@polymorphism-tech/morph-spec 4.21.0 → 5.0.1

package/framework/hooks/claude-code/session-start/resume-context.js

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * SessionStart Hook: Resume Context Orientation
- *
- * Event: SessionStart | Matcher: resume
- *
- * Fires ONLY when a session resumes via /resume.
- * Injects a brief orientation message so Claude immediately knows
- * the active feature, phase, in-progress tasks, and last checkpoint.
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import {
-  stateExists, getActiveFeature, derivePhaseForFeature,
-} from '../../shared/state-reader.js';
-import { injectContext, pass } from '../../shared/hook-response.js';
-import { logHookActivity } from '../../shared/activity-logger.js';
-import { SPEC_SUMMARY_MAX_CHARS } from '../../shared/compact-restore.js';
-
-try {
-  if (!stateExists()) pass();
-
-  const active = getActiveFeature();
-  if (!active) pass();
-
-  const { name, feature } = active;
-  const phase = derivePhaseForFeature(name);
-  const cwd = process.cwd();
-
-  const lines = [
-    `🔄 RESUME — Você está continuando a feature "${name}" na fase ${phase}.`,
-  ];
-
-  // In-progress tasks
-  const taskList = Array.isArray(feature.taskList) ? feature.taskList : [];
-  const inProg = taskList.filter(t => t.status === 'in_progress');
-  if (inProg.length > 0) {
-    const ids = inProg.map(t => t.id).join(', ');
-    lines.push(`Tasks em progresso: ${ids}`);
-  }
-
-  // Task progress summary
-  const tasks = feature.tasks || {};
-  if (tasks.total > 0) {
-    lines.push(`Progresso: ${tasks.completed || 0}/${tasks.total} tasks concluídas`);
-  }
-
-  // Last checkpoint
-  const checkpoints = Array.isArray(feature.checkpoints) ? feature.checkpoints : [];
-  if (checkpoints.length > 0) {
-    const last = checkpoints[checkpoints.length - 1];
-    lines.push(`Último checkpoint: #${last.checkpointNum} (${last.passed ? 'passed' : 'failed'})`);
-  }
-
-  // Spec summary (truncated)
-  const specPath = join(cwd, `.morph/features/${name}/2-design/spec.md`);
-  if (existsSync(specPath)) {
-    try {
-      const raw = readFileSync(specPath, 'utf-8');
-      const summary = raw.length > SPEC_SUMMARY_MAX_CHARS
-        ? raw.slice(0, SPEC_SUMMARY_MAX_CHARS) + '\n[... truncated]'
-        : raw;
-      lines.push('');
-      lines.push('Spec summary:');
-      lines.push(summary);
-    } catch { /* non-blocking */ }
-  }
-
-  logHookActivity('resume-context', 'SessionStart', 'resume_injected');
-  injectContext(lines.join('\n'));
-} catch {
-  process.exit(0);
-}

package/framework/hooks/claude-code/teammate-idle/teammate-idle.js

