gitmem-mcp 1.1.3 → 1.2.0

package/CHANGELOG.md

@@ -7,10 +7,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-02-20
+
+### Added
+- **Telemetry CLI**: `npx gitmem-mcp telemetry` command for viewing scar effectiveness metrics and recall statistics.
+- **Confirm-scars prefix matching**: `confirm_scars` now accepts 8-character ID prefixes instead of requiring full UUIDs — faster agent workflows.
+- **Session-close timing**: `session_close` now tracks and reports ceremony duration for performance visibility.
+
+### Fixed
+- **Test assertion alignment**: Updated smoke and E2E test assertions to match current CLI output format (branded `((●))` display, lowercase identifiers).
+- **No-console-log allowlist**: CLI commands correctly excluded from console.log lint rule.
+
+## [1.1.4] - 2026-02-20
+
+### Changed
+- **Recall default switched to c-review**: Production nudge header changed from "INSTITUTIONAL MEMORY ACTIVATED" to "N scars to review". Nudge-bench testing (54 runs × 3 models) showed 89% scar reference rate vs 44% — a 2x improvement across Opus, Sonnet, and Haiku.
+
+### Fixed
+- **Thread display cleanup**: Removed internal thread IDs from `list_threads` output. Threads now show `# | Thread | Active` — IDs were implementation detail with no user value.
+
 ## [1.1.3] - 2026-02-19
 
+### Added
+- **Multi-client init wizard**: `npx gitmem-mcp init` now supports VS Code, Windsurf, and generic MCP clients in addition to Claude Code and Cursor.
+- **Server-side enforcement layer**: Universal compliance enforcement that works across all MCP clients — recall before consequential actions, scar confirmation gates.
+- **Scar framing guidance**: `create_learning` tool now guides agents to frame scars as "what we now know" (factual discovery) rather than "what I did wrong" (self-criticism).
+- **Auto-detect agent and session**: Scar usage tracking automatically detects the current agent identity and session context.
+- **Closing payload schema**: Session close payload schema now ships with `init` and `session_start` for client reference.
+- **npm discoverability keywords**: Added `mcp-server`, `claude-code`, `ai-memory`, `ai-agent` keywords for npm search.
+- **Documentation site**:
+  - Restored Fumadocs source for gitmem.ai/docs with emerald theme.
+  - Redesigned docs landing page with improved messaging and branding.
+  - Added FAQ page with 11 questions.
+  - Added MCP one-liner explainer for new users.
+  - Added 3 docs examples (scar stories): credential leak, phantom deploy, and first scar.
+  - Inline mailing list signup form in docs pages.
+  - Rich installation page with multi-client instructions.
+
 ### Fixed
 - **Thread display output**: `list_threads` and `cleanup_threads` replaced ASCII box-drawing tables with markdown tables. Thread text truncation increased from 40-48 to 60 characters. Output now renders cleanly in all MCP clients instead of clipping on narrow terminals.
+- **Version reporting**: Server now reads version from `package.json` instead of hardcoded `1.0.3`.
+- **Log header clarity**: `gitmem log` header now says "most recent learnings" instead of ambiguous label.
+- **Analyze output**: Relabeled misleading "Open Threads" to "Threads Referenced" in analyze output.
+- **Stale thread cleanup**: Drop stale local-only threads on `session_start` when Supabase is authoritative source.
+- **Package name in docs**: Corrected to `npx gitmem-mcp init` (was `npx gitmem init`).
+- **Docs fixes**: Removed duplicate h1 headers, fixed sidebar nav duplicate entry, corrected GitHub URLs after org migration.
 
 ## [1.1.2] - 2026-02-17
 

package/CLAUDE.md.template

@@ -51,18 +51,19 @@ A PreToolUse hook blocks consequential actions until all recalled scars are conf
 
 On "closing", "done for now", or "wrapping up":
 
