comate-cli 0.12.4b3__tar.gz → 0.12.4b5__tar.gz

comate_cli-0.12.4b5/.agent/artifacts/grep_content/dec1ee9f38d117f649d0ba2cfb54b50d9ccd841833170c49614fa181a358013e.txt

@@ -0,0 +1,280 @@
+/home/andy/works/agent-sdk/docs/issues/2026-08-20-facade-tools-comate-merge-bug/01-comate-mode-custom-tools-swallow-builtins.md:3:status: fixed
+/home/andy/works/agent-sdk/docs/issues/2026-09-07-reminder-engine-followups/02-external-input-trust-boundary-audit.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-07-reminder-engine-followups/01-output-style-turn-reminder.md:3:status: superseded
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-background-job-progress-delivery/01-barrier-heartbeat-clears-current-tool.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-background-job-progress-delivery/03-turn-end-pending-events-stranded.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-background-job-progress-delivery/02-progress-throttle-drops-token-only-updates.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-comate-resume-slow/01-remove-read-lite-metadata.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-nonstreaming-fallback-10min-guard/04-stream-idle-observability.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-comate-relay/05-agents-service-ts-relay-entry-demo.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-nonstreaming-fallback-10min-guard/02-docs-sync-rules-and-spec.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-comate-resume-slow/04-test-isolation-sessions-root.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-nonstreaming-fallback-10min-guard/01-provider-nonstreaming-timeout-and-clamp.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-15-approval-verbose-params/03-edit-diff-write-content.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-comate-relay/04-cli-rpc-relay-dial-out.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-comate-relay/02-mux-channel-forwarding-core-memory-relay-driver.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-nonstreaming-fallback-10min-guard/03-notgiven-filter-latent-bug.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-comate-resume-slow/02-sessioninfo-resumable-single-head-scan.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-15-approval-verbose-params/02-fallback-verbose-params.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-comate-relay/06-real-process-smoke-and-phone-acceptance.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-comate-relay/01-stamped-identity-and-audit-fields.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-comate-resume-slow/03-ctrl-a-async-scope-loading.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-comate-relay/03-relay-package-accounts-tokens-entrypoints.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-21-sdk-session-message-projection/02-assistant-usage.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-15-approval-verbose-params/01-approval-wrap-display-width.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-21-sdk-session-message-projection/01-tool-result-tool-call-id.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-comate-relay/README.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-21-sdk-session-message-projection/03-midturn-queued-user-projection.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-comate-resume-slow/05-cleanup-tmp-buckets.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-home-skill-chips/02-entry-convergence.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-builtin-marketplace-catalog/01-distribution-profile-builtin-marketplaces.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-home-skill-chips/01-frontend-armed-chips.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-07-live-preview-followups/02-nextjs-allowed-dev-origins.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-add-dirs-cc-alignment/04-cli-add-dir-and-approval-shortcut.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/02-anthropic-thinking-mechanism.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-builtin-marketplace-catalog/03-marketplace-add-shortname-and-docs.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-07-live-preview-followups/01-stale-proxy-visibility.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-builtin-marketplace-catalog/02-marketplaces-tab-featured-section.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-07-live-preview-followups/03-minor-redirect-and-ws-impl.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-bash-readonly-phase2-cc-alignment/01-command-spec-framework-hole-fixes.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-add-dirs-cc-alignment/06-add-dir-remember-when-already-covered.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/07-language-section-memory-slim.md:3:status: done（645e82ff）
+/home/andy/works/agent-sdk/docs/issues/2026-09-24-ci-python-311-matrix/01-add-python-311-to-ci-matrix.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-remove-ls-bash-cc-alignment/05-remove-ls-prompt-reversal-guards.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-bash-readonly-phase2-cc-alignment/05-external-tools-rg-fd-pyright-docker.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-add-dirs-cc-alignment/01-accept-edits-add-dirs-write-roots.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/04-policy-denied-no-batch-kill.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-07-structured-output-class-only-sanitize/03-schema-sanitization-shared-entry.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-11-text-decoding-two-tier-governance/05-strict-side-unicodedecodeerror-audit.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-11-text-decoding-two-tier-governance/06-rules-doc-claude-md-entry.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-bash-readonly-phase2-cc-alignment/03-flag-gated-family-and-cd.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-20-sdk-session-title/01-migrate-openworker-autotitle.md:3:status: needs-info
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-remove-ls-bash-cc-alignment/01-test-samples-de-ls.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/06-compaction-buffer-mcp-cap-restore-budget.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-11-text-decoding-two-tier-governance/01-utils-decoder-skill-tracer.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-02-workflow-tool-model-allocation/01-inherit-parent-tools-model-effort.md:3:status: done（963a91e4）
+/home/andy/works/agent-sdk/docs/issues/2026-08-07-structured-output-class-only-sanitize/02-local-validation-instance-output.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-11-text-decoding-two-tier-governance/02-subagent-plugin-command-lenient.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-02-workflow-tool-model-allocation/02-unknown-tool-hint-misleading-when-mcp-disabled.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-add-dirs-cc-alignment/02-roots-boundary-to-permission-layer.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-bash-readonly-phase2-cc-alignment/02-low-risk-posix-query-commands.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-11-text-decoding-two-tier-governance/04-memory-agents-md-consolidation.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/03-prompt-behavior-patches.md:3:status: done（2a6b0b2e）
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-remove-ls-bash-cc-alignment/02-bash-readonly-autoallow-base.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-07-structured-output-class-only-sanitize/01-class-only-entry-single-field-channel.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-11-text-decoding-two-tier-governance/03-cli-slash-conditional-rules-crash-holes.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-bash-readonly-phase2-cc-alignment/04-git-13-subcommands.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-add-dirs-cc-alignment/03-runtime-add-directory-channel.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-remove-ls-bash-cc-alignment/04-cli-bash-command-fold.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/09-freshness-resume-compact-baseline.md:3:status: done（c89ad911 P2 / 2ee16c28 P1）
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-bash-readonly-phase2-cc-alignment/06-cli-fold-table-expansion.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-21-openworker-autotitle-source/01-autotitle-first-prompt-and-durable-guard.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-add-dirs-cc-alignment/05-settings-persistence-and-remember.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/05-parallel-readonly-tool-group.md:3:status: done（a4df31cf）
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-remove-ls-bash-cc-alignment/03-bash-readonly-git-flags-guards.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-output-cap-cc-alignment/02-sdk-keep-complete-tool-calls.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-diff-color-cc-alignment/02-marker-decoration-split.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-tool-signature-cc-alignment/03-remaining-tools-ellipsis-budget.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-10-openworker-attachment-replay/01-sdk-session-query-multimodal.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/10-mcp-parallel-readonly-group.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-diff-color-cc-alignment/01-diff-color-native-palette.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-tool-signature-cc-alignment/04-standalone-subtitle-diff-budget.md:3:status: done（非本 PRD 范围；决策于 2026-08-01 由用户直接拍板，未走 grilling）
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-output-cap-cc-alignment/03-sdk-continuation-recovery.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-tool-signature-cc-alignment/02-path-search-signature-cc-format.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-10-openworker-attachment-replay/02-openworker-attachment-replay-projection.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/01-model-registry-wildcard-warning-default-temp.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-tool-signature-cc-alignment/05-standalone-fold-subtitle-never-rendered.md:3:status: closed（wontfix — 现状即 CC 对齐行为，2026-08-01 核实关闭）
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-prompt-cache-hit-rate/03-facade-get-llm-stats.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-01-tool-signature-cc-alignment/01-bash-signature-cc-budget.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-output-cap-cc-alignment/01-sdk-compaction-reservation-decouple.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-prompt-cache-hit-rate/01-sdk-cache-hit-rate-sampling.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-provider-endpoint-protocol-mismatch/02-cli-surface-mismatch-warning.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-04-terminal-tab-title/02-tab-title-attention-state.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-cc-gap-p0p1/08-freshness-diff-summary-draft.md:3:status: done（1c25e023 / fa271c5d）
+/home/andy/works/agent-sdk/docs/issues/2026-08-16-prompt-cache-hit-rate/02-cli-statusline-display-and-config.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-provider-endpoint-protocol-mismatch/04-wording-and-total-usage-noise.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-output-cap-cc-alignment/05-openworker-frames-parity.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-23-comate-rpc-v4/03-stdio-channel-real-process-smoke.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-provider-endpoint-protocol-mismatch/05-observe-reverse-mismatch-sample.md:3:status: needs-info
+/home/andy/works/agent-sdk/docs/issues/2026-09-04-terminal-tab-title/01-session-title-as-session-fact.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-31-subagent-user-instruction-root/02-fork-template-shared-config.md:3:status: done（497e3b90）
+/home/andy/works/agent-sdk/docs/issues/2026-08-28-output-cap-cc-alignment/04-continuation-visibility.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-31-subagent-user-instruction-root/01-subagent-instruction-root-and-copy.md:3:status: done（497e3b90）
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-provider-endpoint-protocol-mismatch/01-preflight-endpoint-protocol-mismatch.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-23-comate-rpc-v4/04-websocket-channel-rpc-ws-local-token.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/11-remove-zcode-cli-and-legacy-service.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-23-comate-rpc-v4/02-remote-services-wire-models-interaction-registry.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/06-ts-client-stdio-channel.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-provider-endpoint-protocol-mismatch/03-openai-nonstreaming-response-guard.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-skills-menu-disable/05-menu-space-toggle-end-to-end.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-openworker-automation-run-parity/02-unify-delete-entry.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-09-openworker-model-config/05-gui-level-labels-and-sync-refresh.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-23-comate-rpc-v4/01-framework-protocol-memory-channel.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/07-desktop-comate-agent-service.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/02-rpc-v5-projection-core.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-11-mentions-index-subprocess/01-index-subprocess-managed-async.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-scratchpad-directory/02-scratchpad-write-permission-allow.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-statusline-decode-speed/01-sdk-decode-speed-sampling.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-09-openworker-model-config/02-backend-hyc-single-preset-routes.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/12-packaging-bundle-comate.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/05-send-options-attachments-settings.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-skills-menu-disable/02-sdk-build-time-denylist.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-statusline-decode-speed/02-cli-statusline-display-and-config.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-09-openworker-model-config/01-backend-model-readiness-and-level-sources.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-25-openworker-run-artifacts-ledger/01-run-artifacts-ledger-end-to-end.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/01-move-zcode-to-comate-desktop.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-openworker-automation-run-parity/03-inbox-term-revision.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-09-openworker-model-config/04-gui-settings-models-two-sections.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/README.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-skills-menu-disable/03-sdk-runtime-set-skill-enabled.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/04-resume-history-sessions-index.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-scratchpad-directory/01-scratchpad-path-and-prompt-injection.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-09-openworker-model-config/03-gui-post-login-model-guide.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/10-acceptance-e2e.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/09-desktop-hide-devendor-rebrand.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/03-projection-interactions-queue-markers.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-openworker-automation-run-parity/04-manual-run-parity.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-25-comate-desktop/08-desktop-model-picker-provider-attachments.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-skills-menu-disable/01-skills-menu-list-info-upgrade.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-scratchpad-directory/03-cli-scratch-fold.md:3:status: done（9fa1fc82 主实现，5b63c841 补错误态用例）
+/home/andy/works/agent-sdk/docs/issues/2026-08-21-openworker-phase3-batch-flake/01-bypass-mode-test-order-flake.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-skill-mcp-management/05-dead-surface-cleanup.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-output-cap-retry-visibility/04-sdk-thinking-skip-conservative-cap.md:3:status: reverted
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-skill-mcp-management/01-skills-backend-write-paths-and-denylist.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-skill-mcp-management/06-cli-denylist-migration.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-tool-result-ui-semantics/01-result-state-classifier-and-semantic-colors.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-02-skills-menu-disable/04-cli-persistence-and-projection.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-openworker-automation-run-parity/05-automation-rename-debt.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-skill-mcp-management/03-skill-creator-bundled.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-skill-mcp-management/07-memory-dead-surface.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-skill-mcp-management/02-skills-frontend-detail-page.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-skill-mcp-management/04-connectors-truthful-status.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-tool-result-ui-semantics/04-webfetch-preview.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-output-cap-retry-visibility/01-sdk-cap-retry-event-fields.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-tool-result-ui-semantics/02-fold-and-resume-color-paths.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-openworker-automation-run-parity/01-once-task-gui-guard.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-22-cli-shell-mode-model-turn/01-shell-mode-model-turn-and-display.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-tool-result-ui-semantics/03-fallback-one-line-preview-and-error-path.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-output-cap-retry-visibility/02-cli-reason-branch-display.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-bash-fold-display/01-transcript-viewer-full-command.md:3:status: closed（已存在，无需实现）
+/home/andy/works/agent-sdk/docs/issues/2026-08-21-session-fifo-drain-ttfb-gating/01-session-fifo-blocked-by-ttfb.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-bash-fold-display/README.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-23-comate-rpc-v4/README.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-output-cap-retry-visibility/03-final-truncation-visible-warning.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-15-openworker-personalization/01-personalization.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-windows-rg-unavailable-incident/01-probe-timeout-false-death.md:3:status: fixed
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/02-auth-accounts.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-windows-rg-unavailable-incident/02-event-loop-freeze.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-10-askuserquestion-blocking-cc-alignment/05-cli-review-feedback-reject.md:7:status: superseded
+/home/andy/works/agent-sdk/docs/issues/2026-09-23-comate-rpc-v4/06-remove-legacy-rpc-and-docs-cleanup.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-context-window-mismatch/01-registry-context-window-vs-endpoint-limit.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-windows-rg-unavailable-incident/03-tui-log-default-show.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/03-users-groups.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-11-openworker-attachment-paths/01-backend-attachment-store-and-upload.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-compaction-floor-over-threshold/03-mcp-tool-deferred-loading.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/07-audit-ops.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/04-content-library.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-10-askuserquestion-blocking-cc-alignment/04-cli-question-broker-esc-reject.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-rewind-boundary-truncation/05-truncation-cuts-worktree-events-by-turn.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-23-comate-rpc-v4/05-type-generation-ts-client-demo-ci.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-compaction-floor-over-threshold/02-fixed-overhead-over-threshold-warning.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/05-assignment-sync-api.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/06-admin-frontend.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/10-home-cards-server-driven.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-11-openworker-attachment-paths/04-gui-attach-upload-and-chip.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-rewind-boundary-truncation/02-prefactor-writer-hydrate-via-reader.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-02-workflow-agent-observability/02-persist-tool-call-error-summary.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/08-desktop-login.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/09-desktop-sync.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-27-openworker-hub/01-hub-scaffold.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-10-askuserquestion-blocking-cc-alignment/01-sdk-blocking-pipeline-three-state.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-rewind-boundary-truncation/07-worktree-enter-carries-entered-turn.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-compaction-floor-over-threshold/01-post-compact-check-provider-visible.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-11-openworker-attachment-paths/02-backend-path-message-and-replay.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-rewind-boundary-truncation/03-reader-writer-honor-truncation-marker.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-rewind-boundary-truncation/01-adr-truncating-rewind-boundary.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-rewind-boundary-truncation/04-all-rewind-entries-write-marker.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-rewind-boundary-truncation/06-restore-to-turn-rejects-crossing-reset-point.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-draft-slash-skills-menu/01-draft-slash-skills-source.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-02-workflow-agent-observability/01-agent-usage-and-tool-calls.md:3:status: done（e5d7b4ac 段 A / 341d1072 段 B / 4fcf0d1d 段 C / b514ca47 review 修正）
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-openworker-draft-slash-skills-menu/02-preset-skill-entry-chips.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-11-openworker-attachment-paths/03-backend-attachment-open-and-serve.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-10-askuserquestion-blocking-cc-alignment/03-facade-user-question-callback.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-08-26-runner-engine-drain-p0b/01-query-stream-call-site-convergence.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-16-openworker-dingtalk-connector/02-gui-dingtalk-card-device-login.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-24-cancellation-swallowing-cleanup-sites/01-sdk-swallowing-but-not-deadlocking.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-08-10-askuserquestion-blocking-cc-alignment/02-resume-synthesized-rejection.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-15-openworker-model-per-level-selection/02-gui-per-level-pickers-and-default-level.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-08-24-cancellation-swallowing-cleanup-sites/02-comate-cli-sites-unprobed.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-15-openworker-model-per-level-selection/01-backend-catalog-per-level-save-default-level.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-16-openworker-dingtalk-connector/01-backend-dws-detect-login-inject.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-08-10-askuserquestion-blocking-cc-alignment/06-rpc-host-question-bridge.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-29-scene-prompt/01-sdk-scene-split.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-29-scene-prompt/03-structured-run-inherits-scene.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-16-openworker-dingtalk-connector/03-packaging-bundle-dws.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-29-scene-prompt/02-cli-scene-flag.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/08-workflows-panel-session-scope.md:3:status: done（待提交）
+/home/andy/works/agent-sdk/docs/issues/2026-09-29-system-prompt-flag/01-system-prompt-flag.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/02-sandbox-executor.md:3:status: done（81a5b1a7）
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/01-run-substrate-and-plain-text.md:3:status: done（c35b1809）
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-mcp-tool-snapshot-projection/03-registry-sync-three-paths.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/02-bash-pipeline-tail-grep-exit-exemption.md:3:status: wontfix
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/05-workflow-job-and-system-tool.md:3:status: done（待提交）
+/home/andy/works/agent-sdk/docs/issues/2026-09-17-openworker-browser-connector/02-gui-browser-card-connect-dialog.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/03-primitives-and-failure-semantics.md:3:status: done（cff8beee）
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/07-workflows-panel.md:3:status: done（待提交）
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/05-read-not-found-nearest-existing-path.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/06-authoring-guide-bundled-skill.md:3:status: done（62a18b90）
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-mcp-tool-snapshot-projection/01-manager-ledger-alias-replace.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-mcp-tool-snapshot-projection/04-rules-snapshot-invariant.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-dynamic-workflow/04-run-persistence-and-journal.md:3:status: done（349df332）
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/03-edit-write-read-state-source-fact.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-17-openworker-browser-connector/01-backend-cli-driver-bsk.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-11-read-pdf-support/01-read-pdf-text-and-raster.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-transcript-evidence-audit/05-edit-unread-precondition-return-content.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-07-13-mcp-tool-snapshot-projection/02-tools-ready-full-snapshot-contract.md:3:status: ready
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/README.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-transcript-evidence-audit/01-turn-interrupted-row-not-tied-to-stopevent.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-transcript-evidence-audit/02-interrupt-evidence-elapsed-and-partial.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-transcript-evidence-audit/06-read-output-too-large-suggested-limit-margin.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-transcript-evidence-audit/03-turn-failed-evidence-row.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-17-openworker-browser-connector/03-packaging-bundle-bsk.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-transcript-evidence-audit/README.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/06-misc-feedback-wording-fixes.md:3:status: ready-for-human
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/07-grep-glob-empty-result-sampling.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/04-no-callback-denial-session-facts.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-20-transcript-evidence-audit/04-funnel-paths-write-execution-meta.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-observed-context-window-reactive-compaction/03-user-hint-with-agent-prompt.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-tool-feedback-30day-audit/01-bash-nonzero-exit-no-stderr-facts.md:3:status: ready-for-agent
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/08-business-level-revalidation-hook.md:3:status: done（范围收窄；异步回调待真需求）
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/05-drop-redundant-check-schema-on-validate.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/02-submission-guarantee-chain.md:3:status: done（e10aa9c8 主实现，bce25caa 复查修复）
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-observed-context-window-reactive-compaction/02-reactive-compaction-on-prompt-too-long.md:3:status: done（实现记录见文末）
+/home/andy/works/agent-sdk/docs/issues/2026-09-02-bash-exit-false-alarm/01-pipe-semicolon-exit-attribution.md:3:status: fixed
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/03-facade-exposure.md:3:status: done（8fda08c3 流式核心 / f6e98f11 facade / fd21b9d5 语料；3dc2eb97 dict schema 守门）
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/07-output-style-persist-local-scope.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-observed-context-window-reactive-compaction/04-per-level-context-window-config.md:3:status: needs-triage
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/04-schema-satisfiability-lint.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/09-per-turn-style-reminder.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/01-output-style.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/01-submit-tool-and-structured-run-core.md:3:status: done（82d2bfac 主实现，1c043f98 复查修复）
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/03-merge-prompt-profiles.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/02-concise-style.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/06-oversize-style-warning.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-02-bash-exit-false-alarm/02-kimi-guess-import-prompt-experiment.md:3:status: closed（wontfix）
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/06-submit-contract-align-cc.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/08-effort-persist-local-scope.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-01-structured-run-submit-tool/07-repair-message-trim.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/04-default-communication-rewrite.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-28-observed-context-window-reactive-compaction/01-observed-context-window-from-provider-error.md:3:status: wontfix
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/10-docs-and-corpus.md:3:status: done
+/home/andy/works/agent-sdk/docs/issues/2026-09-03-output-style/05-concise-hint-and-corpus-guard.md:3:status: done
+
+271 matches
+271 matched lines
+271 files contained matches
+347 files searched
+35575 bytes printed
+1279467 bytes searched
+0.011920 seconds spent searching
+0.009914 seconds

