@kawacode/mcp 6.1.5 → 6.8.0

package/build/stop/uncompleted-commit.js

@@ -0,0 +1,188 @@
+/**
+ * Pure transcript detection for the complete_intent hard gate (kawacode-on-stop
+ * job 3). Kept separate from the bin entry so it's unit-testable without
+ * triggering the hook's main().
+ *
+ * The signal we want: the agent ran `git commit` but never finalized the work
+ * with complete_intent. We read Claude Code's own transcript (harness
+ * introspection — not Muninn's concern) and compare the position of the last
+ * SUCCESSFUL commit against the last complete_intent call.
+ */
+/** Flatten a tool_result `content` (string | array of {type,text}) to plain text. */
+export function toolResultText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map(c => (typeof c === 'string' ? c : typeof c?.text === 'string' ? c.text : ''))
+            .join(' ');
+    }
+    return '';
+}
+/** A Bash command that *invokes* `git commit` (incl. `git -C <path> commit`),
+ *  excluding dry runs. NOTE: a true match here is necessary but NOT sufficient —
+ *  a command can merely MENTION "git commit" as data (printf/echo/heredoc/docs,
+ *  `git log --grep`). Confirm an actual commit with {@link looksLikeCommitOutput}
+ *  on the tool_result before treating it as a commit. */
+export function isGitCommitCommand(name, cmd) {
+    if (name !== 'Bash' || !cmd)
+        return false;
+    if (/--dry-run/.test(cmd))
+        return false;
+    return /\bgit\s+(?:-C\s+\S+\s+)?commit\b/.test(cmd);
+}
+/**
+ * True when text contains git's commit-success line: `[<ref> <shorthash>] …`
+ * (covers commit / amend / merge / cherry-pick / root-commit). This is the
+ * authoritative "a commit actually happened" signal — `git log`/`git show` and
+ * non-git output don't produce a bracketed short-hash line, and a command that
+ * only mentions "git commit" as data produces no such output at all.
+ *
+ * Tradeoff: `git commit --quiet` suppresses this line, so a quiet commit is a
+ * false NEGATIVE (no gate). That's the safe bias for a hard gate — a missed nag
+ * is far less disruptive than a false block (the printf-in-transcript bug).
+ */
+export function looksLikeCommitOutput(text) {
+    return /\[[^\]\n]*\b[0-9a-f]{7,40}\b[^\]\n]*\]/.test(text);
+}
+/**
+ * True when the transcript shows a SUCCESSFUL `git commit` tool_use that lands
+ * after the most recent complete_intent tool_use (or with no complete_intent
+ * after it) — i.e. the agent committed without finalizing.
+ *
+ * A commit counts only when BOTH hold: the command invokes git commit AND its
+ * tool_result carries the commit-success signature (not is_error). Requiring
+ * the result signature is what stops a command that merely *mentions* "git
+ * commit" (e.g. a printf crafting a fixture) from being read as a real commit.
+ * A complete_intent call counts even if it later failed (conflicts): the agent
+ * tried, so we don't nag.
+ *
+ * @param transcriptText raw JSONL contents of the Claude Code transcript
+ */
+export function detectUncompletedCommit(transcriptText) {
+    const lines = transcriptText.split('\n');
+    const commits = [];
+    const results = new Map();
+    let lastCompleteIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const ln = lines[i].trim();
+        if (!ln)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(ln);
+        }
+        catch {
+            continue;
+        }
+        const content = obj?.message?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const item of content) {
+            if (item?.type === 'tool_use') {
+                const name = item.name || '';
+                if (/complete_intent/.test(name)) {
+                    lastCompleteIdx = i;
+                }
+                else if (isGitCommitCommand(name, item?.input?.command || '')) {
+                    commits.push({ idx: i, id: item.id });
+                }
+            }
+            else if (item?.type === 'tool_result' && item.tool_use_id) {
+                results.set(item.tool_use_id, {
+                    isError: item.is_error === true,
+                    text: toolResultText(item.content),
+                });
+            }
+        }
+    }
+    // Most recent commit CONFIRMED by its result signature. A candidate with no
+    // result, an errored result, or output lacking the signature does not count.
+    let lastCommitIdx = -1;
+    for (const c of commits) {
+        if (!c.id)
+            continue;
+        const r = results.get(c.id);
+        if (!r || r.isError)
+            continue;
+        if (!looksLikeCommitOutput(r.text))
+            continue;
+        if (c.idx > lastCommitIdx)
+            lastCommitIdx = c.idx;
+    }
+    if (lastCommitIdx === -1)
+        return false;
+    return lastCommitIdx > lastCompleteIdx;
+}
+/**
+ * Gate-SAVE detection (VALUE_METRICS.md V8): the inverse of an uncompleted
+ * commit — a CONFIRMED `git commit` exists AND a complete_intent call lands at
+ * or after it (the commit was finalized). Used at the Stop hook to emit the
+ * acted-on signal only when a prior gate block held the turn open
+ * (`stop_hook_active`) and the agent then completed the intent — i.e. the gate
+ * preceded a completion that would otherwise have skipped distillation +
+ * block auto-capture.
+ *
+ * Mirrors detectUncompletedCommit's parsing exactly (a commit counts only when
+ * its tool_result carries the commit-success signature, per decision 64b340d8 —
+ * a command merely MENTIONING "git commit" does not count) and flips the final
+ * position comparison.
+ *
+ * Correlation, not causation: this says "a completion followed a confirmed
+ * commit while the turn was held open", not "the gate caused the completion".
+ */
+export function detectGateSave(transcriptText) {
+    const lines = transcriptText.split('\n');
+    const commits = [];
+    const results = new Map();
+    let lastCompleteIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const ln = lines[i].trim();
+        if (!ln)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(ln);
+        }
+        catch {
+            continue;
+        }
+        const content = obj?.message?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const item of content) {
+            if (item?.type === 'tool_use') {
+                const name = item.name || '';
+                if (/complete_intent/.test(name)) {
+                    lastCompleteIdx = i;
+                }
+                else if (isGitCommitCommand(name, item?.input?.command || '')) {
+                    commits.push({ idx: i, id: item.id });
+                }
+            }
+            else if (item?.type === 'tool_result' && item.tool_use_id) {
+                results.set(item.tool_use_id, {
+                    isError: item.is_error === true,
+                    text: toolResultText(item.content),
+                });
+            }
+        }
+    }
+    let lastCommitIdx = -1;
+    for (const c of commits) {
+        if (!c.id)
+            continue;
+        const r = results.get(c.id);
+        if (!r || r.isError)
+            continue;
+        if (!looksLikeCommitOutput(r.text))
+            continue;
+        if (c.idx > lastCommitIdx)
+            lastCommitIdx = c.idx;
+    }
+    if (lastCommitIdx === -1)
+        return false;
+    // A complete_intent at or after the last confirmed commit = the commit is finalized.
+    return lastCompleteIdx >= lastCommitIdx;
+}
+//# sourceMappingURL=uncompleted-commit.js.map

