create-thally-docs 0.10.78 → 0.10.79

package/dist/migrate/index.js

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-VGGE6JIL.js";
-import "../chunk-QLMRRNLL.js";
+} from "../chunk-IZQHRVPV.js";
+import "../chunk-KDLP27DS.js";
+import "../chunk-KGKSB3PU.js";
 import "../chunk-4VKRBJV2.js";
-import "../chunk-W5WQ2V7P.js";
+import "../chunk-J7255UQA.js";
+import "../chunk-WWIATVAD.js";
 import "../chunk-RI56XMBI.js";
 import "../chunk-BP2REWTO.js";
+import "../chunk-L2YCVQBR.js";
 export {
   migrateDocs
 };

package/dist/migration-worker.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/migration-worker.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import {
+  runCheck
+} from "./chunk-DIX4EUI4.js";
+import "./chunk-KDLP27DS.js";
+import "./chunk-J7255UQA.js";
+
+// src/migration-worker.ts
+import { parentPort, workerData } from "worker_threads";
+import { migrateRepository, migrateUrl, renderMigrationFiles } from "@thallylabs/migrate";
+async function execute(request) {
+  if (request.operation === "check") {
+    let diagnostics = [];
+    const code = await runCheck(request.args[0], {
+      fix: false,
+      ci: true,
+      silent: true,
+      onIssues: (issues) => {
+        diagnostics = issues;
+      }
+    });
+    return { code, diagnostics };
+  }
+  if (request.operation === "repository") {
+    return migrateRepository(...request.args);
+  }
+  if (request.operation === "url") {
+    return migrateUrl(...request.args);
+  }
+  return renderMigrationFiles(...request.args);
+}
+if (!parentPort) throw new Error("Migration worker requires a parent thread.");
+try {
+  parentPort.postMessage({ result: await execute(workerData) });
+} catch (error) {
+  parentPort.postMessage({ error: error instanceof Error ? error : new Error(String(error)) });
+}

package/dist/scaffold.d.ts

@@ -27,6 +27,11 @@ interface StarterArchiveEntryMetadata {
  */
 declare function validateStarterArchiveEntry(archivePath: string, entry: StarterArchiveEntryMetadata, archiveRoot?: string): void;
 
+/**
+ * Create a customer-owned project from the immutable starter release. Progress
+ * wraps each operation without changing the starter contents or owner fields.
+ */
+
 interface ScaffoldOptions {
     projectDir: string;
     projectName: string;
@@ -54,6 +59,7 @@ interface ScaffoldOptions {
 interface ScaffoldResult {
     projectDir: string;
 }
+/** Download, personalize, and optionally install a new documentation project. */
 declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
 
 export { STARTER_ARCHIVE_ROOT, STARTER_COMMIT_SHA, STARTER_REPOSITORY, type ScaffoldOptions, type ScaffoldResult, scaffold, validateStarterArchiveEntry };

package/dist/scaffold.js

@@ -1,18 +1,20 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-QLMRRNLL.js";
+} from "./chunk-KGKSB3PU.js";
 import "./chunk-4VKRBJV2.js";
+import "./chunk-J7255UQA.js";
 import {
   STARTER_ARCHIVE_ROOT,
   STARTER_COMMIT_SHA,
   STARTER_REPOSITORY,
   validateStarterArchiveEntry
-} from "./chunk-W5WQ2V7P.js";
+} from "./chunk-WWIATVAD.js";
 import "./chunk-RI56XMBI.js";
 import {
   STABLE_SCAFFOLD_RELEASE
 } from "./chunk-BP2REWTO.js";
+import "./chunk-L2YCVQBR.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   STARTER_ARCHIVE_ROOT,

package/dist/starter-update.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   downloadStarter
-} from "./chunk-W5WQ2V7P.js";
+} from "./chunk-WWIATVAD.js";
 import {
   applyStarterRuntimeSyncPlan,
   mergeStarterOwnershipContracts,
@@ -14,6 +14,7 @@ import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
 } from "./chunk-BP2REWTO.js";
