@ai-coders/context 0.2.1 → 0.3.1

package/dist/generators/documentation/documentationGenerator.js

@@ -35,92 +35,80 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentationGenerator = void 0;
 const path = __importStar(require("path"));
-const moduleGrouper_1 = require("../moduleGrouper");
 const shared_1 = require("../shared");
-const documentationTemplates_1 = require("./documentationTemplates");
-const documentationTypes_1 = require("./documentationTypes");
+const templates_1 = require("./templates");
+const guideRegistry_1 = require("./guideRegistry");
 class DocumentationGenerator {
-    constructor(fileMapper, llmClient) {
-        this.fileMapper = fileMapper;
-        this.llmClient = llmClient;
-        this.moduleGrouper = new moduleGrouper_1.ModuleGrouper(fileMapper);
-        this.templates = new documentationTemplates_1.DocumentationTemplates(llmClient, fileMapper);
+    constructor(..._legacyArgs) {
+        this.guides = guideRegistry_1.DOCUMENT_GUIDES;
     }
     async generateDocumentation(repoStructure, outputDir, config = {}, verbose = false) {
-        const fullConfig = {
-            focusAreas: [],
-            maxContentLength: 2000,
-            includeExamples: true,
-            enabledTypes: documentationTypes_1.DOCUMENTATION_TYPES_ARRAY,
-            ...config
-        };
         const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '📚 Generating documentation in');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        await this.generateAllDocumentation(repoStructure, moduleGroups, docsDir, fullConfig.enabledTypes || documentationTypes_1.DOCUMENTATION_TYPES_ARRAY, verbose);
-        await this.generateMainIndex(docsDir, fullConfig.enabledTypes || documentationTypes_1.DOCUMENTATION_TYPES_ARRAY, verbose);
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, 'Generating documentation scaffold in');
+        const guidesToGenerate = (0, guideRegistry_1.getGuidesByKeys)(config.selectedDocs);
+        const context = this.buildContext(repoStructure, guidesToGenerate);
+        const sections = this.getDocSections(guidesToGenerate);
+        let created = 0;
+        for (const section of sections) {
+            const targetPath = path.join(docsDir, section.fileName);
+            const content = section.content(context);
+            await shared_1.GeneratorUtils.writeFileWithLogging(targetPath, content, verbose, `Created ${section.fileName}`);
+            created += 1;
+        }
+        return created;
     }
