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

package/dist/pipeline/phase2/phases/research-dossier.js

@@ -0,0 +1,601 @@
+/**
+ * Phase 2 Stage 2 — Research Dossier Generation
+ *
+ * Pure extraction and cross-referencing engine that builds a structured
+ * research dossier from Phase 1 artifacts. All extraction is deterministic:
+ * sources are processed in a fixed order, items are sorted by category
+ * within each source, IDs are assigned sequentially, and cross-references
+ * are sorted by fromId then toId.
+ *
+ * Exports:
+ *  - generateResearchDossier(context)  — async pipeline entry point
+ *  - buildResearchDossier(artifacts, traceId) — pure, testable extraction
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ResearchDossierSchema } from '../schemas.js';
+import { createSpan, endSpan, emitSpan } from '../telemetry.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const FILE_MODE = 0o600;
+const DOSSIER_FILENAME = 'research-dossier.json';
+/**
+ * Fixed processing order for deterministic output. Sources are processed
+ * in this exact sequence; items within each source are sorted by category.
+ */
+const SOURCE_ORDER = [
+    'scenario',
+    'roadmap',
+    'risk-assessment',
+    'executive-summary',
+    'decision-memo',
+];
+/**
+ * Category sort order for deterministic within-source ordering.
+ * Lower index = earlier in the output.
+ */
+const CATEGORY_ORDER = [
+    'requirement',
+    'constraint',
+    'stakeholder',
+    'success-criterion',
+    'timeline',
+    'risk',
+    'recommendation',
+    'decision-rationale',
+];
+// ============================================================================
+// Safe accessor helpers
+// ============================================================================
+function safeStringArray(obj, key) {
+    if (!obj || typeof obj !== 'object')
+        return [];
+    const val = obj[key];
+    return Array.isArray(val) ? val.filter((v) => typeof v === 'string') : [];
+}
+function safeString(obj, key, fallback = '') {
+    if (!obj || typeof obj !== 'object')
+        return fallback;
+    const val = obj[key];
+    return typeof val === 'string' ? val : fallback;
+}
+// ============================================================================
+// Markdown helpers
+// ============================================================================
+/**
+ * Extract the body text below a level-2 heading, up to the next level-2
+ * heading or end of file.
+ *
+ * @param md      - Full markdown text
+ * @param heading - Heading text without the `## ` prefix
+ * @returns Trimmed section body, or empty string if not found
+ */
+function extractMarkdownSection(md, heading) {
+    const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`## ${escaped}\\s*\\n([\\s\\S]*?)(?=\\n## |$)`);
+    const match = re.exec(md);
+    return match?.[1]?.trim() ?? '';
+}
+/**
+ * Extract items from bulleted or numbered list lines.
+ * Matches lines starting with `- `, `* `, or `N. `.
+ *
+ * @param text - Text potentially containing list items
+ * @returns Array of trimmed item texts (no bullet/number prefix)
+ */
+function extractListItems(text) {
+    const items = [];
+    const re = /^(?:[-*]|\d+\.)\s+(.+)$/gm;
+    let match;
+    while ((match = re.exec(text)) !== null) {
+        const item = match[1]?.trim();
+        if (item) {
+            items.push(item);
+        }
+    }
+    return items;
+}
+/**
+ * Truncate a string to `max` characters. If truncated, no ellipsis is added;
+ * the caller decides how to present it.
+ */
+function truncate(text, max) {
+    return text.length <= max ? text : text.slice(0, max);
+}
+function extractFromScenario(scenario) {
+    const items = [];
+    // Stakeholders
+    const stakeholders = safeStringArray(scenario, 'stakeholders');
+    for (const name of stakeholders) {
+        items.push({
+            source: 'scenario',
+            category: 'stakeholder',
+            title: name,
+            content: `Key stakeholder: ${name}`,
+        });
+    }
+    // Constraints
+    const constraints = safeStringArray(scenario, 'constraints');
+    for (const c of constraints) {
+        items.push({
+            source: 'scenario',
+            category: 'constraint',
+            title: truncate(c, 60),
+            content: c,
+        });
+    }
+    // Success criteria
+    const criteria = safeStringArray(scenario, 'success_criteria');
+    for (const sc of criteria) {
+        items.push({
+            source: 'scenario',
+            category: 'success-criterion',
+            title: truncate(sc, 60),
+            content: sc,
+        });
+    }
+    // Scenario type → requirement
+    const scenarioType = safeString(scenario, 'scenario_type');
+    const query = safeString(scenario, 'query');
+    if (scenarioType) {
+        items.push({
+            source: 'scenario',
+            category: 'requirement',
+            title: `Domain: ${scenarioType}`,
+            content: query || scenarioType,
+        });
+    }
+    return items;
+}
+function extractFromRoadmap(roadmap) {
+    const items = [];
+    const phases = Array.isArray(roadmap.phases) ? roadmap.phases : [];
+    for (const phase of phases) {
+        const phaseName = safeString(phase, 'name', 'Unknown Phase');
+        const deliverables = safeStringArray(phase, 'deliverables');
+        for (const d of deliverables) {
+            items.push({
+                source: 'roadmap',
+                category: 'timeline',
+                title: truncate(d, 60),
+                content: d,
+                phase: phaseName,
+            });
+        }
+    }
+    return items;
+}
+function extractFromRiskAssessment(risk) {
+    const items = [];
+    const factors = Array.isArray(risk.risk_factors) ? risk.risk_factors : [];
+    for (const rf of factors) {
+        const severity = safeString(rf, 'severity', 'unknown');
+        const category = safeString(rf, 'category', 'general');
+        const description = safeString(rf, 'description', '');
+        items.push({
+            source: 'risk-assessment',
+            category: 'risk',
+            title: `[${severity.toUpperCase()}] ${category}: ${description.slice(0, 50)}`,
+            content: description,
+            severity,
+        });
+    }
+    // Recommendations (top-level array on the risk assessment object)
+    const recommendations = safeStringArray(risk, 'recommendations');
+    for (const rec of recommendations) {
+        items.push({
+            source: 'risk-assessment',
+            category: 'recommendation',
+            title: truncate(rec, 60),
+            content: rec,
+        });
+    }
+    return items;
+}
+function extractFromExecutiveSummary(md) {
+    const items = [];
+    // Key Findings
+    const findings = extractMarkdownSection(md, 'Key Findings');
+    if (findings) {
+        for (const f of extractListItems(findings)) {
+            items.push({
+                source: 'executive-summary',
+                category: 'recommendation',
+                title: f,
+                content: f,
+            });
+        }
+    }
+    // Risk Factors (from executive summary, distinct from risk-assessment)
+    const riskSection = extractMarkdownSection(md, 'Risk Factors');
+    if (riskSection) {
+        for (const r of extractListItems(riskSection)) {
+            items.push({
+                source: 'executive-summary',
+                category: 'recommendation',
+                title: r,
+                content: r,
+            });
+        }
+    }
+    // Recommendation
+    const recommendation = extractMarkdownSection(md, 'Recommendation');
+    if (recommendation) {
+        for (const r of extractListItems(recommendation)) {
+            items.push({
+                source: 'executive-summary',
+                category: 'recommendation',
+                title: r,
+                content: r,
+            });
+        }
+        // If no list items but section has content, treat entire section as one item
+        if (extractListItems(recommendation).length === 0 && recommendation.length > 0) {
+            items.push({
+                source: 'executive-summary',
+                category: 'recommendation',
+                title: truncate(recommendation, 60),
+                content: recommendation,
+            });
+        }
+    }
+    // Next Steps
+    const nextSteps = extractMarkdownSection(md, 'Next Steps');
+    if (nextSteps) {
+        for (const step of extractListItems(nextSteps)) {
+            items.push({
+                source: 'executive-summary',
+                category: 'recommendation',
+                title: `Next Step: ${step}`,
+                content: step,
+            });
+        }
+    }
+    return items;
+}
+function extractFromDecisionMemo(md) {
+    const items = [];
+    // Decision section
+    const decision = extractMarkdownSection(md, 'Decision');
+    if (decision) {
+        items.push({
+            source: 'decision-memo',
+            category: 'decision-rationale',
+            title: 'Primary Decision',
+            content: decision,
+        });
+    }
+    // Rationale numbered items
+    const rationale = extractMarkdownSection(md, 'Rationale');
+    if (rationale) {
+        for (const item of extractListItems(rationale)) {
+            items.push({
+                source: 'decision-memo',
+                category: 'decision-rationale',
+                title: item,
+                content: item,
+            });
+        }
+    }
+    // Alternatives Considered
+    const alternatives = extractMarkdownSection(md, 'Alternatives Considered');
+    if (alternatives) {
+        for (const alt of extractListItems(alternatives)) {
+            items.push({
+                source: 'decision-memo',
+                category: 'decision-rationale',
+                title: `Alternative: ${alt}`,
+                content: alt,
+            });
+        }
+    }
+    // Conditions for Success
+    const conditions = extractMarkdownSection(md, 'Conditions for Success');
+    if (conditions) {
+        for (const cond of extractListItems(conditions)) {
+            items.push({
+                source: 'decision-memo',
+                category: 'constraint',
+                title: cond,
+                content: cond,
+            });
+        }
+    }
+    return items;
+}
+// ============================================================================
+// Cross-reference generation
+// ============================================================================
+/**
+ * Extract "significant" words from text: lowercased tokens longer than 4
+ * characters, with common stop words removed.
+ */
+function significantWords(text) {
+    const stopWords = new Set([
+        'about', 'above', 'after', 'again', 'being', 'below', 'between',
+        'could', 'doing', 'during', 'every', 'further', 'having',
+        'might', 'other', 'should', 'their', 'these', 'those', 'through',
+        'under', 'until', 'where', 'which', 'while', 'would',
+    ]);
+    const words = text.toLowerCase().match(/[a-z]{5,}/g) ?? [];
+    return new Set(words.filter((w) => !stopWords.has(w)));
+}
+/**
+ * Count how many words two sets share.
+ */
+function sharedWordCount(a, b) {
+    let count = 0;
+    for (const word of a) {
+        if (b.has(word))
+            count++;
+    }
+    return count;
+}
+/**
+ * Build deterministic cross-references between dossier items.
+ *
+ * Rules:
+ *  1. Risk → Constraint sharing 3+ significant words → 'mitigates'
+ *  2. Timeline item mentioning another item's title keyword → 'depends-on'
+ *  3. Constraint → Requirement referencing constraint topic → 'constrains'
+ *
+ * References are sorted by (fromId, toId) for determinism.
+ */
+function buildCrossReferences(items) {
+    const refs = [];
+    const seen = new Set();
+    const riskItems = items.filter((i) => i.category === 'risk');
+    const constraintItems = items.filter((i) => i.category === 'constraint');
+    const timelineItems = items.filter((i) => i.category === 'timeline');
+    const requirementItems = items.filter((i) => i.category === 'requirement');
+    // Precompute significant word sets
+    const wordSets = new Map();
+    for (const item of items) {
+        wordSets.set(item.id, significantWords(item.content));
+    }
+    // Rule 1: risk → constraint with 3+ shared significant words → 'mitigates'
+    for (const risk of riskItems) {
+        const riskWords = wordSets.get(risk.id);
+        for (const constraint of constraintItems) {
+            const constraintWords = wordSets.get(constraint.id);
+            if (sharedWordCount(riskWords, constraintWords) >= 3) {
+                const key = `${risk.id}:${constraint.id}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    refs.push({
+                        fromId: risk.id,
+                        toId: constraint.id,
+                        relationship: 'mitigates',
+                    });
+                }
+            }
+        }
+    }
+    // Rule 2: timeline items mentioning a dependency keyword from another item's title
+    for (const timeline of timelineItems) {
+        const tlContentLower = timeline.content.toLowerCase();
+        for (const other of items) {
+            if (other.id === timeline.id)
+                continue;
+            // Extract significant words from the other item's title
+            const titleWords = significantWords(other.title);
+            let matchCount = 0;
+            for (const word of titleWords) {
+                if (tlContentLower.includes(word)) {
+                    matchCount++;
+                }
+            }
+            if (matchCount >= 1 && titleWords.size > 0) {
+                const key = `${timeline.id}:${other.id}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    refs.push({
+                        fromId: timeline.id,
+                        toId: other.id,
+                        relationship: 'depends-on',
+                    });
+                }
+            }
+        }
+    }
+    // Rule 3: constraint → requirement where requirement content references
+    // constraint topic (3+ shared significant words)
+    for (const constraint of constraintItems) {
+        const constraintWords = wordSets.get(constraint.id);
+        for (const requirement of requirementItems) {
+            const reqWords = wordSets.get(requirement.id);
+            if (sharedWordCount(constraintWords, reqWords) >= 3) {
+                const key = `${constraint.id}:${requirement.id}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    refs.push({
+                        fromId: constraint.id,
+                        toId: requirement.id,
+                        relationship: 'constrains',
+                    });
+                }
+            }
+        }
+    }
+    // Sort by fromId, then toId for determinism
+    refs.sort((a, b) => {
+        const cmp = a.fromId.localeCompare(b.fromId);
+        return cmp !== 0 ? cmp : a.toId.localeCompare(b.toId);
+    });
+    return refs;
+}
+// ============================================================================
+// Summary computation
+// ============================================================================
+/**
+ * Build the dossier summary with counts, key risk IDs, and critical constraints.
+ */
+function buildDossierSummary(items, crossRefs) {
+    const bySource = {};
+    const byCategory = {};
+    for (const item of items) {
+        bySource[item.source] = (bySource[item.source] ?? 0) + 1;
+        byCategory[item.category] = (byCategory[item.category] ?? 0) + 1;
+    }
+    // Key risks: items with category 'risk' and severity 'high', sorted by ID
+    const keyRisks = items
+        .filter((i) => i.category === 'risk' && i.severity === 'high')
+        .map((i) => i.id)
+        .sort();
+    // Critical constraints: first 5 constraint items, sorted by ID
+    const criticalConstraints = items
+        .filter((i) => i.category === 'constraint')
+        .map((i) => i.id)
+        .sort()
+        .slice(0, 5);
+    // The crossRefs parameter is accepted for future extensibility
+    void crossRefs;
+    return {
+        totalItems: items.length,
+        bySource,
+        byCategory,
+        keyRisks,
+        criticalConstraints,
+    };
+}
+// ============================================================================
+// Core extraction: pure, deterministic, testable
+// ============================================================================
+/**
+ * Build a complete research dossier from Phase 1 artifacts.
+ *
+ * This function is pure (no I/O, no side effects) and deterministic:
+ * given the same artifacts and traceId it always produces the same output.
+ *
+ * @param artifacts - Loaded Phase 1 artifacts
+ * @param traceId  - Trace identifier for provenance
+ * @returns A fully populated ResearchDossier
+ */
+export function buildResearchDossier(artifacts, traceId) {
+    // Collect raw items in source order
+    const rawBySource = new Map();
+    rawBySource.set('scenario', extractFromScenario(artifacts.scenario));
+    rawBySource.set('roadmap', extractFromRoadmap(artifacts.roadmap));
+    rawBySource.set('risk-assessment', extractFromRiskAssessment(artifacts.riskAssessment));
+    rawBySource.set('executive-summary', extractFromExecutiveSummary(artifacts.executiveSummary));
+    rawBySource.set('decision-memo', extractFromDecisionMemo(artifacts.decisionMemo));
+    // Build the ordered list: iterate sources in fixed order, sort items
+    // within each source by category order
+    const orderedRaw = [];
+    for (const source of SOURCE_ORDER) {
+        const sourceItems = rawBySource.get(source) ?? [];
+        // Stable sort by category order
+        const sorted = [...sourceItems].sort((a, b) => {
+            const aIdx = CATEGORY_ORDER.indexOf(a.category);
+            const bIdx = CATEGORY_ORDER.indexOf(b.category);
+            return aIdx - bIdx;
+        });
+        orderedRaw.push(...sorted);
+    }
+    // Assign sequential IDs: RD-001, RD-002, ...
+    let counter = 0;
+    const items = orderedRaw.map((raw) => {
+        counter++;
+        const item = {
+            id: `RD-${String(counter).padStart(3, '0')}`,
+            source: raw.source,
+            category: raw.category,
+            title: raw.title,
+            content: raw.content,
+            ...(raw.severity !== undefined ? { severity: raw.severity } : {}),
+            ...(raw.phase !== undefined ? { phase: raw.phase } : {}),
+        };
+        return item;
+    });
+    // Cross-references
+    const crossReferences = buildCrossReferences(items);
+    // Summary
+    const summary = buildDossierSummary(items, crossReferences);
+    return {
+        id: `dossier-${traceId}`,
+        traceId,
+        generatedFrom: artifacts.manifest.run_id,
+        items,
+        crossReferences,
+        summary,
+    };
+}
+// ============================================================================
+// Pipeline entry point
+// ============================================================================
+/**
+ * Generate the research dossier as Stage 2 of the Phase 2 pipeline.
+ *
+ * 1. Creates a telemetry span
+ * 2. Calls buildResearchDossier (pure extraction)
+ * 3. Validates against ResearchDossierSchema (warn-only)
+ * 4. Writes research-dossier.json to phase2Dir
+ * 5. Stores output on context.stageOutputs
+ * 6. Returns Phase2StageOutput
+ *
+ * @param context - Mutable Phase 2 pipeline context
+ * @returns Stage output with status, timing, and artifact paths
+ */
+export async function generateResearchDossier(context) {
+    const span = createSpan('research-dossier', 'generate', { traceId: context.traceId });
+    const startTime = Date.now();
+    try {
+        // Pure extraction
+        const dossier = buildResearchDossier(context.phase1Artifacts, context.traceId);
+        // Schema validation (warn-only, never blocks)
+        try {
+            ResearchDossierSchema.parse({
+                items: dossier.items,
+                crossReferences: dossier.crossReferences,
+                summary: dossier.summary,
+                generatedAt: new Date().toISOString(),
+                sourceManifest: dossier.generatedFrom,
+            });
+        }
+        catch (validationError) {
+            const msg = validationError instanceof Error ? validationError.message : String(validationError);
+            console.error(`  [WARN] research-dossier schema validation failed: ${msg}`);
+        }
+        // Write to disk
+        const outputPath = path.join(context.phase2Dir, DOSSIER_FILENAME);
+        const content = JSON.stringify(dossier, null, 2);
+        fs.writeFileSync(outputPath, content, { encoding: 'utf-8', mode: FILE_MODE });
+        const timing = Date.now() - startTime;
+        const output = {
+            stage: 'research-dossier',
+            status: 'completed',
+            data: dossier,
+            artifacts: [outputPath],
+            timing,
+            summary: `Extracted ${dossier.items.length} items, ${dossier.crossReferences.length} cross-references from ${SOURCE_ORDER.length} sources`,
+        };
+        context.stageOutputs.set('research-dossier', output);
+        endSpan(span, 'ok', {
+            itemCount: dossier.items.length,
+            crossRefCount: dossier.crossReferences.length,
+            timingMs: timing,
+        });
+        emitSpan(span);
+        context.telemetrySpans.push(span);
+        return output;
+    }
+    catch (error) {
+        const timing = Date.now() - startTime;
+        const msg = error instanceof Error ? error.message : String(error);
+        endSpan(span, 'error', { error: msg, timingMs: timing });
+        emitSpan(span);
+        context.telemetrySpans.push(span);
+        const output = {
+            stage: 'research-dossier',
+            status: 'failed',
+            data: null,
+            artifacts: [],
+            timing,
+            summary: `Research dossier generation failed: ${msg}`,
+        };
+        context.stageOutputs.set('research-dossier', output);
+        return output;
+    }
+}
+//# sourceMappingURL=research-dossier.js.map

package/dist/pipeline/phase2/phases/research-dossier.js.map

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

package/dist/pipeline/phase2/phases/sparc-specification.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Phase 2 Pipeline -- Stage 3: SPARC Specification
+ *
+ * Generates a complete SPARC specification (Specification, Pseudocode,
+ * Architecture, Refinement, Completion) from the research dossier compiled
+ * in Stage 2 and the Phase 1 artifacts loaded in Stage 1.
+ *
+ * Every element in the output carries `dossierItemRefs` for full traceability
+ * back to the research dossier.
+ *
+ * Error codes:
+ *   ECLI-P2-010  Research dossier not available on context
+ *   ECLI-P2-011  SPARC file write failure
+ */
+import type { Phase2Context, Phase2StageOutput, ResearchDossier, Phase1Artifacts, Phase2SPARCOutput } from '../types.js';
+/**
+ * Pure function that builds the full SPARC output from a research dossier
+ * and Phase 1 artifacts. No side effects (no file I/O, no telemetry).
+ * Exported for unit testing.
+ *
+ * @param dossier   - The research dossier compiled in Stage 2
+ * @param artifacts - The Phase 1 artifacts loaded in Stage 1
+ * @returns Complete SPARC output with dossier cross-references
+ */
+export declare function buildPhase2SPARC(dossier: ResearchDossier, artifacts: Phase1Artifacts): Phase2SPARCOutput;
+/**
+ * Stage 3 entry point: generate SPARC specification from the research dossier
+ * and Phase 1 artifacts stored on the pipeline context.
+ *
+ * Writes 6 JSON files to `context.phase2Dir/sparc/`:
+ *   specification.json, pseudocode.json, architecture.json,
+ *   refinement.json, completion.json, sparc-combined.json
+ *
+ * @param context - The Phase 2 pipeline context (must have dossier on stageOutputs)
+ * @returns Stage output describing success or failure
+ */
+export declare function generateSPARCSpecification(context: Phase2Context): Promise<Phase2StageOutput>;
+//# sourceMappingURL=sparc-specification.d.ts.map

package/dist/pipeline/phase2/phases/sparc-specification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparc-specification.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase2/phases/sparc-specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EAWlB,MAAM,aAAa,CAAC;AAktBrB;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,eAAe,GACzB,iBAAiB,CAcnB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAwH5B"}