@claude-pw/framework 0.6.0 → 0.7.0

package/README.es.md

@@ -129,7 +129,7 @@ Issue capturado. ¿Arreglar ahora? (sí/no)
 |---------|----------|
 | `/cpw-startup` | Sesión de discovery — detecta modo, entrevista, genera plan |
 | `/cpw-discuss` | Captura preferencias y resuelve ambigüedades antes de construir |
-| `/cpw-next-step` | Ejecuta pipeline, cierra pasos, valida fases, corre UAT |
+| `/cpw-next-step` | Ejecuta pipeline, cierra pasos, valida fases, corre UAT (`--phase` para planear + auto-avanzar toda la fase) |
 | `/cpw-pause` | Guarda estado de sesión para retomar después |
 | `/cpw-quick` | Tarea ad-hoc fuera del pipeline (detección de scope-creep, `--auto`) |
 | `/cpw-debug` | Sesión de debug persistente — sobrevive resets de contexto |
@@ -137,6 +137,7 @@ Issue capturado. ¿Arreglar ahora? (sí/no)
 | `/cpw-todos` | Captura ideas para después o revisa todos pendientes |
 | `/cpw-reflect` | Revisa correcciones capturadas, convierte en learnings (`--scan-history`, `--dedupe`) |
 | `/cpw-impact` | Analiza impacto de decisiones en todo el plan |
+| `/cpw-update` | Actualización inteligente del framework — diff, merge de conflictos, preserva customizaciones |
 
 ## Configuración
 

package/README.ja.md

@@ -129,7 +129,7 @@ Issue captured. Fix now? (yes/no)
 |---------|-------------|
 | `/cpw-startup` | ディスカバリーセッション — モード検出、インタビュー、計画生成 |
 | `/cpw-discuss` | ビルド前に好みの把握と曖昧さの解消 |
-| `/cpw-next-step` | パイプライン実行、ステップクローズ、フェーズバリデーション、UAT 実行 |
+| `/cpw-next-step` | パイプライン実行、ステップクローズ、フェーズバリデーション、UAT 実行（`--phase` でフェーズ全体を計画 + 自動実行）|
 | `/cpw-pause` | セッション状態を保存して後で再開 |
 | `/cpw-quick` | パイプライン外のアドホックタスク（スコープクリープ検出、`--auto`） |
 | `/cpw-debug` | 永続デバッグセッション — コンテキストリセット後も継続 |
@@ -137,6 +137,7 @@ Issue captured. Fix now? (yes/no)
 | `/cpw-todos` | アイデアの記録または保留中の TODO の確認 |
 | `/cpw-reflect` | キャプチャした修正をレビューし、学習に変換（`--scan-history`, `--dedupe`） |
 | `/cpw-impact` | 計画全体にわたる意思決定の影響分析 |
+| `/cpw-update` | スマートフレームワーク更新 — 差分、コンフリクトマージ、カスタマイズ保持 |
 
 ## 設定
 

package/README.md

@@ -129,7 +129,7 @@ Issue captured. Fix now? (yes/no)
 |---------|-------------|
 | `/cpw-startup` | Discovery session — detect mode, interview, generate plan |
 | `/cpw-discuss` | Capture preferences and resolve ambiguities before building |
-| `/cpw-next-step` | Execute pipeline, close steps, validate phases, run UAT |
+| `/cpw-next-step` | Execute pipeline, close steps, validate phases, run UAT (`--phase` to plan + auto-advance entire phase) |
 | `/cpw-pause` | Save session state for later resume |
 | `/cpw-quick` | Ad-hoc task outside the pipeline (scope-creep detection, `--auto`) |
 | `/cpw-debug` | Persistent debug session — survives context resets |
@@ -137,6 +137,7 @@ Issue captured. Fix now? (yes/no)
 | `/cpw-todos` | Capture ideas for later or review pending todos |
 | `/cpw-reflect` | Review captured corrections, convert to learnings (`--scan-history`, `--dedupe`) |
 | `/cpw-impact` | Analyze decision impact across the entire plan |
+| `/cpw-update` | Smart framework update — diff, merge conflicts, preserve customizations |
 
 ## Configuration
 

package/README.pt-br.md

@@ -129,7 +129,7 @@ Issue captured. Fix now? (yes/no)
 |---------|-----------|
 | `/cpw-startup` | Sessão de descoberta — detectar modo, entrevistar, gerar plano |
 | `/cpw-discuss` | Capturar preferências e resolver ambiguidades antes de construir |
-| `/cpw-next-step` | Executar pipeline, fechar etapas, validar fases, executar UAT |
+| `/cpw-next-step` | Executar pipeline, fechar etapas, validar fases, executar UAT (`--phase` para planejar + auto-avançar toda a fase) |
 | `/cpw-pause` | Salvar estado da sessão para retomar depois |
 | `/cpw-quick` | Tarefa avulsa fora do pipeline (detecção de scope-creep, `--auto`) |
 | `/cpw-debug` | Sessão de debug persistente — sobrevive a resets de contexto |
@@ -137,6 +137,7 @@ Issue captured. Fix now? (yes/no)
 | `/cpw-todos` | Capturar ideias para depois ou revisar todos pendentes |
 | `/cpw-reflect` | Revisar correções capturadas, converter em aprendizados (`--scan-history`, `--dedupe`) |
 | `/cpw-impact` | Analisar impacto de decisões em todo o plano |
