@jungjaehoon/mama-core 1.1.2 → 1.1.3

package/dist/decision-tracker.d.ts

@@ -0,0 +1,218 @@
+/**
+ * MAMA (Memory-Augmented MCP Architecture) - Decision Tracker
+ *
+ * Learn and store decisions with graph relationships
+ * Tasks: 3.1-3.9 (Learn decision, ID generation, supersedes edges, refinement, embeddings)
+ * AC #1: Decision stored with outcome=NULL, confidence from LLM
+ * AC #2: Supersedes relationship creation
+ * AC #5: Multi-parent refinement with confidence calculation
+ *
+ * Updated for PostgreSQL compatibility via db-manager
+ *
+ * @module decision-tracker
+ * @version 2.0
+ * @date 2025-11-17
+ */
+import type { DecisionRecord } from './db-manager.js';
+export type { DecisionRecord };
+export declare const VALID_EDGE_TYPES: readonly ["supersedes", "refines", "contradicts", "builds_on", "debates", "synthesizes"];
+export type EdgeType = (typeof VALID_EDGE_TYPES)[number];
+/**
+ * Decision detection result from analysis
+ */
+export interface DecisionDetection {
+    topic: string;
+    decision: string;
+    reasoning: string;
+    confidence: number;
+    type?: string;
+    trust_context?: Record<string, unknown>;
+    evidence?: string | string[];
+    alternatives?: string | string[];
+    risks?: string;
+}
+/**
+ * Tool execution context
+ */
+export interface ToolExecution {
+    timestamp?: number;
+    tool_name?: string;
+    tool_input?: unknown;
+    exit_code?: number;
+}
+/**
+ * Session context for decision tracking
+ */
+export interface SessionContext {
+    session_id?: string;
+    latest_user_message?: string;
+    recent_exchange?: string;
+}
+/**
+ * Learn decision result
+ */
+export interface LearnDecisionResult {
+    decisionId: string;
+    notification: unknown | null;
+}
+/**
+ * Parsed relationship from reasoning
+ */
+export interface ParsedRelationship {
+    type: string;
+    targetIds: string[];
+}
+/**
+ * Generate decision ID
+ *
+ * Task 3.2: Generate decision ID: `decision_${topic}_${timestamp}`
+ *
+ * @param topic - Decision topic
+ * @returns Decision ID
+ */
+export declare function generateDecisionId(topic: string): string;
+/**
+ * Check for previous decision on same topic
+ *
+ * Task 3.3: Query decisions table WHERE topic=? AND superseded_by IS NULL
+ * AC #2: Find previous decision to create supersedes relationship
+ *
+ * @param topic - Decision topic
+ * @returns Previous decision or null
+ */
+export declare function getPreviousDecision(topic: string): Promise<DecisionRecord | null>;
+/**
+ * Create a decision edge with specified relationship type
+ *
+ * Story 2.1: Generic edge creation supporting all relationship types
+ *
+ * @param fromId - Source decision ID
+ * @param toId - Target decision ID
+ * @param relationship - Edge type (supersedes, builds_on, debates, synthesizes, etc.)
+ * @param reason - Reason for the relationship
+ * @returns Success status
+ */
+export declare function createEdge(fromId: string, toId: string, relationship: string, reason: string): Promise<boolean>;
+/**
+ * Create supersedes edge
+ *
+ * Task 3.5: Create supersedes edge (INSERT INTO decision_edges)
+ * AC #2: Supersedes relationship creation
+ *
+ * @param fromId - New decision ID
+ * @param toId - Previous decision ID
+ * @param reason - Reason for superseding
+ */
+export declare function createSupersedesEdge(fromId: string, toId: string, reason: string): Promise<boolean>;
+/**
+ * Update previous decision's superseded_by field
+ *
+ * Task 3.5: Update previous decision's superseded_by field
+ * AC #2: Previous decision's superseded_by field updated
+ *
+ * @param previousId - Previous decision ID
+ * @param newId - New decision ID
+ */
+export declare function markSuperseded(previousId: string, newId: string): Promise<void>;
+/**
+ * Calculate combined confidence (Bayesian update)
+ *
+ * Task 3.6: Calculate combined confidence for multi-parent refinement
+ * AC #5: Confidence score calculated based on history
+ *
+ * @param prior - Prior confidence
+ * @param parents - Parent decisions
+ * @returns Updated confidence (0.0-1.0)
+ */
+export declare function calculateCombinedConfidence(prior: number, parents: Array<{
+    confidence?: number;
+}>): number;
+/**
+ * Detect multi-parent refinement
+ *
+ * Task 3.6: Detect if new decision refines multiple previous decisions
+ * AC #5: Multi-parent refinement
+ *
+ * @param _detection - Decision detection result
+ * @param _sessionContext - Session context
+ * @returns Array of parent decision IDs or null
+ */
+export declare function detectRefinement(_detection: DecisionDetection, _sessionContext: SessionContext): string[] | null;
+/**
+ * Parse reasoning field for relationship references
+ *
+ * Story 2.2: Detect patterns like:
+ * - builds_on: <decision_id>
+ * - debates: <decision_id>
+ * - synthesizes: [id1, id2]
+ *
+ * @param reasoning - Decision reasoning text
+ * @returns Detected relationships
+ */
+export declare function parseReasoningForRelationships(reasoning: string): ParsedRelationship[];
+/**
+ * Create edges from parsed reasoning relationships
+ *
+ * Story 2.2: Auto-create edges when reasoning references other decisions
+ *
+ * @param fromId - Source decision ID
+ * @param reasoning - Decision reasoning text
+ * @returns Edge creation stats
+ */
+export declare function createEdgesFromReasoning(fromId: string, reasoning: string): Promise<{
+    created: number;
+    failed: number;
+}>;
+/**
+ * Get supersedes chain depth for a topic
+ *
+ * Story 2.2: Calculate how many times a topic has been superseded
+ *
+ * @param topic - Decision topic
+ * @returns Chain depth and decision IDs
+ */
+export declare function getSupersededChainDepth(topic: string): Promise<{
+    depth: number;
+    chain: string[];
+}>;
+/**
+ * Learn Decision Function (Main API)
+ *
+ * Task 3.1: Create Learn Decision Function
+ * Task 3.2: Generate decision ID
+ * Task 3.3: Check for previous decision on same topic
+ * Task 3.4: Insert new decision with outcome=NULL, confidence from LLM
+ * Task 3.5: If previous exists: Create supersedes edge, Update previous superseded_by
+ * Task 3.6: If multi-parent refinement: Store refined_from, Calculate combined confidence
+ * Task 3.7: Generate enhanced embedding
+ * Task 3.8: Store in vss_memories (link via rowid)
+ *
+ * AC #1: Decision stored with outcome=NULL, confidence from LLM
+ * AC #2: Supersedes relationship creation
+ * AC #5: Multi-parent refinement with confidence calculation
+ *
+ * @param detection - Decision detection result
+ * @param toolExecution - Tool execution data
+ * @param sessionContext - Session context
+ * @returns decisionId and notification
+ */
+export declare function learnDecision(detection: DecisionDetection, toolExecution: ToolExecution, sessionContext: SessionContext): Promise<LearnDecisionResult>;
+/**
+ * Evidence item for confidence updates
+ */
+export interface EvidenceItem {
+    type: 'success' | 'failure' | 'partial';
+    impact: number;
+}
+/**
+ * Update confidence score
+ *
+ * Task 6: Confidence evolution (used in outcome tracking)
+ * AC #5: Confidence score calculated based on history
+ *
+ * @param prior - Prior confidence
+ * @param evidence - Evidence items
+ * @returns Updated confidence (0.0-1.0)
+ */
+export declare function updateConfidence(prior: number, evidence: EvidenceItem[]): number;
+//# sourceMappingURL=decision-tracker.d.ts.map