@chiralkit/cli 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xHadal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @chiralkit/cli
+
+CLI for the Chiralkit registry.
+
+## Commands
+
+- `chiralkit init [--maintainer]` — write `ck/chiralkit.config.json`. Without `--maintainer`, detects a consumer framework and writes the consumer flavor. With `--maintainer`, writes (or merges into) a `maintainer` block with `design_system_path` + `registry_path`, enabling `scaffold registry` in this repo.
+- `chiralkit add <module>` — copy a module's files into the current project.
+- `chiralkit spec from-stencil <name>` — draft a `spec.json` from a Stencil component's source.
+- `chiralkit scaffold registry <name> [--force]` — onboard a Stencil component from `<designSystemPath>/ds-<name>/` into the registry (envelope + spec + reversed symlinks + `generation.json`).
+- `chiralkit generate <name> [--stack <s>] [--dry-run] [--debug-prompt] [--force]` — LLM-generate a stack implementation from `spec.json`.
+- `chiralkit doctor` — lint the registry (envelopes, specs, implementations).
+
+## `generate` — two modes
+
+The generator reads `registry/generator.config.json`. It supports two modes; pick whichever fits.
+
+### Agent mode (default; no API key required)
+
+Uses whatever local LLM agent CLI you have installed. Only Claude Code is wired today (`claude -p`); Aider / Codex CLI / gemini-cli are extensions.
+
+```json
+{
+  "generator": {
+    "agent": "claude-code"
+  }
+}
+```
+
+Prerequisite: `claude` binary on PATH (https://docs.claude.com/claude-code/quickstart).
+
+### API mode
+
+Direct call to the Vercel AI SDK. Requires the provider's env var (`ANTHROPIC_API_KEY` for the `anthropic` provider).
+
+```json
+{
+  "generator": {
+    "model": "anthropic/claude-opus-4-8"
+  }
+}
+```
+
+Adding a provider = `pnpm --filter @chiralkit/cli add @ai-sdk/<provider>` + one case in `resolveModel()` at `src/generator/config.ts`.
+
+### Flags
+
+- `--stack <name>` — generate for a specific stack (defaults: every existing `implementations/<stack>/` folder).
+- `--dry-run` — call the LLM but do not write files; print the response.
+- `--debug-prompt` — print the prompt that WOULD be sent (AI SDK messages JSON in API mode; plaintext stdin in agent mode) and exit; do NOT invoke the LLM. Useful for debugging and for manually pasting into an agent that isn't wired yet.
+- `--force` — overwrite even if `generation.json.manually_edited` is `true`.
+
+## `scaffold registry` — onboarding a Stencil component
+
+Reads a `maintainer` block from `ck/chiralkit.config.json`:
+
+```json
+{
+  "maintainer": {
+    "design_system_path": "packages/design-system/src/components",
+    "registry_path": "registry"
+  }
+}
+```
+
+Given `<designSystemPath>/ds-<name>/ds-<name>.tsx` + `ds-<name>.css` (plus any companion files), `scaffold registry <name>` writes:
+
+1. `<registryPath>/<name>/component.json` — envelope with parsed `tag` + flattened `tokens_used`. Human fields (`description`, `category`, `translations`) start as sensible placeholders (`description: "TODO: describe <name>"`, `category: "primitive"`, `translations: {}`) — edit them after.
+2. `<registryPath>/<name>/spec.json` — via `spec from-stencil`.
+3. `<registryPath>/<name>/implementations/stencil/*` — per-file reversed symlinks (git mode 120000) into the source dir. Files-only, hidden-file-skipping, sub-directory-skipping. `--force` first sweeps any pre-existing symlinks so orphans don't survive source-file renames.
+4. `<registryPath>/<name>/implementations/stencil/generation.json` — baseline `{manually_edited: true, ...nulls}`.
+
+Refuses if the target already exists; pass `--force` to overwrite. When `--force` regenerates over an existing `spec.json` that had hand-authored `slot`, `a11y`, or `state_machine` fields (which `runFromStencil` doesn't extract), scaffold prints a `[WARN]` naming the dropped fields — re-add them before running `chiralkit doctor`.
+
+## PM roadmap dashboard
+
+```bash
+ck pm           # deterministic local dashboard; no model required
+ck pm --brief   # same snapshot plus the read-only ck-pm interpretation
+```
+
+The dashboard reads `ROADMAP.md` and `BACKLOG.md` independently, then adds active Git worktrees as operational context. Git inspection failures degrade only the Git section.
+
+Backlog tasks use explicit metadata:
+
+```md
+- [ ] [fib:3] [priority:P1] [status:ready] Task text
+```
+
+- `fib`: `0 | 1 | 2 | 3 | 5 | 8 | 13`, expressing relative effort, difficulty, and time—not hours.
+- `priority`: `P0 | P1 | P2 | P3`, expressing attraction toward doing the task now.
+- `status`: `ready | active | blocked | done`.
+- `[x]` requires `status:done`; unchecked tasks cannot be `done`.
+
+Priority and Fibonacci are the planning pair `attraction ↔ resistance`; they remain separate and are never collapsed into one score. Missing or invalid metadata appears under `INVALID` and makes `ck pm` exit non-zero without hiding the rest of the dashboard. Tasks at `fib:8` or `fib:13` produce a decomposition warning, not an error.
+
+`ck pm --brief` sends only the deterministic `ProjectSnapshot` to the L5 `ck-pm` persona. The agent cannot edit files, mutate Git, or infer missing planning data.

package/dist/add.d.ts

@@ -0,0 +1,4 @@
+import { type ModuleType } from "@chiralkit/registry-schema";
+export declare function runAdd(moduleName: string, cwd?: string, opts?: {
+    type?: ModuleType;
+}): Promise<void>;

package/dist/add.js

@@ -0,0 +1,118 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { parseModule, } from "@chiralkit/registry-schema";
+import { resolveKitsRoot } from "@chiralkit/kits";
+import { readConfig } from "./config.js";
+import { createInstallContext, findInstaller } from "./installers/index.js";
+import { hashFile, legacyLockExists, legacyLockMigrationHint, lockExists, lockKey, readLock, toRelativePosix, writeLock, } from "./lock.js";
+import { MODULE_ENVELOPE_FILENAME, TYPE_TO_FAMILY, walkAllKitRegistries, } from "./registry-layout.js";
+// Resolves a module name to its envelope path by walking every kit's
+// registry/<family>/<name>/ layout, family- and kit-agnostically. `type`,
+// when given, narrows the search to a single family up front — useful once
+// a name collides across families (see the ambiguity error below).
+async function resolveModuleRef(kitsRoot, moduleName, type) {
+    const modules = await walkAllKitRegistries(kitsRoot);
+    const matches = modules.filter((m) => m.name === moduleName && (type === undefined || m.family === TYPE_TO_FAMILY[type]));
+    if (matches.length === 0) {
+        throw new Error(type
+            ? `Module '${moduleName}' (type '${type}') not found under ${kitsRoot}.`
+            : `Module '${moduleName}' not found under ${kitsRoot}.`);
+    }
+    if (matches.length > 1) {
+        const families = matches.map((m) => m.family).join(", ");
+        throw new Error(`Module '${moduleName}' exists in multiple families (${families}). Pass --type <t> to disambiguate.`);
+    }
+    return matches[0];
+}
+export async function runAdd(moduleName, cwd = process.cwd(), opts = {}) {
+    const config = await readConfig(cwd);
+    const registryRoot = resolve(cwd, config.registry_path);
+    const ref = await resolveModuleRef(resolveKitsRoot(), moduleName, opts.type);
+    let raw;
+    try {
+        raw = await readFile(ref.envelopePath, "utf8");
+    }
+    catch {
+        throw new Error(`Module '${moduleName}' not found at ${ref.envelopePath}.`);
+    }
+    const mod = parseModule(JSON.parse(raw));
+    if (mod.type !== "ui-component") {
+        throw new Error(`Only ui-component modules supported in v0. Got: ${mod.type}`);
+    }
+    const spec = mod.spec;
+    const installer = findInstaller(spec.tech, config.framework);
+    if (!installer.supports(mod)) {
+        throw new Error(`Installer for '${spec.tech}' × '${config.framework}' does not support module '${mod.name}'.`);
+    }
+    const ctx = createInstallContext(cwd, registryRoot, config);
+    await installer.install(mod, ctx);
+    await recordInstall(cwd, ref, mod, config.paths.components);
+    console.log(`Added: ${mod.name}@${mod.metadata.version} (${spec.tech} → ${config.framework})`);
+}
+// Appends (or replaces) the module's entry in chiralkit.lock.json. Runs
+// after the installer, so writing succeeds only when the copy did. When
+// the lock does not exist yet, it is created — 'add' is the natural
+// bootstrap point so first-time projects do not need to run 'lock --init'
+// before they have anything to lock.
+async function recordInstall(cwd, ref, mod, componentsRel) {
+    if (!(await lockExists(cwd)) && (await legacyLockExists(cwd))) {
+        throw new Error(legacyLockMigrationHint(cwd));
+    }
+    const lock = (await lockExists(cwd))
+        ? await readLock(cwd)
+        : { modules: {} };
+    const componentsAbs = resolve(cwd, componentsRel);
+    const registryBases = await collectRegistryFileBasenames(ref.moduleDir);
+    const files = {};
+    for (const base of registryBases) {
+        const abs = join(componentsAbs, base);
+        try {
+            const h = await hashFile(abs);
+            files[toRelativePosix(cwd, abs)] = h;
+        }
+        catch {
+            // File was in the registry but not written to the consumer; skip.
+            // This happens on stacks where component.assets covers only a
+            // subset of the registry source tree (e.g. Django ships from
+            // runtime.assets, not per-component).
+        }
+    }
+    lock.modules[lockKey(mod.name, mod.type)] = {
+        type: mod.type,
+        version: mod.metadata.version,
+        installed_at: new Date().toISOString(),
+        files,
+    };
+    await writeLock(cwd, lock);
+}
+async function collectRegistryFileBasenames(moduleDir) {
+    const out = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const p = join(dir, e.name);
+            if (e.isDirectory()) {
+                await walk(p);
+            }
+            else if (e.isFile() || e.isSymbolicLink()) {
+                try {
+                    const s = await stat(p);
+                    if (s.isFile())
+                        out.push(e.name);
+                }
+                catch {
+                    /* dangling symlink; skip */
+                }
+            }
+        }
+    }
+    await walk(moduleDir);
+    return out.filter((b) => b !== MODULE_ENVELOPE_FILENAME && b !== "spec.json");
+}
+//# sourceMappingURL=add.js.map

