@dewtech/dare-cli 2.1.0 → 2.3.0

package/dist/dag-runner/adapters/cursor.js

@@ -0,0 +1,58 @@
+/**
+ * Cursor adapter — uses @cursor/sdk to execute a task as a local subagent.
+ *
+ * Env: CURSOR_API_KEY
+ *
+ * Compatible with the cookbook DAG Task Runner pattern (Agent.create + send + wait).
+ */
+import { Agent } from '@cursor/sdk';
+import { AdapterCallError, MissingApiKeyError, pickModel, } from './index.js';
+export class CursorAdapter {
+    constructor() {
+        this.name = 'cursor';
+    }
+    async call({ prompt, complexity, models, signal }) {
+        const apiKey = process.env.CURSOR_API_KEY;
+        if (!apiKey)
+            throw new MissingApiKeyError('cursor', 'CURSOR_API_KEY');
+        const model = pickModel(models, complexity);
+        let agent;
+        try {
+            agent = await Agent.create({
+                apiKey,
+                model: { id: model },
+                name: 'DARE DAG Subagent',
+            });
+            const run = await agent.send(prompt);
+            const onAbort = () => {
+                // Best-effort cancel; ignore failures.
+                run.cancel().catch(() => undefined);
+            };
+            if (signal.aborted)
+                onAbort();
+            else
+                signal.addEventListener('abort', onAbort, { once: true });
+            const result = await run.wait();
+            return { output: result.result ?? '' };
+        }
+        catch (err) {
+            if (err instanceof MissingApiKeyError)
+                throw err;
+            throw new AdapterCallError('cursor', extractErrorMessage(err), err);
+        }
+        finally {
+            try {
+                await agent?.close();
+            }
+            catch {
+                // ignore close failures — task already completed/failed
+            }
+        }
+    }
+}
+function extractErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=cursor.js.map

