@cogitato/kit-cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# @cogitato/kit-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The `kit` command: the deterministic engine behind Cogitato. Hooks, skills and the MCP server call into it ([02-kit-cli.md](../../docs/architecture/components/02-kit-cli.md)).
+
+Run it anywhere inside a prototype; it finds the folder holding `design/contract`.
+
+| Command | What it does |
+|---|---|
+| `kit validate [--contract] [--files a.tsx b.css] [--json]` | Contract, code and flows against the design contract. `--files` is the fast path for edit hooks. |
+| `kit export-flows [--check] [--json]` | Writes `design/flows.json` from `src/screens/**/screen.tsx` and `src/flows.ts`, read statically. `--check` only reports whether the file is current. |
+| `kit preview [--port n] [--no-open]` | Starts the prototype if it isn't running, then opens `/__kit`. |
+| `kit doctor [--json] [--quiet]` | Node, pnpm, installed parts, contract, flows, dev server, `.env`. `--quiet` prints problems only. |
+| `kit new-screen <id> [--title] [--route] [--from <step>] [--label]` | Creates `src/screens/<id>/screen.tsx` with a default state; `--from` adds an arrow to it. |
+| `kit add-state <screen> <state> [--title] [--from <step>] [--label]` | Adds a state to a screen. |
+| `kit add-edge <from> <to> [--label] [--flow]` | Connects two states in `src/flows.ts`. |
+| `kit gap add --kind --name --context [--screen] [--workaround]` | Records a missing component, token or pattern in `gaps.json`. |
+| `kit link <step> [--canvas]` | Local address of a state, or of its frame on the canvas. |
+| `kit status <step> <status>` | Sets a state's review status (`exploring`, `in-review`, `approved`, `handed-off`) in `flows.json`. |
+| `kit snapshots [--dist dist]` | Screenshots every state of the built prototype for the canvas. Best effort: needs Playwright and Chromium, and otherwise skips. |
+| `kit save [--message]` | Saves a version: commit on a design branch, then push if there's a remote. |
+| `kit hook <post-edit\|session-start>` | Claude Code hook (JSON on stdin), used by the plugin. |
+
+Exit codes: 0 all good, 1 problems found (or a request kit refused, with a plain explanation), 2 couldn't run. Scaffolding edits files in place through the TypeScript parser and keeps their formatting ([ADR 011](../../docs/decisions/011-scaffolding-and-saving.md)). `--json` prints a `ValidationReport` (`@cogitato/contract`'s `report.schema.json`).
+
+The rules and their codes are listed in [ADR 008](../../docs/decisions/008-token-css-and-validation-report.md). Every message is written for a designer, with a machine `suggestion` where there's an obvious fix.
+
+## Library
+```ts
+import { findProject, validate, exportFlows } from "@cogitato/kit-cli";
+const project = findProject()!;
+const { ok, issues } = validate(project, { files: ["src/screens/cart/screen.tsx"] });
+```
+
+## Tests
+`pnpm test` runs the rule unit tests, plus the template checks: it validates clean, its exported flows match the Phase 0 reference, and single-file validation is fast. It also runs the seeded bad prototypes in `test/fixtures/bad/`. Each is a set of edits to a temp copy of the template plus the codes they must produce, and message wording is snapshotted.