@@ -1,90 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * TeammateIdle Hook: Validate feature before teammate becomes idle
- *
- * Event: TeammateIdle
- *
- * When an Agent Team teammate finishes its turn and is about to go idle,
- * this hook runs `morph-spec validate-feature` to check implementation quality.
- *
- * Exit codes:
- *   0 = validation passed — teammate may become idle
- *   2 = validation failed — send feedback to teammate to continue working
- *
- * Fail-open: exits 0 on any error (never blocks teammate incorrectly).
- */
-
-import { execSync } from 'child_process';
-import { readStdin } from '../../../shared/stdin-reader.js';
-import { loadState, stateExists, getActiveFeature } from '../../../shared/state-reader.js';
-import { logHookActivity } from '../../../shared/activity-logger.js';
-
-try {
-  // Read hook payload (TeammateIdle provides teammate info)
-  const payload = await readStdin();
-
-  if (!stateExists()) process.exit(0);
-
-  // Try to extract feature name from payload or fall back to active feature
-  let featureName = payload?.feature_name || payload?.featureName;
-
-  if (!featureName) {
-    const active = getActiveFeature();
-    featureName = active?.name;
-  }
-
-  if (!featureName) process.exit(0);
-
-  // Only validate during implement phase
-  const state = loadState();
-  const feature = state?.features?.[featureName];
-  if (!feature) process.exit(0);
-
-  // derive phase — only run validation during implement phase
-  const phase = feature.phase;
-  if (phase && phase !== 'implement') process.exit(0);
-
-  // Run validate-feature with --quiet flag (suppress non-error output)
-  let output = '';
-  let exitCode = 0;
-
-  try {
-    output = execSync(
-      `morph-spec validate-feature "${featureName}" --phase implement --quiet`,
-      {
-        cwd: process.cwd(),
-        encoding: 'utf-8',
-        timeout: 30000,
-        stdio: ['pipe', 'pipe', 'pipe'],
-      }
-    );
-  } catch (err) {
-    // Non-zero exit from validate-feature means validation errors
-    exitCode = err.status || 1;
-    output = err.stdout || err.stderr || '';
-  }
-
-  if (exitCode !== 0) {
-    // Exit 2: send feedback to teammate to continue working
-    logHookActivity('teammate-idle', 'TeammateIdle', 'validation_failed');
-    const feedback = [
-      'MORPH-SPEC validation found issues — please fix before going idle:',
-      '',
-      output.trim() || 'Run `morph-spec validate-feature to see details.',
-      '',
-      `Run: morph-spec validate-feature ${featureName} --phase implement`,
-    ].join('\n');
-
-    // Claude Code reads additionalContext from stdout for exit code 2
-    process.stdout.write(JSON.stringify({ additionalContext: feedback }) + '\n');
-    process.exit(2);
-  }
-
-  // Exit 0: validation passed, teammate may become idle
-  logHookActivity('teammate-idle', 'TeammateIdle', 'passed');
-  process.exit(0);
-} catch {
-  // Fail-open: never block a teammate due to hook errors
-  process.exit(0);
-}

package/framework/hooks/claude-code/user-prompt/enrich-prompt.js

@@ -1,114 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * UserPromptSubmit Hook: Enrich User Prompts with Context
- *
- * Event: UserPromptSubmit
- *
- * Scans user prompt for morph-spec keywords and injects relevant context:
- *   - Feature name mentioned → inject its current status/phase
- *   - "implement"/"code" while not in implement phase → warn about wrong phase
- *   - "approve"/"looks good" → inject approval command syntax
- *   - "next task" → inject current task list
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readStdin } from '../../shared/stdin-reader.js';
-import { stateExists, loadState, getActiveFeature, getFeature, getPendingGates, derivePhaseForFeature } from '../../shared/state-reader.js';
-import { injectContext, pass } from '../../shared/hook-response.js';
-import { logHookActivity } from '../../shared/activity-logger.js';
-
-try {
-  if (!stateExists()) pass();
-
-  const payload = await readStdin();
-  if (!payload) pass();
-
-  const userPrompt = payload?.prompt || payload?.user_prompt || payload?.content || '';
-  if (!userPrompt || userPrompt.length < 3) pass();
-
-  const promptLower = userPrompt.toLowerCase();
-  const state = loadState();
-  if (!state?.features) pass();
-
-  const context = [];
-
-  // Check if a feature name is mentioned
-  for (const [featureName, feature] of Object.entries(state.features)) {
-    if (promptLower.includes(featureName.toLowerCase())) {
-      const featurePhase = feature.phase || derivePhaseForFeature(featureName);
-      context.push(`[morph-spec] Feature '${featureName}': phase=${featurePhase}, status=${feature.status}`);
-      const taskList = feature.taskList || [];
-      const activeTasks = taskList.filter(t => t.status !== 'expanded');
-      if (activeTasks.length > 0) {
-        const completed = activeTasks.filter(t => t.status === 'completed').length;
-        context.push(`  Tasks: ${completed}/${activeTasks.length} completed`);
-      }
-      break; // Only inject for the first matched feature
-    }
-  }
-
-  // Check for implement/code intent while not in implement phase
-  const active = getActiveFeature();
-  if (active) {
-    const { name, feature } = active;
-
-    const activePhase = feature.phase || derivePhaseForFeature(name);
-    const codeKeywords = ['implement', 'code', 'start coding', 'write the code', 'build it', 'let\'s build'];
-    const wantsToCode = codeKeywords.some(kw => promptLower.includes(kw));
-
-    if (wantsToCode && activePhase !== 'implement' && activePhase !== 'sync') {
-      context.push(
-        `[morph-spec] WARNING: Feature '${name}' is in '${activePhase}' phase, not 'implement'.` +
-        ` Complete the current phase first or advance: morph-spec phase advance ${name}`
-      );
-    }
-
-    // Coding intent during implement phase but no task in_progress
-    if (wantsToCode && activePhase === 'implement') {
-      const hasActiveTask = feature.taskList?.some(t => t.status === 'in_progress') ||
-        feature.tasks?.inProgress > 0; // fallback for legacy state
-      if (!hasActiveTask) {
-        context.push(
-          `[morph-spec] REMINDER: No task is currently in_progress for '${name}'.` +
-          ` Start a task before coding:\n` +
-          `  morph-spec task start ${name} <id>   # mark it in progress`
-        );
-      }
-    }
-
-    // Check for approval intent
-    const approvalKeywords = ['approve', 'approved', 'looks good', 'lgtm', 'ship it'];
-    const wantsToApprove = approvalKeywords.some(kw => promptLower.includes(kw));
-
-    if (wantsToApprove) {
-      const pending = getPendingGates(name);
-      if (pending.length > 0) {
-        context.push(
-          `[morph-spec] To approve, use: morph-spec approve ${name} ${pending[0]}`
-        );
-      }
-    }
-
-    // Check for "next task" intent
-    if (promptLower.includes('next task') || promptLower.includes('what\'s next')) {
-      if (activePhase === 'implement') {
-        context.push(
-          `[morph-spec] Check tasks.md for the next task, then: morph-spec task start ${name} <id>`
-        );
-      }
-    }
-  }
-
-  if (context.length === 0) {
-    logHookActivity('enrich-prompt', 'UserPromptSubmit', 'ok');
-    pass();
-  }
-
-  logHookActivity('enrich-prompt', 'UserPromptSubmit', 'context_injected');
-  injectContext(context.join('\n'));
-} catch {
-  // Fail-open
-  process.exit(0);
-}

