@revturbine/cli 0.15.0 → 0.16.1

package/dist/cli.js

@@ -9705,6 +9705,36 @@ function fail(cls, message) {
   process.exit(cls);
 }
 
+// src/lib/pin-drift.ts
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pinOf(pkg, name) {
+  for (const field of ["devDependencies", "dependencies"]) {
+    const deps = pkg[field];
+    if (isRecord5(deps) && typeof deps[name] === "string") return deps[name];
+  }
+  return void 0;
+}
+var EXACT = /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/;
+function checkPinDrift(pkg) {
+  if (!isRecord5(pkg)) return [];
+  const warnings = [];
+  const cliPin = pinOf(pkg, "@revturbine/cli");
+  if (cliPin !== void 0 && !EXACT.test(cliPin)) {
+    warnings.push(
+      `@revturbine/cli is pinned "${cliPin}" \u2014 the repo-pinned CLI must be EXACT (e.g. "0.14.0"): delegation runs the repo's version, and a range makes the running CLI drift from the committed one.`
+    );
+  }
+  const sdkPin = pinOf(pkg, "@revturbine/sdk");
+  if (sdkPin !== void 0 && !sdkPin.startsWith("^")) {
+    warnings.push(
+      `@revturbine/sdk is pinned "${sdkPin}" \u2014 use a caret (e.g. "^${sdkPin.replace(/^[~>=\s]*/, "")}") so additive SDK releases flow in. (Note: on 0.x, ^ spans PATCH releases only.)`
+    );
+  }
+  return warnings;
+}
+
 // src/lib/selectors.ts
 var SelectorError = class extends Error {
   code = "STATE_REQUIRED";
@@ -9720,6 +9750,13 @@ function collectSelectors(opts, positionalFiles = []) {
   if (opts.release) found.push({ kind: "release", id: opts.release });
   return found;
 }
+function orderDiffSelectors(sels) {
+  if (sels.length !== 2) return sels;
+  const [first, second] = sels;
+  if (second.kind === "live" && first.kind !== "live") return [second, first];
+  if (first.kind === "file" && second.kind !== "file") return [second, first];
+  return sels;
+}
 function describeSelector(sel) {
   switch (sel.kind) {
     case "file":
@@ -10439,12 +10476,13 @@ program.command("validate").description("Validate a Config File offline (schema)
   }
   diag("\u2713 No blocking findings.");
 });
-program.command("diff").description("Compare two config versions (first \u2192 second). Dry-run, no writes.").argument("[file...]", "Local Config File path(s)").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(async (files, opts) => {
+program.command("diff").description("Compare two config versions (first \u2192 second; a file vs --draft/--live/--release previews the launch \u2014 the server side is the base). Dry-run, no writes.").argument("[file...]", "Local Config File path(s)").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(async (files, opts) => {
   const sels = requireSelectors(opts, files, { count: 2, allowed: ["file", "draft", "live", "release"], command: "diff" });
-  const needsServer = sels.some((s) => s.kind !== "file");
+  const ordered = orderDiffSelectors(sels);
+  const needsServer = ordered.some((s) => s.kind !== "file");
   const conn = needsServer ? connect(opts.url, opts.tenantId) : null;
-  const [a, b] = await Promise.all(sels.map((s) => loadVersion(conn, s)));
-  diag(`Diff (${sels.map((s) => s.kind === "file" ? s.path : s.kind === "release" ? `--release ${s.id}` : `--${s.kind}`).join(" \u2192 ")}):`);
+  const [a, b] = await Promise.all(ordered.map((s) => loadVersion(conn, s)));
+  diag(`Diff (${ordered.map((s) => s.kind === "file" ? s.path : s.kind === "release" ? `--release ${s.id}` : `--${s.kind}`).join(" \u2192 ")}):`);
   process.stdout.write(`${formatDiff(diffExportedConfig(a, b))}
 `);
 });
@@ -10627,7 +10665,7 @@ program.command("evaluate").description("Run placement/entitlement decisions for
 );
 var generateCmd = program.command("generate").description("Code generation from a config version (see: generate types).");
 generateCmd.command("types").description(
-  "Generate a TypeScript module of entitlement handles (namespaced by entitlement type) for type-safe can()/gate() calls."
+  "Generate a TypeScript module of Playbook handles \u2014 entitlements (namespaced by type), plans, segments, surface-template ids, and ui-path action types \u2014 for type-safe call sites."
 ).argument("[file...]", "Path to a Config File").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").option("-o, --out <path>", "Write the generated module to this path (parent dirs created); default stdout").option("--json", "Emit the handle map as JSON instead of TypeScript").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(
   async (files, opts) => {
     const [sel] = requireSelectors(opts, files, {
@@ -10796,6 +10834,20 @@ function gitRootOf(from) {
     process.exit(child.status ?? EXIT.UNEXPECTED);
   }
 }
+if (process.argv.includes("-V") || process.argv.includes("--version")) {
+  process.stdout.write(`${pkgVersion} (schema ${SCHEMA_VERSION})
+`);
+  try {
+    const pkgPath = path2.resolve("package.json");
+    if (existsSync2(pkgPath)) {
+      for (const warning of checkPinDrift(JSON.parse(readFileSync2(pkgPath, "utf8")))) {
+        diag(`\u26A0 pin drift: ${warning}`);
+      }
+    }
+  } catch {
+  }
+  process.exit(EXIT.OK);
+}
 program.exitOverride();
 try {
   await program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revturbine/cli",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "revturbine — verify RevTurbine ExportedConfig files and ship them to a RevTurbine instance through the Change Set lifecycle.",
   "license": "MIT",
   "repository": {