agentic-qe 3.6.19 → 3.7.0

package/v3/dist/cli/command-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/cli/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,eAAe,EACf,UAAU,EAQX,MAAM,qBAAqB,CAAC;AAM7B;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,iBAAiB,CAAyB;gBAGhD,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IAO3C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIxC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAI3B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOnC;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAmB/B;;OAEG;IACH,UAAU,IAAI,MAAM;CAUrB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACxC,eAAe,CAIjB"}
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/cli/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,eAAe,EACf,UAAU,EASX,MAAM,qBAAqB,CAAC;AAM7B;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,iBAAiB,CAAyB;gBAGhD,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IAO3C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIxC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAI3B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOnC;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAsB/B;;OAEG;IACH,UAAU,IAAI,MAAM;CAUrB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACxC,eAAe,CAIjB"}

package/v3/dist/cli/command-registry.js

@@ -4,7 +4,7 @@
  * Central registry for all CLI command handlers.
  * Provides command routing and management.
  */
-import { createInitHandler, createStatusHandler, createHealthHandler, createTaskHandler, createAgentHandler, createDomainHandler, createProtocolHandler, } from './handlers/index.js';
+import { createInitHandler, createStatusHandler, createHealthHandler, createTaskHandler, createAgentHandler, createDomainHandler, createProtocolHandler, createBrainHandler, } from './handlers/index.js';
 // ============================================================================
 // Command Registry
 // ============================================================================
@@ -76,6 +76,8 @@ export class CommandRegistry {
         this.register(createDomainHandler(this.cleanupAndExit, this.ensureInitialized));
         // Protocol execution
         this.register(createProtocolHandler(this.cleanupAndExit, this.ensureInitialized));
+        // Brain export/import
+        this.register(createBrainHandler(this.cleanupAndExit, this.ensureInitialized));
     }
     /**
      * Get help for all commands

package/v3/dist/cli/command-registry.js.map

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

package/v3/dist/cli/handlers/brain-handler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agentic QE v3 - Brain Command Handler
+ *
+ * Handles the 'aqe brain' command with subcommands: export, import, info.
+ * Thin CLI wiring around the brain-commands module.
+ */
+import { Command } from 'commander';
+import { ICommandHandler, CLIContext } from './interfaces.js';
+export declare class BrainHandler implements ICommandHandler {
+    readonly name = "brain";
+    readonly description = "Export, import, and inspect QE brain state";
+    private cleanupAndExit;
+    private ensureInitialized;
+    constructor(cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>);
+    register(program: Command, _context: CLIContext): void;
+    private executeExport;
+    private executeImport;
+    private executeInfo;
+    getHelp(): string;
+}
+export declare function createBrainHandler(cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>): BrainHandler;
+//# sourceMappingURL=brain-handler.d.ts.map

package/v3/dist/cli/handlers/brain-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-handler.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/brain-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAW9D,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,WAAW,gDAAgD;IAEpE,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,iBAAiB,CAAyB;gBAGhD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IAM3C,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI;YAmCxC,aAAa;YAsBb,aAAa;YA0Bb,WAAW;IAqBzB,OAAO,IAAI,MAAM;CAqBlB;AAmCD,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACxC,YAAY,CAEd"}

package/v3/dist/cli/handlers/brain-handler.js

