@llm-dev-ops/agentics-cli 2.4.0 → 2.5.1

package/dist/commands/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"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"}

package/dist/commands/agents.js

@@ -94,6 +94,94 @@ async function runCopilotViaClaudeMax(agent, payload, correlationId) {
         return null; // claude --print failed — fall through to cloud function
     }
 }
+// ADR-066 extension: inference-gateway/route via claude --print.
+// The gateway's "route" agent is a pure reasoning task (pick best provider/model
+// for a request given hints). We run it locally through the user's Claude Max
+// session so no server-side Anthropic API key is required.
+async function runInferenceRoutingViaClaudeMax(payload, correlationId) {
+    let claudeBin = null;
+    const envBin = process.env['AGENTICS_CLAUDE_BIN'];
+    if (envBin) {
+        claudeBin = envBin;
+    }
+    else {
+        for (const candidate of ['claude', 'claude-code']) {
+            try {
+                const found = execFileSync(process.platform === 'win32' ? 'where' : 'which', [candidate], { stdio: ['pipe', 'pipe', 'pipe'], timeout: 5_000, encoding: 'utf-8' }).trim().split(/\r?\n/)[0]?.trim();
+                if (found) {
+                    claudeBin = found;
+                    break;
+                }
+            }
+            catch { /* not found */ }
+        }
+    }
+    if (!claudeBin)
+        return null;
+    const systemPrompt = [
+        'You are an inference routing advisor.',
+        'Given an inference request and routing hints, choose the best (provider, model) pair.',
+        'Return ONLY valid JSON (no markdown fences) with shape:',
+        '{',
+        '  "chosen_provider": "anthropic" | "openai" | "google",',
+        '  "chosen_model": "<model-id>",',
+        '  "routing_decision": {',
+        '    "rationale": "<one-sentence reason>",',
+        '    "estimated_latency_ms": <number>,',
+        '    "estimated_cost_usd_per_1k_tokens": <number>,',
+        '    "quality_tier": "tier-1" | "tier-2" | "tier-3"',
+        '  },',
+        '  "fallbacks": [{ "provider": "...", "model": "...", "reason": "..." }],',
+        '  "honored_hints": [<list of hint fields respected>]',
+        '}',
+        'Honor hints.preferred_providers and hints.excluded_providers strictly.',
+        'Honor hints.max_latency_tier (1=fastest, 3=slowest-tolerable).',
+        'If hints.optimize_cost is true, prefer cheaper models when quality allows.',
+        'If request.model is specified and not excluded, prefer honoring it.',
+    ].join('\n');
+    const fullPrompt = `${systemPrompt}\n\nRequest:\n${JSON.stringify(payload, null, 2)}`;
+    try {
+        const rawOutput = execFileSync(claudeBin, [
+            '--print',
+            '--output-format', 'text',
+            '--model', process.env['AGENTICS_CLAUDE_MODEL'] || 'claude-sonnet-4-20250514',
+            fullPrompt,
+        ], {
+            encoding: 'utf-8',
+            timeout: 60_000,
+            maxBuffer: 5 * 1024 * 1024,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, MCP_SERVER_MODE: undefined },
+        });
+        let cleaned = rawOutput.trim();
+        if (cleaned.startsWith('```')) {
+            cleaned = cleaned.replace(/^```(?:json)?\s*\n?/, '').replace(/\n?```\s*$/, '');
+        }
+        const jsonMatch = cleaned.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            return null;
+        const parsed = JSON.parse(jsonMatch[0]);
+        return {
+            ...parsed,
+            _source: 'claude-max',
+            execution_metadata: {
+                trace_id: correlationId,
+                timestamp: new Date().toISOString(),
+                service: 'inference-gateway-agents',
+                execution_id: correlationId,
+                agent: 'inference-routing-agent',
+                engine: 'claude-max',
+            },
+            layers_executed: [
+                { layer: 'AGENT_ROUTING', status: 'completed' },
+                { layer: 'INFERENCE_GATEWAY_ROUTE', status: 'completed' },
+            ],
+        };
+    }
+    catch {
+        return null;
+    }
+}
 export const AGENT_DOMAINS = {
     'test-bench': {
         serviceName: 'test-bench-agents',
@@ -230,6 +318,53 @@ export const AGENT_DOMAINS = {
         agents: ['decision', 'executive-summary', 'decision-memo', 'risk-score'],
         phase: 'Phase 9: Apex Platform',
     },
+    // ADR-PIPELINE-080 registered quality_engineering in the ecosystem graph and
+    // wired agentic-qe into repo-agent-runner FUNCTION_NAMES, but left the
+    // dispatch-time AGENT_DOMAINS registry untouched. ADR-PIPELINE-087 §1
+    // restores the missing entry so resolveAgentRef() → executeAgentsInvokeCommand
+    // does not throw "Unknown domain" on AQE selections.
+    'quality-engineering': {
+        serviceName: 'agentic-qe-agents',
+        agents: [
+            'test-design',
+            'unit-test-gen',
+            'integration-test-gen',
+            'property-test-gen',
+            'bdd-test-gen',
+            'coverage-analysis',
+            'coverage-gap-detect',
+            'defect-prediction',
+            'flaky-detection',
+            'rca',
+            'traceability',
+            'chaos',
+            'test-execution',
+            'qe-reporting',
+        ],
+        phase: 'Phase 8: Validation',
+    },
+    // diligence-artifacts is driven by phase coordinators (phase2/phase3/phase4)
+    // rather than cloud-function dispatch. Registering it here lets
+    // ADR-PIPELINE-087 §1 resolve SPARC/ADR/DDD classifier selections to a known
+    // domain — dispatch returns a pipeline-owned-elsewhere 502 instead of the
+    // previous silent drop, which is the visibility the ADR is enforcing.
+    'diligence-artifacts': {
+        serviceName: 'diligence-artifacts',
+        agents: [
+            'sparc-specification',
+            'sparc-pseudocode',
+            'sparc-architecture',
+            'sparc-refinement',
+            'sparc-completion',
+            'sparc-merge',
+            'adr-generation',
+            'ddd-domain-model',
+            'context-map',
+            'adr-validator',
+            'documentation',
+        ],
+        phase: 'Phase 3-5: Diligence Artifacts',
+    },
 };
 // ============================================================================
 // Command Implementations
@@ -323,11 +458,35 @@ export async function executeAgentsInvokeCommand(domain, agent, payload, options
             invokeHeaders['X-Anthropic-Api-Key'] = anthropicKey;
         }
     }
