@cogitato/kit-cli 0.0.0-stage → 0.1.0

package/dist/flows.d.ts

@@ -0,0 +1,38 @@
+import { type FlowManifest } from "@cogitato/contract";
+import type { Issue } from "./issue.js";
+import { type Project } from "./project.js";
+import type { Registry } from "./registry.js";
+/**
+ * Builds flows.json content from the registry. Screens are ordered by their first appearance
+ * in a flow (so the canvas reads left to right), then by id.
+ */
+export declare function buildManifest(reg: Registry, commit?: string): {
+    manifest: FlowManifest;
+    issues: Issue[];
+};
+export declare function currentCommit(project: Project): string | undefined;
+export declare const serializeManifest: (m: FlowManifest) => string;
+/**
+ * Compares manifests ignoring `commit`, which changes on every commit, and review `status`, which
+ * is set on the canvas rather than derived from code. Pass `status: true` to compare it too.
+ */
+export declare function sameManifest(a: FlowManifest, b: FlowManifest, opts?: {
+    status?: boolean;
+}): boolean;
+/** Review statuses from the current flows.json, for the states that still exist. */
+export declare function keptStatus(project: Project, manifest: FlowManifest): FlowManifest["status"] | undefined;
+export declare function readFlowsJson(project: Project): FlowManifest | undefined;
+/** Checks that design/flows.json matches the code. A warning: the next export fixes it. */
+export declare function staleIssue(project: Project, manifest: FlowManifest): Issue | undefined;
+export interface ExportResult {
+    manifest: FlowManifest;
+    issues: Issue[];
+    /** True when the file on disk differs from the export (ignoring commit). */
+    changed: boolean;
+    written: boolean;
+}
+/** Writes design/flows.json, unless there are problems or `check` is set. */
+export declare function writeManifest(project: Project, built: {
+    manifest: FlowManifest;
+    issues: Issue[];
+}, check: boolean): ExportResult;

package/dist/flows.js

