@ai-coders/context 0.7.0 → 0.7.1

package/dist/generators/shared/structures/agents/factory.js

@@ -4,10 +4,125 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAgentStructure = createAgentStructure;
+/**
+ * Map of section headings to content keys
+ */
+const SECTION_KEY_MAP = {
+    'Mission': 'mission',
+    'Responsibilities': 'responsibilities',
+    'Best Practices': 'bestPractices',
+    'Key Project Resources': 'keyProjectResources',
+    'Repository Starting Points': 'repositoryStartingPoints',
+    'Key Files': 'keyFiles',
+    'Architecture Context': 'architectureContext',
+    'Key Symbols for This Agent': 'keySymbols',
+    'Documentation Touchpoints': 'documentationTouchpoints',
+    'Collaboration Checklist': 'collaborationChecklist',
+    'Hand-off Notes': 'handoffNotes',
+};
 /**
  * Create an agent structure with standard sections
  */
-function createAgentStructure(agentType, title, description, additionalContext) {
+function createAgentStructure(agentType, title, description, additionalContext, defaultContent) {
+    const sections = [
+        {
+            heading: 'Mission',
+            order: 1,
+            contentType: 'prose',
+            guidance: `Describe how the ${title.toLowerCase()} agent supports the team and when to engage it.`,
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Responsibilities',
+            order: 2,
+            contentType: 'list',
+            guidance: 'List specific responsibilities this agent handles. Be concrete about what tasks it performs.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Best Practices',
+            order: 3,
+            contentType: 'list',
+            guidance: 'List best practices and guidelines for this agent to follow.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Key Project Resources',
+            order: 4,
+            contentType: 'list',
+            guidance: 'Link to documentation index, agent handbook, AGENTS.md, and contributor guide.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Repository Starting Points',
+            order: 5,
+            contentType: 'list',
+            guidance: 'List top-level directories relevant to this agent with brief descriptions.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Key Files',
+            order: 6,
+            contentType: 'list',
+            guidance: 'List entry points, pattern implementations, and service files relevant to this agent.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Architecture Context',
+            order: 7,
+            contentType: 'list',
+            guidance: 'For each architectural layer, describe directories, symbol counts, and key exports.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Key Symbols for This Agent',
+            order: 8,
+            contentType: 'list',
+            guidance: 'List symbols (classes, functions, types) most relevant to this agent with links.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Documentation Touchpoints',
+            order: 9,
+            contentType: 'list',
+            guidance: 'Link to relevant documentation files this agent should reference.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Collaboration Checklist',
+            order: 10,
+            contentType: 'checklist',
+            guidance: 'Numbered checklist for agent workflow: confirm assumptions, review PRs, update docs, capture learnings.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Hand-off Notes',
+            order: 11,
+            contentType: 'prose',
+            guidance: 'Summarize outcomes, remaining risks, and suggested follow-up actions after the agent completes work.',
+            required: false,
+            headingLevel: 2,
+        },
+    ];
+    // Apply default content to sections
+    if (defaultContent) {
+        for (const section of sections) {
+            const key = SECTION_KEY_MAP[section.heading];
+            if (key && defaultContent[key]) {
+                section.defaultContent = defaultContent[key];
+            }
+        }
+    }
     return {
         fileType: 'agent',
         documentName: agentType,
@@ -15,96 +130,7 @@ function createAgentStructure(agentType, title, description, additionalContext)
         description,
         tone: 'instructional',
         audience: 'ai-agents',
-        sections: [
-            {
-                heading: 'Mission',
-                order: 1,
-                contentType: 'prose',
-                guidance: `Describe how the ${title.toLowerCase()} agent supports the team and when to engage it.`,
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Responsibilities',
-                order: 2,
-                contentType: 'list',
-                guidance: 'List specific responsibilities this agent handles. Be concrete about what tasks it performs.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Best Practices',
-                order: 3,
-                contentType: 'list',
-                guidance: 'List best practices and guidelines for this agent to follow.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Key Project Resources',
-                order: 4,
-                contentType: 'list',
-                guidance: 'Link to documentation index, agent handbook, AGENTS.md, and contributor guide.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Repository Starting Points',
-                order: 5,
-                contentType: 'list',
-                guidance: 'List top-level directories relevant to this agent with brief descriptions.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Key Files',
-                order: 6,
-                contentType: 'list',
-                guidance: 'List entry points, pattern implementations, and service files relevant to this agent.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Architecture Context',
-                order: 7,
-                contentType: 'list',
-                guidance: 'For each architectural layer, describe directories, symbol counts, and key exports.',
-                required: false,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Key Symbols for This Agent',
-                order: 8,
-                contentType: 'list',
-                guidance: 'List symbols (classes, functions, types) most relevant to this agent with links.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Documentation Touchpoints',
-                order: 9,
-                contentType: 'list',
-                guidance: 'Link to relevant documentation files this agent should reference.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Collaboration Checklist',
-                order: 10,
-                contentType: 'checklist',
-                guidance: 'Numbered checklist for agent workflow: confirm assumptions, review PRs, update docs, capture learnings.',
-                required: true,
-                headingLevel: 2,
-            },
-            {
-                heading: 'Hand-off Notes',
-                order: 11,
-                contentType: 'prose',
-                guidance: 'Summarize outcomes, remaining risks, and suggested follow-up actions after the agent completes work.',
-                required: false,
-                headingLevel: 2,
-            },
-        ],
+        sections,
         linkTo: ['../docs/README.md', 'README.md', '../../AGENTS.md'],
         additionalContext,
     };

package/dist/generators/shared/structures/agents/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/agents/factory.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,oDA0GC;AA7GD;;GAEG;AACH,SAAgB,oBAAoB,CAClC,SAAiB,EACjB,KAAa,EACb,WAAmB,EACnB,iBAA0B;IAE1B,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,YAAY,EAAE,SAAS;QACvB,KAAK,EAAE,GAAG,KAAK,iBAAiB;QAChC,WAAW;QACX,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,OAAO;gBACpB,QAAQ,EAAE,oBAAoB,KAAK,CAAC,WAAW,EAAE,iDAAiD;gBAClG,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,kBAAkB;gBAC3B,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,8FAA8F;gBACxG,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,gBAAgB;gBACzB,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,8DAA8D;gBACxE,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,uBAAuB;gBAChC,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,gFAAgF;gBAC1F,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,4BAA4B;gBACrC,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,4EAA4E;gBACtF,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,WAAW;gBACpB,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,uFAAuF;gBACjG,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,sBAAsB;gBAC/B,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,qFAAqF;gBAC/F,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,4BAA4B;gBACrC,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,kFAAkF;gBAC5F,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,2BAA2B;gBACpC,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,mEAAmE;gBAC7E,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,yBAAyB;gBAClC,KAAK,EAAE,EAAE;gBACT,WAAW,EAAE,WAAW;gBACxB,QAAQ,EAAE,yGAAyG;gBACnH,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,CAAC;aAChB;YACD;gBACE,OAAO,EAAE,gBAAgB;gBACzB,KAAK,EAAE,EAAE;gBACT,WAAW,EAAE,OAAO;gBACpB,QAAQ,EAAE,sGAAsG;gBAChH,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,CAAC;aAChB;SACF;QACD,MAAM,EAAE,CAAC,mBAAmB,EAAE,WAAW,EAAE,iBAAiB,CAAC;QAC7D,iBAAiB;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/agents/factory.ts"],"names":[],"mappings":"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"}

package/dist/generators/shared/structures/documentation/architecture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/architecture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,qBAAqB,EAAE,iBAoHnC,CAAC"}
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/architecture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,qBAAqB,EAAE,iBA2KnC,CAAC"}

package/dist/generators/shared/structures/documentation/architecture.js

@@ -16,6 +16,9 @@ exports.architectureStructure = {
             guidance: 'Describe how the system is assembled and why the current design exists.',
             required: true,
             headingLevel: 2,
+            defaultContent: `This document describes the system architecture, design patterns, and key technical decisions.
+
+For complete symbol counts and dependency analysis, see [\`codebase-map.json\`](./codebase-map.json).`,
         },
         {
             heading: 'System Architecture Overview',
@@ -24,6 +27,17 @@ exports.architectureStructure = {
             guidance: 'Summarize the top-level topology (monolith, modular service, microservices) and deployment model. Highlight how requests traverse the system and where control pivots between layers.',
             required: true,
             headingLevel: 2,
+            defaultContent: `**Architecture Style**: [Monolith / Modular Monolith / Microservices]
+
+**Key Components**:
+- **Entry Layer**: Handles incoming requests (CLI, HTTP, etc.)
+- **Service Layer**: Core business logic and orchestration
+- **Data Layer**: Persistence and external service integration
+
+**Request Flow**:
+1. Request enters through entry point
+2. Routed to appropriate service handler
+3. Service processes and returns response`,
         },
         {
             heading: 'Architectural Layers',
@@ -33,6 +47,12 @@ exports.architectureStructure = {
             exampleContent: '- **Services**: Core business logic (`src/services/`)\n- **Generators**: Content generation (`src/generators/`)\n\n> See [`codebase-map.json`](./codebase-map.json) for complete symbol counts and dependency graphs.',
             required: true,
             headingLevel: 2,
+            defaultContent: `- **Entry Points**: Application entry and initialization (\`src/\`)
+- **Services**: Core business logic (\`src/services/\`)
+- **Models/Types**: Data structures and type definitions (\`src/types/\`)
+- **Utilities**: Shared helper functions (\`src/utils/\`)
+
+> See [\`codebase-map.json\`](./codebase-map.json) for complete symbol counts and dependency graphs.`,
         },
         {
             heading: 'Detected Design Patterns',
@@ -42,6 +62,11 @@ exports.architectureStructure = {
             exampleContent: '| Pattern | Confidence | Locations | Description |\n|---------|------------|-----------|-------------|\n| Factory | 85% | `LLMClientFactory` | Creates LLM client instances |',
             required: true,
             headingLevel: 2,
+            defaultContent: `| Pattern | Locations | Description |
+|---------|-----------|-------------|
+| [Pattern Name] | \`src/path/\` | [Brief description] |
+
+*Update this table as patterns are identified in the codebase.*`,
         },
         {
             heading: 'Entry Points',
@@ -50,6 +75,8 @@ exports.architectureStructure = {
             guidance: 'List entry points with markdown links to the actual files.',
             required: true,
             headingLevel: 2,
+            defaultContent: `- [\`src/index.ts\`](../src/index.ts) — Main module entry
+- [\`src/cli.ts\`](../src/cli.ts) — CLI entry point (if applicable)`,
         },
         {
             heading: 'Public API',
@@ -58,6 +85,11 @@ exports.architectureStructure = {
             guidance: 'Table of exported symbols with Symbol, Type, and Location columns.',
             required: true,
             headingLevel: 2,
+            defaultContent: `| Symbol | Type | Location |
+|--------|------|----------|
+| [ExportName] | class/function/type | \`src/path.ts\` |
+
+See [\`codebase-map.json\`](./codebase-map.json) for the complete public API listing.`,
         },
         {
             heading: 'Internal System Boundaries',
@@ -82,6 +114,13 @@ exports.architectureStructure = {
             guidance: 'Summarize architectural decisions, experiments, or ADR outcomes. Explain why selected approaches won over alternatives.',
             required: false,
             headingLevel: 2,
+            defaultContent: `Document key architectural decisions here. Consider creating Architecture Decision Records (ADRs) for significant choices.
+
+**Template**:
+- **Decision**: [What was decided]
+- **Context**: [Why this decision was needed]
+- **Alternatives**: [What else was considered]
+- **Consequences**: [Impact of this decision]`,
         },
         {
             heading: 'Diagrams',
@@ -90,6 +129,14 @@ exports.architectureStructure = {
             guidance: 'Link architectural diagrams or add mermaid definitions showing system components and their relationships.',
             required: false,
             headingLevel: 2,
+            defaultContent: `\`\`\`mermaid
+graph TD
+    A[Entry Point] --> B[Service Layer]
+    B --> C[Data Layer]
+    B --> D[External Services]
+\`\`\`
+
+*Replace with actual system architecture diagram.*`,
         },
         {
             heading: 'Risks & Constraints',
@@ -106,6 +153,11 @@ exports.architectureStructure = {
             guidance: 'List top directories with approximate file counts.',
             required: true,
             headingLevel: 2,
+            defaultContent: `- \`src/\` — Source code
+- \`tests/\` — Test files
+- \`docs/\` — Documentation
+
+*See [\`codebase-map.json\`](./codebase-map.json) for detailed file counts.*`,
         },
         {
             heading: 'Related Resources',
@@ -114,6 +166,9 @@ exports.architectureStructure = {
             guidance: 'Link to Project Overview and other relevant documentation.',
             required: true,
             headingLevel: 2,
+            defaultContent: `- [Project Overview](./project-overview.md)
+- [Data Flow](./data-flow.md) (if applicable)
+- [Codebase Map](./codebase-map.json)`,
         },
     ],
     linkTo: ['project-overview.md', 'data-flow.md', 'codebase-map.json'],

package/dist/generators/shared/structures/documentation/architecture.js.map

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

package/dist/generators/shared/structures/documentation/dataFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataFlow.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/dataFlow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,iBAmE/B,CAAC"}
+{"version":3,"file":"dataFlow.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/dataFlow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,iBAsG/B,CAAC"}

package/dist/generators/shared/structures/documentation/dataFlow.js

@@ -16,6 +16,9 @@ exports.dataFlowStructure = {
             guidance: 'Explain how data enters, moves through, and exits the system, including interactions with external services.',
             required: true,
             headingLevel: 2,
+            defaultContent: `This document describes how data flows through the system, including internal processing and external integrations.
+
+Understanding data flow helps with debugging, performance optimization, and maintaining system reliability.`,
         },
         {
             heading: 'Module Dependencies',
@@ -25,6 +28,13 @@ exports.dataFlowStructure = {
             exampleContent: '- **src/** → `utils`, `config`\n- **services/** → `utils`',
             required: true,
             headingLevel: 2,
+            defaultContent: `Module dependency overview:
+
+- **Entry Layer** → Services, Utils
+- **Services** → Data Access, External APIs
+- **Data Access** → Database, Cache
+
+*See [\`codebase-map.json\`](./codebase-map.json) for detailed dependency graphs.*`,
         },
         {
             heading: 'Service Layer',
@@ -33,6 +43,11 @@ exports.dataFlowStructure = {
             guidance: 'List service classes with links to their implementations.',
             required: true,
             headingLevel: 2,
+            defaultContent: `Key services in the system:
+
+- **[ServiceName]** — [Purpose] (\`src/services/path.ts\`)
+
+*See [\`codebase-map.json\`](./codebase-map.json) for complete service listings.*`,
         },
         {
             heading: 'High-level Flow',
@@ -41,6 +56,19 @@ exports.dataFlowStructure = {
             guidance: 'Summarize the primary pipeline from input to output. Reference diagrams or embed Mermaid definitions.',
             required: true,
             headingLevel: 2,
+            defaultContent: `\`\`\`mermaid
+flowchart LR
+    A[Input] --> B[Processing]
+    B --> C[Storage]
+    B --> D[Output]
+\`\`\`
+
+**Data Flow Steps**:
+1. Data enters through entry points (API, CLI, etc.)
+2. Services process and transform data
+3. Results are stored and/or returned to caller
+
+*Replace with actual system data flow.*`,
         },
         {
             heading: 'Internal Movement',
@@ -57,6 +85,13 @@ exports.dataFlowStructure = {
             guidance: 'Document each integration with purpose, authentication, payload shapes, and retry strategy.',
             required: false,
             headingLevel: 2,
+            defaultContent: `**External Services**:
+
+| Service | Purpose | Auth Method |
+|---------|---------|-------------|
+| [Service] | [Purpose] | [API Key/OAuth/etc.] |
+
+*Document error handling and retry strategies for each integration.*`,
         },
         {
             heading: 'Observability & Failure Modes',

package/dist/generators/shared/structures/documentation/dataFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataFlow.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/dataFlow.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,WAAW;IACzB,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,6DAA6D;IAC1E,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8GAA8G;YACxH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uEAAuE;YACjF,cAAc,EAAE,2DAA2D;YAC3E,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,2DAA2D;YACrE,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uGAAuG;YACjH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,iFAAiF;YAC3F,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,6FAA6F;YACvG,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,+BAA+B;YACxC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8GAA8G;YACxH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,iBAAiB,CAAC;CAC5B,CAAC"}
+{"version":3,"file":"dataFlow.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/dataFlow.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,WAAW;IACzB,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,6DAA6D;IAC1E,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8GAA8G;YACxH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;4GAEsF;SACvG;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uEAAuE;YACjF,cAAc,EAAE,2DAA2D;YAC3E,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;mFAM6D;SAC9E;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,2DAA2D;YACrE,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;kFAI4D;SAC7E;QACD;YACE,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uGAAuG;YACjH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;wCAYkB;SACnC;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,iFAAiF;YAC3F,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,6FAA6F;YACvG,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;qEAM+C;SAChE;QACD;YACE,OAAO,EAAE,+BAA+B;YACxC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8GAA8G;YACxH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,iBAAiB,CAAC;CAC5B,CAAC"}

package/dist/generators/shared/structures/documentation/glossary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,iBAkE/B,CAAC"}
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,iBAsF/B,CAAC"}

package/dist/generators/shared/structures/documentation/glossary.js

@@ -16,6 +16,9 @@ exports.glossaryStructure = {
             guidance: 'List project-specific terminology, acronyms, domain entities, and user personas.',
             required: true,
             headingLevel: 2,
+            defaultContent: `This document defines project-specific terminology, concepts, and domain knowledge.
+
+Use this as a reference when encountering unfamiliar terms in the codebase or documentation.`,
         },
         {
             heading: 'Type Definitions',
@@ -24,6 +27,11 @@ exports.glossaryStructure = {
             guidance: 'List exported type definitions and interfaces with links to their locations.',
             required: true,
             headingLevel: 2,
+            defaultContent: `Key type definitions in this project:
+
+- **[TypeName]** — [Description] (\`src/types/path.ts\`)
+
+*See [\`codebase-map.json\`](./codebase-map.json) for complete type listings.*`,
         },
         {
             heading: 'Enumerations',
@@ -32,6 +40,11 @@ exports.glossaryStructure = {
             guidance: 'List exported enums with links to their locations.',
             required: true,
             headingLevel: 2,
+            defaultContent: `Enums defined in this project:
+
+- **[EnumName]** — [Description] (\`src/types/path.ts\`)
+
+*See [\`codebase-map.json\`](./codebase-map.json) for complete enum listings.*`,
         },
         {
             heading: 'Core Terms',
@@ -40,6 +53,9 @@ exports.glossaryStructure = {
             guidance: 'Define key terms, their relevance, and where they surface in the codebase.',
             required: true,
             headingLevel: 2,
+            defaultContent: `**[Term]**: [Definition and context]
+
+Add project-specific terminology here as the codebase evolves.`,
         },
         {
             heading: 'Acronyms & Abbreviations',
@@ -48,6 +64,10 @@ exports.glossaryStructure = {
             guidance: 'Expand abbreviations and note associated services or APIs.',
             required: false,
             headingLevel: 2,
+            defaultContent: `| Acronym | Expansion | Context |
+|---------|-----------|---------|
+| API | Application Programming Interface | External/internal interfaces |
+| CLI | Command Line Interface | User interaction |`,
         },
         {
             heading: 'Personas / Actors',

package/dist/generators/shared/structures/documentation/glossary.js.map

@@ -1 +1 @@
-{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/glossary.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,UAAU;IACxB,KAAK,EAAE,4BAA4B;IACnC,WAAW,EAAE,4EAA4E;IACzF,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,4BAA4B;YACrC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,kFAAkF;YAC5F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,8EAA8E;YACxF,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,oDAAoD;YAC9D,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,4EAA4E;YACtF,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,4DAA4D;YACtE,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8EAA8E;YACxF,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,2BAA2B;YACpC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,+GAA+G;YACzH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,qBAAqB,CAAC;CAChC,CAAC"}
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/glossary.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,UAAU;IACxB,KAAK,EAAE,4BAA4B;IACnC,WAAW,EAAE,4EAA4E;IACzF,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,4BAA4B;YACrC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,kFAAkF;YAC5F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;6FAEuE;SACxF;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,8EAA8E;YACxF,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;+EAIyD;SAC1E;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,oDAAoD;YAC9D,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;+EAIyD;SAC1E;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,4EAA4E;YACtF,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;+DAEyC;SAC1D;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,4DAA4D;YACtE,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;oDAG8B;SAC/C;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8EAA8E;YACxF,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,2BAA2B;YACpC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,+GAA+G;YACzH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,qBAAqB,CAAC;CAChC,CAAC"}

package/dist/generators/shared/structures/documentation/projectOverview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projectOverview.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/projectOverview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBA8GtC,CAAC"}
+{"version":3,"file":"projectOverview.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/projectOverview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBA8JtC,CAAC"}

package/dist/generators/shared/structures/documentation/projectOverview.js

@@ -16,6 +16,9 @@ exports.projectOverviewStructure = {
             guidance: 'Summarize in 2-3 sentences what problem this project solves and who benefits from it. Focus on the value proposition.',
             required: true,
             headingLevel: 2,
+            defaultContent: `This project provides [describe main functionality]. It helps [target users] to [key benefit].
+
+The codebase is organized to support [main use case] with a focus on [key qualities like maintainability, performance, etc.].`,
         },
         {
             heading: 'Codebase Reference',
@@ -25,6 +28,7 @@ exports.projectOverviewStructure = {
             exampleContent: '> **Detailed Analysis**: For complete symbol counts, architecture layers, and dependency graphs, see [`codebase-map.json`](./codebase-map.json).',
             required: true,
             headingLevel: 2,
+            defaultContent: `> **Detailed Analysis**: For complete symbol counts, architecture layers, and dependency graphs, see [\`codebase-map.json\`](./codebase-map.json).`,
         },
         {
             heading: 'Quick Facts',
@@ -34,6 +38,10 @@ exports.projectOverviewStructure = {
             exampleContent: '- Root: `/path/to/repo`\n- Languages: TypeScript (150 files), Python (20 files)\n- Entry: `src/index.ts`\n- Full analysis: [`codebase-map.json`](./codebase-map.json)',
             required: true,
             headingLevel: 2,
+            defaultContent: `- **Root**: \`./\`
+- **Primary Language**: [Language] ([X] files)
+- **Entry Point**: \`src/index.ts\` or \`src/main.ts\`
+- **Full Analysis**: [\`codebase-map.json\`](./codebase-map.json)`,
         },
         {
             heading: 'Entry Points',
@@ -42,6 +50,9 @@ exports.projectOverviewStructure = {
             guidance: 'List main entry points with links (CLI, server, library exports). Use markdown links with line numbers.',
             required: true,
             headingLevel: 2,
+            defaultContent: `- **Main Entry**: \`src/index.ts\` - Primary module exports
+- **CLI**: \`src/cli.ts\` - Command-line interface (if applicable)
+- **Server**: \`src/server.ts\` - HTTP server entry (if applicable)`,
         },
         {
             heading: 'Key Exports',
@@ -50,6 +61,10 @@ exports.projectOverviewStructure = {
             guidance: 'Reference codebase-map.json for the complete list.',
             required: true,
             headingLevel: 2,
+            defaultContent: `See [\`codebase-map.json\`](./codebase-map.json) for the complete list of exported symbols.
+
+Key public APIs:
+- [List main exported classes/functions]`,
         },
         {
             heading: 'File Structure & Code Organization',
@@ -59,6 +74,11 @@ exports.projectOverviewStructure = {
             exampleContent: '- `src/` — TypeScript source files and CLI entrypoints.\n- `tests/` — Automated tests and fixtures.',
             required: true,
             headingLevel: 2,
+            defaultContent: `- \`src/\` — Source code and main application logic
+- \`tests/\` or \`__tests__/\` — Test files and fixtures
+- \`dist/\` or \`build/\` — Compiled output (gitignored)
+- \`docs/\` — Documentation files
+- \`scripts/\` — Build and utility scripts`,
         },
         {
             heading: 'Technology Stack Summary',
@@ -67,6 +87,18 @@ exports.projectOverviewStructure = {
             guidance: 'Outline primary runtimes, languages, and platforms in use. Note build tooling, linting, and formatting infrastructure.',
             required: true,
             headingLevel: 2,
+            defaultContent: `**Runtime**: Node.js
+
+**Language**: TypeScript/JavaScript
+
+**Build Tools**:
+- TypeScript compiler (tsc) or bundler (esbuild, webpack, etc.)
+- Package manager: npm/yarn/pnpm
+
+**Code Quality**:
+- Linting: ESLint
+- Formatting: Prettier
+- Type checking: TypeScript strict mode`,
         },
         {
             heading: 'Core Framework Stack',
@@ -91,6 +123,13 @@ exports.projectOverviewStructure = {
             guidance: 'Highlight essential CLIs, scripts, or developer environments. Link to Tooling guide for deeper setup.',
             required: false,
             headingLevel: 2,
+            defaultContent: `See [Tooling](./tooling.md) for detailed development environment setup.
+
+**Essential Commands**:
+- \`npm install\` — Install dependencies
+- \`npm run build\` — Build the project
+- \`npm run test\` — Run tests
+- \`npm run dev\` — Start development mode`,
         },
         {
             heading: 'Getting Started Checklist',
@@ -100,6 +139,12 @@ exports.projectOverviewStructure = {
             exampleContent: '1. Install dependencies with `npm install`.\n2. Explore the CLI by running `npm run dev`.\n3. Review Development Workflow for day-to-day tasks.',
             required: true,
             headingLevel: 2,
+            defaultContent: `1. Clone the repository
+2. Install dependencies: \`npm install\`
+3. Copy environment template: \`cp .env.example .env\` (if applicable)
+4. Run tests to verify setup: \`npm run test\`
+5. Start development: \`npm run dev\`
+6. Review [Development Workflow](./development-workflow.md) for day-to-day tasks`,
         },
         {
             heading: 'Next Steps',
@@ -108,6 +153,9 @@ exports.projectOverviewStructure = {
             guidance: 'Capture product positioning, key stakeholders, and links to external documentation or product specs.',
             required: false,
             headingLevel: 2,
+            defaultContent: `- Review [Architecture](./architecture.md) for system design details
+- See [Development Workflow](./development-workflow.md) for contribution guidelines
+- Check [Testing Strategy](./testing-strategy.md) for quality requirements`,
         },
     ],
     linkTo: ['architecture.md', 'development-workflow.md', 'tooling.md', 'codebase-map.json'],