-    // governance-dashboard and policy-engine require execution context in HTTP headers
-    if (domain === 'governance-dashboard' || domain === 'policy-engine') {
+    // ADR-066 extension: inference-gateway/route via Claude Max — the gateway's
+    // route agent is a reasoning task, so we run it locally through the user's
+    // Claude session instead of requiring a server-side Anthropic API key.
+    if (domain === 'inference-gateway' && agent === 'route') {
+        const routingResult = await runInferenceRoutingViaClaudeMax(normalizedPayload, correlationId);
+        if (routingResult) {
+            return {
+                domain,
+                agent,
+                status: 200,
+                response: routingResult,
+                timing: Date.now() - start,
+            };
+        }
+        // Fall through to cloud function (which will 503 without provider keys)
+        // and then to the existing computeUniversalFallback path.
+    }
+    // governance-dashboard, policy-engine, and costops require execution context in HTTP headers
+    if (domain === 'governance-dashboard' || domain === 'policy-engine' || domain === 'costops') {
         invokeHeaders['x-execution-id'] = correlationId;
         invokeHeaders['x-parent-span-id'] = correlationId;
     }
+    // research-lab requires execution_context as a top-level body field (not headers).
+    if (domain === 'research-lab' && normalizedPayload && typeof normalizedPayload === 'object') {
+        normalizedPayload = {
+            ...normalizedPayload,
+            execution_context: { execution_id: correlationId, parent_span_id: correlationId },
+        };
+    }
     let response;
     try {
         response = await adapter.invoke({
@@ -2028,7 +2187,7 @@ function extractScenarioContext(query) {
  * simulator wants "scenario_id" + "parameters"). This function maps the user's
  * natural-language query into the correct shape.
  */
-function buildDomainPayload(domain, agent, query, correlationId) {
+export function buildDomainPayload(domain, agent, query, correlationId) {
     // Some agents have strict schema validation and reject unknown properties.
     // Only include execution_ref for agents that accept it.
     const base = { execution_ref: correlationId };
@@ -3733,12 +3892,19 @@ export async function executeNaturalLanguageRoute(query, options) {
                     const artMsg = artifactErr instanceof Error ? artifactErr.message : String(artifactErr);
                     console.error(`[WARN] Graph-routed artifact generation failed: ${artMsg}`);
                 }
+                // ADR-PIPELINE-087 §4: propagate classifier-selected-but-unresolved
+                // agents to the caller. Empty array is the healthy case; any entry
+                // indicates a graph→resolver gap (→ CI guard, §8) or a rename drift.
+                const routingMeta = graphResult.unresolved.length > 0
+                    ? { unresolved: graphResult.unresolved.map(u => ({ stage: u.stage, agentName: u.agentName, capability: u.capability })) }
+                    : { unresolved: [] };
                 return {
                     kind: 'multi',
                     result: {
                         query,
                         intents,
                         invocations,
+                        routing: routingMeta,
                         timing: elapsed,
                     },
                 };
@@ -4105,6 +4271,18 @@ export function formatMultiAgentRouteForDisplay(result) {
     lines.push(`Agents invoked: ${agentCount} (${succeeded} succeeded${failed > 0 ? `, ${failed} failed` : ''})`);
     lines.push(`Total Timing: ${result.timing}ms`);
     lines.push('');
+    // ADR-PIPELINE-087 §4: surface unresolved classifier selections at the top
+    // of the display so operators (and MCP clients relaying stdout) see the
+    // routing gap immediately instead of having to infer it from missing work.
+    const unresolved = result.routing?.unresolved ?? [];
+    if (unresolved.length > 0) {
+        lines.push(`⚠️  Routing gaps — ${unresolved.length} classifier-selected agent${unresolved.length === 1 ? '' : 's'} not dispatched (ADR-PIPELINE-087 §4):`);
+        for (const u of unresolved) {
+            lines.push(`   - ${u.stage}: ${u.agentName} (capability "${u.capability}")`);
+        }
+        lines.push('   Fix: add these names to AGENT_NAME_TO_DOMAIN in src/routing/graph-router.ts.');
+        lines.push('');
+    }
     for (const inv of result.invocations) {
         const label = `[${inv.intent.domain}/${inv.intent.agent}]`;
         if ('error' in inv.result) {
@@ -4137,6 +4315,11 @@ export function routeResultToJson(routeResult, query) {
                 reasoning: i.intent.reasoning,
                 result: 'error' in i.result ? { error: i.result.error } : i.result,
             })),
+            // ADR-PIPELINE-087 §4: include routing.unresolved in the JSON envelope
+            // so programmatic consumers (MCP clients, CI) can detect drops.
+            routing: {
+                unresolved: routeResult.result.routing?.unresolved ?? [],
+            },
             timing: routeResult.result.timing,
         };
     }