@dewtech/dare-cli 3.8.2 → 3.10.0

package/dist/agent/__tests__/mock-driver.test.js

@@ -0,0 +1,100 @@
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mockDriver } from '../drivers/mock.js';
+import { noopDriver } from '../drivers/noop.js';
+import { safeSpawn } from '../../exec/safe-spawn.js';
+async function initGitRepo(dir) {
+    await safeSpawn('git', ['init'], { cwd: dir, timeoutSeconds: 30 });
+    await safeSpawn('git', ['add', '.'], { cwd: dir, timeoutSeconds: 30 });
+    await safeSpawn('git', ['commit', '-m', 'baseline', '--allow-empty'], {
+        cwd: dir,
+        timeoutSeconds: 30,
+        env: {
+            ...process.env,
+            GIT_AUTHOR_NAME: 'dare-test',
+            GIT_AUTHOR_EMAIL: 'test@dare.local',
+            GIT_COMMITTER_NAME: 'dare-test',
+            GIT_COMMITTER_EMAIL: 'test@dare.local',
+        },
+    });
+}
+describe('mockDriver', () => {
+    let worktree;
+    beforeEach(async () => {
+        worktree = await fs.mkdtemp(path.join(os.tmpdir(), 'dare-mock-wt-'));
+        await initGitRepo(worktree);
+    });
+    afterEach(async () => {
+        await fs.remove(worktree).catch(() => undefined);
+    });
+    it('should_apply_fixture_patch', async () => {
+        const result = await mockDriver.run({
+            taskId: 'mock-fixture-task',
+            spec: '# spec',
+            steering: [],
+            worktree,
+            budgetRemaining: 1000,
+            signal: new AbortController().signal,
+        });
+        expect(result.status).toBe('implemented');
+        expect((await fs.readFile(path.join(worktree, 'applied.txt'), 'utf8')).trim()).toBe('mock-fixture-applied');
+    });
+    it('should_be_deterministic', async () => {
+        const input = {
+            taskId: 'mock-fixture-task',
+            spec: '# spec',
+            steering: [],
+            worktree,
+            budgetRemaining: 1000,
+            signal: new AbortController().signal,
+        };
+        const a = await mockDriver.run(input);
+        const b = await mockDriver.run(input);
+        expect(a.summary).toBe(b.summary);
+        expect(a.usage).toEqual(b.usage);
+    });
+    it('should_report_zero_usage', async () => {
+        const result = await mockDriver.run({
+            taskId: 'mock-fixture-task',
+            spec: '# spec',
+            steering: [],
+            worktree,
+            budgetRemaining: 1000,
+            signal: new AbortController().signal,
+        });
+        expect(result.usage).toEqual({
+            inputTokens: 0,
+            outputTokens: 0,
+            costUsd: 0,
+            model: 'mock',
+        });
+    });
+    it('should_abort_on_signal', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        const result = await mockDriver.run({
+            taskId: 'mock-fixture-task',
+            spec: '# spec',
+            steering: [],
+            worktree,
+            budgetRemaining: 1000,
+            signal: controller.signal,
+        });
+        expect(result.status).toBe('aborted');
+    });
+    it('noop_returns_aborted', async () => {
+        const result = await noopDriver.run({
+            taskId: 'any',
+            spec: '# spec',
+            steering: [],
+            worktree,
+            budgetRemaining: 1000,
+            signal: new AbortController().signal,
+        });
+        expect(result.status).toBe('aborted');
+        expect(noopDriver.requiresNetwork).toBe(false);
+    });
+});
+//# sourceMappingURL=mock-driver.test.js.map

package/dist/agent/__tests__/mock-driver.test.js.map

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

package/dist/agent/__tests__/no-llm-in-core.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=no-llm-in-core.test.d.ts.map

package/dist/agent/__tests__/no-llm-in-core.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-llm-in-core.test.d.ts","sourceRoot":"","sources":["../../../src/agent/__tests__/no-llm-in-core.test.ts"],"names":[],"mappings":""}