package/dist/add.js.map

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

package/dist/agents/subprocess.d.ts

@@ -0,0 +1,10 @@
+export interface AgentInvocation {
+    bin: string;
+    args: string[];
+    label: string;
+}
+export interface LocalAgentOptions {
+    timeoutMs?: number;
+    onStderr?: (chunk: string) => void;
+}
+export declare function runLocalAgent(invocation: AgentInvocation, prompt: string, options?: LocalAgentOptions): Promise<string>;

package/dist/agents/subprocess.js

@@ -0,0 +1,43 @@
+import { spawn } from "node:child_process";
+export function runLocalAgent(invocation, prompt, options = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(invocation.bin, invocation.args, { stdio: ["pipe", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill("SIGTERM");
+            reject(new Error(`${invocation.label} timed out after ${options.timeoutMs ?? 300_000}ms`));
+        }, options.timeoutMs ?? 300_000);
+        child.stdout.on("data", (chunk) => { stdout += chunk.toString("utf8"); });
+        child.stderr.on("data", (chunk) => {
+            const value = chunk.toString("utf8");
+            stderr = (stderr + value).slice(-8000);
+            options.onStderr?.(value);
+        });
+        child.on("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(new Error(error.code === "ENOENT" ? `${invocation.label}: binary '${invocation.bin}' not found` : `${invocation.label}: ${error.message}`));
+        });
+        child.on("close", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (code !== 0)
+                return reject(new Error(`${invocation.label} exited with code ${code}.\n--- last stderr ---\n${stderr}`));
+            if (!stdout.trim())
+                return reject(new Error(`${invocation.label} produced empty stdout.\n--- last stderr ---\n${stderr}`));
+            resolve(stdout);
+        });
+        child.stdin.on("error", () => { });
+        child.stdin.end(prompt);
+    });
+}
+//# sourceMappingURL=subprocess.js.map

