@phuc1403/musketeer 0.8.0 → 0.10.0

package/template/.claude/hooks/sync-adr-toc.cjs

@@ -1,146 +1,146 @@
-#!/usr/bin/env node
-// PostToolUse hook: after any `adr` command, rebuild docs/adr/README.md from the
-// ADR files themselves — one row per ADR with its title and current status.
-//
-// The index is fully derived, so it can never drift: every run re-reads the
-// source. That is why there is no need to be clever about which adr subcommand
-// ran, or to protect the file from being rewritten.
-//
-// Also deletes the tool's own `decisions.md`. Every `adr new` regenerates that
-// file unconditionally (not just on `adr generate toc`), which would leave two
-// competing indexes side by side in the same directory. README.md is the richer
-// one — it carries a status column — so it is the one kept.
-//
-// Also runnable directly:  node sync-adr-toc.cjs --write
-//
-// Fails open at exit 0 on any problem — a hook must never block a session.
-
-const fs = require('fs');
-const path = require('path');
-
-const root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-const ADR_FILE = /^\d+-.*\.md$/;
-
-// The tool reads its directory from a committed `.adr-dir` (default `doc/adr`).
-function adrDir() {
-  try {
-    return fs.readFileSync(path.join(root, '.adr-dir'), 'utf8').trim() || 'doc/adr';
-  } catch {
-    return 'doc/adr';
-  }
-}
-
-// Was this Bash call an adr command? (`adr new -q …` counts; a hyphenated name
-// such as `adr-new` does not, hence the required whitespace.)
-function isAdrCommand() {
-  try {
-    const payload = JSON.parse(fs.readFileSync(0, 'utf8'));
-    return /\badr\s/.test(payload?.tool_input?.command || '');
-  } catch {
-    return false;
-  }
-}
-
-// First line, minus the leading "# " and the tool's own number prefix — the
-// template renders "# 12: Use X over Y" for 0012-….md. Dropping the unpadded 12
-// keeps the padded
-// stem in the ADR column the only number in the file, so nothing here can be
-// mistaken for the stem `adr new -s` expects.
-function title(body, fallback) {
-  const first = body.split(/\r?\n/)[0] || '';
-  return first.replace(/^#\s*(\d+\s*[:.]\s*)?/, '').trim() || fallback;
-}
-
-// First non-empty line of the `## Status` section. The tool maintains this:
-// "Accepted", or "Superseded by [4: …](0004-….md)" after `adr new -s`.
-function status(body) {
-  const lines = body.split(/\r?\n/);
-  const start = lines.findIndex((l) => /^##\s+Status\s*$/i.test(l));
-  if (start === -1) return 'Unknown';
-  for (const line of lines.slice(start + 1)) {
-    if (/^##\s/.test(line)) break;
-    if (line.trim()) return line.trim();
-  }
-  return 'Unknown';
-}
-
-function render(dir, files) {
-  const rows = files.map((name) => {
-    const body = fs.readFileSync(path.join(root, dir, name), 'utf8');
-    const stem = name.replace(/\.md$/, ''); // padded — what `adr new -s` needs
-    const cell = (s) => s.replace(/\|/g, '\\|'); // never break the table
-    return `| [${stem}](./${name}) | ${cell(title(body, stem))} | ${cell(status(body))} |`;
-  });
-
-  return [
-    '# Architecture Decision Records',
-    '',
-    'Generated from the ADR files by the `sync-adr-toc` hook — do not hand-edit.',
-    '',
-    '| ADR | Title | Status |',
-    '|-----|-------|--------|',
-    ...rows,
-    '',
-  ].join('\n');
-}
-
-// The tool writes its own table of contents to `<adr-dir>/decisions.md` on every
-// `adr new`. README.md supersedes it, so drop it rather than commit two indexes
-// that have to agree with each other.
-//
-// Only ever deletes a file that is recognisably that generated index: the exact
-// heading it writes, followed by nothing but link lines. `decisions.md` is an
-// ordinary name for a hand-written decision log, and deleting one of those on
-// the next `adr new` would destroy work no backup covers.
-const GENERATED_TOC = /^# Table of Contents\r?\n\r?\n(?:- \[[^\]]*\]\([^)]*\)\r?\n?)*$/;
-
-function removeRedundantToc(dir) {
-  const stale = path.join(root, dir, 'decisions.md');
-  try {
-    if (!fs.existsSync(stale)) return;
-    if (!GENERATED_TOC.test(fs.readFileSync(stale, 'utf8'))) {
-      process.stdout.write(
-        `Left ${dir}/decisions.md alone — it is not the generated index. ` +
-          'README.md is the one this hook maintains.\n'
-      );
-      return;
-    }
-    fs.unlinkSync(stale);
-    process.stdout.write(`Removed ${dir}/decisions.md (README.md is the index).\n`);
-  } catch {
-    /* not worth failing the hook over */
-  }
-}
-
-function main() {
-  if (!process.argv.includes('--write') && !isAdrCommand()) return;
-
-  const dir = adrDir();
-  removeRedundantToc(dir);
-  const files = fs
-    .readdirSync(path.join(root, dir))
-    .filter((f) => ADR_FILE.test(f))
-    .sort();
-  if (files.length === 0) return;
-
-  const target = path.join(root, dir, 'README.md');
-  const next = render(dir, files);
-
-  let current = null;
-  try {
-    current = fs.readFileSync(target, 'utf8');
-  } catch {
-    /* no index yet */
-  }
-  if (current === next) return; // already in sync
-
-  fs.writeFileSync(target, next);
-  process.stdout.write(`Regenerated ${dir}/README.md (${files.length} ADRs).\n`);
-}
-
-try {
-  main();
-} catch {
-  /* fail open */
-}
-process.exit(0);
+#!/usr/bin/env node
+// PostToolUse hook: after any `adr` command, rebuild docs/adr/README.md from the
+// ADR files themselves — one row per ADR with its title and current status.
+//
+// The index is fully derived, so it can never drift: every run re-reads the
+// source. That is why there is no need to be clever about which adr subcommand
+// ran, or to protect the file from being rewritten.
+//
+// Also deletes the tool's own `decisions.md`. Every `adr new` regenerates that
+// file unconditionally (not just on `adr generate toc`), which would leave two
+// competing indexes side by side in the same directory. README.md is the richer
+// one — it carries a status column — so it is the one kept.
+//
+// Also runnable directly:  node sync-adr-toc.cjs --write
+//
+// Fails open at exit 0 on any problem — a hook must never block a session.
+
+const fs = require('fs');
+const path = require('path');
+
+const root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const ADR_FILE = /^\d+-.*\.md$/;
+
+// The tool reads its directory from a committed `.adr-dir` (default `doc/adr`).
+function adrDir() {
+  try {
+    return fs.readFileSync(path.join(root, '.adr-dir'), 'utf8').trim() || 'doc/adr';
+  } catch {
+    return 'doc/adr';
+  }
+}
+
+// Was this Bash call an adr command? (`adr new -q …` counts; a hyphenated name
+// such as `adr-new` does not, hence the required whitespace.)
+function isAdrCommand() {
+  try {
+    const payload = JSON.parse(fs.readFileSync(0, 'utf8'));
+    return /\badr\s/.test(payload?.tool_input?.command || '');
+  } catch {
+    return false;
+  }
+}
+
+// First line, minus the leading "# " and the tool's own number prefix — the
+// template renders "# 12: Use X over Y" for 0012-….md. Dropping the unpadded 12
+// keeps the padded
+// stem in the ADR column the only number in the file, so nothing here can be
+// mistaken for the stem `adr new -s` expects.
+function title(body, fallback) {
+  const first = body.split(/\r?\n/)[0] || '';
+  return first.replace(/^#\s*(\d+\s*[:.]\s*)?/, '').trim() || fallback;
+}
+
+// First non-empty line of the `## Status` section. The tool maintains this:
+// "Accepted", or "Superseded by [4: …](0004-….md)" after `adr new -s`.
+function status(body) {
+  const lines = body.split(/\r?\n/);
+  const start = lines.findIndex((l) => /^##\s+Status\s*$/i.test(l));
+  if (start === -1) return 'Unknown';
+  for (const line of lines.slice(start + 1)) {
+    if (/^##\s/.test(line)) break;
+    if (line.trim()) return line.trim();
+  }
+  return 'Unknown';
+}
+
+function render(dir, files) {
+  const rows = files.map((name) => {
+    const body = fs.readFileSync(path.join(root, dir, name), 'utf8');
+    const stem = name.replace(/\.md$/, ''); // padded — what `adr new -s` needs
+    const cell = (s) => s.replace(/\|/g, '\\|'); // never break the table
+    return `| [${stem}](./${name}) | ${cell(title(body, stem))} | ${cell(status(body))} |`;
+  });
+
+  return [
+    '# Architecture Decision Records',
+    '',
+    'Generated from the ADR files by the `sync-adr-toc` hook — do not hand-edit.',
+    '',
+    '| ADR | Title | Status |',
+    '|-----|-------|--------|',
+    ...rows,
+    '',
+  ].join('\n');
+}
+
+// The tool writes its own table of contents to `<adr-dir>/decisions.md` on every
+// `adr new`. README.md supersedes it, so drop it rather than commit two indexes
+// that have to agree with each other.
+//
+// Only ever deletes a file that is recognisably that generated index: the exact
+// heading it writes, followed by nothing but link lines. `decisions.md` is an
+// ordinary name for a hand-written decision log, and deleting one of those on
+// the next `adr new` would destroy work no backup covers.
+const GENERATED_TOC = /^# Table of Contents\r?\n\r?\n(?:- \[[^\]]*\]\([^)]*\)\r?\n?)*$/;
+
+function removeRedundantToc(dir) {
+  const stale = path.join(root, dir, 'decisions.md');
+  try {
+    if (!fs.existsSync(stale)) return;
+    if (!GENERATED_TOC.test(fs.readFileSync(stale, 'utf8'))) {
+      process.stdout.write(
+        `Left ${dir}/decisions.md alone — it is not the generated index. ` +
+          'README.md is the one this hook maintains.\n'
+      );
+      return;
+    }
+    fs.unlinkSync(stale);
+    process.stdout.write(`Removed ${dir}/decisions.md (README.md is the index).\n`);
+  } catch {
+    /* not worth failing the hook over */
+  }
+}
+
+function main() {
+  if (!process.argv.includes('--write') && !isAdrCommand()) return;
+
+  const dir = adrDir();
+  removeRedundantToc(dir);
+  const files = fs
+    .readdirSync(path.join(root, dir))
+    .filter((f) => ADR_FILE.test(f))
+    .sort();
+  if (files.length === 0) return;
+
+  const target = path.join(root, dir, 'README.md');
+  const next = render(dir, files);
+
+  let current = null;
+  try {
+    current = fs.readFileSync(target, 'utf8');
+  } catch {
+    /* no index yet */
+  }
+  if (current === next) return; // already in sync
+
+  fs.writeFileSync(target, next);
+  process.stdout.write(`Regenerated ${dir}/README.md (${files.length} ADRs).\n`);
+}
+
+try {
+  main();
+} catch {
+  /* fail open */
+}
+process.exit(0);

package/template/.claude/hooks/{usage-context-awareness.cjs → usage-quota-cache-refresh.cjs}

@@ -1,166 +1,166 @@
-#!/usr/bin/env node
-/**
- * Usage Cache Writer - UserPromptSubmit & PostToolUse Hook
- *
- * Fetches Claude Code usage limits from Anthropic OAuth API and writes to cache.
- * The cache is read by statusline.cjs to show the 5-hour rate-limit budget.
- *
- * Self-contained port (no .ck.json / hook-logger deps). Fails open: any error
- * just emits {continue:true} so it can never block a prompt or tool call.
- *
- * Features:
- * - Cross-platform credential retrieval (macOS Keychain, file-based)
- * - API response caching (60s TTL)
- * - Throttled API calls (1 min for prompts, 5 mins for tool use)
- */
-
-try {
-  const fs = require("fs");
-  const path = require("path");
-  const os = require("os");
-  const { execSync } = require("child_process");
-
-  // Cache configuration
-  const USAGE_CACHE_FILE = path.join(os.tmpdir(), "ck-usage-limits-cache.json");
-  const FETCH_INTERVAL_MS = 300000; // 5 minutes for PostToolUse
-  const FETCH_INTERVAL_PROMPT_MS = 60000; // 1 minute for UserPromptSubmit
-
-  /**
-   * Get Claude OAuth credentials (cross-platform)
-   */
-  function getClaudeCredentials() {
-    // macOS: Try Keychain first
-    if (os.platform() === "darwin") {
-      try {
-        const result = execSync('security find-generic-password -s "Claude Code-credentials" -w', {
-          timeout: 5000,
-          encoding: "utf-8",
-          stdio: ["pipe", "pipe", "ignore"],
-        }).trim();
-        const parsed = JSON.parse(result);
-        if (parsed.claudeAiOauth?.accessToken) {
-          return parsed.claudeAiOauth.accessToken;
-        }
-      } catch {
-        // Fallback to file-based
-      }
-    }
-
-    // File-based credentials (Linux/Windows, or macOS fallback)
-    const credPath = path.join(os.homedir(), ".claude", ".credentials.json");
-    try {
-      const content = fs.readFileSync(credPath, "utf-8");
-      const parsed = JSON.parse(content);
-      return parsed.claudeAiOauth?.accessToken || null;
-    } catch {
-      return null;
-    }
-  }
-
-  /**
-   * Check if we should fetch (throttled)
-   */
-  function shouldFetch(isUserPrompt = false) {
-    const interval = isUserPrompt ? FETCH_INTERVAL_PROMPT_MS : FETCH_INTERVAL_MS;
-
-    try {
-      if (fs.existsSync(USAGE_CACHE_FILE)) {
-        const cache = JSON.parse(fs.readFileSync(USAGE_CACHE_FILE, "utf-8"));
-        if (Date.now() - cache.timestamp < interval) {
-          return false;
-        }
-      }
-    } catch {}
-    return true;
-  }
-
-  /**
-   * Write cache atomically (temp+rename prevents partial reads by statusline)
-   */
-  function writeCache(status, data = null) {
-    const tmpFile = `${USAGE_CACHE_FILE}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`;
-    try {
-      fs.writeFileSync(
-        tmpFile,
-        JSON.stringify({
-          timestamp: Date.now(),
-          status,
-          data,
-        })
-      );
-      fs.renameSync(tmpFile, USAGE_CACHE_FILE);
-    } catch {
-      try { fs.unlinkSync(tmpFile); } catch {}
-    }
-  }
-
-  /**
-   * Fetch usage limits from Anthropic OAuth API and write to cache
-   * Always writes status to cache (available or unavailable) for statusline fallback
-   */
-  async function fetchAndCacheUsageLimits() {
-    const token = getClaudeCredentials();
-    if (!token) {
-      writeCache("unavailable");
-      return;
-    }
-
-    try {
-      const response = await fetch("https://api.anthropic.com/api/oauth/usage", {
-        method: "GET",
-        headers: {
-          Accept: "application/json",
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${token}`,
-          "anthropic-beta": "oauth-2025-04-20",
-          "User-Agent": "claudekit-engineer/1.0",
-        },
-      });
-
-      if (!response.ok) {
-        writeCache("unavailable");
-        return;
-      }
-
-      const data = await response.json();
-      writeCache("available", data);
-    } catch {
-      writeCache("unavailable");
-    }
-  }
-
-  /**
-   * Main hook execution - just fetch and cache, no injection
-   */
-  async function main() {
-    const result = { continue: true };
-
-    try {
-      // Read hook input
-      let inputStr = "";
-      try {
-        inputStr = fs.readFileSync(0, "utf-8");
-      } catch {}
-
-      const input = JSON.parse(inputStr || "{}");
-
-      // Detect hook type (UserPromptSubmit vs PostToolUse) for throttle interval
-      const isUserPrompt = typeof input.prompt === "string";
-
-      // Check if we should fetch (throttled)
-      if (shouldFetch(isUserPrompt)) {
-        await fetchAndCacheUsageLimits();
-      }
-    } catch {}
-
-    // Output result (no injection, just continue)
-    console.log(JSON.stringify(result));
-  }
-
-  main().catch(() => {
-    console.log(JSON.stringify({ continue: true }));
-    process.exit(0);
-  });
-} catch (e) {
-  process.exit(0); // fail-open
-}
+#!/usr/bin/env node
+/**
+ * Usage Cache Writer - UserPromptSubmit & PostToolUse Hook
+ *
+ * Fetches Claude Code usage limits from Anthropic OAuth API and writes to cache.
+ * The cache is read by statusline.cjs to show the 5-hour rate-limit budget.
+ *
+ * Self-contained port (no .ck.json / hook-logger deps). Fails open: any error
+ * just emits {continue:true} so it can never block a prompt or tool call.
+ *
+ * Features:
+ * - Cross-platform credential retrieval (macOS Keychain, file-based)
+ * - API response caching (60s TTL)
+ * - Throttled API calls (1 min for prompts, 5 mins for tool use)
+ */
+
+try {
+  const fs = require("fs");
+  const path = require("path");
+  const os = require("os");
+  const { execSync } = require("child_process");
+
+  // Cache configuration
+  const USAGE_CACHE_FILE = path.join(os.tmpdir(), "ck-usage-limits-cache.json");
+  const FETCH_INTERVAL_MS = 300000; // 5 minutes for PostToolUse
+  const FETCH_INTERVAL_PROMPT_MS = 60000; // 1 minute for UserPromptSubmit
+
+  /**
+   * Get Claude OAuth credentials (cross-platform)
+   */
+  function getClaudeCredentials() {
+    // macOS: Try Keychain first
+    if (os.platform() === "darwin") {
+      try {
+        const result = execSync('security find-generic-password -s "Claude Code-credentials" -w', {
+          timeout: 5000,
+          encoding: "utf-8",
+          stdio: ["pipe", "pipe", "ignore"],
+        }).trim();
+        const parsed = JSON.parse(result);
+        if (parsed.claudeAiOauth?.accessToken) {
+          return parsed.claudeAiOauth.accessToken;
+        }
+      } catch {
+        // Fallback to file-based
+      }
+    }
+
+    // File-based credentials (Linux/Windows, or macOS fallback)
+    const credPath = path.join(os.homedir(), ".claude", ".credentials.json");
+    try {
+      const content = fs.readFileSync(credPath, "utf-8");
+      const parsed = JSON.parse(content);
+      return parsed.claudeAiOauth?.accessToken || null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Check if we should fetch (throttled)
+   */
+  function shouldFetch(isUserPrompt = false) {
+    const interval = isUserPrompt ? FETCH_INTERVAL_PROMPT_MS : FETCH_INTERVAL_MS;
+
+    try {
+      if (fs.existsSync(USAGE_CACHE_FILE)) {
+        const cache = JSON.parse(fs.readFileSync(USAGE_CACHE_FILE, "utf-8"));
+        if (Date.now() - cache.timestamp < interval) {
+          return false;
+        }
+      }
+    } catch {}
+    return true;
+  }
+
+  /**
+   * Write cache atomically (temp+rename prevents partial reads by statusline)
+   */
+  function writeCache(status, data = null) {
+    const tmpFile = `${USAGE_CACHE_FILE}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`;
+    try {
+      fs.writeFileSync(
+        tmpFile,
+        JSON.stringify({
+          timestamp: Date.now(),
+          status,
+          data,
+        })
+      );
+      fs.renameSync(tmpFile, USAGE_CACHE_FILE);
+    } catch {
+      try { fs.unlinkSync(tmpFile); } catch {}
+    }
+  }
+
+  /**
+   * Fetch usage limits from Anthropic OAuth API and write to cache
+   * Always writes status to cache (available or unavailable) for statusline fallback
+   */
+  async function fetchAndCacheUsageLimits() {
+    const token = getClaudeCredentials();
+    if (!token) {
+      writeCache("unavailable");
+      return;
+    }
+
+    try {
+      const response = await fetch("https://api.anthropic.com/api/oauth/usage", {
+        method: "GET",
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${token}`,
+          "anthropic-beta": "oauth-2025-04-20",
+          "User-Agent": "claudekit-engineer/1.0",
+        },
+      });
+
+      if (!response.ok) {
+        writeCache("unavailable");
+        return;
+      }
+
+      const data = await response.json();
+      writeCache("available", data);
+    } catch {
+      writeCache("unavailable");
+    }
+  }
+
+  /**
+   * Main hook execution - just fetch and cache, no injection
+   */
+  async function main() {
+    const result = { continue: true };
+
+    try {
+      // Read hook input
+      let inputStr = "";
+      try {
+        inputStr = fs.readFileSync(0, "utf-8");
+      } catch {}
+
+      const input = JSON.parse(inputStr || "{}");
+
+      // Detect hook type (UserPromptSubmit vs PostToolUse) for throttle interval
+      const isUserPrompt = typeof input.prompt === "string";
+
+      // Check if we should fetch (throttled)
+      if (shouldFetch(isUserPrompt)) {
+        await fetchAndCacheUsageLimits();
+      }
+    } catch {}
+
+    // Output result (no injection, just continue)
+    console.log(JSON.stringify(result));
+  }
+
+  main().catch(() => {
+    console.log(JSON.stringify({ continue: true }));
+    process.exit(0);
+  });
+} catch (e) {
+  process.exit(0); // fail-open
+}