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

package/dist/routing/graph-validator.js

@@ -0,0 +1,329 @@
+/**
+ * Graph Validator (ADR-031 Phase 5)
+ *
+ * Tiered validation engine for the ecosystem capability graph.
+ *
+ * Tier 1 (Offline): Schema, uniqueness, weights, compositions, cycles
+ * Tier 2 (Online): Repository existence, agent name consistency (requires API)
+ * Tier 3 (Telemetry): Orphan detection (requires outcome data)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { loadEcosystemGraph, resolveGraphPath } from './graph-loader.js';
+import { isWeightedAgent } from './weighted-resolver.js';
+import { validateCompositionRules, detectCompositionCycles } from './composition-engine.js';
+import { loadOutcomes } from './outcome-recorder.js';
+// ============================================================================
+// Tier 1: Offline Validation
+// ============================================================================
+/**
+ * Run Tier 1 offline validation rules.
+ * No network required. Validates structural correctness.
+ */
+export function validateTier1(graphPath) {
+    const resolvedPath = graphPath ?? resolveGraphPath();
+    const results = [];
+    // Rule 1: Schema validation (load will throw on invalid schema)
+    let graph = null;
+    try {
+        graph = loadEcosystemGraph({ graphPath: resolvedPath, forceReload: true });
+        results.push({
+            rule: 'Schema validation',
+            severity: 'error',
+            passed: true,
+            message: `${graph.capabilities.length} capabilities valid`,
+        });
+    }
+    catch (err) {
+        results.push({
+            rule: 'Schema validation',
+            severity: 'error',
+            passed: false,
+            message: err.message,
+        });
+        return buildReport('offline', results);
+    }
+    // Rule 2: Unique capability names (already checked by loader, but explicit)
+    const capNames = graph.capabilities.map(c => c.name);
+    const uniqueNames = new Set(capNames);
+    results.push({
+        rule: 'Unique capability names',
+        severity: 'error',
+        passed: capNames.length === uniqueNames.size,
+        message: capNames.length === uniqueNames.size
+            ? 'no duplicates'
+            : `${capNames.length - uniqueNames.size} duplicate(s) found`,
+    });
+    // Rule 3: Non-empty agents
+    const emptyAgents = graph.capabilities.filter(c => c.agents.length === 0);
+    results.push({
+        rule: 'Non-empty agents',
+        severity: 'error',
+        passed: emptyAgents.length === 0,
+        message: emptyAgents.length === 0
+            ? 'all capabilities have agents'
+            : `${emptyAgents.length} capability(s) missing agents: ${emptyAgents.map(c => c.name).join(', ')}`,
+    });
+    // Rule 4: Non-empty repos
+    const emptyRepos = graph.capabilities.filter(c => c.repos.length === 0);
+    results.push({
+        rule: 'Non-empty repos',
+        severity: 'error',
+        passed: emptyRepos.length === 0,
+        message: emptyRepos.length === 0
+            ? 'all capabilities have repos'
+            : `${emptyRepos.length} capability(s) missing repos: ${emptyRepos.map(c => c.name).join(', ')}`,
+    });
+    // Rule 5: Valid stage references
+    const stageSet = new Set(graph.stages);
+    const invalidStages = graph.capabilities.filter(c => c.stage && !stageSet.has(c.stage));
+    results.push({
+        rule: 'Valid stage references',
+        severity: 'error',
+        passed: invalidStages.length === 0,
+        message: invalidStages.length === 0
+            ? 'all stages exist'
+            : `invalid stages in: ${invalidStages.map(c => `${c.name}(${c.stage})`).join(', ')}`,
+    });
+    // Rule 6: No circular dependencies (already checked by loader)
+    results.push({
+        rule: 'No circular dependencies',
+        severity: 'error',
+        passed: true,
+        message: 'topological sort succeeded',
+    });
+    // Rule 9: Weight bounds
+    const weightErrors = [];
+    for (const cap of graph.capabilities) {
+        for (const agent of cap.agents) {
+            if (isWeightedAgent(agent)) {
+                if (agent.weight < 0 || agent.weight > 1) {
+                    weightErrors.push(`${cap.name}/${agent.name}: weight ${agent.weight}`);
+                }
+            }
+        }
+    }
+    results.push({
+        rule: 'Weight bounds',
+        severity: 'error',
+        passed: weightErrors.length === 0,
+        message: weightErrors.length === 0
+            ? 'all weights in [0.0, 1.0]'
+            : `${weightErrors.length} weight(s) out of range`,
+        details: weightErrors.length > 0 ? weightErrors : undefined,
+    });
+    // Rules 10-11: Composition validation
+    const compositions = loadCompositionsFromGraph(resolvedPath);
+    if (compositions.length > 0) {
+        const validCaps = new Set(capNames);
+        const compErrors = validateCompositionRules(compositions, validCaps);
+        results.push({
+            rule: 'Composition rule validity',
+            severity: 'error',
+            passed: compErrors.length === 0,
+            message: compErrors.length === 0
+                ? 'all referenced capabilities exist'
+                : `${compErrors.length} error(s)`,
+            details: compErrors.length > 0 ? compErrors : undefined,
+        });
+        const cycles = detectCompositionCycles(compositions);
+        results.push({
+            rule: 'Composition cycle detection',
+            severity: 'error',
+            passed: !cycles.hasCycle,
+            message: cycles.hasCycle
+                ? `cycle detected among: ${cycles.cycleNodes.join(', ')}`
+                : 'no cycles',
+        });
+    }
+    else {
+        results.push({
+            rule: 'Composition rule validity',
+            severity: 'error',
+            passed: true,
+            message: 'no composition rules defined',
+        });
+        results.push({
+            rule: 'Composition cycle detection',
+            severity: 'error',
+            passed: true,
+            message: 'no composition rules defined',
+        });
+    }
+    // Rule 12: Fragment owner field (only relevant for federated graphs)
+    const fragmentsDir = getFragmentsDir(resolvedPath);
+    if (fragmentsDir && fs.existsSync(fragmentsDir)) {
+        const missingOwners = checkFragmentOwners(fragmentsDir);
+        results.push({
+            rule: 'Fragment owner field',
+            severity: 'warning',
+            passed: missingOwners.length === 0,
+            message: missingOwners.length === 0
+                ? 'all fragments have owners'
+                : `${missingOwners.length} fragments missing owner`,
+            details: missingOwners.length > 0 ? missingOwners : undefined,
+        });
+    }
+    return buildReport('offline', results);
+}
+// ============================================================================
+// Tier 3: Telemetry Validation
+// ============================================================================
+/**
+ * Run Tier 3 telemetry validation rules.
+ * Requires outcome data from Phase 2.
+ */
+export function validateTier3(graphPath, options) {
+    const resolvedPath = graphPath ?? resolveGraphPath();
+    const results = [];
+    let graph;
+    try {
+        graph = loadEcosystemGraph({ graphPath: resolvedPath, forceReload: true });
+    }
+    catch (err) {
+        results.push({
+            rule: 'Graph load',
+            severity: 'error',
+            passed: false,
+            message: err.message,
+        });
+        return buildReport('telemetry', results);
+    }
+    // Rule 13: Orphan detection
+    const outcomes = loadOutcomes({ basePath: options?.basePath });
+    const orphanDays = options?.orphanDays ?? 30;
+    const cutoff = new Date(Date.now() - orphanDays * 24 * 60 * 60 * 1000).toISOString();
+    const recentOutcomes = outcomes.filter(o => o.timestamp >= cutoff);
+    const usedCapabilities = new Set();
+    for (const o of recentOutcomes) {
+        for (const cap of o.capabilities_used) {
+            usedCapabilities.add(cap);
+        }
+    }
+    // Find capabilities with no inbound depends_on and no recent usage
+    const referencedCaps = new Set();
+    for (const cap of graph.capabilities) {
+        if (cap.depends_on) {
+            for (const dep of cap.depends_on) {
+                referencedCaps.add(dep);
+            }
+        }
+    }
+    const orphans = graph.capabilities
+        .filter(c => !referencedCaps.has(c.name) && !usedCapabilities.has(c.name))
+        .map(c => c.name);
+    if (recentOutcomes.length > 0) {
+        results.push({
+            rule: 'Orphan detection',
+            severity: 'warning',
+            passed: orphans.length === 0,
+            message: orphans.length === 0
+                ? `all capabilities used or referenced in last ${orphanDays} days`
+                : `${orphans.length} orphan(s) detected (no usage or references in ${orphanDays} days)`,
+            details: orphans.length > 0 ? orphans : undefined,
+        });
+    }
+    else {
+        results.push({
+            rule: 'Orphan detection',
+            severity: 'info',
+            passed: true,
+            message: 'no telemetry data available — skipping orphan detection',
+        });
+    }
+    return buildReport('telemetry', results);
+}
+// ============================================================================
+// Report Building
+// ============================================================================
+function buildReport(tier, results) {
+    return {
+        tier,
+        results,
+        passed: results.filter(r => r.passed).length,
+        failed: results.filter(r => !r.passed && r.severity === 'error').length,
+        warnings: results.filter(r => !r.passed && r.severity === 'warning').length,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Format a validation report as human-readable output.
+ */
+export function formatValidationReport(report) {
+    const tierLabel = report.tier === 'offline'
+        ? 'Tier 1: Offline'
+        : report.tier === 'online'
+            ? 'Tier 2: Online'
+            : 'Tier 3: Telemetry';
+    const lines = [
+        `Capability Graph Validation (${tierLabel})`,
+        '='.repeat(50),
+        '',
+    ];
+    for (const result of report.results) {
+        const icon = result.passed
+            ? '[PASS]'
+            : result.severity === 'warning'
+                ? '[WARN]'
+                : result.severity === 'info'
+                    ? '[INFO]'
+                    : '[FAIL]';
+        lines.push(`${icon} ${result.rule}: ${result.message}`);
+        if (result.details && result.details.length > 0) {
+            for (const detail of result.details) {
+                lines.push(`         - ${detail}`);
+            }
+        }
+    }
+    lines.push('');
+    lines.push(`Result: ${report.passed} passed, ${report.failed} failed, ${report.warnings} warning(s)`);
+    return lines.join('\n');
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function loadCompositionsFromGraph(graphPath) {
+    try {
+        const raw = fs.readFileSync(graphPath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (Array.isArray(data['compositions'])) {
+            return data['compositions'];
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return [];
+}
+function getFragmentsDir(graphPath) {
+    try {
+        const raw = fs.readFileSync(graphPath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (typeof data['fragments_dir'] === 'string') {
+            return path.resolve(path.dirname(graphPath), data['fragments_dir']);
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return null;
+}
+function checkFragmentOwners(fragmentsDir) {
+    const missing = [];
+    try {
+        const files = fs.readdirSync(fragmentsDir).filter(f => f.endsWith('.graph.json'));
+        for (const file of files) {
+            const filePath = path.join(fragmentsDir, file);
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            if (!data['owner'] || (typeof data['owner'] === 'string' && data['owner'].length === 0)) {
+                missing.push(file);
+            }
+        }
+    }
+    catch {
+        // Best effort
+    }
+    return missing;
+}
+//# sourceMappingURL=graph-validator.js.map

package/dist/routing/graph-validator.js.map

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

package/dist/routing/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Ecosystem Capability Graph Routing (ADR-030 + ADR-031)
+ *
+ * Barrel export for the routing subsystem.
+ *
+ * Usage:
+ *   import { routeQuery } from '../routing/index.js';
+ *   const result = routeQuery(userPrompt);
+ */
+export { loadEcosystemGraph, clearGraphCache, resolveGraphPath, getCapabilityByName, getCapabilitiesByTag, getCapabilitiesByStage, resolveDependencies, } from './graph-loader.js';
+export type { EcosystemGraph, CapabilityEntry, StageName, GraphValidationError, } from './graph-loader.js';
+export { classifyCapabilities, extractCapabilityNames, } from './capability-classifier.js';
+export type { ClassifiedCapability, ClassificationResult, } from './capability-classifier.js';
+export { routeCapabilities, resolveAgentRef, toDomainAgentList, } from './graph-router.js';
+export type { RoutedAgent, StageGroup, RoutingResult, AgentBudget, DomainAgentRef, } from './graph-router.js';
+export { normalizeAgent, normalizeAgents, getAgentName, selectWeightedAgents, validateAgentInput, isWeightedAgent, } from './weighted-resolver.js';
+export type { WeightedAgent, AgentInput, AgentRole, WeightedSelectionOptions, } from './weighted-resolver.js';
+export { recordOutcome, buildOutcomeRecord, loadOutcomes, loadRecentOutcomes, rotateOutcomes, getOutcomesFilePath, } from './outcome-recorder.js';
+export type { OutcomeRecord, OutcomeStatus, AgentContribution, } from './outcome-recorder.js';
+export { calculateAdjustedWeights, writeWeightOverlay, loadWeightOverlay, applyWeightOverlay, formatAdjustmentReport, } from './weight-adjuster.js';
+export type { WeightOverlay, WeightAdjustment, } from './weight-adjuster.js';
+export { applyCompositions, validateCompositionRules, detectCompositionCycles, formatCompositionExplanation, } from './composition-engine.js';
+export type { CompositionRule, CompositionOperator, CompositionPriority, CompositionResult, CompositionOptions, FiredRule, } from './composition-engine.js';
+export { isFederatedGraph, loadFragments, federateGraph, fragmentToCapabilityEntry, } from './graph-federation.js';
+export type { CapabilityFragment, FederatedRootGraph, FragmentOverride, FederationResult, } from './graph-federation.js';
+export { validateTier1, validateTier3, formatValidationReport, } from './graph-validator.js';
+export type { ValidationTier, ValidationSeverity, ValidationResult, ValidationReport, } from './graph-validator.js';
+import type { RoutingResult, DomainAgentRef } from './graph-router.js';
+export interface RouteQueryResult {
+    /** Full routing result with classification, pipeline, and explanation. */
+    readonly routing: RoutingResult;
+    /** Flat list of domain/agent refs ready for dispatch. */
+    readonly agents: readonly DomainAgentRef[];
+    /** Whether any capabilities were matched. If false, caller should fall back. */
+    readonly matched: boolean;
+}
+/**
+ * Route a natural language query through the ecosystem capability graph.
+ *
+ * This is the primary entry point for graph-based routing. It:
+ * 1. Loads the graph (cached after first load)
+ * 2. Classifies the prompt into capabilities
+ * 3. Applies composition rules (ADR-031 Phase 3)
+ * 4. Resolves dependencies
+ * 5. Builds a stage-ordered agent pipeline with weighted selection (ADR-031 Phase 1)
+ * 6. Returns domain/agent refs for dispatch
+ *
+ * If no capabilities match, returns { matched: false } so the caller
+ * can fall back to full-fleet dispatch.
+ */
+export declare function routeQuery(prompt: string, graphPath?: string): RouteQueryResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,cAAc,EACd,eAAe,EACf,SAAS,EACT,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,WAAW,EACX,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,GACV,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EACL,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAW/E"}

package/dist/routing/index.js

@@ -0,0 +1,68 @@
+/**
+ * Ecosystem Capability Graph Routing (ADR-030 + ADR-031)
+ *
+ * Barrel export for the routing subsystem.
+ *
+ * Usage:
+ *   import { routeQuery } from '../routing/index.js';
+ *   const result = routeQuery(userPrompt);
+ */
+// ============================================================================
+// ADR-030: Core Graph Routing
+// ============================================================================
+export { loadEcosystemGraph, clearGraphCache, resolveGraphPath, getCapabilityByName, getCapabilitiesByTag, getCapabilitiesByStage, resolveDependencies, } from './graph-loader.js';
+export { classifyCapabilities, extractCapabilityNames, } from './capability-classifier.js';
+export { routeCapabilities, resolveAgentRef, toDomainAgentList, } from './graph-router.js';
+// ============================================================================
+// ADR-031 Phase 1: Weighted Edges
+// ============================================================================
+export { normalizeAgent, normalizeAgents, getAgentName, selectWeightedAgents, validateAgentInput, isWeightedAgent, } from './weighted-resolver.js';
+// ============================================================================
+// ADR-031 Phase 2: Telemetry Feedback
+// ============================================================================
+export { recordOutcome, buildOutcomeRecord, loadOutcomes, loadRecentOutcomes, rotateOutcomes, getOutcomesFilePath, } from './outcome-recorder.js';
+export { calculateAdjustedWeights, writeWeightOverlay, loadWeightOverlay, applyWeightOverlay, formatAdjustmentReport, } from './weight-adjuster.js';
+// ============================================================================
+// ADR-031 Phase 3: Composition Rules
+// ============================================================================
+export { applyCompositions, validateCompositionRules, detectCompositionCycles, formatCompositionExplanation, } from './composition-engine.js';
+// ============================================================================
+// ADR-031 Phase 4: Multi-Graph Federation
+// ============================================================================
+export { isFederatedGraph, loadFragments, federateGraph, fragmentToCapabilityEntry, } from './graph-federation.js';
+// ============================================================================
+// ADR-031 Phase 5: CI Validation
+// ============================================================================
+export { validateTier1, validateTier3, formatValidationReport, } from './graph-validator.js';
+// ============================================================================
+// Convenience: one-call routing
+// ============================================================================
+import { loadEcosystemGraph } from './graph-loader.js';
+import { classifyCapabilities } from './capability-classifier.js';
+import { routeCapabilities, toDomainAgentList } from './graph-router.js';
+/**
+ * Route a natural language query through the ecosystem capability graph.
+ *
+ * This is the primary entry point for graph-based routing. It:
+ * 1. Loads the graph (cached after first load)
+ * 2. Classifies the prompt into capabilities
+ * 3. Applies composition rules (ADR-031 Phase 3)
+ * 4. Resolves dependencies
+ * 5. Builds a stage-ordered agent pipeline with weighted selection (ADR-031 Phase 1)
+ * 6. Returns domain/agent refs for dispatch
+ *
+ * If no capabilities match, returns { matched: false } so the caller
+ * can fall back to full-fleet dispatch.
+ */
+export function routeQuery(prompt, graphPath) {
+    const graph = loadEcosystemGraph({ graphPath });
+    const classification = classifyCapabilities(prompt, graph);
+    const routing = routeCapabilities(classification, graph);
+    const agents = toDomainAgentList(routing);
+    return {
+        routing,
+        agents,
+        matched: routing.totalAgents > 0,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAU3B,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAShC,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAO9B,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAWjC,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAS/B,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E,OAAO,EACL,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAS9B,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAYzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,SAAkB;IAC3D,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE1C,OAAO;QACL,OAAO;QACP,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,WAAW,GAAG,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/routing/outcome-recorder.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Outcome Recorder (ADR-031 Phase 2)
+ *
+ * Records execution outcomes to a local JSONL file for telemetry feedback.
+ * Outcomes are used by the weight adjuster to improve routing precision.
+ *
+ * Storage: .agentics/telemetry/outcomes.jsonl (append-only)
+ * Format: One JSON object per line (JSONL)
+ */
+export interface AgentContribution {
+    readonly produced_output: boolean;
+    readonly output_used: boolean;
+}
+export type OutcomeStatus = 'success' | 'failure' | 'partial' | 'timeout';
+export interface OutcomeRecord {
+    readonly timestamp: string;
+    readonly prompt_hash: string;
+    readonly capabilities_used: readonly string[];
+    readonly agents_selected: readonly string[];
+    readonly outcome: OutcomeStatus;
+    readonly user_rating: number | null;
+    readonly execution_time_ms: number;
+    readonly agent_contributions: Readonly<Record<string, AgentContribution>>;
+}
+/**
+ * Record an execution outcome to the telemetry JSONL file.
+ * Creates the telemetry directory if it doesn't exist.
+ */
+export declare function recordOutcome(record: OutcomeRecord, options?: {
+    basePath?: string;
+}): void;
+/**
+ * Build an outcome record from execution data.
+ */
+export declare function buildOutcomeRecord(params: {
+    prompt: string;
+    capabilities: readonly string[];
+    agents: readonly string[];
+    outcome: OutcomeStatus;
+    executionTimeMs: number;
+    userRating?: number | null;
+    contributions?: Record<string, AgentContribution>;
+}): OutcomeRecord;
+/**
+ * Load all outcome records from the telemetry file.
+ * Returns empty array if file doesn't exist.
+ */
+export declare function loadOutcomes(options?: {
+    basePath?: string;
+}): OutcomeRecord[];
+/**
+ * Load the most recent N outcome records.
+ */
+export declare function loadRecentOutcomes(count: number, options?: {
+    basePath?: string;
+}): OutcomeRecord[];
+/**
+ * Rotate the outcomes file, keeping only the most recent records.
+ * This prevents unbounded file growth.
+ */
+export declare function rotateOutcomes(maxRecords?: number, options?: {
+    basePath?: string;
+}): {
+    kept: number;
+    removed: number;
+};
+/**
+ * Get the path to the outcomes file.
+ */
+export declare function getOutcomesFilePath(basePath?: string): string;
+//# sourceMappingURL=outcome-recorder.d.ts.map

package/dist/routing/outcome-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome-recorder.d.ts","sourceRoot":"","sources":["../../src/routing/outcome-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC3E;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACnD,GAAG,aAAa,CAWhB;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,EAAE,CAqB7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,aAAa,EAAE,CAGjB;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAsBnC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D"}