package/build/stop/uncompleted-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uncompleted-commit.js","sourceRoot":"","sources":["../../src/stop/uncompleted-commit.ts"],"names":[],"mappings":"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"}

package/build/stop/uncompleted-commit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/stop/uncompleted-commit.test.js

@@ -0,0 +1,135 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { detectGateSave, detectUncompletedCommit, isGitCommitCommand, looksLikeCommitOutput, toolResultText, } from './uncompleted-commit.js';
+/** A realistic `git commit` success result (the bracketed short-hash line). */
+const COMMIT_OK = '[main 1a2b3c4] Add the thing\n 1 file changed, 2 insertions(+)';
+// ---- transcript line builders (Claude Code JSONL shape) ----
+function bash(command, id) {
+    return JSON.stringify({
+        type: 'assistant',
+        message: { role: 'assistant', content: [{ type: 'tool_use', name: 'Bash', id, input: { command } }] },
+    });
+}
+function toolUse(name, id) {
+    return JSON.stringify({
+        type: 'assistant',
+        message: { role: 'assistant', content: [{ type: 'tool_use', name, id, input: {} }] },
+    });
+}
+function result(toolUseId, opts = {}) {
+    return JSON.stringify({
+        type: 'user',
+        message: {
+            role: 'user',
+            content: [{ type: 'tool_result', tool_use_id: toolUseId, is_error: opts.isError ?? false, content: opts.text ?? 'ok' }],
+        },
+    });
+}
+const COMPLETE = 'mcp__kawa-intents__complete_intent';
+test('isGitCommitCommand', async (t) => {
+    await t.test('plain commit', () => assert.equal(isGitCommitCommand('Bash', 'git commit -m "x"'), true));
+    await t.test('git -C path commit', () => assert.equal(isGitCommitCommand('Bash', 'git -C /repo commit -am "x"'), true));
+    await t.test('chained with &&', () => assert.equal(isGitCommitCommand('Bash', 'git add -A && git commit -m "x"'), true));
+    await t.test('dry-run excluded', () => assert.equal(isGitCommitCommand('Bash', 'git commit --dry-run'), false));
+    await t.test('non-Bash tool excluded', () => assert.equal(isGitCommitCommand('Edit', 'git commit -m "x"'), false));
+    await t.test('git log mentioning commit not matched', () => assert.equal(isGitCommitCommand('Bash', 'git log --pretty=%H'), false));
+});
+test('toolResultText flattens shapes', async (t) => {
+    await t.test('string', () => assert.equal(toolResultText('hello'), 'hello'));
+    await t.test('array of text parts', () => assert.equal(toolResultText([{ type: 'text', text: 'a' }, { type: 'text', text: 'b' }]), 'a b'));
+    await t.test('other → empty', () => assert.equal(toolResultText({ foo: 1 }), ''));
+});
+test('looksLikeCommitOutput', async (t) => {
+    await t.test('standard commit line', () => assert.equal(looksLikeCommitOutput('[main 1a2b3c4] msg'), true));
+    await t.test('root commit', () => assert.equal(looksLikeCommitOutput('[main (root-commit) 0e1f2a3] init'), true));
+    await t.test('detached HEAD', () => assert.equal(looksLikeCommitOutput('[detached HEAD abc1234] msg'), true));
+    await t.test('nothing-to-commit output → false', () => assert.equal(looksLikeCommitOutput('nothing to commit, working tree clean'), false));
+    await t.test('empty (printf wrote a file) → false', () => assert.equal(looksLikeCommitOutput(''), false));
+    await t.test('git log oneline → false', () => assert.equal(looksLikeCommitOutput('1a2b3c4 some subject\nded5678 another'), false));
+});
+test('detectUncompletedCommit', async (t) => {
+    await t.test('no commit at all → false', () => {
+        const t1 = [toolUse('Read', 'r1'), result('r1')].join('\n');
+        assert.equal(detectUncompletedCommit(t1), false);
+    });
+    await t.test('confirmed commit with no completion → true', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { text: COMMIT_OK })].join('\n');
+        assert.equal(detectUncompletedCommit(t1), true);
+    });
+    await t.test('REGRESSION: command merely MENTIONS "git commit" (printf, no commit output) → false', () => {
+        // The printf-in-transcript false positive: a Bash command that contains the
+        // string "git commit" as data, writing a fixture; its result has no commit
+        // signature, so it must NOT be read as a real commit.
+        const printf = bash(`printf '%s' '{"command":"git commit -m \\"x\\""}' > /tmp/fixture.jsonl`, 'p1');
+        const t1 = [printf, result('p1', { text: '' })].join('\n');
+        assert.equal(detectUncompletedCommit(t1), false);
+    });
+    await t.test('command looks like commit but result has no signature → false', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { text: 'ok' })].join('\n');
+        assert.equal(detectUncompletedCommit(t1), false);
+    });
+    await t.test('commit then complete_intent → false', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { text: COMMIT_OK }), toolUse(COMPLETE, 'k1'), result('k1')].join('\n');
+        assert.equal(detectUncompletedCommit(t1), false);
+    });
+    await t.test('complete then a NEW confirmed commit after it → true', () => {
+        const t1 = [
+            bash('git commit -m "a"', 'c1'), result('c1', { text: COMMIT_OK }),
+            toolUse(COMPLETE, 'k1'), result('k1'),
+            bash('git commit -m "b"', 'c2'), result('c2', { text: '[main 9f8e7d6] b\n 1 file changed' }),
+        ].join('\n');
+        assert.equal(detectUncompletedCommit(t1), true);
+    });
+    await t.test('failed commit (is_error) → false', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { isError: true, text: 'fatal' })].join('\n');
+        assert.equal(detectUncompletedCommit(t1), false);
+    });
+    await t.test('"nothing to commit" → false', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { text: 'On branch main\nnothing to commit, working tree clean' })].join('\n');
+        assert.equal(detectUncompletedCommit(t1), false);
+    });
+    await t.test('attempted complete_intent (failed, conflicts) still suppresses the gate', () => {
+        // complete_intent was called after the commit even though it may have failed
+        // (conflicts) — the agent tried, so no nag.
+        const t1 = [
+            bash('git commit -m "x"', 'c1'), result('c1', { text: COMMIT_OK }),
+            toolUse(COMPLETE, 'k1'), result('k1', { text: '{ "success": false, "reason": "conflicts" }' }),
+        ].join('\n');
+        assert.equal(detectUncompletedCommit(t1), false);
+    });
+    await t.test('garbage / non-JSON lines are skipped', () => {
+        const t1 = ['', 'not json', bash('git commit -m "x"', 'c1'), result('c1', { text: COMMIT_OK })].join('\n');
+        assert.equal(detectUncompletedCommit(t1), true);
+    });
+});
+test('detectGateSave (VALUE_METRICS V8 acted-on)', async (t) => {
+    await t.test('confirmed commit then complete_intent → true (the inverse of uncompleted)', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { text: COMMIT_OK }), toolUse(COMPLETE, 'k1'), result('k1')].join('\n');
+        assert.equal(detectGateSave(t1), true);
+    });
+    await t.test('confirmed commit with NO completion → false (gate would still fire, not a save)', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { text: COMMIT_OK })].join('\n');
+        assert.equal(detectGateSave(t1), false);
+    });
+    await t.test('no commit at all → false', () => {
+        const t1 = [toolUse(COMPLETE, 'k1'), result('k1')].join('\n');
+        assert.equal(detectGateSave(t1), false);
+    });
+    await t.test('command merely MENTIONS "git commit" then complete → false (no confirmed commit)', () => {
+        const printf = bash(`printf '%s' 'git commit -m x' > /tmp/f`, 'p1');
+        const t1 = [printf, result('p1', { text: '' }), toolUse(COMPLETE, 'k1'), result('k1')].join('\n');
+        assert.equal(detectGateSave(t1), false);
+    });
+    await t.test('complete BEFORE the last confirmed commit → false (commit not finalized)', () => {
+        const t1 = [
+            toolUse(COMPLETE, 'k1'), result('k1'),
+            bash('git commit -m "later"', 'c1'), result('c1', { text: COMMIT_OK }),
+        ].join('\n');
+        assert.equal(detectGateSave(t1), false);
+    });
+    await t.test('failed commit (is_error) then complete → false', () => {
+        const t1 = [bash('git commit -m "x"', 'c1'), result('c1', { isError: true, text: 'fatal' }), toolUse(COMPLETE, 'k1'), result('k1')].join('\n');
+        assert.equal(detectGateSave(t1), false);
+    });
+});
+//# sourceMappingURL=uncompleted-commit.test.js.map

