dogsbay 0.2.0-beta.0 → 0.2.0-beta.1

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`);

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.1",
   "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.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"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",