@llm-dev-ops/agentics-cli 1.5.9 → 1.5.11

package/dist/pipeline/enterprise/decision-graph-memory.d.ts

@@ -0,0 +1,104 @@
+/**
+ * DecisionGraph Memory Backend — AgentDB Integration (ADR-033)
+ *
+ * Syncs DecisionGraph nodes to the AgentDB memory system using the
+ * claude-flow CLI. Each node is stored as a memory entry with:
+ *   - Key: decisiongraph:{execution_id}:{node_id}
+ *   - Namespace: decisiongraph
+ *   - Tags: node type, pass number, agent name
+ *
+ * This module provides:
+ *   - Push: sync graph nodes to AgentDB
+ *   - Pull: retrieve nodes from AgentDB into a graph
+ *   - Search: semantic vector search via AgentDB HNSW
+ *   - CLI query bridge: format queries for npx @claude-flow/cli
+ *
+ * Per ADR-033: "The DecisionGraph is stored in the existing AgentDB
+ * memory system with HNSW indexing."
+ */
+import type { DecisionGraphNode, DecisionNodeType, PassNumber } from './types.js';
+import { DecisionGraph } from './decision-graph.js';
+/**
+ * Generate the canonical AgentDB memory key for a node.
+ * Format: decisiongraph:{execution_id}:{node_id}
+ */
+export declare function memoryKey(executionId: string, nodeId: string): string;
+/**
+ * Generate tags for a node's memory entry.
+ * Includes: type, pass, agent domain, agent name, execution.
+ */
+export declare function memoryTags(node: DecisionGraphNode, executionId: string): readonly string[];
+/** Result of a push operation. */
+export interface PushResult {
+    readonly nodesStored: number;
+    readonly nodesFailed: number;
+    readonly errors: readonly string[];
+}
+/**
+ * Push all nodes from a DecisionGraph to AgentDB memory.
+ * Uses the claude-flow CLI `memory store` command.
+ *
+ * @param graph - The graph to push.
+ * @param options - Push options.
+ * @returns Push result with counts and any errors.
+ */
+export declare function pushToMemory(graph: DecisionGraph, options?: {
+    readonly verbose?: boolean;
+    readonly timeoutMs?: number;
+}): PushResult;
+/** Result of a pull operation. */
+export interface PullResult {
+    readonly nodesRetrieved: number;
+    readonly nodesFailed: number;
+    readonly errors: readonly string[];
+}
+/**
+ * Pull nodes from AgentDB memory into a DecisionGraph.
+ * Lists all entries in the decisiongraph namespace for the execution ID.
+ *
+ * @param executionId - The execution ID to pull nodes for.
+ * @param outputDir - Output directory for the graph.
+ * @param options - Pull options.
+ * @returns A new DecisionGraph populated from AgentDB.
+ */
+export declare function pullFromMemory(executionId: string, outputDir: string, options?: {
+    readonly verbose?: boolean;
+    readonly timeoutMs?: number;
+}): {
+    graph: DecisionGraph;
+    result: PullResult;
+};
+/** Result of a semantic search. */
+export interface SearchResult {
+    readonly nodes: readonly DecisionGraphNode[];
+    readonly query: string;
+    readonly errors: readonly string[];
+}
+/**
+ * Search for nodes by semantic similarity using AgentDB HNSW indexing.
+ * The query is matched against node summaries.
+ *
+ * @param query - Natural language search query.
+ * @param executionId - Scope search to a specific execution (optional).
+ * @param options - Search options.
+ */
+export declare function searchMemory(query: string, executionId?: string, options?: {
+    readonly limit?: number;
+    readonly timeoutMs?: number;
+}): SearchResult;
+/**
+ * Generate a CLI command string for querying the DecisionGraph via
+ * the claude-flow memory system. Does NOT execute — returns the command.
+ *
+ * Per ADR-033's querying section.
+ */
+export declare function buildMemoryQuery(params: {
+    action: 'list' | 'search' | 'retrieve';
+    executionId?: string;
+    nodeId?: string;
+    type?: DecisionNodeType;
+    pass?: PassNumber;
+    query?: string;
+    limit?: number;
+}): string;
+//# sourceMappingURL=decision-graph-memory.d.ts.map

