@ai-coders/context 0.4.0 → 0.5.1

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

@@ -1 +1 @@
-{"version":3,"file":"dataFlowTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/dataFlowTemplate.ts"],"names":[],"mappings":";;AAGA,wCAkCC;AApCD,qCAAqD;AAErD,SAAgB,cAAc,CAAC,OAAqC;IAClE,OAAO;;;;;;;;;gCASuB,IAAA,kCAAyB,EAAC,OAAO,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBrF,CAAC;AACF,CAAC"}
+{"version":3,"file":"dataFlowTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/dataFlowTemplate.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderDevelopmentWorkflow = renderDevelopmentWorkflow;
+const common_1 = require("./common");
 function renderDevelopmentWorkflow() {
-    return `<!-- agent-update:start:development-workflow -->
-# Development Workflow
+    const content = `# Development Workflow
 
 Outline the day-to-day engineering process for this repository.
 
@@ -21,24 +21,9 @@ Outline the day-to-day engineering process for this repository.
 - Reference [AGENTS.md](../../AGENTS.md) for agent collaboration tips.
 
 ## Onboarding Tasks
-- Point newcomers to first issues or starter tickets.
-- Link to internal runbooks or dashboards.
 
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Confirm branching/release steps with CI configuration and recent tags.
-2. Verify local commands against \`package.json\`; ensure flags and scripts still exist.
-3. Capture review requirements (approvers, checks) from contributing docs or repository settings.
-4. Refresh onboarding links (boards, dashboards) to their latest URLs.
-5. Highlight any manual steps that should become automation follow-ups.
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- CONTRIBUTING guidelines and \`AGENTS.md\`.
-- Build pipelines, branch protection rules, or release scripts.
-- Issue tracker boards used for onboarding or triage.
-
-<!-- agent-update:end -->
+Point newcomers to first issues or starter tickets. Link to internal runbooks or dashboards.
 `;
+    return (0, common_1.wrapWithFrontMatter)(content);
 }
 //# sourceMappingURL=developmentWorkflowTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"developmentWorkflowTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/developmentWorkflowTemplate.ts"],"names":[],"mappings":";;AAAA,8DAuCC;AAvCD,SAAgB,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCR,CAAC;AACF,CAAC"}
+{"version":3,"file":"developmentWorkflowTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/developmentWorkflowTemplate.ts"],"names":[],"mappings":";;AAEA,8DAwBC;AA1BD,qCAA+C;AAE/C,SAAgB,yBAAyB;IACvC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;CAoBjB,CAAC;IAEA,OAAO,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"glossaryTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/glossaryTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,4BAA4B,GAAG,MAAM,CAqC7E"}
+{"version":3,"file":"glossaryTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/glossaryTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAgDvD,wBAAgB,cAAc,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAgC5E"}

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

@@ -1,41 +1,73 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderGlossary = renderGlossary;
-function renderGlossary(_context) {
-    return `
-<!-- agent-update:start:glossary -->
-# Glossary & Domain Concepts
+const common_1 = require("./common");
+function renderTypeDefinitions(context) {
+    const { semantics, repoStructure } = context;
+    if (!semantics) {
+        return '- *No exported type definitions found.*';
+    }
+    const repoRoot = repoStructure.rootPath;
+    // Combine types and interfaces, sort by name
+    const typeSymbols = [
+        ...semantics.symbols.types,
+        ...semantics.symbols.interfaces,
+    ]
+        .filter(s => s.exported)
+        .sort((a, b) => a.name.localeCompare(b.name));
+    if (typeSymbols.length === 0) {
+        return '- *No exported type definitions found.*';
+    }
+    return typeSymbols.map(sym => {
+        const ref = (0, common_1.formatSymbolRef)(sym, repoRoot);
+        const doc = sym.documentation ? ` — ${sym.documentation}` : '';
+        return `- **${sym.name}** (${sym.kind}) — ${ref}${doc}`;
+    }).join('\n');
+}
+function renderEnumDefinitions(context) {
+    const { semantics, repoStructure } = context;
+    if (!semantics || semantics.symbols.enums.length === 0) {
+        return '- *No enums detected.*';
+    }
+    const repoRoot = repoStructure.rootPath;
+    return semantics.symbols.enums
+        .filter(s => s.exported)
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map(sym => {
+        const ref = (0, common_1.formatSymbolRef)(sym, repoRoot);
+        const doc = sym.documentation ? ` — ${sym.documentation}` : '';
+        return `- **${sym.name}** — ${ref}${doc}`;
+    }).join('\n') || '- *No exported enums found.*';
+}
+function renderGlossary(context) {
+    const typeDefinitions = renderTypeDefinitions(context);
+    const enumDefinitions = renderEnumDefinitions(context);
+    const content = `# Glossary & Domain Concepts
 
 List project-specific terminology, acronyms, domain entities, and user personas.
 
+## Type Definitions
+${typeDefinitions}
+
+## Enumerations
+${enumDefinitions}
+
 ## Core Terms
-- <!-- agent-fill:term-one -->**Term** — Definition, relevance, and where it surfaces in the codebase.<!-- /agent-fill -->
-- <!-- agent-fill:term-two -->**Term** — Definition, domain context, related modules.<!-- /agent-fill -->
+
+Define key terms, their relevance, and where they surface in the codebase.
 
 ## Acronyms & Abbreviations
-- <!-- agent-fill:acronym -->**ABC** — Expanded form; why we use it; associated services or APIs.<!-- /agent-fill -->
+
+Expand abbreviations and note associated services or APIs.
 
 ## Personas / Actors
-- <!-- agent-fill:persona -->**Persona Name** — Goals, key workflows, pain points addressed by the system.<!-- /agent-fill -->
+
+Describe user goals, key workflows, and pain points addressed by the system.
 
 ## Domain Rules & Invariants
-- Capture business rules, validation constraints, or compliance requirements that the code enforces.
-- Note any region, localization, or regulatory nuances.
-
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Harvest terminology from recent PRs, issues, and discussions.
-2. Confirm definitions with product or domain experts when uncertain.
-3. Link terms to relevant docs or modules for deeper context.
-4. Remove or archive outdated concepts; flag unknown terms for follow-up.
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- Product requirement docs, RFCs, user research, or support tickets.
-- Service contracts, API schemas, data dictionaries.
-- Conversations with domain experts (summarize outcomes if applicable).
-
-<!-- agent-update:end -->
+
+Capture business rules, validation constraints, or compliance requirements. Note any region, localization, or regulatory nuances.
 `;
+    return (0, common_1.wrapWithFrontMatter)(content);
 }
 //# sourceMappingURL=glossaryTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"glossaryTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/glossaryTemplate.ts"],"names":[],"mappings":";;AAEA,wCAqCC;AArCD,SAAgB,cAAc,CAAC,QAAsC;IAEnE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCR,CAAC;AACF,CAAC"}
+{"version":3,"file":"glossaryTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/glossaryTemplate.ts"],"names":[],"mappings":";;AAiDA,wCAgCC;AA/ED,qCAAgE;AAEhE,SAAS,qBAAqB,CAAC,OAAqC;IAClE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,yCAAyC,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;IAExC,6CAA6C;IAC7C,MAAM,WAAW,GAAG;QAClB,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK;QAC1B,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU;KAChC;SACE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACvB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,yCAAyC,CAAC;IACnD,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC3B,MAAM,GAAG,GAAG,IAAA,wBAAe,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG,GAAG,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAqC;IAClE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAC7C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;IAExC,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACvB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC5C,GAAG,CAAC,GAAG,CAAC,EAAE;QACT,MAAM,GAAG,GAAG,IAAA,wBAAe,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,OAAO,GAAG,CAAC,IAAI,QAAQ,GAAG,GAAG,GAAG,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,8BAA8B,CAAC;AACpD,CAAC;AAED,SAAgB,cAAc,CAAC,OAAqC;IAClE,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG;;;;;EAKhB,eAAe;;;EAGf,eAAe;;;;;;;;;;;;;;;;;CAiBhB,CAAC;IAEA,OAAO,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/indexTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,WAAW,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAsCzE"}
+{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/indexTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,WAAW,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAqBzE"}

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

@@ -8,9 +8,7 @@ function renderIndex(context) {
     const navigationList = context.guides
         .map(guide => `- [${guide.title}](./${guide.file})`)
         .join('\n') || '- *No guides selected.*';
-    return `
-<!-- agent-update:start:docs-index -->
-# Documentation Index
+    return `# Documentation Index
 
 Welcome to the repository knowledge base. Start with the project overview, then dive into specific guides as needed.
 
@@ -22,21 +20,6 @@ ${directoryList || '*Top-level directories will appear here once the repository
 
 ## Document Map
 ${documentMap}
-
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Gather context with \`git status -sb\` plus the latest commits touching \`docs/\` or \`agents/\`.
-2. Compare the current directory tree against the table above; add or retire rows accordingly.
-3. Update cross-links if guides moved or were renamed; keep anchor text concise.
-4. Record sources consulted inside the commit or PR description for traceability.
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- Repository tree and \`package.json\` scripts for canonical command names.
-- Maintainer-approved issues, RFCs, or product briefs referenced in the repo.
-- Release notes or changelog entries that announce documentation changes.
-
-<!-- agent-update:end -->
 `;
 }
 //# sourceMappingURL=indexTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/indexTemplate.ts"],"names":[],"mappings":";;AAGA,kCAsCC;AAzCD,qCAAsE;AAGtE,SAAgB,WAAW,CAAC,OAAqC;IAE/D,MAAM,aAAa,GAAG,IAAA,4BAAmB,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM;SAClC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC;SACnD,IAAI,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC;IAE3C,OAAO;;;;;;;EAOP,cAAc;;;EAGd,aAAa,IAAI,mFAAmF;;;EAGpG,WAAW;;;;;;;;;;;;;;;;CAgBZ,CAAC;AACF,CAAC"}
+{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/indexTemplate.ts"],"names":[],"mappings":";;AAGA,kCAqBC;AAxBD,qCAAsE;AAGtE,SAAgB,WAAW,CAAC,OAAqC;IAE/D,MAAM,aAAa,GAAG,IAAA,4BAAmB,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM;SAClC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC;SACnD,IAAI,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC;IAE3C,OAAO;;;;;EAKP,cAAc;;;EAGd,aAAa,IAAI,mFAAmF;;;EAGpG,WAAW;CACZ,CAAC;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"migrationTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/migrationTemplate.ts"],"names":[],"mappings":"AACA,wBAAgB,eAAe,IAAI,MAAM,CAkaxC"}
+{"version":3,"file":"migrationTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/migrationTemplate.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,MAAM,CA6YxC"}

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

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderMigration = renderMigration;
+const common_1 = require("./common");
 function renderMigration() {
-    return `
-<!-- agent-update:start:migration-guide -->
-# Migration Guide
+    const content = `# Migration Guide
 
 Complete guide for upgrading between versions, handling breaking changes, and migrating data.
 
@@ -397,26 +396,7 @@ When reporting migration problems, include:
 3. Migration log output
 4. Database type and version
 5. Steps to reproduce
-
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Update version numbers and release dates when new versions are published
-2. Document new breaking changes with clear before/after examples
-3. Add migration paths for each new major version
-4. Update deprecation timeline as features are removed
-5. Include actual migration scripts and examples from the codebase
-6. Verify rollback procedures are tested and accurate
-7. Update system requirements for new versions
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- CHANGELOG.md and release notes
-- Migration scripts in migrations/ or db/migrate/ directory
-- Upgrade guides from official documentation
-- Post-mortem reports from previous migrations
-- Breaking changes documented in commit messages or PRs
-
-<!-- agent-update:end -->
 `;
+    return (0, common_1.wrapWithFrontMatter)(content);
 }
 //# sourceMappingURL=migrationTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"migrationTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/migrationTemplate.ts"],"names":[],"mappings":";;AACA,0CAkaC;AAlaD,SAAgB,eAAe;IAE7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+ZR,CAAC;AACF,CAAC"}
+{"version":3,"file":"migrationTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/migrationTemplate.ts"],"names":[],"mappings":";;AAEA,0CA6YC;AA/YD,qCAA+C;AAE/C,SAAgB,eAAe;IAC7B,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyYjB,CAAC;IAEA,OAAO,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"onboardingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/onboardingTemplate.ts"],"names":[],"mappings":"AACA,wBAAgB,gBAAgB,IAAI,MAAM,CA2azC"}
+{"version":3,"file":"onboardingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/onboardingTemplate.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,IAAI,MAAM,CAsZzC"}

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

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderOnboarding = renderOnboarding;
+const common_1 = require("./common");
 function renderOnboarding() {
-    return `
-<!-- agent-update:start:onboarding-guide -->
-# Onboarding Guide
+    const content = `# Onboarding Guide
 
 Welcome to the team! This guide will help you get set up and productive quickly.
 
@@ -406,26 +405,7 @@ We're always improving! Please provide feedback on:
 - Update this guide as you find gaps
 - Ask in #engineering if something is unclear
 - Your feedback helps future team members!
-
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Verify all tool versions and installation instructions are current
-2. Update access request contacts with current team members
-3. Ensure all documentation links are valid
-4. Add new accounts or tools that team members need
-5. Update team communication channels and meeting schedules
-6. Refresh learning resources with current recommendations
-7. Verify suggested first issues are still appropriate
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- Development environment setup scripts and documentation
-- Team wiki or handbook
-- IT/DevOps onboarding documentation
-- Feedback from recent new hires
-- Repository README and CONTRIBUTING files
-
-<!-- agent-update:end -->
 `;
+    return (0, common_1.wrapWithFrontMatter)(content);
 }
 //# sourceMappingURL=onboardingTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"onboardingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/onboardingTemplate.ts"],"names":[],"mappings":";;AACA,4CA2aC;AA3aD,SAAgB,gBAAgB;IAE9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwaR,CAAC;AACF,CAAC"}
