up-cc 0.1.2 → 0.1.4

package/agents/up-executor.md

@@ -33,7 +33,7 @@ Antes de executar, descubra o contexto do projeto:
 Carregue o contexto de execucao:
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init execute-phase "${PHASE}")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init executar-fase "${PHASE}")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/agents/up-planejador.md

@@ -241,7 +241,7 @@ Se qualquer item falhar, corrija ANTES de retornar. Nao dependa de checker exter
 ### Passo 1: Carregar Estado do Projeto
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init plan-phase "${PHASE}")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init planejar-fase "${PHASE}")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/bin/up-tools.cjs

@@ -8,8 +8,8 @@
  * Usage: node up-tools.cjs <command> [args] [--raw] [--cwd <path>]
  *
  * Commands:
- *   init planejar-fase|executar-fase|novo-projeto|rapido|retomar
- *   state load|get|update|advance-plan|update-progress|add-decision|record-session
+ *   init planejar-fase|executar-fase|novo-projeto|rapido|retomar|operacao-fase|progresso|verificar-trabalho
+ *   state load|get|update|advance-plan|update-progress|add-decision|record-session|record-metric|snapshot
  *   roadmap get-phase|analyze|update-plan-progress
  *   phase add|remove|find|complete
  *   config get|set
@@ -18,6 +18,9 @@
  *   progress [json|table|bar]
  *   timestamp [full|date|filename]
  *   slug <text>
+ *   phase-plan-index <phase>
+ *   state-snapshot
+ *   summary-extract <path> [--fields field1,field2]
  */
 
 const fs = require('fs');
@@ -29,6 +32,85 @@ const {
   pathExistsInternal, generateSlugInternal, toPosixPath,
 } = require('./lib/core.cjs');
 
