gitmem-mcp 1.0.0 → 1.0.2

package/dist/tools/definitions.js

@@ -21,8 +21,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 match_count: {
                     type: "number",
@@ -71,7 +70,7 @@ export const TOOLS = [
     },
     {
         name: "session_start",
-        description: "Initialize session, detect agent, load institutional context (last session, relevant scars, recent decisions). DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user instead of formatting your own session summary.",
+        description: "Initialize session, detect agent, load institutional context (last session, recent decisions, open threads). Scars surface on-demand via recall(). DISPLAY: The result includes a pre-formatted 'display' field visible in the tool result. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
@@ -99,8 +98,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 force: {
                     type: "boolean",
@@ -111,21 +109,20 @@ export const TOOLS = [
     },
     {
         name: "session_refresh",
-        description: "Re-surface institutional context (scars, threads, decisions, wins) for the current active session without creating a new session. Use mid-session when you need to remember where you left off, after context compaction, or after a long gap. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user instead of formatting your own session summary.",
+        description: "Re-surface institutional context (threads, decisions) for the current active session without creating a new session. Use mid-session when you need to remember where you left off, after context compaction, or after a long gap. DISPLAY: The result includes a pre-formatted 'display' field visible in the tool result. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: from active session)",
+                    description: "Project namespace (default: from active session). Free-form string (e.g., 'my-project').",
                 },
             },
         },
     },
     {
         name: "session_close",
-        description: "Persist session with compliance validation. IMPORTANT: Before calling this tool, write all heavy payload data (closing_reflection, task_completion, human_corrections, scars_to_record, open_threads, decisions, learnings_created) to .gitmem/closing-payload.json using your file write tool. Then call this tool with ONLY session_id and close_type. The tool reads the payload file automatically and deletes it after processing. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user instead of formatting your own close summary.",
+        description: "Persist session with compliance validation. IMPORTANT: Before calling this tool, write all heavy payload data (closing_reflection, task_completion, human_corrections, scars_to_record, open_threads, decisions, learnings_created) to {gitmem_dir}/closing-payload.json using your file write tool — the gitmem_dir path is returned by session_start (also shown in session start display as 'Payload path'). Then call this tool with ONLY session_id and close_type. The tool reads the payload file automatically and deletes it after processing. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
@@ -213,8 +210,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["learning_type", "title", "description"],
@@ -263,8 +259,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["title", "decision", "rationale"],
@@ -317,6 +312,10 @@ export const TOOLS = [
                     type: "string",
                     description: "Agent identity (CLI, DAC, CODA-1, etc.)",
                 },
+                variant_id: {
+                    type: "string",
+                    description: "UUID of the assigned variant from scar_enforcement_variants (for A/B testing)",
+                },
             },
             required: ["scar_id", "surfaced_at", "reference_type", "reference_context"],
         },
@@ -380,7 +379,6 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
                     description: "Project scope for scar resolution",
                 },
             },
@@ -408,8 +406,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["session_id", "transcript"],
@@ -429,6 +426,32 @@ export const TOOLS = [
             required: ["session_id"],
         },
     },
+    {
+        name: "search_transcripts",
+        description: "Semantic search over session transcript chunks. Generates embedding for query and calls match_transcript_chunks RPC to find relevant conversation fragments across all indexed sessions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Natural language search query (e.g., 'deployment verification discussion', 'what was decided about caching')",
+                },
+                match_count: {
+                    type: "number",
+                    description: "Maximum number of chunks to return (default: 10, max: 50)",
+                },
+                similarity_threshold: {
+                    type: "number",
+                    description: "Minimum similarity score 0-1 (default: 0.3). Higher values return more relevant results.",
+                },
+                project: {
+                    type: "string",
+                    description: "Project namespace to filter by (e.g., 'orchestra_dev')",
+                },
+            },
+            required: ["query"],
+        },
+    },
     // ============================================================================
     // SEARCH & LOG TOOLS (OD-560, OD-561)
     // ============================================================================
@@ -448,8 +471,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 severity: {
                     type: "string",
@@ -477,8 +499,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 learning_type: {
                     type: "string",
@@ -525,8 +546,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["plan", "format"],
@@ -581,8 +601,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
         },
@@ -639,8 +658,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["suggestion_id"],
@@ -669,8 +687,7 @@ export const TOOLS = [
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 auto_archive: {
                     type: "boolean",
@@ -679,6 +696,20 @@ export const TOOLS = [
             },
         },
     },
+    // --- Effect Health Tool ---
+    {
+        name: "health",
+        description: "Show write health for the current session. Reports success/failure rates for all tracked fire-and-forget operations (metrics, cache, triple writes, embeddings, scar usage). Use this to diagnose silent failures.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                failure_limit: {
+                    type: "number",
+                    description: "Max number of recent failures to return (default: 10)",
+                },
+            },
+        },
+    },
     // ============================================================================
     // SHORT ALIASES (gitmem-*)
     // Self-documenting: each description includes both alias and full name
