Distillation

Date: September 9, 2026

• 🔴 (23:09) User stated flags in ALWAYS_STRIP are always stripped before dispatch, so the command never sees them; ALWAYS_STRIP currently contains LOG_LEVEL_KEY.
• 🔴 (23:09) User stated list-command construction must always inject --fresh via FRESH_FLAG unless the command already defines a fresh flag.
• 🔴 (23:09) User stated the first positional argument for list commands is always the target, following the org/project pattern; it is intercepted with interceptSubcommand() to handle plural-alias confusion before invoking the original command function.
• 🔴 (23:09) User stated delete-command construction must always inject --yes via YES_FLAG unless the command already defines a yes flag.
• 🔴 (23:09) User stated conversation IDs are organization-scoped rather than org/project-scoped and never contain /.
• 🟡 (23:09) In packages/cli/src/commands/agent-conversation/list.ts, the diff added getPositionalString from ../../lib/introspect.js while retaining manual pagination helpers resolveCursor, advancePaginationState, hasPreviousPage, buildPaginationContextKey, and paginationHint.
• 🟡 (23:09) Conversation-target parsing accepts [<org>/]<conversation-id>: no slash means the entire trimmed value is the conversation ID and the organization is auto-detected; one slash separates organization from conversation ID.
• 🟡 (23:09) parseConversationTarget() validation changed from throwing ContextError for an empty conversation-ID segment to using validationError(): multiple slashes produce "Conversation target must contain at most one '/'."; an empty organization or conversation-ID segment produces "Conversation target must include both an organization and conversation ID when using '/'."; both include [USAGE_HINT] and field "conversation-id".
• 🟡 (23:09) buildCommand attaches an output JSON schema as the non-standard __jsonSchema property when outputConfig?.schema exists; introspect.ts reads it to populate CommandInfo.jsonFields for help output and SKILL.md generation.
• 🟡 (23:09) The Command type includes introspection metadata: __jsonSchema?: import("valibot").GenericSchema, __primaryUsage?: string, and newly added __examples?: readonly CommandExample[] for canonical documentation examples retained by buildCommand.
• 🟡 (23:09) Command metadata was extended with readonly docs: CommandDocumentation.