@chiralkit/cli 0.1.0-alpha.0

package/dist/pm/snapshot.js

@@ -0,0 +1,129 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { discoverKitSources as defaultDiscoverKitSources } from "@chiralkit/kits";
+import { parseBacklog } from "./backlog.js";
+import { observeGit as defaultObserveGit } from "./git.js";
+import { parseRoadmap } from "./roadmap.js";
+import { sidebarRing } from "./grid.js";
+import { PRIORITY_VALUES, STATUS_VALUES } from "./types.js";
+export async function buildProjectSnapshot(options) {
+    const readText = options.readText ?? ((path) => readFile(path, "utf8"));
+    const diagnostics = [];
+    let roadmap = { horizons: [], invalid: [] };
+    let backlog = {
+        tasks: [], orderedTasks: [], invalid: [],
+        byStatus: Object.fromEntries(STATUS_VALUES.map((status) => [status, { count: 0, maxTotal: 0 }])),
+    };
+    try {
+        const parsedRoadmap = parseRoadmap(await readText(join(options.cwd, "ROADMAP.md")));
+        roadmap.horizons = parsedRoadmap.horizons;
+        roadmap.invalid = parsedRoadmap.invalid;
+        for (const invalid of parsedRoadmap.invalid) {
+            diagnostics.push({ severity: "error", code: "invalid-roadmap-item", message: invalid.reason, line: invalid.line });
+        }
+    }
+    catch (error) {
+        roadmap.error = error instanceof Error ? error.message : String(error);
+        diagnostics.push({ severity: "error", code: "source-missing", message: `ROADMAP.md: ${roadmap.error}` });
+    }
+    try {
+        const parsed = parseBacklog(await readText(join(options.cwd, "BACKLOG.md")));
+        backlog.tasks = parsed.tasks;
+        backlog.invalid = parsed.invalid;
+        backlog.orderedTasks = [...parsed.tasks].sort((a, b) => PRIORITY_VALUES.indexOf(a.priority) - PRIORITY_VALUES.indexOf(b.priority) || a.order - b.order);
+        for (const task of parsed.tasks) {
+            const aggregate = backlog.byStatus[task.status];
+            aggregate.count += 1;
+            aggregate.maxTotal += sidebarRing(task);
+            if (task.time >= 8)
+                diagnostics.push({ severity: "warning", code: "review-decomposition", message: `${task.text} (time:${task.time})`, line: task.line });
+            if (task.difficulty >= 8)
+                diagnostics.push({ severity: "warning", code: "review-decomposition", message: `${task.text} (difficulty:${task.difficulty})`, line: task.line });
+        }
+        for (const invalid of parsed.invalid) {
+            const code = invalid.reason.startsWith("legacy fib tag") ? "legacy-fib-tag" : "invalid-task";
+            diagnostics.push({ severity: "error", code, message: invalid.reason, line: invalid.line });
+        }
+    }
+    catch (error) {
+        backlog.error = error instanceof Error ? error.message : String(error);
+        diagnostics.push({ severity: "error", code: "source-missing", message: `BACKLOG.md: ${backlog.error}` });
+    }
+    const discoverKits = options.discoverKitSources ?? defaultDiscoverKitSources;
+    const kitSources = await discoverKits(join(options.cwd, "kits"));
+    for (const source of kitSources) {
+        if (source.roadmapPath) {
+            try {
+                const parsed = parseRoadmap(await readText(source.roadmapPath));
+                for (const horizon of parsed.horizons) {
+                    for (const item of horizon.items) {
+                        if (!item.kit)
+                            item.kit = source.name;
+                    }
+                }
+                for (const horizon of parsed.horizons) {
+                    const existing = roadmap.horizons.find((h) => h.key === horizon.key);
+                    if (existing)
+                        existing.items.push(...horizon.items);
+                    else
+                        roadmap.horizons.push(horizon);
+                }
+                roadmap.invalid.push(...parsed.invalid);
+                for (const invalid of parsed.invalid) {
+                    diagnostics.push({ severity: "error", code: "invalid-roadmap-item", message: invalid.reason, line: invalid.line });
+                }
+            }
+            catch (error) {
+                diagnostics.push({
+                    severity: "error",
+                    code: "source-missing",
+                    message: `${source.roadmapPath}: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+        if (source.backlogPath) {
+            try {
+                const parsed = parseBacklog(await readText(source.backlogPath));
+                for (const task of parsed.tasks) {
+                    if (!task.kit)
+                        task.kit = source.name;
+                }
+                backlog.tasks.push(...parsed.tasks);
+                backlog.invalid.push(...parsed.invalid);
+                for (const task of parsed.tasks) {
+                    if (task.time >= 8)
+                        diagnostics.push({ severity: "warning", code: "review-decomposition", message: `${task.text} (time:${task.time})`, line: task.line });
+                    if (task.difficulty >= 8)
+                        diagnostics.push({ severity: "warning", code: "review-decomposition", message: `${task.text} (difficulty:${task.difficulty})`, line: task.line });
+                }
+                for (const invalid of parsed.invalid) {
+                    const code = invalid.reason.startsWith("legacy fib tag") ? "legacy-fib-tag" : "invalid-task";
+                    diagnostics.push({ severity: "error", code, message: invalid.reason, line: invalid.line });
+                }
+            }
+            catch (error) {
+                diagnostics.push({
+                    severity: "error",
+                    code: "source-missing",
+                    message: `${source.backlogPath}: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+    }
+    // Recompute derived aggregates so they reflect the merged (top-level + per-kit) set.
+    backlog.orderedTasks = [...backlog.tasks].sort((a, b) => PRIORITY_VALUES.indexOf(a.priority) - PRIORITY_VALUES.indexOf(b.priority) || a.order - b.order);
+    backlog.byStatus = Object.fromEntries(STATUS_VALUES.map((status) => [status, { count: 0, maxTotal: 0 }]));
+    for (const task of backlog.tasks) {
+        const aggregate = backlog.byStatus[task.status];
+        aggregate.count += 1;
+        aggregate.maxTotal += sidebarRing(task);
+    }
+    const git = await (options.observeGit ?? defaultObserveGit)(options.cwd);
+    if (!git.available)
+        diagnostics.push({ severity: "warning", code: "git-unavailable", message: git.reason ?? "unknown error" });
+    return { roadmap, backlog, git, diagnostics };
+}
+export function hasSnapshotErrors(snapshot) {
+    return snapshot.diagnostics.some((diagnostic) => diagnostic.severity === "error");
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/pm/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/pm/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,IAAI,yBAAyB,EAAkB,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,aAAa,EAA+E,MAAM,YAAY,CAAC;AASzI,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA6B;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChF,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,IAAI,OAAO,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAgC,CAAC;IAC1E,IAAI,OAAO,GAAG;QACZ,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;QACxC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAA2C;KAC7G,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QACpF,OAAO,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;QAC1C,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;QACxC,KAAK,MAAM,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC5C,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC7B,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACjC,OAAO,CAAC,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACxJ,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC;YACrB,SAAS,CAAC,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;gBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1J,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC;gBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,gBAAgB,IAAI,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9K,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,CAAC;YAC7F,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,kBAAkB,IAAI,yBAAyB,CAAC;IAC7E,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;gBAChE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;wBACjC,IAAI,CAAC,IAAI,CAAC,GAAG;4BAAE,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;oBACxC,CAAC;gBACH,CAAC;gBACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;oBACrE,IAAI,QAAQ;wBAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;;wBAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtC,CAAC;gBACD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBACxC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACrC,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrH,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,WAAW,CAAC,IAAI,CAAC;oBACf,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC5F,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;gBAChE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAChC,IAAI,CAAC,IAAI,CAAC,GAAG;wBAAE,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;gBACxC,CAAC;gBACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBACxC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAChC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;wBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC1J,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC;wBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,gBAAgB,IAAI,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9K,CAAC;gBACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACrC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,CAAC;oBAC7F,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC7F,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,WAAW,CAAC,IAAI,CAAC;oBACf,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC5F,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,OAAO,CAAC,YAAY,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CACzG,CAAC;IACF,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,CACnC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CACzB,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC;QACrB,SAAS,CAAC,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzE,IAAI,CAAC,GAAG,CAAC,SAAS;QAAE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC,CAAC;IAC/H,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAyB;IACzD,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AACpF,CAAC"}

package/dist/pm/types.d.ts

@@ -0,0 +1,99 @@
+export declare const FIB_VALUES: readonly [0, 1, 2, 3, 5, 8, 13];
+export type Fib = (typeof FIB_VALUES)[number];
+export declare const PRIORITY_VALUES: readonly ["P0", "P1", "P2", "P3"];
+export type Priority = (typeof PRIORITY_VALUES)[number];
+export declare const STATUS_VALUES: readonly ["ready", "active", "blocked", "done"];
+export type TaskStatus = (typeof STATUS_VALUES)[number];
+export declare const AREAS: readonly ["web", "workspace", "cli", "ds", "docs", "agents", "generator", "training", "pm", "automations", "ceremonies"];
+export type Area = (typeof AREAS)[number];
+declare const DIAGNOSTIC_CODES: readonly ["invalid-task", "invalid-roadmap-item", "source-missing", "review-decomposition", "git-unavailable", "legacy-fib-tag"];
+export type DiagnosticCode = (typeof DIAGNOSTIC_CODES)[number];
+export interface BacklogTask {
+    area: string;
+    text: string;
+    checked: boolean;
+    time: Fib;
+    difficulty: Fib;
+    priority: Priority;
+    status: TaskStatus;
+    line: number;
+    order: number;
+    kit?: string;
+}
+export interface InvalidBacklogTask {
+    area: string;
+    raw: string;
+    line: number;
+    reason: string;
+}
+export interface BacklogParseResult {
+    tasks: BacklogTask[];
+    invalid: InvalidBacklogTask[];
+}
+export declare const ROADMAP_STATUS_VALUES: readonly ["now", "later", "cleanup", "done"];
+export type RoadmapStatus = (typeof ROADMAP_STATUS_VALUES)[number];
+export interface RoadmapItem {
+    title: string;
+    description: string;
+    checked: boolean;
+    start: string;
+    end: string;
+    priority: Priority;
+    status: RoadmapStatus;
+    area: string;
+    line: number;
+    kit?: string;
+}
+export interface InvalidRoadmapItem {
+    horizonKey: string;
+    raw: string;
+    line: number;
+    reason: string;
+}
+export interface RoadmapHorizon {
+    key: string;
+    title: string;
+    items: RoadmapItem[];
+}
+export interface RoadmapParseResult {
+    horizons: RoadmapHorizon[];
+    invalid: InvalidRoadmapItem[];
+}
+export interface GitWorktree {
+    path: string;
+    branch: string;
+    current: boolean;
+    dirty: boolean;
+}
+export interface GitObservation {
+    available: boolean;
+    reason?: string;
+    worktrees: GitWorktree[];
+}
+export interface Diagnostic {
+    severity: "warning" | "error";
+    code: DiagnosticCode;
+    message: string;
+    line?: number;
+}
+export interface StatusAggregate {
+    count: number;
+    maxTotal: number;
+}
+export interface ProjectSnapshot {
+    roadmap: {
+        horizons: RoadmapHorizon[];
+        invalid: InvalidRoadmapItem[];
+        error?: string;
+    };
+    backlog: {
+        tasks: BacklogTask[];
+        orderedTasks: BacklogTask[];
+        invalid: InvalidBacklogTask[];
+        byStatus: Record<TaskStatus, StatusAggregate>;
+        error?: string;
+    };
+    git: GitObservation;
+    diagnostics: Diagnostic[];
+}
+export {};

package/dist/pm/types.js

@@ -0,0 +1,29 @@
+export const FIB_VALUES = [0, 1, 2, 3, 5, 8, 13];
+export const PRIORITY_VALUES = ["P0", "P1", "P2", "P3"];
+export const STATUS_VALUES = ["ready", "active", "blocked", "done"];
+// Canonical areas — declared per-task via `[area:<name>]` inline tag.
+// H2 sections in BACKLOG.md are visual only; they normalize into these when
+// no inline tag is present. Adding a new area is intentional (not just a new H2).
+export const AREAS = [
+    "web",
+    "workspace",
+    "cli",
+    "ds",
+    "docs",
+    "agents",
+    "generator",
+    "training",
+    "pm",
+    "automations",
+    "ceremonies",
+];
+const DIAGNOSTIC_CODES = [
+    "invalid-task",
+    "invalid-roadmap-item",
+    "source-missing",
+    "review-decomposition",
+    "git-unavailable",
+    "legacy-fib-tag",
+];
+export const ROADMAP_STATUS_VALUES = ["now", "later", "cleanup", "done"];
+//# sourceMappingURL=types.js.map

package/dist/pm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pm/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAU,CAAC;AAG1D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAGjE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAG7E,sEAAsE;AACtE,4EAA4E;AAC5E,kFAAkF;AAClF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK;IACL,WAAW;IACX,KAAK;IACL,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,WAAW;IACX,UAAU;IACV,IAAI;IACJ,aAAa;IACb,YAAY;CACJ,CAAC;AAGX,MAAM,gBAAgB,GAAG;IACvB,cAAc;IACd,sBAAsB;IACtB,gBAAgB;IAChB,sBAAsB;IACtB,iBAAiB;IACjB,gBAAgB;CACR,CAAC;AA4BX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC"}

package/dist/registry-layout.d.ts

@@ -0,0 +1,18 @@
+import { type KitName } from "@chiralkit/kits";
+import { type Level, type ModuleType } from "@chiralkit/registry-schema";
+export declare const MODULE_ENVELOPE_FILENAME: "module.json";
+export declare const TYPE_TO_FAMILY: Record<ModuleType, string>;
+export declare const TYPE_TO_KIT: Record<ModuleType, KitName>;
+export declare function parseTypeFlag(args: string[], onInvalid: (message: string) => never): ModuleType | undefined;
+export declare function parseLevelFlag(args: string[], onInvalid: (message: string) => never): Level | undefined;
+export interface RegistryModuleRefBase {
+    family: string;
+    name: string;
+    moduleDir: string;
+    envelopePath: string;
+}
+export interface RegistryModuleRef extends RegistryModuleRefBase {
+    kit: KitName;
+}
+export declare function walkRegistryModules(registryRoot: string): Promise<RegistryModuleRefBase[]>;
+export declare function walkAllKitRegistries(kitsRoot: string): Promise<RegistryModuleRef[]>;

package/dist/registry-layout.js

@@ -0,0 +1,122 @@
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { KIT_NAMES } from "@chiralkit/kits";
+import { LEVEL_VALUES, MODULE_TYPES, } from "@chiralkit/registry-schema";
+// The registry envelope filename. Renamed from `component.json` to
+// `module.json` when the registry widened past ui-component-only (see
+// docs/superpowers/plans — Agent Modules Sub-plan A, Task 2). Every CLI
+// walker imports this constant instead of hardcoding the literal.
+export const MODULE_ENVELOPE_FILENAME = "module.json";
+// `chiralkit generate <name> --type <t>` / `scaffold registry --type <t>`
+// map a module's `type` to the top-level registry family folder it lives
+// under: registry/<family>/<name>/module.json.
+export const TYPE_TO_FAMILY = {
+    "ui-component": "design-system",
+    "ui-layout": "design-system",
+    agent: "agents",
+    recipe: "recipes",
+    config: "configs",
+};
+// Maps a module's `type` to the kit that owns it (products-spiral spec
+// §4.1). recipes/configs still live under the `ui` kit until they
+// graduate to their own kits (would need to pass the chiral-element test
+// in docs/superpowers/specs/2026-08-11-chiral-element-definition.md §2).
+export const TYPE_TO_KIT = {
+    "ui-component": "ui",
+    "ui-layout": "ui",
+    agent: "agents",
+    recipe: "ui",
+    config: "ui",
+};
+// Parses a `--type <t>` flag out of an argv-shaped array, validated against
+// MODULE_TYPES. Returns undefined when the flag is absent (callers default
+// to 'ui-component' themselves — this helper only owns parsing/validation).
+// Shared by index.ts (add), scaffold.ts (scaffold registry), and
+// generate.ts so the three CLI entry points that accept --type validate it
+// identically instead of drifting.
+export function parseTypeFlag(args, onInvalid) {
+    const i = args.indexOf("--type");
+    if (i === -1)
+        return undefined;
+    const value = args[i + 1];
+    if (!value || !MODULE_TYPES.includes(value)) {
+        onInvalid(`--type must be one of ${MODULE_TYPES.join(", ")}. Got: ${value ?? "(missing)"}`);
+    }
+    return value;
+}
+// Parses a `--level <n>` flag out of an argv-shaped array, validated against
+// LEVEL_VALUES. Mirrors parseTypeFlag's shape: returns undefined when the
+// flag is absent (level has no cross-type default, so callers that require
+// it must check for undefined themselves and call onInvalid/exit).
+export function parseLevelFlag(args, onInvalid) {
+    const idx = args.indexOf("--level");
+    if (idx === -1 || idx === args.length - 1)
+        return undefined;
+    const raw = args[idx + 1];
+    const n = Number(raw);
+    if (!Number.isInteger(n) || !LEVEL_VALUES.includes(n)) {
+        onInvalid(`--level must be one of ${LEVEL_VALUES.join(",")} (got: ${raw})`);
+    }
+    return n;
+}
+// Walks the two-level registry layout: registry/<family>/<name>/. Tolerates
+// the registry root not existing, and tolerates family folders that don't
+// exist yet (agents/, recipes/, configs/ are placeholders until Task 5
+// populates them) — both simply contribute zero entries rather than
+// throwing. Only directories are considered at either level, and
+// dot-directories (e.g. a stray .gitkeep-only dir) are skipped, matching
+// doctor's original one-level skip logic.
+export async function walkRegistryModules(registryRoot) {
+    const out = [];
+    let familyEntries;
+    try {
+        familyEntries = await readdir(registryRoot, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    const families = familyEntries
+        .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+        .map((e) => e.name)
+        .sort();
+    for (const family of families) {
+        const familyPath = join(registryRoot, family);
+        let nameEntries;
+        try {
+            nameEntries = await readdir(familyPath, { withFileTypes: true });
+        }
+        catch {
+            continue; // family dir vanished between readdir calls — skip defensively
+        }
+        const names = nameEntries
+            .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+            .map((e) => e.name)
+            .sort();
+        for (const name of names) {
+            const moduleDir = join(familyPath, name);
+            out.push({
+                family,
+                name,
+                moduleDir,
+                envelopePath: join(moduleDir, MODULE_ENVELOPE_FILENAME),
+            });
+        }
+    }
+    return out;
+}
+// Walks all kit registries (kitsRoot/<kit>/registry for each kit in KIT_NAMES),
+// delegating to walkRegistryModules per kit and stamping each returned ref with
+// its kit name. Tolerates missing kit registries (returns zero entries for
+// absent kits, as walkRegistryModules already handles missing roots gracefully).
+export async function walkAllKitRegistries(kitsRoot) {
+    const out = [];
+    for (const kit of KIT_NAMES) {
+        const registryRoot = join(kitsRoot, kit, "registry");
+        const refs = await walkRegistryModules(registryRoot);
+        for (const ref of refs) {
+            out.push({ ...ref, kit });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=registry-layout.js.map

package/dist/registry-layout.js.map

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

package/dist/scaffold-registry.d.ts

@@ -0,0 +1,10 @@
+import type { Level, ModuleType } from "@chiralkit/registry-schema";
+export interface RunScaffoldRegistryOptions {
+    force?: boolean;
+    cwd?: string;
+    type?: ModuleType;
+    level: Level;
+    kitsRoot?: string;
+}
+export declare function runScaffoldRegistry(name: string, opts: RunScaffoldRegistryOptions): Promise<void>;
+export declare function flattenTokensUsed(bucketed: Record<string, string[]>): string[];