@planu/cli 0.15.2

package/dist/tools/generate-adr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/generate-adr/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/tools/generate-adr.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateADRInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateADR(args: GenerateADRInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-adr.d.ts.map

package/dist/tools/generate-adr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-adr.d.ts","sourceRoot":"","sources":["../../src/tools/generate-adr.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAa,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQjF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2CnF"}

package/dist/tools/generate-adr.js

@@ -0,0 +1,46 @@
+// tools/generate-adr.ts — Architecture Decision Records
+// Analyzes a spec and project knowledge to generate structured ADRs
+// documenting architectural decisions, options, tradeoffs, and rationale.
+import { specStore, knowledgeStore, patternStore } from '../storage/index.js';
+import { t, ti } from '../i18n/index.js';
+import { generateDecisions, readSpecContent, buildEcosystemAnalysis, buildRecommendation, } from './generate-adr/index.js';
+export async function handleGenerateADR(args) {
+    const { specId, projectId, decisions: requestedDecisions } = args;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+            isError: true,
+        };
+    }
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [{ type: 'text', text: t('project.notFound') }],
+            isError: true,
+        };
+    }
+    const patterns = await patternStore.findPatternsByType(projectId, 'architecture');
+    const specContent = await readSpecContent(spec);
+    const decisions = generateDecisions(spec, knowledge, patterns, specContent, requestedDecisions);
+    const ecosystemAnalysis = buildEcosystemAnalysis(knowledge);
+    const recommendation = buildRecommendation(decisions, knowledge);
+    const result = {
+        decisions,
+        ecosystemAnalysis,
+        recommendation,
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.generate_adr.success', { count: String(decisions.length) }),
+            },
+            {
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=generate-adr.js.map

package/dist/tools/generate-adr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-adr.js","sourceRoot":"","sources":["../../src/tools/generate-adr.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,oEAAoE;AACpE,0EAA0E;AAE1E,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAsB;IAC5D,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAElE,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC/E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACjE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,kBAAkB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAClF,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAChG,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAc;QACxB,SAAS;QACT,iBAAiB;QACjB,cAAc;KACf,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,EAAE,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;aAC5E;YACD;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-checklist.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateChecklistInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateChecklist(params: GenerateChecklistInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-checklist.d.ts.map

package/dist/tools/generate-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-checklist.d.ts","sourceRoot":"","sources":["../../src/tools/generate-checklist.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,UAAU,EAKX,MAAM,mBAAmB,CAAC;AAuF3B,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6GjG"}

package/dist/tools/generate-checklist.js

@@ -0,0 +1,166 @@
+import { ti } from '../i18n/index.js';
+import { specStore, knowledgeStore } from '../storage/index.js';
+import { generateChecklist } from '../engine/validator.js';
+const CATEGORY_WEIGHTS = {
+    completeness: 0.25,
+    consistency: 0.2,
+    feasibility: 0.2,
+    security: 0.15,
+    'edge-cases': 0.1,
+    ux: 0.1,
+};
+function itemPassed(item) {
+    if (item.passed !== undefined) {
+        return item.passed ?? null;
+    }
+    if (item.answer === 'yes') {
+        return true;
+    }
+    if (item.answer === 'no') {
+        return false;
+    }
+    return null;
+}
+function computeChecklistScore(items) {
+    const categories = Object.keys(CATEGORY_WEIGHTS);
+    const categoryScores = [];
+    for (const category of categories) {
+        const catItems = items.filter((i) => i.category === category);
+        const weight = CATEGORY_WEIGHTS[category];
+        if (catItems.length === 0) {
+            categoryScores.push({ category, score: 0, weight, items: [] });
+            continue;
+        }
+        const passed = catItems.filter((i) => itemPassed(i) === true).length;
+        const failed = catItems.filter((i) => itemPassed(i) === false).length;
+        const decidable = passed + failed;
+        const score = decidable > 0 ? Math.round((passed / decidable) * 100) : 50;
+        categoryScores.push({ category, score, weight, items: catItems });
+    }
+    const active = categoryScores.filter((cs) => cs.items.length > 0);
+    const totalWeight = active.reduce((s, cs) => s + cs.weight, 0);
+    /* v8 ignore next 2 */
+    const overall = totalWeight > 0
+        ? Math.round(active.reduce((s, cs) => s + cs.score * cs.weight, 0) / totalWeight)
+        : 0;
+    const autoCheckedCount = items.filter((i) => i.autoChecked).length;
+    const manualPendingCount = items.filter((i) => !i.autoChecked && (i.answer === 'pending' || i.passed === null)).length;
+    const recommendation = overall >= 80 ? 'approve' : overall >= 60 ? 'review' : 'reject';
+    return {
+        overall,
+        categories: categoryScores,
+        autoCheckedCount,
+        manualPendingCount,
+        recommendation,
+    };
+}
+function enrichItemsPassed(items) {
+    return items.map((item) => {
+        const derived = itemPassed(item);
+        const detail = item.detail !== undefined
+            ? item.detail
+            : item.autoChecked && item.answer !== 'pending'
+                ? item.answer === 'yes'
+                    ? 'Auto-check passed'
+                    : 'Auto-check failed'
+                : null;
+        return { ...item, passed: item.passed !== undefined ? item.passed : derived, detail };
+    });
+}
+export async function handleGenerateChecklist(params) {
+    const { specId, projectId, focus, experienceLevel = 'expert' } = params;
+    try {
+        const spec = await specStore.getSpec(projectId, specId);
+        if (!spec) {
+            return {
+                content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+                isError: true,
+            };
+        }
+        const knowledge = await knowledgeStore.getKnowledge(projectId);
+        const checklist = generateChecklist(spec, focus ?? []);
+        const enrichedItems = enrichItemsPassed([...checklist.items]);
+        if (knowledge) {
+            const constitution = await knowledgeStore.getConstitution(projectId);
+            if (constitution && constitution.principles.length > 0) {
+                const strictPrinciples = constitution.principles.filter((p) => p.enforceLevel === 'strict');
+                for (const principle of strictPrinciples.slice(0, 3)) {
+                    enrichedItems.push({
+                        id: `cl-const-${principle.id}`,
+                        question: `Does the implementation comply with: "${principle.principle}"?`,
+                        category: 'consistency',
+                        answer: 'pending',
+                        autoChecked: false,
+                        passed: null,
+                        detail: null,
+                    });
+                }
+            }
+            if (knowledge.database !== 'unknown' &&
+                (spec.target === 'backend' || spec.target === 'fullstack')) {
+                enrichedItems.push({
+                    id: 'cl-db-1',
+                    question: `Are database migrations reversible for ${knowledge.database}?`,
+                    category: 'feasibility',
+                    answer: 'pending',
+                    autoChecked: false,
+                    passed: null,
+                    detail: null,
+                });
+            }
+            if (knowledge.testCommand) {
+                enrichedItems.push({
+                    id: 'cl-test-1',
+                    question: `Do tests pass with \`${knowledge.testCommand}\`?`,
+                    category: 'completeness',
+                    answer: 'pending',
+                    autoChecked: false,
+                    passed: null,
+                    detail: null,
+                });
+            }
+        }
+        const passedCount = enrichedItems.filter((i) => i.answer === 'yes').length;
+        const totalCount = enrichedItems.length;
+        const score = totalCount > 0 ? Math.round((passedCount / totalCount) * 100) : 0;
+        const checklistScore = computeChecklistScore(enrichedItems);
+        const byCategory = {};
+        for (const item of enrichedItems) {
+            const cat = item.category;
+            const group = (byCategory[cat] ??= []);
+            group.push(item);
+        }
+        const base = {
+            specId,
+            projectId,
+            focus: focus ?? ['all'],
+            totalItems: totalCount,
+            passedItems: passedCount,
+            pendingItems: enrichedItems.filter((i) => i.answer === 'pending').length,
+            failedItems: enrichedItems.filter((i) => i.answer === 'no').length,
+            score,
+            checklistScore,
+            checklist: byCategory,
+            generatedAt: new Date().toISOString(),
+            message: ti('tools.generate_checklist.success', { totalCount: String(totalCount) }),
+        };
+        if (experienceLevel === 'beginner') {
+            const improvable = checklistScore.manualPendingCount + enrichedItems.filter((i) => i.answer === 'no').length;
+            const narrative = `Tu spec tiene ${checklistScore.overall}/100 puntos. Hay ${improvable} cosas que mejorar o verificar manualmente.`;
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ ...base, narrative }, null, 2) }],
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(base, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: ti('errors.internalError', { message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=generate-checklist.js.map

package/dist/tools/generate-checklist.js.map

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

package/dist/tools/generate-docs/agent-docs-generator.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectKnowledge, Spec, AgentDocumentationResult } from '../../types/index.js';
+/**
+ * Generate agent documentation if the project is an AI agent project.
+ * Criterion 10: generates usage manual, configuration guide, troubleshooting.
+ */
+export declare function generateAgentDocumentation(knowledge: ProjectKnowledge, specs: Spec[]): AgentDocumentationResult | null;
+//# sourceMappingURL=agent-docs-generator.d.ts.map

package/dist/tools/generate-docs/agent-docs-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-docs-generator.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-docs/agent-docs-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAoN7F;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,GACZ,wBAAwB,GAAG,IAAI,CAUjC"}

package/dist/tools/generate-docs/agent-docs-generator.js

@@ -0,0 +1,213 @@
+// Planu — Agent Documentation Generator
+// SPEC-016a criterion 10: generate agent usage manual, configuration guide, troubleshooting.
+/**
+ * Detect if the project is an AI agent project.
+ */
+function isAgentProject(knowledge) {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    const stack = (knowledge.stack ?? []).map((s) => s.toLowerCase());
+    const agentSignals = [
+        '@anthropic-ai/sdk',
+        '@mastra/core',
+        'langgraph',
+        'crewai',
+        'autogen',
+        'langchain',
+        '@ai-sdk/anthropic',
+        'mem0',
+    ];
+    return agentSignals.some((sig) => stack.some((s) => s.includes(sig)));
+}
+/**
+ * Generate agent usage manual.
+ */
+function buildUsageManual(knowledge, specs) {
+    const agentSpecs = specs.filter((s) => s.type === 'agent' || s.title.toLowerCase().includes('agent'));
+    const specList = agentSpecs.map((s) => `- **${s.id}**: ${s.title}`).join('\n');
+    const installCmd = knowledge.packageManager === 'pnpm'
+        ? 'pnpm install'
+        : knowledge.packageManager === 'yarn'
+            ? 'yarn install'
+            : 'npm install';
+    return [
+        '# Agent Usage Manual',
+        '',
+        `**Framework:** ${knowledge.framework ?? 'Custom'} | **Language:** ${knowledge.language}`,
+        '',
+        '## Overview',
+        'This manual describes how to interact with the AI agent system.',
+        '',
+        '## Available Agents',
+        specList || '- No agent specs defined yet. Run `create_spec` with `type: "agent"`.',
+        '',
+        '## How to Start an Agent',
+        '```bash',
+        '# 1. Set required environment variables',
+        'export ANTHROPIC_API_KEY="your-key-here"',
+        '',
+        '# 2. Install dependencies',
+        installCmd,
+        '',
+        '# 3. Run the agent',
+        knowledge.buildCommand ?? 'npm start',
+        '```',
+        '',
+        '## Input Format',
+        'Send a message to the agent in the following format:',
+        '```json',
+        JSON.stringify({ message: 'Your task description', context: {}, priority: 'medium' }, null, 2),
+        '```',
+        '',
+        '## Output Format',
+        '```json',
+        JSON.stringify({
+            response: 'Agent response',
+            toolsUsed: ['tool_name'],
+            iterationsUsed: 3,
+            confidence: 0.95,
+        }, null, 2),
+        '```',
+        '',
+        '## Limitations',
+        '- Max iterations per request: 10 (configurable)',
+        '- Max tokens per context window: depends on model',
+        '- Rate limits: 60 requests/minute (default)',
+        '- Cost: billed per token — monitor with LangSmith/Langfuse',
+    ].join('\n');
+}
+/**
+ * Generate agent configuration guide.
+ */
+function buildConfigurationGuide(knowledge) {
+    return [
+        '# Agent Configuration Guide',
+        '',
+        '## Environment Variables',
+        '',
+        '| Variable | Required | Description | Example |',
+        '|----------|----------|-------------|---------|',
+        '| `ANTHROPIC_API_KEY` | Yes | Anthropic API key | `sk-ant-...` |',
+        '| `AGENT_MAX_ITERATIONS` | No | Max tool calls per turn (default: 10) | `10` |',
+        '| `AGENT_TEMPERATURE` | No | LLM temperature (default: 0 for determinism) | `0` |',
+        '| `AGENT_LOG_LEVEL` | No | Logging level | `info` |',
+        '| `VECTOR_STORE_URL` | Conditional | Required for RAG/memory | `https://...` |',
+        '| `MEM0_API_KEY` | Conditional | Required for mem0 memory | `m0-...` |',
+        '',
+        '## Model Selection',
+        '',
+        `Current framework: \`${knowledge.framework ?? 'custom'}\``,
+        '',
+        '| Use case | Recommended model |',
+        '|----------|-------------------|',
+        '| Complex reasoning, planning | `claude-opus-4-5` |',
+        '| General tasks, tool use | `claude-sonnet-4-5` |',
+        '| Simple tasks, high volume | `claude-haiku-4-5` |',
+        '',
+        '## Memory Configuration',
+        '',
+        '```typescript',
+        '// In-context memory (simple, no external dependencies)',
+        'const agent = { memory: "in-context", maxTurns: 20 };',
+        '',
+        '// Vector store memory (for large knowledge bases)',
+        'const agent = { memory: "vector-store", vectorStoreUrl: process.env.VECTOR_STORE_URL };',
+        '',
+        '// mem0 persistent memory (cross-session)',
+        'const agent = { memory: "mem0", userId: "user-123" };',
+        '```',
+        '',
+        '## Tool Registration',
+        '',
+        '```typescript',
+        '// Register tools before agent run',
+        'const tools = [',
+        '  { name: "search", description: "Search the web", execute: searchFn },',
+        '  { name: "database", description: "Query database", execute: dbFn },',
+        '];',
+        '```',
+    ].join('\n');
+}
+/**
+ * Generate agent troubleshooting guide.
+ */
+function buildTroubleshootingGuide() {
+    return [
+        '# Agent Troubleshooting Guide',
+        '',
+        '## Common Issues',
+        '',
+        '### 1. Agent loops infinitely',
+        '**Symptom:** Agent keeps calling tools without completing the task.',
+        '**Solution:**',
+        '- Check `AGENT_MAX_ITERATIONS` is set (default: 10)',
+        '- Look for circular tool call patterns in logs',
+        '- Add explicit termination condition to agent instructions',
+        '',
+        '### 2. Hallucinated tool parameters',
+        '**Symptom:** Tool calls fail with parameter validation errors.',
+        '**Solution:**',
+        '- Add JSON Schema validation to all tool inputs',
+        '- Use structured output / strict mode when available',
+        '- Log rejected tool calls for pattern analysis',
+        '',
+        '### 3. Context window exceeded',
+        '**Symptom:** ContextLengthExceededError or silent truncation.',
+        '**Solution:**',
+        '- Enable token counting: check usage in response metadata',
+        '- Implement conversation summarization after N turns',
+        '- Move knowledge to vector store instead of in-context',
+        '',
+        '### 4. Rate limit errors',
+        '**Symptom:** 429 Too Many Requests from API.',
+        '**Solution:**',
+        '- Implement exponential backoff: 100ms * 2^attempt',
+        '- Add token budget per user session',
+        '- Consider batching requests or using async queue',
+        '',
+        '### 5. Prompt injection detected',
+        '**Symptom:** Agent behavior changes unexpectedly after tool call.',
+        '**Solution:**',
+        '- Sanitize tool outputs before adding to context',
+        '- Filter for instruction-like patterns in tool returns',
+        '- Use separate system/user message boundaries',
+        '',
+        '### 6. High costs',
+        '**Symptom:** Unexpected token consumption or billing.',
+        '**Solution:**',
+        '- Enable LangSmith/Langfuse tracing to audit token usage',
+        '- Set hard cost cap per request (max_tokens parameter)',
+        '- Use Haiku for simple tasks, Sonnet for moderate, Opus for complex',
+        '',
+        '## Debugging Commands',
+        '```bash',
+        '# View agent run logs',
+        'AGENT_LOG_LEVEL=debug npm start 2>&1 | grep "tool_call"',
+        '',
+        '# Count tokens in a request',
+        'npx ts-node scripts/count-tokens.ts "Your input message"',
+        '',
+        '# Test prompt injection defense',
+        'npm test -- --grep "prompt injection"',
+        '```',
+        '',
+        '## Support',
+        '- Open an issue with: agent logs, input message, expected vs actual output',
+        '- Include model name and version, tool list, and iteration count',
+    ].join('\n');
+}
+// === Public API ===
+/**
+ * Generate agent documentation if the project is an AI agent project.
+ * Criterion 10: generates usage manual, configuration guide, troubleshooting.
+ */
+export function generateAgentDocumentation(knowledge, specs) {
+    if (!isAgentProject(knowledge)) {
+        return null;
+    }
+    return {
+        usageManual: buildUsageManual(knowledge, specs),
+        configurationGuide: buildConfigurationGuide(knowledge),
+        troubleshootingGuide: buildTroubleshootingGuide(),
+    };
+}
+//# sourceMappingURL=agent-docs-generator.js.map

package/dist/tools/generate-docs/agent-docs-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-docs-generator.js","sourceRoot":"","sources":["../../../src/tools/generate-docs/agent-docs-generator.ts"],"names":[],"mappings":"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"}

package/dist/tools/generate-docs/bounded-context-map-generator.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+/** Generates the BOUNDED-CONTEXT-MAP.md content from detected DDD config */
+export declare function generateBoundedContextMap(projectPath: string, knowledge: ProjectKnowledge): Promise<string>;
+//# sourceMappingURL=bounded-context-map-generator.d.ts.map

package/dist/tools/generate-docs/bounded-context-map-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-context-map-generator.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-docs/bounded-context-map-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,sBAAsB,CAAC;AAgB9B,4EAA4E;AAC5E,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwGjB"}

package/dist/tools/generate-docs/bounded-context-map-generator.js

@@ -0,0 +1,104 @@
+// tools/generate-docs/bounded-context-map-generator.ts — Bounded Context Map generation (SPEC-033)
+// Generates BOUNDED-CONTEXT-MAP.md from DDD detection results.
+import { detectDdd } from '../../engine/architecture-pattern-detector.js';
+/** Maps relation type to a human-readable label */
+function relationTypeLabel(relationType) {
+    const labels = {
+        'upstream-downstream': 'Upstream → Downstream',
+        acl: 'ACL (Anti-Corruption Layer)',
+        'published-language': 'Published Language',
+        'shared-kernel': 'Shared Kernel',
+        conformist: 'Conformist',
+        partnership: 'Partnership (bidirectional)',
+    };
+    return labels[relationType];
+}
+/** Generates the BOUNDED-CONTEXT-MAP.md content from detected DDD config */
+export async function generateBoundedContextMap(projectPath, knowledge) {
+    const dddConfig = await detectDdd(projectPath);
+    if (!dddConfig.detected) {
+        return ('## Bounded Context Map\n\n' +
+            '_No DDD indicators detected in this project. ' +
+            'To enable this document, ensure your project has:\n' +
+            '- At least 3 DDD tactical suffixes (Aggregate, ValueObject, DomainEvent, Repository, Specification)\n' +
+            '- A bounded-contexts/ or contexts/ directory structure\n' +
+            '- An ubiquitous-language.md file or EventStorming links in README_\n');
+    }
+    const contexts = dddConfig.boundedContexts;
+    const relations = dddConfig.contextMap?.relations ?? [];
+    const updatedAt = new Date().toISOString();
+    const lines = [
+        '# Bounded Context Map',
+        '',
+        `> Generated by Planu on ${updatedAt.split('T')[0] ?? updatedAt}`,
+        '',
+    ];
+    // Project info
+    lines.push('## Project');
+    lines.push('');
+    lines.push(`- **Language:** ${knowledge.language}`);
+    lines.push(`- **Architecture primary:** ${knowledge.architecture.primary}`);
+    lines.push('');
+    // Bounded contexts list
+    lines.push('## Bounded Contexts');
+    lines.push('');
+    if (contexts.length === 0) {
+        lines.push('_No bounded contexts detected from directory structure._');
+    }
+    else {
+        for (const ctx of contexts) {
+            lines.push(`### ${ctx}`);
+            lines.push('');
+            if (dddConfig.hasUbiquitousLanguage && dddConfig.ubiquitousLanguagePath) {
+                lines.push(`- **Ubiquitous Language:** See \`${dddConfig.ubiquitousLanguagePath}\``);
+            }
+            lines.push('');
+        }
+    }
+    // Context Relations
+    lines.push('## Context Relations');
+    lines.push('');
+    if (relations.length === 0) {
+        lines.push('_No inter-context relations detected automatically._');
+        lines.push('');
+        lines.push('To document relations, add entries to your `context-map.md` or update this file manually.');
+        lines.push('');
+        lines.push('Relation types to consider:');
+        lines.push('- **Upstream → Downstream**: One context depends on data from another');
+        lines.push('- **ACL**: Downstream translates upstream model to protect its own domain');
+        lines.push('- **Published Language**: Formal contract (OpenAPI, AsyncAPI, Avro)');
+        lines.push('- **Shared Kernel**: Code shared between two contexts with explicit coordination');
+        lines.push('- **Conformist**: Downstream adopts upstream model without translation');
+        lines.push('- **Partnership**: Bidirectional coordination for mutual changes');
+    }
+    else {
+        lines.push('| Upstream | Downstream | Relation Type | Integration Mechanism |');
+        lines.push('|----------|------------|---------------|-----------------------|');
+        for (const rel of relations) {
+            const mechanism = rel.integrationMechanism ?? '_not specified_';
+            lines.push(`| ${rel.upstream} | ${rel.downstream} | ${relationTypeLabel(rel.relationType)} | ${mechanism} |`);
+        }
+    }
+    lines.push('');
+    // EventStorming
+    if (dddConfig.hasEventStormingDiagrams) {
+        lines.push('## EventStorming');
+        lines.push('');
+        lines.push('EventStorming diagrams detected in README. See project documentation for links to Miro/Mural boards.');
+        lines.push('');
+    }
+    // Metadata
+    lines.push('---');
+    lines.push('');
+    lines.push('## Detection Metadata');
+    lines.push('');
+    lines.push(`- **DDD detected:** ${String(dddConfig.detected)}`);
+    lines.push(`- **Bounded contexts found:** ${contexts.length}`);
+    lines.push(`- **Has ubiquitous language:** ${String(dddConfig.hasUbiquitousLanguage)}`);
+    lines.push(`- **Has EventStorming diagrams:** ${String(dddConfig.hasEventStormingDiagrams)}`);
+    lines.push(`- **Last updated:** ${updatedAt}`);
+    lines.push('');
+    lines.push('_Note: This map is auto-generated from code structure. Manual review is recommended._');
+    return lines.join('\n');
+}
+//# sourceMappingURL=bounded-context-map-generator.js.map

package/dist/tools/generate-docs/bounded-context-map-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-context-map-generator.js","sourceRoot":"","sources":["../../../src/tools/generate-docs/bounded-context-map-generator.ts"],"names":[],"mappings":"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"}

package/dist/tools/generate-docs/mobile-installation-guide.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectKnowledge, Spec } from '../../types/index.js';
+/**
+ * Builds a mobile installation guide as a markdown string.
+ * Covers iOS (TestFlight + App Store checklist) and Android (APK + Play Store checklist).
+ * Called by handleGenerateDocs when specs include iOS/Android targets.
+ */
+export declare function generateMobileInstallationGuide(_knowledge: ProjectKnowledge, specs: Spec[], _language: string): string;
+//# sourceMappingURL=mobile-installation-guide.d.ts.map

package/dist/tools/generate-docs/mobile-installation-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-installation-guide.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-docs/mobile-installation-guide.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA0HnE;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAiBR"}