gitmem-mcp 1.0.2 → 1.0.4

package/dist/tools/session-start.js

@@ -4,27 +4,26 @@
  * Initialize session, detect agent, load institutional context.
  * Returns threads and recent decisions. Scars surface via recall on demand.
  *
- * Performance target: <750ms (OD-645: Lean Start)
+ * Performance target: <750ms
  *
- * OD-645: Removed scar/wins queries from start pipeline.
+ * Removed scar/wins queries from start pipeline.
  * Scars load on-demand via recall(). Wins available via search/log.
  * loadLastSession and loadRecentDecisions run in parallel.
  * createSessionRecord is fire-and-forget.
  */
 import * as fs from "fs";
-import * as path from "path";
 import { v4 as uuidv4 } from "uuid";
 import { detectAgent } from "../services/agent-detection.js";
 import * as supabase from "../services/supabase-client.js";
-// OD-645: Scar search removed from start pipeline (loads on-demand via recall)
+// Scar search removed from start pipeline (loads on-demand via recall)
 import { ensureInitialized } from "../services/startup.js";
 import { hasSupabase } from "../services/tier.js";
 import { getStorage } from "../services/storage.js";
 import { Timer, recordMetrics, calculateContextBytes, buildPerformanceData, buildComponentPerformance, } from "../services/metrics.js";
-import { setCurrentSession, getCurrentSession, addSurfacedScars, getSurfacedScars } from "../services/session-state.js"; // OD-547, OD-552
-import { aggregateThreads, saveThreadsFile, loadThreadsFile, mergeThreadStates } from "../services/thread-manager.js"; // OD-thread-lifecycle
-import { deduplicateThreadList } from "../services/thread-dedup.js"; // OD-641
-import { loadActiveThreadsFromSupabase, archiveDormantThreads } from "../services/thread-supabase.js"; // OD-623, Phase 6
+import { setCurrentSession, getCurrentSession, addSurfacedScars, getSurfacedScars } from "../services/session-state.js";
+import { aggregateThreads, saveThreadsFile, loadThreadsFile, mergeThreadStates } from "../services/thread-manager.js"; // 
+import { deduplicateThreadList } from "../services/thread-dedup.js";
+import { loadActiveThreadsFromSupabase, archiveDormantThreads } from "../services/thread-supabase.js";
 import { setGitmemDir, getGitmemDir, getSessionPath, getConfigProject } from "../services/gitmem-dir.js";
 import { registerSession, findSessionByHostPid, pruneStale, migrateFromLegacy } from "../services/active-sessions.js";
 import * as os from "os";
@@ -37,19 +36,19 @@ import { formatDate } from "../services/timezone.js";
 function normalizeDecisions(decisions) {
     return decisions.map((d) => typeof d === "string" ? d : d.title);
 }
-// OD-645: WinRecord removed (wins available via search/log)
+// WinRecord removed (wins available via search/log)
 /**
  * Aggregate open threads across multiple recent sessions.
  * Deduplicates by exact lowercase match. Excludes PROJECT STATE: threads
  * (handled separately). Only includes sessions from the last maxAgeDays.
  */
