dogsbay 0.2.0-beta.112 → 0.2.0-beta.114

package/dist/commands/site-build.js

@@ -18,7 +18,7 @@ import { swapTopicmapNavs } from "../topicmap-nav.js";
 import { cpSync, existsSync, readdirSync, rmSync } from "node:fs";
 import { dirname, isAbsolute, join, resolve } from "node:path";
 import pc from "picocolors";
-import { emitAstroPages, emitPassthroughAstroPages, emitSiteConfig, emitConfigDerivedFiles, emitDeployArtifacts, emitAgentReadinessFiles, emitMissingTranslationStubs, emitSwitcherMap, emitTaxonomyRoutes, makeSlugExcluder, buildBlogData, emitBlogFiles, emitPluginRuntime, normalizeBasePath, basePathSegments, resolvePrefixes, } from "@dogsbay/format-astro";
+import { emitAstroPages, emitPassthroughAstroPages, emitSiteConfig, emitConfigDerivedFiles, syncSiteDependencies, emitDeployArtifacts, emitAgentReadinessFiles, emitMissingTranslationStubs, emitSwitcherMap, emitTaxonomyRoutes, makeSlugExcluder, buildBlogData, emitBlogFiles, emitPluginRuntime, normalizeBasePath, basePathSegments, resolvePrefixes, } from "@dogsbay/format-astro";
 import { collectPassthroughEntries } from "../passthrough-astro.js";
 import { configToAstroOptions, findConfig, loadConfig, resolveOutputDir, applyDeliverable, VALID_FROM, isValidFrom, } from "../config/index.js";
 import { filterSourcesForMode, importContent, primaryModeFiltersAnything, } from "../import-content.js";
@@ -514,6 +514,8 @@ export async function siteBuild(cwd, options) {
                 out: t.out,
                 siteName: config.site.name,
                 siteUrl: config.site.url,
+                copyright: config.site.copyright,
+                poweredBy: config.poweredBy,
                 stripPrefix: combinedPrefix,
                 sourceDir: resolvedSources[0],
                 assetMounts: importResult.assetMounts,
@@ -575,7 +577,21 @@ export async function siteBuild(cwd, options) {
         const { copied } = emitPassthroughAstroPages(passthroughCopies, outputDir, generatedPaths);
         console.log(`  Copied ${copied} passthrough .astro page${copied === 1 ? "" : "s"}`);
     }
-    emitConfigDerivedFiles(outputDir, astroOpts);
+    // Pages are needed for the redirect rules: the dangling-target and
+    // live-page-at-the-source checks are only possible against the emitted set.
+    emitConfigDerivedFiles(outputDir, astroOpts, pages);
+    // Re-pin `@dogsbay/*` to this CLI's version. package.json is scaffold-once,
+    // and this used to run only from `emitSiteScaffold` — which `site build`
+    // never calls — so a site rebuilt for months kept installing the component
+    // libraries written at its first scaffold. Measured on
+    // openshift-docs-markdown: stranded on docs-layout beta.112 while the CLI
+    // was on 113, so nothing shipped in the component library ever reached it.
+    const syncedDeps = syncSiteDependencies(outputDir, { local: astroOpts.local });
+    if (syncedDeps.length > 0) {
+        console.log(`  Dependencies: re-pinned ${syncedDeps.length} @dogsbay/* package(s) to this CLI's version`);
+        for (const change of syncedDeps)
+            console.log(`    ${change}`);
+    }
     // Deploy artifacts — write-if-missing so adding `deploy: github-pages`
     // to dogsbay.config.yml on an existing site materializes the workflow
     // on the next build. Author edits survive (only fired when the file
@@ -1096,6 +1112,8 @@ async function runSecondaryExport(pages, nav, opts) {
     await exporter.export(pages, exportNav, out, {
         siteName: opts.siteName,
         siteUrl: opts.siteUrl,
+        copyright: opts.copyright,
+        poweredBy: opts.poweredBy,
         sourceDir: opts.sourceDir,
         assetMounts: opts.assetMounts,
         plugin: opts.plugin,

package/dist/config/load.js

@@ -168,6 +168,8 @@ function validate(parsed, sourcePath) {
         content,
         output: obj.output,
         outputs: parseOutputs(obj.outputs, sourcePath),
+        redirects: parseRedirects(obj.redirects, sourcePath),
+        poweredBy: obj.poweredBy,
         deploy: obj.deploy,
         analytics: obj.analytics,
         agent,
@@ -1116,3 +1118,35 @@ function parseOutputs(raw, sourcePath) {
         return { format: e.format, path: e.path };
     });
 }
+/**
+ * `redirects:` — a map of source path → target. Shape only; the rules
+ * themselves (loops, chains, dangling targets, platform limits) are validated
+ * by `format-astro` at emit time, where the page set is known.
+ */
+function parseRedirects(raw, sourcePath) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        throw new Error(`redirects must be a map of "/from/": "/to/" in ${sourcePath}`);
+    }
+    const out = {};
+    for (const [from, value] of Object.entries(raw)) {
+        if (typeof value === "string") {
+            out[from] = value;
+            continue;
+        }
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            const v = value;
+            if (typeof v.to !== "string") {
+                throw new Error(`redirects["${from}"] needs a string \`to\` in ${sourcePath}`);
+            }
+            if (v.status !== undefined && typeof v.status !== "number") {
+                throw new Error(`redirects["${from}"].status must be a number in ${sourcePath}`);
+            }
+            out[from] = { to: v.to, ...(v.status !== undefined ? { status: v.status } : {}) };
+            continue;
+        }
+        throw new Error(`redirects["${from}"] must be a path string or { to, status } in ${sourcePath}`);
+    }
+    return out;
+}

