@chiralkit/cli 0.1.0-alpha.0

package/dist/automation/schema.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { PARSERS } from "./parsers/index.js";
+import { VERIFIERS } from "./verifiers/index.js";
+const verifierKinds = Object.keys(VERIFIERS);
+const parserKinds = Object.keys(PARSERS);
+const cronTrigger = z.object({
+    kind: z.literal("cron"),
+    expression: z.string().min(1),
+    target: z.enum(["launchd"]),
+}).strict();
+const eventTrigger = z.object({
+    kind: z.literal("event"),
+    expression: z.string().min(1),
+    target: z.enum(["launchd"]),
+}).strict();
+const onDemandTrigger = z.object({
+    kind: z.literal("on-demand"),
+}).strict();
+const triggerSchema = z.discriminatedUnion("kind", [
+    cronTrigger,
+    eventTrigger,
+    onDemandTrigger,
+]);
+export const AutomationSchema = z.object({
+    name: z.string().regex(/^[a-z][a-z0-9-]*$/, "name must match /^[a-z][a-z0-9-]*$/"),
+    promise: z.string().min(1).max(200),
+    verifier: z.object({
+        kind: z.enum(verifierKinds),
+        command: z.string().min(1),
+        cwd: z.string().default("."),
+        timeout_seconds: z.number().int().min(1).max(3600).default(60),
+        parse: z.enum(parserKinds).default("exit-code"),
+    }),
+    trigger: triggerSchema,
+    broadcast: z.object({
+        on: z.array(z.enum(["drift", "failure"])).min(1),
+        channels: z.array(z.string().min(1)).min(1),
+    }),
+    retention: z.object({
+        runs: z.number().int().min(1).default(100),
+    }).default({ runs: 100 }),
+});
+export function parseAutomationConfig(raw) {
+    return AutomationSchema.parse(raw);
+}
+//# sourceMappingURL=schema.js.map

package/dist/automation/schema.js.map

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

package/dist/automation/status.d.ts

@@ -0,0 +1,16 @@
+export interface AutomationRow {
+    name: string;
+    promise: string;
+    triggerExpression: string;
+    status: "ok" | "drift" | "failure" | "never-run";
+    lastRun: string | null;
+    lastSummary: string | null;
+    nextTrigger: string | null;
+    parsed: unknown;
+}
+export interface StatusDependencies {
+    listDir: (path: string) => Promise<string[]>;
+    readText: (path: string) => Promise<string>;
+    fileExists: (path: string) => Promise<boolean>;
+}
+export declare function getAutomationStatus(cwd: string, deps: StatusDependencies): Promise<AutomationRow[]>;

package/dist/automation/status.js

@@ -0,0 +1,56 @@
+import { join } from "node:path";
+import { parseAutomationConfig } from "./schema.js";
+const SEVERITY = { failure: 0, drift: 1, "never-run": 2, ok: 3 };
+function classify(state) {
+    if (!state)
+        return "never-run";
+    // Drift is a semantic signal that the parser already encoded — the runner
+    // conventionally emits exit=1 as its wire, so drift wins over failure when
+    // both are set. A non-zero exit without drift means the verifier actually
+    // crashed (ENOENT, timeout, unhandled throw) and stays "failure".
+    if (state.last_drift)
+        return "drift";
+    if (state.last_exit !== 0)
+        return "failure";
+    return "ok";
+}
+export async function getAutomationStatus(cwd, deps) {
+    const dir = join(cwd, "automations");
+    let names;
+    try {
+        names = await deps.listDir(dir);
+    }
+    catch {
+        return [];
+    }
+    const rows = [];
+    for (const name of names) {
+        if (name.startsWith("."))
+            continue;
+        const configPath = join(dir, name, "automation.json");
+        if (!(await deps.fileExists(configPath)))
+            continue;
+        const config = parseAutomationConfig(JSON.parse(await deps.readText(configPath)));
+        const statePath = join(dir, name, "state.json");
+        let state = null;
+        if (await deps.fileExists(statePath)) {
+            try {
+                state = JSON.parse(await deps.readText(statePath));
+            }
+            catch { /* ignore */ }
+        }
+        const status = classify(state);
+        rows.push({
+            name,
+            promise: config.promise,
+            triggerExpression: config.trigger.kind === "on-demand" ? "on-demand" : config.trigger.expression,
+            status,
+            lastRun: state?.last_run ?? null,
+            lastSummary: state?.last_summary ?? null,
+            nextTrigger: state?.next_trigger ?? null,
+            parsed: state?.last_parsed ?? null,
+        });
+    }
+    return rows.sort((a, b) => SEVERITY[a.status] - SEVERITY[b.status]);
+}
+//# sourceMappingURL=status.js.map