+import "./chunk-L2YCVQBR.js";
 
 // src/starter-update.ts
 import {

package/dist/terminal.d.ts

@@ -0,0 +1,75 @@
+/** Product-wide promise; command subtitles describe the immediate task. */
+declare const PRODUCT_TAGLINE = "Product knowledge, kept in step with your code.";
+/**
+ * Scope Clack's fixed cyan/magenta/green UI colors to our olive accent.
+ * Clack 0.11 has no theme option. Adapt only its color SGRs while a prompt or
+ * spinner owns stdout; preserve text, cursor controls, warnings, and errors.
+ * Release restores the original writer, including on cancellation or failure.
+ */
+declare function acquireTerminalAccent(): () => void;
+interface TerminalOptions {
+    stdout?: Pick<NodeJS.WriteStream, 'write' | 'isTTY' | 'columns'>;
+    stderr?: Pick<NodeJS.WriteStream, 'write' | 'isTTY' | 'columns'>;
+    env?: NodeJS.ProcessEnv;
+    argv?: Array<string>;
+}
+/** Remove terminal escape sequences and non-printing controls from source text. */
+declare function terminalText(value: string): string;
+/** Create a terminal renderer; injected streams support deterministic transcripts. */
+declare function createTerminal(options?: TerminalOptions): {
+    /** Whether interactive decoration is supported by the current output. */
+    readonly isRich: boolean;
+    /** Whether the caller requested detailed subprocess output. */
+    readonly isVerbose: boolean;
+    /** Introduce a command with the responsive wordmark and its immediate task. */
+    intro(command: string, version?: string, subtitle?: string): void;
+    /** Display a source, destination, or result with a consistent label. */
+    detail(label: string, value: string): void;
+    /** Display a neutral fact without implying success. */
+    info(message: string): void;
+    /** Record a completed operation in the retained transcript. */
+    success(message: string): void;
+    /** Keep warnings visible on stderr even when successful task logs are quiet. */
+    warn(message: string): void;
+    /** Keep errors visible on stderr and separate from machine-readable stdout. */
+    error(message: string): void;
+    /** Group next steps or results without a fixed-width box. */
+    section(title: string, lines: Array<string>): void;
+    /** Make the next action prominent while retaining one intact shell command. */
+    nextAction(title: string, command: string): void;
+    /** Finish a command without masking warnings or incomplete validation. */
+    outro(message: string): void;
+    /** Render progress, retain the outcome, and always release Clack's cursor hooks. */
+    step<T>(label: string, action: (update: (message: string) => void) => T | Promise<T>, completedLabel?: string): Promise<T>;
+};
+/** Process-local shared presentation; importing it never writes output. */
+declare const terminal: {
+    /** Whether interactive decoration is supported by the current output. */
+    readonly isRich: boolean;
+    /** Whether the caller requested detailed subprocess output. */
+    readonly isVerbose: boolean;
+    /** Introduce a command with the responsive wordmark and its immediate task. */
+    intro(command: string, version?: string, subtitle?: string): void;
+    /** Display a source, destination, or result with a consistent label. */
+    detail(label: string, value: string): void;
+    /** Display a neutral fact without implying success. */
+    info(message: string): void;
+    /** Record a completed operation in the retained transcript. */
+    success(message: string): void;
+    /** Keep warnings visible on stderr even when successful task logs are quiet. */
+    warn(message: string): void;
+    /** Keep errors visible on stderr and separate from machine-readable stdout. */
+    error(message: string): void;
+    /** Group next steps or results without a fixed-width box. */
+    section(title: string, lines: Array<string>): void;
+    /** Make the next action prominent while retaining one intact shell command. */
+    nextAction(title: string, command: string): void;
+    /** Finish a command without masking warnings or incomplete validation. */
+    outro(message: string): void;
+    /** Render progress, retain the outcome, and always release Clack's cursor hooks. */
+    step<T>(label: string, action: (update: (message: string) => void) => T | Promise<T>, completedLabel?: string): Promise<T>;
+};
+/** Highlight help headings only on capable terminals; preserve plain help bytes otherwise. */
+declare function formatHelp(text: string): string;
+
+export { PRODUCT_TAGLINE, type TerminalOptions, acquireTerminalAccent, createTerminal, formatHelp, terminal, terminalText };

package/dist/terminal.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import {
+  PRODUCT_TAGLINE,
+  acquireTerminalAccent,
+  createTerminal,
+  formatHelp,
+  terminal,
+  terminalText
+} from "./chunk-L2YCVQBR.js";
+export {
+  PRODUCT_TAGLINE,
+  acquireTerminalAccent,
+  createTerminal,
+  formatHelp,
+  terminal,
+  terminalText
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.78",
+  "version": "0.10.79",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -29,7 +29,11 @@
       "import": "./dist/starter-update.js"
     },
     "./migrate": "./dist/migrate/index.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./terminal": {
+      "types": "./dist/terminal.d.ts",
+      "import": "./dist/terminal.js"
+    }
   },
   "files": [
     "dist",
@@ -43,6 +47,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.36.0",
+    "@clack/prompts": "^0.11.0",
     "@inquirer/prompts": "^7.0.0",
     "@thallylabs/core": "0.2.11",
     "@thallylabs/migrate": "0.2.24",

package/dist/chunk-QLMRRNLL.js

@@ -1,162 +0,0 @@
-#!/usr/bin/env node
-import {
-  personalizeStarter,
-  updateEnvExample
-} from "./chunk-4VKRBJV2.js";
-import {
-  downloadStarter
-} from "./chunk-W5WQ2V7P.js";
-
-// src/scaffold.ts
-import { existsSync, mkdirSync, readdirSync } from "fs";
-import { resolve } from "path";
-
-// src/docs-json.ts
-import { readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-function readDocsJson(projectDir) {
-  const docsPath = join(projectDir, "docs.json");
-  const raw = readFileSync(docsPath, "utf8");
-  return JSON.parse(raw);
-}
-function writeDocsJson(projectDir, config) {
-  const docsPath = join(projectDir, "docs.json");
-  writeFileSync(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
-}
-function resetTrackingConfig(projectDir) {
-  const config = readDocsJson(projectDir);
-  if (config.tracking) {
-    delete config.tracking;
-    writeDocsJson(projectDir, config);
-  }
-}
-function writeTrackingConfig(projectDir, repos) {
-  if (repos.length === 0) return;
-  const config = readDocsJson(projectDir);
-  config.tracking = { repos: repos.map((r) => ({ owner: r.owner, repo: r.repo, branch: "main" })) };
-  writeDocsJson(projectDir, config);
-}
-
-// src/utils.ts
-import { execSync } from "child_process";
-import { basename } from "path";
-function slugify(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function run(cmd, cwd) {
-  execSync(cmd, { cwd, stdio: "inherit" });
-}
-function initGit(targetDir) {
-  try {
-    run("git init", targetDir);
-    run("git add -A", targetDir);
-    run('git commit -m "Initial commit from create-thally-docs"', targetDir);
-  } catch {
-    console.log("  \u26A0\uFE0F  Could not initialize git (you can do this manually).");
-  }
-}
-function installDeps(targetDir) {
-  console.log("");
-  console.log("  \u{1F4E6} Installing dependencies...");
-  console.log("");
-  run("npm install --prefer-offline --no-audit --no-fund --progress=false", targetDir);
-}
-function logo() {
-  console.log("");
-  console.log("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
-  console.log("  \u2551                                                        \u2551");
-  console.log("  \u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557     \u2588\u2588\u2557   \u2588\u2588\u2557   \u2551");
-  console.log("  \u2551   \u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551     \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D   \u2551");
-  console.log("  \u2551      \u2588\u2588\u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551      \u255A\u2588\u2588\u2588\u2588\u2554\u255D    \u2551");
-  console.log("  \u2551      \u2588\u2588\u2551   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551       \u255A\u2588\u2588\u2554\u255D     \u2551");
-  console.log("  \u2551      \u2588\u2588\u2551   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551      \u2551");
-  console.log("  \u2551      \u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D      \u2551");
-  console.log("  \u2551                                                        \u2551");
-  console.log("  \u2551Give your product and docs first-class agent visibility.\u2551");
-  console.log("  \u2551                                                        \u2551");
-  console.log("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D");
-  console.log("");
-}
-function success(projectDir, projectName, dependenciesInstalled) {
-  console.log("");
-  console.log("  \u2705 Your Thally project is ready!");
-  console.log("");
-  console.log(`  \u{1F4C2} ${projectDir}`);
-  console.log("");
-  console.log("  Next steps:");
-  console.log("");
-  console.log(`    cd ${basename(projectDir)}`);
-  if (!dependenciesInstalled) {
-    console.log("    npm install");
-  }
-  console.log("    npm run dev");
-  console.log("");
-  console.log(`  Your terminal will print the local URL for your ${projectName} docs.`);
-  console.log("");
-  console.log("  \u{1F4DD} Key files to edit:");
-  console.log("    \u2022 src/data/site.ts        \u2014 name, links, branding");
-  console.log("    \u2022 docs.json               \u2014 navigation structure");
-  console.log("    \u2022 src/content/*.mdx        \u2014 your documentation");
-  console.log("    \u2022 openapi.yaml            \u2014 API spec (optional)");
-  console.log("");
-  console.log("  Happy documenting! \u{1F680}");
-  console.log("");
-}
-
-// src/scaffold.ts
-async function scaffold(options) {
-  const {
-    projectDir,
-    projectName,
-    description,
-    brandPreset,
-    repoUrl,
-    doInstall,
-    enableAiChat = true,
-    i18nLocales,
-    trackRepos,
-    colors
-  } = options;
-  const targetDir = resolve(projectDir);
-  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
-    throw new Error(`Directory "${targetDir}" already exists and is not empty.`);
-  }
-  mkdirSync(targetDir, { recursive: true });
-  const slug = slugify(projectName);
-  await downloadStarter(targetDir, projectName);
-  personalizeStarter(targetDir, {
-    projectName,
-    packageName: slug,
-    description,
-    brandPreset,
-    repoUrl,
-    enableAiChat,
-    i18nLocales,
-    colors
-  });
-  resetTrackingConfig(targetDir);
-  if (trackRepos?.length) {
-    writeTrackingConfig(targetDir, trackRepos);
-    const list = trackRepos.map((r) => `${r.owner}/${r.repo}`).join(", ");
-    console.log(`  \u2713 Thally Track enabled \u2014 watching ${list} (branch main, all files; refine in docs.json).`);
-    console.log("    To finish wiring it: `thally track setup` (pick a trigger) + `thally agent init`,");
-    console.log("    then add your ANTHROPIC_API_KEY. See /guides/thally-track.");
-  }
-  updateEnvExample(targetDir);
-  if (doInstall) {
-    installDeps(targetDir);
-  }
-  initGit(targetDir);
-  return { projectDir: targetDir };
-}
-
-export {
-  slugify,
-  initGit,
-  installDeps,
-  logo,
-  success,
-  readDocsJson,
-  writeDocsJson,
-  scaffold
-};