@curdx/flow 2.3.1 → 2.3.2

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "curdx-flow",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "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

@@ -99,6 +99,23 @@ const CURDX_FLOW_REQUIRED_TOOLS = [
   "Glob",
 ];
 const CURDX_FLOW_PLUGIN_ID = "curdx-flow@curdx-flow-marketplace";
+const CURDX_FLOW_PLUGIN_OPTIONS = {
+  autonomous_blocking: {
+    type: "boolean",
+    default: true,
+  },
+  daily_dependency_check: {
+    type: "boolean",
+    default: true,
+  },
+  monitor_interval_seconds: {
+    type: "number",
+    default: 8,
+    integer: true,
+    min: 3,
+    max: 60,
+  },
+};
 const CURDX_FLOW_REQUIRED_PLUGIN_IDS = ["context7-plugin@context7-marketplace"];
 const HTTP_HOOK_SETTINGS = ["allowedHttpHookUrls", "httpHookAllowedEnvVars"];
 const PERSISTED_EFFORT_LEVELS = ["low", "medium", "high", "xhigh"];
@@ -171,6 +188,171 @@ function pushScopedWarning(target, kind, message, scope = "project") {
   target.push(warning);
 }
 
+function createCurdxFlowPluginOptionsState() {
+  const definitions = Object.entries(CURDX_FLOW_PLUGIN_OPTIONS).map(([key, value]) => ({
+    key,
+    type: value.type,
+    default: value.default,
+    min: value.min,
+    max: value.max,
+    integer: value.integer === true,
+  }));
+
+  const repoEffective = Object.fromEntries(
+    definitions.map((definition) => [
+      definition.key,
+      { value: definition.default, source: "default" },
+    ])
+  );
+
+  return {
+    pluginId: CURDX_FLOW_PLUGIN_ID,
+    definitions,
+    project: {
+      pluginConfigsPresent: false,
+      pluginConfigPresent: false,
+      optionsPresent: false,
+      overrides: {},
+    },
+    local: {
+      pluginConfigsPresent: false,
+      pluginConfigPresent: false,
+      optionsPresent: false,
+      overrides: {},
+    },
+    repoEffective,
+  };
+}
+
+function pluginScopeLabel(scope) {
+  return scope === "local" ? "settings.local.json" : "settings.json";
+}
+
+function auditCurdxFlowPluginOptions(parsed, warnings, pluginOptionsState, scope = "project") {
+  if (!isNonArrayObject(parsed) || !("pluginConfigs" in parsed)) {
+    return;
+  }
+
+  const target = scope === "local" ? pluginOptionsState.local : pluginOptionsState.project;
+  const settingsLabel = pluginScopeLabel(scope);
+  target.pluginConfigsPresent = true;
+
+  if (!isNonArrayObject(parsed.pluginConfigs)) {
+    pushScopedWarning(
+      warnings,
+      scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+      `pluginConfigs in ${settingsLabel} must be an object keyed by plugin@marketplace id`,
+      scope
+    );
+    return;
+  }
+
+  const pluginConfig = parsed.pluginConfigs[CURDX_FLOW_PLUGIN_ID];
+  if (pluginConfig === undefined) {
+    return;
+  }
+
+  target.pluginConfigPresent = true;
+
+  if (!isNonArrayObject(pluginConfig)) {
+    pushScopedWarning(
+      warnings,
+      scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+      `pluginConfigs[${CURDX_FLOW_PLUGIN_ID}] in ${settingsLabel} must be an object when set`,
+      scope
+    );
+    return;
+  }
+
+  if (!("options" in pluginConfig)) {
+    return;
+  }
+
+  target.optionsPresent = true;
+
+  if (!isNonArrayObject(pluginConfig.options)) {
+    pushScopedWarning(
+      warnings,
+      scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+      `pluginConfigs[${CURDX_FLOW_PLUGIN_ID}].options in ${settingsLabel} must be an object when set`,
+      scope
+    );
+    return;
+  }
+
+  for (const [key, value] of Object.entries(pluginConfig.options)) {
+    const definition = CURDX_FLOW_PLUGIN_OPTIONS[key];
+
+    if (!definition) {
+      pushScopedWarning(
+        warnings,
+        "unknown-plugin-option",
+        `unknown CurDX-Flow plugin option in ${settingsLabel}: ${key}`,
+        scope
+      );
+      continue;
+    }
+
+    if (definition.type === "boolean" && typeof value !== "boolean") {
+      pushScopedWarning(
+        warnings,
+        scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+        `CurDX-Flow plugin option ${key} in ${settingsLabel} must be boolean`,
+        scope
+      );
+      continue;
+    }
+
+    if (definition.type === "number") {
+      if (typeof value !== "number" || Number.isNaN(value)) {
+        pushScopedWarning(
+          warnings,
+          scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+          `CurDX-Flow plugin option ${key} in ${settingsLabel} must be a number`,
+          scope
+        );
+        continue;
+      }
+
+      if (definition.integer && !Number.isInteger(value)) {
+        pushScopedWarning(
+          warnings,
+          scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+          `CurDX-Flow plugin option ${key} in ${settingsLabel} must be an integer`,
+          scope
+        );
+        continue;
+      }
+
+      if (typeof definition.min === "number" && value < definition.min) {
+        pushScopedWarning(
+          warnings,
+          scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+          `CurDX-Flow plugin option ${key} in ${settingsLabel} must be between ${definition.min} and ${definition.max}`,
+          scope
+        );
+        continue;
+      }
+
+      if (typeof definition.max === "number" && value > definition.max) {
+        pushScopedWarning(
+          warnings,
+          scope === "local" ? "invalid-local-setting" : "invalid-project-setting",
+          `CurDX-Flow plugin option ${key} in ${settingsLabel} must be between ${definition.min} and ${definition.max}`,
+          scope
+        );
+        continue;
+      }
+    }
+
+    target.overrides[key] = value;
+    pluginOptionsState.repoEffective[key] = {
+      value,
+      source: scope,
+    };
+  }
+}
+
 function auditLocalClaudeSettings(parsed, warnings) {
   const scope = "local";
   const permissions = parsed?.permissions && typeof parsed.permissions === "object"
@@ -374,6 +556,7 @@ export async function readProjectClaudeSettings(cwd = process.cwd()) {
     localInvalid: false,
     localParseError: null,
     localWarnings: [],
+    pluginOptions: createCurdxFlowPluginOptionsState(),
   };
 
   try {
@@ -407,6 +590,8 @@ export async function readProjectClaudeSettings(cwd = process.cwd()) {
     const allow = Array.isArray(permissions.allow) ? permissions.allow : [];
     const deny = Array.isArray(permissions.deny) ? permissions.deny : [];
 
+    auditCurdxFlowPluginOptions(parsed, state.warnings, state.pluginOptions, "project");
+
     if ("enabledPlugins" in parsed && (
       !parsed.enabledPlugins ||
       typeof parsed.enabledPlugins !== "object" ||
@@ -726,6 +911,7 @@ export async function readProjectClaudeSettings(cwd = process.cwd()) {
   if (state.localExists) {
     try {
       const localParsed = JSON.parse(await fs.readFile(localSettingsPath, "utf-8"));
+      auditCurdxFlowPluginOptions(localParsed, state.localWarnings, state.pluginOptions, "local");
       auditLocalClaudeSettings(localParsed, state.localWarnings);
     } catch (error) {
       state.localInvalid = true;

package/cli/lib/doctor-report.js

@@ -14,6 +14,26 @@ function pluginErrorDetails(plugin) {
 
 function projectSettingsWarningDetails(warning) {
   if (warning?.scope === "local") {
+    if (warning.kind === "unknown-plugin-option") {
+      return [
+        "settings.local.json overrides shared project settings on this machine",
+        "remove the unknown key or rename it to a supported CurDX-Flow plugin option under pluginConfigs[curdx-flow@curdx-flow-marketplace].options",
+      ];
+    }
+
+    if (
+      warning.kind === "invalid-local-setting" &&
+      (
+        warning.message?.includes("pluginConfigs[curdx-flow@curdx-flow-marketplace]") ||
+        warning.message?.includes("CurDX-Flow plugin option")
+      )
+    ) {
+      return [
+        "CurDX-Flow plugin options in settings.local.json override project and user settings on this machine",
+        "use boolean values for autonomous_blocking and daily_dependency_check, and keep monitor_interval_seconds as an integer between 3 and 60",
+      ];
+    }
+
     if (warning.kind === "invalid-local-setting") {
       return [
         "settings.local.json is the highest-precedence repo-scoped settings surface on this machine",
@@ -41,6 +61,26 @@ function projectSettingsWarningDetails(warning) {
     ];
   }
 
+  if (warning.kind === "unknown-plugin-option") {
+    return [
+      "CurDX-Flow only reads keys declared in the plugin manifest",
+      "remove the unknown key or rename it under pluginConfigs[curdx-flow@curdx-flow-marketplace].options",
+    ];
+  }
+
+  if (
+    warning.kind === "invalid-project-setting" &&
+    (
+      warning.message?.includes("pluginConfigs[curdx-flow@curdx-flow-marketplace]") ||
+      warning.message?.includes("CurDX-Flow plugin option")
+    )
+  ) {
+    return [
+      "CurDX-Flow non-sensitive plugin options belong under pluginConfigs[curdx-flow@curdx-flow-marketplace].options in .claude/settings.json",
+      "use boolean values for autonomous_blocking and daily_dependency_check, and keep monitor_interval_seconds as an integer between 3 and 60",
+    ];
+  }
+
   if (!warning?.kind) {
     return [
       "project settings are shared with collaborators",
@@ -116,6 +156,11 @@ function projectSettingsWarningDetails(warning) {
   ];
 }
 
+function formatInlineValue(value) {
+  if (typeof value === "string") return `"${value}"`;
+  return String(value);
+}
+
 export function buildDoctorReport({
   claudeVersionValue,
   nodeVersion,
@@ -403,6 +448,97 @@ export function buildDoctorReport({
     }
   }
 
+  if (
+    bundledPluginRuntimeDefaults?.exists ||
+    projectClaudeSettings?.pluginOptions
+  ) {
+    const configuredOptionsSection = createSection("CurDX-Flow configured options:");
+    const optionState = projectClaudeSettings?.pluginOptions;
+    const projectOverrides = optionState?.project?.overrides || {};
+    const localOverrides = optionState?.local?.overrides || {};
+    const repoEffective = optionState?.repoEffective || {};
+    const definitions = bundledPluginRuntimeDefaults?.userConfig?.length
+      ? bundledPluginRuntimeDefaults.userConfig
+      : (optionState?.definitions || []);
+
+    pushSectionLine(
+      configuredOptionsSection,
+      "info",
+      "Scope precedence      settings.local.json > settings.json > bundled default",
+      [
+        "this section audits repo-scoped CurDX-Flow plugin options only",
+        "user-level ~/.claude/settings.json is not inspected here",
+      ]
+    );
+
+    if (Object.keys(projectOverrides).length > 0) {
+      const summary = Object.entries(projectOverrides)
+        .map(([key, value]) => `${key}=${formatInlineValue(value)}`)
+        .join(", ");
+      pushSectionLine(
+        configuredOptionsSection,
+        "info",
+        `.claude/settings.json ${Object.keys(projectOverrides).length} valid override(s)`,
+        [
+          summary,
+          "path: pluginConfigs[curdx-flow@curdx-flow-marketplace].options",
+        ]
+      );
+    } else {
+      pushSectionLine(
+        configuredOptionsSection,
+        "info",
+        ".claude/settings.json no CurDX-Flow repo override"
+      );
+    }
+
+    if (projectClaudeSettings?.localExists) {
+      if (Object.keys(localOverrides).length > 0) {
+        const summary = Object.entries(localOverrides)
+          .map(([key, value]) => `${key}=${formatInlineValue(value)}`)
+          .join(", ");
+        pushSectionLine(
+          configuredOptionsSection,
+          "info",
+          `.claude/settings.local.json ${Object.keys(localOverrides).length} valid override(s)`,
+          [
+            summary,
+            "local overrides have higher precedence than .claude/settings.json on this machine",
+          ]
+        );
+      } else {
+        pushSectionLine(
+          configuredOptionsSection,
+          "info",
+          ".claude/settings.local.json present without valid CurDX-Flow overrides"
+        );
+      }
+    } else {
+      pushSectionLine(
+        configuredOptionsSection,
+        "info",
+        ".claude/settings.local.json not present"
+      );
+    }
+
+    for (const definition of definitions) {
+      const effective = repoEffective[definition.key] || {
+        value: definition.default,
+        source: "default",
+      };
+      const sourceLabel = effective.source === "local"
+        ? "local"
+        : effective.source === "project"
+          ? "project"
+          : "bundled default";
+      pushSectionLine(
+        configuredOptionsSection,
+        "ok",
+        `${definition.key.padEnd(22)} ${formatInlineValue(effective.value)} (${sourceLabel})`
+      );
+    }
+  }
+
   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.1",
+  "version": "2.3.2",
   "description": "Skill-first discipline layer and CLI installer for Claude Code",
   "type": "module",
   "bin": {