@dewtech/dare-cli 2.1.0 → 2.3.0

package/dist/dag-runner/utils/timeout.js

@@ -0,0 +1,55 @@
+/**
+ * Run an async operation with a hard timeout, backed by `AbortController`.
+ *
+ * The operation receives the controller's `signal` — adapters MUST forward
+ * it to their underlying SDK call (Anthropic, Cursor, Google) so an external
+ * abort is honored. If the SDK doesn't support cancellation, we still time
+ * out at the JS level via the racing promise.
+ *
+ * Also accepts an optional `externalSignal` so a SIGINT/SIGTERM listener can
+ * cancel everything in flight.
+ */
+export class TaskTimeoutError extends Error {
+    constructor(timeoutSeconds) {
+        super(`Task exceeded ${timeoutSeconds}s timeout`);
+        this.timeoutSeconds = timeoutSeconds;
+        this.name = 'TaskTimeoutError';
+    }
+}
+export class TaskAbortedError extends Error {
+    constructor(reason = 'aborted') {
+        super(`Task aborted: ${reason}`);
+        this.name = 'TaskAbortedError';
+    }
+}
+export async function withTimeout(op, { timeoutSeconds, externalSignal }) {
+    const controller = new AbortController();
+    // Forward external aborts (e.g. SIGINT handler) to our controller.
+    const onExternal = () => controller.abort('external');
+    if (externalSignal) {
+        if (externalSignal.aborted)
+            controller.abort('external');
+        else
+            externalSignal.addEventListener('abort', onExternal, { once: true });
+    }
+    const timer = setTimeout(() => controller.abort('timeout'), timeoutSeconds * 1000);
+    try {
+        return await Promise.race([
+            op({ signal: controller.signal }),
+            new Promise((_, reject) => {
+                controller.signal.addEventListener('abort', () => {
+                    const reason = controller.signal.reason ?? 'aborted';
+                    reject(reason === 'timeout'
+                        ? new TaskTimeoutError(timeoutSeconds)
+                        : new TaskAbortedError(String(reason)));
+                }, { once: true });
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+        if (externalSignal)
+            externalSignal.removeEventListener('abort', onExternal);
+    }
+}
+//# sourceMappingURL=timeout.js.map

package/dist/dag-runner/utils/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../../src/dag-runner/utils/timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAA4B,cAAsB;QAChD,KAAK,CAAC,iBAAiB,cAAc,WAAW,CAAC,CAAC;QADxB,mBAAc,GAAd,cAAc,CAAQ;QAEhD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,MAAM,GAAG,SAAS;QAC5B,KAAK,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAuC,EACvC,EAAE,cAAc,EAAE,cAAc,EAAsB;IAEtD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,mEAAmE;IACnE,MAAM,UAAU,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,cAAc,CAAC,OAAO;YAAE,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;;YACpD,cAAc,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;IAEnF,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC3B,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;oBAC/C,MAAM,MAAM,GAAI,UAAU,CAAC,MAAM,CAAC,MAA6B,IAAI,SAAS,CAAC;oBAC7E,MAAM,CAAC,MAAM,KAAK,SAAS;wBACzB,CAAC,CAAC,IAAI,gBAAgB,CAAC,cAAc,CAAC;wBACtC,CAAC,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC5C,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACrB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,cAAc;YAAE,cAAc,CAAC,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/graphrag/factory.d.ts

@@ -0,0 +1,25 @@
+import type { KnowledgeGraph } from './knowledge-graph.js';
+export type GraphBackend = 'sqlite' | 'json' | 'neo4j';
+export interface GraphConfig {
+    backend: GraphBackend;
+    /** Path to the persistence target, relative to the project root. */
+    path?: string;
+}
+/**
+ * Resolve graph config:
+ *   - if `explicit` is given, use it;
+ *   - otherwise read `dare-graph.yml` from cwd (or `cwd` if provided);
+ *   - if no file exists, fall back to sqlite at `.dare/graph.db`.
+ */
+export declare function loadGraphConfig(opts?: {
+    cwd?: string;
+    explicit?: GraphConfig;
+}): Promise<GraphConfig>;
+/**
+ * Build the backend instance and call `init()`. Caller owns the lifecycle and
+ * must call `.close()` when done.
+ */
+export declare function createGraph(config: GraphConfig, opts?: {
+    cwd?: string;
+}): Promise<KnowledgeGraph>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/graphrag/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/graphrag/factory.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAQD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,WAAW,CAAC;CACnB,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB5B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1B,OAAO,CAAC,cAAc,CAAC,CAqBzB"}

package/dist/graphrag/factory.js

@@ -0,0 +1,66 @@
+/**
+ * `createGraph()` — read `dare-graph.yml` (or take an explicit config) and
+ * return the matching backend instance.
+ *
+ * Supported backends:
+ *  - `sqlite`  → `GraphRAG` (sql.js)
+ *  - `json`    → `JsonGraph` (single JSON file, no native deps)
+ *  - `neo4j`   → not yet implemented (throws with guidance)
+ */
+import path from 'path';
+import fs from 'fs-extra';
+import { parse as parseYaml } from 'yaml';
+import { GraphRAG } from './graph-rag.js';
+import { JsonGraph } from './json-graph.js';
+const DEFAULTS = {
+    sqlite: '.dare/graph.db',
+    json: '.dare/graph.json',
+    neo4j: undefined,
+};
+/**
+ * Resolve graph config:
+ *   - if `explicit` is given, use it;
+ *   - otherwise read `dare-graph.yml` from cwd (or `cwd` if provided);
+ *   - if no file exists, fall back to sqlite at `.dare/graph.db`.
+ */
+export async function loadGraphConfig(opts = {}) {
+    if (opts.explicit) {
+        return normalize(opts.explicit);
+    }
+    const cwd = opts.cwd ?? process.cwd();
+    const ymlPath = path.join(cwd, 'dare-graph.yml');
+    if (!(await fs.pathExists(ymlPath))) {
+        return { backend: 'sqlite', path: DEFAULTS.sqlite };
+    }
+    const raw = (await fs.readFile(ymlPath, 'utf-8')).toString();
+    const parsed = (parseYaml(raw) ?? {});
+    const backend = parsed.backend ?? 'sqlite';
+    const subBlock = parsed[backend] ?? {};
+    const filePath = typeof subBlock.path === 'string' ? subBlock.path : DEFAULTS[backend];
+    return normalize({ backend, path: filePath });
+}
+/**
+ * Build the backend instance and call `init()`. Caller owns the lifecycle and
+ * must call `.close()` when done.
+ */
+export async function createGraph(config, opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const cfg = normalize(config);
+    if (cfg.backend === 'neo4j') {
+        throw new Error('Neo4j backend is not yet implemented in @dewtech/dare-cli. Use `backend: sqlite` or `backend: json` in dare-graph.yml. (PRs welcome.)');
+    }
+    if (!cfg.path) {
+        throw new Error(`dare-graph.yml is missing the storage path for backend=${cfg.backend}.`);
+    }
+    const absPath = path.isAbsolute(cfg.path) ? cfg.path : path.resolve(cwd, cfg.path);
+    const graph = cfg.backend === 'sqlite' ? new GraphRAG(absPath) : new JsonGraph(absPath);
+    await graph.init();
+    return graph;
+}
+function normalize(cfg) {
+    return {
+        backend: cfg.backend,
+        path: cfg.path ?? DEFAULTS[cfg.backend],
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/graphrag/factory.js.map

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

package/dist/graphrag/index.d.ts

@@ -1,3 +1,7 @@
 export { GraphRAG } from './graph-rag.js';
+export { JsonGraph } from './json-graph.js';
+export { createGraph, loadGraphConfig } from './factory.js';
+export type { KnowledgeGraph } from './knowledge-graph.js';
+export type { GraphConfig, GraphBackend } from './factory.js';
 export type { GraphNode, GraphEdge, NodeType, EdgeType, TaskNode, FileNode, SchemaNode, EndpointNode, ComponentNode, SearchResult, GraphStatistics, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/graphrag/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphrag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphrag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/graphrag/index.js

@@ -1,2 +1,4 @@
 export { GraphRAG } from './graph-rag.js';
+export { JsonGraph } from './json-graph.js';
+export { createGraph, loadGraphConfig } from './factory.js';
 //# sourceMappingURL=index.js.map

package/dist/graphrag/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graphrag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graphrag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/graphrag/json-graph.d.ts

@@ -0,0 +1,28 @@
+import type { KnowledgeGraph, GraphNode, GraphEdge, NodeType, SearchResult, GraphStatistics } from './knowledge-graph.js';
+export declare class JsonGraph implements KnowledgeGraph {
+    private readonly filePath;
+    private nodes;
+    private edges;
+    constructor(filePath: string);
+    init(): Promise<void>;
+    addNode(node: GraphNode): void;
+    getNode(id: string): GraphNode | null;
+    queryNodes(type?: NodeType, limit?: number): GraphNode[];
+    searchNodes(query: string, limit?: number): SearchResult[];
+    deleteNode(id: string): void;
+    addEdge(edge: GraphEdge): void;
+    getEdges(nodeId: string, direction?: 'out' | 'in' | 'both'): GraphEdge[];
+    getNodeDependencies(nodeId: string, depth?: number): GraphNode[];
+    getStatistics(): GraphStatistics;
+    exportToJson(): {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+    importFromJson(data: {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    }): void;
+    close(): void;
+    private flushSync;
+}
+//# sourceMappingURL=json-graph.d.ts.map

package/dist/graphrag/json-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-graph.d.ts","sourceRoot":"","sources":["../../src/graphrag/json-graph.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EAER,YAAY,EACZ,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAO9B,qBAAa,SAAU,YAAW,cAAc;IAIlC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,KAAK,CAAgC;gBAEhB,QAAQ,EAAE,MAAM;IAEvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAqB9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,SAAK,GAAG,SAAS,EAAE;IAOpD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE;IAiBtD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU5B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAS9B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,IAAI,GAAG,MAAe,GAAG,SAAS,EAAE;IAQhF,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,SAAS,EAAE;IAqB3D,aAAa,IAAI,eAAe;IAiBhC,YAAY,IAAI;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAI1D,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI;IAKtE,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,SAAS;CAWlB"}

package/dist/graphrag/json-graph.js

@@ -0,0 +1,168 @@
+/**
+ * JsonGraph — minimal in-memory knowledge graph persisted to a JSON file.
+ *
+ * Useful for projects that want zero native dependencies (no sql.js).
+ * Trade-offs vs SQLite: no FTS, no SQL queries, full file rewrite on each
+ * mutation. Good enough for small DARE projects (<10k nodes).
+ */
+import path from 'path';
+import fs from 'fs-extra';
+export class JsonGraph {
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.nodes = new Map();
+        this.edges = new Map();
+    }
+    async init() {
+        await fs.ensureDir(path.dirname(this.filePath));
+        if (await fs.pathExists(this.filePath)) {
+            try {
+                const data = (await fs.readJson(this.filePath));
+                for (const n of data.nodes ?? [])
+                    this.nodes.set(n.id, n);
+                for (const e of data.edges ?? [])
+                    this.edges.set(e.id, e);
+            }
+            catch {
+                // corrupt file — start fresh, but keep a backup
+                await fs.copy(this.filePath, `${this.filePath}.corrupt-${Date.now()}`);
+            }
+        }
+        this.flushSync();
+    }
+    // ─── Nodes ────────────────────────────────────────────────────────────────
+    addNode(node) {
+        const now = new Date().toISOString();
+        const existing = this.nodes.get(node.id);
+        const merged = existing
+            ? {
+                ...existing,
+                label: node.label,
+                description: node.description,
+                metadata: node.metadata ?? existing.metadata ?? {},
+                updatedAt: now,
+            }
+            : {
+                ...node,
+                metadata: node.metadata ?? {},
+                createdAt: node.createdAt ?? now,
+                updatedAt: now,
+            };
+        this.nodes.set(node.id, merged);
+        this.flushSync();
+    }
+    getNode(id) {
+        return this.nodes.get(id) ?? null;
+    }
+    queryNodes(type, limit = 20) {
+        const all = type
+            ? [...this.nodes.values()].filter((n) => n.type === type)
+            : [...this.nodes.values()];
+        return all.slice(0, limit);
+    }
+    searchNodes(query, limit = 10) {
+        const q = query.toLowerCase();
+        const out = [];
+        for (const node of this.nodes.values()) {
+            const haystack = `${node.label} ${node.description ?? ''}`.toLowerCase();
+            if (haystack.includes(q)) {
+                out.push({
+                    node,
+                    score: 1,
+                    snippet: node.description?.slice(0, 150),
+                });
+                if (out.length >= limit)
+                    break;
+            }
+        }
+        return out;
+    }
+    deleteNode(id) {
+        this.nodes.delete(id);
+        for (const [edgeId, e] of this.edges) {
+            if (e.sourceId === id || e.targetId === id)
+                this.edges.delete(edgeId);
+        }
+        this.flushSync();
+    }
+    // ─── Edges ────────────────────────────────────────────────────────────────
+    addEdge(edge) {
+        const existing = this.edges.get(edge.id);
+        const merged = existing
+            ? { ...existing, type: edge.type, weight: edge.weight ?? existing.weight ?? 1, metadata: edge.metadata ?? existing.metadata ?? {} }
+            : { ...edge, weight: edge.weight ?? 1, metadata: edge.metadata ?? {} };
+        this.edges.set(edge.id, merged);
+        this.flushSync();
+    }
+    getEdges(nodeId, direction = 'both') {
+        return [...this.edges.values()].filter((e) => {
+            if (direction === 'out')
+                return e.sourceId === nodeId;
+            if (direction === 'in')
+                return e.targetId === nodeId;
+            return e.sourceId === nodeId || e.targetId === nodeId;
+        });
+    }
+    getNodeDependencies(nodeId, depth = 3) {
+        const visited = new Set();
+        const out = [];
+        const traverse = (id, d) => {
+            if (d === 0 || visited.has(id))
+                return;
+            visited.add(id);
+            for (const e of this.edges.values()) {
+                if (e.sourceId !== id || e.type !== 'depends_on')
+                    continue;
+                const target = this.nodes.get(e.targetId);
+                if (target) {
+                    out.push(target);
+                    traverse(e.targetId, d - 1);
+                }
+            }
+        };
+        traverse(nodeId, depth);
+        return out;
+    }
+    // ─── Utilities ────────────────────────────────────────────────────────────
+    getStatistics() {
+        const nodesByType = {};
+        const edgesByType = {};
+        for (const n of this.nodes.values()) {
+            nodesByType[n.type] = (nodesByType[n.type] ?? 0) + 1;
+        }
+        for (const e of this.edges.values()) {
+            edgesByType[e.type] = (edgesByType[e.type] ?? 0) + 1;
+        }
+        return {
+            totalNodes: this.nodes.size,
+            totalEdges: this.edges.size,
+            nodesByType,
+            edgesByType,
+        };
+    }
+    exportToJson() {
+        return { nodes: [...this.nodes.values()], edges: [...this.edges.values()] };
+    }
+    importFromJson(data) {
+        for (const n of data.nodes)
+            this.addNode(n);
+        for (const e of data.edges)
+            this.addEdge(e);
+    }
+    close() {
+        // Synchronous flush is performed on every mutation; no shutdown work.
+    }
+    flushSync() {
+        const data = {
+            nodes: [...this.nodes.values()],
+            edges: [...this.edges.values()],
+        };
+        try {
+            fs.writeJsonSync(this.filePath, data, { spaces: 2 });
+        }
+        catch {
+            // best-effort persistence
+        }
+    }
+}
+//# sourceMappingURL=json-graph.js.map

package/dist/graphrag/json-graph.js.map

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

package/dist/graphrag/knowledge-graph.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Common interface implemented by every backend (SQLite, JSON, Neo4j…).
+ *
+ * Methods mirror the SQLite implementation so callers don't care which
+ * backend is in use. Backends should:
+ *  - upsert by `id` on addNode / addEdge
+ *  - persist incrementally (or on close, when that's safer)
+ *  - never throw on unknown ids — return `null` / empty arrays
+ */
+import type { GraphNode, GraphEdge, NodeType, EdgeType, SearchResult, GraphStatistics } from './types.js';
+export interface KnowledgeGraph {
+    init(): Promise<void>;
+    addNode(node: GraphNode): void;
+    getNode(id: string): GraphNode | null;
+    queryNodes(type?: NodeType, limit?: number): GraphNode[];
+    searchNodes(query: string, limit?: number): SearchResult[];
+    deleteNode(id: string): void;
+    addEdge(edge: GraphEdge): void;
+    getEdges(nodeId: string, direction?: 'out' | 'in' | 'both'): GraphEdge[];
+    getNodeDependencies(nodeId: string, depth?: number): GraphNode[];
+    getStatistics(): GraphStatistics;
+    exportToJson(): {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+    importFromJson(data: {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    }): void;
+    close(): void;
+}
+export type { NodeType, EdgeType, GraphNode, GraphEdge, SearchResult, GraphStatistics };
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/graphrag/knowledge-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/graphrag/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACzD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;IACzE,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAEjE,aAAa,IAAI,eAAe,CAAC;IAEjC,YAAY,IAAI;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAC3D,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAEvE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/graphrag/knowledge-graph.js

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

package/dist/graphrag/knowledge-graph.js.map

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

package/dist/index.d.ts

@@ -2,20 +2,27 @@
  * @dewtech/dare-cli — pacote único do framework DARE.
  *
  * Inclui CLI (`dare`), servidor MCP (`dare-mcp-server`), engine GraphRAG e
- * o DAG Task Runner. Instalar este pacote dá acesso a todas as funcionalidades
- * do método — não há subpacotes para gerenciar separadamente.
+ * o DAG Task Runner (orquestrador). Instalar este pacote dá acesso a todas
+ * as funcionalidades do método — não há subpacotes para gerenciar.
+ *
+ * O CLI **não** chama nenhuma API de LLM diretamente: a execução de tasks
+ * acontece dentro da IDE em que você já está autenticado (Cursor, Antigravity
+ * ou Claude Code). O DAG runner é orquestrador puro — coordena estado,
+ * canvas e ingestão no GraphRAG.
  */
 export { initCommand } from './commands/init.js';
 export { designCommand } from './commands/design.js';
 export { blueprintCommand } from './commands/blueprint.js';
 export { executeCommand } from './commands/execute.js';
-export { runDag } from './dag-runner/run_dag.js';
-export type { Dag, DagTask, RunDagOptions } from './dag-runner/run_dag.js';
+export { graphCommand } from './commands/graph.js';
+export { computeRanks, nextExecutableTasks, applyCascadingSkip, buildTaskPrompt, markRunning, markDone, markFailed, renderCanvas, DEFAULT_DAG_LIMITS, } from './dag-runner/run_dag.js';
+export type { Dag, DagTask, DagLimits, DagModelMap, DagModels, RunnerName, Complexity, TaskStatus as DagTaskStatus, MarkOptions, } from './dag-runner/run_dag.js';
+export { ingestTask, ingestDag, extractFilePaths } from './dag-runner/graph-ingest.js';
 export { convertYamlToDag, convertDagToYaml } from './utils/dag-converter.js';
 export { generateProjectStructure } from './utils/project-generator.js';
 export type { ProjectConfig } from './utils/project-generator.js';
-export { GraphRAG } from './graphrag/index.js';
-export type { GraphNode, GraphEdge, NodeType, EdgeType, TaskNode, FileNode, SchemaNode, EndpointNode, ComponentNode, SearchResult, GraphStatistics, } from './graphrag/index.js';
+export { GraphRAG, JsonGraph, createGraph, loadGraphConfig } from './graphrag/index.js';
+export type { KnowledgeGraph, GraphConfig, GraphBackend, GraphNode, GraphEdge, NodeType, EdgeType, TaskNode, FileNode, SchemaNode, EndpointNode, ComponentNode, SearchResult, GraphStatistics, } from './graphrag/index.js';
 export { createMcpServer } from './mcp-server/index.js';
 export type { ContextQuery, ContextResult, TaskStatus } from './mcp-server/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,GAAG,EACH,OAAO,EACP,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,IAAI,aAAa,EAC3B,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACxF,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -2,21 +2,28 @@
  * @dewtech/dare-cli — pacote único do framework DARE.
  *
  * Inclui CLI (`dare`), servidor MCP (`dare-mcp-server`), engine GraphRAG e
- * o DAG Task Runner. Instalar este pacote dá acesso a todas as funcionalidades
- * do método — não há subpacotes para gerenciar separadamente.
+ * o DAG Task Runner (orquestrador). Instalar este pacote dá acesso a todas
+ * as funcionalidades do método — não há subpacotes para gerenciar.
+ *
+ * O CLI **não** chama nenhuma API de LLM diretamente: a execução de tasks
+ * acontece dentro da IDE em que você já está autenticado (Cursor, Antigravity
+ * ou Claude Code). O DAG runner é orquestrador puro — coordena estado,
+ * canvas e ingestão no GraphRAG.
  */
 // Commands
 export { initCommand } from './commands/init.js';
 export { designCommand } from './commands/design.js';
 export { blueprintCommand } from './commands/blueprint.js';
 export { executeCommand } from './commands/execute.js';
-// DAG Runner
-export { runDag } from './dag-runner/run_dag.js';
+export { graphCommand } from './commands/graph.js';
+// DAG Runner (orchestration)
+export { computeRanks, nextExecutableTasks, applyCascadingSkip, buildTaskPrompt, markRunning, markDone, markFailed, renderCanvas, DEFAULT_DAG_LIMITS, } from './dag-runner/run_dag.js';
+export { ingestTask, ingestDag, extractFilePaths } from './dag-runner/graph-ingest.js';
 export { convertYamlToDag, convertDagToYaml } from './utils/dag-converter.js';
 // Project generation
 export { generateProjectStructure } from './utils/project-generator.js';
 // Knowledge graph engine
-export { GraphRAG } from './graphrag/index.js';
+export { GraphRAG, JsonGraph, createGraph, loadGraphConfig } from './graphrag/index.js';
 // MCP server
 export { createMcpServer } from './mcp-server/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,qBAAqB;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAe/C,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,6BAA6B;AAC7B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAYjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,qBAAqB;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkBxF,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dewtech/dare-cli",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "DARE Framework - CLI, GraphRAG engine, MCP server and shared types in a single package",
   "type": "module",
   "main": "./dist/index.js",