gitmem-mcp 1.0.8 → 1.0.10

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.10] - 2026-02-16
+
+### Fixed
+- **CI smoke test**: `session_close` test looked for `active-sessions.json` at `process.cwd()` instead of `GITMEM_DIR`, failing in CI where they differ.
+- **CI peer dependencies**: Added `--legacy-peer-deps` to `npm ci` for `zod@4` conflict with `claude-agent-sdk`.
+- **CI unit test**: `quick-retrieve.test.ts` now sets `GITMEM_DIR` so disk cache tests resolve correctly in CI.
+
+## [1.0.9] - 2026-02-16
+
+### Fixed
+- **Closing payload field name mismatch**: `CLAUDE.md.template` documented wrong field names (`institutional_memory` instead of `institutional_memory_items`, bogus `started_at`/`completed_at` in task_completion) causing agents to write payloads that `session_close` couldn't parse. Fixed template and added `institutional_memory` as normalizer alias.
+- **Missing Q8/Q9 in closing template**: Added `collaborative_dynamic` and `rapport_notes` fields to payload example.
+
 ## [1.0.6] - 2026-02-16
 
 ### Fixed

package/CLAUDE.md.template

@@ -47,17 +47,17 @@ On "closing", "done for now", or "wrapping up":
        "do_differently": "...",
        "what_worked": "...",
        "wrong_assumption": "...",
-       "scars_applied": "...",
-       "institutional_memory": "..."
+       "scars_applied": ["scar title 1", "scar title 2"],
+       "institutional_memory_items": "...",
+       "collaborative_dynamic": "Q8: How human preferred to work",
+       "rapport_notes": "Q9: What collaborative dynamic worked"
      },
      "task_completion": {
-       "started_at": "ISO timestamp",
-       "completed_at": "ISO timestamp",
        "questions_displayed_at": "ISO timestamp",
        "reflection_completed_at": "ISO timestamp",
        "human_asked_at": "ISO timestamp",
        "human_response_at": "ISO timestamp",
-       "human_response": "human's correction text or empty"
+       "human_response": "human's correction text or 'Looks good'"
      },
      "human_corrections": "",
      "scars_to_record": [],

package/README.md

@@ -26,7 +26,7 @@ Works with **Claude Code**, **Claude Desktop**, **Cursor**, and any MCP-compatib
 ## Quick Start
 
 ```bash
-npx gitmem init
+npx gitmem-mcp init
 ```
 
 One command. The wizard sets up everything:
@@ -40,8 +40,8 @@ One command. The wizard sets up everything:
 Already have existing config? The wizard merges without destroying anything. Re-running is safe.
 
 ```bash
-npx gitmem init --yes       # Non-interactive
-npx gitmem init --dry-run   # Preview changes
+npx gitmem-mcp init --yes       # Non-interactive
+npx gitmem-mcp init --dry-run   # Preview changes
 ```
 
 ## How It Works
@@ -73,16 +73,16 @@ Every scar includes **counter-arguments** — reasons why someone might reasonab
 - **Session Continuity** — Context, threads, and rapport carry across sessions
 - **Closing Ceremony** — Structured reflection captures what broke, what worked, and what to do differently
 - **20+ MCP Tools** — Full toolkit for memory management, search, threads, and multi-agent coordination
-- **Zero Config** — `npx gitmem init` and you're running
+- **Zero Config** — `npx gitmem-mcp init` and you're running
 - **Non-Destructive** — Merges with your existing `.mcp.json`, `CLAUDE.md`, and hooks
 
 ## Supported Clients
 
 | Client | Setup |
 |--------|-------|
-| **Claude Code** | `npx gitmem init` (auto-detected) |
-| **Claude Desktop** | `npx gitmem init` or add to `claude_desktop_config.json` |
-| **Cursor** | `npx gitmem init` or add to `.cursor/mcp.json` |
+| **Claude Code** | `npx gitmem-mcp init` (auto-detected) |
+| **Claude Desktop** | `npx gitmem-mcp init` or add to `claude_desktop_config.json` |
+| **Cursor** | `npx gitmem-mcp init` or add to `.cursor/mcp.json` |
 | **Any MCP client** | Add `npx -y gitmem-mcp` as an MCP server |
 
 <details>
