@unrdf/kgc-probe 26.4.7 → 26.5.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unrdf/kgc-probe",
-  "version": "26.4.7",
+  "version": "26.5.5",
   "description": "KGC Probe - Automated knowledge graph integrity scanning with 10 agents and artifact validation",
   "type": "module",
   "main": "./src/index.mjs",
@@ -23,6 +23,17 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "test": "vitest run --coverage",
+    "test:fast": "vitest run --coverage",
+    "test:watch": "vitest --coverage",
+    "lint": "eslint src/ test/ --max-warnings=0",
+    "lint:fix": "eslint src/ test/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "build": "echo 'Build complete (pure ESM, no compilation needed)'",
+    "validate": "npm run lint && npm run test"
+  },
   "keywords": [
     "rdf",
     "knowledge-graph",
@@ -35,12 +46,11 @@
     "artifact-verification"
   ],
   "dependencies": {
-    "@unrdf/kgc-substrate": "26.4.4",
-    "@unrdf/kgc-4d": "26.4.4",
-    "@unrdf/v6-core": "26.4.4",
-    "@unrdf/oxigraph": "26.4.4",
-    "@unrdf/hooks": "26.4.4",
-    "@unrdf/yawl": "26.4.4",
+    "@unrdf/kgc-substrate": "workspace:*",
+    "@unrdf/kgc-4d": "workspace:*",
+    "@unrdf/v6-core": "workspace:*",
+    "@unrdf/oxigraph": "workspace:*",
+    "@unrdf/hooks": "workspace:*",
     "hash-wasm": "^4.12.0",
     "zod": "^4.1.13"
   },
@@ -66,16 +76,5 @@
   "author": "UNRDF Contributors",
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "test": "vitest run --coverage",
-    "test:fast": "vitest run --coverage",
-    "test:watch": "vitest --coverage",
-    "lint": "eslint src/ test/ --max-warnings=0",
-    "lint:fix": "eslint src/ test/ --fix",
-    "format": "prettier --write src/",
-    "format:check": "prettier --check src/",
-    "build": "echo 'Build complete (pure ESM, no compilation needed)'",
-    "validate": "npm run lint && npm run test"
   }
-}
+}

package/src/config.mjs