+// --- Frontmatter helpers ---
+
+function extractFrontmatter(content) {
+  const frontmatter = {};
+  const match = content.match(/^---\n([\s\S]+?)\n---/);
+  if (!match) return frontmatter;
+
+  const yaml = match[1];
+  const lines = yaml.split('\n');
+  let stack = [{ obj: frontmatter, key: null, indent: -1 }];
+
+  for (const line of lines) {
+    if (line.trim() === '') continue;
+    const indentMatch = line.match(/^(\s*)/);
+    const indent = indentMatch ? indentMatch[1].length : 0;
+    while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+      stack.pop();
+    }
+    const current = stack[stack.length - 1];
+    const keyMatch = line.match(/^(\s*)([a-zA-Z0-9_-]+):\s*(.*)/);
+    if (keyMatch) {
+      const key = keyMatch[2];
+      const value = keyMatch[3].trim();
+      if (value === '' || value === '[') {
+        current.obj[key] = value === '[' ? [] : {};
+        current.key = null;
+        stack.push({ obj: current.obj[key], key: null, indent });
+      } else if (value.startsWith('[') && value.endsWith(']')) {
+        current.obj[key] = value.slice(1, -1).split(',').map(s => s.trim().replace(/^["']|["']$/g, '')).filter(Boolean);
+        current.key = null;
+      } else {
+        current.obj[key] = value.replace(/^["']|["']$/g, '');
+        current.key = null;
+      }
+    } else if (line.trim().startsWith('- ')) {
+      const itemValue = line.trim().slice(2).replace(/^["']|["']$/g, '');
+      if (typeof current.obj === 'object' && !Array.isArray(current.obj) && Object.keys(current.obj).length === 0) {
+        const parent = stack.length > 1 ? stack[stack.length - 2] : null;
+        if (parent) {
+          for (const k of Object.keys(parent.obj)) {
+            if (parent.obj[k] === current.obj) {
+              parent.obj[k] = [itemValue];
+              current.obj = parent.obj[k];
+              break;
+            }
+          }
+        }
+      } else if (Array.isArray(current.obj)) {
+        current.obj.push(itemValue);
+      }
+    }
+  }
+  return frontmatter;
+}
+
+function extractObjective(content) {
+  const m = content.match(/<objective>\s*\n?\s*(.+)/);
+  return m ? m[1].trim() : null;
+}
+
+function getMilestoneInfo(cwd) {
+  try {
+    const roadmap = fs.readFileSync(path.join(cwd, '.plano', 'ROADMAP.md'), 'utf-8');
+    const inProgressMatch = roadmap.match(/🚧\s*\*\*v(\d+\.\d+)\s+([^*]+)\*\*/);
+    if (inProgressMatch) {
+      return { version: 'v' + inProgressMatch[1], name: inProgressMatch[2].trim() };
+    }
+    const cleaned = roadmap.replace(/<details>[\s\S]*?<\/details>/gi, '');
+    const headingMatch = cleaned.match(/## .*v(\d+\.\d+)[:\s]+([^\n(]+)/);
+    if (headingMatch) {
+      return { version: 'v' + headingMatch[1], name: headingMatch[2].trim() };
+    }
+    const versionMatch = cleaned.match(/v(\d+\.\d+)/);
+    return { version: versionMatch ? 'v' + versionMatch[1] : 'v0.1', name: 'MVP' };
+  } catch {
+    return { version: 'v0.1', name: 'MVP' };
+  }
+}
+
 // --- State helpers ---
 
 function stateExtractField(content, fieldName) {
@@ -109,8 +191,17 @@ function main() {
         case 'retomar':
           cmdInitRetomar(cwd, raw);
           break;
+        case 'operacao-fase':
+          cmdInitOperacaoFase(cwd, args[2], raw);
+          break;
+        case 'progresso':
+          cmdInitProgresso(cwd, raw);
+          break;
+        case 'verificar-trabalho':
+          cmdInitVerificarTrabalho(cwd, args[2], raw);
+          break;
         default:
-          error(`Unknown init workflow: ${workflow}\nAvailable: planejar-fase, executar-fase, novo-projeto, rapido, retomar`);
+          error(`Unknown init workflow: ${workflow}\nAvailable: planejar-fase, executar-fase, novo-projeto, rapido, retomar, operacao-fase, progresso, verificar-trabalho`);
       }
       break;
     }
@@ -140,8 +231,23 @@ function main() {
         cmdStateRecordSession(cwd, {
           stopped_at: stoppedIdx !== -1 ? args[stoppedIdx + 1] : null,
         }, raw);
+      } else if (sub === 'record-metric') {
+        const phaseIdx = args.indexOf('--phase');
+        const planIdx = args.indexOf('--plan');
+        const durationIdx = args.indexOf('--duration');
+        const tasksIdx = args.indexOf('--tasks');
+        const filesIdx = args.indexOf('--files');
+        cmdStateRecordMetric(cwd, {
+          phase: phaseIdx !== -1 ? args[phaseIdx + 1] : null,
+          plan: planIdx !== -1 ? args[planIdx + 1] : null,
+          duration: durationIdx !== -1 ? args[durationIdx + 1] : null,
+          tasks: tasksIdx !== -1 ? args[tasksIdx + 1] : null,
+          files: filesIdx !== -1 ? args[filesIdx + 1] : null,
+        }, raw);
+      } else if (sub === 'snapshot') {
+        cmdStateSnapshot(cwd, raw);
       } else {
-        error('Unknown state subcommand. Available: load, get, update, advance-plan, update-progress, add-decision, record-session');
+        error('Unknown state subcommand. Available: load, get, update, advance-plan, update-progress, add-decision, record-session, record-metric, snapshot');
       }
       break;
     }
@@ -232,6 +338,26 @@ function main() {
       break;
     }
 
+    // ==================== PHASE-PLAN-INDEX ====================
+    case 'phase-plan-index': {
+      cmdPhasePlanIndex(cwd, args[1], raw);
+      break;
+    }
+
+    // ==================== STATE-SNAPSHOT ====================
+    case 'state-snapshot': {
+      cmdStateSnapshot(cwd, raw);
+      break;
+    }
+
+    // ==================== SUMMARY-EXTRACT ====================
+    case 'summary-extract': {
+      const fieldsIdx = args.indexOf('--fields');
+      const fields = fieldsIdx !== -1 ? args[fieldsIdx + 1].split(',') : [];
+      cmdSummaryExtract(cwd, args[1], fields, raw);
+      break;
+    }
+
     default:
       error(`Unknown command: ${command}`);
   }
@@ -385,6 +511,174 @@ function cmdInitRetomar(cwd, raw) {
   output(result, raw);
 }
 
+function cmdInitOperacaoFase(cwd, phase, raw) {
+  const config = loadConfig(cwd);
+  let phaseInfo = findPhaseInternal(cwd, phase);
+
+  if (!phaseInfo) {
+    const roadmapPhase = getRoadmapPhaseInternal(cwd, phase);
+    if (roadmapPhase?.found) {
+      const phaseName = roadmapPhase.phase_name;
+      phaseInfo = {
+        found: true,
+        directory: null,
+        phase_number: roadmapPhase.phase_number,
+        phase_name: phaseName,
+        phase_slug: phaseName ? phaseName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') : null,
+        plans: [],
+        summaries: [],
+        incomplete_plans: [],
+        has_research: false,
+        has_context: false,
+        has_verification: false,
+      };
+    }
+  }
+
+  const result = {
+    commit_docs: config.commit_docs,
+    phase_found: !!phaseInfo,
+    phase_dir: phaseInfo?.directory || null,
+    phase_number: phaseInfo?.phase_number || null,
+    phase_name: phaseInfo?.phase_name || null,
+    phase_slug: phaseInfo?.phase_slug || null,
+    padded_phase: phaseInfo?.phase_number?.padStart(2, '0') || null,
+    has_research: phaseInfo?.has_research || false,
+    has_context: phaseInfo?.has_context || false,
+    has_plans: (phaseInfo?.plans?.length || 0) > 0,
+    has_verification: false,
+    plan_count: phaseInfo?.plans?.length || 0,
+    roadmap_exists: pathExistsInternal(cwd, '.plano/ROADMAP.md'),
+    plano_exists: pathExistsInternal(cwd, '.plano'),
+    state_path: '.plano/STATE.md',
+    roadmap_path: '.plano/ROADMAP.md',
+  };
+
+  if (phaseInfo?.directory) {
+    const phaseDirFull = path.join(cwd, phaseInfo.directory);
+    try {
+      const files = fs.readdirSync(phaseDirFull);
+      const contextFile = files.find(f => f.endsWith('-CONTEXT.md') || f === 'CONTEXT.md');
+      if (contextFile) result.context_path = toPosixPath(path.join(phaseInfo.directory, contextFile));
+      const researchFile = files.find(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
+      if (researchFile) result.research_path = toPosixPath(path.join(phaseInfo.directory, researchFile));
+      const verificationFile = files.find(f => f.endsWith('-VERIFICATION.md') || f === 'VERIFICATION.md');
+      if (verificationFile) {
+        result.verification_path = toPosixPath(path.join(phaseInfo.directory, verificationFile));
+        result.has_verification = true;
+      }
+    } catch {}
+  }
+
+  output(result, raw);
+}
+
+function cmdInitProgresso(cwd, raw) {
+  const config = loadConfig(cwd);
+  const milestone = getMilestoneInfo(cwd);
+
+  const fasesDir = path.join(cwd, '.plano', 'fases');
+  const phases = [];
+  let currentPhase = null;
+  let nextPhase = null;
+
+  try {
+    const entries = fs.readdirSync(fasesDir, { withFileTypes: true });
+    const dirs = entries.filter(e => e.isDirectory()).map(e => e.name).sort();
+
+    for (const dir of dirs) {
+      const match = dir.match(/^(\d+(?:\.\d+)*)-?(.*)/);
+      const phaseNumber = match ? match[1] : dir;
+      const phaseName = match && match[2] ? match[2] : null;
+
+      const phasePath = path.join(fasesDir, dir);
+      const phaseFiles = fs.readdirSync(phasePath);
+
+      const plans = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md');
+      const summaries = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md');
+      const hasResearch = phaseFiles.some(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
+
+      const status = summaries.length >= plans.length && plans.length > 0 ? 'complete' :
+                     plans.length > 0 ? 'in_progress' :
+                     hasResearch ? 'researched' : 'pending';
+
+      const phaseInfo = {
+        number: phaseNumber,
+        name: phaseName,
+        directory: '.plano/fases/' + dir,
+        status,
+        plan_count: plans.length,
+        summary_count: summaries.length,
+        has_research: hasResearch,
+      };
+
+      phases.push(phaseInfo);
+
+      if (!currentPhase && (status === 'in_progress' || status === 'researched')) {
+        currentPhase = phaseInfo;
+      }
+      if (!nextPhase && status === 'pending') {
+        nextPhase = phaseInfo;
+      }
+    }
+  } catch {}
+
+  let pausedAt = null;
+  try {
+    const state = fs.readFileSync(path.join(cwd, '.plano', 'STATE.md'), 'utf-8');
+    const pauseMatch = state.match(/\*\*Paused At:\*\*\s*(.+)/);
+    if (pauseMatch) pausedAt = pauseMatch[1].trim();
+  } catch {}
+
+  const result = {
+    commit_docs: config.commit_docs,
+    milestone_version: milestone.version,
+    milestone_name: milestone.name,
+    phases,
+    phase_count: phases.length,
+    completed_count: phases.filter(p => p.status === 'complete').length,
+    in_progress_count: phases.filter(p => p.status === 'in_progress').length,
+    current_phase: currentPhase,
+    next_phase: nextPhase,
+    paused_at: pausedAt,
+    has_work_in_progress: !!currentPhase,
+    state_exists: pathExistsInternal(cwd, '.plano/STATE.md'),
+    roadmap_exists: pathExistsInternal(cwd, '.plano/ROADMAP.md'),
+    project_exists: pathExistsInternal(cwd, '.plano/PROJECT.md'),
+    state_path: '.plano/STATE.md',
+    roadmap_path: '.plano/ROADMAP.md',
+    project_path: '.plano/PROJECT.md',
+  };
+
+  output(result, raw);
+}
+
+function cmdInitVerificarTrabalho(cwd, phase, raw) {
+  if (!phase) error('phase required for init verificar-trabalho');
+
+  const config = loadConfig(cwd);
+  const phaseInfo = findPhaseInternal(cwd, phase);
+
+  let hasVerification = false;
+  if (phaseInfo?.directory) {
+    try {
+      const files = fs.readdirSync(path.join(cwd, phaseInfo.directory));
+      hasVerification = files.some(f => f.endsWith('-VERIFICATION.md') || f === 'VERIFICATION.md');
+    } catch {}
+  }
+
+  const result = {
+    commit_docs: config.commit_docs,
+    phase_found: !!phaseInfo,
+    phase_dir: phaseInfo?.directory || null,
+    phase_number: phaseInfo?.phase_number || null,
+    phase_name: phaseInfo?.phase_name || null,
+    has_verification: hasVerification,
+  };
+
+  output(result, raw);
+}
+
 // =====================================================================
 // STATE COMMANDS
 // =====================================================================
@@ -593,6 +887,108 @@ function cmdStateRecordSession(cwd, options, raw) {
   }
 }
 
+function cmdStateRecordMetric(cwd, options, raw) {
+  const statePath = path.join(cwd, '.plano', 'STATE.md');
+  if (!fs.existsSync(statePath)) { output({ error: 'STATE.md not found' }, raw); return; }
+
+  let content = fs.readFileSync(statePath, 'utf-8');
+  const { phase, plan, duration, tasks, files } = options;
+
+  if (!phase || !plan || !duration) {
+    output({ error: 'phase, plan, and duration required' }, raw);
+    return;
+  }
+
+  const metricsPattern = /(##\s*Performance Metrics[\s\S]*?\n\|[^\n]+\n\|[-|\s]+\n)([\s\S]*?)(?=\n##|\n$|$)/i;
+  const metricsMatch = content.match(metricsPattern);
+
+  if (metricsMatch) {
+    let tableBody = metricsMatch[2].trimEnd();
+    const newRow = `| Phase ${phase} P${plan} | ${duration} | ${tasks || '-'} tasks | ${files || '-'} files |`;
+
+    if (tableBody.trim() === '' || tableBody.includes('None yet')) {
+      tableBody = newRow;
+    } else {
+      tableBody = tableBody + '\n' + newRow;
+    }
+
+    content = content.replace(metricsPattern, (_match, header) => `${header}${tableBody}\n`);
+    fs.writeFileSync(statePath, content, 'utf-8');
+    output({ recorded: true, phase, plan, duration }, raw, 'true');
+  } else {
+    output({ recorded: false, reason: 'Performance Metrics section not found in STATE.md' }, raw, 'false');
+  }
+}
+
+function cmdStateSnapshot(cwd, raw) {
+  const statePath = path.join(cwd, '.plano', 'STATE.md');
+  if (!fs.existsSync(statePath)) { output({ error: 'STATE.md not found' }, raw); return; }
+
+  const content = fs.readFileSync(statePath, 'utf-8');
+
+  const currentPhase = stateExtractField(content, 'Current Phase');
+  const currentPhaseName = stateExtractField(content, 'Current Phase Name');
+  const totalPhasesRaw = stateExtractField(content, 'Total Phases');
+  const currentPlan = stateExtractField(content, 'Current Plan');
+  const totalPlansRaw = stateExtractField(content, 'Total Plans in Phase');
+  const status = stateExtractField(content, 'Status');
+  const progressRaw = stateExtractField(content, 'Progress');
+  const lastActivity = stateExtractField(content, 'Last Activity');
+  const pausedAt = stateExtractField(content, 'Paused At');
+
+  const totalPhases = totalPhasesRaw ? parseInt(totalPhasesRaw, 10) : null;
+  const totalPlansInPhase = totalPlansRaw ? parseInt(totalPlansRaw, 10) : null;
+  const progressPercent = progressRaw ? parseInt(progressRaw.replace('%', ''), 10) : null;
+
+  const decisions = [];
+  const decisionsMatch = content.match(/##\s*Decisions Made[\s\S]*?\n\|[^\n]+\n\|[-|\s]+\n([\s\S]*?)(?=\n##|\n$|$)/i);
+  if (decisionsMatch) {
+    const rows = decisionsMatch[1].trim().split('\n').filter(r => r.includes('|'));
+    for (const row of rows) {
+      const cells = row.split('|').map(c => c.trim()).filter(Boolean);
+      if (cells.length >= 3) {
+        decisions.push({ phase: cells[0], summary: cells[1], rationale: cells[2] });
+      }
+    }
+  }
+
+  const blockers = [];
+  const blockersMatch = content.match(/##\s*Blockers\s*\n([\s\S]*?)(?=\n##|$)/i);
+  if (blockersMatch) {
+    const items = blockersMatch[1].match(/^-\s+(.+)$/gm) || [];
+    for (const item of items) {
+      blockers.push(item.replace(/^-\s+/, '').trim());
+    }
+  }
+
+  const session = { last_date: null, stopped_at: null, resume_file: null };
+  const sessionMatch = content.match(/##\s*Session\s*\n([\s\S]*?)(?=\n##|$)/i);
+  if (sessionMatch) {
+    const s = sessionMatch[1];
+    const ld = s.match(/\*\*Last Date:\*\*\s*(.+)/i) || s.match(/^Last Date:\s*(.+)/im);
+    const sa = s.match(/\*\*Stopped At:\*\*\s*(.+)/i) || s.match(/^Stopped At:\s*(.+)/im);
+    const rf = s.match(/\*\*Resume File:\*\*\s*(.+)/i) || s.match(/^Resume File:\s*(.+)/im);
+    if (ld) session.last_date = ld[1].trim();
+    if (sa) session.stopped_at = sa[1].trim();
+    if (rf) session.resume_file = rf[1].trim();
+  }
+
+  output({
+    current_phase: currentPhase,
+    current_phase_name: currentPhaseName,
+    total_phases: totalPhases,
+    current_plan: currentPlan,
+    total_plans_in_phase: totalPlansInPhase,
+    status,
+    progress_percent: progressPercent,
+    last_activity: lastActivity,
+    decisions,
+    blockers,
+    paused_at: pausedAt,
+    session,
+  }, raw);
+}
+
 // =====================================================================
 // ROADMAP COMMANDS
 // =====================================================================
@@ -1116,6 +1512,128 @@ function cmdPhaseComplete(cwd, phaseNum, raw) {
   }, raw);
 }
 
+function cmdPhasePlanIndex(cwd, phase, raw) {
+  if (!phase) error('phase required for phase-plan-index');
+
+  const fasesDir = path.join(cwd, '.plano', 'fases');
+  const normalized = normalizePhaseName(phase);
+
+  let phaseDir = null;
+  try {
+    const entries = fs.readdirSync(fasesDir, { withFileTypes: true });
+    const dirs = entries.filter(e => e.isDirectory()).map(e => e.name).sort((a, b) => comparePhaseNum(a, b));
+    const match = dirs.find(d => d.startsWith(normalized));
+    if (match) phaseDir = path.join(fasesDir, match);
+  } catch {}
+
+  if (!phaseDir) {
+    output({ phase: normalized, error: 'Phase not found', plans: [], waves: {}, incomplete: [], has_checkpoints: false }, raw);
+    return;
+  }
+
+  const phaseFiles = fs.readdirSync(phaseDir);
+  const planFiles = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md').sort();
+  const summaryFiles = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md');
+
+  const completedPlanIds = new Set(
+    summaryFiles.map(s => s.replace('-SUMMARY.md', '').replace('SUMMARY.md', ''))
+  );
+
+  const plans = [];
+  const waves = {};
+  const incomplete = [];
+  let hasCheckpoints = false;
+
+  for (const planFile of planFiles) {
+    const planId = planFile.replace('-PLAN.md', '').replace('PLAN.md', '');
+    const planPath = path.join(phaseDir, planFile);
+    const content = fs.readFileSync(planPath, 'utf-8');
+    const fm = extractFrontmatter(content);
+
+    const xmlTasks = content.match(/<task[\s>]/gi) || [];
+    const mdTasks = content.match(/##\s*Task\s*\d+/gi) || [];
+    const taskCount = xmlTasks.length || mdTasks.length;
+
+    const wave = parseInt(fm.wave, 10) || 1;
+
+    let autonomous = true;
+    if (fm.autonomous !== undefined) {
+      autonomous = fm.autonomous === 'true' || fm.autonomous === true;
+    }
+    if (!autonomous) hasCheckpoints = true;
+
+    let filesModified = [];
+    const fmFiles = fm['files_modified'] || fm['files-modified'];
+    if (fmFiles) {
+      filesModified = Array.isArray(fmFiles) ? fmFiles : [fmFiles];
+    }
+
+    const hasSummary = completedPlanIds.has(planId);
+    if (!hasSummary) incomplete.push(planId);
+
+    plans.push({
+      id: planId,
+      wave,
+      autonomous,
+      objective: extractObjective(content) || fm.objective || null,
+      files_modified: filesModified,
+      task_count: taskCount,
+      has_summary: hasSummary,
+    });
+
+    const waveKey = String(wave);
+    if (!waves[waveKey]) waves[waveKey] = [];
+    waves[waveKey].push(planId);
+  }
+
+  output({ phase: normalized, plans, waves, incomplete, has_checkpoints: hasCheckpoints }, raw);
+}
+
+function cmdSummaryExtract(cwd, summaryPath, fields, raw) {
+  if (!summaryPath) error('summary-path required for summary-extract');
+
+  const fullPath = path.join(cwd, summaryPath);
+  if (!fs.existsSync(fullPath)) {
+    output({ error: 'File not found', path: summaryPath }, raw);
+    return;
+  }
+
+  const content = fs.readFileSync(fullPath, 'utf-8');
+  const fm = extractFrontmatter(content);
+
+  const parseDecisions = (decisionsList) => {
+    if (!decisionsList || !Array.isArray(decisionsList)) return [];
+    return decisionsList.map(d => {
+      const colonIdx = d.indexOf(':');
+      if (colonIdx > 0) {
+        return { summary: d.substring(0, colonIdx).trim(), rationale: d.substring(colonIdx + 1).trim() };
+      }
+      return { summary: d, rationale: null };
+    });
+  };
+
+  const fullResult = {
+    path: summaryPath,
+    one_liner: fm['one-liner'] || null,
+    key_files: fm['key-files'] || [],
+    tech_added: (fm['tech-stack'] && fm['tech-stack'].added) || [],
+    patterns: fm['patterns-established'] || [],
+    decisions: parseDecisions(fm['key-decisions']),
+    requirements_completed: fm['requirements-completed'] || [],
+  };
+
+  if (fields && fields.length > 0) {
+    const filtered = { path: summaryPath };
+    for (const field of fields) {
+      if (fullResult[field] !== undefined) filtered[field] = fullResult[field];
+    }
+    output(filtered, raw);
+    return;
+  }
+
+  output(fullResult, raw);
+}
+
 // =====================================================================
 // CONFIG COMMANDS
 // =====================================================================

package/commands/depurar.md

@@ -0,0 +1,163 @@
+---
+name: up:depurar
+description: Depuracao sistematica com estado persistente entre resets de contexto
+argument-hint: [descricao do problema]
+allowed-tools:
+  - Read
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+Depurar problemas usando metodo cientifico com isolamento em subagente.
+
+**Papel do orquestrador:** Coletar sintomas, spawnar agente up-depurador, lidar com checkpoints, spawnar continuacoes.
+
+**Por que subagente:** Investigacao consome contexto rapidamente (lendo arquivos, formando hipoteses, testando). Contexto fresco de 200k por investigacao. Contexto principal permanece enxuto para interacao com usuario.
+</objective>
+
+<context>
+Problema do usuario: $ARGUMENTS
+
+Verificar sessoes ativas:
+```bash
+ls .plano/debug/*.md 2>/dev/null | grep -v resolved | head -5
+```
+</context>
+
+<process>
+
+## 0. Inicializar Contexto
+
+```bash
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" state load)
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Extrair `commit_docs` do JSON de init.
+
+## 1. Verificar Sessoes Ativas
+
+Se sessoes ativas existem E sem $ARGUMENTS:
+- Listar sessoes com status, hipotese, proxima acao
+- Usuario escolhe numero para retomar OU descreve novo problema
+
+Se $ARGUMENTS fornecido OU usuario descreve novo problema:
+- Continuar para coleta de sintomas
+
+## 2. Coletar Sintomas (se novo problema)
+
+Usar AskUserQuestion para cada:
+
+1. **Comportamento esperado** - O que deveria acontecer?
+2. **Comportamento real** - O que acontece de fato?
+3. **Mensagens de erro** - Algum erro? (colar ou descrever)
+4. **Timeline** - Quando comecou? Ja funcionou antes?
+5. **Reproducao** - Como reproduzir?
+
+Apos coletar tudo, confirmar pronto para investigar.
+
+## 3. Spawnar Agente up-depurador
+
+Preencher prompt e spawnar:
+
+```markdown
+<objective>
+Investigar problema: {slug}
+
+**Resumo:** {trigger}
+</objective>
+
+<symptoms>
+expected: {expected}
+actual: {actual}
+errors: {errors}
+reproduction: {reproduction}
+timeline: {timeline}
+</symptoms>
+
+<mode>
+symptoms_prefilled: true
+goal: find_and_fix
+</mode>
+
+<debug_file>
+Criar: .plano/debug/{slug}.md
+</debug_file>
+```
+
+```
+Agent(
+  prompt=filled_prompt,
+  subagent_type="up-depurador",
+  description="Depurar {slug}"
+)
+```
+
+## 4. Lidar com Retorno do Agente
+
+**Se `## ROOT CAUSE FOUND`:**
+- Exibir causa raiz e resumo de evidencias
+- Oferecer opcoes:
+  - "Corrigir agora" - spawnar subagente de correcao
+  - "Planejar correcao" - sugerir /up:planejar-fase
+  - "Correcao manual" - encerrar
+
+**Se `## CHECKPOINT REACHED`:**
+- Apresentar detalhes do checkpoint ao usuario
+- Obter resposta do usuario
+- Se tipo `human-verify`:
+  - Se usuario confirma corrigido: continuar para agente finalizar/resolver/arquivar
+  - Se usuario reporta problemas: continuar para agente retomar investigacao/correcao
+- Spawnar agente de continuacao (ver passo 5)
+
+**Se `## INVESTIGATION INCONCLUSIVE`:**
+- Mostrar o que foi verificado e eliminado
+- Oferecer opcoes:
+  - "Continuar investigando" - spawnar novo agente com contexto adicional
+  - "Investigacao manual" - encerrar
+  - "Adicionar mais contexto" - coletar mais sintomas, spawnar novamente
+
+## 5. Spawnar Agente de Continuacao (Apos Checkpoint)
+
+Quando usuario responde ao checkpoint, spawnar agente fresco:
+
+```markdown
+<objective>
+Continuar depuracao {slug}. Evidencias estao no arquivo de debug.
+</objective>
+
+<prior_state>
+<files_to_read>
+- .plano/debug/{slug}.md (Estado da sessao de debug)
+</files_to_read>
+</prior_state>
+
+<checkpoint_response>
+**Type:** {checkpoint_type}
+**Response:** {user_response}
+</checkpoint_response>
+
+<mode>
+goal: find_and_fix
+</mode>
+```
+
+```
+Agent(
+  prompt=continuation_prompt,
+  subagent_type="up-depurador",
+  description="Continuar depuracao {slug}"
+)
+```
+
+</process>
+
+<success_criteria>
+- [ ] Sessoes ativas verificadas
+- [ ] Sintomas coletados (se novo)
+- [ ] up-depurador spawnado com contexto
+- [ ] Checkpoints tratados corretamente
+- [ ] Causa raiz confirmada antes de corrigir
+</success_criteria>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "up-cc",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Simplified spec-driven development for Claude Code, Gemini and OpenCode.",
   "bin": {
     "up-cc": "bin/install.js"

package/references/git-integration.md

@@ -122,13 +122,13 @@ Tasks completed: [N]/[N]
 - [Task 2 name]
 - [Task 3 name]
 
-SUMMARY: .plano/phases/XX-name/{phase}-{plan}-SUMMARY.md
+SUMMARY: .plano/fases/XX-name/{phase}-{plan}-SUMMARY.md
 ```
 
 What to commit:
 
 ```bash
-node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs({phase}-{plan}): complete [plan-name] plan" --files .plano/phases/XX-name/{phase}-{plan}-PLAN.md .plano/phases/XX-name/{phase}-{plan}-SUMMARY.md .plano/STATE.md .plano/ROADMAP.md
+node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs({phase}-{plan}): complete [plan-name] plan" --files .plano/fases/XX-name/{phase}-{plan}-PLAN.md .plano/fases/XX-name/{phase}-{plan}-SUMMARY.md .plano/STATE.md .plano/ROADMAP.md
 ```
 
 **Note:** Code files NOT included - already committed per-task.

package/workflows/discutir-fase.md

@@ -34,7 +34,7 @@ Capturar a ideia em secao "Ideias Adiadas". Nao perca, nao atue sobre ela.
 Numero da fase do argumento (obrigatorio).
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init phase-op "${PHASE}")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init operacao-fase "${PHASE}")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/executar-fase.md

@@ -12,7 +12,7 @@ Orquestrador coordena, nao executa. Cada subagente carrega o contexto completo d
 Carregar contexto:
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init execute-phase "${PHASE_ARG}")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init executar-fase "${PHASE_ARG}")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/executar-plano.md

@@ -13,7 +13,7 @@ Ler config.json para configuracoes de comportamento de planejamento.
 Carregar contexto de execucao:
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init execute-phase "${PHASE}")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init executar-fase "${PHASE}")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/novo-projeto.md

@@ -9,7 +9,7 @@ Inicializar um novo projeto: questionamento, pesquisa (opcional), requisitos, ro
 **PRIMEIRO PASSO OBRIGATORIO -- Execute antes de qualquer interacao:**
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init new-project)
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init novo-projeto)
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/planejar-fase.md

@@ -9,7 +9,7 @@ Flags: --pesquisar (pesquisa profunda), --sem-pesquisa (pular), --auto (encadear
 ## 1. Inicializar
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init plan-phase "$PHASE")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init planejar-fase "$PHASE")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/progresso.md

@@ -8,7 +8,7 @@ Verificar progresso do projeto, resumir trabalho recente e o que vem a seguir, e
 **Carregar contexto de progresso:**
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init progress)
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init progresso)
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/rapido.md

@@ -34,7 +34,7 @@ Exibir banner:
 **Passo 2: Inicializar**
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init quick "$DESCRIPTION")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init rapido "$DESCRIPTION")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/retomar.md

@@ -16,7 +16,7 @@ Restaurar instantaneamente contexto completo do projeto para que "Onde paramos?"
 Carregar contexto:
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init resume)
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init retomar)
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 

package/workflows/verificar-trabalho.md

@@ -18,7 +18,7 @@ Claude apresenta o que DEVERIA acontecer. Usuario confirma ou descreve o que est
 Se $ARGUMENTS contem numero de fase, carregar contexto:
 
 ```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init verify-work "${PHASE_ARG}")
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init verificar-trabalho "${PHASE_ARG}")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```