specweave 0.8.3 → 0.8.4

package/dist/utils/docs-preview.bak/config-generator.js

@@ -0,0 +1,377 @@
+/**
+ * Docusaurus configuration generator
+ * Generates docusaurus.config.js with sensible defaults
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+/**
+ * Generate docusaurus.config.js content
+ */
+export function generateDocusaurusConfig(config) {
+    const { title, tagline, url, baseUrl, docsPath, theme = 'default' } = config;
+    return `// @ts-check
+// This is a Docusaurus site configuration object.
+// Auto-generated by SpecWeave docs-preview plugin
+// Generated: ${new Date().toISOString()}
+
+import {themes as prismThemes} from 'prism-react-renderer';
+
+/** @type {import('@docusaurus/types').Config} */
+const config = {
+  title: '${title}',
+  tagline: '${tagline}',
+  favicon: 'img/favicon.ico',
+
+  // Production URL
+  url: '${url}',
+  baseUrl: '${baseUrl}',
+
+  // GitHub Pages deployment config
+  organizationName: 'your-org',
+  projectName: 'your-repo',
+
+  onBrokenLinks: 'warn',
+  onBrokenMarkdownLinks: 'warn',
+
+  // Internationalization
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en'],
+  },
+
+  presets: [
+    [
+      'classic',
+      /** @type {import('@docusaurus/preset-classic').Options} */
+      ({
+        docs: {
+          routeBasePath: '/',
+          path: '${docsPath}',
+          sidebarPath: './sidebars.js',
+          editUrl: undefined, // Disable "Edit this page" for internal docs
+        },
+        blog: false, // Disable blog
+        theme: {
+          customCss: './src/css/custom.css',
+        },
+      }),
+    ],
+  ],
+
+  themeConfig:
+    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
+    ({
+      // Social card image (optional)
+      image: 'img/docusaurus-social-card.jpg',
+
+      navbar: {
+        title: '${title}',
+        logo: {
+          alt: '${title} Logo',
+          src: 'img/logo.svg',
+        },
+        items: [
+          {
+            type: 'docSidebar',
+            sidebarId: 'docs',
+            position: 'left',
+            label: 'Documentation',
+          },
+        ],
+      },
+
+      footer: {
+        style: 'dark',
+        links: [
+          {
+            title: 'Documentation',
+            items: [
+              {
+                label: 'Strategy',
+                to: '/strategy',
+              },
+              {
+                label: 'Architecture',
+                to: '/architecture',
+              },
+            ],
+          },
+        ],
+        copyright: \`Copyright © \${new Date().getFullYear()} SpecWeave. Built with Docusaurus.\`,
+      },
+
+      prism: {
+        theme: prismThemes.github,
+        darkTheme: prismThemes.dracula,
+        additionalLanguages: ['bash', 'typescript', 'javascript', 'json', 'yaml'],
+      },
+    }),
+
+  // Mermaid diagrams support
+  markdown: {
+    mermaid: true,
+  },
+  themes: ['@docusaurus/theme-mermaid'],
+};
+
+export default config;
+`;
+}
+/**
+ * Write docusaurus.config.js to file
+ */
+export async function writeDocusaurusConfig(targetDir, config) {
+    const configPath = path.join(targetDir, 'docusaurus.config.js');
+    const content = generateDocusaurusConfig(config);
+    await fs.ensureDir(targetDir);
+    await fs.writeFile(configPath, content, 'utf-8');
+}
+/**
+ * Generate package.json for Docusaurus site
+ */
+export function generatePackageJSON(title) {
+    return JSON.stringify({
+        name: 'specweave-docs',
+        version: '1.0.0',
+        description: `${title} - Documentation Site`,
+        private: true,
+        scripts: {
+            docusaurus: 'docusaurus',
+            start: 'docusaurus start',
+            build: 'docusaurus build',
+            swizzle: 'docusaurus swizzle',
+            deploy: 'docusaurus deploy',
+            clear: 'docusaurus clear',
+            serve: 'docusaurus serve',
+            'write-translations': 'docusaurus write-translations',
+            'write-heading-ids': 'docusaurus write-heading-ids'
+        },
+        dependencies: {
+            '@docusaurus/core': '^3.0.0',
+            '@docusaurus/preset-classic': '^3.0.0',
+            '@docusaurus/theme-mermaid': '^3.0.0',
+            '@mdx-js/react': '^3.0.0',
+            'clsx': '^2.0.0',
+            'prism-react-renderer': '^2.1.0',
+            'react': '^18.0.0',
+            'react-dom': '^18.0.0'
+        },
+        devDependencies: {
+            '@docusaurus/module-type-aliases': '^3.0.0',
+            '@docusaurus/types': '^3.0.0'
+        },
+        engines: {
+            node: '>=18.0'
+        }
+    }, null, 2);
+}
+/**
+ * Write package.json to file
+ */
+export async function writePackageJSON(targetDir, title) {
+    const packagePath = path.join(targetDir, 'package.json');
+    const content = generatePackageJSON(title);
+    await fs.ensureDir(targetDir);
+    await fs.writeFile(packagePath, content, 'utf-8');
+}
+/**
+ * Generate custom CSS for theme customization
+ */
+export function generateCustomCSS(theme) {
+    const themes = {
+        default: `
+:root {
+  --ifm-color-primary: #2e8555;
+  --ifm-color-primary-dark: #29784c;
+  --ifm-color-primary-darker: #277148;
+  --ifm-color-primary-darkest: #205d3b;
+  --ifm-color-primary-light: #33925d;
+  --ifm-color-primary-lighter: #359962;
+  --ifm-color-primary-lightest: #3cad6e;
+  --ifm-code-font-size: 95%;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
+}
+
+[data-theme='dark'] {
+  --ifm-color-primary: #25c2a0;
+  --ifm-color-primary-dark: #21af90;
+  --ifm-color-primary-darker: #1fa588;
+  --ifm-color-primary-darkest: #1a8870;
+  --ifm-color-primary-light: #29d5b0;
+  --ifm-color-primary-lighter: #32d8b4;
+  --ifm-color-primary-lightest: #4fddbf;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
+}
+`,
+        classic: `
+:root {
+  --ifm-color-primary: #0066cc;
+  --ifm-color-primary-dark: #005cb8;
+  --ifm-color-primary-darker: #0056ad;
+  --ifm-color-primary-darkest: #00478f;
+  --ifm-color-primary-light: #0070e0;
+  --ifm-color-primary-lighter: #0076eb;
+  --ifm-color-primary-lightest: #1a85ff;
+  --ifm-code-font-size: 95%;
+}
+`,
+        dark: `
+:root {
+  --ifm-color-primary: #1e1e1e;
+  --ifm-background-color: #0d1117;
+  --ifm-code-font-size: 95%;
+}
+
+[data-theme='dark'] {
+  --ifm-color-primary: #58a6ff;
+  --ifm-background-color: #0d1117;
+}
+`
+    };
+    return `/**
+ * Custom CSS for SpecWeave documentation
+ * Theme: ${theme}
+ * Auto-generated by SpecWeave docs-preview plugin
+ */
+
+${themes[theme]}
+
+/* Custom styles */
+.markdown {
+  --ifm-h1-font-size: 2rem;
+  --ifm-h2-font-size: 1.5rem;
+  --ifm-h3-font-size: 1.25rem;
+}
+
+/* Code blocks */
+.prism-code {
+  font-size: 0.9rem;
+}
+
+/* Mermaid diagrams */
+.docusaurus-mermaid-container {
+  text-align: center;
+  margin: 2rem 0;
+}
+`;
+}
+/**
+ * Write custom CSS to file
+ */
+export async function writeCustomCSS(targetDir, theme) {
+    const cssPath = path.join(targetDir, 'src', 'css', 'custom.css');
+    const content = generateCustomCSS(theme);
+    await fs.ensureDir(path.dirname(cssPath));
+    await fs.writeFile(cssPath, content, 'utf-8');
+}
+/**
+ * Generate index page (landing page)
+ */
+export function generateIndexPage(title, tagline) {
+    return `import React from 'react';
+import clsx from 'clsx';
+import Link from '@docusaurus/Link';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+import Layout from '@theme/Layout';
+import styles from './index.module.css';
+
+function HomepageHeader() {
+  const {siteConfig} = useDocusaurusContext();
+  return (
+    <header className={clsx('hero hero--primary', styles.heroBanner)}>
+      <div className="container">
+        <h1 className="hero__title">{siteConfig.title}</h1>
+        <p className="hero__subtitle">{siteConfig.tagline}</p>
+        <div className={styles.buttons}>
+          <Link
+            className="button button--secondary button--lg"
+            to="/strategy">
+            View Documentation
+          </Link>
+        </div>
+      </div>
+    </header>
+  );
+}
+
+export default function Home() {
+  const {siteConfig} = useDocusaurusContext();
+  return (
+    <Layout
+      title={\`\${siteConfig.title}\`}
+      description="${tagline}">
+      <HomepageHeader />
+      <main>
+        <div className="container" style={{marginTop: '2rem', marginBottom: '2rem'}}>
+          <div className="row">
+            <div className="col col--12">
+              <h2>Welcome to ${title}</h2>
+              <p>
+                This is your SpecWeave documentation site, automatically generated from your
+                <code>.specweave/docs/</code> folder.
+              </p>
+              <p>
+                Use the sidebar to navigate through your documentation:
+              </p>
+              <ul>
+                <li><strong>Strategy</strong>: Business rationale, PRDs, OKRs</li>
+                <li><strong>Specs</strong>: Feature specifications and user stories</li>
+                <li><strong>Architecture</strong>: Technical design, ADRs, diagrams</li>
+                <li><strong>Delivery</strong>: Build & release processes</li>
+                <li><strong>Operations</strong>: Runbooks, SLOs, incidents</li>
+                <li><strong>Governance</strong>: Policies, security, compliance</li>
+              </ul>
+            </div>
+          </div>
+        </div>
+      </main>
+    </Layout>
+  );
+}
+`;
+}
+/**
+ * Write index page to file
+ */
+export async function writeIndexPage(targetDir, title, tagline) {
+    const indexPath = path.join(targetDir, 'src', 'pages', 'index.js');
+    const content = generateIndexPage(title, tagline);
+    await fs.ensureDir(path.dirname(indexPath));
+    await fs.writeFile(indexPath, content, 'utf-8');
+}
+/**
+ * Generate index.module.css for landing page styles
+ */
+export function generateIndexModuleCSS() {
+    return `.heroBanner {
+  padding: 4rem 0;
+  text-align: center;
+  position: relative;
+  overflow: hidden;
+}
+
+@media screen and (max-width: 996px) {
+  .heroBanner {
+    padding: 2rem;
+  }
+}
+
+.buttons {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+  margin-top: 2rem;
+}
+`;
+}
+/**
+ * Write index.module.css to file
+ */
+export async function writeIndexModuleCSS(targetDir) {
+    const cssPath = path.join(targetDir, 'src', 'pages', 'index.module.css');
+    const content = generateIndexModuleCSS();
+    await fs.ensureDir(path.dirname(cssPath));
+    await fs.writeFile(cssPath, content, 'utf-8');
+}
+//# sourceMappingURL=config-generator.js.map

