claude-launchpad 1.15.0 → 1.17.0

package/dist/{chunk-IPGNXDJF.js → chunk-IIOY56ZE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   log
-} from "./chunk-U2TFIUGE.js";
+} from "./chunk-KYGWNN5F.js";
 
 // src/commands/memory/utils/gist-transport.ts
 import { execSync } from "child_process";
@@ -205,4 +205,4 @@ export {
   deleteGistFile,
   updateGistFiles
 };
-//# sourceMappingURL=chunk-IPGNXDJF.js.map
+//# sourceMappingURL=chunk-IIOY56ZE.js.map

package/dist/{chunk-DLDVXHI3.js → chunk-JKDFOKHD.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   cwdRequire
-} from "./chunk-7KB5YGQZ.js";
+} from "./chunk-YLIV5WBW.js";
 
 // src/commands/memory/config.ts
 import { z } from "zod";
@@ -181,4 +181,4 @@ export {
   createDatabase,
   closeDatabase
 };
-//# sourceMappingURL=chunk-DLDVXHI3.js.map
+//# sourceMappingURL=chunk-JKDFOKHD.js.map

package/dist/{chunk-U2TFIUGE.js → chunk-KYGWNN5F.js}

@@ -1173,7 +1173,7 @@ These rules apply whenever editing \`BACKLOG.md\` or \`TASKS.md\`. The workflow
 }
 
 // src/commands/init/generators/hooks-rule.ts
-var HOOKS_RULE_VERSION = 1;
+var HOOKS_RULE_VERSION = 2;
 function generateHooksRule() {
   return `---
 paths: [".claude/settings.json", ".claude/settings.local.json"]
