cleargate 0.11.1 → 0.11.3

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project are documented in this file.
 Format: [Common Changelog](https://common-changelog.org/) — most-recent version first.
 
+## [0.11.3] — 2026-05-05
+
+Hotfix.
+
+### Fixed
+- **`cleargate upgrade` no longer strips the executable bit from `.sh` hook scripts** — `cleargate-cli/src/commands/upgrade.ts` `writeAtomic()` now `chmod 0o755` after writing any `.sh` target. `fs.writeFile` defaults to 0o644; init solved this in `copy-payload.ts` (BUG-018) but upgrade's write path bypassed that fix. Result: every Claude Code hook in target repos failed with `Permission denied` after upgrade until manually re-chmod'd. Observed today on `markdown_file_renderer` after the SPRINT-02 PostToolUse:Edit hook fired.
+
+## [0.11.2] — 2026-05-05
+
+Hotfix.
+
+### Fixed
+- **`cleargate upgrade` and `cleargate init` now warn when session-loaded configs change** — `cleargate-cli/src/commands/upgrade.ts` tracks modifications to `.claude/settings.json` and `.mcp.json` during the run and prints a `⚠ Restart Claude Code in this repo` block at the end if either changed. `init.ts` adds the same "restart Claude Code if already open" suffix to its `Updated .claude/settings.json` log line (parallels the existing `.mcp.json` message). Without this, hook wiring + MCP-server changes silently fail to load until the user happens to restart their session — observed today when SPRINT-02 drafts in `markdown_file_renderer` did not trigger `stamp-and-gate.sh` after upgrade because the running session held a pre-upgrade settings snapshot.
+
 ## [0.11.1] — 2026-05-05
 
 Hotfix.

package/dist/MANIFEST.json

@@ -1,6 +1,6 @@
 {
-  "cleargate_version": "0.11.1",
-  "generated_at": "2026-05-04T22:23:50.738Z",
+  "cleargate_version": "0.11.3",
+  "generated_at": "2026-05-04T23:10:17.763Z",
   "files": [
     {
       "path": ".claude/agents/architect.md",

package/dist/cli.cjs

@@ -696,7 +696,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "cleargate",
-  version: "0.11.1",
+  version: "0.11.3",
   private: false,
   type: "module",
   description: "Planning framework for Claude Code agents \u2014 sprint/epic/story protocol, five-role agent team (architect/developer/qa/devops/reporter), Karpathy-style awareness wiki.",
@@ -3353,7 +3353,7 @@ async function initHandler(opts = {}) {
   const mergedSettings = mergeSettings(existingSettings, HOOK_ADDITION);
   fs17.mkdirSync(path18.dirname(settingsPath), { recursive: true });
   writeAtomic(settingsPath, JSON.stringify(mergedSettings, null, 2) + "\n");
-  stdout(`[cleargate init] Updated .claude/settings.json: merged PostToolUse hook
+  stdout(`[cleargate init] Updated .claude/settings.json: merged PostToolUse hook \u2014 restart Claude Code if already open.
 `);
   const claudeMdPath = path18.join(cwd, "CLAUDE.md");
   const claudeMdSrcPath = path18.join(payloadDir, "CLAUDE.md");
@@ -8934,6 +8934,9 @@ async function writeAtomic2(filePath, content) {
   const tmpPath = filePath + ".tmp." + Date.now();
   await fsp.writeFile(tmpPath, content, "utf-8");
   await fsp.rename(tmpPath, filePath);
+  if (filePath.endsWith(".sh")) {
+    await fsp.chmod(filePath, 493);
+  }
 }
 async function updateSnapshotEntry(projectRoot, filePath, newSha) {
   const snapshotPath = path41.join(projectRoot, ".cleargate", ".install-manifest.json");
@@ -9164,6 +9167,8 @@ async function upgradeHandler(flags, cli) {
   }
   const packageRoot = cli?.packageRoot ?? cwd;
   const driftMap = {};
+  const SESSION_LOAD_PATHS = /* @__PURE__ */ new Set([".claude/settings.json", ".mcp.json"]);
+  const sessionRestartFiles = [];
   for (const item of workItems) {
     const { entry, currentSha, installSha, action } = item;
     switch (action) {
@@ -9196,9 +9201,19 @@ async function upgradeHandler(flags, cli) {
       current_sha: postSha,
       package_sha: entry.sha256
     };
+    if (SESSION_LOAD_PATHS.has(entry.path) && postSha !== currentSha) {
+      sessionRestartFiles.push(entry.path);
+    }
   }
   await writeDriftState(cwd, driftMap, { lastRefreshed: now.toISOString() });
   stdout("[upgrade] complete.");
+  if (sessionRestartFiles.length > 0) {
+    stdout("");
+    stdout(`\u26A0 Restart Claude Code in this repo to load the new ${sessionRestartFiles.length === 1 ? "config" : "configs"}:`);
+    for (const f of sessionRestartFiles) {
+      stdout(`    ${f} (loaded once at session start)`);
+    }
+  }
 }
 
 // src/commands/uninstall.ts