dogsbay 0.2.0-beta.0 → 0.2.0-beta.2

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

@@ -15,7 +15,7 @@
  * `dogsbay site build`.
  */
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { isAbsolute, join, resolve } from "node:path";
 import pc from "picocolors";
 import prompts from "prompts";
 import { emitSiteScaffold } from "@dogsbay/format-astro";
@@ -107,7 +107,55 @@ export async function siteInit(targetDir, options) {
     if (options.local)
         astroOpts.local = true;
     emitSiteScaffold(outputDir, config.site.name, astroOpts, true);
-    printNextSteps(absTarget, outputDir, config);
+    // Seed starter content so the first `dogsbay site build` succeeds
+    // without manual intervention. Only writes when this is a fresh
+    // init (writeConfig=true; scaffold-only consumers already have
+    // content) and the content dir doesn't exist yet — never
+    // overwrites user files. See plans/beta-launch-followups.md.
+    let starterContentPath = null;
+    if (writeConfig) {
+        starterContentPath = seedStarterContent(absTarget, config);
+    }
+    printNextSteps(absTarget, outputDir, config, starterContentPath);
+}
+/**
+ * Create a starter `<content>/index.md` if the content dir doesn't
+ * already exist. Returns the path written, or null when nothing
+ * was created (dir already populated). Never overwrites.
+ */
+function seedStarterContent(absTarget, config) {
+    const sources = config.content.sources ?? [];
+    const first = sources[0];
+    if (!first?.path)
+        return null;
+    const contentDir = isAbsolute(first.path)
+        ? first.path
+        : join(absTarget, first.path);
+    if (existsSync(contentDir))
+        return null; // user already has content
+    mkdirSync(contentDir, { recursive: true });
+    const indexPath = join(contentDir, "index.md");
+    writeFileSync(indexPath, `---
+title: ${config.site.name || "Welcome"}
+description: Edit content/index.md to get started.
+---
+
+# ${config.site.name || "Welcome"}
+
+This is your starter page. Replace this content with your own
+markdown — every \`.md\` file under \`content/\` becomes a page.
+
+## What's next
+
+- Edit this file (\`content/index.md\`) to change the home page.
+- Add more \`.md\` files alongside it for additional pages.
+- Run \`dogsbay site dev\` to preview live as you edit.
+- See \`dogsbay.config.yml\` for site-wide settings (theme, agent
+  readiness, deploy target, etc.).
+
+For the full reference, see https://github.com/dogsbay/dogsbay.
+`);
+    return indexPath;
 }
 // ─── Resolution: flags + prompts → DogsbayConfig ─────────────────────────
 async function resolveConfig(opts, interactive) {
@@ -353,12 +401,15 @@ function findExistingConfig(dir) {
     }
     return null;
 }
-function printNextSteps(absTarget, outputDir, config) {
+function printNextSteps(absTarget, outputDir, config, starterContentPath) {
     void config;
     const sameDir = absTarget === outputDir;
     console.log("");
     console.log(pc.green("Wrote:"));
     console.log(`  ${absTarget}/dogsbay.config.yml`);
+    if (starterContentPath) {
+        console.log(`  ${starterContentPath}`);
+    }
     console.log(`  ${outputDir}/package.json`);
     console.log(`  ${outputDir}/astro.config.mjs`);
     console.log(`  ${outputDir}/src/styles/theme.css`);
@@ -366,11 +417,14 @@ function printNextSteps(absTarget, outputDir, config) {
     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/dist/index.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
 import { Command } from "commander";
 import { init } from "./commands/init.js";
 import { add, list } from "./commands/add.js";
@@ -12,11 +15,18 @@ import { siteInit } from "./commands/site-init.js";
 import { siteBuild } from "./commands/site-build.js";
 import { siteCheck } from "./commands/site-check.js";
 import { siteDev, sitePreview } from "./commands/site-dev.js";
+// Read version from the runtime package.json so `dogsbay --version`
+// never drifts from what's published. Walks one level up from
+// `dist/index.js` to `package.json` (works in both monorepo dev and
+// the published tarball — pnpm/npm both keep package.json next to
+// dist/).
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 const program = new Command();
 program
     .name("dogsbay")
     .description("Documentation site generator + Astro component library")
-    .version("0.1.0");
+    .version(pkg.version);
 // ── `dogsbay astro` — drop Dogsbay components into an existing Astro project ──
 const astro = program
     .command("astro")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.0-beta.2",
   "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.0",
-    "@dogsbay/format-astro": "0.2.0-beta.0",
-    "@dogsbay/format-obsidian": "0.2.0-beta.0",
-    "@dogsbay/format-mdx": "0.2.0-beta.0",
-    "@dogsbay/format-starlight": "0.2.0-beta.0",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.0",
-    "@dogsbay/format-openapi": "0.2.0-beta.0",
-    "@dogsbay/types": "0.2.0-beta.0"
+    "@dogsbay/format-mkdocs": "0.2.0-beta.2",
+    "@dogsbay/format-astro": "0.2.0-beta.2",
+    "@dogsbay/format-mdx": "0.2.0-beta.2",
+    "@dogsbay/format-obsidian": "0.2.0-beta.2",
+    "@dogsbay/format-starlight": "0.2.0-beta.2",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.2",
+    "@dogsbay/types": "0.2.0-beta.2",
+    "@dogsbay/format-openapi": "0.2.0-beta.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",