{comate_cli-0.12.4b3 → comate_cli-0.12.4b5}/.agent/artifacts/index.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "updated_at": 1788447889,
+  "updated_at": 1790691418,
   "items": {
     "sha256:9871dc91ff9afef1303c74cf669996828a7db3dbff6c4c41fbac0a53fd7d195b": {
       "id": "sha256:9871dc91ff9afef1303c74cf669996828a7db3dbff6c4c41fbac0a53fd7d195b",
@@ -427,6 +427,16 @@
       "mime": "text/plain",
       "created_at": 1788447889,
       "ttl_seconds": 3600
+    },
+    "sha256:dec1ee9f38d117f649d0ba2cfb54b50d9ccd841833170c49614fa181a358013e": {
+      "id": "sha256:dec1ee9f38d117f649d0ba2cfb54b50d9ccd841833170c49614fa181a358013e",
+      "relpath": ".agent/artifacts/grep_content/dec1ee9f38d117f649d0ba2cfb54b50d9ccd841833170c49614fa181a358013e.txt",
+      "abspath": "/home/andy/works/agent-sdk/packages/comate_cli/.agent/artifacts/grep_content/dec1ee9f38d117f649d0ba2cfb54b50d9ccd841833170c49614fa181a358013e.txt",
+      "bytes": 35746,
+      "sha256": "dec1ee9f38d117f649d0ba2cfb54b50d9ccd841833170c49614fa181a358013e",
+      "mime": "text/plain",
+      "created_at": 1790691418,
+      "ttl_seconds": 3600
     }
   }
 }

