@ai-coders/context 0.3.1 → 0.4.0

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

@@ -1,39 +1,37 @@
 "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 -->
+    const coreComponentsSection = directorySnapshot || '- *Add notes for each core component or module.*';
+    return `<!-- agent-update:start: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')}
+## System Architecture Overview
+- Summarize the top-level topology (monolith, modular service, microservices) and deployment model.
+- Highlight how requests traverse the system and where control pivots between layers.
+
+## Core System Components
+${coreComponentsSection}
+
+## Internal System Boundaries
+- Document seams between domains, bounded contexts, or service ownership.
+- Note data ownership, synchronization strategies, and shared contract enforcement.
+
+## System Integration Points
+- Map inbound interfaces (APIs, events, webhooks) and the modules that own them.
+- Capture orchestration touchpoints where this system calls or coordinates other internal services.
+
+## External Service Dependencies
+- List SaaS platforms, third-party APIs, or infrastructure services the system relies on.
+- Describe authentication methods, rate limits, and failure considerations for each dependency.
+
+## Key Decisions & Trade-offs
+- Summarize architectural decisions, experiments, or ADR outcomes that shape the current design.
+- Reference supporting documents and explain why selected approaches won over alternatives.
 
 ## Diagrams
 - Link architectural diagrams or add mermaid definitions here.
@@ -44,6 +42,7 @@ ${defaultSections.map(item => `- ${item}`).join('\n')}
 ## Top Directories Snapshot
 ${directorySnapshot}
 
+<!-- agent-readonly:guidance -->
 ## 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.
@@ -51,6 +50,7 @@ ${directorySnapshot}
 4. Update Risks & Constraints with active incident learnings or TODO debt.
 5. Link any new diagrams or dashboards referenced in recent work.
 
+<!-- agent-readonly:sources -->
 ## Acceptable Sources
 - ADR folders, \`/docs/architecture\` notes, or RFC threads.
 - Dependency visualisations from build tooling or scripts.
@@ -60,7 +60,7 @@ ${directorySnapshot}
 - [Project Overview](./project-overview.md)
 - Update [agents/README.md](../agents/README.md) when architecture changes.
 
-<!-- /ai-task -->
+<!-- agent-update:end -->
 `;
 }
 //# sourceMappingURL=architectureTemplate.js.map

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

@@ -1 +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"}
+{"version":3,"file":"architectureTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/architectureTemplate.ts"],"names":[],"mappings":";;AAGA,0DA6DC;AA/DD,qCAAgD;AAEhD,SAAgB,uBAAuB,CAAC,OAAqC;IAC3E,MAAM,iBAAiB,GAAG,IAAA,6BAAoB,EAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACvE,MAAM,qBAAqB,GAAG,iBAAiB,IAAI,kDAAkD,CAAC;IAEtG,OAAO;;;;;;;;;;EAUP,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;EAyBrB,iBAAiB;;;;;;;;;;;;;;;;;;;;;CAqBlB,CAAC;AACF,CAAC"}

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

@@ -27,13 +27,13 @@ function formatDirectoryList(context, includePlaceholders) {
             return `- \`${dir}/\``;
         }
         const slotId = slugify(dir);
-        return `- <!-- ai-slot:directory-${slotId} -->\`${dir}/\` — TODO: Describe the purpose of this directory.<!-- /ai-slot -->`;
+        return `- <!-- agent-fill:directory-${slotId} -->\`${dir}/\` — TODO: Describe the purpose of this directory.<!-- /agent-fill -->`;
     })
         .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');