-// aggregateOpenThreads replaced by aggregateThreads from thread-manager.ts (OD-thread-lifecycle)
+// aggregateOpenThreads replaced by aggregateThreads from thread-manager.ts ()
 /**
  * Load the last CLOSED session for this agent.
  * Filters out orphaned sessions (those without close_compliance).
- * Uses _lite view for performance (OD-460 added arrays to view).
+ * Uses _lite view for performance.
  *
- * OD-489: Returns timing and network call info for instrumentation.
+ * Returns timing and network call info for instrumentation.
  */
 async function loadLastSession(agent, project) {
     const timer = new Timer();
@@ -67,14 +66,14 @@ async function loadLastSession(agent, project) {
     }
     try {
         // Use _lite view for performance (excludes embedding)
-        // OD-460: View now includes decisions/open_threads arrays
+        // View now includes decisions/open_threads arrays
         const sessions = await supabase.listRecords({
             table: "orchestra_sessions_lite",
             filters: { agent, project },
             limit: 10, // Get several to find a closed one + aggregate threads
             orderBy: { column: "created_at", ascending: false },
         });
-        // OD-623: Try loading threads from Supabase (source of truth) first
+        // Try loading threads from Supabase (source of truth) first
         let aggregated_open_threads;
         let displayInfo = [];
         let threadsFromSupabase = false;
@@ -86,7 +85,7 @@ async function loadLastSession(agent, project) {
             threadsFromSupabase = true;
             console.error(`[session_start] Loaded ${aggregated_open_threads.length} open threads from Supabase`);
             // Phase 6: Auto-archive dormant threads (fire-and-forget)
-            archiveDormantThreads(project).catch(() => { });
+            archiveDormantThreads(project).catch((err) => console.error("[session_start] archiveDormantThreads failed:", err instanceof Error ? err.message : err));
         }
         else {
             // Fallback: aggregate from session records (original behavior)
@@ -139,9 +138,9 @@ async function loadLastSession(agent, project) {
         return { session: null, aggregated_open_threads: [], displayInfo: [], latency_ms: timer.stop(), network_call: true, threadsFromSupabase: false };
     }
 }
-// OD-645: queryRelevantScars removed — scars load on-demand via recall()
+// queryRelevantScars removed — scars load on-demand via recall()
 /**
- * OD-666: Load recent rapport summaries across all agents for this project.
+ * Load recent rapport summaries across all agents for this project.
  * Returns up to 3 most recent sessions that have a non-null rapport_summary.
  * Cross-agent by design: CLI session rapport visible to DAC's next session.
  */
@@ -171,14 +170,14 @@ async function loadRecentRapport(project) {
     }
 }
 /**
- * Load recent decisions with caching (OD-473)
+ * Load recent decisions with caching
  *
- * OD-489: Returns timing and network call info for instrumentation.
+ * Returns timing and network call info for instrumentation.
  */
 async function loadRecentDecisions(project, limit = 5) {
     const timer = new Timer();
     try {
-        // Use cached decisions query (OD-473)
+        // Use cached decisions query
         // Fetch extra to account for date filtering
         const { data: decisions, cache_hit, cache_age_ms } = await supabase.cachedListDecisions(project, limit + 5);
         // Filter by project in memory if needed (ww-mcp filters may not work with views)
@@ -216,13 +215,13 @@ async function loadRecentDecisions(project, limit = 5) {
         };
     }
 }
-// OD-645: loadRecentWins removed — wins available via search/log on-demand
+// loadRecentWins removed — wins available via search/log on-demand
 /**
  * Create a new session record
  *
- * OD-489: Returns timing and network call info for instrumentation.
+ * Returns timing and network call info for instrumentation.
  */
-async function createSessionRecord(agent, project, linearIssue, preGeneratedId // OD-645: Accept pre-generated UUID for fire-and-forget pattern
+async function createSessionRecord(agent, project, linearIssue, preGeneratedId // Accept pre-generated UUID for fire-and-forget pattern
 ) {
     const sessionId = preGeneratedId || uuidv4();
     const today = new Date().toISOString().split("T")[0];
@@ -232,7 +231,7 @@ async function createSessionRecord(agent, project, linearIssue, preGeneratedId /
         return { session_id: sessionId, latency_ms: timer.stop(), network_call: false };
     }
     try {
-        // OD-cast: Capture asciinema recording path from Docker entrypoint
+        // Capture asciinema recording path from Docker entrypoint
         const recordingPath = process.env.GITMEM_RECORDING_PATH || null;
         await supabase.directUpsert("orchestra_sessions", {
             id: sessionId,
@@ -308,7 +307,7 @@ async function sessionStartFree(params, env, agent, project, timer, metricsId, e
             order: "session_date.desc",
             limit: 10,
         });
-        // Aggregate threads across recent sessions (OD-thread-lifecycle)
+        // Aggregate threads across recent sessions ()
         const freeThreadResult = aggregateThreads(sessions);
         freeAggregatedThreads = freeThreadResult.open;
         const closedSession = sessions.find((s) => s.close_compliance != null) || sessions[0];
@@ -325,7 +324,7 @@ async function sessionStartFree(params, env, agent, project, timer, metricsId, e
     catch (error) {
         console.error("[session_start] Failed to load last session:", error);
     }
-    // OD-645: Scars removed from start pipeline — load on-demand via recall
+    // Scars removed from start pipeline — load on-demand via recall
     // Load recent decisions from local storage (time-scoped to 5 days)
     let decisions = [];
     try {
@@ -349,7 +348,7 @@ async function sessionStartFree(params, env, agent, project, timer, metricsId, e
     catch (error) {
         console.error("[session_start] Failed to load decisions:", error);
     }
-    // OD-645: Wins removed from start pipeline — available via search/log
+    // Wins removed from start pipeline — available via search/log
     // Create session record locally (skip if resuming existing session)
     if (!isResuming) {
         try {
@@ -378,9 +377,9 @@ async function sessionStartFree(params, env, agent, project, timer, metricsId, e
         ?.map((t) => typeof t === "string" ? t : t.text)
         .find((t) => t.startsWith("PROJECT STATE:"))
         ?.replace(/^PROJECT STATE:\s*/, "");
-    // OD-645: Simplified performance data (no scars/wins)
+    // Simplified performance data (no scars/wins)
     const performance = buildPerformanceData("session_start", latencyMs, decisions.length + (lastSession ? 1 : 0));
-    // OD-645: surfacedScars initialized empty — populated by recall during session
+    // surfacedScars initialized empty — populated by recall during session
     const surfacedScars = [];
     // GIT-20: Persist to per-session dir, legacy file, and registry
     // writeSessionFiles merges with existing file threads to preserve mid-session creations
@@ -403,7 +402,7 @@ async function sessionStartFree(params, env, agent, project, timer, metricsId, e
         children: forceCarryActivity?.children,
         threads: freeMergedThreads,
     });
-    // OD-645: No scars/wins in start result
+    // No scars/wins in start result
     const freeResult = {
         session_id: sessionId,
         agent,
@@ -421,11 +420,14 @@ async function sessionStartFree(params, env, agent, project, timer, metricsId, e
     // Write display to per-session dir
     try {
         const sessionFilePath = getSessionPath(sessionId, "session.json");
-        const sessionData = JSON.parse(fs.readFileSync(sessionFilePath, "utf-8"));
+        const raw = fs.readFileSync(sessionFilePath, "utf-8");
+        const sessionData = JSON.parse(raw);
         sessionData.display = freeResult.display;
         fs.writeFileSync(sessionFilePath, JSON.stringify(sessionData, null, 2));
     }
-    catch { /* non-critical */ }
+    catch (err) {
+        console.error("[session_start] Failed to write display to session file:", err instanceof Error ? err.message : err);
+    }
     return freeResult;
 }
 /**
@@ -465,7 +467,7 @@ function restoreSessionState(existing, fallbackAgent) {
     };
 }
 /**
- * GIT-20 / OD-558: Check for existing active session and return it if found.
+ * Check for existing active session and return it if found.
  *
  * Uses the active-sessions registry (hostname+PID) to identify THIS process's
  * session, preventing cross-process session theft on shared filesystems.
@@ -506,7 +508,7 @@ function checkExistingSession(agent, force) {
  * Consolidates write logic used by session_start (main + free) and session_refresh.
  */
 function writeSessionFiles(sessionId, agent, project, surfacedScars, threads, recordingPath, isRefresh, supabaseAuthoritative, startedAt) {
-    const gitmemDir = path.join(process.cwd(), ".gitmem");
+    const gitmemDir = getGitmemDir();
     if (!fs.existsSync(gitmemDir)) {
         fs.mkdirSync(gitmemDir, { recursive: true });
     }
@@ -671,10 +673,10 @@ function formatStartDisplay(result, displayInfoMap) {
 /**
  * Execute session_start tool
  *
- * OD-489: Returns detailed performance breakdown for test harness validation.
+ * Returns detailed performance breakdown for test harness validation.
  * Key metrics: network_calls_made, fully_local, breakdown per component.
  *
- * OD-558: Guards against overwriting existing active sessions.
+ * Guards against overwriting existing active sessions.
  * Returns existing session if active-session.json exists (idempotent).
  * Pass force=true to override.
  */
@@ -685,7 +687,7 @@ export async function sessionStart(params) {
     const env = detectAgent();
     const agent = params.agent_identity || env.agent;
     const project = params.project || getConfigProject() || "default";
-    // OD-558: Check for existing active session — reuse session_id but still load full context
+    // Check for existing active session — reuse session_id but still load full context
     const existingSession = checkExistingSession(agent, params.force);
     const isResuming = existingSession !== null;
     // t-f7c2fa01: When force:true kills an existing session, carry forward its startedAt
@@ -700,18 +702,18 @@ export async function sessionStart(params) {
     if (!hasSupabase()) {
         return sessionStartFree(params, env, agent, project, timer, metricsId, existingSession?.sessionId, existingSession?.startedAt || forceCarryStartedAt, priorSession ? { surfacedScars: forceCarrySurfacedScars, observations: forceCarryObservations, children: forceCarryChildren } : undefined);
     }
-    // 2. OD-645: Load last session + decisions in parallel (was sequential)
+    // 2. Load last session + decisions in parallel (was sequential)
     // Scars and wins removed from pipeline — load on-demand via recall/search
-    // OD-666: Rapport loading disabled — recording kept in session_close but not injected
+    // Rapport loading disabled — recording kept in session_close but not injected
     const [lastSessionResult, decisionsResult] = await Promise.all([
         loadLastSession(agent, project),
         loadRecentDecisions(project, 3),
     ]);
     const lastSession = lastSessionResult.session;
     const decisions = decisionsResult.decisions;
-    // OD-645: surfacedScars initialized empty — populated by recall/confirm_scars during session
+    // surfacedScars initialized empty — populated by recall/confirm_scars during session
     const surfacedScars = [];
-    // 3. Create session record — fire-and-forget (OD-645)
+    // 3. Create session record — fire-and-forget
     // UUID generated locally, Supabase write runs in background
     let sessionId;
     if (isResuming) {
@@ -742,12 +744,12 @@ export async function sessionStart(params) {
         });
     }).catch(() => { });
     const latencyMs = timer.stop();
-    // OD-534: Extract PROJECT STATE from last session if present
+    // Extract PROJECT STATE from last session if present
     const projectState = lastSession?.open_threads
         ?.map((t) => typeof t === "string" ? t : t.text)
         .find(t => t.startsWith("PROJECT STATE:"))
         ?.replace(/^PROJECT STATE:\s*/, "");
-    // OD-645: Simplified performance breakdown (no scar_search, wins, session_create)
+    // Simplified performance breakdown (no scar_search, wins, session_create)
     const breakdown = {
         last_session: buildComponentPerformance(lastSessionResult.latency_ms, "supabase", lastSessionResult.network_call, lastSessionResult.network_call ? "miss" : "hit"),
         decisions: buildComponentPerformance(decisionsResult.latency_ms, decisionsResult.cache_hit ? "local_cache" : "supabase", decisionsResult.network_call, decisionsResult.cache_hit ? "hit" : "miss"),
@@ -770,9 +772,9 @@ export async function sessionStart(params) {
     catch (error) {
         console.warn("[session_start] Failed to persist session files:", error);
     }
-    // OD-547: Set active session for variant assignment in recall
-    // OD-552: Initialize with surfaced scars for auto-bridge at close time
-    // OD-thread-lifecycle: Initialize with merged threads (aggregated + mid-session preserved)
+    // Set active session for variant assignment in recall
+    // Initialize with surfaced scars for auto-bridge at close time
+    // : Initialize with merged threads (aggregated + mid-session preserved)
     // t-f7c2fa01: On resume OR force, preserve original startedAt so session_close duration is accurate
     const mergedScars = [...forceCarrySurfacedScars, ...surfacedScars];
     setCurrentSession({
@@ -786,7 +788,7 @@ export async function sessionStart(params) {
         children: forceCarryChildren,
         threads: mergedThreads,
     });
-    // OD-645: Build result — no scars/wins (load on-demand via recall/search)
+    // Build result — no scars/wins (load on-demand via recall/search)
     const openOnly = mergedThreads.filter(t => t.status === "open" || !t.status);
     // Strip bulky fields from last_session — open_threads used only for PROJECT STATE extraction above
     const slimLastSession = lastSession ? {
@@ -802,7 +804,7 @@ export async function sessionStart(params) {
         ...(isResuming && { resumed: true }),
         detected_environment: env,
         last_session: slimLastSession,
-        ...(projectState && { project_state: projectState }), // OD-534
+        ...(projectState && { project_state: projectState }),
         ...(openOnly.length > 0 && { open_threads: openOnly }),
         recent_decisions: decisions,
         ...(recordingPath && { recording_path: recordingPath }),
@@ -810,7 +812,7 @@ export async function sessionStart(params) {
         project,
         performance,
     };
-    // Record metrics (OD-645: simplified — no scar-related fields)
+    // Record metrics
     recordMetrics({
         id: metricsId,
         session_id: sessionId,
@@ -859,11 +861,11 @@ export async function sessionRefresh(params) {
     let project;
     if (currentSession) {
         sessionId = currentSession.sessionId;
-        agent = currentSession.agent || "CLI";
+        agent = currentSession.agent || "cli";
         project = params.project || currentSession.project || "default";
     }
     else {
-        // GIT-20: Fallback — check registry for this process, then legacy file
+        // Fallback — check registry for this process, then legacy file
         const mySession = findSessionByHostPid(os.hostname(), process.pid);
         let raw = null;
         if (mySession) {
@@ -872,14 +874,14 @@ export async function sessionRefresh(params) {
         if (!raw || !raw.session_id) {
             return {
                 session_id: "",
-                agent: "CLI",
+                agent: "cli",
                 refreshed: true,
                 message: "No active session — call session_start first",
                 performance: buildPerformanceData("session_refresh", timer.stop(), 0),
             };
         }
         sessionId = raw.session_id;
-        agent = raw.agent || "CLI";
+        agent = raw.agent || "cli";
         project = params.project || raw.project || "default";
     }
     // Free tier: all-local path (reuse session_start free path)
@@ -892,24 +894,24 @@ export async function sessionRefresh(params) {
             performance: buildPerformanceData("session_refresh", timer.stop(), 0),
         };
     }
-    // 2. OD-645: Load last session + decisions in parallel (same as session_start)
+    // 2. Load last session + decisions in parallel (same as session_start)
     // Scars and wins removed — load on-demand via recall/search
-    // OD-666: Rapport loading disabled — recording kept in session_close but not injected
+    // Rapport loading disabled — recording kept in session_close but not injected
     const [lastSessionResult, decisionsResult] = await Promise.all([
         loadLastSession(agent, project),
         loadRecentDecisions(project, 3),
     ]);
     const lastSession = lastSessionResult.session;
     const decisions = decisionsResult.decisions;
-    // OD-645: surfacedScars not re-queried on refresh — existing ones preserved in session state
+    // surfacedScars not re-queried on refresh — existing ones preserved in session state
     const refreshAggregatedThreads = lastSessionResult.aggregated_open_threads;
     const refreshDisplayInfo = lastSessionResult.displayInfo;
-    // 3. Extract PROJECT STATE (OD-534)
+    // 3. Extract PROJECT STATE
     const projectState = lastSession?.open_threads
         ?.map((t) => typeof t === "string" ? t : t.text)
         .find(t => t.startsWith("PROJECT STATE:"))
         ?.replace(/^PROJECT STATE:\s*/, "");
-    // 4. OD-645: Simplified performance breakdown (no scar_search, wins)
+    // 4. Simplified performance breakdown (no scar_search, wins)
     const latencyMs = timer.stop();
     const breakdown = {
         last_session: buildComponentPerformance(lastSessionResult.latency_ms, "supabase", lastSessionResult.network_call, lastSessionResult.network_call ? "miss" : "hit"),
@@ -917,7 +919,7 @@ export async function sessionRefresh(params) {
     };
     const performance = buildPerformanceData("session_refresh", latencyMs, decisions.length + (lastSession ? 1 : 0), { breakdown });
     const recordingPath = process.env.GITMEM_RECORDING_PATH || undefined;
-    // OD-645: Build result — no scars/wins
+    // Build result — no scars/wins
     const result = {
         session_id: sessionId,
         agent,
@@ -927,7 +929,7 @@ export async function sessionRefresh(params) {
         ...(projectState && { project_state: projectState }),
         // open_threads filled after merge below
         recent_decisions: decisions,
-        // OD-666: Rapport disabled — not injected into session context
+        // Rapport disabled — not injected into session context
         ...(recordingPath && { recording_path: recordingPath }),
         project,
         performance,
@@ -957,7 +959,7 @@ export async function sessionRefresh(params) {
         threads: refreshMergedThreads,
         linearIssue: currentSession?.linearIssue,
     });
-    // Record metrics (OD-645: simplified — no scar-related fields)
+    // Record metrics
     recordMetrics({
         id: metricsId,
         session_id: sessionId,

package/dist/types/index.d.ts

@@ -35,7 +35,7 @@ export interface PerformanceData {
     cache_age_ms?: number;
     search_mode?: "local" | "remote";
 }
-export type AgentIdentity = "CLI" | "DAC" | "CODA-1" | "Brain_Local" | "Brain_Cloud" | "Unknown";
+export type AgentIdentity = "cli" | "desktop" | "autonomous" | "local" | "cloud" | "Unknown";
 export type Project = string;
 export type ThreadStatus = "open" | "resolved";
 export interface ThreadObject {
@@ -94,7 +94,7 @@ export interface SessionStartParams {
     issue_description?: string;
     issue_labels?: string[];
     project?: Project;
-    /** OD-558: Force overwrite of existing active session */
+    /** Force overwrite of existing active session */
     force?: boolean;
 }
 export interface LastSession {
@@ -117,6 +117,7 @@ export interface RelevantScar {
     action_protocol?: string[];
     self_check_criteria?: string[];
     decay_multiplier?: number;
+    is_starter?: boolean;
 }
 export interface RecentDecision {
     id: string;
@@ -136,7 +137,7 @@ export interface SessionStartResult {
     agent: AgentIdentity;
     detected_environment?: DetectedEnvironment;
     last_session?: LastSession | null;
-    /** OD-534: PROJECT STATE thread extracted from last session (if present) */
+    /** PROJECT STATE thread extracted from last session (if present) */
     project_state?: string;
     /** Aggregated open threads across last 5 sessions (deduplicated, migrated to objects) */
     open_threads?: ThreadObject[];
@@ -144,7 +145,7 @@ export interface SessionStartResult {
     suggested_threads?: ThreadSuggestion[];
     relevant_scars?: RelevantScar[];
     recent_decisions?: RecentDecision[];
-    /** OD-666: Cross-agent rapport summaries from recent sessions */
+    /** Cross-agent rapport summaries from recent sessions */
     rapport_summaries?: {
         agent: string;
         summary: string;
@@ -152,11 +153,11 @@ export interface SessionStartResult {
     }[];
     recent_wins?: RecentWin[];
     performance?: PerformanceData;
-    /** OD-558: Whether this session was resumed from an existing active session */
+    /** Whether this session was resumed from an existing active session */
     resumed?: boolean;
     /** Whether this result is from a mid-session refresh (no new session created) */
     refreshed?: boolean;
-    /** OD-558: Message explaining session state */
+    /** Message explaining session state */
     message?: string;
     /** Asciinema recording path for session replay (from GITMEM_RECORDING_PATH env var) */
     recording_path?: string;
@@ -183,7 +184,7 @@ export interface ClosingReflection {
     rapport_notes?: string;
 }
 /**
- * Task completion proof for standard close (OD-491)
+ * Task completion proof for standard close
  *
  * Enforces that each step in the closing protocol was actually completed.
  * Timestamps must be in logical order and human_response requires minimum gap.
@@ -209,21 +210,21 @@ export interface SessionDecision {
 export interface SessionCloseParams {
     session_id: string;
     close_type: CloseType;
-    /** Task completion proof - REQUIRED for standard close (OD-491) */
+    /** Task completion proof - REQUIRED for standard close */
     task_completion?: TaskCompletion;
     closing_reflection?: ClosingReflection;
     human_corrections?: string;
     decisions?: SessionDecision[];
     open_threads?: (string | ThreadObject)[];
-    /** Optional PROJECT STATE that auto-prepends to open_threads[0] (OD-534) */
+    /** Optional PROJECT STATE that auto-prepends to open_threads[0] */
     project_state?: string;
     learnings_created?: (string | Record<string, unknown>)[];
     linear_issue?: string;
     ceremony_duration_ms?: number;
     scars_to_record?: ScarUsageEntry[];
-    /** OD-538: Capture full conversation transcript to Supabase storage (defaults to true for CLI/DAC) */
+    /** Capture full conversation transcript to Supabase storage (defaults to true for CLI/DAC) */
     capture_transcript?: boolean;
-    /** OD-538: Explicit transcript file path (overrides automatic detection) */
+    /** Explicit transcript file path (overrides automatic detection) */
     transcript_path?: string;
 }
 export interface CloseCompliance {
@@ -270,7 +271,7 @@ export interface CreateLearningResult {
     success: boolean;
     learning_id: string;
     embedding_generated: boolean;
-    /** Error details when success=false (OD-554: surface DB/validation errors) */
+    /** Error details when success=false */
     errors?: string[];
     display?: string;
     performance: PerformanceData;
@@ -301,18 +302,21 @@ export interface SurfacedScar {
     variant_id?: string;
 }
 export type ConfirmationDecision = "APPLYING" | "N_A" | "REFUTED";
+export type ScarRelevance = "high" | "low" | "noise";
 export interface ScarConfirmation {
     scar_id: string;
     scar_title: string;
     decision: ConfirmationDecision;
     evidence: string;
     confirmed_at: string;
+    relevance?: ScarRelevance;
 }
 export interface ConfirmScarsParams {
     confirmations: Array<{
         scar_id: string;
         decision: ConfirmationDecision;
         evidence: string;
+        relevance?: ScarRelevance;
     }>;
 }
 export interface ConfirmScarsResult {
@@ -341,7 +345,7 @@ export interface RecordScarUsageParams {
 export interface RecordScarUsageResult {
     success: boolean;
     usage_id: string;
-    /** Error details when success=false (OD-554: surface DB errors) */
+    /** Error details when success=false */
     errors?: string[];
     display?: string;
     performance: PerformanceData;

package/hooks/.claude-plugin/plugin.json

@@ -3,6 +3,6 @@
   "description": "Enforces the GitMem institutional memory lifecycle through hooks — auto-starts sessions, reminds you to recall before consequential actions, and ensures proper session closure.",
   "author": {
     "name": "nTEG Labs",
-    "email": "support@nteg.com"
+    "email": "support@gitmem.ai"
   }
 }

package/hooks/scripts/post-tool-use.sh

@@ -21,7 +21,7 @@ HOOK_INPUT=$(cat -)
 # Graceful degradation: skip if no active gitmem session
 # ============================================================================
 
-# Check active sessions registry (Phase 1 multi-session, GIT-19)
+# Check active sessions registry
 ACTIVE_SESSIONS=".gitmem/active-sessions.json"
 if [ ! -f "$ACTIVE_SESSIONS" ]; then
     exit 0

package/hooks/scripts/recall-check.sh

@@ -26,7 +26,7 @@ set -e
 HOOK_INPUT=$(cat -)
 
 # ============================================================================
-# Resolve active session from registry (Phase 1 multi-session, GIT-19)
+# Resolve active session from registry
 # ============================================================================
 
 ACTIVE_SESSIONS=".gitmem/active-sessions.json"

package/hooks/scripts/session-close-check.sh

@@ -38,7 +38,7 @@ IS_MEANINGFUL=false
 ACTIVE_SESSIONS=".gitmem/active-sessions.json"
 SESSION_STARTED=false
 if [ -f "$ACTIVE_SESSIONS" ]; then
-    # Check if registry has active session entries (Phase 1 multi-session, GIT-19)
+    # Check if registry has active session entries
     if command -v jq &>/dev/null; then
         [ "$(jq '.sessions | length' "$ACTIVE_SESSIONS" 2>/dev/null || echo 0)" -gt 0 ] 2>/dev/null && SESSION_STARTED=true
     elif command -v node &>/dev/null; then

package/hooks/scripts/session-start.sh

@@ -183,7 +183,7 @@ if [ "$GITMEM_DETECTED" = "true" ]; then
 
     # Instruct agent to call session_start via MCP.
     # The MCP server creates sessions with its own PID, enabling multi-session
-    # isolation (Phase 1, GIT-19). CLI binary invocation was removed because
+    # isolation. CLI binary invocation was removed because
     # the CLI PID dies immediately, defeating PID-based session identity.
     #
     # NOTE: ToolSearch (tengu_mcp_tool_search) was removed. MCP tools load

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitmem-mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Institutional memory for AI coding agents. Memory that compounds.",
   "type": "module",
   "main": "dist/index.js",
@@ -46,9 +46,12 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "dist",
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "!dist/**/*.test.*",
     "bin",
     "hooks",
+    "!hooks/tests",
     "schema",
     "CLAUDE.md.template",
     "README.md",
@@ -70,7 +73,7 @@
     "type": "git",
     "url": "https://github.com/nTEG-dev/gitmem.git"
   },
-  "homepage": "https://github.com/nTEG-dev/gitmem#readme",
+  "homepage": "https://gitmem.ai",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"