@aipper/aiws 0.0.29 → 0.0.30

package/src/codex-prompts.js

@@ -1,74 +0,0 @@
-import os from "node:os";
-import path from "node:path";
-import { listFilesRecursive, readText } from "./fs.js";
-import { normalizeNewlines } from "./hash.js";
-import { extractTemplateBlock } from "./managed-blocks.js";
-import { UserError } from "./errors.js";
-
-/**
- * Resolve Codex global prompts directory:
- * - If `--dir` provided, use it directly.
- * - Else if `CODEX_HOME` is set, use `$CODEX_HOME/prompts`.
- * - Else use `~/.codex/prompts`.
- *
- * @param {string | undefined} dirOption
- */
-export function resolveCodexPromptsDir(dirOption) {
-  if (dirOption) return path.resolve(dirOption);
-  const envHome = String(process.env.CODEX_HOME || "").trim();
-  if (envHome) return path.join(path.resolve(envHome), "prompts");
-  return path.join(os.homedir(), ".codex", "prompts");
-}
-
-function timestamp() {
-  const d = new Date();
-  // 2026-01-28T12:34:56Z -> 20260128-123456Z
-  return d.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z").replace("T", "-");
-}
-
-export function codexBackupStamp() {
-  return timestamp();
-}
-
-/**
- * @param {string} promptsDir
- * @param {string} filename
- * @param {string=} stamp
- */
-export function codexBackupPathFor(promptsDir, filename, stamp) {
-  return path.join(promptsDir, ".aiws", "backups", "codex-prompts", stamp || timestamp(), filename);
-}
-
-/**
- * List Codex prompt files in a template and extract their managed block inner text.
- *
- * @param {{ templateId: string, templateDir: string }} tpl
- * @returns {Promise<Array<{ rel: string, filename: string, name: string, blockId: string, srcAbs: string, templateText: string, innerText: string }>>}
- */
-export async function listTemplateCodexPrompts(tpl) {
-  const relFiles = await listFilesRecursive(tpl.templateDir, ".codex/prompts");
-  const promptFiles = relFiles
-    .filter((rel) => rel.startsWith(".codex/prompts/"))
-    .filter((rel) => rel.split("/").length === 3)
-    .filter((rel) => rel.toLowerCase().endsWith(".md"));
-
-  if (promptFiles.length === 0) {
-    throw new UserError(`Template has no Codex prompt files: ${tpl.templateId}`, {
-      details: `Missing under: ${path.join(tpl.templateDir, ".codex", "prompts")}`,
-      exitCode: 1,
-    });
-  }
-
-  /** @type {Array<{ rel: string, filename: string, name: string, blockId: string, srcAbs: string, templateText: string, innerText: string }>} */
-  const out = [];
-  for (const rel of promptFiles) {
-    const filename = path.posix.basename(rel);
-    const name = filename.replace(/\.md$/i, "");
-    const blockId = `codex:${name}`;
-    const srcAbs = path.join(tpl.templateDir, ...rel.split("/"));
-    const templateText = normalizeNewlines(await readText(srcAbs));
-    const { innerText } = extractTemplateBlock(templateText, blockId);
-    out.push({ rel, filename, name, blockId, srcAbs, templateText, innerText });
-  }
-  return out;
-}

package/src/codex-skills.js