package/dist/agents/subprocess.js.map

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

package/dist/automation/index.d.ts

@@ -0,0 +1,14 @@
+import { type RunRecord } from "./run.js";
+import { type AutomationRow } from "./status.js";
+export interface AutomationCommandDependencies {
+    stdout: (value: string) => void;
+    stderr: (value: string) => void;
+    cwd: () => string;
+    getStatus: (cwd: string) => Promise<AutomationRow[]>;
+    doRun: (name: string, cwd: string) => Promise<RunRecord>;
+    doInstall: (name: string, cwd: string) => Promise<void>;
+    doUninstall: (name: string, cwd: string) => Promise<void>;
+    readConfig: (name: string, cwd: string) => Promise<unknown>;
+    readTail: (name: string, cwd: string, count: number) => Promise<string[]>;
+}
+export declare function runAutomationCommand(argv: string[], overrides?: Partial<AutomationCommandDependencies>): Promise<number>;

package/dist/automation/index.js

@@ -0,0 +1,129 @@
+import { access, mkdir, readFile, readdir, rm, writeFile, appendFile } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { runAutomation } from "./run.js";
+import { installAutomation, uninstallAutomation } from "./install.js";
+import { getAutomationStatus } from "./status.js";
+import { parseAutomationConfig } from "./schema.js";
+const execFileAsync = promisify(execFile);
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const defaults = {
+    stdout: (v) => process.stdout.write(v),
+    stderr: (v) => process.stderr.write(v),
+    cwd: () => process.cwd(),
+    getStatus: (cwd) => getAutomationStatus(cwd, {
+        listDir: (path) => readdir(path),
+        readText: (path) => readFile(path, "utf8"),
+        fileExists,
+    }),
+    doRun: (name, cwd) => runAutomation(name, cwd, {
+        now: () => new Date(),
+        readText: (p) => readFile(p, "utf8"),
+        appendLine: async (p, l) => { await appendFile(p, l + "\n"); },
+        writeText: (p, c) => writeFile(p, c),
+        readLines: async (p) => { const t = await readFile(p, "utf8").catch(() => ""); return t.split(/\r?\n/).filter(Boolean); },
+    }),
+    doInstall: (name, cwd) => installAutomation(name, cwd, {
+        home: homedir(),
+        launchctl: async (args) => { await execFileAsync("launchctl", args); },
+        writeText: async (p, c) => { await mkdir(join(homedir(), "Library", "LaunchAgents"), { recursive: true }); await writeFile(p, c); },
+        removeFile: (p) => rm(p, { force: true }),
+        fileExists,
+        nodePath: process.execPath,
+        repoRoot: cwd,
+    }),
+    doUninstall: (name, cwd) => uninstallAutomation(name, cwd, {
+        home: homedir(),
+        launchctl: async (args) => { await execFileAsync("launchctl", args); },
+        writeText: () => Promise.resolve(),
+        removeFile: (p) => rm(p, { force: true }),
+        fileExists,
+        nodePath: process.execPath,
+        repoRoot: cwd,
+    }),
+    readConfig: async (name, cwd) => JSON.parse(await readFile(join(cwd, "automations", name, "automation.json"), "utf8")),
+    readTail: async (name, cwd, count) => {
+        const path = join(cwd, "automations", name, "runs.jsonl");
+        const text = await readFile(path, "utf8").catch(() => "");
+        const lines = text.split(/\r?\n/).filter(Boolean);
+        return lines.slice(-count);
+    },
+};
+export async function runAutomationCommand(argv, overrides = {}) {
+    const deps = { ...defaults, ...overrides };
+    const [sub, ...rest] = argv;
+    switch (sub) {
+        case "list": {
+            const rows = await deps.getStatus(deps.cwd());
+            if (rows.length === 0) {
+                deps.stdout("no automations declared.\n");
+                return 0;
+            }
+            deps.stdout("STATUS   NAME              TRIGGER          SUMMARY\n");
+            for (const row of rows) {
+                deps.stdout(`${row.status.padEnd(8)} ${row.name.padEnd(17)} ${row.triggerExpression.padEnd(16)} ${row.lastSummary ?? "-"}\n`);
+            }
+            return 0;
+        }
+        case "show": {
+            const name = rest[0];
+            if (!name) {
+                deps.stderr("automation show: missing name\n");
+                return 1;
+            }
+            const config = parseAutomationConfig(await deps.readConfig(name, deps.cwd()));
+            deps.stdout(JSON.stringify(config, null, 2) + "\n");
+            const tail = await deps.readTail(name, deps.cwd(), 3);
+            if (tail.length > 0) {
+                deps.stdout("\nLast runs:\n");
+                for (const line of tail)
+                    deps.stdout(line + "\n");
+            }
+            return 0;
+        }
+        case "run": {
+            const name = rest[0];
+            if (!name) {
+                deps.stderr("automation run: missing name\n");
+                return 1;
+            }
+            const record = await deps.doRun(name, deps.cwd());
+            deps.stdout(`${record.ts}  exit=${record.exit}  drift=${record.drift}  ${record.summary}\n`);
+            return record.exit === 0 ? 0 : 1;
+        }
+        case "install": {
+            const name = rest[0];
+            if (!name) {
+                deps.stderr("automation install: missing name\n");
+                return 1;
+            }
+            await deps.doInstall(name, deps.cwd());
+            deps.stdout(`installed dev.chiralkit.${name}\n`);
+            return 0;
+        }
+        case "uninstall": {
+            const name = rest[0];
+            if (!name) {
+                deps.stderr("automation uninstall: missing name\n");
+                return 1;
+            }
+            await deps.doUninstall(name, deps.cwd());
+            deps.stdout(`uninstalled dev.chiralkit.${name}\n`);
+            return 0;
+        }
+        default:
+            deps.stderr(`automation: unknown subcommand '${sub ?? ""}'. Use: list | show | run | install | uninstall\n`);
+            return 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/automation/index.js.map

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

package/dist/automation/install.d.ts

@@ -0,0 +1,19 @@
+import { type AutomationConfig } from "./schema.js";
+export interface InstallDependencies {
+    home: string;
+    launchctl: (args: string[]) => Promise<void>;
+    writeText: (path: string, content: string) => Promise<void>;
+    removeFile: (path: string) => Promise<void>;
+    fileExists: (path: string) => Promise<boolean>;
+    nodePath: string;
+    repoRoot: string;
+}
+export declare function plistPath(home: string, name: string): string;
+export declare function renderPlist(config: AutomationConfig, ctx: {
+    nodePath: string;
+    repoRoot: string;
+    logPath: string;
+    path: string;
+}): string;
+export declare function installAutomation(name: string, cwd: string, deps: InstallDependencies): Promise<void>;
+export declare function uninstallAutomation(name: string, cwd: string, deps: InstallDependencies): Promise<void>;

package/dist/automation/install.js

@@ -0,0 +1,116 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseAutomationConfig } from "./schema.js";
+export function plistPath(home, name) {
+    return join(home, "Library", "LaunchAgents", `dev.chiralkit.${name}.plist`);
+}
+function logPath(home, name) {
+    return join(home, "Library", "Logs", `chiralkit-${name}.log`);
+}
+function assertPlainInteger(field) {
+    if (field !== "*" && !/^\d+$/.test(field)) {
+        throw new Error(`cron field '${field}' is not a plain integer; step/list/range syntax not supported yet`);
+    }
+}
+function cronToStartCalendarInterval(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5)
+        throw new Error(`unsupported cron expression: ${expression}`);
+    const [minute, hour] = parts;
+    assertPlainInteger(minute);
+    assertPlainInteger(hour);
+    const entries = [];
+    if (minute !== "*")
+        entries.push(`<key>Minute</key><integer>${Number(minute)}</integer>`);
+    if (hour !== "*")
+        entries.push(`<key>Hour</key><integer>${Number(hour)}</integer>`);
+    if (entries.length === 0)
+        throw new Error(`cron expression '${expression}' has no fixed minute or hour — StartInterval instead is a follow-up`);
+    return `<dict>\n        ${entries.join("\n        ")}\n    </dict>`;
+}
+export function renderPlist(config, ctx) {
+    if (config.trigger.kind === "on-demand") {
+        throw new Error(`renderPlist: automation '${config.name}' has trigger.kind: "on-demand" — on-demand triggers are invocation-driven and have no cron expression to render into a launchd plist. Callers must guard before reaching renderPlist.`);
+    }
+    const args = [ctx.nodePath, join(ctx.repoRoot, "packages/cli/dist/index.js"), "automation", "run", config.name];
+    const programArgs = args.map((a) => `        <string>${a}</string>`).join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>dev.chiralkit.${config.name}</string>
+
+    <key>ProgramArguments</key>
+    <array>
+${programArgs}
+    </array>
+
+    <key>WorkingDirectory</key>
+    <string>${ctx.repoRoot}</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>${ctx.path}</string>
+    </dict>
+
+    <key>StartCalendarInterval</key>
+    ${cronToStartCalendarInterval(config.trigger.expression)}
+
+    <key>StandardOutPath</key>
+    <string>${ctx.logPath}</string>
+
+    <key>StandardErrorPath</key>
+    <string>${ctx.logPath}</string>
+
+    <key>RunAtLoad</key>
+    <false/>
+</dict>
+</plist>
+`;
+}
+export async function installAutomation(name, cwd, deps) {
+    const configRaw = JSON.parse(await readFile(join(cwd, "automations", name, "automation.json"), "utf8"));
+    const config = parseAutomationConfig(configRaw);
+    if (config.trigger.kind === "on-demand") {
+        // on-demand triggers are invocation-driven; there is nothing to register
+        // in launchd. No-op: do not write a plist, do not call launchctl.
+        return;
+    }
+    const path = plistPath(deps.home, name);
+    const xml = renderPlist(config, {
+        nodePath: deps.nodePath,
+        repoRoot: deps.repoRoot,
+        logPath: logPath(deps.home, name),
+        path: process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin",
+    });
+    if (await deps.fileExists(path)) {
+        await deps.launchctl(["unload", path]);
+    }
+    await deps.writeText(path, xml);
+    await deps.launchctl(["load", path]);
+}
+export async function uninstallAutomation(name, cwd, deps) {
+    // Best-effort: on-demand triggers never get installed to launchd, so there
+    // is nothing to unload. Read the config to short-circuit explicitly when
+    // possible; if automation.json is missing or malformed, fall through to
+    // the existing plist-presence-based uninstall — that path is already safe
+    // regardless of config state (idempotent no-op when the plist is absent).
+    try {
+        const configRaw = JSON.parse(await readFile(join(cwd, "automations", name, "automation.json"), "utf8"));
+        const config = parseAutomationConfig(configRaw);
+        if (config.trigger.kind === "on-demand") {
+            return;
+        }
+    }
+    catch {
+        // missing/malformed automation.json — fall through
+    }
+    const path = plistPath(deps.home, name);
+    if (await deps.fileExists(path)) {
+        await deps.launchctl(["unload", path]);
+        await deps.removeFile(path);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/automation/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/automation/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAyB,MAAM,aAAa,CAAC;AAY3E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY;IAClD,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,IAAI,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,IAAI,MAAM,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,KAAK,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,oEAAoE,CAAC,CAAC;IAC5G,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,UAAkB;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;IACtF,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAC7B,kBAAkB,CAAC,MAAO,CAAC,CAAC;IAC5B,kBAAkB,CAAC,IAAK,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1F,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,sEAAsE,CAAC,CAAC;IAChJ,OAAO,mBAAmB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,MAAwB,EACxB,GAA0E;IAE1E,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,CAAC,IAAI,wLAAwL,CAChO,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,4BAA4B,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAChH,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,OAAO;;;;;4BAKmB,MAAM,CAAC,IAAI;;;;EAIrC,WAAW;;;;cAIC,GAAG,CAAC,QAAQ;;;;;kBAKR,GAAG,CAAC,IAAI;;;;MAIpB,2BAA2B,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;;;cAG9C,GAAG,CAAC,OAAO;;;cAGX,GAAG,CAAC,OAAO;;;;;;CAMxB,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAW,EAAE,IAAyB;IAC1F,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACxG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACxC,yEAAyE;QACzE,kEAAkE;QAClE,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,8BAA8B;KACzD,CAAC,CAAC;IAEH,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,GAAW,EAAE,IAAyB;IAC5F,2EAA2E;IAC3E,yEAAyE;IACzE,wEAAwE;IACxE,0EAA0E;IAC1E,0EAA0E;IAC1E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACxG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/automation/parsers/audit-report.d.ts

@@ -0,0 +1,2 @@
+import type { Parser } from "./types.js";
+export declare const auditReportParser: Parser;