@llm-dev-ops/agentics-cli 1.4.25 → 1.4.27

package/dist/pipeline/phases/sparc-development.js

@@ -0,0 +1,262 @@
+/**
+ * Pipeline Phase 3: SPARC Development
+ *
+ * Runs the 5 SPARC phases (Specification, Pseudocode, Architecture,
+ * Refinement, Completion) using research output as input.
+ * Writes phase outputs to <run-dir>/sparc/.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export async function executeSPARCDevelopment(context) {
+    const start = Date.now();
+    const sparcDir = path.join(context.artifactsDir, 'sparc');
+    fs.mkdirSync(sparcDir, { recursive: true, mode: 0o700 });
+    const artifacts = [];
+    // Get research data and user feedback
+    const researchOutput = context.stageOutputs.get('deep-research');
+    const feedback = context.userFeedback.get('sparc-development') ?? [];
+    const researchData = researchOutput?.data;
+    const userContext = (researchData?.['user_context'] ?? context.userContext);
+    console.error('  Running SPARC development phases...');
+    console.error('');
+    // Phase 1: Specification
+    console.error('    [1/5] Specification...');
+    const specification = buildSpecification(context.query, userContext, researchData, feedback);
+    writePhaseFile(sparcDir, 'specification.json', specification);
+    artifacts.push('sparc/specification.json');
+    // Phase 2: Pseudocode
+    console.error('    [2/5] Pseudocode...');
+    const pseudocode = buildPseudocode(specification, userContext);
+    writePhaseFile(sparcDir, 'pseudocode.json', pseudocode);
+    artifacts.push('sparc/pseudocode.json');
+    // Phase 3: Architecture
+    console.error('    [3/5] Architecture...');
+    const architecture = buildArchitecture(specification, pseudocode, userContext);
+    writePhaseFile(sparcDir, 'architecture.json', architecture);
+    artifacts.push('sparc/architecture.json');
+    // Phase 4: Refinement
+    console.error('    [4/5] Refinement...');
+    const refinement = buildRefinement(architecture, specification, userContext);
+    writePhaseFile(sparcDir, 'refinement.json', refinement);
+    artifacts.push('sparc/refinement.json');
+    // Phase 5: Completion
+    console.error('    [5/5] Completion...');
+    const completion = buildCompletion(architecture, refinement, specification);
+    writePhaseFile(sparcDir, 'completion.json', completion);
+    artifacts.push('sparc/completion.json');
+    const sparcOutput = {
+        specification,
+        pseudocode,
+        architecture,
+        refinement,
+        completion,
+    };
+    // Write combined SPARC output
+    writePhaseFile(sparcDir, 'sparc-combined.json', sparcOutput);
+    artifacts.push('sparc/sparc-combined.json');
+    console.error('    SPARC phases complete.');
+    console.error('');
+    return {
+        stage: 'sparc-development',
+        status: 'completed',
+        data: sparcOutput,
+        artifacts,
+        timing: Date.now() - start,
+        summary: buildSPARCSummary(sparcOutput),
+    };
+}
+// ============================================================================
+// SPARC Phase Builders
+// ============================================================================
+function buildSpecification(query, userContext, _researchData, feedback) {
+    const erpSystem = String(userContext['erpSystem'] ?? 'not specified');
+    const techStack = userContext['techStack'] ?? [];
+    const timeline = String(userContext['timeline'] ?? 'to be determined');
+    // Extract requirements from simulation query and research
+    const requirements = [
+        `Implement solution for: ${query}`,
+        ...(erpSystem !== 'not specified' ? [`Integrate with ${erpSystem} ERP system`] : []),
+        ...(techStack.length > 0 ? [`Use technology stack: ${techStack.join(', ')}`] : []),
+        `Deliver within target timeline: ${timeline}`,
+    ];
+    const constraints = [
+        'Must maintain backward compatibility with existing systems',
+        ...(erpSystem !== 'not specified' ? [`Must interface with ${erpSystem} APIs and data formats`] : []),
+        'Must comply with enterprise security policies',
+        'Must support horizontal scaling',
+    ];
+    const successCriteria = [
+        'All automated tests pass with >90% coverage',
+        'Performance benchmarks meet defined SLAs',
+        'Security audit passes with no critical findings',
+        'Integration tests with ERP system succeed',
+    ];
+    // Incorporate feedback
+    if (feedback.length > 0) {
+        requirements.push(`[Revised per feedback]: ${feedback[feedback.length - 1]}`);
+    }
+    return {
+        requirements,
+        constraints,
+        successCriteria,
+        scope: query,
+    };
+}
+function buildPseudocode(spec, userContext) {
+    return {
+        algorithms: [
+            `// Main workflow for: ${spec.scope}`,
+            '// 1. Initialize system context and configuration',
+            '// 2. Validate input parameters and prerequisites',
+            '// 3. Execute core business logic',
+            '// 4. Handle integration with external systems',
+            '// 5. Persist results and emit domain events',
+            '// 6. Return structured response with audit trail',
+        ],
+        tddAnchors: [
+            'TEST: System initializes with valid configuration',
+            'TEST: Input validation rejects malformed data',
+            'TEST: Core logic produces expected output for known inputs',
+            'TEST: External system integration handles timeouts gracefully',
+            'TEST: Results are persisted atomically',
+            'TEST: Domain events are emitted in correct order',
+        ],
+        dataStructures: [
+            `Primary data model for ${spec.scope}`,
+            `Integration payload schema for ${String(userContext['erpSystem'] ?? 'external systems')}`,
+            'Audit trail record structure',
+            'Configuration schema with validation',
+        ],
+    };
+}
+function buildArchitecture(spec, _pseudocode, userContext) {
+    const erpSystem = String(userContext['erpSystem'] ?? 'external-system');
+    const techStack = userContext['techStack'] ?? ['Node.js'];
+    return {
+        services: [
+            {
+                name: 'api-gateway',
+                responsibility: 'Request routing, authentication, rate limiting',
+                api: ['POST /v1/execute', 'GET /v1/status', 'GET /v1/health'],
+                dependencies: ['core-service'],
+            },
+            {
+                name: 'core-service',
+                responsibility: `Core business logic for: ${spec.scope}`,
+                api: ['execute()', 'validate()', 'getStatus()'],
+                dependencies: ['data-service', 'integration-service'],
+            },
+            {
+                name: 'integration-service',
+                responsibility: `${erpSystem} integration and data synchronization`,
+                api: ['sync()', 'push()', 'pull()', 'mapSchema()'],
+                dependencies: ['data-service'],
+            },
+            {
+                name: 'data-service',
+                responsibility: 'Data persistence, caching, and retrieval',
+                api: ['store()', 'retrieve()', 'query()', 'audit()'],
+                dependencies: [],
+            },
+        ],
+        boundaries: [
+            `Core Domain: Business logic for ${spec.scope}`,
+            `Integration Layer: ${erpSystem} adapter with anti-corruption layer`,
+            `Presentation Layer: API gateway with ${techStack[0] ?? 'Node.js'}`,
+            'Infrastructure Layer: Data persistence and messaging',
+        ],
+        dataFlow: [
+            `Client -> API Gateway -> Core Service -> Integration Service -> ${erpSystem}`,
+            `${erpSystem} -> Integration Service -> Data Service -> Event Bus -> Audit Log`,
+        ].join('\n'),
+        apiContracts: [
+            'OpenAPI 3.0 specification for all service endpoints',
+            `${erpSystem} integration contract (inbound/outbound schemas)`,
+            'Event schema definitions for domain events',
+        ],
+    };
+}
+function buildRefinement(architecture, _spec, _userContext) {
+    return {
+        securityConsiderations: [
+            'Input validation on all API endpoints (Zod schemas)',
+            'Authentication via JWT with refresh token rotation',
+            'Authorization: claims-based access control (RBAC)',
+            'Data encryption at rest (AES-256) and in transit (TLS 1.3)',
+            'Audit logging for all state-changing operations',
+            'SQL injection prevention via parameterized queries',
+            'Rate limiting per API key and IP address',
+        ],
+        performanceTargets: [
+            'API response time: p95 < 200ms, p99 < 500ms',
+            'Throughput: 1000 requests/second per instance',
+            'Database query time: p95 < 50ms',
+            `Integration latency: p95 < 2s (depends on ${architecture.services[2]?.name ?? 'external'} system)`,
+            'Memory footprint: < 512MB per instance',
+        ],
+        testStrategy: [
+            'Unit tests: >90% line coverage, >80% branch coverage',
+            'Integration tests: All service boundaries tested',
+            'Contract tests: API schemas validated against consumers',
+            'Performance tests: Load testing with k6 or Artillery',
+            'Security tests: OWASP ZAP scan, dependency audit',
+        ].join('\n'),
+    };
+}
+function buildCompletion(architecture, _refinement, _spec) {
+    return {
+        integrationPlan: [
+            '1. Deploy data-service with schema migrations',
+            `2. Deploy integration-service with ${architecture.services[2]?.name ?? 'external'} adapter`,
+            '3. Deploy core-service with feature flags',
+            '4. Deploy api-gateway with canary routing',
+            '5. Run integration test suite',
+            '6. Enable monitoring and alerting',
+            '7. Gradual traffic migration (10% -> 50% -> 100%)',
+        ].join('\n'),
+        documentation: [
+            'API reference (auto-generated from OpenAPI spec)',
+            'Architecture decision records (ADRs)',
+            'Deployment runbook',
+            'Monitoring and alerting playbook',
+            'Integration guide for ERP system',
+        ],
+        monitoringSetup: [
+            'Health check endpoints on all services',
+            'Structured logging with correlation IDs',
+            'Metrics: request rate, latency, error rate, saturation',
+            'Alerts: SLO breach, error rate spike, latency degradation',
+            'Dashboard: service topology, request flow, error hotspots',
+        ],
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function writePhaseFile(dir, filename, data) {
+    const content = JSON.stringify(data, null, 2);
+    fs.writeFileSync(path.join(dir, filename), content, { mode: 0o600, encoding: 'utf-8' });
+}
+function buildSPARCSummary(sparc) {
+    return [
+        '  SPARC Development Summary:',
+        '',
+        `  Specification:`,
+        `    - ${sparc.specification.requirements.length} requirements`,
+        `    - ${sparc.specification.constraints.length} constraints`,
+        `    - ${sparc.specification.successCriteria.length} success criteria`,
+        '',
+        `  Architecture:`,
+        `    - ${sparc.architecture.services.length} services defined`,
+        `    - ${sparc.architecture.boundaries.length} bounded contexts`,
+        '',
+        `  Refinement:`,
+        `    - ${sparc.refinement.securityConsiderations.length} security items`,
+        `    - ${sparc.refinement.performanceTargets.length} performance targets`,
+        '',
+        `  Completion:`,
+        `    - ${sparc.completion.documentation.length} documentation items`,
+        `    - ${sparc.completion.monitoringSetup.length} monitoring items`,
+    ].join('\n');
+}
+//# sourceMappingURL=sparc-development.js.map

package/dist/pipeline/phases/sparc-development.js.map

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

package/dist/pipeline/pipeline-coordinator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pipeline Coordinator
+ *
+ * Orchestrates the 6-stage prototype-to-production pipeline.
+ * Supports two modes:
+ * - 'autonomous': Runs all stages end-to-end without stopping.
+ * - 'human-in-the-loop': Pauses at each stage for approval with revision loops.
+ */
+import type { PipelineContext, PipelineResult } from './types.js';
+/**
+ * Execute the full prototype-to-production pipeline.
+ *
+ * Stage 1 (Decision Gate): Always interactive — asks proceed y/n + mode selection.
+ * Stages 2-5 (Research, SPARC, ADR/DDD, Prompts):
+ *   - Autonomous: run straight through.
+ *   - HITL: run stage -> show results -> ask approval -> if no, get feedback, re-run, ask again.
+ * Stage 6 (RuvFlow Execution): Always runs without gate.
+ */
+export declare function executePipeline(context: PipelineContext): Promise<PipelineResult>;
+//# sourceMappingURL=pipeline-coordinator.d.ts.map

