agentic-qe 3.9.13 → 3.9.15

package/dist/mcp/protocol-server.js

@@ -588,7 +588,7 @@ export class MCPProtocolServer {
                 category: 'agent',
                 isConcurrencySafe: true,
                 parameters: [
-                    { name: 'agentId', type: 'string', description: 'Specific agent ID' },
+                    { name: 'agentId', type: 'string', description: 'Specific agent ID', required: true },
                 ],
             },
             handler: (params) => handleAgentMetrics(params),
@@ -714,7 +714,7 @@ export class MCPProtocolServer {
                 category: 'domain',
                 isConcurrencySafe: true,
                 parameters: [
-                    { name: 'target', type: 'string', description: 'Target path to analyze' },
+                    { name: 'target', type: 'string', description: 'Target path to analyze', required: true },
                     { name: 'detectGaps', type: 'boolean', description: 'Detect coverage gaps', default: true },
                 ],
             },
@@ -766,7 +766,7 @@ export class MCPProtocolServer {
                 description: 'Test accessibility against WCAG 2.1/2.2 and Section 508 standards. Example: accessibility_test({ url: "http://localhost:3000", standard: "wcag21-aa" })',
                 category: 'domain',
                 parameters: [
-                    { name: 'url', type: 'string', description: 'URL to test' },
+                    { name: 'url', type: 'string', description: 'URL to test', required: true },
                     { name: 'standard', type: 'string', description: 'Accessibility standard' },
                 ],
             },
@@ -793,7 +793,7 @@ export class MCPProtocolServer {
                 category: 'domain',
                 isConcurrencySafe: true,
                 parameters: [
-                    { name: 'target', type: 'string', description: 'Target path' },
+                    { name: 'target', type: 'string', description: 'Target path', required: true },
                 ],
             },
             handler: (params) => handleDefectPredict(params),
@@ -819,7 +819,7 @@ export class MCPProtocolServer {
                 category: 'domain',
                 isConcurrencySafe: true,
                 parameters: [
-                    { name: 'target', type: 'string', description: 'Target path' },
+                    { name: 'target', type: 'string', description: 'Target path', required: true },
                 ],
             },
             handler: (params) => handleCodeIndex(params),
