pokedocs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wesley Huber
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * pokedocs CLI entry point. `deploy init` is live (F1.7); the other
+ * commands arrive with their milestones (see src/index.ts).
+ */
+export declare function runCli(argv: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAgEH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5D"}

package/dist/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * pokedocs CLI entry point. `deploy init` is live (F1.7); the other
+ * commands arrive with their milestones (see src/index.ts).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+const node_util_1 = require("node:util");
+const init_js_1 = require("./deploy/init.js");
+const index_js_1 = require("./index.js");
+const DEPLOY_USAGE = `Usage: pokedocs deploy init <target> [options]
+
+Targets:
+${(0, init_js_1.targetList)()}
+
+Options:
+  --base-url <path>  Base path override (default: read from docusaurus.config)
+  --domain <host>    Custom domain (github-pages: writes static/CNAME)
+  --force            Overwrite existing files
+  -h, --help         Show this help
+`;
+async function runDeploy(rest) {
+    let values;
+    let positionals;
+    try {
+        ({ values, positionals } = (0, node_util_1.parseArgs)({
+            args: rest,
+            allowPositionals: true,
+            options: {
+                'base-url': { type: 'string' },
+                domain: { type: 'string' },
+                force: { type: 'boolean', default: false },
+                help: { type: 'boolean', short: 'h', default: false },
+            },
+        }));
+    }
+    catch (error) {
+        console.error(`pokedocs: ${error.message}\n\n${DEPLOY_USAGE}`);
+        return 1;
+    }
+    if (values.help || positionals.length === 0) {
+        console.log(DEPLOY_USAGE);
+        return values.help ? 0 : 1;
+    }
+    try {
+        const result = await (0, init_js_1.runDeployInit)(positionals[0], process.cwd(), {
+            baseUrl: values['base-url'],
+            domain: values.domain,
+            force: values.force,
+        });
+        console.log(`pokedocs deploy init ${result.target}: wrote ${result.written.join(', ')}\n\n${result.nextSteps}`);
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof init_js_1.DeployInitError) {
+            console.error(`pokedocs: ${error.message}`);
+            return 1;
+        }
+        throw error;
+    }
+}
+async function runCli(argv) {
+    const [command, subcommand, ...rest] = argv;
+    if (command === 'deploy') {
+        if (subcommand !== 'init') {
+            console.error(DEPLOY_USAGE);
+            return 1;
+        }
+        return runDeploy(rest);
+    }
+    if (command && index_js_1.COMMANDS.includes(command)) {
+        console.error(`pokedocs ${command} is not implemented yet — follow along at github.com/wbaxterh/pokedocs`);
+        return 1;
+    }
+    console.error(`pokedocs — agent-native docs tooling.\n\nCommands:\n  deploy init <target>   scaffold deploy artifacts\n  check, export, mcp     coming with their milestones\n\n${DEPLOY_USAGE}`);
+    return 1;
+}
+if (require.main === module) {
+    runCli(process.argv.slice(2)).then((code) => {
+        process.exitCode = code;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/deploy/docker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Docker/nginx target (S1.7.2): a maintained multi-stage build — node +
+ * chromium builder (build-time mermaid needs a browser), static files
+ * behind unprivileged nginx. Non-root runtime, port 8080, try_files
+ * derived from the site's configured baseUrl.
+ */
+import type { DeployTarget } from './targets.js';
+export declare const dockerTarget: DeployTarget;
+//# sourceMappingURL=docker.d.ts.map

package/dist/deploy/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/deploy/docker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA+DjD,eAAO,MAAM,YAAY,EAAE,YAkB1B,CAAC"}

package/dist/deploy/docker.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Docker/nginx target (S1.7.2): a maintained multi-stage build — node +
+ * chromium builder (build-time mermaid needs a browser), static files
+ * behind unprivileged nginx. Non-root runtime, port 8080, try_files
+ * derived from the site's configured baseUrl.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerTarget = void 0;
+function dockerfile(baseUrl) {
+    const mount = baseUrl === '/' ? '' : baseUrl.replace(/\/$/, '');
+    return `# Build stage: node + chromium (mermaid renders to SVG at build time)
+FROM node:22-bookworm AS builder
+WORKDIR /site
+COPY package.json package-lock.json* ./
+RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
+RUN npx playwright install --with-deps chromium
+COPY . .
+# Site URL override at image build time (S1.7.3), e.g.
+#   docker build --build-arg POKEDOCS_URL=https://docs.mycompany.dev .
+ARG POKEDOCS_URL
+ARG POKEDOCS_BASE_URL
+ENV POKEDOCS_URL=\${POKEDOCS_URL} POKEDOCS_BASE_URL=\${POKEDOCS_BASE_URL}
+RUN npm run build
+
+# Runtime stage: static files behind unprivileged nginx (non-root, port 8080)
+FROM nginxinc/nginx-unprivileged:1.27-alpine
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=builder /site/build /usr/share/nginx/html${mount}
+EXPOSE 8080
+`;
+}
+function nginxConf(baseUrl) {
+    const rootRedirect = baseUrl === '/'
+        ? ''
+        : `
+  # The site lives under ${baseUrl} — bounce the bare root there.
+  location = / {
+    return 302 ${baseUrl};
+  }
+`;
+    return `server {
+  listen 8080;
+  server_name _;
+
+  root /usr/share/nginx/html;
+  index index.html;
+
+  gzip on;
+  gzip_types text/plain text/css application/javascript application/json image/svg+xml;
+
+  error_page 404 ${baseUrl}404.html;
+${rootRedirect}
+  # Docusaurus emits a directory per route with an index.html; markdown
+  # twins, llms.txt, and other agent artifacts are plain files.
+  location ${baseUrl} {
+    try_files $uri $uri/ =404;
+  }
+}
+`;
+}
+const DOCKERIGNORE = `node_modules
+build
+.docusaurus
+.git
+`;
+exports.dockerTarget = {
+    name: 'docker',
+    description: 'Multi-stage Dockerfile + non-root nginx for self-hosting',
+    files({ baseUrl }) {
+        return [
+            { path: 'Dockerfile', content: dockerfile(baseUrl) },
+            { path: 'nginx.conf', content: nginxConf(baseUrl) },
+            { path: '.dockerignore', content: DOCKERIGNORE },
+        ];
+    },
+    nextSteps({ baseUrl }) {
+        return [
+            'Build and run:',
+            '  docker build -t my-docs .',
+            '  docker run --rm -p 8080:8080 my-docs',
+            `Then open http://localhost:8080${baseUrl}`,
+        ].join('\n');
+    },
+};
+//# sourceMappingURL=docker.js.map

package/dist/deploy/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/deploy/docker.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,KAAK,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChE,OAAO;;;;;;;;;;;;;;;;;uDAiB8C,KAAK;;CAE3D,CAAC;AACF,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,YAAY,GAChB,OAAO,KAAK,GAAG;QACb,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;2BACmB,OAAO;;iBAEjB,OAAO;;CAEvB,CAAC;IACA,OAAO;;;;;;;;;;mBAUU,OAAO;EACxB,YAAY;;;aAGD,OAAO;;;;CAInB,CAAC;AACF,CAAC;AAED,MAAM,YAAY,GAAG;;;;CAIpB,CAAC;AAEW,QAAA,YAAY,GAAiB;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,0DAA0D;IACvE,KAAK,CAAC,EAAE,OAAO,EAAE;QACf,OAAO;YACL,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE;YACpD,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE;YACnD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE;SACjD,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,EAAE,OAAO,EAAE;QACnB,OAAO;YACL,gBAAgB;YAChB,6BAA6B;YAC7B,wCAAwC;YACxC,kCAAkC,OAAO,EAAE;SAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/deploy/github-pages.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GitHub Pages target (S1.7.1): the same workflow shape that deploys the
+ * PokeDocs dogfood site on every merge — checkout, npm install, chromium
+ * for build-time mermaid (cached), build, upload-pages-artifact,
+ * deploy-pages. Non-Actions setups also get .nojekyll, and --domain
+ * writes the CNAME.
+ */
+import type { DeployTarget } from './targets.js';
+export declare const githubPagesTarget: DeployTarget;
+//# sourceMappingURL=github-pages.d.ts.map

package/dist/deploy/github-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pages.d.ts","sourceRoot":"","sources":["../../src/deploy/github-pages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAqDjD,eAAO,MAAM,iBAAiB,EAAE,YAsB/B,CAAC"}

package/dist/deploy/github-pages.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * GitHub Pages target (S1.7.1): the same workflow shape that deploys the
+ * PokeDocs dogfood site on every merge — checkout, npm install, chromium
+ * for build-time mermaid (cached), build, upload-pages-artifact,
+ * deploy-pages. Non-Actions setups also get .nojekyll, and --domain
+ * writes the CNAME.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.githubPagesTarget = void 0;
+const WORKFLOW = `name: Deploy Docs
+
+# Publishes to GitHub Pages on every push to main. One-time setup:
+# repo Settings → Pages → Source: "GitHub Actions".
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: deploy-docs
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - name: Cache playwright browsers
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-\${{ runner.os }}-\${{ hashFiles('package-lock.json') }}
+      # Mermaid renders at build time via chromium
+      - run: npx playwright install --with-deps chromium
+      - run: npm run build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: build
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: \${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4
+`;
+exports.githubPagesTarget = {
+    name: 'github-pages',
+    description: 'GitHub Actions workflow publishing to GitHub Pages',
+    files({ domain }) {
+        return [
+            { path: '.github/workflows/deploy.yml', content: WORKFLOW },
+            // Harmless under actions/deploy-pages; protects anyone who later
+            // serves the build/ dir from a branch, where Jekyll would eat
+            // underscore-prefixed asset paths.
+            { path: 'static/.nojekyll', content: '' },
+            ...(domain ? [{ path: 'static/CNAME', content: `${domain}\n` }] : []),
+        ];
+    },
+    nextSteps({ domain, baseUrl }) {
+        const lines = [
+            'Push to main, then set repo Settings → Pages → Source to "GitHub Actions".',
+            domain
+                ? `Custom domain: set \`url: 'https://${domain}'\` and \`baseUrl: '/'\` in docusaurus.config.ts, and configure the domain under Settings → Pages.`
+                : `Project pages serve from https://<owner>.github.io/<repo>/ — make sure url/baseUrl match (current baseUrl: ${baseUrl}).`,
+        ];
+        return lines.join('\n');
+    },
+};
+//# sourceMappingURL=github-pages.js.map

package/dist/deploy/github-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pages.js","sourceRoot":"","sources":["../../src/deploy/github-pages.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIH,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDhB,CAAC;AAEW,QAAA,iBAAiB,GAAiB;IAC7C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,oDAAoD;IACjE,KAAK,CAAC,EAAE,MAAM,EAAE;QACd,OAAO;YACL,EAAE,IAAI,EAAE,8BAA8B,EAAE,OAAO,EAAE,QAAQ,EAAE;YAC3D,iEAAiE;YACjE,8DAA8D;YAC9D,mCAAmC;YACnC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,EAAE;YACzC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE;QAC3B,MAAM,KAAK,GAAG;YACZ,4EAA4E;YAC5E,MAAM;gBACJ,CAAC,CAAC,sCAAsC,MAAM,oGAAoG;gBAClJ,CAAC,CAAC,8GAA8G,OAAO,IAAI;SAC9H,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC"}

package/dist/deploy/init.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `pokedocs deploy init <target>` — resolves the site context, asks the
+ * target for its files, and writes them without clobbering anything
+ * unless --force.
+ */
+import type { DeployTarget } from './targets.js';
+export declare const DEPLOY_TARGETS: DeployTarget[];
+export declare class DeployInitError extends Error {
+}
+export interface DeployInitFlags {
+    baseUrl?: string;
+    domain?: string;
+    force?: boolean;
+}
+export interface DeployInitResult {
+    target: string;
+    written: string[];
+    nextSteps: string;
+}
+export declare function targetList(): string;
+export declare function runDeployInit(targetName: string, siteDir: string, flags?: DeployInitFlags): Promise<DeployInitResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/deploy/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/deploy/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,cAAc,CAAC;AAGpE,eAAO,MAAM,cAAc,EAAE,YAAY,EAAsC,CAAC;AAEhF,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,eAAoB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAkD3B"}

package/dist/deploy/init.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * `pokedocs deploy init <target>` — resolves the site context, asks the
+ * target for its files, and writes them without clobbering anything
+ * unless --force.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeployInitError = exports.DEPLOY_TARGETS = void 0;
+exports.targetList = targetList;
+exports.runDeployInit = runDeployInit;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const docker_js_1 = require("./docker.js");
+const github_pages_js_1 = require("./github-pages.js");
+const targets_js_1 = require("./targets.js");
+exports.DEPLOY_TARGETS = [github_pages_js_1.githubPagesTarget, docker_js_1.dockerTarget];
+class DeployInitError extends Error {
+}
+exports.DeployInitError = DeployInitError;
+function targetList() {
+    return exports.DEPLOY_TARGETS.map((t) => `  ${t.name.padEnd(14)}${t.description}`).join('\n');
+}
+async function runDeployInit(targetName, siteDir, flags = {}) {
+    const target = exports.DEPLOY_TARGETS.find((t) => t.name === targetName);
+    if (!target) {
+        throw new DeployInitError(`unknown deploy target ${JSON.stringify(targetName)}. Available targets:\n${targetList()}`);
+    }
+    const configFile = await (0, targets_js_1.findSiteConfig)(siteDir);
+    if (!configFile) {
+        throw new DeployInitError(`no docusaurus.config.ts/js found in ${siteDir} — run this from your site directory.`);
+    }
+    let baseUrl = flags.baseUrl;
+    if (baseUrl === undefined) {
+        baseUrl = (0, targets_js_1.parseBaseUrl)(await (0, promises_1.readFile)(configFile, 'utf8')) ?? '/';
+    }
+    const context = {
+        siteDir,
+        baseUrl: (0, targets_js_1.normalizeBaseUrl)(baseUrl),
+        domain: flags.domain,
+    };
+    const files = target.files(context);
+    if (!flags.force) {
+        for (const file of files) {
+            const existing = await (0, promises_1.readFile)(node_path_1.default.join(siteDir, file.path), 'utf8').catch(() => null);
+            if (existing !== null && existing !== file.content) {
+                throw new DeployInitError(`${file.path} already exists — re-run with --force to overwrite.`);
+            }
+        }
+    }
+    const written = [];
+    for (const file of files) {
+        const absolute = node_path_1.default.join(siteDir, file.path);
+        await (0, promises_1.mkdir)(node_path_1.default.dirname(absolute), { recursive: true });
+        await (0, promises_1.writeFile)(absolute, file.content);
+        written.push(file.path);
+    }
+    return { target: target.name, written, nextSteps: target.nextSteps(context) };
+}
+//# sourceMappingURL=init.js.map

package/dist/deploy/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/deploy/init.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAyBH,gCAIC;AAED,sCAsDC;AAnFD,+CAA8D;AAC9D,0DAA6B;AAC7B,2CAA2C;AAC3C,uDAAsD;AAEtD,6CAA8E;AAEjE,QAAA,cAAc,GAAmB,CAAC,mCAAiB,EAAE,wBAAY,CAAC,CAAC;AAEhF,MAAa,eAAgB,SAAQ,KAAK;CAAG;AAA7C,0CAA6C;AAc7C,SAAgB,UAAU;IACxB,OAAO,sBAAc,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,OAAe,EACf,QAAyB,EAAE;IAE3B,MAAM,MAAM,GAAG,sBAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,eAAe,CACvB,yBAAyB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,yBAAyB,UAAU,EAAE,EAAE,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,IAAA,2BAAc,EAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,eAAe,CACvB,uCAAuC,OAAO,uCAAuC,CACtF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAA,yBAAY,EAAC,MAAM,IAAA,mBAAQ,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC;IACpE,CAAC;IACD,MAAM,OAAO,GAAsB;QACjC,OAAO;QACP,OAAO,EAAE,IAAA,6BAAgB,EAAC,OAAO,CAAC;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEpC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,MAAM,IAAA,mBAAQ,EAC7B,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAC7B,MAAM,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACnD,MAAM,IAAI,eAAe,CACvB,GAAG,IAAI,CAAC,IAAI,qDAAqD,CAClE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,IAAA,gBAAK,EAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/deploy/targets.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `pokedocs deploy init` plumbing (S1.7.1): pluggable targets that emit
+ * verified deploy artifacts into an existing site. Each target is pure —
+ * files in, files out — so targets are unit-testable and adding one is a
+ * single registry entry.
+ */
+export interface DeployInitContext {
+    /** Absolute site directory. */
+    siteDir: string;
+    /** The site's base path, e.g. "/" or "/my-docs/". */
+    baseUrl: string;
+    /** Custom domain (github-pages): writes static/CNAME. */
+    domain?: string;
+}
+export interface EmittedFile {
+    /** Path relative to the site dir. */
+    path: string;
+    content: string;
+}
+export interface DeployTarget {
+    name: string;
+    description: string;
+    files(context: DeployInitContext): EmittedFile[];
+    nextSteps(context: DeployInitContext): string;
+}
+export declare function findSiteConfig(siteDir: string): Promise<string | null>;
+/**
+ * Best-effort baseUrl from the config source: the first string literal on
+ * the `baseUrl:` line — which is the fallback in scaffolded configs like
+ * `baseUrl: process.env.POKEDOCS_BASE_URL ?? '/my-docs/'`.
+ */
+export declare function parseBaseUrl(configSource: string): string | null;
+/** Normalize to leading+trailing slash form ('/', '/my-docs/'). */
+export declare function normalizeBaseUrl(baseUrl: string): string;
+//# sourceMappingURL=targets.d.ts.map

package/dist/deploy/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/deploy/targets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,EAAE,CAAC;IACjD,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC;CAC/C;AAQD,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY5E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASxD"}

package/dist/deploy/targets.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * `pokedocs deploy init` plumbing (S1.7.1): pluggable targets that emit
+ * verified deploy artifacts into an existing site. Each target is pure —
+ * files in, files out — so targets are unit-testable and adding one is a
+ * single registry entry.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findSiteConfig = findSiteConfig;
+exports.parseBaseUrl = parseBaseUrl;
+exports.normalizeBaseUrl = normalizeBaseUrl;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const CONFIG_FILES = [
+    'docusaurus.config.ts',
+    'docusaurus.config.js',
+    'docusaurus.config.mjs',
+];
+async function findSiteConfig(siteDir) {
+    for (const name of CONFIG_FILES) {
+        const file = node_path_1.default.join(siteDir, name);
+        const found = await (0, promises_1.readFile)(file, 'utf8').then(() => file, () => null);
+        if (found) {
+            return found;
+        }
+    }
+    return null;
+}
+/**
+ * Best-effort baseUrl from the config source: the first string literal on
+ * the `baseUrl:` line — which is the fallback in scaffolded configs like
+ * `baseUrl: process.env.POKEDOCS_BASE_URL ?? '/my-docs/'`.
+ */
+function parseBaseUrl(configSource) {
+    const match = configSource.match(/baseUrl:[^\n]*?['"`]([^'"`]*)['"`]/);
+    return match ? match[1] : null;
+}
+/** Normalize to leading+trailing slash form ('/', '/my-docs/'). */
+function normalizeBaseUrl(baseUrl) {
+    let normalized = baseUrl.trim();
+    if (!normalized.startsWith('/')) {
+        normalized = `/${normalized}`;
+    }
+    if (!normalized.endsWith('/')) {
+        normalized = `${normalized}/`;
+    }
+    return normalized;
+}
+//# sourceMappingURL=targets.js.map

package/dist/deploy/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/deploy/targets.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAiCH,wCAYC;AAOD,oCAGC;AAGD,4CASC;AAjED,+CAA4C;AAC5C,0DAA6B;AAwB7B,MAAM,YAAY,GAAG;IACnB,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;CACxB,CAAC;AAEK,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAC7C,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,IAAI,CACX,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,YAAoB;IAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,mEAAmE;AACnE,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,IAAI,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,UAAU,GAAG,GAAG,UAAU,GAAG,CAAC;IAChC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * pokedocs — the CLI (PRD F1.7, F2.1, F5.2).
+ *
+ * Commands land milestone by milestone:
+ *   deploy init  — scaffold deploy artifacts per platform (M1, S1.7.1/S1.7.2)
+ *   check        — the docs linter for what a green build won't catch (M2, F2.1)
+ *   export pdf   — themed PDF export driven by the real sidebar (M5, S5.2.1)
+ *   mcp          — optional local docs MCP server (M3, S3.3.2)
+ *
+ * Design constraint (PRD Open Question 5): Docusaurus CLI commands are not
+ * natively site-context-aware; commands here likely consume context cached
+ * at build time.
+ */
+export declare const COMMANDS: readonly ["check", "export", "deploy", "mcp"];
+export type PokedocsCommand = (typeof COMMANDS)[number];
+export { DEPLOY_TARGETS, DeployInitError, type DeployInitFlags, type DeployInitResult, runDeployInit, targetList, } from './deploy/init.js';
+export type { DeployInitContext, DeployTarget, EmittedFile, } from './deploy/targets.js';
+export { normalizeBaseUrl, parseBaseUrl, } from './deploy/targets.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,QAAQ,+CAAgD,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,aAAa,EACb,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * pokedocs — the CLI (PRD F1.7, F2.1, F5.2).
+ *
+ * Commands land milestone by milestone:
+ *   deploy init  — scaffold deploy artifacts per platform (M1, S1.7.1/S1.7.2)
+ *   check        — the docs linter for what a green build won't catch (M2, F2.1)
+ *   export pdf   — themed PDF export driven by the real sidebar (M5, S5.2.1)
+ *   mcp          — optional local docs MCP server (M3, S3.3.2)
+ *
+ * Design constraint (PRD Open Question 5): Docusaurus CLI commands are not
+ * natively site-context-aware; commands here likely consume context cached
+ * at build time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBaseUrl = exports.normalizeBaseUrl = exports.targetList = exports.runDeployInit = exports.DeployInitError = exports.DEPLOY_TARGETS = exports.COMMANDS = void 0;
+exports.COMMANDS = ['check', 'export', 'deploy', 'mcp'];
+var init_js_1 = require("./deploy/init.js");
+Object.defineProperty(exports, "DEPLOY_TARGETS", { enumerable: true, get: function () { return init_js_1.DEPLOY_TARGETS; } });
+Object.defineProperty(exports, "DeployInitError", { enumerable: true, get: function () { return init_js_1.DeployInitError; } });
+Object.defineProperty(exports, "runDeployInit", { enumerable: true, get: function () { return init_js_1.runDeployInit; } });
+Object.defineProperty(exports, "targetList", { enumerable: true, get: function () { return init_js_1.targetList; } });
+var targets_js_1 = require("./deploy/targets.js");
+Object.defineProperty(exports, "normalizeBaseUrl", { enumerable: true, get: function () { return targets_js_1.normalizeBaseUrl; } });
+Object.defineProperty(exports, "parseBaseUrl", { enumerable: true, get: function () { return targets_js_1.parseBaseUrl; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEU,QAAA,QAAQ,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAGtE,4CAO0B;AANxB,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AAGf,wGAAA,aAAa,OAAA;AACb,qGAAA,UAAU,OAAA;AAOZ,kDAG6B;AAF3B,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "pokedocs",
+  "version": "0.1.0",
+  "description": "PokeDocs CLI — check, export, deploy init, mcp",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wbaxterh/pokedocs.git",
+    "directory": "packages/pokedocs"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "pokedocs": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}