commandmate 0.42.2 → 0.44.0

package/dist/server/src/lib/verification/scope-gate.js

@@ -33,10 +33,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SCOPE_SKIP_NOT_REQUIRED = exports.SCOPE_SKIP_NO_CONTRACT = exports.ScopeMatcher = exports.CONTRACT_DIR_PREFIX = exports.SCOPE_EXEMPT_CONTRACT_PATH = exports.SCOPE_EXEMPT_ALWAYS_ALLOWED = exports.SCOPE_PATTERN_ARROW = exports.ALWAYS_ALLOWED_PREFIX = exports.SCOPE_ALLOW_GUIDANCE = exports.MAX_REPORTED_VIOLATIONS = void 0;
 exports.isContractPath = isContractPath;
 exports.parsePorcelainEntries = parsePorcelainEntries;
+exports.parsePorcelainStatusEntries = parsePorcelainStatusEntries;
+exports.isSkillInstalledUntrackedEntry = isSkillInstalledUntrackedEntry;
 exports.collectChangedPaths = collectChangedPaths;
 exports.scopeSkipDetachedContract = scopeSkipDetachedContract;
 exports.evaluateScope = evaluateScope;
 const child_process_1 = require("child_process");
+const receipt_owned_paths_1 = require("../../lib/skills/receipt-owned-paths");
+const agent_state_paths_1 = require("../../lib/skills/agent-state-paths");
 /**
  * Violations listed in `log_tail` before the rest are summarised as a count.
  *
@@ -311,6 +315,10 @@ function splitNul(output) {
  * as one change (#1580).
  */
 function parsePorcelainEntries(output) {
+    return parsePorcelainStatusEntries(output).map((entry) => entry.paths);
+}
+/** {@link parsePorcelainEntries}, keeping each record's status code (#3092). */
+function parsePorcelainStatusEntries(output) {
     const fields = output.split('\0');
     const entries = [];
     let i = 0;
@@ -328,10 +336,22 @@ function parsePorcelainEntries(output) {
             if (original)
                 paths.push(original);
         }
-        entries.push(paths);
+        entries.push({ status: entry.slice(0, 2), paths });
     }
     return entries;
 }