@@ -0,0 +1,141 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { SCHEMA_VERSIONS, validateFlows } from "@cogitato/contract";
+import { LAYOUT } from "./project.js";
+const FLOWS_SCHEMA = "../node_modules/@cogitato/contract/schema/flows.schema.json";
+function unknownStep(reg, flow, ref, at) {
+    const dot = ref.lastIndexOf(".");
+    const screenId = ref.slice(0, dot);
+    const state = ref.slice(dot + 1);
+    const screen = reg.screens.find((s) => s.id === screenId);
+    const reason = dot < 0
+        ? `steps are written as "{screen id}.{state}", like "checkout.payment.default"`
+        : screen
+            ? `the ${screen.title} screen has no state called "${state}" (it has: ${screen.fixtures.map((f) => `"${f.key}"`).join(", ")})`
+            : `there's no screen with the id "${screenId}"`;
+    return {
+        code: "code-unknown-flow-step",
+        severity: "error",
+        file: at.file,
+        path: "",
+        line: at.line,
+        column: at.column,
+        message: `The "${flow.title}" flow mentions "${ref}", but ${reason}.`,
+    };
+}
+/**
+ * Builds flows.json content from the registry. Screens are ordered by their first appearance
+ * in a flow (so the canvas reads left to right), then by id.
+ */
+export function buildManifest(reg, commit) {
+    const issues = [];
+    const known = new Set(reg.screens.flatMap((s) => s.fixtures.map((f) => `${s.id}.${f.key}`)));
+    const flows = reg.flows.map((flow) => {
+        for (const e of flow.edges) {
+            if (!known.has(e.from))
+                issues.push(unknownStep(reg, flow, e.from, e));
+            if (!known.has(e.to))
+                issues.push(unknownStep(reg, flow, e.to, e));
+        }
+        for (const n of flow.nodes ?? [])
+            if (!known.has(n.ref))
+                issues.push(unknownStep(reg, flow, n.ref, n.at));
+        const nodes = flow.nodes ? flow.nodes.map((n) => n.ref) : [...new Set(flow.edges.flatMap((e) => [e.from, e.to]))];
+        return {
+            id: flow.id,
+            title: flow.title,
+            nodes,
+            edges: flow.edges.map(({ from, to, label }) => (label !== undefined ? { from, to, label } : { from, to })),
+        };
+    });
+    const order = new Map();
+    for (const f of flows)
+        for (const node of f.nodes) {
+            const screenId = node.slice(0, node.lastIndexOf("."));
+            if (!order.has(screenId))
+                order.set(screenId, order.size);
+        }
+    const rank = (id) => order.get(id) ?? Number.MAX_SAFE_INTEGER;
+    const screens = [...reg.screens]
+        .sort((a, b) => rank(a.id) - rank(b.id) || a.id.localeCompare(b.id))
+        .map((s) => ({
+        id: s.id,
+        route: s.route,
+        title: s.title,
+        states: s.fixtures.map((f) => ({ id: f.key, fixture: f.key, title: f.title })),
+    }));
+    const manifest = {
+        $schema: FLOWS_SCHEMA,
+        schemaVersion: SCHEMA_VERSIONS.flows,
+        ...(commit ? { commit } : {}),
+        screens,
+        flows,
+    };
+    return { manifest, issues };
+}
+export function currentCommit(project) {
+    const r = spawnSync("git", ["rev-parse", "--short", "HEAD"], { cwd: project.root, encoding: "utf8" });
+    const sha = r.status === 0 ? r.stdout.trim() : "";
+    return /^[0-9a-f]{7,40}$/.test(sha) ? sha : undefined;
+}
+export const serializeManifest = (m) => JSON.stringify(m, null, 2) + "\n";
+/**
+ * Compares manifests ignoring `commit`, which changes on every commit, and review `status`, which
+ * is set on the canvas rather than derived from code. Pass `status: true` to compare it too.
+ */
+export function sameManifest(a, b, opts = {}) {
+    const strip = ({ commit: _c, status, ...rest }) => JSON.stringify(opts.status ? { ...rest, status: status ?? {} } : rest);
+    return strip(a) === strip(b);
+}
+/** Review statuses from the current flows.json, for the states that still exist. */
+export function keptStatus(project, manifest) {
+    const existing = readFlowsJson(project)?.status;
+    if (!existing)
+        return undefined;
+    const nodes = new Set(manifest.screens.flatMap((s) => s.states.map((st) => `${s.id}.${st.id}`)));
+    const kept = Object.fromEntries(Object.entries(existing).filter(([node]) => nodes.has(node)));
+    return Object.keys(kept).length ? kept : undefined;
+}
+export function readFlowsJson(project) {
+    const path = project.abs(LAYOUT.flowsJson);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Checks that design/flows.json matches the code. A warning: the next export fixes it. */
+export function staleIssue(project, manifest) {
+    const existing = readFlowsJson(project);
+    if (existing && sameManifest(existing, manifest))
+        return undefined;
+    return {
+        code: "code-flows-stale",
+        severity: "warning",
+        file: LAYOUT.flowsJson,
+        path: "",
+        message: existing
+            ? "flows.json is out of date with the screens and flows in the code. Run the flow export to update it."
+            : "flows.json hasn't been created yet. Run the flow export to create it.",
+    };
+}
+/** Writes design/flows.json, unless there are problems or `check` is set. */
+export function writeManifest(project, built, check) {
+    const issues = [...built.issues];
+    if (!issues.some((i) => i.severity === "error")) {
+        // Safety net: the shared validator must accept what we're about to write.
+        const r = validateFlows(built.manifest, LAYOUT.flowsJson);
+        issues.push(...r.issues);
+    }
+    const existing = readFlowsJson(project);
+    const changed = !existing || !sameManifest(existing, built.manifest, { status: true });
+    const ok = !issues.some((i) => i.severity === "error");
+    const written = ok && !check && (changed || existing?.commit !== built.manifest.commit);
+    if (written)
+        writeFileSync(project.abs(LAYOUT.flowsJson), serializeManifest(built.manifest));
+    return { manifest: built.manifest, issues, changed, written };
+}
+//# sourceMappingURL=flows.js.map

package/dist/flows.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,3 @@
+import type { ValidationResult } from "@cogitato/contract";
+/** Plain-language report for people. `--json` prints the ValidationReport instead. */
+export declare function formatResult(r: ValidationResult, success?: string): string;

package/dist/format.js

@@ -0,0 +1,27 @@
+const plural = (n, word) => `${n} ${word}${n === 1 ? "" : "s"}`;
+/** Plain-language report for people. `--json` prints the ValidationReport instead. */
+export function formatResult(r, success = "All good: the prototype follows the design contract.") {
+    const errors = r.issues.filter((i) => i.severity === "error").length;
+    const warnings = r.issues.length - errors;
+    if (r.issues.length === 0)
+        return success;
+    const lines = [];
+    lines.push(errors
+        ? `Found ${plural(errors, "problem")}${warnings ? ` and ${plural(warnings, "warning")}` : ""} to fix.`
+        : `No problems, but ${plural(warnings, "warning")}:`);
+    const byFile = new Map();
+    for (const i of r.issues)
+        byFile.set(i.file, [...(byFile.get(i.file) ?? []), i]);
+    for (const [file, list] of byFile) {
+        lines.push("", file);
+        for (const i of list) {
+            const where = i.line ? `line ${i.line}: ` : "";
+            const tag = i.severity === "warning" ? "(warning) " : "";
+            lines.push(`  ${tag}${where}${i.message}`);
+            if (i.suggestion)
+                lines.push(`    suggested: ${i.suggestion}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAEhF,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,CAAmB,EAAE,OAAO,GAAG,sDAAsD;IAChH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IAC1C,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAE1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CACR,MAAM;QACJ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU;QACtG,CAAC,CAAC,oBAAoB,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,CACvD,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/gaps.d.ts

@@ -0,0 +1,21 @@
+import { type Gap } from "@cogitato/contract";
+import { type Project } from "./project.js";
+export interface AddGapOptions {
+    kind: Gap["kind"];
+    /** What's missing, e.g. "Stepper" or "color.feedback.warning-subtle". */
+    name: string;
+    /** What the designer was trying to do. */
+    context: string;
+    screen?: string;
+    workaround?: string;
+    requestedBy?: string;
+    /** For tests. */
+    now?: Date;
+}
+export interface AddGapResult {
+    gap: Gap;
+    /** False when the same open gap was already logged; it's returned instead of a duplicate. */
+    created: boolean;
+}
+/** Records something the design needed that the contract doesn't have, in design/contract/gaps.json. */
+export declare function addGap(project: Project, opts: AddGapOptions): AddGapResult;

package/dist/gaps.js

@@ -0,0 +1,52 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { kebabCase, validateFormat } from "@cogitato/contract";
+import { KitError } from "./errors.js";
+import { LAYOUT } from "./project.js";
+const FILE = `${LAYOUT.contract}/gaps.json`;
+const SCHEMA = "../../node_modules/@cogitato/contract/schema/gaps.schema.json";
+function gitUser(project) {
+    const r = spawnSync("git", ["config", "user.name"], { cwd: project.root, encoding: "utf8" });
+    return r.status === 0 && r.stdout.trim() ? r.stdout.trim() : undefined;
+}
+/** Records something the design needed that the contract doesn't have, in design/contract/gaps.json. */
+export function addGap(project, opts) {
+    const path = project.abs(FILE);
+    let log = { $schema: SCHEMA, gaps: [] };
+    if (existsSync(path)) {
+        try {
+            log = JSON.parse(readFileSync(path, "utf8"));
+        }
+        catch {
+            throw new KitError(`${FILE} has a typo in it, so the gap couldn't be added. Ask a developer to fix the file.`);
+        }
+    }
+    const name = opts.name.trim();
+    const same = log.gaps.find((g) => g.status === "open" && g.kind === opts.kind && g.name.toLowerCase() === name.toLowerCase());
+    if (same)
+        return { gap: same, created: false };
+    const slug = kebabCase(name).replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || "item";
+    const taken = new Set(log.gaps.map((g) => g.id));
+    let id = `gap_${slug}`;
+    for (let n = 2; taken.has(id); n++)
+        id = `gap_${slug}-${n}`;
+    const requestedBy = opts.requestedBy ?? gitUser(project);
+    const gap = {
+        id,
+        kind: opts.kind,
+        name,
+        context: opts.context.trim(),
+        ...(opts.screen ? { screen: opts.screen } : {}),
+        ...(opts.workaround?.trim() ? { workaround: opts.workaround.trim() } : {}),
+        ...(requestedBy ? { requestedBy } : {}),
+        status: "open",
+        createdAt: (opts.now ?? new Date()).toISOString().replace(/\.\d{3}Z$/, "Z"),
+    };
+    const next = { ...log, gaps: [...log.gaps, gap] };
+    const check = validateFormat("gaps", next, FILE);
+    if (!check.ok)
+        throw new KitError(`The gap couldn't be recorded: ${check.issues.map((i) => i.message).join(" ")}`);
+    writeFileSync(path, JSON.stringify(next, null, 2) + "\n");
+    return { gap, created: true };
+}
+//# sourceMappingURL=gaps.js.map

package/dist/gaps.js.map

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

package/dist/hook.d.ts

@@ -0,0 +1,33 @@
+import { type DoctorOptions } from "./doctor.js";
+import { type Project } from "./project.js";
+export type HookEvent = "post-edit" | "session-start";
+export interface HookInput {
+    hook_event_name?: string;
+    cwd?: string;
+    tool_name?: string;
+    tool_input?: {
+        file_path?: string;
+    };
+    source?: string;
+}
+export interface HookOutput {
+    decision?: "block";
+    reason?: string;
+    systemMessage?: string;
+    hookSpecificOutput?: {
+        hookEventName: "PostToolUse" | "SessionStart";
+        additionalContext?: string;
+    };
+}
+export declare const MCP_TOOLS = "list_components, get_component, get_tokens, create_screen, add_state, log_gap, validate, canvas_link, set_status";
+/** Which files the edit hook checks: prototype source outside the kit, and the design/ folder. */
+export declare function checkedByHook(rel: string): boolean;
+/** After Claude writes or edits a file: keep flows.json fresh and send any problems back to Claude. */
+export declare function postEditHook(project: Project, input: HookInput): HookOutput | undefined;
+/** At session start: tell the designer (one line) and Claude (details) if the machine isn't ready. */
+export declare function sessionStartHook(project: Project, opts?: DoctorOptions): Promise<HookOutput>;
+/**
+ * Runs a hook from its JSON input. Returns undefined when there's nothing to say (including
+ * when the session isn't in a Cogitato prototype at all).
+ */
+export declare function runHook(event: HookEvent, input: HookInput, start?: string): Promise<HookOutput | undefined>;

package/dist/hook.js

@@ -0,0 +1,78 @@
+import { isAbsolute } from "node:path";
+import { doctor } from "./doctor.js";
+import { exportFlows } from "./export-flows.js";
+import { formatResult } from "./format.js";
+import { LAYOUT, findProject, isKitFile, isScreenFile, sourceFiles } from "./project.js";
+import { readRegistry } from "./registry.js";
+import { validate } from "./validate.js";
+export const MCP_TOOLS = "list_components, get_component, get_tokens, create_screen, add_state, log_gap, validate, canvas_link, set_status";
+const FIX_ADVICE = "Fix these before finishing. If the design needs something the kit doesn't have, use the nearest token or kit component " +
+    "and say so, or log a gap with the log_gap tool; don't hardcode values or build your own components.";
+/** Which files the edit hook checks: prototype source outside the kit, and the design/ folder. */
+export function checkedByHook(rel) {
+    if (rel.startsWith("..") || isAbsolute(rel))
+        return false;
+    if (rel.startsWith(`${LAYOUT.design}/`))
+        return rel.endsWith(".json") || rel.endsWith(".md");
+    return rel.startsWith(`${LAYOUT.src}/`) && /\.(tsx?|css)$/.test(rel) && !rel.endsWith(".d.ts") && !isKitFile(rel);
+}
+/** After Claude writes or edits a file: keep flows.json fresh and send any problems back to Claude. */
+export function postEditHook(project, input) {
+    const file = input.tool_input?.file_path;
+    if (!file)
+        return undefined;
+    const rel = project.rel(file);
+    if (!checkedByHook(rel))
+        return undefined;
+    if (rel === LAYOUT.flowsJson) {
+        return {
+            decision: "block",
+            reason: "design/flows.json is generated from the screens and src/flows.ts, so edits to it get overwritten. " +
+                "Change src/flows.ts (or the screen's states) instead; the file updates itself after each edit.",
+        };
+    }
+    if (isScreenFile(rel) || rel === LAYOUT.flowsTs)
+        exportFlows(project);
+    const r = validate(project, { files: [rel] });
+    if (r.ok && r.issues.length === 0)
+        return undefined;
+    if (r.ok) {
+        return { hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: `Cogitato check of ${rel}:\n${formatResult(r)}` } };
+    }
+    return { decision: "block", reason: `Cogitato check of ${rel}: ${formatResult(r)}\n\n${FIX_ADVICE}` };
+}
+/** At session start: tell the designer (one line) and Claude (details) if the machine isn't ready. */
+export async function sessionStartHook(project, opts = {}) {
+    const checks = await doctor(project, opts);
+    const problems = checks.filter((c) => c.status === "problem");
+    const warnings = checks.filter((c) => c.status === "warning");
+    const reg = readRegistry(project, sourceFiles(project));
+    const states = reg.screens.reduce((n, s) => n + s.fixtures.length, 0);
+    const context = [
+        `This is a Cogitato prototype: ${reg.screens.length} screen${reg.screens.length === 1 ? "" : "s"}, ${states} state${states === 1 ? "" : "s"}.`,
+        "The person here is usually a designer: plain language, never ask them to run commands.",
+        `Use the Cogitato MCP tools (${MCP_TOOLS}) instead of reading design/contract files, and the Cogitato skills for building screens and states.`,
+        "Every edit is checked automatically and design/flows.json is regenerated after each one, so there's no need to run kit commands yourself.",
+        ...(problems.length
+            ? ["", "Setup problems found:", ...problems.map((c) => `- ${c.message}`), "Offer to fix them with the Cogitato setup-machine skill, in plain words."]
+            : []),
+        ...(warnings.length ? ["", "Notes:", ...warnings.map((c) => `- ${c.message}`)] : []),
+    ].join("\n");
+    return {
+        ...(problems.length
+            ? { systemMessage: `Cogitato: this prototype isn't ready on this computer yet. ${problems[0].message} Ask Claude to set it up.` }
+            : {}),
+        hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: context },
+    };
+}
+/**
+ * Runs a hook from its JSON input. Returns undefined when there's nothing to say (including
+ * when the session isn't in a Cogitato prototype at all).
+ */
+export async function runHook(event, input, start = input.cwd ?? process.cwd()) {
+    const project = findProject(start);
+    if (!project)
+        return undefined;
+    return event === "post-edit" ? postEditHook(project, input) : sessionStartHook(project);
+}
+//# sourceMappingURL=hook.js.map

