@chiralkit/cli 0.1.0-alpha.0

package/dist/doctor.js

@@ -0,0 +1,281 @@
+import { readdir, readFile, realpath } from "node:fs/promises";
+import { join, relative, resolve, sep } from "node:path";
+import { z } from "zod";
+import { parseComponentContract, parseAgentCapabilities, parseAgentSpec, parseModule, } from "@chiralkit/registry-schema";
+import { resolveKitsRoot } from "@chiralkit/kits";
+import { MODULE_ENVELOPE_FILENAME, walkAllKitRegistries, } from "./registry-layout.js";
+import { runInvariants } from "./doctor-invariants.js";
+function ok(r, msg) {
+    r.oks.push(msg);
+}
+function warn(r, msg) {
+    r.warnings.push(msg);
+}
+function err(r, msg) {
+    r.errors.push(msg);
+}
+const uiLayoutContractSchema = z.object({
+    version: z.string().min(1),
+    implementation: z.object({
+        files: z.array(z.string().min(1)).min(1),
+    }).passthrough(),
+}).passthrough();
+async function validateUiLayoutFiles(repoRoot, files) {
+    const problems = [];
+    const resolvedRepoRoot = resolve(repoRoot);
+    for (const declared of files) {
+        const target = resolve(resolvedRepoRoot, declared);
+        const relativeTarget = relative(resolvedRepoRoot, target);
+        if (relativeTarget === "" || relativeTarget === ".." || relativeTarget.startsWith(`..${sep}`)) {
+            problems.push(`${declared} escapes repository boundary`);
+            continue;
+        }
+        try {
+            const [realRepoRoot, realTarget] = await Promise.all([
+                realpath(resolvedRepoRoot),
+                realpath(target),
+            ]);
+            const realRelativeTarget = relative(realRepoRoot, realTarget);
+            if (realRelativeTarget === "" ||
+                realRelativeTarget === ".." ||
+                realRelativeTarget.startsWith(`..${sep}`)) {
+                problems.push(`${declared} escapes repository boundary`);
+                continue;
+            }
+            await readFile(realTarget, "utf8");
+        }
+        catch {
+            problems.push(`${declared} is not readable`);
+        }
+    }
+    return problems;
+}
+async function checkEnvelope(label, moduleDir, r) {
+    const path = join(moduleDir, MODULE_ENVELOPE_FILENAME);
+    try {
+        const raw = await readFile(path, "utf8");
+        const parsed = parseModule(JSON.parse(raw));
+        ok(r, `envelope: ${label} — level=${parsed.metadata.level}, type=${parsed.type}`);
+        return parsed;
+    }
+    catch (e) {
+        err(r, `envelope: ${label} — ${e.message}`);
+        return null;
+    }
+}
+async function checkSpec(label, moduleDir, envelope, repoRoot, r) {
+    if (envelope?.type === "agent") {
+        let spec;
+        try {
+            spec = parseAgentSpec(envelope.spec);
+        }
+        catch (e) {
+            err(r, `agent: ${label} — ${e.message}`);
+            return null;
+        }
+        const result = await validateAgentFiles(moduleDir, spec);
+        for (const problem of result.problems)
+            err(r, `agent: ${label} — ${problem}`);
+        for (const warning of result.warnings)
+            warn(r, `agent: ${label} — ${warning}`);
+        if (result.problems.length === 0)
+            ok(r, `agent: ${label} — contract and declared agent files readable`);
+        return null;
+    }
+    const path = join(moduleDir, "spec.json");
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        warn(r, `spec.json: ${label} — file not found (module has no contract yet)`);
+        return null;
+    }
+    if (envelope?.type === "ui-layout") {
+        let contract;
+        try {
+            contract = uiLayoutContractSchema.parse(JSON.parse(raw));
+        }
+        catch (e) {
+            err(r, `ui-layout: ${label} — ${e.message}`);
+            return null;
+        }
+        const problems = await validateUiLayoutFiles(repoRoot, contract.implementation.files);
+        for (const problem of problems)
+            err(r, `ui-layout: ${label} — ${problem}`);
+        if (problems.length === 0) {
+            ok(r, `ui-layout: ${label} — contract and implementation files readable`);
+        }
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = parseComponentContract(JSON.parse(raw));
+    }
+    catch (e) {
+        err(r, `spec.json: ${label} — ${e.message}`);
+        return null;
+    }
+    ok(r, `spec.json: ${label} v${parsed.version}`);
+    // Level conformance: only meaningful for ui-component today. L1 (primitive)
+    // shouldn't declare a state_machine; L2 (pattern) should. Other levels
+    // have no conformance rule at this layer.
+    if (envelope?.type === "ui-component") {
+        const hasStateMachine = parsed.state_machine !== undefined;
+        if (envelope.metadata.level === 1 && hasStateMachine) {
+            warn(r, `level conformance: ${label} — L1 (primitive) with state_machine (usually a pattern in disguise; check?)`);
+        }
+        if (envelope.metadata.level === 2 && !hasStateMachine) {
+            warn(r, `level conformance: ${label} — L2 (pattern) without state_machine (usually pattern behavior deserves explicit modeling)`);
+        }
+    }
+    return parsed;
+}
+async function readDeclaredAgentFile(moduleDir, declared) {
+    if (!declared)
+        return { problem: "agent file path is missing" };
+    const target = resolve(moduleDir, declared);
+    const rel = relative(resolve(moduleDir), target);
+    if (rel.startsWith("..") || rel === "") {
+        return { problem: `${declared} escapes module directory` };
+    }
+    try {
+        const [realModuleDir, realTarget] = await Promise.all([
+            realpath(moduleDir),
+            realpath(target),
+        ]);
+        const realRel = relative(realModuleDir, realTarget);
+        if (realRel.startsWith("..") || realRel === "") {
+            return { problem: `${declared} escapes module directory` };
+        }
+        return { content: await readFile(realTarget, "utf8") };
+    }
+    catch {
+        return { problem: `${declared} is not readable` };
+    }
+}
+export async function validateAgentFiles(moduleDir, spec) {
+    const problems = [];
+    const warnings = [];
+    if ("runtime_targets" in spec) {
+        const declaredPaths = [
+            spec.contract,
+            ...spec.runtime_targets.map((runtime) => spec.implementations[runtime]?.entry ?? ""),
+        ];
+        for (const declared of declaredPaths) {
+            const file = await readDeclaredAgentFile(moduleDir, declared);
+            if (file.problem)
+                problems.push(file.problem);
+        }
+        warnings.push("legacy runtime-target agent locator is deprecated; migrate to entry + capabilities");
+        return { problems, warnings };
+    }
+    for (const declared of [
+        spec.entry,
+        spec.contract,
+        ...Object.values(spec.adapters ?? {}).map((adapter) => adapter.entry),
+    ]) {
+        const file = await readDeclaredAgentFile(moduleDir, declared);
+        if (file.problem)
+            problems.push(file.problem);
+    }
+    const capabilitiesFile = await readDeclaredAgentFile(moduleDir, spec.capabilities);
+    if (capabilitiesFile.problem) {
+        problems.push(capabilitiesFile.problem);
+    }
+    else {
+        try {
+            parseAgentCapabilities(JSON.parse(capabilitiesFile.content ?? ""));
+        }
+        catch (e) {
+            problems.push(`${spec.capabilities} is invalid: ${e.message}`);
+        }
+    }
+    return { problems, warnings };
+}
+async function checkImplementations(label, moduleDir, spec, r) {
+    const implRoot = join(moduleDir, "implementations");
+    let stacks;
+    try {
+        stacks = (await readdir(implRoot, { withFileTypes: true }))
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        warn(r, `implementations: ${label} — no implementations/ directory`);
+        return;
+    }
+    if (stacks.length === 0) {
+        warn(r, `implementations: ${label} — implementations/ directory is empty`);
+        return;
+    }
+    for (const stack of stacks) {
+        const genPath = join(implRoot, stack, "generation.json");
+        let gen;
+        try {
+            gen = JSON.parse(await readFile(genPath, "utf8"));
+        }
+        catch {
+            warn(r, `implementations: ${label}/${stack} — no generation.json (implementation not tracked)`);
+            continue;
+        }
+        if (spec &&
+            gen.generated_from_spec_version !== null &&
+            gen.generated_from_spec_version !== spec.version) {
+            warn(r, `version drift: ${label}/${stack} — generated from spec v${gen.generated_from_spec_version}, current spec is v${spec.version}${gen.manually_edited ? " (manually_edited: true, will not regenerate without --force)" : ""}`);
+        }
+        else {
+            ok(r, `implementation: ${label}/${stack}${gen.manually_edited ? " (hand-authored)" : ` (from spec v${gen.generated_from_spec_version})`}`);
+        }
+    }
+}
+function printReport(r) {
+    for (const line of r.oks)
+        console.log(`[OK]   ${line}`);
+    for (const line of r.warnings)
+        console.log(`[WARN] ${line}`);
+    for (const line of r.errors)
+        console.error(`[ERR]  ${line}`);
+    console.log("");
+    console.log(`${r.errors.length} error(s), ${r.warnings.length} warning(s), ${r.oks.length} ok`);
+}
+// Builds the doctor report for a given registry root, with no printing or
+// process exit — the I/O layer that both `runDoctor` (CLI entry) and tests
+// (staging a tmp registry) drive. Walks each module, checks its envelope +
+// spec (plus declared implementation files for ui-layout, and implementation
+// metadata for ui-component), then runs the pure
+// cross-module chirality invariants over the collected envelopes.
+export async function collectDoctorReport(root) {
+    const r = { errors: [], warnings: [], oks: [] };
+    const modules = await walkAllKitRegistries(root);
+    if (modules.length === 0) {
+        warn(r, `registry: no modules found at ${root}`);
+        return r;
+    }
+    ok(r, `registry: ${modules.length} module(s) found at ${root}`);
+    const repoRoot = resolve(root, "..");
+    const envelopes = [];
+    for (const m of modules) {
+        const label = `${m.family}/${m.name}`;
+        const envelope = await checkEnvelope(label, m.moduleDir, r);
+        const spec = await checkSpec(label, m.moduleDir, envelope, repoRoot, r);
+        if (envelope?.type === "ui-component") {
+            await checkImplementations(label, m.moduleDir, spec, r);
+        }
+        if (envelope)
+            envelopes.push(envelope);
+    }
+    const invariants = runInvariants(envelopes);
+    for (const line of invariants.oks)
+        ok(r, line);
+    for (const line of invariants.errors)
+        err(r, line);
+    return r;
+}
+export async function runDoctor() {
+    const r = await collectDoctorReport(resolveKitsRoot());
+    printReport(r);
+    process.exit(r.errors.length > 0 ? 1 : 0);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/generate.d.ts

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

package/dist/generate.js

@@ -0,0 +1,275 @@
+import { readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseComponentContract, } from "@chiralkit/registry-schema";
+import { resolveKitsRoot } from "@chiralkit/kits";
+import { isAgentConfig, loadGeneratorConfig, resolveModel, } from "./generator/config.js";
+import { composeRequest } from "./generator/prompt.js";
+import { runApi, serializeForApi } from "./generator/api.js";
+import { runAgent, serializeForAgent } from "./generator/agent.js";
+import { parseResponse } from "./generator/parse-response.js";
+import { TYPE_TO_FAMILY, parseTypeFlag, walkAllKitRegistries } from "./registry-layout.js";
+const kitsRoot = resolveKitsRoot();
+// Resolves a module name to its registry/<family>/<name>/ directory across
+// every kit registry, family- and kit-agnostically — same lookup shape as
+// add.ts's resolveModuleRef. `type` narrows the search up front once a name
+// collides across families.
+async function resolveComponentDir(component, type) {
+    const modules = await walkAllKitRegistries(kitsRoot);
+    const matches = modules.filter((m) => m.name === component && (type === undefined || m.family === TYPE_TO_FAMILY[type]));
+    if (matches.length === 0) {
+        throw new Error(`generate: no such module '${component}' under ${kitsRoot}.`);
+    }
+    if (matches.length > 1) {
+        const families = matches.map((m) => m.family).join(", ");
+        throw new Error(`generate: '${component}' exists in multiple families (${families}). Pass --type <t> to disambiguate.`);
+    }
+    return matches[0].moduleDir;
+}
+export async function runGenerate(argv) {
+    const opts = parseArgs(argv);
+    const componentDir = await resolveComponentDir(opts.component, opts.type);
+    const spec = await loadSpec(componentDir, opts.component);
+    const implRoot = join(componentDir, "implementations");
+    const stacks = await resolveStacks(implRoot, opts.stack);
+    if (stacks.length === 0) {
+        console.error(`generate: no implementations to generate for '${opts.component}'.` +
+            ` Pass --stack <name> to create a new stack.`);
+        process.exit(1);
+    }
+    const config = await loadGeneratorConfig();
+    const modelId = isAgentConfig(config)
+        ? config.generator.agent
+        : config.generator.model;
+    let hardFailures = 0;
+    for (const stack of stacks) {
+        try {
+            await generateForStack({
+                component: opts.component,
+                componentDir,
+                spec,
+                stack,
+                config,
+                modelId,
+                dryRun: opts.dryRun,
+                debugPrompt: opts.debugPrompt,
+                force: opts.force,
+            });
+        }
+        catch (e) {
+            hardFailures++;
+            console.error(`[FAIL] ${opts.component}/${stack}: ${e.message}`);
+        }
+    }
+    process.exit(hardFailures > 0 ? 1 : 0);
+}
+function parseArgs(argv) {
+    const positional = [];
+    const opts = {
+        dryRun: false,
+        debugPrompt: false,
+        force: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--dry-run")
+            opts.dryRun = true;
+        else if (a === "--debug-prompt")
+            opts.debugPrompt = true;
+        else if (a === "--force")
+            opts.force = true;
+        else if (a === "--stack") {
+            const next = argv[++i];
+            if (!next) {
+                console.error("generate: --stack requires a value");
+                process.exit(1);
+            }
+            opts.stack = next;
+        }
+        else if (a === "--type") {
+            i++; // consume the value here; parseTypeFlag below re-scans argv for validation.
+        }
+        else if (a.startsWith("--")) {
+            console.error(`generate: unknown flag '${a}'`);
+            process.exit(1);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    const component = positional[0];
+    if (!component) {
+        console.error("generate: missing component name");
+        console.error("Usage: chiralkit generate <component> [--stack <name>] [--type <t>] [--dry-run] [--debug-prompt] [--force]");
+        process.exit(1);
+    }
+    const type = parseTypeFlag(argv, (msg) => {
+        console.error(`generate: ${msg}`);
+        process.exit(1);
+    });
+    return {
+        component,
+        stack: opts.stack,
+        type,
+        dryRun: opts.dryRun ?? false,
+        debugPrompt: opts.debugPrompt ?? false,
+        force: opts.force ?? false,
+    };
+}
+async function loadSpec(componentDir, name) {
+    const path = join(componentDir, "spec.json");
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        throw new Error(`generate: no spec.json for '${name}' at ${path}. Run 'chiralkit spec from-stencil ${name}' or author one by hand.`);
+    }
+    try {
+        return parseComponentContract(JSON.parse(raw));
+    }
+    catch (e) {
+        throw new Error(`generate: spec.json for '${name}' failed validation: ${e.message}`);
+    }
+}
+async function resolveStacks(implRoot, explicit) {
+    if (explicit)
+        return [explicit];
+    try {
+        const entries = await readdir(implRoot, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+// Two-level walk across every registry/<family>/<name>/ module (siblings
+// across families are fair game as few-shots, not just siblings within the
+// same family — a design-system component and a hand-authored recipe
+// implementation for the same stack are equally useful examples).
+async function pickFewShots(component, stack) {
+    const modules = await walkAllKitRegistries(kitsRoot);
+    const candidates = [];
+    for (const m of modules) {
+        if (m.name === component)
+            continue;
+        const stackDir = join(m.moduleDir, "implementations", stack);
+        try {
+            const files = await readdir(stackDir);
+            const pick = files.find((f) => f !== "generation.json" && !f.endsWith(".md"));
+            if (pick)
+                candidates.push(join(stackDir, pick));
+        }
+        catch {
+            // no implementations/<stack>/ for this sibling — skip
+        }
+        if (candidates.length >= 2)
+            break;
+    }
+    return candidates;
+}
+async function generateForStack(input) {
+    const stackDir = join(input.componentDir, "implementations", input.stack);
+    const genPath = join(stackDir, "generation.json");
+    const existingGen = await readGeneration(genPath);
+    if (existingGen &&
+        existingGen.manually_edited &&
+        !input.force &&
+        !input.debugPrompt) {
+        console.warn(`[SKIP] ${input.component}/${input.stack}: manually_edited=true (pass --force to overwrite)`);
+        return;
+    }
+    const fewShotPaths = await pickFewShots(input.component, input.stack);
+    const request = await composeRequest({
+        spec: input.spec,
+        stack: input.stack,
+        targetComponent: input.component,
+        fewShotPaths,
+    });
+    if (input.debugPrompt) {
+        dumpDebugPrompt(input.config, request, input.component, input.stack);
+        return;
+    }
+    console.log(`[GEN]  ${input.component}/${input.stack}: dispatching to ${input.modelId}...`);
+    const text = await callProvider(input.config, request);
+    if (input.dryRun) {
+        console.log(`--- response (${input.component}/${input.stack}) ---`);
+        console.log(text);
+        console.log(`--- end response ---`);
+        console.log(`[DRY]  ${input.component}/${input.stack}: no files written`);
+        return;
+    }
+    const files = parseResponse(text);
+    await ensureDir(stackDir);
+    for (const file of files) {
+        await writeParsedFile(stackDir, file, input.stack);
+    }
+    const gen = {
+        generated_from_spec_version: input.spec.version,
+        generated_at: new Date().toISOString(),
+        generator_model: input.modelId,
+        manually_edited: false,
+    };
+    await writeFile(genPath, JSON.stringify(gen, null, 2) + "\n", "utf8");
+    console.log(`[OK]   ${input.component}/${input.stack}: wrote ${files.length} file(s) + generation.json`);
+}
+async function callProvider(config, request) {
+    if (isAgentConfig(config)) {
+        return runAgent(config.generator.agent, request);
+    }
+    const model = await resolveModel(config);
+    return runApi(model, request);
+}
+function dumpDebugPrompt(config, request, component, stack) {
+    console.log(`--- debug-prompt (${component}/${stack}) ---`);
+    if (isAgentConfig(config)) {
+        console.log(`mode: agent (${config.generator.agent})`);
+        console.log(`--- stdin that would be piped to the subprocess ---`);
+        console.log(serializeForAgent(request));
+    }
+    else {
+        console.log(`mode: api (${config.generator.model})`);
+        console.log(`--- messages that would be sent to generateText ---`);
+        console.log(JSON.stringify(serializeForApi(request), null, 2));
+    }
+    console.log(`--- end debug-prompt ---`);
+}
+async function readGeneration(path) {
+    try {
+        const raw = await readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function ensureDir(path) {
+    try {
+        await stat(path);
+    }
+    catch {
+        const { mkdir } = await import("node:fs/promises");
+        await mkdir(path, { recursive: true });
+    }
+}
+async function writeParsedFile(stackDir, file, stack) {
+    const full = join(stackDir, file.path);
+    if (stack === "stencil") {
+        try {
+            await stat(full);
+        }
+        catch {
+            console.warn(`[WARN] stencil: '${file.path}' did not exist before generation. ` +
+                `A real file is being created at ${full}, but Stencil's srcDir is ` +
+                `packages/design-system/src/components/. Move it there and add a ` +
+                `symlink under implementations/stencil/ to make Stencil compile it.`);
+        }
+    }
+    const normalized = file.content.endsWith("\n")
+        ? file.content
+        : file.content + "\n";
+    await writeFile(full, normalized, "utf8");
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/generator/agent.d.ts

@@ -0,0 +1,8 @@
+import type { GenerationRequest } from "./request.js";
+export type AgentName = "claude-code";
+export interface RunAgentOptions {
+    timeoutMs?: number;
+    onStderr?: (chunk: string) => void;
+}
+export declare function serializeForAgent(req: GenerationRequest): string;
+export declare function runAgent(agent: AgentName, req: GenerationRequest, opts?: RunAgentOptions): Promise<string>;

package/dist/generator/agent.js

@@ -0,0 +1,66 @@
+import { runLocalAgent } from "../agents/subprocess.js";
+import { renderFewShotsBlock } from "./request.js";
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
+export function serializeForAgent(req) {
+    return [
+        "--- PREAMBLE ---",
+        req.preamble,
+        "",
+        "--- SPEC ---",
+        req.spec,
+        "",
+        "--- REQUIREMENTS ---",
+        req.derivedRequirements,
+        "",
+        "--- EXAMPLES ---",
+        renderFewShotsBlock(req.fewShots),
+        "",
+        "--- OUTPUT FORMAT ---",
+        req.outputFormat,
+        "",
+        `Generate the ${req.targetStack} implementation of ${req.targetComponent}.`,
+    ].join("\n");
+}
+// Dispatch table for supported agents. Adding another agent = one entry.
+function resolveAgent(agent) {
+    // Environment overrides exist for tests + power users; production callers
+    // pass the plain agent name and get the canonical invocation.
+    const envBin = process.env["CHIRALKIT_CLAUDE_BIN"];
+    const envArgsRaw = process.env["CHIRALKIT_CLAUDE_ARGS"];
+    if (envBin) {
+        const args = envArgsRaw ? JSON.parse(envArgsRaw) : [];
+        return { bin: envBin, args };
+    }
+    switch (agent) {
+        case "claude-code":
+            // `claude -p` runs headless print mode, reading the prompt from stdin.
+            return { bin: "claude", args: ["-p"] };
+        default: {
+            const _exhaustive = agent;
+            throw new Error(`generator: unknown agent '${_exhaustive}'`);
+        }
+    }
+}
+export async function runAgent(agent, req, opts = {}) {
+    const { bin, args } = resolveAgent(agent);
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const onStderr = opts.onStderr ??
+        ((chunk) => process.stderr.write(prefixStderr(chunk)));
+    try {
+        return await runLocalAgent({ bin, args, label: `generator: agent '${agent}'` }, serializeForAgent(req), { timeoutMs, onStderr });
+    }
+    catch (error) {
+        const message = error.message;
+        if (message.includes("not found")) {
+            throw new Error(`generator: agent '${agent}' is not installed (binary '${bin}' not found on PATH).\nInstall Claude Code: https://docs.claude.com/claude-code/quickstart\nOr switch to API mode by setting generator.model in registry/generator.config.json.`);
+        }
+        throw error;
+    }
+}
+function prefixStderr(chunk) {
+    return chunk
+        .split(/(\r?\n)/)
+        .map((part) => (/\r?\n/.test(part) || part === "" ? part : `[agent] ${part}`))
+        .join("");
+}
+//# sourceMappingURL=agent.js.map