@chiralkit/cli 0.1.0-alpha.0

package/dist/scaffold-registry.js

@@ -0,0 +1,283 @@
+import { execFileSync } from "node:child_process";
+import { lstat, mkdir, readdir, readFile, stat, symlink, unlink, writeFile, } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+import { resolveKitsRoot } from "@chiralkit/kits";
+import { readMaintainerConfig } from "./config.js";
+import { runFromStencil } from "./spec-from-stencil.js";
+import { MODULE_ENVELOPE_FILENAME, TYPE_TO_FAMILY, TYPE_TO_KIT } from "./registry-layout.js";
+// Filenames scaffold itself manages at the implementations/stencil/ layer
+// (generation.json) or elsewhere in the registry entry (module.json,
+// spec.json — normally at registry/<family>/<name>/, but skipping
+// defensively). The walker will not symlink source files with these names,
+// so that step 4's writeFile through the symlink can't corrupt the source.
+const RESERVED_FILENAMES = new Set([
+    "generation.json",
+    MODULE_ENVELOPE_FILENAME,
+    "spec.json",
+]);
+export async function runScaffoldRegistry(name, opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const force = opts.force ?? false;
+    const type = opts.type ?? "ui-component";
+    const family = TYPE_TO_FAMILY[type];
+    const config = await readMaintainerConfig(cwd);
+    const kitsRoot = opts.kitsRoot ?? resolveKitsRoot();
+    const registryDir = join(kitsRoot, TYPE_TO_KIT[type], "registry", family, name);
+    // Non-ui-component types have no Stencil source to onboard from — there is
+    // no `ds-<name>.tsx` to parse into spec.json/tag/tokens_used. Until Task 5
+    // builds real agent/recipe/config scaffolders, `--type <t>` for those types
+    // writes a minimal placeholder envelope only (name/type/metadata scaffold,
+    // empty spec) at the correct family path, for a human to fill in by hand.
+    if (type !== "ui-component") {
+        await validateTarget(registryDir, family, name, force);
+        await mkdir(registryDir, { recursive: true });
+        const envelope = {
+            name,
+            type,
+            metadata: {
+                level: opts.level,
+                description: `TODO: describe ${name}`,
+                author: detectAuthor(cwd),
+                version: "0.1.0",
+                created_at: new Date().toISOString().slice(0, 10),
+                dependencies: [],
+                translations: {},
+            },
+            spec: {},
+        };
+        await writeFile(join(registryDir, MODULE_ENVELOPE_FILENAME), JSON.stringify(envelope, null, 2) + "\n", "utf8");
+        console.log(`Wrote placeholder envelope: ${join(registryDir, MODULE_ENVELOPE_FILENAME)}`);
+        console.log(`type '${type}' has no automated scaffolder yet — fill in metadata.description and spec by hand.`);
+        return;
+    }
+    const sourceDir = join(cwd, config.design_system_path, `ds-${name}`);
+    const stencilImplDir = join(registryDir, "implementations", "stencil");
+    await validateSource(sourceDir, name);
+    await validateTarget(registryDir, family, name, force);
+    // 1. spec.json (delegates to Plan 2's extractor via the wrapper below).
+    //    Before writing, capture any hand-authored fields on an existing
+    //    spec.json (slot, a11y, state_machine) so we can warn the user that
+    //    the pure-parser regeneration will drop them.
+    const wipedFields = await detectFieldsToBeWiped(join(registryDir, "spec.json"));
+    await writeSpecViaFromStencil(name, sourceDir, registryDir);
+    if (wipedFields.length > 0) {
+        console.warn(`[WARN] scaffold: existing spec.json had hand-authored field(s): ` +
+            `${wipedFields.join(", ")}. The pure-parser regeneration dropped them; ` +
+            `re-add them to registry/${family}/${name}/spec.json before the next 'chiralkit doctor' pass.`);
+    }
+    // 2. module.json envelope — build it from the just-written spec.json
+    //    (for tokens_used bucketed form) + parsed source (for the tag).
+    const spec = JSON.parse(await readFile(join(registryDir, "spec.json"), "utf8"));
+    const tag = extractTag(await readFile(join(sourceDir, `ds-${name}.tsx`), "utf8"), name);
+    const envelope = buildEnvelope({
+        name,
+        tag,
+        bucketedTokens: spec.tokens_used ?? {},
+        cwd,
+        level: opts.level,
+    });
+    await mkdir(registryDir, { recursive: true });
+    await writeFile(join(registryDir, MODULE_ENVELOPE_FILENAME), JSON.stringify(envelope, null, 2) + "\n", "utf8");
+    // 3. Symlinks: one per source file (files-only, no hidden, no subdirs).
+    await mkdir(stencilImplDir, { recursive: true });
+    // First: sweep any pre-existing symlinks in stencilImplDir so a --force
+    // regeneration doesn't leave orphans pointing at now-removed source
+    // files. Regular files (like generation.json) are left alone; only
+    // symlinks are swept.
+    await sweepSymlinks(stencilImplDir);
+    const sourceEntries = await readdir(sourceDir, { withFileTypes: true });
+    for (const entry of sourceEntries) {
+        if (entry.name.startsWith("."))
+            continue;
+        if (!entry.isFile())
+            continue;
+        // Skip CLI-managed filenames — if a user's source dir happens to
+        // contain one of these, symlinking through it would let step 4's
+        // writeFile clobber the source file.
+        if (RESERVED_FILENAMES.has(entry.name))
+            continue;
+        const linkPath = join(stencilImplDir, entry.name);
+        const targetAbs = join(sourceDir, entry.name);
+        const targetRel = relative(dirname(linkPath), targetAbs);
+        try {
+            await unlink(linkPath);
+        }
+        catch {
+            // Doesn't exist — that's fine.
+        }
+        await symlink(targetRel, linkPath);
+    }
+    // 4. generation.json baseline (regular file, not a symlink)
+    await writeFile(join(stencilImplDir, "generation.json"), JSON.stringify({
+        generated_from_spec_version: null,
+        generated_at: null,
+        generator_model: null,
+        manually_edited: true,
+    }, null, 2) + "\n", "utf8");
+}
+// Pure function — exposed for unit test. Flattens the bucketed tokens_used
+// form spec.json uses ({ colors: ["primary"], spacing: ["sm"] }) into the
+// flat "category.value" string list module.json uses.
+export function flattenTokensUsed(bucketed) {
+    const out = [];
+    for (const [bucket, values] of Object.entries(bucketed)) {
+        if (!values || values.length === 0)
+            continue;
+        const cat = singular(bucket);
+        for (const v of values) {
+            out.push(`${cat}.${v}`);
+        }
+    }
+    return out;
+}
+// Same 5-line function as generator/prompt.ts:singular(). Duplicated per
+// spec §Design decisions #5 — extracting a shared helper is not justified
+// by two callers at ~5 LOC each.
+function singular(bucket) {
+    switch (bucket) {
+        case "colors":
+            return "color";
+        default:
+            return bucket;
+    }
+}
+function buildEnvelope(input) {
+    return {
+        name: input.name,
+        type: "ui-component",
+        metadata: {
+            level: input.level,
+            description: `TODO: describe ${input.name}`,
+            author: detectAuthor(input.cwd),
+            version: "0.1.0",
+            created_at: new Date().toISOString().slice(0, 10),
+            dependencies: [],
+            translations: {},
+        },
+        spec: {
+            tech: "stencil",
+            tag: input.tag,
+            tokens_used: flattenTokensUsed(input.bucketedTokens),
+        },
+    };
+}
+function detectAuthor(cwd) {
+    try {
+        const out = execFileSync("git", ["config", "user.name"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        return out.length > 0 ? out : "TODO";
+    }
+    catch {
+        return "TODO";
+    }
+}
+// Parses `@Component({ tag: "ds-foo", ... })` from Stencil source and
+// returns the tag. Falls back to `ds-<name>` if the decorator can't be
+// parsed (shouldn't happen for a well-formed Stencil component, but the
+// fallback keeps scaffold usable during Stencil source edits).
+function extractTag(source, name) {
+    const m = /@Component\s*\(\s*\{[^}]*?\btag\s*:\s*["']([^"']+)["']/.exec(source);
+    return m ? m[1] : `ds-${name}`;
+}
+async function validateSource(sourceDir, name) {
+    try {
+        const s = await stat(sourceDir);
+        if (!s.isDirectory()) {
+            throw new Error(`source '${sourceDir}' exists but is not a directory.`);
+        }
+    }
+    catch (e) {
+        if (e.code === "ENOENT") {
+            throw new Error(`source '${sourceDir}' does not exist. Expected a Stencil component directory with ds-${name}.tsx and ds-${name}.css.`);
+        }
+        throw e;
+    }
+    const tsxPath = join(sourceDir, `ds-${name}.tsx`);
+    try {
+        await stat(tsxPath);
+    }
+    catch {
+        throw new Error(`${sourceDir} exists but has no ds-${name}.tsx (Stencil requires the tsx entry point named after the component).`);
+    }
+}
+async function validateTarget(registryDir, family, name, force) {
+    if (force)
+        return;
+    try {
+        await stat(registryDir);
+        // Exists — refuse.
+        throw new Error(`registry/${family}/${name}/ already exists at ${registryDir}; pass --force to regenerate (this will overwrite module.json and, for ui-component types, spec.json, generation.json, and all implementations/stencil/ symlinks).`);
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return;
+        throw e;
+    }
+}
+// Bridge to runFromStencil. Task 3 Step 3 extended runFromStencil to
+// accept optional sourceDir + registryDir; scaffold passes both so the
+// spec extractor operates against the scaffold's configured layout
+// rather than the workspace-resolved default. `force: true` is safe
+// because validateTarget above has already enforced the outer --force
+// gate — reaching this line means we're allowed to overwrite.
+async function writeSpecViaFromStencil(name, sourceDir, registryDir) {
+    await runFromStencil(name, { force: true, sourceDir, registryDir });
+}
+// Removes every symlink under `dir` (leaves regular files untouched). Used
+// before recreating symlinks on --force regeneration so that source files
+// removed since the last scaffold do not leave orphaned symlinks behind.
+async function sweepSymlinks(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return; // Dir doesn't exist yet — nothing to sweep.
+    }
+    for (const name of entries) {
+        const full = join(dir, name);
+        let s;
+        try {
+            s = await lstat(full);
+        }
+        catch {
+            continue;
+        }
+        if (s.isSymbolicLink()) {
+            await unlink(full);
+        }
+    }
+}
+// Detects which human-authored fields exist on an already-present spec.json
+// and would be wiped by the pure-parser regeneration. Returns [] if no
+// spec.json exists (fresh scaffold — nothing to wipe).
+async function detectFieldsToBeWiped(specPath) {
+    let raw;
+    try {
+        raw = await readFile(specPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return [];
+    }
+    const obj = parsed;
+    const wiped = [];
+    for (const field of ["slot", "a11y", "state_machine"]) {
+        if (obj[field] !== undefined)
+            wiped.push(field);
+    }
+    return wiped;
+}
+//# sourceMappingURL=scaffold-registry.js.map

package/dist/scaffold-registry.js.map

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

package/dist/scaffold.d.ts

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

package/dist/scaffold.js

@@ -0,0 +1,32 @@
+import { runScaffoldRegistry } from "./scaffold-registry.js";
+import { parseLevelFlag, parseTypeFlag } from "./registry-layout.js";
+// Subcommand dispatcher for `chiralkit scaffold ...`. Currently one action;
+// grows as future types (recipe, agent, config) gain their own scaffolders.
+export async function runScaffold(rest) {
+    const [action, ...args] = rest;
+    switch (action) {
+        case "registry": {
+            const name = args[0];
+            if (!name) {
+                throw new Error("scaffold registry: missing module name. Usage: chiralkit scaffold registry <name> --level <n> [--type <t>] [--force]");
+            }
+            const force = args.includes("--force");
+            const type = parseTypeFlag(args, (msg) => {
+                throw new Error(`scaffold registry: ${msg}`);
+            });
+            const level = parseLevelFlag(args, (msg) => {
+                throw new Error(`scaffold registry: ${msg}`);
+            });
+            if (level === undefined) {
+                throw new Error("scaffold registry: --level <n> is required, where n ∈ 0,1,2,3,5,8");
+            }
+            await runScaffoldRegistry(name, { force, type, level });
+            return;
+        }
+        case undefined:
+            throw new Error("scaffold: missing action. Actions: registry <name> --level <n> [--type <t>] [--force]");
+        default:
+            throw new Error(`scaffold: unknown action '${action}'`);
+    }
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErE,4EAA4E;AAC5E,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CACb,sHAAsH,CACvH,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvC,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;YACH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;YACJ,CAAC;YACD,MAAM,mBAAmB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QACD,KAAK,SAAS;YACZ,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,GAAG,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/spec-from-react.d.ts

@@ -0,0 +1,11 @@
+export interface FromReactOptions {
+    name?: string;
+    exportName?: string;
+    tokensMapPath: string;
+    version?: string;
+    outPath?: string;
+    force: boolean;
+    strict: boolean;
+    dryRun: boolean;
+}
+export declare function runFromReact(sourcePath: string, options: FromReactOptions): Promise<void>;