@@ -1,111 +0,0 @@
-import os from "node:os";
-import path from "node:path";
-import { listFilesRecursive, readText } from "./fs.js";
-import { normalizeNewlines } from "./hash.js";
-import { UserError } from "./errors.js";
-
-/**
- * Resolve Codex global skills directory:
- * - If `--dir` provided, use it directly.
- * - Else if `CODEX_HOME` is set, use `$CODEX_HOME/.agents/skills` as a compatibility/test override root.
- * - Else use `~/.agents/skills`.
- *
- * @param {string | undefined} dirOption
- */
-export function resolveCodexSkillsDir(dirOption) {
-  if (dirOption) return path.resolve(dirOption);
-  const envHome = String(process.env.CODEX_HOME || "").trim();
-  if (envHome) return path.join(path.resolve(envHome), ".agents", "skills");
-  return path.join(os.homedir(), ".agents", "skills");
-}
-
-function timestamp() {
-  const d = new Date();
-  // 2026-01-28T12:34:56Z -> 20260128-123456Z
-  return d.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z").replace("T", "-");
-}
-
-export function codexSkillsBackupStamp() {
-  return timestamp();
-}
-
-/**
- * @param {string} skillsDir
- * @param {string} skillName
- * @param {string=} stamp
- */
-export function codexSkillsBackupPathFor(skillsDir, skillName, stamp) {
-  return path.join(skillsDir, ".aiws", "backups", "codex-skills", stamp || timestamp(), skillName, "SKILL.md");
-}
-
-/**
- * @param {string} text normalized
- * @returns {{ frontMatter: string, body: string }}
- */
-function splitYamlFrontMatter(text) {
-  const t = normalizeNewlines(text);
-  const lines = t.split("\n");
-  if ((lines[0] ?? "") !== "---") {
-    throw new UserError("Invalid SKILL.md: missing YAML front matter at top", { exitCode: 1 });
-  }
-  let end = -1;
-  for (let i = 1; i < lines.length; i++) {
-    if ((lines[i] ?? "") === "---") {
-      end = i;
-      break;
-    }
-  }
-  if (end === -1) {
-    throw new UserError("Invalid SKILL.md: YAML front matter not closed", { exitCode: 1 });
-  }
-
-  const frontMatter = `${lines.slice(0, end + 1).join("\n")}\n`;
-  const body = lines.slice(end + 1).join("\n");
-  return { frontMatter, body };
-}
-
-/**
- * List Codex repo skills in a template and prepare a managed-file wrapper for global installation.
- *
- * The wrapper adds an AIWS managed block after YAML front matter so updates can preserve user-added
- * text outside the managed block.
- *
- * @param {{ templateId: string, templateDir: string }} tpl
- * @returns {Promise<Array<{ rel: string, skillName: string, blockId: string, srcAbs: string, templateText: string, managedText: string, innerText: string }>>}
- */
-export async function listTemplateCodexSkills(tpl) {
-  const relFiles = await listFilesRecursive(tpl.templateDir, ".agents/skills");
-  const skillFiles = relFiles
-    .filter((rel) => rel.startsWith(".agents/skills/"))
-    .filter((rel) => rel.split("/").length === 4)
-    .filter((rel) => rel.toLowerCase().endsWith("/skill.md"));
-
-  if (skillFiles.length === 0) {
-    throw new UserError(`Template has no Codex skills: ${tpl.templateId}`, {
-      details: `Missing under: ${path.join(tpl.templateDir, ".agents", "skills")}`,
-      exitCode: 1,
-    });
-  }
-
-  /** @type {Array<{ rel: string, skillName: string, blockId: string, srcAbs: string, templateText: string, managedText: string, innerText: string }>} */
-  const out = [];
-  for (const rel of skillFiles) {
-    const parts = rel.split("/");
-    const skillName = parts[2] ?? "";
-    if (!skillName) continue;
-    const blockId = `codex-skill:${skillName}`;
-    const srcAbs = path.join(tpl.templateDir, ...rel.split("/"));
-    const templateText = normalizeNewlines(await readText(srcAbs));
-    const { frontMatter, body } = splitYamlFrontMatter(templateText);
-
-    const innerTextRaw = normalizeNewlines(body);
-    const innerText = innerTextRaw.endsWith("\n") ? innerTextRaw : `${innerTextRaw}\n`;
-
-    const begin = `<!-- AIWS_MANAGED_BEGIN:${blockId} -->`;
-    const end = `<!-- AIWS_MANAGED_END:${blockId} -->`;
-    const managedText = `${frontMatter}\n${begin}\n${innerText}${end}\n`;
-
-    out.push({ rel, skillName, blockId, srcAbs, templateText, managedText, innerText });
-  }
-  return out;
-}

package/src/commands/change-advice.js

