Skip to content

v1.60.2.0 fix(codex): keep gstack catalog within prompt budget - #2363

Open
cuddly-life wants to merge 2 commits into
garrytan:mainfrom
cuddly-life:fix/codex-skill-catalog-budget
Open

v1.60.2.0 fix(codex): keep gstack catalog within prompt budget#2363
cuddly-life wants to merge 2 commits into
garrytan:mainfrom
cuddly-life:fix/codex-skill-catalog-budget

Conversation

@cuddly-life

Copy link
Copy Markdown

Summary

  • Apply catalog trimming only to generated Codex skills while retaining natural-language discovery and router guidance.
  • Emit valid default prompts that explicitly name each $skill-name.
  • Add YAML, metadata-shape, catalog-budget, routing-preservation, and golden-output regression coverage.

Why

The generated Codex install exposes 54 gstack descriptions in the always-loaded skill catalog. Together they exceeded the catalog budget and triggered description shortening at session startup.

This reduces the generated catalog to 3,854 description characters (71 average, 208 maximum) without removing workflow instructions or natural-language routing.

Related work

Related to #1972. This implementation is rebased onto current main, scoped to Codex, preserves implicit routing, fixes generated $skill-name prompts, and adds positive and negative routing-preservation coverage.

Test Coverage

All changed generator paths have focused regression coverage.

Pre-Landing Review

Reviewer concerns around hidden child skills and overly broad YAML changes were resolved. No remaining blocking findings.

Design Review

No frontend files changed — design review skipped.

Plan Completion

No plan file detected.

Verification

  • bun run gen:skill-docs --host all
  • bun run gen:skill-docs --host all --dry-run
  • bun test --timeout 15000 test/gen-skill-docs.test.ts (403 pass)
  • bun test test/host-config.test.ts (77 pass)
  • focused catalog-mode and trim suites
  • bun run build
  • git diff --check
  • fresh Codex CLI prompt audit with no skill-description warning

Known repository-wide gate limitations

  • bun test was attempted; the all-files parallel run encountered unrelated timing and shared-state failures in discovery, gbrain, repo-mode, and detach suites. The changed generator and host suites pass in isolation.
  • bun run skill:check reports the intentional absence of claude/SKILL.md; all 54 Codex skills and all generated-host freshness checks pass.

@trunk-io

trunk-io Bot commented Jul 27, 2026

Copy link
Copy Markdown

Merging to main in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

After your PR is submitted to the merge queue, this comment will be automatically updated with its status. If the PR fails, failure details will also be posted here

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant