@aipper/aiws 0.0.28 → 0.0.30

package/src/dashboard/app.js

@@ -1,371 +0,0 @@
-async function fetchJson(url) {
-  const res = await fetch(url, { headers: { "Accept": "application/json" } });
-  const text = await res.text();
-  let data = null;
-  try {
-    data = JSON.parse(text);
-  } catch {
-    data = { ok: false, error: "invalid json", raw: text };
-  }
-  if (!res.ok) {
-    return { ok: false, status: res.status, ...data };
-  }
-  return data;
-}
-
-function escapeHtml(s) {
-  return String(s || "")
-    .replaceAll("&", "&")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;")
-    .replaceAll("\"", "&quot;")
-    .replaceAll("'", "&#39;");
-}
-
-function blockersBadge(n) {
-  const cls = n === 0 ? "good" : n <= 2 ? "warn" : "bad";
-  return `<span class="badge"><span class="dot ${cls}"></span>${n === 0 ? "none" : `${n} blockers`}</span>`;
-}
-
-function driftBadge(n) {
-  const cls = n === 0 ? "good" : "warn";
-  return `<span class="badge"><span class="dot ${cls}"></span>${n === 0 ? "clean" : `${n} drift`}</span>`;
-}
-
-function tasksBadge(done, total, unchecked) {
-  const cls = unchecked === 0 && total > 0 ? "good" : unchecked === 0 ? "warn" : "warn";
-  const label = total > 0 ? `${done}/${total} (unchecked=${unchecked})` : "no tasks";
-  return `<span class="badge"><span class="dot ${cls}"></span>${label}</span>`;
-}
-
-function summarizeNextAdvice(advice) {
-  const a = advice && typeof advice === "object" ? advice : {};
-  const actions = Array.isArray(a.actions) ? a.actions : [];
-  const recommended = Array.isArray(a.recommended) ? a.recommended : [];
-  const prohibitions = Array.isArray(a.prohibitions) ? a.prohibitions : [];
-  return actions[0] || recommended[0] || prohibitions[0] || "";
-}
-
-function renderDetails(obj) {
-  return JSON.stringify(obj, null, 2);
-}
-
-function renderValidateGroups(groups) {
-  const order = [
-    ["truth_drift", "Truth drift"],
-    ["missing_files", "Missing files"],
-    ["placeholders", "Placeholders / WS:TODO"],
-    ["bindings", "Bindings"],
-    ["scope_gate", "Scope gate"],
-    ["finish_gate", "Finish gate"],
-    ["plan_quality", "Plan quality"],
-    ["other", "Other"],
-  ];
-  const g = groups && typeof groups === "object" ? groups : {};
-  const lines = [];
-  for (const [key, label] of order) {
-    const it = g[key] || { errors: [], warnings: [] };
-    const errs = Array.isArray(it.errors) ? it.errors : [];
-    const warns = Array.isArray(it.warnings) ? it.warnings : [];
-    if (errs.length === 0 && warns.length === 0) continue;
-    lines.push(`${label}:`);
-    for (const e of errs) lines.push(`  - error: ${e}`);
-    for (const w of warns) lines.push(`  - warn: ${w}`);
-    lines.push("");
-  }
-  return lines.join("\n").trim();
-}
-
-async function runStrictValidate(changeId) {
-  return fetchJson(`/api/change/${encodeURIComponent(changeId)}/validate?strict=1`);
-}
-
-function normalizeStageId(value) {
-  return String(value || "").trim();
-}
-
-function stageLabel(stageId) {
-  return normalizeStageId(stageId) || "(unknown)";
-}
-
-function renderContractField(label, value) {
-  return `<div class="contract-field">
-    <div class="contract-field-label">${escapeHtml(label)}</div>
-    <div>${escapeHtml(value || "(none)")}</div>
-  </div>`;
-}
-
-function renderContractCard(title, contract) {
-  if (!contract) return "";
-  return `<div class="contract-card">
-    <div class="contract-title">${escapeHtml(title)}</div>
-    <div class="contract-stage"><code>${escapeHtml(contract.stage || "")}</code></div>
-    ${renderContractField("目标", contract.goal)}
-    ${renderContractField("必需输入", contract.requiredInputs)}
-    ${renderContractField("必需输出", contract.requiredOutputs)}
-    ${renderContractField("阻断条件", contract.blockers)}
-    ${renderContractField("下一步", contract.next)}
-  </div>`;
-}
-
-function normalizeGateStatus(value) {
-  return String(value || "missing").trim() || "missing";
-}
-
-function reviewGateText(reviewGates) {
-  const gates = reviewGates && typeof reviewGates === "object" ? reviewGates : {};
-  const spec = normalizeGateStatus(gates?.specReview?.status);
-  const quality = normalizeGateStatus(gates?.qualityReview?.status);
-  const validate = normalizeGateStatus(gates?.validateStamp?.status);
-  const preComplete = normalizeGateStatus(gates?.verifyBeforeComplete?.status);
-  return `review-gates: spec=${spec}, quality=${quality}, validate=${validate}, pre-complete=${preComplete}`;
-}
-
-function renderReviewGateBadges(reviewGates) {
-  const gates = reviewGates && typeof reviewGates === "object" ? reviewGates : {};
-  const items = [
-    ["spec", gates?.specReview],
-    ["quality", gates?.qualityReview],
-    ["validate", gates?.validateStamp],
-    ["pre-complete", gates?.verifyBeforeComplete],
-  ];
-  return `<div class="governance-head">${items
-    .map(([label, gate]) => {
-      const ready = gate?.ready === true;
-      const status = normalizeGateStatus(gate?.status);
-      const cls = ready ? "good" : "warn";
-      return `<span class="badge"><span class="dot ${cls}"></span>${escapeHtml(`${label}=${status}`)}</span>`;
-    })
-    .join("")}</div>`;
-}
-
-function scopeGateText(scopeGate) {
-  const gate = scopeGate && typeof scopeGate === "object" ? scopeGate : {};
-  const status = String(gate.status || "not_run").trim() || "not_run";
-  const details = [];
-  if (typeof gate.errors === "number") details.push(`errors=${gate.errors}`);
-  if (typeof gate.warnings === "number") details.push(`warnings=${gate.warnings}`);
-  if (gate.lastRunAt) details.push(`at=${gate.lastRunAt}`);
-  return `scope-gate: ${status}${details.length > 0 ? ` (${details.join(", ")})` : ""}`;
-}
-
-function renderScopeGateBadge(scopeGate) {
-  const gate = scopeGate && typeof scopeGate === "object" ? scopeGate : {};
-  const status = String(gate.status || "not_run").trim() || "not_run";
-  const ready = gate.ready === true;
-  const cls = ready ? "good" : status === "failed" ? "bad" : "warn";
-  return `<span class="badge"><span class="dot ${cls}"></span>${escapeHtml(`scope=${status}`)}</span>`;
-}
-
-function renderGovernanceSummary(selected, stageData) {
-  const governance = selected?.governance && typeof selected.governance === "object" ? selected.governance : {};
-  const currentStage = normalizeStageId(governance.currentStage);
-  const recommendedStage = normalizeStageId(governance.recommendedStage);
-  const phase = normalizeStageId(governance.phase || selected?.phase);
-  const contracts = Array.isArray(stageData?.stages) ? stageData.stages : [];
-  const byStage = new Map(contracts.map((contract) => [normalizeStageId(contract.stage), contract]));
-  const currentContract = byStage.get(currentStage) || null;
-  const recommendedContract = byStage.get(recommendedStage) || null;
-
-  const rail = contracts.length > 0
-    ? `<div class="governance-rail">${contracts
-        .map((contract, index) => {
-          const stage = normalizeStageId(contract.stage);
-          const cls = [
-            "stage-chip",
-            stage === currentStage ? "active" : "",
-            stage === recommendedStage && stage !== currentStage ? "recommended" : "",
-          ]
-            .filter(Boolean)
-            .join(" ");
-          const arrow = index < contracts.length - 1 ? `<span class="rail-arrow">&rarr;</span>` : "";
-          return `<span class="${cls}"><code>${escapeHtml(stageLabel(stage))}</code></span>${arrow}`;
-        })
-        .join("")}</div>`
-    : `<div class="muted">(workflow-stage-contracts unavailable)</div>`;
-
-  const cards = [];
-  if (currentContract) cards.push(renderContractCard(`Current Contract (${phase || "unknown"})`, currentContract));
-  if (recommendedContract && recommendedStage && recommendedStage !== currentStage) {
-    cards.push(renderContractCard("Next Contract", recommendedContract));
-  }
-
-  return `<div class="governance-head">
-      <span class="badge"><span class="dot good"></span>phase=${escapeHtml(phase || "(unknown)")}</span>
-      <span class="badge"><span class="dot warn"></span>current=${escapeHtml(stageLabel(currentStage))}</span>
-      <span class="badge"><span class="dot good"></span>next=${escapeHtml(stageLabel(recommendedStage || currentStage))}</span>
-    </div>
-    ${governance.rationale ? `<div class="muted">${escapeHtml(governance.rationale)}</div>` : ""}
-    ${governance.warning ? `<div class="muted">warning: ${escapeHtml(governance.warning)}</div>` : ""}
-    ${selected?.reviewGates ? renderReviewGateBadges(selected.reviewGates) : ""}
-    ${selected?.scopeGate ? `<div class="governance-head">${renderScopeGateBadge(selected.scopeGate)}</div>` : ""}
-    ${rail}
-    <div class="governance-grid">
-      ${cards.join("") || `<div class="muted">No contract summary available.</div>`}
-    </div>`;
-}
-
-async function refresh() {
-  const summaryEl = document.getElementById("summary");
-  const bodyEl = document.getElementById("changes-body");
-  const detailsTitleEl = document.getElementById("details-title");
-  const detailsEl = document.getElementById("details");
-  const governanceEl = document.getElementById("governance-summary");
-
-  summaryEl.textContent = "Loading…";
-  bodyEl.innerHTML = "";
-  if (governanceEl) governanceEl.innerHTML = `<div class="muted">Loading workflow governance…</div>`;
-
-  const [data, stageData] = await Promise.all([fetchJson("/api/changes"), fetchJson("/api/workflow-stages")]);
-  if (!data || data.ok === false) {
-    summaryEl.textContent = "Failed";
-    detailsTitleEl.textContent = "Error";
-    detailsEl.textContent = renderDetails(data);
-    if (governanceEl) governanceEl.innerHTML = `<div class="muted">Failed to load governance summary.</div>`;
-    return;
-  }
-
-  const items = Array.isArray(data.changes) ? data.changes : [];
-  summaryEl.textContent = `${items.length} change(s)`;
-
-  bodyEl.innerHTML = items
-    .map((c) => {
-      const changeId = c.changeId || c.id || "";
-      const tasks = c.tasks || {};
-      const drift = Array.isArray(c.driftFiles) ? c.driftFiles.length : 0;
-      const blockers = Array.isArray(c.blockersStrict) ? c.blockersStrict.length : 0;
-      const bindings = c.bindings || {};
-      const planFile = bindings.planFile || "";
-      const evidencePaths = Array.isArray(bindings.evidencePaths) ? bindings.evidencePaths : [];
-      const collaboration = c.collaboration && typeof c.collaboration === "object" ? c.collaboration : {};
-      const nextHint = summarizeNextAdvice(c.nextAdvice);
-      const governance = c.governance && typeof c.governance === "object" ? c.governance : {};
-      const reviewGateLine = reviewGateText(c.reviewGates);
-      const scopeGateLine = scopeGateText(c.scopeGate);
-      const collabLabel = `analysis=${collaboration.analysis || 0}, patches=${collaboration.patches || 0}, review=${collaboration.review || 0}`;
-      const stageLine = `phase=${governance.phase || c.phase || "unknown"}, current=${governance.currentStage || "unknown"}, next=${governance.recommendedStage || governance.currentStage || "unknown"}`;
-      const rationaleLine = governance.rationale ? `<div class="muted">${escapeHtml(governance.rationale)}</div>` : "";
-      const warningLine = governance.warning ? `<div class="muted">warning: ${escapeHtml(governance.warning)}</div>` : "";
-      const pe = `${planFile ? `<div><code>${escapeHtml(planFile)}</code></div>` : `<div class="muted">(no Plan_File)</div>`}
-        <div class="muted">${evidencePaths.length} evidence path(s)</div>
-        <div class="muted">${escapeHtml(collabLabel)}</div>
-        <div class="muted">${escapeHtml(stageLine)}</div>
-        <div class="muted">${escapeHtml(reviewGateLine)}</div>
-        <div class="muted">${escapeHtml(scopeGateLine)}</div>
-        ${rationaleLine}
-        ${warningLine}
-        ${nextHint ? `<div class="muted">${escapeHtml(nextHint)}</div>` : ""}`;
-      return `<tr data-change="${escapeHtml(changeId)}">
-        <td><a class="link" href="#" data-open="${escapeHtml(changeId)}">${escapeHtml(changeId)}</a></td>
-        <td>${tasksBadge(tasks.done || 0, tasks.total || 0, tasks.unchecked || 0)}</td>
-        <td>${driftBadge(drift)}</td>
-        <td>${blockersBadge(blockers)}</td>
-        <td>${pe}</td>
-        <td>
-          <button class="btn secondary" data-validate="${escapeHtml(changeId)}">Validate --strict</button>
-        </td>
-      </tr>`;
-    })
-    .join("");
-
-  bodyEl.querySelectorAll("[data-open]").forEach((a) => {
-    a.addEventListener("click", (ev) => {
-      ev.preventDefault();
-      const changeId = a.getAttribute("data-open") || "";
-      const selected = items.find((x) => (x.changeId || x.id) === changeId) || null;
-      detailsTitleEl.textContent = changeId ? `change: ${changeId}` : "Details";
-      if (!selected) {
-        detailsEl.textContent = renderDetails(selected);
-        if (governanceEl) governanceEl.innerHTML = `<div class="muted">No governance summary available.</div>`;
-        return;
-      }
-      if (governanceEl) governanceEl.innerHTML = renderGovernanceSummary(selected, stageData);
-      const b = selected.bindings || {};
-      const governance = selected.governance && typeof selected.governance === "object" ? selected.governance : {};
-      const evid = Array.isArray(b.evidencePaths) ? b.evidencePaths : [];
-      const lines = [];
-      lines.push(`changeId: ${selected.changeId || ""}`);
-      if (selected.reqId) lines.push(`Req_ID: ${selected.reqId}`);
-      if (selected.probId) lines.push(`Problem_ID: ${selected.probId}`);
-      if (b.planFile) lines.push(`Plan_File: ${b.planFile}`);
-      if (b.contractRow) lines.push(`Contract_Row: ${b.contractRow}`);
-      if (evid.length > 0) {
-        lines.push("Evidence_Path:");
-        for (const p of evid) lines.push(`- ${p}`);
-      }
-      if (selected.collaboration && typeof selected.collaboration === "object") {
-        lines.push("Collaboration:");
-        lines.push(`- analysis: ${selected.collaboration.analysis || 0}`);
-        lines.push(`- patches: ${selected.collaboration.patches || 0}`);
-        lines.push(`- review: ${selected.collaboration.review || 0}`);
-        lines.push(`- evidence: ${selected.collaboration.evidence || 0}`);
-      }
-      if (selected.reviewGates && typeof selected.reviewGates === "object") {
-        lines.push("");
-        lines.push("Review gates:");
-        lines.push(`- ${reviewGateText(selected.reviewGates)}`);
-        for (const [label, gate] of [
-          ["ws-spec-review", selected.reviewGates.specReview],
-          ["ws-quality-review", selected.reviewGates.qualityReview],
-          ["validate-stamp", selected.reviewGates.validateStamp],
-          ["ws-verify-before-complete", selected.reviewGates.verifyBeforeComplete],
-        ]) {
-          if (!gate || typeof gate !== "object") continue;
-          const foundPath = gate.foundPath ? ` path=${gate.foundPath}` : "";
-          lines.push(`- ${label}: ready=${gate.ready === true} status=${normalizeGateStatus(gate.status)}${foundPath}`);
-        }
-      }
-      if (selected.scopeGate && typeof selected.scopeGate === "object") {
-        lines.push("");
-        lines.push("Scope gate:");
-        lines.push(`- ${scopeGateText(selected.scopeGate)}`);
-      }
-      if (selected.nextAdvice && typeof selected.nextAdvice === "object") {
-        const actions = Array.isArray(selected.nextAdvice.actions) ? selected.nextAdvice.actions : [];
-        const recommended = Array.isArray(selected.nextAdvice.recommended) ? selected.nextAdvice.recommended : [];
-        const prohibitions = Array.isArray(selected.nextAdvice.prohibitions) ? selected.nextAdvice.prohibitions : [];
-        if (actions.length > 0 || recommended.length > 0 || prohibitions.length > 0) {
-          lines.push("");
-          lines.push("Next:");
-          for (const x of actions) lines.push(`- action: ${x}`);
-          for (const x of recommended) lines.push(`- recommended: ${x}`);
-          for (const x of prohibitions) lines.push(`- do-not: ${x}`);
-        }
-      }
-      if (governance.rationale) {
-        lines.push("");
-        lines.push(`Governance rationale: ${governance.rationale}`);
-      }
-      if (governance.warning) {
-        lines.push(`Governance warning: ${governance.warning}`);
-      }
-      if (Array.isArray(selected.blockersStrict) && selected.blockersStrict.length > 0) {
-        lines.push("");
-        lines.push("Blockers (strict):");
-        for (const x of selected.blockersStrict) lines.push(`- ${x}`);
-      }
-      lines.push("");
-      lines.push("Raw JSON:");
-      lines.push(renderDetails(selected));
-      detailsEl.textContent = lines.join("\n");
-    });
-  });
-
-  bodyEl.querySelectorAll("[data-validate]").forEach((btn) => {
-    btn.addEventListener("click", async () => {
-      const changeId = btn.getAttribute("data-validate") || "";
-      if (!changeId) return;
-      btn.disabled = true;
-      btn.textContent = "Running…";
-      detailsTitleEl.textContent = `validate --strict: ${changeId}`;
-      const res = await runStrictValidate(changeId);
-      const grouped = renderValidateGroups(res && res.groups ? res.groups : null);
-      detailsEl.textContent = grouped ? `${grouped}\n\nRaw JSON:\n${renderDetails(res)}` : renderDetails(res);
-      btn.disabled = false;
-      btn.textContent = "Validate --strict";
-    });
-  });
-}
-
-document.getElementById("refresh")?.addEventListener("click", refresh);
-refresh();

