@curdx/flow 2.3.3 → 2.3.4

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Claude Code Discipline Layer — spec-driven workflow + goal-backward verification + Karpathy 4 principles enforced via gates. Stops Claude from faking \"done\" on non-trivial features.",
-    "version": "2.3.3"
+    "version": "2.3.4"
   },
   "allowCrossMarketplaceDependenciesOn": [
     "context7-marketplace"
@@ -16,7 +16,7 @@
       "name": "curdx-flow",
       "source": "./",
       "description": "Claude Code Discipline Layer — spec-driven workflow + goal-backward verification + Karpathy 4 principles enforced via gates. Stops Claude from faking \"done\" on non-trivial features.",
-      "version": "2.3.3",
+      "version": "2.3.4",
       "author": {
         "name": "wdx",
         "email": "bydongxin@gmail.com"

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "curdx-flow",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "Claude Code Discipline Layer — spec-driven workflow + goal-backward verification + Karpathy 4 principles enforced via gates. Stops Claude from faking \"done\" on non-trivial features.",
   "author": {
     "name": "wdx",

package/cli/lib/doctor-claude-settings.js

@@ -121,6 +121,23 @@ const CURDX_FLOW_REQUIRED_PLUGIN_IDS = ["context7-plugin@context7-marketplace"];
 const HTTP_HOOK_SETTINGS = ["allowedHttpHookUrls", "httpHookAllowedEnvVars"];
 const PERSISTED_EFFORT_LEVELS = ["low", "medium", "high", "xhigh"];
 const ENV_EFFORT_LEVELS = [...PERSISTED_EFFORT_LEVELS, "max", "auto"];
+const CURDX_FLOW_RUNTIME_CONSUMERS = {
+  autonomous_blocking: {
+    envVar: "CLAUDE_PLUGIN_OPTION_AUTONOMOUS_BLOCKING",
+    consumer: "hooks/scripts/stop-watcher.sh",
+    summary: "controls whether the Stop hook blocks Claude from stopping while execute work remains",
+  },
+  daily_dependency_check: {
+    envVar: "CLAUDE_PLUGIN_OPTION_DAILY_DEPENDENCY_CHECK",
+    consumer: "hooks/scripts/session-start.sh",
+    summary: "controls the once-per-day recommended companion plugin reminder",
+  },
+  monitor_interval_seconds: {
+    envVar: "CLAUDE_PLUGIN_OPTION_MONITOR_INTERVAL_SECONDS",
+    consumer: "monitors/scripts/flow-state-monitor.sh",
+    summary: "controls the polling interval for the interactive flow-state monitor",
+  },
+};
 
 function envFlagEnabled(value) {
   if (value === true || value === 1) return true;
@@ -258,6 +275,43 @@ function applyCurdxFlowPluginOptionOverride(pluginOptionsState, key, value, scop
   }
 }
 
+function buildCurdxFlowRuntimeProjection(pluginOptionsState) {
+  return pluginOptionsState.definitions.map((definition) => {
+    const effective = pluginOptionsState.machineEffective[definition.key] || {
+      value: definition.default,
+      source: "default",
+    };
+    const runtime = CURDX_FLOW_RUNTIME_CONSUMERS[definition.key] || {};
+    const details = [];
+
+    if (definition.key === "autonomous_blocking") {
+      details.push(
+        effective.value === false
+          ? "stop-hook continuation is disabled; Claude may stop at turn end even when execute tasks remain"
+          : "stop-hook continuation is enabled; CurDX-Flow can block turn end while execute tasks remain"
+      );
+    } else if (definition.key === "daily_dependency_check") {
+      details.push(
+        effective.value === false
+          ? "SessionStart plugin reminder is disabled on this machine"
+          : "SessionStart plugin reminder runs at most once per day on this machine"
+      );
+    } else if (definition.key === "monitor_interval_seconds") {
+      details.push(`flow-state monitor polls every ${effective.value} second(s) when Monitor is available`);
+    }
+
+    return {
+      key: definition.key,
+      envVar: runtime.envVar || `CLAUDE_PLUGIN_OPTION_${definition.key.toUpperCase()}`,
+      consumer: runtime.consumer || "plugin subprocess",
+      summary: runtime.summary || "runtime consumer",
+      value: effective.value,
+      source: effective.source,
+      details,
+    };
+  });
+}
+
 function auditCurdxFlowPluginOptions(parsed, warnings, pluginOptionsState, scope = "project") {
   if (!isNonArrayObject(parsed) || !("pluginConfigs" in parsed)) {
     return;
@@ -593,6 +647,7 @@ export async function readProjectClaudeSettings(cwd = process.cwd(), { homeDir =
     localParseError: null,
     localWarnings: [],
     pluginOptions: createCurdxFlowPluginOptionsState(),
+    pluginRuntimeProjection: [],
   };
 
   try {
@@ -972,5 +1027,7 @@ export async function readProjectClaudeSettings(cwd = process.cwd(), { homeDir =
     }
   }
 
+  state.pluginRuntimeProjection = buildCurdxFlowRuntimeProjection(state.pluginOptions);
+
   return state;
 }

package/cli/lib/doctor-report.js

@@ -598,6 +598,30 @@ export function buildDoctorReport({
     }
   }
 
+  if ((projectClaudeSettings?.pluginRuntimeProjection || []).length > 0) {
+    const runtimeProjectionSection = createSection("CurDX-Flow runtime projection:");
+
+    for (const entry of projectClaudeSettings.pluginRuntimeProjection) {
+      const sourceLabel = entry.source === "local"
+        ? "local"
+        : entry.source === "project"
+          ? "project"
+          : entry.source === "user"
+            ? "user"
+            : "bundled default";
+      pushSectionLine(
+        runtimeProjectionSection,
+        "info",
+        `${entry.envVar.padEnd(36)} ${formatInlineValue(entry.value)} (${sourceLabel})`,
+        [
+          `consumer: ${entry.consumer}`,
+          entry.summary,
+          ...(entry.details || []),
+        ]
+      );
+    }
+  }
+
   const localProjectSection = createSection("Local project:");
   if (projectState?.exists) {
     pushSectionLine(localProjectSection, "ok", `.flow/                ${cwd}`);

package/knowledge/claude-code-runtime-contracts.md

@@ -88,6 +88,7 @@ Guarded artifact targets:
   - `autonomous_blocking`: lets users disable stop-hook continuation without editing plugin files.
   - `daily_dependency_check`: silences or enables the once-per-day recommended-plugin reminder.
   - `monitor_interval_seconds`: controls plugin monitor polling cadence.
+- `doctor` should explain both the machine-effective config value and the projected plugin subprocess env var for these knobs, since hook/monitor behavior depends on the env projection rather than direct JSON parsing.
 
 ## Plugin Dependency Constraints
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curdx/flow",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "Skill-first discipline layer and CLI installer for Claude Code",
   "type": "module",
   "bin": {