avorelo 0.1.0 → 0.3.0

package/scripts/lib/work-panel-preview.js

@@ -1,352 +0,0 @@
-"use strict";
-
-// ── Work Panel Preview ────────────────────────────────────────────────────────
-//
-// Contract: avorelo.workPanelPreview.v1
-//
-// Generates a local-only compact preview of the current execution packet.
-// V1: JSON preview artifact + compact CLI-rendered preview.
-//
-// Not a permanent dashboard. Not a CSS editor. Not browser injection.
-// Local-only artifacts. No network. No auto-apply.
-
-const fs = require("fs");
-const path = require("path");
-const { ensureCcoDirs } = require("./fsx");
-const { appendProductLearningEvent } = require("./product-learning-events");
-
-const CONTRACT = "avorelo.workPanelPreview.v1";
-const SCHEMA_VERSION = 1;
-
-const LATEST_PREVIEW_JSON_REL = ".claude/cco/orchestration/work-panel/latest-preview.json";
-const LATEST_PREVIEW_HTML_REL = ".claude/cco/orchestration/work-panel/latest-preview.html";
-
-function safeReadJson(absPath) {
-  try {
-    if (!fs.existsSync(absPath)) return null;
-    return JSON.parse(fs.readFileSync(absPath, "utf8").replace(/^/, ""));
-  } catch {
-    return null;
-  }
-}
-
-function nowIso() {
-  return new Date().toISOString();
-}
-
-// ── Panel content builder ─────────────────────────────────────────────────────
-
-function buildPanelContent(packet, projectProfile) {
-  if (!packet) {
-    return {
-      status: "no_packet",
-      message: "No execution packet found. Run `avorelo execution-packet <task>` first.",
-      goal: null,
-      mode: null,
-      riskLevel: null,
-      approvalRequired: false,
-      proofRequired: [],
-      allowedScopeSummary: null,
-      blockedScopeSummary: null,
-      makeSaferSuggestion: null,
-      cancelInstruction: null,
-    };
-  }
-
-  const riskLevel = packet.risk?.level || "unknown";
-
-  // Make safer suggestion based on mode and risk
-  let makeSaferSuggestion = null;
-  if (riskLevel === "high" || riskLevel === "critical") {
-    makeSaferSuggestion = "Switch to 'refactor_plan' mode to scope changes before executing, or request manual approval.";
-  } else if (packet.mode === "fast_prototype") {
-    makeSaferSuggestion = "Switch to 'safe_patch' mode for diff-first, proof-first execution.";
-  }
-
-  return {
-    status: "ready",
-    goal: packet.goal,
-    mode: packet.mode,
-    riskLevel,
-    approvalRequired: packet.userApproval || false,
-    proofRequired: (packet.requiredAfterWrite || []),
-    diffRequired: packet.diffRequired || false,
-    allowedScopeSummary: {
-      actions: (packet.allowedScope?.actions || []).slice(0, 6),
-      areas: (packet.allowedScope?.areas || []).slice(0, 4),
-    },
-    blockedScopeSummary: {
-      filePatternCount: (packet.blockedScope?.files || []).length,
-      dirCount: (packet.blockedScope?.dirs || []).length,
-      actionCount: (packet.blockedScope?.actions || []).length,
-      topBlocked: (packet.blockedScope?.files || []).slice(0, 5),
-    },
-    makeSaferSuggestion,
-    cancelInstruction: "To cancel: discard the execution packet and do not proceed with the task.",
-    safeNextAction: packet.safeNextAction || null,
-    packetId: packet.packetId || null,
-    packetPath: LATEST_PACKET_REL_FROM_PANEL,
-    promptAvailable: true,
-    projectFramework: projectProfile?.framework || null,
-    projectPackageManager: projectProfile?.packageManager || null,
-  };
-}
-
-const LATEST_PACKET_REL_FROM_PANEL = ".claude/cco/orchestration/execution-packet/latest-packet.json";
-
-// ── HTML preview (static local artifact) ─────────────────────────────────────
-
-function buildPreviewHtml(panel) {
-  const riskColor = {
-    low: "#2d8c4e",
-    medium: "#b58900",
-    high: "#dc3545",
-    critical: "#7b0000",
-    unknown: "#6c757d",
-  }[panel.riskLevel || "unknown"] || "#6c757d";
-
-  const proofList = (panel.proofRequired || []).length > 0
-    ? panel.proofRequired.map((s) => `<li>${escHtml(s)}</li>`).join("\n")
-    : "<li>Manual review</li>";
-
-  const topBlocked = (panel.blockedScopeSummary?.topBlocked || []).map((f) => `<code>${escHtml(f)}</code>`).join(", ");
-
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Avorelo Work Panel</title>
-<style>
-  body { font-family: system-ui, sans-serif; max-width: 680px; margin: 2rem auto; padding: 1rem; color: #222; background: #fafafa; }
-  h1 { font-size: 1.1rem; font-weight: 700; margin-bottom: 0.5rem; }
-  .badge { display: inline-block; padding: 0.2em 0.7em; border-radius: 4px; font-size: 0.85rem; font-weight: 600; color: #fff; background: ${riskColor}; }
-  .section { margin: 1rem 0; padding: 0.75rem 1rem; background: #fff; border: 1px solid #e0e0e0; border-radius: 6px; }
-  .section h2 { font-size: 0.9rem; font-weight: 600; margin: 0 0 0.4rem; color: #555; text-transform: uppercase; letter-spacing: 0.03em; }
-  .goal { font-size: 1rem; font-weight: 500; }
-  .meta { font-size: 0.85rem; color: #444; }
-  .warning { background: #fff3cd; border-color: #ffc107; }
-  .warning h2 { color: #856404; }
-  code { background: #f0f0f0; border-radius: 3px; padding: 0.1em 0.3em; font-size: 0.85em; }
-  ul { margin: 0.3rem 0; padding-left: 1.2rem; }
-  .footer { font-size: 0.75rem; color: #888; margin-top: 1.5rem; border-top: 1px solid #eee; padding-top: 0.75rem; }
-  .copy-hint { font-size: 0.8rem; color: #555; font-style: italic; }
-</style>
-</head>
-<body>
-<h1>Avorelo Work Panel <span class="badge">${escHtml(panel.riskLevel || "unknown")} risk</span></h1>
-
-<div class="section">
-  <h2>Goal</h2>
-  <div class="goal">${escHtml(panel.goal || "No goal set.")}</div>
-  <div class="meta">Mode: <strong>${escHtml(panel.mode || "—")}</strong> &nbsp;|&nbsp; Worker: claude_code</div>
-</div>
-
-${panel.approvalRequired ? `<div class="section warning">
-  <h2>⚠ Approval Required</h2>
-  <p>This packet requires human approval before executing. Do not proceed without explicit sign-off.</p>
-</div>` : ""}
-
-<div class="section">
-  <h2>Allowed Scope</h2>
-  <div class="meta">Actions: ${escHtml((panel.allowedScopeSummary?.actions || []).join(", ") || "file_read, file_write_with_diff")}</div>
-  ${panel.allowedScopeSummary?.areas?.length > 0 ? `<div class="meta">Areas: ${escHtml(panel.allowedScopeSummary.areas.join(", "))}</div>` : ""}
-</div>
-
-<div class="section">
-  <h2>Blocked Scope</h2>
-  <div class="meta">
-    ${(panel.blockedScopeSummary?.filePatternCount || 0)} file patterns blocked &nbsp;|&nbsp;
-    ${(panel.blockedScopeSummary?.dirCount || 0)} sensitive dirs &nbsp;|&nbsp;
-    ${(panel.blockedScopeSummary?.actionCount || 0)} actions blocked
-  </div>
-  ${topBlocked ? `<div class="meta">Top blocked: ${topBlocked}</div>` : ""}
-  <div class="meta"><em>Secrets, auth, billing, deploy are always blocked.</em></div>
-</div>
-
-<div class="section">
-  <h2>Proof Required</h2>
-  <ul>${proofList}</ul>
-  ${panel.diffRequired ? `<div class="meta">Diff required before any write.</div>` : ""}
-</div>
-
-${panel.makeSaferSuggestion ? `<div class="section">
-  <h2>Make Safer</h2>
-  <div class="meta">${escHtml(panel.makeSaferSuggestion)}</div>
-</div>` : ""}
-
-<div class="section">
-  <h2>Next Action</h2>
-  <div class="meta">${escHtml(panel.safeNextAction || "Review the packet before proceeding.")}</div>
-</div>
-
-<div class="section">
-  <h2>Copy</h2>
-  <div class="copy-hint">Execution packet: <code>${escHtml(panel.packetPath || "")}</code></div>
-  <div class="copy-hint">Agent prompt: run <code>avorelo execution-packet --debug</code> to view compiled prompt.</div>
-</div>
-
-<div class="footer">
-  Local-only preview. No network. No browser injection. No auto-apply.
-  Packet: ${escHtml(panel.packetId || "—")} &nbsp;|&nbsp; Generated: ${escHtml(nowIso())}
-</div>
-</body>
-</html>`;
-}
-
-function escHtml(str) {
-  return String(str || "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-
-function nowIso() {
-  return new Date().toISOString();
-}
-
-// ── Build and write ───────────────────────────────────────────────────────────
-
-function buildWorkPanelPreview(cwd, options = {}) {
-  const packet = safeReadJson(path.join(cwd, ".claude", "cco", "orchestration", "execution-packet", "latest-packet.json"));
-  const projectProfile = safeReadJson(path.join(cwd, ".claude", "cco", "orchestration", "project-profile", "latest-profile.json"));
-
-  const panel = buildPanelContent(packet, projectProfile);
-
-  const preview = {
-    contract: CONTRACT,
-    schemaVersion: SCHEMA_VERSION,
-    createdAt: nowIso(),
-    customerVisible: false,
-    debugAvailable: true,
-    localOnly: true,
-    panel,
-    artifacts: {
-      jsonPath: LATEST_PREVIEW_JSON_REL,
-      htmlPath: LATEST_PREVIEW_HTML_REL,
-    },
-    caveats: [
-      "Local-only preview. No network calls.",
-      "No browser injection or auto-apply.",
-      "Not a CSS editor or Visual QA full implementation.",
-      "Execution packet must be compiled first.",
-    ],
-    redacted: true,
-  };
-
-  return preview;
-}
-
-function writeWorkPanelPreview(cwd, preview) {
-  ensureCcoDirs(cwd);
-  const dir = path.join(cwd, ".claude", "cco", "orchestration", "work-panel");
-  fs.mkdirSync(dir, { recursive: true });
-
-  // Write JSON preview
-  const jsonPath = path.join(cwd, LATEST_PREVIEW_JSON_REL);
-  fs.writeFileSync(jsonPath, JSON.stringify(preview, null, 2), "utf8");
-
-  // Write HTML preview
-  const htmlContent = buildPreviewHtml(preview.panel || {});
-  const htmlPath = path.join(cwd, LATEST_PREVIEW_HTML_REL);
-  fs.writeFileSync(htmlPath, htmlContent, "utf8");
-
-  try {
-    appendProductLearningEvent(cwd, {
-      eventName: "work_panel_preview_generated",
-      category: "work_panel",
-      surface: "local",
-      status: "observed",
-      payload: {
-        panelStatus: preview.panel?.status || "unknown",
-        riskLevel: preview.panel?.riskLevel || "unknown",
-        approvalRequired: preview.panel?.approvalRequired || false,
-        proofStepCount: (preview.panel?.proofRequired || []).length,
-        htmlGenerated: true,
-        localOnly: true,
-      },
-    });
-  } catch {
-    // non-blocking
-  }
-
-  return {
-    jsonPath: LATEST_PREVIEW_JSON_REL,
-    htmlPath: LATEST_PREVIEW_HTML_REL,
-  };
-}
-
-function buildWorkPanelSurface(cwd, options = {}) {
-  const absPath = path.join(cwd, LATEST_PREVIEW_JSON_REL);
-  const preview = safeReadJson(absPath);
-  if (!preview) {
-    return {
-      status: "not_run",
-      latestPreviewPath: null,
-      customerVisible: false,
-      debugAvailable: false,
-      nextAction: "Run `avorelo work-panel <task>` to generate a work panel preview.",
-    };
-  }
-  return {
-    status: preview.panel?.status || "ready",
-    latestPreviewPath: LATEST_PREVIEW_JSON_REL,
-    latestHtmlPath: LATEST_PREVIEW_HTML_REL,
-    customerVisible: false,
-    debugAvailable: true,
-    riskLevel: preview.panel?.riskLevel || null,
-    approvalRequired: preview.panel?.approvalRequired || false,
-    nextAction: null,
-  };
-}
-
-function formatWorkPanelText(preview, options = {}) {
-  const panel = preview?.panel || {};
-  const debug = options.debug || false;
-
-  const lines = [
-    "Avorelo Work Panel Preview",
-    "",
-    panel.status === "no_packet"
-      ? panel.message
-      : [
-          `Goal:    ${panel.goal || "—"}`,
-          `Mode:    ${panel.mode || "—"}`,
-          `Risk:    ${panel.riskLevel || "—"}`,
-          panel.approvalRequired ? "⚠ APPROVAL REQUIRED" : null,
-          "",
-          `Allowed: ${(panel.allowedScopeSummary?.actions || []).join(", ")}`,
-          `Blocked: ${panel.blockedScopeSummary?.filePatternCount || 0} file patterns · ${panel.blockedScopeSummary?.actionCount || 0} actions`,
-          "",
-          `Proof required: ${(panel.proofRequired || []).join(", ") || "manual review"}`,
-          panel.diffRequired ? "Diff before write: yes" : null,
-          "",
-          panel.makeSaferSuggestion ? `Make safer: ${panel.makeSaferSuggestion}` : null,
-          `Next: ${panel.safeNextAction || "Review the packet."}`,
-        ].filter((l) => l !== null).join("\n"),
-    "",
-    `JSON: ${LATEST_PREVIEW_JSON_REL}`,
-    `HTML: ${LATEST_PREVIEW_HTML_REL}`,
-  ].filter((l) => l !== null);
-
-  if (debug && panel.status !== "no_packet") {
-    lines.push(
-      "",
-      "--- Debug ---",
-      `Packet ID: ${panel.packetId || "—"}`,
-      `Blocked top files: ${(panel.blockedScopeSummary?.topBlocked || []).join(", ")}`,
-      `Allowed areas: ${(panel.allowedScopeSummary?.areas || []).join(", ")}`,
-      `Cancel: ${panel.cancelInstruction || "—"}`,
-    );
-  }
-
-  return lines.join("\n") + "\n";
-}
-
-module.exports = {
-  CONTRACT,
-  SCHEMA_VERSION,
-  LATEST_PREVIEW_JSON_REL,
-  LATEST_PREVIEW_HTML_REL,
-  buildWorkPanelPreview,
-  writeWorkPanelPreview,
-  buildWorkPanelSurface,
-  formatWorkPanelText,
-};

package/scripts/lib/workflow-discipline.js

@@ -1,280 +0,0 @@
-"use strict";
-
-// Workflow discipline: deterministic recommendation engine for AI-coding workflows.
-// Input signals → infer work mode → return ordered recommendations with reason codes.
-
-const WORKFLOW_IDS = {
-  PLAN_FIRST: "WF_PLAN_FIRST",
-  PLAN_REFACTOR: "WF_PLAN_REFACTOR",
-  DIAGNOSE_FIRST: "WF_DIAGNOSE_FIRST",
-  RISK_REVIEW: "WF_RISK_REVIEW",
-  HANDOFF_COMPRESS: "WF_HANDOFF_COMPRESS",
-  PROOF_BUNDLE: "WF_PROOF_BUNDLE",
-  REFRAME_AGENT: "WF_REFRAME_AGENT",
-};
-
-const WORKFLOW_CATALOG = {
-  [WORKFLOW_IDS.PLAN_FIRST]: {
-    id: WORKFLOW_IDS.PLAN_FIRST,
-    label: "Plan before coding",
-    description: "Break the work into scoped slices with acceptance criteria before starting implementation.",
-    nextAction: "Define scope, success criteria, and a slice plan before writing code.",
-    severity: "warn",
-  },
-  [WORKFLOW_IDS.PLAN_REFACTOR]: {
-    id: WORKFLOW_IDS.PLAN_REFACTOR,
-    label: "Plan the refactor boundary",
-    description: "Define what changes and what stays the same before touching existing code.",
-    nextAction: "Define change boundaries, protect behavior with tests, then refactor incrementally with a diff review.",
-    severity: "warn",
-  },
-  [WORKFLOW_IDS.DIAGNOSE_FIRST]: {
-    id: WORKFLOW_IDS.DIAGNOSE_FIRST,
-    label: "Diagnose before patching",
-    description: "Identify the root cause using logs, tests, or runtime evidence before applying a fix.",
-    nextAction: "Reproduce the failure, identify root cause, then patch minimally.",
-    severity: "warn",
-  },
-  [WORKFLOW_IDS.RISK_REVIEW]: {
-    id: WORKFLOW_IDS.RISK_REVIEW,
-    label: "Review risk before acting",
-    description: "Limit tool/action scope and confirm risk posture before proceeding with risky changes.",
-    nextAction: "Check what could go wrong, limit blast radius, require confirmation where appropriate.",
-    severity: "warn",
-  },
-  [WORKFLOW_IDS.HANDOFF_COMPRESS]: {
-    id: WORKFLOW_IDS.HANDOFF_COMPRESS,
-    label: "Compress and hand off",
-    description: "Summarize session state, store reentry memory, and reduce context before continuing.",
-    nextAction: "Save a session summary to reentry memory before the context window fills.",
-    severity: "info",
-  },
-  [WORKFLOW_IDS.PROOF_BUNDLE]: {
-    id: WORKFLOW_IDS.PROOF_BUNDLE,
-    label: "Produce proof before shipping",
-    description: "Bundle tests, git diff review, and a clean PR summary before merging.",
-    nextAction: "Run tests, review the diff, and write a clear PR summary with proof of correctness.",
-    severity: "info",
-  },
-  [WORKFLOW_IDS.REFRAME_AGENT]: {
-    id: WORKFLOW_IDS.REFRAME_AGENT,
-    label: "Reframe before re-running",
-    description: "Stop repetitive or unclear agent behavior. Ask for a plan or options before re-executing.",
-    nextAction: "Ask the agent to produce a plan, options, or tradeoffs before running implementation again.",
-    severity: "warn",
-  },
-};
-
-const VALID_TASK_TYPES = ["feature", "bug", "refactor", "pr", "unknown"];
-const VALID_RISK_LEVELS = ["low", "medium", "high"];
-const VALID_REPO_STATES = ["clean", "modified", "unknown"];
-const VALID_CONTEXT_PRESSURES = ["ok", "warn", "critical"];
-const VALID_REENTRY_STATES = ["available", "missing"];
-const VALID_VALIDATION_STATES = ["missing", "partial", "passed"];
-const VALID_AGENT_SECURITY_STATES = ["off", "visibility", "warn", "approve", "enforce"];
-
-const DEFAULT_INPUT = {
-  taskType: "unknown",
-  riskLevel: "low",
-  repoState: "unknown",
-  contextPressure: "ok",
-  reentryState: "missing",
-  validationState: "missing",
-  agentSecurityState: "off",
-  ambiguous: false,
-  repetitiveAgent: false,
-};
-
-const VALID_MODES = ["off", "suggest", "warn"];
-
-const DEFAULT_WORKFLOW_DISCIPLINE_CONFIG = {
-  enabled: true,
-  mode: "suggest",
-  maxRecommendations: 3,
-};
-
-function normalizeWorkflowDisciplineConfig(raw) {
-  const cfg = { ...DEFAULT_WORKFLOW_DISCIPLINE_CONFIG, ...(raw || {}) };
-  cfg.enabled = cfg.enabled !== false;
-  if (!VALID_MODES.includes(cfg.mode)) cfg.mode = DEFAULT_WORKFLOW_DISCIPLINE_CONFIG.mode;
-  cfg.maxRecommendations = Number.isFinite(Number(cfg.maxRecommendations))
-    ? Math.max(1, Math.min(10, Number(cfg.maxRecommendations)))
-    : DEFAULT_WORKFLOW_DISCIPLINE_CONFIG.maxRecommendations;
-  return cfg;
-}
-
-function normalizeInput(raw) {
-  const input = { ...DEFAULT_INPUT, ...(raw || {}) };
-  if (!VALID_TASK_TYPES.includes(input.taskType)) input.taskType = "unknown";
-  if (!VALID_RISK_LEVELS.includes(input.riskLevel)) input.riskLevel = "low";
-  if (!VALID_REPO_STATES.includes(input.repoState)) input.repoState = "unknown";
-  if (!VALID_CONTEXT_PRESSURES.includes(input.contextPressure)) input.contextPressure = "ok";
-  if (!VALID_REENTRY_STATES.includes(input.reentryState)) input.reentryState = "missing";
-  if (!VALID_VALIDATION_STATES.includes(input.validationState)) input.validationState = "missing";
-  if (!VALID_AGENT_SECURITY_STATES.includes(input.agentSecurityState)) input.agentSecurityState = "off";
-  input.ambiguous = input.ambiguous === true;
-  input.repetitiveAgent = input.repetitiveAgent === true;
-  return input;
-}
-
-// Returns a stable label for the dominant work mode. Used in status surfacing.
-function inferWorkflowMode(rawInput) {
-  const input = normalizeInput(rawInput);
-  const { taskType, riskLevel, contextPressure, repetitiveAgent } = input;
-
-  if (repetitiveAgent) return "reframe";
-  if (contextPressure === "critical") return "handoff";
-  if (taskType === "pr") return "finalize";
-  if (taskType === "bug") return "diagnose";
-  if (riskLevel === "high") return "risk-review";
-  if (taskType === "feature" || input.ambiguous) return "plan";
-  if (contextPressure === "warn") return "handoff";
-  if (taskType === "refactor") return "plan";
-  return "steady";
-}
-
-// Returns an ordered list of workflow recommendation objects with reason codes.
-function recommendWorkflows(rawInput, rawConfig) {
-  const input = normalizeInput(rawInput);
-  const cfg = normalizeWorkflowDisciplineConfig(rawConfig);
-
-  if (!cfg.enabled || cfg.mode === "off") {
-    return [];
-  }
-
-  const candidates = [];
-
-  // Repetitive/unclear agent → reframe first
-  if (input.repetitiveAgent) {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.REFRAME_AGENT],
-      reasonCodes: ["REPETITIVE_AGENT"],
-    });
-  }
-
-  // Context pressure → handoff/compress
-  if (input.contextPressure === "critical" || input.contextPressure === "warn") {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.HANDOFF_COMPRESS],
-      reasonCodes: [`CONTEXT_PRESSURE_${input.contextPressure.toUpperCase()}`, input.reentryState === "missing" ? "REENTRY_MISSING" : null].filter(Boolean),
-    });
-  }
-
-  // Bug/failure → diagnose first
-  if (input.taskType === "bug") {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.DIAGNOSE_FIRST],
-      reasonCodes: ["TASK_TYPE_BUG", input.validationState === "missing" ? "VALIDATION_MISSING" : null].filter(Boolean),
-    });
-  }
-
-  // High risk → risk review
-  if (input.riskLevel === "high") {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.RISK_REVIEW],
-      reasonCodes: ["RISK_LEVEL_HIGH", input.repoState === "modified" ? "REPO_MODIFIED" : null].filter(Boolean),
-    });
-  }
-
-  // Medium risk with modified repo → risk review (lower priority)
-  if (input.riskLevel === "medium" && input.repoState === "modified" && !candidates.find((c) => c.id === WORKFLOW_IDS.RISK_REVIEW)) {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.RISK_REVIEW],
-      reasonCodes: ["RISK_LEVEL_MEDIUM", "REPO_MODIFIED"],
-    });
-  }
-
-  // Feature or ambiguous → plan first
-  if (input.taskType === "feature" || (input.taskType === "unknown" && input.ambiguous)) {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.PLAN_FIRST],
-      reasonCodes: [`TASK_TYPE_${input.taskType.toUpperCase()}`, input.ambiguous ? "AMBIGUOUS_REQUEST" : null].filter(Boolean),
-    });
-  }
-
-  // Refactor → plan the refactor boundary (distinct from feature planning)
-  if (input.taskType === "refactor") {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.PLAN_REFACTOR],
-      reasonCodes: ["TASK_TYPE_REFACTOR"],
-    });
-  }
-
-  // PR/finalization stage → proof bundle
-  if (input.taskType === "pr") {
-    candidates.push({
-      ...WORKFLOW_CATALOG[WORKFLOW_IDS.PROOF_BUNDLE],
-      reasonCodes: ["TASK_TYPE_PR", input.validationState !== "passed" ? "VALIDATION_NOT_PASSED" : null].filter(Boolean),
-    });
-  }
-
-  // Deduplicate by id (keep first occurrence)
-  const seen = new Set();
-  const deduped = [];
-  for (const c of candidates) {
-    if (!seen.has(c.id)) {
-      seen.add(c.id);
-      deduped.push(c);
-    }
-  }
-
-  return deduped.slice(0, cfg.maxRecommendations);
-}
-
-function buildWorkflowDisciplineStatus(rawInput, rawConfig) {
-  const cfg = normalizeWorkflowDisciplineConfig(rawConfig);
-  const mode = inferWorkflowMode(rawInput);
-  const recommendations = recommendWorkflows(rawInput, rawConfig);
-  const top = recommendations[0] || null;
-
-  return {
-    enabled: cfg.enabled,
-    mode: cfg.mode,
-    currentWorkflow: mode,
-    topRecommendation: top
-      ? {
-          id: top.id,
-          label: top.label,
-          nextAction: top.nextAction,
-          reasonCodes: top.reasonCodes,
-          severity: top.severity,
-        }
-      : null,
-    recommendations: recommendations.map((r) => ({
-      id: r.id,
-      label: r.label,
-      reasonCodes: r.reasonCodes,
-      nextAction: r.nextAction,
-      severity: r.severity,
-    })),
-  };
-}
-
-function formatWorkflowDisciplineText(status) {
-  if (!status || !status.enabled || status.mode === "off") {
-    return null;
-  }
-  const top = status.topRecommendation;
-  if (!top) {
-    return `Workflow discipline: ${status.mode} (no active recommendation)`;
-  }
-  const why = top.reasonCodes && top.reasonCodes.length
-    ? top.reasonCodes.join(", ")
-    : "workflow signal detected";
-  return [
-    `Workflow discipline: ${status.mode}`,
-    `  Recommended next step: ${top.nextAction}`,
-    `  Why: ${why}`,
-  ].join("\n");
-}
-
-module.exports = {
-  normalizeWorkflowDisciplineConfig,
-  inferWorkflowMode,
-  recommendWorkflows,
-  buildWorkflowDisciplineStatus,
-  formatWorkflowDisciplineText,
-  DEFAULT_WORKFLOW_DISCIPLINE_CONFIG,
-  WORKFLOW_IDS,
-  WORKFLOW_CATALOG,
-};