@axiomatic-labs/claudeflow 2.13.23 → 2.13.24

package/lib/hook-overrides.js

@@ -51,7 +51,7 @@ function normalizeHandlerPath(command) {
 }
 
 function defaultOverrides() {
-  return { version: 1, disabledHandlers: [] };
+  return { version: 1, disabledHandlers: [], disabledReminders: [] };
 }
 
 function readOverrides(projectRoot) {
@@ -60,6 +60,7 @@ function readOverrides(projectRoot) {
   return {
     version: data.version || 1,
     disabledHandlers: Array.isArray(data.disabledHandlers) ? data.disabledHandlers : [],
+    disabledReminders: Array.isArray(data.disabledReminders) ? data.disabledReminders : [],
   };
 }
 
@@ -172,6 +173,26 @@ function toggleHookOverride(projectRoot, { event, matcher = '', handler, disable
   return { state: 'enabled' };
 }
 
+// Toggle a single reminder by id. Same persistence file, same hot-reload
+// semantics — `reload-reminder.js` re-reads overrides on every invocation.
+function toggleReminderOverride(projectRoot, { id, disable }) {
+  if (typeof id !== 'string' || !id.trim()) return { state: 'error', reason: 'id-required' };
+  const overrides = readOverrides(projectRoot);
+  const list = overrides.disabledReminders;
+  const idx = list.indexOf(id);
+
+  if (disable) {
+    if (idx !== -1) return { state: 'noop', reason: 'already-disabled' };
+    list.push(id);
+    writeOverrides(projectRoot, overrides);
+    return { state: 'disabled' };
+  }
+  if (idx === -1) return { state: 'noop', reason: 'not-disabled' };
+  list.splice(idx, 1);
+  writeOverrides(projectRoot, overrides);
+  return { state: 'enabled' };
+}
+
 module.exports = {
   OVERRIDES_REL,
   SETTINGS_REL,
@@ -180,6 +201,7 @@ module.exports = {
   readOverrides,
   writeOverrides,
   toggleHookOverride,
+  toggleReminderOverride,
   normalizeHandlerPath,
   matchesOverride,
 };

package/lib/panel.js

@@ -24,9 +24,26 @@ const {
 const {
   readOverrides,
   toggleHookOverride,
+  toggleReminderOverride,
   normalizeHandlerPath,
 } = require('./hook-overrides.js');
 
+// Lazy-load the reminder catalog from the template hook helper. The path
+// resolves the same way at install time and from the template repo.
+function loadReminderHelpers(cwd) {
+  const candidates = [
+    path.join(cwd, '.claude', 'hooks', 'shared', 'reload-reminder.js'),
+  ];
+  for (const c of candidates) {
+    if (fs.existsSync(c)) {
+      // Bypass require cache so updates to the template are picked up.
+      delete require.cache[require.resolve(c)];
+      return require(c);
+    }
+  }
+  return null;
+}
+
 const IDLE_SHUTDOWN_MS = 30 * 60 * 1000; // 30 min
 
 // ─── data collectors ─────────────────────────────────────────────
@@ -227,6 +244,29 @@ function getActiveRunInfo(cwd) {
   };
 }
 
+function getRemindersInfo(cwd) {
+  const helpers = loadReminderHelpers(cwd);
+  if (!helpers || typeof helpers.listReminderCatalog !== 'function') {
+    return { available: false, reminders: [], disabledCount: 0 };
+  }
+  const catalog = helpers.listReminderCatalog();
+  const overrides = readOverrides(cwd);
+  const disabledSet = new Set(overrides.disabledReminders || []);
+  const reminders = catalog.map((r) => ({
+    id: r.id,
+    label: r.label,
+    description: r.description,
+    slot: r.slot,
+    disabled: disabledSet.has(r.id),
+  }));
+  return {
+    available: true,
+    reminders,
+    disabledCount: reminders.filter((r) => r.disabled).length,
+    activeCount: reminders.filter((r) => !r.disabled).length,
+  };
+}
+
 function getDoctorInfo(cwd) {
   const checks = [checkCdpPortMismatch(cwd), checkStaleLockfiles(cwd)];
   const issues = checks.filter((c) => c.severity !== 'ok' && c.severity !== 'info');
@@ -247,6 +287,7 @@ function collectStatus(cwd) {
     mcp: getMcpInfo(cwd),
     setupContext: getSetupContextInfo(cwd),
     activeRun: getActiveRunInfo(cwd),
+    reminders: getRemindersInfo(cwd),
     doctor: getDoctorInfo(cwd),
   };
 }
@@ -338,6 +379,12 @@ details[open] summary { padding-bottom: 8px; border-bottom: 1px solid var(--bord
 .toggle input { accent-color: var(--accent); }
 .disabled-row { opacity: 0.55; }
 .disabled-row .matcher { font-style: italic; }
+.reminder-row { padding: 10px 0; border-bottom: 1px solid var(--border); }
+.reminder-row:last-child { border-bottom: 0; }
+.reminder-row .reminder-label { font-size: 13px; }
+.reminder-row .reminder-desc { font-size: 12px; margin-left: 22px; margin-top: 2px; }
+.reminder-row .reminder-id { font-size: 11px; margin-left: 22px; margin-top: 2px; }
+.reminder-row code { background: var(--panel-2); padding: 1px 5px; border-radius: 3px; font-size: 11px; }
 .toast { position: fixed; bottom: 18px; right: 18px; background: var(--panel); border: 1px solid var(--border); padding: 10px 14px; border-radius: 6px; font-size: 13px; box-shadow: 0 4px 12px rgba(0,0,0,0.4); }
 .toast.err { border-color: var(--err); }
 .toast.ok { border-color: var(--ok); }
@@ -363,6 +410,7 @@ const SECTIONS = [
   { id: 'overview',     label: 'Overview' },
   { id: 'claudeMd',     label: 'CLAUDE.md' },
   { id: 'hooks',        label: 'Hooks' },
+  { id: 'reminders',    label: 'Reminders' },
   { id: 'mcp',          label: 'MCP & observer' },
   { id: 'setupContext', label: 'Setup context' },
   { id: 'activeRun',    label: 'Active run' },
@@ -446,6 +494,7 @@ function severityFor(id) {
     case 'overview': return s.doctor.issueCount > 0 ? 'warn' : 'ok';
     case 'claudeMd': return !s.claudeMd.exists ? 'err' : (s.claudeMd.optOut ? 'info' : 'ok');
     case 'hooks':    return s.hooks.warnings > 0 ? 'warn' : 'ok';
+    case 'reminders': return s.reminders && s.reminders.disabledCount > 0 ? 'info' : 'ok';
     case 'mcp':      return !s.mcp.configFound ? 'info' : (s.mcp.playwright.match && s.mcp.staleLockfiles.length === 0 ? 'ok' : 'warn');
     case 'setupContext': return !s.setupContext.exists ? 'err' : (s.setupContext.toolingComplete ? 'ok' : 'warn');
     case 'activeRun': return s.activeRun.active ? 'info' : 'info';
@@ -489,6 +538,7 @@ function renderContent() {
     overview: renderOverview,
     claudeMd: renderClaudeMd,
     hooks: renderHooks,
+    reminders: renderReminders,
     mcp: renderMcp,
     setupContext: renderSetup,
     activeRun: renderRun,
@@ -510,6 +560,9 @@ function renderOverview() {
   const sc = !s.setupContext.exists ? 'missing' : (s.setupContext.toolingComplete ? 'complete' : 'incomplete (' + s.setupContext.missingTooling.join(', ') + ')');
   const ar = s.activeRun.active ? s.activeRun.runId : 'none';
   const dc = s.doctor.issueCount === 0 ? '0 issues' : s.doctor.issueCount + ' issue(s) — run \`claudeflow doctor\`';
+  const rm = s.reminders && s.reminders.available
+    ? \`\${s.reminders.activeCount} active · \${s.reminders.disabledCount} disabled\`
+    : 'unavailable';
   return \`<h2>Overview</h2>
     <p class="sub">Snapshot at \${new Date(s.timestamp).toLocaleTimeString()}</p>
     <div class="card">
@@ -519,6 +572,7 @@ function renderOverview() {
       \${row('MCP & observer', mc, { kind: !s.mcp.configFound ? 'info' : (s.mcp.playwright.match ? 'ok' : 'warn'), text: !s.mcp.configFound ? '·' : (s.mcp.playwright.match ? '✓' : '!') })}
       \${row('Setup context', sc, { kind: s.setupContext.exists ? (s.setupContext.toolingComplete ? 'ok' : 'warn') : 'err', text: s.setupContext.exists ? (s.setupContext.toolingComplete ? '✓' : '!') : '✗' })}
       \${row('Active run', ar, { kind: 'info', text: s.activeRun.active ? '·' : '·' })}
+      \${row('Reminders', rm, { kind: s.reminders && s.reminders.available ? (s.reminders.disabledCount ? 'info' : 'ok') : 'err', text: s.reminders && s.reminders.disabledCount ? '·' : '✓' })}
       \${row('Doctor', dc, { kind: s.doctor.issueCount === 0 ? 'ok' : 'warn', text: s.doctor.issueCount === 0 ? '✓' : '!' })}
     </div>\`;
 }
@@ -564,6 +618,35 @@ function renderHooks() {
     \${items}\`;
 }
 
+function renderReminders() {
+  const r = state.reminders;
+  if (!r || !r.available) return '<h2>Reminders</h2><p class="error">Reminder catalog unavailable (template helper not found).</p>';
+  const slotLabel = { reads: 'Reads / anchors', rules: 'Rules', 'claude-md': 'CLAUDE.md content' };
+  const grouped = {};
+  for (const item of r.reminders) {
+    if (!grouped[item.slot]) grouped[item.slot] = [];
+    grouped[item.slot].push(item);
+  }
+  const sections = Object.entries(grouped).map(([slot, items]) => {
+    const rows = items.map(item => {
+      const checked = item.disabled ? '' : 'checked';
+      const dataset = \`data-id="\${escapeHtml(item.id)}"\`;
+      const status = item.disabled ? '<span class="badge info">disabled</span>' : '';
+      const cls = item.disabled ? 'reminder-row disabled-row' : 'reminder-row';
+      return \`<div class="\${cls}">
+        <label class="toggle"><input type="checkbox" class="reminder-toggle" \${dataset} \${checked} />
+          <span class="reminder-label"><strong>\${escapeHtml(item.label)}</strong> \${status}</span></label>
+        <div class="reminder-desc muted">\${escapeHtml(item.description)}</div>
+        <div class="reminder-id muted">id: <code>\${escapeHtml(item.id)}</code></div>
+      </div>\`;
+    }).join('');
+    return \`<details open><summary>\${escapeHtml(slotLabel[slot] || slot)} <span class="muted">(\${items.length})</span></summary>\${rows}</details>\`;
+  }).join('');
+  return \`<h2>Reminders</h2>
+    <p class="sub">\${r.activeCount} active · \${r.disabledCount} disabled. Toggles are read by <code>reload-reminder.js</code> on every hook invocation — disabling takes effect on the next user prompt without reloading Claude Code.</p>
+    \${sections}\`;
+}
+
 function renderMcp() {
   const m = state.mcp;
   if (!m.configFound) return '<h2>MCP & observer</h2><p class="muted">.mcp.json not found</p>';
@@ -644,14 +727,40 @@ async function toggleHook(event, matcher, handler, disable) {
   await refresh();
 }
 
+async function toggleReminder(id, disable) {
+  try {
+    const r = await fetch('/api/reminders/toggle', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id, disable }),
+    });
+    const result = await r.json();
+    if (!r.ok || result.state === 'error') {
+      showToast('Toggle failed: ' + (result.reason || result.error || 'unknown'), 'err');
+    } else if (result.state === 'noop') {
+      showToast('Already in target state', 'ok');
+    } else {
+      showToast(disable ? 'Reminder silenced. Next prompt will skip it.' : 'Reminder restored. Next prompt will include it.', 'ok');
+    }
+  } catch (e) {
+    showToast('Network error: ' + e.message, 'err');
+  }
+  await refresh();
+}
+
 document.addEventListener('change', (e) => {
   const t = e.target;
-  if (t && t.classList && t.classList.contains('hook-toggle')) {
+  if (!t || !t.classList) return;
+  if (t.classList.contains('hook-toggle')) {
     const event = t.dataset.event;
     const matcher = t.dataset.matcher;
     const handler = t.dataset.handler;
     const disable = !t.checked;
     toggleHook(event, matcher, handler, disable);
+  } else if (t.classList.contains('reminder-toggle')) {
+    const id = t.dataset.id;
+    const disable = !t.checked;
+    toggleReminder(id, disable);
   }
 });
 
@@ -733,6 +842,20 @@ function handler(cwd) {
         return send(status, JSON.stringify(result), 'application/json');
       }
 
+      if (req.method === 'POST' && route === '/api/reminders/toggle') {
+        const raw = await readRequestBody(req);
+        let payload;
+        try { payload = JSON.parse(raw); }
+        catch { return send(400, JSON.stringify({ error: 'invalid json' }), 'application/json'); }
+        const { id, disable } = payload;
+        if (typeof id !== 'string' || typeof disable !== 'boolean') {
+          return send(400, JSON.stringify({ error: 'id, disable required' }), 'application/json');
+        }
+        const result = toggleReminderOverride(cwd, { id, disable });
+        const status = result.state === 'error' ? 500 : 200;
+        return send(status, JSON.stringify(result), 'application/json');
+      }
+
       send(404, JSON.stringify({ error: 'not found' }), 'application/json');
     } catch (err) {
       res.writeHead(500, { 'Content-Type': 'application/json' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.13.23",
+  "version": "2.13.24",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"