@intelligo-dev/cli 1.0.0-beta.1 → 1.0.0-beta.13

package/dist/commands/create-flow.js

@@ -0,0 +1,180 @@
+/**
+ * The conversation around `createApp`: ask what the flags did not say,
+ * scaffold, and install the chosen registry items once the developer
+ * has approved the commands that do it.
+ *
+ * Nothing runs on the developer's machine without their say-so. In a
+ * terminal the commands are shown and confirmed; without one (CI, a
+ * pipe) they run only under `--yes`, and are otherwise printed.
+ */
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import * as p from "@clack/prompts";
+import { assertNotOccupied, createApp, deriveNames, formatCreateResult, formatNextSteps, isOccupied, } from "./create.js";
+import { detectPackageManager, formatCommand, hasLocalShadcn, installPlan, readRegistryCatalogue, shortDescription, withDependencies, } from "../registry-items.js";
+export function parseCreateFlags(args) {
+    let target;
+    let items;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--items" || arg.startsWith("--items=")) {
+            const list = arg === "--items" ? (args[++i] ?? "") : arg.slice(8);
+            items = list
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        else if (!arg.startsWith("-") && target === undefined) {
+            target = arg;
+        }
+    }
+    return {
+        target,
+        items,
+        all: args.includes("--all"),
+        yes: args.includes("--yes") || args.includes("-y"),
+        install: !args.includes("--no-install"),
+        linkWorkspace: args.includes("--link-workspace"),
+    };
+}
+/** The pages a first app most likely wants; the picker starts with them ticked. */
+const SUGGESTED = ["app-shell", "auth-login", "auth-signup", "dashboard"];
+function bail(value, message = "Nothing was created.") {
+    if (!p.isCancel(value))
+        return false;
+    p.cancel(message);
+    return true;
+}
+function run(c, cwd) {
+    const result = spawnSync(c.command, c.args, {
+        cwd,
+        stdio: "inherit",
+        // pnpm, npx and friends are .cmd shims on Windows.
+        shell: process.platform === "win32",
+    });
+    return result.status === 0;
+}
+export async function runCreate(flags, context) {
+    const { interactive } = context;
+    const catalogue = readRegistryCatalogue(context.templatesDir);
+    const packageManager = detectPackageManager();
+    if (interactive)
+        p.intro("intelligo create");
+    // 1. Where.
+    let target = flags.target;
+    if (!target) {
+        if (!interactive) {
+            console.error("Usage: intelligo create <directory> [--items a,b | --all] [--yes] [--no-install]");
+            return 1;
+        }
+        const answer = await p.text({
+            message: "Project name",
+            placeholder: "my-app",
+            validate: (v) => {
+                if (!v)
+                    return "A name is required.";
+                try {
+                    deriveNames(v);
+                }
+                catch (error) {
+                    return error.message;
+                }
+                return isOccupied(v) ? `${v} is not empty.` : undefined;
+            },
+        });
+        if (bail(answer))
+            return 1;
+        target = answer;
+    }
+    // Before any question about items, so nobody chooses pages for an
+    // app that is then refused.
+    assertNotOccupied(target);
+    // 2. What.
+    let selected = [];
+    if (flags.all)
+        selected = Object.keys(catalogue.items);
+    else if (flags.items)
+        selected = flags.items;
+    else if (interactive) {
+        const answer = await p.multiselect({
+            message: "Which pages should be installed? (space to toggle)",
+            options: Object.entries(catalogue.items).map(([name, item]) => ({
+                value: name,
+                label: item.title,
+                hint: shortDescription(item.description),
+            })),
+            initialValues: SUGGESTED.filter((n) => n in catalogue.items),
+            required: false,
+        });
+        if (bail(answer))
+            return 1;
+        selected = answer;
+    }
+    const items = withDependencies(selected, catalogue.requires);
+    const added = items.filter((n) => !selected.includes(n));
+    if (interactive && added.length > 0) {
+        p.log.info(`Also installing what they build on: ${added.join(", ")}`);
+    }
+    // 3. The scaffold.
+    const result = createApp({
+        target,
+        templatesDir: context.templatesDir,
+        frameworkVersion: context.frameworkVersion,
+        linkWorkspace: flags.linkWorkspace,
+    });
+    const appRoot = path.resolve(target);
+    if (interactive) {
+        p.log.success(`Scaffolded ${result.written.length} files in ${target}`);
+    }
+    // 4. The pages — only with approval.
+    const plan = installPlan(items, { appRoot, packageManager });
+    let approved = plan.length > 0 && flags.install && flags.yes;
+    if (plan.length > 0 && flags.install && !flags.yes && interactive) {
+        const needsInstall = !hasLocalShadcn(appRoot);
+        p.note(plan.map(formatCommand).join("\n"), "Commands to run in " + target);
+        const answer = await p.confirm({
+            message: needsInstall
+                ? `shadcn is not installed yet — install the dependencies (shadcn included) with ${packageManager} and add ${items.length} page(s)?`
+                : `Add ${items.length} page(s) with shadcn?`,
+        });
+        if (bail(answer, `The scaffold is in ${target}; nothing was installed.`))
+            return 1;
+        approved = answer;
+    }
+    let pending = [];
+    if (approved) {
+        for (const [i, command] of plan.entries()) {
+            if (interactive)
+                p.log.step(formatCommand(command));
+            else
+                console.log(`› ${formatCommand(command)}`);
+            if (!run(command, appRoot)) {
+                pending = plan.slice(i);
+                const message = `\`${formatCommand(command)}\` failed — the scaffold is in place; run the rest by hand.`;
+                if (interactive)
+                    p.log.error(message);
+                else
+                    console.error(message);
+                break;
+            }
+        }
+    }
+    else {
+        pending = plan;
+    }
+    const next = {
+        packageManager,
+        installed: approved && pending.length === 0,
+        pending,
+    };
+    if (interactive) {
+        p.note(formatNextSteps(target, next), "Next");
+        p.outro(next.installed ? `${items.length} page(s) installed.` : "Scaffold ready.");
+    }
+    else {
+        console.log(formatCreateResult(target, result, next));
+    }
+    // A failed install is a failure; a declined one is a choice.
+    return approved && pending.length > 0 ? 1 : 0;
+}
+//# sourceMappingURL=create-flow.js.map