package/dist/automation/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/automation/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAoBpD,MAAM,QAAQ,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAW,CAAC;AAE1E,SAAS,QAAQ,CAAC,KAAuB;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,WAAW,CAAC;IAC/B,0EAA0E;IAC1E,2EAA2E;IAC3E,0EAA0E;IAC1E,kEAAkE;IAClE,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC;IACrC,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,IAAwB;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACrC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QAAC,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IACxC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;IAEpB,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAAE,SAAS;QACnD,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAChD,IAAI,KAAK,GAAqB,IAAI,CAAC;QACnC,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC;gBAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACjG,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC;YACR,IAAI;YACJ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU;YAChG,MAAM;YACN,OAAO,EAAE,KAAK,EAAE,QAAQ,IAAI,IAAI;YAChC,WAAW,EAAE,KAAK,EAAE,YAAY,IAAI,IAAI;YACxC,WAAW,EAAE,KAAK,EAAE,YAAY,IAAI,IAAI;YACxC,MAAM,EAAE,KAAK,EAAE,WAAW,IAAI,IAAI;SACnC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/automation/verifiers/index.d.ts

@@ -0,0 +1,7 @@
+import type { Verifier } from "./types.js";
+export declare const VERIFIERS: {
+    shell: Verifier<import("./shell.js").ShellVerifierConfig>;
+};
+export type VerifierKind = keyof typeof VERIFIERS;
+export type { Verifier, VerifierContext, VerifierResult } from "./types.js";
+export type { ShellVerifierConfig } from "./shell.js";

package/dist/automation/verifiers/index.js

@@ -0,0 +1,5 @@
+import { shellVerifier } from "./shell.js";
+export const VERIFIERS = {
+    shell: shellVerifier,
+};
+//# sourceMappingURL=index.js.map

package/dist/automation/verifiers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/automation/verifiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,aAAa;CACmB,CAAC"}

package/dist/automation/verifiers/shell.d.ts

@@ -0,0 +1,5 @@
+import type { Verifier } from "./types.js";
+export interface ShellVerifierConfig {
+    command: string;
+}
+export declare const shellVerifier: Verifier<ShellVerifierConfig>;

package/dist/automation/verifiers/shell.js

@@ -0,0 +1,17 @@
+import { execFile } from "node:child_process";
+export const shellVerifier = (config, ctx) => {
+    return new Promise((resolve) => {
+        const start = Date.now();
+        const child = execFile("/bin/sh", ["-c", config.command], { cwd: ctx.cwd, env: ctx.env, timeout: ctx.timeoutMs, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+            const durationMs = Date.now() - start;
+            if (error && error.killed) {
+                resolve({ exit: 124, stdout: String(stdout), stderr: String(stderr), durationMs });
+                return;
+            }
+            const exit = error?.code !== undefined ? Number(error.code) : 0;
+            resolve({ exit, stdout: String(stdout), stderr: String(stderr), durationMs });
+        });
+        void child;
+    });
+};
+//# sourceMappingURL=shell.js.map

package/dist/automation/verifiers/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/automation/verifiers/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK9C,MAAM,CAAC,MAAM,aAAa,GAAkC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAC1E,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,QAAQ,CACpB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EACjC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EACnF,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACtC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC1B,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;gBACnF,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QAChF,CAAC,CACF,CAAC;QACF,KAAK,KAAK,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/automation/verifiers/types.d.ts

