@llm-dev-ops/agentics-cli 1.4.26 → 1.4.29

package/dist/pipeline/phases/adr-ddd-generator.js

@@ -0,0 +1,310 @@
+/**
+ * Pipeline Phase 4: ADR & DDD Generation
+ *
+ * Takes SPARC output and generates:
+ * - Architecture Decision Records (ADRs) -> <run-dir>/adrs/
+ * - Domain-Driven Design artifacts (DDDs) -> <run-dir>/ddd/
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export async function executeADRDDDGeneration(context) {
+    const start = Date.now();
+    const artifacts = [];
+    const sparcOutput = context.stageOutputs.get('sparc-development');
+    const sparc = sparcOutput?.data;
+    const feedback = context.userFeedback.get('adr-ddd-generation') ?? [];
+    if (!sparc) {
+        return {
+            stage: 'adr-ddd-generation',
+            status: 'failed',
+            data: { error: 'SPARC output not available' },
+            artifacts: [],
+            timing: Date.now() - start,
+            summary: '  ERROR: SPARC output not available. Cannot generate ADRs/DDDs.',
+        };
+    }
+    console.error('  Generating Architecture Decision Records...');
+    // ========================================================================
+    // Generate ADRs
+    // ========================================================================
+    const adrDir = path.join(context.artifactsDir, 'adrs');
+    fs.mkdirSync(adrDir, { recursive: true, mode: 0o700 });
+    const adrs = generateADRs(sparc, context.query, feedback);
+    for (const adr of adrs) {
+        const filename = `${adr.id}-${slugify(adr.title)}.md`;
+        const content = renderADRMarkdown(adr);
+        fs.writeFileSync(path.join(adrDir, filename), content, { mode: 0o600, encoding: 'utf-8' });
+        artifacts.push(`adrs/${filename}`);
+        console.error(`    [ADR] ${adr.id}: ${adr.title}`);
+    }
+    console.error('');
+    console.error('  Generating Domain-Driven Design artifacts...');
+    // ========================================================================
+    // Generate DDD
+    // ========================================================================
+    const dddDir = path.join(context.artifactsDir, 'ddd');
+    const contextsDir = path.join(dddDir, 'contexts');
+    fs.mkdirSync(contextsDir, { recursive: true, mode: 0o700 });
+    const domainModel = generateDomainModel(sparc, context.query, feedback);
+    // Write domain model
+    const modelContent = JSON.stringify(domainModel, null, 2);
+    fs.writeFileSync(path.join(dddDir, 'domain-model.json'), modelContent, { mode: 0o600, encoding: 'utf-8' });
+    artifacts.push('ddd/domain-model.json');
+    // Write individual bounded context files
+    for (const ctx of domainModel.contexts) {
+        const filename = `${slugify(ctx.name)}.json`;
+        const ctxContent = JSON.stringify(ctx, null, 2);
+        fs.writeFileSync(path.join(contextsDir, filename), ctxContent, { mode: 0o600, encoding: 'utf-8' });
+        artifacts.push(`ddd/contexts/${filename}`);
+        console.error(`    [DDD] Context: ${ctx.name}`);
+    }
+    console.error('');
+    return {
+        stage: 'adr-ddd-generation',
+        status: 'completed',
+        data: { adrs, domainModel },
+        artifacts,
+        timing: Date.now() - start,
+        summary: buildADRDDDSummary(adrs, domainModel),
+    };
+}
+// ============================================================================
+// ADR Generation
+// ============================================================================
+function generateADRs(sparc, query, feedback) {
+    const now = new Date().toISOString().split('T')[0] ?? new Date().toISOString();
+    const adrs = [];
+    // ADR 1: Architecture Style
+    adrs.push({
+        id: 'ADR-001',
+        title: 'Architecture Style Selection',
+        status: 'proposed',
+        date: now,
+        context: `The system "${query}" requires a scalable, maintainable architecture. The SPARC analysis identified ${sparc.architecture.services.length} services with distinct responsibilities.`,
+        decision: `Adopt a microservices architecture with ${sparc.architecture.services.length} services: ${sparc.architecture.services.map(s => s.name).join(', ')}. Services communicate via REST APIs with async event-driven integration where appropriate.`,
+        alternatives: [
+            'Monolithic architecture — simpler but harder to scale independently',
+            'Serverless functions — lower cost at low scale but cold start concerns',
+            'Modular monolith — compromise between simplicity and separation',
+        ],
+        consequences: [
+            'Each service can be deployed and scaled independently',
+            'Increased operational complexity (more services to monitor)',
+            'Requires service discovery and API gateway',
+            'Team can work on services in parallel',
+        ],
+    });
+    // ADR 2: Integration Strategy
+    const integrationService = sparc.architecture.services.find(s => s.name.includes('integration'));
+    if (integrationService) {
+        adrs.push({
+            id: 'ADR-002',
+            title: 'ERP Integration Strategy',
+            status: 'proposed',
+            date: now,
+            context: `Integration with external ERP systems is a core requirement. The ${integrationService.name} service handles bidirectional data synchronization.`,
+            decision: `Use an Anti-Corruption Layer (ACL) pattern via ${integrationService.name}. External data formats are translated at the boundary, keeping the core domain model clean.`,
+            alternatives: [
+                'Direct API integration — simpler but couples core to external schemas',
+                'ETL pipeline — batch processing but higher latency',
+                'Event sourcing bridge — complex but provides full audit trail',
+            ],
+            consequences: [
+                'Core domain model remains independent of external schemas',
+                'Schema changes in ERP only affect the ACL adapter',
+                'Bidirectional sync requires conflict resolution strategy',
+                'Additional translation overhead per request',
+            ],
+        });
+    }
+    // ADR 3: Security Architecture
+    adrs.push({
+        id: 'ADR-003',
+        title: 'Security Architecture',
+        status: 'proposed',
+        date: now,
+        context: `Enterprise security requirements mandate: ${sparc.refinement.securityConsiderations.slice(0, 3).join('; ')}.`,
+        decision: `Implement defense-in-depth: JWT authentication with refresh tokens, claims-based RBAC authorization, input validation via Zod schemas at all boundaries, TLS 1.3 for all communications, AES-256 encryption at rest.`,
+        alternatives: [
+            'Session-based auth — simpler but not suitable for microservices',
+            'OAuth2 only — standard but requires identity provider setup',
+            'mTLS between services — more secure but complex certificate management',
+        ],
+        consequences: [
+            'Strong authentication and authorization model',
+            'Token management adds complexity to client implementations',
+            'Audit trail captures all security-relevant events',
+            'Compliance with common enterprise security frameworks',
+        ],
+    });
+    // ADR 4: Data Management
+    adrs.push({
+        id: 'ADR-004',
+        title: 'Data Management Strategy',
+        status: 'proposed',
+        date: now,
+        context: `Each service requires its own data management. The system must support both transactional operations and analytical queries.`,
+        decision: `Database-per-service pattern. Each service owns its data store. Use event-driven synchronization for cross-service data needs. Implement CQRS where read and write patterns diverge significantly.`,
+        alternatives: [
+            'Shared database — simpler but creates tight coupling',
+            'Single event store — unified audit trail but complex querying',
+            'Data mesh — domain-oriented but requires mature data platform',
+        ],
+        consequences: [
+            'Services are fully decoupled at the data layer',
+            'Cross-service queries require event-driven materialized views',
+            'Each service can choose optimal storage technology',
+            'Data consistency is eventual (not immediate) across services',
+        ],
+    });
+    // ADR 5: Deployment Strategy (from SPARC completion)
+    adrs.push({
+        id: 'ADR-005',
+        title: 'Deployment and Release Strategy',
+        status: 'proposed',
+        date: now,
+        context: `The integration plan calls for phased deployment: ${sparc.completion.integrationPlan.split('\n').slice(0, 2).join('; ')}.`,
+        decision: `Adopt GitOps with canary deployments. Use feature flags for gradual rollout (10% -> 50% -> 100%). Each service has independent CI/CD pipeline with automated testing gates.`,
+        alternatives: [
+            'Blue-green deployment — simpler but doubles infrastructure cost',
+            'Rolling update — standard but limited rollback capability',
+            'A/B testing deployment — useful for UX but complex for backend',
+        ],
+        consequences: [
+            'Zero-downtime deployments with automated rollback',
+            'Feature flags enable controlled exposure to new functionality',
+            'Independent service deployment allows faster iteration',
+            'Requires investment in deployment tooling and monitoring',
+        ],
+    });
+    // Incorporate feedback into the last ADR
+    if (feedback.length > 0) {
+        adrs.push({
+            id: `ADR-${String(adrs.length + 1).padStart(3, '0')}`,
+            title: 'Feedback-Driven Adjustments',
+            status: 'proposed',
+            date: now,
+            context: `Stakeholder feedback identified areas for revision: ${feedback[feedback.length - 1]}`,
+            decision: `Incorporate the following changes based on feedback: ${feedback[feedback.length - 1]}`,
+            alternatives: ['Maintain original design without changes'],
+            consequences: ['Design better aligned with stakeholder expectations', 'May require additional iteration'],
+        });
+    }
+    return adrs;
+}
+// ============================================================================
+// DDD Generation
+// ============================================================================
+function generateDomainModel(sparc, _query, feedback) {
+    const contexts = [];
+    // Map each architecture service to a bounded context
+    for (const service of sparc.architecture.services) {
+        contexts.push({
+            name: service.name,
+            description: service.responsibility,
+            aggregates: [
+                {
+                    name: `${pascalCase(service.name)}Aggregate`,
+                    root: `${pascalCase(service.name)}Root`,
+                    entities: service.api.map((_, i) => `${pascalCase(service.name)}Entity${i + 1}`),
+                    valueObjects: [`${pascalCase(service.name)}Config`, `${pascalCase(service.name)}Status`],
+                },
+            ],
+            domainEvents: [
+                `${pascalCase(service.name)}Created`,
+                `${pascalCase(service.name)}Updated`,
+                `${pascalCase(service.name)}Completed`,
+                `${pascalCase(service.name)}Failed`,
+            ],
+            commands: service.api.filter(a => !a.startsWith('get') && !a.startsWith('GET')).map(a => `Execute${pascalCase(a.split('(')[0] ?? a)}`),
+            queries: service.api.filter(a => a.startsWith('get') || a.startsWith('GET')).map(a => `Query${pascalCase(a.split('(')[0] ?? a)}`),
+        });
+    }
+    // Add feedback-driven context if applicable
+    if (feedback.length > 0) {
+        const lastCtx = contexts[contexts.length - 1];
+        if (lastCtx) {
+            lastCtx.description += ` [Revised: ${feedback[feedback.length - 1]}]`;
+        }
+    }
+    // Build context map
+    const contextMap = buildContextMap(contexts);
+    return { contexts, contextMap };
+}
+function buildContextMap(contexts) {
+    const relations = [];
+    // API gateway is upstream to core
+    const gateway = contexts.find(c => c.name.includes('gateway'));
+    const core = contexts.find(c => c.name.includes('core'));
+    const integration = contexts.find(c => c.name.includes('integration'));
+    const data = contexts.find(c => c.name.includes('data'));
+    if (gateway && core) {
+        relations.push({ upstream: gateway.name, downstream: core.name, type: 'customer-supplier' });
+    }
+    if (core && integration) {
+        relations.push({ upstream: core.name, downstream: integration.name, type: 'anticorruption-layer' });
+    }
+    if (core && data) {
+        relations.push({ upstream: core.name, downstream: data.name, type: 'partnership' });
+    }
+    if (integration && data) {
+        relations.push({ upstream: integration.name, downstream: data.name, type: 'customer-supplier' });
+    }
+    return relations;
+}
+// ============================================================================
+// Renderers
+// ============================================================================
+function renderADRMarkdown(adr) {
+    return [
+        `# ${adr.id}: ${adr.title}`,
+        '',
+        `**Status:** ${adr.status}`,
+        `**Date:** ${adr.date}`,
+        '',
+        '## Context',
+        '',
+        adr.context,
+        '',
+        '## Decision',
+        '',
+        adr.decision,
+        '',
+        '## Alternatives Considered',
+        '',
+        ...adr.alternatives.map(a => `- ${a}`),
+        '',
+        '## Consequences',
+        '',
+        ...adr.consequences.map(c => `- ${c}`),
+        '',
+    ].join('\n');
+}
+function buildADRDDDSummary(adrs, model) {
+    return [
+        '  ADR & DDD Generation Summary:',
+        '',
+        '  Architecture Decision Records:',
+        ...adrs.map(a => `    - ${a.id}: ${a.title} (${a.status})`),
+        '',
+        '  Domain-Driven Design:',
+        `    - ${model.contexts.length} bounded contexts`,
+        ...model.contexts.map(c => `      - ${c.name}: ${c.aggregates.length} aggregate(s), ${c.domainEvents.length} event(s)`),
+        `    - ${model.contextMap.length} context relationships`,
+    ].join('\n');
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function slugify(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
+}
+function pascalCase(text) {
+    return text
+        .replace(/[^a-zA-Z0-9]/g, ' ')
+        .split(' ')
+        .filter(Boolean)
+        .map(w => (w[0]?.toUpperCase() ?? '') + w.slice(1))
+        .join('');
+}
+//# sourceMappingURL=adr-ddd-generator.js.map

package/dist/pipeline/phases/adr-ddd-generator.js.map

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

package/dist/pipeline/phases/decision-gate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pipeline Phase 1: Decision Gate
+ *
+ * Displays simulation summary and asks the user whether to proceed
+ * to prototype development. In autonomous mode, auto-proceeds.
+ */
+import type { PipelineContext, StageOutput } from '../types.js';
+export declare function executeDecisionGate(context: PipelineContext): Promise<StageOutput>;
+//# sourceMappingURL=decision-gate.d.ts.map