package/dist/pipeline/enterprise/decision-graph-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-graph-memory.d.ts","sourceRoot":"","sources":["../../../src/pipeline/enterprise/decision-graph-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAapD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAS1F;AAMD,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,UAAU,CAsCZ;AAMD,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAgC9C;AAMD,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,YAAY,CA6Bd;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAiCT"}

package/dist/pipeline/enterprise/decision-graph-memory.js

@@ -0,0 +1,292 @@
+/**
+ * DecisionGraph Memory Backend — AgentDB Integration (ADR-033)
+ *
+ * Syncs DecisionGraph nodes to the AgentDB memory system using the
+ * claude-flow CLI. Each node is stored as a memory entry with:
+ *   - Key: decisiongraph:{execution_id}:{node_id}
+ *   - Namespace: decisiongraph
+ *   - Tags: node type, pass number, agent name
+ *
+ * This module provides:
+ *   - Push: sync graph nodes to AgentDB
+ *   - Pull: retrieve nodes from AgentDB into a graph
+ *   - Search: semantic vector search via AgentDB HNSW
+ *   - CLI query bridge: format queries for npx @claude-flow/cli
+ *
+ * Per ADR-033: "The DecisionGraph is stored in the existing AgentDB
+ * memory system with HNSW indexing."
+ */
+import { execSync } from 'node:child_process';
+import { DecisionGraph } from './decision-graph.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const NAMESPACE = 'decisiongraph';
+const CLI_CMD = 'npx @claude-flow/cli@latest';
+// ============================================================================
+// Key Format
+// ============================================================================
+/**
+ * Generate the canonical AgentDB memory key for a node.
+ * Format: decisiongraph:{execution_id}:{node_id}
+ */
+export function memoryKey(executionId, nodeId) {
+    return `${NAMESPACE}:${executionId}:${nodeId}`;
+}
+/**
+ * Generate tags for a node's memory entry.
+ * Includes: type, pass, agent domain, agent name, execution.
+ */
+export function memoryTags(node, executionId) {
+    return [
+        `type:${node.type}`,
+        `pass:${node.pass}`,
+        `domain:${node.producedBy.domain}`,
+        `agent:${node.producedBy.agent}`,
+        `execution:${executionId}`,
+        `status:${node.status}`,
+    ];
+}
+/**
+ * Push all nodes from a DecisionGraph to AgentDB memory.
+ * Uses the claude-flow CLI `memory store` command.
+ *
+ * @param graph - The graph to push.
+ * @param options - Push options.
+ * @returns Push result with counts and any errors.
+ */
+export function pushToMemory(graph, options) {
+    const executionId = graph.getExecutionId();
+    const nodes = graph.getAllNodes();
+    let stored = 0;
+    let failed = 0;
+    const errors = [];
+    const timeout = options?.timeoutMs ?? 10_000;
+    for (const node of nodes) {
+        const key = memoryKey(executionId, node.id);
+        const tags = memoryTags(node, executionId);
+        const value = JSON.stringify({
+            ...node,
+            _memoryKey: key,
+            _namespace: NAMESPACE,
+        });
+        try {
+            const tagsArg = tags.join(',');
+            execSync(`${CLI_CMD} memory store --key "${key}" --value '${escapeSingleQuotes(value)}' --namespace ${NAMESPACE} --tags "${tagsArg}"`, { encoding: 'utf-8', timeout, stdio: 'pipe' });
+            stored++;
+            if (options?.verbose) {
+                console.error(`  [AgentDB] Stored: ${key}`);
+            }
+        }
+        catch (err) {
+            failed++;
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push(`Failed to store ${key}: ${message}`);
+            if (options?.verbose) {
+                console.error(`  [AgentDB] Failed: ${key} — ${message}`);
+            }
+        }
+    }
+    return { nodesStored: stored, nodesFailed: failed, errors };
+}
+/**
+ * Pull nodes from AgentDB memory into a DecisionGraph.
+ * Lists all entries in the decisiongraph namespace for the execution ID.
+ *
+ * @param executionId - The execution ID to pull nodes for.
+ * @param outputDir - Output directory for the graph.
+ * @param options - Pull options.
+ * @returns A new DecisionGraph populated from AgentDB.
+ */
+export function pullFromMemory(executionId, outputDir, options) {
+    const graph = new DecisionGraph(executionId, outputDir);
+    const timeout = options?.timeoutMs ?? 10_000;
+    let retrieved = 0;
+    let failed = 0;
+    const errors = [];
+    try {
+        const raw = execSync(`${CLI_CMD} memory list --namespace ${NAMESPACE} --limit 1000`, { encoding: 'utf-8', timeout, stdio: 'pipe' });
+        // Parse the output (may be JSON or newline-delimited)
+        const entries = parseMemoryListOutput(raw, executionId);
+        for (const entry of entries) {
+            try {
+                const nodeData = JSON.parse(entry.value);
+                graph.addNode(nodeData);
+                retrieved++;
+            }
+            catch (err) {
+                failed++;
+                errors.push(`Failed to parse node: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        errors.push(`Failed to list memory entries: ${message}`);
+    }
+    return { graph, result: { nodesRetrieved: retrieved, nodesFailed: failed, errors } };
+}
+/**
+ * Search for nodes by semantic similarity using AgentDB HNSW indexing.
+ * The query is matched against node summaries.
+ *
+ * @param query - Natural language search query.
+ * @param executionId - Scope search to a specific execution (optional).
+ * @param options - Search options.
+ */
+export function searchMemory(query, executionId, options) {
+    const limit = options?.limit ?? 10;
+    const timeout = options?.timeoutMs ?? 10_000;
+    const errors = [];
+    const nodes = [];
+    try {
+        let cmd = `${CLI_CMD} memory search --query "${escapeDQ(query)}" --namespace ${NAMESPACE} --limit ${limit}`;
+        if (executionId) {
+            cmd += ` --tags "execution:${executionId}"`;
+        }
+        const raw = execSync(cmd, { encoding: 'utf-8', timeout, stdio: 'pipe' });
+        const entries = parseMemorySearchOutput(raw);
+        for (const entry of entries) {
+            try {
+                const nodeData = JSON.parse(entry);
+                nodes.push(nodeData);
+            }
+            catch {
+                // Skip unparseable entries
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        errors.push(`Search failed: ${message}`);
+    }
+    return { nodes, query, errors };
+}
+// ============================================================================
+// CLI Query Bridge — Format Queries for claude-flow CLI
+// ============================================================================
+/**
+ * Generate a CLI command string for querying the DecisionGraph via
+ * the claude-flow memory system. Does NOT execute — returns the command.
+ *
+ * Per ADR-033's querying section.
+ */
+export function buildMemoryQuery(params) {
+    switch (params.action) {
+        case 'list': {
+            let cmd = `${CLI_CMD} memory list --namespace ${NAMESPACE}`;
+            const tags = [];
+            if (params.executionId)
+                tags.push(`execution:${params.executionId}`);
+            if (params.type)
+                tags.push(`type:${params.type}`);
+            if (params.pass !== undefined)
+                tags.push(`pass:${params.pass}`);
+            if (tags.length > 0)
+                cmd += ` --tags "${tags.join(',')}"`;
+            if (params.limit)
+                cmd += ` --limit ${params.limit}`;
+            return cmd;
+        }
+        case 'search': {
+            if (!params.query)
+                throw new Error('Query parameter is required for search');
+            let cmd = `${CLI_CMD} memory search --query "${escapeDQ(params.query)}" --namespace ${NAMESPACE}`;
+            if (params.executionId)
+                cmd += ` --tags "execution:${params.executionId}"`;
+            if (params.type)
+                cmd += ` --tags "type:${params.type}"`;
+            if (params.limit)
+                cmd += ` --limit ${params.limit}`;
+            return cmd;
+        }
+        case 'retrieve': {
+            if (!params.executionId || !params.nodeId) {
+                throw new Error('Both executionId and nodeId are required for retrieve');
+            }
+            const key = memoryKey(params.executionId, params.nodeId);
+            return `${CLI_CMD} memory retrieve --key "${key}" --namespace ${NAMESPACE}`;
+        }
+        default:
+            throw new Error(`Unknown action: ${params.action}`);
+    }
+}
+/** Parse `memory list` CLI output into key-value entries. */
+function parseMemoryListOutput(raw, executionId) {
+    const entries = [];
+    const prefix = `${NAMESPACE}:${executionId}:`;
+    // Try JSON array first
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            for (const item of parsed) {
+                if (typeof item === 'object' && item !== null) {
+                    const key = String(item.key ?? '');
+                    const value = typeof item.value === 'string' ? item.value : JSON.stringify(item.value ?? item);
+                    if (key.startsWith(prefix) || !executionId) {
+                        entries.push({ key, value });
+                    }
+                }
+            }
+            return entries;
+        }
+    }
+    catch {
+        // Not JSON — try line-based parsing
+    }
+    // Line-based: each line might be a key or JSON object
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.startsWith(prefix) || trimmed.startsWith('{')) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                entries.push({
+                    key: String(parsed.key ?? ''),
+                    value: typeof parsed.value === 'string' ? parsed.value : JSON.stringify(parsed),
+                });
+            }
+            catch {
+                // Skip non-parseable lines
+            }
+        }
+    }
+    return entries;
+}
+/** Parse `memory search` CLI output into value strings. */
+function parseMemorySearchOutput(raw) {
+    const results = [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            for (const item of parsed) {
+                const value = typeof item === 'string' ? item
+                    : typeof item.value === 'string' ? item.value
+                        : JSON.stringify(item);
+                results.push(value);
+            }
+            return results;
+        }
+    }
+    catch {
+        // Not JSON
+    }
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed && trimmed.startsWith('{')) {
+            results.push(trimmed);
+        }
+    }
+    return results;
+}
+// ============================================================================
+// String Helpers
+// ============================================================================
+function escapeSingleQuotes(s) {
+    return s.replace(/'/g, "'\\''");
+}
+function escapeDQ(s) {
+    return s.replace(/"/g, '\\"');
+}
+//# sourceMappingURL=decision-graph-memory.js.map

package/dist/pipeline/enterprise/decision-graph-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-graph-memory.js","sourceRoot":"","sources":["../../../src/pipeline/enterprise/decision-graph-memory.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/enterprise/decision-graph.d.ts

@@ -0,0 +1,237 @@
+/**
+ * DecisionGraph — Unified Data Model (ADR-033)
+ *
+ * Canonical shared data model for every pipeline execution.
+ * A directed acyclic graph (DAG) where nodes are data artifacts
+ * and edges represent derivation relationships.
+ *
+ * Features:
+ *   - Typed node/edge CRUD with schema validation
+ *   - Append-only version history (originals preserved)
+ *   - Automatic edge creation from derivedFrom references
+ *   - Graph lifecycle management (created → accumulated → sealed)
+ *   - Compound querying with pagination
+ *   - Semantic search on summary fields
+ *   - JSON file persistence + AgentDB memory sync
+ *   - Concurrent-safe writes via monotonic timestamps
+ *   - Statistics and metrics aggregation
+ */
+import type { DecisionGraphNode, DecisionGraphEdge, DecisionNodeType, EdgeRelation, PassNumber, AgentRef } from './types.js';
+/** All valid DecisionNodeType values as a runtime-accessible object. */
+export declare const DECISION_NODE_TYPES: {
+    readonly PROBLEM_DEFINITION: "problem_definition";
+    readonly BUSINESS_CONTEXT: "business_context";
+    readonly TECHNICAL_SCOPE: "technical_scope";
+    readonly ARCHITECTURE_HYPOTHESIS: "architecture_hypothesis";
+    readonly EXECUTION_PLAN: "execution_plan";
+    readonly DECISION_LINEAGE: "decision_lineage";
+    readonly SCENARIO: "scenario";
+    readonly RISK_SIGNAL: "risk_signal";
+    readonly RELIABILITY_REPORT: "reliability_report";
+    readonly SYSTEM_ARCHITECTURE: "system_architecture";
+    readonly INTEGRATION_MAP: "integration_map";
+    readonly DATA_FLOW: "data_flow";
+    readonly SERVICE_BOUNDARY: "service_boundary";
+    readonly PROTOTYPE: "prototype";
+    readonly API_CONTRACT: "api_contract";
+    readonly SDK_INTERFACE: "sdk_interface";
+    readonly SECURITY_ANALYSIS: "security_analysis";
+    readonly COMPLIANCE_REPORT: "compliance_report";
+    readonly COST_MODEL: "cost_model";
+    readonly GOVERNANCE_REPORT: "governance_report";
+    readonly POLICY_ANALYSIS: "policy_analysis";
+    readonly EXECUTIVE_MEMO: "executive_memo";
+    readonly EXECUTIVE_SUMMARY: "executive_summary";
+    readonly RISK_ASSESSMENT: "risk_assessment";
+    readonly IMPLEMENTATION_ROADMAP: "implementation_roadmap";
+    readonly ORG_IMPACT: "org_impact";
+    readonly STAKEHOLDER_MAP: "stakeholder_map";
+    readonly KPI_DEFINITION: "kpi_definition";
+    readonly OKR_ALIGNMENT: "okr_alignment";
+    readonly RAID_LOG: "raid_log";
+    readonly CONFIDENCE_SCORE: "confidence_score";
+    readonly DEPLOYMENT_ENDPOINT: "deployment_endpoint";
+    readonly INTEGRATION_RESULT: "integration_result";
+    readonly TELEMETRY_CONFIG: "telemetry_config";
+    readonly HEALTH_CHECK: "health_check";
+    readonly LEARNED_PATTERN: "learned_pattern";
+    readonly PROVENANCE_MANIFEST: "provenance_manifest";
+};
+/** Set of all valid node type values for runtime validation. */
+export declare const VALID_NODE_TYPES: ReadonlySet<string>;
+/** All valid EdgeRelation values as a runtime-accessible object. */
+export declare const EDGE_RELATIONS: {
+    readonly DERIVED_FROM: "derived_from";
+    readonly INFORMS: "informs";
+    readonly VALIDATES: "validates";
+    readonly SUPERSEDES: "supersedes";
+    readonly AGGREGATES: "aggregates";
+};
+/** Set of all valid edge relation values for runtime validation. */
+export declare const VALID_EDGE_RELATIONS: ReadonlySet<string>;
+/** Lifecycle states for the DecisionGraph. */
+export type GraphLifecycle = 'created' | 'accumulated' | 'sealed' | 'queryable';
+/** A snapshot of a node at a specific version. */
+export interface NodeVersionEntry {
+    readonly version: number;
+    readonly timestamp: string;
+    readonly content: Record<string, unknown>;
+    readonly summary: string;
+    readonly status: DecisionGraphNode['status'];
+    readonly confidence: number;
+}
+/** Compound query filter for nodes. */
+export interface NodeQuery {
+    readonly type?: DecisionNodeType;
+    readonly pass?: PassNumber;
+    readonly tag?: string;
+    readonly status?: DecisionGraphNode['status'];
+    readonly domain?: string;
+    readonly agent?: string;
+    readonly minConfidence?: number;
+}
+/** Pagination options for query results. */
+export interface PaginationOptions {
+    readonly offset?: number;
+    readonly limit?: number;
+}
+/** Paginated query result. */
+export interface PaginatedResult<T> {
+    readonly items: readonly T[];
+    readonly total: number;
+    readonly offset: number;
+    readonly limit: number;
+    readonly hasMore: boolean;
+}
+/** Aggregate statistics for the graph. */
+export interface GraphStatistics {
+    readonly executionId: string;
+    readonly lifecycle: GraphLifecycle;
+    readonly nodeCount: number;
+    readonly edgeCount: number;
+    readonly nodesByPass: Readonly<Record<number, number>>;
+    readonly nodesByType: Readonly<Record<string, number>>;
+    readonly nodesByStatus: Readonly<Record<string, number>>;
+    readonly averageConfidence: number;
+    readonly completenessRatio: number;
+}
+/** Structured node validation error. */
+export interface NodeValidationError {
+    readonly field: string;
+    readonly message: string;
+}
+export declare class DecisionGraph {
+    private readonly nodes;
+    private readonly edges;
+    private readonly versionHistory;
+    private readonly executionId;
+    private readonly outputDir;
+    private lifecycle;
+    private writeSequence;
+    constructor(executionId: string, outputDir: string);
+    /** Get the execution ID. */
+    getExecutionId(): string;
+    /** Get the current lifecycle state. */
+    getLifecycle(): GraphLifecycle;
+    /** Transition to accumulated state (called after first node beyond root). */
+    markAccumulated(): void;
+    /** Seal the graph — no further writes allowed. */
+    seal(): void;
+    /** Mark as queryable — sealed + available for external queries. */
+    markQueryable(): void;
+    /** Check if the graph accepts writes. */
+    isWritable(): boolean;
+    /** Generate a new unique node ID. */
+    generateNodeId(): string;
+    /**
+     * Generate the canonical AgentDB memory key for a node.
+     * Format: decisiongraph:{execution_id}:{node_id}
+     */
+    memoryKey(nodeId: string): string;
+    /** Validate a node against the schema. Returns errors (empty = valid). */
+    validateNode(node: DecisionGraphNode): readonly NodeValidationError[];
+    /** Add a validated node to the graph. Throws on validation failure. */
+    addNode(node: DecisionGraphNode): void;
+    /**
+     * Update an existing node (ADR-033: append-only history).
+     * Original content is preserved in version history.
+     * Increments version and updates timestamp.
+     */
+    updateNode(nodeId: string, updates: Partial<Pick<DecisionGraphNode, 'content' | 'summary' | 'status' | 'confidence' | 'tags'>>): DecisionGraphNode;
+    /** Get a node by ID. Returns undefined if not found. */
+    getNode(nodeId: string): DecisionGraphNode | undefined;
+    /** Get all nodes of a specific type. */
+    getNodesByType(type: DecisionNodeType): readonly DecisionGraphNode[];
+    /** Get all nodes from a specific pass. */
+    getNodesByPass(pass: PassNumber): readonly DecisionGraphNode[];
+    /** Get all nodes produced by a specific agent. */
+    getNodesByAgent(domain: string, agent: string): readonly DecisionGraphNode[];
+    /** Get all nodes matching a tag. */
+    getNodesByTag(tag: string): readonly DecisionGraphNode[];
+    /** Get total node count. */
+    get nodeCount(): number;
+    /** Get total edge count. */
+    get edgeCount(): number;
+    /** Get all nodes as an array. */
+    getAllNodes(): readonly DecisionGraphNode[];
+    /** Get all edges as an array. */
+    getAllEdges(): readonly DecisionGraphEdge[];
+    /**
+     * Query nodes with compound filters and optional pagination.
+     * All filter fields are ANDed together.
+     */
+    queryNodes(filter: NodeQuery, pagination?: PaginationOptions): PaginatedResult<DecisionGraphNode>;
+    /**
+     * Search nodes by text similarity on the summary field.
+     * Uses simple token overlap scoring (production systems would use
+     * vector embeddings via AgentDB HNSW — this provides the interface).
+     */
+    searchBySummary(query: string, topK?: number): readonly DecisionGraphNode[];
+    /** Add an edge to the graph with validation. */
+    addEdge(from: string, to: string, relation: EdgeRelation): void;
+    /** Get all edges from a specific node. */
+    getEdgesFrom(nodeId: string): readonly DecisionGraphEdge[];
+    /** Get all edges to a specific node. */
+    getEdgesTo(nodeId: string): readonly DecisionGraphEdge[];
+    /** Get all edges with a specific relation. */
+    getEdgesByRelation(relation: EdgeRelation): readonly DecisionGraphEdge[];
+    /** Get the full derivation chain for a node (all ancestors, depth-first). */
+    getDerivationChain(nodeId: string): readonly DecisionGraphNode[];
+    /** Get the immediate children of a node (nodes that derive from it). */
+    getChildren(nodeId: string): readonly DecisionGraphNode[];
+    /** Get the full version history for a node. */
+    getVersionHistory(nodeId: string): readonly NodeVersionEntry[];
+    /** Get a specific version of a node's content. */
+    getNodeAtVersion(nodeId: string, version: number): NodeVersionEntry | undefined;
+    /** Create and add a node with minimal boilerplate. Auto-tags with pass/type/agent. */
+    createNode(params: {
+        type: DecisionNodeType;
+        name: string;
+        content: Record<string, unknown>;
+        summary: string;
+        producedBy: AgentRef;
+        pass: PassNumber;
+        derivedFrom?: readonly string[];
+        confidence?: number;
+        status?: DecisionGraphNode['status'];
+        tags?: readonly string[];
+    }): DecisionGraphNode;
+    /** Compute aggregate statistics for the graph. */
+    getStatistics(): GraphStatistics;
+    /** Serialize the graph to JSON (includes version history). */
+    toJSON(): {
+        executionId: string;
+        lifecycle: GraphLifecycle;
+        nodes: DecisionGraphNode[];
+        edges: DecisionGraphEdge[];
+        versionHistory: Record<string, NodeVersionEntry[]>;
+        writeSequence: number;
+    };
+    /** Persist the graph to the output directory. */
+    persist(): string;
+    /** Load a previously persisted graph (rehydrates lifecycle, history, sequence). */
+    static load(executionId: string, outputDir: string): DecisionGraph;
+    /** Generate a human-readable summary of the graph. */
+    summarize(): string;
+}
+//# sourceMappingURL=decision-graph.d.ts.map

package/dist/pipeline/enterprise/decision-graph.d.ts.map

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