@rryando/arcs 3.0.0

package/dist/cli/commands/diagram.js

@@ -0,0 +1,305 @@
+// ---------------------------------------------------------------------------
+// Diagram commands — registry-based
+// ---------------------------------------------------------------------------
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { access, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { generateDiagramFromTasks } from "../../utils/diagram-generator.js";
+import { getDataDir, getProjectDir } from "../../utils/paths.js";
+import { listTasks } from "../../utils/project-memory.js";
+import { defineCommand, ERROR_CODES, } from "../command-registry.js";
+import { failure, success } from "../output-envelope.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function findDiagramScript() {
+    const localPath = resolve(import.meta.dirname, "../../../opencode/arcs/skills/to-diagram/scripts/manage-diagram.mjs");
+    if (existsSync(localPath))
+        return localPath;
+    const configPath = resolve(homedir(), ".config/opencode/skills/arcs/to-diagram/scripts/manage-diagram.mjs");
+    if (existsSync(configPath))
+        return configPath;
+    return undefined;
+}
+function resolveDiagramPath(slug, planId) {
+    const dataDir = getDataDir();
+    return resolve(dataDir, "projects", slug, "plans", `${planId}.diagram.mmd`);
+}
+function runDiagramScript(scriptPath, subcommand, diagramPath, extraArgs = []) {
+    const argsStr = extraArgs.map((a) => `"${a}"`).join(" ");
+    return execSync(`node "${scriptPath}" ${subcommand} "${diagramPath}"${argsStr ? ` ${argsStr}` : ""}`, {
+        encoding: "utf-8",
+        timeout: 10000,
+    }).trim();
+}
+function requireScript() {
+    const scriptPath = findDiagramScript();
+    if (!scriptPath) {
+        return failure("script_not_found", "manage-diagram.mjs not found. Install ARCS OpenCode bundle: arcs setup");
+    }
+    return scriptPath;
+}
+function requireDiagramFile(slug, planId) {
+    const diagramPath = resolveDiagramPath(slug, planId);
+    if (!existsSync(diagramPath)) {
+        return failure(ERROR_CODES.ENTITY_NOT_FOUND, `No diagram found for plan "${planId}" in project "${slug}". Create one via brainstorm workflow.`);
+    }
+    return diagramPath;
+}
+function parseScriptOutput(output) {
+    try {
+        return JSON.parse(output);
+    }
+    catch {
+        return { output };
+    }
+}
+// ---------------------------------------------------------------------------
+// diagram ready
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "diagram ready",
+    description: "Show ready-to-execute nodes (all dependencies done)",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        planId: { type: "string", required: true, positional: 1, description: "Plan ID" },
+    },
+    handler: handleDiagramReady,
+});
+async function handleDiagramReady(params, _flags) {
+    const slug = params.slug;
+    const planId = params.planId;
+    const diagramPath = requireDiagramFile(slug, planId);
+    if (typeof diagramPath !== "string")
+        return diagramPath;
+    const scriptPath = requireScript();
+    if (typeof scriptPath !== "string")
+        return scriptPath;
+    try {
+        const output = runDiagramScript(scriptPath, "ready", diagramPath);
+        return success(parseScriptOutput(output));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.stderr || err.message : String(err);
+        return failure("diagram_error", `diagram ready failed: ${msg}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// diagram inspect
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "diagram inspect",
+    description: "Show diagram structure and metadata",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        planId: { type: "string", positional: 1, description: "Plan ID" },
+    },
+    handler: handleDiagramInspect,
+});
+async function handleDiagramInspect(params, _flags) {
+    const slug = params.slug;
+    const planId = params.planId;
+    const projectDir = getProjectDir(slug);
+    if (!existsSync(projectDir)) {
+        return failure(ERROR_CODES.PROJECT_NOT_FOUND, `Project "${slug}" not found`);
+    }
+    if (!planId) {
+        return failure(ERROR_CODES.MISSING_PARAM, "--planId is required", {
+            hint: "usage: arcs diagram inspect <slug> <planId>",
+        });
+    }
+    const diagramPath = requireDiagramFile(slug, planId);
+    if (typeof diagramPath !== "string")
+        return diagramPath;
+    const scriptPath = requireScript();
+    if (typeof scriptPath !== "string")
+        return scriptPath;
+    try {
+        const output = runDiagramScript(scriptPath, "inspect", diagramPath);
+        return success(parseScriptOutput(output));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.stderr || err.message : String(err);
+        return failure("diagram_error", `diagram inspect failed: ${msg}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// diagram validate
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "diagram validate",
+    description: "Validate diagram integrity",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        planId: { type: "string", required: true, positional: 1, description: "Plan ID" },
+    },
+    handler: handleDiagramValidate,
+});
+async function handleDiagramValidate(params, _flags) {
+    const slug = params.slug;
+    const planId = params.planId;
+    const diagramPath = requireDiagramFile(slug, planId);
+    if (typeof diagramPath !== "string")
+        return diagramPath;
+    const scriptPath = requireScript();
+    if (typeof scriptPath !== "string")
+        return scriptPath;
+    try {
+        const output = runDiagramScript(scriptPath, "validate", diagramPath);
+        return success(parseScriptOutput(output));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.stderr || err.message : String(err);
+        return failure("diagram_error", `diagram validate failed: ${msg}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// diagram status
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "diagram status",
+    description: "Update a diagram node's status",
+    mutation: true,
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        planId: { type: "string", required: true, positional: 1, description: "Plan ID" },
+        nodeId: { type: "string", required: true, positional: 2, description: "Node ID to update" },
+        status: {
+            type: "string",
+            required: true,
+            positional: 3,
+            description: "New status",
+            enum: ["backlog", "in_progress", "done", "blocked"],
+        },
+    },
+    handler: handleDiagramStatus,
+});
+async function handleDiagramStatus(params, _flags) {
+    const slug = params.slug;
+    const planId = params.planId;
+    const nodeId = params.nodeId;
+    const status = params.status;
+    const diagramPath = requireDiagramFile(slug, planId);
+    if (typeof diagramPath !== "string")
+        return diagramPath;
+    const scriptPath = requireScript();
+    if (typeof scriptPath !== "string")
+        return scriptPath;
+    try {
+        const output = runDiagramScript(scriptPath, "status", diagramPath, [nodeId, status]);
+        return success(parseScriptOutput(output));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.stderr || err.message : String(err);
+        return failure("diagram_error", `diagram status failed: ${msg}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// diagram sort-metadata
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "diagram sort-metadata",
+    description: "Sort metadata blocks in diagram file",
+    mutation: true,
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        planId: { type: "string", required: true, positional: 1, description: "Plan ID" },
+    },
+    handler: handleDiagramSortMetadata,
+});
+async function handleDiagramSortMetadata(params, _flags) {
+    const slug = params.slug;
+    const planId = params.planId;
+    const diagramPath = requireDiagramFile(slug, planId);
+    if (typeof diagramPath !== "string")
+        return diagramPath;
+    const scriptPath = requireScript();
+    if (typeof scriptPath !== "string")
+        return scriptPath;
+    try {
+        const output = runDiagramScript(scriptPath, "sort-metadata", diagramPath);
+        return success(parseScriptOutput(output));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.stderr || err.message : String(err);
+        return failure("diagram_error", `diagram sort-metadata failed: ${msg}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// diagram show
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "diagram show",
+    description: "Render diagram in terminal",
+    params: {
+        path: { type: "string", required: true, positional: 0, description: "Path to .mmd file" },
+    },
+    handler: handleDiagramShow,
+});
+async function handleDiagramShow(params, _flags) {
+    const path = params.path;
+    if (!existsSync(path)) {
+        return failure(ERROR_CODES.ENTITY_NOT_FOUND, `File not found: ${path}`);
+    }
+    try {
+        const { renderDiagramShow } = await import("../diagram-renderer.js");
+        const output = renderDiagramShow(path);
+        return success({ output });
+    }
+    catch (err) {
+        return failure("diagram_error", err instanceof Error ? err.message : String(err));
+    }
+}
+// ---------------------------------------------------------------------------
+// diagram init
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "diagram init",
+    description: "Generate skeleton .diagram.mmd for a plan from its existing tasks",
+    params: {
+        slug: { type: "string", positional: 0, required: true, description: "Project slug" },
+        planId: { type: "string", positional: 1, required: true, description: "Plan ID" },
+        force: { type: "boolean", description: "Overwrite existing .mmd file" },
+    },
+    mutation: true,
+    errorCodes: ["project_not_found", "entity_not_found", "conflict"],
+    handler: async (params, _flags) => {
+        const { slug, planId, force } = params;
+        const projectDir = getProjectDir(slug);
+        try {
+            await access(projectDir);
+        }
+        catch {
+            return { ok: false, code: "project_not_found", message: `Project not found: ${slug}` };
+        }
+        const allTasks = await listTasks(projectDir);
+        const planTasks = allTasks.filter((t) => t.planId === planId);
+        if (planTasks.length === 0) {
+            return {
+                ok: false,
+                code: "entity_not_found",
+                message: `No tasks found for plan '${planId}' in project '${slug}'. Create tasks with --planId first.`,
+            };
+        }
+        const diagramPath = resolveDiagramPath(slug, planId);
+        if (!force) {
+            try {
+                await access(diagramPath);
+                return {
+                    ok: false,
+                    code: "conflict",
+                    message: `Diagram already exists: ${diagramPath}. Use --force to overwrite.`,
+                };
+            }
+            catch {
+                // file does not exist — proceed
+            }
+        }
+        const { mmd, nodes } = generateDiagramFromTasks(planId, planTasks);
+        await writeFile(diagramPath, mmd, "utf-8");
+        return { ok: true, data: { path: diagramPath, planId, nodeCount: nodes.length, nodes } };
+    },
+});
+//# sourceMappingURL=diagram.js.map

package/dist/cli/commands/diagram.js.map

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

package/dist/cli/commands/done.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=done.d.ts.map

package/dist/cli/commands/done.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"done.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/done.ts"],"names":[],"mappings":""}

package/dist/cli/commands/done.js

@@ -0,0 +1,140 @@
+// ---------------------------------------------------------------------------
+// done — Mark a task as done and show the next task to work on
+// ---------------------------------------------------------------------------
+import { existsSync } from "node:fs";
+import { createKnowledgeEntry, getTask, listTasks, readPlanIndex, updateTask, } from "../../utils/project-memory.js";
+import { resolveProject } from "../../utils/project-resolver.js";
+import { normalizeIdentifier } from "../../utils/slug.js";
+import { defineCommand, ERROR_CODES, } from "../command-registry.js";
+import { failure, success } from "../output-envelope.js";
+import { attemptDiagramUpdate } from "./task.js";
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "done",
+    description: "Mark a task as done and show the next task",
+    mutation: true,
+    params: {
+        slug: {
+            type: "string",
+            required: true,
+            positional: 0,
+            description: "Project slug",
+        },
+        taskId: {
+            type: "string",
+            required: true,
+            positional: 1,
+            description: "Task ID to mark as done",
+        },
+        planId: { type: "string", description: "Plan ID (enables atomic diagram update)" },
+        diagramNodeId: { type: "string", description: "Diagram node ID to update (e.g. T001)" },
+        learn: { type: "string", description: "Capture a quick insight linked to this task" },
+    },
+    handler: handleDone,
+});
+// ---------------------------------------------------------------------------
+async function handleDone(params, flags) {
+    const rawSlug = params.slug;
+    const taskId = params.taskId;
+    const planIdParam = params.planId;
+    const diagramNodeId = params.diagramNodeId;
+    const learnText = params.learn;
+    const resolved = await resolveProject(rawSlug);
+    if (!resolved.ok)
+        return resolved.result;
+    const { slug, projectDir } = resolved;
+    // Validate project directory exists
+    if (!existsSync(projectDir)) {
+        return failure(ERROR_CODES.PROJECT_NOT_FOUND, `Project "${slug}" not found`, {
+            hint: "Run 'arcs project list' to see available projects.",
+        });
+    }
+    // Get and transition the task
+    let completedTask;
+    try {
+        const task = await getTask(projectDir, taskId);
+        await updateTask(projectDir, { id: taskId, status: "done" });
+        completedTask = { id: task.id, title: task.title };
+        // Attempt diagram update if planId and diagramNodeId available
+        const effectivePlanId = planIdParam ?? task.planId;
+        if (effectivePlanId && diagramNodeId) {
+            attemptDiagramUpdate(slug, effectivePlanId, diagramNodeId, "done");
+        }
+    }
+    catch (err) {
+        return failure(ERROR_CODES.ENTITY_NOT_FOUND, err instanceof Error ? err.message : String(err));
+    }
+    // Derive next task
+    const [allTasks, planIndex] = await Promise.all([
+        listTasks(projectDir),
+        readPlanIndex(projectDir),
+    ]);
+    const openTasks = allTasks.filter((t) => t.status !== "done" && t.status !== "cancelled");
+    const priorityOrder = { high: 0, medium: 1, low: 2 };
+    const sorted = [...openTasks].sort((a, b) => {
+        if (a.status === "in_progress" && b.status !== "in_progress")
+            return -1;
+        if (b.status === "in_progress" && a.status !== "in_progress")
+            return 1;
+        const pa = priorityOrder[a.priority ?? "medium"] ?? 1;
+        const pb = priorityOrder[b.priority ?? "medium"] ?? 1;
+        return pa - pb;
+    });
+    const nextTask = sorted[0];
+    const nextPlan = nextTask?.planId
+        ? planIndex.plans.find((p) => p.id === nextTask.planId)
+        : undefined;
+    const nextData = nextTask
+        ? { id: nextTask.id, title: nextTask.title, plan: nextPlan?.title ?? null }
+        : null;
+    // Capture --learn insight if provided
+    let learnedEntry = null;
+    if (learnText) {
+        try {
+            const lower = learnText.toLowerCase();
+            const kind = /don't|never|careful|watch out|gotcha/.test(lower)
+                ? "gotcha"
+                : /learned|lesson|realized|mistake/.test(lower)
+                    ? "lesson"
+                    : /pattern|always|convention|rule/.test(lower)
+                        ? "pattern"
+                        : "lesson";
+            const title = learnText.length <= 50 ? learnText : `${learnText.slice(0, 50)}...`;
+            const id = normalizeIdentifier(title);
+            const entry = await createKnowledgeEntry(projectDir, {
+                id,
+                title,
+                kind: kind,
+                keywords: [completedTask.id],
+                summary: learnText,
+            });
+            learnedEntry = { id: entry.id, title: entry.title, kind: entry.kind };
+        }
+        catch {
+            // Best-effort — don't fail the done command for a learn error
+        }
+    }
+    if (flags.json) {
+        return success({
+            completed: completedTask,
+            next: nextData,
+            ...(learnedEntry ? { learned: learnedEntry } : {}),
+        });
+    }
+    const lines = [`✓ Done: ${completedTask.title}`, ""];
+    if (nextData) {
+        lines.push(`Next: ${nextData.title}`);
+        if (nextData.plan)
+            lines.push(`Plan: ${nextData.plan}`);
+        lines.push("");
+        lines.push(`Run: arcs done ${slug} ${nextData.id}`);
+    }
+    else {
+        lines.push("All tasks complete! Nothing left to do.");
+    }
+    if (learnedEntry) {
+        lines.push(`✓ Remembered [${learnedEntry.kind}]: ${learnedEntry.title}`);
+    }
+    return success(lines.join("\n"));
+}
+//# sourceMappingURL=done.js.map

package/dist/cli/commands/done.js.map

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

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

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

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

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

package/dist/cli/commands/graph.js

@@ -0,0 +1,105 @@
+// ---------------------------------------------------------------------------
+// Graph-related commands — related, graph inspect (registry-based)
+// ---------------------------------------------------------------------------
+import { existsSync } from "node:fs";
+import { createGraphCache } from "../../retrieval/graph-cache.js";
+import { retrieveRelated } from "../../retrieval/graph-retrieval.js";
+import { getProjectDir } from "../../utils/paths.js";
+import { defineCommand, ERROR_CODES, } from "../command-registry.js";
+import { failure, success } from "../output-envelope.js";
+// ---------------------------------------------------------------------------
+// related
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "related",
+    description: "Find entities related to a task, knowledge entry, or plan via the knowledge graph",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        task: { type: "string", description: "Task ID to find related entities for" },
+        plan: { type: "string", description: "Plan ID to find related entities for" },
+        knowledge: { type: "string", description: "Knowledge entry ID to find related entities for" },
+        limit: { type: "number", description: "Max results to return (default 10)" },
+    },
+    handler: handleRelatedCmd,
+});
+async function handleRelatedCmd(params, _flags) {
+    const slug = params.slug;
+    const taskId = params.task;
+    const knowledgeId = params.knowledge;
+    const planId = params.plan;
+    if (!taskId && !knowledgeId && !planId) {
+        return failure(ERROR_CODES.MISSING_PARAM, "One of --task, --knowledge, or --plan is required", {
+            usage: "arcs related <slug> --task=<id> | --knowledge=<id> | --plan=<id> [--limit=N] [--json]",
+        });
+    }
+    let startNodeId;
+    if (taskId) {
+        startNodeId = `task:${taskId}`;
+    }
+    else if (knowledgeId) {
+        startNodeId = `knowledge:${knowledgeId}`;
+    }
+    else {
+        startNodeId = `plan:${planId}`;
+    }
+    const limit = params.limit ?? 10;
+    const results = await retrieveRelated(slug, startNodeId, { limit });
+    return success({ related: results });
+}
+// ---------------------------------------------------------------------------
+// graph inspect
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "graph inspect",
+    description: "Show knowledge graph index statistics for a project",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+    },
+    handler: handleGraphInspectCmd,
+});
+async function handleGraphInspectCmd(params, _flags) {
+    const slug = params.slug;
+    const projectDir = getProjectDir(slug);
+    if (!existsSync(projectDir)) {
+        return failure(ERROR_CODES.PROJECT_NOT_FOUND, `Project "${slug}" not found`);
+    }
+    const cache = createGraphCache();
+    const index = await cache.getOrBuild(slug);
+    const nodeCount = index.nodes.size;
+    let edgeCount = 0;
+    for (const edgeList of index.edges.values()) {
+        edgeCount += edgeList.length;
+    }
+    const nodesByType = {};
+    for (const node of index.nodes.values()) {
+        nodesByType[node.type] = (nodesByType[node.type] || 0) + 1;
+    }
+    const mostConnectedFiles = [...index.fileIndex.entries()]
+        .map(([path, refs]) => ({ path, refs: refs.length }))
+        .sort((a, b) => b.refs - a.refs)
+        .slice(0, 10);
+    // Orphan nodes: no outgoing AND no incoming edges
+    const hasConnection = new Set();
+    for (const [source, edgeList] of index.edges.entries()) {
+        if (edgeList.length > 0)
+            hasConnection.add(source);
+        for (const edge of edgeList) {
+            hasConnection.add(edge.target);
+        }
+    }
+    const orphanNodes = [];
+    for (const nodeId of index.nodes.keys()) {
+        if (!hasConnection.has(nodeId))
+            orphanNodes.push(nodeId);
+    }
+    const density = nodeCount > 1 ? edgeCount / (nodeCount * (nodeCount - 1)) : 0;
+    return success({
+        nodeCount,
+        edgeCount,
+        nodesByType,
+        mostConnectedFiles,
+        orphanNodes,
+        density: Math.round(density * 1000) / 1000,
+    });
+}
+//# sourceMappingURL=graph.js.map

package/dist/cli/commands/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/cli/commands/graph.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mEAAmE;AACnE,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAGL,aAAa,EACb,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEzD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,aAAa,CAAC;IACZ,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,mFAAmF;IAChG,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE;QACpF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;QAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;QAC7E,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;QAC7F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;KAC7E;IACD,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC;AAEH,KAAK,UAAU,gBAAgB,CAC7B,MAA+B,EAC/B,MAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAc,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,IAA0B,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,SAA+B,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,IAA0B,CAAC;IAEjD,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,mDAAmD,EAAE;YAC7F,KAAK,EACH,uFAAuF;SAC1F,CAAC,CAAC;IACL,CAAC;IAED,IAAI,WAAmB,CAAC;IACxB,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,GAAG,QAAQ,MAAM,EAAE,CAAC;IACjC,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,WAAW,GAAG,aAAa,WAAW,EAAE,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,QAAQ,MAAM,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAI,MAAM,CAAC,KAA4B,IAAI,EAAE,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAEpE,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,aAAa,CAAC;IACZ,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,qDAAqD;IAClE,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE;KACrF;IACD,OAAO,EAAE,qBAAqB;CAC/B,CAAC,CAAC;AAEH,KAAK,UAAU,qBAAqB,CAClC,MAA+B,EAC/B,MAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAc,CAAC;IAEnC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,YAAY,IAAI,aAAa,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAE3C,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IAEnC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,kBAAkB,GAAG,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;SACpD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;SAC/B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,kDAAkD;IAClD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,SAAS,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,OAAO,OAAO,CAAC;QACb,SAAS;QACT,SAAS;QACT,WAAW;QACX,kBAAkB;QAClB,WAAW;QACX,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI;KAC3C,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,21 @@
+import "./project.js";
+import "./project-updates.js";
+import "./task.js";
+import "./plan.js";
+import "./knowledge.js";
+import "./knowledge-search.js";
+import "./utility.js";
+import "./batch.js";
+import "./diagram.js";
+import "./diagnostics.js";
+import "./graph.js";
+import "./dependency.js";
+import "./bundle.js";
+import "./maintenance.js";
+import "./loop.js";
+import "./brief.js";
+import "./next.js";
+import "./remember.js";
+import "./done.js";
+import "./status.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AACtB,OAAO,sBAAsB,CAAC;AAC9B,OAAO,WAAW,CAAC;AACnB,OAAO,WAAW,CAAC;AACnB,OAAO,gBAAgB,CAAC;AACxB,OAAO,uBAAuB,CAAC;AAC/B,OAAO,cAAc,CAAC;AACtB,OAAO,YAAY,CAAC;AACpB,OAAO,cAAc,CAAC;AACtB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,YAAY,CAAC;AACpB,OAAO,iBAAiB,CAAC;AACzB,OAAO,aAAa,CAAC;AACrB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,WAAW,CAAC;AACnB,OAAO,YAAY,CAAC;AACpB,OAAO,WAAW,CAAC;AACnB,OAAO,eAAe,CAAC;AACvB,OAAO,WAAW,CAAC;AACnB,OAAO,aAAa,CAAC"}

package/dist/cli/commands/index.js

@@ -0,0 +1,22 @@
+// Import command files to register them with the registry
+import "./project.js";
+import "./project-updates.js";
+import "./task.js";
+import "./plan.js";
+import "./knowledge.js";
+import "./knowledge-search.js";
+import "./utility.js";
+import "./batch.js";
+import "./diagram.js";
+import "./diagnostics.js";
+import "./graph.js";
+import "./dependency.js";
+import "./bundle.js";
+import "./maintenance.js";
+import "./loop.js";
+import "./brief.js";
+import "./next.js";
+import "./remember.js";
+import "./done.js";
+import "./status.js";
+//# sourceMappingURL=index.js.map