+/**
+ * Whether a status record is an untracked file a recorded Skill install placed
+ * there, untouched since (#3092).
+ *
+ * Untracked only: a tracked Skill file that changed is a change to what the
+ * branch carries, and stays counted. `owned` comes from
+ * `collectSkillReceiptOwnedPaths`, which already rejects files whose bytes no
+ * longer match the receipt.
+ */
+function isSkillInstalledUntrackedEntry(entry, owned) {
+    return entry.status === '??' && entry.paths.every((path) => owned.has(path));
+}
 /**
  * Every path this worktree changed relative to `baseRef`.
  *
@@ -368,10 +388,30 @@ async function collectChangedPaths(worktreePath, baseRef) {
                 (status.stderr.trim() ? `\n${status.stderr.trim()}` : ''),
         };
     }
+    // Untracked files a recorded Skill install placed are CommandMate's, not the
+    // agent's (#3092). Dropped from the working-tree side only; a committed Skill
+    // file is still judged by the diff above.
+    const skillOwned = (0, receipt_owned_paths_1.collectSkillReceiptOwnedPaths)(worktreePath);
+    // Likewise the state files an agent CLI writes for itself (#3126), by an
+    // explicit declaration of paths; they are reported, not silently dropped.
+    const agentStateExcluded = new Set();
+    const workingTree = parsePorcelainStatusEntries(status.stdout).filter((entry) => {
+        if (isSkillInstalledUntrackedEntry(entry, skillOwned))
+            return false;
+        if ((0, agent_state_paths_1.isAgentStateUntrackedEntry)(entry)) {
+            entry.paths.forEach((path) => agentStateExcluded.add(path));
+            return false;
+        }
+        return true;
+    });
     // Both sides are filtered, not just the working tree: an orchestrator may
     // also have committed the contract as a setup commit (#1580).
-    const paths = new Set([...splitNul(diff.stdout), ...parsePorcelainEntries(status.stdout).flat()].filter((path) => !isContractPath(path)));
-    return { paths: [...paths].sort(), mergeBase: base };
+    const paths = new Set([...splitNul(diff.stdout), ...workingTree.flatMap((entry) => entry.paths)].filter((path) => !isContractPath(path)));
+    return {
+        paths: [...paths].sort(),
+        mergeBase: base,
+        agentStateExcluded: [...agentStateExcluded].sort(),
+    };
 }
 // =============================================================================
 // Gate evaluation
@@ -418,6 +458,18 @@ function formatAdmitted(admitted) {
         ...(remainder > 0 ? [`  ... (+${remainder} more)`] : []),
     ];
 }
+/** The `excluded:` section naming agent-managed state files left out (#3126). */
+function formatAgentStateExcluded(excluded) {
+    if (excluded.length === 0)
+        return [];
+    const listed = excluded.slice(0, exports.MAX_REPORTED_VIOLATIONS);
+    const remainder = excluded.length - listed.length;
+    return [
+        'excluded (agent-managed state files, not counted as change):',
+        ...listed.map((path) => `  ~ ${path}`),
+        ...(remainder > 0 ? [`  ... (+${remainder} more)`] : []),
+    ];
+}
 /**
  * Reasons the gate has nothing to judge, phrased for `log_tail`.
  *
@@ -440,7 +492,8 @@ exports.SCOPE_SKIP_NOT_REQUIRED = 'scope: the contract sets success.requireScope
 function scopeSkipDetachedContract(taskId, status) {
     return (`scope: task ${taskId} declares a scope for this worktree, but it is ${status} and ` +
         'this run was not attached to it, so its scope was NOT judged. ' +
-        'Name the task when starting the run (`wait --verify` does this automatically).');
+        '`wait --verify` attaches only to an in-flight task; to re-verify a finished task, run ' +
+        `\`commandmate verify <worktree> --task ${taskId}\`.`);
 }
 /**
  * Judge the worktree's changes against a contract's scope.
@@ -492,6 +545,7 @@ async function evaluateScope(worktreePath, scope, requireScopeClean, baseRef, co
         `allow: ${formatPatterns(scope.allow)}`,
         `deny: ${formatPatterns(scope.deny)}`,
         ...formatAdmitted(admitted),
+        ...formatAgentStateExcluded(changed.agentStateExcluded),
     ].join('\n');
     if (violations.length === 0) {
         // An empty change set passes: work-evidence is the gate that judges "nothing

package/dist/server/src/types/cli-tool-contracts.js

@@ -96,11 +96,18 @@ exports.GRACEFUL_EXIT_FAILURE_REASONS = ['graceful_exit_timeout', 'port_orphaned
  * | `manual`        | claude                           | `⏸ manual mode on`              |
  * | `auto`          | claude                           | `⏵⏵ auto mode on`               |
  * | `accept-edits`  | claude / Command Code / agy      | `⏵⏵ accept edits on`, `» accept edits on`, `accept-edits ·` |
- * | `plan`          | all five                         | `⏸ plan mode on`, `plan mode`, `Plan mode (shift+tab to cycle)`, `plan` |
+ * | `plan`          | all six                          | `⏸ plan mode on`, `plan mode`, `Plan mode (shift+tab to cycle)`, `plan`, `┃  Plan · <model>` |
  * | `autopilot`     | copilot                          | `autopilot` in the hint bar     |
  * | `bypass`        | Command Code (NOT in its cycle)  | `» permission bypass on`        |
  * | `dont-ask`      | Command Code (NOT in its cycle)  | `» don't-ask on`                |
  * | `default`       | Command Code                     | `? for shortcuts` (its own row) |
+ * | `build`         | OpenCode V2 (Issue #3038)        | `┃  Build · <model>` under the composer |
+ *
+ * `build` is OpenCode V2's AGENT, not a permission mode, and it is its own id
+ * rather than `default` on purpose: the chip says what the pane says (#2592).
+ * OpenCode V2's `shift+tab` toggles `Build` ⇄ `Plan` agents, and the button
+ * carries the `opencodeAgentSwitch` note so the "permission mode" wording of
+ * its aria label is not the whole story.
  *
  * `bypass` and `dont-ask` are declared even though `shift+tab` cannot REACH
  * them, and that is the point: a user who put Command Code in one of those from
@@ -118,6 +125,7 @@ exports.AGENT_MODE_IDS = [
     'autopilot',
     'bypass',
     'dont-ask',
+    'build',
 ];
 /**
  * The verdict for a frame nothing in {@link AgentModeSpec.indicators} matched.
@@ -146,4 +154,4 @@ function isAgentModeId(value) {
  * translated (`.eslintrc.json`'s i18n rule, Issue #1271), and because the tool
  * declaring it has no way to call `useTranslations()`.
  */