package/build/stop/uncompleted-commit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uncompleted-commit.test.js","sourceRoot":"","sources":["../../src/stop/uncompleted-commit.test.ts"],"names":[],"mappings":"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"}

package/build/telemetry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Context-injection telemetry (VALUE_METRICS.md Phase 2, Track B).
+ *
+ * At each of the 5 injection points where Kawa adds context to an agent's turn,
+ * we SIZE the payload we're about to inject (≈ chars/4 tokens) and emit a
+ * fire-and-forget IPC to Muninn, which forwards it to kawa.api. This is the COST
+ * side of the headline ratio ("Kawa adds ≈N tokens/turn"), paired with an
+ * "acted on" signal for the benefit side.
+ *
+ * Keep-mcp-thin: this module ONLY sizes + hashes + forwards. No storage, no API
+ * client, no business logic — Muninn owns the forward and the API owns the
+ * store. Every emit is fire-and-forget and swallows its own errors, so telemetry
+ * can never block or fail a tool call or a hook.
+ *
+ * Zero-knowledge: we emit token COUNTS, item COUNTS, and opaque decision ids
+ * only — never the strings measured. The repo origin is HASHED here before it
+ * leaves the process (`hashOrigin`, byte-identical to
+ * kawa.api/scripts/value-report.ts so `--repo` filtering matches).
+ */
+export type InjectionType = 'recall' | 'pre_edit' | 'stop_gate' | 'stop_collision' | 'check_active';
+/** ≈ tokens for a string payload (chars/4, rounded up). Labelled "≈" wherever published. */
+export declare function estimateTokens(s: string | undefined | null): number;
+/**
+ * Hash a repo origin for the zero-knowledge aggregate. MUST stay byte-identical
+ * to `hashOrigin` in kawa.api/scripts/value-report.ts (which hashes the
+ * lowercased origin) so a `--repo <origin>` filter matches these rows. Callers
+ * pass the lowercased origin.
+ */
+export declare function hashOrigin(origin: string): string;
+/**
+ * Emit one context-injection sizing. Fire-and-forget: returns a resolved
+ * promise even on failure. Callers in the long-lived server may ignore the
+ * result; hook callers should include it in their pre-disconnect await set so
+ * the socket write flushes before the process exits.
+ */
+export declare function emitInjection(args: {
+    type: InjectionType;
+    tokensEst: number;
+    itemCount: number;
+    /** raw repo origin — hashed here before it leaves the process */
+    repoOrigin: string;
+    /** recall only — surfaced decision ids, for the read-side recall→supersedes join */
+    decisionIds?: string[];
+}): Promise<void>;
+/**
+ * Emit one "acted on" signal (R2 acted-on rate; V8 gate-saves when
+ * type='stop_gate'). Fire-and-forget.
+ */
+export declare function emitActedOn(args: {
+    type: InjectionType;
+    /** the surfaced id that was used (e.g. a decisionId) */
+    refId?: string;
+    repoOrigin: string;
+}): Promise<void>;