package/dist/pipeline/phases/decision-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-gate.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phases/decision-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGhE,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CAqEtB"}

package/dist/pipeline/phases/decision-gate.js

@@ -0,0 +1,69 @@
+/**
+ * Pipeline Phase 1: Decision Gate
+ *
+ * Displays simulation summary and asks the user whether to proceed
+ * to prototype development. In autonomous mode, auto-proceeds.
+ */
+import { requestModeSelection } from '../approval-gate.js';
+export async function executeDecisionGate(context) {
+    const start = Date.now();
+    console.error('');
+    console.error('='.repeat(72));
+    console.error('  SIMULATION COMPLETE');
+    console.error('='.repeat(72));
+    console.error('');
+    console.error(`  Query:     ${context.query}`);
+    console.error(`  Artifacts: ${context.artifactsDir}`);
+    console.error('');
+    console.error('  Would you like to proceed to developing a prototype for this solution?');
+    console.error('  This will run: Deep Research -> SPARC -> ADR/DDD -> Prompts -> Implementation');
+    console.error('');
+    // If mode is already set (e.g. via --pipeline flag), skip the prompt
+    if (context.mode !== 'autonomous' && context.mode !== 'human-in-the-loop') {
+        // Should not happen with proper typing, but handle gracefully
+        context.mode = 'human-in-the-loop';
+    }
+    // Ask user to choose mode
+    const readline = await import('node:readline');
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stderr,
+        terminal: process.stdin.isTTY ?? false,
+    });
+    const answer = await new Promise(resolve => {
+        rl.question('  Proceed to prototype? (y/n): ', ans => {
+            rl.close();
+            resolve(ans.trim());
+        });
+    });
+    if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
+        console.error('');
+        console.error('  Pipeline cancelled. Your simulation artifacts are available at:');
+        console.error(`  ${context.artifactsDir}`);
+        console.error('');
+        return {
+            stage: 'prototype-decision',
+            status: 'cancelled',
+            data: { userDecision: 'no' },
+            artifacts: [],
+            timing: Date.now() - start,
+            summary: 'User declined to proceed to prototype development.',
+        };
+    }
+    // User wants to proceed — ask about mode
+    const mode = await requestModeSelection();
+    context.mode = mode;
+    console.error('');
+    console.error(`  Mode selected: ${mode === 'autonomous' ? 'Autonomous (end-to-end)' : 'Human-in-the-Loop (approval gates)'}`);
+    console.error('  Starting pipeline...');
+    console.error('');
+    return {
+        stage: 'prototype-decision',
+        status: 'completed',
+        data: { userDecision: 'yes', mode },
+        artifacts: [],
+        timing: Date.now() - start,
+        summary: `User approved prototype development in ${mode} mode.`,
+    };
+}
+//# sourceMappingURL=decision-gate.js.map

