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

package/dist/routing/outcome-recorder.js

@@ -0,0 +1,133 @@
+/**
+ * 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)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_TELEMETRY_DIR = '.agentics/telemetry';
+const OUTCOMES_FILE = 'outcomes.jsonl';
+const MAX_RECORDS = 1000;
+// ============================================================================
+// Recording
+// ============================================================================
+/**
+ * Record an execution outcome to the telemetry JSONL file.
+ * Creates the telemetry directory if it doesn't exist.
+ */
+export function recordOutcome(record, options) {
+    const basePath = options?.basePath ?? process.cwd();
+    const telemetryDir = path.join(basePath, DEFAULT_TELEMETRY_DIR);
+    const filePath = path.join(telemetryDir, OUTCOMES_FILE);
+    // Ensure directory exists
+    fs.mkdirSync(telemetryDir, { recursive: true });
+    // Append record as JSONL
+    const line = JSON.stringify(record) + '\n';
+    fs.appendFileSync(filePath, line, 'utf-8');
+}
+/**
+ * Build an outcome record from execution data.
+ */
+export function buildOutcomeRecord(params) {
+    return {
+        timestamp: new Date().toISOString(),
+        prompt_hash: hashPrompt(params.prompt),
+        capabilities_used: [...params.capabilities],
+        agents_selected: [...params.agents],
+        outcome: params.outcome,
+        user_rating: params.userRating ?? null,
+        execution_time_ms: params.executionTimeMs,
+        agent_contributions: params.contributions ?? buildDefaultContributions(params.agents, params.outcome),
+    };
+}
+// ============================================================================
+// Loading
+// ============================================================================
+/**
+ * Load all outcome records from the telemetry file.
+ * Returns empty array if file doesn't exist.
+ */
+export function loadOutcomes(options) {
+    const basePath = options?.basePath ?? process.cwd();
+    const filePath = path.join(basePath, DEFAULT_TELEMETRY_DIR, OUTCOMES_FILE);
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n').filter(line => line.trim().length > 0);
+    const records = [];
+    for (const line of lines) {
+        try {
+            records.push(JSON.parse(line));
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return records;
+}
+/**
+ * Load the most recent N outcome records.
+ */
+export function loadRecentOutcomes(count, options) {
+    const all = loadOutcomes(options);
+    return all.slice(-count);
+}
+// ============================================================================
+// Maintenance
+// ============================================================================
+/**
+ * Rotate the outcomes file, keeping only the most recent records.
+ * This prevents unbounded file growth.
+ */
+export function rotateOutcomes(maxRecords, options) {
+    const limit = maxRecords ?? MAX_RECORDS;
+    const basePath = options?.basePath ?? process.cwd();
+    const filePath = path.join(basePath, DEFAULT_TELEMETRY_DIR, OUTCOMES_FILE);
+    if (!fs.existsSync(filePath)) {
+        return { kept: 0, removed: 0 };
+    }
+    const records = loadOutcomes(options);
+    if (records.length <= limit) {
+        return { kept: records.length, removed: 0 };
+    }
+    const kept = records.slice(-limit);
+    const removed = records.length - kept.length;
+    // Rewrite file with only recent records
+    const content = kept.map(r => JSON.stringify(r)).join('\n') + '\n';
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return { kept: kept.length, removed };
+}
+/**
+ * Get the path to the outcomes file.
+ */
+export function getOutcomesFilePath(basePath) {
+    return path.join(basePath ?? process.cwd(), DEFAULT_TELEMETRY_DIR, OUTCOMES_FILE);
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function hashPrompt(prompt) {
+    const hash = crypto.createHash('sha256').update(prompt).digest('hex').slice(0, 12);
+    return `sha256:${hash}`;
+}
+function buildDefaultContributions(agents, outcome) {
+    const contributions = {};
+    const succeeded = outcome === 'success' || outcome === 'partial';
+    for (const agent of agents) {
+        contributions[agent] = {
+            produced_output: succeeded,
+            output_used: outcome === 'success',
+        };
+    }
+    return contributions;
+}
+//# sourceMappingURL=outcome-recorder.js.map

package/dist/routing/outcome-recorder.js.map

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

package/dist/routing/weight-adjuster.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Weight Adjuster (ADR-031 Phase 2)
+ *
+ * Calculates adjusted agent weights from telemetry outcome records.
+ * Uses exponential moving average (EMA) for gradual weight adaptation.
+ *
+ * Weight adjustments are written to a separate overlay file
+ * (docs/ecosystem.graph.weights.json) that does not modify the
+ * curated base graph.
+ */
+import type { OutcomeRecord } from './outcome-recorder.js';
+import type { WeightedAgent } from './weighted-resolver.js';
+export interface WeightOverlay {
+    readonly generated_at: string;
+    readonly total_outcomes: number;
+    readonly adjustments: readonly WeightAdjustment[];
+}
+export interface WeightAdjustment {
+    readonly capability: string;
+    readonly agent: string;
+    readonly original_weight: number;
+    readonly adjusted_weight: number;
+    readonly success_rate: number;
+    readonly usage_rate: number;
+    readonly sample_count: number;
+}
+/**
+ * Calculate adjusted weights for agents in a capability based on outcomes.
+ *
+ * Uses exponential moving average:
+ *   new_weight = old_weight * (1 - alpha) + observed_score * alpha
+ *
+ * Requires minimum sample count before adjusting.
+ */
+export declare function calculateAdjustedWeights(capability: string, agents: readonly WeightedAgent[], outcomes: readonly OutcomeRecord[]): WeightAdjustment[];
+/**
+ * Write weight adjustments to the overlay file.
+ * Does NOT modify the base ecosystem.graph.json.
+ */
+export declare function writeWeightOverlay(adjustments: readonly WeightAdjustment[], totalOutcomes: number, options?: {
+    basePath?: string;
+}): string;
+/**
+ * Load weight adjustments from the overlay file.
+ * Returns null if the file doesn't exist.
+ */
+export declare function loadWeightOverlay(options?: {
+    basePath?: string;
+}): WeightOverlay | null;
+/**
+ * Apply weight overlay adjustments to a set of agents.
+ * Returns agents with updated weights from the overlay.
+ */
+export declare function applyWeightOverlay(capability: string, agents: readonly WeightedAgent[], overlay: WeightOverlay): WeightedAgent[];
+/**
+ * Format weight adjustments as a human-readable report.
+ */
+export declare function formatAdjustmentReport(adjustments: readonly WeightAdjustment[]): string;
+//# sourceMappingURL=weight-adjuster.d.ts.map

package/dist/routing/weight-adjuster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weight-adjuster.d.ts","sourceRoot":"","sources":["../../src/routing/weight-adjuster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAgBD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,QAAQ,EAAE,SAAS,aAAa,EAAE,GACjC,gBAAgB,EAAE,CAmDpB;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,SAAS,gBAAgB,EAAE,EACxC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,MAAM,CAYR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,aAAa,GAAG,IAAI,CActB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,OAAO,EAAE,aAAa,GACrB,aAAa,EAAE,CAoBjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CA+BvF"}

package/dist/routing/weight-adjuster.js

@@ -0,0 +1,167 @@
+/**
+ * Weight Adjuster (ADR-031 Phase 2)
+ *
+ * Calculates adjusted agent weights from telemetry outcome records.
+ * Uses exponential moving average (EMA) for gradual weight adaptation.
+ *
+ * Weight adjustments are written to a separate overlay file
+ * (docs/ecosystem.graph.weights.json) that does not modify the
+ * curated base graph.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ============================================================================
+// Constants
+// ============================================================================
+const MIN_SAMPLES = 20;
+const ALPHA = 0.1; // EMA smoothing factor (slow adaptation)
+const MIN_WEIGHT = 0.05;
+const MAX_WEIGHT = 1.0;
+const WEIGHT_OVERLAY_FILE = 'ecosystem.graph.weights.json';
+// ============================================================================
+// Weight Calculation
+// ============================================================================
+/**
+ * Calculate adjusted weights for agents in a capability based on outcomes.
+ *
+ * Uses exponential moving average:
+ *   new_weight = old_weight * (1 - alpha) + observed_score * alpha
+ *
+ * Requires minimum sample count before adjusting.
+ */
+export function calculateAdjustedWeights(capability, agents, outcomes) {
+    // Filter outcomes that used this capability
+    const relevantOutcomes = outcomes.filter(o => o.capabilities_used.includes(capability));
+    if (relevantOutcomes.length < MIN_SAMPLES) {
+        return []; // Not enough data
+    }
+    const adjustments = [];
+    for (const agent of agents) {
+        // Count how many times this agent was selected
+        const selections = relevantOutcomes.filter(o => o.agents_selected.includes(agent.name));
+        if (selections.length === 0)
+            continue;
+        // Calculate success rate
+        const successes = selections.filter(o => o.outcome === 'success').length;
+        const successRate = successes / selections.length;
+        // Calculate usage rate (output was actually consumed)
+        const usages = selections.filter(o => {
+            const contrib = o.agent_contributions[agent.name];
+            return contrib?.output_used === true;
+        }).length;
+        const usageRate = usages / selections.length;
+        // Combined score (equal weight to success and usage)
+        const observedScore = successRate * 0.5 + usageRate * 0.5;
+        // EMA adjustment
+        const adjustedWeight = clampWeight(agent.weight * (1 - ALPHA) + observedScore * ALPHA);
+        adjustments.push({
+            capability,
+            agent: agent.name,
+            original_weight: agent.weight,
+            adjusted_weight: adjustedWeight,
+            success_rate: round(successRate, 4),
+            usage_rate: round(usageRate, 4),
+            sample_count: selections.length,
+        });
+    }
+    return adjustments;
+}
+// ============================================================================
+// Overlay File Management
+// ============================================================================
+/**
+ * Write weight adjustments to the overlay file.
+ * Does NOT modify the base ecosystem.graph.json.
+ */
+export function writeWeightOverlay(adjustments, totalOutcomes, options) {
+    const basePath = options?.basePath ?? process.cwd();
+    const filePath = path.join(basePath, 'docs', WEIGHT_OVERLAY_FILE);
+    const overlay = {
+        generated_at: new Date().toISOString(),
+        total_outcomes: totalOutcomes,
+        adjustments: [...adjustments],
+    };
+    fs.writeFileSync(filePath, JSON.stringify(overlay, null, 2) + '\n', 'utf-8');
+    return filePath;
+}
+/**
+ * Load weight adjustments from the overlay file.
+ * Returns null if the file doesn't exist.
+ */
+export function loadWeightOverlay(options) {
+    const basePath = options?.basePath ?? process.cwd();
+    const filePath = path.join(basePath, 'docs', WEIGHT_OVERLAY_FILE);
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Apply weight overlay adjustments to a set of agents.
+ * Returns agents with updated weights from the overlay.
+ */
+export function applyWeightOverlay(capability, agents, overlay) {
+    const adjustmentMap = new Map();
+    for (const adj of overlay.adjustments) {
+        if (adj.capability === capability) {
+            adjustmentMap.set(adj.agent, adj.adjusted_weight);
+        }
+    }
+    if (adjustmentMap.size === 0) {
+        return [...agents];
+    }
+    return agents.map(agent => {
+        const adjustedWeight = adjustmentMap.get(agent.name);
+        if (adjustedWeight !== undefined) {
+            return { ...agent, weight: adjustedWeight };
+        }
+        return agent;
+    });
+}
+/**
+ * Format weight adjustments as a human-readable report.
+ */
+export function formatAdjustmentReport(adjustments) {
+    if (adjustments.length === 0) {
+        return 'No weight adjustments calculated (insufficient data or no changes).';
+    }
+    const lines = ['Weight Adjustment Report', '='.repeat(50)];
+    // Group by capability
+    const byCapability = new Map();
+    for (const adj of adjustments) {
+        const existing = byCapability.get(adj.capability);
+        if (existing) {
+            existing.push(adj);
+        }
+        else {
+            byCapability.set(adj.capability, [adj]);
+        }
+    }
+    for (const [capability, adjs] of byCapability) {
+        lines.push(`\n  ${capability}:`);
+        for (const adj of adjs) {
+            const delta = adj.adjusted_weight - adj.original_weight;
+            const direction = delta >= 0 ? '+' : '';
+            lines.push(`    ${adj.agent}: ${adj.original_weight.toFixed(2)} → ${adj.adjusted_weight.toFixed(2)} (${direction}${delta.toFixed(3)})` +
+                `  [success=${(adj.success_rate * 100).toFixed(0)}%, usage=${(adj.usage_rate * 100).toFixed(0)}%, n=${adj.sample_count}]`);
+        }
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function clampWeight(w) {
+    return Math.max(MIN_WEIGHT, Math.min(MAX_WEIGHT, w));
+}
+function round(n, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(n * factor) / factor;
+}
+//# sourceMappingURL=weight-adjuster.js.map

package/dist/routing/weight-adjuster.js.map

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

package/dist/routing/weighted-resolver.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Weighted Agent Resolver (ADR-031 Phase 1)
+ *
+ * Weight-aware agent selection that replaces flat agent lists with
+ * prioritized selection based on weight scores and role classification.
+ *
+ * Backward compatible: plain string agents are treated as
+ * { name: string, weight: 1.0, role: "primary" }.
+ */
+export type AgentRole = 'primary' | 'secondary' | 'specialist';
+export interface WeightedAgent {
+    readonly name: string;
+    readonly weight: number;
+    readonly role: AgentRole;
+}
+/** Input can be either a plain string or a weighted agent object. */
+export type AgentInput = string | WeightedAgent;
+/**
+ * Normalize an agent input (string or weighted object) into a WeightedAgent.
+ * Plain strings get weight 1.0 and role "primary".
+ */
+export declare function normalizeAgent(input: AgentInput): WeightedAgent;
+/**
+ * Normalize an array of agent inputs into weighted agents.
+ */
+export declare function normalizeAgents(inputs: readonly AgentInput[]): WeightedAgent[];
+/**
+ * Extract the agent name from any agent input form.
+ */
+export declare function getAgentName(input: AgentInput): string;
+export interface WeightedSelectionOptions {
+    /** Maximum number of agents to select. */
+    readonly budget: number;
+    /** Tags from the user prompt for specialist matching. */
+    readonly promptTags?: readonly string[];
+}
+/**
+ * Select agents from a capability using weight-aware prioritization.
+ *
+ * Algorithm:
+ * 1. Select all primary agents (sorted by weight descending)
+ * 2. Fill remaining budget with secondary agents (by weight)
+ * 3. Add specialists only when prompt tags match capability tags
+ * 4. Enforce budget ceiling
+ */
+export declare function selectWeightedAgents(agents: readonly AgentInput[], options: WeightedSelectionOptions): WeightedAgent[];
+/**
+ * Validate agent input format. Returns error messages or empty array.
+ */
+export declare function validateAgentInput(input: unknown, path: string): string[];
+/**
+ * Check if an agent input is in weighted object format.
+ */
+export declare function isWeightedAgent(input: unknown): input is WeightedAgent;
+//# sourceMappingURL=weighted-resolver.d.ts.map

package/dist/routing/weighted-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weighted-resolver.d.ts","sourceRoot":"","sources":["../../src/routing/weighted-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAS/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,aAAa,EAAE,CAE9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEtD;AAMD,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,OAAO,EAAE,wBAAwB,GAChC,aAAa,EAAE,CAuCjB;AAQD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAItE"}

package/dist/routing/weighted-resolver.js

@@ -0,0 +1,133 @@
+/**
+ * Weighted Agent Resolver (ADR-031 Phase 1)
+ *
+ * Weight-aware agent selection that replaces flat agent lists with
+ * prioritized selection based on weight scores and role classification.
+ *
+ * Backward compatible: plain string agents are treated as
+ * { name: string, weight: 1.0, role: "primary" }.
+ */
+// ============================================================================
+// Normalization
+// ============================================================================
+/**
+ * Normalize an agent input (string or weighted object) into a WeightedAgent.
+ * Plain strings get weight 1.0 and role "primary".
+ */
+export function normalizeAgent(input) {
+    if (typeof input === 'string') {
+        return { name: input, weight: 1.0, role: 'primary' };
+    }
+    return {
+        name: input.name,
+        weight: clampWeight(input.weight),
+        role: input.role ?? 'primary',
+    };
+}
+/**
+ * Normalize an array of agent inputs into weighted agents.
+ */
+export function normalizeAgents(inputs) {
+    return inputs.map(normalizeAgent);
+}
+/**
+ * Extract the agent name from any agent input form.
+ */
+export function getAgentName(input) {
+    return typeof input === 'string' ? input : input.name;
+}
+/**
+ * Select agents from a capability using weight-aware prioritization.
+ *
+ * Algorithm:
+ * 1. Select all primary agents (sorted by weight descending)
+ * 2. Fill remaining budget with secondary agents (by weight)
+ * 3. Add specialists only when prompt tags match capability tags
+ * 4. Enforce budget ceiling
+ */
+export function selectWeightedAgents(agents, options) {
+    const normalized = normalizeAgents(agents);
+    const { budget, promptTags } = options;
+    if (budget <= 0)
+        return [];
+    if (normalized.length === 0)
+        return [];
+    // Sort all agents by weight descending
+    const sorted = [...normalized].sort((a, b) => b.weight - a.weight);
+    // Step 1: Select primary agents
+    const primary = sorted.filter(a => a.role === 'primary');
+    const selected = primary.slice(0, budget);
+    // Step 2: Fill with secondary agents
+    if (selected.length < budget) {
+        const secondary = sorted.filter(a => a.role === 'secondary');
+        const remaining = budget - selected.length;
+        selected.push(...secondary.slice(0, remaining));
+    }
+    // Step 3: Add matching specialists (can exceed budget by specialist count)
+    if (promptTags && promptTags.length > 0) {
+        const tagSet = new Set(promptTags.map(t => t.toLowerCase()));
+        const specialists = sorted.filter(a => a.role === 'specialist' && !selected.some(s => s.name === a.name));
+        for (const spec of specialists) {
+            // Specialist name tokens are matched against prompt tags
+            const nameTokens = spec.name.toLowerCase().split(/[\s\-_]+/);
+            const hasMatch = nameTokens.some(t => tagSet.has(t));
+            if (hasMatch) {
+                selected.push(spec);
+            }
+        }
+    }
+    // Step 4: Enforce hard budget (specialists can push over)
+    return selected.slice(0, Math.max(budget, selected.length));
+}
+// ============================================================================
+// Validation
+// ============================================================================
+const VALID_ROLES = new Set(['primary', 'secondary', 'specialist']);
+/**
+ * Validate agent input format. Returns error messages or empty array.
+ */
+export function validateAgentInput(input, path) {
+    const errors = [];
+    if (typeof input === 'string') {
+        if (input.length === 0) {
+            errors.push(`${path}: agent name must be non-empty`);
+        }
+        return errors;
+    }
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        errors.push(`${path}: agent must be a string or { name, weight, role } object`);
+        return errors;
+    }
+    const obj = input;
+    if (typeof obj['name'] !== 'string' || obj['name'].length === 0) {
+        errors.push(`${path}.name: must be a non-empty string`);
+    }
+    if (typeof obj['weight'] !== 'number') {
+        errors.push(`${path}.weight: must be a number`);
+    }
+    else if (obj['weight'] < 0 || obj['weight'] > 1) {
+        errors.push(`${path}.weight: must be between 0.0 and 1.0, got ${obj['weight']}`);
+    }
+    if ('role' in obj && obj['role'] !== undefined) {
+        if (typeof obj['role'] !== 'string' || !VALID_ROLES.has(obj['role'])) {
+            errors.push(`${path}.role: must be "primary", "secondary", or "specialist", got "${String(obj['role'])}"`);
+        }
+    }
+    return errors;
+}
+/**
+ * Check if an agent input is in weighted object format.
+ */
+export function isWeightedAgent(input) {
+    if (typeof input !== 'object' || input === null)
+        return false;
+    const obj = input;
+    return typeof obj['name'] === 'string' && typeof obj['weight'] === 'number';
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function clampWeight(w) {
+    return Math.max(0, Math.min(1, w));
+}
+//# sourceMappingURL=weighted-resolver.js.map

package/dist/routing/weighted-resolver.js.map

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

package/dist/synthesis/ask-artifact-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-artifact-writer.d.ts","sourceRoot":"","sources":["../../src/synthesis/ask-artifact-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgBH,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAa/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAg5BD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAmBjF;AA6DD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA2E9D"}
+{"version":3,"file":"ask-artifact-writer.d.ts","sourceRoot":"","sources":["../../src/synthesis/ask-artifact-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAa/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAg5BD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAmBjF;AAoED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA2E9D"}

package/dist/synthesis/ask-artifact-writer.js

@@ -12,6 +12,7 @@
  *
  * All persistence is NON-FATAL — errors warn but never block result display.
  */
+import { execSync } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
@@ -862,6 +863,13 @@ function persistProjectMode(input, execCtx) {
         const msg = err instanceof Error ? err.message : String(err);
         console.error(`  [WARN] Failed to commit artifacts: ${msg}`);
     }
+    // Push the branch to remote so the GitHub URL is valid
+    try {
+        execSync(`git push -u origin ${branch}`, { stdio: 'pipe', timeout: 30000 });
+    }
+    catch {
+        console.error('  [WARN] Could not push artifacts branch to remote');
+    }
     // Return to original branch
     checkoutBranch(originalBranch);
     // Build GitHub URL