package/dist/hook.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { DEFAULT_PORT, doctor, formatDoctor, isServerUp, type CheckStatus, type DoctorCheck, type DoctorOptions } from "./doctor.js";
+export { exportFlows, type ExportOptions } from "./export-flows.js";
+export { buildManifest, keptStatus, sameManifest, serializeManifest, type ExportResult } from "./flows.js";
+export { formatResult } from "./format.js";
+export { KIT_PATH, preview, type PreviewOptions, type PreviewResult } from "./preview.js";
+export { LAYOUT, findProject, projectAt, readContract, sourceFiles, type ContractView, type Project } from "./project.js";
+export { ID_PATTERNS, humanize, readFlows, readRegistry, readScreen, type Registry, type ScreenEntry } from "./registry.js";
+export { checkCssValue } from "./rules/css-values.js";
+export { validate, type ValidateOptions } from "./validate.js";
+export { KitError } from "./errors.js";
+export { addGap, type AddGapOptions, type AddGapResult } from "./gaps.js";
+export { MCP_TOOLS, checkedByHook, postEditHook, runHook, sessionStartHook, type HookEvent, type HookInput, type HookOutput } from "./hook.js";
+export { CANVAS_PATH, branchSlug, canvasLink, previewLink, stateLink } from "./links.js";
+export { SNAPSHOT_VIEWPORT, snapshotFile, snapshotManifest, takeSnapshots, type SnapshotOptions, type SnapshotResult } from "./snapshots.js";
+export { FRAME_STATUSES, setStatus, statusLabel, type FrameStatusValue } from "./status.js";
+export { describeChanges, saveVersion, type SaveOptions, type SaveResult } from "./save.js";
+export { addEdge, addState, createScreen, type AddEdgeOptions, type AddStateOptions, type CreateScreenOptions, type ScaffoldResult, } from "./scaffold.js";

