create-thally-docs 0.7.2 → 0.7.4

package/README.md

@@ -9,10 +9,12 @@ AI agents as structured JSON, JSON-LD, and Markdown from the same URL.
 ```bash
 npx create-thally-docs my-docs
 cd my-docs
+npm install
 npm run dev
 ```
 
-Then open [http://localhost:3040](http://localhost:3040). A freshly scaffolded
+The dev server starts at [http://localhost:3040](http://localhost:3040) and
+automatically uses the next available port when needed. A freshly scaffolded
 site is agent-ready out of the box and scores 100/A on the built-in
 [Agent Readiness Score](https://github.com/thallylabs/thally).
 
@@ -22,6 +24,10 @@ Run non-interactively with smart defaults:
 npx create-thally-docs my-docs --yes
 ```
 
+Dependency installation is deliberately opt-in so the scaffold finishes in
+seconds. Pass `--install` to run it immediately, or `--no-install` to skip the
+interactive question explicitly.
+
 ## What you get
 
 - **MDX content** in `src/content/`, navigation in `docs.json`

package/dist/{chunk-QGRDDS5V.js → chunk-AIG772AY.js}

@@ -3,7 +3,7 @@ import {
   initGit,
   installDeps,
   scaffold
-} from "./chunk-KN6QUPKR.js";
+} from "./chunk-D6W2N7ZW.js";
 
 // src/migrate/index.ts
 import { mkdirSync as mkdirSync2, copyFileSync as copyFileSync2, readFileSync as readFileSync3, writeFileSync, existsSync as existsSync3, mkdtempSync, rmSync } from "fs";

package/dist/{chunk-KN6QUPKR.js → chunk-D6W2N7ZW.js}

@@ -494,7 +494,8 @@ npm install
 npm run dev
 \`\`\`
 
-Open [http://localhost:3040](http://localhost:3040).
+The server starts at [http://localhost:3040](http://localhost:3040), or the next
+available port when 3040 is already in use.
 
 ## Write your docs
 
@@ -519,6 +520,42 @@ anywhere Next.js is supported, or connect the repository to
 `;
   writeFileSync2(join2(targetDir, "README.md"), readme, "utf8");
 }
+function writeCloudflareRuntimeConfig(targetDir, slug) {
+  writeFileSync2(
+    join2(targetDir, "open-next.config.ts"),
+    `/** OpenNext adapter configuration for the Cloudflare Workers runtime. */
+import { defineCloudflareConfig } from '@opennextjs/cloudflare/config'
+
+export default defineCloudflareConfig()
+`,
+    "utf8"
+  );
+  writeFileSync2(
+    join2(targetDir, "wrangler.jsonc"),
+    `${JSON.stringify(
+      {
+        $schema: "node_modules/wrangler/config-schema.json",
+        name: slug,
+        main: ".open-next/worker.js",
+        compatibility_date: "2026-07-15",
+        compatibility_flags: ["nodejs_compat", "global_fetch_strictly_public"],
+        observability: {
+          enabled: true,
+          logs: { head_sampling_rate: 1 },
+          traces: { enabled: true, head_sampling_rate: 0.01 }
+        },
+        assets: {
+          directory: ".open-next/assets",
+          binding: "ASSETS"
+        }
+      },
+      null,
+      2
+    )}
+`,
+    "utf8"
+  );
+}
 function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl) {
   const siteFile = join2(targetDir, "src", "data", "site.ts");
   if (!existsSync(siteFile)) {
@@ -628,15 +665,34 @@ function patchPackageJson(targetDir, slug) {
   if (!existsSync(pkgPath)) return;
   const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
   const hadWorkspaces = Array.isArray(pkg.workspaces) && pkg.workspaces.length > 0;
+  const hasRuntimeSourceCompiler = existsSync(
+    join2(targetDir, "scripts", "build-runtime-sources.mts")
+  );
   pkg.name = slug;
   delete pkg.workspaces;
   if (pkg.scripts) {
-    if (pkg.scripts["prebuild"]) pkg.scripts["prebuild"] = "npm run embeddings:build";
+    if (hasRuntimeSourceCompiler) {
+      pkg.scripts["runtime-sources:build"] ??= "tsx scripts/build-runtime-sources.mts";
+      pkg.scripts["predev"] = "npm run runtime-sources:build";
+      pkg.scripts["postinstall"] = "npm run runtime-sources:build";
+      pkg.scripts["prebuild"] = "npm run runtime-sources:build && npm run embeddings:build";
+    } else {
+      pkg.scripts["prebuild"] = "npm run embeddings:build";
+    }
     delete pkg.scripts["pretest"];
     delete pkg.scripts["packages:build"];
+    pkg.scripts["build:cloudflare"] = "opennextjs-cloudflare build";
+    pkg.scripts["preview:cloudflare"] = "npm run build:cloudflare && opennextjs-cloudflare preview";
+    pkg.scripts["deploy:cloudflare"] = "npm run build:cloudflare && opennextjs-cloudflare deploy";
+    pkg.scripts["upload:cloudflare"] = "npm run build:cloudflare && opennextjs-cloudflare upload";
   }
+  pkg.devDependencies ??= {};
+  pkg.devDependencies["@thallylabs/cli"] = "0.5.1";
+  pkg.devDependencies["@opennextjs/cloudflare"] ??= "1.15.0";
+  pkg.devDependencies.vite ??= "7.2.6";
+  pkg.devDependencies.wrangler ??= "4.111.0";
   if (pkg.dependencies?.["@thallylabs/mcp"] === "*") {
-    pkg.dependencies["@thallylabs/mcp"] = "0.7.0";
+    pkg.dependencies["@thallylabs/mcp"] = "0.7.1";
   }
   writeFileSync2(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
@@ -687,7 +743,7 @@ function installDeps(targetDir) {
   console.log("");
   console.log("  \u{1F4E6} Installing dependencies...");
   console.log("");
-  run("npm install", targetDir);
+  run("npm install --prefer-offline --no-audit --no-fund --progress=false", targetDir);
 }
 function logo() {
   console.log("");
@@ -700,12 +756,12 @@ function logo() {
   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("  \u2551             Beautiful docs, zero lock-in.              \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) {
+function success(projectDir, projectName, dependenciesInstalled) {
   console.log("");
   console.log("  \u2705 Your Thally project is ready!");
   console.log("");
@@ -714,9 +770,12 @@ function success(projectDir, projectName) {
   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(`  Then open http://localhost:3040 to see your ${projectName} docs.`);
+  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");
@@ -764,6 +823,7 @@ async function scaffold(options) {
   patchTopBarNavigation(targetDir);
   patchOpenApiFetch(targetDir);
   patchPackageJson(targetDir, slug);
+  writeCloudflareRuntimeConfig(targetDir, slug);
   patchGitignore(targetDir);
   updateEnvExample(targetDir);
   if (doInstall) {

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   migrateDocs,
   parseGitHubUrl
-} from "./chunk-QGRDDS5V.js";
+} from "./chunk-AIG772AY.js";
 import {
   logo,
   readDocsJson,
@@ -10,7 +10,7 @@ import {
   slugify,
   success,
   writeDocsJson
-} from "./chunk-KN6QUPKR.js";
+} from "./chunk-D6W2N7ZW.js";
 
 // src/index.ts
 import { existsSync as existsSync3, readdirSync as readdirSync2 } from "fs";
@@ -20,7 +20,7 @@ import { resolve as resolve2 } from "path";
 import { input, select } from "@inquirer/prompts";
 import { basename } from "path";
 import { resolve } from "path";
-async function gatherAnswers(dirArg, useDefaults) {
+async function gatherAnswers(dirArg, useDefaults, installPreference) {
   let projectDir;
   if (dirArg) {
     projectDir = resolve(dirArg);
@@ -71,13 +71,13 @@ async function gatherAnswers(dirArg, useDefaults) {
       else console.log("  \u26A0 No valid owner/repo entries \u2014 skipping Track (add it later with `thally track add`).");
     }
   }
-  let doInstall = true;
-  if (!useDefaults) {
+  let doInstall = installPreference ?? false;
+  if (!useDefaults && installPreference === void 0) {
     const shouldInstall = await input({
-      message: "  Install dependencies? (Y/n):",
-      default: "Y"
+      message: "  Install dependencies now? (y/N):",
+      default: "N"
     });
-    doInstall = shouldInstall.toLowerCase() !== "n";
+    doInstall = shouldInstall.trim().toLowerCase().startsWith("y");
   }
   let i18nLocales;
   if (!useDefaults) {
@@ -682,10 +682,19 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
 // src/index.ts
 var args = process.argv.slice(2);
 var flags = args.filter((a) => a.startsWith("-"));
+var valueFlags = /* @__PURE__ */ new Set([
+  "--api-key",
+  "--branch",
+  "--docs-dir",
+  "--into",
+  "--locale",
+  "--model",
+  "--pages"
+]);
 var positional = [];
 for (let i = 0; i < args.length; i++) {
   if (args[i].startsWith("-")) {
-    if (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+    if (valueFlags.has(args[i]) && i + 1 < args.length && !args[i + 1].startsWith("-")) {
       i++;
     }
   } else {
@@ -754,6 +763,7 @@ async function runMigrateCommand() {
 }
 async function runScaffoldCommand() {
   const useDefaults = flags.includes("--yes") || flags.includes("-y");
+  const installPreference = flags.includes("--install") ? true : flags.includes("--no-install") ? false : void 0;
   const dirArg = positional[0];
   if (dirArg) {
     const resolved = resolve2(dirArg);
@@ -763,7 +773,7 @@ async function runScaffoldCommand() {
       process.exit(1);
     }
   }
-  const answers = await gatherAnswers(dirArg, useDefaults);
+  const answers = await gatherAnswers(dirArg, useDefaults, installPreference);
   const result = await scaffold({
     projectDir: answers.projectDir,
     projectName: answers.projectName,
@@ -774,7 +784,7 @@ async function runScaffoldCommand() {
     i18nLocales: answers.i18nLocales,
     trackRepos: answers.trackRepos
   });
-  success(result.projectDir, answers.projectName);
+  success(result.projectDir, answers.projectName, answers.doInstall);
 }
 async function runCheckCommand() {
   const projectDir = resolve2(positional[1] ?? ".");

package/dist/migrate/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-QGRDDS5V.js";
-import "../chunk-KN6QUPKR.js";
+} from "../chunk-AIG772AY.js";
+import "../chunk-D6W2N7ZW.js";
 export {
   migrateDocs
 };

package/dist/scaffold.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-KN6QUPKR.js";
+} from "./chunk-D6W2N7ZW.js";
 export {
   scaffold
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Scaffold a new Thally documentation project",
   "type": "module",
   "engines": {