@ai-coders/context 0.3.1 → 0.5.0

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

@@ -1,26 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderTestingStrategy = renderTestingStrategy;
-const frontMatter_1 = require("./frontMatter");
 function renderTestingStrategy() {
-    const frontMatter = (0, frontMatter_1.createFrontMatter)({
-        id: 'testing-strategy',
-        goal: 'Explain how the project maintains quality, from unit coverage to release gates.',
-        requiredInputs: [
-            'Testing framework configuration (jest.config.js, etc.)',
-            'CI requirements for merges/releases',
-            'Known flaky suites or troubleshooting notes'
-        ],
-        successCriteria: [
-            'Test types list frameworks and ownership at a glance',
-            'Commands match package scripts and CI usage',
-            'Quality gates describe pass/fail expectations with numbers when possible'
-        ],
-        relatedAgents: ['test-writer', 'code-reviewer']
-    });
-    return `${frontMatter}
-<!-- ai-task:testing-strategy -->
-# Testing Strategy
+    return `# Testing Strategy
 
 Document how quality is maintained across the codebase.
 
@@ -40,20 +22,6 @@ Document how quality is maintained across the codebase.
 
 ## Troubleshooting
 - Document flaky suites, long-running tests, or environment quirks.
-
-## 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.
-
-## 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.
-
-<!-- /ai-task -->
 `;
 }
 //# 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":";;AAEA,sDAsDC;AAxDD,+CAAkD;AAElD,SAAgB,qBAAqB;IACnC,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC;QACpC,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,iFAAiF;QACvF,cAAc,EAAE;YACd,wDAAwD;YACxD,qCAAqC;YACrC,6CAA6C;SAC9C;QACD,eAAe,EAAE;YACf,sDAAsD;YACtD,6CAA6C;YAC7C,0EAA0E;SAC3E;QACD,aAAa,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;KAChD,CAAC,CAAC;IAEH,OAAO,GAAG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCtB,CAAC;AACF,CAAC"}
+{"version":3,"file":"testingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/testingTemplate.ts"],"names":[],"mappings":";;AAAA,sDAsBC;AAtBD,SAAgB,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;CAoBR,CAAC;AACF,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":"AAEA,wBAAgB,kBAAkB,IAAI,MAAM,CAmD3C"}
+{"version":3,"file":"toolingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/toolingTemplate.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,IAAI,MAAM,CAoB3C"}

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

@@ -1,31 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderToolingGuide = renderToolingGuide;
-const frontMatter_1 = require("./frontMatter");
 function renderToolingGuide() {
-    const frontMatter = (0, frontMatter_1.createFrontMatter)({
-        id: 'tooling-guide',
-        goal: 'Help contributors set up local environments, automation, and productivity tooling quickly.',
-        requiredInputs: [
-            'Project-specific CLI commands or scripts',
-            'Preferred IDE/editor configurations',
-            'Automation hooks (pre-commit, CI helpers, generators)'
-        ],
-        successCriteria: [
-            'Includes copy/paste-ready commands for installation and diagnostics',
-            'Highlights required extensions or plugins',
-            'Links to automation or productivity aids maintained by the team'
-        ],
-        relatedAgents: ['feature-developer', 'documentation-writer']
-    });
-    return `${frontMatter}
-<!-- ai-task:tooling -->
-# Tooling & Productivity Guide
+    return `# Tooling & Productivity Guide
 
 Collect the scripts, automation, and editor settings that keep contributors efficient.
 
 ## Required Tooling
-- <!-- ai-slot:tool-required -->Tool name — How to install, version requirements, what it powers.<!-- /ai-slot -->
+- Tool name — How to install, version requirements, what it powers.
 
 ## Recommended Automation
 - Pre-commit hooks, linting/formatting commands, code generators, or scaffolding scripts.
@@ -38,19 +20,6 @@ Collect the scripts, automation, and editor settings that keep contributors effi
 ## Productivity Tips
 - Terminal aliases, container workflows, or local emulators mirroring production.
 - Links to shared scripts or dotfiles used across the team.
-
-## AI Update Checklist
-1. Verify commands align with the latest scripts and build tooling.
-2. Remove instructions for deprecated tools and add replacements.
-3. Highlight automation that saves time during reviews or releases.
-4. Cross-link to runbooks or README sections that provide deeper context.
-
-## Acceptable Sources
-- Onboarding docs, internal wikis, and team retrospectives.
-- Script directories, package manifests, CI configuration.
-- Maintainer recommendations gathered during pairing or code reviews.
-
-<!-- /ai-task -->
 `;
 }
 //# sourceMappingURL=toolingTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/toolingTemplate.ts"],"names":[],"mappings":";;AAEA,gDAmDC;AArDD,+CAAkD;AAElD,SAAgB,kBAAkB;IAChC,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC;QACpC,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,4FAA4F;QAClG,cAAc,EAAE;YACd,0CAA0C;YAC1C,qCAAqC;YACrC,uDAAuD;SACxD;QACD,eAAe,EAAE;YACf,qEAAqE;YACrE,2CAA2C;YAC3C,iEAAiE;SAClE;QACD,aAAa,EAAE,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;KAC7D,CAAC,CAAC;IAEH,OAAO,GAAG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCtB,CAAC;AACF,CAAC"}