@@ -1,181 +0,0 @@
-/**
- * @param {string} gitRoot
- * @param {string} changeId
- * @param {{
- *   computeChangeStatus: (gitRoot: string, changeId: string) => Promise<any>,
- *   currentBranch: (gitRoot: string) => Promise<string>,
- *   inferChangeIdFromBranch: (branch: string) => string,
- *   changeDirAbs: (gitRoot: string, changeId: string) => string,
- *   governanceGuidanceLines: (status: any) => Promise<string[]>,
- *   scopeGateFailureAction: (changeId: string) => string,
- *   scopeGatePendingRecommendation: (changeId: string) => string,
- *   scopeGatePassedRecommendation: () => string
- * }} deps
- */
-export async function computeChangeNextAdvice(gitRoot, changeId, deps) {
-  const status = await deps.computeChangeStatus(gitRoot, changeId);
-  const branch = await deps.currentBranch(gitRoot);
-  const inferred = deps.inferChangeIdFromBranch(branch);
-  const advice = {
-    changeId,
-    branch: branch || "",
-    inferredChangeId: inferred || "",
-    phase: status.phase,
-    governance: status.governance || null,
-    scopeGate: status.scopeGate || null,
-    blockersStrict: status.blockersStrict,
-    evidence: status.evidence?.counts || null,
-    collaboration: status.collaboration?.counts || null,
-    actions: [],
-    prohibitions: [],
-    recommended: [],
-  };
-
-  if (!branch) {
-    advice.actions.push("当前为 detached HEAD：建议切到 `change/<change-id>` 分支后再继续（或显式传入 `<change-id>`）");
-  } else if (inferred && inferred !== changeId) {
-    advice.actions.push(`当前分支为 \`${branch}\`（推断 change=${inferred}），但你在查看 change=${changeId}：建议先切换到 \`change/${changeId}\` 再执行开发/交付`);
-  } else if (!inferred) {
-    advice.actions.push(`当前分支为 \`${branch}\`（非 change 分支）：建议 \`aiws change start ${changeId} --hooks --switch\` 或 \`git switch change/${changeId}\``);
-  }
-
-  if (status.metaState !== "ok") advice.actions.push(`补齐元信息并建立真值基线：\`aiws change sync ${changeId}\``);
-  if (status.driftFiles.length > 0) {
-    advice.actions.push("真值/合同已变化：先对齐 `AI_PROJECT.md` / `AI_WORKSPACE.md` / `REQUIREMENTS.md` 与 proposal/tasks");
-    advice.actions.push(`确认后同步基线：\`aiws change sync ${changeId}\``);
-  }
-  if (status.terminatedReuse) {
-    advice.actions.push(status.terminatedReuse.message);
-    advice.prohibitions.push(`不要继续在 change/${changeId} 上开发或提交新改动`);
-    advice.recommended.push(`优先续跑收尾：\`aiws change finish ${changeId} --push\``);
-    advice.recommended.push(`仅在你明确只需要本地归档恢复时，才手工运行 \`aiws change archive ${changeId}\``);
-    return advice;
-  }
-
-  const proposalPath = path.join(deps.changeDirAbs(gitRoot, changeId), "proposal.md");
-  const tasksPath = path.join(deps.changeDirAbs(gitRoot, changeId), "tasks.md");
-  if (status.blockersStrict.some((item) => item.includes("proposal.md") && item.includes("WS:TODO"))) {
-    advice.actions.push(`完善 proposal：\`$EDITOR ${proposalPath}\``);
-  }
-  if (status.blockersStrict.some((item) => item.includes("tasks.md") && item.includes("WS:TODO"))) {
-    advice.actions.push(`完善 tasks：\`$EDITOR ${tasksPath}\``);
-  }
-  if (status.blockersStrict.some((item) => item.includes("proposal.md missing attribution"))) {
-    advice.actions.push("补齐归因：在 proposal.md 填写非空 `Req_ID` 或 `Problem_ID`（严格校验需要）");
-  }
-  if (status.blockersStrict.some((item) => item.includes("missing Contract_Row"))) {
-    advice.actions.push("补齐绑定：在 proposal.md 填写非空 `Contract_Row`（严格校验需要）");
-  }
-  if (status.blockersStrict.some((item) => item.includes("Plan_File"))) {
-    advice.actions.push("补齐绑定：修正 proposal.md 的 `Plan_File`（严格校验需要；必须存在且仅 1 个）");
-  }
-  if (status.blockersStrict.some((item) => item.includes("missing Evidence_Path"))) {
-    advice.actions.push("补齐绑定：在 proposal.md 填写非空 `Evidence_Path`（严格校验需要；建议优先写 `changes/<id>/evidence/...`）");
-  }
-  if (status.scopeGate?.status === "failed") {
-    advice.actions.push(deps.scopeGateFailureAction(changeId));
-  }
-  if (status.tasks.unchecked > 0) advice.actions.push(`完成未勾选任务（${status.tasks.unchecked} 项）`);
-  if (status.blockersStrict.length === 0 && status.tasks.unchecked > 0) {
-    advice.actions.push("质量门通过后继续开发：simple/local 单点修复优先 `$ws-dev-lite`；否则 `$ws-dev`");
-  }
-  if (
-    status.blockersStrict.length === 0 &&
-    status.tasks.unchecked === 0 &&
-    Number(status?.reviewSignals?.effectiveCount || 0) > 0 &&
-    Number(status?.reviewGates?.summary?.dualReviewMissingCount || 0) > 0
-  ) {
-    advice.actions.push("已有通用 review，但 dual review gate 未完成：继续补齐 `$ws-spec-review` / `$ws-quality-review`，不要把 `codex-review.md` 当成 finish gate");
-  }
-  if ((status.collaboration?.counts?.analysis || 0) > 0 && (status.collaboration?.counts?.review || 0) === 0) {
-    advice.actions.push("已有委托分析但还没有 review 汇总结论：建议在 `changes/<id>/review/` 落盘结论后再交付");
-  }
-  if ((status.collaboration?.counts?.patches || 0) > 0) {
-    advice.actions.push("存在委托 patch 草案：提交/交付前先人工审查 `changes/<id>/patches/`，不要直接无审查应用");
-  }
-
-  if (status.blockersStrict.length > 0 && advice.actions.length === 0) {
-    advice.actions.push("先修复 Blockers (strict) 后复跑质量门，再进入编码：simple/local 单点修复优先 `$ws-dev-lite`；否则 `$ws-dev`");
-  }
-
-  if (status.blockersStrict.length === 0 && status.tasks.unchecked === 0) {
-    for (const line of await deps.governanceGuidanceLines(status)) advice.recommended.push(line);
-    if (advice.evidence && advice.evidence.persistent === 0) {
-      advice.recommended.push("交付前建议生成持久证据并回填：`aiws change evidence <change-id>`");
-    }
-    if (status.scopeGate?.status === "not_run") {
-      advice.recommended.push(deps.scopeGatePendingRecommendation(changeId));
-    } else if (status.scopeGate?.status === "passed") {
-      advice.recommended.push(deps.scopeGatePassedRecommendation());
-    }
-    if ((status.governance?.recommendedStage || "") === "ws-finish" || (status.governance?.currentStage || "") === "ws-commit") {
-      advice.recommended.push("交付前门禁（推荐落盘）：`aiws validate . --stamp`");
-    }
-    if ((status.collaboration?.counts?.review || 0) > 1) advice.recommended.push("存在多份 review：交付前建议在 handoff 或 review 汇总里收敛最终结论");
-  } else if (advice.actions.length === 0) {
-    advice.recommended.push("继续开发：simple/local 单点修复优先 `$ws-dev-lite`；否则 `$ws-dev`（小步实现 + 可复现验证）");
-    if ((status.collaboration?.counts?.analysis || 0) > 0) advice.recommended.push("已有委托分析：进入实现前先收敛 `changes/<id>/analysis/` 结论");
-    if ((status.collaboration?.counts?.patches || 0) > 0) advice.recommended.push("已有 patch 草案：应用前先人工审查 `changes/<id>/patches/`");
-  }
-
-  return advice;
-}
-
-/**
- * @param {{
- *   changeId: string,
- *   gitRoot: string,
- *   now: string,
- *   status: any,
- *   advice: any,
- *   planVerifyLine: string
- * }} input
- */
-export function renderChangeStateMarkdown(input) {
-  /** @type {string[]} */
-  const lines = [];
-  lines.push(`# AIWS STATE: ${input.changeId}`);
-  lines.push("");
-  lines.push(`Generated: ${input.now}`);
-  lines.push("");
-  lines.push("## Context");
-  lines.push(`- Worktree: \`${input.gitRoot}\``);
-  lines.push(`- Branch: \`${input.advice.branch || "(detached)"}\``);
-  lines.push("");
-  lines.push("## Phase");
-  lines.push(`- Phase: \`${input.status.phase}\``);
-  lines.push(
-    `- Tasks: ${input.status.tasks.done}/${input.status.tasks.total} (unchecked=${input.status.tasks.unchecked}, optional_open=${input.status.tasks.optionalUnchecked || 0}, n_a=${input.status.tasks.naCount || 0})`,
-  );
-  lines.push("");
-  lines.push("## Bindings");
-  if (input.status.reqId) lines.push(`- Req_ID: \`${input.status.reqId}\``);
-  if (input.status.probId) lines.push(`- Problem_ID: \`${input.status.probId}\``);
-  if (input.status.bindings?.contractRow) lines.push(`- Contract_Row: \`${input.status.bindings.contractRow}\``);
-  if (input.status.bindings?.planFile) lines.push(`- Plan_File: \`${input.status.bindings.planFile}\``);
-  lines.push("");
-  lines.push("## Evidence");
-  if (input.status.evidence?.counts) {
-    const counts = input.status.evidence.counts;
-    lines.push(
-      `- Declared: \`${counts.total}\` (exists=\`${counts.exists}\`, missing=\`${counts.missing}\`, persistent=\`${counts.persistent}\`, tmp=\`${counts.tmp}\`)`,
-    );
-  } else {
-    lines.push("- (unknown)");
-  }
-  lines.push("");
-  lines.push("## Blockers (strict)");
-  if (input.status.blockersStrict.length === 0) lines.push("- (none)");
-  else for (const blocker of input.status.blockersStrict) lines.push(`- ${blocker}`);
-  lines.push("");
-  lines.push("## Next");
-  lines.push(`- ${input.planVerifyLine}`);
-  for (const action of input.advice.actions) lines.push(`- ${action}`);
-  for (const recommendation of input.advice.recommended) lines.push(`- ${recommendation}`);
-  if (input.advice.prohibitions.length > 0) {
-    lines.push("");
-    lines.push("## Do Not");
-    for (const prohibition of input.advice.prohibitions) lines.push(`- ${prohibition}`);
-  }
-  return lines.join("\n") + "\n";
-}