+    return ['| Guide | File | AI Marker | Primary Inputs |', '| --- | --- | --- | --- |', ...rows].join('\n');
 }
 function formatDirectoryStats(stats) {
     if (!stats.length) {

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

@@ -1 +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"}
+{"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,+BAA+B,MAAM,SAAS,GAAG,yEAAyE,CAAC;IACpI,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,+CAA+C,EAAE,2BAA2B,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5G,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.map

@@ -1 +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"}
+{"version":3,"file":"dataFlowTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/dataFlowTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAGvD,wBAAgB,cAAc,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAkC5E"}

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

@@ -1,26 +1,9 @@
 "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 -->
+    return `<!-- agent-update:start:data-flow -->
 # Data Flow & Integrations
 
 Explain how data enters, moves through, and exits the system, including interactions with external services.
@@ -32,24 +15,26 @@ Explain how data enters, moves through, and exits the system, including interact
 - 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 -->
+- <!-- agent-fill:integration -->**Integration** — Purpose, authentication, payload shapes, retry strategy.<!-- /agent-fill -->
 
 ## Observability & Failure Modes
 - Metrics, traces, or logs that monitor the flow.
 - Backoff, dead-letter, or compensating actions when downstream systems fail.
 
+<!-- agent-readonly:guidance -->
 ## 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.
 
+<!-- agent-readonly:sources -->
 ## Acceptable Sources
 - Architecture diagrams, ADRs, integration playbooks.
 - API specs, queue/topic definitions, infrastructure code.
 - Postmortems or incident reviews impacting data movement.
 
-<!-- /ai-task -->
+<!-- agent-update:end -->
 `;
 }
 //# sourceMappingURL=dataFlowTemplate.js.map

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":";;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"}
+{"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"}

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":"AAEA,wBAAgB,yBAAyB,IAAI,MAAM,CAsDlD"}
+{"version":3,"file":"developmentWorkflowTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/developmentWorkflowTemplate.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,IAAI,MAAM,CAuClD"}

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

@@ -1,25 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderDevelopmentWorkflow = renderDevelopmentWorkflow;
-const frontMatter_1 = require("./frontMatter");
 function renderDevelopmentWorkflow() {
-    const frontMatter = (0, frontMatter_1.createFrontMatter)({
-        id: 'development-workflow',
-        goal: 'Document how the team builds, reviews, and ships code every day.',
-        requiredInputs: [
-            'Branching and release policies',
-            'Package scripts and CI workflows',
-            'Code review expectations agreed upon by the team'
-        ],
-        successCriteria: [
-            'Branching guidance mirrors the default git strategy or CI configuration',
-            'Local development commands are copy/paste ready',
-            'Onboarding links point to living sources (boards, runbooks)'
-        ],
-        relatedAgents: ['documentation-writer', 'code-reviewer']
-    });
-    return `${frontMatter}
-<!-- ai-task:development-workflow -->
+    return `<!-- agent-update:start:development-workflow -->
 # Development Workflow
 
 Outline the day-to-day engineering process for this repository.
@@ -35,12 +18,13 @@ Outline the day-to-day engineering process for this repository.
 
 ## Code Review Expectations
 - Summarize review checklists and required approvals.
-- Reference [AGENTS.md](../AGENTS.md) for agent collaboration tips.
+- 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.
@@ -48,12 +32,13 @@ Outline the day-to-day engineering process for this repository.
 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.
 
-<!-- /ai-task -->
+<!-- agent-update:end -->
 `;
 }
 //# 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":";;AAEA,8DAsDC;AAxDD,+CAAkD;AAElD,SAAgB,yBAAyB;IACvC,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC;QACpC,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,kEAAkE;QACxE,cAAc,EAAE;YACd,gCAAgC;YAChC,kCAAkC;YAClC,kDAAkD;SACnD;QACD,eAAe,EAAE;YACf,yEAAyE;YACzE,iDAAiD;YACjD,6DAA6D;SAC9D;QACD,aAAa,EAAE,CAAC,sBAAsB,EAAE,eAAe,CAAC;KACzD,CAAC,CAAC;IAEH,OAAO,GAAG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCtB,CAAC;AACF,CAAC"}
+{"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"}

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":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,4BAA4B,GAAG,MAAM,CAkD7E"}
+{"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"}

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

@@ -1,55 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderGlossary = renderGlossary;
-const frontMatter_1 = require("./frontMatter");
 function renderGlossary(_context) {
-    const frontMatter = (0, frontMatter_1.createFrontMatter)({
-        id: 'glossary',
-        goal: 'Capture shared language, acronyms, domain entities, and user personas so newcomers and agents understand the problem space.',
-        requiredInputs: [
-            'Business or product briefs that define the problem domain',
-            'Onboarding notes or internal wiki entries with terminology',
-            'Examples from issues/PRs where domain language appears'
-        ],
-        successCriteria: [
-            'Each term includes a concise definition plus why it matters to the codebase',
-            'Acronyms are expanded on first mention and linked to their origin',
-            'Personas or actors include their goals and interactions with the system'
-        ],
-        relatedAgents: ['documentation-writer', 'feature-developer']
-    });
-    return `${frontMatter}
-<!-- ai-task:glossary -->
+    return `
+<!-- agent-update:start:glossary -->
 # Glossary & Domain Concepts
 
 List project-specific terminology, acronyms, domain entities, and user personas.
 
 ## Core Terms
-- <!-- ai-slot:term-one -->**Term** — Definition, relevance, and where it surfaces in the codebase.<!-- /ai-slot -->
-- <!-- ai-slot:term-two -->**Term** — Definition, domain context, related modules.<!-- /ai-slot -->
+- <!-- 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 -->
 
 ## Acronyms & Abbreviations
-- <!-- ai-slot:acronym -->**ABC** — Expanded form; why we use it; associated services or APIs.<!-- /ai-slot -->
+- <!-- agent-fill:acronym -->**ABC** — Expanded form; why we use it; associated services or APIs.<!-- /agent-fill -->
 
 ## Personas / Actors
-- <!-- ai-slot:persona -->**Persona Name** — Goals, key workflows, pain points addressed by the system.<!-- /ai-slot -->
+- <!-- agent-fill:persona -->**Persona Name** — Goals, key workflows, pain points addressed by the system.<!-- /agent-fill -->
 
 ## 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).
 
-<!-- /ai-task -->
+<!-- agent-update:end -->
 `;
 }
 //# 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":";;AAGA,wCAkDC;AArDD,+CAAkD;AAGlD,SAAgB,cAAc,CAAC,QAAsC;IACnE,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC;QACpC,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,6HAA6H;QACnI,cAAc,EAAE;YACd,2DAA2D;YAC3D,4DAA4D;YAC5D,wDAAwD;SACzD;QACD,eAAe,EAAE;YACf,6EAA6E;YAC7E,mEAAmE;YACnE,yEAAyE;SAC1E;QACD,aAAa,EAAE,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;KAC7D,CAAC,CAAC;IAEH,OAAO,GAAG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCtB,CAAC;AACF,CAAC"}
+{"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"}

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

@@ -7,5 +7,9 @@ export { renderGlossary } from './glossaryTemplate';
 export { renderDataFlow } from './dataFlowTemplate';
 export { renderSecurity } from './securityTemplate';
 export { renderToolingGuide } from './toolingTemplate';
+export { renderApiReference } from './apiReferenceTemplate';
+export { renderTroubleshooting } from './troubleshootingTemplate';
+export { renderMigration } from './migrationTemplate';
+export { renderOnboarding } from './onboardingTemplate';
 export type { DocumentationTemplateContext, GuideMeta, DirectoryStat } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,4BAA4B,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,4BAA4B,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderToolingGuide = exports.renderSecurity = exports.renderDataFlow = exports.renderGlossary = exports.renderTestingStrategy = exports.renderDevelopmentWorkflow = exports.renderArchitectureNotes = exports.renderProjectOverview = exports.renderIndex = void 0;
+exports.renderOnboarding = exports.renderMigration = exports.renderTroubleshooting = exports.renderApiReference = exports.renderToolingGuide = exports.renderSecurity = exports.renderDataFlow = exports.renderGlossary = exports.renderTestingStrategy = exports.renderDevelopmentWorkflow = exports.renderArchitectureNotes = exports.renderProjectOverview = exports.renderIndex = void 0;
 var indexTemplate_1 = require("./indexTemplate");
 Object.defineProperty(exports, "renderIndex", { enumerable: true, get: function () { return indexTemplate_1.renderIndex; } });
 var projectOverviewTemplate_1 = require("./projectOverviewTemplate");
@@ -19,4 +19,12 @@ var securityTemplate_1 = require("./securityTemplate");
 Object.defineProperty(exports, "renderSecurity", { enumerable: true, get: function () { return securityTemplate_1.renderSecurity; } });
 var toolingTemplate_1 = require("./toolingTemplate");
 Object.defineProperty(exports, "renderToolingGuide", { enumerable: true, get: function () { return toolingTemplate_1.renderToolingGuide; } });
+var apiReferenceTemplate_1 = require("./apiReferenceTemplate");
+Object.defineProperty(exports, "renderApiReference", { enumerable: true, get: function () { return apiReferenceTemplate_1.renderApiReference; } });
+var troubleshootingTemplate_1 = require("./troubleshootingTemplate");
+Object.defineProperty(exports, "renderTroubleshooting", { enumerable: true, get: function () { return troubleshootingTemplate_1.renderTroubleshooting; } });
+var migrationTemplate_1 = require("./migrationTemplate");
+Object.defineProperty(exports, "renderMigration", { enumerable: true, get: function () { return migrationTemplate_1.renderMigration; } });
+var onboardingTemplate_1 = require("./onboardingTemplate");
+Object.defineProperty(exports, "renderOnboarding", { enumerable: true, get: function () { return onboardingTemplate_1.renderOnboarding; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/index.ts"],"names":[],"mappings":";;;AAAA,iDAA8C;AAArC,4GAAA,WAAW,OAAA;AACpB,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAC9B,+DAAiE;AAAxD,+HAAA,uBAAuB,OAAA;AAChC,6EAA0E;AAAjE,wIAAA,yBAAyB,OAAA;AAClC,qDAA0D;AAAjD,wHAAA,qBAAqB,OAAA;AAC9B,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,qDAAuD;AAA9C,qHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/index.ts"],"names":[],"mappings":";;;AAAA,iDAA8C;AAArC,4GAAA,WAAW,OAAA;AACpB,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAC9B,+DAAiE;AAAxD,+HAAA,uBAAuB,OAAA;AAChC,6EAA0E;AAAjE,wIAAA,yBAAyB,OAAA;AAClC,qDAA0D;AAAjD,wHAAA,qBAAqB,OAAA;AAC9B,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,qDAAuD;AAA9C,qHAAA,kBAAkB,OAAA;AAC3B,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAC9B,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AACxB,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA"}

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":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,WAAW,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAmDzE"}
+{"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"}

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

@@ -1,31 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderIndex = renderIndex;
-const frontMatter_1 = require("./frontMatter");
 const common_1 = require("./common");
 function renderIndex(context) {
-    const frontMatter = (0, frontMatter_1.createFrontMatter)({
-        id: 'docs-index',
-        goal: 'Keep the documentation map accurate so contributors and agents land on the right guide quickly.',
-        requiredInputs: [
-            'Current docs and agents directory listings',
-            'Recent additions or removals across documentation assets',
-            'Latest roadmap or release summary (if available)'
-        ],
-        successCriteria: [
-            'Each linked guide exists and reflects its stated purpose',
-            'Repository snapshot matches the real top-level structure',
-            'Update checklist is confirmed before closing the task'
-        ],
-        relatedAgents: ['documentation-writer', 'architect-specialist']
-    });
     const directoryList = (0, common_1.formatDirectoryList)(context, false);
     const documentMap = (0, common_1.buildDocumentMapTable)(context.guides);
     const navigationList = context.guides
         .map(guide => `- [${guide.title}](./${guide.file})`)
         .join('\n') || '- *No guides selected.*';
-    return `${frontMatter}
-<!-- ai-task:docs-index -->
+    return `
+<!-- agent-update:start:docs-index -->
 # Documentation Index
 
 Welcome to the repository knowledge base. Start with the project overview, then dive into specific guides as needed.
@@ -39,18 +23,20 @@ ${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.
 
-<!-- /ai-task -->
+<!-- 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":";;AAIA,kCAmDC;AAvDD,+CAAkD;AAClD,qCAAsE;AAGtE,SAAgB,WAAW,CAAC,OAAqC;IAC/D,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC;QACpC,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,iGAAiG;QACvG,cAAc,EAAE;YACd,4CAA4C;YAC5C,0DAA0D;YAC1D,kDAAkD;SACnD;QACD,eAAe,EAAE;YACf,0DAA0D;YAC1D,0DAA0D;YAC1D,uDAAuD;SACxD;QACD,aAAa,EAAE,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;KAChE,CAAC,CAAC;IAEH,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,GAAG,WAAW;;;;;;;EAOrB,cAAc;;;EAGd,aAAa,IAAI,mFAAmF;;;EAGpG,WAAW;;;;;;;;;;;;;;CAcZ,CAAC;AACF,CAAC"}
+{"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"}

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

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

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

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