specforge-mcp 0.1.0

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

@@ -0,0 +1,201 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    ti: vi.fn((_key, params) => `translated:${JSON.stringify(params)}`),
+}));
+vi.mock('../storage/index.js', () => ({
+    specStore: {
+        getSpec: vi.fn(),
+    },
+    knowledgeStore: {
+        getKnowledge: vi.fn(),
+        getConstitution: vi.fn(),
+    },
+}));
+vi.mock('../engine/validator.js', () => ({
+    generateChecklist: vi.fn(),
+}));
+import { handleGenerateChecklist } from './generate-checklist.js';
+import { specStore, knowledgeStore } from '../storage/index.js';
+import { generateChecklist } from '../engine/validator.js';
+const makeSpec = (overrides = {}) => ({
+    id: 'SPEC-001',
+    title: 'Test Spec',
+    status: 'draft',
+    target: 'fullstack',
+    ...overrides,
+});
+const makeChecklistResult = () => ({
+    specId: 'SPEC-001',
+    items: [
+        { id: 'cl-1', question: 'Is the spec complete?', category: 'completeness', answer: 'pending', autoChecked: false },
+        { id: 'cl-2', question: 'Is it consistent?', category: 'consistency', answer: 'yes', autoChecked: true },
+    ],
+    passedCount: 1,
+    totalCount: 2,
+    score: 50,
+    generatedAt: '2024-01-01',
+});
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('handleGenerateChecklist', () => {
+    it('should return error when spec not found', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(null);
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-999',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should generate checklist without knowledge', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue(null);
+        vi.mocked(generateChecklist).mockReturnValue(makeChecklistResult());
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBeUndefined();
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.specId).toBe('SPEC-001');
+        expect(parsed.totalItems).toBeGreaterThan(0);
+        expect(parsed.checklist).toBeDefined();
+    });
+    it('should enrich checklist with knowledge and constitution', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ target: 'backend' }));
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({
+            database: 'postgresql',
+            testCommand: 'npm test',
+        });
+        vi.mocked(knowledgeStore.getConstitution).mockResolvedValue({
+            principles: [
+                { id: 'p-1', enforceLevel: 'strict', principle: 'Follow layered architecture' },
+                { id: 'p-2', enforceLevel: 'strict', principle: 'Use TypeScript' },
+                { id: 'p-3', enforceLevel: 'strict', principle: 'Write tests' },
+                { id: 'p-4', enforceLevel: 'recommended', principle: 'Use camelCase' },
+            ],
+        });
+        vi.mocked(generateChecklist).mockReturnValue(makeChecklistResult());
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        // Should have extra items from constitution (up to 3 strict) + db + test
+        expect(parsed.totalItems).toBeGreaterThan(2);
+    });
+    it('should pass focus parameter to engine', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue(null);
+        vi.mocked(generateChecklist).mockReturnValue(makeChecklistResult());
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            focus: ['security', 'completeness'],
+        });
+        expect(generateChecklist).toHaveBeenCalledWith(expect.anything(), ['security', 'completeness']);
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.focus).toEqual(['security', 'completeness']);
+    });
+    it('should calculate correct scores', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue(null);
+        vi.mocked(generateChecklist).mockReturnValue({
+            ...makeChecklistResult(),
+            items: [
+                { id: 'cl-1', question: 'Q1', category: 'completeness', answer: 'yes', autoChecked: true },
+                { id: 'cl-2', question: 'Q2', category: 'consistency', answer: 'no', autoChecked: false },
+                { id: 'cl-3', question: 'Q3', category: 'feasibility', answer: 'pending', autoChecked: false },
+            ],
+        });
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.passedItems).toBe(1);
+        expect(parsed.failedItems).toBe(1);
+        expect(parsed.pendingItems).toBe(1);
+        expect(parsed.score).toBe(33);
+    });
+    it('should handle errors gracefully', async () => {
+        vi.mocked(specStore.getSpec).mockRejectedValue(new Error('DB error'));
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should enrich with frontend target without DB check', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ target: 'frontend' }));
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({
+            database: 'postgresql',
+            testCommand: 'npm test',
+        });
+        vi.mocked(knowledgeStore.getConstitution).mockResolvedValue(null);
+        vi.mocked(generateChecklist).mockReturnValue(makeChecklistResult());
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        // Should NOT have DB migration check for frontend target
+        const allItems = Object.values(parsed.checklist).flat();
+        expect(allItems.some((item) => item.id === 'cl-db-1')).toBe(false);
+    });
+    it('should add testCommand item when knowledge has testCommand', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ target: 'frontend' }));
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({
+            database: 'unknown',
+            testCommand: 'vitest run',
+        });
+        vi.mocked(knowledgeStore.getConstitution).mockResolvedValue(null);
+        vi.mocked(generateChecklist).mockReturnValue(makeChecklistResult());
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        const allItems = Object.values(parsed.checklist).flat();
+        const testItem = allItems.find((item) => item.id === 'cl-test-1');
+        expect(testItem).toBeDefined();
+        expect(testItem?.question).toContain('vitest run');
+    });
+    it('should not add testCommand item when knowledge lacks testCommand', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ target: 'backend' }));
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue({
+            database: 'unknown',
+        });
+        vi.mocked(knowledgeStore.getConstitution).mockResolvedValue(null);
+        vi.mocked(generateChecklist).mockReturnValue(makeChecklistResult());
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        const allItems = Object.values(parsed.checklist).flat();
+        expect(allItems.some((item) => item.id === 'cl-test-1')).toBe(false);
+        // Score should be recalculated with only original items
+        expect(parsed.score).toBeDefined();
+    });
+    it('should return score zero when checklist has no items', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        vi.mocked(knowledgeStore.getKnowledge).mockResolvedValue(null);
+        vi.mocked(generateChecklist).mockReturnValue({
+            specId: 'SPEC-001',
+            items: [],
+            passedCount: 0,
+            totalCount: 0,
+            score: 0,
+            generatedAt: '2024-01-01',
+        });
+        const result = await handleGenerateChecklist({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.totalItems).toBe(0);
+        expect(parsed.score).toBe(0);
+    });
+});
+//# sourceMappingURL=generate-checklist.test.js.map

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

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