@rryando/arcs 3.0.0

package/dist/cli/commands/project.js

@@ -0,0 +1,362 @@
+// ---------------------------------------------------------------------------
+// Project commands — registry-based
+// ---------------------------------------------------------------------------
+import { existsSync, readFileSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { readRootMeta, writeRootMeta } from "../../utils/dag.js";
+import { readJsonSafe } from "../../utils/json.js";
+import { getDataDir, getProjectDir } from "../../utils/paths.js";
+import { PROJECT_DOC_FILES } from "../../utils/project-documents.js";
+import { createTask, listTasks, readKnowledgeIndex, readPlanIndex, } from "../../utils/project-memory.js";
+import { quickScan } from "../../utils/quick-scan.js";
+import { slugify } from "../../utils/slug.js";
+import { getTemplatePath, renderTemplate } from "../../utils/template.js";
+import { normalizeWorkspacePath } from "../../utils/workspace-match.js";
+import { defineCommand, ERROR_CODES, } from "../command-registry.js";
+import { failure, success } from "../output-envelope.js";
+// ---------------------------------------------------------------------------
+// project list
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "project list",
+    description: "List all tracked projects",
+    params: {},
+    handler: handleProjectList,
+});
+async function handleProjectList(_params, _flags) {
+    const dataDir = getDataDir();
+    let rootMeta;
+    try {
+        rootMeta = await readRootMeta(dataDir);
+    }
+    catch {
+        return failure("read_error", "Could not read ARCS data directory");
+    }
+    const projects = [];
+    for (const node of rootMeta.projects) {
+        const metaPath = resolve(dataDir, "projects", node.id, "meta.json");
+        let description = "";
+        if (existsSync(metaPath)) {
+            const raw = await readJsonSafe(metaPath);
+            if (raw && typeof raw.description === "string") {
+                description = raw.description;
+            }
+        }
+        projects.push({
+            slug: node.id,
+            name: node.name,
+            status: node.status,
+            description,
+            dependsOn: node.dependsOn,
+        });
+    }
+    return success(projects);
+}
+// ---------------------------------------------------------------------------
+// project get
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "project get",
+    description: "Get project metadata or a specific document",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        doc: {
+            type: "string",
+            description: "Specific doc to retrieve",
+            enum: ["overview", "tasks", "dependencies", "knowledge"],
+        },
+    },
+    handler: handleProjectGet,
+});
+async function handleProjectGet(params, _flags) {
+    const slug = params.slug;
+    const doc = params.doc;
+    const projectDir = getProjectDir(slug);
+    if (!existsSync(projectDir)) {
+        return failure(ERROR_CODES.PROJECT_NOT_FOUND, `Project "${slug}" not found`, {
+            hint: "Run 'arcs project list' to see available projects.",
+        });
+    }
+    if (doc) {
+        const fileName = PROJECT_DOC_FILES[doc];
+        if (!fileName) {
+            return failure(ERROR_CODES.INVALID_ENUM, `Invalid doc type "${doc}". Valid: overview, tasks, dependencies, knowledge`);
+        }
+        const filePath = resolve(projectDir, fileName);
+        if (!existsSync(filePath)) {
+            return failure(ERROR_CODES.ENTITY_NOT_FOUND, `Doc file not found: ${fileName}`);
+        }
+        const content = await readFile(filePath, "utf-8");
+        return success({ slug, doc, content });
+    }
+    // Return project metadata
+    const metaPath = resolve(projectDir, "meta.json");
+    const meta = JSON.parse(readFileSync(metaPath, "utf-8"));
+    return success(meta);
+}
+// ---------------------------------------------------------------------------
+// project init
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "project init",
+    description: "Initialize a new project",
+    mutation: true,
+    params: {
+        name: { type: "string", required: true, positional: 0, description: "Project name" },
+        description: { type: "string", required: true, description: "Project description" },
+        path: { type: "string", description: "Workspace path to associate" },
+    },
+    handler: handleProjectInit,
+});
+async function handleProjectInit(params, flags) {
+    const name = params.name;
+    const description = params.description;
+    const wsPath = params.path;
+    const slug = slugify(name);
+    if (flags.dryRun) {
+        return success({
+            dryRun: true,
+            wouldCreate: { slug, name, description, path: wsPath ?? process.cwd() },
+        });
+    }
+    const dataDir = getDataDir();
+    const projectDir = resolve(dataDir, "projects", slug);
+    try {
+        const rootMeta = await readRootMeta(dataDir);
+        if (rootMeta.projects.some((p) => p.id === slug)) {
+            return failure("already_exists", `Project "${slug}" already exists`);
+        }
+        await mkdir(projectDir, { recursive: true });
+        const now = new Date().toISOString();
+        const variables = {
+            id: slug,
+            name,
+            description,
+            repoUrl: "",
+            status: "draft",
+            createdAt: now,
+            dependsOnList: "—",
+            statusBlock: "**Status:** draft\n",
+            repoBlock: "",
+            upstreamBlock: "- None",
+        };
+        const templates = [
+            { tmpl: "project-meta.json.tmpl", out: "meta.json" },
+            { tmpl: "project.md.tmpl", out: "overview.md" },
+            { tmpl: "task.md.tmpl", out: "tasks.md" },
+            { tmpl: "dependency.md.tmpl", out: "dependencies.md" },
+            { tmpl: "knowledge.md.tmpl", out: "knowledge.md" },
+        ];
+        for (const { tmpl, out } of templates) {
+            const content = renderTemplate(getTemplatePath(tmpl), variables);
+            await writeFile(resolve(projectDir, out), content, "utf-8");
+        }
+        // Inject workspacePaths
+        const metaJsonPath = resolve(projectDir, "meta.json");
+        const metaObj = JSON.parse(readFileSync(metaJsonPath, "utf-8"));
+        metaObj.workspacePaths = [normalizeWorkspacePath(wsPath ?? process.cwd())];
+        await writeFile(metaJsonPath, JSON.stringify(metaObj, null, 2), "utf-8");
+        // Create indexes
+        await mkdir(resolve(projectDir, "plans"), { recursive: true });
+        await mkdir(resolve(projectDir, "knowledge"), { recursive: true });
+        await mkdir(resolve(projectDir, "tasks"), { recursive: true });
+        await writeFile(resolve(projectDir, "plans", "index.json"), JSON.stringify({ plans: [] }, null, 2), "utf-8");
+        await writeFile(resolve(projectDir, "knowledge", "index.json"), JSON.stringify({ entries: [] }, null, 2), "utf-8");
+        await writeFile(resolve(projectDir, "tasks", "index.json"), JSON.stringify({ tasks: [] }, null, 2), "utf-8");
+        // Update root meta
+        rootMeta.projects.push({ id: slug, name, status: "draft", dependsOn: [] });
+        await writeRootMeta(dataDir, rootMeta);
+        // Graphify: extract code graph and seed structural knowledge (non-fatal)
+        // Only attempt if workspace looks like a real codebase (has .git or package.json)
+        // Skip when ARCS_SKIP_GRAPHIFY=1 (used in tests to avoid spawning real binaries)
+        let graphify = null;
+        const graphifyWorkspace = wsPath ?? process.cwd();
+        const hasGit = existsSync(resolve(graphifyWorkspace, ".git"));
+        const looksLikeCodebase = hasGit || existsSync(resolve(graphifyWorkspace, "package.json"));
+        const skipGraphify = process.env.ARCS_SKIP_GRAPHIFY === "1";
+        if (looksLikeCodebase && !skipGraphify) {
+            try {
+                const { detectGraphify, runExtraction, ingestGraph } = await import("../../utils/graphify.js");
+                const { persistProposals } = await import("../../utils/graphify-knowledge.js");
+                const info = detectGraphify();
+                if (info.available) {
+                    const extraction = runExtraction(graphifyWorkspace);
+                    if (extraction.success) {
+                        const { proposals, stats } = ingestGraph(extraction.graphJsonPath, slug);
+                        let created = 0;
+                        if (proposals.length > 0) {
+                            const result = await persistProposals(slug, proposals);
+                            created = result.created;
+                        }
+                        graphify = { proposed: stats.totalProposals, created };
+                        // Offer git hook for auto-refresh on commit
+                        if (hasGit) {
+                            graphify.hooksHint =
+                                "Run `graphify hook install` in the workspace to auto-refresh the code graph on each commit.";
+                        }
+                    }
+                }
+            }
+            catch {
+                // Graphify failure never blocks project init
+            }
+        }
+        // Quick scan: extract git context and auto-create initial tasks (non-fatal)
+        // Skip when ARCS_SKIP_QUICK_SCAN=1 (used in tests)
+        let quickScanResult = null;
+        const skipQuickScan = process.env.ARCS_SKIP_QUICK_SCAN === "1";
+        if (!skipQuickScan) {
+            try {
+                const scanWorkspace = wsPath ?? process.cwd();
+                const scan = quickScan(scanWorkspace);
+                let tasksCreated = 0;
+                for (const title of scan.suggestedTasks.slice(0, 5)) {
+                    try {
+                        await createTask(projectDir, { title, status: "backlog", priority: "medium" });
+                        tasksCreated++;
+                    }
+                    catch {
+                        // Skip duplicate or invalid tasks silently
+                    }
+                }
+                if (tasksCreated > 0 || scan.suggestedTasks.length > 0) {
+                    quickScanResult = { tasksCreated, suggestedTasks: scan.suggestedTasks };
+                }
+            }
+            catch {
+                // Quick scan failure never blocks project init
+            }
+        }
+        return success({
+            slug,
+            name,
+            status: "draft",
+            dependsOn: [],
+            graphify,
+            quickScan: quickScanResult,
+        });
+    }
+    catch (err) {
+        return failure("init_error", err instanceof Error ? err.message : String(err));
+    }
+}
+// ---------------------------------------------------------------------------
+// project validate
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "project validate",
+    description: "Run structural health checks on a project",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+    },
+    handler: handleProjectValidate,
+});
+async function handleProjectValidate(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 metaPath = resolve(projectDir, "meta.json");
+    let workspacePaths = [];
+    try {
+        const rawMeta = JSON.parse(readFileSync(metaPath, "utf-8"));
+        workspacePaths = rawMeta.workspacePaths ?? [];
+    }
+    catch {
+        // continue with empty workspace paths
+    }
+    const issues = [];
+    let totalChecks = 0;
+    // Check 1: Knowledge sourceFiles exist
+    const knowledgeIndex = await readKnowledgeIndex(projectDir);
+    for (const entry of knowledgeIndex.entries) {
+        const sourceFiles = entry.sourceFiles ?? [];
+        for (const ref of sourceFiles) {
+            totalChecks++;
+            const found = workspacePaths.some((ws) => existsSync(resolve(ws, ref.path)));
+            if (!found && workspacePaths.length > 0) {
+                issues.push({
+                    severity: "warning",
+                    kind: "stale_knowledge_source",
+                    message: `Knowledge entry "${entry.title}" references missing file: ${ref.path}`,
+                    file: ref.path,
+                    repair: `Remove stale sourceFile reference from knowledge entry "${entry.id}"`,
+                    safeToAutoRepair: false,
+                });
+            }
+        }
+    }
+    // Check 2: AGENTS.md exists in workspace paths
+    for (const ws of workspacePaths) {
+        totalChecks++;
+        const agentsPath = resolve(ws, "AGENTS.md");
+        if (!existsSync(agentsPath)) {
+            issues.push({
+                severity: "info",
+                kind: "missing_agents_md",
+                message: `No AGENTS.md found at workspace path: ${ws}`,
+                file: agentsPath,
+                repair: `Run: arcs sync-agents-md ${slug} --analysis-file=<path>`,
+                safeToAutoRepair: true,
+            });
+        }
+    }
+    // Check 3: Plan diagrams
+    const planIndex = await readPlanIndex(projectDir);
+    const plansDir = resolve(projectDir, "plans");
+    const activeStatuses = ["planned", "in_progress", "blocked"];
+    for (const plan of planIndex.plans) {
+        if (!activeStatuses.includes(plan.status))
+            continue;
+        totalChecks++;
+        const diagramPath = resolve(plansDir, `${plan.normalizedId}.diagram.mmd`);
+        if (!existsSync(diagramPath)) {
+            issues.push({
+                severity: "info",
+                kind: "missing_plan_diagram",
+                message: `Active plan "${plan.title}" has no diagram file`,
+                file: diagramPath,
+                repair: `Create diagram for plan "${plan.id}" using to-diagram skill`,
+                safeToAutoRepair: false,
+            });
+        }
+    }
+    // Check 4: Plan status vs task completion
+    const allTasks = await listTasks(projectDir);
+    for (const plan of planIndex.plans) {
+        if (!activeStatuses.includes(plan.status))
+            continue;
+        const planTasks = allTasks.filter((t) => t.planId === plan.id);
+        if (planTasks.length === 0)
+            continue;
+        totalChecks++;
+        const allDone = planTasks.every((t) => t.status === "done") &&
+            !planTasks.some((t) => t.status === "cancelled");
+        if (allDone) {
+            issues.push({
+                severity: "warning",
+                kind: "plan_status_drift",
+                message: `Plan "${plan.title}" is "${plan.status}" but all ${planTasks.length} tasks are done`,
+                file: resolve(plansDir, `${plan.normalizedId}.meta.json`),
+                repair: `Update plan "${plan.id}" status to "done"`,
+                safeToAutoRepair: false,
+            });
+        }
+    }
+    const report = {
+        issues,
+        summary: {
+            totalChecks,
+            issueCount: issues.length,
+            bySeverity: {
+                error: issues.filter((i) => i.severity === "error").length,
+                warning: issues.filter((i) => i.severity === "warning").length,
+                info: issues.filter((i) => i.severity === "info").length,
+            },
+        },
+    };
+    return success(report);
+}
+//# sourceMappingURL=project.js.map

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

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

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

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

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

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