package/src/errors.js

@@ -1,15 +0,0 @@
-export class UserError extends Error {
-  /**
-   * @param {string} message
-   * @param {{ exitCode?: number, details?: string }=} options
-   */
-  constructor(message, options) {
-    super(message);
-    this.name = "UserError";
-    /** @type {number} */
-    this.exitCode = options?.exitCode ?? 2;
-    /** @type {string | undefined} */
-    this.details = options?.details;
-  }
-}
-

package/src/exec.js

@@ -1,34 +0,0 @@
-import { spawn } from "node:child_process";
-
-/**
- * @param {string} command
- * @param {string[]} args
- * @param {{ cwd?: string }=} options
- * @returns {Promise<{ code: number, stdout: string, stderr: string }>}
- */
-export function runCommand(command, args, options) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, {
-      cwd: options?.cwd,
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    /** @type {Buffer[]} */
-    const out = [];
-    /** @type {Buffer[]} */
-    const err = [];
-
-    child.stdout.on("data", (b) => out.push(Buffer.from(b)));
-    child.stderr.on("data", (b) => err.push(Buffer.from(b)));
-
-    child.on("error", (e) => reject(e));
-    child.on("close", (code) => {
-      resolve({
-        code: typeof code === "number" ? code : 1,
-        stdout: Buffer.concat(out).toString("utf8"),
-        stderr: Buffer.concat(err).toString("utf8"),
-      });
-    });
-  });
-}
-