package/dist/index.js

@@ -0,0 +1,19 @@
+// Library entry. Hooks, skills and the kit MCP server call these; they don't reimplement them.
+export { DEFAULT_PORT, doctor, formatDoctor, isServerUp } from "./doctor.js";
+export { exportFlows } from "./export-flows.js";
+export { buildManifest, keptStatus, sameManifest, serializeManifest } from "./flows.js";
+export { formatResult } from "./format.js";
+export { KIT_PATH, preview } from "./preview.js";
+export { LAYOUT, findProject, projectAt, readContract, sourceFiles } from "./project.js";
+export { ID_PATTERNS, humanize, readFlows, readRegistry, readScreen } from "./registry.js";
+export { checkCssValue } from "./rules/css-values.js";
+export { validate } from "./validate.js";
+export { KitError } from "./errors.js";
+export { addGap } from "./gaps.js";
+export { MCP_TOOLS, checkedByHook, postEditHook, runHook, sessionStartHook } from "./hook.js";
+export { CANVAS_PATH, branchSlug, canvasLink, previewLink, stateLink } from "./links.js";
+export { SNAPSHOT_VIEWPORT, snapshotFile, snapshotManifest, takeSnapshots } from "./snapshots.js";
+export { FRAME_STATUSES, setStatus, statusLabel } from "./status.js";
+export { describeChanges, saveVersion } from "./save.js";
+export { addEdge, addState, createScreen, } from "./scaffold.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAA0D,MAAM,aAAa,CAAC;AACrI,OAAO,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAA2C,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAmC,MAAM,cAAc,CAAC;AAC1H,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAmC,MAAM,eAAe,CAAC;AAC5H,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,EAAyC,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAmD,MAAM,WAAW,CAAC;AAC/I,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAA6C,MAAM,gBAAgB,CAAC;AAC7I,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,WAAW,EAAqC,MAAM,WAAW,CAAC;AAC5F,OAAO,EACL,OAAO,EACP,QAAQ,EACR,YAAY,GAKb,MAAM,eAAe,CAAC"}

