Skip to content

fix(cli): make --llms-full complete and accurate - #474

Open
mldangelo-oai wants to merge 20 commits into
mainfrom
mdangelo/codex/fix-llms-full-manifest
Open

fix(cli): make --llms-full complete and accurate#474
mldangelo-oai wants to merge 20 commits into
mainfrom
mdangelo/codex/fix-llms-full-manifest

Conversation

@mldangelo-oai

@mldangelo-oai mldangelo-oai commented Aug 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

Make --llms-full a complete reference for the installed CLI. The reference now uses the live command schemas and documents the options, constraints, and output modes that the CLI actually supports.

Changes

  • Render canonical kebab-case flags, required arguments and options, allowed values, defaults, constraints, and deprecated aliases.
  • Reuse the packaged README for the operating guide and include current runtime metadata, without duplicating the guide in scoped command output.
  • Share command-result restrictions with CLI enforcement while preserving discovery, structured manifests, and shell completion.
  • Merge current main's Linear patch workflow. The existing schema-based renderer picks up its optional issue arguments and project selectors; generic contract tests cover requiredness and deprecation.

Testing

  • Exact-head discovery, manifest, and mocked Linear CLI checks on 5f8ccba0: 28 passed, zero failures, 1,539 assertions.
  • pnpm run types, pnpm run format, and git diff --check: passed.
  • Build, pack, check:package, and separate installed-package smoke: passed. The archive check validated 226 entries and 106 bundled plugin files; the installed smoke exercised the nested worker without a global Codex installation.
  • The earlier randomized full suite on beedc8ee passed 1,307 tests with 11 skips and zero failures. That result is historical; a new full suite was not run for this main integration.
  • Three fresh source-only native reviews and independent verification on 5f8ccba0 found no confirmed blocking or advisory findings. Pushed-head CI is still required.

Risk and rollout

This keeps Incur's live parser schemas and the existing command-result policy. There is no dependency, persisted-state, or bundled-plugin-version change. Current-head cross-platform CI, required human review, and resolution of older source-fixed review threads remain merge conditions.

Public disclosure review

Newly authored material was reviewed for public disclosure. Existing automated review comments contain access-restricted report references; maintainer cleanup remains outstanding.

  • No customer, partner, prospect, or user identities, data, or identifying details are included.
  • No credentials, personal data, private source, scan findings, or nonpublic links or tickets are included.
  • I reviewed the branch name, title, description, commits, changes, comments, logs, screenshots, attachments, and links for public disclosure.

@github-actions github-actions Bot added the bug Something isn't working label Aug 16, 2026

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Security review completed. No security issues were found in this pull request.

Reviewed commit: 5789da8956

View security finding report

Only the user who started this review can view the report in Codex.

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: 5789da8956

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@mldangelo-oai
mldangelo-oai marked this pull request as ready for review August 16, 2026 03:54

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5789da8956

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread sdk/typescript/tests-ts/cli-manifest.test.ts Outdated

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Security review completed. No security issues were found in this pull request.

Reviewed commit: d2e63a0a1d

View security finding report

Only the user who started this review can view the report in Codex.

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d2e63a0a1d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +45 to +46
INCUR_VALUE_OPTIONS.has(argument) &&
argv[index + 1] !== undefined

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Strip equals-form global options before deriving scope

When an accepted equals-form global option precedes the command path, such as codex-security --filter-output=scan scans show --llms-full, this exact lookup does not consume it. renderFullMarkdownManifest consequently treats the option as the first command argument and leaves the scope empty, producing a root heading and root operating guide even though Incur selected only scans show; handle equals forms for --filter-output, --token-limit, and --token-offset before deriving the scope.

Useful? React with 👍 / 👎.

Comment on lines +173 to +177
if (options && property.type === "array") {
details.push("Repeat this flag for multiple values.");
if (Array.isArray(property.default)) {
details.push(`Default: ${codeValue(property.default)}.`);
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Document constraints on repeatable option values

Every repeatable option such as --path, --knowledge-base, and --codex is an array whose string items have a minimum length, but Zod places that constraint under property.items and this branch only describes repetition and the outer default. Because Incur does not render these constraints itself, the full manifest omits that empty repeated values are rejected; include applicable item-level constraints when documenting arrays.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

@codex review

Please review the current head, 59ae515c1f81f982a0edeaaa0b07574653e899db.

@chatgpt-codex-connector

Copy link
Copy Markdown

Security review completed. No security issues were found in this pull request.

Reviewed commit: 59ae515c1f

View security finding report

Only the user who started this review can view the report in Codex.

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 59ae515c1f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

{ commands: [{ name: command }] },
[command],
);
expect(scoped).toMatch(/--filter-output.*only to command results/u);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Test filtering semantics without pinning renderer prose

The latest commit reintroduces an assertion on exact generated English by requiring the words “only to command results,” so a harmless copy edit will fail this test even when filtering behavior and documented restrictions remain correct. Assert a stable semantic property or source-of-truth value instead; this is fresh evidence after the earlier wording assertions were removed.

AGENTS.md reference: sdk/typescript/AGENTS.md:L29-L32

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

@codex review

Please review the current head, beedc8eee5352c29787ba0882c2564a75ad1277e.

@chatgpt-codex-connector

Copy link
Copy Markdown

Security review completed. No security issues were found in this pull request.

Reviewed commit: beedc8eee5

View security finding report

Only the user who started this review can view the report in Codex.

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: beedc8eee5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

zcrab-oai
zcrab-oai previously approved these changes Aug 16, 2026

@zcrab-oai zcrab-oai left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the generated CLI reference against actual command schemas; verified scoped equals-form options and repeatable-value constraints.

@mldangelo-oai

Copy link
Copy Markdown
Collaborator Author

@codex review

Please review the current head, 5f8ccba09350c854495abfda2659d04fcba1c7a4.

@chatgpt-codex-connector

Copy link
Copy Markdown

Security review completed. No security issues were found in this pull request.

Reviewed commit: 5f8ccba093

View security finding report

Only the user who started this review can view the report in Codex.

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Delightful!

Reviewed commit: 5f8ccba093

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

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

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants