Skip to content

v0.24.0

Choose a tag to compare

@agentfirstkit agentfirstkit released this 27 Jul 06:39
· 20 commits to main since this release
  • Make CLI help a normal result: --help inherits the command's declared --output default, so a JSON-default CLI answers with a protocol-v1 result.code:"help" envelope and --output plain is how a human asks for conventional text
  • Add spec/cli-help-v1.schema.json as the normative compact structured-help contract, with fixtures and a validator the test gate runs against real --help output from all four SDK examples and the afdata binary
  • Add cli_handle_version_or_help_or_continue() with HelpConfig::output_aware() and output_aware_with_fallback() as the single pre-parse entry point for version and help
  • Keep structured help token-efficient: a concise about instead of Markdown long_about, inherited globals referenced through inherited_arguments_from rather than repeated, empty and false metadata omitted, secret defaults rendered as ***, and no version values embedded
  • Spell --help and --version out in full, dropping the -h and -V aliases across the CLI, the Bash authoring kit, and all four SDKs, which frees those shorts for applications that need them (such as -h for --host)
  • Make version output follow the same explicit-or-inherited --output rule as help
  • Honor hide_default_value in structured help so a default hidden from plain help is never disclosed in JSON or YAML
  • Emit the same protocol-v1 envelope from cli_render_help_with_options as the pre-parse handler, so structured help validates identically no matter which entry point produced it
  • Give Markdown help headings and Usage lines the full invocable command path, so every line of the generated CLI reference can be copied straight into a shell
  • Return a structured cli_error when afdata is invoked with no command or with an unsupported short flag, instead of the argument parser's plain-text help at exit 0
  • Restructure the Agent Skill into a router plus four focused references (naming and output, CLI and protocol, documents, Bash) and bundle the help schema as an installed skill asset
  • Redact secret-suffixed argv values in the Go and TypeScript example startup logs, and use the library's LogFilters prefix matching in the Python example
  • Fix Bash authoring-kit examples that aborted on stock macOS Bash 3.2 when a forwarded argument array was empty
  • Drop the unused clap-markdown dependency, fix the cli-help-without-cli-help-markdown feature combination, and upgrade noyalib to 0.0.17