package/src/commands/change-evidence-command.js

@@ -1,242 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import {
-  buildDeliverySummary,
-  collectCollaborationArtifacts,
-  findLatestFileByMtime,
-  formatDeclaredValues,
-  mergeDeclaredValues,
-  relFromRoot,
-  upsertIdLine,
-  upsertProposalEvidencePath,
-} from "./change-evidence.js";
-import { TMP_REVIEW_FALLBACKS, tmpReviewFallbackPath } from "./change-review-gates.js";
-
-/**
- * @param {{
- *   gitRoot: string,
- *   changeId: string,
- *   changeDir: string,
- *   proposalText: string,
- *   options: { noValidate: boolean, allowFail: boolean }
- * }} input
- * @param {{
- *   appendMetricsEvent: (gitRoot: string, changeId: string, type: string, payload: any) => Promise<void>,
- *   computeChangeStatus: (gitRoot: string, changeId: string) => Promise<any>,
- *   currentBranch: (gitRoot: string) => Promise<string>,
- *   ensureDir: (path: string) => Promise<void>,
- *   extractId: (label: string, text: string) => string,
- *   nowIsoUtc: () => string,
- *   nowStampUtc: () => string,
- *   pathExists: (path: string) => Promise<boolean>,
- *   planVerifyHint: (changeId: string) => string,
- *   readText: (path: string) => Promise<string>,
- *   splitDeclaredValues: (s: string) => string[],
- *   validateChangeArtifacts: (gitRoot: string, changeId: string, options: any) => Promise<any>,
- *   writeText: (path: string, content: string) => Promise<void>,
- *   UserError: typeof import("../errors.js").UserError
- * }} deps
- */
-export async function runChangeEvidenceWorkflow(input, deps) {
-  const { gitRoot, changeId, changeDir, proposalText, options } = input;
-  const planDecl = deps.extractId("Plan_File", proposalText) || deps.extractId("Plan file", proposalText);
-  const planFiles = deps.splitDeclaredValues(planDecl).map((item) => String(item || "").replace(/^\.\//, ""));
-  const planRel = planFiles.length === 1 ? planFiles[0] : "";
-  const planAbs = planRel ? path.join(gitRoot, planRel) : "";
-  const planText = planAbs && (await deps.pathExists(planAbs)) ? await deps.readText(planAbs) : "";
-
-  const now = deps.nowStampUtc();
-  const evidenceDir = path.join(changeDir, "evidence");
-  const reviewDir = path.join(changeDir, "review");
-  const analysisDir = path.join(changeDir, "analysis");
-  const patchesDir = path.join(changeDir, "patches");
-  await deps.ensureDir(evidenceDir);
-  await deps.ensureDir(reviewDir);
-  await deps.ensureDir(analysisDir);
-  await deps.ensureDir(patchesDir);
-
-  /** @type {string[]} */
-  const created = [];
-  const branch = await deps.currentBranch(gitRoot);
-  const status = await deps.computeChangeStatus(gitRoot, changeId);
-
-  const statusPath = path.join(evidenceDir, `change-status-${now}.json`);
-  await deps.writeText(
-    statusPath,
-    JSON.stringify(
-      {
-        generated_at: deps.nowIsoUtc(),
-        ws_root: gitRoot,
-        change_id: changeId,
-        branch: branch || "",
-        phase: status.phase,
-        tasks: status.tasks,
-        bindings: status.bindings,
-        truth: {
-          baseline: { label: status.baselineLabel, at: status.baselineAt },
-          drift_files: status.driftFiles,
-        },
-        evidence: status.evidence?.counts || null,
-        collaboration: status.collaboration?.counts || null,
-        note: "aiws change evidence status snapshot; does not contain secrets.",
-      },
-      null,
-      2,
-    ) + "\n",
-  );
-  created.push(relFromRoot(gitRoot, statusPath));
-
-  /** @type {any | null} */
-  let validateRes = null;
-  let validateFailed = false;
-  let validatePathForError = "";
-  if (!options.noValidate) {
-    validateRes = await deps.validateChangeArtifacts(gitRoot, changeId, { strict: true, allowTruthDrift: false });
-    const validatePath = path.join(evidenceDir, `change-validate-strict-${now}.json`);
-    await deps.writeText(validatePath, JSON.stringify(validateRes, null, 2) + "\n");
-    created.push(relFromRoot(gitRoot, validatePath));
-    validateFailed = validateRes.ok !== true;
-    validatePathForError = validatePath;
-  }
-
-  const validateStampDir = path.join(gitRoot, ".agentdocs", "tmp", "aiws-validate");
-  const latestValidateStamp = await findLatestFileByMtime(validateStampDir, (name) => name.endsWith(".json"));
-  if (latestValidateStamp) {
-    const dest = path.join(evidenceDir, `aiws-validate-stamp-${now}.json`);
-    await fs.copyFile(latestValidateStamp, dest);
-    created.push(relFromRoot(gitRoot, dest));
-  }
-
-  const syncStampDir = path.join(gitRoot, ".agentdocs", "tmp", "change-sync");
-  const latestSyncStamp = await findLatestFileByMtime(syncStampDir, (name) => name.endsWith(`-${changeId}.json`));
-  if (latestSyncStamp) {
-    const dest = path.join(evidenceDir, `change-sync-stamp-${now}.json`);
-    await fs.copyFile(latestSyncStamp, dest);
-    created.push(relFromRoot(gitRoot, dest));
-  }
-
-  for (const { fileName, persistentKind } of TMP_REVIEW_FALLBACKS) {
-    const src = tmpReviewFallbackPath(gitRoot, fileName);
-    if (!(await deps.pathExists(src))) continue;
-    const dest = persistentKind === "evidence" ? path.join(evidenceDir, fileName) : path.join(reviewDir, fileName);
-    if (!(await deps.pathExists(dest))) {
-      await fs.copyFile(src, dest);
-    }
-    const rel = relFromRoot(gitRoot, dest);
-    if (!created.includes(rel)) created.push(rel);
-  }
-
-  if (await deps.pathExists(reviewDir)) {
-    try {
-      const reviewEntries = await fs.readdir(reviewDir, { withFileTypes: true });
-      for (const entry of reviewEntries) {
-        if (!entry.isFile()) continue;
-        if (entry.name === "codex-review.md") continue;
-        if (!entry.name.endsWith(".md")) continue;
-        const rel = relFromRoot(gitRoot, path.join(reviewDir, entry.name));
-        if (!created.includes(rel)) created.push(rel);
-      }
-    } catch {
-      // ignore
-    }
-  }
-
-  const collaboration = await collectCollaborationArtifacts(gitRoot, changeDir);
-  const collaborationPath = path.join(evidenceDir, `collaboration-summary-${now}.json`);
-  await deps.writeText(
-    collaborationPath,
-    JSON.stringify(
-      {
-        generated_at: deps.nowIsoUtc(),
-        ws_root: gitRoot,
-        change_id: changeId,
-        counts: collaboration.counts,
-        dirs: collaboration.dirs,
-        note: "aiws collaboration summary; patch files are drafts and must be reviewed before apply.",
-      },
-      null,
-      2,
-    ) + "\n",
-  );
-  created.push(relFromRoot(gitRoot, collaborationPath));
-
-  const summaryAbs = path.join(evidenceDir, `delivery-summary-${now}.md`);
-  await deps.writeText(
-    summaryAbs,
-    buildDeliverySummary({
-      gitRoot,
-      changeId,
-      branch: branch || "",
-      status,
-      collaboration,
-      created,
-      validateRes,
-      validateFailed,
-    }),
-  );
-  created.push(relFromRoot(gitRoot, summaryAbs));
-
-  const declaredEvidence = deps.extractId("Evidence_Path", proposalText) || deps.extractId("Evidence_Path(s)", proposalText);
-  const existingProposalEvidence = deps.splitDeclaredValues(declaredEvidence).map((item) => String(item || "").replace(/^\.\//, ""));
-  const mergedEvidence = mergeDeclaredValues(existingProposalEvidence, created);
-  const mergedEvidenceText = formatDeclaredValues(mergedEvidence);
-
-  const updatedProposal = upsertProposalEvidencePath(proposalText, mergedEvidenceText);
-  if (updatedProposal.changed) {
-    await deps.writeText(path.join(changeDir, "proposal.md"), updatedProposal.text);
-  }
-
-  let planUpdated = false;
-  if (planAbs && planText) {
-    const existingPlanEvidence = deps
-      .splitDeclaredValues(deps.extractId("Evidence_Path", planText) || deps.extractId("Evidence_Path(s)", planText))
-      .map((item) => String(item || "").replace(/^\.\//, ""));
-    const mergedPlanEvidence = mergeDeclaredValues(existingPlanEvidence, mergedEvidence);
-    const mergedPlanEvidenceText = formatDeclaredValues(mergedPlanEvidence);
-    const updatedPlan = upsertIdLine(planText, ["Evidence_Path", "Evidence_Path(s)"], mergedPlanEvidenceText, { insertAfterLabels: ["Plan_File", "Contract_Row"] });
-    if (updatedPlan.changed) {
-      await deps.writeText(planAbs, updatedPlan.text);
-      planUpdated = true;
-    }
-  }
-
-  await deps.appendMetricsEvent(gitRoot, changeId, "evidence", {
-    generated_at: deps.nowIsoUtc(),
-    created: created.length,
-    strict_validate: options.noValidate ? "skipped" : validateRes && validateRes.ok === true ? "ok" : "failed",
-    allow_fail: options.allowFail === true,
-  });
-
-  /** @type {string[]} */
-  const outputLines = [];
-  outputLines.push(`✓ aiws change evidence: ${changeId}`);
-  outputLines.push(`dir: ${path.relative(gitRoot, changeDir)}`);
-  if (planRel) outputLines.push(`Plan_File: ${planRel}`);
-  outputLines.push("created:");
-  if (created.length > 0) {
-    for (const item of created) outputLines.push(`- ${item}`);
-  } else {
-    outputLines.push("- (none)");
-  }
-  outputLines.push("updated:");
-  outputLines.push(`- ${path.relative(gitRoot, path.join(changeDir, "proposal.md"))} (Evidence_Path)`);
-  if (planRel && planText && planUpdated) outputLines.push(`- ${planRel} (Evidence_Path)`);
-  else if (planRel && planText) outputLines.push(`- ${planRel} (Evidence_Path)`);
-  outputLines.push("");
-  outputLines.push("next:");
-  outputLines.push(`- ${deps.planVerifyHint(changeId)}`);
-  if (validateFailed) outputLines.push("- fix validation errors, then re-run evidence (or run with --allow-fail to proceed)");
-  else outputLines.push(`- verify evidence gate: \`aiws change validate ${changeId} --strict --check-evidence\``);
-
-  let errorToThrow = null;
-  if (validateFailed && !options.allowFail) {
-    const details = (validateRes && validateRes.raw ? String(validateRes.raw) : "").trim() || "Validation failed (see evidence JSON for details).";
-    const hint = validatePathForError ? `\n\nevidence:\n- ${path.relative(gitRoot, validatePathForError)}` : "";
-    errorToThrow = new deps.UserError("Failed to generate evidence due to strict validation errors.", { details: `${details}${hint}` });
-  }
-
-  return {
-    output: outputLines.join("\n") + "\n",
-    errorToThrow,
-  };
-}

package/src/commands/change-evidence-entry.js

@@ -1,40 +0,0 @@
-import path from "node:path";
-
-/**
- * @param {{
- *   gitRoot: string,
- *   changeId: string,
- *   options: { noValidate: boolean, allowFail: boolean }
- * }} input
- * @param {{
- *   changeDirAbs: (gitRoot: string, changeId: string) => string,
- *   fileState: (changeDir: string, rel: string) => Promise<any>,
- *   pathExists: (path: string) => Promise<boolean>,
- *   runChangeEvidenceWorkflow: (input: any, deps: any) => Promise<{ output: string, errorToThrow: any }>,
- *   workflowDeps: Record<string, any>,
- *   UserError: typeof import("../errors.js").UserError
- * }} deps
- */
-export async function runChangeEvidenceCommand(input, deps) {
-  const { gitRoot, changeId, options } = input;
-  const changeDir = deps.changeDirAbs(gitRoot, changeId);
-  if (!(await deps.pathExists(changeDir))) {
-    throw new deps.UserError(`Missing change dir: ${path.relative(gitRoot, changeDir)}`);
-  }
-
-  const proposal = await deps.fileState(changeDir, "proposal.md");
-  if (proposal.state !== "ok") {
-    throw new deps.UserError("proposal.md is required for evidence generation.", { details: path.relative(gitRoot, proposal.abs) });
-  }
-
-  return deps.runChangeEvidenceWorkflow(
-    {
-      gitRoot,
-      changeId,
-      changeDir,
-      proposalText: proposal.text,
-      options,
-    },
-    deps.workflowDeps,
-  );
-}