@rex_koh/subagent-budget-guard 0.1.5 → 0.1.7

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "subagent-budget-guard",
   "displayName": "Subagent Budget Guard",
   "description": "Hard-deny subagent launches, record verified subagent usage, and enforce a session budget against Claude Code's 5-hour rate-limit percentage.",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "author": {
     "name": "ClaudeSubAgentSuppressor"
   },
@@ -13,57 +13,5 @@
     "rate-limit",
     "tokens",
     "hooks"
-  ],
-  "userConfig": {
-    "max_concurrent_subagents": {
-      "type": "number",
-      "title": "Max concurrent subagents",
-      "description": "Maximum simultaneously active subagents. The default 0 blocks all new subagents.",
-      "default": 0,
-      "min": 0,
-      "required": false
-    },
-    "max_subagent_tokens_per_session": {
-      "type": "number",
-      "title": "Max verified subagent tokens per session",
-      "description": "Maximum verified subagent tokens allowed in one session. Set 0 for no token cap.",
-      "default": 0,
-      "min": 0,
-      "required": false
-    },
-    "subagent_token_warning_threshold_percent": {
-      "type": "number",
-      "title": "Subagent token warning threshold percent",
-      "description": "Warn Claude to stop using subagents once verified subagent token usage reaches this percentage of max_subagent_tokens_per_session.",
-      "default": 95,
-      "min": 1,
-      "max": 100,
-      "required": false
-    },
-    "session_five_hour_budget_percent": {
-      "type": "number",
-      "title": "Session 5-hour budget percent",
-      "description": "Maximum percentage points of the current 5-hour Claude Code limit this session may consume after the statusLine bridge records its baseline.",
-      "default": 25,
-      "min": 0,
-      "max": 100,
-      "required": false
-    },
-    "absolute_five_hour_ceiling_percent": {
-      "type": "number",
-      "title": "Absolute 5-hour ceiling percent",
-      "description": "Block new prompts once Claude Code reports this absolute 5-hour usage percentage, regardless of this session's baseline.",
-      "default": 95,
-      "min": 0,
-      "max": 100,
-      "required": false
-    },
-    "enforcement_enabled": {
-      "type": "boolean",
-      "title": "Enable enforcement",
-      "description": "When true, hooks deny over-budget subagents and prompts. When false, the plugin records usage without blocking.",
-      "default": true,
-      "required": false
-    }
-  }
+  ]
 }

package/README.md

@@ -9,12 +9,12 @@ Recommended Claude Code install:
 ```text
 /plugin marketplace add rexkoh425/ClaudeSubAgentSuppressor
 /plugin install subagent-budget-guard@subagent-budget-tools
-/reload-plugins
 /subagent-budget-guard:setup
-/reload-plugins
 /subagent-budget-guard:verify
 ```
 