-1. **Answer these reflection questions** and display to the human:
-   - What broke that you didn't expect?
-   - What took longer than it should have?
-   - What would you do differently next time?
-   - What pattern or approach worked well?
-   - What assumption was wrong?
-   - Which scars did you apply?
-   - What should be captured as institutional memory?
-
-2. **Ask the human**: "Any corrections or additions?" Wait for their response.
-
-3. **Write payload** to `.gitmem/closing-payload.json`:
+1. **Write reflection directly to payload** — do NOT display the full Q&A to the human.
+   Internally answer these 9 questions and write them straight to `.gitmem/closing-payload.json`:
+   - Q1: What broke that you didn't expect?
+   - Q2: What took longer than it should have?
+   - Q3: What would you do differently next time?
+   - Q4: What pattern or approach worked well?
+   - Q5: What assumption was wrong?
+   - Q6: Which scars did you apply?
+   - Q7: What should be captured as institutional memory?
+   - Q8: How did the human prefer to work this session?
+   - Q9: What collaborative dynamic worked or didn't?
+
+   Payload schema (`.gitmem/closing-payload.json`):
    ```json
    {
      "closing_reflection": {
@@ -73,15 +74,15 @@ On "closing", "done for now", or "wrapping up":
        "wrong_assumption": "...",
        "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"
+       "collaborative_dynamic": "...",
+       "rapport_notes": "..."
      },
      "task_completion": {
-       "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 'Looks good'"
+       "questions_displayed_at": "ISO timestamp (when reflection started)",
+       "reflection_completed_at": "ISO timestamp (when payload written)",
+       "human_asked_at": "ISO timestamp (when 'Corrections?' shown)",
+       "human_response_at": "ISO timestamp (when human replied)",
+       "human_response": "user's correction text or 'none'"
      },
      "human_corrections": "",
      "scars_to_record": [],
@@ -91,7 +92,15 @@ On "closing", "done for now", or "wrapping up":
    }
    ```
 
-4. **Call `session_close`** with `session_id` and `close_type: "standard"`
+2. **Show compact summary** (3-4 lines max):
+   ```
+   Session close: [N] learnings captured, [M] scars applied, [K] threads open
+   Key lesson: [one-sentence from Q7]
+   ```
+
+3. **Ask**: "Corrections?" — wait for response, then call `session_close`.
+
+4. **Call `session_close`** with `session_id` and `close_type: "standard"`.
 
 For short exploratory sessions (< 30 min, no real work), use `close_type: "quick"` — no questions needed.
 <!-- gitmem:end -->

package/README.md

@@ -3,11 +3,11 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/gitmem-mcp"><img src="https://img.shields.io/npm/v/gitmem-mcp?style=flat-square&color=ed1e25&label=npm" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/gitmem-mcp"><img src="https://img.shields.io/npm/v/gitmem-mcp?style=flat-square&color=c41920&label=npm" alt="npm version" /></a>
   <a href="https://www.npmjs.com/package/gitmem-mcp"><img src="https://img.shields.io/npm/dm/gitmem-mcp?style=flat-square&color=333333&label=downloads" alt="npm downloads" /></a>
-  <a href="https://github.com/gitmem-dev/gitmem/blob/main/LICENSE"><img src="https://img.shields.io/github/license/gitmem-dev/gitmem?style=flat-square&color=ed1e25" alt="MIT License" /></a>
+  <a href="https://github.com/gitmem-dev/gitmem/blob/main/LICENSE"><img src="https://img.shields.io/github/license/gitmem-dev/gitmem?style=flat-square&color=c41920" alt="MIT License" /></a>
   <a href="https://github.com/gitmem-dev/gitmem/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gitmem-dev/gitmem/ci.yml?style=flat-square&color=333333&label=build" alt="Build" /></a>
-  <img src="https://img.shields.io/badge/node-%3E%3D22-ed1e25?style=flat-square" alt="Node.js >= 22" />
+  <img src="https://img.shields.io/badge/node-%3E%3D18-c41920?style=flat-square" alt="Node.js >= 18" />
 </p>
 
 <p align="center">
@@ -136,7 +136,7 @@ Add this to your MCP client's config file:
 | **Session analytics** | Spot patterns in what keeps going wrong |
 | **Sub-agent briefing** | Hand institutional context to sub-agents automatically |
 | **Cloud persistence** | Memory survives machine changes, shareable across team |
-| **A/B testing** | Optimize scar phrasing based on what actually changes behavior |
+| **A/B testing analytics** | Measure which scar phrasings actually change agent behavior (free tier includes `GITMEM_NUDGE_VARIANT` for manual testing) |
 
 The free tier gives you everything for solo projects. Pro makes recall smarter and memory portable.
 

package/bin/gitmem.js

@@ -51,6 +51,9 @@ Other commands:
   npx gitmem-mcp check --full      Full diagnostic with benchmarks
   npx gitmem-mcp install-hooks     Install hooks (standalone)
   npx gitmem-mcp uninstall-hooks   Remove hooks (standalone)