{comate_cli-0.12.4b3 → comate_cli-0.12.4b5}/CHANGELOG.md

@@ -4,6 +4,7 @@
 
 ### Added
 
+- `--system-prompt <文本>` / `--system-prompt-file <路径>`：用自己的文字替换 system prompt 的开头段（agent 是谁、怎么干活）；`--append-system-prompt <文本>` / `--append-system-prompt-file <路径>`：在护栏之后追加。参数名对齐 Claude Code，但与 Claude Code 不同的是护栏段（运行环境说明、工作纪律、危险操作确认、汇报规范等）始终保留。替换与追加可同时使用；同类的文本版与文件版同时给、值为空、文件读不了或为空都会当场退出并按界面语言提示。`--rpc-*` 与 `-p` 同样生效，一个进程下所有新会话共用；resume 旧会话时沿用会话创建时的 system prompt，界面会给出提示，`/clear` 后生效。白牌 `system_role` 语义不变：只换品牌身份句，编码规则保留。
 - ctrl+b 把正在前台跑的 shell 命令转到后台：对模型调用的 Bash 工具和 `!` 本地命令都生效。同一个进程原样移交给后台 job（不重启不杀），模型 Bash 的工具结果立刻回「用户已转后台 + job_id + 输出尾部」让模型继续本轮；`!` 命令静默记一条 reminder、解锁输入框。后台跑完走既有 job 完成通知叫模型；想停用 `/ps`。运行面板与 `!` 活动区在 Bash 跑时显示「ctrl+b 转后台」提示，`/help` 多一行说明。没有可转后台的命令时按键只闪一条提示；子 agent 里的 Bash 不受影响。tmux 用户需按两次 ctrl+b。
 - `!` shell 模式：空输入框敲 `!` 进入 shell 模式，回车后命令在本地直接执行（跳过权限审批、与模型共享持久 cwd），滚动区显示 `! cmd` + 紧贴其下的 `⎿` 输出块（stderr 红、stdout 不红、空输出标 `(No output)`、控制码剥净、长输出截断可 Ctrl+O 看全文）。命令结束后模型自动简短回应一轮；运行期间敲的提问并入同一轮。运行中锚点下方实时显示最后 5 行输出与耗时；超过 60 秒自动转后台并解锁输入框，后台跑完再叫模型；Esc/Ctrl+C 中断不叫模型并把命令回填到输入框。忙时 `!cmd` 排队，回合结束后按顺序执行。
 - 代码托管平台整合第一刀（提示词层）：`<git_env>` 新增 `Main branch:`（PR/MR 的 base 分支）与