package/build/telemetry.js

@@ -0,0 +1,84 @@
+/**
+ * Context-injection telemetry (VALUE_METRICS.md Phase 2, Track B).
+ *
+ * At each of the 5 injection points where Kawa adds context to an agent's turn,
+ * we SIZE the payload we're about to inject (≈ chars/4 tokens) and emit a
+ * fire-and-forget IPC to Muninn, which forwards it to kawa.api. This is the COST
+ * side of the headline ratio ("Kawa adds ≈N tokens/turn"), paired with an
+ * "acted on" signal for the benefit side.
+ *
+ * Keep-mcp-thin: this module ONLY sizes + hashes + forwards. No storage, no API
+ * client, no business logic — Muninn owns the forward and the API owns the
+ * store. Every emit is fire-and-forget and swallows its own errors, so telemetry
+ * can never block or fail a tool call or a hook.
+ *
+ * Zero-knowledge: we emit token COUNTS, item COUNTS, and opaque decision ids
+ * only — never the strings measured. The repo origin is HASHED here before it
+ * leaves the process (`hashOrigin`, byte-identical to
+ * kawa.api/scripts/value-report.ts so `--repo` filtering matches).
+ */
+import * as crypto from 'node:crypto';
+import { request, SESSION_ID } from './services/muninn-ipc.js';
+/** Coarse char→token approximation; deterministic, no tokenizer dep. Matches
+ *  CHARS_PER_TOKEN in kawacode-on-pre-edit.ts and the "≈ chars/4" method the
+ *  value-report publishes. */
+const CHARS_PER_TOKEN = 4;
+/** ≈ tokens for a string payload (chars/4, rounded up). Labelled "≈" wherever published. */
+export function estimateTokens(s) {
+    return Math.ceil((s ? s.length : 0) / CHARS_PER_TOKEN);
+}
+/**
+ * Hash a repo origin for the zero-knowledge aggregate. MUST stay byte-identical
+ * to `hashOrigin` in kawa.api/scripts/value-report.ts (which hashes the
+ * lowercased origin) so a `--repo <origin>` filter matches these rows. Callers
+ * pass the lowercased origin.
+ */
+export function hashOrigin(origin) {
+    return 'sha256:' + crypto.createHash('sha256').update(origin || '').digest('hex').slice(0, 16);
+}
+function enabled() {
+    return process.env.KAWA_VALUE_TELEMETRY !== 'off';
+}
+/** ISO timestamp (informational; the API windows on its own _c). */
+function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * Emit one context-injection sizing. Fire-and-forget: returns a resolved
+ * promise even on failure. Callers in the long-lived server may ignore the
+ * result; hook callers should include it in their pre-disconnect await set so
+ * the socket write flushes before the process exits.
+ */
+export function emitInjection(args) {
+    if (!enabled())
+        return Promise.resolve();
+    const data = {
+        type: args.type,
+        tokensEst: args.tokensEst,
+        itemCount: args.itemCount,
+        sessionId: SESSION_ID,
+        repoOriginHash: hashOrigin((args.repoOrigin || '').toLowerCase()),
+        ts: nowIso(),
+    };
+    if (args.decisionIds && args.decisionIds.length)
+        data.decisionIds = args.decisionIds;
+    return request('telemetry', 'record', data).then(() => { }).catch(() => { });
+}
+/**
+ * Emit one "acted on" signal (R2 acted-on rate; V8 gate-saves when
+ * type='stop_gate'). Fire-and-forget.
+ */
+export function emitActedOn(args) {
+    if (!enabled())
+        return Promise.resolve();
+    const data = {
+        type: args.type,
+        sessionId: SESSION_ID,
+        repoOriginHash: hashOrigin((args.repoOrigin || '').toLowerCase()),
+        ts: nowIso(),
+    };
+    if (args.refId)
+        data.refId = args.refId;
+    return request('telemetry', 'acted_on', data).then(() => { }).catch(() => { });
+}
+//# sourceMappingURL=telemetry.js.map

