@massu/core 1.9.2 → 1.9.5

package/dist/hooks/classify-failure.js

@@ -12,6 +12,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -516,7 +523,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/cost-tracker.js

@@ -12,6 +12,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -516,7 +523,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/fix-detector.js

@@ -2,7 +2,7 @@
 import{createRequire as __cr}from"module";const require=__cr(import.meta.url);
 
 // src/hooks/fix-detector.ts
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
 import { existsSync as existsSync2, appendFileSync, mkdirSync, readFileSync as readFileSync2 } from "fs";
 import { tmpdir } from "os";
 import { join } from "path";
@@ -565,9 +565,9 @@ async function main() {
     const root = getProjectRoot();
     let diff = "";
     try {
-      diff = execSync(`git diff -- "${filePath}"`, { cwd: root, timeout: 3e3, encoding: "utf-8" });
+      diff = execFileSync("git", ["diff", "--", filePath], { cwd: root, timeout: 3e3, encoding: "utf-8" });
       if (!diff) {
-        diff = execSync(`git diff HEAD -- "${filePath}"`, { cwd: root, timeout: 3e3, encoding: "utf-8" });
+        diff = execFileSync("git", ["diff", "HEAD", "--", filePath], { cwd: root, timeout: 3e3, encoding: "utf-8" });
       }
     } catch {
       process.exit(0);

package/dist/hooks/incident-pipeline.js

@@ -11,6 +11,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -515,7 +522,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/post-edit-context.js

@@ -10,6 +10,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -514,7 +521,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/post-tool-use.js

@@ -12,6 +12,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -516,7 +523,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/pre-compact.js

@@ -12,6 +12,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -516,7 +523,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/pre-delete-check.js

@@ -11,6 +11,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -515,7 +522,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/quality-event.js

@@ -12,6 +12,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -516,7 +523,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/session-end.js

@@ -12,6 +12,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -516,7 +523,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/session-start.js

@@ -5804,6 +5804,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -6308,7 +6315,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/dist/hooks/user-prompt.js

@@ -12,6 +12,13 @@ import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
+
+// src/lib/memory-path.ts
+function encodeMemoryDirName(projectRoot) {
+  return projectRoot.replace(/\//g, "-");
+}
+
+// src/config.ts
 var DomainConfigSchema = z.object({
   name: z.string().default("Unknown"),
   routers: z.array(z.string()).default([]),
@@ -516,7 +523,7 @@ function getResolvedPaths() {
     plansDir: resolve(root, "docs/plans"),
     docsDir: resolve(root, "docs"),
     claudeDir: resolve(root, claudeDirName),
-    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", encodeMemoryDirName(root), "memory"),
     sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
     sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
     mcpJsonPath: resolve(root, ".mcp.json"),

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@massu/core",
-  "version": "1.9.2",
+  "version": "1.9.5",
   "type": "module",
-  "description": "AI Engineering Governance MCP Server - Session memory, knowledge system, feature registry, code intelligence, rule enforcement, tiered tooling (12 free / 72 total), 55+ workflow commands, 11 agents, 20+ patterns",
+  "description": "AI Engineering Governance MCP Server - Session memory, knowledge system, feature registry, code intelligence, rule enforcement, tiered tooling (12 free / 73 total), 59 workflow commands, 11 agents, 20+ patterns",
   "main": "src/server.ts",
   "exports": {
     ".": "./src/server.ts",

package/src/backfill-sessions.ts

@@ -14,6 +14,7 @@ import { getMemoryDb, createSession, addObservation, addSummary, addUserPrompt,
 import { parseTranscript, extractUserMessages, getLastAssistantMessage } from './transcript-parser.ts';
 import { extractObservationsFromEntries } from './observation-extractor.ts';
 import { getProjectRoot, getConfig } from './config.ts';
+import { encodeMemoryDirName } from './lib/memory-path.ts';
 
 /**
  * Auto-detect the Claude Code project transcript directory.
@@ -23,8 +24,8 @@ function findTranscriptDir(): string {
   const home = process.env.HOME ?? '~';
   const projectRoot = getProjectRoot();
   const claudeDirName = getConfig().conventions?.claudeDirName ?? '.claude';
-  // Claude Code escapes the path by replacing / with -
-  const escapedPath = projectRoot.replace(/\//g, '-');
+  // Claude Code escapes the path by replacing / with -. Shared helper is SoT.
+  const escapedPath = encodeMemoryDirName(projectRoot);
   const candidate = resolve(home, `${claudeDirName}/projects`, escapedPath);
   if (existsSync(candidate)) return candidate;
   // Fallback: scan projects dir for directories matching the project name

package/src/cli.ts

@@ -42,6 +42,16 @@ async function main(): Promise<void> {
       await runInstallHooks();
       break;
     }
+    case 'hook-runner': {
+      // Dynamic hook dispatcher — invoked by Claude Code's hook command lines
+      // (settings.json -> `npx -y @massu/core@<version> hook-runner <name>`).
+      // Closes P-003 by resolving the hook file at fire-time instead of baking
+      // an absolute npx-cache path at install-time.
+      const { runHookRunner } = await import('./commands/hook-runner.ts');
+      const result = await runHookRunner(args.slice(1));
+      process.exit(result.exitCode);
+      return;
+    }
     case 'install-commands': {
       const { runInstallCommands } = await import('./commands/install-commands.ts');
       await runInstallCommands();

package/src/commands/hook-runner.ts

@@ -0,0 +1,145 @@
+// Copyright (c) 2026 Massu. All rights reserved.
+// Licensed under BSL 1.1 - see LICENSE file for details.
+
+/**
+ * `massu hook-runner <hook-name>` — dynamic hook dispatcher.
+ *
+ * Closes the P-003 install-path drift class: previously, `installHooks`
+ * baked an ABSOLUTE path to the installer's `dist/hooks/*.js` location
+ * (whatever npx happened to cache, e.g. `/opt/homebrew/lib/node_modules/...`).
+ * Any cache clear, global-install relocation, or npx upgrade silently 404'd
+ * every hook — customers thought auto-learning was working but nothing fired.
+ *
+ * The fix: settings.json now invokes `npx -y @massu/core@<pinned-version> hook-runner <name>`.
+ * This subcommand resolves the hook script via Node's module resolver at
+ * fire-time, dispatching to the same compiled hook file that ships with
+ * the installer. Customer never sees an absolute path.
+ *
+ * Performance: each hook fire spawns npx + node. Measured ~120-300ms cold
+ * (npx cache hit). Acceptable for hooks not on UI critical path; SessionStart
+ * and PreCompact are infrequent, PostToolUse is per-tool-call.
+ *
+ * Hook name → compiled-file mapping is exhaustive (closed enum) so we fail
+ * loudly on typos rather than silent-no-op. Unknown hook names print a
+ * diagnostic to stderr and exit 2 (distinct from hook's own non-zero exits).
+ */
+
+import { existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { spawn } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * Closed enum of recognized hook names → compiled JS filename under `dist/hooks/`.
+ * Keep in sync with `buildHooksConfig` in `commands/init.ts` and the source
+ * files in `packages/core/src/hooks/`.
+ */
+export const HOOK_NAME_TO_FILE: Record<string, string> = {
+  'session-start': 'session-start.js',
+  'session-end': 'session-end.js',
+  'security-gate': 'security-gate.js',
+  'pre-delete-check': 'pre-delete-check.js',
+  'post-tool-use': 'post-tool-use.js',
+  'post-edit-context': 'post-edit-context.js',
+  'quality-event': 'quality-event.js',
+  'cost-tracker': 'cost-tracker.js',
+  'fix-detector': 'fix-detector.js',
+  'classify-failure': 'classify-failure.js',
+  'incident-pipeline': 'incident-pipeline.js',
+  'rule-enforcement-pipeline': 'rule-enforcement-pipeline.js',
+  'auto-learning-pipeline': 'auto-learning-pipeline.js',
+  'pre-compact': 'pre-compact.js',
+  'user-prompt': 'user-prompt.js',
+  'intent-suggester': 'intent-suggester.js',
+};
+
+/**
+ * Resolve the compiled hook file path for a given hook name.
+ *
+ * Search order (in order of likelihood at runtime):
+ *   1. `./hooks/<file>` — bundled compiled layout: dist/cli.js + dist/hooks/*.js
+ *      (the canonical layout under npx cache + global install).
+ *   2. `../hooks/<file>` — TS-source dev layout: src/commands/hook-runner.ts +
+ *      src/hooks/<file>.ts (used by direct-tsx invocation in tests).
+ *   3. `../../dist/hooks/<file>` — TS-source dev layout fallback after build.
+ *
+ * Hard error on miss — silently swallowing a missing hook is exactly the bug
+ * class P-003 closes.
+ */
+export function resolveHookFile(hookName: string): string {
+  const file = HOOK_NAME_TO_FILE[hookName];
+  if (!file) {
+    throw new Error(
+      `Unknown hook: "${hookName}". Recognized: ${Object.keys(HOOK_NAME_TO_FILE).join(', ')}`,
+    );
+  }
+  const candidates = [
+    // Bundled compiled layout: dist/cli.js → ./hooks/<file>.js
+    resolve(__dirname, 'hooks', file),
+    // TS-source dev / sibling layout: src/commands/ → ../hooks/<file>
+    resolve(__dirname, '../hooks', file),
+    // TS-source dev fallback: src/commands/ → ../../dist/hooks/<file>
+    resolve(__dirname, '../../dist/hooks', file),
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Hook file not found for "${hookName}". Searched: ${candidates.join(', ')}. ` +
+      'This indicates a broken @massu/core install. Re-run `npx -y @massu/core init`.',
+  );
+}
+
+/**
+ * Subcommand entrypoint. Spawns `node <resolved-hook-file>` as a child
+ * with stdin/stdout/stderr piped through, so the hook receives the same
+ * JSON-on-stdin contract Claude Code expects, and stdout/stderr surface
+ * to Claude Code unchanged.
+ *
+ * Returns the child's exit code (or 2 on resolution error before spawn).
+ */
+export async function runHookRunner(args: string[]): Promise<{ exitCode: number }> {
+  const hookName = args[0];
+  if (!hookName) {
+    process.stderr.write(
+      'massu hook-runner: missing hook name.\n' +
+        'Usage: massu hook-runner <hook-name>\n' +
+        `Recognized: ${Object.keys(HOOK_NAME_TO_FILE).join(', ')}\n`,
+    );
+    return { exitCode: 2 };
+  }
+
+  let hookFile: string;
+  try {
+    hookFile = resolveHookFile(hookName);
+  } catch (err) {
+    process.stderr.write(`massu hook-runner: ${err instanceof Error ? err.message : String(err)}\n`);
+    return { exitCode: 2 };
+  }
+
+  return new Promise((resolvePromise) => {
+    const child = spawn(process.execPath, [hookFile], {
+      stdio: ['inherit', 'inherit', 'inherit'],
+      env: process.env,
+    });
+    child.on('exit', (code, signal) => {
+      if (signal) {
+        // Mirror typical shell convention: 128 + signal number; signals are not
+        // easily mapped to numbers here without an explicit table, so we just
+        // report 128 as a sentinel "killed by signal".
+        resolvePromise({ exitCode: 128 });
+        return;
+      }
+      resolvePromise({ exitCode: code ?? 0 });
+    });
+    child.on('error', (err) => {
+      process.stderr.write(`massu hook-runner: failed to spawn hook "${hookName}": ${err.message}\n`);
+      resolvePromise({ exitCode: 2 });
+    });
+  });
+}