package/framework/hooks/shared/compact-restore.js

@@ -1,123 +0,0 @@
-/**
- * Shared helpers for post-compact context restoration.
- *
- * Used by:
- *   - pre-compact hook: buildRichContext() to enrich memory file
- *   - post-compact-restore hook: buildRestoreBlock() + findLatestMemoryFile() to inject context
- *
- * Pure functions — no I/O.
- */
-
-export const DECISIONS_MAX_CHARS     = 3000;
-export const MAX_PENDING_TASKS       = 8;
-export const SPEC_SUMMARY_MAX_CHARS  = 3000;
-
-/**
- * Build the richContext object to embed in pre-compact memory file.
- * @param {Object} feature          - Feature state object (tasks, taskList, checkpoints)
- * @param {string} phase            - Current derived phase string
- * @param {string} decisionsContent - Raw text of decisions.md (may be empty string)
- * @param {string} [specContent=''] - Raw text of spec.md (may be empty string)
- * @returns {Object} richContext
- */
-export function buildRichContext(feature, phase, decisionsContent, specContent = '') {
-  const taskList = Array.isArray(feature.taskList) ? feature.taskList : [];
-
-  const inProgress = taskList
-    .filter(t => t.status === 'in_progress')
-    .map(t => t.id);
-
-  const nextPending = taskList
-    .filter(t => t.status === 'pending')
-    .slice(0, MAX_PENDING_TASKS)
-    .map(t => ({ id: t.id, title: t.title }));
-
-  const decisionsSnippet = decisionsContent.length > DECISIONS_MAX_CHARS
-    ? decisionsContent.slice(0, DECISIONS_MAX_CHARS)
-    : decisionsContent;
-
-  const specSummary = specContent.length > SPEC_SUMMARY_MAX_CHARS
-    ? specContent.slice(0, SPEC_SUMMARY_MAX_CHARS)
-    : specContent;
-
-  const checkpoints = Array.isArray(feature.checkpoints) ? feature.checkpoints : [];
-  const lastCheckpoint = checkpoints.length > 0
-    ? { passed: checkpoints[checkpoints.length - 1].passed, checkpointNum: checkpoints[checkpoints.length - 1].checkpointNum }
-    : null;
-
-  return {
-    phase,
-    tasks:            feature.tasks || {},
-    decisionsSnippet,
-    inProgress,
-    nextPending,
-    specSummary,
-    lastCheckpoint,
-  };
-}
-
-/**
- * Build the context block string to inject in session-start after compact.
- * @param {Object} memorySnapshot - Parsed pre-compact-*.json file contents
- * @returns {string|null} Block string, or null if no richContext present
- */
-export function buildRestoreBlock(memorySnapshot) {
-  const rc = memorySnapshot?.richContext;
-  if (!rc) return null;
-
-  const { timestamp, activeFeature } = memorySnapshot;
-  const { phase, tasks, decisionsSnippet, inProgress, nextPending, specSummary, lastCheckpoint } = rc;
-
-  const done  = tasks?.completed ?? '?';
-  const total = tasks?.total     ?? '?';
-
-  const lines = [
-    `\uD83D\uDD04 POST-COMPACT RESTORE \u2014 context from pre-compact snapshot (${timestamp})`,
-    `Active feature: ${activeFeature} | Phase: ${phase} | Tasks: ${done}/${total}`,
-  ];
-
-  if (lastCheckpoint) {
-    lines.push(`Last checkpoint: #${lastCheckpoint.checkpointNum} (${lastCheckpoint.passed ? 'passed' : 'failed'})`);
-  }
-
-  if (specSummary) {
-    lines.push('');
-    lines.push('Spec summary (at time of compact):');
-    lines.push(specSummary);
-  }
-
-  if (decisionsSnippet) {
-    lines.push('');
-    lines.push('Key decisions (at time of compact):');
-    lines.push(decisionsSnippet);
-  }
-
-  if (inProgress.length > 0) {
-    lines.push('');
-    lines.push(`In progress at compact time: [${inProgress.join(', ')}]`);
-  }
-
-  if (nextPending.length > 0) {
-    lines.push('');
-    lines.push('Next pending at compact time:');
-    for (const t of nextPending) {
-      lines.push(`  [${t.id}] ${t.title}`);
-    }
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * Find the most recent pre-compact memory file from a list of filenames.
- * Files named pre-compact-{ISO-timestamp-sanitized}.json — sort descending picks latest.
- * @param {string[]} filenames - Array of filenames in the memory directory
- * @returns {string|null} Latest filename, or null if none found
- */
-export function findLatestMemoryFile(filenames) {
-  const matches = filenames
-    .filter(f => f.startsWith('pre-compact-') && f.endsWith('.json'))
-    .sort()
-    .reverse();
-  return matches.length > 0 ? matches[0] : null;
-}

package/framework/hooks/shared/dispatch-helpers.js

@@ -1,147 +0,0 @@
-/**
- * Pure helper functions for the dispatch PostToolUse hook.
- *
- * Extracted for testability — no I/O, no process.exit, no stdin/stdout.
- */
-
-/**
- * Extract VALIDATION DISPATCH JSON from tool output string.
- * Strips ANSI escape codes and parses the JSON block between delimiters.
- *
- * @param {string} toolOutput - Raw tool output (may contain ANSI codes)
- * @returns {object|null} - Parsed dispatch object or null
- */
-export function extractValidationDispatch(toolOutput) {
-  if (!toolOutput || typeof toolOutput !== 'string') return null;
-
-  // Strip ANSI escape codes (chalk colors)
-  const clean = toolOutput.replace(/\x1B\[[0-9;]*m/g, '');
-
-  const match = clean.match(/--- VALIDATION DISPATCH ---\s*\n([\s\S]*?)\n\s*--- END VALIDATION DISPATCH ---/);
-  if (!match) return null;
-
-  try {
-    const dispatch = JSON.parse(match[1]);
-    if (!dispatch?.validators?.length) return null;
-    return dispatch;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Format a dispatch object as a mandatory instruction string for Claude.
- *
- * @param {object} dispatch - Dispatch object with validators array
- * @returns {string} - Formatted injection text
- */
-export function formatValidatorInstruction(dispatch) {
-  if (!dispatch?.validators?.length) return '';
-
-  const lines = [
-    '🔍 MANDATORY VALIDATOR DISPATCH',
-    '════════════════════════════════════════',
-    'You MUST dispatch each validator below as a READ-ONLY subagent using the Agent tool.',
-    'Do NOT skip this step. Do NOT proceed until all blocking validators pass.',
-    '',
-  ];
-
-  for (const v of dispatch.validators) {
-    const blocks = v.blocksOnFail !== false;
-    const sev = v.severity || 'error';
-    lines.push(`### ${v.title} (${v.id})`);
-    lines.push(`Severity: ${sev} | Blocks: ${blocks}`);
-    if (v.checks?.length) lines.push(`Checks: ${v.checks.join(', ')}`);
-    lines.push('');
-    if (v.taskPrompt) {
-      lines.push('Subagent prompt:');
-      lines.push(v.taskPrompt);
-    }
-    lines.push('---');
-  }
-
-  lines.push('');
-  lines.push('DISPATCH INSTRUCTIONS:');
-  lines.push('1. Use the Agent tool for each validator. Set subagent_type to the validator name shown above.');
-  lines.push('2. Use model="haiku" for efficiency. Each validator is read-only.');
-  lines.push('3. Each must return { "passed": boolean, "issues": [] }');
-  lines.push('4. If any blocking validator (Blocks: true) fails, fix issues before proceeding.');
-
-  return lines.join('\n');
-}
-
-/**
- * Parse `morph-spec task done <feature> <taskId>` from a bash command string.
- * Returns { featureName, taskId } or null if the command doesn't match.
- *
- * @param {string} command
- * @returns {{ featureName: string, taskId: string } | null}
- */
-export function parseTaskDoneCommand(command) {
-  if (!command || typeof command !== 'string') return null;
-  const match = command.match(/morph-spec\s+task\s+done\s+(\S+)\s+(\S+)/);
-  if (!match) return null;
-  return { featureName: match[1], taskId: match[2] };
-}
-
-/**
- * Parse `morph-spec phase advance <feature>` from a bash command string.
- * Returns { featureName } or null if the command doesn't match.
- *
- * @param {string} command
- * @returns {{ featureName: string } | null}
- */
-export function parsePhaseAdvanceCommand(command) {
-  if (!command || typeof command !== 'string') return null;
-  const match = command.match(/morph-spec\s+phase\s+advance\s+(\S+)/);
-  if (!match) return null;
-  return { featureName: match[1] };
-}
-
-/**
- * Parse `morph-spec dispatch-agents <feature> <phase>` from a bash command string.
- * Returns { featureName, phase } or null if the command doesn't match.
- *
- * @param {string} command
- * @returns {{ featureName: string, phase: string } | null}
- */
-export function parseDispatchAgentsCommand(command) {
-  if (!command || typeof command !== 'string') return null;
-  const match = command.match(/morph-spec\s+dispatch-agents\s+(\S+)\s+(\S+)/);
-  if (!match) return null;
-  return { featureName: match[1], phase: match[2] };
-}
-
-/**
- * Convert a subagent_type string back to a morph agent ID.
- * Reverses the mapping used when dispatching agents as subagents.
- *
- * Example: 'morph-nextjs-expert' → 'nextjs-expert'
- *
- * @param {string} subagentType - The subagent_type value (e.g. 'morph-nextjs-expert')
- * @returns {string|null} - Agent ID without 'morph-' prefix, or null if invalid
- */
-export function subagentTypeToAgentId(subagentType) {
-  if (!subagentType || typeof subagentType !== 'string') return null;
-  if (!subagentType.startsWith('morph-')) return null;
-  const agentId = subagentType.slice('morph-'.length);
-  if (!agentId) return null;
-  return agentId;
-}
-
-/**
- * Extract the tool result string from a PostToolUse hook payload.
- * Handles multiple possible formats.
- *
- * @param {object} payload - Hook payload
- * @returns {string} - Tool output string (empty string if not found)
- */
-export function getToolOutput(payload) {
-  if (!payload) return '';
-  const result = payload.tool_result;
-  if (typeof result === 'string') return result;
-  if (result && typeof result === 'object') {
-    return result.stdout || result.content || '';
-  }
-  return '';
-}

package/framework/hooks/shared/skill-reminder-helpers.js

@@ -1,79 +0,0 @@
-/**
- * Pure helper functions for the skill-reminder PostToolUse hook.
- * Extracted to shared/ so they can be unit-tested without running the hook entry point.
- */
-
-/**
- * Parse `morph-spec task start <feature> <taskId>` from a bash command string.
- * Returns { featureName, taskId } or null if the command doesn't match.
- *
- * @param {string} command
- * @returns {{ featureName: string, taskId: string } | null}
- */
-export function parseTaskStartCommand(command) {
-  if (!command || typeof command !== 'string') return null;
-  const match = command.match(/morph-spec\s+task\s+start\s+(\S+)\s+(\S+)/);
-  if (!match) return null;
-  return { featureName: match[1], taskId: match[2] };
-}
-
-/**
- * Build the mandatory skill reminder message for a task start event.
- * Returns null if no relevant skills exist for this phase at task-start time.
- *
- * Relevant triggers:
- *   - beforeEachTask   → invoke NOW before writing any code
- *   - beforeTaskDone   → invoke BEFORE marking task done
- *   - onBugOrUnexpected → invoke IF a bug is encountered
- *
- * @param {string} featureName
- * @param {string} taskId
- * @param {string} phase
- * @param {Object|null} phasesData - Parsed phases.json content
- * @returns {string|null}
- */
-export function buildSkillReminderMessage(featureName, taskId, phase, phasesData) {
-  try {
-    const allSkills = phasesData?.phases?.[phase]?.requiredSkills;
-    if (!allSkills || allSkills.length === 0) return null;
-
-    const nowSkills   = allSkills.filter(s => s.trigger === 'beforeEachTask');
-    const laterSkills = allSkills.filter(s => s.trigger === 'beforeTaskDone');
-    const bugSkills   = allSkills.filter(s => s.trigger === 'onBugOrUnexpected');
-
-    if (nowSkills.length === 0 && laterSkills.length === 0) return null;
-
-    const lines = [];
-    lines.push(`⚠️  MORPH-SPEC SKILL REMINDER — Task ${taskId} started (phase: ${phase})`);
-    lines.push('');
-
-    if (nowSkills.length > 0) {
-      lines.push('INVOKE NOW before writing any code:');
-      for (const s of nowSkills) {
-        lines.push(`  → Skill(${s.skill})`);
-      }
-      lines.push('');
-    }
-
-    if (laterSkills.length > 0) {
-      lines.push('INVOKE BEFORE marking task done:');
-      for (const s of laterSkills) {
-        lines.push(`  → Skill(${s.skill})`);
-      }
-      lines.push('');
-    }
-
-    if (bugSkills.length > 0) {
-      lines.push('IF you encounter a bug or unexpected behavior:');
-      for (const s of bugSkills) {
-        lines.push(`  → Skill(${s.skill})`);
-      }
-      lines.push('');
-    }
-
-    lines.push('These are MANDATORY. Use the Skill() tool. Do NOT skip.');
-    return lines.join('\n');
-  } catch {
-    return null;
-  }
-}

package/framework/hooks/shared/stale-task-reset.js

@@ -1,57 +0,0 @@
-/**
- * Stale Task Reset — shared hook utility
- *
- * Detects tasks stuck in `in_progress` for longer than STALE_MS and resets
- * them to `pending`. Works for both v2 (tasks is array) and v3 (taskList)
- * state formats. Pure function: mutates state in-place, returns reset log.
- *
- * Stale threshold: 1 hour (hardcoded — not user-configurable)
- */
-
-export const STALE_MS = 60 * 60 * 1000; // 1 hour
-
-/**
- * Determine if a task is stale (in_progress for longer than STALE_MS).
- * @param {Object} task
- * @param {number} [now] - timestamp for testability (defaults to Date.now())
- * @returns {boolean}
- */
-export function isStaleTask(task, now = Date.now()) {
-  if (task.status !== 'in_progress') return false;
-  if (!task.startedAt) return true; // missing timestamp → treat as stale
-  return now - new Date(task.startedAt).getTime() > STALE_MS;
-}
-
-/**
- * Reset all stale in_progress tasks across all features in state.
- * Mutates state in-place. Returns log of reset task identifiers.
- *
- * @param {Object} state - Full state object (state.features)
- * @param {number} [now] - Timestamp for testability
- * @returns {string[]} resetLog — entries like "feature-name/T008"
- */
-export function resetStaleTasks(state, now = Date.now()) {
-  const resetLog = [];
-
-  for (const [featureName, feature] of Object.entries(state.features || {})) {
-    // Resolve task list for both v2 (array) and v3 (taskList) formats
-    const isV2 = Array.isArray(feature.tasks);
-    const list = isV2 ? feature.tasks : (feature.taskList || []);
-
-    for (const task of list) {
-      if (isStaleTask(task, now)) {
-        task.status = 'pending';
-        delete task.startedAt;
-        resetLog.push(`${featureName}/${task.id ?? '(unknown)'}`);
-      }
-    }
-
-    // Re-sync counters (v3 only — v2 tasks IS the list, no separate counters)
-    if (!isV2 && feature.tasks) {
-      feature.tasks.inProgress = list.filter(t => t.status === 'in_progress').length;
-      feature.tasks.pending = list.filter(t => t.status === 'pending').length;
-    }
-  }
-
-  return resetLog;
-}