package/dist/config/schema.d.ts

@@ -124,6 +124,22 @@ export interface DogsbayConfig {
      * See plans/cli-grammar.md.
      */
     outputs?: OutputTarget[];
+    /**
+     * Redirects for paths with no surviving page — bulk moves, retired
+     * sections, external targets. `"/old/": "/new/"` is shorthand for a 301.
+     * A page that still exists should declare `aliases:` in its own
+     * frontmatter instead, so the knowledge is deleted with the page.
+     * See plans/redirects-and-aliases.md.
+     */
+    redirects?: Record<string, string | {
+        to: string;
+        status?: number;
+    }>;
+    /**
+     * "Powered by DogsBay" footer attribution on generated sites. Default true.
+     * Set `poweredBy: false` to remove it. See docs/powered-by.md.
+     */
+    poweredBy?: boolean;
     deploy?: DeployConfig;
     /**
      * Build / asset behaviour. Knobs that affect how the site

package/dist/config/to-astro-options.js

@@ -27,6 +27,8 @@ export function configToAstroOptions(config) {
         plausibleDomain: config.analytics?.plausible?.domain,
         plausibleScriptUrl: config.analytics?.plausible?.scriptUrl,
         deploy: config.deploy?.target,
+        redirects: config.redirects,
+        poweredBy: config.poweredBy,
         inlineStylesheets: config.build?.inlineStylesheets,
         navMode: config.build?.navMode,
         llmsTxt: config.agent?.llmsTxt,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.112",
+  "version": "0.2.0-beta.114",
   "description": "CLI for Dogsbay — scaffold, build, and serve documentation sites with markdown / MkDocs / Obsidian / OpenAPI sources",
   "type": "module",
   "bin": {
@@ -42,32 +42,32 @@
     "typescript": "^5.9.3",
     "valibot": "1.1.0",
     "yaml": "^2.9.0",
-    "@dogsbay/adoc2md-modular": "0.2.0-beta.112",
-    "@dogsbay/autodoc-python": "0.2.0-beta.112",
-    "@dogsbay/format-asciidoc": "0.2.0-beta.112",
-    "@dogsbay/format-astro": "0.2.0-beta.112",
-    "@dogsbay/format-dita": "0.2.0-beta.112",
-    "@dogsbay/commands": "0.2.0-beta.112",
-    "@dogsbay/format-docusaurus": "0.2.0-beta.112",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.112",
-    "@dogsbay/format-fluidtopics-markdown": "0.2.0-beta.112",
-    "@dogsbay/format-gatsby": "0.2.0-beta.112",
-    "@dogsbay/format-gitbook": "0.2.0-beta.112",
-    "@dogsbay/format-hugo": "0.2.0-beta.112",
-    "@dogsbay/format-fluidtopics-rest": "0.2.0-beta.112",
-    "@dogsbay/format-mdx": "0.2.0-beta.112",
-    "@dogsbay/format-mkdocs": "0.2.0-beta.112",
-    "@dogsbay/format-myst": "0.2.0-beta.112",
-    "@dogsbay/format-obsidian": "0.2.0-beta.112",
-    "@dogsbay/format-openapi": "0.2.0-beta.112",
-    "@dogsbay/format-rst": "0.2.0-beta.112",
-    "@dogsbay/format-starlight": "0.2.0-beta.112",
-    "@dogsbay/format-openknowledge": "0.2.0-beta.112",
-    "@dogsbay/format-topicmap": "0.2.0-beta.112",
-    "@dogsbay/minja": "0.2.0-beta.112",
-    "@dogsbay/format-vitepress": "0.2.0-beta.112",
-    "@dogsbay/serialize-core": "0.2.0-beta.112",
-    "@dogsbay/types": "0.2.0-beta.112"
+    "@dogsbay/adoc2md-modular": "0.2.0-beta.114",
+    "@dogsbay/autodoc-python": "0.2.0-beta.114",
+    "@dogsbay/commands": "0.2.0-beta.114",
+    "@dogsbay/format-asciidoc": "0.2.0-beta.114",
+    "@dogsbay/format-astro": "0.2.0-beta.114",
+    "@dogsbay/format-dita": "0.2.0-beta.114",
+    "@dogsbay/format-docusaurus": "0.2.0-beta.114",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.114",
+    "@dogsbay/format-fluidtopics-markdown": "0.2.0-beta.114",
+    "@dogsbay/format-fluidtopics-rest": "0.2.0-beta.114",
+    "@dogsbay/format-gatsby": "0.2.0-beta.114",
+    "@dogsbay/format-gitbook": "0.2.0-beta.114",
+    "@dogsbay/format-hugo": "0.2.0-beta.114",
+    "@dogsbay/format-mdx": "0.2.0-beta.114",
+    "@dogsbay/format-mkdocs": "0.2.0-beta.114",
+    "@dogsbay/format-myst": "0.2.0-beta.114",
+    "@dogsbay/format-obsidian": "0.2.0-beta.114",
+    "@dogsbay/format-openapi": "0.2.0-beta.114",
+    "@dogsbay/format-openknowledge": "0.2.0-beta.114",
+    "@dogsbay/format-rst": "0.2.0-beta.114",
+    "@dogsbay/format-starlight": "0.2.0-beta.114",
+    "@dogsbay/format-topicmap": "0.2.0-beta.114",
+    "@dogsbay/format-vitepress": "0.2.0-beta.114",
+    "@dogsbay/serialize-core": "0.2.0-beta.114",
+    "@dogsbay/minja": "0.2.0-beta.114",
+    "@dogsbay/types": "0.2.0-beta.114"
   },
   "devDependencies": {
     "@types/markdown-it": "^14.1.2",