specforge-mcp 0.1.0

package/dist/engine/detectors/template-engine-detector.js

@@ -0,0 +1,172 @@
+// engine/detectors/template-engine-detector.ts — SPEC-043
+// Detects server-side template engines by ecosystem.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+// === Detector registry ===
+const TEMPLATE_ENGINE_SIGNALS = [
+    // Python
+    {
+        name: 'jinja2',
+        extensions: ['jinja2', 'j2'],
+        depFiles: [{ file: 'requirements.txt', contains: 'Jinja2' }],
+    },
+    {
+        name: 'django-templates',
+        extensions: ['html'],
+        depFiles: [{ file: 'requirements.txt', contains: 'Django' }],
+    },
+    // Ruby
+    {
+        name: 'erb',
+        extensions: ['erb'],
+        depFiles: [{ file: 'Gemfile', contains: 'rails' }],
+    },
+    // PHP
+    {
+        name: 'blade',
+        extensions: ['blade.php'],
+        depFiles: [{ file: 'composer.json', contains: 'laravel/framework' }],
+    },
+    {
+        name: 'twig',
+        extensions: ['twig'],
+        depFiles: [{ file: 'composer.json', contains: 'twig/twig' }],
+    },
+    // Go
+    {
+        name: 'go-templates',
+        extensions: ['templ'],
+    },
+    // Java/Spring — detected via pom.xml only (html extension is too generic)
+    {
+        name: 'thymeleaf',
+        depFiles: [{ file: 'pom.xml', contains: 'thymeleaf' }],
+        xmlTags: ['th:text', 'th:each', 'th:if'],
+    },
+    // JavaScript/Node
+    {
+        name: 'handlebars',
+        extensions: ['hbs', 'handlebars'],
+        depPackages: ['handlebars', 'express-handlebars'],
+    },
+    {
+        name: 'nunjucks',
+        extensions: ['njk', 'nunjucks'],
+        depPackages: ['nunjucks'],
+    },
+    {
+        name: 'pug',
+        extensions: ['pug', 'jade'],
+        depPackages: ['pug'],
+    },
+    {
+        name: 'ejs',
+        extensions: ['ejs'],
+        depPackages: ['ejs'],
+    },
+];
+// === File helpers ===
+async function readText(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+async function hasFilesWithExtension(projectPath, ext) {
+    try {
+        const matches = await glob(`**/*.${ext}`, {
+            cwd: projectPath,
+            nodir: true,
+            maxDepth: 4,
+            ignore: ['node_modules/**', 'dist/**', 'build/**', '.git/**', 'vendor/**'],
+        });
+        return matches.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function readPackageJsonDeps(projectPath) {
+    const deps = new Set();
+    const content = await readText(join(projectPath, 'package.json'));
+    if (!content) {
+        return deps;
+    }
+    try {
+        const pkg = JSON.parse(content);
+        for (const dep of Object.keys(pkg.dependencies ?? {})) {
+            deps.add(dep);
+        }
+        for (const dep of Object.keys(pkg.devDependencies ?? {})) {
+            deps.add(dep);
+        }
+    }
+    catch {
+        // Unparseable — skip
+    }
+    return deps;
+}
+/**
+ * Detect Go templates specifically via {{ }} syntax in HTML files.
+ */
+async function detectGoTemplates(projectPath) {
+    try {
+        const matches = await glob('**/*.html', {
+            cwd: projectPath,
+            nodir: true,
+            maxDepth: 4,
+            ignore: ['node_modules/**', 'dist/**', 'build/**', 'vendor/**'],
+        });
+        for (const file of matches) {
+            const content = await readText(join(projectPath, file));
+            if (content && /\{\{[\s-]*\.?\w+/.test(content)) {
+                // Go template syntax: {{ .Field }} or {{- .Field -}}
+                return true;
+            }
+        }
+    }
+    catch {
+        // Skip
+    }
+    return false;
+}
+/**
+ * Detect the primary template engine used in a project.
+ * Returns the engine name (e.g. 'jinja2', 'erb', 'blade') or null if none found.
+ */
+export async function detectTemplateEngine(projectPath) {
+    const nodeDeps = await readPackageJsonDeps(projectPath);
+    for (const signal of TEMPLATE_ENGINE_SIGNALS) {
+        // Check npm deps (Node.js engines)
+        if (signal.depPackages?.some((pkg) => nodeDeps.has(pkg))) {
+            return signal.name;
+        }
+        // Check dep files (requirements.txt, Gemfile, composer.json, pom.xml)
+        if (signal.depFiles) {
+            for (const { file, contains } of signal.depFiles) {
+                const content = await readText(join(projectPath, file));
+                if (content?.includes(contains)) {
+                    return signal.name;
+                }
+            }
+        }
+        // Check file extensions (skip Go — handled separately below)
+        if (signal.extensions && signal.name !== 'go-templates' && signal.name !== 'django-templates') {
+            for (const ext of signal.extensions) {
+                if (await hasFilesWithExtension(projectPath, ext)) {
+                    return signal.name;
+                }
+            }
+        }
+    }
+    // Go templates: check for .templ files (typed Go templates) or {{ }} syntax in HTML
+    if ((await hasFilesWithExtension(projectPath, 'templ')) ||
+        (await detectGoTemplates(projectPath))) {
+        return 'go-templates';
+    }
+    return null;
+}
+//# sourceMappingURL=template-engine-detector.js.map

package/dist/engine/detectors/template-engine-detector.js.map

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

package/dist/engine/detectors/wasm-detector.d.ts

@@ -0,0 +1,26 @@
+import type { WasmDetectionResult, WasmPackageJson, WasmTarget } from '../../types/index.js';
+/**
+ * Check package.json for WASM-related dependencies and scripts.
+ * Returns tools and targets detectable from Node/browser context.
+ */
+export declare function detectWasmFromPackageJson(pkg: WasmPackageJson): {
+    tools: string[];
+    targets: WasmTarget[];
+};
+/**
+ * Check Cargo.toml for wasm-bindgen dependency.
+ * Indicates Rust WASM compilation.
+ */
+export declare function detectWasmFromCargoToml(content: string): {
+    tools: string[];
+    targets: WasmTarget[];
+};
+/**
+ * Detect WebAssembly compilation targets and toolchain in a project.
+ *
+ * Checks:
+ * - package.json: @assemblyscript/loader, assemblyscript, wasm-pack, emscripten in scripts
+ * - Cargo.toml: wasm-bindgen, wasm-pack, wasi targets
+ */
+export declare function detectWasm(projectPath: string): Promise<WasmDetectionResult>;
+//# sourceMappingURL=wasm-detector.d.ts.map

package/dist/engine/detectors/wasm-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/wasm-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAW7F;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,GAAG;IAC/D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAmCA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAwBA;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoClF"}

package/dist/engine/detectors/wasm-detector.js

@@ -0,0 +1,114 @@
+// engine/detectors/wasm-detector.ts — WebAssembly toolchain detection
+// SPEC-004 tech-debt S4: Detect WASM targets and build tools
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// === Helpers ===
+async function readJsonFile(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+// === Detection logic ===
+/**
+ * Check package.json for WASM-related dependencies and scripts.
+ * Returns tools and targets detectable from Node/browser context.
+ */
+export function detectWasmFromPackageJson(pkg) {
+    const tools = [];
+    const targets = new Set();
+    const allDeps = {
+        ...pkg.dependencies,
+        ...pkg.devDependencies,
+    };
+    if ('@assemblyscript/loader' in allDeps || 'assemblyscript' in allDeps) {
+        tools.push('assemblyscript');
+        targets.add('browser');
+        targets.add('node');
+    }
+    if ('wasm-pack' in allDeps) {
+        tools.push('wasm-pack');
+        targets.add('browser');
+    }
+    // Check scripts for emcc / emscripten references
+    for (const scriptCmd of Object.values(pkg.scripts ?? {})) {
+        if (/emcc|emscripten/i.test(scriptCmd)) {
+            /* v8 ignore start */
+            if (!tools.includes('emscripten')) {
+                /* v8 ignore stop */
+                tools.push('emscripten');
+            }
+            targets.add('browser');
+            targets.add('node');
+            break;
+        }
+    }
+    return { tools, targets: [...targets] };
+}
+/**
+ * Check Cargo.toml for wasm-bindgen dependency.
+ * Indicates Rust WASM compilation.
+ */
+export function detectWasmFromCargoToml(content) {
+    const tools = [];
+    const targets = new Set();
+    if (content.includes('wasm-bindgen')) {
+        tools.push('wasm-bindgen');
+        targets.add('browser');
+    }
+    if (content.includes('wasm-pack')) {
+        /* v8 ignore start */
+        if (!tools.includes('wasm-pack')) {
+            /* v8 ignore stop */
+            tools.push('wasm-pack');
+        }
+        targets.add('browser');
+    }
+    // WASI target hint
+    if (content.includes('wasi')) {
+        targets.add('wasi');
+    }
+    return { tools, targets: [...targets] };
+}
+/**
+ * Detect WebAssembly compilation targets and toolchain in a project.
+ *
+ * Checks:
+ * - package.json: @assemblyscript/loader, assemblyscript, wasm-pack, emscripten in scripts
+ * - Cargo.toml: wasm-bindgen, wasm-pack, wasi targets
+ */
+export async function detectWasm(projectPath) {
+    const allTools = [];
+    const allTargets = new Set();
+    // Check package.json
+    try {
+        const pkg = (await readJsonFile(join(projectPath, 'package.json')));
+        const { tools, targets } = detectWasmFromPackageJson(pkg);
+        for (const t of tools) {
+            allTools.push(t);
+        }
+        for (const t of targets) {
+            allTargets.add(t);
+        }
+    }
+    catch {
+        // no package.json — skip
+    }
+    // Check Cargo.toml
+    try {
+        const content = await readFile(join(projectPath, 'Cargo.toml'), 'utf-8');
+        const { tools, targets } = detectWasmFromCargoToml(content);
+        for (const t of tools) {
+            if (!allTools.includes(t)) {
+                allTools.push(t);
+            }
+        }
+        for (const t of targets) {
+            allTargets.add(t);
+        }
+    }
+    catch {
+        // no Cargo.toml — skip
+    }
+    const isWasm = allTools.length > 0;
+    return { isWasm, targets: [...allTargets], tools: allTools };
+}
+//# sourceMappingURL=wasm-detector.js.map

package/dist/engine/detectors/wasm-detector.js.map

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

package/dist/engine/doc-generator/arch-api-user-generators.d.ts

@@ -0,0 +1,5 @@
+import type { GeneratedDocument, ProjectKnowledge, Spec } from '../../types/index.js';
+export declare function generateArchitectureDoc(knowledge: ProjectKnowledge, _language: string): GeneratedDocument;
+export declare function generateApiReference(knowledge: ProjectKnowledge, specs: Spec[], _language: string): GeneratedDocument;
+export declare function generateUserGuide(knowledge: ProjectKnowledge, specs: Spec[], _language: string): GeneratedDocument;
+//# sourceMappingURL=arch-api-user-generators.d.ts.map

package/dist/engine/doc-generator/arch-api-user-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-api-user-generators.d.ts","sourceRoot":"","sources":["../../../src/engine/doc-generator/arch-api-user-generators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EAGjB,gBAAgB,EAChB,IAAI,EACL,MAAM,sBAAsB,CAAC;AAiD9B,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAqDnB;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAyEnB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,iBAAiB,CA4CnB"}

package/dist/engine/doc-generator/arch-api-user-generators.js

@@ -0,0 +1,195 @@
+// SpecForge — Architecture, API Reference, and User Guide generators
+import { generateArchitectureDiagram, generateDependencyDiagram } from './diagrams.js';
+function buildArchOverviewSection(arch) {
+    return {
+        title: 'Architecture Overview',
+        level: 2,
+        content: [
+            `This project follows the **${arch.primary}** architecture pattern.`,
+            '',
+            arch.secondary.length > 0 ? `Secondary patterns: ${arch.secondary.join(', ')}.` : '',
+            '',
+            `Communication patterns: ${arch.communicationPatterns.join(', ')}.`,
+            '',
+            `Deployment units: ${arch.deploymentUnits.join(', ')}.`,
+        ]
+            .filter(Boolean)
+            .join('\n'),
+    };
+}
+function buildLayersSection(arch) {
+    return {
+        title: 'Layers',
+        level: 2,
+        content: arch.layers
+            .map((layer) => [
+            `### ${layer.name}`,
+            '',
+            `**Responsibility:** ${layer.responsibility}`,
+            '',
+            `**Directories:** ${layer.directories.map((d) => `\`${d}\``).join(', ')}`,
+            '',
+            layer.dependsOn.length > 0
+                ? `**Depends on:** ${layer.dependsOn.join(', ')}`
+                : '**Depends on:** nothing (foundation layer)',
+            '',
+            layer.neverDependsOn.length > 0
+                ? `**NEVER depends on:** ${layer.neverDependsOn.join(', ')}`
+                : '',
+        ]
+            .filter(Boolean)
+            .join('\n'))
+            .join('\n\n'),
+    };
+}
+export function generateArchitectureDoc(knowledge, _language) {
+    const arch = knowledge.architecture;
+    const sections = [buildArchOverviewSection(arch), buildLayersSection(arch)];
+    if (arch.boundaries.length > 0) {
+        sections.push({
+            title: 'Module Boundaries',
+            level: 2,
+            content: arch.boundaries
+                .map((b) => [
+                `### ${b.name}`,
+                '',
+                `Directories: ${b.directories.map((d) => `\`${d}\``).join(', ')}`,
+                '',
+                b.publicApi.length > 0
+                    ? `Public API: ${b.publicApi.map((a) => `\`${a}\``).join(', ')}`
+                    : '',
+            ]
+                .filter(Boolean)
+                .join('\n'))
+                .join('\n\n'),
+        });
+    }
+    const diagrams = [
+        generateArchitectureDiagram(knowledge),
+        generateDependencyDiagram(knowledge),
+    ];
+    sections.push({
+        title: 'Architecture Diagram',
+        level: 2,
+        content: diagrams
+            .map((d) => `### ${d.title}\n\n\`\`\`mermaid\n${d.content}\n\`\`\``)
+            .join('\n\n'),
+    });
+    const content = `# Architecture Documentation\n\n` +
+        sections.map((s) => `${'#'.repeat(s.level)} ${s.title}\n\n${s.content}`).join('\n\n');
+    return {
+        type: 'architecture-doc',
+        title: 'Architecture Documentation',
+        path: 'docs/architecture.md',
+        content,
+        audience: 'developer',
+        sections,
+        diagrams,
+        relatedSpecs: [],
+    };
+}
+export function generateApiReference(knowledge, specs, _language) {
+    const sections = [];
+    sections.push({
+        title: 'API Overview',
+        level: 2,
+        content: [
+            `This project uses ${knowledge.framework ?? knowledge.language} for its API layer.`,
+            '',
+            knowledge.apiContracts.length > 0
+                ? `API contracts: ${knowledge.apiContracts.map((c) => c.type).join(', ')}.`
+                : 'No formal API contracts detected. Consider adding OpenAPI/GraphQL schema.',
+        ].join('\n'),
+    });
+    for (const contract of knowledge.apiContracts) {
+        sections.push({
+            title: `${contract.type.toUpperCase()} API`,
+            level: 2,
+            content: [
+                `Type: ${contract.type}`,
+                contract.path ? `Schema: \`${contract.path}\`` : '',
+                '',
+                contract.endpoints.length > 0
+                    ? `Endpoints:\n${contract.endpoints.map((e) => `- ${e}`).join('\n')}`
+                    : 'Endpoints: auto-detected from code.',
+            ]
+                .filter(Boolean)
+                .join('\n'),
+        });
+    }
+    sections.push({
+        title: 'Authentication',
+        level: 2,
+        content: 'Document your authentication strategy here. Common patterns: JWT, API keys, OAuth 2.0, session-based.',
+    });
+    sections.push({
+        title: 'Error Handling',
+        level: 2,
+        content: [
+            'All API errors should follow a consistent format:',
+            '',
+            '```json',
+            '{',
+            '  "error": {',
+            '    "code": "ERROR_CODE",',
+            '    "message": "Human-readable message",',
+            '    "details": {}',
+            '  }',
+            '}',
+            '```',
+        ].join('\n'),
+    });
+    const content = `# API Reference\n\n` +
+        sections.map((s) => `${'#'.repeat(s.level)} ${s.title}\n\n${s.content}`).join('\n\n');
+    return {
+        type: 'api-reference',
+        title: 'API Reference',
+        path: 'docs/api-reference.md',
+        content,
+        audience: 'developer',
+        sections,
+        diagrams: [],
+        relatedSpecs: specs
+            .filter((s) => s.target === 'backend' || s.target === 'fullstack')
+            .map((s) => s.id),
+    };
+}
+export function generateUserGuide(knowledge, specs, _language) {
+    const sections = [];
+    const projectName = 
+    /* v8 ignore next -- defensive nullish coalescing */
+    knowledge.projectPath.split('/').pop() ?? 'Project';
+    sections.push({
+        title: `Welcome to ${projectName}`,
+        level: 2,
+        content: `This guide will help you get started with ${projectName}.`,
+    });
+    sections.push({
+        title: 'Features',
+        level: 2,
+        content: specs.length > 0
+            ? specs
+                .filter((s) => s.status === 'done')
+                .map((s) => `- **${s.title}**`)
+                .join('\n')
+            : 'Feature list will be populated from completed specs.',
+    });
+    sections.push({
+        title: 'Getting Started',
+        level: 2,
+        content: 'Follow the setup guide to install and configure the application.',
+    });
+    const content = `# User Guide\n\n` +
+        sections.map((s) => `${'#'.repeat(s.level)} ${s.title}\n\n${s.content}`).join('\n\n');
+    return {
+        type: 'user-guide',
+        title: `${projectName} User Guide`,
+        path: 'docs/user-guide.md',
+        content,
+        audience: 'end-user',
+        sections,
+        diagrams: [],
+        relatedSpecs: specs.map((s) => s.id),
+    };
+}
+//# sourceMappingURL=arch-api-user-generators.js.map

package/dist/engine/doc-generator/arch-api-user-generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-api-user-generators.js","sourceRoot":"","sources":["../../../src/engine/doc-generator/arch-api-user-generators.ts"],"names":[],"mappings":"AAAA,qEAAqE;AASrE,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAEvF,SAAS,wBAAwB,CAAC,IAAsC;IACtE,OAAO;QACL,KAAK,EAAE,uBAAuB;QAC9B,KAAK,EAAE,CAAC;QACR,OAAO,EAAE;YACP,8BAA8B,IAAI,CAAC,OAAO,0BAA0B;YACpE,EAAE;YACF,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACpF,EAAE;YACF,2BAA2B,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACnE,EAAE;YACF,qBAAqB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SACxD;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC;KACd,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAsC;IAChE,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,IAAI,CAAC,MAAM;aACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACb;YACE,OAAO,KAAK,CAAC,IAAI,EAAE;YACnB,EAAE;YACF,uBAAuB,KAAK,CAAC,cAAc,EAAE;YAC7C,EAAE;YACF,oBAAoB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACzE,EAAE;YACF,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBACxB,CAAC,CAAC,mBAAmB,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACjD,CAAC,CAAC,4CAA4C;YAChD,EAAE;YACF,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAC7B,CAAC,CAAC,yBAAyB,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC5D,CAAC,CAAC,EAAE;SACP;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CACd;aACA,IAAI,CAAC,MAAM,CAAC;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAA2B,EAC3B,SAAiB;IAEjB,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC;IACpC,MAAM,QAAQ,GAAiB,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1F,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,IAAI,CAAC,UAAU;iBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT;gBACE,OAAO,CAAC,CAAC,IAAI,EAAE;gBACf,EAAE;gBACF,gBAAgB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACjE,EAAE;gBACF,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;oBACpB,CAAC,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAChE,CAAC,CAAC,EAAE;aACP;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CACd;iBACA,IAAI,CAAC,MAAM,CAAC;SAChB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC9B,2BAA2B,CAAC,SAAS,CAAC;QACtC,yBAAyB,CAAC,SAAS,CAAC;KACrC,CAAC;IAEF,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,sBAAsB;QAC7B,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,QAAQ;aACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,sBAAsB,CAAC,CAAC,OAAO,UAAU,CAAC;aACnE,IAAI,CAAC,MAAM,CAAC;KAChB,CAAC,CAAC;IAEH,MAAM,OAAO,GACX,kCAAkC;QAClC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExF,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,sBAAsB;QAC5B,OAAO;QACP,QAAQ,EAAE,WAAW;QACrB,QAAQ;QACR,QAAQ;QACR,YAAY,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAA2B,EAC3B,KAAa,EACb,SAAiB;IAEjB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,CAAC;QACR,OAAO,EAAE;YACP,qBAAqB,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,QAAQ,qBAAqB;YACnF,EAAE;YACF,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBAC/B,CAAC,CAAC,kBAAkB,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC3E,CAAC,CAAC,2EAA2E;SAChF,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC,CAAC;IAEH,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM;YAC3C,KAAK,EAAE,CAAC;YACR,OAAO,EAAE;gBACP,SAAS,QAAQ,CAAC,IAAI,EAAE;gBACxB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE;gBACnD,EAAE;gBACF,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;oBAC3B,CAAC,CAAC,eAAe,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACrE,CAAC,CAAC,qCAAqC;aAC1C;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,CAAC;QACR,OAAO,EACL,uGAAuG;KAC1G,CAAC,CAAC;IAEH,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,CAAC;QACR,OAAO,EAAE;YACP,mDAAmD;YACnD,EAAE;YACF,SAAS;YACT,GAAG;YACH,cAAc;YACd,2BAA2B;YAC3B,0CAA0C;YAC1C,mBAAmB;YACnB,KAAK;YACL,GAAG;YACH,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC,CAAC;IAEH,MAAM,OAAO,GACX,qBAAqB;QACrB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExF,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,uBAAuB;QAC7B,OAAO;QACP,QAAQ,EAAE,WAAW;QACrB,QAAQ;QACR,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,KAAK;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAA2B,EAC3B,KAAa,EACb,SAAiB;IAEjB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,WAAW;IACf,oDAAoD;IACpD,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;IAEtD,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,cAAc,WAAW,EAAE;QAClC,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,6CAA6C,WAAW,GAAG;KACrE,CAAC,CAAC;IAEH,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,CAAC;QACR,OAAO,EACL,KAAK,CAAC,MAAM,GAAG,CAAC;YACd,CAAC,CAAC,KAAK;iBACF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;iBAC9B,IAAI,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,sDAAsD;KAC7D,CAAC,CAAC;IAEH,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,kEAAkE;KAC5E,CAAC,CAAC;IAEH,MAAM,OAAO,GACX,kBAAkB;QAClB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExF,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,GAAG,WAAW,aAAa;QAClC,IAAI,EAAE,oBAAoB;QAC1B,OAAO;QACP,QAAQ,EAAE,UAAU;QACpB,QAAQ;QACR,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/engine/doc-generator/builders.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+export declare function buildReadmeIntro(knowledge: ProjectKnowledge): string;
+export declare function buildTechStackSection(knowledge: ProjectKnowledge): string;
+export declare function buildGettingStartedSection(knowledge: ProjectKnowledge): string;
+export declare function buildProjectStructureSection(knowledge: ProjectKnowledge): string;
+export declare function buildDevelopmentSection(knowledge: ProjectKnowledge): string;
+export declare function buildPrerequisitesSection(knowledge: ProjectKnowledge): string;
+export declare function buildInstallationSection(knowledge: ProjectKnowledge): string;
+export declare function buildEnvVarsSection(knowledge: ProjectKnowledge): string;
+export declare function buildDatabaseSetupSection(knowledge: ProjectKnowledge): string;
+export declare function buildRunningSection(knowledge: ProjectKnowledge): string;
+export declare function buildVerifySection(knowledge: ProjectKnowledge): string;
+export declare function buildDeploymentInstructions(unit: string, _knowledge: ProjectKnowledge): string;
+export declare function buildSecurityEnvSection(knowledge: ProjectKnowledge): string;
+export declare function getInstallCommand(packageManager: string): string;
+export declare function buildMobileInstallGuide(platform: 'ios' | 'android' | 'cross-platform'): string;
+//# sourceMappingURL=builders.d.ts.map

package/dist/engine/doc-generator/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/engine/doc-generator/builders.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAUpE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAczE;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAgC9E;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAWhF;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAkB3E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CA6B7E;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAgB5E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAoBvE;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAY7E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAevE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAatE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAa9F;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAsB3E;AAED,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAmBhE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,gBAAgB,GAAG,MAAM,CAwC9F"}