@jungjaehoon/mama-core 1.4.1 → 1.5.0

package/dist/decision-formatter.js

@@ -140,7 +140,7 @@ Top ${full.length} Most Relevant Decisions:
 `.trim();
     for (let i = 0; i < full.length; i++) {
         const d = full[i];
-        const duration = calculateDuration(d.created_at);
+        const duration = calculateDuration(getDecisionTimestamp(d));
         const outcomeEmoji = getOutcomeEmoji(d.outcome ?? null);
         const relevancePercent = Math.round((d.relevanceScore || 0) * 100);
         context += `\n\n${i + 1}. ${d.decision} (${duration}, relevance: ${relevancePercent}%) ${outcomeEmoji}`;
@@ -166,7 +166,7 @@ Top ${full.length} Most Relevant Decisions:
  * Format small decision history (3 or fewer)
  */
 function formatSmallHistory(current, history) {
-    const duration = calculateDuration(current.created_at);
+    const duration = calculateDuration(getDecisionTimestamp(current));
     let context = `
 🧠 DECISION HISTORY: ${current.topic}
 
@@ -284,6 +284,9 @@ function calculateDuration(timestamp) {
     }
     return `${diffDays} day${diffDays !== 1 ? 's' : ''} ago`;
 }
+function getDecisionTimestamp(decision) {
+    return decision.event_datetime ?? decision.created_at;
+}
 /**
  * Calculate duration between two timestamps in days
  */
