@curdx/flow 2.3.0 → 2.3.1

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.0"
+    "version": "2.3.1"
   },
   "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.0",
+      "version": "2.3.1",
       "author": {
         "name": "wdx",
         "email": "bydongxin@gmail.com"

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "curdx-flow",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "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/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2.3.1
+
+- expanded `doctor` to report CurDX-Flow’s bundled main-thread agent, monitor surface, and plugin option defaults
+- documented where Claude Code stores CurDX-Flow non-sensitive `userConfig` values in `pluginConfigs`
+- added troubleshooting guidance for stop-hook blocking and plugin monitor behavior
+
 ## 2.3.0
 
 - added a default `flow-orchestrator` main-thread agent through plugin-level `settings.json`

package/README.md

@@ -22,6 +22,10 @@ Requires modern Claude Code and Node 18+. The install flow registers the plugin,
 required reasoning/doc tools, and recommended companion plugins. Run
 `npx @curdx/flow doctor` after install if anything looks off.
 
+After restart, CurDX-Flow routes the main thread through `flow-orchestrator`
+by default and starts the bundled `.flow` progress monitor in interactive
+Claude Code sessions.
+
 ## 11 slash commands, that's it
 
 ```text

package/cli/doctor-workflow.js

@@ -1,5 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 
 import { readProjectClaudeSettings } from "./lib/doctor-claude-settings.js";
 import { inspectRuntimeEnvironment } from "./lib/doctor-runtime-environment.js";
@@ -19,6 +20,8 @@ import {
 export { readProjectClaudeSettings };
 export { inspectRuntimeEnvironment };
 
+const PACKAGE_ROOT = fileURLToPath(new URL("../", import.meta.url));
+
 export function createDoctorContext(args = []) {
   return {
     fix: args.includes("--fix"),
@@ -150,6 +153,78 @@ export async function readProjectTeamConfig(cwd = process.cwd()) {
   return state;
 }
 
+export async function readBundledPluginRuntimeDefaults(packageRoot = PACKAGE_ROOT) {
+  const pluginSettingsPath = path.join(packageRoot, "settings.json");
+  const pluginManifestPath = path.join(packageRoot, ".claude-plugin", "plugin.json");
+  const monitorsPath = path.join(packageRoot, "monitors", "monitors.json");
+
+  const state = {
+    exists: false,
+    defaultAgent: null,
+    subagentStatusLineCommand: null,
+    monitorCount: 0,
+    monitors: [],
+    userConfig: [],
+  };
+
+  let pluginSettings = null;
+  let pluginManifest = null;
+  let monitors = null;
+
+  try {
+    pluginSettings = JSON.parse(await fs.readFile(pluginSettingsPath, "utf-8"));
+  } catch {
+    pluginSettings = null;
+  }
+
+  try {
+    pluginManifest = JSON.parse(await fs.readFile(pluginManifestPath, "utf-8"));
+  } catch {
+    pluginManifest = null;
+  }
+
+  try {
+    monitors = JSON.parse(await fs.readFile(monitorsPath, "utf-8"));
+  } catch {
+    monitors = null;
+  }
+
+  if (!pluginSettings && !pluginManifest && !monitors) {
+    return state;
+  }
+
+  state.exists = true;
+  state.defaultAgent = typeof pluginSettings?.agent === "string" ? pluginSettings.agent : null;
+  state.subagentStatusLineCommand =
+    typeof pluginSettings?.subagentStatusLine?.command === "string"
+      ? pluginSettings.subagentStatusLine.command
+      : null;
+
+  if (Array.isArray(monitors)) {
+    state.monitorCount = monitors.length;
+    state.monitors = monitors
+      .filter((entry) => entry && typeof entry === "object")
+      .map((entry) => ({
+        name: typeof entry.name === "string" ? entry.name : null,
+        when: typeof entry.when === "string" ? entry.when : "always",
+      }))
+      .filter((entry) => entry.name);
+  }
+
+  if (pluginManifest?.userConfig && typeof pluginManifest.userConfig === "object") {
+    state.userConfig = Object.entries(pluginManifest.userConfig)
+      .filter(([, value]) => value && typeof value === "object" && !Array.isArray(value))
+      .map(([key, value]) => ({
+        key,
+        type: value.type ?? null,
+        default: Object.prototype.hasOwnProperty.call(value, "default") ? value.default : undefined,
+        sensitive: value.sensitive === true,
+      }));
+  }
+
+  return state;
+}
+
 export async function readProjectState(cwd = process.cwd()) {
   const flowDir = path.join(cwd, ".flow");
   try {
@@ -185,6 +260,7 @@ export async function collectDoctorData(
     readProjectMcpConfigImpl = readProjectMcpConfig,
     readProjectTeamConfigImpl = readProjectTeamConfig,
     readProjectClaudeSettingsImpl = readProjectClaudeSettings,
+    readBundledPluginRuntimeDefaultsImpl = readBundledPluginRuntimeDefaults,
   } = {}
 ) {
   const claudeVersionValue = claudeVersionImpl();
@@ -212,6 +288,7 @@ export async function collectDoctorData(
     projectMcpConfig: await readProjectMcpConfigImpl(cwd),
     projectTeamConfig: await readProjectTeamConfigImpl(cwd),
     projectClaudeSettings: await readProjectClaudeSettingsImpl(cwd),
+    bundledPluginRuntimeDefaults: await readBundledPluginRuntimeDefaultsImpl(),
   };
 }
 

package/cli/install-next-steps.js

@@ -11,6 +11,8 @@ export function printNextSteps() {
   console.log(`${color.bold("Next steps")}:\n`);
   console.log(`  ${color.dim("# Verify health")}`);
   console.log(`  ${cliCmd} doctor\n`);
+  console.log(`  ${color.dim("# Review the bundled main-agent / monitor defaults")}`);
+  console.log(`  ${color.dim("# (doctor now prints CurDX-Flow runtime defaults and plugin option keys)")}\n`);
   console.log(`  ${color.dim("# Inside any project, initialize and start a feature spec")}`);
   console.log(`  ${color.cyan("cd ~/your-project")}`);
   console.log(`  ${color.cyan("claude")}`);

package/cli/lib/doctor-report.js

@@ -130,6 +130,7 @@ export function buildDoctorReport({
   projectMcpConfig,
   projectTeamConfig,
   projectClaudeSettings,
+  bundledPluginRuntimeDefaults,
 }) {
   const lines = [];
   const sections = [];
@@ -345,6 +346,63 @@ export function buildDoctorReport({
     }
   }
 
+  if (bundledPluginRuntimeDefaults?.exists) {
+    const bundledRuntimeSection = createSection("CurDX-Flow bundled runtime:");
+
+    if (bundledPluginRuntimeDefaults.defaultAgent) {
+      pushSectionLine(
+        bundledRuntimeSection,
+        "ok",
+        `Main thread agent     ${bundledPluginRuntimeDefaults.defaultAgent}`,
+        [
+          "plugin-level settings route the main Claude thread through this agent by default",
+        ]
+      );
+    }
+
+    if (bundledPluginRuntimeDefaults.subagentStatusLineCommand) {
+      pushSectionLine(
+        bundledRuntimeSection,
+        "info",
+        `Subagent status line  configured`,
+        [bundledPluginRuntimeDefaults.subagentStatusLineCommand]
+      );
+    }
+
+    if (bundledPluginRuntimeDefaults.monitorCount > 0) {
+      const monitorSummary = bundledPluginRuntimeDefaults.monitors
+        .map((monitor) => `${monitor.name} (${monitor.when})`)
+        .join(", ");
+      pushSectionLine(
+        bundledRuntimeSection,
+        "ok",
+        `Plugin monitors       ${bundledPluginRuntimeDefaults.monitorCount} configured`,
+        [
+          monitorSummary,
+          "official docs: plugin monitors run only in interactive Claude Code sessions where the Monitor tool is available",
+        ]
+      );
+    }
+
+    if ((bundledPluginRuntimeDefaults.userConfig || []).length > 0) {
+      const optionSummary = bundledPluginRuntimeDefaults.userConfig
+        .map((option) => {
+          const suffix = option.default === undefined ? "" : `=${String(option.default)}`;
+          return `${option.key}${suffix}`;
+        })
+        .join(", ");
+      pushSectionLine(
+        bundledRuntimeSection,
+        "info",
+        `Plugin options        ${bundledPluginRuntimeDefaults.userConfig.length} available`,
+        [
+          optionSummary,
+          "non-sensitive values are stored under pluginConfigs[curdx-flow@curdx-flow-marketplace].options in Claude settings.json",
+        ]
+      );
+    }
+  }
+
   const localProjectSection = createSection("Local project:");
   if (projectState?.exists) {
     pushSectionLine(localProjectSection, "ok", `.flow/                ${cwd}`);

package/package.json

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