package/dist/issue.d.ts

@@ -0,0 +1,17 @@
+import type { Issue } from "@cogitato/contract";
+import ts from "typescript";
+export type { Issue };
+/** Issue at a position in a TypeScript source file. */
+export declare function issueAt(code: string, sf: ts.SourceFile, node: ts.Node, message: string, extra?: {
+    severity?: Issue["severity"];
+    suggestion?: string;
+}): Issue;
+export declare function parseSource(file: string, text: string): ts.SourceFile;
+/** Text of a string literal or a template without substitutions; undefined for anything computed. */
+export declare function literalText(node: ts.Node | undefined): string | undefined;
+/** Name of an object literal property when it's written as plain text. */
+export declare function propertyName(name: ts.PropertyName): string | undefined;
+/** The value expression of property `key` in an object literal, if it's a plain `key: value` assignment. */
+export declare function getProperty(obj: ts.ObjectLiteralExpression, key: string): ts.PropertyAssignment | undefined;
+/** Calls to `name(...)` (or `x.name(...)`) anywhere in the file. */
+export declare function findCalls(sf: ts.SourceFile, name: string): ts.CallExpression[];

package/dist/issue.js

@@ -0,0 +1,65 @@
+import ts from "typescript";
+/** Issue at a position in a TypeScript source file. */
+export function issueAt(code, sf, node, message, extra = {}) {
+    const { line, character } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+    return {
+        code,
+        severity: extra.severity ?? "error",
+        file: sf.fileName,
+        path: "",
+        line: line + 1,
+        column: character + 1,
+        message,
+        ...(extra.suggestion !== undefined ? { suggestion: extra.suggestion } : {}),
+    };
+}
+export function parseSource(file, text) {
+    const kind = file.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    return ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, kind);
+}
+/** Text of a string literal or a template without substitutions; undefined for anything computed. */
+export function literalText(node) {
+    if (!node)
+        return undefined;
+    if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))
+        return node.text;
+    if (ts.isParenthesizedExpression(node) || ts.isAsExpression(node) || ts.isSatisfiesExpression(node)) {
+        return literalText(node.expression);
+    }
+    return undefined;
+}
+/** Name of an object literal property when it's written as plain text. */
+export function propertyName(name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name) || ts.isNoSubstitutionTemplateLiteral(name)) {
+        return name.text;
+    }
+    return undefined;
+}
+/** The value expression of property `key` in an object literal, if it's a plain `key: value` assignment. */
+export function getProperty(obj, key) {
+    for (const p of obj.properties) {
+        if (ts.isPropertyAssignment(p) && propertyName(p.name) === key)
+            return p;
+    }
+    return undefined;
+}
+/** Calls to `name(...)` (or `x.name(...)`) anywhere in the file. */
+export function findCalls(sf, name) {
+    const out = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            const calleeName = ts.isIdentifier(callee)
+                ? callee.text
+                : ts.isPropertyAccessExpression(callee)
+                    ? callee.name.text
+                    : undefined;
+            if (calleeName === name)
+                out.push(node);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return out;
+}
+//# sourceMappingURL=issue.js.map

package/dist/issue.js.map

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

package/dist/links.d.ts

@@ -0,0 +1,16 @@
+import { type Project } from "./project.js";
+export declare const CANVAS_PATH = "/__canvas";
+/**
+ * Local address of a screen state, like http://localhost:5173/checkout/payment?fixture=card-declined.
+ * `node` is "{screen id}.{state}" or just a screen id (its default state).
+ */
+export declare function stateLink(project: Project, node: string, port?: number): string;
+/** Local canvas, opened on one state's frame. */
+export declare function canvasLink(project: Project, node: string, port?: number): string;
+/** Netlify's form of a branch name in branch-deploy addresses: "design/sam-0102" -> "design-sam-0102". */
+export declare function branchSlug(branch: string): string;
+/**
+ * Hosted canvas for a branch, from `"kit": { "previewUrl": "https://{branch}--site.netlify.app" }`
+ * in the prototype's package.json. Undefined when the prototype has no hosting set up.
+ */
+export declare function previewLink(project: Project, branch: string, node?: string): string | undefined;