Skip to content

docs(design): C18 one CLI grammar, verb then kind - #188

Merged
Max-Levitskiy merged 10 commits into
mainfrom
design/c18-cli-grammar
Oct 17, 2026
Merged

Max-Levitskiy merged 10 commits into
mainfrom
design/c18-cli-grammar

Conversation

@Max-Levitskiy

Copy link
Copy Markdown
Member

Design record for the CLI review of 2026-10-15: docs/design/c18-cli-grammar.md.

  • L1 (Max): every command is spore <verb> <kind>/<name>, as in kubectl.
  • L2: the full verb table, with what each replaces (status → describe run/X, list → get runs, run → execute, worker → serve).
  • L3: each kind is one registry entry (names, columns, schema, conditions, verbs); read verbs dispatch on it.
  • L4: a verb with a kind it does not fit, or a flag of another verb, fails with the fix.
  • L6: one address form: run/<id-prefix|start-key>, step/<run>:<node>; -o name round trips.
  • L7: plugins (M6) add kinds as data and verbs only for their own kinds; never override core ones.
  • L8: one flag vocabulary (--data, --outcome, --key), -o text|wide|json|jsonl|name, JSON errors, exit codes 7–9, --dry-run.
  • L9: 0.2 commands stay as warned aliases through 0.4.

Delivery is 5 tickets, about 4.5 days. Docs only; no code changes.

https://claude.ai/code/session_01Vpm2tc4cgoSUG78H3fbpMy

Every spore command becomes `spore <verb> <kind>/<name>`. Read verbs
(get, describe, explain, wait) work on every kind through a kind
registry, so plugin kinds get them for free with M6. Old commands stay
as warned aliases for two minor releases.

Claude-Session: https://claude.ai/code/session_01Vpm2tc4cgoSUG78H3fbpMy
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-17T09:38:08.902262Z ef2b6c4 New commits
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@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: 51d7d3a572

ℹ️ 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 docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
… key/prefix ambiguity, invocation resolve, legacy flags, plugin invoke, --error, --unfinished

Claude-Session: https://claude.ai/code/session_01Hqwwk3UZWJZ2j92zCFYf2d

@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: 814d95263d

ℹ️ 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 docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
…ays a queue, validate takes artifacts, conditions as status.conditions

Claude-Session: https://claude.ai/code/session_01Hqwwk3UZWJZ2j92zCFYf2d

@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: 03603e9189

ℹ️ 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 docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
… by token alone, claim scopes with --run, describe step without a name

Claude-Session: https://claude.ai/code/session_01PvecNurNanbbbk5qLA5qpM

@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: 5d1d7c630c

ℹ️ 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 docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
…p, no get -w, aliases keep exit 2, release dry run shows the quarantine

Claude-Session: https://claude.ai/code/session_01PvecNurNanbbbk5qLA5qpM

@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: cb993d82de

ℹ️ 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 docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated
Comment thread docs/design/c18-cli-grammar.md Outdated

@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: 71d17189cf

ℹ️ 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 docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md

@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: 06d11b79a3

ℹ️ 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 docs/design/c18-cli-grammar.md Outdated

@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: e878fd7e43

ℹ️ 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 docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md Outdated

@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: ef2b6c4b9f

ℹ️ 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 docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md
Comment thread docs/design/c18-cli-grammar.md
@Max-Levitskiy
Max-Levitskiy merged commit 6d93f3d into main Oct 17, 2026
7 checks passed
@Max-Levitskiy
Max-Levitskiy deleted the design/c18-cli-grammar branch October 18, 2026 13:04
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