package/src/fs.js

@@ -1,91 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-/**
- * @param {string} p
- */
-export async function pathExists(p) {
-  try {
-    await fs.access(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * @param {string} p
- */
-export async function ensureDir(p) {
-  await fs.mkdir(p, { recursive: true });
-}
-
-/**
- * @param {string} p
- */
-export async function readText(p) {
-  return await fs.readFile(p, "utf8");
-}
-
-/**
- * @param {string} p
- * @param {string} content
- */
-export async function writeText(p, content) {
-  await ensureDir(path.dirname(p));
-  await fs.writeFile(p, content, "utf8");
-}
-
-/**
- * @param {string} src
- * @param {string} dest
- * @param {{ chmod?: number }=} options
- */
-export async function copyFile(src, dest, options) {
-  await ensureDir(path.dirname(dest));
-  await fs.copyFile(src, dest);
-  if (typeof options?.chmod === "number") {
-    await fs.chmod(dest, options.chmod);
-    return;
-  }
-  try {
-    const st = await fs.stat(src);
-    await fs.chmod(dest, st.mode & 0o777);
-  } catch {
-    // ignore chmod errors (e.g. on certain filesystems)
-  }
-}
-
-/**
- * Very small glob support for patterns ending with `/**`.
- *
- * @param {string} rootDir
- * @param {string} prefixDir
- * @returns {Promise<string[]>} paths relative to rootDir
- */
-export async function listFilesRecursive(rootDir, prefixDir) {
-  /** @type {string[]} */
-  const out = [];
-  const start = path.join(rootDir, prefixDir);
-  if (!(await pathExists(start))) return out;
-
-  /** @type {Array<{ abs: string, rel: string }>} */
-  const stack = [{ abs: start, rel: prefixDir }];
-  while (stack.length > 0) {
-    const cur = stack.pop();
-    if (!cur) break;
-    const entries = await fs.readdir(cur.abs, { withFileTypes: true });
-    for (const ent of entries) {
-      const abs = path.join(cur.abs, ent.name);
-      const rel = path.posix.join(cur.rel.replaceAll(path.sep, "/"), ent.name);
-      if (ent.isDirectory()) {
-        stack.push({ abs, rel });
-      } else if (ent.isFile()) {
-        out.push(rel);
-      }
-    }
-  }
-  out.sort();
-  return out;
-}
-

package/src/governance.js

@@ -1,159 +0,0 @@
-import { UserError } from "./errors.js";
-import { loadWorkflowGovernanceRules } from "./spec.js";
-
-/**
- * @param {any} status
- */
-export function effectiveReviewCount(status) {
-  return Number(status?.reviewSignals?.effectiveCount ?? status?.collaboration?.counts?.review ?? 0);
-}
-
-/**
- * @param {any} status
- * @param {any} [governance]
- */
-function collectGovernanceSignals(status, governance) {
-  const git = status?.git && typeof status.git === "object" ? status.git : {};
-  const lifecycle = status?.lifecycle && typeof status.lifecycle === "object" ? status.lifecycle : {};
-  const repo = status?.repo && typeof status.repo === "object" ? status.repo : {};
-  const gov = governance && typeof governance === "object" ? governance : status?.governance && typeof status.governance === "object" ? status.governance : {};
-  const reviewGates = status?.reviewGates && typeof status.reviewGates === "object" ? status.reviewGates : {};
-  const reviewGateSummary = reviewGates?.summary && typeof reviewGates.summary === "object" ? reviewGates.summary : {};
-  const reviewEffectiveCount = effectiveReviewCount(status);
-  const specReviewReady = reviewGates?.specReview?.ready === true || (!reviewGates.specReview && reviewEffectiveCount > 0);
-  const qualityReviewReady = reviewGates?.qualityReview?.ready === true || (!reviewGates.qualityReview && reviewEffectiveCount > 0);
-  const verifyBeforeCompleteReady = reviewGates?.verifyBeforeComplete?.ready === true;
-  const validateStampReady = reviewGates?.validateStamp?.ready === true;
-
-  return {
-    change_id: String(status?.changeId || ""),
-    blockers_strict_count: Array.isArray(status?.blockersStrict) ? status.blockersStrict.length : 0,
-    finish_resume_required: status?.terminatedReuse?.kind === "finished_unarchived",
-    tasks_unchecked: Number(status?.tasks?.unchecked || 0),
-    review_effective_count: reviewEffectiveCount,
-    evidence_persistent_count: Number(status?.evidence?.counts?.persistent || 0),
-    git_total: Number(git.total || 0),
-    git_staged: Number(git.staged || 0),
-    git_conflicted: Number(git.conflicted || 0),
-    lifecycle_evidence_runs: Number(lifecycle.evidenceRuns || 0),
-    finish_cleanup_pending_reason: String(lifecycle.finishCleanupPendingReason || ""),
-    finish_state: String(lifecycle.finishState || ""),
-    finish_state_reason: String(lifecycle.finishStateReason || ""),
-    repo_submodules: Number(repo.submodules || 0),
-    spec_review_ready: specReviewReady,
-    quality_review_ready: qualityReviewReady,
-    verify_before_complete_ready: verifyBeforeCompleteReady,
-    validate_stamp_ready: validateStampReady,
-    spec_review_status: String(reviewGates?.specReview?.status || (specReviewReady ? "ready" : "missing")),
-    quality_review_status: String(reviewGates?.qualityReview?.status || (qualityReviewReady ? "ready" : "missing")),
-    verify_before_complete_status: String(
-      reviewGates?.verifyBeforeComplete?.status || (verifyBeforeCompleteReady ? "ready" : "missing"),
-    ),
-    validate_stamp_status: String(reviewGates?.validateStamp?.status || (validateStampReady ? "ready" : "missing")),
-    dual_review_missing_count: Number(reviewGateSummary?.dualReviewMissingCount || 0),
-    finish_gate_missing_count: Number(reviewGateSummary?.finishGateMissingCount || 0),
-    governance_current_stage: String(gov.currentStage || ""),
-    governance_recommended_stage: String(gov.recommendedStage || ""),
-    governance_rule_id: String(gov.ruleId || ""),
-  };
-}
-
-/**
- * @param {string} template
- * @param {Record<string, string | number | boolean>} signals
- */
-function renderTemplate(template, signals) {
-  return String(template || "").replace(/\{([a-z0-9_]+)\}/gi, (_, key) => String(signals[key] ?? ""));
-}
-
-/**
- * @param {unknown} actual
- * @param {any} condition
- */
-function matchesLeafCondition(actual, condition) {
-  if (Object.prototype.hasOwnProperty.call(condition, "eq") && actual !== condition.eq) return false;
-  if (Object.prototype.hasOwnProperty.call(condition, "ne") && actual === condition.ne) return false;
-  if (Object.prototype.hasOwnProperty.call(condition, "gt") && !(Number(actual) > Number(condition.gt))) return false;
-  if (Object.prototype.hasOwnProperty.call(condition, "gte") && !(Number(actual) >= Number(condition.gte))) return false;
-  if (Object.prototype.hasOwnProperty.call(condition, "lt") && !(Number(actual) < Number(condition.lt))) return false;
-  if (Object.prototype.hasOwnProperty.call(condition, "lte") && !(Number(actual) <= Number(condition.lte))) return false;
-  if (Array.isArray(condition?.in) && !condition.in.includes(actual)) return false;
-  if (Array.isArray(condition?.notIn) && condition.notIn.includes(actual)) return false;
-  if (condition?.truthy === true && !actual) return false;
-  if (condition?.falsy === true && !!actual) return false;
-  return true;
-}
-
-/**
- * @param {any} when
- * @param {Record<string, string | number | boolean>} signals
- */
-function matchesCondition(when, signals) {
-  if (!when || (typeof when === "object" && Object.keys(when).length === 0)) return true;
-  if (Array.isArray(when?.all)) return when.all.every((item) => matchesCondition(item, signals));
-  if (Array.isArray(when?.any)) return when.any.some((item) => matchesCondition(item, signals));
-  if (when?.not) return !matchesCondition(when.not, signals);
-  if (typeof when?.signal === "string") {
-    return matchesLeafCondition(signals[when.signal], when);
-  }
-  return false;
-}
-
-/**
- * @param {string[]} lines
- */
-function uniqueLines(lines) {
-  const seen = new Set();
-  /** @type {string[]} */
-  const out = [];
-  for (const raw of lines || []) {
-    const line = String(raw || "").trim();
-    if (!line || seen.has(line)) continue;
-    seen.add(line);
-    out.push(line);
-  }
-  return out;
-}
-
-/**
- * @param {any} status
- */
-export async function inferChangeGovernance(status) {
-  const spec = await loadWorkflowGovernanceRules();
-  const signals = collectGovernanceSignals(status);
-  const matched = spec.governanceRules.find((rule) => matchesCondition(rule?.when, signals));
-  if (!matched) {
-    throw new UserError("Failed to infer workflow governance from spec rules.", {
-      details: JSON.stringify({ source: spec.source, signals }, null, 2),
-    });
-  }
-  return {
-    phase: String(status?.phase || ""),
-    currentStage: String(matched.currentStage || ""),
-    recommendedStage: String(matched.recommendedStage || matched.currentStage || ""),
-    rationale: renderTemplate(String(matched.rationale || ""), signals),
-    ruleId: String(matched.id || ""),
-    source: spec.source,
-  };
-}
-
-/**
- * @param {any} status
- */
-export async function governanceGuidanceLines(status) {
-  const spec = await loadWorkflowGovernanceRules();
-  const governance = status?.governance && typeof status.governance === "object" ? status.governance : await inferChangeGovernance(status);
-  const signals = collectGovernanceSignals(status, governance);
-  /** @type {string[]} */
-  const lines = [];
-
-  for (const rule of spec.guidanceRules) {
-    if (!matchesCondition(rule?.when, signals)) continue;
-    const entries = Array.isArray(rule?.lines) ? rule.lines : [];
-    for (const entry of entries) lines.push(renderTemplate(String(entry || ""), signals));
-  }
-
-  const deduped = uniqueLines(lines);
-  if (deduped.length > 0) return deduped;
-  return ["按阶段契约继续推进当前 change"];
-}