@sienklogic/plan-build-run 2.12.0 → 2.14.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to Plan-Build-Run will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.14.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.13.0...plan-build-run-v2.14.0) (2026-02-22)
+
+
+### Features
+
+* **tools:** add EnterPlanMode interception hook to redirect to PBR commands ([57e2b55](https://github.com/SienkLogic/plan-build-run/commit/57e2b551d326457c44feccdf3c3fdf6c02d9c1b8))
+
+## [2.13.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.12.0...plan-build-run-v2.13.0) (2026-02-22)
+
+
+### Features
+
+* **tools:** add stale active-skill session-start warning and copilot hook limitation docs ([158a78d](https://github.com/SienkLogic/plan-build-run/commit/158a78d03b482f56ab6f09e89bf9ef67b81fb409))
+
 ## [2.12.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.11.0...plan-build-run-v2.12.0) (2026-02-21)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sienklogic/plan-build-run",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Plan it, Build it, Run it — structured development workflow for Claude Code",
   "keywords": [
     "claude-code",

package/plugins/copilot-pbr/README.md

@@ -119,6 +119,13 @@ Copilot CLI supports 6 hook events vs Claude Code's full set. The following hook
 
 **Not available** in Copilot CLI (present in Claude Code/Cursor ports): `SubagentStart`, `SubagentStop`, `TaskCompleted`, `PostToolUseFailure`, `PreCompact`, `Stop`.
 
+**Impact of missing hooks:**
+
+- No auto-continue between skills (`Stop` hook) — you must manually run the next command
+- No tool failure logging (`PostToolUseFailure`) — silent failures won't be recorded to `.planning/logs/`
+- No context budget preservation on compaction (`PreCompact`) — STATE.md won't be auto-preserved when context is compressed
+- No subagent lifecycle tracking (`SubagentStart`/`SubagentStop`/`TaskCompleted`) — agent spawn/completion events aren't logged
+
 ## Cross-Plugin Compatibility
 
 This plugin works alongside the Claude Code and Cursor versions of Plan-Build-Run. All three plugins share the same `.planning/` directory and file formats, so you can switch between tools without losing state. Hook scripts under `plugins/pbr/scripts/` are shared between all plugins via relative paths.

package/plugins/copilot-pbr/hooks/hooks.json

@@ -125,6 +125,18 @@
             "timeoutSec": 15
           }
         ]
+      },
+      {
+        "matcher": "EnterPlanMode",
+        "hooks": [
+          {
+            "type": "command",
+            "bash": "node \"$(cd \"$(dirname \"$0\")\" && pwd)/../../pbr/scripts/run-hook.js\" intercept-plan-mode.js",
+            "powershell": "node (Join-Path (Split-Path -Parent $PSScriptRoot) 'pbr\\scripts\\run-hook.js') intercept-plan-mode.js",
+            "cwd": ".",
+            "timeoutSec": 15
+          }
+        ]
       }
     ],
     "sessionEnd": [

package/plugins/copilot-pbr/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pbr",
   "displayName": "Plan-Build-Run",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Plan-Build-Run — Structured development workflow for GitHub Copilot CLI. Solves context rot through disciplined agent delegation, structured planning, atomic execution, and goal-backward verification.",
   "author": {
     "name": "SienkLogic",

package/plugins/cursor-pbr/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pbr",
   "displayName": "Plan-Build-Run",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Plan-Build-Run — Structured development workflow for Cursor. Solves context rot through disciplined subagent delegation, structured planning, atomic execution, and goal-backward verification.",
   "author": {
     "name": "SienkLogic",

package/plugins/cursor-pbr/hooks/hooks.json

@@ -116,6 +116,16 @@
             "statusMessage": "Validating skill arguments..."
           }
         ]
+      },
+      {
+        "matcher": "EnterPlanMode",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'..','pbr','scripts','run-hook.js'))\" intercept-plan-mode.js",
+            "statusMessage": "Checking plan mode compatibility..."
+          }
+        ]
       }
     ],
     "PreCompact": [

package/plugins/pbr/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pbr",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Plan-Build-Run — Structured development workflow for Claude Code. Solves context rot through disciplined subagent delegation, structured planning, atomic execution, and goal-backward verification.",
   "author": {
     "name": "SienkLogic",

package/plugins/pbr/hooks/hooks.json

@@ -116,6 +116,16 @@
             "statusMessage": "Validating skill arguments..."
           }
         ]