package/dist/commands/create-flow.js.map

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

package/dist/commands/create.d.ts

@@ -1,14 +1,21 @@
 /**
  * `intelligo create <name>` — a new application on the framework.
  *
- * ADR-0001 is explicit that this is onboarding, not the product
- * boundary: what it writes is the consumer's from the moment it lands,
- * and the enduring relationship is the versioned packages, not this
+ * This is onboarding, not the product boundary: what it writes is the
+ * consumer's from the moment it lands, and the enduring relationship is the versioned packages, not this
  * scaffold. So it generates through the same manifest machinery as
  * `add`, which means the very first upgrade already knows which files
  * you have since edited.
+ *
+ * In a terminal it asks for the project name when none is given, then
+ * which registry pages to install (`--items a,b` or `--all` answer that
+ * without asking). The pages are installed by the shadcn CLI the scaffold
+ * declares, after the dependencies — and only once you approve the exact
+ * commands, or pass `--yes`. `--no-install` stops after the scaffold and
+ * prints them instead.
  */
 import { type AddResult } from "./add.js";
+import { type Command, type PackageManager } from "../registry-items.js";
 export type CreateOptions = {
     /** Directory to create the app in; created if absent. */
     target: string;
@@ -18,8 +25,7 @@ export type CreateOptions = {
      * Emit `workspace:*` for the @intelligo-dev/* dependencies instead of a
      * version range. Only meaningful when scaffolding inside this
      * monorepo — outside it, pnpm fails the install with "workspace
-     * protocol used outside a workspace", which is the first thing a new
-     * user would have seen.
+     * protocol used outside a workspace".
      */
     linkWorkspace?: boolean;
 };
@@ -28,6 +34,17 @@ export declare function deriveNames(target: string): {
     appName: string;
     appSlug: string;
 };
+export declare function isOccupied(target: string): boolean;
+/** Scaffolding into an occupied directory is how people lose work. */
+export declare function assertNotOccupied(target: string): void;
 export declare function createApp(options: CreateOptions): AddResult;
-export declare function formatCreateResult(target: string, r: AddResult): string;
+export type NextSteps = {
+    packageManager: PackageManager;
+    /** Whether `create` already installed the dependencies. */
+    installed: boolean;
+    /** Install commands the developer declined, or that did not get to run. */
+    pending?: Command[];
+};
+export declare function formatNextSteps(target: string, next: NextSteps): string;
+export declare function formatCreateResult(target: string, r: AddResult, next?: NextSteps): string;
 //# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CA0B3D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAYvE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOtD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAoB3D;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB,CAAC;AASF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAYvE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,SAAS,EACZ,IAAI,GAAE,SAAwD,GAC7D,MAAM,CAWR"}

package/dist/commands/create.js

@@ -1,16 +1,23 @@
 /**
  * `intelligo create <name>` — a new application on the framework.
  *
- * ADR-0001 is explicit that this is onboarding, not the product
- * boundary: what it writes is the consumer's from the moment it lands,
- * and the enduring relationship is the versioned packages, not this
+ * This is onboarding, not the product boundary: what it writes is the
+ * consumer's from the moment it lands, and the enduring relationship is the versioned packages, not this
  * scaffold. So it generates through the same manifest machinery as
  * `add`, which means the very first upgrade already knows which files
  * you have since edited.
+ *
+ * In a terminal it asks for the project name when none is given, then
+ * which registry pages to install (`--items a,b` or `--all` answer that
+ * without asking). The pages are installed by the shadcn CLI the scaffold
+ * declares, after the dependencies — and only once you approve the exact
+ * commands, or pass `--yes`. `--no-install` stops after the scaffold and
+ * prints them instead.
  */
 import { existsSync, mkdirSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { addFeature, formatAddResult } from "./add.js";
+import { formatCommand, } from "../registry-items.js";
 /** A package name and product slug derived from the directory name. */
 export function deriveNames(target) {
     const base = path.basename(path.resolve(target));
@@ -23,13 +30,20 @@ export function deriveNames(target) {
     }
     return { appName: slug, appSlug: slug };
 }
-export function createApp(options) {
-    const target = path.resolve(options.target);
-    if (existsSync(target) && readdirSync(target).length > 0) {
-        // Scaffolding into an occupied directory is how people lose work.
-        throw new Error(`${target} is not empty. Create the app in a new directory, or use ` +
+export function isOccupied(target) {
+    const dir = path.resolve(target);
+    return existsSync(dir) && readdirSync(dir).length > 0;
+}
+/** Scaffolding into an occupied directory is how people lose work. */
+export function assertNotOccupied(target) {
+    if (isOccupied(target)) {
+        throw new Error(`${path.resolve(target)} is not empty. Create the app in a new directory, or use ` +
             `\`intelligo add app-scaffold\` inside an existing one.`);
     }
+}
+export function createApp(options) {
+    const target = path.resolve(options.target);
+    assertNotOccupied(target);
     mkdirSync(target, { recursive: true });
     const { appName, appSlug } = deriveNames(target);
     return addFeature("app-scaffold", {
@@ -45,15 +59,33 @@ export function createApp(options) {
         },
     });
 }
-export function formatCreateResult(target, r) {
+/** A path the reader can paste into a shell, spaces and quotes included. */
+function shellQuote(value) {
+    return /^[\w@%+=:,./-]+$/.test(value)
+        ? value
+        : `'${value.replace(/'/g, "'\\''")}'`;
+}
+export function formatNextSteps(target, next) {
+    const pm = next.packageManager;
+    return [
+        `cd ${shellQuote(path.relative(process.cwd(), path.resolve(target)) || ".")}`,
+        "cp .env.example .env.local   # then fill it in",
+        ...(next.pending?.length
+            ? next.pending.map(formatCommand)
+            : next.installed
+                ? []
+                : [`${pm} install`]),
+        `${pm === "npm" ? "npm run" : pm} dev`,
+    ].join("\n");
+}
+export function formatCreateResult(target, r, next = { packageManager: "pnpm", installed: false }) {
     return [
         formatAddResult(r),
         "",
         "Next:",
-        `  cd ${path.relative(process.cwd(), path.resolve(target)) || "."}`,
-        "  cp .env.example .env.local   # then fill it in",
-        "  pnpm install",
-        "  pnpm dev",
+        ...formatNextSteps(target, next)
+            .split("\n")
+            .map((line) => `  ${line}`),
         "",
         "`intelligo doctor` will tell you what is still missing.",
     ].join("\n");

package/dist/commands/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAkB,MAAM,UAAU,CAAC;AAiBvE,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,MAAc;IAIxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,kEAAkE;QAClE,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,2DAA2D;YAClE,wDAAwD,CAC3D,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEjD,OAAO,UAAU,CAAC,cAAc,EAAE;QAChC,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,SAAS,EAAE;YACT,YAAY,EAAE,OAAO;YACrB,YAAY,EAAE,OAAO;YACrB,iBAAiB,EAAE,OAAO,CAAC,aAAa;gBACtC,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,IAAI,OAAO,CAAC,gBAAgB,EAAE;SACnC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,CAAY;IAC7D,OAAO;QACL,eAAe,CAAC,CAAC,CAAC;QAClB,EAAE;QACF,OAAO;QACP,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,EAAE;QACnE,kDAAkD;QAClD,gBAAgB;QAChB,YAAY;QACZ,EAAE;QACF,yDAAyD;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAkB,MAAM,UAAU,CAAC;AACvE,OAAO,EACL,aAAa,GAGd,MAAM,sBAAsB,CAAC;AAgB9B,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,MAAc;IAIxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,2DAA2D;YAChF,wDAAwD,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEjD,OAAO,UAAU,CAAC,cAAc,EAAE;QAChC,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,SAAS,EAAE;YACT,YAAY,EAAE,OAAO;YACrB,YAAY,EAAE,OAAO;YACrB,iBAAiB,EAAE,OAAO,CAAC,aAAa;gBACtC,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,IAAI,OAAO,CAAC,gBAAgB,EAAE;SACnC;KACF,CAAC,CAAC;AACL,CAAC;AAUD,4EAA4E;AAC5E,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QACnC,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAe;IAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC;IAC/B,OAAO;QACL,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE;QAC7E,gDAAgD;QAChD,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM;YACtB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,SAAS;gBACd,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACxB,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,CAAY,EACZ,OAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE;IAE9D,OAAO;QACL,eAAe,CAAC,CAAC,CAAC;QAClB,EAAE;QACF,OAAO;QACP,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC;aAC7B,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7B,EAAE;QACF,yDAAyD;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/commands/doctor.d.ts

@@ -1,18 +1,28 @@
 /**
  * `intelligo doctor` — report the problems that are invisible until
  * they are an incident.
- *
- * The checks here were each chosen because something in this codebase
- * actually went wrong that way, not because they sounded thorough.
  */
 export type CheckResult = {
     name: string;
     status: "ok" | "warn" | "error";
     detail: string;
 };
+type ItemRequires = {
+    marker: string;
+    items?: string[];
+    files?: string[];
+    exports?: Record<string, string[]>;
+    features?: string[];
+};
+export type RegistryRequires = {
+    scaffold: string[];
+    items: Record<string, ItemRequires>;
+};
 export type DoctorOptions = {
     /** Workspace root; defaults to the current working directory. */
     root?: string;
+    /** Registry requirements; defaults to the copy bundled with the CLI. */
+    requires?: RegistryRequires | null;
     /** Environment to validate; defaults to process.env. */
     env?: NodeJS.ProcessEnv;
 };
@@ -20,4 +30,5 @@ export declare function runChecks(options?: DoctorOptions): CheckResult[];
 export declare function formatResults(results: CheckResult[]): string;
 /** Process exit code: non-zero when any check errored. */
 export declare function exitCodeFor(results: CheckResult[]): number;
+export {};
 //# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AASF,wBAAgB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,WAAW,EAAE,CAkHpE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAK5D;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAE1D"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrC,CAAC;AAiCF,MAAM,MAAM,aAAa,GAAG;IAC1B,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AAyLF,wBAAgB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,WAAW,EAAE,CAmNpE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAK5D;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAE1D"}