@thallylabs/cli 0.6.0 → 0.8.0

package/dist/index.js

@@ -13,7 +13,8 @@ var COMMANDS = [
   { name: "translate", summary: "Translate content into a locale", usage: "thally translate --locale <code>" },
   { name: "mcp", summary: "Start the Model Context Protocol server (stdio)", usage: "thally mcp" },
   { name: "agent", summary: "Draft docs from a task (PR, diff, or instruction) as a reviewed PR", usage: 'thally agent "<instruction>" [--diff <ref>] [--from-pr <url>] [--context-file <path>] [--dry-run] [--pr]' },
-  { name: "track", summary: "Track product repos \u2014 their merged PRs become docs PRs", usage: "thally track <add|list|test|setup> [owner/repo] [--branch <base>] [--paths <globs>] [--pr <n>]" }
+  { name: "track", summary: "Track product repos \u2014 their merged PRs become docs PRs", usage: "thally track <add|list|test|setup> [owner/repo] [--branch <base>] [--paths <globs>] [--pr <n>]" },
+  { name: "starter", summary: "Review or apply an immutable starter runtime update", usage: "thally starter update [--apply]" }
 ];
 function parseArgs(argv) {
   const command = argv[0] && !argv[0].startsWith("-") ? argv[0] : void 0;
@@ -49,8 +50,9 @@ function parseArgs(argv) {
 function helpText() {
   const lines = [];
   lines.push("");
-  lines.push("  thally \u2014 the unified documentation CLI");
+  lines.push("  thally \u2014 keep customer-facing knowledge in sync with product changes");
   lines.push("");
+  lines.push("  Connect product evidence, prepare reviewable updates, and publish one trusted source.");
   lines.push("  You author content/, docs.json, and snippets/.");
   lines.push("  The framework (Next.js) is a hidden runtime \u2014 you never touch src/app/.");
   lines.push("");
@@ -6450,6 +6452,57 @@ async function runTrackCommand(args) {
   return sub ? 1 : 0;
 }
 
+// src/commands/starter.ts
+import {
+  updateStarterProject
+} from "create-thally-docs/starter-update";
+function formatPaths(label, paths) {
+  if (paths.length === 0) return [];
+  return [`  ${label}:`, ...paths.map((path5) => `    - ${path5}`)];
+}
+function formatStarterUpdateResult(result) {
+  if (result.isUpToDate) {
+    return `
+  Starter release ${result.targetRelease.starterVersion} is already current.
+
+`;
+  }
+  const lines = [
+    "",
+    `  Starter ${result.previousRelease.starterVersion} \u2192 ${result.targetRelease.starterVersion}`,
+    `  ${result.plan.copyPaths.length} copy/update \xB7 ${result.plan.deletePaths.length} delete \xB7 ${result.plan.conflictPaths.length} conflict \xB7 ${result.plan.manualReviewPaths.length} manual review`,
+    "",
+    ...formatPaths("Copy/update", result.plan.copyPaths),
+    ...formatPaths("Delete", result.plan.deletePaths),
+    ...formatPaths("Conflicts", result.plan.conflictPaths),
+    ...formatPaths("Manual review", result.plan.manualReviewPaths),
+    ""
+  ];
+  if (result.applied) {
+    lines.push("  Starter update applied and provenance advanced.", "");
+  } else if (result.plan.conflictPaths.length > 0) {
+    lines.push("  Dry run only. Resolve conflicts before applying.", "");
+  } else {
+    lines.push('  Dry run only. Review the plan, then run "thally starter update --apply".', "");
+  }
+  return lines.join("\n");
+}
+async function runStarterCommand(args) {
+  const subcommand = args.positionals[0];
+  if (subcommand !== "update" || args.hasFlag("--help", "-h")) {
+    process.stdout.write("\n  Usage: thally starter update [--apply]\n\n");
+    return subcommand && subcommand !== "update" ? 1 : 0;
+  }
+  const apply = args.hasFlag("--apply");
+  const result = await updateStarterProject({
+    targetDir: process.cwd(),
+    apply,
+    confirmed: apply
+  });
+  process.stdout.write(formatStarterUpdateResult(result));
+  return result.plan.conflictPaths.length > 0 ? 1 : 0;
+}
+
 // src/index.ts
 var [major] = process.versions.node.split(".").map(Number);
 if (major < 18) {
@@ -6504,6 +6557,9 @@ async function main() {
     case "track":
       requireProject();
       return runTrackCommand(args);
+    case "starter":
+      requireProject();
+      return runStarterCommand(args);
     default:
       process.stderr.write(`
   Unknown command: ${args.command}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@thallylabs/cli",
-  "version": "0.6.0",
-  "description": "The unified thally CLI — author content + config; the framework stays a hidden runtime",
+  "version": "0.8.0",
+  "description": "The Thally CLI for authoring knowledge surfaces, tracing product changes, and keeping documentation checked.",
   "type": "module",
   "engines": {
     "node": ">=18"
@@ -24,8 +24,8 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.78.0",
-    "@thallylabs/mcp": "0.8.0",
-    "create-thally-docs": "0.8.0"
+    "@thallylabs/mcp": "0.10.0",
+    "create-thally-docs": "0.10.0"
   },
   "devDependencies": {
     "@thallylabs/agent": "*",