@@ -58,7 +59,6 @@
 
 ### Changed
 
-- 启动 logo 固定 1x：不再按终端宽度自动放大。宽终端原来的 8 行 2x 大字标改回 4 行小字标（4 行排版契约不变），2x 放大相关代码随之删除；测试锁定「宽终端也必须是 1x」防回归。白牌发行版（hico）同款改动。
 - 首启向导（Provider setup）整体重做，照 `/effort` 刻度尺模式改为自绘组件 `preflight_wizard_ui.WizardScreenUI`，不再借用共用的 `SelectionMenuUI`：六屏统一「标题 / 空行 / 内容 / 空行 / 键位提示」顶部对齐骨架；选项行改为 `❯ label` 无圆点、项间不留空行；provider 屏只在选中项下方显示一行 preset 说明；API key / endpoint / 模型名输入屏去掉边框；确认屏的 JSON 预览改为对齐缩进的静态块；键位提示只写真正绑定的键（去掉并不存在的 k/j）。其它菜单不受影响。
 - `/effort` 的 `ultracode` 改绑 `max` 档（原 `xhigh`）：选 ultracode = 最高思考档 + workflows
   多 agent 编排；`/effort max` 或 `auto` 关开关，`xhigh` 变回普通档。刻度尺描述改为

{comate_cli-0.12.4b3 → comate_cli-0.12.4b5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comate-cli
-Version: 0.12.4b3
+Version: 0.12.4b5
 Summary: Comate terminal CLI built on comate-agent-sdk
 Project-URL: Homepage, https://github.com/AndyLee1024/agent-sdk
 Project-URL: Repository, https://github.com/AndyLee1024/agent-sdk
@@ -15,8 +15,8 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <3.14,>=3.11
 Requires-Dist: charset-normalizer==3.4.7
-Requires-Dist: comate-agent-sdk<0.13,>=0.12.10
-Requires-Dist: comate-rpc<0.2,>=0.1.3
+Requires-Dist: comate-agent-sdk<0.13,>=0.12.11
+Requires-Dist: comate-rpc<0.2,>=0.1.4
 Requires-Dist: concurrent-log-handler>=0.9.25
 Requires-Dist: curl-cffi==0.13.0
 Requires-Dist: httpx<0.29.0,>=0.28.1

{comate_cli-0.12.4b3 → comate_cli-0.12.4b5}/comate_cli/main.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import atexit
 import asyncio
 from contextlib import nullcontext
+from dataclasses import dataclass
 import logging
 import os
 import signal
@@ -57,11 +58,56 @@ PRINT_OUTPUT_FORMAT_JSON = "json"
 PRINT_OUTPUT_FORMATS = frozenset({PRINT_OUTPUT_FORMAT_TEXT, PRINT_OUTPUT_FORMAT_JSON})
 PRINT_OUTPUT_FORMAT_UNSUPPORTED = frozenset({"stream-json"})
 
-# (rpc_stdio, resume_session_id, resume_select, print_prompt, output_format, rpc_relay,
+@dataclass(frozen=True)
+class PromptFlag:
+    """--system-prompt 类参数的原始值：内联文本，或文件路径（读文件留给 app 侧）。
+
+    option 是用户实际敲的参数名，报错时原样回显。
+    """
+
+    value: str
+    option: str
+
+    @property
+    def from_file(self) -> bool:
+        return self.option.endswith("-file")
+
+
+@dataclass(frozen=True)
+class SystemPromptFlags:
+    """--system-prompt[-file]（替换开头段）与 --append-system-prompt[-file]（护栏后追加）。"""
+
+    system_prompt: PromptFlag | None = None
+    append: PromptFlag | None = None
+
+    @property
+    def given(self) -> bool:
+        return self.system_prompt is not None or self.append is not None
+
+
+# 参数名 → 归属（替换开头段 / 护栏后追加）；带 -file 后缀的是文件版。名字与互斥规则对齐 Claude Code。
+_SYSTEM_PROMPT_OPTIONS: dict[str, str] = {
+    "--system-prompt": "system_prompt",
+    "--system-prompt-file": "system_prompt",
+    "--append-system-prompt": "append",
+    "--append-system-prompt-file": "append",
+}
+
+# (rpc_stdio, resume_session_id, resume_select, print_prompt, output_format, prompt_flags, rpc_relay,
 #  add_dirs, rpc_ws_port, yolo)；rpc_ws_port 为 None 表示不是 --rpc-ws，0 表示由系统挑空闲端口；
-# rpc_relay 为 None 表示不是 --rpc-relay，否则是（中转地址, Agent 令牌, 是否允许远程切到 bypassPermissions）。
+# rpc_relay 为 None 表示不是 --rpc-relay，否则是（中转地址, Agent 令牌, 是否允许远程切到 bypassPermissions）；
+# prompt_flags 是 system prompt 四个参数的原始值，没给时各字段为 None。
 ParsedArgs = tuple[
-    bool, str | None, bool, str | None, str, tuple[str, str, bool] | None, tuple[str, ...], int | None, bool
+    bool,
+    str | None,
+    bool,
+    str | None,
+    str,
+    SystemPromptFlags,
+    tuple[str, str, bool] | None,
+    tuple[str, ...],
+    int | None,
+    bool,
 ]
 # --rpc-relay 的 Agent 令牌优先从这里取（不进进程列表和 shell 历史）。
 AGENT_TOKEN_ENV = "COMATE_AGENT_TOKEN"
@@ -293,6 +339,15 @@ def _usage_text(command_name: str = "comate") -> str:
         "  --add-dir <path>   Grant tool read/write access to an extra directory\n"
         "                     (repeatable). Applies to subagents too."
         "\n"
+        "  --system-prompt <text>\n"
+        "                     Replace the opening of the system prompt (who the agent is and\n"
+        "                     how it works); guardrail sections always stay\n"
+        "  --system-prompt-file <path>\n"
+        "                     Same as --system-prompt, read from a file\n"
+        "  --append-system-prompt <text>\n"
+        "                     Append text after the system prompt's guardrail sections\n"
+        "  --append-system-prompt-file <path>\n"
+        "                     Same as --append-system-prompt, read from a file\n"
         "  --rpc-ws           Serve RPC protocol v4 over WebSocket on 127.0.0.1 only;\n"
         "                     prints one JSON ready line (url + token) to stdout\n"
         "  --port <n>         (--rpc-ws) Port to listen on; 0 or omitted = any free port\n"
@@ -356,6 +411,7 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
     output_format_explicit = False
     positionals: list[str] = []
     add_dirs: list[str] = []
+    prompt_flags: dict[str, PromptFlag] = {}
     yolo = False
 
     index = 0
@@ -437,6 +493,30 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
             add_dirs.append(value)
             index += 1
             continue
+        name, has_value, value = arg.partition("=")
+        if name in _SYSTEM_PROMPT_OPTIONS:
+            if not has_value:
+                index += 1
+                value = argv[index] if index < len(argv) else ""
+            if not value.strip():
+                from comate_cli.terminal_agent.i18n import i18n, message
+
+                raise _ArgumentError(i18n(message.system_prompt_requires_value, flag=name))
+            slot = _SYSTEM_PROMPT_OPTIONS[name]
+            previous = prompt_flags.get(slot)
+            if previous is not None and previous.option != name:
+                from comate_cli.terminal_agent.i18n import i18n, message
+
+                text_flag = name.removesuffix("-file")
+                raise _ArgumentError(
+                    i18n(message.system_prompt_flag_conflict, first=text_flag, second=f"{text_flag}-file")
+                )
+            # 文件路径去首尾空白；内联文本原样保留（SDK 渲染时再 strip）。
+            prompt_flags[slot] = PromptFlag(
+                value.strip() if name.endswith("-file") else value, option=name
+            )
+            index += 1
+            continue
         if arg.startswith("-"):
             raise _ArgumentError(f"Unknown option: {arg}")
         positionals.append(arg)
@@ -464,6 +544,10 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
 
         raise _ArgumentError(i18n(message.rpc_ws_port_without_rpc_ws))
     rpc_ws_port = _parse_rpc_ws_port(port_arg if port_arg is not None else "0") if rpc_ws else None
+    system_prompt_flags = SystemPromptFlags(
+        system_prompt=prompt_flags.get("system_prompt"),
+        append=prompt_flags.get("append"),
+    )
     rpc_flag = (
         "--rpc-stdio" if rpc_stdio else "--rpc-ws" if rpc_ws else "--rpc-relay" if rpc_relay_flag else None
     )
@@ -483,12 +567,12 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
 
             raise _ArgumentError(i18n(message.rpc_mode_print_conflict, flag=rpc_flag))
         print_prompt = " ".join(positionals) if positionals else ""
-        return rpc_stdio, None, False, print_prompt, output_format, None, tuple(add_dirs), None, yolo
+        return rpc_stdio, None, False, print_prompt, output_format, system_prompt_flags, None, tuple(add_dirs), None, yolo
 
     # Non -p mode: original logic
     if not positionals:
         return (
-            rpc_stdio, None, False, None, output_format, rpc_relay, tuple(add_dirs), rpc_ws_port, yolo
+            rpc_stdio, None, False, None, output_format, system_prompt_flags, rpc_relay, tuple(add_dirs), rpc_ws_port, yolo
         )
 
     command = positionals[0]
@@ -501,10 +585,10 @@ def _parse_args(argv: list[str]) -> ParsedArgs:
         raise _ArgumentError(i18n(message.rpc_mode_resume_unsupported, flag=rpc_flag))
 
     if len(positionals) == 1:
-        return rpc_stdio, None, True, None, output_format, None, tuple(add_dirs), None, yolo
+        return rpc_stdio, None, True, None, output_format, system_prompt_flags, None, tuple(add_dirs), None, yolo
 
     if len(positionals) == 2:
-        return rpc_stdio, positionals[1], False, None, output_format, None, tuple(add_dirs), None, yolo
+        return rpc_stdio, positionals[1], False, None, output_format, system_prompt_flags, None, tuple(add_dirs), None, yolo
 
     raise _ArgumentError("resume accepts at most one <session_id>")
 
@@ -775,6 +859,7 @@ def main(argv: list[str] | None = None, *, profile=None) -> None:
             resume_select,
             print_prompt,
             print_output_format,
+            system_prompt_flags,
             rpc_relay,
             add_dirs_raw,
             rpc_ws_port,
@@ -829,6 +914,7 @@ def main(argv: list[str] | None = None, *, profile=None) -> None:
                         print_output_format=print_output_format,
                         add_dirs=add_dirs,
                         yolo=yolo,
+                        system_prompt_flags=system_prompt_flags,
                         process_start_perf=_PROCESS_START_PERF,
                         app_import_start_perf=_app_import_start_perf,
                         app_import_done_perf=_app_import_done_perf,