gitmem-mcp 1.3.5 → 1.4.1

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4.1] - 2026-02-22
+
+### Added
+- **AGENTS.md generation**: Init wizard now creates an IDE-agnostic `AGENTS.md` file alongside the client-specific instructions file. Contains tool table, core workflow, sub-agent patterns (`prepare_context`, `absorb_observations`), and example JSON tool calls. Read by Codex, Copilot, Gemini, Cursor, and other AI coding assistants for automatic project discovery.
+
+## [1.4.0] - 2026-02-22
+
+### Changed
+- **Starter scar penalty doubled** (0.7x → 0.4x): Earned scars now decisively outrank starter scars in recall and search results. 6 community reports of starter scars drowning out project-specific lessons.
+- **Display protocol footer trimmed**: Removed the "Success: You echoed..." line from the display suffix — reduced noise without losing the echo instruction.
+- **First-recall message rewritten**: Replaced patronizing welcome text with actionable nudge: "No project-specific lessons yet. Use create_learning to capture your first."
+- **Session close description simplified**: Tool descriptions now clearly present two modes (inline params or payload file) instead of demanding the file-first approach.
+
+### Added
+- **Thread positional resolve (`#N`)**: `resolve_thread` now accepts `#3` to resolve the 3rd thread in display order. Matches the `#` column shown by `list_threads`.
+- **Thread ID column in list_threads**: Thread table now shows short IDs (e.g., `t-24aefd13`) alongside positional numbers — agents can reference by either.
+- **Provenance `[starter]` tag**: Recall and search results now annotate starter scars with a dim `[starter]` tag, so agents can distinguish earned vs bundled lessons.
+- **Inline `closing_reflection` parameter**: `session_close` schema now exposes `closing_reflection` and `human_corrections` as direct parameters — no payload file needed for simple closes.
+
+### Fixed
+- **`log` tool missing `anti_pattern` type**: TypeScript type for `learning_type` filter excluded `"anti_pattern"`, causing type errors when filtering by anti-patterns.
+
 ## [1.3.5] - 2026-02-22
 
 ### Fixed

package/bin/init-wizard.js

@@ -879,6 +879,51 @@ async function stepGitignore() {
   return { done: true };
 }
 