@@ -0,0 +1,148 @@
+/**
+ * Agentic QE v3 - Brain Command Handler
+ *
+ * Handles the 'aqe brain' command with subcommands: export, import, info.
+ * Thin CLI wiring around the brain-commands module.
+ */
+import path from 'path';
+import chalk from 'chalk';
+import { exportBrain, importBrain, brainInfo, } from '../brain-commands.js';
+// ============================================================================
+// Brain Handler
+// ============================================================================
+export class BrainHandler {
+    name = 'brain';
+    description = 'Export, import, and inspect QE brain state';
+    cleanupAndExit;
+    ensureInitialized;
+    constructor(cleanupAndExit, ensureInitialized) {
+        this.cleanupAndExit = cleanupAndExit;
+        this.ensureInitialized = ensureInitialized;
+    }
+    register(program, _context) {
+        const brain = program
+            .command('brain')
+            .description(this.description);
+        brain
+            .command('export')
+            .description('Export brain state to a portable directory')
+            .requiredOption('-o, --output <path>', 'Output directory path')
+            .option('--format <format>', 'Export format', 'jsonl')
+            .option('--db <path>', 'Source database path', defaultDbPath())
+            .action(async (options) => {
+            await this.executeExport(options);
+        });
+        brain
+            .command('import')
+            .description('Import brain state from an export directory')
+            .requiredOption('-i, --input <path>', 'Path to brain export directory')
+            .option('--strategy <strategy>', 'Merge strategy', 'skip-conflicts')
+            .option('--dry-run', 'Preview import without writing', false)
+            .option('--db <path>', 'Target database path', defaultDbPath())
+            .action(async (options) => {
+            await this.executeImport(options);
+        });
+        brain
+            .command('info')
+            .description('Show manifest info for a brain export')
+            .requiredOption('-i, --input <path>', 'Path to brain export directory')
+            .action(async (options) => {
+            await this.executeInfo(options);
+        });
+    }
+    async executeExport(options) {
+        try {
+            console.log(chalk.blue('\n  Exporting brain state...\n'));
+            const manifest = await exportBrain(options.db, {
+                outputPath: path.resolve(options.output),
+            });
+            console.log(chalk.green('  Export complete.'));
+            console.log(`  Patterns: ${chalk.cyan(manifest.stats.patternCount)}`);
+            console.log(`  Vectors:  ${chalk.cyan(manifest.stats.vectorCount)}`);
+            console.log(`  Checksum: ${chalk.gray(manifest.checksum)}`);
+            console.log(`  Output:   ${chalk.cyan(path.resolve(options.output))}`);
+            console.log('');
+            await this.cleanupAndExit(0);
+        }
+        catch (error) {
+            console.error(chalk.red('\n  Brain export failed:'), error);
+            await this.cleanupAndExit(1);
+        }
+    }
+    async executeImport(options) {
+        try {
+            if (options.dryRun) {
+                console.log(chalk.yellow('\n  Dry-run mode — no data will be written.\n'));
+            }
+            else {
+                console.log(chalk.blue('\n  Importing brain state...\n'));
+            }
+            const result = await importBrain(options.db, path.resolve(options.input), {
+                mergeStrategy: options.strategy,
+                dryRun: options.dryRun,
+            });
+            console.log(chalk.green('  Import complete.'));
+            console.log(`  Imported:  ${chalk.cyan(result.imported)}`);
+            console.log(`  Skipped:   ${chalk.yellow(result.skipped)}`);
+            console.log(`  Conflicts: ${chalk.red(result.conflicts)}`);
+            console.log('');
+            await this.cleanupAndExit(0);
+        }
+        catch (error) {
+            console.error(chalk.red('\n  Brain import failed:'), error);
+            await this.cleanupAndExit(1);
+        }
+    }
+    async executeInfo(options) {
+        try {
+            console.log(chalk.blue('\n  Brain Export Info\n'));
+            const manifest = await brainInfo(path.resolve(options.input));
+            console.log(`  Version:    ${chalk.cyan(manifest.version)}`);
+            console.log(`  Exported:   ${chalk.cyan(manifest.exportedAt)}`);
+            console.log(`  Source DB:  ${chalk.cyan(manifest.sourceDb)}`);
+            console.log(`  Patterns:   ${chalk.cyan(manifest.stats.patternCount)}`);
+            console.log(`  Vectors:    ${chalk.cyan(manifest.stats.vectorCount)}`);
+            console.log(`  Checksum:   ${chalk.gray(manifest.checksum)}`);
+            console.log('');
+            await this.cleanupAndExit(0);
+        }
+        catch (error) {
+            console.error(chalk.red('\n  Failed to read brain info:'), error);
+            await this.cleanupAndExit(1);
+        }
+    }
+    getHelp() {
+        return `
+Export, import, and inspect QE brain state.
+
+Usage:
+  aqe brain export --output <path> [--format jsonl] [--db <path>]
+  aqe brain import --input <path> [--strategy skip-conflicts] [--dry-run] [--db <path>]
+  aqe brain info --input <path>
+
+Subcommands:
+  export    Export brain patterns and vectors to a portable directory
+  import    Import a brain export into the local database
+  info      Show manifest metadata for an existing brain export
+
+Examples:
+  aqe brain export -o ./my-brain-export
+  aqe brain import -i ./my-brain-export --strategy latest-wins
+  aqe brain import -i ./my-brain-export --dry-run
+  aqe brain info -i ./my-brain-export
+`;
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function defaultDbPath() {
+    return path.join(process.cwd(), '.agentic-qe', 'memory.db');
+}
+// ============================================================================
+// Factory
+// ============================================================================
+export function createBrainHandler(cleanupAndExit, ensureInitialized) {
+    return new BrainHandler(cleanupAndExit, ensureInitialized);
+}
+//# sourceMappingURL=brain-handler.js.map

package/v3/dist/cli/handlers/brain-handler.js.map

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

package/v3/dist/cli/handlers/index.d.ts

@@ -10,4 +10,5 @@ export { TaskHandler, createTaskHandler } from './task-handler.js';
 export { AgentHandler, createAgentHandler } from './agent-handler.js';
 export { DomainHandler, createDomainHandler } from './domain-handler.js';
 export { ProtocolHandler, createProtocolHandler } from './protocol-handler.js';
+export { BrainHandler, createBrainHandler } from './brain-handler.js';
 //# sourceMappingURL=index.d.ts.map

package/v3/dist/cli/handlers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/v3/dist/cli/handlers/index.js

@@ -12,4 +12,5 @@ export { TaskHandler, createTaskHandler } from './task-handler.js';
 export { AgentHandler, createAgentHandler } from './agent-handler.js';
 export { DomainHandler, createDomainHandler } from './domain-handler.js';
 export { ProtocolHandler, createProtocolHandler } from './protocol-handler.js';
+export { BrainHandler, createBrainHandler } from './brain-handler.js';
 //# sourceMappingURL=index.js.map

package/v3/dist/cli/handlers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2BAA2B;AAC3B,cAAc,iBAAiB,CAAC;AAEhC,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2BAA2B;AAC3B,cAAc,iBAAiB,CAAC;AAEhC,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/v3/dist/domains/coverage-analysis/services/hnsw-index.d.ts

@@ -1,12 +1,13 @@
 /**
  * Agentic QE v3 - HNSW Index for O(log n) Coverage Gap Detection
  *
- * Uses @ruvector/gnn's QEGNNEmbeddingIndex for HNSW operations.
- * This provides:
- * - Differentiable search for RL gradient flow
- * - GNN-based hierarchical feature extraction
- * - Adaptive tensor compression (hot/warm/cold data)
- * - O(log n) approximate nearest neighbor search
+ * Delegates to the unified HnswAdapter (ADR-071) for all vector operations.
+ * The HnswAdapter wraps ProgressiveHnswBackend which uses @ruvector/gnn's
+ * differentiableSearch as the primary engine with brute-force fallback.
+ *
+ * Migration (ADR-071): Previously used QEGNNEmbeddingIndex directly from
+ * @ruvector/gnn. Now delegates to HnswAdapter.create('coverage') which
+ * provides the same search quality through ProgressiveHnswBackend.
  *
  * Performance characteristics (measured, not theoretical):
  * | Codebase Size | Brute Force O(n) | HNSW O(log n) | Improvement |
@@ -110,7 +111,10 @@ export interface HNSWSearchResult {
 }
 /**
  * Backend type for HNSW index.
- * - 'ruvector-gnn': Using @ruvector/gnn with differentiable search
+ * - 'ruvector-gnn': Using @ruvector/gnn via ProgressiveHnswBackend (through HnswAdapter)
+ *
+ * @deprecated The backend type is now always 'ruvector-gnn' via HnswAdapter.
+ *   The ProgressiveHnswBackend handles @ruvector/gnn availability internally.
  */
 export type HNSWBackendType = 'ruvector-gnn';
 /**
@@ -140,10 +144,11 @@ export interface HNSWIndexStats {
     insertOperations: number;
 }
 /**
- * HNSW Index implementation using @ruvector/gnn.
+ * HNSW Index implementation delegating to the unified HnswAdapter (ADR-071).
  *
- * This provides REAL O(log n) approximate nearest neighbor search for coverage
- * gap detection using @ruvector/gnn's QEGNNEmbeddingIndex.
+ * This provides O(log n) approximate nearest neighbor search for coverage
+ * gap detection. Internally uses HnswAdapter which wraps ProgressiveHnswBackend
+ * with @ruvector/gnn differentiableSearch and brute-force cosine fallback.
  *
  * @example
  * ```typescript
@@ -159,19 +164,16 @@ export declare class HNSWIndex implements IHNSWIndex {
     private readonly stats;
     private searchLatencies;
     private readonly backendType;
-    private ruvectorIndex;
+    private adapter;
     private initialized;
-    private keyToLabel;
-    private labelToKey;
     private metadataStore;
-    private vectorStore;
-    private nextLabel;
     constructor(memory: MemoryBackend, config?: Partial<HNSWIndexConfig>);
     /**
-     * Initialize the HNSW index using @ruvector/gnn.
+     * Initialize the HNSW index using the unified HnswAdapter.
      *
      * Must be called before insert/search operations.
-     * Throws if @ruvector/gnn is not available.
+     * The HnswAdapter lazily loads @ruvector/gnn and falls back to
+     * brute-force cosine similarity if unavailable.
      */
     initialize(): Promise<void>;
     /**
@@ -187,7 +189,7 @@ export declare class HNSWIndex implements IHNSWIndex {
     getBackendType(): HNSWBackendType;
     /**
      * Check if @ruvector/gnn backend is available.
-     * Returns true if the index has been initialized.
+     * Returns true if the adapter has been initialized and @ruvector/gnn is loaded.
      */
     isRuvectorAvailable(): boolean;
     /**
@@ -196,7 +198,7 @@ export declare class HNSWIndex implements IHNSWIndex {
      * Time complexity: O(log n)
      *
      * @param key - Unique identifier for the vector
-     * @param vector - The embedding vector (must match configured dimensions)
+     * @param vector - The embedding vector (auto-resized if dimensions mismatch)
      * @param metadata - Optional coverage metadata
      */
     insert(key: string, vector: number[], metadata?: CoverageVectorMetadata): Promise<void>;
@@ -210,16 +212,6 @@ export declare class HNSWIndex implements IHNSWIndex {
      * @returns Array of search results sorted by similarity (highest first)
      */
     search(query: number[], k: number): Promise<HNSWSearchResult[]>;
-    /**
-     * Search using @ruvector/gnn differentiable search.
-     *
-     * This provides soft weights instead of hard distances, which is
-     * useful for RL gradient flow and attention mechanisms.
-     *
-     * Note: We compute actual cosine similarity for the score to maintain
-     * backward compatibility with tests expecting similarity scores in [0, 1].
-     */
-    private searchRuvector;
     /**
      * Batch insert multiple vectors efficiently
      *
@@ -229,9 +221,6 @@ export declare class HNSWIndex implements IHNSWIndex {
     /**
      * Delete a vector from the index
      *
-     * Note: HNSW doesn't support true deletion, so we mark as deleted
-     * and the entry remains in the index until rebuild.
-     *
      * @param key - Key of the vector to delete
      * @returns true if vector was found and deleted
      */
@@ -250,6 +239,10 @@ export declare class HNSWIndex implements IHNSWIndex {
      * Validate and auto-resize vectors to match HNSW configured dimensions.
      * Fix #279: Prevents Rust WASM panic when RealEmbeddings (768-dim) are
      * passed to a mismatched-dim HNSW index.
+     *
+     * Note: ProgressiveHnswBackend also handles dimension auto-resize internally,
+     * but we keep this validation for the non-finite value check which the
+     * backend does not perform.
      */
     private validateVector;
     /**
@@ -257,26 +250,20 @@ export declare class HNSWIndex implements IHNSWIndex {
      */
     private resizeVector;
     private buildKey;
-    /**
-     * Convert a plain vector to IEmbedding format for @ruvector/gnn.
-     *
-     * @param vector - The embedding vector
-     * @param key - Key for the embedding (used as text)
-     * @param metadata - Optional metadata to attach
-     * @returns IEmbedding-compatible object
-     */
-    private vectorToEmbedding;
-    private distanceToSimilarity;
     private recordSearchLatency;
     private calculateAvgLatency;
     private calculatePercentileLatency;
     /**
      * Update efSearch parameter for search quality/speed tradeoff.
+     *
+     * Note: With the unified HnswAdapter, efSearch is set at construction time.
+     * This method is retained for backward compatibility but has no runtime effect
+     * on the ProgressiveHnswBackend (which uses brute-force or differentiableSearch).
      */
     setEfSearch(ef: number): void;
 }
 /**
- * Create a new HNSW index instance using @ruvector/gnn.
+ * Create a new HNSW index instance backed by the unified HnswAdapter (ADR-071).
  *
  * @param memory - Memory backend for storage
  * @param config - Optional configuration overrides
@@ -287,7 +274,7 @@ export declare class HNSWIndex implements IHNSWIndex {
  * const index = createHNSWIndex(memoryBackend);
  * await index.initialize();
  *
- * // Backend is always ruvector-gnn
+ * // Backend is always ruvector-gnn (via HnswAdapter)
  * console.log(`Backend: ${index.getBackendType()}`); // => 'ruvector-gnn'
  * ```
  */

package/v3/dist/domains/coverage-analysis/services/hnsw-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hnsw-index.d.ts","sourceRoot":"","sources":["../../../../src/domains/coverage-analysis/services/hnsw-index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hnsw-index.d.ts","sourceRoot":"","sources":["../../../../src/domains/coverage-analysis/services/hnsw-index.ts"],"names":[],"mappings":"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"}