+After `/subagent-budget-guard:setup`, fully exit and reopen Claude Code before verification so the statusLine bridge from `settings.json` is active. Some Claude Code builds do not provide an in-session plugin reload command.
+
 Useful after install:
 
 ```text

package/lib/guard.js

@@ -1,5 +1,5 @@
 import { spawn } from 'node:child_process';
-import { constants as fsConstants } from 'node:fs';
+import { constants as fsConstants, readFileSync } from 'node:fs';
 import {
   access,
   mkdir,
@@ -74,18 +74,40 @@ function envValue(env, key) {
   return env[exact] ?? env[upper];
 }
 
-export function loadConfig(env = process.env) {
-  const config = { ...DEFAULT_CONFIG };
+function settingsPathForEnv(env) {
+  const homeDir = env.USERPROFILE || env.HOME;
+  if (!homeDir && env !== process.env) return null;
+  return path.join(homeDir || os.homedir(), '.claude', 'settings.json');
+}
 
+function readSettingsOptions(env) {
+  const settingsPath = settingsPathForEnv(env);
+  if (!settingsPath) return {};
+
+  try {
+    const text = readFileSync(settingsPath, 'utf8');
+    const settings = JSON.parse(text.replace(/^\uFEFF/, ''));
+    const options = settings?.pluginConfigs?.[PLUGIN_ID]?.options;
+    return isPlainObject(options) ? options : {};
+  } catch (error) {
+    if (error.code === 'ENOENT') return {};
+    if (error instanceof SyntaxError) return {};
+    throw error;
+  }
+}
+
+function applyConfigValues(config, valueForKey) {
   for (const key of CONFIG_KEYS) {
-    const value = envValue(env, key);
+    const value = valueForKey(key);
     if (NUMBER_KEYS.has(key)) {
-      config[key] = Math.max(0, asNumber(value, DEFAULT_CONFIG[key]));
+      config[key] = Math.max(0, asNumber(value, config[key]));
     } else if (typeof DEFAULT_CONFIG[key] === 'boolean') {
-      config[key] = asBoolean(value, DEFAULT_CONFIG[key]);
+      config[key] = asBoolean(value, config[key]);
     }
   }
+}
 
+function normalizeConfig(config) {
   config.session_five_hour_budget_percent = Math.min(
     100,
     config.session_five_hour_budget_percent
@@ -102,6 +124,16 @@ export function loadConfig(env = process.env) {
   return config;
 }
 
+export function loadConfig(env = process.env) {
+  const config = { ...DEFAULT_CONFIG };
+  const settingsOptions = readSettingsOptions(env);
+
+  applyConfigValues(config, (key) => settingsOptions[key]);
+  applyConfigValues(config, (key) => envValue(env, key));
+
+  return normalizeConfig(config);
+}
+
 export function getHomeDir(env = process.env) {
   return env.USERPROFILE || env.HOME || os.homedir();
 }

package/lib/verifier.js

@@ -90,7 +90,7 @@ export async function runOfflineVerification({
         entry.source?.package === '@rex_koh/subagent-budget-guard',
         'marketplace npm package mismatch'
       );
-      assert(entry.source?.version === '0.1.5', 'marketplace npm version mismatch');
+      assert(entry.source?.version === '0.1.7', 'marketplace npm version mismatch');
       return marketplacePath;
     });
   } else {
@@ -105,7 +105,7 @@ export async function runOfflineVerification({
     });
   }
 
-  await withCheck(result, 'plugin-manifest-user-config', async () => {
+  await withCheck(result, 'plugin-manifest-no-install-config', async () => {
     const manifestPath = path.join(root, '.claude-plugin', 'plugin.json');
     const manifest = await readJson(manifestPath);
     assert(manifest.name === 'subagent-budget-guard', 'plugin name mismatch');
@@ -117,13 +117,10 @@ export async function runOfflineVerification({
       manifest.skills === undefined,
       'manifest.skills must be omitted for default skills/ scanning to avoid duplicate loading'
     );
-    for (const key of CONFIG_KEYS) {
-      assert(manifest.userConfig?.[key], `missing userConfig.${key}`);
-      assert(
-        manifest.userConfig[key].required !== true,
-        `userConfig.${key} must not be required at install time`
-      );
-    }
+    assert(
+      manifest.userConfig === undefined,
+      'manifest.userConfig must be omitted so installs do not ask for --config flags'
+    );
     return manifestPath;
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rex_koh/subagent-budget-guard",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Claude Code plugin that blocks subagents by default, records verified subagent usage, and enforces 5-hour usage budgets.",
   "license": "MIT",
   "author": "ClaudeSubAgentSuppressor",

package/skills/setup/SKILL.md

@@ -22,7 +22,7 @@ absolute_five_hour_ceiling_percent=95
 enforcement_enabled=true
 ```
 
-Then tell the user to run `/reload-plugins`, interact with Claude Code once so the statusLine bridge receives fresh session JSON, and run:
+Then tell the user to fully exit and reopen Claude Code, interact once so the statusLine bridge receives fresh session JSON, and run:
 
 ```bash
 node "${CLAUDE_PLUGIN_ROOT}/bin/verify.js" --live