package/dist/agent/__tests__/no-llm-in-core.test.js

@@ -0,0 +1,46 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, it, expect } from 'vitest';
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+const ALLOWED_REL = path.join('src', 'agent', 'drivers', 'claude.ts');
+const FORBIDDEN = /(?:import|require)\s*\(?['"]@anthropic-ai|from\s+['"]@anthropic-ai/;
+function walkTsFiles(dir, base = pkgRoot) {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === '__tests__' || entry.name === 'node_modules')
+                continue;
+            files.push(...walkTsFiles(full, base));
+            continue;
+        }
+        if (!entry.name.endsWith('.ts'))
+            continue;
+        if (entry.name.endsWith('.test.ts') || entry.name.endsWith('.spec.ts'))
+            continue;
+        files.push(path.relative(base, full));
+    }
+    return files;
+}
+function listSourceFiles() {
+    return walkTsFiles(path.join(pkgRoot, 'src')).filter((f) => path.normalize(f) !== path.normalize(ALLOWED_REL));
+}
+function findLlmSdkImports() {
+    return listSourceFiles().filter((rel) => {
+        const content = readFileSync(path.join(pkgRoot, rel), 'utf8');
+        return FORBIDDEN.test(content);
+    });
+}
+describe('no-llm-in-core', () => {
+    it('passes_on_clean_tree', () => {
+        const offenders = findLlmSdkImports();
+        expect(offenders, `LLM SDK imported outside ${ALLOWED_REL}`).toEqual([]);
+    });
+    it('detects_planted_import', () => {
+        const sample = "import Anthropic from '@anthropic-ai/sdk';";
+        expect(FORBIDDEN.test(sample)).toBe(true);
+    });
+});
+//# sourceMappingURL=no-llm-in-core.test.js.map

package/dist/agent/__tests__/no-llm-in-core.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-llm-in-core.test.js","sourceRoot":"","sources":["../../../src/agent/__tests__/no-llm-in-core.test.ts"],"names":[],"mappings":"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"}

package/dist/agent/budget.d.ts

@@ -0,0 +1,15 @@
+import type { TokenUsage } from './driver.js';
+export declare class BudgetTracker {
+    private readonly totalTokens;
+    private spentTokens;
+    private spentUsd;
+    constructor(totalTokens: number | null);
+    add(usage: TokenUsage): void;
+    remaining(): number;
+    exhausted(): boolean;
+    get spent(): {
+        tokens: number;
+        usd: number;
+    };
+}
+//# sourceMappingURL=budget.d.ts.map

package/dist/agent/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,WAAW;IAHxC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAK;gBAEQ,WAAW,EAAE,MAAM,GAAG,IAAI;IAEvD,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAK5B,SAAS,IAAI,MAAM;IAMnB,SAAS,IAAI,OAAO;IAIpB,IAAI,KAAK,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAE3C;CACF"}

package/dist/agent/budget.js

@@ -0,0 +1,23 @@
+export class BudgetTracker {
+    constructor(totalTokens) {
+        this.totalTokens = totalTokens;
+        this.spentTokens = 0;
+        this.spentUsd = 0;
+    }
+    add(usage) {
+        this.spentTokens += usage.inputTokens + usage.outputTokens;
+        this.spentUsd += usage.costUsd;
+    }
+    remaining() {
+        return this.totalTokens === null
+            ? Number.POSITIVE_INFINITY
+            : Math.max(0, this.totalTokens - this.spentTokens);
+    }
+    exhausted() {
+        return this.remaining() <= 0;
+    }
+    get spent() {
+        return { tokens: this.spentTokens, usd: this.spentUsd };
+    }
+}
+//# sourceMappingURL=budget.js.map

package/dist/agent/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAIxB,YAA6B,WAA0B;QAA1B,gBAAW,GAAX,WAAW,CAAe;QAH/C,gBAAW,GAAG,CAAC,CAAC;QAChB,aAAQ,GAAG,CAAC,CAAC;IAEqC,CAAC;IAE3D,GAAG,CAAC,KAAiB;QACnB,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC;QAC3D,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,WAAW,KAAK,IAAI;YAC9B,CAAC,CAAC,MAAM,CAAC,iBAAiB;YAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC1D,CAAC;CACF"}