package/dist/cli/commands/remember.js

@@ -0,0 +1,70 @@
+// ---------------------------------------------------------------------------
+// remember — zero-ceremony knowledge capture
+// ---------------------------------------------------------------------------
+import { existsSync } from "node:fs";
+import { getProjectDir } from "../../utils/paths.js";
+import { createKnowledgeEntry } from "../../utils/project-memory.js";
+import { normalizeIdentifier } from "../../utils/slug.js";
+import { defineCommand, ERROR_CODES, } from "../command-registry.js";
+import { failure, success } from "../output-envelope.js";
+function classifyKind(text) {
+    const lower = text.toLowerCase();
+    if (/don't|never|careful|watch out|gotcha/.test(lower))
+        return "gotcha";
+    if (/learned|lesson|realized|mistake/.test(lower))
+        return "lesson";
+    if (/pattern|always|convention|rule/.test(lower))
+        return "pattern";
+    if (/decided|decision|chose|picked/.test(lower))
+        return "decision";
+    return "lesson";
+}
+function autoTitle(text) {
+    if (text.length <= 50)
+        return text;
+    return `${text.slice(0, 50)}...`;
+}
+defineCommand({
+    path: "remember",
+    description: "Capture a knowledge insight with zero ceremony",
+    params: {
+        slug: { type: "string", required: true, positional: 0, description: "Project slug" },
+        text: { type: "string", required: true, positional: 1, description: "The insight to remember" },
+    },
+    handler: handleRemember,
+});
+async function handleRemember(params, flags) {
+    const slug = params.slug;
+    const text = params.text;
+    const projectDir = getProjectDir(slug);
+    if (!existsSync(projectDir)) {
+        return failure(ERROR_CODES.PROJECT_NOT_FOUND, `Project "${slug}" not found`, {
+            hint: "Run 'arcs project list' to see available projects.",
+        });
+    }
+    const title = autoTitle(text);
+    const kind = classifyKind(text);
+    const id = normalizeIdentifier(title);
+    try {
+        const entry = await createKnowledgeEntry(projectDir, {
+            id,
+            title,
+            kind,
+            keywords: [],
+            summary: text,
+        });
+        if (flags.json) {
+            return success({
+                id: entry.id,
+                title: entry.title,
+                kind: entry.kind,
+                summary: text,
+            });
+        }
+        return success(`✓ Remembered [${entry.kind}]: ${entry.title}`);
+    }
+    catch (err) {
+        return failure("remember_error", err instanceof Error ? err.message : String(err));
+    }
+}
+//# sourceMappingURL=remember.js.map

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

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

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

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

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

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

package/dist/cli/commands/status.js

@@ -0,0 +1,104 @@
+// ---------------------------------------------------------------------------
+// status — Quick progress overview for a project
+// ---------------------------------------------------------------------------
+import { listTasks, readKnowledgeIndex, readPlanIndex } from "../../utils/project-memory.js";
+import { resolveProject } from "../../utils/project-resolver.js";
+import { defineCommand } from "../command-registry.js";
+import { success } from "../output-envelope.js";
+// ---------------------------------------------------------------------------
+defineCommand({
+    path: "status",
+    description: "Quick progress overview for a project",
+    params: {
+        slug: {
+            type: "string",
+            positional: 0,
+            description: "Project slug or path",
+        },
+    },
+    handler: handleStatus,
+});
+// ---------------------------------------------------------------------------
+async function handleStatus(params, flags) {
+    const rawArg = params.slug;
+    const resolved = await resolveProject(rawArg);
+    if (!resolved.ok)
+        return resolved.result;
+    const { name, projectDir } = resolved;
+    const [allTasks, planIndex, knowledgeIndex] = await Promise.all([
+        listTasks(projectDir),
+        readPlanIndex(projectDir),
+        readKnowledgeIndex(projectDir),
+    ]);
+    // Tasks
+    const openTasks = allTasks.filter((t) => t.status !== "done" && t.status !== "cancelled");
+    const doneTasks = allTasks.filter((t) => t.status === "done");
+    // Plans
+    const activePlans = planIndex.plans.filter((p) => p.status === "in_progress" || p.status === "planned");
+    const donePlans = planIndex.plans.filter((p) => p.status === "done");
+    const archivedPlans = planIndex.plans.filter((p) => p.status === "archived");
+    // Knowledge by kind
+    const kindCounts = {};
+    for (const entry of knowledgeIndex.entries) {
+        kindCounts[entry.kind] = (kindCounts[entry.kind] ?? 0) + 1;
+    }
+    const kindSummary = Object.entries(kindCounts)
+        .sort((a, b) => b[1] - a[1])
+        .map(([k, n]) => `${n} ${k}s`)
+        .join(", ");
+    // Recent: last 3 done tasks + next open task
+    const recentDone = [...doneTasks]
+        .sort((a, b) => (b.updatedAt ?? "").localeCompare(a.updatedAt ?? ""))
+        .slice(0, 3);
+    const priorityOrder = { high: 0, medium: 1, low: 2 };
+    const nextTask = [...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;
+        return ((priorityOrder[a.priority ?? "medium"] ?? 1) - (priorityOrder[b.priority ?? "medium"] ?? 1));
+    })[0];
+    if (flags.json) {
+        return success({
+            project: name,
+            plans: {
+                active: activePlans.length,
+                done: donePlans.length,
+                archived: archivedPlans.length,
+            },
+            tasks: {
+                open: openTasks.length,
+                done: doneTasks.length,
+            },
+            knowledge: {
+                total: knowledgeIndex.entries.length,
+                byKind: kindCounts,
+            },
+            recent: {
+                done: recentDone.map((t) => ({ id: t.id, title: t.title, updatedAt: t.updatedAt })),
+                next: nextTask ? { id: nextTask.id, title: nextTask.title } : null,
+            },
+        });
+    }
+    const isToday = (isoDate) => {
+        if (!isoDate)
+            return false;
+        const d = new Date(isoDate);
+        const now = new Date();
+        return (d.getFullYear() === now.getFullYear() &&
+            d.getMonth() === now.getMonth() &&
+            d.getDate() === now.getDate());
+    };
+    const lines = [
+        `Project: ${name}`,
+        `Plans: ${activePlans.length} active, ${donePlans.length} done, ${archivedPlans.length} archived`,
+        `Tasks: ${openTasks.length} open, ${doneTasks.length} done`,
+        `Knowledge: ${knowledgeIndex.entries.length} entries${kindSummary ? ` (${kindSummary})` : ""}`,
+        "",
+        "Recent:",
+        ...recentDone.map((t) => `  ✓ ${t.title} (${isToday(t.updatedAt) ? "today" : (t.updatedAt?.slice(0, 10) ?? "–")})`),
+        ...(nextTask ? [`  → ${nextTask.title} (next)`] : ["  (no open tasks)"]),
+    ];
+    return success(lines.join("\n"));
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,6 @@
+import { type TaskStatus } from "../../utils/project-memory.js";
+export declare function attemptDiagramUpdate(slug: string, planId: string, nodeId: string, status: TaskStatus): {
+    diagramUpdated: boolean;
+    diagramError?: string;
+};
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/task.ts"],"names":[],"mappings":"AASA,OAAO,EAML,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AA6OvC,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,GACjB;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CA4BpD"}