+{"version":3,"file":"toolingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/toolingTemplate.ts"],"names":[],"mappings":";;AAAA,gDAoBC;AApBD,SAAgB,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshootingTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/troubleshootingTemplate.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,IAAI,MAAM,CAyQ9C"}

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

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTroubleshooting = renderTroubleshooting;
+function renderTroubleshooting() {
+    return `# Troubleshooting Guide
+
+**Purpose:** Enable AI agents to diagnose and resolve issues using automated diagnostics and decision trees.
+
+**Agent Protocol:**
+1. Run diagnostic script to gather facts
+2. Match symptoms to known patterns
+3. Execute resolution if confidence high (>80%)
+4. Escalate to human if uncertain or high-risk
+5. Log all diagnostic steps and resolution attempts
+
+## Agent Diagnostic Script
+
+**Agent First Action:** Always run this diagnostic script to gather system state.
+
+\`\`\`bash
+#!/bin/bash
+# Save as: scripts/diagnose.sh
+# Agent runs this for ANY issue before attempting fixes
+
+echo "=== System Diagnostics $(date) ==="
+
+# 1. Application Status
+echo -e "\\n[Application Status]"
+curl -sf http://localhost:3000/health && echo "✓ App responding" || echo "✗ App not responding"
+
+# 2. Recent Errors
+echo -e "\\n[Recent Errors - Last 50 lines]"
+tail -50 logs/error.log 2>/dev/null || echo "No error log found"
+
+# 3. System Resources
+echo -e "\\n[System Resources]"
+echo "CPU: $(top -bn1 | grep "Cpu(s)" | awk '{print $2}')%"
+echo "Memory: $(free -h | awk '/^Mem:/ {print $3 "/" $2}')"
+echo "Disk: $(df -h / | awk 'NR==2 {print $5 " used"}')"
+
+# 4. Critical Services
+echo -e "\\n[Critical Services]"
+nc -z localhost 5432 && echo "✓ Database reachable" || echo "✗ Database unreachable"
+nc -z localhost 6379 && echo "✓ Redis reachable" || echo "✗ Redis unreachable"
+
+# 5. Recent Git Changes
+echo -e "\\n[Recent Changes]"
+git log --oneline -5
+
+# 6. Running Processes
+echo -e "\\n[Node Processes]"
+ps aux | grep -i node | grep -v grep
+
+echo -e "\\n=== Diagnostics Complete ==="
+\`\`\`
+
+**Agent Usage:**
+\`\`\`bash
+chmod +x scripts/diagnose.sh
+./scripts/diagnose.sh > diagnostics-$(date +%Y%m%d-%H%M%S).txt
+# Agent parses output to determine issue category
+\`\`\`
+
+## Agent Decision Tree
+
+**Agent follows this tree based on diagnostic output:**
+
+\`\`\`
+App not responding?
+├─ YES → Check "Application Won't Start" section
+└─ NO → Continue
+
+Database unreachable?
+├─ YES → Check "Database Issues" section
+└─ NO → Continue
+
+Error log has entries?
+├─ YES → Parse errors, match to "Common Issues" patterns
+└─ NO → Check "Performance Issues" section
+
+CPU > 80% OR Memory > 90%?
+├─ YES → Check "Performance/Memory Issues" section
+└─ NO → Escalate (unusual state, no clear pattern)
+\`\`\`
+
+**Agent Pattern Matching:**
+\`\`\`bash
+# Agent extracts last error from log
+LAST_ERROR=$(tail -1 logs/error.log)
+
+# Agent matches against known patterns
+if echo "$LAST_ERROR" | grep -q "ECONNREFUSED"; then
+  # Database connection issue
+  ISSUE_TYPE="database_connection"
+  CONFIDENCE="high"
+elif echo "$LAST_ERROR" | grep -q "EADDRINUSE"; then
+  # Port conflict
+  ISSUE_TYPE="port_in_use"
+  CONFIDENCE="high"
+elif echo "$LAST_ERROR" | grep -q "Cannot find module"; then
+  # Missing dependency
+  ISSUE_TYPE="missing_dependency"
+  CONFIDENCE="high"
+else
+  # Unknown pattern
+  ISSUE_TYPE="unknown"
+  CONFIDENCE="low"
+fi
+
+# Agent decides action based on confidence
+if [ "$CONFIDENCE" == "high" ]; then
+  echo "Agent attempting auto-resolution for $ISSUE_TYPE"
+  # Execute fix from "Common Issues" section
+else
+  echo "Agent escalating: unknown error pattern"
+  # Create issue with diagnostic output
+fi
+\`\`\`
+
+## Common Issues & Solutions
+
+### Application Won't Start
+
+**Agent Auto-Resolution: YES (safe to attempt)**
+
+#### Error Pattern: "EADDRINUSE"
+**Agent Detection:** Log contains "EADDRINUSE" or "port already in use"
+
+**Agent Resolution:**
+\`\`\`bash
+# Agent automatically kills process and restarts
+PORT=\${PORT:-3000}
+PID=$(lsof -ti:\$PORT)
+if [ -n "\$PID" ]; then
+  echo "Killing process \$PID on port \$PORT"
+  kill -9 \$PID
+  sleep 2
+fi
+npm start
+# Agent verifies: curl -f http://localhost:\$PORT/health
+\`\`\`
+
+#### Error Pattern: "Cannot find module"
+**Agent Detection:** Log contains "Cannot find module" or "MODULE_NOT_FOUND"
+
+**Agent Resolution:**
+\`\`\`bash
+# Agent reinstalls dependencies
+rm -rf node_modules package-lock.json
+npm install
+npm start
+# Agent logs: "Resolved missing module issue by reinstalling dependencies"
+\`\`\`
+
+#### Error Pattern: "Missing environment variable"
+**Agent Detection:** Log contains "undefined" for env var or "Missing required environment variable"
+
+**Agent Resolution:**
+\`\`\`bash
+# Agent checks .env.example for required vars
+REQUIRED_VARS=$(grep -v "^#" .env.example | cut -d= -f1)
+for VAR in \$REQUIRED_VARS; do
+  if [ -z "\${!VAR}" ]; then
+    echo "ERROR: Missing required environment variable: \$VAR"
+    echo "Agent cannot auto-resolve. Escalating to human."
+    exit 1
+  fi
+done
+\`\`\`
+**Agent Action:** ESCALATE (requires human to set values)
+
+---
+
+### Performance Issues
+
+**Agent Auto-Resolution: CONDITIONAL (depends on cause)**
+
+#### Error Pattern: High CPU Usage
+**Agent Detection:** CPU >80% sustained for >5 minutes
+
+**Agent Diagnostic:**
+\`\`\`bash
+# Agent identifies high CPU process
+top -bn1 | head -20
+ps aux --sort=-%cpu | head -10
+
+# Agent checks if it's the application
+APP_PID=$(ps aux | grep "node.*index.js" | grep -v grep | awk '{print \$2}')
+APP_CPU=$(ps aux | grep \$APP_PID | awk '{print \$3}')
+
+if (( \$(echo "\$APP_CPU > 80" | bc -l) )); then
+  echo "Application consuming high CPU: \${APP_CPU}%"
+  echo "Agent Action: Restart application"
+  pm2 restart app || npm run restart
+else
+  echo "External process consuming CPU - Agent escalating to human"
+fi
+\`\`\`
+
+---
+
+### Database Issues
+
+**Agent Auto-Resolution: CONDITIONAL**
+
+#### Error Pattern: "ECONNREFUSED" (Database)
+**Agent Detection:** Log contains "ECONNREFUSED" with database port (5432, 3306, 27017)
+
+**Agent Diagnostic:**
+\`\`\`bash
+# Check if database is running
+nc -z localhost 5432 && echo "DB reachable" || echo "DB not reachable"
+
+# If not reachable, attempt to start
+if ! nc -z localhost 5432; then
+  echo "Agent attempting to start database..."
+  docker-compose up -d db || sudo systemctl start postgresql
+  sleep 5
+  nc -z localhost 5432 && echo "✓ Database started" || echo "✗ Failed to start - escalating"
+fi
+\`\`\`
+
+---
+
+## Escalation Criteria
+
+**Agent must escalate immediately when:**
+- Unknown error pattern (confidence <50%)
+- Data corruption risk (database migration failures, validation errors)
+- Security issue detected (exposed credentials, unauthorized access)
+- Multiple resolution attempts failed (tried 2+ fixes, issue persists)
+- Human approval required (destructive operations, production changes)
+
+**Escalation format:**
+\`\`\`bash
+# Agent creates structured escalation
+cat > escalation-\$(date +%Y%m%d-%H%M%S).txt <<EOF
+ESCALATION REQUIRED
+
+Issue: [Brief description]
+Confidence: [low/medium]
+Risk Level: [low/medium/high]
+
+Symptoms:
+- [List observed symptoms]
+
+Diagnostics Run:
+- [Commands executed]
+- [Output summary]
+
+Resolution Attempts:
+- [What agent tried]
+- [Results]
+
+Recommendation:
+- [Suggested next steps for human]
+
+Diagnostic Files:
+- diagnostics-*.txt
+- logs/error.log (last 100 lines attached below)
+
+---
+\$(tail -100 logs/error.log)
+EOF
+
+echo "Escalation created. Agent awaiting human intervention."
+\`\`\`
+`;
+}
+//# sourceMappingURL=troubleshootingTemplate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshootingTemplate.js","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/troubleshootingTemplate.ts"],"names":[],"mappings":";;AAAA,sDAyQC;AAzQD,SAAgB,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuQR,CAAC;AACF,CAAC"}

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