package/build/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE9D;;8BAE8B;AAC9B,MAAM,eAAe,GAAG,CAAC,CAAA;AAIzB,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,CAA4B;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAA;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAChG,CAAC;AAED,SAAS,OAAO;IACd,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,KAAK,CAAA;AACnD,CAAC;AAED,oEAAoE;AACpE,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAQ7B;IACC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IACxC,MAAM,IAAI,GAAwB;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,EAAE,EAAE,MAAM,EAAE;KACb,CAAA;IACD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM;QAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;IACpF,OAAO,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAK3B;IACC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IACxC,MAAM,IAAI,GAAwB;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,EAAE,EAAE,MAAM,EAAE;KACb,CAAA;IACD,IAAI,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IACvC,OAAO,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AAC9E,CAAC"}

package/build/tools/activate-intent.d.ts

@@ -17,10 +17,8 @@ export declare const activateIntentSchema: z.ZodObject<{
     repoOrigin: z.ZodOptional<z.ZodString>;
     repoPath: z.ZodString;
     intentId: z.ZodString;
-    force: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     repoPath: string;
-    force: boolean;
     intentId: string;
     repoOrigin?: string | undefined;
     forkAuthor?: {
@@ -39,22 +37,14 @@ export declare const activateIntentSchema: z.ZodObject<{
         forkOrigin: string;
     } | undefined;
     workspaceId?: string | undefined;
-    force?: boolean | undefined;
 }>;
 export type ActivateIntentInput = z.infer<typeof activateIntentSchema>;
-export interface ActiveIntentLockConflict {
-    existingIntentId: string;
-    title?: string;
-    createdBy?: string;
-    author?: string;
-}
 export interface ActivateIntentResponse {
     success: boolean;
     intentId: string;
-    action?: 'activated' | 'already_active' | 'conflict';
+    action?: 'activated' | 'already_active';
     previousActiveId?: string;
     message: string;
-    lockConflict?: ActiveIntentLockConflict;
 }
 export declare function activateIntent(input: ActivateIntentInput): Promise<ActivateIntentResponse>;
 export declare const activateIntentTool: {
@@ -78,10 +68,8 @@ export declare const activateIntentTool: {
         repoOrigin: z.ZodOptional<z.ZodString>;
         repoPath: z.ZodString;
         intentId: z.ZodString;
-        force: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         repoPath: string;
-        force: boolean;
         intentId: string;
         repoOrigin?: string | undefined;
         forkAuthor?: {
@@ -100,7 +88,6 @@ export declare const activateIntentTool: {
             forkOrigin: string;
         } | undefined;
         workspaceId?: string | undefined;
-        force?: boolean | undefined;
     }>;
     handler: typeof activateIntent;
 };