-exports.AGENT_MODE_NOTE_IDS = ['codexModelCoupled'];
+exports.AGENT_MODE_NOTE_IDS = ['codexModelCoupled', 'opencodeAgentSwitch'];

package/dist/types/cli-tool-contracts.d.ts

@@ -418,11 +418,18 @@ export type ToolLivenessVerdict = {
  * | `manual`        | claude                           | `⏸ manual mode on`              |
  * | `auto`          | claude                           | `⏵⏵ auto mode on`               |
  * | `accept-edits`  | claude / Command Code / agy      | `⏵⏵ accept edits on`, `» accept edits on`, `accept-edits ·` |
- * | `plan`          | all five                         | `⏸ plan mode on`, `plan mode`, `Plan mode (shift+tab to cycle)`, `plan` |
+ * | `plan`          | all six                          | `⏸ plan mode on`, `plan mode`, `Plan mode (shift+tab to cycle)`, `plan`, `┃  Plan · <model>` |
  * | `autopilot`     | copilot                          | `autopilot` in the hint bar     |
  * | `bypass`        | Command Code (NOT in its cycle)  | `» permission bypass on`        |
  * | `dont-ask`      | Command Code (NOT in its cycle)  | `» don't-ask on`                |
  * | `default`       | Command Code                     | `? for shortcuts` (its own row) |
+ * | `build`         | OpenCode V2 (Issue #3038)        | `┃  Build · <model>` under the composer |
+ *
+ * `build` is OpenCode V2's AGENT, not a permission mode, and it is its own id
+ * rather than `default` on purpose: the chip says what the pane says (#2592).
+ * OpenCode V2's `shift+tab` toggles `Build` ⇄ `Plan` agents, and the button
+ * carries the `opencodeAgentSwitch` note so the "permission mode" wording of
+ * its aria label is not the whole story.
  *
  * `bypass` and `dont-ask` are declared even though `shift+tab` cannot REACH
  * them, and that is the point: a user who put Command Code in one of those from
@@ -431,7 +438,7 @@ export type ToolLivenessVerdict = {
  * 1.53.1, where `? for shortcuts` is drawn in every mode, that fall-through is
  * a chip that says `default` while the agent bypasses permissions.
  */
-export declare const AGENT_MODE_IDS: readonly ["default", "manual", "accept-edits", "plan", "auto", "autopilot", "bypass", "dont-ask"];
+export declare const AGENT_MODE_IDS: readonly ["default", "manual", "accept-edits", "plan", "auto", "autopilot", "bypass", "dont-ask", "build"];
 /** One permission mode a supported CLI can be in. */
 export type AgentModeId = typeof AGENT_MODE_IDS[number];
 /**
@@ -482,7 +489,7 @@ export interface AgentModeIndicator {
  * translated (`.eslintrc.json`'s i18n rule, Issue #1271), and because the tool
  * declaring it has no way to call `useTranslations()`.
  */
-export declare const AGENT_MODE_NOTE_IDS: readonly ["codexModelCoupled"];
+export declare const AGENT_MODE_NOTE_IDS: readonly ["codexModelCoupled", "opencodeAgentSwitch"];
 /** Which caution one tool's mode button carries, if any. */
 export type AgentModeNoteId = typeof AGENT_MODE_NOTE_IDS[number];
 /**
@@ -516,7 +523,7 @@ export type AgentModeNoteId = typeof AGENT_MODE_NOTE_IDS[number];
  */
 export interface AgentModeSpec {
     /**
-     * The key that advances the cycle — `BTab` for all five declaring tools.
+     * The key that advances the cycle — `BTab` for all six declaring tools.
      *
      * Declared rather than hard-coded so the invariant above is checkable, and so
      * a tool that moves its binding changes one line.
@@ -554,10 +561,14 @@ export interface AgentModeSpec {
     /**
      * A caution this tool's button must carry, or `null`.
      *
-     * codex alone today: its modes are coupled to the model and reasoning effort
+     * codex: its modes are coupled to the model and reasoning effort
      * (`xhigh` ⇄ `medium`, measured 2026-09-16), so one press of a button labelled
      * "mode" also moves the model tier. Issue #2592 §「設計に効く事実」4 requires
      * that be visible rather than discovered.
+     *
+     * OpenCode V2 (Issue #3038): its `shift+tab` switches the AGENT (`Build`,
+     * which edits, ⇄ `Plan`, which only reads) rather than a permission mode, so
+     * the note says what the button actually switches.
      */
     readonly noteId: AgentModeNoteId | null;
 }

package/dist/types/cli-tool-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-tool-contracts.d.ts","sourceRoot":"","sources":["../../src/types/cli-tool-contracts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-tool-contracts.d.ts","sourceRoot":"","sources":["../../src/types/cli-tool-contracts.ts"],"names":[],"mappings":"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"}

package/dist/types/cli-tool-contracts.js

@@ -96,11 +96,18 @@ exports.GRACEFUL_EXIT_FAILURE_REASONS = ['graceful_exit_timeout', 'port_orphaned
  * | `manual`        | claude                           | `⏸ manual mode on`              |
  * | `auto`          | claude                           | `⏵⏵ auto mode on`               |
  * | `accept-edits`  | claude / Command Code / agy      | `⏵⏵ accept edits on`, `» accept edits on`, `accept-edits ·` |
- * | `plan`          | all five                         | `⏸ plan mode on`, `plan mode`, `Plan mode (shift+tab to cycle)`, `plan` |
+ * | `plan`          | all six                          | `⏸ plan mode on`, `plan mode`, `Plan mode (shift+tab to cycle)`, `plan`, `┃  Plan · <model>` |
  * | `autopilot`     | copilot                          | `autopilot` in the hint bar     |
  * | `bypass`        | Command Code (NOT in its cycle)  | `» permission bypass on`        |
  * | `dont-ask`      | Command Code (NOT in its cycle)  | `» don't-ask on`                |
  * | `default`       | Command Code                     | `? for shortcuts` (its own row) |
+ * | `build`         | OpenCode V2 (Issue #3038)        | `┃  Build · <model>` under the composer |
+ *
+ * `build` is OpenCode V2's AGENT, not a permission mode, and it is its own id
+ * rather than `default` on purpose: the chip says what the pane says (#2592).
+ * OpenCode V2's `shift+tab` toggles `Build` ⇄ `Plan` agents, and the button
+ * carries the `opencodeAgentSwitch` note so the "permission mode" wording of
+ * its aria label is not the whole story.
  *
  * `bypass` and `dont-ask` are declared even though `shift+tab` cannot REACH
  * them, and that is the point: a user who put Command Code in one of those from
@@ -118,6 +125,7 @@ exports.AGENT_MODE_IDS = [
     'autopilot',
     'bypass',
     'dont-ask',
+    'build',
 ];
 /**
  * The verdict for a frame nothing in {@link AgentModeSpec.indicators} matched.
@@ -146,4 +154,4 @@ function isAgentModeId(value) {
  * translated (`.eslintrc.json`'s i18n rule, Issue #1271), and because the tool
  * declaring it has no way to call `useTranslations()`.
  */
-exports.AGENT_MODE_NOTE_IDS = ['codexModelCoupled'];
+exports.AGENT_MODE_NOTE_IDS = ['codexModelCoupled', 'opencodeAgentSwitch'];