@ghl-ai/aw 0.1.35-beta.1 → 0.1.35-beta.2

package/ide-hooks.mjs

@@ -0,0 +1,193 @@
+// ide-hooks.mjs — Generate IDE session-start hooks for superpowers bootstrap.
+//
+// installIdeHooks(cwd) → writes/merges hook configs into ~/.claude/ and ~/.cursor/
+// removeIdeHooks(cwd)  → removes aw-generated hook entries from IDE hook configs
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import * as fmt from './fmt.mjs';
+
+const HOME = homedir();
+const AW_REGISTRY = join(HOME, '.aw_registry');
+const HOOKS_DIR = join(AW_REGISTRY, 'platform', 'superpowers', 'hooks');
+const SESSION_START = join(HOOKS_DIR, 'session-start');
+const RUN_HOOK_CMD = join(HOOKS_DIR, 'run-hook.cmd');
+
+const AW_MARKER = 'aw-superpowers-session';
+
+/**
+ * Install IDE session-start hooks that bootstrap using-superpowers.
+ * Only installs if the superpowers hooks exist in the registry.
+ * Merges with existing hook configs — never clobbers user hooks.
+ * @returns {string[]} paths of created/modified hook config files
+ */
+export function installIdeHooks(cwd) {
+  if (!existsSync(SESSION_START)) return [];
+
+  const created = [];
+
+  const claudeResult = installClaudeCodeHooks(cwd);
+  if (claudeResult) created.push(claudeResult);
+
+  const cursorResult = installCursorHooks(cwd);
+  if (cursorResult) created.push(cursorResult);
+
+  if (created.length > 0) {
+    fmt.logStep('IDE session hooks installed (superpowers bootstrap)');
+  }
+
+  return created;
+}
+
+/**
+ * Remove aw-generated hook entries from IDE hook configs.
+ */
+export function removeIdeHooks(cwd) {
+  removeClaudeCodeHooks(cwd);
+  removeCursorHooks(cwd);
+  fmt.logStep('IDE session hooks removed');
+}
+
+// ── Claude Code ─────────────────────────────────────────────────────────
+
+function installClaudeCodeHooks(cwd) {
+  const hooksPath = join(HOME, '.claude', 'hooks.json');
+
+  const hookEntry = {
+    matcher: AW_MARKER,
+    hooks: [{
+      type: 'command',
+      command: `"${RUN_HOOK_CMD}" session-start`,
+      async: false,
+    }],
+  };
+
+  let config;
+  if (existsSync(hooksPath)) {
+    try {
+      config = JSON.parse(readFileSync(hooksPath, 'utf8'));
+    } catch {
+      return null;
+    }
+
+    if (!config.hooks) config.hooks = {};
+    if (!Array.isArray(config.hooks.SessionStart)) config.hooks.SessionStart = [];
+
+    const existing = config.hooks.SessionStart.findIndex(
+      e => e.matcher === AW_MARKER
+    );
+    if (existing !== -1) {
+      config.hooks.SessionStart[existing] = hookEntry;
+    } else {
+      config.hooks.SessionStart.push(hookEntry);
+    }
+  } else {
+    mkdirSync(join(HOME, '.claude'), { recursive: true });
+    config = {
+      hooks: {
+        SessionStart: [hookEntry],
+      },
+    };
+  }
+
+  writeFileSync(hooksPath, JSON.stringify(config, null, 2) + '\n');
+  return hooksPath;
+}
+
+function removeClaudeCodeHooks(cwd) {
+  const hooksPath = join(HOME, '.claude', 'hooks.json');
+  if (!existsSync(hooksPath)) return;
+
+  try {
+    const config = JSON.parse(readFileSync(hooksPath, 'utf8'));
+    if (!config.hooks?.SessionStart) return;
+
+    config.hooks.SessionStart = config.hooks.SessionStart.filter(
+      e => e.matcher !== AW_MARKER
+    );
+
+    if (config.hooks.SessionStart.length === 0) {
+      delete config.hooks.SessionStart;
+    }
+    if (Object.keys(config.hooks).length === 0) {
+      delete config.hooks;
+    }
+
+    if (Object.keys(config).length === 0) {
+      writeFileSync(hooksPath, '{}\n');
+    } else {
+      writeFileSync(hooksPath, JSON.stringify(config, null, 2) + '\n');
+    }
+  } catch { /* best effort */ }
+}
+
+// ── Cursor ──────────────────────────────────────────────────────────────
+
+function installCursorHooks(cwd) {
+  const hooksPath = join(HOME, '.cursor', 'hooks.json');
+
+  const hookEntry = {
+    command: SESSION_START,
+    _aw: AW_MARKER,
+  };
+
+  let config;
+  if (existsSync(hooksPath)) {
+    try {
+      config = JSON.parse(readFileSync(hooksPath, 'utf8'));
+    } catch {
+      return null;
+    }
+
+    if (!config.hooks) config.hooks = {};
+    if (!Array.isArray(config.hooks.sessionStart)) config.hooks.sessionStart = [];
+
+    const existing = config.hooks.sessionStart.findIndex(
+      e => e._aw === AW_MARKER
+    );
+    if (existing !== -1) {
+      config.hooks.sessionStart[existing] = hookEntry;
+    } else {
+      config.hooks.sessionStart.push(hookEntry);
+    }
+  } else {
+    mkdirSync(join(HOME, '.cursor'), { recursive: true });
+    config = {
+      version: 1,
+      hooks: {
+        sessionStart: [hookEntry],
+      },
+    };
+  }
+
+  writeFileSync(hooksPath, JSON.stringify(config, null, 2) + '\n');
+  return hooksPath;
+}
+
+function removeCursorHooks(cwd) {
+  const hooksPath = join(HOME, '.cursor', 'hooks.json');
+  if (!existsSync(hooksPath)) return;
+
+  try {
+    const config = JSON.parse(readFileSync(hooksPath, 'utf8'));
+    if (!config.hooks?.sessionStart) return;
+
+    config.hooks.sessionStart = config.hooks.sessionStart.filter(
+      e => e._aw !== AW_MARKER
+    );
+
+    if (config.hooks.sessionStart.length === 0) {
+      delete config.hooks.sessionStart;
+    }
+    if (config.hooks && Object.keys(config.hooks).length === 0) {
+      delete config.hooks;
+    }
+
+    if (Object.keys(config).length <= 1 && config.version) {
+      writeFileSync(hooksPath, JSON.stringify({ version: config.version }, null, 2) + '\n');
+    } else {
+      writeFileSync(hooksPath, JSON.stringify(config, null, 2) + '\n');
+    }
+  } catch { /* best effort */ }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.35-beta.1",
+  "version": "0.1.35-beta.2",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": {
@@ -24,7 +24,8 @@
     "registry.mjs",
     "apply.mjs",
     "update.mjs",
-    "hooks.mjs"
+    "hooks.mjs",
+    "ide-hooks.mjs"
   ],
   "engines": {
     "node": ">=18.0.0"