Skip to content

Add Command Manifest v1 to JSON help output#308

Merged
AndreyVMarkelov merged 1 commit into
masterfrom
feat/command-manifest-v1
Jun 29, 2026
Merged

Add Command Manifest v1 to JSON help output#308
AndreyVMarkelov merged 1 commit into
masterfrom
feat/command-manifest-v1

Conversation

@AndreyVMarkelov

@AndreyVMarkelov AndreyVMarkelov commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Enriches JSON help with structured machine-contract metadata: positional args, flag enum values/conflicts/sensitive/prompt annotations, examples, Dropbox scopes, stdin/stdout behavior, schema refs, result statuses/kinds, and warning codes
  • Adds docs/json-schema/v1/manifest.schema.json for strict validation of manifest objects
  • Adds audit test ensuring all runnable commands have registry entries and all flag conflicts reference real flags
  • Removes dead code from tools/gen-docs after switching to the new CommandManifestFor() export

Test plan

  • go test ./... passes
  • golangci-lint run ./... clean
  • gofmt -s -l . clean
  • TestJSONHelpManifestV1MachineFields validates put manifest completeness
  • TestJSONHelpManifestV1SelectedCommandMetadata spot-checks get, cp, share-link create/update, login, completion
  • TestJSONHelpManifestRegistryAudit verifies all runnable commands have entries, conflicts are valid, schema files exist
  • TestPublicJSONManifestSchemaFile validates manifest.schema.json structure
  • Generated docs rebuilt and in sync

Enriches JSON help with structured machine-contract metadata: positional
args, flag enum values/conflicts/sensitive/prompt annotations, examples,
Dropbox scopes, stdin/stdout behavior, schema refs, result statuses/kinds,
and warning codes. Adds manifest.schema.json for validation and an audit
test ensuring all runnable commands have registry entries.
@AndreyVMarkelov AndreyVMarkelov merged commit 018f79c into master Jun 29, 2026
8 checks passed
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