@axiomatic-labs/claudeflow 2.13.41 → 2.13.42

package/lib/hook-overrides.js

@@ -51,7 +51,13 @@ function normalizeHandlerPath(command) {
 }
 
 function defaultOverrides() {
-  return { version: 1, disabledHandlers: [], disabledReminders: [], enforcementDisabled: false };
+  return {
+    version: 1,
+    disabledHandlers: [],
+    disabledReminders: [],
+    enforcementDisabled: false,
+    runToCompletionReminderEnabled: false,
+  };
 }
 
 function readOverrides(projectRoot) {
@@ -62,6 +68,7 @@ function readOverrides(projectRoot) {
     disabledHandlers: Array.isArray(data.disabledHandlers) ? data.disabledHandlers : [],
     disabledReminders: Array.isArray(data.disabledReminders) ? data.disabledReminders : [],
     enforcementDisabled: data.enforcementDisabled === true,
+    runToCompletionReminderEnabled: data.runToCompletionReminderEnabled === true,
   };
 }
 
@@ -189,6 +196,19 @@ function toggleEnforcementMode(projectRoot, { disable }) {
   return { state: disable ? 'off' : 'on' };
 }
 
+// Toggle the run-to-completion reminder. Independent of the master
+// enforcement switch — it's a soft nudge, not a gate. Default OFF.
+function toggleRunToCompletionReminder(projectRoot, { enable }) {
+  if (typeof enable !== 'boolean') return { state: 'error', reason: 'enable-required' };
+  const overrides = readOverrides(projectRoot);
+  if (overrides.runToCompletionReminderEnabled === enable) {
+    return { state: 'noop', reason: enable ? 'already-on' : 'already-off' };
+  }
+  overrides.runToCompletionReminderEnabled = enable;
+  writeOverrides(projectRoot, overrides);
+  return { state: enable ? 'on' : 'off' };
+}
+
 // 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 }) {
@@ -219,6 +239,7 @@ module.exports = {
   toggleHookOverride,
   toggleReminderOverride,
   toggleEnforcementMode,
+  toggleRunToCompletionReminder,
   normalizeHandlerPath,
   matchesOverride,
 };

package/lib/panel.js

@@ -26,6 +26,7 @@ const {
   toggleHookOverride,
   toggleReminderOverride,
   toggleEnforcementMode,
+  toggleRunToCompletionReminder,
   normalizeHandlerPath,
 } = require('./hook-overrides.js');
 
@@ -286,6 +287,14 @@ function getEnforcementInfo(cwd) {
   };
 }
 
+function getRunToCompletionInfo(cwd) {
+  const overrides = readOverrides(cwd);
+  return {
+    on: overrides.runToCompletionReminderEnabled === true,
+    handler: 'UserPromptSubmit/run-to-completion-reminder.js',
+  };
+}
+
 function getActivePlanInfo(cwd) {
   const p = path.join(cwd, '.claudeflow', 'state', 'active-plan.json');
   let raw;
@@ -536,6 +545,7 @@ function collectStatus(cwd) {
     activeRun: getActiveRunInfo(cwd),
     reminders: getRemindersInfo(cwd),
     enforcement: getEnforcementInfo(cwd),
+    runToCompletion: getRunToCompletionInfo(cwd),
     activePlan: getActivePlanInfo(cwd),
     logs: getLogsInfo(cwd),
     doctor: getDoctorInfo(cwd),
@@ -706,6 +716,11 @@ details[open] summary { padding-bottom: 8px; border-bottom: 1px solid var(--bord
       <label class="enforce-switch"><input type="checkbox" id="enforce-toggle" /><span class="enforce-slider"></span></label>
       <span class="enforce-state" id="enforce-state">…</span>
     </span>
+    <span class="enforce-pill" id="run-to-completion-pill" title="Soft nudge — when the agent stops mid-build with PLACEHOLDER proofs or untouched files, the next user prompt receives a reminder telling the LLM to resume without re-checkpointing. Independent of the master Enforcement switch.">
+      <span class="enforce-label">Run-to-completion reminder</span>
+      <label class="enforce-switch"><input type="checkbox" id="run-to-completion-toggle" /><span class="enforce-slider"></span></label>
+      <span class="enforce-state" id="run-to-completion-state">…</span>
+    </span>
     <label class="toggle"><input type="checkbox" id="auto" checked /> auto-refresh 5s</label>
     <button id="refresh">Refresh</button>
   </span>
@@ -826,6 +841,20 @@ function renderHeader() {
   } else {
     pill.style.display = 'none';
   }
+  const rtc = state.runToCompletion;
+  const rtcPill = document.getElementById('run-to-completion-pill');
+  const rtcCb = document.getElementById('run-to-completion-toggle');
+  const rtcLbl = document.getElementById('run-to-completion-state');
+  if (rtc && rtcPill) {
+    rtcPill.dataset.state = rtc.on ? 'on' : 'off';
+    rtcCb.checked = rtc.on;
+    rtcLbl.textContent = rtc.on ? 'ON' : 'OFF';
+    rtcPill.title = rtc.on
+      ? 'Run-to-completion reminder is ON — every user prompt during an in-progress build step receives a "resume work, do not checkpoint" reminder. The agent can still stop when genuinely blocked.'
+      : 'Run-to-completion reminder is OFF — the agent may pause for user confirmation after partial progress. Click to enable the soft nudge.';
+  } else if (rtcPill) {
+    rtcPill.style.display = 'none';
+  }
 }
 
 function severityFor(id) {
@@ -1476,6 +1505,34 @@ document.getElementById('enforce-toggle').onchange = (e) => {
   toggleEnforcement(!e.target.checked);
 };
 
+async function toggleRunToCompletion(enable) {
+  try {
+    const r = await fetch('/api/run-to-completion/toggle', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ enable }),
+    });
+    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('Run-to-completion reminder already in target state', 'ok');
+    } else {
+      showToast(enable
+        ? 'Run-to-completion reminder ON — agent will be nudged to resume mid-build steps.'
+        : 'Run-to-completion reminder OFF — agent may checkpoint after partial progress.',
+        'ok');
+    }
+  } catch (e) {
+    showToast('Network error: ' + e.message, 'err');
+  }
+  await refresh();
+}
+
+document.getElementById('run-to-completion-toggle').onchange = (e) => {
+  toggleRunToCompletion(e.target.checked);
+};
+
 document.getElementById('refresh').onclick = refresh;
 document.getElementById('auto').onchange = (e) => {
   if (timer) clearInterval(timer);
@@ -1585,6 +1642,20 @@ function handler(cwd) {
         return send(status, JSON.stringify(result), 'application/json');
       }
 
+      if (req.method === 'POST' && route === '/api/run-to-completion/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 { enable } = payload;
+        if (typeof enable !== 'boolean') {
+          return send(400, JSON.stringify({ error: 'enable required' }), 'application/json');
+        }
+        const result = toggleRunToCompletionReminder(cwd, { enable });
+        const status = result.state === 'error' ? 500 : 200;
+        return send(status, JSON.stringify(result), 'application/json');
+      }
+
       if (req.method === 'POST' && route === '/api/reminders/toggle') {
         const raw = await readRequestBody(req);
         let payload;

package/package.json

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