+      },
+      {
+        "matcher": "EnterPlanMode",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"var r=process.env.CLAUDE_PLUGIN_ROOT||'',m=r.match(/^\\/([a-zA-Z])\\/(.*)/);if(m)r=m[1]+String.fromCharCode(58)+String.fromCharCode(92)+m[2];require(require('path').resolve(r,'scripts','run-hook.js'))\" intercept-plan-mode.js",
+            "statusMessage": "Checking plan mode compatibility..."
+          }
+        ]
       }
     ],
     "PreCompact": [

package/plugins/pbr/scripts/intercept-plan-mode.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+/**
+ * PreToolUse hook on EnterPlanMode: Warns users in PBR projects that
+ * native plan mode won't integrate with PBR's planning system.
+ *
+ * Suggests /pbr:plan instead. Does NOT block — just advises.
+ *
+ * Exit codes:
+ *   0 = always (advisory only, never blocks)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { logHook } = require('./hook-logger');
+
+function main() {
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', () => {});
+  process.stdin.on('end', () => {
+    try {
+      const cwd = process.cwd();
+      const planningDir = path.join(cwd, '.planning');
+
+      // Only relevant for Plan-Build-Run projects
+      if (!fs.existsSync(planningDir)) {
+        process.exit(0);
+      }
+
+      logHook('intercept-plan-mode', 'PreToolUse', 'warn', {
+        reason: 'native plan mode used in PBR project'
+      });
+
+      const output = {
+        decision: 'block',
+        reason: 'This is a Plan-Build-Run project. Native plan mode stores plans outside .planning/ and won\'t integrate with PBR\'s workflow.\n\nUse instead:\n  /pbr:plan <phase>  — Create a PBR-formatted plan for a phase\n  /pbr:quick         — Plan and execute an ad-hoc task\n  /pbr:import        — Import an external plan document into PBR format\n\nIf you already generated a plan in native plan mode, paste it into /pbr:import to convert it.'
+      };
+      process.stdout.write(JSON.stringify(output));
+      process.exit(2);
+    } catch (_e) {
+      process.exit(0);
+    }
+  });
+}
+
+if (require.main === module || process.argv[1] === __filename) { main(); }
+module.exports = { main };

package/plugins/pbr/scripts/progress-tracker.js

@@ -182,6 +182,23 @@ function buildContext(planningDir, stateFile) {
     }
   }
 
+  // Check for stale .active-skill (multi-session conflict detection)
+  const activeSkillFile = path.join(planningDir, '.active-skill');
+  if (fs.existsSync(activeSkillFile)) {
+    try {
+      const stats = fs.statSync(activeSkillFile);
+      const ageMs = Date.now() - stats.mtimeMs;
+      const ageMinutes = Math.floor(ageMs / 60000);
+      if (ageMinutes > 60) {
+        const skill = fs.readFileSync(activeSkillFile, 'utf8').trim();
+        parts.push(`\nWarning: .active-skill is ${ageMinutes} minutes old (skill: "${skill}"). This may be a stale lock from a crashed session or concurrent session conflict. Run /pbr:health to auto-fix, or delete .planning/.active-skill manually.`);
+        logHook('progress-tracker', 'SessionStart', 'stale-active-skill', { ageMinutes, skill });
+      }
+    } catch (_e) {
+      // Ignore errors
+    }
+  }
+
   // Check for stale .auto-next signal (S>M-9)
   const autoNextFile = path.join(planningDir, '.auto-next');
   if (fs.existsSync(autoNextFile)) {