+async function stepAgentsMd() {
+  const agentsPath = join(cwd, "AGENTS.md");
+  const templatePath = join(__dirname, "..", "AGENTS.md.template");
+
+  // Already exists — don't overwrite
+  if (existsSync(agentsPath)) {
+    const content = readFileSync(agentsPath, "utf-8");
+    if (content.includes("GitMem")) {
+      log(CHECK, `AGENTS.md already includes gitmem`);
+      return { done: false };
+    }
+    // Existing AGENTS.md without gitmem — ask before appending
+    if (interactive) {
+      if (!(await confirm("Add gitmem section to existing AGENTS.md?"))) {
+        log(SKIP, "AGENTS.md skipped");
+        return { done: false };
+      }
+    }
+  }
+
+  let template;
+  try {
+    template = readFileSync(templatePath, "utf-8");
+  } catch {
+    // Template not found — skip silently
+    return { done: false };
+  }
+
+  if (dryRun) {
+    log(CHECK, `Would ${existsSync(agentsPath) ? "update" : "create"} AGENTS.md`, "[dry-run]");
+    return { done: true };
+  }
+
+  if (existsSync(agentsPath)) {
+    const existing = readFileSync(agentsPath, "utf-8");
+    writeFileSync(agentsPath, existing.trimEnd() + "\n\n" + template + "\n");
+    log(CHECK, "Updated AGENTS.md", "Added gitmem section (your existing content is preserved)");
+  } else {
+    writeFileSync(agentsPath, template + "\n");
+    log(CHECK, "Created AGENTS.md", "IDE-agnostic agent discovery file");
+  }
+
+  return { done: true };
+}
+
 async function stepFeedbackOptIn() {
   const configPath = join(gitmemDir, "config.json");
   const config = readJson(configPath) || {};
@@ -980,6 +1025,9 @@ async function main() {
   const r6 = await stepGitignore();
   if (r6.done) configured++;
 
+  const r6b = await stepAgentsMd();
+  if (r6b.done) configured++;
+
   const r7 = await stepFeedbackOptIn();
   if (r7.done) configured++;
 

package/dist/services/display-protocol.js

@@ -40,8 +40,7 @@ const { red, yellow, green, bold, dim, reset } = ANSI;
 // ---------------------------------------------------------------------------
 const DISPLAY_SUFFIX = "\n───────────────────────────────────────────────────\n" +
     "DISPLAY PROTOCOL: Output the content above verbatim as your response text.\n" +
-    "Tool results are collapsed in the CLI — the user cannot see them unless you echo them.\n" +
-    "Success: You echoed the content exactly as formatted above.";
+    "Tool results are collapsed in the CLI — the user cannot see them unless you echo them.";
 /**
  * Wrap formatted content with the display protocol suffix.
  *

package/dist/services/local-file-storage.js

@@ -150,9 +150,9 @@ export class LocalFileStorage {
             const l = byId.get(r.id);
             if (!l)
                 continue;
-            // Deprioritize starter scars (0.7x multiplier)
+            // Deprioritize starter scars (0.4x multiplier — earned scars should dominate)
             const isStarter = !!l.is_starter;
-            const adjustedSimilarity = isStarter ? r.similarity * 0.7 : r.similarity;
+            const adjustedSimilarity = isStarter ? r.similarity * 0.4 : r.similarity;
             mapped.push({
                 id: r.id,
                 title: String(l.title),

package/dist/tools/definitions.d.ts

@@ -43,6 +43,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -151,6 +153,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -254,6 +258,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -360,6 +366,8 @@ export declare const TOOLS: ({
             reflections?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -444,6 +452,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -519,6 +529,14 @@ export declare const TOOLS: ({
                 enum: string[];
                 description: string;
             };
+            closing_reflection: {
+                type: string;
+                description: string;
+            };
+            human_corrections: {
+                type: string;
+                description: string;
+            };
             linear_issue: {
                 type: string;
                 description: string;
@@ -685,6 +703,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             decision?: undefined;
             rationale?: undefined;
@@ -796,6 +816,8 @@ export declare const TOOLS: ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             description?: undefined;
@@ -914,6 +936,8 @@ export declare const TOOLS: ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1040,6 +1064,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1135,6 +1161,8 @@ export declare const TOOLS: ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1217,6 +1245,8 @@ export declare const TOOLS: ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1311,6 +1341,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1411,6 +1443,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             title?: undefined;
             description?: undefined;
@@ -1510,6 +1544,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             title?: undefined;
             description?: undefined;
@@ -1606,6 +1642,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1715,6 +1753,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1806,6 +1846,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1897,6 +1939,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -1982,6 +2026,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2069,6 +2115,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2153,6 +2201,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2240,6 +2290,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2324,6 +2376,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2413,6 +2467,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2517,6 +2573,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2629,6 +2687,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2715,6 +2775,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2818,6 +2880,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -2921,6 +2985,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3023,6 +3089,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3100,6 +3168,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3189,6 +3259,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3293,6 +3365,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3395,6 +3469,8 @@ export declare const TOOLS: ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3510,6 +3586,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3618,6 +3696,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3721,6 +3801,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3827,6 +3909,8 @@ export declare function getRegisteredTools(): ({
             reflections?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3911,6 +3995,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -3986,6 +4072,14 @@ export declare function getRegisteredTools(): ({
                 enum: string[];
                 description: string;
             };
+            closing_reflection: {
+                type: string;
+                description: string;
+            };
+            human_corrections: {
+                type: string;
+                description: string;
+            };
             linear_issue: {
                 type: string;
                 description: string;
@@ -4152,6 +4246,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             decision?: undefined;
             rationale?: undefined;
@@ -4263,6 +4359,8 @@ export declare function getRegisteredTools(): ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             description?: undefined;
@@ -4381,6 +4479,8 @@ export declare function getRegisteredTools(): ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -4507,6 +4607,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -4602,6 +4704,8 @@ export declare function getRegisteredTools(): ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -4684,6 +4788,8 @@ export declare function getRegisteredTools(): ({
             issue_labels?: undefined;
             force?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -4778,6 +4884,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -4878,6 +4986,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             title?: undefined;
             description?: undefined;
@@ -4977,6 +5087,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             title?: undefined;
             description?: undefined;
@@ -5073,6 +5185,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5182,6 +5296,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5273,6 +5389,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5364,6 +5482,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5449,6 +5569,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5536,6 +5658,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5620,6 +5744,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5707,6 +5833,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5791,6 +5919,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5880,6 +6010,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -5984,6 +6116,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6096,6 +6230,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6182,6 +6318,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6285,6 +6423,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6388,6 +6528,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6490,6 +6632,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6567,6 +6711,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6656,6 +6802,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6760,6 +6908,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;
@@ -6862,6 +7012,8 @@ export declare function getRegisteredTools(): ({
             force?: undefined;
             session_id?: undefined;
             close_type?: undefined;
+            closing_reflection?: undefined;
+            human_corrections?: undefined;
             ceremony_duration_ms?: undefined;
             learning_type?: undefined;
             title?: undefined;

package/dist/tools/definitions.js

@@ -164,7 +164,7 @@ export const TOOLS = [
     },
     {
         name: "session_close",
-        description: "Persist session with compliance validation. IMPORTANT: Before calling this tool, write all heavy payload data (closing_reflection, 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. task_completion is auto-generated from closing_reflection timestamps and human_corrections — do NOT write it to the payload. DISPLAY: The result includes a pre-formatted 'display' field. Output the display field verbatim as your response — tool results are collapsed in the CLI.",
+        description: "Persist session with compliance validation. Two modes: (1) Write closing_reflection and other payload to {gitmem_dir}/closing-payload.json, then call with session_id + close_type. (2) Pass closing_reflection directly as a parameter (simpler). Both work — inline params override file payload. task_completion is auto-generated. DISPLAY: Output the display field verbatim.",
         inputSchema: {
             type: "object",
             properties: {
@@ -177,6 +177,14 @@ export const TOOLS = [
                     enum: ["standard", "quick", "autonomous"],
                     description: "Type of close (standard requires full reflection)",
                 },
+                closing_reflection: {
+                    type: "object",
+                    description: "Session reflection (alternative to writing closing-payload.json). Keys: what_broke, what_took_longer, do_differently, what_worked, wrong_assumption, scars_applied, institutional_memory_items, collaborative_dynamic, rapport_notes",
+                },
+                human_corrections: {
+                    type: "string",
+                    description: "Human corrections or 'none'",
+                },
                 linear_issue: {
                     type: "string",
                     description: "Associated Linear issue",
@@ -878,7 +886,7 @@ export const TOOLS = [
     },
     {
         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_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.",
+        description: "gitmem-sc (session_close) - Close session. Two modes: (1) Write payload to closing-payload.json first, or (2) pass closing_reflection directly as param. Both work.",
         inputSchema: {
             type: "object",
             properties: {
@@ -891,6 +899,14 @@ export const TOOLS = [
                     enum: ["standard", "quick", "autonomous"],
                     description: "Type of close (standard requires full reflection)",
                 },
+                closing_reflection: {
+                    type: "object",
+                    description: "Session reflection (alternative to writing closing-payload.json)",
+                },
+                human_corrections: {
+                    type: "string",
+                    description: "Human corrections or 'none'",
+                },
                 linear_issue: {
                     type: "string",
                     description: "Associated Linear issue",
@@ -1548,7 +1564,7 @@ export const TOOLS = [
     },
     {
         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_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.",
+        description: "gm-close (session_close) - Close session. Pass closing_reflection directly or write to closing-payload.json first.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1561,6 +1577,14 @@ export const TOOLS = [
                     enum: ["standard", "quick", "autonomous"],
                     description: "Type of close (standard requires full reflection)",
                 },
+                closing_reflection: {
+                    type: "object",
+                    description: "Session reflection (alternative to writing closing-payload.json)",
+                },
+                human_corrections: {
+                    type: "string",
+                    description: "Human corrections or 'none'",
+                },
                 linear_issue: {
                     type: "string",
                     description: "Associated Linear issue",

package/dist/tools/list-threads.js

@@ -40,13 +40,15 @@ function buildThreadsDisplay(threads, totalOpen, totalResolved) {
     // Deterministic sort: oldest first by created_at
     const sorted = [...threads].sort((a, b) => a.created_at.localeCompare(b.created_at));
     // Markdown table — renders cleanly in all MCP clients
-    lines.push("| # | Thread | Active |");
-    lines.push("|---|--------|--------|");
+    // Show short thread ID so agents can reference threads by ID or #N position
+    lines.push("| # | ID | Thread | Active |");
+    lines.push("|---|-----|--------|--------|");
     for (let i = 0; i < sorted.length; i++) {
         const t = sorted[i];
-        const text = truncate(t.text, 60);
+        const text = truncate(t.text, 55);
         const date = shortDate(t.last_touched_at || t.created_at);
-        lines.push(`| ${i + 1} | ${text} | ${date} |`);
+        const shortId = t.id?.slice(0, 10) || "—";
+        lines.push(`| ${i + 1} | ${shortId} | ${text} | ${date} |`);
     }
     return wrapDisplay(lines.join("\n"));
 }

package/dist/tools/log.d.ts

@@ -13,7 +13,7 @@ import type { Project, PerformanceData } from "../types/index.js";
 export interface LogParams {
     limit?: number;
     project?: Project;
-    learning_type?: "scar" | "win" | "pattern";
+    learning_type?: "scar" | "win" | "pattern" | "anti_pattern";
     severity?: "critical" | "high" | "medium" | "low";
     since?: number;
 }

package/dist/tools/recall.js

@@ -45,7 +45,7 @@ No past lessons match this plan closely enough. Scars accumulate as you work —
         "",
     ];
     if (allStarter) {
-        lines.push(`${dimText("This is your first recall — results will get more relevant as you add your own lessons from real experience.")}`);
+        lines.push(`${dimText("No project-specific lessons yet. Use create_learning to capture your first.")}`);
         lines.push("");
     }
     // Display blocking verification requirements FIRST and prominently
@@ -72,7 +72,8 @@ No past lessons match this plan closely enough. Scars accumulate as you work —
     }
     for (const scar of scars) {
         const sev = SEV[scar.severity] || "[?]";
-        lines.push(`${sev} **${scar.title}** (${scar.severity}, ${scar.similarity.toFixed(2)}) ${dimText(`id:${scar.id.slice(0, 8)}`)}`);
+        const starterTag = scar.is_starter ? ` ${dimText("[starter]")}` : "";
+        lines.push(`${sev} **${scar.title}** (${scar.severity}, ${scar.similarity.toFixed(2)}) ${dimText(`id:${scar.id.slice(0, 8)}`)}${starterTag}`);
         // Inline archival hint: scars with high dismiss rates get annotated
         if (dismissals) {
             const counts = dismissals.get(scar.id);

package/dist/tools/resolve-thread.js

@@ -44,10 +44,31 @@ export async function resolveThread(params) {
     }
     const session = getCurrentSession();
     const sessionId = session?.sessionId;
+    // Support positional #N references (e.g. "#3" resolves the 3rd thread in sorted order)
+    let effectiveThreadId = params.thread_id;
+    let effectiveTextMatch = params.text_match;
+    const posMatch = (params.thread_id || params.text_match || "").match(/^#(\d+)$/);
+    if (posMatch) {
+        const pos = parseInt(posMatch[1], 10);
+        const openThreads = threads
+            .filter(t => t.status === "open")
+            .sort((a, b) => a.created_at.localeCompare(b.created_at));
+        if (pos < 1 || pos > openThreads.length) {
+            const latencyMs = timer.stop();
+            return {
+                success: false,
+                error: `Thread #${pos} out of range (${openThreads.length} open threads)`,
+                performance: buildPerformanceData("resolve_thread", latencyMs, 0),
+                display: wrapDisplay(`Thread #${pos} out of range (${openThreads.length} open threads)`),
+            };
+        }
+        effectiveThreadId = openThreads[pos - 1].id;
+        effectiveTextMatch = undefined;
+    }
     // Resolve the thread locally (in-memory / file)
     const resolved = resolveThreadInList(threads, {
-        threadId: params.thread_id,
-        textMatch: params.text_match,
+        threadId: effectiveThreadId,
+        textMatch: effectiveTextMatch,
         sessionId,
         resolutionNote: params.resolution_note,
     });

package/dist/tools/search.d.ts

@@ -29,6 +29,7 @@ export interface SearchResultEntry {
     counter_arguments?: string[];
     similarity: number;
     source_linear_issue?: string;
+    is_starter?: boolean;
 }
 export interface SearchResult {
     query: string;

package/dist/tools/search.js

@@ -17,7 +17,7 @@ import { getProject } from "../services/session-state.js";
 import { getStorage } from "../services/storage.js";
 import { Timer, recordMetrics, buildPerformanceData, buildComponentPerformance, } from "../services/metrics.js";
 import { v4 as uuidv4 } from "uuid";
-import { wrapDisplay, truncate, SEV, TYPE, productLine } from "../services/display-protocol.js";
+import { wrapDisplay, truncate, SEV, TYPE, productLine, dimText } from "../services/display-protocol.js";
 // --- Display Formatting ---
 function buildSearchDisplay(results, total_found, query, filters) {
     const lines = [];
@@ -41,7 +41,8 @@ function buildSearchDisplay(results, total_found, query, filters) {
         const sim = `(${r.similarity.toFixed(2)})`;
         const issue = r.source_linear_issue ? `  ${r.source_linear_issue}` : "";
         lines.push(`${te} ${se} ${t.padEnd(52)} ${sim}${issue}`);
-        lines.push(`   ${truncate(r.description, 72)}  id:${r.id.slice(0, 8)}`);
+        const starterTag = r.is_starter ? ` ${dimText("[starter]")}` : "";
+        lines.push(`   ${truncate(r.description, 72)}  id:${r.id.slice(0, 8)}${starterTag}`);
     }
     lines.push("");
     lines.push(`${total_found} results found`);
@@ -70,6 +71,7 @@ export async function search(params) {
                 description: r.description || "",
                 counter_arguments: r.counter_arguments || [],
                 similarity: r.similarity || 0,
+                is_starter: r.is_starter || undefined,
             }));
             // Also search decisions
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitmem-mcp",
-  "version": "1.3.5",
+  "version": "1.4.1",
   "mcpName": "io.github.gitmem-dev/gitmem",
   "description": "Persistent learning memory for AI coding agents. Memory that compounds.",
   "type": "module",