package/dist/pipeline/pipeline-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-coordinator.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAA8B,MAAM,YAAY,CAAC;AAkC9F;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAiFvF"}

package/dist/pipeline/pipeline-coordinator.js

@@ -0,0 +1,164 @@
+/**
+ * Pipeline Coordinator
+ *
+ * Orchestrates the 6-stage prototype-to-production pipeline.
+ * Supports two modes:
+ * - 'autonomous': Runs all stages end-to-end without stopping.
+ * - 'human-in-the-loop': Pauses at each stage for approval with revision loops.
+ */
+import { requestApproval } from './approval-gate.js';
+import { executeDecisionGate } from './phases/decision-gate.js';
+import { executeDeepResearch } from './phases/deep-research.js';
+import { executeSPARCDevelopment } from './phases/sparc-development.js';
+import { executeADRDDDGeneration } from './phases/adr-ddd-generator.js';
+import { executePromptGeneration } from './phases/prompt-generator.js';
+import { executeRuvFlowExecution } from './phases/ruvflow-executor.js';
+const STAGES = [
+    { id: 'prototype-decision', label: 'Prototype Decision', executor: executeDecisionGate, hasApprovalGate: false },
+    { id: 'deep-research', label: 'Deep Research', executor: executeDeepResearch, hasApprovalGate: true },
+    { id: 'sparc-development', label: 'SPARC Development', executor: executeSPARCDevelopment, hasApprovalGate: true },
+    { id: 'adr-ddd-generation', label: 'ADR & DDD Generation', executor: executeADRDDDGeneration, hasApprovalGate: true },
+    { id: 'prompt-generation', label: 'Prompt Generation', executor: executePromptGeneration, hasApprovalGate: true },
+    { id: 'ruvflow-execution', label: 'RuvFlow Execution', executor: executeRuvFlowExecution, hasApprovalGate: false },
+];
+// ============================================================================
+// Pipeline Executor
+// ============================================================================
+/**
+ * Execute the full prototype-to-production pipeline.
+ *
+ * Stage 1 (Decision Gate): Always interactive — asks proceed y/n + mode selection.
+ * Stages 2-5 (Research, SPARC, ADR/DDD, Prompts):
+ *   - Autonomous: run straight through.
+ *   - HITL: run stage -> show results -> ask approval -> if no, get feedback, re-run, ask again.
+ * Stage 6 (RuvFlow Execution): Always runs without gate.
+ */
+export async function executePipeline(context) {
+    const pipelineStart = Date.now();
+    const completedStages = [];
+    console.error('');
+    console.error('='.repeat(72));
+    console.error('  PROTOTYPE DEVELOPMENT PIPELINE');
+    console.error('='.repeat(72));
+    console.error('');
+    for (const stage of STAGES) {
+        console.error(`  >> Stage: ${stage.label}`);
+        console.error('');
+        let output;
+        try {
+            output = await stage.executor(context);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            output = {
+                stage: stage.id,
+                status: 'failed',
+                data: { error: errMsg },
+                artifacts: [],
+                timing: 0,
+                summary: `  ERROR: ${errMsg}`,
+            };
+        }
+        // Stage 1 (decision gate): if cancelled, stop pipeline
+        if (stage.id === 'prototype-decision') {
+            completedStages.push(output);
+            context.stageOutputs.set(stage.id, output);
+            if (output.status === 'cancelled') {
+                return buildPipelineResult(context, completedStages, 'cancelled', pipelineStart);
+            }
+            continue;
+        }
+        // If stage failed, stop pipeline
+        if (output.status === 'failed') {
+            completedStages.push(output);
+            context.stageOutputs.set(stage.id, output);
+            console.error(`  Stage "${stage.label}" failed. Pipeline halted.`);
+            return buildPipelineResult(context, completedStages, 'failed', pipelineStart);
+        }
+        // Stages 2-5 in HITL mode: approval gate with revision loop
+        if (stage.hasApprovalGate && context.mode === 'human-in-the-loop') {
+            output = await runApprovalLoop(stage, output, context);
+            // If cancelled during revision (shouldn't happen, but guard)
+            if (output.status === 'cancelled') {
+                completedStages.push(output);
+                context.stageOutputs.set(stage.id, output);
+                return buildPipelineResult(context, completedStages, 'cancelled', pipelineStart);
+            }
+        }
+        else {
+            // Autonomous mode or no-gate stage: just log and continue
+            console.error(output.summary);
+            console.error('');
+        }
+        completedStages.push(output);
+        context.stageOutputs.set(stage.id, output);
+    }
+    // Pipeline complete
+    console.error('');
+    console.error('='.repeat(72));
+    console.error('  PIPELINE COMPLETE');
+    console.error('='.repeat(72));
+    console.error('');
+    console.error(`  All artifacts written to: ${context.artifactsDir}`);
+    console.error(`  Mode: ${context.mode}`);
+    console.error(`  Total stages: ${completedStages.length}`);
+    console.error('');
+    return buildPipelineResult(context, completedStages, 'completed', pipelineStart);
+}
+// ============================================================================
+// Approval Loop
+// ============================================================================
+async function runApprovalLoop(stage, output, context) {
+    const MAX_REVISIONS = 10; // Safety limit
+    let revisions = 0;
+    while (revisions < MAX_REVISIONS) {
+        const approval = await requestApproval(stage.label, output.summary);
+        if (approval.approved) {
+            return output;
+        }
+        // User wants changes — record feedback and re-run
+        revisions++;
+        const feedback = approval.feedback ?? 'Unspecified changes requested';
+        console.error('');
+        console.error(`  Incorporating feedback (revision ${revisions}): ${feedback}`);
+        console.error('');
+        const existing = context.userFeedback.get(stage.id);
+        if (existing) {
+            existing.push(feedback);
+        }
+        else {
+            context.userFeedback.set(stage.id, [feedback]);
+        }
+        try {
+            output = await stage.executor(context);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            output = {
+                stage: stage.id,
+                status: 'failed',
+                data: { error: errMsg },
+                artifacts: [],
+                timing: 0,
+                summary: `  ERROR during revision: ${errMsg}`,
+            };
+            return output;
+        }
+    }
+    console.error(`  Maximum revisions (${MAX_REVISIONS}) reached. Proceeding with last output.`);
+    return output;
+}
+// ============================================================================
+// Result Builder
+// ============================================================================
+function buildPipelineResult(context, stages, finalStatus, startTime) {
+    return {
+        executionId: context.executionId,
+        mode: context.mode,
+        stages,
+        finalStatus,
+        outputDir: context.artifactsDir,
+        totalTiming: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=pipeline-coordinator.js.map

package/dist/pipeline/pipeline-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-coordinator.js","sourceRoot":"","sources":["../../src/pipeline/pipeline-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAcvE,MAAM,MAAM,GAAsB;IAChC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAK,QAAQ,EAAE,mBAAmB,EAAO,eAAe,EAAE,KAAK,EAAE;IACxH,EAAE,EAAE,EAAE,eAAe,EAAM,KAAK,EAAE,eAAe,EAAW,QAAQ,EAAE,mBAAmB,EAAQ,eAAe,EAAE,IAAI,EAAE;IACxH,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAO,QAAQ,EAAE,uBAAuB,EAAK,eAAe,EAAE,IAAI,EAAE;IACzH,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,sBAAsB,EAAG,QAAQ,EAAE,uBAAuB,EAAI,eAAe,EAAE,IAAI,EAAE;IACxH,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAO,QAAQ,EAAE,uBAAuB,EAAK,eAAe,EAAE,IAAI,EAAE;IACzH,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAO,QAAQ,EAAE,uBAAuB,EAAK,eAAe,EAAE,KAAK,EAAE;CAC3H,CAAC;AAEF,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAwB;IAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,eAAe,GAAkB,EAAE,CAAC;IAE1C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAClD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAElB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,eAAe,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAElB,IAAI,MAAmB,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,GAAG;gBACP,KAAK,EAAE,KAAK,CAAC,EAAE;gBACf,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;gBACvB,SAAS,EAAE,EAAE;gBACb,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,YAAY,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;QAED,uDAAuD;QACvD,IAAI,KAAK,CAAC,EAAE,KAAK,oBAAoB,EAAE,CAAC;YACtC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAE3C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,OAAO,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;YACnF,CAAC;YACD,SAAS;QACX,CAAC;QAED,iCAAiC;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,KAAK,4BAA4B,CAAC,CAAC;YACnE,OAAO,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAChF,CAAC;QAED,4DAA4D;QAC5D,IAAI,KAAK,CAAC,eAAe,IAAI,OAAO,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAClE,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAEvD,6DAA6D;YAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC3C,OAAO,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,0DAA0D;YAC1D,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QAED,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,oBAAoB;IACpB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACrC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,+BAA+B,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,mBAAmB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAElB,OAAO,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACnF,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,KAAK,UAAU,eAAe,CAC5B,KAAsB,EACtB,MAAmB,EACnB,OAAwB;IAExB,MAAM,aAAa,GAAG,EAAE,CAAC,CAAE,eAAe;IAC1C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,SAAS,GAAG,aAAa,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAEpE,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,kDAAkD;QAClD,SAAS,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,+BAA+B,CAAC;QAEtE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,sCAAsC,SAAS,MAAM,QAAQ,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAElB,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,GAAG;gBACP,KAAK,EAAE,KAAK,CAAC,EAAE;gBACf,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;gBACvB,SAAS,EAAE,EAAE;gBACb,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,4BAA4B,MAAM,EAAE;aAC9C,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,wBAAwB,aAAa,yCAAyC,CAAC,CAAC;IAC9F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,SAAS,mBAAmB,CAC1B,OAAwB,EACxB,MAAqB,EACrB,WAAiD,EACjD,SAAiB;IAEjB,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM;QACN,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACpC,CAAC;AACJ,CAAC"}

package/dist/pipeline/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Pipeline Types
+ *
+ * Type definitions for the prototype-to-production pipeline.
+ * Supports two modes: 'autonomous' (end-to-end) and 'human-in-the-loop' (approval gates).
+ */
+export type PipelineMode = 'autonomous' | 'human-in-the-loop';
+export type PipelineStage = 'prototype-decision' | 'deep-research' | 'sparc-development' | 'adr-ddd-generation' | 'prompt-generation' | 'ruvflow-execution';
+export type StageStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface PipelineContext {
+    /** Execution ID from ruvector or correlation ID */
+    executionId: string;
+    /** Original user query */
+    query: string;
+    /** Raw simulation result */
+    simulationResult: unknown;
+    /** Platform agent results (risk-score, executive-summary, decision-memo) */
+    platformAnalysis: unknown[];
+    /** Path to artifacts directory (~/.agentics/runs/<run-id>/) */
+    artifactsDir: string;
+    /** Pipeline mode: autonomous or human-in-the-loop */
+    mode: PipelineMode;
+    /** Accumulated outputs from completed stages */
+    stageOutputs: Map<PipelineStage, StageOutput>;
+    /** User feedback per stage (for revision loops in HITL mode) */
+    userFeedback: Map<PipelineStage, string[]>;
+    /** User-provided context from deep research questions */
+    userContext: UserContext;
+}
+export interface UserContext {
+    erpSystem?: string;
+    techStack?: string[];
+    teamSize?: string;
+    timeline?: string;
+    additionalNotes?: string;
+    [key: string]: unknown;
+}
+export interface StageOutput {
+    stage: PipelineStage;
+    status: StageStatus;
+    data: unknown;
+    /** File paths of artifacts written by this stage */
+    artifacts: string[];
+    timing: number;
+    /** Human-readable summary for approval gate display */
+    summary: string;
+}
+export interface ApprovalResult {
+    approved: boolean;
+    /** What needs to change (when not approved) */
+    feedback?: string;
+}
+export interface PipelineResult {
+    executionId: string;
+    mode: PipelineMode;
+    stages: StageOutput[];
+    finalStatus: StageStatus;
+    outputDir: string;
+    totalTiming: number;
+}
+export interface SPARCOutput {
+    specification: {
+        requirements: string[];
+        constraints: string[];
+        successCriteria: string[];
+        scope: string;
+    };
+    pseudocode: {
+        algorithms: string[];
+        tddAnchors: string[];
+        dataStructures: string[];
+    };
+    architecture: {
+        services: ServiceDefinition[];
+        boundaries: string[];
+        dataFlow: string;
+        apiContracts: string[];
+    };
+    refinement: {
+        securityConsiderations: string[];
+        performanceTargets: string[];
+        testStrategy: string;
+    };
+    completion: {
+        integrationPlan: string;
+        documentation: string[];
+        monitoringSetup: string[];
+    };
+}
+export interface ServiceDefinition {
+    name: string;
+    responsibility: string;
+    api: string[];
+    dependencies: string[];
+}
+export interface ADRRecord {
+    id: string;
+    title: string;
+    status: 'proposed' | 'accepted' | 'deprecated';
+    date: string;
+    context: string;
+    decision: string;
+    alternatives: string[];
+    consequences: string[];
+}
+export interface DDDBoundedContext {
+    name: string;
+    description: string;
+    aggregates: AggregateDefinition[];
+    domainEvents: string[];
+    commands: string[];
+    queries: string[];
+}
+export interface AggregateDefinition {
+    name: string;
+    root: string;
+    entities: string[];
+    valueObjects: string[];
+}
+export interface DomainModel {
+    contexts: DDDBoundedContext[];
+    contextMap: ContextRelation[];
+}
+export interface ContextRelation {
+    upstream: string;
+    downstream: string;
+    type: 'partnership' | 'customer-supplier' | 'conformist' | 'anticorruption-layer';
+}
+export interface ImplementationPrompt {
+    id: string;
+    title: string;
+    boundedContext: string;
+    relatedADRs: string[];
+    content: string;
+    dependencies: string[];
+    order: number;
+}
+export interface ExecutionPlan {
+    prompts: ImplementationPrompt[];
+    totalSteps: number;
+    estimatedDuration: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAE9D,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,eAAe,GACf,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAMvF,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,IAAI,EAAE,YAAY,CAAC;IACnB,gDAAgD;IAChD,YAAY,EAAE,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,gEAAgE;IAChE,YAAY,EAAE,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,yDAAyD;IACzD,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,YAAY,EAAE;QACZ,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,UAAU,EAAE;QACV,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,EAAE;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,GAAG,mBAAmB,GAAG,YAAY,GAAG,sBAAsB,CAAC;CACnF;AAMD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/dist/pipeline/types.js

@@ -0,0 +1,8 @@
+/**
+ * Pipeline Types
+ *
+ * Type definitions for the prototype-to-production pipeline.
+ * Supports two modes: 'autonomous' (end-to-end) and 'human-in-the-loop' (approval gates).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/runtime/claude-code-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code-runner.d.ts","sourceRoot":"","sources":["../../src/runtime/claude-code-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,sDAAsD,CAAC;AAgC9D;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;gBAEzB,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,cAAc,GAAG,kBAAkB,GAAG,eAAe,GAAG,gBAAgB,CAAC;QACnF,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QAC7C,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAsBF;AAwTD,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,2DAA2D;IAC3D,OAAO,CAAC,cAAc,CAAuB;IAE7C;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,MAAM;IAwEjB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAAC,CAAC,CAAC;CA6LvF;AA2JD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,CAK1D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}
+{"version":3,"file":"claude-code-runner.d.ts","sourceRoot":"","sources":["../../src/runtime/claude-code-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,sDAAsD,CAAC;AAgC9D;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;gBAEzB,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,cAAc,GAAG,kBAAkB,GAAG,eAAe,GAAG,gBAAgB,CAAC;QACnF,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QAC7C,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAsBF;AAwTD,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,2DAA2D;IAC3D,OAAO,CAAC,cAAc,CAAuB;IAE7C;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,MAAM;IAwEjB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAyLvF;AA2JD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,CAK1D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}