+| `/cpw-update` | Atualização inteligente do framework — diff, merge de conflitos, preserva customizações |
 
 ## Configuração
 

package/README.zh-cn.md

@@ -129,7 +129,7 @@ UAT 演练：
 |------|------|
 | `/cpw-startup` | 发现会话——检测模式、访谈、生成计划 |
 | `/cpw-discuss` | 构建前捕获偏好和解决歧义 |
-| `/cpw-next-step` | 执行流水线、关闭步骤、验证阶段、运行 UAT |
+| `/cpw-next-step` | 执行流水线、关闭步骤、验证阶段、运行 UAT（`--phase` 规划 + 自动推进整个阶段）|
 | `/cpw-pause` | 保存会话状态以便稍后恢复 |
 | `/cpw-quick` | 流水线外的临时任务（范围蔓延检测、`--auto`） |
 | `/cpw-debug` | 持久化调试会话——跨上下文重置存活 |
@@ -137,6 +137,7 @@ UAT 演练：
 | `/cpw-todos` | 捕获想法或查看待办事项 |
 | `/cpw-reflect` | 审查捕获的修正，转化为学习成果（`--scan-history`、`--dedupe`） |
 | `/cpw-impact` | 分析决策对整个计划的影响 |
+| `/cpw-update` | 智能框架更新 — 差异对比、冲突合并、保留自定义 |
 
 ## 配置
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-pw/framework",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Structured Project Workflow for Claude Code — adaptive pipeline, context management, quality gates",
   "bin": {
     "claude-pw": "./install.js"

package/templates/claude/commands/cpw-next-step.md

@@ -8,6 +8,10 @@ description: "Load context and execute the next pipeline stage"
 
 ## 0. Health check (session start)
 
+### Orphan phase-active cleanup
+If `.planning/.phase-active` exists AND `--phase` flag is NOT active:
+- Delete the file (leftover from interrupted session)
+
 ### Post-update detection
 If `.planning/.updated-from` exists:
 - Read the file — it contains the previous version
@@ -266,7 +270,7 @@ Estimated context resets: [N / based on step count, suggest /clear every 3 steps
 ```
 
 Ask: "Execute this plan? (yes / adjust / cancel)"
-- **yes**: proceed with auto-advance (normal --phase behavior)
+- **yes**: create `.planning/.phase-active` (enables auto-approve for tool permissions), then proceed with auto-advance
 - **adjust**: ask what to change (skip a step, reorder, modify pipeline). Update sub-plan if needed, re-present.
 - **cancel**: exit --phase mode, continue as normal /cpw-next-step (step by step)
 
@@ -576,11 +580,22 @@ If all deliverables passed (or issues were fixed):
   ## Session notes
   - (empty)
   ```
-- If autoAdvance is **off**: Recommend /clear, then report:
+- Delete `.planning/.phase-active` if it exists (re-enables normal tool permissions)
+- If `--phase` flag is active: STOP. Do NOT advance to next phase. Report:
+  ```
+  Phase N complete. UAT passed.
+
+  Next: run `/clear`, then `/cpw-next-step` (or `/cpw-next-step --phase`) for Phase N+1.
+
+  Optional before starting:
+    /cpw-discuss — clarify ambiguities for the next phase
+    /cpw-todos  — review pending todos
+  ```
+- If autoAdvance is **off** (and no --phase): Recommend /clear, then report:
   "Phase N complete. Before starting Phase N+1:"
   "  1. `/cpw-discuss` — clarify ambiguities for the next phase"
   "  2. `/cpw-todos` — review pending todos (some may fit the next phase)"
   "  3. `/cpw-next-step` — start directly"
-- If autoAdvance is **auto** or **yolo**: Suggest /clear for context refresh, then automatically continue with Phase N+1 (run tooling audit → first step).
+- If autoAdvance is **auto** or **yolo** (and no --phase): Suggest /clear for context refresh, then automatically continue with Phase N+1 (run tooling audit → first step).
 
 NEVER advance between phases without completing UAT first (in any mode).

package/templates/claude/hooks/cpw-phase-approve.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Auto-approve tool calls during --phase execution
+# Created by: /cpw-next-step --phase (creates .planning/.phase-active)
+# Removed by: /cpw-next-step at UAT or phase end
+
+PHASE_FILE=".planning/.phase-active"
+
+if [ -f "$PHASE_FILE" ]; then
+  # Check for stale file (>24h)
+  if [ "$(find "$PHASE_FILE" -mmin +1440 2>/dev/null)" ]; then
+    rm -f "$PHASE_FILE"
+    exit 0
+  fi
+  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow","permissionDecisionReason":"--phase active: plan approved by user"}}'
+fi
+exit 0

package/templates/claude/settings.json

@@ -4,6 +4,15 @@
     "command": "node .claude/hooks/cpw-statusline.js"
   },
   "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "",
+        "hooks": [{
+          "type": "command",
+          "command": "bash .claude/hooks/cpw-phase-approve.sh"
+        }]
+      }
+    ],
     "UserPromptSubmit": [
       {
         "matcher": "",