package/dist/pipeline/phases/decision-gate.js.map

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

package/dist/pipeline/phases/deep-research.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pipeline Phase 2: Deep Research
+ *
+ * Asks user about tech stack / ERP, then dispatches research agents
+ * in parallel to gather technical feasibility, market analysis, etc.
+ * Writes research-report.json to the run directory.
+ */
+import type { PipelineContext, StageOutput } from '../types.js';
+export declare function executeDeepResearch(context: PipelineContext): Promise<StageOutput>;
+//# sourceMappingURL=deep-research.d.ts.map

package/dist/pipeline/phases/deep-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-research.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phases/deep-research.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGhE,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CA6FtB"}

package/dist/pipeline/phases/deep-research.js

@@ -0,0 +1,161 @@
+/**
+ * Pipeline Phase 2: Deep Research
+ *
+ * Asks user about tech stack / ERP, then dispatches research agents
+ * in parallel to gather technical feasibility, market analysis, etc.
+ * Writes research-report.json to the run directory.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { askTechStackQuestions } from '../approval-gate.js';
+export async function executeDeepResearch(context) {
+    const start = Date.now();
+    const artifacts = [];
+    // Step 1: Gather user context (always ask, even in autonomous mode)
+    let userAnswers = {};
+    const existingFeedback = context.userFeedback.get('deep-research') ?? [];
+    if (existingFeedback.length === 0) {
+        // First run — ask tech stack questions
+        userAnswers = await askTechStackQuestions();
+        context.userContext = {
+            ...context.userContext,
+            erpSystem: userAnswers['erpSystem'],
+            techStack: userAnswers['techStack']?.split(',').map(s => s.trim()),
+            teamSize: userAnswers['teamSize'],
+            timeline: userAnswers['timeline'],
+            additionalNotes: userAnswers['additionalNotes'],
+        };
+    }
+    else {
+        console.error('');
+        console.error('  Re-running research with your feedback incorporated...');
+        console.error(`  Feedback: ${existingFeedback[existingFeedback.length - 1]}`);
+        console.error('');
+    }
+    // Step 2: Dispatch research agents in parallel
+    console.error('  Dispatching research agents...');
+    const researchAgents = [
+        { domain: 'copilot', agent: 'planner', task: 'Task decomposition' },
+        { domain: 'copilot', agent: 'decomposer', task: 'Solution breakdown' },
+        { domain: 'research-lab', agent: 'hypothesis', task: 'Technical feasibility' },
+        { domain: 'research-lab', agent: 'metrics', task: 'KPI analysis' },
+    ];
+    const researchResults = [];
+    // Try to dispatch via the existing agent infrastructure
+    for (const agentSpec of researchAgents) {
+        try {
+            // Dynamic import to avoid circular dependencies
+            const { AGENT_DOMAINS } = await import('../../commands/agents.js');
+            const { loadEndpointConfig } = await import('../../config/endpoints.js');
+            const { createAdapter } = await import('../../adapters/base-adapter.js');
+            const domainConfig = AGENT_DOMAINS[agentSpec.domain];
+            if (!domainConfig) {
+                researchResults.push({
+                    ...agentSpec,
+                    result: { error: `Domain not found: ${agentSpec.domain}` },
+                });
+                continue;
+            }
+            const config = loadEndpointConfig(domainConfig.serviceName);
+            const adapter = createAdapter(domainConfig.serviceName, config, context.executionId);
+            const payload = buildResearchPayload(context, agentSpec.agent, existingFeedback);
+            const response = await adapter.invoke({
+                endpoint: `/v1/${agentSpec.domain}/${agentSpec.agent}`,
+                method: 'POST',
+                headers: {},
+                body: payload,
+            });
+            researchResults.push({ ...agentSpec, result: response.body });
+            console.error(`    [OK] ${agentSpec.domain}/${agentSpec.agent}: ${agentSpec.task}`);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            researchResults.push({ ...agentSpec, result: { error: errMsg } });
+            console.error(`    [SKIP] ${agentSpec.domain}/${agentSpec.agent}: ${errMsg.slice(0, 80)}`);
+        }
+    }
+    // Step 3: Build research report
+    const report = buildResearchReport(context, researchResults, existingFeedback);
+    const reportContent = JSON.stringify(report, null, 2);
+    const reportPath = path.join(context.artifactsDir, 'research-report.json');
+    fs.writeFileSync(reportPath, reportContent, { mode: 0o600, encoding: 'utf-8' });
+    artifacts.push('research-report.json');
+    // Build summary for approval gate
+    const summary = buildResearchSummary(report);
+    return {
+        stage: 'deep-research',
+        status: 'completed',
+        data: report,
+        artifacts,
+        timing: Date.now() - start,
+        summary,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function buildResearchPayload(context, _agent, feedback) {
+    return {
+        objective: context.query,
+        context: {
+            erp_system: context.userContext.erpSystem ?? 'not specified',
+            tech_stack: context.userContext.techStack ?? [],
+            team_size: context.userContext.teamSize ?? 'not specified',
+            timeline: context.userContext.timeline ?? 'not specified',
+            additional_notes: context.userContext.additionalNotes ?? '',
+        },
+        simulation_results: context.simulationResult,
+        feedback: feedback.length > 0 ? feedback : undefined,
+    };
+}
+function buildResearchReport(context, results, feedback) {
+    const successful = results.filter(r => {
+        const res = r.result;
+        return !res['error'];
+    });
+    return {
+        metadata: {
+            created_at: new Date().toISOString(),
+            query: context.query,
+            revision: feedback.length,
+        },
+        user_context: context.userContext,
+        agent_results: results.map(r => ({
+            domain: r.domain,
+            agent: r.agent,
+            task: r.task,
+            status: r.result['error'] ? 'error' : 'success',
+            data: r.result,
+        })),
+        synthesis: {
+            agents_succeeded: successful.length,
+            agents_total: results.length,
+            feedback_incorporated: feedback,
+        },
+    };
+}
+function buildResearchSummary(report) {
+    const synthesis = report['synthesis'];
+    const userCtx = report['user_context'];
+    const lines = [
+        '  Research Summary:',
+        '',
+        `  - Agents queried: ${synthesis['agents_total']} (${synthesis['agents_succeeded']} succeeded)`,
+    ];
+    if (userCtx) {
+        if (userCtx['erpSystem'])
+            lines.push(`  - ERP System: ${userCtx['erpSystem']}`);
+        if (userCtx['techStack'])
+            lines.push(`  - Tech Stack: ${Array.isArray(userCtx['techStack']) ? userCtx['techStack'].join(', ') : userCtx['techStack']}`);
+        if (userCtx['teamSize'])
+            lines.push(`  - Team Size: ${userCtx['teamSize']}`);
+        if (userCtx['timeline'])
+            lines.push(`  - Timeline: ${userCtx['timeline']}`);
+    }
+    const revisions = synthesis['feedback_incorporated'];
+    if (revisions && revisions.length > 0) {
+        lines.push(`  - Revisions incorporated: ${revisions.length}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=deep-research.js.map

package/dist/pipeline/phases/deep-research.js.map

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

package/dist/pipeline/phases/prompt-generator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pipeline Phase 5: Prompt Generation
+ *
+ * Combines ADRs and DDDs into implementation prompts for RuvFlow.
+ * Each bounded context + its related ADRs = one implementation prompt.
+ * Writes to <run-dir>/prompts/.
+ */
+import type { PipelineContext, StageOutput } from '../types.js';
+export declare function executePromptGeneration(context: PipelineContext): Promise<StageOutput>;
+//# sourceMappingURL=prompt-generator.d.ts.map

package/dist/pipeline/phases/prompt-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phases/prompt-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EAMZ,MAAM,aAAa,CAAC;AAErB,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CA8DtB"}