@@ -40,7 +40,7 @@ export const ProbeConfigSchema = z.object({
   maxTimeoutMs: z.number().int().positive().default(50000),
 
   // Probe version
-  probeVersion: z.string().default('1.0.0'),
+  probeVersion: z.string().default('[VERSION]'),
 });
 
 /**
@@ -69,7 +69,7 @@ export function parseConfig(options) {
     samples: options.samples,
     enforceTimeouts: true,
     maxTimeoutMs: (options.budgetMs || 5000) * 10,
-    probeVersion: '1.0.0',
+    probeVersion: '[VERSION]',
   };
 
   return ProbeConfigSchema.parse(config);

package/src/guards.mjs

@@ -353,7 +353,7 @@ const NETWORK_ALLOWED_HOSTS = [
   { hostname: 'github.com', paths: ['**'], methods: ['GET'] },
   { hostname: 'docs.github.com', paths: ['**'], methods: ['GET'] },
   { hostname: 'localhost', paths: ['**'], methods: ['GET', 'POST'] },
-  { hostname: '127.0.0.1', paths: ['**'], methods: ['GET', 'POST'] },
+  { hostname: '[VERSION].1', paths: ['**'], methods: ['GET', 'POST'] },
 ];
 
 /**
@@ -362,7 +362,7 @@ const NETWORK_ALLOWED_HOSTS = [
  */
 const NETWORK_FORBIDDEN_DOMAINS = [
   'metadata.google.internal',
-  '169.254.169.254', // AWS/Azure metadata
+  '[VERSION].254', // AWS/Azure metadata
   '169.254.*',
   '*.internal',
   '*.local',
@@ -729,7 +729,7 @@ export class GuardRegistry {
    * @param {string} [method='GET'] - HTTP method
    * @returns {{allowed: boolean, reason?: string, guardId?: string, hostname?: string, severity?: string, receipt?: Object}}
    * @example
-   * const result = registry.checkNetworkURL('http://169.254.169.254/latest/meta-data/');
+   * const result = registry.checkNetworkURL('http://[VERSION].254/latest/meta-data/');
    * // { allowed: false, reason: 'Network access to metadata service forbidden', ... }
    */
   checkNetworkURL(url, method = 'GET') {

package/src/index.mjs

@@ -337,7 +337,7 @@ export {
  */
 export default {
   name: '@unrdf/kgc-probe',
-  version: '1.0.0',
+  version: '[VERSION]',
   description:
     'KGC Probe - Automated knowledge graph integrity scanning with 10 agents and artifact validation',
 };

package/src/observation.mjs

@@ -145,7 +145,7 @@ export function createGuardDenial({ guardName, reason, agentId, context = {} })
     },
     metadata: {
       agentId,
-      probeVersion: '0.1.0',
+      probeVersion: '[VERSION]',
       budgetMs: 1, // Guards have minimal overhead
       actualMs: 0,
       timestamp: new Date().toISOString(),

package/src/probes/README.md

@@ -32,7 +32,7 @@ The Tooling Surface Probe provides safe, API-based detection of CLI tools, versi
    {
      method: "tooling.git_version",
      inputs: { command: "git", args: ["--version"] },
-     outputs: { version: "2.34.1", available: true },
+     outputs: { version: "[VERSION]", available: true },
      guardDecision: "allowed",
      metadata: {}
    }

package/src/probes/concurrency.mjs

@@ -165,7 +165,7 @@ async function probeWorkerThreadsAvailability() {
     // Check Node.js version
     const nodeVersion = process.version;
     outputs.nodeVersion = nodeVersion;
-    metadata.minVersion = 'v10.5.0'; // worker_threads introduced in Node 10.5.0
+    metadata.minVersion = '[VERSION]'; // worker_threads introduced in Node [VERSION]
   } catch (error) {
     outputs.available = false;
     metadata.error = error.message;
@@ -828,7 +828,7 @@ async function probeAsyncLocalStorage() {
     }
 
     metadata.nodeVersion = process.version;
-    metadata.note = 'AsyncLocalStorage available since Node.js v13.10.0';
+    metadata.note = 'AsyncLocalStorage available since Node.js [VERSION]';
   } catch (error) {
     outputs.available = false;
     outputs.functional = false;

package/src/probes/performance.mjs

@@ -39,7 +39,7 @@ import { readFile, writeFile, unlink, mkdir } from 'node:fs/promises';
 import { Readable, Writable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { join, resolve } from 'node:path';
-import { blake3 } from '@noble/hashes/blake3';
+import { blake3 } from '@noble/hashes/blake3.js';
 import { ObservationSchema, ProbeConfigSchema } from '../types.mjs';
 
 // =============================================================================
@@ -109,7 +109,7 @@ function createObservation(category, observation, value, guardDecision, metadata
     metadata,
   };
 
-  return ObservationSchema.parse(obs);
+  return obs;
 }
 
 /**
@@ -485,8 +485,9 @@ async function benchmarkStringOperations(stringSize, options) {
  */
 export async function probePerformance(config = {}) {
   // Validate config
-  const validatedConfig = ProbeConfigSchema.parse(config);
-  const { out, timeout } = validatedConfig;
+  const validatedConfig = config;
+  const out = validatedConfig.out || '/tmp';
+  const timeout = validatedConfig.timeout || 30000;
 
   // Additional config defaults for performance benchmarking
   const samples = config.samples || 100;

package/src/probes/persistence.mjs

@@ -78,8 +78,8 @@ function createObservation(probeName, category, observation, value, guardDecisio
   };
 
   // Validate before returning
-  const validated = ObservationSchema.parse(obs);
-  return validated;
+  // const validated = ObservationSchema.parse(obs);
+  return obs;
 }
 
 /**
@@ -773,7 +773,7 @@ async function probeStorageType(config) {
  */
 export async function probePersistence(config) {
   // Validate config
-  const validatedConfig = ProbeConfigSchema.parse(config);
+  const validatedConfig = config;
 
   const observations = [];
 

package/src/probes/tooling.mjs

@@ -154,7 +154,7 @@ async function probeGit(timeout) {
   const metadata = {};
 
   if (result.success && result.stdout) {
-    // Parse version: "git version 2.34.1" -> "2.34.1"
+    // Parse version: "git version [VERSION]" -> "[VERSION]"
     const match = result.stdout.match(/git version ([\d.]+)/);
     if (match) {
       outputs.version = match[1];
@@ -186,7 +186,7 @@ async function probeNode(timeout) {
   const metadata = {};
 
   if (result.success && result.stdout) {
-    // Parse version: "v18.17.0" -> "18.17.0"
+    // Parse version: "[VERSION]" -> "[VERSION]"
     const version = result.stdout.replace(/^v/, '');
     outputs.version = version;
     outputs.available = true;

package/src/probes/tooling.test.mjs

@@ -138,7 +138,7 @@ describe('ObservationSchema', () => {
     const obs = {
       method: 'tooling.git_version',
       inputs: { command: 'git', args: ['--version'] },
-      outputs: { version: '2.34.1', available: true },
+      outputs: { version: '[VERSION]', available: true },
       guardDecision: 'allowed',
       metadata: { timestamp: Date.now() },
     };

package/src/receipt.mjs

@@ -14,8 +14,8 @@
  * - Verifiable: Can reconstruct and verify entire chain
  */
 
-import { blake3 } from '@noble/hashes/blake3';
-import { bytesToHex } from '@noble/hashes/utils';
+import { blake3 } from '@noble/hashes/blake3.js';
+import { bytesToHex } from '@noble/hashes/utils.js';
 
 /**
  * Hash data deterministically using BLAKE3

package/src/receipts/index.mjs

@@ -21,7 +21,7 @@ import { randomUUID, createHash } from 'crypto';
 export const HASH_ALGORITHM = 'sha256';
 
 /** Receipt version */
-export const RECEIPT_VERSION = '1.0.0';
+export const RECEIPT_VERSION = '[VERSION]';
 
 /** Receipt types */
 export const RECEIPT_TYPES = Object.freeze({
@@ -302,7 +302,7 @@ export function createMergeReceipt({
     proofPath,
     mergeAlgorithm: {
       algorithm: 'lww-deterministic',
-      version: '1.0.0',
+      version: '[VERSION]',
       parameters: {
         leafOrder: 'agentId-ascending',
         hashFunction: HASH_ALGORITHM,

package/src/reporter.mjs

@@ -93,7 +93,7 @@ function generateHash(observation) {
  * @returns {string} Turtle-formatted RDF string
  *
  * @example
- * const obs = [{ method: 'probeRuntime', outputs: { node: 'v18.19.0' } }];
+ * const obs = [{ method: 'probeRuntime', outputs: { node: '[VERSION]' } }];
  * const turtle = observationsToRdf(obs);
  * console.log(turtle); // @prefix kgc: <http://unrdf.dev/kgc#> . ...
  */
@@ -193,8 +193,8 @@ export function observationsToRdf(observations) {
     }
   }
 
-  // Serialize to Turtle
-  return store.dump({ format: 'turtle' });
+  // Serialize to N-Quads
+  return store.dump({ format: 'application/n-quads' });
 }
 
 /**

package/src/reporters/rdf.mjs

@@ -186,7 +186,7 @@ function deriveConstraints(observations) {
  * @returns {Promise<string>} Turtle-formatted RDF string
  *
  * @example
- * const obs = [{ method: 'runtime.node-version', outputs: { version: 'v22.21.1' } }];
+ * const obs = [{ method: 'runtime.node-version', outputs: { version: '[VERSION]' } }];
  * const turtle = await convertToTurtle(obs);
  * console.log(turtle); // @prefix kgc: <https://unrdf.org/kgc/probe#> . ...
  */

package/src/types.mjs

@@ -32,7 +32,7 @@ export const UUID_V4_REGEX =
   /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 
 /**
- * Semver pattern (e.g., 1.0.0, 2.1.3-beta.1+build.123)
+ * Semver pattern (e.g., [VERSION], [VERSION]-beta.1+build.123)
  * @type {RegExp}
  */
 export const SEMVER_REGEX =
@@ -725,7 +725,7 @@ export function createFrontmatter(data) {
     bounds: { maxQueries: 100, maxRuntime: 5000, maxFileScans: 50 },
     views: ['reference'],
     sources: [],
-    version: '1.0.0',
+    version: '[VERSION]',
     createdAt: now,
     lastProved: now,
   };
@@ -964,7 +964,7 @@ export function createProbeReport(data) {
       coverage: 1.0,
     },
     metadata: {
-      probeVersion: '1.0.0',
+      probeVersion: '[VERSION]',
       executionTimeMs: 0,
     },
   };

package/src/vocabulary.ttl

@@ -17,7 +17,7 @@
 # - Provenance-focused: Every claim links to evidence (observations)
 # - RDFS/OWL compatible: Standard semantics for tooling integration
 #
-# Version: 0.1.0
+# Version: [VERSION]
 # Author: KGC Probe Agent 10 (Reporter & RDF Modeler)
 # License: MIT
 # =============================================================================

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,414 +0,0 @@
-# @unrdf/kgc-probe
-
-Automated knowledge graph integrity scanning with 10 specialized agents and deterministic artifact validation.
-
-## Overview
-
-KGC Probe provides a comprehensive integrity scanning framework for RDF knowledge graphs with:
-
-- **10 Specialized Agents**: Completeness, consistency, conformance, coverage, caching, coherence, clustering, classification, and collaboration analysis
-- **Guard-Based Validation**: Quality checks, severity limits, and completeness verification
-- **Deterministic Artifacts**: Blake3 hashed observations for reproducible scans
-- **Distributed Shard Merging**: Multi-node probe result aggregation
-- **Multiple Storage Backends**: Memory, file system, or database-backed
-- **CLI Integration**: Full `kgc probe` command suite
-
-## Installation
-
-```bash
-pnpm add @unrdf/kgc-probe
-```
-
-## Quick Start
-
-### Basic Scan
-
-```javascript
-import { runProbe } from '@unrdf/kgc-probe';
-
-const artifact = await runProbe({
-  universe_id: 'my-universe',
-  snapshot_id: 'snap_123'
-});
-
-console.log(artifact.summary);
-// {
-//   total: 42,
-//   by_kind: { completeness: 15, consistency: 12, ... },
-//   by_severity: { critical: 2, warning: 8, info: 32 },
-//   confidence_mean: 0.89,
-//   coverage_mean: 0.92
-// }
-```
-
-### Advanced Orchestration
-
-```javascript
-import { createProbeOrchestrator, createMemoryStorage } from '@unrdf/kgc-probe';
-
-const orchestrator = createProbeOrchestrator({
-  storage: createMemoryStorage()
-});
-
-// Listen to events
-orchestrator.on('agent_complete', (result) => {
-  console.log(`Agent ${result.agentId} found ${result.observationCount} observations`);
-});
-
-// Run scan
-const result = await orchestrator.scan({
-  universe_id: 'my-universe',
-  agents: ['completion', 'consistency', 'conformance'], // Specific agents
-  distributed: true // Enable shard merging
-});
-
-console.log(result.status); // 'success' | 'partial' | 'failed'
-```
-
-## CLI Usage
-
-```bash
-# Run full scan
-kgc probe scan --args '{"universe":"my-universe"}' --json
-
-# List agents
-kgc agent list
-
-# List guards
-kgc guard list
-
-# Validate artifact
-kgc probe validate --args '{"artifact_id":"run-123"}'
-
-# Diff two artifacts
-kgc probe diff --args '{"artifact1_id":"run-1","artifact2_id":"run-2"}'
-
-# Merge shards
-kgc shard merge --args '{"universe":"my-universe"}'
-```
-
-## Architecture
-
-### 10 Agents
-
-| Agent | Kind | Purpose |
-|-------|------|---------|
-| **Completion** | completeness | Missing required properties |
-| **Consistency** | consistency | Value conflicts and contradictions |
-| **Conformance** | conformance | SHACL shape violations |
-| **Coverage** | coverage | Triple density and reachability |
-| **Caching** | caching | Cache staleness and efficiency |
-| **Completeness** | completeness_level | Data population ratios |
-| **Coherence** | coherence | Semantic inconsistencies |
-| **Clustering** | clustering | Entity grouping patterns |
-| **Classification** | classification | Type hierarchy issues |
-| **Collaboration** | collaboration | Cross-agent finding fusion |
-
-### 5 Guards
-
-| Guard | Purpose |
-|-------|---------|
-| **quality_check** | Validates confidence and observation count |
-| **completeness_check** | Verifies coverage thresholds |
-| **severity_limit** | Enforces maximum critical observations |
-| **integrity_check** | Validates observation structure |
-| **agent_coverage** | Ensures agent diversity |
-
-### Observation Schema
-
-```typescript
-interface Observation {
-  id: string; // UUID
-  agent: string; // Agent identifier
-  timestamp: ISO8601; // When observed
-  kind: string; // Observation type
-  severity: 'critical' | 'warning' | 'info';
-  subject: string; // RDF node
-  predicate?: string; // RDF property
-  object?: string; // RDF value
-  evidence: {
-    query: string; // SPARQL or algorithm
-    result: unknown; // Computation result
-    witnesses: string[]; // Confirming references
-  };
-  metrics: {
-    confidence: number; // [0, 1]
-    coverage: number; // [0, 1]
-    latency_ms: number;
-  };
-  tags?: string[];
-  xid?: string; // Correlation ID
-}
-```
-
-### Artifact Schema
-
-```typescript
-interface Artifact {
-  version: '1.0';
-  universe_id: string;
-  snapshot_id: string;
-  generated_at: ISO8601;
-  probe_run_id: UUID;
-  shard_count: number;
-  shard_hash: hex64;
-  observations: Observation[];
-  summary: {
-    total: number;
-    by_kind: Record<string, number>;
-    by_severity: Record<'critical' | 'warning' | 'info', number>;
-    confidence_mean: number;
-    coverage_mean: number;
-  };
-  metadata: {
-    agents_run: string[];
-    guards_applied: string[];
-    execution_time_ms: number;
-    storage_backend: string;
-    config: ProbeConfig;
-  };
-  integrity: {
-    checksum: hex64;
-    signature?: string;
-    verified_at?: ISO8601;
-  };
-}
-```
-
-## Storage Backends
-
-### Memory Storage
-
-In-process Map-based storage. Best for testing and single-process deployments.
-
-```javascript
-import { createMemoryStorage } from '@unrdf/kgc-probe';
-
-const storage = createMemoryStorage();
-await storage.saveArtifact(artifact);
-const loaded = await storage.loadArtifact(artifact.probe_run_id);
-```
-
-### File Storage
-
-Filesystem-based storage with JSON serialization.
-
-```javascript
-import { createFileStorage } from '@unrdf/kgc-probe';
-
-const storage = createFileStorage('./artifacts');
-await storage.saveArtifact(artifact);
-const shards = await storage.fetchShards(); // Merge-ready artifacts
-```
-
-### Database Storage
-
-KGC Substrate-backed storage using RDF quads (production).
-
-```javascript
-import { createDatabaseStorage } from '@unrdf/kgc-probe';
-
-const storage = createDatabaseStorage({
-  store: kgcSubstrateStore,
-  namespace: 'https://probe.unrdf.org/'
-});
-```
-
-## Operations
-
-### Merge Shards
-
-Deterministic merge of distributed probe results with deduplication:
-
-```javascript
-import { mergeShards } from '@unrdf/kgc-probe';
-
-const artifacts = await storage.fetchShards();
-const merged = await mergeShards(artifacts, newObservations);
-// Merged observations are deduplicated and sorted deterministically
-```
-
-### Diff Artifacts
-
-Compare two artifacts to identify changes:
-
-```javascript
-import { diffArtifacts } from '@unrdf/kgc-probe';
-
-const diff = diffArtifacts(artifact1, artifact2);
-// {
-//   added: Observation[],
-//   removed: Observation[],
-//   modified: { subject, predicate, before, after }[],
-//   summary: { total_changes, similarity_ratio }
-// }
-```
-
-### Verify Artifact
-
-Validate artifact integrity and schema compliance:
-
-```javascript
-import { verifyArtifact } from '@unrdf/kgc-probe';
-
-const result = await verifyArtifact(artifact);
-// {
-//   valid: boolean,
-//   errors: string[],
-//   verified_at: ISO8601
-// }
-```
-
-## Complexity Analysis
-
-| Operation | Time | Space |
-|-----------|------|-------|
-| scan() | O(n × m) | O(o) |
-| mergeShards() | O(s log s) | O(s) |
-| diffArtifacts() | O(o) | O(o) |
-| hashObservations() | O(o log o) | O(o) |
-
-- n = triples in graph
-- m = agents (parallel)
-- o = observations
-- s = shard observations
-
-## Configuration
-
-### ProbeConfig
-
-```typescript
-interface ProbeConfig {
-  universe_id: string; // Required
-  snapshot_id?: string; // Optional snapshot reference
-  agents?: string[]; // Specific agent IDs (all if omitted)
-  guards?: string[]; // Specific guard IDs
-  distributed?: boolean; // Enable shard merging (default: false)
-  persist?: boolean; // Save to storage (default: true)
-  timeout_ms?: number; // Scan timeout (default: 300000)
-  batch_size?: number; // Observation batch size (default: 100)
-}
-```
-
-## Examples
-
-### Full Workflow
-
-```javascript
-import {
-  createProbeOrchestrator,
-  createFileStorage,
-  createGuardRegistry,
-  diffArtifacts,
-  verifyArtifact
-} from '@unrdf/kgc-probe';
-
-// Setup
-const storage = createFileStorage('./probes');
-const orchestrator = createProbeOrchestrator({ storage });
-
-// Scan 1
-const result1 = await orchestrator.scan({
-  universe_id: 'my-universe',
-  persist: true
-});
-const artifact1 = result1.artifact;
-
-// Later: Scan 2
-const result2 = await orchestrator.scan({
-  universe_id: 'my-universe',
-  persist: true
-});
-const artifact2 = result2.artifact;
-
-// Compare
-const diff = diffArtifacts(artifact1, artifact2);
-console.log(`Changes: ${diff.summary.total_changes}`);
-console.log(`Similarity: ${(diff.summary.similarity_ratio * 100).toFixed(1)}%`);
-
-// Verify
-const verification = await verifyArtifact(artifact2);
-console.log(`Valid: ${verification.valid}`);
-```
-
-## Design Patterns
-
-### Factory Pattern
-
-All exports use factory functions for configuration flexibility:
-
-```javascript
-const orchestrator = createProbeOrchestrator({ storage });
-const registry = createGuardRegistry();
-const storage = createMemoryStorage();
-```
-
-### Registry Pattern
-
-Agents and guards use registry for dynamic registration:
-
-```javascript
-const agents = createAgentRegistry();
-agents.register('custom-agent', new MyAgent());
-const agent = agents.get('custom-agent');
-```
-
-### Observer Pattern
-
-Orchestrator emits events for monitoring:
-
-```javascript
-orchestrator.on('agent_complete', handler);
-orchestrator.on('guard_violation', handler);
-orchestrator.on('scan_complete', handler);
-```
-
-### Strategy Pattern
-
-Storage is pluggable with multiple implementations:
-
-```javascript
-// Swap backends without changing code
-const storage = process.env.NODE_ENV === 'production'
-  ? createDatabaseStorage(opts)
-  : createMemoryStorage();
-```
-
-## Performance Characteristics
-
-- **Scan time**: Dominated by agent SPARQL queries (varies by graph size)
-- **Memory**: O(observations) - typically 10-100KB per 1000 observations
-- **Determinism**: Blake3 hashing ensures identical results for same input
-
-## Testing
-
-```bash
-pnpm test                  # Run all tests
-pnpm test:watch            # Watch mode
-pnpm test coverage         # Coverage report
-```
-
-## Dependencies
-
-- `@unrdf/kgc-substrate` - Knowledge store interface
-- `@unrdf/kgc-4d` - 4D snapshot and universe management
-- `@unrdf/v6-core` - Core UNRDF types and utilities
-- `@unrdf/oxigraph` - SPARQL query engine
-- `@unrdf/hooks` - Hook and policy framework
-- `@unrdf/yawl` - Workflow orchestration
-- `hash-wasm` - Blake3 hashing
-- `zod` - Runtime validation schemas
-
-## License
-
-MIT
-
-## Contributing
-
-See [CONTRIBUTING.md](../../CONTRIBUTING.md)
-
-## References
-
-- [KGC Probe Design](../../DESIGN_KGC_PROBE_PACKAGE.md)
-- [SPARC Methodology](../../docs/sparc-methodology.md)
-- [UNRDF Documentation](https://unrdf.org)