@@ -695,8 +726,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 match_count: {
                     type: "number",
@@ -731,7 +761,7 @@ export const TOOLS = [
     },
     {
         name: "gitmem-ss",
-        description: "gitmem-ss (session_start) - Initialize session with institutional context. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user.",
+        description: "gitmem-ss (session_start) - Initialize session with institutional context. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
@@ -759,8 +789,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 force: {
                     type: "boolean",
@@ -771,21 +800,20 @@ export const TOOLS = [
     },
     {
         name: "gitmem-sr",
-        description: "gitmem-sr (session_refresh) - Refresh institutional context for the active session without creating a new session. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user.",
+        description: "gitmem-sr (session_refresh) - Refresh institutional context for the active session without creating a new session. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: from active session)",
+                    description: "Project namespace (default: from active session). Free-form string (e.g., 'my-project').",
                 },
             },
         },
     },
     {
         name: "gitmem-sc",
-        description: "gitmem-sc (session_close) - Close session with compliance validation. IMPORTANT: Write all heavy payload data (closing_reflection, task_completion, human_corrections, scars_to_record, open_threads, decisions, learnings_created) to .gitmem/closing-payload.json BEFORE calling this tool. Only pass session_id and close_type inline. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user instead of formatting your own close summary.",
+        description: "gitmem-sc (session_close) - Close session with compliance validation. IMPORTANT: Write all heavy payload data (closing_reflection, task_completion, human_corrections, scars_to_record, open_threads, decisions, learnings_created) to {gitmem_dir}/closing-payload.json BEFORE calling this tool — gitmem_dir is from session_start. Only pass session_id and close_type inline. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
@@ -873,8 +901,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["learning_type", "title", "description"],
@@ -923,8 +950,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["title", "decision", "rationale"],
@@ -977,6 +1003,10 @@ export const TOOLS = [
                     type: "string",
                     description: "Agent identity (CLI, DAC, CODA-1, etc.)",
                 },
+                variant_id: {
+                    type: "string",
+                    description: "UUID of the assigned variant from scar_enforcement_variants (for A/B testing)",
+                },
             },
             required: ["scar_id", "surfaced_at", "reference_type", "reference_context"],
         },
@@ -1040,7 +1070,6 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
                     description: "Project scope for scar resolution",
                 },
             },
@@ -1068,8 +1097,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["session_id", "transcript"],
@@ -1089,6 +1117,59 @@ export const TOOLS = [
             required: ["session_id"],
         },
     },
+    // gitmem-stx / gm-stx (search_transcripts)
+    {
+        name: "gitmem-stx",
+        description: "gitmem-stx (search_transcripts) - Semantic search over transcript chunks",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Natural language search query",
+                },
+                match_count: {
+                    type: "number",
+                    description: "Maximum number of chunks to return (default: 10, max: 50)",
+                },
+                similarity_threshold: {
+                    type: "number",
+                    description: "Minimum similarity score 0-1 (default: 0.3)",
+                },
+                project: {
+                    type: "string",
+                    description: "Project namespace to filter by",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "gm-stx",
+        description: "gm-stx (search_transcripts) - Semantic search over transcript chunks",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Natural language search query",
+                },
+                match_count: {
+                    type: "number",
+                    description: "Maximum number of chunks to return (default: 10, max: 50)",
+                },
+                similarity_threshold: {
+                    type: "number",
+                    description: "Minimum similarity score 0-1 (default: 0.3)",
+                },
+                project: {
+                    type: "string",
+                    description: "Project namespace to filter by",
+                },
+            },
+            required: ["query"],
+        },
+    },
     // gitmem-search (OD-560)
     {
         name: "gitmem-search",
@@ -1106,8 +1187,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 severity: {
                     type: "string",
@@ -1136,8 +1216,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 learning_type: {
                     type: "string",
@@ -1182,8 +1261,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["plan", "format"],
@@ -1224,7 +1302,7 @@ export const TOOLS = [
             properties: {
                 status: { type: "string", enum: ["open", "resolved"], description: "Filter by status (default: open)" },
                 include_resolved: { type: "boolean", description: "Include recently resolved threads (default: false)" },
-                project: { type: "string", enum: ["orchestra_dev", "weekend_warrior"], description: "Project scope" },
+                project: { type: "string", description: "Project namespace for organizing memories" },
             },
         },
     },
@@ -1262,7 +1340,7 @@ export const TOOLS = [
             type: "object",
             properties: {
                 suggestion_id: { type: "string", description: "Suggestion ID (e.g., ts-a1b2c3d4)" },
-                project: { type: "string", enum: ["orchestra_dev", "weekend_warrior"], description: "Project scope" },
+                project: { type: "string", description: "Project namespace for organizing memories" },
             },
             required: ["suggestion_id"],
         },
@@ -1286,17 +1364,28 @@ export const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                project: { type: "string", enum: ["orchestra_dev", "weekend_warrior"] },
+                project: { type: "string" },
                 auto_archive: { type: "boolean", description: "Auto-archive dormant threads (30+ days)" },
             },
         },
     },
