Skip to content

feat(overlays): expose structured command examples#74

Merged
samzong merged 1 commit into
mainfrom
feat/structured-command-examples
Jun 26, 2026
Merged

feat(overlays): expose structured command examples#74
samzong merged 1 commit into
mainfrom
feat/structured-command-examples

Conversation

@samzong

@samzong samzong commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds structured overlay examples metadata for generated commands and carries it through generated CommandSpec, the runtime catalog, and generated Skill references.

Keeps legacy example projected into examples for catalog consumers, documents the overlay shape, and bumps the catalog schema to 7.

Closes #72

Verification

  • make check
  • git diff HEAD~1..HEAD --check
  • pre-ship committed diff scan: 0 MUST-FIX

Compatibility

Catalog schema changes from 6 to 7. commands --json and commands show --json now include examples when overlays define structured example metadata or legacy example is present.

Runtime execution, auth, body handling, output formatting, and generated output commit policy are unchanged.

Checklist

  • Tests or focused verification cover the changed surface.
  • User-facing behavior changes are documented.
  • Generated output under internal/generated/, .cache/, and ad-hoc skills/<cli-name>/ directories is not committed.
  • Commits are signed off when this is ready to merge.

Signed-off-by: samzong <samzong.lu@gmail.com>
@samzong

samzong commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator Author

@codex review

@samzong samzong merged commit 9b2d7e3 into main Jun 26, 2026
3 checks passed
@samzong samzong deleted the feat/structured-command-examples branch June 26, 2026 17:09
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.

feat(catalog): expose runnable examples and host context in command metadata

1 participant