+{"version":3,"file":"onboardingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/onboardingTemplate.ts"],"names":[],"mappings":";;AAEA,4CAsZC;AAxZD,qCAA+C;AAE/C,SAAgB,gBAAgB;IAC9B,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkZjB,CAAC;IAEA,OAAO,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"projectOverviewTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/projectOverviewTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CA6DnF"}
+{"version":3,"file":"projectOverviewTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/projectOverviewTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAmDvD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAyDnF"}

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

@@ -1,65 +1,131 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderProjectOverview = renderProjectOverview;
+const path = __importStar(require("path"));
 const common_1 = require("./common");
+function renderEntryPointsSection(context) {
+    const { semantics, repoStructure } = context;
+    if (!semantics || !semantics.architecture.entryPoints.length) {
+        return '- *No entry points detected.*';
+    }
+    const repoRoot = repoStructure.rootPath;
+    return semantics.architecture.entryPoints.map(ep => {
+        const relPath = path.relative(repoRoot, ep);
+        return `- [\`${relPath}\`](${relPath})`;
+    }).join('\n');
+}
+function renderKeyExportsSection(context) {
+    const { semantics, repoStructure } = context;
+    if (!semantics) {
+        return '- *No key exports detected.*';
+    }
+    const repoRoot = repoStructure.rootPath;
+    // Get exported classes and interfaces
+    const classes = semantics.symbols.classes
+        .filter(s => s.exported);
+    const interfaces = semantics.symbols.interfaces
+        .filter(s => s.exported);
+    const lines = [];
+    if (classes.length > 0) {
+        lines.push('**Classes:**');
+        lines.push((0, common_1.buildSymbolList)(classes, repoRoot, false));
+    }
+    if (interfaces.length > 0) {
+        if (lines.length > 0)
+            lines.push('');
+        lines.push('**Interfaces:**');
+        lines.push((0, common_1.buildSymbolList)(interfaces, repoRoot, false));
+    }
+    if (lines.length === 0) {
+        return '- *No major exports detected.*';
+    }
+    return lines.join('\n');
+}
 function renderProjectOverview(context) {
     const directoryList = (0, common_1.formatDirectoryList)(context, true);
     const languageSummary = context.primaryLanguages.length > 0
         ? context.primaryLanguages.map(lang => `- ${lang.extension} (${lang.count} files)`).join('\n')
         : '- Language mix pending analysis.';
-    return `
-<!-- agent-update:start:project-overview -->
-# Project Overview
+    const entryPointsSection = renderEntryPointsSection(context);
+    const keyExportsSection = renderKeyExportsSection(context);
+    const content = `# Project Overview
 
-> TODO: Summarize the problem this project solves and who benefits from it.
+Summarize the problem this project solves and who benefits from it.
 
 ## Quick Facts
+
 - Root path: \`${context.repoStructure.rootPath}\`
 - Primary languages detected:
 ${languageSummary}
 
+## Entry Points
+${entryPointsSection}
+
+## Key Exports
+${keyExportsSection}
+
 ## File Structure & Code Organization
 ${directoryList || '*Add a short description for each relevant directory.*'}
 
 ## Technology Stack Summary
-- Outline primary runtimes, languages, and platforms in use.
-- Note build tooling, linting, and formatting infrastructure the team relies on.
+
+Outline primary runtimes, languages, and platforms in use. Note build tooling, linting, and formatting infrastructure the team relies on.
 
 ## Core Framework Stack
-- Document core frameworks per layer (backend, frontend, data, messaging).
-- Mention architectural patterns enforced by these frameworks.
+
+Document core frameworks per layer (backend, frontend, data, messaging). Mention architectural patterns enforced by these frameworks.
 
 ## UI & Interaction Libraries
-- List UI kits, CLI interaction helpers, or design system dependencies.
-- Note theming, accessibility, or localization considerations contributors must follow.
+
+List UI kits, CLI interaction helpers, or design system dependencies. Note theming, accessibility, or localization considerations contributors must follow.
 
 ## Development Tools Overview
-- Highlight essential CLIs, scripts, or developer environments.
-- Link to [Tooling & Productivity Guide](./tooling.md) for deeper setup instructions.
+
+Highlight essential CLIs, scripts, or developer environments. Link to [Tooling & Productivity Guide](./tooling.md) for deeper setup instructions.
 
 ## Getting Started Checklist
+
 1. Install dependencies with \`npm install\`.
 2. Explore the CLI by running \`npm run dev\`.
 3. Review [Development Workflow](./development-workflow.md) for day-to-day tasks.
 
 ## Next Steps
-Capture product positioning, key stakeholders, and links to external documentation or product specs here.
 
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Review roadmap items or issues labelled “release” to confirm current goals.
-2. Cross-check Quick Facts against \`package.json\` and environment docs.
-3. Refresh the File Structure & Code Organization section to reflect new or retired modules; keep guidance actionable.
-4. Link critical dashboards, specs, or runbooks used by the team.
-5. Flag any details that require human confirmation (e.g., stakeholder ownership).
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- Recent commits, release notes, or ADRs describing high-level changes.
-- Product requirement documents linked from this repository.
-- Confirmed statements from maintainers or product leads.
-
-<!-- agent-update:end -->
+Capture product positioning, key stakeholders, and links to external documentation or product specs here.
 `;
+    return (0, common_1.wrapWithFrontMatter)(content);
 }
 //# sourceMappingURL=projectOverviewTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"projectOverviewTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/projectOverviewTemplate.ts"],"names":[],"mappings":";;AAGA,sDA6DC;AA/DD,qCAA+C;AAE/C,SAAgB,qBAAqB,CAAC,OAAqC;IAEzE,MAAM,aAAa,GAAG,IAAA,4BAAmB,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9F,CAAC,CAAC,kCAAkC,CAAC;IAEvC,OAAO;;;;;;;iBAOQ,OAAO,CAAC,aAAa,CAAC,QAAQ;;EAE7C,eAAe;;;EAGf,aAAa,IAAI,wDAAwD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC1E,CAAC;AACF,CAAC"}