@@ -560,7 +563,7 @@ function formatTeaserList(decisions, topN = 3) {
         output += `\n   "${preview}"`;
         // Recency metadata (NEW - Gaussian Decay)
         if (d.recency_age_days !== undefined && d.created_at) {
-            const timeAgo = calculateDuration(d.created_at);
+            const timeAgo = calculateDuration(getDecisionTimestamp(d));
             const recencyScore = d.recency_score ? Math.round(d.recency_score * 100) : null;
             const finalScore = d.final_score ? Math.round(d.final_score * 100) : null;
             output += `\n   ⏰ ${timeAgo}`;
@@ -582,7 +585,7 @@ function formatTeaser(decision) {
     if (!decision) {
         return null;
     }
-    const timeAgo = calculateDuration(decision.created_at);
+    const timeAgo = calculateDuration(getDecisionTimestamp(decision));
     // Extract preview (first 60 chars)
     const preview = decision.decision.length > 60 ? decision.decision.substring(0, 60) + '...' : decision.decision;
     // Extract files from trust_context or show generic
@@ -633,7 +636,7 @@ function formatRecall(decisions, semanticEdges = null) {
  * Format single decision with full detail
  */
 function formatSingleDecision(decision) {
-    const timeAgo = calculateDuration(decision.created_at);
+    const timeAgo = calculateDuration(getDecisionTimestamp(decision));
     const confidencePercent = Math.round((decision.confidence || 0) * 100);
     const outcomeEmoji = getOutcomeEmoji(decision.outcome ?? null);
     const outcomeText = decision.outcome || 'Not yet tracked';
@@ -725,7 +728,7 @@ function formatDecisionHistory(decisions, semanticEdges = null) {
 📋 Decision History: ${topic}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Latest Decision (${calculateDuration(latest.created_at)}):
+Latest Decision (${calculateDuration(getDecisionTimestamp(latest))}):
 ${latest.decision}
 `.trim();
     // Show brief reasoning if available
@@ -777,7 +780,7 @@ ${latest.decision}
         output += `\nPrevious Decisions (${older.length}):\n`;
         for (let i = 0; i < Math.min(older.length, 5); i++) {
             const d = older[i];
-            const timeAgo = calculateDuration(d.created_at);
+            const timeAgo = calculateDuration(getDecisionTimestamp(d));
             const emoji = getOutcomeEmoji(d.outcome ?? null);
             output += `\n${i + 2}. ${d.decision} (${timeAgo}) ${emoji}`;
             if (d.outcome === 'FAILED' && d.failure_reason) {
@@ -876,7 +879,7 @@ function formatList(decisions, options = {}) {
     output += '━'.repeat(60) + '\n';
     for (let i = 0; i < items.length; i++) {
         const d = items[i];
-        const timeAgo = calculateDuration(d.created_at);
+        const timeAgo = calculateDuration(getDecisionTimestamp(d));
         const type = d.user_involvement === 'approved' ? '👤 User' : '🤖 Assistant';
         const status = d.outcome ? getOutcomeEmoji(d.outcome) + ' ' + d.outcome : '⏳ Pending';
         const confidence = Math.round((d.confidence || 0) * 100);

package/dist/embedding-server/mobile/daemon.d.ts

@@ -83,6 +83,7 @@ export declare class ClaudeDaemon extends EventEmitter {
     private _pid;
     private _isRunning;
     private buffer;
+    private cliSessionId;
     /**
      * Create a new ClaudeDaemon instance
      * @param projectDir - Working directory for Claude Code

package/dist/embedding-server/mobile/daemon.js

@@ -17,6 +17,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClaudeDaemon = exports.ANSI_REGEX = void 0;
 const events_1 = require("events");
+const crypto_1 = require("crypto");
 const child_process_1 = require("child_process");
 /**
  * ANSI escape code regex pattern
@@ -38,6 +39,7 @@ class ClaudeDaemon extends events_1.EventEmitter {
     _pid;
     _isRunning;
     buffer;
+    cliSessionId;
     /**
      * Create a new ClaudeDaemon instance
      * @param projectDir - Working directory for Claude Code
@@ -51,6 +53,7 @@ class ClaudeDaemon extends events_1.EventEmitter {
         this._pid = null;
         this._isRunning = false;
         this.buffer = '';
+        this.cliSessionId = (0, crypto_1.randomUUID)();
     }
     /**
      * Check if the daemon is currently running
@@ -76,13 +79,20 @@ class ClaudeDaemon extends events_1.EventEmitter {
         return new Promise((resolve, reject) => {
             let settled = false;
             try {
-                // Use stream-json mode for bidirectional JSON communication
+                // Requires a modern Claude CLI build with stream-json support
+                // for --print/--verbose/--session-id/--setting-sources.
                 const args = [
+                    '--print',
+                    '--verbose',
                     '--dangerously-skip-permissions',
                     '--input-format',
                     'stream-json',
                     '--output-format',
                     'stream-json',
+                    '--session-id',
+                    this.cliSessionId,
+                    '--setting-sources',
+                    'project,local',
                 ];
                 // Spawn Claude Code CLI
                 this.process = (0, child_process_1.spawn)('claude', args, {

package/dist/entities/audit-metrics.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Entity audit metric helpers.
+ *
+ * Pure functions — no DB, no embeddings. The audit queue assembles the
+ * snapshot from live tables and fixtures, then hands it to these helpers
+ * for deterministic metric calculation + baseline classification.
+ */
+export declare const FALSE_MERGE_HARD_CEILING = 0.02;
+export type EntityAuditClassification = 'improved' | 'stable' | 'regressed' | 'inconclusive';
+export interface AuditCandidateSnapshot {
+    id: string;
+    status: 'pending' | 'auto_merged' | 'approved' | 'rejected' | 'deferred';
+    score_total: number;
+    left_canonical_id: string | null;
+    right_canonical_id: string | null;
+    left_kind: string | null;
+    right_kind: string | null;
+}
+export interface AuditGoldPair {
+    canonical_id: string;
+    left_obs_id: string;
+    right_obs_id: string;
+}
+export interface AuditCandidateGoldLink {
+    candidate_id: string;
+    matched_pair_key: string;
+    score_total: number;
+}
+export interface AuditSnapshot {
+    candidates: AuditCandidateSnapshot[];
+    gold_pairs: AuditGoldPair[];
+    candidate_gold_matches: AuditCandidateGoldLink[];
+    gold_canonical_projection_counts: Record<string, number>;
+}
+export interface AuditMetricSummary {
+    false_merge_rate: number;
+    false_merge_numerator: number;
+    false_merge_denominator: number;
+    cross_language_candidate_recall_at_10: number;
+    cross_language_recall_numerator: number;
+    cross_language_recall_denominator: number;
+    ontology_violation_count: number;
+    projection_fragmentation_rate: number;
+}
+export interface AuditRunClassificationInput {
+    current: AuditMetricSummary;
+    baseline: AuditMetricSummary | null;
+}
+export declare function computeFalseMergeRate(candidates: AuditCandidateSnapshot[]): {
+    rate: number;
+    numerator: number;
+    denominator: number;
+};
+export declare function computeCrossLanguageRecallAtK(goldPairs: AuditGoldPair[], matches: AuditCandidateGoldLink[], k: number): {
+    recall: number;
+    numerator: number;
+    denominator: number;
+};
+export declare function computeCrossLanguageRecallAt5(goldPairs: AuditGoldPair[], matches: AuditCandidateGoldLink[]): {
+    recall: number;
+    numerator: number;
+    denominator: number;
+};
+export declare function computeCrossLanguageRecallAt10(goldPairs: AuditGoldPair[], matches: AuditCandidateGoldLink[]): {
+    recall: number;
+    numerator: number;
+    denominator: number;
+};
+export declare function computeOntologyViolationCount(candidates: AuditCandidateSnapshot[]): number;
+export declare function computeProjectionFragmentationRate(counts: Record<string, number>): number;
+export declare function computeAuditMetrics(snapshot: AuditSnapshot): AuditMetricSummary;
+export declare function classifyAuditRun(input: AuditRunClassificationInput): EntityAuditClassification;
+//# sourceMappingURL=audit-metrics.d.ts.map

package/dist/entities/audit-metrics.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Entity audit metric helpers.
+ *
+ * Pure functions — no DB, no embeddings. The audit queue assembles the
+ * snapshot from live tables and fixtures, then hands it to these helpers
+ * for deterministic metric calculation + baseline classification.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALSE_MERGE_HARD_CEILING = void 0;
+exports.computeFalseMergeRate = computeFalseMergeRate;
+exports.computeCrossLanguageRecallAtK = computeCrossLanguageRecallAtK;
+exports.computeCrossLanguageRecallAt5 = computeCrossLanguageRecallAt5;
+exports.computeCrossLanguageRecallAt10 = computeCrossLanguageRecallAt10;
+exports.computeOntologyViolationCount = computeOntologyViolationCount;
+exports.computeProjectionFragmentationRate = computeProjectionFragmentationRate;
+exports.computeAuditMetrics = computeAuditMetrics;
+exports.classifyAuditRun = classifyAuditRun;
+exports.FALSE_MERGE_HARD_CEILING = 0.02;
+const RESOLVED_MERGE_STATUSES = new Set([
+    'auto_merged',
+    'approved',
+]);
+function computeFalseMergeRate(candidates) {
+    let denominator = 0;
+    let numerator = 0;
+    for (const candidate of candidates) {
+        if (!RESOLVED_MERGE_STATUSES.has(candidate.status))
+            continue;
+        denominator += 1;
+        if (candidate.left_canonical_id &&
+            candidate.right_canonical_id &&
+            candidate.left_canonical_id !== candidate.right_canonical_id) {
+            numerator += 1;
+        }
+    }
+    const rate = denominator === 0 ? 0 : numerator / denominator;
+    return { rate, numerator, denominator };
+}
+function computeCrossLanguageRecallAtK(goldPairs, matches, k) {
+    const denominator = goldPairs.length;
+    if (denominator === 0) {
+        return { recall: 0, numerator: 0, denominator: 0 };
+    }
+    const topRanked = [...matches]
+        .sort((a, b) => b.score_total - a.score_total)
+        .slice(0, Math.max(0, k))
+        .map((m) => m.matched_pair_key);
+    const matched = new Set(topRanked);
+    let numerator = 0;
+    for (const pair of goldPairs) {
+        const key = `${pair.canonical_id}:${pair.left_obs_id}:${pair.right_obs_id}`;
+        if (matched.has(key)) {
+            numerator += 1;
+        }
+    }
+    return { recall: numerator / denominator, numerator, denominator };
+}
+function computeCrossLanguageRecallAt5(goldPairs, matches) {
+    return computeCrossLanguageRecallAtK(goldPairs, matches, 5);
+}
+function computeCrossLanguageRecallAt10(goldPairs, matches) {
+    return computeCrossLanguageRecallAtK(goldPairs, matches, 10);
+}
+function computeOntologyViolationCount(candidates) {
+    let count = 0;
+    for (const candidate of candidates) {
+        if (candidate.left_kind &&
+            candidate.right_kind &&
+            candidate.left_kind !== candidate.right_kind) {
+            count += 1;
+        }
+    }
+    return count;
+}
+function computeProjectionFragmentationRate(counts) {
+    const keys = Object.keys(counts);
+    if (keys.length === 0)
+        return 0;
+    let fragmented = 0;
+    for (const key of keys) {
+        if ((counts[key] ?? 0) > 1)
+            fragmented += 1;
+    }
+    return fragmented / keys.length;
+}
+function computeAuditMetrics(snapshot) {
+    const falseMerge = computeFalseMergeRate(snapshot.candidates);
+    const recall = computeCrossLanguageRecallAt10(snapshot.gold_pairs, snapshot.candidate_gold_matches);
+    const ontology = computeOntologyViolationCount(snapshot.candidates);
+    const fragmentation = computeProjectionFragmentationRate(snapshot.gold_canonical_projection_counts);
+    return {
+        false_merge_rate: falseMerge.rate,
+        false_merge_numerator: falseMerge.numerator,
+        false_merge_denominator: falseMerge.denominator,
+        cross_language_candidate_recall_at_10: recall.recall,
+        cross_language_recall_numerator: recall.numerator,
+        cross_language_recall_denominator: recall.denominator,
+        ontology_violation_count: ontology,
+        projection_fragmentation_rate: fragmentation,
+    };
+}
+function classifyAuditRun(input) {
+    const { current, baseline } = input;
+    if (current.false_merge_rate > exports.FALSE_MERGE_HARD_CEILING) {
+        return 'regressed';
+    }
+    if (!baseline) {
+        return 'inconclusive';
+    }
+    if (current.false_merge_rate > baseline.false_merge_rate) {
+        return 'regressed';
+    }
+    const recallUp = current.cross_language_candidate_recall_at_10 > baseline.cross_language_candidate_recall_at_10;
+    const fragmentationDown = current.projection_fragmentation_rate < baseline.projection_fragmentation_rate;
+    const ontologyDown = current.ontology_violation_count < baseline.ontology_violation_count;
+    if (recallUp || fragmentationDown || ontologyDown) {
+        const anyRegression = current.cross_language_candidate_recall_at_10 <
+            baseline.cross_language_candidate_recall_at_10 ||
+            current.projection_fragmentation_rate > baseline.projection_fragmentation_rate ||
+            current.ontology_violation_count > baseline.ontology_violation_count;
+        if (anyRegression)
+            return 'stable';
+        return 'improved';
+    }
+    return 'stable';
+}
+//# sourceMappingURL=audit-metrics.js.map

package/dist/entities/candidate-generator.d.ts

@@ -0,0 +1,9 @@
+import type { EntityObservation, EntityResolutionCandidate } from './types.js';
+export declare const ENTITY_EMBEDDING_TOPN = 50;
+export interface CandidateGeneratorOptions {
+    embeddingScorer?: (left: EntityObservation, right: EntityObservation) => Promise<number>;
+    topN?: number;
+}
+export declare function dedupeObservationsBySource(observations: EntityObservation[]): EntityObservation[];
+export declare function generateResolutionCandidates(observations: EntityObservation[], options?: CandidateGeneratorOptions): Promise<EntityResolutionCandidate[]>;
+//# sourceMappingURL=candidate-generator.d.ts.map