@@ -1208,6 +1208,17 @@ Reference: https://code.claude.com/docs/en/hooks
 - \`matcher\`: a regex-style string matching tool names (e.g. \`Bash\`, \`Read|Write|Edit\`). Empty string matches all tools for the event. For SessionStart use \`startup\`, \`resume\`, \`clear\`, or \`compact\`.
 - \`hooks\` array: every entry runs in parallel when the matcher fires. Identical command strings are deduplicated automatically.
 
+## The \`if\` field \u2014 when to use it
+
+- \`if\` (PreToolUse/PostToolUse/PostToolUseFailure/PermissionRequest) filters a hook with a SINGLE permission rule (e.g. \`"if": "Bash(terraform *)"\`) before your command ever spawns \u2014 cheaper than jq+grep for hooks targeting one narrow rule.
+- The generated guards intentionally do NOT use it: they match multiple patterns in one hook (rm -rf, DROP TABLE, force-push) and need exclusions (.env but not .env.example) that permission-rule syntax cannot express. Splitting them into per-rule entries would grow the config without changing behavior \u2014 the jq+stdin grep stays the single source of truth.
+- For your own single-pattern hooks, prefer \`if\` over an inline grep.
+
+## Long-running SessionEnd work \u2014 use \`async: true\`
+
+- Plain SessionEnd hooks are killed when Claude Code exits \u2014 a ~3s network push never completes (verified empirically). Mark the hook \`{"type": "command", "command": "...", "async": true}\` and it survives; output is logged without touching the conversation.
+- The old workaround was a \`nohup ... & exit 0\` wrapper \u2014 still works, but the native field is canonical now.
+
 ## Input \u2014 JSON on stdin, NOT env vars
 
 The hook receives a JSON payload on stdin. **There are no \`TOOL_INPUT_*\` environment variables in current Claude Code.** A hook that does \`cmd="$TOOL_INPUT_COMMAND"\` reads an empty string and silently no-ops. This is the single most common authoring bug.
@@ -1512,6 +1523,15 @@ async function createHooksRule(root) {
   );
   return true;
 }
+async function updateHooksRule(root) {
+  const hooksPath = join4(root, ".claude", "rules", "hooks.md");
+  const content = await readFile3(hooksPath, "utf-8").catch(() => null);
+  if (content === null) return false;
+  if (!/<!-- lp-hooks-version: \d+ -->/.test(content)) return false;
+  await writeFile3(hooksPath, generateHooksRule());
+  log.success("Updated .claude/rules/hooks.md to the latest version");
+  return true;
+}
 async function createVerificationRule(root) {
   const rulesDir = join4(root, ".claude", "rules");
   const verificationPath = join4(rulesDir, "verification.md");
@@ -1879,7 +1899,7 @@ async function addSessionStartPullHook(root, placement) {
 async function addSessionEndPushHook(root, placement) {
   const target = placement === "local" ? "settings.local.json" : "settings.json";
   return addPlacementHook(root, placement, "SessionEnd", "memory push", {
-    hooks: [{ type: "command", command: "nohup npx claude-launchpad memory push -y </dev/null >/dev/null 2>&1 & exit 0" }]
+    hooks: [{ type: "command", command: "npx claude-launchpad memory push -y", async: true }]
   }, false, `Added SessionEnd hook for memory sync to ${target}`);
 }
 async function upgradeStaleSessionEndPushHook(root) {
@@ -1898,9 +1918,9 @@ async function upgradeStaleSessionEndPushHook(root) {
       if (!inner) return group;
       const rewritten = inner.map((h) => {
         const cmd = typeof h.command === "string" ? h.command : "";
-        if (!cmd.includes("memory push") || cmd.includes("nohup")) return h;
+        if (!cmd.includes("memory push") || h.async === true) return h;
         changed = true;
-        return { ...h, command: "nohup npx claude-launchpad memory push -y </dev/null >/dev/null 2>&1 & exit 0" };
+        return { ...h, type: "command", command: "npx claude-launchpad memory push -y", async: true };
       });
       return { ...group, hooks: rewritten };
     });
@@ -1908,7 +1928,7 @@ async function upgradeStaleSessionEndPushHook(root) {
     const updated = { ...settings, hooks: { ...hooks, SessionEnd: upgraded } };
     await write(root, updated);
     const target = placement === "local" ? "settings.local.json" : "settings.json";
-    log.success(`Upgraded SessionEnd push hook in ${target} (now nohup-wrapped)`);
+    log.success(`Upgraded SessionEnd push hook in ${target} (native async: true)`);
     changedAny = true;
   }
   return changedAny;
@@ -2150,6 +2170,11 @@ var FIX_TABLE = [
     match: "workflow.md rule is outdated",
     fix: (root) => updateWorkflowRule(root)
   },
+  {
+    analyzer: "Rules",
+    match: "hooks.md rule is outdated",
+    fix: (root) => updateHooksRule(root)
+  },
   {
     analyzer: "Rules",
     match: "verification.md rule is outdated",
@@ -2337,7 +2362,12 @@ var FIX_TABLE = [
   },
   {
     analyzer: "Memory",
-    match: "SessionEnd push hook is not nohup-wrapped",
+    match: "SessionEnd push hook is neither async nor detached",
+    fix: (root) => upgradeStaleSessionEndPushHook(root)
+  },
+  {
+    analyzer: "Memory",
+    match: "SessionEnd push hook is uses the legacy nohup wrapper",
     fix: (root) => upgradeStaleSessionEndPushHook(root)
   },
   {
@@ -2724,6 +2754,7 @@ export {
   writeWorkflowCheckScript,
   WORKFLOW_RULE_VERSION,
   generateWorkflowRule,
+  HOOKS_RULE_VERSION,
   generateHooksRule,
   VERIFICATION_RULE_VERSION,
   generateVerificationRule,
@@ -2734,4 +2765,4 @@ export {
   printScoreCard,
   renderDoctorReport
 };
-//# sourceMappingURL=chunk-U2TFIUGE.js.map
+//# sourceMappingURL=chunk-KYGWNN5F.js.map