Distillation

Date: Sep 9, 2026

• 🔴 (16:28) Tool result showed 3 commits in order: fc5d50e23 fix(ci): skip risk labels for fork PRs; 285a589de fix(docs): derive command references from metadata; 92dc1dab2 fix(docs): correct agent conversation argument syntax.
• 🟡 (16:29) Truncated tool output was saved in full at /home/byk/.local/share/opencode/tool-output/tool_086ffafaa001mpC6CU5SMeUB34.
• 🔴 (16:29) User stated --fields is always injected when output: { human: ... }, even when a command already defines its own json flag.
• 🔴 (16:29) User stated flags listed in ALWAYS_STRIP are always stripped so the command never sees them; ALWAYS_STRIP currently contains LOG_LEVEL_KEY.
• 🟡 (16:29) packages/cli/src/lib/command.ts adds prepareNativeDocs(), which removes examples from extended CommandDocumentation, renders each example as ${command} # ${description} under an Examples: section in fullDescription, and returns native Stricli help documentation.
• 🟡 (16:29) packages/cli/src/lib/command.ts adds attachDocumentationMetadata(), preserving the first customUsage entry as __primaryUsage and canonical documentation examples as __examples on the built command.
• 🟡 (16:29) buildCommand() now runs prepareNativeDocs(builderArgs.docs) before enrichDocsWithSchema(...), intentionally retaining JSON field documentation at the end of native help; it passes the resulting stricliDocs to stricliCommand() and calls attachDocumentationMetadata(cmd, builderArgs.docs).
• 🟡 (16:29) packages/cli/src/lib/introspect.ts imports CommandExample, adds Command.__examples?: readonly CommandExample[], and makes canonical command metadata examples take precedence over externally supplied documentation examples. Canonical examples are emitted as # ${description}\n${command}.
• 🟡 (16:29) getPositionalString() in packages/cli/src/lib/introspect.ts now renders optional tuple positional parameters with brackets, changing an optional placeholder from <name> to [<name>]; required tuple and variadic array formatting remain unchanged.
• 🟡 (16:29) packages/cli/src/lib/list-command.ts now uses the shared CommandDocumentation type for both buildListCommand() docs and OrgListCommandDocs, replacing local { brief; fullDescription? } shapes.
• 🔴 (16:29) User directed buildListCommand() to always inject --fresh unless the command already defines it.
• 🔴 (16:29) User stated the first positional argument to buildListCommand() is always the target using the org/project pattern; the wrapper intercepts this argument through interceptSubcommand() to handle plural-alias confusion.
• 🟡 (16:29) buildListCommand() injects --cursor unless options.noCursorFlag is set or the command defines it; injects -f → fresh unless options.noFreshAlias is set or f exists; injects -c → cursor unless cursor is opted out or c exists; and calls applyFreshFlag(flags) before the original command function.
• 🟡 (16:29) packages/cli/src/lib/mutate-command.ts now uses shared CommandDocumentation for buildDeleteCommand() docs instead of a local { brief; fullDescription? } type.
• 🔴 (16:29) User directed buildDeleteCommand() to always inject --yes unless the command already defines it.
• 🟡 (16:29) buildDeleteCommand() injects --force unless options.noForceFlag is set or it already exists, injects --dry-run unless options.noDryRunFlag is set or it already exists, and supplies aliases -y → yes, -f → force, and -n → dry-run when not occupied or opted out.
• 🟡 (16:29) buildDeleteCommand() runs guardNonInteractive() before the original function unless options.noNonInteractiveGuard is set; the guard evaluates yes, force, and dry-run.
• 🟡 (16:29) .github/workflows/pr-risk.yml defines workflow PR Risk Experiment, triggered for pull-request events opened, synchronize, reopened, and ready_for_review; concurrency group is pr-risk-${{ github.event.pull_request.number }} with cancel-in-progress: true.
• 🟡 (16:29) .github/workflows/pr-risk.yml runs job Score PR risk on ubuntu-latest only when github.event.pull_request.draft == false, using getsentry/pr-risk-action@v0 with skip-reviews: "true" and result-path: risk-pr-result.json.
• 🟡 (16:29) Fork-PR label behavior in .github/workflows/pr-risk.yml: apply-label is ${{ github.event.pull_request.head.repo.full_name == github.repository }}, so risk labels are applied only when the PR head repository matches the target repository.
• 🟡 (16:29) .github/workflows/pr-risk.yml uploads risk-pr-result.json using actions/upload-artifact@v4 under artifact name risk-pr-result; workflow permissions are contents: read, pull-requests: write, and issues: write.