-    async generateAllDocumentation(repoStructure, moduleGroups, docsDir, enabledTypes, verbose) {
-        shared_1.GeneratorUtils.logProgress('🧠 Generating high-level conceptual documentation...', verbose);
-        const generators = {
-            'mental-model': () => this.templates.createMentalModel(repoStructure, moduleGroups),
-            'architecture-decisions': () => this.templates.createArchitectureDecisions(repoStructure, moduleGroups),
-            'code-organization': () => this.templates.createCodeOrganization(repoStructure, moduleGroups),
-            'development-patterns': () => this.templates.createDevelopmentPatterns(repoStructure, moduleGroups),
-            'ai-guidelines': () => this.templates.createAIGuidelines(repoStructure, moduleGroups),
-            'contributing-workflows': () => this.templates.createContributingWorkflows(repoStructure, moduleGroups),
-            'domain-context': () => this.templates.createDomainContext(repoStructure, moduleGroups),
-            'software-guidelines': () => this.templates.createSoftwareGuidelines(repoStructure, moduleGroups)
+    buildContext(repoStructure, guides) {
+        const directorySet = new Set();
+        repoStructure.directories.forEach(dir => {
+            const [firstSegment] = dir.relativePath.split(/[\\/]/).filter(Boolean);
+            if (firstSegment) {
+                directorySet.add(firstSegment);
+            }
+        });
+        const topLevelDirectories = Array.from(directorySet).sort();
+        const directoryStats = topLevelDirectories.map(name => ({
+            name,
+            fileCount: repoStructure.files.filter(file => file.relativePath.startsWith(`${name}/`)).length
+        }));
+        const primaryLanguages = shared_1.GeneratorUtils.getTopFileExtensions(repoStructure, 5)
+            .filter(([ext]) => !!ext)
+            .map(([extension, count]) => ({ extension, count }));
+        return {
+            repoStructure,
+            topLevelDirectories,
+            primaryLanguages,
+            directoryStats,
+            guides
         };
-        for (const docType of enabledTypes) {
-            try {
-                const content = await generators[docType]();
-                const fileName = `${docType}.md`;
-                const filePath = path.join(docsDir, fileName);
-                await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Generated ${shared_1.GeneratorUtils.formatTitle(docType)}`);
+    }
+    getDocSections(guides) {
+        const sections = [
+            {
+                fileName: 'README.md',
+                content: context => (0, templates_1.renderIndex)(context)
             }
-            catch (error) {
-                shared_1.GeneratorUtils.logError(`Error generating ${docType}`, error, verbose);
+        ];
+        const renderMap = {
+            'project-overview': templates_1.renderProjectOverview,
+            architecture: templates_1.renderArchitectureNotes,
+            'development-workflow': () => (0, templates_1.renderDevelopmentWorkflow)(),
+            'testing-strategy': () => (0, templates_1.renderTestingStrategy)(),
+            glossary: templates_1.renderGlossary,
+            'data-flow': templates_1.renderDataFlow,
+            security: () => (0, templates_1.renderSecurity)(),
+            tooling: () => (0, templates_1.renderToolingGuide)()
+        };
+        guides.forEach(guide => {
+            const renderer = renderMap[guide.key];
+            if (!renderer) {
+                return;
             }
-        }
-    }
-    async generateMainIndex(docsDir, enabledTypes, verbose) {
-        const indexContent = this.templates.createDocumentationIndex(enabledTypes);
-        const indexPath = path.join(docsDir, 'README.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(indexPath, indexContent, verbose, 'Generated documentation index');
-    }
-    // Convenience methods for specific documentation types
-    async generateMentalModelOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🧠 Generating mental model documentation');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createMentalModel(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'mental-model.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Mental Model');
-    }
-    async generateAIGuidelinesOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🤖 Generating AI guidelines documentation');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createAIGuidelines(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'ai-guidelines.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated AI Guidelines');
-    }
-    async generateArchitectureDecisionsOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🏗️ Generating architecture decisions documentation');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createArchitectureDecisions(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'architecture-decisions.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Architecture Decisions');
-    }
-    async generateSoftwareGuidelinesOnly(repoStructure, outputDir, verbose = false) {
-        const docsDir = path.join(outputDir, 'docs');
-        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '📋 Generating software development guidelines');
-        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
-        const content = await this.templates.createSoftwareGuidelines(repoStructure, moduleGroups);
-        const filePath = path.join(docsDir, 'software-guidelines.md');
-        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Software Development Guidelines');
+            sections.push({
+                fileName: guide.file,
+                content: renderer
+            });
+        });
+        return sections;
     }
 }
 exports.DocumentationGenerator = DocumentationGenerator;

package/dist/generators/documentation/documentationGenerator.js.map

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

package/dist/generators/documentation/guideRegistry.d.ts

@@ -0,0 +1,6 @@
+import { GuideMeta } from './templates/types';
+export declare const DOCUMENT_GUIDES: GuideMeta[];
+export declare const DOCUMENT_GUIDE_KEYS: string[];
+export declare function getGuidesByKeys(keys?: string[]): GuideMeta[];
+export declare function getDocFilesByKeys(keys?: string[]): Set<string> | undefined;
+//# sourceMappingURL=guideRegistry.d.ts.map

package/dist/generators/documentation/guideRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guideRegistry.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/guideRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,eAAO,MAAM,eAAe,EAAE,SAAS,EAyDtC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAA0C,CAAC;AAE3E,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAQ5D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAQ1E"}

package/dist/generators/documentation/guideRegistry.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCUMENT_GUIDE_KEYS = exports.DOCUMENT_GUIDES = void 0;
+exports.getGuidesByKeys = getGuidesByKeys;
+exports.getDocFilesByKeys = getDocFilesByKeys;
+exports.DOCUMENT_GUIDES = [
+    {
+        key: 'project-overview',
+        title: 'Project Overview',
+        file: 'project-overview.md',
+        marker: 'ai-task:project-overview',
+        primaryInputs: 'Roadmap, README, stakeholder notes'
+    },
+    {
+        key: 'architecture',
+        title: 'Architecture Notes',
+        file: 'architecture.md',
+        marker: 'ai-task:architecture-notes',
+        primaryInputs: 'ADRs, service boundaries, dependency graphs'
+    },
+    {
+        key: 'development-workflow',
+        title: 'Development Workflow',
+        file: 'development-workflow.md',
+        marker: 'ai-task:development-workflow',
+        primaryInputs: 'Branching rules, CI config, contributing guide'
+    },
+    {
+        key: 'testing-strategy',
+        title: 'Testing Strategy',
+        file: 'testing-strategy.md',
+        marker: 'ai-task:testing-strategy',
+        primaryInputs: 'Test configs, CI gates, known flaky suites'
+    },
+    {
+        key: 'glossary',
+        title: 'Glossary & Domain Concepts',
+        file: 'glossary.md',
+        marker: 'ai-task:glossary',
+        primaryInputs: 'Business terminology, user personas, domain rules'
+    },
+    {
+        key: 'data-flow',
+        title: 'Data Flow & Integrations',
+        file: 'data-flow.md',
+        marker: 'ai-task:data-flow',
+        primaryInputs: 'System diagrams, integration specs, queue topics'
+    },
+    {
+        key: 'security',
+        title: 'Security & Compliance Notes',
+        file: 'security.md',
+        marker: 'ai-task:security',
+        primaryInputs: 'Auth model, secrets management, compliance requirements'
+    },
+    {
+        key: 'tooling',
+        title: 'Tooling & Productivity Guide',
+        file: 'tooling.md',
+        marker: 'ai-task:tooling',
+        primaryInputs: 'CLI scripts, IDE configs, automation workflows'
+    }
+];
+exports.DOCUMENT_GUIDE_KEYS = exports.DOCUMENT_GUIDES.map(guide => guide.key);
+function getGuidesByKeys(keys) {
+    if (!keys || keys.length === 0) {
+        return exports.DOCUMENT_GUIDES;
+    }
+    const set = new Set(keys);
+    const filtered = exports.DOCUMENT_GUIDES.filter(guide => set.has(guide.key));
+    return filtered.length > 0 ? filtered : exports.DOCUMENT_GUIDES;
+}
+function getDocFilesByKeys(keys) {
+    if (!keys || keys.length === 0) {
+        return undefined;
+    }
+    const files = exports.DOCUMENT_GUIDES
+        .filter(guide => keys.includes(guide.key))
+        .map(guide => guide.file);
+    return files.length ? new Set(files) : undefined;
+}
+//# sourceMappingURL=guideRegistry.js.map

package/dist/generators/documentation/guideRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guideRegistry.js","sourceRoot":"","sources":["../../../src/generators/documentation/guideRegistry.ts"],"names":[],"mappings":";;;AA+DA,0CAQC;AAED,8CAQC;AA/EY,QAAA,eAAe,GAAgB;IAC1C;QACE,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,0BAA0B;QAClC,aAAa,EAAE,oCAAoC;KACpD;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,4BAA4B;QACpC,aAAa,EAAE,6CAA6C;KAC7D;IACD;QACE,GAAG,EAAE,sBAAsB;QAC3B,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,8BAA8B;QACtC,aAAa,EAAE,gDAAgD;KAChE;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,0BAA0B;QAClC,aAAa,EAAE,4CAA4C;KAC5D;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,kBAAkB;QAC1B,aAAa,EAAE,mDAAmD;KACnE;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,0BAA0B;QACjC,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,mBAAmB;QAC3B,aAAa,EAAE,kDAAkD;KAClE;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,kBAAkB;QAC1B,aAAa,EAAE,yDAAyD;KACzE;IACD;QACE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,8BAA8B;QACrC,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,iBAAiB;QACzB,aAAa,EAAE,gDAAgD;KAChE;CACF,CAAC;AAEW,QAAA,mBAAmB,GAAG,uBAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAE3E,SAAgB,eAAe,CAAC,IAAe;IAC7C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,uBAAe,CAAC;IACzB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,uBAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAe,CAAC;AAC1D,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAe;IAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,uBAAe;SAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACzC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}

package/dist/generators/documentation/index.d.ts

@@ -1,8 +1,2 @@
 export { DocumentationGenerator } from './documentationGenerator';
-export { DocumentationUtils } from './documentationUtils';
-export { DocumentationTemplates } from './documentationTemplates';
-export { IncrementalDocumentationGenerator } from './incrementalDocumentationGenerator';
-export { DOCUMENTATION_TYPES, DOCUMENTATION_TYPES_ARRAY, DocumentationType, DocumentationConfig, DOCUMENTATION_CONFIG_FILES } from './documentationTypes';
-export { CodebaseAnalyzer } from '../analyzers';
-export { GuidelinesGenerator, GuidelinesAnalyzer, GuidelineCategory, GuidelineConfig } from '../guidelines';
 //# sourceMappingURL=index.d.ts.map

package/dist/generators/documentation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/generators/documentation/index.js

@@ -1,22 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GuidelinesAnalyzer = exports.GuidelinesGenerator = exports.CodebaseAnalyzer = exports.DOCUMENTATION_CONFIG_FILES = exports.DOCUMENTATION_TYPES_ARRAY = exports.DOCUMENTATION_TYPES = exports.IncrementalDocumentationGenerator = exports.DocumentationTemplates = exports.DocumentationUtils = exports.DocumentationGenerator = void 0;
+exports.DocumentationGenerator = void 0;
 var documentationGenerator_1 = require("./documentationGenerator");
 Object.defineProperty(exports, "DocumentationGenerator", { enumerable: true, get: function () { return documentationGenerator_1.DocumentationGenerator; } });
-var documentationUtils_1 = require("./documentationUtils");
-Object.defineProperty(exports, "DocumentationUtils", { enumerable: true, get: function () { return documentationUtils_1.DocumentationUtils; } });
-var documentationTemplates_1 = require("./documentationTemplates");
-Object.defineProperty(exports, "DocumentationTemplates", { enumerable: true, get: function () { return documentationTemplates_1.DocumentationTemplates; } });
-var incrementalDocumentationGenerator_1 = require("./incrementalDocumentationGenerator");
-Object.defineProperty(exports, "IncrementalDocumentationGenerator", { enumerable: true, get: function () { return incrementalDocumentationGenerator_1.IncrementalDocumentationGenerator; } });
-var documentationTypes_1 = require("./documentationTypes");
-Object.defineProperty(exports, "DOCUMENTATION_TYPES", { enumerable: true, get: function () { return documentationTypes_1.DOCUMENTATION_TYPES; } });
-Object.defineProperty(exports, "DOCUMENTATION_TYPES_ARRAY", { enumerable: true, get: function () { return documentationTypes_1.DOCUMENTATION_TYPES_ARRAY; } });
-Object.defineProperty(exports, "DOCUMENTATION_CONFIG_FILES", { enumerable: true, get: function () { return documentationTypes_1.DOCUMENTATION_CONFIG_FILES; } });
-// Re-export analyzers and guidelines for convenience
-var analyzers_1 = require("../analyzers");
-Object.defineProperty(exports, "CodebaseAnalyzer", { enumerable: true, get: function () { return analyzers_1.CodebaseAnalyzer; } });
-var guidelines_1 = require("../guidelines");
-Object.defineProperty(exports, "GuidelinesGenerator", { enumerable: true, get: function () { return guidelines_1.GuidelinesGenerator; } });
-Object.defineProperty(exports, "GuidelinesAnalyzer", { enumerable: true, get: function () { return guidelines_1.GuidelinesAnalyzer; } });
 //# sourceMappingURL=index.js.map

package/dist/generators/documentation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/documentation/index.ts"],"names":[],"mappings":";;;AAAA,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,yFAAwF;AAA/E,sJAAA,iCAAiC,OAAA;AAC1C,2DAM8B;AAL5B,yHAAA,mBAAmB,OAAA;AACnB,+HAAA,yBAAyB,OAAA;AAGzB,gIAAA,0BAA0B,OAAA;AAG5B,qDAAqD;AACrD,0CAAgD;AAAvC,6GAAA,gBAAgB,OAAA;AACzB,4CAKuB;AAJrB,iHAAA,mBAAmB,OAAA;AACnB,gHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/documentation/index.ts"],"names":[],"mappings":";;;AAAA,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA"}

package/dist/generators/documentation/templates/architectureTemplate.d.ts

@@ -0,0 +1,3 @@
+import { DocumentationTemplateContext } from './types';
+export declare function renderArchitectureNotes(context: DocumentationTemplateContext): string;
+//# sourceMappingURL=architectureTemplate.d.ts.map

package/dist/generators/documentation/templates/architectureTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architectureTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/architectureTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CA8DrF"}

package/dist/generators/documentation/templates/architectureTemplate.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderArchitectureNotes = renderArchitectureNotes;
+const frontMatter_1 = require("./frontMatter");
+const common_1 = require("./common");
+function renderArchitectureNotes(context) {
+    const frontMatter = (0, frontMatter_1.createFrontMatter)({
+        id: 'architecture-notes',
+        goal: 'Describe how the system is assembled, key trade-offs, and active constraints.',
+        requiredInputs: [
+            'Recent architectural decisions or ADRs',
+            'Observed service/module boundaries in the codebase',
+            'Dependency graphs or build tooling insights'
+        ],
+        successCriteria: [
+            'Decision list covers the most influential trade-offs',
+            'Risks capture active constraints or technical debt',
+            'Links to diagrams or monitors are up to date'
+        ],
+        relatedAgents: ['architect-specialist', 'backend-specialist']
+    });
+    const defaultSections = [
+        'System boundaries and integration points',
+        'Primary modules and their responsibilities',
+        'Data flow between major components',
+        'Dependencies worth highlighting'
+    ];
+    const directorySnapshot = (0, common_1.formatDirectoryStats)(context.directoryStats);
+    return `${frontMatter}
+<!-- ai-task:architecture-notes -->
+# Architecture Notes
+
+> TODO: Describe how the system is assembled and why the current design exists.
+
+## Decisions To Record
+${defaultSections.map(item => `- ${item}`).join('\n')}
+
+## Diagrams
+- Link architectural diagrams or add mermaid definitions here.
+
+## Risks & Constraints
+- Document performance constraints, scaling considerations, or external system assumptions.
+
+## Top Directories Snapshot
+${directorySnapshot}
+
+## AI Update Checklist
+1. Review ADRs, design docs, or major PRs for architectural changes.
+2. Verify that each documented decision still holds; mark superseded choices clearly.
+3. Capture upstream/downstream impacts (APIs, events, data flows).
+4. Update Risks & Constraints with active incident learnings or TODO debt.
+5. Link any new diagrams or dashboards referenced in recent work.
+
+## Acceptable Sources
+- ADR folders, \`/docs/architecture\` notes, or RFC threads.
+- Dependency visualisations from build tooling or scripts.
+- Issue tracker discussions vetted by maintainers.
+
+## Related Resources
+- [Project Overview](./project-overview.md)
+- Update [agents/README.md](../agents/README.md) when architecture changes.
+
+<!-- /ai-task -->
+`;
+}
+//# sourceMappingURL=architectureTemplate.js.map

package/dist/generators/documentation/templates/architectureTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architectureTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/architectureTemplate.ts"],"names":[],"mappings":";;AAIA,0DA8DC;AAlED,+CAAkD;AAElD,qCAAgD;AAEhD,SAAgB,uBAAuB,CAAC,OAAqC;IAC3E,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC;QACpC,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,+EAA+E;QACrF,cAAc,EAAE;YACd,wCAAwC;YACxC,oDAAoD;YACpD,6CAA6C;SAC9C;QACD,eAAe,EAAE;YACf,sDAAsD;YACtD,oDAAoD;YACpD,8CAA8C;SAC/C;QACD,aAAa,EAAE,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;KAC9D,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG;QACtB,0CAA0C;QAC1C,4CAA4C;QAC5C,oCAAoC;QACpC,iCAAiC;KAClC,CAAC;IAEF,MAAM,iBAAiB,GAAG,IAAA,6BAAoB,EAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAEvE,OAAO,GAAG,WAAW;;;;;;;EAOrB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;EASnD,iBAAiB;;;;;;;;;;;;;;;;;;;CAmBlB,CAAC;AACF,CAAC"}

package/dist/generators/documentation/templates/common.d.ts

@@ -0,0 +1,7 @@
+import { DirectoryStat, DocumentationTemplateContext } from './types';
+export declare function formatDirectoryList(context: DocumentationTemplateContext, includePlaceholders: boolean): string;
+export declare function buildDocumentMapTable(guides: DocumentationTemplateContext['guides']): string;
+export declare function formatDirectoryStats(stats: DirectoryStat[]): string;
+export declare function formatInlineDirectoryList(directories: string[]): string;
+export declare function slugify(value: string): string;
+//# sourceMappingURL=common.d.ts.map

package/dist/generators/documentation/templates/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAWtE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,4BAA4B,EACrC,mBAAmB,EAAE,OAAO,GAC3B,MAAM,CAoBR;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,GAAG,MAAM,CAG5F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAQnE;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAMvE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7C"}

package/dist/generators/documentation/templates/common.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDirectoryList = formatDirectoryList;
+exports.buildDocumentMapTable = buildDocumentMapTable;
+exports.formatDirectoryStats = formatDirectoryStats;
+exports.formatInlineDirectoryList = formatInlineDirectoryList;
+exports.slugify = slugify;
+const KNOWN_DESCRIPTIONS = {
+    src: 'TypeScript source files and CLI entrypoints.',
+    dist: 'Compiled JavaScript output generated by the build step.',
+    docs: 'Living documentation produced by this tool.',
+    agents: 'AI agent playbooks and prompts.',
+    tests: 'Automated tests and fixtures.',
+    packages: 'Workspace packages or modules.'
+};
+function formatDirectoryList(context, includePlaceholders) {
+    if (context.topLevelDirectories.length === 0) {
+        return '';
+    }
+    return context.topLevelDirectories
+        .map(dir => {
+        const description = KNOWN_DESCRIPTIONS[dir];
+        if (description) {
+            return `- \`${dir}/\` — ${description}`;
+        }
+        if (!includePlaceholders) {
+            return `- \`${dir}/\``;
+        }
+        const slotId = slugify(dir);
+        return `- <!-- ai-slot:directory-${slotId} -->\`${dir}/\` — TODO: Describe the purpose of this directory.<!-- /ai-slot -->`;
+    })
+        .join('\n');
+}
+function buildDocumentMapTable(guides) {
+    const rows = guides.map(meta => `| ${meta.title} | \`${meta.file}\` | ${meta.marker} | ${meta.primaryInputs} |`);
+    return ['| Guide | File | Task Marker | Primary Inputs |', '| --- | --- | --- | --- |', ...rows].join('\n');
+}
+function formatDirectoryStats(stats) {
+    if (!stats.length) {
+        return '*No directories detected.*';
+    }
+    return stats
+        .map(stat => `- \`${stat.name}/\` — approximately ${stat.fileCount} files`)
+        .join('\n');
+}
+function formatInlineDirectoryList(directories) {
+    if (!directories.length) {
+        return '`n/a`';
+    }
+    return directories.map(dir => `\`${dir}\``).join(', ');
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=common.js.map

package/dist/generators/documentation/templates/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/common.ts"],"names":[],"mappings":";;AAWA,kDAuBC;AAED,sDAGC;AAED,oDAQC;AAED,8DAMC;AAED,0BAKC;AA9DD,MAAM,kBAAkB,GAA2B;IACjD,GAAG,EAAE,8CAA8C;IACnD,IAAI,EAAE,yDAAyD;IAC/D,IAAI,EAAE,6CAA6C;IACnD,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE,+BAA+B;IACtC,QAAQ,EAAE,gCAAgC;CAC3C,CAAC;AAEF,SAAgB,mBAAmB,CACjC,OAAqC,EACrC,mBAA4B;IAE5B,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,CAAC,mBAAmB;SAC/B,GAAG,CAAC,GAAG,CAAC,EAAE;QACT,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,OAAO,GAAG,SAAS,WAAW,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,OAAO,OAAO,GAAG,KAAK,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,4BAA4B,MAAM,SAAS,GAAG,sEAAsE,CAAC;IAC9H,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAA8C;IAClF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;IACjH,OAAO,CAAC,iDAAiD,EAAE,2BAA2B,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9G,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAsB;IACzD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,uBAAuB,IAAI,CAAC,SAAS,QAAQ,CAAC;SAC1E,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAgB,yBAAyB,CAAC,WAAqB;IAC7D,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/generators/documentation/templates/dataFlowTemplate.d.ts

@@ -0,0 +1,3 @@
+import { DocumentationTemplateContext } from './types';
+export declare function renderDataFlow(context: DocumentationTemplateContext): string;
+//# sourceMappingURL=dataFlowTemplate.d.ts.map

package/dist/generators/documentation/templates/dataFlowTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataFlowTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/dataFlowTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,wBAAgB,cAAc,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAiD5E"}

package/dist/generators/documentation/templates/dataFlowTemplate.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderDataFlow = renderDataFlow;
+const frontMatter_1 = require("./frontMatter");
+const common_1 = require("./common");
+function renderDataFlow(context) {
+    const frontMatter = (0, frontMatter_1.createFrontMatter)({
+        id: 'data-flow',
+        goal: 'Describe how information moves through the system and where it integrates with external services.',
+        requiredInputs: [
+            'Architecture diagrams or sequence flows',
+            'Integration specs (APIs, queues, webhooks, third-party services)',
+            'Notes on batch jobs, schedulers, or ETL processes'
+        ],
+        successCriteria: [
+            'Highlights inbound, internal, and outbound flows',
+            'Documents transformation points and trust boundaries',
+            'Identifies failure modes and retry/backoff behaviour'
+        ],
+        relatedAgents: ['architect-specialist', 'backend-specialist']
+    });
+    return `${frontMatter}
+<!-- ai-task:data-flow -->
+# Data Flow & Integrations
+
+Explain how data enters, moves through, and exits the system, including interactions with external services.
+
+## High-level Flow
+- Summarize the primary pipeline from input to output. Reference diagrams or embed Mermaid definitions when available.
+
+## Internal Movement
+- Describe how modules within ${(0, common_1.formatInlineDirectoryList)(context.topLevelDirectories)} collaborate (queues, events, RPC calls, shared databases).
+
+## External Integrations
+- <!-- ai-slot:integration -->**Integration** — Purpose, authentication, payload shapes, retry strategy.<!-- /ai-slot -->
+
+## Observability & Failure Modes
+- Metrics, traces, or logs that monitor the flow.
+- Backoff, dead-letter, or compensating actions when downstream systems fail.
+
+## AI Update Checklist
+1. Validate flows against the latest integration contracts or diagrams.
+2. Update authentication, scopes, or rate limits when they change.
+3. Capture recent incidents or lessons learned that influenced reliability.
+4. Link to runbooks or dashboards used during triage.
+
+## Acceptable Sources
+- Architecture diagrams, ADRs, integration playbooks.
+- API specs, queue/topic definitions, infrastructure code.
+- Postmortems or incident reviews impacting data movement.
+
+<!-- /ai-task -->
+`;
+}
+//# sourceMappingURL=dataFlowTemplate.js.map

package/dist/generators/documentation/templates/dataFlowTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataFlowTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/dataFlowTemplate.ts"],"names":[],"mappings":";;AAIA,wCAiDC;AArDD,+CAAkD;AAElD,qCAAqD;AAErD,SAAgB,cAAc,CAAC,OAAqC;IAClE,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC;QACpC,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,mGAAmG;QACzG,cAAc,EAAE;YACd,yCAAyC;YACzC,kEAAkE;YAClE,mDAAmD;SACpD;QACD,eAAe,EAAE;YACf,kDAAkD;YAClD,sDAAsD;YACtD,sDAAsD;SACvD;QACD,aAAa,EAAE,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;KAC9D,CAAC,CAAC;IAEH,OAAO,GAAG,WAAW;;;;;;;;;;gCAUS,IAAA,kCAAyB,EAAC,OAAO,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBrF,CAAC;AACF,CAAC"}

package/dist/generators/documentation/templates/developmentWorkflowTemplate.d.ts

@@ -0,0 +1,2 @@
+export declare function renderDevelopmentWorkflow(): string;
+//# sourceMappingURL=developmentWorkflowTemplate.d.ts.map

package/dist/generators/documentation/templates/developmentWorkflowTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"developmentWorkflowTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/developmentWorkflowTemplate.ts"],"names":[],"mappings":"AAEA,wBAAgB,yBAAyB,IAAI,MAAM,CAsDlD"}