@@ -1,9 +1,9 @@
 import { RepoStructure } from '../../../types';
+import { SemanticContext } from '../../../services/semantic';
 export interface GuideMeta {
     key: string;
     title: string;
     file: string;
-    marker: string;
     primaryInputs: string;
 }
 export interface DirectoryStat {
@@ -19,5 +19,6 @@ export interface DocumentationTemplateContext {
     }>;
     directoryStats: DirectoryStat[];
     guides: GuideMeta[];
+    semantics?: SemanticContext;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,aAAa,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/generators/documentation/templates/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,aAAa,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B"}

package/dist/generators/plans/planGenerator.d.ts

@@ -7,6 +7,8 @@ interface PlanGeneratorOptions {
     selectedDocKeys?: string[] | null;
     force?: boolean;
     verbose?: boolean;
+    semantic?: boolean;
+    projectPath?: string;
 }
 interface PlanGenerationResult {
     planPath: string;
@@ -14,8 +16,10 @@ interface PlanGenerationResult {
     slug: string;
 }
 export declare class PlanGenerator {
+    private analyzer?;
     generatePlan(options: PlanGeneratorOptions): Promise<PlanGenerationResult>;
     private resolveAgents;
+    private buildCodebaseSnapshot;
     private updatePlanIndex;
 }
 export {};

package/dist/generators/plans/planGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/plans/planGenerator.ts"],"names":[],"mappings":"AAWA,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAa;IAClB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4DhF,OAAO,CAAC,aAAa;YAmBP,eAAe;CAkB9B"}
+{"version":3,"file":"planGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/plans/planGenerator.ts"],"names":[],"mappings":"AAYA,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAmB;IAE9B,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmFhF,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,qBAAqB;YAYf,eAAe;CAkB9B"}

package/dist/generators/plans/planGenerator.js

@@ -42,9 +42,10 @@ const agentConfig_1 = require("../agents/agentConfig");
 const guideRegistry_1 = require("../documentation/guideRegistry");
 const planTemplate_1 = require("./templates/planTemplate");
 const indexTemplate_1 = require("./templates/indexTemplate");
+const semantic_1 = require("../../services/semantic");
 class PlanGenerator {
     async generatePlan(options) {
-        const { planName, outputDir, title, summary, selectedAgentTypes, selectedDocKeys, force = false, verbose = false } = options;
+        const { planName, outputDir, title, summary, selectedAgentTypes, selectedDocKeys, force = false, verbose = false, semantic = false, projectPath } = options;
         const slug = shared_1.GeneratorUtils.slugify(planName);
         if (!slug) {
             throw new Error('Plan name must contain at least one alphanumeric character.');
@@ -59,6 +60,21 @@ class PlanGenerator {
         if (!force && await fs.pathExists(planPath)) {
             throw new Error(`Plan already exists at ${planPath}. Use --force to overwrite.`);
         }
+        // Perform semantic analysis if enabled
+        let semantics;
+        let codebaseSnapshot;
+        if (semantic && projectPath) {
+            shared_1.GeneratorUtils.logProgress('Running semantic analysis for plan...', verbose);
+            this.analyzer = new semantic_1.CodebaseAnalyzer();
+            try {
+                semantics = await this.analyzer.analyze(projectPath);
+                codebaseSnapshot = this.buildCodebaseSnapshot(semantics);
+                shared_1.GeneratorUtils.logProgress(`Analyzed ${semantics.stats.totalFiles} files, found ${semantics.stats.totalSymbols} symbols`, verbose);
+            }
+            catch (error) {
+                shared_1.GeneratorUtils.logError('Semantic analysis failed, continuing without it', error, verbose);
+            }
+        }
         const agentSummaries = this.resolveAgents(selectedAgentTypes);
         const docGuides = selectedDocKeys === null
             ? []
@@ -68,7 +84,9 @@ class PlanGenerator {
             slug,
             summary,
             agents: agentSummaries,
-            docs: docGuides
+            docs: docGuides,
+            semantics,
+            codebaseSnapshot
         });
         await shared_1.GeneratorUtils.writeFileWithLogging(planPath, content, verbose, `Created ${planFileName}`);
         await this.updatePlanIndex(plansDir, verbose);
@@ -93,6 +111,16 @@ class PlanGenerator {
             responsibility: agentConfig_1.AGENT_RESPONSIBILITIES[type]?.[0] || 'Document this agent\'s primary responsibility.'
         }));
     }
+    buildCodebaseSnapshot(semantics) {
+        const { architecture, stats } = semantics;
+        return {
+            totalFiles: stats.totalFiles,
+            totalSymbols: stats.totalSymbols,
+            layers: architecture.layers.map(layer => layer.name),
+            patterns: architecture.patterns.map(pattern => pattern.name),
+            entryPoints: architecture.entryPoints
+        };
+    }
     async updatePlanIndex(plansDir, verbose) {
         const files = await fs.readdir(plansDir);
         const entries = files

package/dist/generators/plans/planGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"planGenerator.js","sourceRoot":"","sources":["../../../src/generators/plans/planGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAC7B,6CAA+B;AAE/B,sCAA2C;AAC3C,qDAA8D;AAC9D,uDAA+D;AAC/D,kEAAiE;AACjE,2DAA8D;AAC9D,6DAA4D;AAoB5D,MAAa,aAAa;IACxB,KAAK,CAAC,YAAY,CAAC,OAA6B;QAC9C,MAAM,EACJ,QAAQ,EACR,SAAS,EACT,KAAK,EACL,OAAO,EACP,kBAAkB,EAClB,eAAe,EACf,KAAK,GAAG,KAAK,EACb,OAAO,GAAG,KAAK,EAChB,GAAG,OAAO,CAAC;QAEZ,MAAM,IAAI,GAAG,uBAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,uBAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAEpD,MAAM,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACnC,MAAM,uBAAc,CAAC,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC;QAE1F,MAAM,YAAY,GAAG,GAAG,IAAI,KAAK,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEnD,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,6BAA6B,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,eAAe,KAAK,IAAI;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,IAAA,+BAAe,EAAC,eAAe,IAAI,SAAS,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,IAAA,iCAAkB,EAAC;YACjC,KAAK,EAAE,SAAS;YAChB,IAAI;YACJ,OAAO;YACP,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QAEH,MAAM,uBAAc,CAAC,oBAAoB,CACvC,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,YAAY,EAAE,CAC1B,CAAC;QAEF,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE9C,OAAO;YACL,QAAQ;YACR,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC;YACrD,IAAI;SACL,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,QAA0B;QAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAY,KAAK,CAAC,IAAI,CAAC,wBAAW,CAAC,CAAC,CAAC;QAE5D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAgB,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YACzD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;iBACnE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAkB,CAAC,CAAgB;YACpE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAExB,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI;YACJ,KAAK,EAAE,uBAAc,CAAC,WAAW,CAAC,IAAI,CAAC;YACvC,cAAc,EAAE,oCAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,gDAAgD;SACtG,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,OAAgB;QAC9D,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,OAAO,GAAqB,KAAK;aACpC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC;aACxF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;aACvC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,uBAAc,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;aAChE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAElD,MAAM,YAAY,GAAG,IAAA,+BAAe,EAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEnD,MAAM,uBAAc,CAAC,oBAAoB,CACvC,SAAS,EACT,YAAY,EACZ,OAAO,EACP,qBAAqB,CACtB,CAAC;IACJ,CAAC;CACF;AAlGD,sCAkGC"}
+{"version":3,"file":"planGenerator.js","sourceRoot":"","sources":["../../../src/generators/plans/planGenerator.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/plans/templates/indexTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAgCjE"}
+{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/plans/templates/indexTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAwBjE"}

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

@@ -9,28 +9,20 @@ function renderPlanIndex(entries) {
         : '_No plans created yet. Use "ai-context plan <name>" to create the first one._';
     return `# Collaboration Plans
 
-This directory is the run queue for AI agents and maintainers coordinating work across documentation and playbooks. Treat the list below as an ordered backlog: finish the first plan before moving on to the next unless a human directs otherwise.
+This directory contains plans for coordinating work across documentation and playbooks.
 
-## Agent Execution Protocol
-1. **Read the queue** from top to bottom. The numbering reflects execution priority.
-2. **Open the plan file** (e.g., './plans/<slug>.md') and review the YAML front matter and the '<!-- ai-task:plan-... -->' wrapper so you understand the goal, required inputs, and success criteria.
-3. **Gather context** by visiting the linked documentation and agent playbooks referenced in the "Agent Lineup" and "Documentation Touchpoints" tables.
-4. **Execute the stages** exactly as written, capturing evidence and updating linked docs as instructed. If a stage cannot be completed, record the reason inside the plan before pausing.
-5. **Close out the plan** by updating any TODOs, recording outcomes in the "Evidence & Follow-up" section, and notifying maintainers if human review is required.
-6. **Return here** and pick the next plan in the queue. Always leave the README and plan files consistent with the work performed.
-
-## Plan Queue (process in order)
+## Plan Queue
 ${planList}
 
 ## How To Create Or Update Plans
 - Run "ai-context plan <name>" to scaffold a new plan template.
-- Run "ai-context plan <name> --fill" (optionally with "--dry-run") to have an LLM refresh the plan using the latest repository context.
-- Cross-link any new documentation or agent resources you introduce so future runs stay discoverable.
+- Run "ai-context plan <name> --fill" to have an LLM refresh the plan using the latest repository context.
 
 ## Related Resources
 - [Agent Handbook](../agents/README.md)
 - [Documentation Index](../docs/README.md)
-- [Contributor Guidelines](../AGENTS.md)
+- [Agent Knowledge Base](../../AGENTS.md)
+- [Contributor Guidelines](../../CONTRIBUTING.md)
 `;
 }
 //# sourceMappingURL=indexTemplate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/plans/templates/indexTemplate.ts"],"names":[],"mappings":";;AAEA,0CAgCC;AAhCD,SAAgB,eAAe,CAAC,OAAyB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM;QAC7B,CAAC,CAAC,OAAO;aACJ,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC;aAC3E,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,+EAA+E,CAAC;IAEpF,OAAO;;;;;;;;;;;;;EAaP,QAAQ;;;;;;;;;;;CAWT,CAAC;AACF,CAAC"}
+{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/plans/templates/indexTemplate.ts"],"names":[],"mappings":";;AAEA,0CAwBC;AAxBD,SAAgB,eAAe,CAAC,OAAyB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM;QAC7B,CAAC,CAAC,OAAO;aACJ,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC;aAC3E,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,+EAA+E,CAAC;IAEpF,OAAO;;;;;EAKP,QAAQ;;;;;;;;;;;CAWT,CAAC;AACF,CAAC"}

package/dist/generators/plans/templates/planTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/plans/templates/planTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CA8FvE"}
+{"version":3,"file":"planTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/plans/templates/planTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,SAAS,CAAC;AA4DhE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CA+IvE"}