@dinyangetoh/codeplug-cli 0.1.0

package/dist/core/generator/StalenessTracker.js

@@ -0,0 +1,76 @@
+import { createHash } from 'node:crypto';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { CODEPLUG_DIR, DOC_HASHES_FILE } from '../../config/defaults.js';
+const TRACKED_DOCS = [
+    'README.md',
+    'ARCHITECTURE.md',
+    'CONVENTIONS.md',
+    'CONTRIBUTING.md',
+    'ONBOARDING.md',
+];
+export class StalenessTracker {
+    projectRoot;
+    hashFilePath;
+    dirPath;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.dirPath = join(projectRoot, CODEPLUG_DIR);
+        this.hashFilePath = join(this.dirPath, DOC_HASHES_FILE);
+    }
+    async check() {
+        const saved = await this.loadHashes();
+        const currentHash = await this.computeSourceHash();
+        return TRACKED_DOCS.map((name) => {
+            const docPath = join(this.projectRoot, name);
+            if (!existsSync(docPath)) {
+                return { name, stale: true, reason: 'Document does not exist' };
+            }
+            const savedHash = saved[name];
+            if (!savedHash) {
+                return { name, stale: true, reason: 'No generation record found' };
+            }
+            if (savedHash !== currentHash) {
+                return { name, stale: true, reason: 'Source code changed since last generation' };
+            }
+            return { name, stale: false };
+        });
+    }
+    async update(docName, hash) {
+        const saved = await this.loadHashes();
+        saved[docName] = hash;
+        await this.saveHashes(saved);
+    }
+    async computeSourceHash() {
+        const { globby } = await import('globby');
+        const files = await globby(['**/*.{ts,tsx,js,jsx,mjs,cjs}'], {
+            cwd: this.projectRoot,
+            gitignore: true,
+            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.codeplug/**'],
+            absolute: false,
+        });
+        files.sort();
+        const hash = createHash('sha256');
+        for (const file of files) {
+            const content = await readFile(join(this.projectRoot, file), 'utf-8');
+            hash.update(file);
+            hash.update(content);
+        }
+        return hash.digest('hex');
+    }
+    async loadHashes() {
+        if (!existsSync(this.hashFilePath)) {
+            return {};
+        }
+        const raw = await readFile(this.hashFilePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    async saveHashes(record) {
+        if (!existsSync(this.dirPath)) {
+            await mkdir(this.dirPath, { recursive: true });
+        }
+        await writeFile(this.hashFilePath, JSON.stringify(record, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=StalenessTracker.js.map

package/dist/core/generator/StalenessTracker.js.map

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

package/dist/core/generator/documents/ArchitectureGenerator.d.ts

@@ -0,0 +1,13 @@
+import type { DocumentGenerator, GenerationContext } from './types.js';
+export declare class ArchitectureGenerator implements DocumentGenerator {
+    generate(ctx: GenerationContext): Promise<string>;
+    private buildOverview;
+    private countDirs;
+    private buildDirectoryMap;
+    private renderTree;
+    private buildComponentRelationships;
+    private buildDataFlow;
+    private buildDesignDecisions;
+    private enhanceWithLlm;
+}
+//# sourceMappingURL=ArchitectureGenerator.d.ts.map

package/dist/core/generator/documents/ArchitectureGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchitectureGenerator.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/documents/ArchitectureGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAE3F,qBAAa,qBAAsB,YAAW,iBAAiB;IACvD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBvD,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,oBAAoB;YAYd,cAAc;CAc7B"}

package/dist/core/generator/documents/ArchitectureGenerator.js

@@ -0,0 +1,101 @@
+import { basename } from 'node:path';
+export class ArchitectureGenerator {
+    async generate(ctx) {
+        const projectName = basename(ctx.projectRoot);
+        const sections = [];
+        sections.push(`# ${projectName} — Architecture\n`);
+        sections.push(this.buildOverview(ctx));
+        sections.push(this.buildDirectoryMap(ctx.analysis.folderStructure));
+        sections.push(this.buildComponentRelationships(ctx));
+        sections.push(this.buildDataFlow(ctx));
+        sections.push(this.buildDesignDecisions(ctx));
+        const template = sections.join('\n');
+        if (ctx.llmAvailable && ctx.llmClient) {
+            return this.enhanceWithLlm(ctx, template);
+        }
+        return template;
+    }
+    buildOverview(ctx) {
+        const { analysis } = ctx;
+        return [
+            '## System Overview\n',
+            `The project contains ${analysis.fileCount} source files organized across ${this.countDirs(analysis.folderStructure)} directories.`,
+            '',
+        ].join('\n');
+    }
+    countDirs(node) {
+        let count = node.children.length;
+        for (const child of node.children) {
+            count += this.countDirs(child);
+        }
+        return count;
+    }
+    buildDirectoryMap(root) {
+        const lines = ['## Directory Structure\n', '```'];
+        lines.push(...this.renderTree(root, 0, 4));
+        lines.push('```', '');
+        return lines.join('\n');
+    }
+    renderTree(node, depth, maxDepth) {
+        if (depth > maxDepth)
+            return [];
+        const indent = '  '.repeat(depth);
+        const lines = [`${indent}${node.name}/ (${node.fileCount} files)`];
+        for (const child of node.children) {
+            lines.push(...this.renderTree(child, depth + 1, maxDepth));
+        }
+        return lines;
+    }
+    buildComponentRelationships(ctx) {
+        const structural = ctx.analysis.patterns.filter((p) => p.dimension === 'structure' || p.dimension === 'component');
+        if (structural.length === 0)
+            return '';
+        const lines = ['## Component Relationships\n'];
+        for (const p of structural) {
+            lines.push(`- **${p.pattern}** — seen ${p.frequency}/${p.total} times (${(p.confidence * 100).toFixed(0)}% confidence)`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    buildDataFlow(ctx) {
+        const apiPatterns = ctx.analysis.patterns.filter((p) => p.dimension === 'api' || p.dimension === 'state');
+        if (apiPatterns.length === 0) {
+            return [
+                '## Data Flow\n',
+                'No API or state management patterns detected. Refer to source code for data flow details.',
+                '',
+            ].join('\n');
+        }
+        const lines = ['## Data Flow\n'];
+        for (const p of apiPatterns) {
+            lines.push(`- **${p.pattern}**: ${p.examples.slice(0, 2).join(', ') || 'N/A'}`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    buildDesignDecisions(ctx) {
+        const highConf = ctx.analysis.patterns.filter((p) => p.confidence >= 0.8);
+        if (highConf.length === 0)
+            return '';
+        const lines = ['## Design Decisions\n'];
+        for (const p of highConf.slice(0, 5)) {
+            lines.push(`- **${p.dimension}**: ${p.pattern}`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    async enhanceWithLlm(ctx, template) {
+        const prompt = [
+            `Improve this ARCHITECTURE.md for a ${ctx.audience} audience in a ${ctx.style} style.`,
+            'Add mermaid diagrams where appropriate to illustrate component relationships and data flow.',
+            'Return only the final markdown.\n',
+            template,
+        ].join('\n');
+        return ctx.llmClient.generate(prompt, {
+            systemPrompt: 'You are a software architect writing clear documentation.',
+            temperature: 0.3,
+            maxTokens: 3000,
+        });
+    }
+}
+//# sourceMappingURL=ArchitectureGenerator.js.map

package/dist/core/generator/documents/ArchitectureGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchitectureGenerator.js","sourceRoot":"","sources":["../../../../src/core/generator/documents/ArchitectureGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,MAAM,OAAO,qBAAqB;IAChC,KAAK,CAAC,QAAQ,CAAC,GAAsB;QACnC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,QAAQ,CAAC,IAAI,CAAC,KAAK,WAAW,mBAAmB,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;QACpE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;QAE9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAyB,EAAE,QAAQ,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,aAAa,CAAC,GAAsB;QAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;QACzB,OAAO;YACL,sBAAsB;YACtB,wBAAwB,QAAQ,CAAC,SAAS,kCAAkC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,eAAe;YACnI,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAEO,SAAS,CAAC,IAAgB;QAChC,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB,CAAC,IAAgB;QACxC,MAAM,KAAK,GAAG,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,UAAU,CAAC,IAAgB,EAAE,KAAa,EAAE,QAAgB;QAClE,IAAI,KAAK,GAAG,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,KAAK,GAAa,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,SAAS,SAAS,CAAC,CAAC;QAC7E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,2BAA2B,CAAC,GAAsB;QACxD,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,KAAK,WAAW,CAAC,CAAC;QACnH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEvC,MAAM,KAAK,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,aAAa,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAC3H,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,aAAa,CAAC,GAAsB;QAC1C,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,IAAI,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC;QAC1G,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,gBAAgB;gBAChB,2FAA2F;gBAC3F,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,oBAAoB,CAAC,GAAsB;QACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;QAC1E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,KAAK,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,GAAuB,EAAE,QAAgB;QACpE,MAAM,MAAM,GAAG;YACb,sCAAsC,GAAG,CAAC,QAAQ,kBAAkB,GAAG,CAAC,KAAK,SAAS;YACtF,6FAA6F;YAC7F,mCAAmC;YACnC,QAAQ;SACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE;YACpC,YAAY,EAAE,2DAA2D;YACzE,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/generator/documents/ContributingGenerator.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentGenerator, GenerationContext } from './types.js';
+export declare class ContributingGenerator implements DocumentGenerator {
+    generate(ctx: GenerationContext): Promise<string>;
+    private buildSetup;
+    private buildWorkflow;
+    private buildCodingStandards;
+    private buildPrProcess;
+    private enhanceWithLlm;
+}
+//# sourceMappingURL=ContributingGenerator.d.ts.map

package/dist/core/generator/documents/ContributingGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContributingGenerator.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/documents/ContributingGenerator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAE3F,qBAAa,qBAAsB,YAAW,iBAAiB;IACvD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBvD,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,cAAc;YAYR,cAAc;CAa7B"}

package/dist/core/generator/documents/ContributingGenerator.js

@@ -0,0 +1,90 @@
+import { basename } from 'node:path';
+export class ContributingGenerator {
+    async generate(ctx) {
+        const projectName = basename(ctx.projectRoot);
+        const sections = [];
+        sections.push(`# Contributing to ${projectName}\n`);
+        sections.push(this.buildSetup(projectName));
+        sections.push(this.buildWorkflow());
+        sections.push(this.buildCodingStandards(ctx));
+        sections.push(this.buildPrProcess());
+        const template = sections.join('\n');
+        if (ctx.llmAvailable && ctx.llmClient) {
+            return this.enhanceWithLlm(ctx, template);
+        }
+        return template;
+    }
+    buildSetup(projectName) {
+        return [
+            '## Setup\n',
+            '```bash',
+            'git clone <repository-url>',
+            `cd ${projectName}`,
+            'npm install',
+            'npm run build',
+            'npm test',
+            '```',
+            '',
+        ].join('\n');
+    }
+    buildWorkflow() {
+        return [
+            '## Development Workflow\n',
+            '1. Create a feature branch from `main`',
+            '2. Make your changes with clear, atomic commits',
+            '3. Write or update tests for your changes',
+            '4. Ensure all tests pass and linting is clean',
+            '5. Open a pull request against `main`',
+            '',
+        ].join('\n');
+    }
+    buildCodingStandards(ctx) {
+        const confirmed = ctx.conventions.filter((c) => c.confirmed);
+        if (confirmed.length === 0) {
+            return [
+                '## Coding Standards\n',
+                'Follow the existing patterns in the codebase. Run `codeplug conventions audit` to check compliance.',
+                '',
+            ].join('\n');
+        }
+        const lines = ['## Coding Standards\n'];
+        const byDimension = new Map();
+        for (const c of confirmed) {
+            const list = byDimension.get(c.dimension) ?? [];
+            list.push(c.rule);
+            byDimension.set(c.dimension, list);
+        }
+        for (const [dim, rules] of byDimension) {
+            lines.push(`### ${dim}\n`);
+            for (const rule of rules) {
+                lines.push(`- ${rule}`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    buildPrProcess() {
+        return [
+            '## Pull Request Process\n',
+            '1. Fill out the PR template completely',
+            '2. Request review from at least one maintainer',
+            '3. Address all review comments',
+            '4. Ensure CI passes before merging',
+            '5. Squash and merge when approved',
+            '',
+        ].join('\n');
+    }
+    async enhanceWithLlm(ctx, template) {
+        const prompt = [
+            `Improve this CONTRIBUTING.md for a ${ctx.audience} audience in a ${ctx.style} style.`,
+            'Make it welcoming and actionable. Return only the final markdown.\n',
+            template,
+        ].join('\n');
+        return ctx.llmClient.generate(prompt, {
+            systemPrompt: 'You are a technical writer creating contributor documentation.',
+            temperature: 0.3,
+            maxTokens: 2000,
+        });
+    }
+}
+//# sourceMappingURL=ContributingGenerator.js.map

package/dist/core/generator/documents/ContributingGenerator.js.map

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

package/dist/core/generator/documents/ConventionsGenerator.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentGenerator, GenerationContext } from './types.js';
+export declare class ConventionsGenerator implements DocumentGenerator {
+    generate(ctx: GenerationContext): Promise<string>;
+    private buildIntro;
+    private buildConventionList;
+    private enhanceWithLlm;
+}
+//# sourceMappingURL=ConventionsGenerator.d.ts.map

package/dist/core/generator/documents/ConventionsGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConventionsGenerator.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/documents/ConventionsGenerator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAE3F,qBAAa,oBAAqB,YAAW,iBAAiB;IACtD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAevD,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,mBAAmB;YAmCb,cAAc;CAa7B"}

package/dist/core/generator/documents/ConventionsGenerator.js

@@ -0,0 +1,65 @@
+export class ConventionsGenerator {
+    async generate(ctx) {
+        const sections = [];
+        sections.push('# Conventions\n');
+        sections.push(this.buildIntro(ctx));
+        sections.push(this.buildConventionList(ctx.conventions));
+        const template = sections.join('\n');
+        if (ctx.llmAvailable && ctx.llmClient) {
+            return this.enhanceWithLlm(ctx, template);
+        }
+        return template;
+    }
+    buildIntro(ctx) {
+        const confirmed = ctx.conventions.filter((c) => c.confirmed).length;
+        return [
+            `This document describes **${ctx.conventions.length}** conventions detected in the codebase`,
+            `(${confirmed} confirmed).\n`,
+        ].join(' ');
+    }
+    buildConventionList(conventions) {
+        if (conventions.length === 0) {
+            return 'No conventions have been detected yet. Run `codeplug conventions init` to analyze the codebase.\n';
+        }
+        const grouped = new Map();
+        for (const c of conventions) {
+            const list = grouped.get(c.dimension) ?? [];
+            list.push(c);
+            grouped.set(c.dimension, list);
+        }
+        const lines = [];
+        for (const [dimension, items] of grouped) {
+            lines.push(`## ${dimension}\n`);
+            for (const c of items) {
+                lines.push(`### ${c.rule}\n`);
+                lines.push(`| Property | Value |`);
+                lines.push(`|----------|-------|`);
+                lines.push(`| **Severity** | ${c.severity} |`);
+                lines.push(`| **Confidence** | ${(c.confidence * 100).toFixed(0)}% |`);
+                lines.push(`| **Confirmed** | ${c.confirmed ? 'Yes' : 'No'} |`);
+                if (c.examples.length > 0) {
+                    lines.push('');
+                    lines.push('**Examples:**\n');
+                    for (const ex of c.examples.slice(0, 3)) {
+                        lines.push(`- \`${ex}\``);
+                    }
+                }
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    async enhanceWithLlm(ctx, template) {
+        const prompt = [
+            `Improve this CONVENTIONS.md for a ${ctx.audience} audience in a ${ctx.style} style.`,
+            'Make descriptions concise and actionable. Return only the final markdown.\n',
+            template,
+        ].join('\n');
+        return ctx.llmClient.generate(prompt, {
+            systemPrompt: 'You are a technical writer documenting coding conventions.',
+            temperature: 0.3,
+            maxTokens: 2000,
+        });
+    }
+}
+//# sourceMappingURL=ConventionsGenerator.js.map

package/dist/core/generator/documents/ConventionsGenerator.js.map

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

package/dist/core/generator/documents/OnboardingGenerator.d.ts

@@ -0,0 +1,12 @@
+import type { DocumentGenerator, GenerationContext } from './types.js';
+export declare class OnboardingGenerator implements DocumentGenerator {
+    generate(ctx: GenerationContext): Promise<string>;
+    private buildProjectOverview;
+    private buildEnvironmentSetup;
+    private buildKeyConcepts;
+    private buildArchitectureTour;
+    private describePurpose;
+    private buildCommonTasks;
+    private enhanceWithLlm;
+}
+//# sourceMappingURL=OnboardingGenerator.d.ts.map

package/dist/core/generator/documents/OnboardingGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnboardingGenerator.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/documents/OnboardingGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAE3F,qBAAa,mBAAoB,YAAW,iBAAiB;IACrD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBvD,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,qBAAqB;IAuB7B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,gBAAgB;YAaV,cAAc;CAa7B"}

package/dist/core/generator/documents/OnboardingGenerator.js

@@ -0,0 +1,116 @@
+import { basename } from 'node:path';
+export class OnboardingGenerator {
+    async generate(ctx) {
+        const projectName = basename(ctx.projectRoot);
+        const sections = [];
+        sections.push(`# Onboarding — ${projectName}\n`);
+        sections.push(this.buildProjectOverview(ctx));
+        sections.push(this.buildEnvironmentSetup(projectName));
+        sections.push(this.buildKeyConcepts(ctx));
+        sections.push(this.buildArchitectureTour(ctx));
+        sections.push(this.buildCommonTasks());
+        const template = sections.join('\n');
+        if (ctx.llmAvailable && ctx.llmClient) {
+            return this.enhanceWithLlm(ctx, template);
+        }
+        return template;
+    }
+    buildProjectOverview(ctx) {
+        const { analysis } = ctx;
+        return [
+            '## Project Overview\n',
+            `This project contains ${analysis.fileCount} source files.`,
+            `${ctx.conventions.length} coding conventions have been identified.`,
+            '',
+        ].join('\n');
+    }
+    buildEnvironmentSetup(projectName) {
+        return [
+            '## Environment Setup\n',
+            '### Prerequisites\n',
+            '- Node.js >= 20.0.0',
+            '- npm or yarn',
+            '',
+            '### Installation\n',
+            '```bash',
+            'git clone <repository-url>',
+            `cd ${projectName}`,
+            'npm install',
+            '```',
+            '',
+            '### Verify Setup\n',
+            '```bash',
+            'npm run build',
+            'npm test',
+            '```',
+            '',
+        ].join('\n');
+    }
+    buildKeyConcepts(ctx) {
+        const dimensions = [...new Set(ctx.analysis.patterns.map((p) => p.dimension))];
+        if (dimensions.length === 0)
+            return '';
+        const lines = ['## Key Concepts\n'];
+        for (const dim of dimensions) {
+            const patterns = ctx.analysis.patterns.filter((p) => p.dimension === dim);
+            lines.push(`### ${dim}\n`);
+            for (const p of patterns.slice(0, 3)) {
+                lines.push(`- ${p.pattern} (${(p.confidence * 100).toFixed(0)}% confidence)`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    buildArchitectureTour(ctx) {
+        const root = ctx.analysis.folderStructure;
+        if (root.children.length === 0)
+            return '';
+        const lines = ['## Architecture Tour\n'];
+        lines.push('Key directories:\n');
+        for (const child of root.children) {
+            lines.push(`- **${child.name}/** — ${child.fileCount} files${this.describePurpose(child)}`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    describePurpose(node) {
+        const name = node.name.toLowerCase();
+        const purposes = {
+            src: ' (source code)',
+            lib: ' (library code)',
+            test: ' (tests)',
+            tests: ' (tests)',
+            config: ' (configuration)',
+            docs: ' (documentation)',
+            scripts: ' (build/utility scripts)',
+            public: ' (static assets)',
+            assets: ' (static assets)',
+        };
+        return purposes[name] ?? '';
+    }
+    buildCommonTasks() {
+        return [
+            '## Common Tasks\n',
+            '| Task | Command |',
+            '|------|---------|',
+            '| Build | `npm run build` |',
+            '| Run tests | `npm test` |',
+            '| Lint | `npm run lint` |',
+            '| Dev mode | `npm run dev` |',
+            '',
+        ].join('\n');
+    }
+    async enhanceWithLlm(ctx, template) {
+        const prompt = [
+            `Improve this ONBOARDING.md for a ${ctx.audience} audience in a ${ctx.style} style.`,
+            'Make it friendly and thorough for new team members. Return only the final markdown.\n',
+            template,
+        ].join('\n');
+        return ctx.llmClient.generate(prompt, {
+            systemPrompt: 'You are a technical writer creating onboarding documentation for new developers.',
+            temperature: 0.3,
+            maxTokens: 2500,
+        });
+    }
+}
+//# sourceMappingURL=OnboardingGenerator.js.map

package/dist/core/generator/documents/OnboardingGenerator.js.map

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

package/dist/core/generator/documents/ReadmeGenerator.d.ts

@@ -0,0 +1,12 @@
+import type { DocumentGenerator, GenerationContext } from './types.js';
+export declare class ReadmeGenerator implements DocumentGenerator {
+    generate(ctx: GenerationContext): Promise<string>;
+    private buildDescription;
+    private buildQuickStart;
+    private buildFolderStructure;
+    private renderTree;
+    private buildTechStack;
+    private buildConventionsSummary;
+    private enhanceWithLlm;
+}
+//# sourceMappingURL=ReadmeGenerator.d.ts.map

package/dist/core/generator/documents/ReadmeGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadmeGenerator.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/documents/ReadmeGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAE3F,qBAAa,eAAgB,YAAW,iBAAiB;IACjD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBvD,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,uBAAuB;YAsBjB,cAAc;CAc7B"}