create-thally-docs 0.7.2 → 0.7.3

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-PGTE4X3G.js}

@@ -3,7 +3,7 @@ import {
   initGit,
   installDeps,
   scaffold
-} from "./chunk-KN6QUPKR.js";
+} from "./chunk-WMVWYKAB.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-WMVWYKAB.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
 
@@ -687,7 +688,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 +701,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 +715,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");

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   migrateDocs,
   parseGitHubUrl
-} from "./chunk-QGRDDS5V.js";
+} from "./chunk-PGTE4X3G.js";
 import {
   logo,
   readDocsJson,
@@ -10,7 +10,7 @@ import {
   slugify,
   success,
   writeDocsJson
-} from "./chunk-KN6QUPKR.js";
+} from "./chunk-WMVWYKAB.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-PGTE4X3G.js";
+import "../chunk-WMVWYKAB.js";
 export {
   migrateDocs
 };

package/dist/scaffold.js

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

package/package.json

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