+{"version":3,"file":"projectOverviewTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/projectOverviewTemplate.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"securityTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/securityTemplate.ts"],"names":[],"mappings":"AACA,wBAAgB,cAAc,IAAI,MAAM,CAmCvC"}
+{"version":3,"file":"securityTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/securityTemplate.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,IAAI,MAAM,CAuBvC"}

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

@@ -1,39 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderSecurity = renderSecurity;
+const common_1 = require("./common");
 function renderSecurity() {
-    return `
-<!-- agent-update:start:security -->
-# Security & Compliance Notes
+    const content = `# Security & Compliance Notes
 
 Capture the policies and guardrails that keep this project secure and compliant.
 
 ## Authentication & Authorization
-- Describe identity providers, token formats, session strategies, and role/permission models.
+
+Describe identity providers, token formats, session strategies, and role/permission models.
 
 ## Secrets & Sensitive Data
-- Storage locations (vaults, parameter stores), rotation cadence, encryption practices, and data classifications.
+
+Document storage locations (vaults, parameter stores), rotation cadence, encryption practices, and data classifications.
 
 ## Compliance & Policies
-- Applicable standards (GDPR, SOC2, HIPAA, internal policies) and evidence requirements.
+
+List applicable standards (GDPR, SOC2, HIPAA, internal policies) and evidence requirements.
 
 ## Incident Response
-- On-call contacts, escalation steps, and tooling for detection, triage, and post-incident analysis.
-
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Confirm security libraries and infrastructure match current deployments.
-2. Update secrets management details when storage or naming changes.
-3. Reflect new compliance obligations or audit findings.
-4. Ensure incident response procedures include current contacts and tooling.
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- Security architecture docs, runbooks, policy handbooks.
-- IAM/authorization configuration (code or infrastructure).
-- Compliance updates from security or legal teams.
-
-<!-- agent-update:end -->
+
+Note on-call contacts, escalation steps, and tooling for detection, triage, and post-incident analysis.
 `;
+    return (0, common_1.wrapWithFrontMatter)(content);
 }
 //# sourceMappingURL=securityTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"securityTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/securityTemplate.ts"],"names":[],"mappings":";;AACA,wCAmCC;AAnCD,SAAgB,cAAc;IAE5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCR,CAAC;AACF,CAAC"}
+{"version":3,"file":"securityTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/securityTemplate.ts"],"names":[],"mappings":";;AAEA,wCAuBC;AAzBD,qCAA+C;AAE/C,SAAgB,cAAc;IAC5B,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;CAmBjB,CAAC;IAEA,OAAO,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"testingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/testingTemplate.ts"],"names":[],"mappings":"AACA,wBAAgB,qBAAqB,IAAI,MAAM,CAyC9C"}
+{"version":3,"file":"testingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/testingTemplate.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,IAAI,MAAM,CAyB9C"}

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

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderTestingStrategy = renderTestingStrategy;
+const common_1 = require("./common");
 function renderTestingStrategy() {
-    return `
-<!-- agent-update:start:testing-strategy -->
-# Testing Strategy
+    const content = `# Testing Strategy
 
 Document how quality is maintained across the codebase.
 
@@ -23,23 +22,9 @@ Document how quality is maintained across the codebase.
 - Capture linting or formatting requirements before merging.
 
 ## Troubleshooting
-- Document flaky suites, long-running tests, or environment quirks.
 
-<!-- agent-readonly:guidance -->
-## AI Update Checklist
-1. Review test scripts and CI workflows to confirm command accuracy.
-2. Update Quality Gates with current thresholds (coverage %, lint rules, required checks).
-3. Document new test categories or suites introduced since the last update.
-4. Record known flaky areas and link to open issues for visibility.
-5. Confirm troubleshooting steps remain valid with current tooling.
-
-<!-- agent-readonly:sources -->
-## Acceptable Sources
-- \`package.json\` scripts and testing configuration files.
-- CI job definitions (GitHub Actions, CircleCI, etc.).
-- Issue tracker items labelled “testing” or “flaky” with maintainer confirmation.
-
-<!-- agent-update:end -->
+Document flaky suites, long-running tests, or environment quirks.
 `;
+    return (0, common_1.wrapWithFrontMatter)(content);
 }
 //# sourceMappingURL=testingTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"testingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/testingTemplate.ts"],"names":[],"mappings":";;AACA,sDAyCC;AAzCD,SAAgB,qBAAqB;IAEnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCR,CAAC;AACF,CAAC"}
+{"version":3,"file":"testingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/testingTemplate.ts"],"names":[],"mappings":";;AAEA,sDAyBC;AA3BD,qCAA+C;AAE/C,SAAgB,qBAAqB;IACnC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBjB,CAAC;IAEA,OAAO,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"toolingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/toolingTemplate.ts"],"names":[],"mappings":"AACA,wBAAgB,kBAAkB,IAAI,MAAM,CAsC3C"}
+{"version":3,"file":"toolingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/toolingTemplate.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,IAAI,MAAM,CAuB3C"}