+    // gitmem-health (health) — Effect Tracker health report
+    {
+        name: "gitmem-health",
+        description: "gitmem-health (health) - Show write health for fire-and-forget operations this session",
+        inputSchema: {
+            type: "object",
+            properties: {
+                failure_limit: { type: "number", description: "Max recent failures to return (default: 10)" },
+            },
+        },
+    },
     // ============================================================================
     // GM-* SHORT, MEMORABLE ALIASES (user-facing ergonomics)
     // ============================================================================
     {
         name: "gm-open",
-        description: "gm-open (session_start) - Open a GitMem session and load institutional context. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user.",
+        description: "gm-open (session_start) - Open a GitMem session and load institutional context. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1324,8 +1413,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 force: {
                     type: "boolean",
@@ -1359,21 +1447,20 @@ export const TOOLS = [
     },
     {
         name: "gm-refresh",
-        description: "gm-refresh (session_refresh) - Refresh context for the active session without creating a new one. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user.",
+        description: "gm-refresh (session_refresh) - Refresh context for the active session without creating a new one. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: from active session)",
+                    description: "Project namespace (default: from active session). Free-form string (e.g., 'my-project').",
                 },
             },
         },
     },
     {
         name: "gm-close",
-        description: "gm-close (session_close) - Close a GitMem session. IMPORTANT: Write all heavy payload data (closing_reflection, task_completion, human_corrections, scars_to_record, open_threads, decisions, learnings_created) to .gitmem/closing-payload.json BEFORE calling this tool. Only pass session_id and close_type inline. DISPLAY: The result includes a pre-formatted 'display' field. Echo it verbatim to the user instead of formatting your own close summary.",
+        description: "gm-close (session_close) - Close a GitMem session. IMPORTANT: Write all heavy payload data (closing_reflection, task_completion, human_corrections, scars_to_record, open_threads, decisions, learnings_created) to {gitmem_dir}/closing-payload.json BEFORE calling this tool — gitmem_dir is from session_start. Only pass session_id and close_type inline. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1461,8 +1548,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["learning_type", "title", "description"],
@@ -1485,8 +1571,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 severity: {
                     type: "string",
@@ -1515,8 +1600,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 learning_type: {
                     type: "string",
@@ -1561,8 +1645,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
             required: ["plan", "format"],
@@ -1603,7 +1686,7 @@ export const TOOLS = [
             properties: {
                 status: { type: "string", enum: ["open", "resolved"], description: "Filter by status (default: open)" },
                 include_resolved: { type: "boolean", description: "Include resolved threads" },
-                project: { type: "string", enum: ["orchestra_dev", "weekend_warrior"], description: "Project scope" },
+                project: { type: "string", description: "Project namespace for organizing memories" },
             },
         },
     },
@@ -1641,7 +1724,7 @@ export const TOOLS = [
             type: "object",
             properties: {
                 suggestion_id: { type: "string", description: "Suggestion ID" },
-                project: { type: "string", enum: ["orchestra_dev", "weekend_warrior"], description: "Project scope" },
+                project: { type: "string", description: "Project namespace for organizing memories" },
             },
             required: ["suggestion_id"],
         },
@@ -1665,11 +1748,22 @@ export const TOOLS = [
         inputSchema: {
             type: "object",
             properties: {
-                project: { type: "string", enum: ["orchestra_dev", "weekend_warrior"] },
+                project: { type: "string" },
                 auto_archive: { type: "boolean", description: "Auto-archive dormant threads" },
             },
         },
     },
+    // gm-health (health) — Effect Tracker health report
+    {
+        name: "gm-health",
+        description: "gm-health (health) - Show write health for fire-and-forget operations",
+        inputSchema: {
+            type: "object",
+            properties: {
+                failure_limit: { type: "number", description: "Max recent failures (default: 10)" },
+            },
+        },
+    },
     // ============================================================================
     // ANALYTICS TOOLS (OD-567)
     // ============================================================================
@@ -1690,8 +1784,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 agent: {
                     type: "string",
@@ -1723,8 +1816,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 agent: {
                     type: "string",
@@ -1756,8 +1848,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 agent: {
                     type: "string",
@@ -1790,8 +1881,7 @@ export const TOOLS = [
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
         },
@@ -1804,8 +1894,7 @@ export const TOOLS = [
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
         },
@@ -1818,8 +1907,7 @@ export const TOOLS = [
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
         },
@@ -1832,8 +1920,7 @@ export const TOOLS = [
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
         },
@@ -1846,8 +1933,7 @@ export const TOOLS = [
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
         },
@@ -1860,12 +1946,66 @@ export const TOOLS = [
             properties: {
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
             },
         },
     },
+    // --- Archive Learning Tool ---
+    {
+        name: "archive_learning",
+        description: "Archives a learning (scar/win/pattern) by setting is_active=false and recording archived_at timestamp. Archived learnings are excluded from recall and search results but preserved for audit trail.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "UUID of the learning to archive",
+                },
+                reason: {
+                    type: "string",
+                    description: "Optional reason for archiving (e.g., 'superseded by OD-XXX', 'no longer relevant')",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "gitmem-al",
+        description: "gitmem-al (archive_learning) - Archive a scar/win/pattern (sets is_active=false)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "UUID of the learning to archive",
+                },
+                reason: {
+                    type: "string",
+                    description: "Optional reason for archiving",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "gm-archive",
+        description: "gm-archive (archive_learning) - Archive a scar/win/pattern",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "UUID of the learning to archive",
+                },
+                reason: {
+                    type: "string",
+                    description: "Optional reason for archiving",
+                },
+            },
+            required: ["id"],
+        },
+    },
     // --- Knowledge Graph Traversal (Phase 3) ---
     {
         name: "graph_traverse",
@@ -1893,8 +2033,7 @@ export const TOOLS = [
                 },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope (default: orchestra_dev)",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 limit: {
                     type: "number",
@@ -1927,8 +2066,7 @@ export const TOOLS = [
                 depth: { type: "number", description: "Max depth for provenance (default: 3)" },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 limit: { type: "number", description: "Max triples (default: 50)" },
             },
@@ -1955,8 +2093,7 @@ export const TOOLS = [
                 depth: { type: "number", description: "Max depth for provenance" },
                 project: {
                     type: "string",
-                    enum: ["orchestra_dev", "weekend_warrior"],
-                    description: "Project scope",
+                    description: "Project namespace (e.g., 'my-project', 'orchestra_dev'). Scopes sessions and searches.",
                 },
                 limit: { type: "number", description: "Max triples" },
             },
@@ -1981,6 +2118,7 @@ export const BATCH_TOOL_NAMES = new Set([
 export const TRANSCRIPT_TOOL_NAMES = new Set([
     "save_transcript", "gitmem-st",
     "get_transcript", "gitmem-gt",
+    "search_transcripts", "gitmem-stx", "gm-stx",
 ]);
 export const ANALYZE_TOOL_NAMES = new Set([
     "analyze", "gitmem-analyze", "gm-analyze",
@@ -1988,6 +2126,9 @@ export const ANALYZE_TOOL_NAMES = new Set([
 export const GRAPH_TOOL_NAMES = new Set([
     "graph_traverse", "gitmem-graph", "gm-graph",
 ]);
+export const ARCHIVE_TOOL_NAMES = new Set([
+    "archive_learning", "gitmem-al", "gm-archive",
+]);
 /**
  * Get tools registered for the current tier.
  * Free: core tools only (7 canonical + aliases)
@@ -2011,6 +2152,9 @@ export function getRegisteredTools() {
         if (GRAPH_TOOL_NAMES.has(tool.name)) {
             return hasSupabase();
         }
+        if (ARCHIVE_TOOL_NAMES.has(tool.name)) {
+            return hasSupabase();
+        }
         return true;
     });
 }