package/dist/utils/docs-preview.bak/config-generator.js.map

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

package/dist/utils/docs-preview.bak/package-installer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Package installer for Docusaurus dependencies
+ * Handles npm install with progress tracking
+ */
+import { InstallOptions, NodeVersion } from './types.js';
+/**
+ * Check Node.js version
+ */
+export declare function checkNodeVersion(): Promise<NodeVersion>;
+/**
+ * Check if npm is installed
+ */
+export declare function checkNpmInstalled(): Promise<boolean>;
+/**
+ * Install npm packages
+ */
+export declare function installPackages(options: InstallOptions): Promise<void>;
+/**
+ * Install Docusaurus packages
+ */
+export declare function installDocusaurus(targetDir: string): Promise<void>;
+/**
+ * Check if Docusaurus is installed
+ */
+export declare function isDocusaurusInstalled(targetDir: string): Promise<boolean>;
+/**
+ * Clean npm cache
+ */
+export declare function cleanNpmCache(): Promise<void>;
+/**
+ * Get installed npm package version
+ */
+export declare function getPackageVersion(targetDir: string, packageName: string): Promise<string | null>;
+/**
+ * Estimate install size (rough estimate)
+ */
+export declare function estimateInstallSize(): string;
+/**
+ * Estimate install time (rough estimate)
+ */
+export declare function estimateInstallTime(): string;
+//# sourceMappingURL=package-installer.d.ts.map

