dogsbay 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/commands/site-build.js

@@ -244,8 +244,9 @@ export async function siteBuild(cwd, options) {
     }
     console.log("");
     console.log(pc.cyan("Next:"));
-    console.log("  npm run build              # Astro build → dist/");
-    console.log("  dogsbay site dev           # local preview with hot reload");
+    console.log("  dogsbay site dev           # live preview at http://localhost:4321");
+    console.log("  dogsbay site preview       # production build → dist/ + serve");
+    console.log("  dogsbay site check         # run audit rules");
 }
 // ─── Helpers ─────────────────────────────────────────────────────────────
 function resolveConfigPath(startDir, explicit) {

package/dist/commands/site-dev.js

@@ -32,6 +32,36 @@ const defaultRunner = (siteRoot, args) => new Promise((resolve) => {
         resolve(1);
     });
 });
+/**
+ * Pick the first available package manager from a preference list.
+ * Defaults to pnpm (matches the dogsbay tooling chain); falls back
+ * to npm so machines without pnpm don't dead-end.
+ */
+function pickPackageManager() {
+    const onPath = (cmd) => {
+        try {
+            const { execSync } = require("node:child_process");
+            execSync(`command -v ${cmd}`, { stdio: "ignore" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (onPath("pnpm"))
+        return "pnpm";
+    return "npm";
+}
+function runPackageManagerInstall(pm, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(pm, ["install"], { cwd, stdio: "inherit" });
+        child.on("exit", (code) => resolve(code ?? 0));
+        child.on("error", (err) => {
+            console.error(pc.red(`Error: failed to spawn ${pm}: ${err.message}`));
+            resolve(1);
+        });
+    });
+}
 export async function siteDev(cwd, options, runner = defaultRunner) {
     const siteRoot = await prepareForAstro(cwd, options);
     const code = await runner(siteRoot, ["dev"]);
@@ -61,9 +91,18 @@ async function prepareForAstro(cwd, options) {
         process.exit(1);
     }
     if (!existsSync(join(outputDir, "node_modules"))) {
-        console.error(pc.red(`Error: dependencies not installed at ${outputDir}.`));
-        console.error(`       Run \`pnpm install\` (or \`npm install\`) in ${outputDir}.`);
-        process.exit(1);
+        // First-run: install scaffolded site's deps automatically. Picks
+        // pnpm if available, otherwise npm. Friendly users shouldn't have
+        // to know this is a separate project under the hood — the
+        // dogsbay command should Just Work the first time.
+        const pm = pickPackageManager();
+        console.log(pc.cyan(`Installing scaffolded site deps (one-time, ~30s) — using ${pm}...`));
+        const installCode = await runPackageManagerInstall(pm, outputDir);
+        if (installCode !== 0) {
+            console.error(pc.red(`Error: ${pm} install failed in ${outputDir} (exit ${installCode}).`));
+            console.error(`       Try running \`${pm} install\` manually in that directory.`);
+            process.exit(installCode);
+        }
     }
     // Refresh content / config-derived / agent-readiness files before
     // handing off to Astro. Skip with --no-build for fast iteration when

package/dist/commands/site-init.js

@@ -417,11 +417,14 @@ function printNextSteps(absTarget, outputDir, config, starterContentPath) {
     console.log(`  ${outputDir}/src/components/ui/`);
     console.log("");
     console.log(pc.cyan("Next steps:"));
-    console.log(`  cd ${outputDir}`);
-    console.log("  pnpm install");
     if (!sameDir)
         console.log(`  cd ${absTarget}`);
-    console.log("  dogsbay site build");
-    console.log("  dogsbay site dev    # local preview");
+    console.log("  dogsbay site dev      # build + live preview at http://localhost:4321");
+    console.log("                          (auto-installs scaffolded deps on first run)");
+    console.log("");
+    console.log("Other commands:");
+    console.log("  dogsbay site build    # generate Astro source from content");
+    console.log("  dogsbay site preview  # production build + serve from dist/");
+    console.log("  dogsbay site check    # run audit rules against built content");
     console.log("");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.3",
   "description": "CLI for Dogsbay — scaffold, build, and serve documentation sites with markdown / MkDocs / Obsidian / OpenAPI sources",
   "type": "module",
   "bin": {
@@ -30,14 +30,14 @@
     "picocolors": "^1.1.0",
     "prompts": "^2.4.2",
     "yaml": "^2.8.3",
-    "@dogsbay/format-mkdocs": "0.2.0-beta.1",
-    "@dogsbay/format-obsidian": "0.2.0-beta.1",
-    "@dogsbay/format-astro": "0.2.0-beta.1",
-    "@dogsbay/format-mdx": "0.2.0-beta.1",
-    "@dogsbay/format-starlight": "0.2.0-beta.1",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.1",
-    "@dogsbay/format-openapi": "0.2.0-beta.1",
-    "@dogsbay/types": "0.2.0-beta.1"
+    "@dogsbay/format-mkdocs": "0.2.0-beta.3",
+    "@dogsbay/format-obsidian": "0.2.0-beta.3",
+    "@dogsbay/format-mdx": "0.2.0-beta.3",
+    "@dogsbay/format-starlight": "0.2.0-beta.3",
+    "@dogsbay/format-astro": "0.2.0-beta.3",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.3",
+    "@dogsbay/format-openapi": "0.2.0-beta.3",
+    "@dogsbay/types": "0.2.0-beta.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",