package/dist/dag-runner/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/dag-runner/adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,GAIV,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,aAAa;IAA1B;QACW,SAAI,GAAG,QAAiB,CAAC;IAsCpC,CAAC;IApCC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAoB;QACjE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAEtE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE5C,IAAI,KAA2D,CAAC;QAChE,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;gBACzB,MAAM;gBACN,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;gBACpB,IAAI,EAAE,mBAAmB;aAC1B,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErC,MAAM,OAAO,GAAG,GAAS,EAAE;gBACzB,uCAAuC;gBACvC,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC,CAAC;YACF,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAC;;gBACzB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB;gBAAE,MAAM,GAAG,CAAC;YACjD,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,SAAS,mBAAmB,CAAC,GAAY;IACvC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/dag-runner/adapters/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Runner adapters — execute a single DAG task by calling the underlying
+ * provider SDK (Anthropic, Cursor, Google).
+ *
+ * Each adapter must:
+ *   - read its API key from the documented env var (or throw a clear error)
+ *   - honor the AbortSignal forwarded by `withTimeout`
+ *   - return raw text output (capping is the runner's responsibility)
+ *   - report token usage when the SDK exposes it
+ */
+import type { Complexity, DagModelMap, RunnerName } from '../run_dag.js';
+export interface AdapterCallInput {
+    prompt: string;
+    complexity: Complexity;
+    models: DagModelMap;
+    signal: AbortSignal;
+}
+export interface AdapterCallResult {
+    output: string;
+    tokens?: number;
+}
+export interface RunnerAdapter {
+    readonly name: RunnerName;
+    call(input: AdapterCallInput): Promise<AdapterCallResult>;
+}
+export declare class MissingApiKeyError extends Error {
+    readonly runner: RunnerName;
+    readonly envVar: string;
+    constructor(runner: RunnerName, envVar: string);
+}
+export declare class AdapterCallError extends Error {
+    readonly runner: RunnerName;
+    readonly cause?: unknown | undefined;
+    constructor(runner: RunnerName, message: string, cause?: unknown | undefined);
+}
+/**
+ * Resolve a model id from complexity → model map, with a soft fallback.
+ */
+export declare function pickModel(models: DagModelMap | undefined, complexity: Complexity): string;
+/**
+ * Lazy factory — keeps SDK imports out of the require graph until the
+ * specific adapter is actually invoked. Avoids loading three SDKs when only
+ * one is in use.
+ */
+export declare function getAdapter(name: RunnerName): Promise<RunnerAdapter>;
+//# sourceMappingURL=index.d.ts.map

package/dist/dag-runner/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dag-runner/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3D;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aACf,MAAM,EAAE,UAAU;aAAkB,MAAM,EAAE,MAAM;gBAAlD,MAAM,EAAE,UAAU,EAAkB,MAAM,EAAE,MAAM;CAO/E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aACb,MAAM,EAAE,UAAU;aAAmC,KAAK,CAAC,EAAE,OAAO;gBAApE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAIjG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CASzF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBzE"}

package/dist/dag-runner/adapters/index.js

@@ -0,0 +1,55 @@
+export class MissingApiKeyError extends Error {
+    constructor(runner, envVar) {
+        super(`${runner} runner requires ${envVar} to be set. ` +
+            `Export it before running: setx ${envVar} <your-key>  (Windows)  or  export ${envVar}=<your-key>  (bash).`);
+        this.runner = runner;
+        this.envVar = envVar;
+        this.name = 'MissingApiKeyError';
+    }
+}
+export class AdapterCallError extends Error {
+    constructor(runner, message, cause) {
+        super(`${runner} adapter: ${message}`);
+        this.runner = runner;
+        this.cause = cause;
+        this.name = 'AdapterCallError';
+    }
+}
+/**
+ * Resolve a model id from complexity → model map, with a soft fallback.
+ */
+export function pickModel(models, complexity) {
+    if (!models) {
+        throw new Error(`No model mapping configured for complexity=${complexity}`);
+    }
+    const id = models[complexity];
+    if (!id) {
+        throw new Error(`Missing model for complexity=${complexity} in dare-dag.yaml`);
+    }
+    return id;
+}
+/**
+ * Lazy factory — keeps SDK imports out of the require graph until the
+ * specific adapter is actually invoked. Avoids loading three SDKs when only
+ * one is in use.
+ */
+export async function getAdapter(name) {
+    switch (name) {
+        case 'claude': {
+            const { ClaudeAdapter } = await import('./claude.js');
+            return new ClaudeAdapter();
+        }
+        case 'cursor': {
+            const { CursorAdapter } = await import('./cursor.js');
+            return new CursorAdapter();
+        }
+        case 'antigravity': {
+            const { AntigravityAdapter } = await import('./antigravity.js');
+            return new AntigravityAdapter();
+        }
+        default: {
+            throw new Error(`Unknown runner: ${name}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/dag-runner/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dag-runner/adapters/index.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAA4B,MAAkB,EAAkB,MAAc;QAC5E,KAAK,CACH,GAAG,MAAM,oBAAoB,MAAM,cAAc;YAC/C,kCAAkC,MAAM,sCAAsC,MAAM,sBAAsB,CAC7G,CAAC;QAJwB,WAAM,GAAN,MAAM,CAAY;QAAkB,WAAM,GAAN,MAAM,CAAQ;QAK5E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAA4B,MAAkB,EAAE,OAAe,EAAkB,KAAe;QAC9F,KAAK,CAAC,GAAG,MAAM,aAAa,OAAO,EAAE,CAAC,CAAC;QADb,WAAM,GAAN,MAAM,CAAY;QAAmC,UAAK,GAAL,KAAK,CAAU;QAE9F,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAA+B,EAAE,UAAsB;IAC/E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,UAAU,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,mBAAmB,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB;IAC/C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACtD,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACtD,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAChE,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAc,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/dag-runner/graph-ingest.d.ts

@@ -0,0 +1,17 @@
+import type { Dag, DagTask } from './run_dag.js';
+import type { KnowledgeGraph } from '../graphrag/knowledge-graph.js';
+export interface IngestOptions {
+    /** Project root used to resolve relative file paths. Defaults to cwd. */
+    cwd?: string;
+}
+/**
+ * Ingest a single task. Idempotent — re-running upserts by id.
+ */
+export declare function ingestTask(graph: KnowledgeGraph, task: DagTask, dag: Dag, _opts?: IngestOptions): void;
+/**
+ * Ingest every task of a DAG. Useful for `dare graph ingest` after an
+ * execution finishes (re-syncs the graph from in-memory DAG state).
+ */
+export declare function ingestDag(graph: KnowledgeGraph, dag: Dag, opts?: IngestOptions): void;
+export declare function extractFilePaths(text: string): string[];
+//# sourceMappingURL=graph-ingest.d.ts.map

package/dist/dag-runner/graph-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-ingest.d.ts","sourceRoot":"","sources":["../../src/dag-runner/graph-ingest.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,GAAG,EACR,KAAK,GAAE,aAAkB,GACxB,IAAI,CA+CN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,GAAE,aAAkB,GAAG,IAAI,CAEzF;AAqBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBvD"}

package/dist/dag-runner/graph-ingest.js

@@ -0,0 +1,149 @@
+/**
+ * Ingest a finished DAG task into the knowledge graph.
+ *
+ * For each task we add:
+ *   - one `task` node with status / duration / tokens metadata
+ *   - one `depends_on` edge per parent task in the DAG
+ *   - one `file` node + `implements` edge for each file the task touched
+ *
+ * "Files touched" are inferred heuristically from the task's captured output:
+ *   - explicit markers ("Created: …", "Modified: …", "File: …", "wrote …")
+ *   - bare path-like tokens with extensions (e.g. `src/auth.ts`, `tests/x.py`)
+ *
+ * The heuristic is intentionally simple — false positives are tolerated;
+ * the graph is meant to power discovery, not be a build-system source of truth.
+ */
+import path from 'path';
+/**
+ * Ingest a single task. Idempotent — re-running upserts by id.
+ */
+export function ingestTask(graph, task, dag, _opts = {}) {
+    if (!task.status || task.status === 'PENDING' || task.status === 'RUNNING')
+        return;
+    // 1) task node
+    graph.addNode({
+        id: nodeId('task', task.id),
+        type: 'task',
+        label: task.title,
+        description: task.subtask_prompt.slice(0, 500),
+        metadata: {
+            status: task.status,
+            complexity: task.complexity,
+            tokens: task.tokens,
+            duration_ms: task.duration,
+            error: task.error,
+        },
+    });
+    // 2) depends_on edges (mirror DAG)
+    for (const parentId of task.depends_on) {
+        graph.addEdge({
+            id: edgeId('depends_on', task.id, parentId),
+            sourceId: nodeId('task', task.id),
+            targetId: nodeId('task', parentId),
+            type: 'depends_on',
+        });
+    }
+    // 3) file nodes + implements edges (only for DONE tasks)
+    if (task.status !== 'DONE' || !task.output)
+        return;
+    const files = extractFilePaths(task.output);
+    for (const filePath of files) {
+        const normalized = filePath.replace(/\\/g, '/');
+        graph.addNode({
+            id: nodeId('file', normalized),
+            type: 'file',
+            label: path.basename(normalized),
+            description: normalized,
+            metadata: { path: normalized, language: detectLanguage(normalized) },
+        });
+        graph.addEdge({
+            id: edgeId('implements', task.id, normalized),
+            sourceId: nodeId('task', task.id),
+            targetId: nodeId('file', normalized),
+            type: 'implements',
+        });
+    }
+}
+/**
+ * Ingest every task of a DAG. Useful for `dare graph ingest` after an
+ * execution finishes (re-syncs the graph from in-memory DAG state).
+ */
+export function ingestDag(graph, dag, opts = {}) {
+    for (const task of dag.tasks)
+        ingestTask(graph, task, dag, opts);
+}
+// ─── Heuristics ─────────────────────────────────────────────────────────────
+// Find any token that contains a '/' and ends with .ext — explicit anchors and
+// punctuation-trimming is handled in `looksLikePath` after extraction.
+const FILE_PATH_REGEX = /[./\w-]+\/[./\w-]+/g;
+const EXPLICIT_MARKERS = [
+    /(?:created|modified|wrote|updated|added|new file)[:\s]+([^\s`'"]+)/gi,
+    /(?:^|\n)\s*[-*]\s+([^\s`'"]+\.[a-zA-Z]{1,8})\s*$/gm,
+];
+const COMMON_EXTENSIONS = new Set([
+    'ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs',
+    'py', 'rs', 'go', 'java', 'kt', 'swift',
+    'php', 'rb', 'cs', 'cpp', 'c', 'h', 'hpp',
+    'json', 'yaml', 'yml', 'toml', 'xml', 'html',
+    'css', 'scss', 'less', 'vue', 'svelte',
+    'md', 'mdx', 'sql', 'sh', 'bash', 'env', 'lock', 'gitignore',
+]);
+export function extractFilePaths(text) {
+    // Strip http/https URLs first so the path heuristic doesn't pick up
+    // tokens like "example.com/a.ts".
+    const sanitized = text.replace(/https?:\/\/\S+/g, ' ');
+    const found = new Set();
+    for (const re of EXPLICIT_MARKERS) {
+        re.lastIndex = 0;
+        for (let m; (m = re.exec(sanitized));) {
+            const cleaned = stripWrappers(m[1]);
+            if (looksLikePath(cleaned))
+                found.add(cleaned);
+        }
+    }
+    FILE_PATH_REGEX.lastIndex = 0;
+    for (let m; (m = FILE_PATH_REGEX.exec(sanitized));) {
+        const cleaned = stripWrappers(m[0]);
+        if (looksLikePath(cleaned))
+            found.add(cleaned);
+    }
+    return [...found];
+}
+function looksLikePath(p) {
+    if (p.length === 0 || p.length > 200)
+        return false;
+    if (p.startsWith('http://') || p.startsWith('https://'))
+        return false;
+    const dot = p.lastIndexOf('.');
+    if (dot < 0)
+        return false;
+    const ext = p.slice(dot + 1).toLowerCase();
+    return COMMON_EXTENSIONS.has(ext);
+}
+function stripWrappers(s) {
+    return s.replace(/^[`'"(\[]+|[`'")\],.;:!?]+$/g, '').trim();
+}
+function detectLanguage(filePath) {
+    const ext = path.extname(filePath).slice(1).toLowerCase();
+    const map = {
+        ts: 'typescript', tsx: 'typescript',
+        js: 'javascript', jsx: 'javascript', mjs: 'javascript', cjs: 'javascript',
+        py: 'python',
+        rs: 'rust',
+        go: 'go',
+        java: 'java',
+        php: 'php',
+        rb: 'ruby',
+        vue: 'vue',
+        svelte: 'svelte',
+        sql: 'sql',
+    };
+    return map[ext];
+}
+function nodeId(type, id) {
+    return `${type}:${id}`;
+}
+function edgeId(kind, from, to) {
+    return `${kind}:${from}->${to}`;
+}
+//# sourceMappingURL=graph-ingest.js.map

package/dist/dag-runner/graph-ingest.js.map

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

package/dist/dag-runner/run_dag.d.ts

@@ -1,8 +1,22 @@
 /**
- * DARE Framework - DAG Task Runner
- * Adapted from Cursor Cookbook DAG Task Runner pattern
- * Executes tasks in parallel based on dependency graph
+ * DARE DAG Task Runner — orchestration only.
+ *
+ * The DAG runner is **not** an executor. The agent inside the user's IDE
+ * (Cursor / Antigravity / Claude Code) executes each task using its native
+ * runtime — the IDE is already authenticated and the user already pays for
+ * inference there. This CLI is responsible for:
+ *
+ *   1. ordering tasks (Kahn's algorithm) and surfacing what to execute next
+ *   2. computing the prompt the agent should run, with parent-output context
+ *   3. recording status transitions (PENDING → RUNNING → DONE / FAILED / SKIPPED)
+ *   4. cascading-skip when a parent fails
+ *   5. rendering the live canvas at DARE/.canvas.md
+ *   6. (optionally) ingesting finished tasks into the knowledge graph
+ *
+ * The actual task execution loop lives outside this file: see `dare execute`
+ * (`--next` / `--complete` / `--fail`).
  */
+import type { KnowledgeGraph } from '../graphrag/knowledge-graph.js';
 export type Complexity = 'LOW' | 'MED' | 'HIGH';
 export type RunnerName = 'cursor' | 'claude' | 'antigravity';
 export type TaskStatus = 'PENDING' | 'RUNNING' | 'DONE' | 'FAILED' | 'SKIPPED';
@@ -16,46 +30,59 @@ export interface DagTask {
     spec_file?: string;
     status?: TaskStatus;
     output?: string;
+    error?: string;
     tokens?: number;
     duration?: number;
 }
-/** Hard limits applied per task during execution. */
 export interface DagLimits {
-    /** Snippet (in chars) of each parent's output injected into a child's context. */
     parent_context_chars: number;
-    /** Cap (in chars) on the captured output of a single task. */
     task_output_chars: number;
-    /** Per-task timeout, used by AbortController. */
     timeout_seconds: number;
 }
-/** complexity → model mapping. */
 export type DagModelMap = Record<Complexity, string>;
-/**
- * Full models block. New schema is per-runner (cursor / claude / antigravity).
- * Legacy flat schema (HIGH/MED/LOW directly) is also accepted by the parser
- * and normalized to the runner-keyed form on read.
- */
 export type DagModels = Partial<Record<RunnerName, DagModelMap>>;
 export interface Dag {
     title: string;
     version: string;
-    /** Optional ISO timestamp set when the YAML was generated. */
     generated?: string;
-    /** Optional execution limits (defaults applied if missing). */
     limits?: DagLimits;
-    /** Per-runner model mapping. */
     models: DagModels;
     tasks: DagTask[];
 }
-/** Defaults used when a YAML omits the `limits` block. */
 export declare const DEFAULT_DAG_LIMITS: DagLimits;
-export interface RunDagOptions {
-    parallel: boolean;
-    runner: string;
-    canvasPath: string;
-}
 /**
- * Main DAG runner - executes tasks in parallel based on dependency ranks
+ * Compute execution ranks for tasks based on dependencies. Tasks in the same
+ * rank can run in parallel (logical parallelism: the IDE agent decides
+ * whether to literally fan them out or run them back-to-back).
+ */
+export declare function computeRanks(tasks: DagTask[]): Map<string, number>;
+/**
+ * Return the next batch of tasks the agent should execute now: PENDING tasks
+ * whose every parent is DONE. These can be executed in parallel by the agent.
+ *
+ * If `currentRankOnly` is true (default), restrict to the lowest rank that
+ * still has executable tasks — gives a clean "rank-by-rank" cadence.
+ */
+export declare function nextExecutableTasks(dag: Dag, currentRankOnly?: boolean): DagTask[];
+/**
+ * Cascade: any PENDING task whose dependency is FAILED/SKIPPED becomes SKIPPED.
+ * Returns the list of newly-skipped tasks (caller can ingest them).
+ */
+export declare function applyCascadingSkip(dag: Dag): DagTask[];
+/**
+ * Compose the prompt for a given task: the task's `subtask_prompt` plus an
+ * "Upstream context" block with capped snippets of each parent's output.
  */
-export declare function runDag(dag: Dag, options: RunDagOptions): Promise<void>;
+export declare function buildTaskPrompt(dag: Dag, task: DagTask): string;
+export interface MarkOptions {
+    output?: string;
+    error?: string;
+    tokens?: number;
+    durationMs?: number;
+    graph?: KnowledgeGraph;
+}
+export declare function markRunning(dag: Dag, taskId: string): DagTask;
+export declare function markDone(dag: Dag, taskId: string, opts?: MarkOptions): DagTask;
+export declare function markFailed(dag: Dag, taskId: string, opts?: MarkOptions): DagTask;
+export declare function renderCanvas(dag: Dag, canvasPath: string): Promise<void>;
 //# sourceMappingURL=run_dag.d.ts.map

package/dist/dag-runner/run_dag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_dag.d.ts","sourceRoot":"","sources":["../../src/dag-runner/run_dag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AA2FD;;GAEG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4F5E"}
+{"version":3,"file":"run_dag.d.ts","sourceRoot":"","sources":["../../src/dag-runner/run_dag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BlE;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,UAAO,GAAG,OAAO,EAAE,CAa/E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,EAAE,CAoBtD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAW/D;AAMD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAUlF;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAUpF;AAcD,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC9E"}