@bobbykim/manguito-cms-cli 0.6.2 → 0.7.0

package/dist/index.js

@@ -43958,6 +43958,16 @@ function loadEnvFile(filePath) {
   config2({ path: filePath });
 }
 
+// src/utils/project-version-model.ts
+init_esm_shims();
+function loadProjectVersionModel(schema, registry2) {
+  const snapshots = loadVersionSnapshots(schema, registry2);
+  if (!snapshots.ok) return snapshots;
+  const model = computeVersionModel({ current: registry2, snapshots: snapshots.value });
+  if (!model.ok) return model;
+  return { ok: true, value: { snapshots: snapshots.value, model: model.value } };
+}
+
 // src/commands/build.ts
 function registerBuild(program2) {
   program2.command("build").description("Run codegen and compile project to dist/").option("--env <path>", "path to .env file to load").action(async (options) => {
@@ -44018,6 +44028,11 @@ async function runBuild(options, deps) {
     parsedRoutesDef,
     parsedRoles
   );
+  const versions = loadProjectVersionModel(resolveSchemaConfig(cwd, config3), registry2);
+  if (!versions.ok) {
+    printValidationErrors(versions.errors, "Version model errors", "manguito build");
+    process.exit(1);
+  }
   printSuccess("Config loaded");
   const contentCount = parsedSchemas.filter((s) => s.schema_type === "content-type").length;
   const paragraphCount = parsedSchemas.filter((s) => s.schema_type === "paragraph-type").length;
@@ -44033,19 +44048,8 @@ async function runBuild(options, deps) {
   await generateSchemaRegistry(registry2, generatedDir);
   await generateRoutes2(registry2, generatedDir);
   await generateForms(registry2, join9(generatedDir, "forms"));
-  const schema = resolveSchemaConfig(cwd, config3);
-  const snapshots = loadVersionSnapshots(schema, registry2);
-  if (!snapshots.ok) {
-    printValidationErrors(snapshots.errors, "Snapshot errors", "manguito build");
-    process.exit(1);
-  }
-  const versionModel = computeVersionModel({ current: registry2, snapshots: snapshots.value });
-  if (!versionModel.ok) {
-    printValidationErrors(versionModel.errors, "Version model errors", "manguito build");
-    process.exit(1);
-  }
-  await generateVersionModel(versionModel.value, generatedDir);
-  printSuccess(`Version model baked (live: ${versionModel.value.live.join(", ")})`);
+  await generateVersionModel(versions.value.model, generatedDir);
+  printSuccess(`Version model baked (live: ${versions.value.model.live.join(", ")})`);
   const programmaticDir = resolve4(cwd, config3.programmatic.dir);
   const resolverFiles = existsSync3(programmaticDir) ? walkFiles(programmaticDir).filter((f) => /\.(ts|mjs|js)$/.test(f)) : [];
   await generateProgrammaticRegistry(resolverFiles, generatedDir);
@@ -50741,18 +50745,12 @@ async function runDev(options, deps) {
   await generateRoutes2(registry2, manguitoDir);
   await generateForms(registry2, join13(manguitoDir, "forms"));
   await generateNav(registry2, manguitoDir);
-  const schemaConfig = resolveSchemaConfig(cwd, config3);
-  const snapshotsResult = loadVersionSnapshots(schemaConfig, registry2);
-  if (!snapshotsResult.ok) {
-    printValidationErrors(snapshotsResult.errors, "Version snapshot errors", "manguito version:diff");
-    process.exit(1);
-  }
-  const versionModelResult = computeVersionModel({ current: registry2, snapshots: snapshotsResult.value });
-  if (!versionModelResult.ok) {
-    printValidationErrors(versionModelResult.errors, "Version model errors", "manguito version:diff");
+  const versionsResult = loadProjectVersionModel(resolveSchemaConfig(cwd, config3), registry2);
+  if (!versionsResult.ok) {
+    printValidationErrors(versionsResult.errors, "Version model errors", "manguito validate");
     process.exit(1);
   }
-  const versionModel = reduceVersionModel(versionModelResult.value);
+  const versionModel = reduceVersionModel(versionsResult.value.model);
   const resolverMap = await loadProgrammaticResolvers(cwd, config3.programmatic.dir);
   const adapter = createCmsApp({
     name: config3.name,
@@ -50891,20 +50889,13 @@ async function onSchemaFileChange(args) {
   await generateRoutes2(registry2, manguitoDir);
   await generateForms(registry2, join13(manguitoDir, "forms"));
   await generateNav(registry2, manguitoDir);
-  const schemaConfig = resolveSchemaConfig(cwd, config3);
-  const snapshotsResult = loadVersionSnapshots(schemaConfig, registry2);
-  if (!snapshotsResult.ok) {
-    printValidationErrors(snapshotsResult.errors, "Version snapshot errors", "manguito version:diff");
+  const versionsResult = loadProjectVersionModel(resolveSchemaConfig(cwd, config3), registry2);
+  if (!versionsResult.ok) {
+    printValidationErrors(versionsResult.errors, "Version model errors", "manguito validate");
     process.stderr.write("\u26A0 Changes not applied.\n");
     return;
   }
-  const versionModelResult = computeVersionModel({ current: registry2, snapshots: snapshotsResult.value });
-  if (!versionModelResult.ok) {
-    printValidationErrors(versionModelResult.errors, "Version model errors", "manguito version:diff");
-    process.stderr.write("\u26A0 Changes not applied.\n");
-    return;
-  }
-  const versionModel = reduceVersionModel(versionModelResult.value);
+  const versionModel = reduceVersionModel(versionsResult.value.model);
   try {
     await runDevMigration(drizzleConfigPath);
   } catch (err) {
@@ -51362,10 +51353,16 @@ async function runValidate(options, deps) {
       parsedRoutesDef = routesParseResult.value;
     }
   }
+  let liveVersions = null;
   if (allErrors.length === 0 && parsedRoles !== null && parsedRoutesDef !== null) {
     const registry2 = buildSchemaRegistry(parsedSchemas, parsedRoutesDef, parsedRoles);
     const crossRefErrors = validateCrossReferences(registry2, config3.api.media?.max_file_size);
     allErrors.push(...crossRefErrors);
+    if (crossRefErrors.length === 0) {
+      const versions = loadProjectVersionModel(resolveSchemaConfig(cwd, config3), registry2);
+      if (versions.ok) liveVersions = versions.value.model.live;
+      else allErrors.push(...versions.errors);
+    }
   }
   if (allErrors.length > 0) {
     printValidationErrors(allErrors, "Validation errors", "manguito validate");
@@ -51380,6 +51377,7 @@ async function runValidate(options, deps) {
   );
   printSuccess("roles.json valid");
   printSuccess("routes.json valid");
+  if (liveVersions !== null) printSuccess(`Versions valid (live: ${liveVersions.join(", ")})`);
   process.stdout.write("\nNo errors found.\n");
 }
 
@@ -51693,7 +51691,7 @@ function formatField(change) {
   }
 }
 function formatSchemaChange(change) {
-  const header = change.from === null ? `Working schema \u2014 nothing has been cut yet, so ${change.to} would be the first version` : `Working schema vs ${change.from} (highest snapshot) \u2014 would become ${change.to}`;
+  const header = change.from === null ? `Working schema \u2014 nothing has been created yet, so ${change.to} would be the first version` : `Working schema vs ${change.from} (highest snapshot) \u2014 would become ${change.to}`;
   if (change.identical) {
     return `${header}
 
@@ -51707,6 +51705,38 @@ No column added, renamed, tombstoned or restored.`;
   });
   return [header, "", ...blocks].join("\n");
 }
+function driftSummary(change) {
+  const counts = { renamed: 0, tombstoned: 0, added: 0, restored: 0 };
+  for (const type of change.types) {
+    for (const field of type.fields) counts[field.kind]++;
+  }
+  const parts = [];
+  if (counts.renamed > 0) parts.push(`${counts.renamed} renamed`);
+  if (counts.tombstoned > 0) parts.push(`${counts.tombstoned} removed`);
+  if (counts.added > 0) parts.push(`${counts.added} added`);
+  if (counts.restored > 0) parts.push(`${counts.restored} restored`);
+  if (parts.length > 0) return `${parts.join(", ")} since`;
+  if (change.identical) return "identical to current";
+  const newTypes = change.types.filter((t) => t.status === "added").length;
+  return `${newTypes} new type${newTypes === 1 ? "" : "s"} since`;
+}
+function formatVersionList(input2) {
+  const { prefix, current, older } = input2;
+  if (older.length === 0) {
+    return `No versions created yet. Your working schema is ${current}, served at ${prefix}/${current} and ${prefix}.
+Run \`manguito version:create\` before making a breaking change.`;
+  }
+  const rows = [
+    ...older.map((o) => [o.version, `${prefix}/${o.version}`, driftSummary(o.change)]),
+    [current, `${prefix}/${current}`, `current \u2014 also ${prefix}`]
+  ];
+  const nameWidth = Math.max(...rows.map((r) => r[0].length));
+  const pathWidth = Math.max(...rows.map((r) => r[1].length));
+  return [
+    `Live versions (${rows.length}):`,
+    ...rows.map(([name, url2, note]) => `  ${name.padEnd(nameWidth)}  ${url2.padEnd(pathWidth)}  ${note}`)
+  ].join("\n");
+}
 
 // src/commands/version-fs.ts
 init_esm_shims();
@@ -51764,17 +51794,19 @@ async function loadVersionContext(options, deps, command) {
   const config3 = await resolveConfig(deps.cwd);
   const schema = resolveSchemaConfig(deps.cwd, config3);
   const registry2 = loadWorkingRegistry(deps.cwd, config3, command);
-  const snapshots = loadVersionSnapshots(schema, registry2);
-  if (!snapshots.ok) {
-    printValidationErrors(snapshots.errors, "Snapshot errors", command);
+  const versions = loadProjectVersionModel(schema, registry2);
+  if (!versions.ok) {
+    printValidationErrors(versions.errors, "Version model errors", command);
     process.exit(1);
   }
-  const model = computeVersionModel({ current: registry2, snapshots: snapshots.value });
-  if (!model.ok) {
-    printValidationErrors(model.errors, "Version model errors", command);
-    process.exit(1);
-  }
-  return { schema, registry: registry2, snapshots: snapshots.value, model: model.value };
+  return {
+    schema,
+    registry: registry2,
+    snapshots: versions.value.snapshots,
+    model: versions.value.model,
+    // Same default `dev` uses: the prefix the served routes actually carry.
+    apiPrefix: config3.api.prefix ?? "/api"
+  };
 }
 function orphanedTombstoneErrors(input2) {
   const remaining = input2.snapshots.filter((s) => s.version !== input2.retiring);
@@ -51782,14 +51814,22 @@ function orphanedTombstoneErrors(input2) {
   if (model.ok) return [];
   return model.errors.filter((e) => e.code === "ORPHANED_TOMBSTONE");
 }
+var VERSION_CUT_DEPRECATION = "`version:cut` is deprecated \u2014 use `version:create`. It will be removed in a future release.\n";
 function registerVersion(program2) {
-  program2.command("version:diff").description("Show what cutting a new version would freeze").option("--env <path>", "path to .env file to load").action(async (options) => {
+  program2.command("version:diff").description("Show what creating a new version would freeze").option("--env <path>", "path to .env file to load").action(async (options) => {
     await runVersionDiff(options, { cwd: process.cwd() });
   });
-  program2.command("version:cut").description("Freeze the working schema as a new version").option("--env <path>", "path to .env file to load").option("--yes", "skip the confirmation prompt").action(async (options) => {
-    await runVersionCut(options, { cwd: process.cwd(), prompt: createPromptAdapter() });
+  program2.command("version:create").description("Create a version: freeze the working schema so it keeps being served unchanged").option("--env <path>", "path to .env file to load").option("--yes", "skip the confirmation prompt").action(async (options) => {
+    await runVersionCreate(options, { cwd: process.cwd(), prompt: createPromptAdapter() });
   });
-  program2.command("version:retire <version>").description("Stop serving a cut version and delete its snapshot").option("--env <path>", "path to .env file to load").option("--yes", "skip the confirmation prompt").action(async (version3, options) => {
+  program2.command("version:list").description("List the versions being served and how far each is behind the working schema").option("--env <path>", "path to .env file to load").action(async (options) => {
+    await runVersionList(options, { cwd: process.cwd() });
+  });
+  program2.command("version:cut", { hidden: true }).option("--env <path>", "path to .env file to load").option("--yes", "skip the confirmation prompt").action(async (options) => {
+    process.stderr.write(VERSION_CUT_DEPRECATION);
+    await runVersionCreate(options, { cwd: process.cwd(), prompt: createPromptAdapter() });
+  });
+  program2.command("version:retire <version>").description("Stop serving a created version and delete its snapshot").option("--env <path>", "path to .env file to load").option("--yes", "skip the confirmation prompt").action(async (version3, options) => {
     await runVersionRetire(version3, options, { cwd: process.cwd(), prompt: createPromptAdapter() });
   });
 }
@@ -51805,15 +51845,15 @@ async function runVersionDiff(options, deps) {
   if (change.identical) {
     process.stdout.write(
       `
-Nothing to cut \u2014 no column was added, renamed, tombstoned or restored, so ${ctx.model.current} would expose the same contract.
+Nothing to create \u2014 no column was added, renamed, tombstoned or restored, so ${ctx.model.current} would expose the same contract.
 `
     );
     return;
   }
-  printSuccess(`Cutting now would create ${ctx.schema.base_path}/versions/${ctx.model.current}/`);
+  printSuccess(`Creating a version now would write ${ctx.schema.base_path}/versions/${ctx.model.current}/`);
 }
-async function runVersionCut(options, deps) {
-  const ctx = await loadVersionContext(options, deps, "manguito version:cut");
+async function runVersionCreate(options, deps) {
+  const ctx = await loadVersionContext(options, deps, "manguito version:create");
   const from = highestSnapshot(ctx.snapshots);
   const version3 = ctx.model.current;
   const change = describeSchemaChange({
@@ -51822,8 +51862,8 @@ async function runVersionCut(options, deps) {
   });
   if (change.identical) {
     printGuidedError(
-      `No column was added, renamed, tombstoned or restored since ${from?.version ?? "the last cut"} \u2014 cutting ${version3} would freeze an identical contract.`,
-      "Changes to paragraph, programmatic, many-to-many and enum definitions are not versioned and need no new version. A live version commits you to retaining every column it exposes, so cut only when a column actually changed \u2014 or run `manguito version:retire <version>` if you meant to shrink the live set."
+      `No column was added, renamed, tombstoned or restored since ${from?.version ?? "the working schema began"} \u2014 creating ${version3} would freeze an identical contract.`,
+      "Changes to paragraph, programmatic, many-to-many and enum definitions are not versioned and need no new version. A live version commits you to retaining every column it exposes, so create one only when a column actually changed \u2014 or run `manguito version:retire <version>` if you meant to shrink the live set."
     );
     process.exit(1);
   }
@@ -51832,22 +51872,32 @@ async function runVersionCut(options, deps) {
   if (fs6.existsSync(target)) {
     printGuidedError(
       `${target} already exists.`,
-      "A snapshot directory is never overwritten. Remove or rename it, then run version:cut again."
+      "A snapshot directory is never overwritten. Remove or rename it, then run version:create again."
     );
     process.exit(1);
   }
   process.stdout.write(`${formatSchemaChange(change)}
 
 `);
-  const live = [...ctx.model.live.filter((v2) => v2 !== version3), version3].join(" ");
+  const next = `v${Number.parseInt(version3.slice(1), 10) + 1}`;
+  const liveAfter = [...ctx.model.live.filter((v2) => v2 !== version3), version3, next];
+  if (from === null) {
+    const prefix = ctx.apiPrefix;
+    process.stdout.write(
+      `This creates ${version3} from your working schema. ${prefix}/${version3} keeps serving it
+unchanged; your working schema becomes ${next}, served at ${prefix}/${next} and ${prefix}.
+
+`
+    );
+  }
   process.stdout.write(
-    `After cutting, ${live} are live. Every column those versions expose must stay in the
-schema \u2014 as a live field or a tombstone \u2014 until you retire them.
+    `After creating ${version3}, these versions are live: ${liveAfter.join(" ")}. Every column they
+expose must stay in the schema \u2014 as a live field or a tombstone \u2014 until you retire them.
 
 `
   );
   if (options.yes !== true) {
-    const ok = await deps.prompt.confirm(`Freeze the working schema as ${version3}?`);
+    const ok = await deps.prompt.confirm(`Create ${version3} from the working schema?`);
     if (!ok) {
       process.stdout.write("Cancelled. Nothing was written.\n");
       return;
@@ -51862,8 +51912,19 @@ schema \u2014 as a live field or a tombstone \u2014 until you retire them.
     );
     process.exit(1);
   }
-  printSuccess(`Froze the working schema as ${version3} at ${target}`);
-  process.stdout.write(`Live: ${live}.  Working schema is now v${Number.parseInt(version3.slice(1), 10) + 1}.
+  printSuccess(`Created ${version3} at ${target}`);
+  process.stdout.write(`Live: ${liveAfter.join(" ")}.  Working schema is now ${next}.
+`);
+}
+async function runVersionList(options, deps) {
+  const ctx = await loadVersionContext(options, deps, "manguito version:list");
+  const current = ctx.model.current;
+  const versionNumber3 = (v2) => Number.parseInt(v2.slice(1), 10);
+  const older = [...ctx.snapshots].sort((a2, b2) => versionNumber3(a2.version) - versionNumber3(b2.version)).map((s) => ({
+    version: s.version,
+    change: describeSchemaChange({ from: s, to: { version: current, registry: ctx.registry } })
+  }));
+  process.stdout.write(`${formatVersionList({ prefix: ctx.apiPrefix, current, older })}
 `);
 }
 async function runVersionRetire(version3, options, deps) {
@@ -51875,8 +51936,8 @@ async function runVersionRetire(version3, options, deps) {
   if (!ctx.snapshots.some((s) => s.version === version3)) {
     const existing = ctx.snapshots.map((s) => s.version).join(", ");
     printGuidedError(
-      `${version3} is not a cut version.`,
-      existing === "" ? "No versions have been cut yet \u2014 run `manguito version:cut` first." : `Cut versions: ${existing}.`
+      `${version3} is not a created version.`,
+      existing === "" ? "No versions have been created yet \u2014 run `manguito version:create` first." : `Created versions: ${existing}.`
     );
     process.exit(1);
   }
@@ -51884,8 +51945,8 @@ async function runVersionRetire(version3, options, deps) {
   if (highest !== null && highest.version === version3) {
     const target = path6.join(ctx.schema.base_path, "versions", version3);
     printGuidedError(
-      `${version3} is the newest cut version and cannot be retired.`,
-      `The working schema is ${ctx.model.current} because ${version3} is the highest snapshot \u2014 retiring it would renumber the working schema back onto ${version3}, and anyone pinned to ${version3} would get a different contract. Cutting a version with a real contract change makes ${version3} retirable. If ${version3} was cut in error, delete ${target} by hand \u2014 safe only while nothing yet consumes ${version3}, since deleting the newest snapshot renumbers the working schema back onto it.`
+      `${version3} is the newest created version and cannot be retired.`,
+      `The working schema is ${ctx.model.current} because ${version3} is the highest snapshot \u2014 retiring it would renumber the working schema back onto ${version3}, and anyone pinned to ${version3} would get a different contract. Creating a newer version with a real contract change makes ${version3} retirable. If ${version3} was created in error, delete ${target} by hand \u2014 safe only while nothing yet consumes ${version3}, since deleting the newest snapshot renumbers the working schema back onto it.`
     );
     process.exit(1);
   }
@@ -51911,7 +51972,7 @@ longer exposed by any live version. You must then delete these fields:
 `);
     }
     process.stdout.write(
-      "Until you do, `manguito validate` will report ORPHANED_TOMBSTONE. Deleting them\nshrinks the union and lets the next migration DROP those columns.\n\n"
+      "Until you do, `manguito validate` and `manguito build` will fail. Deleting them\nshrinks the union and lets the next migration DROP those columns.\n\n"
     );
   }
   if (options.yes !== true) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobbykim/manguito-cms-cli",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "license": "MIT",
   "author": "Bobby Kim <bobby.sihun.kim@gmail.com>",
   "homepage": "https://github.com/bobbykim89/manguito-cms",
@@ -30,9 +30,9 @@
     "typescript": "^6.0.3",
     "vite": "^8.1.3",
     "@bobbykim/manguito-cms-admin": "0.4.3",
-    "@bobbykim/manguito-cms-core": "0.6.0",
     "@bobbykim/manguito-cms-api": "0.7.0",
-    "@bobbykim/manguito-cms-db": "0.1.6"
+    "@bobbykim/manguito-cms-db": "0.1.6",
+    "@bobbykim/manguito-cms-core": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",