@@ -1232,8 +1232,8 @@ export class MCPProtocolServer {
                 description: 'Consult a stronger advisor model for strategic guidance. Forwards a task description and context to the advisor and returns enumerated action steps. Auto-detects the best available provider. Example: advisor_consult({ agent: "qe-test-architect", task: "Generate tests for auth module", context: "Found 4 classes with external deps" })',
                 category: 'routing',
                 parameters: [
-                    { name: 'agent', type: 'string', description: 'Agent name requesting advice (e.g., qe-test-architect)' },
-                    { name: 'task', type: 'string', description: 'Task description' },
+                    { name: 'agent', type: 'string', description: 'Agent name requesting advice (e.g., qe-test-architect)', required: true },
+                    { name: 'task', type: 'string', description: 'Task description', required: true },
                     { name: 'context', type: 'string', description: 'What the executor has found so far' },
                     { name: 'provider', type: 'string', description: 'Provider override (openrouter, claude, ollama)' },
                     { name: 'model', type: 'string', description: 'Model override' },
@@ -1245,13 +1245,23 @@ export class MCPProtocolServer {
                 const { join } = await import('path');
                 const { tmpdir } = await import('os');
                 const p = params;
+                // ADR-092 contract enforcement: reject empty/missing required fields early
+                // instead of shelling out to `aqe llm advise` with placeholder values.
+                const agent = typeof p.agent === 'string' ? p.agent.trim() : '';
+                const task = typeof p.task === 'string' ? p.task.trim() : '';
+                if (!agent) {
+                    return { error: "advisor_consult: 'agent' is required (non-empty string)" };
+                }
+                if (!task) {
+                    return { error: "advisor_consult: 'task' is required (non-empty string)" };
+                }
                 const transcriptDir = join(tmpdir(), 'aqe-advisor');
                 mkdirSync(transcriptDir, { recursive: true });
                 const transcriptPath = join(transcriptDir, `mcp-${Date.now()}.json`);
                 const transcript = {
-                    taskDescription: p.task ?? '',
+                    taskDescription: task,
                     messages: [
-                        { role: 'user', content: p.task ?? '' },
+                        { role: 'user', content: task },
                         ...(p.context ? [{ role: 'assistant', content: p.context }] : []),
                     ],
                 };
@@ -1260,7 +1270,7 @@ export class MCPProtocolServer {
                     const cliArgs = [
                         'llm', 'advise',
                         '--transcript', transcriptPath,
-                        '--agent', p.agent ?? 'unknown',
+                        '--agent', agent,
                         '--json',
                     ];
                     if (p.provider)

package/dist/validation/command-eval-runner.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Command Eval Runner — shell-command-based eval suite execution.
+ *
+ * Sibling to {@link ParallelEvalRunner} (which evaluates LLM prompts against
+ * keyword-match patterns). This runner is for skills whose eval suite is a
+ * set of shell commands that produce JSON envelopes — e.g. qe-browser, whose
+ * five primitives (assert, batch, visual-diff, check-injection, intent-score)
+ * are Node scripts that exit 0/1 with structured stdout.
+ *
+ * Detection is by suite shape, not by an explicit type tag: if the first test
+ * case has `input.command`, we treat the suite as command-mode.
+ *
+ * Supported assertions per test case:
+ *   - `exit_code`: strict equality against the process exit code
+ *   - `json_fields`: a map of dotted JSONPath -> expected value, evaluated
+ *     against parsed stdout JSON
+ *   - `severity_at_least`: ordered comparison against
+ *     `.output.checkInjection.severity` in the range
+ *     `none < low < medium < high < critical`
+ *   - `candidate_count_at_least`: numeric lower bound on
+ *     `.output.intentScore.candidateCount`
+ *
+ * Setup steps in `input.setup[]` run sequentially before the main command;
+ * any non-zero setup exit short-circuits the test case as failed.
+ */
+declare const SEVERITY_ORDER: readonly ["none", "low", "medium", "high", "critical"];
+export type Severity = (typeof SEVERITY_ORDER)[number];
+/**
+ * Return true iff `actual` is at or above `threshold` on the severity scale.
+ * Unknown severities return false (conservative — we never silently pass).
+ */
+export declare function severityAtLeast(actual: unknown, threshold: Severity): boolean;
+/**
+ * Evaluate a simple dotted JSONPath like `.output.assert.passed` against an
+ * already-parsed JSON value. Returns `undefined` if any segment is missing.
+ *
+ * We intentionally support only dotted paths (no `[idx]`, no filters) because
+ * that's the full surface area used by qe-browser's output schemas.
+ */
+export declare function evalJsonPath(obj: unknown, jsonPath: string): unknown;
+export type TestCasePriority = 'critical' | 'high' | 'medium' | 'low';
+export interface CommandEvalExpected {
+    exit_code?: number;
+    /** Dotted JSONPath → expected JSON value (deep equality). */
+    json_fields?: Record<string, unknown>;
+    severity_at_least?: Severity;
+    candidate_count_at_least?: number;
+}
+export interface CommandEvalTestCase {
+    id: string;
+    description?: string;
+    category?: string;
+    priority?: TestCasePriority;
+    input: {
+        setup?: string[];
+        command: string;
+    };
+    expected: CommandEvalExpected;
+}
+export interface CommandEvalSuite {
+    skill: string;
+    version?: string;
+    status?: 'design-spec' | 'active' | 'deprecated';
+    description?: string;
+    test_cases: CommandEvalTestCase[];
+    validation?: {
+        required_pass_rate?: number;
+        critical_must_pass?: boolean;
+    };
+}
+export interface CommandEvalTestResult {
+    testId: string;
+    passed: boolean;
+    category?: string;
+    priority?: TestCasePriority;
+    exitCode: number | null;
+    stdoutSnippet: string;
+    stderrSnippet: string;
+    /** Assertion failures — empty when passed. */
+    failures: string[];
+    durationMs: number;
+    /** Set when a setup step failed before the main command ran. */
+    setupFailure?: string;
+}
+export interface CommandEvalResult {
+    skill: string;
+    passed: boolean;
+    totalTests: number;
+    passedTests: number;
+    failedTests: number;
+    passRate: number;
+    /** True iff every test with priority=critical passed. */
+    criticalPassed: boolean;
+    testResults: CommandEvalTestResult[];
+    totalDurationMs: number;
+    timestamp: Date;
+}
+/** Injectable runner so tests don't spawn real processes. */
+export type CommandRunner = (cmd: string, options: {
+    timeoutMs: number;
+    cwd: string;
+}) => {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+};
+/**
+ * A suite is command-eval mode when the first test case has `input.command`.
+ * We use this to dispatch from the shared `aqe eval` CLI without requiring a
+ * new explicit type tag in every existing LLM-style yaml.
+ */
+export declare function isCommandEvalSuite(raw: unknown): raw is CommandEvalSuite;
+/**
+ * Validate a single test-case result against its expected block.
+ * Returns the list of failures (empty == passed).
+ *
+ * Parses stdout as JSON only if at least one assertion needs it, so commands
+ * that only care about `exit_code` don't require JSON output.
+ */
+export declare function validateCommandResult(tc: CommandEvalTestCase, exitCode: number | null, stdout: string): {
+    passed: boolean;
+    failures: string[];
+};
+export interface CommandEvalRunnerOptions {
+    /** Directory containing skill directories (default: `.claude/skills`). */
+    skillsDir?: string;
+    /** Per-command timeout in milliseconds (default: 60s). */
+    timeoutMs?: number;
+    /** Working directory for commands (default: `process.cwd()`). */
+    cwd?: string;
+    /** Injected runner for tests. */
+    runner?: CommandRunner;
+}
+export declare class CommandEvalRunner {
+    private readonly skillsDir;
+    private readonly timeoutMs;
+    private readonly cwd;
+    private readonly runner;
+    constructor(options?: CommandEvalRunnerOptions);
+    /**
+     * Load `${skill}/evals/${skill}.yaml` and return it iff it's a command-mode
+     * suite. Returns null if missing, unparseable, or not command-mode.
+     */
+    loadSuite(skill: string): CommandEvalSuite | null;
+    run(skill: string): Promise<CommandEvalResult>;
+    private executeCase;
+}
+/**
+ * Convenience factory.
+ */
+export declare function createCommandEvalRunner(options?: CommandEvalRunnerOptions): CommandEvalRunner;
+export {};
+//# sourceMappingURL=command-eval-runner.d.ts.map

package/dist/validation/command-eval-runner.js

@@ -0,0 +1,293 @@
+/**
+ * Command Eval Runner — shell-command-based eval suite execution.
+ *
+ * Sibling to {@link ParallelEvalRunner} (which evaluates LLM prompts against
+ * keyword-match patterns). This runner is for skills whose eval suite is a
+ * set of shell commands that produce JSON envelopes — e.g. qe-browser, whose
+ * five primitives (assert, batch, visual-diff, check-injection, intent-score)
+ * are Node scripts that exit 0/1 with structured stdout.
+ *
+ * Detection is by suite shape, not by an explicit type tag: if the first test
+ * case has `input.command`, we treat the suite as command-mode.
+ *
+ * Supported assertions per test case:
+ *   - `exit_code`: strict equality against the process exit code
+ *   - `json_fields`: a map of dotted JSONPath -> expected value, evaluated
+ *     against parsed stdout JSON
+ *   - `severity_at_least`: ordered comparison against
+ *     `.output.checkInjection.severity` in the range
+ *     `none < low < medium < high < critical`
+ *   - `candidate_count_at_least`: numeric lower bound on
+ *     `.output.intentScore.candidateCount`
+ *
+ * Setup steps in `input.setup[]` run sequentially before the main command;
+ * any non-zero setup exit short-circuits the test case as failed.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'yaml';
+import { spawnSync as realSpawnSync } from 'node:child_process';
+import { toErrorMessage } from '../shared/error-utils.js';
+// ============================================================================
+// Severity ordering
+// ============================================================================
+const SEVERITY_ORDER = ['none', 'low', 'medium', 'high', 'critical'];
+/**
+ * Return true iff `actual` is at or above `threshold` on the severity scale.
+ * Unknown severities return false (conservative — we never silently pass).
+ */
+export function severityAtLeast(actual, threshold) {
+    if (typeof actual !== 'string')
+        return false;
+    const a = SEVERITY_ORDER.indexOf(actual);
+    const t = SEVERITY_ORDER.indexOf(threshold);
+    return a >= 0 && t >= 0 && a >= t;
+}
+// ============================================================================
+// JSON path evaluation
+// ============================================================================
+/**
+ * Evaluate a simple dotted JSONPath like `.output.assert.passed` against an
+ * already-parsed JSON value. Returns `undefined` if any segment is missing.
+ *
+ * We intentionally support only dotted paths (no `[idx]`, no filters) because
+ * that's the full surface area used by qe-browser's output schemas.
+ */
+export function evalJsonPath(obj, jsonPath) {
+    if (typeof jsonPath !== 'string' || !jsonPath.startsWith('.'))
+        return undefined;
+    const parts = jsonPath === '.' ? [] : jsonPath.slice(1).split('.');
+    let cur = obj;
+    for (const part of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+const defaultCommandRunner = (cmd, opts) => {
+    const result = realSpawnSync('bash', ['-c', cmd], {
+        timeout: opts.timeoutMs,
+        cwd: opts.cwd,
+        encoding: 'utf8',
+        maxBuffer: 16 * 1024 * 1024,
+    });
+    return {
+        status: result.status,
+        stdout: typeof result.stdout === 'string' ? result.stdout : '',
+        stderr: typeof result.stderr === 'string' ? result.stderr : '',
+        error: result.error,
+    };
+};
+// ============================================================================
+// Suite detection
+// ============================================================================
+/**
+ * A suite is command-eval mode when the first test case has `input.command`.
+ * We use this to dispatch from the shared `aqe eval` CLI without requiring a
+ * new explicit type tag in every existing LLM-style yaml.
+ */
+export function isCommandEvalSuite(raw) {
+    if (!raw || typeof raw !== 'object')
+        return false;
+    const obj = raw;
+    if (!Array.isArray(obj.test_cases) || obj.test_cases.length === 0)
+        return false;
+    const first = obj.test_cases[0];
+    return typeof first?.input?.command === 'string';
+}
+// ============================================================================
+// Result validation
+// ============================================================================
+/**
+ * Validate a single test-case result against its expected block.
+ * Returns the list of failures (empty == passed).
+ *
+ * Parses stdout as JSON only if at least one assertion needs it, so commands
+ * that only care about `exit_code` don't require JSON output.
+ */
+export function validateCommandResult(tc, exitCode, stdout) {
+    const failures = [];
+    const expected = tc.expected || {};
+    if (expected.exit_code !== undefined && exitCode !== expected.exit_code) {
+        failures.push(`exit_code: expected ${expected.exit_code}, got ${exitCode}`);
+    }
+    const needsJson = !!expected.json_fields ||
+        expected.severity_at_least !== undefined ||
+        expected.candidate_count_at_least !== undefined;
+    let parsed = null;
+    if (needsJson) {
+        try {
+            parsed = JSON.parse(stdout);
+        }
+        catch (e) {
+            failures.push(`stdout is not valid JSON: ${toErrorMessage(e)}`);
+            return { passed: false, failures };
+        }
+    }
+    if (expected.json_fields) {
+        for (const [jsonPath, want] of Object.entries(expected.json_fields)) {
+            const got = evalJsonPath(parsed, jsonPath);
+            if (!deepEqual(got, want)) {
+                failures.push(`json_fields ${jsonPath}: expected ${JSON.stringify(want)}, got ${JSON.stringify(got)}`);
+            }
+        }
+    }
+    if (expected.severity_at_least !== undefined) {
+        const sev = evalJsonPath(parsed, '.output.checkInjection.severity');
+        if (!severityAtLeast(sev, expected.severity_at_least)) {
+            failures.push(`severity_at_least: expected >= ${expected.severity_at_least}, got ${JSON.stringify(sev)}`);
+        }
+    }
+    if (expected.candidate_count_at_least !== undefined) {
+        const count = evalJsonPath(parsed, '.output.intentScore.candidateCount');
+        const countNum = typeof count === 'number' ? count : Number.NaN;
+        if (!(countNum >= expected.candidate_count_at_least)) {
+            failures.push(`candidate_count_at_least: expected >= ${expected.candidate_count_at_least}, got ${JSON.stringify(count)}`);
+        }
+    }
+    return { passed: failures.length === 0, failures };
+}
+/**
+ * Strict structural equality for JSON values — used to compare
+ * `json_fields` expected values against extracted paths. Avoids the pitfalls
+ * of `JSON.stringify` comparison (e.g. key order variance on objects) by
+ * walking both sides.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return a === b;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i]));
+    }
+    if (typeof a === 'object') {
+        if (typeof b !== 'object' || Array.isArray(b))
+            return false;
+        const ao = a;
+        const bo = b;
+        const ak = Object.keys(ao);
+        const bk = Object.keys(bo);
+        if (ak.length !== bk.length)
+            return false;
+        return ak.every((k) => deepEqual(ao[k], bo[k]));
+    }
+    return false;
+}
+export class CommandEvalRunner {
+    skillsDir;
+    timeoutMs;
+    cwd;
+    runner;
+    constructor(options = {}) {
+        this.skillsDir = options.skillsDir ?? '.claude/skills';
+        this.timeoutMs = options.timeoutMs ?? 60_000;
+        this.cwd = options.cwd ?? process.cwd();
+        this.runner = options.runner ?? defaultCommandRunner;
+    }
+    /**
+     * Load `${skill}/evals/${skill}.yaml` and return it iff it's a command-mode
+     * suite. Returns null if missing, unparseable, or not command-mode.
+     */
+    loadSuite(skill) {
+        const baseDir = path.isAbsolute(this.skillsDir)
+            ? this.skillsDir
+            : path.join(this.cwd, this.skillsDir);
+        const evalPath = path.join(baseDir, skill, 'evals', `${skill}.yaml`);
+        if (!fs.existsSync(evalPath))
+            return null;
+        try {
+            const raw = yaml.parse(fs.readFileSync(evalPath, 'utf-8'));
+            if (!isCommandEvalSuite(raw))
+                return null;
+            return raw;
+        }
+        catch {
+            return null;
+        }
+    }
+    async run(skill) {
+        const start = Date.now();
+        const suite = this.loadSuite(skill);
+        if (!suite) {
+            throw new Error(`Command-eval suite not found or not command-mode at ${this.skillsDir}/${skill}/evals/${skill}.yaml`);
+        }
+        const results = [];
+        // Sequential by design: setup steps (e.g. `vibium go <url>`) mutate
+        // shared browser state, so interleaving test cases would be racy.
+        for (const tc of suite.test_cases) {
+            results.push(this.executeCase(tc));
+        }
+        const passedTests = results.filter((r) => r.passed).length;
+        const failedTests = results.length - passedTests;
+        const passRate = results.length > 0 ? passedTests / results.length : 0;
+        const requiredPassRate = suite.validation?.required_pass_rate ?? 0.9;
+        const criticalMustPass = suite.validation?.critical_must_pass ?? true;
+        const criticalResults = results.filter((r) => r.priority === 'critical');
+        const criticalPassed = criticalResults.every((r) => r.passed);
+        const passed = passRate >= requiredPassRate && (!criticalMustPass || criticalPassed);
+        return {
+            skill,
+            passed,
+            totalTests: results.length,
+            passedTests,
+            failedTests,
+            passRate,
+            criticalPassed,
+            testResults: results,
+            totalDurationMs: Date.now() - start,
+            timestamp: new Date(),
+        };
+    }
+    executeCase(tc) {
+        const start = Date.now();
+        const setup = tc.input?.setup ?? [];
+        for (const step of setup) {
+            const r = this.runner(step, { timeoutMs: this.timeoutMs, cwd: this.cwd });
+            if (r.status !== 0) {
+                return {
+                    testId: tc.id,
+                    passed: false,
+                    category: tc.category,
+                    priority: tc.priority,
+                    exitCode: r.status,
+                    stdoutSnippet: truncate(r.stdout),
+                    stderrSnippet: truncate(r.stderr),
+                    failures: [],
+                    setupFailure: `setup step failed (exit ${r.status}): ${step}`,
+                    durationMs: Date.now() - start,
+                };
+            }
+        }
+        const r = this.runner(tc.input.command, { timeoutMs: this.timeoutMs, cwd: this.cwd });
+        const v = validateCommandResult(tc, r.status, r.stdout);
+        return {
+            testId: tc.id,
+            passed: v.passed,
+            category: tc.category,
+            priority: tc.priority,
+            exitCode: r.status,
+            stdoutSnippet: truncate(r.stdout),
+            stderrSnippet: truncate(r.stderr),
+            failures: v.failures,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+function truncate(s, max = 500) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max)}…[truncated ${s.length - max}b]`;
+}
+/**
+ * Convenience factory.
+ */
+export function createCommandEvalRunner(options = {}) {
+    return new CommandEvalRunner(options);
+}
+//# sourceMappingURL=command-eval-runner.js.map

package/dist/validation/index.d.ts

@@ -14,6 +14,8 @@ export { SwarmSkillValidator, createSwarmSkillValidator, DEFAULT_SWARM_VALIDATIO
 export type { SwarmValidationConfig, SwarmTopology, SwarmValidationResult, SwarmValidationSummary, SkillValidatorFn, } from './swarm-skill-validator.js';
 export { ParallelEvalRunner, createParallelEvalRunner, DEFAULT_PARALLEL_EVAL_CONFIG, MockLLMExecutor, } from './parallel-eval-runner.js';
 export type { ParallelEvalConfig, EvalTestCase, EvalTestCaseInput, EvalTestCaseExpectedOutput, EvalTestCaseValidation, EvalSuite, TestCaseTask, ParallelEvalResult, WorkerMessage, WorkerProgress, EvalProgress, LLMExecutor, } from './parallel-eval-runner.js';
+export { CommandEvalRunner, createCommandEvalRunner, evalJsonPath, severityAtLeast, isCommandEvalSuite, validateCommandResult, } from './command-eval-runner.js';
+export type { CommandEvalSuite, CommandEvalTestCase, CommandEvalExpected, CommandEvalResult, CommandEvalTestResult, CommandEvalRunnerOptions, CommandRunner, Severity, TestCasePriority, } from './command-eval-runner.js';
 export { ValidationResultAggregator, createValidationResultAggregator, } from './validation-result-aggregator.js';
 export type { AggregatedValidationReport, AggregatorConfig, CrossModelReport, IssueSeverity, ModelAnomaly, ParallelValidationRunResult, RegressionReport, SkillValidationSummary, ValidationIssue, } from './validation-result-aggregator.js';
 export { TriggerOptimizer, createTriggerOptimizer, parseSkillFrontmatter, } from './trigger-optimizer.js';

package/dist/validation/index.js

@@ -25,6 +25,10 @@ P0_SKILLS, DEFAULT_VALIDATION_MODELS, } from './swarm-skill-validator.js';
 // ============================================================================
 export { ParallelEvalRunner, createParallelEvalRunner, DEFAULT_PARALLEL_EVAL_CONFIG, MockLLMExecutor, } from './parallel-eval-runner.js';
 // ============================================================================
+// Command Eval Runner (ADR-091: qe-browser and other shell-based skills)
+// ============================================================================
+export { CommandEvalRunner, createCommandEvalRunner, evalJsonPath, severityAtLeast, isCommandEvalSuite, validateCommandResult, } from './command-eval-runner.js';
+// ============================================================================
 // Validation Result Aggregator (ADR-056 Phase 5)
 // ============================================================================
 export { ValidationResultAggregator, createValidationResultAggregator, } from './validation-result-aggregator.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-qe",
-  "version": "3.9.13",
+  "version": "3.9.15",
   "description": "Agentic Quality Engineering V3 - Domain-Driven Design Architecture with 13 Bounded Contexts, O(log n) coverage analysis, ReasoningBank learning, 60 specialized QE agents, mathematical Coherence verification, deep Claude Flow integration",
   "type": "module",
   "main": "./dist/index.js",
@@ -82,7 +82,7 @@
     "dev": "node dist/cli/bundle.js",
     "start": "node dist/cli/bundle.js",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src tests --ext .ts",
+    "lint": "eslint src --ext .ts",
     "clean": "node -e \"const fs=require('fs');try{fs.rmSync('dist',{recursive:true,force:true})}catch{}\"",
     "sync:agents": "node scripts/sync-agents.cjs",
     "sync:agents:check": "node scripts/sync-agents-check.cjs",
@@ -128,7 +128,6 @@
   "author": "AQE Development Team",
   "license": "MIT",
   "dependencies": {
-    "@claude-flow/guidance": "3.0.0-alpha.1",
     "@ruvector/attention": "0.1.3",
     "@ruvector/gnn": "0.1.25",
     "@ruvector/learning-wasm": "^0.1.29",
@@ -156,6 +155,7 @@
   },
   "optionalDependencies": {
     "@claude-flow/browser": "3.0.0-alpha.1",
+    "@claude-flow/guidance": "3.0.0-alpha.1",
     "@ruvector/attention-darwin-arm64": "0.1.3",
     "@ruvector/attention-darwin-x64": "0.1.3",
     "@ruvector/attention-linux-arm64-gnu": "0.1.3",
@@ -174,13 +174,15 @@
   "resolutions": {
     "graceful-fs": "^4.2.11",
     "stack-utils": "^2.0.6",
-    "tar": ">=7.5.7"
+    "tar": ">=7.5.7",
+    "protobufjs": "^7.5.5"
   },
   "overrides": {
     "@ruvector/gnn-linux-x64-musl": "npm:@ruvector/gnn-linux-x64-gnu@0.1.25",
     "@ruvector/gnn-linux-arm64-musl": "npm:@ruvector/gnn-linux-arm64-gnu@0.1.25",
     "tar": ">=7.5.7",
-    "markdown-it": ">=14.1.1"
+    "markdown-it": ">=14.1.1",
+    "protobufjs": "^7.5.5"
   },
   "devDependencies": {
     "@faker-js/faker": "^10.2.0",

package/dist/cli/chunks/adapter-VP3WBXE5.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.9.13");process.exit(0)}
-import{a,b,c}from"./chunk-LRHJOYKY.js";import"./chunk-F74IVEON.js";import"./chunk-Z6F4GRXY.js";import"./chunk-VCJP7HQG.js";import"./chunk-3AOWTHLS.js";import"./chunk-ERGY45RL.js";export{a as AgentBoosterAdapter,b as createAgentBoosterAdapter,c as createAgentBoosterAdapterSync};

package/dist/cli/chunks/aqe-learning-engine-ASPPEOKQ.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.9.13");process.exit(0)}
-import{a,b,c,d,e,f}from"./chunk-4WJ3BHCN.js";import"./chunk-R4B2B6MZ.js";import"./chunk-Q7TWE55T.js";import"./chunk-APQYMAKG.js";import"./chunk-TRJRRJV3.js";import"./chunk-OBDM6OJL.js";import"./chunk-TOS3PI5Q.js";import"./chunk-VVVIRGO7.js";import"./chunk-UCCNB75R.js";import"./chunk-FLML5IT7.js";import"./chunk-RYPUA6E2.js";import"./chunk-7HX2PMBB.js";import"./chunk-TWRGM5TY.js";import"./chunk-EBQUXPIG.js";import"./chunk-XXQYSDLV.js";import"./chunk-Y2ONHWXI.js";import"./chunk-HHRUXDLT.js";import"./chunk-VCJP7HQG.js";import"./chunk-QIE76ERL.js";import"./chunk-3AOWTHLS.js";import"./chunk-IQGVQBVS.js";import"./chunk-CF5EJGOV.js";import"./chunk-OM7A3YC3.js";import"./chunk-77GZ7LXL.js";import"./chunk-YYQVSVBO.js";import"./chunk-ZS5BM2EE.js";import"./chunk-AZPDX4KS.js";import"./chunk-V2CV6J2A.js";import"./chunk-JOCR5TWI.js";import"./chunk-W2YCNX4O.js";import"./chunk-ERGY45RL.js";export{b as AQELearningEngine,a as DEFAULT_ENGINE_CONFIG,c as DEFAULT_META_LEARNING_CONFIG,d as MetaLearningEngine,e as createAQELearningEngine,f as createDefaultLearningEngine};

package/dist/cli/chunks/base-SIAOYPTD.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.9.13");process.exit(0)}
-import{a,b,c,d,e,f}from"./chunk-D22MEX2U.js";import"./chunk-YCQ2GHFH.js";import"./chunk-EBQUXPIG.js";import"./chunk-XXQYSDLV.js";import"./chunk-Y2ONHWXI.js";import"./chunk-HHRUXDLT.js";import"./chunk-VCJP7HQG.js";import"./chunk-3AOWTHLS.js";import"./chunk-IQGVQBVS.js";import"./chunk-CF5EJGOV.js";import"./chunk-OM7A3YC3.js";import"./chunk-77GZ7LXL.js";import"./chunk-YYQVSVBO.js";import"./chunk-ZS5BM2EE.js";import"./chunk-AZPDX4KS.js";import"./chunk-V2CV6J2A.js";import"./chunk-JOCR5TWI.js";import"./chunk-W2YCNX4O.js";import"./chunk-ERGY45RL.js";export{f as MCPToolBase,e as defaultToolLogger,d as getMemoryBackend,b as getSharedMemoryBackend,a as registerRvfResetFn,c as resetSharedMemoryBackend};

package/dist/cli/chunks/browser-workflow-BG3M3RZU.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.9.13");process.exit(0)}
-import{a}from"./chunk-RMNZSGTE.js";import"./chunk-D22MEX2U.js";import"./chunk-YCQ2GHFH.js";import"./chunk-EBQUXPIG.js";import"./chunk-XXQYSDLV.js";import"./chunk-Y2ONHWXI.js";import"./chunk-HHRUXDLT.js";import"./chunk-VCJP7HQG.js";import"./chunk-3AOWTHLS.js";import"./chunk-IQGVQBVS.js";import"./chunk-CF5EJGOV.js";import"./chunk-OM7A3YC3.js";import"./chunk-77GZ7LXL.js";import"./chunk-YYQVSVBO.js";import"./chunk-ZS5BM2EE.js";import"./chunk-AZPDX4KS.js";import"./chunk-V2CV6J2A.js";import"./chunk-JOCR5TWI.js";import"./chunk-W2YCNX4O.js";import"./chunk-ERGY45RL.js";export{a as BrowserWorkflowTool};

package/dist/cli/chunks/chunk-3I6KWFJT.js

@@ -1,2 +0,0 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.9.13");process.exit(0)}
-import{a as f}from"./chunk-Y2ONHWXI.js";import{c as p}from"./chunk-HHRUXDLT.js";import{a as l,d as b}from"./chunk-YYQVSVBO.js";import{a as d,c as g}from"./chunk-V2CV6J2A.js";f();g();b();var v={dimensions:384,M:16,efConstruction:200,efSearch:100,metric:"cosine",namespace:"coverage-hnsw",maxElements:1e5},S=p.create("coverage-analysis/hnsw-index"),u=class{constructor(e,t={}){this.memory=e;this.config={...v,...t},this.stats={vectorCount:0,searchOperations:0,insertOperations:0}}config;stats;searchLatencies=[];backendType="ruvector-gnn";adapter=null;initialized=!1;metadataStore=new Map;async initialize(){if(this.initialized)return;let e=this.config.metric==="cosine"?"cosine":"euclidean",t=`coverage-${this.config.namespace}`;d.close(t),this.adapter=d.create(t,{dimensions:this.config.dimensions,M:this.config.M,efConstruction:this.config.efConstruction,efSearch:this.config.efSearch,metric:e}),S.info(`HnswAdapter initialized: dimension=${this.config.dimensions}, metric=${this.config.metric}, M=${this.config.M} (unified backend via ADR-071)`),this.initialized=!0}isNativeAvailable(){return this.initialized&&this.adapter!==null}getBackendType(){return this.backendType}isRuvectorAvailable(){return this.initialized&&this.adapter!==null&&this.adapter.isRuvectorAvailable()}async insert(e,t,a){this.initialized||await this.initialize(),t=this.validateVector(t),this.adapter.addByStringId(e,t),a&&this.metadataStore.set(e,a),this.stats.insertOperations++,this.stats.vectorCount=this.adapter.size()}async search(e,t){this.initialized||await this.initialize(),e=this.validateVector(e);let a=performance.now(),n=[];this.adapter.size()>0&&(n=this.adapter.searchByArray(e,t).map(({id:i,score:o})=>({key:i,score:o,distance:1-o,metadata:this.metadataStore.get(i)})));let s=performance.now()-a;return this.recordSearchLatency(s),this.stats.searchOperations++,n}async batchInsert(e){this.initialized||await this.initialize();let t=100;for(let a=0;a<e.length;a+=t){let n=e.slice(a,a+t);await Promise.all(n.map(r=>this.insert(r.key,r.vector,r.metadata)))}}async delete(e){if(!this.adapter)return!1;let t=this.adapter.removeByStringId(e);if(t){this.metadataStore.delete(e);let a=this.buildKey(e);await this.memory.delete(a),this.stats.vectorCount=this.adapter.size()}return t}async getStats(){return{nativeHNSW:this.initialized&&this.adapter!==null,backendType:this.backendType,vectorCount:this.stats.vectorCount,indexSizeBytes:this.stats.vectorCount*this.config.dimensions*4,avgSearchLatencyMs:this.calculateAvgLatency(),p95SearchLatencyMs:this.calculatePercentileLatency(95),p99SearchLatencyMs:this.calculatePercentileLatency(99),searchOperations:this.stats.searchOperations,insertOperations:this.stats.insertOperations}}async clear(){this.metadataStore.clear(),this.adapter&&this.adapter.clear(),this.stats.vectorCount=0,this.searchLatencies=[]}validateVector(e){if(e.length!==this.config.dimensions)return this.resizeVector(e,this.config.dimensions);for(let t=0;t<e.length;t++)if(!Number.isFinite(e[t]))throw new Error(`Invalid vector value at index ${t}: ${e[t]}`);return e}resizeVector(e,t){if(e.length===t)return e;if(e.length>t){let n=new Array(t).fill(0),r=e.length/t;for(let s=0;s<t;s++){let h=Math.floor(s*r),i=Math.floor((s+1)*r),o=0;for(let m=h;m<i;m++)o+=e[m];n[s]=o/(i-h)}return n}let a=new Array(t).fill(0);for(let n=0;n<e.length;n++)a[n]=e[n];return a}buildKey(e){return`${this.config.namespace}:${e}`}recordSearchLatency(e){this.searchLatencies.push(e);let t=1e3;this.searchLatencies.length>t&&(this.searchLatencies=this.searchLatencies.slice(-t))}calculateAvgLatency(){return this.searchLatencies.length===0?0:this.searchLatencies.reduce((t,a)=>t+a,0)/this.searchLatencies.length}calculatePercentileLatency(e){if(this.searchLatencies.length===0)return 0;let t=[...this.searchLatencies].sort((n,r)=>n-r),a=Math.ceil(e/100*t.length)-1;return t[Math.max(0,a)]}setEfSearch(e){this.config.efSearch=e}};function C(c,e){return new u(c,e)}async function H(c,e=1e4,t=1e3){let n=performance.now();for(let i=0;i<e;i++){let o=Array.from({length:384},()=>l());await c.insert(`bench-${i}`,o)}let r=performance.now()-n,s=performance.now();for(let i=0;i<t;i++){let o=Array.from({length:384},()=>l());await c.search(o,10)}let h=performance.now()-s;return{insertTimeMs:r,searchTimeMs:h,avgSearchLatencyMs:h/t,isNative:c.isNativeAvailable(),backendType:c.getBackendType()}}export{v as a,u as b,C as c,H as d};