@memnexus-ai/cli 1.7.162 → 1.7.164

package/dist/lib/setup/hooks-writer.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * Hooks writer — install and remove MemNexus lifecycle hooks for AI agents.
+ *
+ * Phase 1 scope: Claude Code only.
+ *
+ * Copies bundled hook scripts to ~/.memnexus/hooks/ and merges hook entries
+ * into the agent's settings.json without overwriting existing hooks.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installHooks = installHooks;
+exports.removeHooks = removeHooks;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const detector_js_1 = require("./detector.js");
+// Resolve the hooks/ directory bundled alongside the compiled output.
+// Compiled file lives at dist/lib/setup/hooks-writer.js → go up 3 levels
+// to the package root, then into hooks/.
+// __dirname is a CommonJS global — available because module: "commonjs" in tsconfig.
+const BUNDLED_HOOKS_DIR = node_path_1.default.resolve(__dirname, '../../../hooks');
+/** Destination directory for installed hook scripts. */
+const INSTALLED_HOOKS_DIR = node_path_1.default.join(node_os_1.default.homedir(), '.memnexus', 'hooks');
+/** Hook script filenames managed by MemNexus. */
+const HOOK_SCRIPTS = ['capture-precompact.sh', 'capture-session-end.sh'];
+/** Build hook entries with absolute paths (resolved at install time, not tilde). */
+function buildMemnexusHooks() {
+    const hooksDir = node_path_1.default.join(node_os_1.default.homedir(), '.memnexus', 'hooks');
+    return {
+        PreCompact: [
+            {
+                matcher: '',
+                hooks: [
+                    {
+                        type: 'command',
+                        command: `bash ${node_path_1.default.join(hooksDir, 'capture-precompact.sh')}`,
+                    },
+                ],
+            },
+        ],
+        Stop: [
+            {
+                hooks: [
+                    {
+                        type: 'command',
+                        command: `bash ${node_path_1.default.join(hooksDir, 'capture-session-end.sh')}`,
+                    },
+                ],
+            },
+        ],
+    };
+}
+/** Marker string used to identify MemNexus hook entries. */
+const MEMNEXUS_MARKER = 'memnexus';
+/**
+ * Resolve the settings.json path for a Claude Code installation.
+ * - global scope: ~/.claude/settings.json
+ * - project scope: <projectDir>/.claude/settings.json
+ */
+function resolveSettingsPath(scope, projectDir) {
+    if (scope === 'project') {
+        if (!projectDir) {
+            throw new Error('Project directory required for project scope');
+        }
+        return node_path_1.default.join(projectDir, '.claude', 'settings.json');
+    }
+    return (0, detector_js_1.resolvePath)('~/.claude/settings.json');
+}
+/**
+ * Return true if a hook entry array contains a MemNexus command.
+ */
+function arrayHasMemnexusHook(entries) {
+    return entries.some((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return false;
+        const e = entry;
+        const subHooks = e.hooks;
+        if (!Array.isArray(subHooks))
+            return false;
+        return subHooks.some((h) => {
+            if (typeof h !== 'object' || h === null)
+                return false;
+            const cmd = h.command;
+            return typeof cmd === 'string' && cmd.includes(MEMNEXUS_MARKER);
+        });
+    });
+}
+/**
+ * Replace any existing MemNexus entry in a hook array, or append if not present.
+ */
+function upsertHookEntries(existing, newEntries) {
+    // Remove old memnexus entries
+    const filtered = existing.filter((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return true;
+        const e = entry;
+        const subHooks = e.hooks;
+        if (!Array.isArray(subHooks))
+            return true;
+        return !subHooks.some((h) => {
+            if (typeof h !== 'object' || h === null)
+                return false;
+            const cmd = h.command;
+            return typeof cmd === 'string' && cmd.includes(MEMNEXUS_MARKER);
+        });
+    });
+    // Append the new entries
+    return [...filtered, ...newEntries];
+}
+/**
+ * Install MemNexus lifecycle hooks for a Claude Code installation.
+ *
+ * - Copies bundled hook scripts to ~/.memnexus/hooks/
+ * - Merges hook entries into the agent's settings.json
+ * - Idempotent: re-running updates scripts and entries in place
+ *
+ * Returns null for agents other than Claude Code (Phase 1 scope).
+ */
+async function installHooks(options) {
+    const { agent, scope, projectDir, dryRun } = options;
+    // Phase 1: Claude Code only
+    if (agent.id !== 'claude-code') {
+        return null;
+    }
+    const scriptsCopied = [];
+    // ── 1. Copy hook scripts to ~/.memnexus/hooks/ ──────────────────────────
+    if (!dryRun) {
+        await (0, promises_1.mkdir)(INSTALLED_HOOKS_DIR, { recursive: true });
+        for (const scriptName of HOOK_SCRIPTS) {
+            const src = node_path_1.default.join(BUNDLED_HOOKS_DIR, scriptName);
+            if (!(0, node_fs_1.existsSync)(src)) {
+                // Bundled script missing — skip gracefully (shouldn't happen in production)
+                continue;
+            }
+            const dest = node_path_1.default.join(INSTALLED_HOOKS_DIR, scriptName);
+            await (0, promises_1.copyFile)(src, dest);
+            await (0, promises_1.chmod)(dest, 0o755);
+            scriptsCopied.push(scriptName);
+        }
+    }
+    else {
+        // Dry-run: report what would be copied
+        for (const scriptName of HOOK_SCRIPTS) {
+            const src = node_path_1.default.join(BUNDLED_HOOKS_DIR, scriptName);
+            if ((0, node_fs_1.existsSync)(src)) {
+                scriptsCopied.push(scriptName);
+            }
+        }
+    }
+    // ── 2. Merge hook entries into settings.json ─────────────────────────────
+    const configPath = resolveSettingsPath(scope, projectDir);
+    let backupPath;
+    let action;
+    let settings = {};
+    const fileExists = (0, node_fs_1.existsSync)(configPath);
+    if (fileExists) {
+        try {
+            const raw = await (0, promises_1.readFile)(configPath, 'utf-8');
+            settings = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`Cannot parse ${configPath} — fix the JSON syntax and retry. ` +
+                `Original error: ${err.message}`);
+        }
+        if (!dryRun) {
+            backupPath = configPath + '.bak';
+            await (0, promises_1.copyFile)(configPath, backupPath);
+        }
+        action = 'updated';
+    }
+    else {
+        action = 'created';
+    }
+    // Ensure hooks object exists
+    if (!settings.hooks || typeof settings.hooks !== 'object') {
+        settings.hooks = {};
+    }
+    const hooks = settings.hooks;
+    // Merge PreCompact hooks
+    const preCompactEntries = Array.isArray(hooks.PreCompact) ? hooks.PreCompact : [];
+    hooks.PreCompact = upsertHookEntries(preCompactEntries, buildMemnexusHooks().PreCompact);
+    // Merge Stop hooks
+    const stopEntries = Array.isArray(hooks.Stop) ? hooks.Stop : [];
+    hooks.Stop = upsertHookEntries(stopEntries, buildMemnexusHooks().Stop);
+    // Check whether anything actually changed when updating
+    if (fileExists &&
+        action === 'updated' &&
+        Array.isArray(hooks.PreCompact) &&
+        Array.isArray(hooks.Stop) &&
+        arrayHasMemnexusHook(preCompactEntries) &&
+        arrayHasMemnexusHook(stopEntries) &&
+        JSON.stringify(hooks.PreCompact) === JSON.stringify(preCompactEntries) &&
+        JSON.stringify(hooks.Stop) === JSON.stringify(stopEntries)) {
+        // Nothing changed — already up to date
+        action = 'skipped';
+        backupPath = undefined;
+    }
+    if (!dryRun && action !== 'skipped') {
+        await (0, promises_1.mkdir)(node_path_1.default.dirname(configPath), { recursive: true });
+        await (0, promises_1.writeFile)(configPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+    }
+    return { scriptsDir: INSTALLED_HOOKS_DIR, scriptsCopied, configPath, backupPath, action };
+}
+/**
+ * Remove MemNexus lifecycle hooks for a Claude Code installation.
+ *
+ * - Removes hook entries containing "memnexus" from settings.json
+ * - Deletes hook scripts from ~/.memnexus/hooks/
+ * - Cleans up empty hook arrays
+ *
+ * No-ops for agents other than Claude Code.
+ */
+async function removeHooks(options) {
+    const { agent, scope, projectDir } = options;
+    // Phase 1: Claude Code only
+    if (agent.id !== 'claude-code') {
+        return;
+    }
+    // ── 1. Remove hook scripts ───────────────────────────────────────────────
+    for (const scriptName of HOOK_SCRIPTS) {
+        const scriptPath = node_path_1.default.join(INSTALLED_HOOKS_DIR, scriptName);
+        if ((0, node_fs_1.existsSync)(scriptPath)) {
+            await (0, promises_1.rm)(scriptPath, { force: true });
+        }
+    }
+    // ── 2. Remove hook entries from settings.json ────────────────────────────
+    const configPath = resolveSettingsPath(scope, projectDir);
+    if (!(0, node_fs_1.existsSync)(configPath))
+        return;
+    let settings;
+    try {
+        const raw = await (0, promises_1.readFile)(configPath, 'utf-8');
+        settings = JSON.parse(raw);
+    }
+    catch {
+        return; // Unparseable — leave it alone
+    }
+    if (!settings.hooks || typeof settings.hooks !== 'object')
+        return;
+    const hooks = settings.hooks;
+    for (const eventType of ['PreCompact', 'Stop']) {
+        const entries = hooks[eventType];
+        if (!Array.isArray(entries))
+            continue;
+        const filtered = entries.filter((entry) => {
+            if (typeof entry !== 'object' || entry === null)
+                return true;
+            const e = entry;
+            const subHooks = e.hooks;
+            if (!Array.isArray(subHooks))
+                return true;
+            return !subHooks.some((h) => {
+                if (typeof h !== 'object' || h === null)
+                    return false;
+                const cmd = h.command;
+                return typeof cmd === 'string' && cmd.includes(MEMNEXUS_MARKER);
+            });
+        });
+        if (filtered.length === 0) {
+            delete hooks[eventType];
+        }
+        else {
+            hooks[eventType] = filtered;
+        }
+    }
+    // If hooks object is now empty, remove it
+    if (Object.keys(hooks).length === 0) {
+        delete settings.hooks;
+    }
+    await (0, promises_1.writeFile)(configPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+}
+//# sourceMappingURL=hooks-writer.js.map

package/dist/lib/setup/hooks-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-writer.js","sourceRoot":"","sources":["../../../src/lib/setup/hooks-writer.ts"],"names":[],"mappings":"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"}

package/dist/lib/setup/index.d.ts

@@ -6,5 +6,7 @@ export { composeRules, parseSteeringVersion } from './rules-templates.js';
 export { getAgent, getAgentIds, getSortedAgents, AGENTS } from './registry.js';
 export { writeAllSkills, removeAllSkills, listSkills, resolveSkillsDir, resolveSkillPath, } from './skills-writer.js';
 export { SKILLS, parseSkillVersion } from './skills-templates.js';
+export { installHooks, removeHooks } from './hooks-writer.js';
+export type { HooksWriteResult } from './hooks-writer.js';
 export type * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/setup/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClE,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,mBAAmB,YAAY,CAAC"}

package/dist/lib/setup/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseSkillVersion = exports.SKILLS = exports.resolveSkillPath = exports.resolveSkillsDir = exports.listSkills = exports.removeAllSkills = exports.writeAllSkills = exports.AGENTS = exports.getSortedAgents = exports.getAgentIds = exports.getAgent = exports.parseSteeringVersion = exports.composeRules = exports.resolveSteeringPath = exports.getSteeringVersion = exports.removeSteeringSection = exports.writeSteeringFile = exports.verifyAll = exports.verifyAgent = exports.resolveConfigPath = exports.removeAgentConfig = exports.writeAgentConfig = exports.resolvePath = exports.detectAgents = void 0;
+exports.removeHooks = exports.installHooks = exports.parseSkillVersion = exports.SKILLS = exports.resolveSkillPath = exports.resolveSkillsDir = exports.listSkills = exports.removeAllSkills = exports.writeAllSkills = exports.AGENTS = exports.getSortedAgents = exports.getAgentIds = exports.getAgent = exports.parseSteeringVersion = exports.composeRules = exports.resolveSteeringPath = exports.getSteeringVersion = exports.removeSteeringSection = exports.writeSteeringFile = exports.verifyAll = exports.verifyAgent = exports.resolveConfigPath = exports.removeAgentConfig = exports.writeAgentConfig = exports.resolvePath = exports.detectAgents = void 0;
 var detector_js_1 = require("./detector.js");
 Object.defineProperty(exports, "detectAgents", { enumerable: true, get: function () { return detector_js_1.detectAgents; } });
 Object.defineProperty(exports, "resolvePath", { enumerable: true, get: function () { return detector_js_1.resolvePath; } });
@@ -33,4 +33,7 @@ Object.defineProperty(exports, "resolveSkillPath", { enumerable: true, get: func
 var skills_templates_js_1 = require("./skills-templates.js");
 Object.defineProperty(exports, "SKILLS", { enumerable: true, get: function () { return skills_templates_js_1.SKILLS; } });
 Object.defineProperty(exports, "parseSkillVersion", { enumerable: true, get: function () { return skills_templates_js_1.parseSkillVersion; } });
+var hooks_writer_js_1 = require("./hooks-writer.js");
+Object.defineProperty(exports, "installHooks", { enumerable: true, get: function () { return hooks_writer_js_1.installHooks; } });
+Object.defineProperty(exports, "removeHooks", { enumerable: true, get: function () { return hooks_writer_js_1.removeHooks; } });
 //# sourceMappingURL=index.js.map

package/dist/lib/setup/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/setup/index.ts"],"names":[],"mappings":";;;AAAA,6CAA0D;AAAjD,2GAAA,YAAY,OAAA;AAAE,0GAAA,WAAW,OAAA;AAClC,uDAA4F;AAAnF,oHAAA,gBAAgB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAC/D,6CAAuD;AAA9C,0GAAA,WAAW,OAAA;AAAE,wGAAA,SAAS,OAAA;AAC/B,qDAK2B;AAJzB,oHAAA,iBAAiB,OAAA;AACjB,wHAAA,qBAAqB,OAAA;AACrB,qHAAA,kBAAkB,OAAA;AAClB,sHAAA,mBAAmB,OAAA;AAErB,2DAA0E;AAAjE,kHAAA,YAAY,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAC3C,6CAA+E;AAAtE,uGAAA,QAAQ,OAAA;AAAE,0GAAA,WAAW,OAAA;AAAE,8GAAA,eAAe,OAAA;AAAE,qGAAA,MAAM,OAAA;AACvD,uDAM4B;AAL1B,kHAAA,cAAc,OAAA;AACd,mHAAA,eAAe,OAAA;AACf,8GAAA,UAAU,OAAA;AACV,oHAAA,gBAAgB,OAAA;AAChB,oHAAA,gBAAgB,OAAA;AAElB,6DAAkE;AAAzD,6GAAA,MAAM,OAAA;AAAE,wHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/setup/index.ts"],"names":[],"mappings":";;;AAAA,6CAA0D;AAAjD,2GAAA,YAAY,OAAA;AAAE,0GAAA,WAAW,OAAA;AAClC,uDAA4F;AAAnF,oHAAA,gBAAgB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAC/D,6CAAuD;AAA9C,0GAAA,WAAW,OAAA;AAAE,wGAAA,SAAS,OAAA;AAC/B,qDAK2B;AAJzB,oHAAA,iBAAiB,OAAA;AACjB,wHAAA,qBAAqB,OAAA;AACrB,qHAAA,kBAAkB,OAAA;AAClB,sHAAA,mBAAmB,OAAA;AAErB,2DAA0E;AAAjE,kHAAA,YAAY,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAC3C,6CAA+E;AAAtE,uGAAA,QAAQ,OAAA;AAAE,0GAAA,WAAW,OAAA;AAAE,8GAAA,eAAe,OAAA;AAAE,qGAAA,MAAM,OAAA;AACvD,uDAM4B;AAL1B,kHAAA,cAAc,OAAA;AACd,mHAAA,eAAe,OAAA;AACf,8GAAA,UAAU,OAAA;AACV,oHAAA,gBAAgB,OAAA;AAChB,oHAAA,gBAAgB,OAAA;AAElB,6DAAkE;AAAzD,6GAAA,MAAM,OAAA;AAAE,wHAAA,iBAAiB,OAAA;AAClC,qDAA8D;AAArD,+GAAA,YAAY,OAAA;AAAE,8GAAA,WAAW,OAAA"}

package/hooks/capture-precompact.sh

@@ -0,0 +1,218 @@
+#!/bin/bash
+# capture-precompact.sh — Automatic memory capture before context compaction
+#
+# Installed at ~/.memnexus/hooks/ by `mx mcp install` for end-user lifecycle
+# hook integration with Claude Code.
+#
+# The highest-value automatic capture signal: fires when ~95% of context window
+# is full, meaning rich context (decisions, debugging sessions, architecture
+# discussions) is about to be lost forever.
+#
+# Unlike session-end capture (which summarises what was done), this hook
+# extracts structured knowledge — decisions, problems solved, patterns — and
+# saves it as a permanent memory before compaction discards the context.
+#
+# Fires on: PreCompact
+# Input: JSON on stdin with transcript_path, session_id, trigger
+# Output: none (side-effect only — saves memory via mx CLI)
+# Exit: always 0 (never blocks compaction)
+
+# Fail-open: any error -> allow compaction without saving
+trap 'exit 0' ERR
+
+# ── 1. Check required tools ──────────────────────────────────────────────
+command -v jq >/dev/null 2>&1 || exit 0
+command -v mx >/dev/null 2>&1 || exit 0
+
+# ── 2. Parse hook input ──────────────────────────────────────────────────
+INPUT=$(cat)
+
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)
+_SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
+
+# Skip if no transcript
+if [[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]]; then
+  exit 0
+fi
+
+# Validate transcript path — must resolve to a real file, not a symlink to elsewhere
+REAL_TRANSCRIPT=$(realpath "$TRANSCRIPT_PATH" 2>/dev/null) || exit 0
+if [[ ! -f "$REAL_TRANSCRIPT" ]]; then
+  exit 0
+fi
+TRANSCRIPT_PATH="$REAL_TRANSCRIPT"
+
+# ── 3. Derive project name from transcript path or cwd ───────────────────
+# Transcript paths typically contain the project directory name
+PROJECT_NAME=$(basename "$(dirname "$TRANSCRIPT_PATH")" 2>/dev/null)
+if [[ -z "$PROJECT_NAME" || "$PROJECT_NAME" == "." ]]; then
+  PROJECT_NAME=$(basename "$(pwd)" 2>/dev/null || echo "unknown")
+fi
+
+# ── 4. Extract structured data from transcript ───────────────────────────
+
+tmpdir=$(mktemp -d)
+trap 'rm -rf "$tmpdir"; exit 0' EXIT ERR
+
+# Total line count (proxy for session depth)
+_TOTAL_LINES=$(wc -l < "$TRANSCRIPT_PATH" 2>/dev/null || echo "0")
+
+# Files modified (Write/Edit tool calls)
+FILES_MODIFIED=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and (.name == "Write" or .name == "Edit")) |
+  .input.file_path // empty
+' "$TRANSCRIPT_PATH" 2>/dev/null | grep -v '^$' | sort -u | head -30)
+
+# Files read (Read tool calls — indicates areas of investigation)
+FILES_READ=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and .name == "Read") |
+  .input.file_path // empty
+' "$TRANSCRIPT_PATH" 2>/dev/null | grep -v '^$' | sort | uniq -c | sort -rn | head -15 | awk '{print $2}')
+
+# Bash commands run (significant actions)
+BASH_COMMANDS=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and .name == "Bash") |
+  .input.command // empty
+' "$TRANSCRIPT_PATH" 2>/dev/null | grep -v '^$' | grep -vE '^(ls|pwd|echo|cat |head |tail )' | tail -20)
+
+# Git activity
+GIT_COMMITS=$(echo "$BASH_COMMANDS" | grep -oE 'git commit' | wc -l | tr -d ' ')
+GIT_PUSHES=$(echo "$BASH_COMMANDS" | grep -oE 'git push' | wc -l | tr -d ' ')
+PR_CREATES=$(echo "$BASH_COMMANDS" | grep -oE 'gh pr create' | wc -l | tr -d ' ')
+PR_MERGES=$(echo "$BASH_COMMANDS" | grep -oE 'gh pr merge' | wc -l | tr -d ' ')
+
+# PR and issue references from all text content
+ALL_TEXT=$(jq -r '
+  select(.type == "user" or .type == "assistant") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' "$TRANSCRIPT_PATH" 2>/dev/null)
+
+GH_REFS=$(echo "$ALL_TEXT" | grep -oE '(PR |#)[0-9]+' 2>/dev/null | sort -u | head -15 | tr '\n' ', ' | sed 's/,$//')
+
+# User messages (to understand intent and topics)
+USER_MESSAGES=$(jq -r '
+  select(.type == "user") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' "$TRANSCRIPT_PATH" 2>/dev/null | head -c 3000)
+
+# Last few assistant text blocks (conclusions/results)
+RECENT_RESULTS=$(tail -100 "$TRANSCRIPT_PATH" | jq -r '
+  select(.type == "assistant") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' 2>/dev/null | tail -c 2000)
+
+# Tool usage summary
+TOOL_SUMMARY=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use") | .name
+' "$TRANSCRIPT_PATH" 2>/dev/null | sort | uniq -c | sort -rn | head -10 | awk '{printf "%s(%d) ", $2, $1}')
+
+# ── 5. Significance filter ───────────────────────────────────────────────
+# Skip if session was trivial (very few tool calls, no files modified)
+TOOL_COUNT=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use") | .name
+' "$TRANSCRIPT_PATH" 2>/dev/null | wc -l | tr -d ' ')
+
+if [[ "$TOOL_COUNT" -lt 5 && -z "$FILES_MODIFIED" ]]; then
+  # Trivial session — not worth capturing
+  exit 0
+fi
+
+# ── 5b. Sanitize sensitive data ──────────────────────────────────────────
+# Strip common secret patterns from extracted text before saving as memory
+sanitize() {
+  sed -E \
+    -e 's/(api[_-]?key|token|secret|password|bearer|authorization)[[:space:]]*[:=][[:space:]]*[^[:space:],\"'"'"']+/\1=<REDACTED>/gi' \
+    -e 's/cmk_live_[A-Za-z0-9_-]+/cmk_live_<REDACTED>/g' \
+    -e 's/sk-[A-Za-z0-9_-]{20,}/sk-<REDACTED>/g' \
+    -e 's/ghp_[A-Za-z0-9]{36}/ghp_<REDACTED>/g' \
+    -e 's/gho_[A-Za-z0-9]{36}/gho_<REDACTED>/g' \
+    -e 's/-----BEGIN [A-Z ]*PRIVATE KEY-----/-----BEGIN REDACTED KEY-----/g'
+}
+
+USER_MESSAGES=$(echo "$USER_MESSAGES" | sanitize)
+BASH_COMMANDS=$(echo "$BASH_COMMANDS" | sanitize)
+RECENT_RESULTS=$(echo "$RECENT_RESULTS" | sanitize)
+
+# ── 6. Build structured memory content ───────────────────────────────────
+GIT_BRANCH=$(git -C "$(dirname "$TRANSCRIPT_PATH")" branch --show-current 2>/dev/null || \
+             git branch --show-current 2>/dev/null || echo "unknown")
+
+# Build files list
+MOD_LIST=""
+if [[ -n "$FILES_MODIFIED" ]]; then
+  MOD_LIST=$(echo "$FILES_MODIFIED" | sed 's/^/- /')
+fi
+
+READ_LIST=""
+if [[ -n "$FILES_READ" ]]; then
+  READ_LIST=$(echo "$FILES_READ" | head -10 | sed 's/^/- /')
+fi
+
+# Build activity summary
+ACTIVITY=""
+[[ "$GIT_COMMITS" -gt 0 ]] && ACTIVITY="${ACTIVITY}${GIT_COMMITS} commits, "
+[[ "$GIT_PUSHES" -gt 0 ]] && ACTIVITY="${ACTIVITY}${GIT_PUSHES} pushes, "
+[[ "$PR_CREATES" -gt 0 ]] && ACTIVITY="${ACTIVITY}${PR_CREATES} PRs created, "
+[[ "$PR_MERGES" -gt 0 ]] && ACTIVITY="${ACTIVITY}${PR_MERGES} PRs merged, "
+ACTIVITY="${ACTIVITY}${TOOL_COUNT} tool calls"
+
+CONTENT="[Auto-Captured] Session context before compaction — ${PROJECT_NAME}
+
+Branch: ${GIT_BRANCH}
+Activity: ${ACTIVITY}
+GitHub refs: ${GH_REFS:-none}
+
+Files modified:
+${MOD_LIST:-None}
+
+Files investigated:
+${READ_LIST:-None}
+
+Tools used: ${TOOL_SUMMARY}
+
+What the user was working on:
+$(echo "$USER_MESSAGES" | head -c 1500)
+
+Recent results/conclusions:
+$(echo "$RECENT_RESULTS" | head -c 1500)"
+
+# Truncate total content to ~5000 chars
+CONTENT=$(echo "$CONTENT" | head -c 5000)
+
+# ── 7. Save memory (with timeout — never block compaction) ───────────────
+TIMEOUT_CMD=""
+if command -v timeout >/dev/null 2>&1; then
+  TIMEOUT_CMD="timeout 10"
+elif command -v gtimeout >/dev/null 2>&1; then
+  TIMEOUT_CMD="gtimeout 10"
+fi
+
+$TIMEOUT_CMD mx memories create \
+  --conversation-id "NEW" \
+  --content "$CONTENT" \
+  --topics "auto-captured,precompact" \
+  >/dev/null 2>&1 || true
+
+exit 0