squish-memory 1.0.1 → 1.1.5

package/scripts/generate-mcp.mjs

@@ -1,264 +1,264 @@
-#!/usr/bin/env node
-
-import fs from "node:fs";
-import path from "node:path";
-import crypto from "node:crypto";
-
-const root = process.cwd();
-const defaultSourcePath = path.join(root, "config", "mcp.json");
-const defaultOutDir = path.join(root, "generated", "mcp");
-const defaultImports = [
-  "cursor",
-  "claude-code",
-  "claude-desktop",
-  "codex",
-  "windsurf",
-  "opencode",
-  "vscode"
-];
-
-function parseArgs(argv) {
-  const args = {
-    configPath: defaultSourcePath,
-    outDir: defaultOutDir,
-    strictEnv: false
-  };
-
-  for (let i = 2; i < argv.length; i += 1) {
-    const token = argv[i];
-    if (token === "--strict-env") {
-      args.strictEnv = true;
-      continue;
-    }
-    if (token === "--config") {
-      args.configPath = path.resolve(argv[i + 1]);
-      i += 1;
-      continue;
-    }
-    if (token === "--out") {
-      args.outDir = path.resolve(argv[i + 1]);
-      i += 1;
-      continue;
-    }
-    throw new Error(`Unknown argument: ${token}`);
-  }
-
-  return args;
-}
-
-function readJson(filePath) {
-  return JSON.parse(fs.readFileSync(filePath, "utf8"));
-}
-
-function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
-
-function writeJson(filePath, data) {
-  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
-}
-
-function sha256File(filePath) {
-  const hash = crypto.createHash("sha256");
-  hash.update(fs.readFileSync(filePath));
-  return hash.digest("hex");
-}
-
-function sortObjectKeys(input) {
-  if (Array.isArray(input)) {
-    return input.map(sortObjectKeys);
-  }
-  if (input && typeof input === "object") {
-    const sorted = {};
-    for (const key of Object.keys(input).sort()) {
-      sorted[key] = sortObjectKeys(input[key]);
-    }
-    return sorted;
-  }
-  return input;
-}
-
-function extractEnvPlaceholders(servers) {
-  const placeholders = [];
-  for (const [serverName, server] of Object.entries(servers)) {
-    const env = server?.env || {};
-    for (const [envKey, value] of Object.entries(env)) {
-      if (typeof value !== "string") continue;
-      const match = value.match(/^\$\{([A-Z0-9_]+)\}$/);
-      if (match) {
-        placeholders.push({ serverName, envKey, variable: match[1] });
-      }
-    }
-  }
-  return placeholders;
-}
-
-function validateConfig(config, strictEnv) {
-  if (!config || typeof config !== "object") {
-    throw new Error("Invalid config: expected object");
-  }
-
-  if (!config.defaults || typeof config.defaults !== "object") {
-    throw new Error("Invalid config: defaults must be an object");
-  }
-
-  if (!config.servers || typeof config.servers !== "object") {
-    throw new Error("Invalid config: servers must be an object");
-  }
-
-  const serverNames = Object.keys(config.servers);
-  if (serverNames.length === 0) {
-    throw new Error("Invalid config: at least one server is required");
-  }
-
-  for (const [serverName, server] of Object.entries(config.servers)) {
-    if (!server || typeof server !== "object") {
-      throw new Error(`Invalid server ${serverName}: expected object`);
-    }
-    if (!server.command || typeof server.command !== "string") {
-      throw new Error(`Invalid server ${serverName}: command is required`);
-    }
-    if (!Array.isArray(server.args)) {
-      throw new Error(`Invalid server ${serverName}: args must be an array`);
-    }
-    if (!server.transport || typeof server.transport !== "string") {
-      throw new Error(`Invalid server ${serverName}: transport is required`);
-    }
-    if (!server.env || typeof server.env !== "object") {
-      throw new Error(`Invalid server ${serverName}: env must be an object`);
-    }
-  }
-
-  const includeServers = config.includeServers || [];
-  if (includeServers.length > 0) {
-    const unique = new Set(includeServers);
-    if (unique.size !== includeServers.length) {
-      throw new Error("Invalid config: includeServers contains duplicates");
-    }
-    for (const name of includeServers) {
-      if (!config.servers[name]) {
-        throw new Error(`Invalid config: includeServers references unknown server ${name}`);
-      }
-    }
-  }
-
-  if (strictEnv) {
-    const unresolved = extractEnvPlaceholders(config.servers)
-      .filter((entry) => !process.env[entry.variable]);
-    if (unresolved.length > 0) {
-      const first = unresolved[0];
-      throw new Error(
-        `Missing required env for strict mode: ${first.variable} (server=${first.serverName}, key=${first.envKey})`
-      );
-    }
-  }
-}
-
-function selectServers(config) {
-  const include = config.includeServers || [];
-  if (include.length === 0) {
-    return config.servers;
-  }
-  const selected = {};
-  for (const serverName of include) {
-    selected[serverName] = config.servers[serverName];
-  }
-  return selected;
-}
-
-function toOpenClawMemoryConfig(runtime) {
-  return {
-    memory: {
-      backend: "qmd",
-      qmd: {
-        mcporter: {
-          enabled: true,
-          serverName: "qmd",
-          startDaemon: true
-        },
-        limits: {
-          timeoutMs: runtime.requestTimeoutMs,
-          maxSnippetChars: runtime.resultMaxChars,
-          maxResults: 12
-        }
-      }
-    }
-  };
-}
-
-function toMcporterConfig(servers) {
-  return {
-    mcpServers: servers,
-    imports: defaultImports
-  };
-}
-
-function removeLegacyProfileDirectories(outDir) {
-  const removed = [];
-  if (!fs.existsSync(outDir)) return;
-  const entries = fs.readdirSync(outDir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (entry.isDirectory()) {
-      fs.rmSync(path.join(outDir, entry.name), { recursive: true, force: true });
-      removed.push(entry.name);
-    }
-  }
-  return removed;
-}
-
-function main() {
-  const args = parseArgs(process.argv);
-  const config = readJson(args.configPath);
-
-  validateConfig(config, args.strictEnv);
-
-  ensureDir(args.outDir);
-  const removedLegacyDirs = removeLegacyProfileDirectories(args.outDir) || [];
-
-  if (config.profiles && typeof config.profiles === "object") {
-    console.warn(
-      "[mcp-migration] legacy profiles detected in config/mcp.json and ignored by universal generator"
-    );
-  }
-  if (removedLegacyDirs.length > 0) {
-    console.warn(
-      `[mcp-migration] removed legacy profile output directories: ${removedLegacyDirs.join(", ")}`
-    );
-  }
-
-  const runtime = sortObjectKeys(config.defaults);
-  const selectedServers = sortObjectKeys(selectServers(config));
-
-  const fileMap = {
-    "runtime.json": runtime,
-    "mcp-servers.json": { mcpServers: selectedServers },
-    "mcporter.json": toMcporterConfig(selectedServers),
-    "openclaw-memory-qmd.json": toOpenClawMemoryConfig(runtime)
-  };
-
-  for (const [fileName, json] of Object.entries(fileMap)) {
-    writeJson(path.join(args.outDir, fileName), json);
-  }
-
-  const manifestFiles = Object.keys(fileMap)
-    .sort()
-    .map((fileName) => {
-      const filePath = path.join(args.outDir, fileName);
-      return {
-        file: fileName,
-        sha256: sha256File(filePath)
-      };
-    });
-
-  const manifest = {
-    mode: "universal",
-    generatedAt: new Date().toISOString(),
-    source: path.relative(root, args.configPath).replace(/\\/g, "/"),
-    files: manifestFiles
-  };
-
-  writeJson(path.join(args.outDir, "manifest.json"), manifest);
-  console.log(`Generated universal MCP artifacts in ${args.outDir}`);
-}
-
-main();
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+
+const root = process.cwd();
+const defaultSourcePath = path.join(root, "config", "mcp.json");
+const defaultOutDir = path.join(root, "generated", "mcp");
+const defaultImports = [
+  "cursor",
+  "claude-code",
+  "claude-desktop",
+  "codex",
+  "windsurf",
+  "opencode",
+  "vscode"
+];
+
+function parseArgs(argv) {
+  const args = {
+    configPath: defaultSourcePath,
+    outDir: defaultOutDir,
+    strictEnv: false
+  };
+
+  for (let i = 2; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (token === "--strict-env") {
+      args.strictEnv = true;
+      continue;
+    }
+    if (token === "--config") {
+      args.configPath = path.resolve(argv[i + 1]);
+      i += 1;
+      continue;
+    }
+    if (token === "--out") {
+      args.outDir = path.resolve(argv[i + 1]);
+      i += 1;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${token}`);
+  }
+
+  return args;
+}
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function writeJson(filePath, data) {
+  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+}
+
+function sha256File(filePath) {
+  const hash = crypto.createHash("sha256");
+  hash.update(fs.readFileSync(filePath));
+  return hash.digest("hex");
+}
+
+function sortObjectKeys(input) {
+  if (Array.isArray(input)) {
+    return input.map(sortObjectKeys);
+  }
+  if (input && typeof input === "object") {
+    const sorted = {};
+    for (const key of Object.keys(input).sort()) {
+      sorted[key] = sortObjectKeys(input[key]);
+    }
+    return sorted;
+  }
+  return input;
+}
+
+function extractEnvPlaceholders(servers) {
+  const placeholders = [];
+  for (const [serverName, server] of Object.entries(servers)) {
+    const env = server?.env || {};
+    for (const [envKey, value] of Object.entries(env)) {
+      if (typeof value !== "string") continue;
+      const match = value.match(/^\$\{([A-Z0-9_]+)\}$/);
+      if (match) {
+        placeholders.push({ serverName, envKey, variable: match[1] });
+      }
+    }
+  }
+  return placeholders;
+}
+
+function validateConfig(config, strictEnv) {
+  if (!config || typeof config !== "object") {
+    throw new Error("Invalid config: expected object");
+  }
+
+  if (!config.defaults || typeof config.defaults !== "object") {
+    throw new Error("Invalid config: defaults must be an object");
+  }
+
+  if (!config.servers || typeof config.servers !== "object") {
+    throw new Error("Invalid config: servers must be an object");
+  }
+
+  const serverNames = Object.keys(config.servers);
+  if (serverNames.length === 0) {
+    throw new Error("Invalid config: at least one server is required");
+  }
+
+  for (const [serverName, server] of Object.entries(config.servers)) {
+    if (!server || typeof server !== "object") {
+      throw new Error(`Invalid server ${serverName}: expected object`);
+    }
+    if (!server.command || typeof server.command !== "string") {
+      throw new Error(`Invalid server ${serverName}: command is required`);
+    }
+    if (!Array.isArray(server.args)) {
+      throw new Error(`Invalid server ${serverName}: args must be an array`);
+    }
+    if (!server.transport || typeof server.transport !== "string") {
+      throw new Error(`Invalid server ${serverName}: transport is required`);
+    }
+    if (!server.env || typeof server.env !== "object") {
+      throw new Error(`Invalid server ${serverName}: env must be an object`);
+    }
+  }
+
+  const includeServers = config.includeServers || [];
+  if (includeServers.length > 0) {
+    const unique = new Set(includeServers);
+    if (unique.size !== includeServers.length) {
+      throw new Error("Invalid config: includeServers contains duplicates");
+    }
+    for (const name of includeServers) {
+      if (!config.servers[name]) {
+        throw new Error(`Invalid config: includeServers references unknown server ${name}`);
+      }
+    }
+  }
+
+  if (strictEnv) {
+    const unresolved = extractEnvPlaceholders(config.servers)
+      .filter((entry) => !process.env[entry.variable]);
+    if (unresolved.length > 0) {
+      const first = unresolved[0];
+      throw new Error(
+        `Missing required env for strict mode: ${first.variable} (server=${first.serverName}, key=${first.envKey})`
+      );
+    }
+  }
+}
+
+function selectServers(config) {
+  const include = config.includeServers || [];
+  if (include.length === 0) {
+    return config.servers;
+  }
+  const selected = {};
+  for (const serverName of include) {
+    selected[serverName] = config.servers[serverName];
+  }
+  return selected;
+}
+
+function toOpenClawMemoryConfig(runtime) {
+  return {
+    memory: {
+      backend: "qmd",
+      qmd: {
+        mcporter: {
+          enabled: true,
+          serverName: "qmd",
+          startDaemon: true
+        },
+        limits: {
+          timeoutMs: runtime.requestTimeoutMs,
+          maxSnippetChars: runtime.resultMaxChars,
+          maxResults: 12
+        }
+      }
+    }
+  };
+}
+
+function toMcporterConfig(servers) {
+  return {
+    mcpServers: servers,
+    imports: defaultImports
+  };
+}
+
+function removeLegacyProfileDirectories(outDir) {
+  const removed = [];
+  if (!fs.existsSync(outDir)) return;
+  const entries = fs.readdirSync(outDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      fs.rmSync(path.join(outDir, entry.name), { recursive: true, force: true });
+      removed.push(entry.name);
+    }
+  }
+  return removed;
+}
+
+function main() {
+  const args = parseArgs(process.argv);
+  const config = readJson(args.configPath);
+
+  validateConfig(config, args.strictEnv);
+
+  ensureDir(args.outDir);
+  const removedLegacyDirs = removeLegacyProfileDirectories(args.outDir) || [];
+
+  if (config.profiles && typeof config.profiles === "object") {
+    console.warn(
+      "[mcp-migration] legacy profiles detected in config/mcp.json and ignored by universal generator"
+    );
+  }
+  if (removedLegacyDirs.length > 0) {
+    console.warn(
+      `[mcp-migration] removed legacy profile output directories: ${removedLegacyDirs.join(", ")}`
+    );
+  }
+
+  const runtime = sortObjectKeys(config.defaults);
+  const selectedServers = sortObjectKeys(selectServers(config));
+
+  const fileMap = {
+    "runtime.json": runtime,
+    "mcp-servers.json": { mcpServers: selectedServers },
+    "mcporter.json": toMcporterConfig(selectedServers),
+    "openclaw-memory-qmd.json": toOpenClawMemoryConfig(runtime)
+  };
+
+  for (const [fileName, json] of Object.entries(fileMap)) {
+    writeJson(path.join(args.outDir, fileName), json);
+  }
+
+  const manifestFiles = Object.keys(fileMap)
+    .sort()
+    .map((fileName) => {
+      const filePath = path.join(args.outDir, fileName);
+      return {
+        file: fileName,
+        sha256: sha256File(filePath)
+      };
+    });
+
+  const manifest = {
+    mode: "universal",
+    generatedAt: new Date().toISOString(),
+    source: path.relative(root, args.configPath).replace(/\\/g, "/"),
+    files: manifestFiles
+  };
+
+  writeJson(path.join(args.outDir, "manifest.json"), manifest);
+  console.log(`Generated universal MCP artifacts in ${args.outDir}`);
+}
+
+main();

package/scripts/github-release.sh

@@ -19,22 +19,22 @@ cd release-assets
 # Linux x64
 echo "Building linux-x64..."
 npx pkg ../dist/index.js --targets node18-linux-x64 --output squish-linux-x64
-tar -czf "../squish-v${VERSION}-linux-x64.tar.gz" squish-linux-x64 ../dist/ ../plugin.json ../README.md ../LICENSE
+tar -czf "../squish-v${VERSION}-linux-x64.tar.gz" squish-linux-x64 ../dist/ ../config/plugin.json ../README.md ../LICENSE
 
 # Linux ARM64
 echo "Building linux-arm64..."
 npx pkg ../dist/index.js --targets node18-linux-arm64 --output squish-linux-arm64
-tar -czf "../squish-v${VERSION}-linux-arm64.tar.gz" squish-linux-arm64 ../dist/ ../plugin.json ../README.md ../LICENSE
+tar -czf "../squish-v${VERSION}-linux-arm64.tar.gz" squish-linux-arm64 ../dist/ ../config/plugin.json ../README.md ../LICENSE
 
 # macOS ARM64 (Apple Silicon)
 echo "Building macos-arm64..."
 npx pkg ../dist/index.js --targets node18-macos-arm64 --output squish-macos-arm64
-tar -czf "../squish-v${VERSION}-macos-arm64.tar.gz" squish-macos-arm64 ../dist/ ../plugin.json ../README.md ../LICENSE
+tar -czf "../squish-v${VERSION}-macos-arm64.tar.gz" squish-macos-arm64 ../dist/ ../config/plugin.json ../README.md ../LICENSE
 
 # Windows x64
 echo "Building windows-x64..."
 npx pkg ../dist/index.js --targets node18-win-x64 --output squish-windows-x64.exe
-zip "../squish-v${VERSION}-windows-x64.zip" squish-windows-x64.exe ../dist/ ../plugin.json ../README.md ../LICENSE
+zip "../squish-v${VERSION}-windows-x64.zip" squish-windows-x64.exe ../dist/ ../config/plugin.json ../README.md ../LICENSE
 
 cd ..
 rm -rf release-assets

package/scripts/install-claude-code.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+# Install Squish hooks for Claude Code
+# Run from the squish project directory
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SQUISH_DIR="${SQUISH_DIR:-$HOME/.squish}"
+HOOKS_CONFIG="$SCRIPT_DIR/config/hooks/claude-code-hooks.json"
+
+echo "Installing Squish hooks for Claude Code..."
+
+# Create Squish config directory
+mkdir -p "$SQUISH_DIR"
+
+# Copy hook config
+if [ -f "$HOOKS_CONFIG" ]; then
+    cp "$HOOKS_CONFIG" "$SQUISH_DIR/hooks-claude-code.json"
+    echo "Copied hook config to $SQUISH_DIR/hooks-claude-code.json"
+else
+    echo "ERROR: Hook config not found at $HOOKS_CONFIG"
+    exit 1
+fi
+
+# Create hooks directory
+mkdir -p "$SQUISH_DIR/hooks"
+
+# Check for Claude Code settings file
+SETTINGS_FILE="$HOME/.claude/settings.json"
+HOOKS_DIR="$HOME/.claude/hooks/squish"
+
+if [ -f "$SETTINGS_FILE" ]; then
+    echo ""
+    echo "Found Claude Code settings at $SETTINGS_FILE"
+    echo ""
+    echo "To enable hooks, add this to your settings.json:"
+    echo ""
+    cat << 'SETTINGS_JSON'
+{
+  "hooks": {
+    "SessionStart": [
+      { "matcher": "startup", "hooks": [{ "type": "command", "command": "squish", "args": ["hooks", "session-start", "--agent", "claude-code", "--mode", "startup"], "matcher": "startup" }] },
+      { "matcher": "resume", "hooks": [{ "type": "command", "command": "squish", "args": ["hooks", "session-start", "--agent", "claude-code", "--mode", "resume"], "matcher": "resume" }] },
+      { "matcher": "compact", "hooks": [{ "type": "command", "command": "squish", "args": ["hooks", "session-start", "--agent", "claude-code", "--mode", "compact"], "matcher": "compact" }] }
+    ],
+    "PostToolUse": [
+      { "hooks": [{ "type": "command", "command": "squish", "args": ["hooks", "post-tool-use", "--agent", "claude-code"], "timeout": 5 }] }
+    ],
+    "SessionEnd": [
+      { "hooks": [{ "type": "command", "command": "squish", "args": ["hooks", "session-end", "--agent", "claude-code"], "timeout": 10 }] }
+    ],
+    "PreCompact": [
+      { "matcher": "auto", "hooks": [{ "type": "command", "command": "squish", "args": ["hooks", "pre-compact", "--agent", "claude-code"], "matcher": "auto" }] }
+    ]
+  }
+}
+SETTINGS_JSON
+
+    echo ""
+    echo "OR use the simplified approach - add MCP servers for memory:"
+    echo ""
+    cat << 'MCP_CONFIG'
+{
+  "mcpServers": {
+    "squish-memory": {
+      "command": "squish",
+      "args": ["run", "mcp"]
+    }
+  }
+}
+MCP_CONFIG
+else
+    echo ""
+    echo "WARNING: Claude Code settings file not found at $SETTINGS_FILE"
+    echo "Install Claude Code first, then rerun this script"
+fi
+
+echo ""
+echo "Installation complete!"
+echo ""
+echo "Next steps:"
+echo "1. Add MCP server config to your .claude.json or settings.json"
+echo "2. Restart Claude Code"
+echo "3. Run 'squish health' to verify"
+echo ""