package/dist/agent/driver.d.ts

@@ -0,0 +1,46 @@
+import type { GuardedArtifact } from '../guard/types.js';
+export interface TokenUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    /** estimado a partir do modelo */
+    readonly costUsd: number;
+    readonly model: string;
+}
+/**
+ * Entrada para {@link AgentDriver.run}.
+ *
+ * Pré-condição: `spec` e cada item de `steering` já passaram pelo guard (verdict ≠ FAIL).
+ */
+export interface AgentRunInput {
+    readonly taskId: string;
+    /** EXECUTION/task-*.md já validado pelo guard */
+    readonly spec: string;
+    /** só artefatos PASS/WARN */
+    readonly steering: ReadonlyArray<GuardedArtifact>;
+    readonly worktree: string;
+    readonly budgetRemaining: number;
+    /** cancelamento por budget/aprovação */
+    readonly signal: AbortSignal;
+}
+/**
+ * Resultado de uma execução de agente.
+ *
+ * Pós-condição: em `status: 'implemented'` há patch aplicável no `worktree`;
+ * `usage` sempre preenchido.
+ */
+export interface AgentRunResult {
+    readonly status: 'implemented' | 'failed' | 'aborted';
+    readonly worktree: string;
+    /** não-autoritativo */
+    readonly summary: string;
+    readonly usage: TokenUsage;
+    /** alimenta decideNextAction */
+    readonly failureSignature?: string;
+}
+export interface AgentDriver {
+    /** 'mock' | 'noop' | 'claude' */
+    readonly id: string;
+    readonly requiresNetwork: boolean;
+    run(input: AgentRunInput): Promise<AgentRunResult>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/agent/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/agent/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACpD"}

package/dist/agent/driver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/agent/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/agent/driver.ts"],"names":[],"mappings":""}

package/dist/agent/drivers/claude.d.ts

@@ -0,0 +1,43 @@
+import type { AgentDriver } from '../driver.js';
+export interface ClaudeDriverOptions {
+    readonly model: string;
+    readonly apiKeyEnv?: string;
+    readonly maxTokens?: number;
+}
+export declare class AgentSdkMissingError extends Error {
+    readonly code: "AGENT_SDK_MISSING";
+    constructor();
+}
+type ClaudeMessageResponse = {
+    readonly usage?: {
+        readonly input_tokens?: number;
+        readonly output_tokens?: number;
+    };
+    readonly content?: ReadonlyArray<{
+        readonly type?: string;
+        readonly text?: string;
+    }>;
+};
+type ClaudeClient = {
+    readonly messages: {
+        create(payload: {
+            readonly model: string;
+            readonly max_tokens: number;
+            readonly messages: ReadonlyArray<{
+                readonly role: 'user';
+                readonly content: string;
+            }>;
+        }, requestOptions?: {
+            readonly signal?: AbortSignal;
+        }): Promise<ClaudeMessageResponse>;
+    };
+};
+type ClaudeSdkModule = {
+    readonly default: new (options: {
+        readonly apiKey: string;
+    }) => ClaudeClient;
+};
+export declare function setClaudeSdkImporterForTests(importer: (() => Promise<ClaudeSdkModule>) | null): void;
+export declare function createClaudeDriver(opts: ClaudeDriverOptions): Promise<AgentDriver>;
+export {};
+//# sourceMappingURL=claude.d.ts.map

package/dist/agent/drivers/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/agent/drivers/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,cAAc,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;;CAQ9C;AAED,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CACJ,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,QAAQ,EAAE;QACjB,MAAM,CACJ,OAAO,EAAE;YACP,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;gBAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACvF,EACD,cAAc,CAAC,EAAE;YAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjD,OAAO,CAAC,qBAAqB,CAAC,CAAC;KACnC,CAAC;CACH,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,KAAK,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,YAAY,CAAC;CAC9E,CAAC;AAqBF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,CAAC,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,IAAI,GAChD,IAAI,CAEN;AA2DD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsExF"}

package/dist/agent/drivers/claude.js

@@ -0,0 +1,134 @@
+export class AgentSdkMissingError extends Error {
+    constructor() {
+        super("Optional dependency '@anthropic-ai/sdk' not installed. Run: npm i @anthropic-ai/sdk — or use --dry-run.");
+        this.code = 'AGENT_SDK_MISSING';
+        this.name = 'AgentSdkMissingError';
+    }
+}
+const DEFAULT_API_KEY_ENV = 'ANTHROPIC_API_KEY';
+const DEFAULT_MAX_TOKENS = 1200;
+const MODEL_COST_PER_MILLION = [
+    { matcher: /haiku/i, inputUsd: 0.8, outputUsd: 4 },
+    { matcher: /sonnet/i, inputUsd: 3, outputUsd: 15 },
+    { matcher: /opus/i, inputUsd: 15, outputUsd: 75 },
+];
+async function importClaudeSdk() {
+    return (await import('@anthropic-ai/sdk'));
+}
+let sdkImporter = importClaudeSdk;
+export function setClaudeSdkImporterForTests(importer) {
+    sdkImporter = importer ?? importClaudeSdk;
+}
+function estimateCostUsd(model, inputTokens, outputTokens) {
+    const pricing = MODEL_COST_PER_MILLION.find((entry) => entry.matcher.test(model)) ?? MODEL_COST_PER_MILLION[1];
+    const inputCost = (inputTokens / 1000000) * pricing.inputUsd;
+    const outputCost = (outputTokens / 1000000) * pricing.outputUsd;
+    return Number((inputCost + outputCost).toFixed(6));
+}
+function summarizeContent(response) {
+    const chunks = response.content
+        ?.filter((chunk) => chunk.type === 'text' && typeof chunk.text === 'string')
+        .map((chunk) => chunk.text?.trim() ?? '')
+        .filter(Boolean) ?? [];
+    return chunks.length > 0 ? chunks.join('\n') : 'claude run completed';
+}
+function usageFromResponse(model, response) {
+    const inputTokens = Math.max(0, Math.trunc(response.usage?.input_tokens ?? 0));
+    const outputTokens = Math.max(0, Math.trunc(response.usage?.output_tokens ?? 0));
+    return {
+        inputTokens,
+        outputTokens,
+        costUsd: estimateCostUsd(model, inputTokens, outputTokens),
+        model,
+    };
+}
+function zeroUsage(model) {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        costUsd: 0,
+        model,
+    };
+}
+function buildPrompt(input) {
+    const steeringList = input.steering.length > 0
+        ? input.steering
+            .map((artifact) => `- ${artifact.path} (${artifact.origin}/${artifact.channel})`)
+            .join('\n')
+        : '- none';
+    return [
+        `Task: ${input.taskId}`,
+        `Worktree: ${input.worktree}`,
+        `Budget remaining tokens: ${input.budgetRemaining}`,
+        'Steering artifacts:',
+        steeringList,
+        '',
+        'Specification:',
+        input.spec,
+    ].join('\n');
+}
+export async function createClaudeDriver(opts) {
+    let sdk;
+    try {
+        sdk = await sdkImporter();
+    }
+    catch {
+        throw new AgentSdkMissingError();
+    }
+    const apiKeyEnv = opts.apiKeyEnv ?? DEFAULT_API_KEY_ENV;
+    const apiKey = process.env[apiKeyEnv];
+    if (!apiKey) {
+        throw new Error(`Missing Claude API key in env var ${apiKeyEnv}.`);
+    }
+    const client = new sdk.default({ apiKey });
+    return {
+        id: 'claude',
+        requiresNetwork: true,
+        async run(input) {
+            if (input.signal.aborted) {
+                return {
+                    status: 'aborted',
+                    worktree: input.worktree,
+                    summary: 'claude aborted by signal',
+                    usage: zeroUsage(opts.model),
+                };
+            }
+            try {
+                const response = await client.messages.create({
+                    model: opts.model,
+                    max_tokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,
+                    messages: [
+                        {
+                            role: 'user',
+                            content: buildPrompt(input),
+                        },
+                    ],
+                }, { signal: input.signal });
+                return {
+                    status: 'implemented',
+                    worktree: input.worktree,
+                    summary: summarizeContent(response),
+                    usage: usageFromResponse(opts.model, response),
+                };
+            }
+            catch (error) {
+                if (input.signal.aborted) {
+                    return {
+                        status: 'aborted',
+                        worktree: input.worktree,
+                        summary: 'claude aborted by signal',
+                        usage: zeroUsage(opts.model),
+                    };
+                }
+                return {
+                    status: 'failed',
+                    worktree: input.worktree,
+                    summary: 'claude run failed',
+                    usage: zeroUsage(opts.model),
+                    failureSignature: error instanceof Error ? error.name : 'ClaudeRunError',
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/agent/drivers/claude.js.map

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

package/dist/agent/drivers/mock.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDriver } from '../driver.js';
+export declare const mockDriver: AgentDriver;
+//# sourceMappingURL=mock.d.ts.map

package/dist/agent/drivers/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/agent/drivers/mock.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsChD,eAAO,MAAM,UAAU,EAAE,WAsBxB,CAAC"}

package/dist/agent/drivers/mock.js

@@ -0,0 +1,56 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fs from 'fs-extra';
+import { safeSpawn } from '../../exec/safe-spawn.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const FIXTURES_DIR = path.join(__dirname, '..', '__fixtures__', 'patches');
+const ZERO_USAGE = {
+    inputTokens: 0,
+    outputTokens: 0,
+    costUsd: 0,
+    model: 'mock',
+};
+async function applyFixturePatch(worktree, taskId) {
+    const patchPath = path.join(FIXTURES_DIR, `${taskId}.diff`);
+    if (!(await fs.pathExists(patchPath)))
+        return false;
+    await fs.ensureDir(worktree);
+    const patch = await fs.readFile(patchPath, 'utf8');
+    const tmpPatch = path.join(worktree, '.dare-mock.patch');
+    await fs.writeFile(tmpPatch, patch);
+    const apply = await safeSpawn('git', ['apply', '--whitespace=nowarn', tmpPatch], {
+        cwd: worktree,
+        timeoutSeconds: 30,
+        maxChars: 8000,
+    });
+    await fs.remove(tmpPatch).catch(() => undefined);
+    if (apply.code !== 0) {
+        const err = apply.stderr.trim();
+        if (err.includes('already exists in working directory'))
+            return true;
+        throw new Error(`mock patch apply failed: ${err}`);
+    }
+    return true;
+}
+export const mockDriver = {
+    id: 'mock',
+    requiresNetwork: false,
+    async run(input) {
+        if (input.signal.aborted) {
+            return {
+                status: 'aborted',
+                worktree: input.worktree,
+                summary: 'mock aborted by signal',
+                usage: { ...ZERO_USAGE },
+            };
+        }
+        await applyFixturePatch(input.worktree, input.taskId);
+        return {
+            status: 'implemented',
+            worktree: input.worktree,
+            summary: `mock applied for ${input.taskId}`,
+            usage: { ...ZERO_USAGE },
+        };
+    },
+};
+//# sourceMappingURL=mock.js.map

package/dist/agent/drivers/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../../src/agent/drivers/mock.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;AAE3E,MAAM,UAAU,GAAG;IACjB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,MAAM;CACL,CAAC;AAEX,KAAK,UAAU,iBAAiB,CAC9B,QAAgB,EAChB,MAAc;IAEd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEpC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,CAAC,EAAE;QAC/E,GAAG,EAAE,QAAQ;QACb,cAAc,EAAE,EAAE;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAAE,OAAO,IAAI,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,EAAE,EAAE,MAAM;IACV,eAAe,EAAE,KAAK;IACtB,KAAK,CAAC,GAAG,CAAC,KAAK;QACb,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,wBAAwB;gBACjC,KAAK,EAAE,EAAE,GAAG,UAAU,EAAE;aACzB,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtD,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,oBAAoB,KAAK,CAAC,MAAM,EAAE;YAC3C,KAAK,EAAE,EAAE,GAAG,UAAU,EAAE;SACzB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/agent/drivers/noop.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDriver } from '../driver.js';
+export declare const noopDriver: AgentDriver;
+//# sourceMappingURL=noop.d.ts.map

package/dist/agent/drivers/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../src/agent/drivers/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,eAAO,MAAM,UAAU,EAAE,WAWxB,CAAC"}

package/dist/agent/drivers/noop.js

@@ -0,0 +1,13 @@
+export const noopDriver = {
+    id: 'noop',
+    requiresNetwork: false,
+    async run(input) {
+        return {
+            status: 'aborted',
+            worktree: input.worktree,
+            summary: 'noop',
+            usage: { inputTokens: 0, outputTokens: 0, costUsd: 0, model: 'noop' },
+        };
+    },
+};
+//# sourceMappingURL=noop.js.map

package/dist/agent/drivers/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../src/agent/drivers/noop.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,EAAE,EAAE,MAAM;IACV,eAAe,EAAE,KAAK;IACtB,KAAK,CAAC,GAAG,CAAC,KAAK;QACb,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;SACtE,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/agent/telemetry.d.ts

@@ -0,0 +1,4 @@
+import type { KnowledgeGraph } from '../graphrag/knowledge-graph.js';
+import type { TokenUsage } from './driver.js';
+export declare function recordCostTelemetry(graph: KnowledgeGraph, taskId: string, total: TokenUsage, attempts: number): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/agent/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/agent/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,IAAI,CAqBN"}

package/dist/agent/telemetry.js

@@ -0,0 +1,25 @@
+function resolveTaskNodeId(taskId) {
+    return taskId.startsWith('task:') ? taskId : `task:${taskId}`;
+}
+export function recordCostTelemetry(graph, taskId, total, attempts) {
+    const canonicalTaskId = resolveTaskNodeId(taskId);
+    const node = graph.getNode(canonicalTaskId) ?? graph.getNode(taskId);
+    if (!node)
+        return;
+    graph.addNode({
+        ...node,
+        metadata: {
+            ...node.metadata,
+            inputTokens: total.inputTokens,
+            outputTokens: total.outputTokens,
+            costUsd: total.costUsd,
+            model: total.model,
+            attempts,
+        },
+    });
+    const pendingFlush = graph.flush?.();
+    if (pendingFlush) {
+        void pendingFlush.catch(() => undefined);
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/agent/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/agent/telemetry.ts"],"names":[],"mappings":"AAGA,SAAS,iBAAiB,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAqB,EACrB,MAAc,EACd,KAAiB,EACjB,QAAgB;IAEhB,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,KAAK,CAAC,OAAO,CAAC;QACZ,GAAG,IAAI;QACP,QAAQ,EAAE;YACR,GAAG,IAAI,CAAC,QAAQ;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ;SACT;KACF,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IACrC,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/bin/dare.js

@@ -21,6 +21,7 @@ import { benchCommand } from '../commands/bench.js';
 import { steeringCommand } from '../commands/steering.js';
 import { hooksCommand } from '../commands/hooks.js';
 import { patternsCommand } from '../commands/patterns.js';
+import { guardCommand } from '../commands/guard.js';
 import { skillCommand } from '../skills/index.js';
 import { welcomeCommand } from '../commands/welcome.js';
 import { printBanner } from '../utils/banner.js';
@@ -52,6 +53,7 @@ program.addCommand(benchCommand);
 program.addCommand(steeringCommand);
 program.addCommand(hooksCommand);
 program.addCommand(patternsCommand);
+program.addCommand(guardCommand);
 program.addCommand(skillCommand);
 program.addCommand(welcomeCommand);
 // Show banner + help when invoked with no subcommand