contextspin 0.6.3 → 0.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contextspin",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Replace Claude Code spinner/statusline text with live org context (meetings, Slack, CI, incidents, PRs) aggregated from your existing MCP servers, CLIs, and HTTP endpoints.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -30,6 +30,7 @@ import {
   uninstallStatusline,
   uninstallAllStatuslines,
 } from './inject/statusline.js';
+import { addSessionStartHook, removeSessionStartHook } from './inject/hook.js';
 import { installPatcher, restorePatcher } from './inject/patcher.js';
 import { detectSources } from './detect.js';
 
@@ -476,106 +477,6 @@ async function runUninject(opts = {}) {
   }
 }
 
-/**
- * The SessionStart hook command the `install` flow wires into the user settings
- * so ContextSpin self-heals every session (the curl install replicates what the
- * Claude Code plugin's hook does, without the marketplace).
- *
- * The hook is pinned to the EXACT version doing the install (never `@latest` or a
- * range), so a future release never runs on the user's machine without them
- * deliberately re-installing. Runs from a neutral dir so npx never resolves a
- * confused local package (Exit 127).
- * @returns {string}
- */
-function sessionStartHookCmd() {
-  return `cd /tmp && npx --yes contextspin@${readVersion()} ensure >/dev/null 2>&1; exit 0`;
-}
-
-/**
- * Read+parse a JSON file, returning a fallback on any read/parse error.
- * @param {string} filePath
- * @param {*} fallback
- * @returns {*}
- */
-function readJsonSafeSync(filePath, fallback) {
-  try {
-    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-  } catch {
-    return fallback;
-  }
-}
-
-/**
- * Whether a SessionStart entry already runs ContextSpin (so install is idempotent).
- * @param {*} entry
- * @returns {boolean}
- */
-function entryRunsContextspin(entry) {
-  return !!(
-    entry &&
-    Array.isArray(entry.hooks) &&
-    entry.hooks.some(
-      (h) => h && typeof h.command === 'string' && h.command.includes('contextspin'),
-    )
-  );
-}
-
-/**
- * Wire a ContextSpin SessionStart hook into the user ~/.claude/settings.json so
- * the daemon + statusline self-heal every session. JSON-merge (preserves every
- * other key and any existing hooks). Idempotent.
- * @returns {boolean} true if the hook was added (false if already present).
- */
-function addSessionStartHook() {
-  fs.mkdirSync(path.dirname(CLAUDE_SETTINGS_PATH), { recursive: true });
-  const settings = readJsonSafeSync(CLAUDE_SETTINGS_PATH, {});
-  const obj = settings && typeof settings === 'object' ? settings : {};
-  obj.hooks = obj.hooks && typeof obj.hooks === 'object' ? obj.hooks : {};
-  const arr = Array.isArray(obj.hooks.SessionStart) ? obj.hooks.SessionStart : [];
-
-  const desired = sessionStartHookCmd();
-  const existing = arr.find(entryRunsContextspin);
-  const alreadyCurrent =
-    existing &&
-    Array.isArray(existing.hooks) &&
-    existing.hooks.some((h) => h && h.command === desired);
-  // Already exactly this command (same pinned version) — nothing to do.
-  if (alreadyCurrent) return false;
-
-  // Upsert: drop any prior ContextSpin entry (e.g. an older pinned version) and
-  // add the current one, so re-installing a newer version re-pins cleanly.
-  const others = arr.filter((e) => !entryRunsContextspin(e));
-  others.push({
-    matcher: '',
-    hooks: [{ type: 'command', command: desired, timeout: 15 }],
-  });
-  obj.hooks.SessionStart = others;
-  fs.writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(obj, null, 2));
-  return true;
-}
-
-/**
- * Remove any ContextSpin SessionStart hook from the user settings (best-effort,
- * JSON-merge). Prunes empty containers.
- * @returns {boolean} true if a hook was removed.
- */
-function removeSessionStartHook() {
-  const settings = readJsonSafeSync(CLAUDE_SETTINGS_PATH, null);
-  if (!settings || typeof settings !== 'object' || !settings.hooks) return false;
-  const arr = Array.isArray(settings.hooks.SessionStart)
-    ? settings.hooks.SessionStart
-    : [];
-  const kept = arr.filter((e) => !entryRunsContextspin(e));
-  if (kept.length === arr.length) return false;
-  if (kept.length > 0) settings.hooks.SessionStart = kept;
-  else delete settings.hooks.SessionStart;
-  if (settings.hooks && Object.keys(settings.hooks).length === 0) {
-    delete settings.hooks;
-  }
-  fs.writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2));
-  return true;
-}
-
 /**
  * One-shot install (the `curl | bash` entrypoint): wire the SessionStart hook so
  * ContextSpin self-heals each session, then run ensure (config + statusline +
@@ -583,7 +484,7 @@ function removeSessionStartHook() {
  * @returns {Promise<void>}
  */
 async function runInstall() {
-  const addedHook = addSessionStartHook();
+  const addedHook = addSessionStartHook(readVersion());
   await runEnsure();
   console.log('');
   console.log(

package/src/config.js

@@ -34,8 +34,14 @@ export const LOG_PATH = path.join(STATE_DIR, "daemon.log");
 /** Path to the generated statusline bash wrapper. */
 export const STATUSLINE_SH = path.join(STATE_DIR, "statusline.sh");
 
-/** Path to the generated statusline Node render script. */
-export const STATUSLINE_JS = path.join(STATE_DIR, "statusline-render.js");
+/**
+ * Path to the generated statusline Node render script. Uses the `.mjs` extension
+ * so Node treats it as ESM regardless of version — the script lives in STATE_DIR
+ * (no package.json), and Node 18 has no automatic ESM detection, so a plain
+ * `.js` would fail to parse its `import` statements ("Cannot use import statement
+ * outside a module").
+ */
+export const STATUSLINE_JS = path.join(STATE_DIR, "statusline-render.mjs");
 
 /**
  * Path to the recorded prior statusLine commands (captured when we wrap an

package/src/inject/hook.js

@@ -0,0 +1,105 @@
+// src/inject/hook.js — manage ContextSpin's SessionStart hook in the user
+// ~/.claude/settings.json. Used by `contextspin install` / `uninstall` (the curl
+// flow) so ContextSpin self-heals every session without the plugin/marketplace.
+
+import fs from "node:fs";
+import path from "node:path";
+import { CLAUDE_SETTINGS_PATH } from "../config.js";
+
+/**
+ * Read+parse a JSON file, returning a fallback on any read/parse error.
+ * @param {string} filePath
+ * @param {*} fallback
+ * @returns {*}
+ */
+function readJsonSafeSync(filePath, fallback) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch {
+    return fallback;
+  }
+}
+
+/**
+ * Build the SessionStart hook command, pinned to an EXACT version (never
+ * `@latest` or a range) so a future release never runs without a deliberate
+ * re-install. Runs from a neutral dir so npx can't resolve a confused local
+ * package (Exit 127).
+ * @param {string} version - The exact package version to pin (e.g. "0.6.3").
+ * @returns {string}
+ */
+export function sessionStartHookCmd(version) {
+  return `cd /tmp && npx --yes contextspin@${version} ensure >/dev/null 2>&1; exit 0`;
+}
+
+/**
+ * Whether a SessionStart entry already runs ContextSpin (any version).
+ * @param {*} entry
+ * @returns {boolean}
+ */
+export function entryRunsContextspin(entry) {
+  return !!(
+    entry &&
+    Array.isArray(entry.hooks) &&
+    entry.hooks.some(
+      (h) => h && typeof h.command === "string" && h.command.includes("contextspin"),
+    )
+  );
+}
+
+/**
+ * Upsert the ContextSpin SessionStart hook into the user settings, pinned to
+ * `version`. JSON-merge (preserves every other key and any non-ours hooks).
+ * Drops any prior ContextSpin entry (e.g. an older pinned version) so
+ * re-installing a newer version re-pins cleanly. Idempotent when already current.
+ * @param {string} version
+ * @param {string} [settingsPath=CLAUDE_SETTINGS_PATH]
+ * @returns {boolean} true if the file was changed (added or re-pinned).
+ */
+export function addSessionStartHook(version, settingsPath = CLAUDE_SETTINGS_PATH) {
+  fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
+  const settings = readJsonSafeSync(settingsPath, {});
+  const obj = settings && typeof settings === "object" ? settings : {};
+  obj.hooks = obj.hooks && typeof obj.hooks === "object" ? obj.hooks : {};
+  const arr = Array.isArray(obj.hooks.SessionStart) ? obj.hooks.SessionStart : [];
+
+  const desired = sessionStartHookCmd(version);
+  const existing = arr.find(entryRunsContextspin);
+  const alreadyCurrent =
+    existing &&
+    Array.isArray(existing.hooks) &&
+    existing.hooks.some((h) => h && h.command === desired);
+  if (alreadyCurrent) return false;
+
+  const others = arr.filter((e) => !entryRunsContextspin(e));
+  others.push({
+    matcher: "",
+    hooks: [{ type: "command", command: desired, timeout: 15 }],
+  });
+  obj.hooks.SessionStart = others;
+  fs.writeFileSync(settingsPath, JSON.stringify(obj, null, 2));
+  return true;
+}
+
+/**
+ * Remove any ContextSpin SessionStart hook from the user settings (JSON-merge,
+ * best-effort). Prunes empty containers.
+ * @param {string} [settingsPath=CLAUDE_SETTINGS_PATH]
+ * @returns {boolean} true if a hook was removed.
+ */
+export function removeSessionStartHook(settingsPath = CLAUDE_SETTINGS_PATH) {
+  const settings = readJsonSafeSync(settingsPath, null);
+  if (!settings || typeof settings !== "object" || !settings.hooks) return false;
+  const arr = Array.isArray(settings.hooks.SessionStart)
+    ? settings.hooks.SessionStart
+    : [];
+  const kept = arr.filter((e) => !entryRunsContextspin(e));
+  if (kept.length === arr.length) return false;
+  if (kept.length > 0) settings.hooks.SessionStart = kept;
+  else delete settings.hooks.SessionStart;
+  if (settings.hooks && Object.keys(settings.hooks).length === 0) {
+    delete settings.hooks;
+  }
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+  return true;
+}