@llm-dev-ops/agentics-cli 1.4.59 → 1.4.68

package/dist/pipeline/phase2/phases/sparc-quality-gate.js

@@ -0,0 +1,350 @@
+/**
+ * Phase 2 Quality Gate: SPARC Output Validator
+ *
+ * Validates SPARC specification + pseudocode before DDD generation.
+ * Prevents empty entity types by ensuring pseudocode contains:
+ * - dataStructures with typed fields (not just type names)
+ * - Algorithm steps (not empty arrays)
+ * - Service definitions with API signatures
+ *
+ * Error codes:
+ *   ECLI-P2-040  SPARC output quality too low for DDD generation
+ *   ECLI-P2-041  SPARC output not available on context
+ */
+// ============================================================================
+// Detection Patterns
+// ============================================================================
+/**
+ * Patterns indicating typed field definitions in data structures.
+ * Matches formats like "fieldName: string", "amount: number", "{ name: Type }".
+ */
+const TYPED_FIELD_PATTERNS = [
+    /\w+\s*:\s*(?:string|number|boolean|Date|int|float|double|bigint|uuid|decimal)\b/gi,
+    /\w+\s*:\s*(?:Array|List|Set|Map|Record|Optional|Nullable)<?\s*\w+/gi,
+    /\w+\s*:\s*[A-Z][a-z]+(?:[A-Z][a-z]+)+/g, // fieldName: PascalCaseType
+    /(?:readonly|public|private|protected)\s+\w+\s*:\s*\w+/gi,
+];
+/**
+ * Patterns indicating truncated or corrupt JSON content.
+ */
+const TRUNCATION_PATTERNS = [
+    /\.\.\.\s*$/m, // ends with "..."
+    /\{\s*$/m, // ends with opening brace
+    /,\s*$/m, // ends with trailing comma
+    /(?:truncated|maximum\s+length|token\s+limit|cut\s+off)\b/gi,
+];
+/**
+ * Patterns indicating error messages leaked into content.
+ */
+const ERROR_MESSAGE_PATTERNS = [
+    /\b(?:Error|Exception|ENOENT|EACCES|EPERM|EISDIR)\b.*:/g,
+    /\bstack\s*trace\b/gi,
+    /\bat\s+\w+\s*\(.*:\d+:\d+\)/g, // "at functionName (file:line:col)"
+    /\b(?:undefined|null)\s+is\s+not\s+(?:a\s+function|an?\s+object|iterable)\b/gi,
+    /\b(?:Cannot\s+read\s+propert(?:y|ies)\s+of\s+(?:undefined|null))\b/gi,
+];
+/**
+ * Patterns indicating API signatures with input/output types.
+ */
+const API_SIGNATURE_PATTERNS = [
+    /\b\w+\s*\(.*\)\s*(?:=>|->|:)\s*\w+/g, // func(args) => ReturnType
+    /\b(?:GET|POST|PUT|PATCH|DELETE)\s+\/\w+/g, // HTTP method + path
+    /\b(?:input|request|params?)\s*:\s*\{[^}]+\}/gi, // input: { ... }
+    /\b(?:output|response|returns?)\s*:\s*(?:\{[^}]+\}|\w+)/gi, // output: { ... } or Type
+    /\b(?:rpc|grpc|graphql)\b/gi, // RPC protocol mentions
+];
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Check whether a pseudocode module has real typed data structures
+ * (not just empty type names or generic placeholders).
+ */
+function moduleHasTypedDataStructures(mod) {
+    // Check the markdown content for typed field patterns
+    const content = `${mod.markdown} ${mod.dataStructures.join(' ')}`;
+    for (const pattern of TYPED_FIELD_PATTERNS) {
+        const re = new RegExp(pattern.source, pattern.flags);
+        if (re.test(content))
+            return true;
+    }
+    // Also accept dataStructures array entries that contain ":" (field: type)
+    return mod.dataStructures.some((ds) => /\w+\s*:\s*\w+/.test(ds));
+}
+/**
+ * Check whether a pseudocode module has non-empty algorithm steps.
+ */
+function moduleHasAlgorithms(mod) {
+    // algorithms array must have real entries (not empty strings)
+    if (mod.algorithms.length > 0 && mod.algorithms.some((a) => a.trim().length > 10)) {
+        return true;
+    }
+    // Also check markdown for algorithmic constructs
+    return /\b(?:if|for|while|loop|iterate|return|throw|try|catch|switch|case|step\s+\d)\b/i.test(mod.markdown);
+}
+/**
+ * Check whether a service has API signatures with typed inputs/outputs.
+ */
+function serviceHasTypedAPIs(svc) {
+    const apiText = svc.api.join(' ');
+    for (const pattern of API_SIGNATURE_PATTERNS) {
+        const re = new RegExp(pattern.source, pattern.flags);
+        if (re.test(apiText))
+            return true;
+    }
+    return false;
+}
+/**
+ * Detect truncated content across all SPARC output text.
+ */
+function detectTruncation(sparc) {
+    const allText = gatherAllText(sparc);
+    for (const pattern of TRUNCATION_PATTERNS) {
+        const re = new RegExp(pattern.source, pattern.flags);
+        if (re.test(allText))
+            return true;
+    }
+    return false;
+}
+/**
+ * Detect error messages leaked into SPARC content.
+ */
+function detectErrorMessages(sparc) {
+    const allText = gatherAllText(sparc);
+    for (const pattern of ERROR_MESSAGE_PATTERNS) {
+        const re = new RegExp(pattern.source, pattern.flags);
+        if (re.test(allText))
+            return true;
+    }
+    return false;
+}
+/**
+ * Concatenate all textual content from SPARC output for scanning.
+ */
+function gatherAllText(sparc) {
+    const parts = [];
+    // Specification
+    parts.push(sparc.specification.scope);
+    for (const req of sparc.specification.requirements)
+        parts.push(req.text);
+    for (const con of sparc.specification.constraints)
+        parts.push(con.text);
+    for (const sc of sparc.specification.successCriteria)
+        parts.push(sc.text);
+    // Pseudocode
+    for (const mod of sparc.pseudocode.modules) {
+        parts.push(mod.markdown);
+        parts.push(mod.algorithms.join(' '));
+        parts.push(mod.dataStructures.join(' '));
+    }
+    // Architecture
+    for (const svc of sparc.architecture.services) {
+        parts.push(svc.responsibility);
+        parts.push(svc.api.join(' '));
+    }
+    parts.push(sparc.architecture.dataFlow);
+    parts.push(sparc.architecture.apiContracts.join(' '));
+    // Refinement
+    for (const sec of sparc.refinement.securityConsiderations)
+        parts.push(sec.text);
+    for (const perf of sparc.refinement.performanceTargets)
+        parts.push(perf.text);
+    parts.push(sparc.refinement.testStrategy);
+    // Completion
+    parts.push(sparc.completion.integrationPlan);
+    parts.push(sparc.completion.documentation.join(' '));
+    return parts.join('\n');
+}
+// ============================================================================
+// Main Validation
+// ============================================================================
+const PASSING_SCORE = 60;
+const WEIGHTS = {
+    servicesCovered: 25, // every service has at least 1 pseudocode module
+    dataStructures: 25, // modules have typed data structures
+    algorithms: 15, // modules have real algorithms
+    apiSignatures: 15, // services have typed API signatures
+    specCompleteness: 10, // specification has requirements + constraints
+    contentIntegrity: 10, // no truncation or error messages
+};
+/**
+ * Validate SPARC output quality and produce a detailed report.
+ */
+export function validateSPARCQuality(sparc) {
+    const issues = [];
+    const modules = sparc.pseudocode.modules;
+    const services = sparc.architecture.services;
+    const spec = sparc.specification;
+    const totalModules = modules.length;
+    const totalServices = services.length;
+    // ---- Empty output fast-path ----
+    if (totalModules === 0 && totalServices === 0) {
+        return {
+            passed: false,
+            score: 0,
+            issues: ['SPARC output contains zero pseudocode modules and zero services. Generation may have failed entirely.'],
+            servicesWithPseudocode: 0,
+            totalServices: 0,
+            modulesWithDataStructures: 0,
+            modulesWithAlgorithms: 0,
+            totalModules: 0,
+            apisWithSignatures: 0,
+            truncatedContentDetected: false,
+            errorMessagesDetected: false,
+        };
+    }
+    // ---- Count signals ----
+    // 1. Services with at least one pseudocode module
+    const serviceNames = new Set(services.map((s) => s.name.toLowerCase()));
+    const moduleMappedServices = new Set();
+    for (const mod of modules) {
+        // Try to map modules to services by name similarity
+        const modNameLower = mod.name.toLowerCase();
+        for (const svcName of serviceNames) {
+            if (modNameLower.includes(svcName) || svcName.includes(modNameLower)) {
+                moduleMappedServices.add(svcName);
+            }
+        }
+    }
+    // If no direct mapping, count by ratio of modules to services
+    const servicesWithPseudocode = moduleMappedServices.size > 0
+        ? moduleMappedServices.size
+        : Math.min(totalServices, totalModules);
+    // 2. Modules with typed data structures
+    const modulesWithDataStructures = modules.filter(moduleHasTypedDataStructures).length;
+    // 3. Modules with real algorithms
+    const modulesWithAlgorithms = modules.filter(moduleHasAlgorithms).length;
+    // 4. Services with typed API signatures
+    const apisWithSignatures = services.filter(serviceHasTypedAPIs).length;
+    // 5. Content integrity
+    const truncatedContentDetected = detectTruncation(sparc);
+    const errorMessagesDetected = detectErrorMessages(sparc);
+    // ---- Compute sub-scores ----
+    const servicesCoveredRatio = totalServices > 0
+        ? servicesWithPseudocode / totalServices
+        : (totalModules > 0 ? 1 : 0);
+    const servicesCoveredScore = servicesCoveredRatio * WEIGHTS.servicesCovered;
+    const dsRatio = totalModules > 0 ? modulesWithDataStructures / totalModules : 0;
+    const dataStructuresScore = dsRatio * WEIGHTS.dataStructures;
+    const algoRatio = totalModules > 0 ? modulesWithAlgorithms / totalModules : 0;
+    const algorithmsScore = algoRatio * WEIGHTS.algorithms;
+    const apiRatio = totalServices > 0 ? apisWithSignatures / totalServices : 0;
+    const apiScore = apiRatio * WEIGHTS.apiSignatures;
+    // Spec completeness: has requirements, constraints, and success criteria
+    const specParts = [
+        spec.requirements.length > 0 ? 1 : 0,
+        spec.constraints.length > 0 ? 1 : 0,
+        spec.successCriteria.length > 0 ? 1 : 0,
+    ];
+    const specRatio = specParts.reduce((a, b) => a + b, 0) / 3;
+    const specScore = specRatio * WEIGHTS.specCompleteness;
+    // Content integrity penalty
+    let integrityPenalty = 0;
+    if (truncatedContentDetected)
+        integrityPenalty += WEIGHTS.contentIntegrity / 2;
+    if (errorMessagesDetected)
+        integrityPenalty += WEIGHTS.contentIntegrity / 2;
+    const integrityScore = WEIGHTS.contentIntegrity - integrityPenalty;
+    const rawScore = servicesCoveredScore + dataStructuresScore + algorithmsScore +
+        apiScore + specScore + integrityScore;
+    const score = Math.max(0, Math.min(100, Math.round(rawScore)));
+    // ---- Collect actionable issues ----
+    if (totalModules === 0) {
+        issues.push('No pseudocode modules generated. SPARC pseudocode phase may have been skipped.');
+    }
+    if (totalServices === 0) {
+        issues.push('No services defined in SPARC architecture. Architecture phase may have been skipped.');
+    }
+    if (totalServices > 0 && servicesWithPseudocode < totalServices) {
+        issues.push(`Only ${servicesWithPseudocode}/${totalServices} services have corresponding pseudocode modules. ` +
+            'Each service needs at least one pseudocode module for DDD generation.');
+    }
+    if (totalModules > 0 && modulesWithDataStructures < totalModules) {
+        issues.push(`Only ${modulesWithDataStructures}/${totalModules} modules have typed data structures. ` +
+            'Add "{ fieldName: type }" definitions to dataStructures arrays.');
+    }
+    if (totalModules > 0 && modulesWithAlgorithms < totalModules) {
+        issues.push(`Only ${modulesWithAlgorithms}/${totalModules} modules have non-trivial algorithms. ` +
+            'Algorithm arrays should contain real control flow, not empty strings.');
+    }
+    if (totalServices > 0 && apisWithSignatures < totalServices) {
+        issues.push(`Only ${apisWithSignatures}/${totalServices} services have typed API signatures. ` +
+            'API entries should include input/output types (e.g. "createOrder(input: CreateOrderDTO) => OrderConfirmation").');
+    }
+    if (spec.requirements.length === 0) {
+        issues.push('Specification has no requirements. At least one "must" requirement is expected.');
+    }
+    if (spec.constraints.length === 0) {
+        issues.push('Specification has no constraints defined.');
+    }
+    if (truncatedContentDetected) {
+        issues.push('Truncated content detected in SPARC output. LLM response may have been cut off by token limits.');
+    }
+    if (errorMessagesDetected) {
+        issues.push('Error messages or stack traces detected in SPARC content. Generation may have partially failed.');
+    }
+    const passed = score >= PASSING_SCORE;
+    return {
+        passed,
+        score,
+        issues,
+        servicesWithPseudocode,
+        totalServices,
+        modulesWithDataStructures,
+        modulesWithAlgorithms,
+        totalModules,
+        apisWithSignatures,
+        truncatedContentDetected,
+        errorMessagesDetected,
+    };
+}
+// ============================================================================
+// Pipeline Stage Entry Point
+// ============================================================================
+/**
+ * Execute the SPARC quality gate as a Phase 2 pipeline stage.
+ *
+ * Reads the SPARC output from context stage outputs, validates it,
+ * and returns a stage output indicating pass or fail.
+ *
+ * @throws Error with ECLI-P2-041 if SPARC output is not on context
+ */
+export async function executeSPARCQualityGate(context) {
+    const start = Date.now();
+    const sparcOutput = context.stageOutputs.get('sparc-specification');
+    if (!sparcOutput || sparcOutput.status !== 'completed' || !sparcOutput.data) {
+        throw new Error('ECLI-P2-041: SPARC output not available on context. ' +
+            'The sparc-specification stage must complete successfully before the SPARC quality gate.');
+    }
+    const sparc = sparcOutput.data;
+    const report = validateSPARCQuality(sparc);
+    const elapsed = Date.now() - start;
+    if (!report.passed) {
+        console.error(`  [QUALITY-GATE] SPARC output FAILED (score: ${report.score}/100)`);
+        for (const issue of report.issues) {
+            console.error(`    - ${issue}`);
+        }
+        return {
+            stage: 'sparc-specification',
+            status: 'failed',
+            data: report,
+            artifacts: [],
+            timing: elapsed,
+            summary: `ECLI-P2-040: SPARC output quality too low (score: ${report.score}/100, minimum: ${PASSING_SCORE}). ` +
+                `Issues: ${report.issues.join(' | ')}`,
+        };
+    }
+    console.error(`  [QUALITY-GATE] SPARC output PASSED (score: ${report.score}/100)`);
+    console.error(`    Modules: ${report.totalModules}, Services: ${report.totalServices}, ` +
+        `Data structures OK: ${report.modulesWithDataStructures}, APIs typed: ${report.apisWithSignatures}`);
+    return {
+        stage: 'sparc-specification',
+        status: 'completed',
+        data: report,
+        artifacts: [],
+        timing: elapsed,
+        summary: `SPARC quality gate passed (score: ${report.score}/100). ` +
+            `${report.totalModules} modules, ${report.totalServices} services validated.`,
+    };
+}
+//# sourceMappingURL=sparc-quality-gate.js.map

