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

package/dist/registry-items.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intelligo-dev/cli",
-  "version": "1.0.0-beta.13",
+  "version": "1.0.0-beta.14",
   "description": "The Intelligo CLI: scaffold an AI SaaS app, generate owned source, and check its migrations and upgrades.",
   "keywords": [
     "intelligo",

package/src/bin.ts

@@ -35,6 +35,15 @@ import {
   applyMigrations,
   formatApplyResult,
 } from "./commands/migrate.js";
+import {
+  formatSyncReport,
+  installedFrameworkVersion,
+  selectItems,
+  syncApply,
+  syncCheck,
+  syncCheckExitCode,
+  type SyncContext,
+} from "./commands/sync.js";
 import {
   formatUpgradeReport,
   upgradeCheck,
@@ -42,6 +51,8 @@ import {
 } from "./commands/upgrade-check.js";
 
 import { loadAppEnv } from "./env-files.js";
+import { resolveRegistryDir } from "./registry-bundle.js";
+import { readRegistryCatalogue } from "./registry-items.js";
 import { MIGRATION_LOCATIONS, resolveMigrationsDir } from "./migrations-dir.js";
 
 /**
@@ -82,6 +93,9 @@ function usage(): string {
     "                    fresh | ahead | unmanaged | legacy)",
     "  add <feature>     Generate consumer-owned source (--force to overwrite)",
     "  upgrade --check   Show what a template upgrade would change",
+    "  sync [items…]     Install registry pages from this release's registry,",
+    "                    keeping seams and merging messages (--force replaces",
+    "                    hand-edited files; --check only reports, exit 1 on drift)",
     "",
   ].join("\n");
 }
@@ -245,6 +259,44 @@ async function main(): Promise<number> {
       console.log(formatUpgradeReport(report));
       return upgradeCheckExitCode(report);
     }
+    case "sync": {
+      const registryDir = resolveRegistryDir(TEMPLATES_DIR);
+      if (!registryDir) {
+        console.error(
+          "This CLI has no bundled registry — in the framework repository, run `pnpm registry:build` first."
+        );
+        return 1;
+      }
+      const context: SyncContext = {
+        appRoot: process.cwd(),
+        registryDir,
+        requires: readRegistryCatalogue(TEMPLATES_DIR).requires,
+        frameworkVersion: FRAMEWORK_VERSION,
+      };
+      const installed = installedFrameworkVersion(context.appRoot);
+      if (installed && installed !== FRAMEWORK_VERSION) {
+        console.error(
+          `! @intelligo-dev/core is ${installed} but this CLI carries the ${FRAMEWORK_VERSION} registry — ` +
+            "run the CLI of the same version (`pnpm exec intelligo`), or pages and packages will disagree."
+        );
+      }
+      const selection = selectItems(
+        rest.filter((a) => !a.startsWith("-")),
+        context
+      );
+      if (!selection.ok) {
+        console.error(selection.message);
+        return 1;
+      }
+      if (rest.includes("--check")) {
+        const report = syncCheck(selection.items, context);
+        console.log(formatSyncReport(report));
+        return syncCheckExitCode(report);
+      }
+      return syncApply(selection.items, context, {
+        force: rest.includes("--force"),
+      });
+    }
     case "help":
       console.log(usage());
       return 0;

package/src/commands/add.ts

@@ -30,6 +30,8 @@ export type TemplateFeature = {
   deprecated?: string;
   files: TemplateFile[];
   cron?: TemplateCron;
+  /** What the developer still does by hand once the files are written. */
+  nextSteps?: string[];
 };
 export type TemplateCatalogue = Record<string, TemplateFeature>;
 
@@ -54,6 +56,8 @@ export type AddResult = {
    * app has a vercel.json without it, which is the consumer's to edit.
    */
   cron?: TemplateCron & { status: "written" | "present" | "manual" };
+  /** The catalogue's steps left to the developer, printed after the files. */
+  nextSteps?: string[];
 };
 
 export type AddOptions = {
@@ -137,9 +141,13 @@ export function addFeature(feature: string, options: AddOptions): AddResult {
     skippedUnknown: [],
   };
   if (spec.deprecated) result.deprecated = spec.deprecated;
+  if (spec.nextSteps?.length) result.nextSteps = spec.nextSteps;
   const recorded: GeneratedFile[] = [];
+  const handedOver = new Set(previous?.handedOver ?? []);
 
   for (const file of spec.files) {
+    // A registry item replaced it; `intelligo sync` keeps it now.
+    if (handedOver.has(file.target)) continue;
     const source = path.join(options.templatesDir, file.template);
     const target = path.join(options.appRoot, file.target);
     const contents = substitute(
@@ -212,6 +220,9 @@ export function formatAddResult(r: AddResult): string {
   )
     lines.push("  nothing to do");
   if (r.cron) lines.push(...cronNextSteps(r.cron));
+  if (r.nextSteps?.length) {
+    lines.push("", "  Next:", ...r.nextSteps.map((step) => `  - ${step}`));
+  }
   return lines.join("\n");
 }
 

package/src/commands/create-flow.ts

@@ -1,7 +1,10 @@
 /**
  * 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.
+ * has approved the commands that do it. The items go in through
+ * `intelligo sync` — one `shadcn add` per item from the registry this
+ * CLI carries, recorded in the manifest — exactly as a later sync
+ * would put them back.
  *
  * Nothing runs on the developer's machine without their say-so. In a
  * terminal the commands are shown and confirmed; without one (CI, a
@@ -21,15 +24,18 @@ import {
   formatNextSteps,
   isOccupied,
 } from "./create.js";
+import { syncApply, type SyncContext } from "./sync.js";
+import { resolveRegistryDir } from "../registry-bundle.js";
 import {
   detectPackageManager,
+  findWorkspaceRoot,
   formatCommand,
-  hasLocalShadcn,
   installPlan,
   readRegistryCatalogue,
   shortDescription,
   withDependencies,
   type Command,
+  type InstallPlan,
 } from "../registry-items.js";
 
 export type CreateFlags = {
@@ -97,6 +103,47 @@ function run(c: Command, cwd: string): boolean {
   return result.status === 0;
 }
 
+/**
+ * Run the plan: the dependency install, then the sync. Returns the
+ * commands still to run by hand — none when both succeeded.
+ */
+async function installPages(
+  plan: InstallPlan,
+  options: {
+    appRoot: string;
+    interactive: boolean;
+    show: (c: Command) => string;
+    syncContext: SyncContext;
+  }
+): Promise<Command[]> {
+  const { appRoot, interactive, show } = options;
+  const say = (line: string) =>
+    interactive ? p.log.step(line) : console.log(line);
+  const fail = (message: string) =>
+    interactive ? p.log.error(message) : console.error(message);
+  if (plan.install) {
+    say(`› ${show(plan.install)}`);
+    if (!run(plan.install, plan.install.cwd ?? appRoot)) {
+      fail(
+        `\`${show(plan.install)}\` failed — the scaffold is in place; run the rest by hand.`
+      );
+      return [plan.install, plan.sync];
+    }
+  }
+  say(`› ${show(plan.sync)}`);
+  const code = await syncApply(plan.items, options.syncContext, {
+    force: true,
+    log: say,
+  });
+  if (code !== 0) {
+    fail(
+      "The pages did not all install — the scaffold is in place; re-run the sync by hand."
+    );
+    return [plan.sync];
+  }
+  return [];
+}
+
 export async function runCreate(
   flags: CreateFlags,
   context: {
@@ -178,14 +225,24 @@ export async function runCreate(
   }
 
   // 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 workspaceRoot = findWorkspaceRoot(appRoot);
+  const plan = installPlan(items, { appRoot, packageManager, workspaceRoot });
+  const commands: Command[] = plan
+    ? [...(plan.install ? [plan.install] : []), plan.sync]
+    : [];
+  const show = (c: Command) => formatCommand(c, appRoot);
+  const registryDir = resolveRegistryDir(context.templatesDir);
+  if (plan && flags.install && !registryDir) {
+    console.error(
+      "This CLI has no bundled registry to install pages from — in the framework repository, run `pnpm registry:build` first."
+    );
+  }
+  let approved = plan !== null && flags.install && flags.yes && !!registryDir;
+  if (plan && flags.install && registryDir && !flags.yes && interactive) {
+    p.note(commands.map(show).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)?`
+      message: plan.install
+        ? `shadcn is not installed yet — install the dependencies (shadcn included) with ${plan.install.command}${workspaceRoot ? " from the workspace root" : ""} and add ${items.length} page(s)?`
         : `Add ${items.length} page(s) with shadcn?`,
     });
     if (bail(answer, `The scaffold is in ${target}; nothing was installed.`))
@@ -193,27 +250,26 @@ export async function runCreate(
     approved = answer;
   }
 
-  let pending: Command[] = [];
-  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 pending =
+    approved && plan && registryDir
+      ? await installPages(plan, {
+          appRoot,
+          interactive,
+          show,
+          syncContext: {
+            appRoot,
+            registryDir,
+            requires: catalogue.requires,
+            frameworkVersion: context.frameworkVersion,
+          },
+        })
+      : commands;
 
   const next = {
-    packageManager,
+    packageManager: workspaceRoot ? ("pnpm" as const) : packageManager,
     installed: approved && pending.length === 0,
     pending,
+    workspaceRoot,
   };
   if (interactive) {
     p.note(formatNextSteps(target, next), "Next");

package/src/commands/create.ts

@@ -9,10 +9,12 @@
  *
  * 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.
+ * without asking). The pages are installed by `intelligo sync` — one
+ * `shadcn add` per item, from the registry this CLI carries — after the
+ * dependencies (from the root of a parent pnpm workspace when the app is
+ * a member of one), 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";
@@ -98,6 +100,8 @@ export type NextSteps = {
   installed: boolean;
   /** Install commands the developer declined, or that did not get to run. */
   pending?: Command[];
+  /** The parent pnpm workspace the app is a member of, installed from its root. */
+  workspaceRoot?: string | null;
 };
 
 /** A path the reader can paste into a shell, spaces and quotes included. */
@@ -109,14 +113,20 @@ function shellQuote(value: string): string {
 
 export function formatNextSteps(target: string, next: NextSteps): string {
   const pm = next.packageManager;
+  const appRoot = path.resolve(target);
+  const install: Command = {
+    command: pm,
+    args: ["install"],
+    cwd: next.workspaceRoot ?? appRoot,
+  };
   return [
-    `cd ${shellQuote(path.relative(process.cwd(), path.resolve(target)) || ".")}`,
+    `cd ${shellQuote(path.relative(process.cwd(), appRoot) || ".")}`,
     "cp .env.example .env.local   # then fill it in",
     ...(next.pending?.length
-      ? next.pending.map(formatCommand)
+      ? next.pending.map((c) => formatCommand(c, appRoot))
       : next.installed
         ? []
-        : [`${pm} install`]),
+        : [formatCommand(install, appRoot)]),
     `${pm === "npm" ? "npm run" : pm} dev`,
   ].join("\n");
 }

package/src/commands/doctor.ts

@@ -10,6 +10,12 @@ import { parseEnv } from "node:util";
 
 import { inspectMigrationChain, readMigrationChain } from "../migrations.js";
 import { readManifest } from "../manifest.js";
+import {
+  checkExports,
+  hasObjectKey,
+  reexportedSource,
+  stripComments,
+} from "../module-exports.js";
 import {
   MODEL_CATALOGUE_LOCATIONS,
   readCatalogueModelIds,
@@ -38,17 +44,6 @@ export type RegistryRequires = {
   items: Record<string, ItemRequires>;
 };
 
-/**
- * Block and line comments removed, so a check cannot be satisfied — or
- * defeated — by prose. The composition root's own doc comment names
- * `registerModels` in several of the templates.
- */
-function stripComments(text: string): string {
-  return text
-    .replace(/\/\*[\s\S]*?\*\//g, "")
-    .replace(/(^|[^:])\/\/.*$/gm, "$1");
-}
-
 /**
  * templates/registry-requires.json is a build-time copy of
  * packages/registry/requires.json (scripts/sync-registry-requires.mjs),
@@ -328,13 +323,17 @@ export function runChecks(options: DoctorOptions = {}): CheckResult[] {
       [".ts", ".tsx", ".js", ".jsx", ".json", ""].some((ext) =>
         existsSync(path.join(root, rel + ext))
       );
-    const plansSource = existsSync(path.join(root, "lib/plans.ts"))
-      ? readFileSync(path.join(root, "lib/plans.ts"), "utf8")
-      : null;
+    // lib/plans.ts and whatever it re-exports — a catalogue defined in
+    // a workspace package counts — comments stripped.
+    const plansFile = ["lib/plans.ts", "lib/plans.tsx"]
+      .map((rel) => path.join(root, rel))
+      .find((file) => existsSync(file));
+    const plans = plansFile ? reexportedSource(plansFile, root) : null;
 
     for (const [name, item] of Object.entries(requires.items)) {
       if (!existsSync(path.join(root, item.marker))) continue;
       const problems: string[] = [];
+      const notes: string[] = [];
 
       for (const dep of item.items ?? []) {
         const marker = requires.items[dep]?.marker;
@@ -350,23 +349,22 @@ export function runChecks(options: DoctorOptions = {}): CheckResult[] {
           .map((ext) => path.join(root, file + ext))
           .find((p) => existsSync(p));
         if (!abs) continue; // reported above as a missing file
-        const source = readFileSync(abs, "utf8");
-        const missing = names.filter(
-          (n) =>
-            !new RegExp(
-              `export\\s+(?:default\\s+)?(?:async\\s+)?(?:const|function\\*?|let|var|class)\\s+${n}\\b`
-            ).test(source) &&
-            !new RegExp(`export\\s*\\{[^}]*\\b${n}\\b`).test(source)
-        );
+        const { missing, unresolved } = checkExports(abs, names, root);
         if (missing.length) {
           problems.push(`${file} must export ${missing.join(", ")}`);
+        } else if (unresolved.length) {
+          notes.push(
+            `${file}: could not read ${unresolved.map((u) => `\`export * from "${u}"\``).join(", ")} — assumed to provide ${names.join(", ")}`
+          );
         }
       }
       for (const feature of item.features ?? []) {
-        if (
-          plansSource !== null &&
-          !new RegExp(`\\b${feature}\\b\\s*:`).test(plansSource)
-        ) {
+        if (!plans || hasObjectKey(plans.text, feature)) continue;
+        if (plans.unresolved.length) {
+          notes.push(
+            `the "${feature}" feature key is not in lib/plans.ts, and ${plans.unresolved.join(", ")} could not be read to confirm it`
+          );
+        } else {
           problems.push(
             `register the "${feature}" feature key in lib/plans.ts — an unregistered key is denied (403)`
           );
@@ -375,7 +373,9 @@ export function runChecks(options: DoctorOptions = {}): CheckResult[] {
 
       results.push(
         problems.length === 0
-          ? { name: `item:${name}`, status: "ok", detail: "requirements met" }
+          ? notes.length === 0
+            ? { name: `item:${name}`, status: "ok", detail: "requirements met" }
+            : { name: `item:${name}`, status: "warn", detail: notes.join("; ") }
           : {
               name: `item:${name}`,
               status: "error",

package/src/commands/migrate-check.ts

@@ -37,7 +37,7 @@
  *                    `migrate` can take it over.
  *
  * Beside `state` it carries `exitCode`, `chain`, `applied`, `pending`,
- * `unknown`, `legacy` and `adoptable`.
+ * `unknown`, `legacy`, `legacyMissing` and `adoptable`.
  */
 
 import { createHash } from "node:crypto";
@@ -64,6 +64,11 @@ export type MigrateCheckResult = {
   legacy: string[];
   /** Length of the pre-1.0 chain (0 when this checkout ships none). */
   legacyChainLength: number;
+  /**
+   * Pre-1.0 migrations the database has not run, by tag, in chain
+   * order — empty unless it ran some of them.
+   */
+  legacyMissing: string[];
   /**
    * The database ran the whole pre-1.0 chain and not the baseline:
    * `migrate` records the baseline as applied without running it.
@@ -74,11 +79,11 @@ export type MigrateCheckResult = {
 /** The pre-1.0 chain's tags and hashes, if this checkout ships them. */
 export function readLegacyChain(
   migrationsDir: string
-): Array<{ tag: string; hash: string }> {
+): Array<{ tag: string; hash: string; alternates?: string[] }> {
   const file = path.join(migrationsDir, "legacy-chain.json");
   if (!existsSync(file)) return [];
   const parsed = JSON.parse(readFileSync(file, "utf8")) as {
-    entries?: Array<{ tag: string; hash: string }>;
+    entries?: Array<{ tag: string; hash: string; alternates?: string[] }>;
   };
   return parsed.entries ?? [];
 }
@@ -118,7 +123,13 @@ export async function migrateCheck(
   }
 
   const legacyChain = readLegacyChain(migrationsDir);
-  const legacyByHash = new Map(legacyChain.map((e) => [e.hash, e.tag]));
+  // A migration can be recorded under more than one hash: npm's
+  // 1.0.0-beta.6 shipped different bytes for three of them.
+  const legacyByHash = new Map(
+    legacyChain.flatMap((e) =>
+      [e.hash, ...(e.alternates ?? [])].map((h) => [h, e.tag] as const)
+    )
+  );
 
   const appliedHashes = new Set(rows.map((r) => r.hash));
   const applied: string[] = [];
@@ -144,6 +155,10 @@ export async function migrateCheck(
     unmanaged: tableMissing || appliedHashes.size === 0,
     legacy,
     legacyChainLength: legacyChain.length,
+    legacyMissing:
+      legacy.length > 0
+        ? legacyChain.map((e) => e.tag).filter((t) => !legacy.includes(t))
+        : [],
     adoptable:
       legacyChain.length > 0 &&
       legacy.length === legacyChain.length &&
@@ -185,12 +200,8 @@ export function formatMigrateCheck(
         `already there), then applies what follows. Tables the old chain ` +
         `created that the framework no longer owns are left untouched.`
     );
-  } else if (r.legacy.length > 0 && r.legacy.length < r.legacyChainLength) {
-    lines.push(
-      `✗ This database ran ${r.legacy.length} of the ${r.legacyChainLength} ` +
-        `pre-1.0 migrations. Finish that chain with @intelligo-dev/core ` +
-        `1.0.0-beta.7 (\`intelligo migrate\`) before upgrading.`
-    );
+  } else if (isPartialLegacy(r)) {
+    lines.push(`✗ ${partialLegacyMessage(r)}`);
   }
 
   if (r.unknown.length > 0) {
@@ -221,6 +232,35 @@ export function isPartialLegacy(r: MigrateCheckResult): boolean {
   return r.legacy.length > 0 && r.legacy.length < r.legacyChainLength;
 }
 
+/**
+ * The last pre-1.0 migration any published `@intelligo-dev/core`
+ * carries: 1.0.0-beta.6 shipped the chain through it, and the versions
+ * that carried the rest were never published.
+ */
+export const LAST_PUBLISHED_LEGACY_TAG = "0042_sessions_active_organization_id";
+
+/**
+ * Why a partial pre-1.0 chain is refused and where the way forward is
+ * written down. No published version finishes the chain, so the
+ * message names what is missing and points at the README's options
+ * instead of at a version to install.
+ */
+export function partialLegacyMessage(r: MigrateCheckResult): string {
+  const shown = r.legacyMissing.slice(0, 6);
+  const more = r.legacyMissing.length - shown.length;
+  return (
+    `This database ran ${r.legacy.length} of the ${r.legacyChainLength} ` +
+    `pre-1.0 migrations; it has not run ${shown.join(", ")}` +
+    `${more > 0 ? ` and ${more} more` : ""}. No published ` +
+    `@intelligo-dev/core finishes that chain: 1.0.0-beta.6 ships it ` +
+    `through ${LAST_PUBLISHED_LEGACY_TAG}, and the versions that carried ` +
+    `the rest never reached npm. Apply the missing migrations' SQL from ` +
+    `your own copy of it, or bring the schema to the baseline and record ` +
+    `it as applied — see "Databases from before 1.0" in README.md in ` +
+    `@intelligo-dev/core's src/db/migrations.`
+  );
+}
+
 export type MigrateState =
   "up_to_date" | "pending" | "fresh" | "ahead" | "unmanaged" | "legacy";
 
@@ -252,6 +292,7 @@ export function formatMigrateCheckJson(
     pending: r.pending,
     unknown: r.unknown,
     legacy: r.legacy,
+    legacyMissing: r.legacyMissing,
     adoptable: r.adoptable,
   });
 }

package/src/commands/migrate.ts

@@ -34,6 +34,7 @@ import {
   hashMigration,
   isPartialLegacy,
   migrateCheck,
+  partialLegacyMessage,
   type MigrateCheckResult,
 } from "./migrate-check.js";
 
@@ -68,14 +69,7 @@ export function decideApply(
   }
 
   if (isPartialLegacy(check)) {
-    return {
-      action: "refuse",
-      reason:
-        `This database ran ${check.legacy.length} of the ` +
-        `${check.legacyChainLength} pre-1.0 migrations. Finish that chain ` +
-        `with @intelligo-dev/core 1.0.0-beta.7 (\`intelligo migrate\`) ` +
-        `before upgrading.`,
-    };
+    return { action: "refuse", reason: partialLegacyMessage(check) };
   }
 
   if (check.adoptable) {