package/bin/kit.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "../dist/cli.js";
+
+process.exitCode = await main(process.argv.slice(2));

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+/** Runs the CLI and returns the exit code. */
+export declare function main(argv: string[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,204 @@
+import mri from "mri";
+import { toReport } from "@cogitato/contract";
+import { doctor, formatDoctor } from "./doctor.js";
+import { exportFlows } from "./export-flows.js";
+import { KitError } from "./errors.js";
+import { formatResult } from "./format.js";
+import { addGap } from "./gaps.js";
+import { runHook } from "./hook.js";
+import { canvasLink, stateLink } from "./links.js";
+import { preview } from "./preview.js";
+import { findProject } from "./project.js";
+import { saveVersion } from "./save.js";
+import { addEdge, addState, createScreen } from "./scaffold.js";
+import { takeSnapshots } from "./snapshots.js";
+import { FRAME_STATUSES, setStatus, statusLabel } from "./status.js";
+import { validate } from "./validate.js";
+const HELP = `kit: Cogitato's prototype tools
+
+  kit validate [--contract] [--files <file>...] [--json]
+      Check the prototype against its design contract.
+  kit export-flows [--check] [--json]
+      Write design/flows.json from the screens and src/flows.ts.
+  kit preview [--port <n>] [--no-open]
+      Start the prototype if needed and open the design kit page.
+  kit doctor [--json] [--quiet] [--port <n>]
+      Check this machine is ready to run the prototype.
+
+  kit new-screen <screen id> [--title <t>] [--route </path>] [--from <step>] [--label <l>] [--flow <id>]
+      Create a screen with a default state; --from adds an arrow to it.
+  kit add-state <screen id> <state> [--title <t>] [--from <step>] [--label <l>] [--flow <id>]
+      Add a state to a screen.
+  kit add-edge <from step> <to step> [--label <l>] [--flow <id>]
+      Connect two states in src/flows.ts.
+  kit gap add --kind <component|token|pattern> --name <n> --context <why> [--screen <id>] [--workaround <w>]
+      Record something the design needs that the kit doesn't have.
+  kit link <step> [--canvas] [--port <n>]
+      Print the local address of a screen state, or of its frame on the canvas.
+  kit status <step> <status>
+      Set a state's review status on the canvas.
+  kit snapshots [--dist <folder>] [--port <n>]
+      Screenshot every state of the built prototype for the canvas (needs Playwright).
+  kit save [--message <m>]
+      Save a version: commit on a design branch, and share it if there's a remote.
+  kit hook <post-edit|session-start>
+      Claude Code hook (reads the hook's JSON on stdin). Used by the Cogitato plugin.
+
+Steps are "{screen id}.{state}", like "checkout.payment.card-declined". Every command takes --json.
+
+Exit codes: 0 all good, 1 problems found, 2 couldn't run.`;
+const out = (text) => {
+    if (text)
+        process.stdout.write(text + "\n");
+};
+function project() {
+    const p = findProject();
+    if (!p)
+        throw new UsageError("This folder isn't a Cogitato prototype: there's no design/contract folder here or above it.");
+    return p;
+}
+class UsageError extends Error {
+}
+/** Runs the CLI and returns the exit code. */
+export async function main(argv) {
+    const args = mri(argv, {
+        boolean: ["json", "contract", "check", "quiet", "help", "open", "canvas"],
+        string: ["files", "port", "title", "route", "from", "to", "label", "flow", "kind", "name", "context", "screen", "workaround", "message", "dist"],
+        default: { open: true },
+    });
+    const [command, ...rest] = args._;
+    const port = args.port ? Number(args.port) : undefined;
+    const opt = (key) => (typeof args[key] === "string" && args[key] ? args[key] : undefined);
+    const need = (value, what) => {
+        if (typeof value !== "string" || !value)
+            throw new UsageError(`Missing ${what}.
+
+${HELP}`);
+        return value;
+    };
+    const scaffolded = (r) => {
+        if (args.json)
+            out(JSON.stringify({ ...toReport(r), files: r.files, node: r.node, link: r.link, canvas: r.canvas }, null, 2));
+        else
+            out(`Done: ${r.node} (${r.files.join(", ")})\nSee it at ${r.link}\nOn the canvas: ${r.canvas}\n\n${formatResult(r)}`);
+        return r.ok ? 0 : 1;
+    };
+    try {
+        switch (command) {
+            case "validate": {
+                // --files takes the following arguments too: `kit validate --files a.tsx b.css`.
+                const files = args.files === undefined ? undefined : [args.files, ...rest].flat().map(String).filter(Boolean);
+                const r = validate(project(), { contractOnly: args.contract, ...(files ? { files } : {}) });
+                out(args.json ? JSON.stringify(toReport(r), null, 2) : formatResult(r));
+                return r.ok ? 0 : 1;
+            }
+            case "export-flows": {
+                const r = exportFlows(project(), { check: args.check });
+                const result = { ok: !r.issues.some((i) => i.severity === "error"), issues: r.issues };
+                if (args.json)
+                    out(JSON.stringify(toReport(result), null, 2));
+                else if (!result.ok)
+                    out(formatResult(result) + "\n\nflows.json wasn't updated.");
+                else if (args.check)
+                    out(r.changed ? "flows.json is out of date. Run kit export-flows." : "flows.json is up to date.");
+                else
+                    out(r.written ? "Updated design/flows.json." : "flows.json is already up to date.");
+                return !result.ok || (args.check && r.changed) ? 1 : 0;
+            }
+            case "preview": {
+                const r = await preview(project(), { ...(port ? { port } : {}), open: args.open, log: out });
+                if (r.server) {
+                    await new Promise((resolve) => r.server.on("exit", () => resolve()));
+                }
+                return 0;
+            }
+            case "doctor": {
+                const checks = await doctor(project(), port ? { port } : {});
+                out(args.json ? JSON.stringify(checks, null, 2) : formatDoctor(checks, args.quiet));
+                return checks.some((c) => c.status === "problem") ? 1 : 0;
+            }
+            case "new-screen":
+                return scaffolded(createScreen(project(), {
+                    id: need(rest[0], "the screen id"),
+                    title: opt("title"), route: opt("route"), from: opt("from"), label: opt("label"), flow: opt("flow"),
+                }));
+            case "add-state":
+                return scaffolded(addState(project(), {
+                    screen: need(rest[0], "the screen id"),
+                    state: need(rest[1], "the state name"),
+                    title: opt("title"), from: opt("from"), label: opt("label"), flow: opt("flow"),
+                }));
+            case "add-edge":
+                return scaffolded(addEdge(project(), { from: need(rest[0] ?? opt("from"), "the step to start from"), to: need(rest[1] ?? opt("to"), "the step to go to"), label: opt("label"), flow: opt("flow") }));
+            case "gap": {
+                if (rest[0] !== "add")
+                    throw new UsageError(`Use "kit gap add".
+
+${HELP}`);
+                const kind = need(opt("kind"), "--kind");
+                if (kind !== "component" && kind !== "token" && kind !== "pattern")
+                    throw new UsageError("--kind is component, token or pattern.");
+                const r = addGap(project(), {
+                    kind, name: need(opt("name"), "--name"), context: need(opt("context"), "--context"),
+                    screen: opt("screen"), workaround: opt("workaround"),
+                });
+                out(args.json ? JSON.stringify(r, null, 2) : r.created ? `Logged ${r.gap.id}: ${r.gap.name}.` : `Already logged as ${r.gap.id}.`);
+                return 0;
+            }
+            case "link": {
+                const link = (args.canvas ? canvasLink : stateLink)(project(), need(rest[0], "the step"), port);
+                out(args.json ? JSON.stringify({ link }) : link);
+                return 0;
+            }
+            case "status": {
+                const r = setStatus(project(), need(rest[0], "the step"), need(rest[1], `the status (${FRAME_STATUSES.join(", ")})`));
+                out(args.json ? JSON.stringify(r) : `${r.node} is now "${statusLabel(r.status)}" (was "${statusLabel(r.previous)}").`);
+                return 0;
+            }
+            case "snapshots": {
+                const r = await takeSnapshots(project(), { ...(opt("dist") ? { dist: opt("dist") } : {}), ...(port ? { port } : {}), log: out });
+                if (args.json)
+                    out(JSON.stringify(r, null, 2));
+                else if (r.skipped)
+                    out(r.skipped);
+                // Snapshots are a nice-to-have: never fail a build over them.
+                return 0;
+            }
+            case "save": {
+                const r = saveVersion(project(), { message: opt("message") });
+                out(args.json ? JSON.stringify(r, null, 2) : r.message);
+                return 0;
+            }
+            case "hook": {
+                const event = rest[0];
+                if (event !== "post-edit" && event !== "session-start")
+                    throw new UsageError(`Use "kit hook post-edit" or "kit hook session-start".`);
+                const input = await readStdin();
+                const r = await runHook(event, input ? JSON.parse(input) : {});
+                if (r)
+                    out(JSON.stringify(r));
+                return 0;
+            }
+            case undefined:
+            case "help":
+                out(HELP);
+                return command ? 0 : args.help ? 0 : 2;
+            default:
+                out(`"${command}" isn't a kit command.\n\n${HELP}`);
+                return 2;
+        }
+    }
+    catch (e) {
+        out(e instanceof Error ? e.message : String(e));
+        return e instanceof KitError ? 1 : 2;
+    }
+}
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8").trim();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,19 @@
+import { type Project } from "./project.js";
+export type CheckStatus = "ok" | "warning" | "problem";
+export interface DoctorCheck {
+    id: string;
+    status: CheckStatus;
+    /** One plain-language line: what's wrong and how to fix it, or what's fine. */
+    message: string;
+}
+export interface DoctorOptions {
+    /** Port the prototype's dev server uses. */
+    port?: number;
+    /** For tests: skip slow checks that touch the network or spawn processes. */
+    offline?: boolean;
+}
+export declare const DEFAULT_PORT = 5173;
+export declare function isServerUp(port: number, timeoutMs?: number): Promise<boolean>;
+/** Machine health check for a prototype. Every message is written for a designer. */
+export declare function doctor(project: Project, opts?: DoctorOptions): Promise<DoctorCheck[]>;
+export declare function formatDoctor(checks: DoctorCheck[], quiet?: boolean): string;

package/dist/doctor.js

@@ -0,0 +1,72 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { validateProject } from "@cogitato/contract";
+import { buildManifest, readFlowsJson, sameManifest } from "./flows.js";
+import { LAYOUT, sourceFiles } from "./project.js";
+import { readRegistry } from "./registry.js";
+export const DEFAULT_PORT = 5173;
+export async function isServerUp(port, timeoutMs = 800) {
+    try {
+        const res = await fetch(`http://localhost:${port}/`, { signal: AbortSignal.timeout(timeoutMs) });
+        return res.ok || res.status < 500;
+    }
+    catch {
+        return false;
+    }
+}
+function envKeys(path) {
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, "utf8")
+        .split(/\r?\n/)
+        .map((l) => /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=/.exec(l)?.[1])
+        .filter((k) => Boolean(k));
+}
+/** Machine health check for a prototype. Every message is written for a designer. */
+export async function doctor(project, opts = {}) {
+    const checks = [];
+    const add = (id, status, message) => checks.push({ id, status, message });
+    const major = Number(process.versions.node.split(".")[0]);
+    add("node", major >= 22 ? "ok" : "problem", major >= 22 ? `Node ${process.versions.node} is installed.` : `Node ${process.versions.node} is too old. Cogitato needs Node 22 or newer.`);
+    if (!opts.offline) {
+        const pnpm = spawnSync("pnpm", ["--version"], { encoding: "utf8", shell: true });
+        add("pnpm", pnpm.status === 0 ? "ok" : "problem", pnpm.status === 0 ? `pnpm ${pnpm.stdout.trim()} is installed.` : "pnpm isn't installed. It's needed to install the prototype's parts.");
+    }
+    const installed = ["@cogitato/runtime", "@cogitato/contract", "@cogitato/kit-mcp"].every((p) => existsSync(project.abs(`node_modules/${p}/package.json`)));
+    add("dependencies", installed ? "ok" : "problem", installed ? "The prototype's parts are installed." : "The prototype's parts aren't installed yet. Run the setup (pnpm install) once.");
+    const contract = validateProject(project.abs(LAYOUT.design));
+    const contractErrors = contract.issues.filter((i) => i.severity === "error").length;
+    add("contract", contractErrors ? "problem" : "ok", contractErrors
+        ? `The design contract has ${contractErrors} problem${contractErrors === 1 ? "" : "s"}. Run kit validate to see them.`
+        : "The design contract is valid.");
+    const existing = readFlowsJson(project);
+    const registry = readRegistry(project, sourceFiles(project));
+    const built = buildManifest(registry);
+    add("flows", !existing ? "warning" : sameManifest(existing, built.manifest) ? "ok" : "warning", !existing
+        ? "flows.json hasn't been created yet. Run kit export-flows."
+        : sameManifest(existing, built.manifest)
+            ? "flows.json is up to date."
+            : "flows.json is out of date. Run kit export-flows.");
+    if (!opts.offline) {
+        const port = opts.port ?? DEFAULT_PORT;
+        const up = await isServerUp(port);
+        add("dev-server", up ? "ok" : "warning", up ? `The prototype is running at http://localhost:${port}.` : `The prototype isn't running. Start it to see your screens (port ${port}).`);
+    }
+    const needed = envKeys(project.abs(".env.example"));
+    const present = new Set(envKeys(project.abs(".env")));
+    const missing = needed.filter((k) => !present.has(k));
+    add("env", missing.length ? "problem" : "ok", missing.length
+        ? `Some settings are missing from .env: ${missing.join(", ")}. Ask a developer for the values.`
+        : needed.length
+            ? "All settings in .env are present."
+            : "No settings are needed.");
+    return checks;
+}
+export function formatDoctor(checks, quiet = false) {
+    const shown = quiet ? checks.filter((c) => c.status === "problem") : checks;
+    if (quiet && shown.length === 0)
+        return "";
+    const mark = { ok: "ok     ", warning: "check  ", problem: "PROBLEM" };
+    return shown.map((c) => `${mark[c.status]}  ${c.message}`).join("\n");
+}
+//# 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/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A request kit can't carry out, with a message written for a designer ("There's already a
+ * screen called checkout.review."). The CLI prints it and exits 1; the MCP server returns it
+ * as a tool error.
+ */
+export declare class KitError extends Error {
+    name: string;
+}

package/dist/errors.js

@@ -0,0 +1,9 @@
+/**
+ * A request kit can't carry out, with a message written for a designer ("There's already a
+ * screen called checkout.review."). The CLI prints it and exits 1; the MCP server returns it
+ * as a tool error.
+ */
+export class KitError extends Error {
+    name = "KitError";
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,GAAG,UAAU,CAAC;CAC5B"}

package/dist/export-flows.d.ts

@@ -0,0 +1,8 @@
+import { type ExportResult } from "./flows.js";
+import { type Project } from "./project.js";
+export interface ExportOptions {
+    /** Don't write; report whether design/flows.json is up to date. */
+    check?: boolean;
+}
+/** Reads every screen and src/flows.ts, and writes design/flows.json for the canvas. */
+export declare function exportFlows(project: Project, opts?: ExportOptions): ExportResult;

package/dist/export-flows.js

@@ -0,0 +1,15 @@
+import { buildManifest, currentCommit, keptStatus, writeManifest } from "./flows.js";
+import { sourceFiles } from "./project.js";
+import { readRegistry } from "./registry.js";
+/** Reads every screen and src/flows.ts, and writes design/flows.json for the canvas. */
+export function exportFlows(project, opts = {}) {
+    const registry = readRegistry(project, sourceFiles(project));
+    const built = buildManifest(registry, currentCommit(project));
+    // With an unreadable screen, flow-step problems would only repeat it (see Registry.complete).
+    const flowIssues = registry.complete ? built.issues : [];
+    // Review statuses are set on the canvas, not in code, so they carry over from the current file.
+    const status = keptStatus(project, built.manifest);
+    const manifest = status ? { ...built.manifest, status } : built.manifest;
+    return writeManifest(project, { manifest, issues: [...registry.issues, ...flowIssues] }, opts.check ?? false);
+}
+//# sourceMappingURL=export-flows.js.map

package/dist/export-flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-flows.js","sourceRoot":"","sources":["../src/export-flows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAqB,MAAM,YAAY,CAAC;AACxG,OAAO,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAO7C,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,OAAsB,EAAE;IACpE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,8FAA8F;IAC9F,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,gGAAgG;IAChG,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IACzE,OAAO,aAAa,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;AAChH,CAAC"}