@devflow-tools/cli 0.12.6 → 0.13.1

package/dist/commands/benchmark-cmd.d.ts

@@ -0,0 +1,5 @@
+export declare function runBenchmark(_target: string, _opts: {
+    iterations?: number;
+    output?: string;
+}): Promise<string>;
+//# sourceMappingURL=benchmark-cmd.d.ts.map

package/dist/commands/benchmark-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/benchmark-cmd.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/commands/benchmark-cmd.js

@@ -0,0 +1,18 @@
+import { BenchmarkEngine } from "@devflow-tools/benchmark";
+import chalk from "chalk";
+export async function runBenchmark(_target, _opts) {
+    const engine = new BenchmarkEngine();
+    const tasks = engine.getTasks();
+    const lines = [
+        chalk.blue("◉ DevFlow Benchmark"),
+        "───────────────────────────────",
+        `Available tasks: ${tasks.length}`,
+        "",
+        "Benchmark requires a real runner implementation.",
+        "No fake data or estimated scores are shown.",
+        "",
+        "Setup: devflow benchmark --runner <path-to-runner>",
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=benchmark-cmd.js.map

package/dist/commands/benchmark-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-cmd.js","sourceRoot":"","sources":["../../src/commands/benchmark-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,KAA+C;IAE/C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG;QACZ,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC;QACjC,iCAAiC;QACjC,oBAAoB,KAAK,CAAC,MAAM,EAAE;QAClC,EAAE;QACF,kDAAkD;QAClD,6CAA6C;QAC7C,EAAE;QACF,oDAAoD;KACrD,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/connect.d.ts

@@ -0,0 +1,8 @@
+export interface ConnectOptions {
+    agent?: string;
+    command?: string;
+    sseUrl?: string;
+}
+export declare function connectAgent(options: ConnectOptions): Promise<string[]>;
+export declare function getAvailableAgents(): string[];
+//# sourceMappingURL=connect.d.ts.map

package/dist/commands/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuB7E;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/commands/connect.js

@@ -0,0 +1,26 @@
+import { connect, listAdapters } from "@devflow-tools/adapters";
+export async function connectAgent(options) {
+    const results = [];
+    let connectionConfig;
+    if (options.sseUrl) {
+        connectionConfig = { url: options.sseUrl };
+    }
+    else {
+        connectionConfig = {
+            command: options.command ?? "devflow-mcp",
+            args: ["--mode", "stdio"],
+        };
+    }
+    const targets = options.agent
+        ? [options.agent]
+        : await import("@devflow-tools/adapters").then((m) => m.detectAll());
+    for (const agent of targets) {
+        const result = await connect(agent, connectionConfig);
+        results.push(`${agent}: ${result.configPath} (${result.written ? "written" : "skipped"})`);
+    }
+    return results;
+}
+export function getAvailableAgents() {
+    return listAdapters();
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAShE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB;IACxD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,gBAAkC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,gBAAgB,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,gBAAgB,GAAG;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,aAAa;YACzC,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK;QAC3B,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACjB,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAEvE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC"}

package/dist/commands/context.d.ts

@@ -0,0 +1,15 @@
+import type { TaskContextResult } from "@devflow-tools/sdk";
+export interface ContextOptions {
+    query: string;
+    mode?: "fast" | "deep";
+    maxTokens?: number;
+    skipServer?: boolean;
+}
+export interface ContextResult {
+    files: unknown[];
+    confidence: number;
+    tokenCount: number;
+}
+export declare function getContext(options: ContextOptions): Promise<ContextResult>;
+export declare function getTaskContext(options: ContextOptions): Promise<TaskContextResult>;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAchF;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAexF"}

package/dist/commands/context.js

@@ -0,0 +1,24 @@
+import { withServer } from "../lib/with-server.js";
+import { createEngines } from "@devflow-tools/context-engine";
+export async function getContext(options) {
+    return withServer(process.cwd(), (client) => client.buildContext(options.query, options.mode ?? "fast", options.maxTokens), async () => {
+        const { context } = await createEngines(process.cwd());
+        return context.build({
+            query: options.query,
+            mode: options.mode ?? "fast",
+            maxTokens: options.maxTokens ?? 8000,
+        });
+    }, { skipServer: options.skipServer });
+}
+export async function getTaskContext(options) {
+    const rootPath = process.cwd();
+    const taskOptions = {
+        mode: options.mode ?? "fast",
+        maxTokens: options.maxTokens ?? 8000,
+    };
+    return withServer(rootPath, (client) => client.buildTaskContext(options.query, rootPath, taskOptions), async () => {
+        const { context } = await createEngines(rootPath);
+        return context.buildTaskContext(options.query, taskOptions);
+    }, { skipServer: options.skipServer });
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAgB9D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAuB;IACtD,OAAO,UAAU,CACf,OAAO,CAAC,GAAG,EAAE,EACb,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,EACzF,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC,KAAK,CAAC;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;SACrC,CAAC,CAAC;IACL,CAAC,EACD,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAuB;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;KACrC,CAAC;IACF,OAAO,UAAU,CACf,QAAQ,EACR,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,EACzE,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC,EACD,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CACnC,CAAC;AACJ,CAAC"}

package/dist/commands/dashboard.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const dashboardCommand: Command;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/commands/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/commands/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,gBAAgB,SAMzB,CAAC"}

package/dist/commands/dashboard.js

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+import chalk from "chalk";
+export const dashboardCommand = new Command("dashboard")
+    .description("Open DevFlow Dashboard")
+    .action(async () => {
+    console.log(chalk.blue("The Dashboard is served by the DevFlow server."));
+    console.log(chalk.dim("Run: devflow start"));
+    console.log(chalk.dim(`Then open: http://localhost:13337`));
+});
+//# sourceMappingURL=dashboard.js.map

package/dist/commands/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/commands/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;KACrD,WAAW,CAAC,wBAAwB,CAAC;KACrC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,56 @@
+export interface DoctorReport {
+    index: {
+        totalFiles: number;
+        totalSymbols: number;
+        indexing: boolean;
+    };
+    graph: {
+        nodes: number;
+        edges: number;
+    };
+    memory: {
+        projectReady: boolean;
+        userPrefs: number;
+    };
+    knowledge: {
+        sources: number;
+    };
+    plugins: {
+        installed: number;
+        names: string[];
+    };
+    workflows: {
+        registered: number;
+    };
+    server: {
+        running: boolean;
+    };
+    toolCalls: {
+        total: number;
+        byTool: Record<string, number>;
+    };
+    readyScore: number;
+}
+export declare function runDoctor(): Promise<DoctorReport>;
+export declare function runDoctorAudit(): Promise<{
+    valid: boolean;
+    brokenAt: number | null;
+    entryCount: number;
+}>;
+export declare function runDoctorAuditFix(): Promise<{
+    rebuilt: boolean;
+}>;
+export declare function runDoctorViolations(last?: string): Promise<{
+    violations: Array<{
+        tool: string;
+        decision: string;
+        ruleId: string | null;
+        ts: number;
+        sessionId: string;
+    }>;
+}>;
+export declare function runDoctorReceipts(): {
+    sessionId: string;
+    data: unknown;
+};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,EAAE;QACN,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CAmFvD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB/G;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAgBvE;AAED,wBAAsB,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqBjL;AAED,wBAAgB,iBAAiB,IAAI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAUxE"}

package/dist/commands/doctor.js

@@ -0,0 +1,156 @@
+import { createHmac, createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { createEngines } from "@devflow-tools/context-engine";
+import { serverStatus } from "./server.js";
+export async function runDoctor() {
+    const { codegraph, graph, memory, knowledge, workflow, data } = await createEngines(process.cwd());
+    const stats = codegraph.getStats();
+    const graphOutput = graph.export();
+    let workflowCount = 0;
+    try {
+        const wfList = await workflow.list();
+        workflowCount = wfList.length;
+    }
+    catch {
+        // workflow engine not initialized
+    }
+    let memoryReady = false;
+    let userPrefs = 0;
+    try {
+        const mem = await memory.getAll();
+        memoryReady = !!mem?.project;
+        const prefs = mem?.user ?? {};
+        userPrefs = Object.keys(prefs).length;
+    }
+    catch {
+        // memory engine not initialized
+    }
+    let knowledgeSources = 0;
+    try {
+        const sources = await knowledge.getSources();
+        knowledgeSources = sources.length;
+    }
+    catch {
+        // knowledge engine not initialized
+    }
+    // Layer 4: Fetch local tool call telemetry
+    let toolCallStats = { total: 0, byTool: {} };
+    try {
+        toolCallStats = await data.getToolCallStats();
+    }
+    catch {
+        // data provider not available or table not yet created
+    }
+    const server = await serverStatus();
+    let readyScore = 0;
+    if (stats.fileCount > 0)
+        readyScore += 25;
+    if (stats.nodeCount > 0)
+        readyScore += 15;
+    if (graphOutput.nodes.length > 0)
+        readyScore += 20;
+    if (memoryReady)
+        readyScore += 15;
+    if (knowledgeSources > 0)
+        readyScore += 10;
+    if (workflowCount > 0)
+        readyScore += 5;
+    if (server.running)
+        readyScore += 10;
+    if (toolCallStats.total > 0)
+        readyScore += 5;
+    return {
+        index: {
+            totalFiles: stats.fileCount,
+            totalSymbols: stats.nodeCount,
+            indexing: codegraph.isIndexing(),
+        },
+        graph: {
+            nodes: graphOutput.nodes.length,
+            edges: graphOutput.edges.length,
+        },
+        memory: {
+            projectReady: memoryReady,
+            userPrefs,
+        },
+        knowledge: {
+            sources: knowledgeSources,
+        },
+        plugins: {
+            installed: 0,
+            names: [],
+        },
+        workflows: {
+            registered: workflowCount,
+        },
+        server: {
+            running: server.running,
+        },
+        toolCalls: toolCallStats,
+        readyScore,
+    };
+}
+export async function runDoctorAudit() {
+    const { data } = await createEngines(process.cwd());
+    const secret = await data.auditGetSecret();
+    const entries = await data.auditGetAll();
+    let prevHash = createHash("sha256").update("genesis").digest("hex");
+    for (const entry of entries) {
+        if (entry.prevHash !== prevHash) {
+            return { valid: false, brokenAt: entry.seq, entryCount: entries.length };
+        }
+        const payload = `${entry.seq}|${entry.ts}|${entry.tool}|${entry.argsHash}|${entry.decision}|${entry.ruleId ?? ""}|${entry.sessionId}|${prevHash}`;
+        const expectedSig = createHmac("sha256", secret).update(payload).digest("hex");
+        if (entry.signature !== expectedSig) {
+            return { valid: false, brokenAt: entry.seq, entryCount: entries.length };
+        }
+        prevHash = entry.signature;
+    }
+    return { valid: true, brokenAt: null, entryCount: entries.length };
+}
+export async function runDoctorAuditFix() {
+    const { data } = await createEngines(process.cwd());
+    const secret = await data.auditGetSecret();
+    const entries = await data.auditGetAll();
+    let prevHash = createHash("sha256").update("genesis").digest("hex");
+    for (const entry of entries) {
+        const payload = `${entry.seq}|${entry.ts}|${entry.tool}|${entry.argsHash}|${entry.decision}|${entry.ruleId ?? ""}|${entry.sessionId}|${prevHash}`;
+        const signature = createHmac("sha256", secret).update(payload).digest("hex");
+        await data.sqlExecute("UPDATE devflow_audit_chain SET prev_hash = ?, signature = ? WHERE seq = ?", [prevHash, signature, entry.seq]);
+        prevHash = signature;
+    }
+    return { rebuilt: true };
+}
+export async function runDoctorViolations(last) {
+    const { data } = await createEngines(process.cwd());
+    const entries = await data.auditGetAll();
+    let violations = entries.filter((e) => e.decision !== "allow");
+    if (last) {
+        const match = last.match(/^(\d+)([dh])$/);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            const unit = match[2];
+            const cutoffMs = unit === "d" ? num * 86400000 : num * 3600000;
+            const cutoff = Date.now() - cutoffMs;
+            violations = violations.filter((v) => v.ts > cutoff);
+        }
+    }
+    return {
+        violations: violations.map((v) => ({
+            tool: v.tool, decision: v.decision, ruleId: v.ruleId, ts: v.ts, sessionId: v.sessionId,
+        })),
+    };
+}
+export function runDoctorReceipts() {
+    const receiptDir = `${process.env.TMPDIR ?? "/tmp"}/.devflow-receipts`;
+    const sessionId = createHash("sha256").update(process.cwd()).digest("hex").slice(0, 16);
+    const receiptFile = `${receiptDir}/${sessionId}.json`;
+    try {
+        const raw = readFileSync(receiptFile, "utf-8");
+        return { sessionId, data: JSON.parse(raw) };
+    }
+    catch {
+        return { sessionId, data: null };
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,11 @@
+export interface GraphOptions {
+    target?: string;
+    depth?: number;
+    skipServer?: boolean;
+}
+export interface GraphOutput {
+    nodes: unknown[];
+    edges: unknown[];
+}
+export declare function getGraph(options?: GraphOptions): Promise<GraphOutput>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAe/E"}

package/dist/commands/graph.js

@@ -0,0 +1,14 @@
+import { withServer } from "../lib/with-server.js";
+import { createEngines } from "@devflow-tools/context-engine";
+export async function getGraph(options = {}) {
+    const target = options.target ?? "all";
+    const depth = options.depth ?? 2;
+    return withServer(process.cwd(), (client) => client.getGraph(target, depth), async () => {
+        const { graph } = await createEngines(process.cwd());
+        if (target === "all")
+            return graph.export();
+        const sub = graph.getSubGraph(target, depth);
+        return { nodes: sub.nodes, edges: sub.edges };
+    }, { skipServer: options.skipServer });
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAa9D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAwB,EAAE;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAEjC,OAAO,UAAU,CACf,OAAO,CAAC,GAAG,EAAE,EACb,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EAC1C,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC,EACD,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CACnC,CAAC;AACJ,CAAC"}

package/dist/commands/index-cmd.d.ts

@@ -0,0 +1,4 @@
+import type { IndexStatus } from "@devflow-tools/sdk";
+export { IndexStatus };
+export declare function getIndexStatus(skipServer?: boolean): Promise<IndexStatus>;
+//# sourceMappingURL=index-cmd.d.ts.map

package/dist/commands/index-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,wBAAsB,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAgB/E"}

package/dist/commands/index-cmd.js

@@ -0,0 +1,15 @@
+import { withServer } from "../lib/with-server.js";
+import { createEngines } from "@devflow-tools/context-engine";
+export async function getIndexStatus(skipServer) {
+    return withServer(process.cwd(), (client) => client.getIndexStatus(), async () => {
+        const { codegraph } = await createEngines(process.cwd());
+        const stats = codegraph.getStats();
+        return {
+            totalFiles: stats.fileCount,
+            totalSymbols: stats.nodeCount,
+            lastIndexTime: stats.lastUpdated,
+            indexing: codegraph.isIndexing(),
+        };
+    }, { skipServer });
+}
+//# sourceMappingURL=index-cmd.js.map

package/dist/commands/index-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAK9D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAoB;IACvD,OAAO,UAAU,CACf,OAAO,CAAC,GAAG,EAAE,EACb,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,EACnC,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,YAAY,EAAE,KAAK,CAAC,SAAS;YAC7B,aAAa,EAAE,KAAK,CAAC,WAAW;YAChC,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE;SACjC,CAAC;IACJ,CAAC,EACD,EAAE,UAAU,EAAE,CACf,CAAC;AACJ,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,20 @@
+import type { OnboardingPack } from "@devflow-tools/context-engine";
+export interface InitOptions {
+    force?: boolean;
+    scan?: boolean;
+}
+export interface InitResult {
+    created: string[];
+    indexed?: {
+        files: number;
+        symbols: number;
+        graphNodes: number;
+    };
+    pluginDeployed: boolean;
+    pluginEnabled: boolean;
+    mcpConfigured: boolean;
+    onboardingPack?: OnboardingPack;
+}
+export declare function initProject(projectRoot: string, options?: InitOptions): Promise<InitResult>;
+export declare function renderInitReport(pack: OnboardingPack): string;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAMpE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4HrG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA+B7D"}

package/dist/commands/init.js

@@ -0,0 +1,145 @@
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { createRequire } from "module";
+import CGModule from "@colbymchenry/codegraph";
+import { createEngines, buildOnboardingPack } from "@devflow-tools/context-engine";
+import { getPluginFilesDir, deployPlugin, ensurePluginEnabled, writeMcpConfig } from "../lib/plugin-setup.js";
+const CodeGraph = CGModule.default ?? CGModule;
+const require = createRequire(import.meta.url);
+export async function initProject(projectRoot, options = {}) {
+    const devflowDir = join(projectRoot, ".devflow");
+    const created = [];
+    // ── Step 1: Project initialization (existing) ──
+    if (!existsSync(devflowDir)) {
+        mkdirSync(devflowDir, { recursive: true });
+        created.push(".devflow/");
+    }
+    const configPath = join(devflowDir, "config.json");
+    if (!existsSync(configPath) || options.force) {
+        writeFileSync(configPath, JSON.stringify({
+            version: "0.1.0",
+            initialized: new Date().toISOString(),
+        }, null, 2), "utf-8");
+        created.push(".devflow/config.json");
+    }
+    const result = {
+        created,
+        pluginDeployed: false,
+        pluginEnabled: false,
+        mcpConfigured: false,
+    };
+    // Initialize CodeGraph if not already done
+    if (!CodeGraph.isInitialized(projectRoot)) {
+        await CodeGraph.init(projectRoot, { index: options.scan !== false });
+    }
+    if (options.scan !== false) {
+        try {
+            const { indexer, graph } = await createEngines(projectRoot);
+            const { files, symbols, imports } = await indexer.indexAll(projectRoot);
+            const graphResult = await graph.build(symbols, imports);
+            result.indexed = {
+                files: files.length,
+                symbols: symbols.length,
+                graphNodes: graphResult.nodes.length,
+            };
+        }
+        catch (err) {
+            // Indexing is best-effort during init; errors are non-fatal
+            result.indexed = { files: 0, symbols: 0, graphNodes: 0 };
+        }
+    }
+    // ── Step 1.5: Onboarding pack generation ──
+    if (options.scan !== false) {
+        try {
+            const { indexer, graph } = await createEngines(projectRoot);
+            const cg = CodeGraph.openSync(projectRoot);
+            const pack = await buildOnboardingPack(projectRoot, cg, indexer, graph);
+            const onboardingPath = join(devflowDir, "onboarding-pack.json");
+            writeFileSync(onboardingPath, JSON.stringify(pack, null, 2), "utf-8");
+            created.push(".devflow/onboarding-pack.json");
+            const reportPath = join(devflowDir, "init-report.md");
+            writeFileSync(reportPath, renderInitReport(pack), "utf-8");
+            created.push(".devflow/init-report.md");
+            result.onboardingPack = pack;
+        }
+        catch (err) {
+            console.warn(`Warning: Onboarding pack generation skipped — ${err.message}`);
+        }
+    }
+    // ── Step 2: Plugin deployment ──
+    try {
+        const pluginFilesDir = getPluginFilesDir();
+        const home = homedir();
+        const cacheBaseDir = join(home, ".claude", "plugins", "cache");
+        const globalSkillsDir = join(home, ".claude", "skills");
+        const pluginPkgPath = join(pluginFilesDir, "package.json");
+        const version = existsSync(pluginPkgPath)
+            ? JSON.parse(readFileSync(pluginPkgPath, "utf-8")).version
+            : "0.0.0";
+        deployPlugin(pluginFilesDir, cacheBaseDir, version, globalSkillsDir);
+        result.pluginDeployed = true;
+    }
+    catch (err) {
+        console.warn(`Warning: Plugin deployment skipped — ${err.message}`);
+    }
+    // ── Step 3: Plugin enablement ──
+    try {
+        const home = homedir();
+        const settingsPath = join(home, ".claude", "settings.json");
+        ensurePluginEnabled(settingsPath);
+        result.pluginEnabled = true;
+    }
+    catch (err) {
+        console.warn(`Warning: Plugin enablement skipped — ${err.message}`);
+    }
+    // ── Step 4: MCP configuration ──
+    try {
+        let mcpCommand;
+        try {
+            mcpCommand = require.resolve("@devflow-tools/mcp-server/bin/devflow-mcp.cjs");
+        }
+        catch {
+            mcpCommand = "devflow-mcp";
+        }
+        writeMcpConfig(projectRoot, mcpCommand);
+        result.mcpConfigured = true;
+    }
+    catch (err) {
+        console.warn(`Warning: MCP config skipped — ${err.message}`);
+    }
+    return result;
+}
+export function renderInitReport(pack) {
+    const lines = [
+        `# ${pack.projectName} — DevFlow Onboarding Report`,
+        `Generated: ${pack.createdAt}`,
+        ``,
+        `## Project Stats`,
+        `- Files: ${pack.stats.files}`,
+        `- Symbols: ${pack.stats.symbols}`,
+        `- Graph Nodes: ${pack.stats.graphNodes}`,
+        ``,
+        `## Tech Stack`,
+        `- Languages: ${pack.stack.languages.join(", ") || "unknown"}`,
+        `- Frameworks: ${pack.stack.frameworks.join(", ") || "none detected"}`,
+        `- Build Tools: ${pack.stack.buildTools.join(", ") || "none detected"}`,
+        `- Test Tools: ${pack.stack.testTools.join(", ") || "none detected"}`,
+        ``,
+        `## Architecture Layers`,
+        ...pack.architectureLayers.map((l) => `- **${l.name}**: ${l.files} files`),
+        ``,
+        `## Key Modules`,
+        ...pack.keyModules.slice(0, 10).map((m) => `- \`${m.name}\` — ${m.reason}`),
+        ``,
+        `## Key Symbols`,
+        ...pack.keySymbols.slice(0, 20).map((s) => `- \`${s.name}\` (${s.kind}) in \`${s.file}\``),
+        ``,
+        `## Recommended Next Steps`,
+        ...pack.recommendedPlugins.map((p) => `- Install plugin: \`${p}\``),
+        ...pack.recommendedWorkflows.map((w) => `- Run workflow: \`devflow workflow ${w}\``),
+        `- Try: \`devflow context "${pack.recommendedQueries[0] ?? '项目架构'}"\``,
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/knowledge.d.ts

@@ -0,0 +1,5 @@
+import type { KnowledgeEntry, KnowledgeSourceStatus, SyncResult } from "@devflow-tools/sdk";
+export declare function searchKnowledge(query: string, scope?: string, skipServer?: boolean): Promise<KnowledgeEntry[]>;
+export declare function getDocsStatus(skipServer?: boolean): Promise<KnowledgeSourceStatus[]>;
+export declare function syncDocs(pluginName?: string, skipServer?: boolean): Promise<SyncResult[]>;
+//# sourceMappingURL=knowledge.d.ts.map