@sienklogic/plan-build-run 2.19.1 → 2.19.2

package/plugins/pbr/scripts/session-cleanup.js

@@ -24,7 +24,6 @@ const { logHook, getLogFilename: getHooksFilename, cleanOldHookLogs } = require(
 const { getLogFilename: getEventsFilename, cleanOldEventLogs } = require('./event-logger');
 const { tailLines, configLoad } = require('./pbr-tools');
 const { removeSessionDir, releaseSessionClaims } = require('./lib/core');
-const { readSessionMetrics, summarizeMetrics, formatSessionSummary } = require('./lib/local-llm/metrics');
 const { writeSnapshot } = require('./lib/snapshot-manager');
 
 function readStdin() {
@@ -492,35 +491,6 @@ function main() {
     }
   } catch (_e) { /* metrics display is best-effort */ }
 
-  // Local LLM metrics summary (SessionEnd — sync reads only, never throws)
-  let llmAdditionalContext = null;
-  try {
-    const sessionStartFile = path.join(planningDir, '.session-start');
-    if (fs.existsSync(sessionStartFile)) {
-      const sessionStartTime = fs.readFileSync(sessionStartFile, 'utf8').trim();
-      const entries = readSessionMetrics(planningDir, sessionStartTime);
-      if (entries.length > 0) {
-        const summary = summarizeMetrics(entries);
-        logHook('session-cleanup', 'SessionEnd', 'llm-metrics', {
-          total_calls: summary.total_calls,
-          fallback_count: summary.fallback_count,
-          avg_latency_ms: summary.avg_latency_ms,
-          tokens_saved: summary.tokens_saved,
-          cost_saved_usd: summary.cost_saved_usd
-        });
-        if (summary.total_calls > 0) {
-          let modelName = null;
-          try {
-            const rawConfig = configLoad(planningDir) || {};
-            modelName = (rawConfig.local_llm && rawConfig.local_llm.model) || null;
-          } catch (_e) { /* config read failure is non-fatal */ }
-          llmAdditionalContext = formatSessionSummary(summary, modelName);
-        }
-      }
-      // Clean up session-start file
-      try { fs.unlinkSync(sessionStartFile); } catch (_e) { /* non-fatal */ }
-    }
-  } catch (_e) { /* metrics never crash the hook */ }
 
   // Surface compliance violations from this session
   let complianceContext = null;
@@ -568,7 +538,7 @@ function main() {
     // Snapshot failure must never crash SessionEnd
   }
 
-  const combinedContext = [metricsContext, llmAdditionalContext, complianceContext].filter(Boolean).join('\n');
+  const combinedContext = [metricsContext, complianceContext].filter(Boolean).join('\n');
   if (combinedContext) {
     process.stdout.write(JSON.stringify({ additionalContext: combinedContext }) + '\n');
   }

package/plugins/pbr/scripts/status-line.js

@@ -16,6 +16,7 @@ const cp = require('child_process');
 const { logHook } = require('./hook-logger');
 const { configLoad } = require('./pbr-tools');
 const { resolveSessionPath } = require('./lib/core');
+const { extractFrontmatter } = require('./lib/frontmatter');
 // ANSI color codes
 const c = {
   reset: '\x1b[0m',
@@ -542,26 +543,27 @@ function main() {
 
 /**
  * Parse YAML frontmatter from STATE.md content.
- * Returns an object with frontmatter fields, or null if no frontmatter.
+ * Thin adapter around canonical extractFrontmatter preserving null-on-missing
+ * and filtering out null/undefined string values for status-line display.
  */
-function parseFrontmatter(content) {
+const parseFrontmatter = (content) => {
   if (!content.startsWith('---')) return null;
   const endIdx = content.indexOf('---', 3);
   if (endIdx === -1) return null;
-  const fm = content.substring(3, endIdx);
+  const raw = extractFrontmatter(content);
   const result = {};
-  for (const line of fm.split(/\r?\n/)) {
-    const m = line.match(/^(\w[\w_]*):\s*"?([^"]*)"?\s*$/);
-    if (m) {
-      const val = m[2].trim();
-      // Skip YAML nulls and empty values — they'd render as literal "null"
-      if (val && val !== 'null' && val !== 'undefined') {
-        result[m[1]] = val;
+  for (const [key, val] of Object.entries(raw)) {
+    if (typeof val === 'object') {
+      // Keep objects/arrays (non-empty)
+      if (Array.isArray(val) ? val.length > 0 : Object.keys(val).length > 0) {
+        result[key] = val;
       }
+    } else if (typeof val === 'string' && val && val !== 'null' && val !== 'undefined') {
+      result[key] = val;
     }
   }
   return result;
-}
+};
 
 function buildStatusLine(content, ctxPercent, cfg, stdinData, planningDir) {
   const config = cfg || DEFAULTS;

package/plugins/pbr/scripts/suggest-compact.js

@@ -9,7 +9,7 @@
  * fresh (<60s old). CRITICAL tier always emits; others use REMINDER_INTERVAL debounce.
  *
  * Fallback: when bridge is absent or stale, uses call-count threshold.
- * Counter stored in .planning/.compact-counter (JSON).
+ * Counter stored in .planning/.compact-counter (JSON) and .session.json.
  * Threshold configurable via config.json hooks.compactThreshold (default: 50).
  * Counter resets on SessionStart (via progress-tracker.js).
  *
@@ -281,15 +281,7 @@ function resetCounter(planningDir, sessionId) {
     sessionSave(planningDir, { compactCounter: { count: 0, lastSuggested: 0 } }, sessionId);
   } catch (_e) { /* best-effort */ }
 
-  // Legacy: also delete .compact-counter file if present
-  const counterPath = path.join(planningDir, '.compact-counter');
-  try {
-    if (fs.existsSync(counterPath)) {
-      fs.unlinkSync(counterPath);
-    }
-  } catch (_e) {
-    // Best-effort
-  }
+  // .compact-counter cleanup removed -- legacy file no longer used
 }
 
 /**

package/plugins/pbr/scripts/test/state.test.js

@@ -66,19 +66,11 @@ describe('parseStateMd', () => {
     assert.strictEqual(crlfResult.plans_complete, lfResult.plans_complete);
   });
 
-  it('parses legacy v1 format correctly', () => {
-    // Suppress the deprecation warning to stderr
-    const origWrite = process.stderr.write;
-    process.stderr.write = () => true;
-    try {
-      const result = parseStateMd(STATE_V1);
-      assert.strictEqual(result.format, 'legacy');
-      assert.strictEqual(result.current_phase, 2);
-      assert.strictEqual(result.status, 'planned');
-      assert.strictEqual(result.progress, 20);
-    } finally {
-      process.stderr.write = origWrite;
-    }
+  it('returns nulls for v1 format (no longer parsed)', () => {
+    const content = '# State\n\nPhase: 2 of 6\nStatus: built\nProgress: 33%\n';
+    const result = parseStateMd(content);
+    expect(result.format).toBe('frontmatter');
+    expect(result.current_phase).toBeNull();
   });
 
   it('returns defaults for empty content', () => {

package/plugins/pbr/scripts/validate-commit.js

@@ -26,8 +26,6 @@ const path = require('path');
 const { execSync } = require('child_process');
 const { logHook } = require('./hook-logger');
 const { logEvent } = require('./event-logger');
-const { resolveConfig } = require('./lib/local-llm/health');
-const { classifyCommit } = require('./lib/local-llm/operations/classify-commit');
 
 const VALID_TYPES = ['feat', 'fix', 'refactor', 'test', 'docs', 'chore', 'wip', 'revert', 'perf', 'ci', 'build'];
 
@@ -75,7 +73,13 @@ function checkAiCoAuthorResult(command, sessionId) {
 
 function checkSensitiveFilesResult(sessionId) {
   try {
-    const output = execSync('git diff --cached --name-only', { encoding: 'utf8' });
+    let output;
+    try {
+      output = execSync('git diff --cached --name-only', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+    } catch (_e) {
+      // git diff --cached fails during git tag or in --no-index contexts
+      return null;
+    }
     const files = output.trim().split('\n').filter(Boolean);
 
     const matched = files.filter((file) => {
@@ -157,58 +161,6 @@ function checkCommit(data) {
   return null;
 }
 
-/**
- * Load and resolve the local_llm config block from .planning/config.json.
- * Returns a resolved config (always safe to use — disabled by default on error).
- */
-function loadLocalLlmConfig(cwd) {
-  try {
-    const configPath = path.join(cwd || process.cwd(), '.planning', 'config.json');
-    const parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    return resolveConfig(parsed.local_llm);
-  } catch (_e) {
-    return resolveConfig(undefined);
-  }
-}
-
-/**
- * Async LLM enrichment for commit messages. Returns an advisory string or null.
- * Called after checkCommit passes (valid format) to provide semantic classification.
- *
- * @param {object} data - parsed hook data
- * @returns {Promise<string|null>}
- */
-async function enrichCommitLlm(data) {
-  try {
-    const command = data.tool_input?.command || '';
-    const message = extractCommitMessage(command);
-    if (!message) return null;
-
-    const cwd = process.cwd();
-    const llmConfig = loadLocalLlmConfig(cwd);
-    const planningDir = path.join(cwd, '.planning');
-
-    // Get staged files for scope validation
-    let stagedFiles = [];
-    try {
-      const output = execSync('git diff --cached --name-only', { encoding: 'utf8' });
-      stagedFiles = output.trim().split('\n').filter(Boolean);
-    } catch (_e) {
-      // Not in a git repo — skip staged files context
-    }
-
-    const llmResult = await classifyCommit(llmConfig, planningDir, message, stagedFiles, data.session_id);
-    if (llmResult && llmResult.classification !== 'correct') {
-      return 'LLM commit advisory: ' + llmResult.classification +
-        ' (confidence: ' + (llmResult.confidence * 100).toFixed(0) + '%)';
-    }
-    return null;
-  } catch (_llmErr) {
-    // Never propagate LLM errors
-    return null;
-  }
-}
-
 function main() {
   let input = '';
 
@@ -223,14 +175,6 @@ function main() {
         process.exit(result.exitCode);
       }
 
-      // LLM semantic classification — advisory only (after format validation passes)
-      const llmAdvisory = await enrichCommitLlm(data);
-      if (llmAdvisory) {
-        process.stdout.write(JSON.stringify({
-          additionalContext: '[pbr] ' + llmAdvisory
-        }));
-      }
-
       process.exit(0);
     } catch (_e) {
       // Parse error - don't block
@@ -267,5 +211,5 @@ function extractCommitMessage(command) {
   return null;
 }
 
-module.exports = { checkCommit, enrichCommitLlm };
+module.exports = { checkCommit };
 if (require.main === module || process.argv[1] === __filename) { main(); }

package/plugins/pbr/scripts/validate-task.js

@@ -20,8 +20,6 @@
 const fs = require('fs');
 const path = require('path');
 const { logHook } = require('./hook-logger');
-const { resolveConfig } = require('./lib/local-llm/health');
-const { validateTask: llmValidateTask } = require('./lib/local-llm/operations/validate-task');
 const { checkNonPbrAgent } = require('./enforce-pbr-workflow');
 const { KNOWN_AGENTS } = require('./lib/core');
 
@@ -39,21 +37,6 @@ const { checkDebuggerAdvisory, checkCheckpointManifest, checkActiveSkillIntegrit
 const { checkDocExistence } = require('./lib/gates/doc-existence');
 const { checkUserConfirmationGate } = require('./lib/gates/user-confirmation');
 
-/**
- * Load and resolve the local_llm config block from .planning/config.json.
- * Returns a resolved config (always safe to use — disabled by default on error).
- * @param {string} cwd - working directory to resolve .planning/config.json from
- */
-function loadLocalLlmConfig(cwd) {
-  try {
-    const configPath = path.join(cwd, '.planning', 'config.json');
-    const parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    return resolveConfig(parsed.local_llm);
-  } catch (_e) {
-    return resolveConfig(undefined);
-  }
-}
-
 const MAX_DESCRIPTION_LENGTH = 100;
 
 /**
@@ -264,19 +247,6 @@ function main() {
       if (nonPbrAgentResult) warnings.push(nonPbrAgentResult.output.additionalContext);
       if (planValGate && planValGate.warning) warnings.push(planValGate.warning);
 
-      // LLM task coherence check — advisory only
-      try {
-        const llmCwd = process.env.PBR_PROJECT_ROOT || process.cwd();
-        const llmConfig = loadLocalLlmConfig(llmCwd);
-        const planningDir = path.join(llmCwd, '.planning');
-        const llmResult = await llmValidateTask(llmConfig, planningDir, data.tool_input || {}, data.session_id);
-        if (llmResult && !llmResult.coherent) {
-          warnings.push('LLM task coherence advisory: ' + (llmResult.issue || 'Task description may not match intended operation.') + ' (confidence: ' + (llmResult.confidence * 100).toFixed(0) + '%)');
-        }
-      } catch (_llmErr) {
-        // Never propagate LLM errors
-      }
-
       if (warnings.length > 0) {
         for (const warning of warnings) {
           logHook('validate-task', 'PreToolUse', 'warn', { warning });

package/plugins/pbr/skills/begin/SKILL.md

@@ -2,6 +2,7 @@
 name: begin
 description: "Start a new project. Deep questioning, research, requirements, and roadmap."
 allowed-tools: Read, Write, Bash, Glob, Grep, WebFetch, WebSearch, Task, AskUserQuestion
+argument-hint: "[--auto]"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/skills/begin/templates/config.json.tmpl

@@ -378,7 +378,6 @@
     "debug.max_hypothesis_rounds: 1-20 — max hypothesis cycles for /pbr:debug",
     "depth_profiles: override built-in quick/standard/comprehensive defaults",
     "developer_profile: behavioral profiling from session history + prompt injection",
-    "(DEPRECATED) local_llm: offload classification tasks to local Ollama instance — removed in v14.0",
     "prd.auto_extract: skip confirmation gate during PRD import",
     "spinner_tips: custom messages shown during agent execution",
     "status_line: status bar appearance (sections, branding, context bar)",
@@ -398,9 +397,6 @@
     "enabled": false,
     "inject_prompts": false
   },
-  "local_llm": {
-    "enabled": false
-  },
   "prd": {
     "auto_extract": false
   },

package/plugins/pbr/skills/build/SKILL.md

@@ -749,13 +749,13 @@ For each plan that completed successfully in this wave:
 
 **Skip if** `features.security_scanning` is not `true` in `.planning/config.json`.
 
-Run an OWASP-style security scan over the files changed during this wave using the patterns in `plan-build-run/bin/lib/security-scan.cjs`.
+Run an OWASP-style security scan over the files changed during this wave using the patterns in `plugins/pbr/scripts/lib/security-scan.js`.
 
 ```bash
 node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js security scan '{space-separated changed files}'
 ```
 
-(`scanFiles()` in `plan-build-run/bin/lib/security-scan.cjs`)
+(`scanFiles()` in `plugins/pbr/scripts/lib/security-scan.js`)
 
 Display formatted findings:
 
@@ -763,7 +763,7 @@ Display formatted findings:
 node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js security format-findings '{scan-output-json}'
 ```
 
-(`formatFindings()` in `plan-build-run/bin/lib/security-scan.cjs`)
+(`formatFindings()` in `plugins/pbr/scripts/lib/security-scan.js`)
 
 Output format:
 - If no findings: `✓ Security scan: clean`
@@ -782,13 +782,13 @@ HIGH-severity findings (hardcoded secrets, SQL injection, eval-of-user-input) re
 
 **Skip if** `features.regression_prevention` is not `true` in `.planning/config.json`.
 
-After each wave, identify which test files are relevant to the changed source files using `plan-build-run/bin/lib/test-selection.cjs`. Run only those tests instead of the full suite — this catches regressions early without the latency of a full test run.
+After each wave, identify which test files are relevant to the changed source files using `plugins/pbr/scripts/lib/test-selection.js`. Run only those tests instead of the full suite — this catches regressions early without the latency of a full test run.
 
 ```bash
 node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js test-selection select '{space-separated changed files}'
 ```
 
-(`selectTests()` in `plan-build-run/bin/lib/test-selection.cjs`)
+(`selectTests()` in `plugins/pbr/scripts/lib/test-selection.js`)
 
 Then format the test command:
 
@@ -796,7 +796,7 @@ Then format the test command:
 node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js test-selection format-command '{selection-output-json}'
 ```
 
-(`formatTestCommand()` in `plan-build-run/bin/lib/test-selection.cjs`)
+(`formatTestCommand()` in `plugins/pbr/scripts/lib/test-selection.js`)
 
 Run the resulting command (e.g., `npm test -- tests/foo.test.js tests/bar.test.js`) via Bash. Display:
 - `✓ Smart tests ({N} files): all passed`

package/plugins/pbr/skills/config/SKILL.md

@@ -2,6 +2,7 @@
 name: config
 description: "Configure settings: depth, model profiles, features, git, and gates."
 allowed-tools: Read, Write, Bash, Glob, AskUserQuestion
+argument-hint: "set <key> <value> | get <key> | list"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/skills/help/SKILL.md

@@ -2,6 +2,7 @@
 name: help
 description: "Command reference and workflow guide for Plan-Build-Run."
 allowed-tools: Read, Bash
+argument-hint: "[command]"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/skills/pause/SKILL.md

@@ -2,6 +2,7 @@
 name: pause
 description: "Save your current session state for later resumption."
 allowed-tools: Read, Write, Bash, Glob
+argument-hint: "[reason]"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/skills/profile-user/SKILL.md

@@ -2,6 +2,7 @@
 name: profile-user
 description: "Analyze Claude Code session history to generate a developer behavioral profile across 8 dimensions."
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+argument-hint: "[--sessions N]"
 ---
 
 **STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes tokens. Begin executing Step 0 immediately.**

package/plugins/pbr/skills/quick/SKILL.md

@@ -2,6 +2,7 @@
 name: quick
 description: "Execute an ad-hoc task with atomic commits. Skips full plan/review."
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Task, AskUserQuestion
+argument-hint: "<description> [--discuss] [--full]"
 ---
 
 **STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 0 immediately.**
@@ -245,7 +246,7 @@ After the executor completes:
 
 2. **Generate post-hoc SUMMARY.md** (if `features.post_hoc_artifacts` is not `false`):
    ```bash
-   node -e "const ph=require('./plan-build-run/bin/lib/post-hoc.cjs'); ph.generateSummary(process.argv[1], process.argv[2], {commitPattern: 'quick-{NNN}', description: '{description}'})" .planning ".planning/quick/{NNN}-{slug}"
+   node -e "const ph=require('./plugins/pbr/scripts/lib/post-hoc.js'); ph.generateSummary(process.argv[1], process.argv[2], {commitPattern: 'quick-{NNN}', description: '{description}'})" .planning ".planning/quick/{NNN}-{slug}"
    ```
    - If `features.post_hoc_artifacts` is `false`: skip SUMMARY.md generation
 

package/plugins/pbr/skills/resume/SKILL.md

@@ -2,6 +2,7 @@
 name: resume
 description: "Pick up where you left off. Restores context and suggests next action."
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
+argument-hint: "[--from <file>]"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/skills/scan/SKILL.md

@@ -2,6 +2,7 @@
 name: scan
 description: "Analyze an existing codebase. Maps structure, architecture, conventions, and concerns."
 allowed-tools: Read, Write, Bash, Glob, Grep, Task, AskUserQuestion
+argument-hint: "[--focus tech|arch|quality|concerns]"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/skills/setup/SKILL.md

@@ -2,6 +2,7 @@
 name: setup
 description: "Reconfigure an existing Plan-Build-Run project (models, features, CLAUDE.md)."
 allowed-tools: Read, Write, Bash, Glob, AskUserQuestion
+argument-hint: "[--models] [--features] [--hooks]"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/skills/shared/state-update.md

@@ -100,7 +100,7 @@ Resume file: {path or "None"}
 
 ## Size Limit Enforcement
 
-**Hard limit: 150 lines.** After every STATE.md write, check the line count. If over 150 lines, compact:
+**Hard limit: 100 lines.** After every STATE.md write, check the line count. If over 100 lines, compact:
 
 1. **Collapse completed phase entries** to one-liners:
    ```
@@ -111,7 +111,7 @@ Resume file: {path or "None"}
 3. **Remove old session entries** -- keep only the current session's continuity data
 4. **Keep these always:** current phase detail, active blockers, core value statement, milestone info
 
-If still over 150 lines after compaction, the Accumulated Context section has grown too large. Move non-critical decisions to the phase's CONTEXT.md file.
+If still over 100 lines after compaction, the Accumulated Context section has grown too large. Move non-critical decisions to the phase's CONTEXT.md file.
 
 ---
 

package/plugins/pbr/skills/status/SKILL.md

@@ -2,6 +2,7 @@
 name: status
 description: "Show current project status and suggest what to do next."
 allowed-tools: Read, Glob, Grep, Bash, AskUserQuestion
+argument-hint: "[--json]"
 ---
 
 **STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.**

package/plugins/pbr/references/behavioral-contexts.md

@@ -1,53 +0,0 @@
-# Behavioral Contexts
-
-PBR supports 3 behavioral context profiles that adjust agent behavior based on the current activity.
-
-## Context Profiles
-
-| Context | Risk Tolerance | Verbosity | Focus | Use When |
-|---------|---------------|-----------|-------|----------|
-| `dev` | Medium | Low | Shipping code | Building features, executing plans |
-| `research` | Low | High | Thoroughness | Researching approaches, exploring options |
-| `review` | Very Low | Medium | Accuracy | Verifying work, reviewing code |
-
-## How Contexts Affect Agents
-
-### `dev` Context (default during execute-phase)
-- Executor: Focused, concise output, 3-attempt bug fix limit
-- Deviations: Log and continue for minor issues
-- Verification: Standard must_have checking
-
-### `research` Context (default during plan-phase, research-phase)
-- Researcher: Exhaustive source checking, S0-S6 hierarchy enforced
-- Planner: Extra validation passes, dependency verification
-- Output: Detailed reasoning, cite sources
-
-### `review` Context (default during verify-work)
-- Verifier: Strict must_have checking, severity-level reporting
-- Integration checker: Full CRUD flow verification
-- Output: Structured findings with severity levels
-
-## Configuration
-
-Set in `.planning/config.json`:
-```json
-{
-  "behavioral_context": "auto"
-}
-```
-
-Or override per-command via pbr-tools:
-```bash
-node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js resolve-context --raw
-# Returns: {"context": "dev", "risk_tolerance": "medium", "verbosity": "low"}
-```
-
-## Automatic Context Selection
-
-When `behavioral_context` is not set or set to `"auto"` (default):
-- `/pbr:execute-phase` -> `dev`
-- `/pbr:plan-phase` -> `research`
-- `/pbr:research-phase` -> `research`
-- `/pbr:verify-work` -> `review`
-- `/pbr:quick` -> `dev`
-- All others -> `dev`

package/plugins/pbr/scripts/lib/autonomy.js

@@ -1,91 +0,0 @@
-'use strict';
-
-/**
- * lib/autonomy.js — Progressive autonomy level resolver.
- *
- * Maps autonomy levels to concrete behavior flags that skills and agents
- * use to decide approval gates, UAT skipping, and retry behavior.
- *
- * Levels:
- *   supervised    — Human approves all actions
- *   guided        — AI acts, human reviews asynchronously
- *   collaborative — AI handles routine, escalates novel
- *   adaptive      — AI adjusts own level per task confidence
- */
-
-/** All valid autonomy levels. */
-const AUTONOMY_LEVELS = ['supervised', 'guided', 'collaborative', 'adaptive'];
-
-/** Confidence thresholds for adaptive mode. */
-const ADAPTIVE_THRESHOLDS = {
-  HIGH: 0.90,
-  LOW: 0.70
-};
-
-/** Behavior preset for each static level. */
-const LEVEL_BEHAVIORS = {
-  supervised: {
-    requiresApproval: true,
-    skipUAT: false,
-    autoRetry: false
-  },
-  guided: {
-    requiresApproval: false,
-    skipUAT: true,
-    autoRetry: false
-  },
-  collaborative: {
-    requiresApproval: false,
-    skipUAT: true,
-    autoRetry: true
-  }
-};
-
-/**
- * Resolve the autonomy behavior for a given level and task confidence.
- *
- * @param {string} [level] - Autonomy level (supervised/guided/collaborative/adaptive). Defaults to supervised.
- * @param {number} [taskConfidence=0.5] - Task confidence score 0-1 (used by adaptive mode).
- * @returns {{ requiresApproval: boolean, skipUAT: boolean, autoRetry: boolean, effectiveLevel: string }}
- */
-function resolveAutonomyBehavior(level, taskConfidence) {
-  const confidence = typeof taskConfidence === 'number' ? taskConfidence : 0.5;
-
-  // Adaptive: route based on confidence
-  if (level === 'adaptive') {
-    let effectiveLevel;
-    if (confidence > ADAPTIVE_THRESHOLDS.HIGH) {
-      effectiveLevel = 'collaborative';
-    } else if (confidence < ADAPTIVE_THRESHOLDS.LOW) {
-      effectiveLevel = 'supervised';
-    } else {
-      effectiveLevel = 'guided';
-    }
-    return {
-      ...LEVEL_BEHAVIORS[effectiveLevel],
-      effectiveLevel
-    };
-  }
-
-  // Static levels (supervised, guided, collaborative)
-  const behavior = LEVEL_BEHAVIORS[level];
-  if (behavior) {
-    return {
-      ...behavior,
-      effectiveLevel: level
-    };
-  }
-
-  // Unknown or undefined level — default to supervised
-  return {
-    ...LEVEL_BEHAVIORS.supervised,
-    effectiveLevel: 'supervised'
-  };
-}
-
-module.exports = {
-  resolveAutonomyBehavior,
-  AUTONOMY_LEVELS,
-  ADAPTIVE_THRESHOLDS,
-  LEVEL_BEHAVIORS
-};