package/dist/pipeline/phase2/phases/sparc-quality-gate.js.map

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

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

@@ -16,6 +16,20 @@
  *   ECLI-P2-011  SPARC file write failure
  */
 import type { Phase2Context, Phase2StageOutput, ResearchDossier, Phase1Artifacts, Phase2SPARCOutput } from '../types.js';
+/**
+ * Detect whether the user's query requires intelligence/ML/analytics contexts.
+ * Returns keywords found and suggested intelligence context names.
+ */
+export declare function detectIntelligenceRequirements(query: string): {
+    hasIntelligence: boolean;
+    keywords: string[];
+    suggestedContexts: Array<{
+        name: string;
+        type: 'ml-inference' | 'analytics' | 'anomaly-detection' | 'forecasting' | 'data-pipeline';
+        commands: string[];
+        description: string;
+    }>;
+};
 export declare function buildPhase2SPARC(dossier: ResearchDossier, artifacts: Phase1Artifacts): Phase2SPARCOutput;
 /**
  * Stage 3 entry point: generate SPARC specification from the research dossier

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

@@ -1 +1 @@
-{"version":3,"file":"sparc-specification.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase2/phases/sparc-specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EAWlB,MAAM,aAAa,CAAC;AA65BrB,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,eAAe,GACzB,iBAAiB,CAEnB;AAMD;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CA6H5B"}
+{"version":3,"file":"sparc-specification.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase2/phases/sparc-specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EAWlB,MAAM,aAAa,CAAC;AAiBrB;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG;IAC7D,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,cAAc,GAAG,WAAW,GAAG,mBAAmB,GAAG,aAAa,GAAG,eAAe,CAAC;QAC3F,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ,CA8GA;AAi1CD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,eAAe,GACzB,iBAAiB,CAEnB;AAMD;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAiJ5B"}