@@ -0,0 +1,12 @@
+export interface VerifierContext {
+    cwd: string;
+    timeoutMs: number;
+    env: NodeJS.ProcessEnv;
+}
+export interface VerifierResult {
+    exit: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+export type Verifier<Config> = (config: Config, ctx: VerifierContext) => Promise<VerifierResult>;

package/dist/automation/verifiers/types.js

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

package/dist/automation/verifiers/types.js.map

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

package/dist/backlog/add.d.ts

@@ -0,0 +1,10 @@
+export interface AppendInboxOpts {
+    backlogPath: string;
+    text: string;
+    note?: string;
+    capturedDate: string;
+    source: "chiralkit-workspace" | "human";
+}
+export declare function appendInboxItem(opts: AppendInboxOpts): Promise<{
+    line: number;
+}>;

package/dist/backlog/add.js

@@ -0,0 +1,30 @@
+import { readFile, writeFile } from "node:fs/promises";
+const INBOX_HEADER = "## Inbox (unrefined)";
+const INBOX_COMMENT = "<!-- Raw captures awaiting refinement F(3). Do not manually reorder; refinement moves items from here into the priority sections above. -->";
+export async function appendInboxItem(opts) {
+    const text = opts.text.replace(/\s+/g, " ").trim();
+    if (!text)
+        throw new Error("Backlog item text is required and cannot be empty.");
+    let md = await readFile(opts.backlogPath, "utf8");
+    const bullet = `- [ ] [status:inbox] [captured:${opts.capturedDate}] ${text} <!-- source: ${opts.source} -->`;
+    const trimmedNote = opts.note?.replace(/\s+/g, " ").trim();
+    const noteBullet = trimmedNote ? `\n  - ${trimmedNote}` : "";
+    const idx = md.indexOf(INBOX_HEADER);
+    if (idx === -1) {
+        const prefix = md.endsWith("\n") ? md : md + "\n";
+        md = prefix + `\n${INBOX_HEADER}\n\n${INBOX_COMMENT}\n\n${bullet}${noteBullet}\n`;
+    }
+    else {
+        const before = md.slice(0, idx);
+        const after = md.slice(idx);
+        const nextH2 = after.search(/\n## /);
+        const section = nextH2 === -1 ? after : after.slice(0, nextH2);
+        const rest = nextH2 === -1 ? "" : after.slice(nextH2);
+        const trimmedSection = section.replace(/\s+$/, "");
+        md = before + trimmedSection + `\n${bullet}${noteBullet}\n` + (rest.startsWith("\n") ? rest : "\n" + rest);
+    }
+    await writeFile(opts.backlogPath, md, "utf8");
+    const line = md.split("\n").findIndex((l) => l.trim() === bullet.trim()) + 1;
+    return { line };
+}
+//# sourceMappingURL=add.js.map

package/dist/backlog/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/backlog/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAC5C,MAAM,aAAa,GACjB,6IAA6I,CAAC;AAUhJ,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAqB;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACjF,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,kCAAkC,IAAI,CAAC,YAAY,KAAK,IAAI,iBAAiB,IAAI,CAAC,MAAM,MAAM,CAAC;IAC9G,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;QAClD,EAAE,GAAG,MAAM,GAAG,KAAK,YAAY,OAAO,aAAa,OAAO,MAAM,GAAG,UAAU,IAAI,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,EAAE,GAAG,MAAM,GAAG,cAAc,GAAG,KAAK,MAAM,GAAG,UAAU,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7G,CAAC;IAED,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IAC7E,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/backlog/index.d.ts

@@ -0,0 +1 @@
+export declare function runBacklogCommand(argv: string[]): Promise<number>;

package/dist/backlog/index.js

@@ -0,0 +1,53 @@
+import { join } from "node:path";
+import { KIT_NAMES, resolveKitsRoot } from "@chiralkit/kits";
+import { appendInboxItem } from "./add.js";
+const HELP = `chiralkit backlog — capture raw items to a kit's Inbox
+
+Usage:
+  chiralkit backlog add <kit> "<text>" [--note "<note>"]
+
+Kits: ${KIT_NAMES.join(", ")}
+`;
+export async function runBacklogCommand(argv) {
+    const [sub, ...rest] = argv;
+    if (!sub || sub === "--help" || sub === "-h") {
+        console.log(HELP);
+        return 0;
+    }
+    if (sub !== "add") {
+        console.error(`Unknown subcommand: ${sub}. See 'chiralkit backlog --help'.`);
+        return 1;
+    }
+    const [kit, text, ...tail] = rest;
+    if (!kit || !KIT_NAMES.includes(kit)) {
+        console.error(`Unknown kit: '${kit ?? ""}'. Valid kits: ${KIT_NAMES.join(", ")}.`);
+        return 1;
+    }
+    if (!text || text.trim().length === 0) {
+        console.error("Backlog item text is required and cannot be empty.");
+        return 2;
+    }
+    let note;
+    for (let i = 0; i < tail.length; i++) {
+        if (tail[i] === "--note") {
+            note = tail[i + 1];
+            i++;
+        }
+    }
+    const backlogPath = join(resolveKitsRoot(), kit, "BACKLOG.md");
+    const source = process.env.CHIRALKIT_INVOKED_BY === "chiralkit-workspace" ? "chiralkit-workspace" : "human";
+    const capturedDate = new Date().toISOString().slice(0, 10);
+    try {
+        const { line } = await appendInboxItem({ backlogPath, text, note, capturedDate, source });
+        console.log(`Appended to kits/${kit}/BACKLOG.md § Inbox (unrefined) at line ${line}.`);
+        return 0;
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            console.error(`Backlog file not found: kits/${kit}/BACKLOG.md`);
+            return 3;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/backlog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backlog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,IAAI,GAAG;;;;;QAKL,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAc;IACpD,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,mCAAmC,CAAC,CAAC;QAC7E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAClC,IAAI,CAAC,GAAG,IAAI,CAAE,SAA+B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,kBAAkB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAwB,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACzB,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACnB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/F,MAAM,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1F,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,2CAA2C,IAAI,GAAG,CAAC,CAAC;QACvF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,aAAa,CAAC,CAAC;YAChE,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+import type { FrameworkTarget } from "@chiralkit/registry-schema";
+export declare const CONFIG_DIR = "ck";
+export declare const CONFIG_FILE = "chiralkit.config.json";
+export declare function configPath(cwd: string): string;
+export interface ChiralkitPaths {
+    components: string;
+    assets: string;
+}
+export interface ChiralkitConfig {
+    framework: FrameworkTarget;
+    registry_path: string;
+    paths: ChiralkitPaths;
+}
+export declare function defaultPaths(framework: FrameworkTarget): ChiralkitPaths;
+export declare function configExists(cwd: string): Promise<boolean>;
+export declare function legacyConfigExists(cwd: string): Promise<boolean>;
+export declare function legacyMigrationHint(cwd: string): string;
+export declare function readConfig(cwd: string): Promise<ChiralkitConfig>;
+export declare function writeConfig(cwd: string, config: ChiralkitConfig): Promise<void>;
+export interface MaintainerBlock {
+    design_system_path: string;
+    registry_path: string;
+}
+export declare function readConfigRaw(cwd: string): Promise<Record<string, unknown> | null>;
+export declare function writeConfigRaw(cwd: string, obj: Record<string, unknown>): Promise<void>;
+export declare function readMaintainerConfig(cwd: string): Promise<MaintainerBlock>;

package/dist/config.js

@@ -0,0 +1,110 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export const CONFIG_DIR = "ck";
+export const CONFIG_FILE = "chiralkit.config.json";
+export function configPath(cwd) {
+    return join(cwd, CONFIG_DIR, CONFIG_FILE);
+}
+export function defaultPaths(framework) {
+    switch (framework) {
+        case "react":
+            return {
+                components: "src/components/chiralkit",
+                assets: "public/chiralkit",
+            };
+        case "django-template":
+            return {
+                components: "templates/chiralkit",
+                assets: "static/chiralkit-ds",
+            };
+        case "html":
+            return { components: "components", assets: "assets" };
+    }
+}
+export async function configExists(cwd) {
+    try {
+        await access(configPath(cwd));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// A project predating the ck/ folder had chiralkit.config.json at the
+// project root. Detect it so init/read paths can point the user at the
+// one-line move instead of silently drifting.
+export async function legacyConfigExists(cwd) {
+    try {
+        await access(join(cwd, CONFIG_FILE));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function legacyMigrationHint(cwd) {
+    return `Legacy config at ${join(cwd, CONFIG_FILE)} — move it: \`mkdir -p ${CONFIG_DIR} && git mv ${CONFIG_FILE} ${CONFIG_DIR}/${CONFIG_FILE}\`.`;
+}
+export async function readConfig(cwd) {
+    const path = configPath(cwd);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        const hint = (await legacyConfigExists(cwd))
+            ? ` ${legacyMigrationHint(cwd)}`
+            : ` Run 'chiralkit init' first.`;
+        throw new Error(`No ${CONFIG_DIR}/${CONFIG_FILE} found in ${cwd}.${hint}`);
+    }
+    return JSON.parse(raw);
+}
+export async function writeConfig(cwd, config) {
+    const path = configPath(cwd);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+export async function readConfigRaw(cwd) {
+    const path = configPath(cwd);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new Error(`${path} is not a JSON object at the top level.`);
+    }
+    return parsed;
+}
+export async function writeConfigRaw(cwd, obj) {
+    const path = configPath(cwd);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(obj, null, 2) + "\n", "utf8");
+}
+export async function readMaintainerConfig(cwd) {
+    const parsed = await readConfigRaw(cwd);
+    if (parsed === null) {
+        const hint = (await legacyConfigExists(cwd))
+            ? ` ${legacyMigrationHint(cwd)}`
+            : ` Run 'chiralkit init --maintainer' first.`;
+        throw new Error(`no ${CONFIG_DIR}/${CONFIG_FILE} found in ${cwd}.${hint}`);
+    }
+    const m = parsed["maintainer"];
+    if (typeof m !== "object" || m === null || Array.isArray(m)) {
+        throw new Error(`${CONFIG_DIR}/${CONFIG_FILE} has no 'maintainer' block. Run 'chiralkit init --maintainer' to add it, or edit the file to include design_system_path and registry_path.`);
+    }
+    const block = m;
+    const ds = block["design_system_path"];
+    const rp = block["registry_path"];
+    if (typeof ds !== "string" || ds.length === 0) {
+        throw new Error(`maintainer.design_system_path is required (a repo-relative path to the DS components directory, e.g. 'packages/design-system/src/components').`);
+    }
+    if (typeof rp !== "string" || rp.length === 0) {
+        throw new Error(`maintainer.registry_path is required (a repo-relative path to the registry root, e.g. 'registry').`);
+    }
+    return { design_system_path: ds, registry_path: rp };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/detect.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkTarget } from "@chiralkit/registry-schema";
+export declare function detectFramework(cwd: string): Promise<FrameworkTarget | null>;

package/dist/detect.js

@@ -0,0 +1,26 @@
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectFramework(cwd) {
+    if (await fileExists(join(cwd, "manage.py")))
+        return "django-template";
+    const pkgPath = join(cwd, "package.json");
+    if (await fileExists(pkgPath)) {
+        const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        if (deps["react"])
+            return "react";
+    }
+    if (await fileExists(join(cwd, "index.html")))
+        return "html";
+    return null;
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW;IAEX,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAGrD,CAAC;QACF,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;QAC7D,IAAI,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;IACpC,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/doctor-invariants.d.ts

@@ -0,0 +1,6 @@
+import type { Module } from "@chiralkit/registry-schema";
+export interface InvariantReport {
+    errors: string[];
+    oks: string[];
+}
+export declare function runInvariants(modules: Module[]): InvariantReport;

package/dist/doctor-invariants.js

@@ -0,0 +1,50 @@
+// The four invariants defined in 2026-07-24-agent-modules-design.md §3.
+// Level comparison reads envelope.metadata.level (source of truth since 5ef54b2).
+export function runInvariants(modules) {
+    const errors = [];
+    const oks = [];
+    const byName = new Map(modules.map((m) => [m.name, m]));
+    const reportedPairs = new Set();
+    for (const m of modules) {
+        const spec = m.spec;
+        // Rule 4a: pipeline_stage only for agents.
+        if (spec.pipeline_stage !== undefined && m.type !== "agent") {
+            errors.push(`${m.name}: pipeline_stage is only valid for type=agent (found type=${m.type})`);
+        }
+        // Rule 4b: pipeline_stage only at L3.
+        if (spec.pipeline_stage !== undefined && m.metadata.level !== 3) {
+            errors.push(`${m.name}: pipeline_stage is only valid at L3 (found level=${m.metadata.level})`);
+        }
+        if (spec.enantiomer_of === undefined)
+            continue;
+        const partner = byName.get(spec.enantiomer_of);
+        if (!partner) {
+            errors.push(`${m.name}: enantiomer_of points at "${spec.enantiomer_of}" which is not in the registry`);
+            continue;
+        }
+        const partnerSpec = partner.spec;
+        // Dedupe pair reporting.
+        const key = [m.name, partner.name].sort().join(" ↔ ");
+        if (reportedPairs.has(key))
+            continue;
+        reportedPairs.add(key);
+        // Rule 1: reciprocity.
+        if (partnerSpec.enantiomer_of !== m.name) {
+            errors.push(`${key}: reciprocity broken (${partner.name}.enantiomer_of=${partnerSpec.enantiomer_of ?? "unset"})`);
+            continue;
+        }
+        // Rule 2: matching chiral_axis.
+        if (spec.chiral_axis !== partnerSpec.chiral_axis) {
+            errors.push(`${key}: chiral_axis mismatch ("${spec.chiral_axis}" vs "${partnerSpec.chiral_axis}")`);
+            continue;
+        }
+        // Rule 3: same metadata.level.
+        if (m.metadata.level !== partner.metadata.level) {
+            errors.push(`${key}: metadata.level mismatch (${m.metadata.level} vs ${partner.metadata.level})`);
+            continue;
+        }
+        oks.push(`chirality: ${key} on axis "${spec.chiral_axis}"`);
+    }
+    return { errors, oks };
+}
+//# sourceMappingURL=doctor-invariants.js.map

package/dist/doctor-invariants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-invariants.js","sourceRoot":"","sources":["../src/doctor-invariants.ts"],"names":[],"mappings":"AAOA,wEAAwE;AACxE,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,OAAiB;IAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,IAId,CAAC;QAEF,2CAA2C;QAC3C,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,6DAA6D,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/F,CAAC;QACD,sCAAsC;QACtC,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,qDAAqD,CAAC,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;QACjG,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;YAAE,SAAS;QAE/C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,8BAA8B,IAAI,CAAC,aAAa,gCAAgC,CAAC,CAAC;YACvG,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAG3B,CAAC;QAEF,yBAAyB;QACzB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACrC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEvB,uBAAuB;QACvB,IAAI,WAAW,CAAC,aAAa,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,yBAAyB,OAAO,CAAC,IAAI,kBAAkB,WAAW,CAAC,aAAa,IAAI,OAAO,GAAG,CAAC,CAAC;YAClH,SAAS;QACX,CAAC;QACD,gCAAgC;QAChC,IAAI,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,4BAA4B,IAAI,CAAC,WAAW,SAAS,WAAW,CAAC,WAAW,IAAI,CAAC,CAAC;YACpG,SAAS;QACX,CAAC;QACD,+BAA+B;QAC/B,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,8BAA8B,CAAC,CAAC,QAAQ,CAAC,KAAK,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;YAClG,SAAS;QACX,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,cAAc,GAAG,aAAa,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACzB,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,13 @@
+import { type AgentSpec } from "@chiralkit/registry-schema";
+export interface Report {
+    errors: string[];
+    warnings: string[];
+    oks: string[];
+}
+export interface AgentFileValidation {
+    problems: string[];
+    warnings: string[];
+}
+export declare function validateAgentFiles(moduleDir: string, spec: AgentSpec): Promise<AgentFileValidation>;
+export declare function collectDoctorReport(root: string): Promise<Report>;
+export declare function runDoctor(): Promise<void>;