package/dist/utils/docs-preview.bak/package-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-installer.d.ts","sourceRoot":"","sources":["../../../src/utils/docs-preview.bak/package-installer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,CAqB7D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO1D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD5E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB/E;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAatG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C"}

package/dist/utils/docs-preview.bak/package-installer.js

@@ -0,0 +1,182 @@
+/**
+ * Package installer for Docusaurus dependencies
+ * Handles npm install with progress tracking
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+import { spawn } from 'child_process';
+import { execFileNoThrow } from '../execFileNoThrow.js';
+/**
+ * Check Node.js version
+ */
+export async function checkNodeVersion() {
+    try {
+        const result = await execFileNoThrow('node', ['--version']);
+        if (result.status !== 0) {
+            throw new Error('Node.js not found');
+        }
+        const versionString = result.stdout.trim().replace('v', '');
+        const [major, minor, patch] = versionString.split('.').map(Number);
+        return {
+            version: versionString,
+            major,
+            minor,
+            patch,
+            compatible: major >= 18
+        };
+    }
+    catch (error) {
+        throw new Error('Node.js not found. Please install Node.js 18+ from https://nodejs.org/');
+    }
+}
+/**
+ * Check if npm is installed
+ */
+export async function checkNpmInstalled() {
+    try {
+        const result = await execFileNoThrow('npm', ['--version']);
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Install npm packages
+ */
+export async function installPackages(options) {
+    const { targetDir, packages, dev = false } = options;
+    // Ensure target directory exists
+    await fs.ensureDir(targetDir);
+    // Build npm install command
+    const args = ['install'];
+    if (dev) {
+        args.push('--save-dev');
+    }
+    args.push(...packages);
+    // Spawn npm install process
+    return new Promise((resolve, reject) => {
+        const npmProcess = spawn('npm', args, {
+            cwd: targetDir,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: true
+        });
+        let stdout = '';
+        let stderr = '';
+        npmProcess.stdout.on('data', (data) => {
+            stdout += data.toString();
+            // Show progress to console
+            process.stdout.write('.');
+        });
+        npmProcess.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        npmProcess.on('close', (code) => {
+            if (code === 0) {
+                console.log(' ✅');
+                resolve();
+            }
+            else {
+                console.log(' ❌');
+                reject(new Error(`npm install failed with code ${code}\n${stderr}`));
+            }
+        });
+        npmProcess.on('error', (error) => {
+            reject(new Error(`Failed to start npm install: ${error.message}`));
+        });
+    });
+}
+/**
+ * Install Docusaurus packages
+ */
+export async function installDocusaurus(targetDir) {
+    const packages = [
+        '@docusaurus/core@^3.0.0',
+        '@docusaurus/preset-classic@^3.0.0',
+        '@docusaurus/theme-mermaid@^3.0.0',
+        '@mdx-js/react@^3.0.0',
+        'clsx@^2.0.0',
+        'prism-react-renderer@^2.1.0',
+        'react@^18.0.0',
+        'react-dom@^18.0.0'
+    ];
+    const devPackages = [
+        '@docusaurus/module-type-aliases@^3.0.0',
+        '@docusaurus/types@^3.0.0'
+    ];
+    console.log('   Installing Docusaurus packages...');
+    await installPackages({
+        targetDir,
+        packages,
+        dev: false
+    });
+    console.log('   Installing dev dependencies...');
+    await installPackages({
+        targetDir,
+        packages: devPackages,
+        dev: true
+    });
+}
+/**
+ * Check if Docusaurus is installed
+ */
+export async function isDocusaurusInstalled(targetDir) {
+    try {
+        const packageJsonPath = path.join(targetDir, 'package.json');
+        const nodeModulesPath = path.join(targetDir, 'node_modules');
+        // Check if package.json exists
+        if (!await fs.pathExists(packageJsonPath)) {
+            return false;
+        }
+        // Check if node_modules exists
+        if (!await fs.pathExists(nodeModulesPath)) {
+            return false;
+        }
+        // Check if @docusaurus/core is installed
+        const docusaurusCorePath = path.join(nodeModulesPath, '@docusaurus', 'core');
+        if (!await fs.pathExists(docusaurusCorePath)) {
+            return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clean npm cache
+ */
+export async function cleanNpmCache() {
+    await execFileNoThrow('npm', ['cache', 'clean', '--force']);
+}
+/**
+ * Get installed npm package version
+ */
+export async function getPackageVersion(targetDir, packageName) {
+    try {
+        const packageJsonPath = path.join(targetDir, 'node_modules', packageName, 'package.json');
+        if (!await fs.pathExists(packageJsonPath)) {
+            return null;
+        }
+        const packageJson = await fs.readJSON(packageJsonPath);
+        return packageJson.version || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Estimate install size (rough estimate)
+ */
+export function estimateInstallSize() {
+    // Docusaurus + React + dependencies ≈ 150-200 MB
+    return '~150 MB';
+}
+/**
+ * Estimate install time (rough estimate)
+ */
+export function estimateInstallTime() {
+    // Typically 20-40 seconds depending on network and CPU
+    return '~30 seconds';
+}
+//# sourceMappingURL=package-installer.js.map

package/dist/utils/docs-preview.bak/package-installer.js.map

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

package/dist/utils/docs-preview.bak/server-manager.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server manager for Docusaurus dev server
+ * Handles port finding, server start/stop, browser opening
+ */
+import { ServerOptions, ServerProcess } from './types.js';
+/**
+ * Find an available port in the given range
+ */
+export declare function findAvailablePort(startPort?: number, endPort?: number): Promise<number>;
+/**
+ * Start Docusaurus dev server
+ */
+export declare function startDevServer(targetDir: string, options: ServerOptions): Promise<ServerProcess>;
+/**
+ * Open URL in default browser
+ */
+export declare function openBrowserUrl(url: string): Promise<void>;
+/**
+ * Kill all Docusaurus processes (SAFE - uses execFileNoThrow)
+ */
+export declare function killAllDocusaurusProcesses(): Promise<number>;
+/**
+ * Check if Docusaurus server is running
+ */
+export declare function isDocusaurusRunning(port: number): Promise<boolean>;
+/**
+ * Get server URL
+ */
+export declare function getServerUrl(port: number, host?: string): string;
+//# sourceMappingURL=server-manager.d.ts.map

package/dist/utils/docs-preview.bak/server-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/docs-preview.bak/server-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,GAAE,MAAa,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzG;AAsBD;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAiCxB;AA8ED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D;AAED;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAwDlE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAoB,GAAG,MAAM,CAE7E"}