@@ -105,12 +105,12 @@ Every scar includes **counter-arguments** — reasons why someone might reasonab
 
 | Command | Description |
 |---------|-------------|
-| `npx gitmem init` | Interactive setup wizard |
-| `npx gitmem init --yes` | Non-interactive setup |
-| `npx gitmem init --dry-run` | Preview changes |
-| `npx gitmem uninstall` | Clean removal (preserves `.gitmem/` data) |
-| `npx gitmem uninstall --all` | Full removal including data |
-| `npx gitmem check` | Diagnostic health check |
+| `npx gitmem-mcp init` | Interactive setup wizard |
+| `npx gitmem-mcp init --yes` | Non-interactive setup |
+| `npx gitmem-mcp init --dry-run` | Preview changes |
+| `npx gitmem-mcp uninstall` | Clean removal (preserves `.gitmem/` data) |
+| `npx gitmem-mcp uninstall --all` | Full removal including data |
+| `npx gitmem-mcp check` | Diagnostic health check |
 
 ## Pro Tier — Coming Soon
 

package/bin/gitmem.js

@@ -37,31 +37,31 @@ function printUsage() {
 GitMem — Institutional Memory for AI Coding
 
 Usage:
-  npx gitmem init              Interactive setup wizard (recommended)
-  npx gitmem init --yes        Non-interactive setup (accept all defaults)
-  npx gitmem init --dry-run    Show what would be configured
-  npx gitmem uninstall         Clean removal of gitmem from project
-  npx gitmem uninstall --all   Also delete .gitmem/ data directory
+  npx gitmem-mcp init              Interactive setup wizard (recommended)
+  npx gitmem-mcp init --yes        Non-interactive setup (accept all defaults)
+  npx gitmem-mcp init --dry-run    Show what would be configured
+  npx gitmem-mcp uninstall         Clean removal of gitmem from project
+  npx gitmem-mcp uninstall --all   Also delete .gitmem/ data directory
 
 Other commands:
-  npx gitmem setup             Output SQL for Supabase schema setup (pro/dev tier)
-  npx gitmem configure         Generate .mcp.json config for Claude Code
-  npx gitmem check             Run diagnostic health check
-  npx gitmem check --full      Full diagnostic with benchmarks
-  npx gitmem install-hooks     Install Claude Code hooks (standalone)
-  npx gitmem uninstall-hooks   Remove Claude Code hooks (standalone)
-  npx gitmem server            Start MCP server (default)
-  npx gitmem help              Show this help message
+  npx gitmem-mcp setup             Output SQL for Supabase schema setup (pro/dev tier)
+  npx gitmem-mcp configure         Generate .mcp.json config for Claude Code
+  npx gitmem-mcp check             Run diagnostic health check
+  npx gitmem-mcp check --full      Full diagnostic with benchmarks
+  npx gitmem-mcp install-hooks     Install Claude Code hooks (standalone)
+  npx gitmem-mcp uninstall-hooks   Remove Claude Code hooks (standalone)
+  npx gitmem-mcp server            Start MCP server (default)
+  npx gitmem-mcp help              Show this help message
 
 Quick Start:
-  npx gitmem init              One command sets up everything
-  npx gitmem uninstall         One command removes everything
+  npx gitmem-mcp init              One command sets up everything
+  npx gitmem-mcp uninstall         One command removes everything
 
 Pro Tier (with Supabase):
   1. Create free Supabase project → database.new
-  2. npx gitmem setup   (copy SQL → Supabase SQL Editor)
+  2. npx gitmem-mcp setup   (copy SQL → Supabase SQL Editor)
   3. Set SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY env vars
-  4. npx gitmem init    (auto-detects pro tier)
+  4. npx gitmem-mcp init    (auto-detects pro tier)
   5. Start coding — memory is active!
 `);
 }
@@ -562,7 +562,7 @@ function cmdInstallHooks() {
       console.log("GitMem hooks already installed in .claude/settings.json");
       console.log("");
       console.log("To reinstall (overwrite), run:");
-      console.log("  npx gitmem install-hooks --force");
+      console.log("  npx gitmem-mcp install-hooks --force");
       return;
     }
   }
@@ -600,14 +600,14 @@ function cmdInstallHooks() {
   if (!mcpFound) {
     console.log("WARNING: gitmem MCP server not detected in .mcp.json.");
     console.log("  Hooks will be silent until gitmem MCP is configured.");
-    console.log("  Run: npx gitmem configure");
+    console.log("  Run: npx gitmem-mcp configure");
     console.log("");
   }
 
   console.log("Installed! Hooks will activate on next Claude Code session.");
   console.log("");
   console.log("To update after a gitmem version bump:");
-  console.log("  npx gitmem install-hooks --force");
+  console.log("  npx gitmem-mcp install-hooks --force");
 }
 
 /**
@@ -693,7 +693,7 @@ function cmdUninstallHooks() {
   console.log("Notes:");
   console.log("  - gitmem MCP server config (.mcp.json) was NOT modified");
   console.log("  - Restart Claude Code for changes to take effect");
-  console.log("  - To reinstall: npx gitmem install-hooks");
+  console.log("  - To reinstall: npx gitmem-mcp install-hooks");
 }
 
 switch (command) {

package/bin/init-wizard.js

@@ -4,7 +4,7 @@
  * GitMem Init Wizard
  *
  * Interactive setup that detects existing config, prompts, and merges.
- * Usage: npx gitmem init [--yes] [--dry-run] [--project <name>]
+ * Usage: npx gitmem-mcp init [--yes] [--dry-run] [--project <name>]
  */
 
 import {
@@ -635,7 +635,7 @@ async function main() {
     console.log("  Dry run complete — no files were modified.");
   } else {
     console.log("  Setup complete! Start Claude Code — memory is active.");
-    console.log("  To remove: npx gitmem uninstall");
+    console.log("  To remove: npx gitmem-mcp uninstall");
   }
   console.log("");
 

package/bin/uninstall.js

@@ -3,8 +3,8 @@
 /**
  * GitMem Uninstall
  *
- * Cleanly reverses everything `npx gitmem init` did.
- * Usage: npx gitmem uninstall [--yes] [--all]
+ * Cleanly reverses everything `npx gitmem-mcp init` did.
+ * Usage: npx gitmem-mcp uninstall [--yes] [--all]
  */
 
 import {

package/dist/commands/check.d.ts

@@ -4,9 +4,9 @@
  * Diagnostic CLI command for health checks and benchmarks.
  *
  * Usage:
- *   npx gitmem check           — Quick health check (~5s)
- *   npx gitmem check --full    — Full diagnostic (~30s)
- *   npx gitmem check --output report.json
+ *   npx gitmem-mcp check           — Quick health check (~5s)
+ *   npx gitmem-mcp check --full    — Full diagnostic (~30s)
+ *   npx gitmem-mcp check --output report.json
  *
  *
  */

package/dist/commands/check.js

@@ -4,9 +4,9 @@
  * Diagnostic CLI command for health checks and benchmarks.
  *
  * Usage:
- *   npx gitmem check           — Quick health check (~5s)
- *   npx gitmem check --full    — Full diagnostic (~30s)
- *   npx gitmem check --output report.json
+ *   npx gitmem-mcp check           — Quick health check (~5s)
+ *   npx gitmem-mcp check --full    — Full diagnostic (~30s)
+ *   npx gitmem-mcp check --output report.json
  *
  *
  */

package/dist/constants/closing-questions.js

@@ -137,6 +137,7 @@ const REFLECTION_ALIASES = {
     capture: "institutional_memory_items",
     capture_as_memory: "institutional_memory_items",
     memory_items: "institutional_memory_items",
+    institutional_memory: "institutional_memory_items",
     // Q8-Q9 (rapport, not in CLOSING_QUESTIONS but used)
     q8_human_style: "human_work_style",
     q9_dynamic: "collaborative_dynamic",

package/hooks/README.md

@@ -14,7 +14,7 @@ A Claude Code **plugin** that enforces the GitMem institutional memory lifecycle
 ## Installation
 
 ```bash
-npx gitmem install-hooks
+npx gitmem-mcp install-hooks
 ```
 
 This copies the hooks plugin to `~/.claude/plugins/gitmem-hooks/`. Restart Claude Code to activate.
@@ -22,7 +22,7 @@ This copies the hooks plugin to `~/.claude/plugins/gitmem-hooks/`. Restart Claud
 ### Uninstall
 
 ```bash
-npx gitmem uninstall-hooks
+npx gitmem-mcp uninstall-hooks
 ```
 
 Removes the plugin, cleans up settings and temp state.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitmem-mcp",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Institutional memory for AI coding agents. Memory that compounds.",
   "type": "module",
   "main": "dist/index.js",

package/dist/tools/create-linear-issue.d.ts

@@ -1,18 +0,0 @@
-/**
- * create_linear_issue Tool (OD-611)
- *
- * Proxy Linear issue creation via GraphQL API.
- * Returns slim response (~50 tokens) instead of Linear MCP's ~1400 tokens.
- *
- * Pattern: File-based payload handoff (same as session_close).
- * Agent writes description to .gitmem/issue-payload.json, then calls this
- * tool with title + teamId inline. Tool reads, merges, calls Linear, deletes file.
- *
- * Performance target: <2000ms (one network call)
- */
-import type { CreateLinearIssueParams, CreateLinearIssueResult } from "../types/index.js";
-/**
- * Create a Linear issue via GraphQL API with slim response.
- */
-export declare function createLinearIssue(params: CreateLinearIssueParams): Promise<CreateLinearIssueResult>;
-//# sourceMappingURL=create-linear-issue.d.ts.map

package/dist/tools/create-linear-issue.js

@@ -1,197 +0,0 @@
-/**
- * create_linear_issue Tool (OD-611)
- *
- * Proxy Linear issue creation via GraphQL API.
- * Returns slim response (~50 tokens) instead of Linear MCP's ~1400 tokens.
- *
- * Pattern: File-based payload handoff (same as session_close).
- * Agent writes description to .gitmem/issue-payload.json, then calls this
- * tool with title + teamId inline. Tool reads, merges, calls Linear, deletes file.
- *
- * Performance target: <2000ms (one network call)
- */
-import * as fs from "fs";
-import { v4 as uuidv4 } from "uuid";
-import { getGitmemPath } from "../services/gitmem-dir.js";
-import { Timer, buildPerformanceData, recordMetrics, } from "../services/metrics.js";
-import { getEffectTracker } from "../services/effect-tracker.js";
-const LINEAR_API_URL = "https://api.linear.app/graphql";
-/** GraphQL mutation — request only the fields needed for the slim response */
-const ISSUE_CREATE_MUTATION = `
-  mutation IssueCreate($input: IssueCreateInput!) {
-    issueCreate(input: $input) {
-      success
-      issue {
-        id
-        identifier
-        url
-        state {
-          name
-        }
-      }
-    }
-  }
-`;
-/**
- * Create a Linear issue via GraphQL API with slim response.
- */
-export async function createLinearIssue(params) {
-    const timer = new Timer();
-    const metricsId = uuidv4();
-    // 1. Check LINEAR_API_KEY
-    const apiKey = process.env.LINEAR_API_KEY;
-    if (!apiKey) {
-        const latencyMs = timer.stop();
-        return {
-            success: false,
-            error: "LINEAR_API_KEY environment variable is not set. Add it to your MCP server configuration.",
-            performance: buildPerformanceData("create_linear_issue", latencyMs, 0),
-        };
-    }
-    // 2. Load file-based payload (same pattern as session_close)
-    const payloadPath = params.payload_path || getGitmemPath("issue-payload.json");
-    let filePayload = {};
-    try {
-        if (fs.existsSync(payloadPath)) {
-            filePayload = JSON.parse(fs.readFileSync(payloadPath, "utf-8"));
-            console.error(`[create_linear_issue] Loaded payload from ${payloadPath}`);
-            // Clean up payload file after reading
-            try {
-                fs.unlinkSync(payloadPath);
-            }
-            catch {
-                /* ignore cleanup errors */
-            }
-        }
-    }
-    catch (error) {
-        console.error("[create_linear_issue] Failed to read issue-payload.json:", error);
-    }
-    // 3. Merge: inline params override file payload
-    const teamId = params.teamId || filePayload.teamId;
-    const title = params.title || filePayload.title;
-    if (!teamId || !title) {
-        const latencyMs = timer.stop();
-        return {
-            success: false,
-            error: "teamId and title are required. Provide inline or in .gitmem/issue-payload.json.",
-            performance: buildPerformanceData("create_linear_issue", latencyMs, 0),
-        };
-    }
-    // 4. Build IssueCreateInput for GraphQL
-    const input = {
-        teamId,
-        title,
-    };
-    // Description only comes from file payload (the large field)
-    if (filePayload.description) {
-        input.description = filePayload.description;
-    }
-    // Merge optional fields — inline overrides file
-    if (params.priority !== undefined || filePayload.priority !== undefined) {
-        input.priority = params.priority ?? filePayload.priority;
-    }
-    if (params.labelIds?.length || filePayload.labelIds?.length) {
-        input.labelIds = params.labelIds || filePayload.labelIds;
-    }
-    if (params.projectId || filePayload.projectId) {
-        input.projectId = params.projectId || filePayload.projectId;
-    }
-    if (params.assigneeId || filePayload.assigneeId) {
-        input.assigneeId = params.assigneeId || filePayload.assigneeId;
-    }
-    if (params.parentId || filePayload.parentId) {
-        input.parentId = params.parentId || filePayload.parentId;
-    }
-    if (params.stateId || filePayload.stateId) {
-        input.stateId = params.stateId || filePayload.stateId;
-    }
-    if (params.estimate !== undefined || filePayload.estimate !== undefined) {
-        input.estimate = params.estimate ?? filePayload.estimate;
-    }
-    // 5. Call Linear GraphQL API
-    try {
-        const response = await fetch(LINEAR_API_URL, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                Authorization: apiKey,
-            },
-            body: JSON.stringify({
-                query: ISSUE_CREATE_MUTATION,
-                variables: { input },
-            }),
-        });
-        if (!response.ok) {
-            const text = await response.text();
-            const latencyMs = timer.stop();
-            return {
-                success: false,
-                error: `Linear API HTTP ${response.status}: ${text.slice(0, 200)}`,
-                performance: buildPerformanceData("create_linear_issue", latencyMs, 0),
-            };
-        }
-        const data = (await response.json());
-        // Handle GraphQL errors
-        if (data.errors?.length) {
-            const latencyMs = timer.stop();
-            return {
-                success: false,
-                error: `Linear GraphQL error: ${data.errors.map((e) => e.message).join("; ")}`,
-                performance: buildPerformanceData("create_linear_issue", latencyMs, 0),
-            };
-        }
-        const issueCreate = data.data?.issueCreate;
-        if (!issueCreate?.success || !issueCreate.issue) {
-            const latencyMs = timer.stop();
-            return {
-                success: false,
-                error: "Linear API returned unsuccessful issueCreate",
-                performance: buildPerformanceData("create_linear_issue", latencyMs, 0),
-            };
-        }
-        const issue = issueCreate.issue;
-        const latencyMs = timer.stop();
-        // 6. Fire-and-forget metrics recording
-        getEffectTracker().track("metrics", "create_linear_issue", () => recordMetrics({
-            id: metricsId,
-            tool_name: "create_linear_issue",
-            latency_ms: latencyMs,
-            result_count: 1,
-            metadata: {
-                identifier: issue.identifier,
-                teamId,
-                has_description: !!filePayload.description,
-            },
-        }));
-        // 7. Return slim response (~50 tokens vs ~1400)
-        return {
-            success: true,
-            identifier: issue.identifier,
-            url: issue.url,
-            id: issue.id,
-            state: issue.state?.name,
-            performance: buildPerformanceData("create_linear_issue", latencyMs, 1, {
-                breakdown: {
-                    upsert: {
-                        latency_ms: latencyMs,
-                        source: "supabase",
-                        cache_status: "not_applicable",
-                        network_call: true,
-                    },
-                },
-            }),
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error("[create_linear_issue] Failed:", error);
-        const latencyMs = timer.stop();
-        return {
-            success: false,
-            error: `Linear API call failed: ${errorMessage}`,
-            performance: buildPerformanceData("create_linear_issue", latencyMs, 0),
-        };
-    }
-}
-//# sourceMappingURL=create-linear-issue.js.map