@dtlabs/ai-toolkit 0.13.0 → 0.14.0

package/src/claude/workflows/pm-phase2.js

@@ -1,575 +1,54 @@
 export const meta = {
+  controlPlaneVersion: 1,
   name: 'pm-phase2',
-  description: 'Feature delivery phase 2: generate-work-breakdown → Effort-Estimate → gate2_payload. Precondition: Gate 1 approved.',
-  phases: [
-    { title: 'Work Breakdown', detail: 'Run generate-work-breakdown' },
-    { title: 'Effort Estimate', detail: 'Parse WB metrics, write Effort-Estimate.md' },
-  ],
-}
-
-// Output schemas for wb-validate and wb-render agent invocations (used by US-05)
-const WB_WRAPPER_SCHEMA = {
-  type: 'object',
-  properties: {
-    exitCode: { type: 'number' },
-    stdout:   { type: 'string' },
-    stderr:   { type: 'string' },
-  },
-  required: ['exitCode', 'stdout', 'stderr'],
-}
-
-const WB_RENDER_SCHEMA = {
-  type: 'object',
-  properties: {
-    exitCode:       { type: 'number' },
-    stdout:         { type: 'string' },
-    stderr:         { type: 'string' },
-    markdownPath:   { type: 'string' },
-    csvPath:        { type: 'string' },
-    markdownExists: { type: 'boolean' },
-    csvExists:      { type: 'boolean' },
-  },
-  required: ['exitCode', 'stdout', 'stderr', 'markdownPath', 'csvPath', 'markdownExists', 'csvExists'],
-}
-
-const WB_SEMANTIC_SCHEMA = {
-  type: 'object',
-  properties: {
-    valid:    { type: 'boolean' },
-    findings: { type: 'array' },
-  },
-  required: ['valid', 'findings'],
-}
-
-function normalizeError(err) {
-  if (!err) return '<unknown error>'
-  if (typeof err === 'string') return err
-  if (err.message) return err.message
-  if (err.stderr) return err.stderr
-  try { return JSON.stringify(err) } catch (_) { return '<unknown error>' }
-}
-
-// ── Tier 2 resolution guard ───────────────────────────────────────────────────
-// All worker agents must be resolved via the CLI before dispatch.
-// No direct require('lib/agent-registry') — resolution goes through the CLI facade.
-const RESOLVE_SCHEMA = {
-  type: 'object',
-  properties: {
-    nativeName:  { type: 'string' },
-    status:      { type: 'string' },
-    agentId:     { type: 'string' },
-    exitNonZero: { type: 'boolean' },
-    error:       { type: 'string' },
-  },
-}
-
-async function resolveAgentTier2(agentId, label, phaseName) {
-  const result = await agent(
-    `Run this command via Bash:\n\nai-toolkit agents resolve --project . --id ${agentId} --require-verified\n\nIf the command exits 0: parse the JSON from stdout and return it with exitNonZero: false.\nIf the command exits non-zero: return {"exitNonZero": true, "error": "<stderr text>", "agentId": "${agentId}"}.`,
-    { label, phase: phaseName, model: 'haiku', schema: RESOLVE_SCHEMA }
-  )
-  if (!result || result.exitNonZero || !result.nativeName) {
-    throw new Error(`HARD STOP — Tier 2 resolution failed for ${agentId}: ${result && result.error ? result.error : 'no nativeName returned'}`)
+  description: 'Generate, validate and render a work breakdown with deterministic control-plane operations.',
+  phases: [{ title: 'Work Breakdown' }, { title: 'Effort Estimate' }],
+}
+
+
+
+const c = control
+const { featurePath, featureDir, prefix } = c.feature(args[0])
+return c.run(meta.name, featureDir, prefix, async () => {
+  const file = suffix => `${featureDir}/${prefix}-${suffix}`
+  const approvals = c.read(file('Approvals.md'))
+  const gate = approvals.match(/^## Gate 1\b[^\n]*\n([\s\S]*?)(?=^## |$(?![\s\S]))/m)
+  if (!gate || !/✅\s*Approved/.test(gate[1])) throw new Error('Gate 1 approval evidence missing')
+  await c.worker('gaia.agent.planner.work-breakdown', featurePath)
+  const jsonPath = file('Work-Breakdown.json')
+  const report = await c.activity('wb-validate', async () => {
+    const res = c.command(['run-asset', 'scripts/wb-validate.js', '--project', c.root,
+      '--', jsonPath, file('Requirements.md')], [0, 1])
+    const parsed = JSON.parse(res.stdout)
+    if (typeof parsed.valid !== 'boolean' || !Array.isArray(parsed.errors) ||
+        !Array.isArray(parsed.warnings) || (res.exitCode === 0) !== parsed.valid) throw new Error('Invalid validator result')
+    if (!parsed.valid || parsed.errors.length) throw new Error('Work breakdown structural validation failed: ' + res.stdout)
+    return parsed
+  })
+  const semantic = await c.worker('gaia.agent.planner.validate-work-breakdown',
+    `${jsonPath}\n${file('Requirements.md')}`, { schema: {
+      type: 'object', properties: { valid: { type: 'boolean' }, findings: { type: 'array' } }, required: ['valid', 'findings'],
+    } })
+  if (!semantic.valid || semantic.findings.some(f => f.blocking)) throw new Error('Work breakdown semantic validation failed')
+  const rendered = await c.activity('wb-render', async () => {
+    const result = c.command(['run-asset', 'scripts/wb-render.js', '--project', c.root, '--', jsonPath, prefix])
+    const markdownPath = file('Work-Breakdown.md'), csvPath = file('Work-Breakdown.csv')
+    if (!c.exists(markdownPath) || !c.exists(csvPath)) throw new Error('Renderer outputs missing')
+    // Read the actual bytes now: unreadable output must never produce an approved gate.
+    c.read(markdownPath); c.read(csvPath)
+    return { ...result, markdownPath, csvPath, markdownExists: true, csvExists: true }
+  })
+  const metrics = await c.estimates(featureDir, prefix, c.json(jsonPath))
+  c.append(file('process-log.txt'), `[${new Date().toISOString()}] pm-phase2 complete; Gate 2 approval requested\n`)
+  return {
+    ...metrics, feature_path: featurePath, token_ledger: c.tokenLedger, errors: [],
+    gate2_payload: {
+      js_validator_report: report, js_validator_failed: false,
+      semantic_validator_result: semantic, semantic_validator_failed: false,
+      renderer_result: rendered, renderer_failed: false, gate2_blocked: false,
+      duration_bands: report.durationBands, domain_distribution: report.domainDistribution,
+      warning_band_tasks: report.warnings.filter(w => w.category === 'duration_warning').map(w => ({ taskId: w.taskId, agentMinutes: w.details?.agentMinutes })),
+      split_required_tasks: [], must_ac_uncovered: [], phase_unschedulable: [],
+    },
   }
-  return result.nativeName
-}
-
-// ── Parse args ────────────────────────────────────────────────────────────────
-
-// args: "<path-to-feature.md>"
-const featurePath = (typeof args === 'string' ? args : '').trim().split(/\s+/)[0]
-
-// Feature directory = parent of the feature.md path. Separator-agnostic: the workflow
-// runtime provides no `path` module, so we cannot use path.dirname. Handle BOTH POSIX
-// "/" and Windows "\": strip a trailing "<sep>feature.md" tail when present; if the
-// input is already a directory (no feature.md tail), strip only a trailing separator.
-// This replaces the previous POSIX-only regex (/\/[^/]+$/), which left "\feature.md"
-// attached on Windows paths and produced malformed "…\feature.md/…json" paths that only
-// "worked" because an LLM wrapper agent silently repaired them.
-function deriveFeatureDir(featurePath) {
-  return /[/\\]feature\.md$/i.test(featurePath)
-    ? featurePath.replace(/[/\\]feature\.md$/i, '')
-    : featurePath.replace(/[/\\]+$/, '')
-}
-
-// Derive feature directory and prefix early (needed for ledger writes before metrics agent runs)
-const featureDir  = deriveFeatureDir(featurePath)
-const prefixMatch = featureDir.match(/([A-Z]+-\d+)/)
-const prefix      = prefixMatch ? prefixMatch[1] : 'FTR-000'
-
-// ── Tier 3 — self-ledger helper ───────────────────────────────────────────────
-const SELF_LEDGER_SCHEMA = {
-  type: 'object',
-  properties: {
-    exitCode: { type: 'number' },
-    stdout:   { type: 'string' },
-    stderr:   { type: 'string' },
-  },
-  required: ['exitCode'],
-}
-
-async function selfLedgerOp(cmd, label, phaseName) {
-  const result = await agent(
-    `Run this shell command via Bash and return the exit code as structured output.\n\nCommand: ${cmd}\n\nCapture: exitCode (integer), stdout (string), stderr (string). Return all three.`,
-    { label, phase: phaseName, model: 'haiku', schema: SELF_LEDGER_SCHEMA }
-  )
-  const status = (result && typeof result.exitCode === 'number') ? result.exitCode : 1
-  if (status !== 0) {
-    throw new Error(`HARD STOP — self-ledger operation failed. Exit code: ${status}. Command: ${cmd}`)
-  }
-}
-
-// ── Tier 3 self-registration (open BEFORE any main logic, fail-closed) ────────
-await selfLedgerOp(
-  `ai-toolkit ledger open --prefix ${prefix} --agent pm-phase2:self --phase phase2 --dir "${featureDir}" --attempt 1`,
-  'ledger-open-pm-phase2-self', 'Work Breakdown'
-)
-
-// ── generate-work-breakdown ───────────────────────────────────────────────────
-phase('Work Breakdown')
-
-const tokenLedger = []
-
-log(`Running generate-work-breakdown for ${featurePath}`)
-const wbNativeName = await resolveAgentTier2('gaia.agent.planner.work-breakdown', 'resolve-generate-work-breakdown', 'Work Breakdown')
-const wbKey = 'generate-work-breakdown:phase2'
-await agent(
-  `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger open --dir ${featureDir} --prefix ${prefix} --agent ${wbKey} --phase phase2 --model haiku --attempt 1\n\nReturn no output.`,
-  { label: 'ledger-open-generate-work-breakdown', phase: 'Work Breakdown', model: 'haiku' }
-)
-const beforeWB = budget.spent()
-await agent(featurePath, {
-  agentType: wbNativeName,
-  label:     'generate-work-breakdown',
-  phase:     'Work Breakdown',
 })
-const wbTokens = budget.spent() - beforeWB
-await agent(
-  `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger close --dir ${featureDir} --prefix ${prefix} --agent ${wbKey} --tokens ${wbTokens} --attempt 1\n\nReturn no output.`,
-  { label: 'ledger-close-generate-work-breakdown', phase: 'Work Breakdown', model: 'haiku' }
-)
-tokenLedger.push({ agent: 'generate-work-breakdown', model: 'haiku', phase_delta_tokens: wbTokens })
-log(`generate-work-breakdown done — phase delta: ${wbTokens} tokens`)
-
-// ── Step 2: wb-validate.js (deterministic structural validator) ───────────────
-let wbValidatorReport = null
-let validateFailed = false
-let validateExitCode = null
-const wbValidateKey = 'wb-validate:phase2'
-await agent(
-  `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger open --dir ${featureDir} --prefix ${prefix} --agent ${wbValidateKey} --phase phase2 --model haiku --attempt 1\n\nReturn no output.`,
-  { label: 'ledger-open-wb-validate', phase: 'Work Breakdown', model: 'haiku' }
-)
-const beforeValidate = budget.spent()
-try {
-  const validateWrapper = await agent(
-    `Run this command and return the result as structured output:\n` +
-    `ai-toolkit run-asset scripts/wb-validate.js -- "${featureDir}/${prefix}-Work-Breakdown.json" "${featureDir}/${prefix}-Requirements.md"\n\n` +
-    `Capture exitCode (integer), stdout (string), stderr (string). Return all three.`,
-    {
-      label:  'wb-validate',
-      phase:  'Work Breakdown',
-      model:  'haiku',
-      schema: WB_WRAPPER_SCHEMA,
-    }
-  )
-  validateExitCode = validateWrapper.exitCode
-  if (validateWrapper.stderr?.trim()) {
-    log(`wb-validate stderr: ${validateWrapper.stderr.trim()}`)
-  }
-  if (validateWrapper.exitCode === 2) {
-    throw Object.assign(
-      new Error(validateWrapper.stderr?.trim() || 'wb-validate runtime error (exit 2)'),
-      { _exitCode: validateWrapper.exitCode }
-    )
-  }
-  if (![0, 1].includes(validateWrapper.exitCode)) {
-    throw Object.assign(
-      new Error(`wb-validate unexpected exit code: ${validateWrapper.exitCode}`),
-      { _exitCode: validateWrapper.exitCode }
-    )
-  }
-  if (!validateWrapper.stdout?.trim()) {
-    throw new Error('wb-validate returned empty stdout')
-  }
-  wbValidatorReport = JSON.parse(validateWrapper.stdout)
-  if (validateWrapper.exitCode === 0 && !wbValidatorReport.valid) {
-    throw new Error('Inconsistent wb-validate result: exit 0 with valid=false')
-  }
-  if (validateWrapper.exitCode === 1 && wbValidatorReport.valid) {
-    throw new Error('Inconsistent wb-validate result: exit 1 with valid=true')
-  }
-} catch (err) {
-  validateFailed = true
-}
-const validateTokens = budget.spent() - beforeValidate
-await agent(
-  `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger close --dir ${featureDir} --prefix ${prefix} --agent ${wbValidateKey} --tokens ${validateTokens} --attempt 1\n\nReturn no output.`,
-  { label: 'ledger-close-wb-validate', phase: 'Work Breakdown', model: 'haiku' }
-)
-const wbValidatorPassed = !validateFailed && wbValidatorReport !== null
-  && wbValidatorReport.valid === true && wbValidatorReport.errors.length === 0
-log(`wb-validate: ${wbValidatorPassed ? 'passed' : 'failed/errors'} — ${validateTokens} tokens`)
-
-// ── Step 3: Semantic validator (only if wb-validate passed) ───────────────────
-let semanticResult = null
-let semanticFailed = false
-let semanticTokens = 0
-const semanticKey = 'validate-work-breakdown-semantic:phase2'
-if (!wbValidatorPassed) {
-  log('validate-work-breakdown-semantic: skipped (wb-validate did not pass)')
-} else {
-  const semanticNativeName = await resolveAgentTier2('gaia.agent.planner.validate-work-breakdown', 'resolve-validate-work-breakdown-semantic', 'Work Breakdown')
-  await agent(
-    `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger open --dir ${featureDir} --prefix ${prefix} --agent ${semanticKey} --phase phase2 --model sonnet --attempt 1\n\nReturn no output.`,
-    { label: 'ledger-open-semantic-validator', phase: 'Work Breakdown', model: 'haiku' }
-  )
-  const beforeSemantic = budget.spent()
-  try {
-    semanticResult = await agent(
-      `${featureDir}/${prefix}-Work-Breakdown.json\n${featureDir}/${prefix}-Requirements.md`,
-      {
-        label:     'validate-work-breakdown-semantic',
-        phase:     'Work Breakdown',
-        agentType: semanticNativeName,
-        schema:    WB_SEMANTIC_SCHEMA,
-      }
-    )
-  } catch (err) {
-    semanticFailed = true
-  }
-  semanticTokens = budget.spent() - beforeSemantic
-  await agent(
-    `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger close --dir ${featureDir} --prefix ${prefix} --agent ${semanticKey} --tokens ${semanticTokens} --attempt 1\n\nReturn no output.`,
-    { label: 'ledger-close-semantic-validator', phase: 'Work Breakdown', model: 'haiku' }
-  )
-}
-log(`semantic validator: ${semanticFailed ? 'failed' : semanticResult ? 'done' : 'skipped'}`)
-
-// ── Step 4: wb-render.js (only if wb-validate passed and semantic did not fail) ─
-const canRender = wbValidatorPassed && !semanticFailed
-let renderFailed = false
-let renderResult = null
-const wbRenderKey = 'wb-render:phase2'
-if (!canRender) {
-  log('wb-render: skipped (wb-validate or semantic validator did not pass)')
-} else {
-  await agent(
-    `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger open --dir ${featureDir} --prefix ${prefix} --agent ${wbRenderKey} --phase phase2 --model haiku --attempt 1\n\nReturn no output.`,
-    { label: 'ledger-open-wb-render', phase: 'Work Breakdown', model: 'haiku' }
-  )
-  const beforeRender = budget.spent()
-  try {
-    renderResult = await agent(
-      `Run this command and return the result as structured output:\n` +
-      `ai-toolkit run-asset scripts/wb-render.js -- "${featureDir}/${prefix}-Work-Breakdown.json" "${prefix}"\n\n` +
-      `Capture exitCode (integer), stdout (string), stderr (string).\n` +
-      `Resolve the expected output paths:\n` +
-      `  markdownPath = "${featureDir}/${prefix}-Work-Breakdown.md"\n` +
-      `  csvPath      = "${featureDir}/${prefix}-Work-Breakdown.csv"\n` +
-      `Check whether each file exists on disk and return:\n` +
-      `  markdownExists (boolean), csvExists (boolean).\n` +
-      `Return all seven fields.`,
-      {
-        label:  'wb-render',
-        phase:  'Work Breakdown',
-        model:  'haiku',
-        schema: WB_RENDER_SCHEMA,
-      }
-    )
-    if (renderResult.stderr?.trim()) {
-      log(`wb-render stderr: ${renderResult.stderr.trim()}`)
-    }
-    if (renderResult.exitCode !== 0) {
-      throw Object.assign(
-        new Error(`wb-render exited ${renderResult.exitCode}: ${renderResult.stderr?.trim() || renderResult.stdout?.trim()}`),
-        { _exitCode: renderResult.exitCode }
-      )
-    }
-    if (!renderResult.markdownPath?.trim()) throw new Error('wb-render did not return markdownPath')
-    if (!renderResult.csvPath?.trim()) throw new Error('wb-render did not return csvPath')
-    if (!renderResult.markdownExists) {
-      throw Object.assign(
-        new Error(`wb-render output file not found: ${renderResult.markdownPath}`),
-        { _exitCode: renderResult.exitCode }
-      )
-    }
-    if (!renderResult.csvExists) {
-      throw Object.assign(
-        new Error(`wb-render output file not found: ${renderResult.csvPath}`),
-        { _exitCode: renderResult.exitCode }
-      )
-    }
-  } catch (err) {
-    renderFailed = true
-  }
-  const renderTokens = budget.spent() - beforeRender
-  await agent(
-    `Run this shell command via Bash. If the --dir path contains spaces, enclose it in double quotes.\n\nai-toolkit ledger close --dir ${featureDir} --prefix ${prefix} --agent ${wbRenderKey} --tokens ${renderTokens} --attempt 1\n\nReturn no output.`,
-    { label: 'ledger-close-wb-render', phase: 'Work Breakdown', model: 'haiku' }
-  )
-  tokenLedger.push({ agent: 'wb-render', model: 'haiku', phase_delta_tokens: renderTokens })
-}
-
-tokenLedger.push({ agent: 'wb-validate', model: 'haiku', phase_delta_tokens: validateTokens })
-tokenLedger.push({ agent: 'validate-work-breakdown-semantic', model: 'sonnet', phase_delta_tokens: semanticTokens })
-
-// ── Step 5: Assemble gate2_payload ────────────────────────────────────────────
-const gate2_payload = {
-  js_validator_report:       wbValidatorReport,
-  js_validator_failed:       validateFailed,
-  semantic_validator_result: semanticResult,
-  semantic_validator_failed: semanticFailed,
-  renderer_result:           renderResult,
-  renderer_failed:           renderFailed,
-  duration_bands:      wbValidatorReport ? wbValidatorReport.durationBands : null,
-  domain_distribution: wbValidatorReport ? wbValidatorReport.domainDistribution : null,
-  warning_band_tasks:  wbValidatorReport
-    ? wbValidatorReport.warnings.filter(w => w.category === 'duration_warning')
-        .map(w => ({ taskId: w.taskId, agentMinutes: w.details ? w.details.agentMinutes : null }))
-    : [],
-  split_required_tasks: wbValidatorReport
-    ? wbValidatorReport.errors.filter(e => e.category === 'split_required')
-        .map(e => ({ taskId: e.taskId, agentMinutes: e.details ? e.details.agentMinutes : null }))
-    : [],
-  must_ac_uncovered: wbValidatorReport
-    ? wbValidatorReport.errors.filter(e => e.category === 'must_ac_uncovered')
-        .map(e => ({ acId: e.details ? e.details.acId : null }))
-    : [],
-  phase_unschedulable: wbValidatorReport
-    ? (wbValidatorReport.dependencies ? wbValidatorReport.dependencies.phaseUnschedulable || [] : [])
-    : [],
-  gate2_blocked:
-    validateFailed ||
-    !wbValidatorPassed ||
-    semanticFailed ||
-    renderFailed ||
-    Boolean(semanticResult && semanticResult.findings && semanticResult.findings.some(f => f.blocking)),
-}
-log(`gate2_payload assembled — gate2_blocked: ${gate2_payload.gate2_blocked}`)
-
-// ── Parse WB + write Effort-Estimate + Token-Estimate ────────────────────────
-phase('Effort Estimate')
-
-const PARSE_SCHEMA = {
-  type: 'object',
-  properties: {
-    prefix:                { type: 'string' },
-    feature_dir:           { type: 'string' },
-    user_stories:          { type: 'number' },
-    total_tasks:           { type: 'number' },
-    domain_breakdown:      { type: 'string' },
-    implementation_phases: { type: 'number' },
-    human_estimate:        { type: 'string' },
-    agent_estimate:        { type: 'string' },
-    work_breakdown_path:   { type: 'string' },
-    effort_estimate_path:  { type: 'string' },
-    token_estimate_path:   { type: 'string' },
-    tasks_csv_path:        { type: 'string' },
-  },
-  required: ['prefix', 'user_stories', 'total_tasks', 'work_breakdown_path'],
-}
-
-// ── Load token pricing ────────────────────────────────────────────────────────
-// Pricing config is read inline (haiku agent) so it survives path-agnostic installs.
-// Cost formula: tokens * (0.8 * input + 0.2 * output) / 1_000_000 * usd_to_eur
-// (80/20 input/output split — no per-agent breakdown available in the ledger)
-const pricingRaw = await agent(
-  `Read the file docs/token-pricing.json and return its raw JSON contents as a string, nothing else.`,
-  { label: 'read-pricing', phase: 'Effort Estimate', model: 'haiku' }
-)
-let pricing = null
-try { pricing = JSON.parse(typeof pricingRaw === 'string' ? pricingRaw.trim() : '{}') } catch (_) {}
-
-function tokenCostEur(tokens, model) {
-  if (!pricing || !pricing.models) return null
-  const m = pricing.models[model] || pricing.models['sonnet']
-  const usdPer1M = 0.8 * m.input_per_1m_usd + 0.2 * m.output_per_1m_usd
-  return (tokens * usdPer1M / 1_000_000) * (pricing.usd_to_eur || 1)
-}
-
-function formatEur(val) {
-  if (val === null || val === undefined) return '—'
-  return '€' + val.toFixed(4)
-}
-
-// NOTE: pm-phase2 is a separate workflow and does NOT receive pm-phase1's token ledger,
-// so the real Phase 1 actuals (generate-requirements/tech-spec/validate) are unknown here.
-// They are written as "—" placeholders below and filled later by the orchestrator (the
-// implement-feature skill Step 7, which holds all three phase ledgers). Do NOT reuse wbTokens
-// as a stand-in for Phase 1 — that mislabels Phase 2's tokens as Phase 1's.
-
-const metrics = await agent(
-  `You have four tasks:
-
-TASK 1 — Read the Work Breakdown JSON file.
-The feature.md is at: ${featurePath}
-The JSON work breakdown is at: ${featureDir}/${prefix}-Work-Breakdown.json
-Read the JSON file and extract:
-- prefix (e.g. "FTR-009") — use "${prefix}"
-- feature_dir (directory containing feature.md) — use "${featureDir}"
-- feature_title — from wb.title or wb.feature field
-- total_tasks (integer) — count all tasks across all phases
-- user_stories (integer) — count phases whose id starts with "US-"
-- domain_breakdown (string) — e.g. "BE: N, FE: N, DB: N, INFRA: N, TEST: N"
-- implementation_phases (integer) — total number of phases
-- human_estimate — compute as: (BE_tasks * 120 + TEST_tasks * 60 + INFRA_tasks * 30 + FE_tasks * 90 + DB_tasks * 90) minutes, format as "~Xh Ymin"
-- agent_estimate — human_estimate / 4 (parallel dispatch), format as "~Xmin" or "~Xh Ymin"
-- work_breakdown_path — ${featureDir}/${prefix}-Work-Breakdown.json
-
-Also extract per-User-Story details for the Effort-Estimate:
-- US ID (phase.id where it starts with "US-")
-- US title (phase.title)
-- task count (phase.tasks.length)
-- domains involved (unique task.domain values in the phase)
-- estimated hours (per the formula above)
-
-TASK 2 — Write the Effort-Estimate.md file.
-Write {feature_dir}/{PREFIX}-Effort-Estimate.md with this format:
-
-# Effort Estimate — {PREFIX} — {feature_title}
-
-## Summary
-
-| Metric | Value |
-|--------|-------|
-| User Stories | {user_stories} |
-| Total tasks | {total_tasks} ({domain_breakdown}) |
-| Implementation phases | {implementation_phases} |
-| Human estimate | {human_estimate} (sequential, no parallelism) |
-| Agent estimate | {agent_estimate} (parallel dispatch, critical path only) |
-
-## Per-Phase Breakdown
-
-| Phase | Title | Tasks | Domains | Est. Human | Est. Agent | Actual Human | Actual Agent |
-|-------|-------|-------|---------|-----------|-----------|-------------|-------------|
-{one row per phase (INFRA + each US) extracted from Section 4 of the Work Breakdown — use ~2h per BE task, ~1h per TEST task, ~30min per INFRA task for human estimate; agent estimate = human / 6 as baseline}
-| **Total** | | **{total_tasks}** | | **{human_estimate}** | **{agent_estimate}** | **—** | **—** |
-
-## Notes
-- Human estimate assumes sequential execution with no parallelism.
-- Agent estimate assumes parallel dispatch of independent tasks within each phase (critical path only).
-- Actual Human: filled in if a human developer performed or reviewed the implementation.
-- Actual Agent: filled in by pm-phase3 after implementation completes.
-
-TASK 3 — Write the Token-Estimate.md file.
-Write {feature_dir}/{PREFIX}-Token-Estimate.md with this format:
-
-# Token Estimate — {PREFIX} — {feature_title}
-
-## Phase 1 — Documentation (Actuals)
-
-Phase 1 ran in a separate workflow (pm-phase1); its per-agent token actuals are filled in
-by the orchestrator after implementation. Leave the Tokens Actual cells as "—" here.
-
-| Agent | Task | Model | Tokens Est. | Est. cost € | Tokens Actual | Actual cost € |
-|-------|------|-------|------------|------------|--------------|--------------|
-| generate-requirements | Generate requirements from feature.md | haiku | — | — | — | — |
-| generate-tech-spec | Generate tech spec from feature.md | haiku | — | — | — | — |
-| validate-feature-docs | Validate requirements + tech spec | haiku | — | — | — | — |
-| **Phase 1 total** | | | **—** | **—** | **—** | **—** |
-
-## Phase 2 — Work Breakdown (Actuals)
-
-| Agent | Task | Model | Tokens Est. | Est. cost € | Tokens Actual | Actual cost € |
-|-------|------|-------|------------|------------|--------------|--------------|
-| generate-work-breakdown | Generate work breakdown from docs | haiku | — | — | {wbTokens from above} | ${formatEur(tokenCostEur(wbTokens, 'haiku'))} |
-| **Phase 2 total** | | | **—** | **—** | **{wbTokens from above}** | **${formatEur(tokenCostEur(wbTokens, 'haiku'))}** |
-
-## Phase 3 — Implementation (Estimates)
-
-Estimates based on {total_tasks} tasks ({domain_breakdown}), {user_stories} User Stories.
-Baseline: ~15,000 tokens/BE task, ~8,000/TEST task, ~5,000/INFRA task.
-
-| Agent | Task | Model | Tokens Est. | Est. cost € | Tokens Actual | Actual cost € |
-|-------|------|-------|------------|------------|--------------|--------------|
-| developer-backend | Implement BE/INFRA tasks | sonnet | {estimated: be_tasks * 15000 + infra_tasks * 5000} | {cost for that estimate, sonnet} | — | — |
-| developer-testing | Implement TEST tasks | sonnet | {estimated: test_tasks * 8000} | {cost for that estimate, sonnet} | — | — |
-| review-solution (×{user_stories}) | Architect review per US | sonnet | {estimated: user_stories * 8000} | {cost for that estimate, sonnet} | — | — |
-| remediation | Fix review issues | sonnet | ~10,000 | {cost for 10000, sonnet} | — | — |
-| pr-and-registry | Push branch, create PR | sonnet | ~5,000 | {cost for 5000, sonnet} | — | — |
-| write-actuals | Update Token/Effort Estimate | sonnet | ~3,000 | {cost for 3000, sonnet} | — | — |
-| **Phase 3 total** | | | **{sum of phase 3 token estimates}** | **{sum of phase 3 cost estimates}** | **—** | **—** |
-
-For the "Est. cost €" column in Phase 3: use the formula tokens * (0.8 * 3.00 + 0.2 * 15.00) / 1_000_000 * ${pricing ? pricing.usd_to_eur : 0.92} for sonnet rows. Round to 4 decimal places, prefix with €.
-
-## Grand Total
-
-| Phase | Tokens Est. | Est. cost € | Tokens Actual | Actual cost € |
-|-------|------------|------------|--------------|--------------|
-| Phase 1 — Documentation | — | — | — (filled by orchestrator) | — |
-| Phase 2 — Work Breakdown | — | — | {wbTokens from above} | ${formatEur(tokenCostEur(wbTokens, 'haiku'))} |
-| Phase 3 — Implementation | {sum of phase 3 token estimates} | {sum of phase 3 cost estimates} | — | — |
-| **Total** | **{sum of phase 3 token estimates}** | **{sum of phase 3 cost estimates}** | **{wbTokens} (partial)** | **${formatEur(tokenCostEur(wbTokens, 'haiku'))} (partial)** |
-
----
-*Actuals will be appended by pm-phase3 after implementation completes.*
-*Cost assumes 80% input / 20% output token split. Pricing: sonnet $3.00/$15.00 per 1M, haiku $0.80/$4.00 per 1M (USD). Rate: $1 = €${pricing ? pricing.usd_to_eur : '0.92'} (${pricing ? pricing.usd_to_eur_date : 'see docs/token-pricing.json'}).*
-
-TASK 4 — Set return values.
-Set effort_estimate_path to the full path of the written Effort-Estimate.md.
-Set token_estimate_path to the full path of the written Token-Estimate.md.
-Set tasks_csv_path to "${featureDir}/${prefix}-Work-Breakdown.csv" (written by wb-render in the same directory as feature.md).
-
-Return the extracted metrics as structured output.`,
-  {
-    label:  'parse-wb-write-estimates',
-    phase:  'Effort Estimate',
-    schema: PARSE_SCHEMA,
-  }
-)
-
-log(`WB parsed: ${metrics.user_stories} US, ${metrics.total_tasks} tasks, ${metrics.implementation_phases} phases`)
-log(`Effort-Estimate written: ${metrics.effort_estimate_path}`)
-log(`Token-Estimate written: ${metrics.token_estimate_path}`)
-
-// ── Append to process-log (phase 2 events) ───────────────────────────────────
-const wbEntry = tokenLedger.find(e => e.agent === 'generate-work-breakdown')
-const phase2Events = [
-  `APPROVAL GRANTED by user — Gate 1`,
-  `pm-phase2 START — work breakdown phase`,
-  `Agent DONE: generate-work-breakdown — tokens: ${wbEntry ? wbEntry.phase_delta_tokens : 'N/A'}`,
-  `Written: ${metrics.prefix}-Work-Breakdown.md (${metrics.user_stories} US, ${metrics.total_tasks} tasks, ${metrics.implementation_phases} phases)`,
-  `Written: ${metrics.prefix}-Effort-Estimate.md`,
-  `pm-phase2 COMPLETE`,
-  `APPROVAL REQUESTED — Gate 2`,
-].join('\n')
-
-await agent(
-  `Append phase 2 events to the process-log for this feature delivery run.
-
-Process-log path: ${metrics.feature_dir}/${metrics.prefix}-process-log.txt
-
-Steps:
-1. Get current UTC datetime via Bash: run \`date -u +"%Y-%m-%dT%H:%M:%S"\`
-2. Append the following lines to the existing file. Use the datetime from step 1 for ALL event lines.
-   Format each event line as: [{datetime}] {event text}
-
-Events to append:
-${phase2Events}`,
-  { label: 'append-process-log', phase: 'Effort Estimate' }
-)
-
-// ── Tier 3 self-registration — close on successful completion ─────────────────
-await selfLedgerOp(
-  `ai-toolkit ledger close --prefix ${prefix} --agent pm-phase2:self --dir "${featureDir}" --attempt 1`,
-  'ledger-close-pm-phase2-self', 'Effort Estimate'
-)
-
-return {
-  prefix:                metrics.prefix || prefix,
-  feature_path:          featurePath,
-  user_stories:          metrics.user_stories,
-  total_tasks:           metrics.total_tasks,
-  domain_breakdown:      metrics.domain_breakdown  || 'N/A',
-  implementation_phases: metrics.implementation_phases,
-  human_estimate:        metrics.human_estimate    || 'N/A',
-  agent_estimate:        metrics.agent_estimate    || 'N/A',
-  work_breakdown_path:   metrics.work_breakdown_path,
-  effort_estimate_path:  metrics.effort_estimate_path || '',
-  token_estimate_path:   metrics.token_estimate_path  || '',
-  tasks_csv_path:        metrics.tasks_csv_path        || '',
-  token_ledger:          tokenLedger,
-  errors:                [],
-  gate2_payload,
-}