+  npx gitmem-mcp telemetry status  Check telemetry settings
+  npx gitmem-mcp telemetry enable  Enable anonymous usage tracking (opt-in)
+  npx gitmem-mcp telemetry disable Disable usage tracking
   npx gitmem-mcp server            Start MCP server (default)
   npx gitmem-mcp help              Show this help message
 
@@ -200,6 +203,10 @@ async function cmdInit() {
     console.log("Add .gitmem/ to your .gitignore:");
     console.log("  echo '.gitmem/' >> .gitignore");
     console.log("");
+
+    // Prompt for telemetry (optional, non-blocking)
+    promptTelemetryOptIn();
+
     console.log("To upgrade to Pro tier (semantic search + Supabase persistence):");
     console.log("  Set SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY, then run init again.");
     return;
@@ -686,6 +693,29 @@ function cmdInstallHooks() {
   console.log("  npx gitmem-mcp install-hooks --force");
 }
 
+/**
+ * Prompt user to opt-in to telemetry (non-blocking, async)
+ */
+function promptTelemetryOptIn() {
+  console.log("─────────────────────────────────────────────");
+  console.log("");
+  console.log("Help improve GitMem? (Optional)");
+  console.log("");
+  console.log("Send anonymous usage data to help us understand:");
+  console.log("  • Which features are most useful");
+  console.log("  • Where errors occur");
+  console.log("  • Performance patterns");
+  console.log("");
+  console.log("✓ No queries, scars, or project content");
+  console.log("✓ Randomized ID (not linked to you)");
+  console.log("✓ View all data before it's sent");
+  console.log("✓ Disable anytime");
+  console.log("");
+  console.log("To enable: npx gitmem-mcp telemetry enable");
+  console.log("Privacy policy: https://gitmem.ai/privacy");
+  console.log("");
+}
+
 /**
  * Uninstall gitmem hooks.
  *
@@ -858,6 +888,9 @@ switch (command) {
   case "check":
     import("../dist/commands/check.js").then((m) => m.main(process.argv.slice(3)));
     break;
+  case "telemetry":
+    import("../dist/commands/telemetry.js").then((m) => m.main(process.argv.slice(3)));
+    break;
   case "install-hooks":
     cmdInstallHooks();
     break;

package/copilot-instructions.template

@@ -46,18 +46,19 @@ Safe alternatives: `env | grep -c VARNAME` (count only), `[ -n "$VARNAME" ] && e
 
 **End:** On "closing", "done for now", or "wrapping up":
 
-1. **Answer these reflection questions** and display to the human:
-   - What broke that you didn't expect?
-   - What took longer than it should have?
-   - What would you do differently next time?
-   - What pattern or approach worked well?
-   - What assumption was wrong?
-   - Which scars did you apply?
-   - What should be captured as institutional memory?
-
-2. **Ask the human**: "Any corrections or additions?" Wait for their response.
-
-3. **Write payload** to `.gitmem/closing-payload.json`:
+1. **Write reflection directly to payload** — do NOT display the full Q&A to the human.
+   Internally answer these 9 questions and write them straight to `.gitmem/closing-payload.json`:
+   - Q1: What broke that you didn't expect?
+   - Q2: What took longer than it should have?
+   - Q3: What would you do differently next time?
+   - Q4: What pattern or approach worked well?
+   - Q5: What assumption was wrong?
+   - Q6: Which scars did you apply?
+   - Q7: What should be captured as institutional memory?
+   - Q8: How did the human prefer to work this session?
+   - Q9: What collaborative dynamic worked or didn't?
+
+   Payload schema (`.gitmem/closing-payload.json`):
    ```json
    {
      "closing_reflection": {
@@ -67,16 +68,34 @@ Safe alternatives: `env | grep -c VARNAME` (count only), `[ -n "$VARNAME" ] && e
        "what_worked": "...",
        "wrong_assumption": "...",
        "scars_applied": ["scar title 1", "scar title 2"],
-       "institutional_memory_items": "..."
+       "institutional_memory_items": "...",
+       "collaborative_dynamic": "...",
+       "rapport_notes": "..."
+     },
+     "task_completion": {
+       "questions_displayed_at": "ISO timestamp (when reflection started)",
+       "reflection_completed_at": "ISO timestamp (when payload written)",
+       "human_asked_at": "ISO timestamp (when 'Corrections?' shown)",
+       "human_response_at": "ISO timestamp (when human replied)",
+       "human_response": "user's correction text or 'none'"
      },
      "human_corrections": "",
      "scars_to_record": [],
+     "learnings_created": [],
      "open_threads": [],
      "decisions": []
    }
    ```
 
-4. **Call `session_close`** with `session_id` and `close_type: "standard"`
+2. **Show compact summary** (3-4 lines max):
+   ```
+   Session close: [N] learnings captured, [M] scars applied, [K] threads open
+   Key lesson: [one-sentence from Q7]
+   ```
+
+3. **Ask**: "Corrections?" — wait for response, then call `session_close`.
+
+4. **Call `session_close`** with `session_id` and `close_type: "standard"`.
 
 For short exploratory sessions (< 30 min, no real work), use `close_type: "quick"` — no questions needed.
 <!-- gitmem:end -->

package/cursorrules.template

@@ -46,18 +46,19 @@ Safe alternatives: `env | grep -c VARNAME` (count only), `[ -n "$VARNAME" ] && e
 
 On "closing", "done for now", or "wrapping up":
 
-1. **Answer these reflection questions** and display to the human:
-   - What broke that you didn't expect?
-   - What took longer than it should have?
-   - What would you do differently next time?
-   - What pattern or approach worked well?
-   - What assumption was wrong?
-   - Which scars did you apply?
-   - What should be captured as institutional memory?
-
-2. **Ask the human**: "Any corrections or additions?" Wait for their response.
-
-3. **Write payload** to `.gitmem/closing-payload.json`:
+1. **Write reflection directly to payload** — do NOT display the full Q&A to the human.
+   Internally answer these 9 questions and write them straight to `.gitmem/closing-payload.json`:
+   - Q1: What broke that you didn't expect?
+   - Q2: What took longer than it should have?
+   - Q3: What would you do differently next time?
+   - Q4: What pattern or approach worked well?
+   - Q5: What assumption was wrong?
+   - Q6: Which scars did you apply?
+   - Q7: What should be captured as institutional memory?
+   - Q8: How did the human prefer to work this session?
+   - Q9: What collaborative dynamic worked or didn't?
+
+   Payload schema (`.gitmem/closing-payload.json`):
    ```json
    {
      "closing_reflection": {
@@ -68,15 +69,15 @@ On "closing", "done for now", or "wrapping up":
        "wrong_assumption": "...",
        "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"
+       "collaborative_dynamic": "...",
+       "rapport_notes": "..."
      },
      "task_completion": {
-       "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 'Looks good'"
+       "questions_displayed_at": "ISO timestamp (when reflection started)",
+       "reflection_completed_at": "ISO timestamp (when payload written)",
+       "human_asked_at": "ISO timestamp (when 'Corrections?' shown)",
+       "human_response_at": "ISO timestamp (when human replied)",
+       "human_response": "user's correction text or 'none'"
      },
      "human_corrections": "",
      "scars_to_record": [],
@@ -86,7 +87,15 @@ On "closing", "done for now", or "wrapping up":
    }
    ```
 
-4. **Call `session_close`** with `session_id` and `close_type: "standard"`
+2. **Show compact summary** (3-4 lines max):
+   ```
+   Session close: [N] learnings captured, [M] scars applied, [K] threads open
+   Key lesson: [one-sentence from Q7]
+   ```
+
+3. **Ask**: "Corrections?" — wait for response, then call `session_close`.
+
+4. **Call `session_close`** with `session_id` and `close_type: "standard"`.
 
 For short exploratory sessions (< 30 min, no real work), use `close_type: "quick"` — no questions needed.
 # --- gitmem:end ---

package/dist/commands/telemetry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI commands for telemetry control
+ *
+ * gitmem telemetry status
+ * gitmem telemetry enable
+ * gitmem telemetry disable
+ * gitmem telemetry show [--limit N]
+ * gitmem telemetry clear
+ */
+export declare function main(args: string[]): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/commands/telemetry.js

@@ -0,0 +1,207 @@
+/**
+ * CLI commands for telemetry control
+ *
+ * gitmem telemetry status
+ * gitmem telemetry enable
+ * gitmem telemetry disable
+ * gitmem telemetry show [--limit N]
+ * gitmem telemetry clear
+ */
+import { getTelemetry, Telemetry } from "../lib/telemetry.js";
+import { join } from "path";
+import { readFileSync } from "fs";
+const VERSION = getPackageVersion();
+function getPackageVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf-8"));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function getGitmemDir() {
+    return join(process.cwd(), ".gitmem");
+}
+export function main(args) {
+    const subcommand = args[0];
+    const gitmemDir = getGitmemDir();
+    const telemetry = getTelemetry(gitmemDir, VERSION);
+    switch (subcommand) {
+        case "status":
+            cmdStatus(telemetry);
+            break;
+        case "enable":
+            cmdEnable(telemetry);
+            break;
+        case "disable":
+            cmdDisable(telemetry);
+            break;
+        case "show":
+            cmdShow(telemetry, args);
+            break;
+        case "clear":
+            cmdClear(telemetry);
+            break;
+        default:
+            printUsage();
+            process.exit(1);
+    }
+}
+function cmdStatus(telemetry) {
+    const status = telemetry.getStatus();
+    console.log("GitMem Telemetry — Status");
+    console.log("========================\n");
+    if (status.enabled) {
+        console.log("Status: \x1b[32mEnabled\x1b[0m");
+        console.log(`Session ID: ${status.session_id} (random, not persistent)`);
+        console.log(`Events logged: ${status.event_count} (local)`);
+        if (status.consented_at) {
+            const date = new Date(status.consented_at).toLocaleDateString();
+            console.log(`Consented: ${date}`);
+        }
+        console.log("");
+        console.log("What's collected:");
+        console.log("  • Tool names (recall, session_close, etc.)");
+        console.log("  • Success/failure status");
+        console.log("  • Execution duration");
+        console.log("  • Result counts (not content)");
+        console.log("  • Platform (darwin, linux, win32)");
+        console.log("  • Version number");
+        console.log("");
+        console.log("What's NOT collected:");
+        console.log("  ✗ Queries or search terms");
+        console.log("  ✗ Scar/learning content");
+        console.log("  ✗ Project names or file paths");
+        console.log("  ✗ IP addresses or identifiers");
+        console.log("");
+        console.log("Commands:");
+        console.log("  gitmem telemetry show      View pending events");
+        console.log("  gitmem telemetry disable   Turn off telemetry");
+        console.log("");
+        console.log("Privacy policy: https://gitmem.ai/privacy");
+    }
+    else {
+        console.log("Status: \x1b[33mDisabled\x1b[0m");
+        console.log("");
+        console.log("No data is being sent.");
+        console.log("");
+        console.log("To help improve GitMem:");
+        console.log("  gitmem telemetry enable");
+        console.log("");
+        console.log("Privacy policy: https://gitmem.ai/privacy");
+    }
+}
+function cmdEnable(telemetry) {
+    console.log("GitMem Telemetry — Enable");
+    console.log("=========================\n");
+    console.log("Help improve GitMem by sending anonymous usage data.\n");
+    console.log("What we collect:");
+    console.log("  ✓ Tool usage patterns (which tools are most useful)");
+    console.log("  ✓ Error rates (to prioritize fixes)");
+    console.log("  ✓ Performance metrics (duration, platform)");
+    console.log("");
+    console.log("What we DON'T collect:");
+    console.log("  ✗ Your queries or content");
+    console.log("  ✗ Scar/learning text");
+    console.log("  ✗ Project names or file paths");
+    console.log("  ✗ IP addresses or persistent IDs");
+    console.log("");
+    console.log("Transparency:");
+    console.log("  • All events logged to .gitmem/telemetry.log");
+    console.log("  • View before sending: gitmem telemetry show");
+    console.log("  • Disable anytime: gitmem telemetry disable");
+    console.log("");
+    console.log("Full privacy policy: https://gitmem.ai/privacy");
+    console.log("");
+    // Prompt for confirmation (skip if --yes flag)
+    if (!process.argv.includes("--yes") && !process.argv.includes("-y")) {
+        const readline = require("readline");
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question("Enable telemetry? [y/N] ", (answer) => {
+            rl.close();
+            if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
+                telemetry.enable();
+                console.log("");
+                console.log("\x1b[32m✓\x1b[0m Telemetry enabled");
+                console.log("  Data logged to: .gitmem/telemetry.log");
+                console.log("  Review anytime: gitmem telemetry show");
+                console.log("  Disable anytime: gitmem telemetry disable");
+            }
+            else {
+                console.log("");
+                console.log("Telemetry not enabled.");
+            }
+        });
+    }
+    else {
+        telemetry.enable();
+        console.log("\x1b[32m✓\x1b[0m Telemetry enabled (--yes flag)");
+    }
+}
+function cmdDisable(telemetry) {
+    telemetry.disable();
+    console.log("GitMem Telemetry — Disable");
+    console.log("==========================\n");
+    console.log("\x1b[32m✓\x1b[0m Telemetry disabled");
+    console.log("  Pending events: will not be sent");
+    console.log("  Local logs: preserved at .gitmem/telemetry.log");
+    console.log("");
+    console.log("To re-enable: gitmem telemetry enable");
+}
+function cmdShow(telemetry, args) {
+    const limitIdx = args.indexOf("--limit");
+    const limit = limitIdx !== -1 ? parseInt(args[limitIdx + 1], 10) : 100;
+    const events = telemetry.getRecentEvents(limit);
+    console.log(`GitMem Telemetry — Recent Events (last ${Math.min(limit, events.length)})`);
+    console.log("=".repeat(60));
+    console.log("");
+    if (events.length === 0) {
+        console.log("No events logged yet.");
+        console.log("");
+        console.log("Events are logged automatically as you use gitmem tools.");
+        return;
+    }
+    for (const eventJson of events) {
+        console.log(Telemetry.formatEvent(eventJson));
+    }
+    console.log("");
+    console.log(`Total events: ${events.length}`);
+    console.log(`Status: ${telemetry.isEnabled() ? "\x1b[32mEnabled\x1b[0m (will be sent)" : "\x1b[33mDisabled\x1b[0m (logged only)"}`);
+}
+function cmdClear(telemetry) {
+    const status = telemetry.getStatus();
+    const count = status.event_count;
+    telemetry.clearLog();
+    console.log("GitMem Telemetry — Clear");
+    console.log("========================\n");
+    console.log("\x1b[32m✓\x1b[0m Cleared all local telemetry logs");
+    console.log(`  Events removed: ${count}`);
+    console.log("");
+    console.log("Note: Remote data (already sent) cannot be deleted.");
+    console.log("      It's already anonymous and not linked to you.");
+}
+function printUsage() {
+    console.log(`
+GitMem Telemetry — Control
+
+Usage:
+  gitmem telemetry status           Show current status
+  gitmem telemetry enable           Enable anonymous usage tracking
+  gitmem telemetry disable          Disable usage tracking
+  gitmem telemetry show [--limit N] View recent events (default: 100)
+  gitmem telemetry clear            Clear local event log
+
+Privacy:
+  • Opt-in only (disabled by default)
+  • No PII (queries, scars, project names, IPs)
+  • Transparent (local logs before sending)
+  • Anonymous (random session IDs, not persistent)
+
+Full policy: https://gitmem.ai/privacy
+`);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/hooks/format-utils.d.ts

@@ -23,6 +23,7 @@ export interface FormattableScar {
     action_protocol?: string[];
     self_check_criteria?: string[];
 }
+/** Text severity indicators — no emoji (column width is unpredictable across terminals) */
 export declare const SEVERITY_EMOJI: Record<string, string>;
 export declare const SEVERITY_LABEL: Record<string, string>;
 export declare const SEVERITY_ORDER: Record<string, number>;

package/dist/hooks/format-utils.js

@@ -6,11 +6,12 @@
  *   - quick-retrieve.ts  (hook-invoked retrieval for auto-inject)
  */
 // --- Severity Constants ---
+/** Text severity indicators — no emoji (column width is unpredictable across terminals) */
 export const SEVERITY_EMOJI = {
-    critical: "\uD83D\uDD34",
-    high: "\uD83D\uDFE0",
-    medium: "\uD83D\uDFE1",
-    low: "\uD83D\uDFE2",
+    critical: "[!!]",
+    high: "[!]",
+    medium: "[~]",
+    low: "[-]",
 };
 export const SEVERITY_LABEL = {
     critical: "CRITICAL",
@@ -44,7 +45,7 @@ export function formatCompact(scars, plan, maxTokens) {
     const lines = [header];
     let included = 0;
     for (const scar of sorted) {
-        const emoji = SEVERITY_EMOJI[scar.severity] || "\u26AA";
+        const emoji = SEVERITY_EMOJI[scar.severity] || "[?]";
         const label = SEVERITY_LABEL[scar.severity] || "UNKNOWN";
         const firstSentence = scar.description.split(/\.\s/)[0].slice(0, 120);
         const line = `${emoji} ${label}: ${scar.title} \u2014 ${firstSentence}`;
@@ -76,7 +77,7 @@ export function formatGate(scars) {
     ];
     for (const scar of blockingScars) {
         const rv = scar.required_verification;
-        lines.push(`\uD83D\uDEA8 BLOCK: ${rv.when}`);
+        lines.push(`[!!] BLOCK: ${rv.when}`);
         if (rv.queries && rv.queries.length > 0) {
             for (const query of rv.queries) {
                 lines.push(`  RUN: ${query}`);