@aipper/aiws 0.0.29 → 0.0.31

package/dist/commands/change-status-command.js

@@ -0,0 +1,126 @@
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   branch: string,
+ *   status: any
+ * }} input
+ * @param {{
+ *   effectiveReviewCount: (status: any) => number,
+ *   governanceGuidanceLines: (status: any) => Promise<string[]>,
+ *   planVerifyHint: (changeId: string) => string
+ * }} deps
+ */
+export async function renderChangeStatusOutput(input, deps) {
+    const { gitRoot, branch, status } = input;
+    /** @type {string[]} */
+    const lines = [];
+    lines.push(`✓ aiws change status: ${status.changeId}`);
+    lines.push(`dir: ${status.dir}`);
+    lines.push(`phase: ${status.phase}`);
+    lines.push(`branch: ${branch || "(detached HEAD)"}`);
+    lines.push(`meta: ${status.metaState}`);
+    if (status.reqId)
+        lines.push(`Req_ID: ${status.reqId}`);
+    if (status.probId)
+        lines.push(`Problem_ID: ${status.probId}`);
+    lines.push(`tasks: ${status.tasks.done}/${status.tasks.total} (unchecked=${status.tasks.unchecked}, optional_open=${status.tasks.optionalUnchecked || 0}, n_a=${status.tasks.naCount || 0})`);
+    if (status.reviewSignals) {
+        lines.push(`review_signal: effective=${status.reviewSignals.effectiveCount} source=${status.reviewSignals.source}`);
+    }
+    if (status.reviewGates?.summary) {
+        const summary = status.reviewGates.summary;
+        const missing = summary.finishGateMissingIds.length > 0 ? summary.finishGateMissingIds.join(", ") : "(none)";
+        lines.push(`review_gates: generic_only=${summary.genericReviewOnly} dual_pending=${summary.dualReviewPending} dual_ready=${summary.dualReviewReady} finish_ready=${summary.finishGateReady} missing=${missing}`);
+        for (const gate of status.reviewGates.gates || []) {
+            lines.push(`review_gate:${gate.id} ready=${gate.ready} status=${gate.status}${gate.foundPath ? ` path=${gate.foundPath}` : ""}`);
+        }
+        if (status.reviewGates.validateStamp) {
+            const validateStamp = status.reviewGates.validateStamp;
+            lines.push(`review_gate:${validateStamp.id} ready=${validateStamp.ready} status=${validateStamp.status}${validateStamp.foundPath ? ` path=${validateStamp.foundPath}` : ""}`);
+        }
+    }
+    if (status.scopeGate) {
+        lines.push(`scope_gate: status=${status.scopeGate.status} ready=${status.scopeGate.ready} checked=${status.scopeGate.checked} errors=${status.scopeGate.errors} warnings=${status.scopeGate.warnings}${status.scopeGate.lastRunAt ? ` at=${status.scopeGate.lastRunAt}` : ""}`);
+    }
+    if (status.git) {
+        lines.push(`git: clean=${status.git.clean} staged=${status.git.staged} unstaged=${status.git.unstaged} untracked=${status.git.untracked} conflicted=${status.git.conflicted}`);
+    }
+    if (status.governance) {
+        lines.push(`governance: current=${status.governance.currentStage} next=${status.governance.recommendedStage}`);
+        if (status.governance.rationale)
+            lines.push(`governance_reason: ${status.governance.rationale}`);
+        if (status.governance.ruleId)
+            lines.push(`governance_rule: ${status.governance.ruleId}`);
+        if (status.governance.source)
+            lines.push(`governance_source: ${status.governance.source}`);
+    }
+    lines.push(`baseline: ${status.baselineLabel}${status.baselineAt ? ` (at=${status.baselineAt})` : ""}`);
+    lines.push(`drift: ${status.driftFiles.length > 0 ? status.driftFiles.join(", ") : "(none)"}`);
+    if (status.evidence?.counts) {
+        const counts = status.evidence.counts;
+        lines.push(`evidence: declared=${counts.total} (exists=${counts.exists}, missing=${counts.missing}, persistent=${counts.persistent}, tmp=${counts.tmp})`);
+    }
+    if (status.collaboration?.counts) {
+        const counts = status.collaboration.counts;
+        lines.push(`collaboration: analysis=${counts.analysis}, patches=${counts.patches}, review=${counts.review}, evidence_dir=${counts.evidence}`);
+    }
+    lines.push("");
+    lines.push("Blockers (strict):");
+    if (status.blockersStrict.length === 0)
+        lines.push("- (none)");
+    else
+        for (const blocker of status.blockersStrict)
+            lines.push(`- ${blocker}`);
+    lines.push("");
+    lines.push("Blockers (archive):");
+    if (status.blockersArchive.length === 0)
+        lines.push("- (none)");
+    else
+        for (const blocker of status.blockersArchive)
+            lines.push(`- ${blocker}`);
+    lines.push("");
+    lines.push("Next (recommended):");
+    if (status.terminatedReuse) {
+        lines.push(`- ${status.terminatedReuse.message}`);
+        lines.push(`- rerun \`aiws change finish ${status.changeId} --push\` to resume the unfinished finish/archive flow`);
+        lines.push(`- do not continue development or commit on \`change/${status.changeId}\``);
+        return lines.join("\n") + "\n";
+    }
+    lines.push(`- ${deps.planVerifyHint(status.changeId)}`);
+    if (status.blockersStrict.length > 0) {
+        lines.push("- 先修复 Blockers (strict) 后复跑质量门，再进入编码：simple/local 单点修复优先 `$ws-dev-lite`；否则 `$ws-dev`");
+        return lines.join("\n") + "\n";
+    }
+    if (status.tasks.unchecked > 0) {
+        lines.push("- 继续开发：simple/local 单点修复优先 `$ws-dev-lite`；否则 `$ws-dev`（小步实现 + 可复现验证）");
+        if ((status.collaboration?.counts?.analysis || 0) > 0)
+            lines.push("- 已有委托分析：在编码前先收敛 `.aiws/changes/<id>/analysis/` 中的结论");
+        if ((status.collaboration?.counts?.patches || 0) > 0)
+            lines.push("- 已有 patch 草案：应用前先人工审查 `.aiws/changes/<id>/patches/`");
+        lines.push("- 提交/交付前强制门禁：`aiws validate .`（可选落盘：`aiws validate . --stamp`）");
+        lines.push(`- （可选）状态快照：\`aiws change state ${status.changeId} --write\``);
+        return lines.join("\n") + "\n";
+    }
+    if (status.evidence?.counts && status.evidence.counts.persistent === 0) {
+        lines.push("- 交付前建议生成持久证据：`.aiws/changes/<id>/evidence/...`（并把路径回填到 proposal.md 的 Evidence_Path）");
+    }
+    if (status.evidence?.missing && status.evidence.missing.length > 0) {
+        const show = status.evidence.missing.slice(0, 5);
+        lines.push(`- 交付前建议补齐缺失证据文件（missing=${status.evidence.missing.length}）：${show.join(", ")}${status.evidence.missing.length > show.length ? ", ..." : ""}`);
+    }
+    if ((status.collaboration?.counts?.patches || 0) > 0) {
+        lines.push("- 存在委托 patch 草案：交付前确认其已被人工审查，并在 review/handoff 中记录结论");
+    }
+    if ((status.collaboration?.counts?.analysis || 0) > 0 && deps.effectiveReviewCount(status) === 0) {
+        lines.push("- 存在委托分析但尚无 review 汇总：建议先在 `.aiws/changes/<id>/review/` 形成结论后再交付");
+    }
+    lines.push(`- （可选）状态快照：\`aiws change state ${status.changeId} --write\``);
+    for (const line of await deps.governanceGuidanceLines(status))
+        lines.push(`- ${line}`);
+    if (status.governance?.rationale)
+        lines.push(`- 阶段判定：${status.governance.rationale}`);
+    if (status.governance?.warning)
+        lines.push(`- 注意：${status.governance.warning}`);
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=change-status-command.js.map

package/dist/commands/change-status-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-status-command.js","sourceRoot":"","sources":["../../src/commands/change-status-command.ts"],"names":[],"mappings":"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"}

package/dist/commands/change-status-context.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{
+ *   currentBranch: (gitRoot: string) => Promise<string>,
+ *   inferChangeIdFromBranch: (branch: string) => string
+ * }} deps
+ */
+export declare function resolveChangeStatusContext(gitRoot: string, changeId: string, deps: any): Promise<{
+    worktree: string;
+    branch: any;
+    branchMatchesChange: boolean;
+    source: string;
+    warning: string;
+    currentWorktree: string;
+    currentBranch: any;
+    changeWorktree: string;
+}>;
+/**
+ * @param {string} changeDir
+ * @param {{ pathExists: (path: string) => Promise<boolean>, readText: (path: string) => Promise<string> }} deps
+ */
+export declare function readChangeMetrics(changeDir: string, deps: any): Promise<{
+    state: string;
+    abs: string;
+    events: any;
+}>;
+/**
+ * @param {{ state: string, events: any[] }} metrics
+ */
+export declare function summarizeLifecycleSignals(metrics: any): {
+    metricsState: string;
+    latestEventType: string;
+    eventCounts: Record<string, number>;
+    evidenceRuns: number;
+    finishRuns: number;
+    finishCleanupPendingReason: string;
+    finishState: string;
+    finishStateReason: string;
+    finishStateEventType: string;
+    archiveRuns: number;
+    strictValidatePass: boolean;
+    strictScopeValidateRuns: any;
+    strictScopeValidatePass: boolean;
+    strictScopeValidateAt: string;
+    strictScopeValidateErrors: number;
+    strictScopeValidateWarnings: number;
+};
+/**
+ * @param {Record<string, string | null>} curTruth
+ * @param {any} baseline
+ * @returns {{ baselineLabel: string, baselineAt: string, driftFiles: string[] }}
+ */
+export declare function truthDrift(curTruth: Record<string, string | null>, baseline: any): {
+    baselineLabel: string;
+    baselineAt: string;
+    driftFiles: string[];
+};

package/dist/commands/change-status-context.js

@@ -0,0 +1,166 @@
+import path from "node:path";
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{
+ *   currentBranch: (gitRoot: string) => Promise<string>,
+ *   inferChangeIdFromBranch: (branch: string) => string
+ * }} deps
+ */
+export async function resolveChangeStatusContext(gitRoot, changeId, deps) {
+    const rootBranch = await deps.currentBranch(gitRoot);
+    const contextBranch = rootBranch;
+    const inferred = deps.inferChangeIdFromBranch(contextBranch);
+    return {
+        worktree: path.resolve(gitRoot),
+        branch: contextBranch,
+        branchMatchesChange: inferred === changeId,
+        source: "current_worktree",
+        warning: "",
+        currentWorktree: path.resolve(gitRoot),
+        currentBranch: rootBranch,
+        changeWorktree: "",
+    };
+}
+/**
+ * @param {string} changeDir
+ * @param {{ pathExists: (path: string) => Promise<boolean>, readText: (path: string) => Promise<string> }} deps
+ */
+export async function readChangeMetrics(changeDir, deps) {
+    const metricsAbs = path.join(changeDir, "metrics.json");
+    if (!(await deps.pathExists(metricsAbs)))
+        return { state: "missing", abs: metricsAbs, events: [] };
+    try {
+        const parsed = JSON.parse(await deps.readText(metricsAbs));
+        const events = Array.isArray(parsed?.events) ? parsed.events : [];
+        return { state: "ok", abs: metricsAbs, events };
+    }
+    catch {
+        return { state: "invalid", abs: metricsAbs, events: [] };
+    }
+}
+const FINISH_DONE_COMPLETED_CLEANUPS = new Set([
+    "removed",
+    "pruned-missing",
+    "skipped:current_worktree",
+]);
+/**
+ * @param {any} ev
+ * @returns {{ state: string, reason: string, eventType: string } | null}
+ */
+function classifyFinishLifecycleEvent(ev) {
+    const type = String(ev?.type || "").trim();
+    if (!type)
+        return null;
+    if (type === "finish_local") {
+        return { state: "local", reason: "", eventType: type };
+    }
+    if (type === "finish_failed") {
+        return { state: "failed", reason: String(ev?.payload?.error || ""), eventType: type };
+    }
+    if (type === "finish_cleanup_pending") {
+        return {
+            state: "cleanup_pending",
+            reason: String(ev?.payload?.reason || ev?.payload?.cleanup || ""),
+            eventType: type,
+        };
+    }
+    if (type === "finish") {
+        return { state: "done", reason: "", eventType: type };
+    }
+    if (type !== "finish_done")
+        return null;
+    const payload = ev?.payload && typeof ev.payload === "object" ? ev.payload : null;
+    const hasPush = payload ? Object.prototype.hasOwnProperty.call(payload, "push") : false;
+    const pushCompleted = hasPush ? payload?.push === true : null;
+    const cleanup = String(payload?.cleanup || "").trim();
+    if (pushCompleted === false || cleanup === "not_requested") {
+        return { state: "local", reason: "", eventType: type };
+    }
+    if (!cleanup) {
+        return { state: "done", reason: "", eventType: type };
+    }
+    if (FINISH_DONE_COMPLETED_CLEANUPS.has(cleanup)) {
+        return { state: "done", reason: "", eventType: type };
+    }
+    return {
+        state: "cleanup_pending",
+        reason: cleanup.startsWith("skipped:") ? cleanup.slice("skipped:".length) : cleanup,
+        eventType: type,
+    };
+}
+/**
+ * @param {{ state: string, events: any[] }} metrics
+ */
+export function summarizeLifecycleSignals(metrics) {
+    const events = Array.isArray(metrics?.events) ? metrics.events : [];
+    /** @type {Record<string, number>} */
+    const eventCounts = {};
+    let finishState = "";
+    let finishStateReason = "";
+    let finishStateEventType = "";
+    for (const ev of events) {
+        const type = String(ev?.type || "").trim();
+        if (!type)
+            continue;
+        eventCounts[type] = (eventCounts[type] || 0) + 1;
+        const finishIsTerminal = finishState === "done";
+        if (finishIsTerminal && type !== "finish_done" && type !== "finish")
+            continue;
+        const classified = classifyFinishLifecycleEvent(ev);
+        if (!classified)
+            continue;
+        finishState = classified.state;
+        finishStateReason = classified.reason;
+        finishStateEventType = classified.eventType;
+    }
+    const latest = events.length > 0 ? events[events.length - 1] : null;
+    const validateEvents = events.filter((ev) => ev?.type === "validate");
+    const latestStrictValidate = [...validateEvents].reverse().find((ev) => ev?.payload?.strict === true) || null;
+    const latestStrictScopeValidate = [...validateEvents].reverse().find((ev) => ev?.payload?.strict === true && ev?.payload?.check_scope === true) || null;
+    const strictScopeValidateRuns = validateEvents.filter((ev) => ev?.payload?.strict === true && ev?.payload?.check_scope === true).length;
+    return {
+        metricsState: String(metrics?.state || "missing"),
+        latestEventType: String(latest?.type || ""),
+        eventCounts,
+        evidenceRuns: eventCounts.evidence || 0,
+        finishRuns: (eventCounts.finish || 0) + (eventCounts.finish_done || 0),
+        finishCleanupPendingReason: finishState === "cleanup_pending" ? finishStateReason : "",
+        finishState,
+        finishStateReason,
+        finishStateEventType,
+        archiveRuns: eventCounts.archive || 0,
+        strictValidatePass: latestStrictValidate ? latestStrictValidate?.payload?.ok === true : false,
+        strictScopeValidateRuns,
+        strictScopeValidatePass: latestStrictScopeValidate ? latestStrictScopeValidate?.payload?.ok === true : false,
+        strictScopeValidateAt: String(latestStrictScopeValidate?.timestamp || ""),
+        strictScopeValidateErrors: Number(latestStrictScopeValidate?.payload?.errors || 0),
+        strictScopeValidateWarnings: Number(latestStrictScopeValidate?.payload?.warnings || 0),
+    };
+}
+/**
+ * @param {Record<string, string | null>} curTruth
+ * @param {any} baseline
+ * @returns {{ baselineLabel: string, baselineAt: string, driftFiles: string[] }}
+ */
+export function truthDrift(curTruth, baseline) {
+    /** @type {string[]} */
+    const driftFiles = [];
+    const createdTruth = baseline?.base_truth_files && typeof baseline.base_truth_files === "object" ? baseline.base_truth_files : {};
+    const syncedTruth = baseline?.synced_truth_files && typeof baseline.synced_truth_files === "object" ? baseline.synced_truth_files : {};
+    const effective = Object.keys(syncedTruth).length > 0 ? syncedTruth : createdTruth;
+    const baselineLabel = Object.keys(syncedTruth).length > 0 ? "sync" : "creation";
+    const baselineAt = Object.keys(syncedTruth).length > 0 ? String(baseline?.synced_at || "") : String(baseline?.created_at || "");
+    for (const [rel, info] of Object.entries(effective || {})) {
+        const baseSha = info && typeof info === "object" ? String(info.sha256 || "") : "";
+        const curSha = curTruth[rel] ?? null;
+        if (curSha == null) {
+            driftFiles.push(rel);
+            continue;
+        }
+        if (baseSha && curSha !== baseSha)
+            driftFiles.push(rel);
+    }
+    return { baselineLabel, baselineAt, driftFiles };
+}
+//# sourceMappingURL=change-status-context.js.map

package/dist/commands/change-status-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-status-context.js","sourceRoot":"","sources":["../../src/commands/change-status-context.ts"],"names":[],"mappings":"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"}

package/dist/commands/change-task-stats.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Parse checkbox tasks with AIWS-specific control markers.
+ *
+ * Supported markers:
+ * - `[optional]`: unchecked optional tasks do not block archive/finish.
+ * - `[n/a: ...]` / `[na: ...]` / `[not-applicable: ...]`: task is treated as closed.
+ *
+ * Returned `total/done/unchecked` are the effective gate counts. Optional open
+ * tasks are reported separately via `optionalUnchecked`.
+ *
+ * @param {string} text
+ */
+export declare function checkboxStats(text: string): {
+    total: number;
+    done: number;
+    unchecked: number;
+    hasCheckboxes: boolean;
+    totalAll: number;
+    doneAll: number;
+    uncheckedAll: number;
+    optionalTotal: number;
+    optionalUnchecked: number;
+    naCount: number;
+};

package/dist/commands/change-task-stats.js

@@ -0,0 +1,66 @@
+/**
+ * Parse checkbox tasks with AIWS-specific control markers.
+ *
+ * Supported markers:
+ * - `[optional]`: unchecked optional tasks do not block archive/finish.
+ * - `[n/a: ...]` / `[na: ...]` / `[not-applicable: ...]`: task is treated as closed.
+ *
+ * Returned `total/done/unchecked` are the effective gate counts. Optional open
+ * tasks are reported separately via `optionalUnchecked`.
+ *
+ * @param {string} text
+ */
+export function checkboxStats(text) {
+    const lines = String(text || "").split(/\r?\n/);
+    let total = 0;
+    let done = 0;
+    let unchecked = 0;
+    let totalAll = 0;
+    let doneAll = 0;
+    let uncheckedAll = 0;
+    let optionalTotal = 0;
+    let optionalUnchecked = 0;
+    let naCount = 0;
+    for (const rawLine of lines) {
+        const match = rawLine.match(/^\s*-\s+\[([ xX])\]\s+(.*)$/);
+        if (!match)
+            continue;
+        totalAll += 1;
+        const checked = String(match[1] || "").toLowerCase() === "x";
+        const body = String(match[2] || "");
+        const isOptional = /\[(?:optional|Optional)\]/.test(body);
+        const isNa = /\[(?:n\/a|na|not-applicable)\s*:[^\]]+\]/i.test(body);
+        if (checked)
+            doneAll += 1;
+        else
+            uncheckedAll += 1;
+        if (isOptional) {
+            optionalTotal += 1;
+            if (!checked && !isNa)
+                optionalUnchecked += 1;
+            continue;
+        }
+        total += 1;
+        if (checked || isNa) {
+            done += 1;
+            if (isNa)
+                naCount += 1;
+        }
+        else {
+            unchecked += 1;
+        }
+    }
+    return {
+        total,
+        done,
+        unchecked,
+        hasCheckboxes: totalAll > 0,
+        totalAll,
+        doneAll,
+        uncheckedAll,
+        optionalTotal,
+        optionalUnchecked,
+        naCount,
+    };
+}
+//# sourceMappingURL=change-task-stats.js.map

package/dist/commands/change-task-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-task-stats.js","sourceRoot":"","sources":["../../src/commands/change-task-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,QAAQ,IAAI,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpE,IAAI,OAAO;YAAE,OAAO,IAAI,CAAC,CAAC;;YACrB,YAAY,IAAI,CAAC,CAAC;QAEvB,IAAI,UAAU,EAAE,CAAC;YACf,aAAa,IAAI,CAAC,CAAC;YACnB,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI;gBAAE,iBAAiB,IAAI,CAAC,CAAC;YAC9C,SAAS;QACX,CAAC;QAED,KAAK,IAAI,CAAC,CAAC;QACX,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,CAAC;YACV,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,IAAI;QACJ,SAAS;QACT,aAAa,EAAE,QAAQ,GAAG,CAAC;QAC3B,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,aAAa;QACb,iBAAiB;QACjB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/commands/change-validate-entry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   options: { strict: boolean, allowTruthDrift: boolean, checkEvidence: boolean, checkScope: boolean }
+ * }} input
+ * @param {{
+ *   appendMetricsEvent: (gitRoot: string, changeId: string, type: string, payload: any) => Promise<void>,
+ *   validateChangeArtifacts: (gitRoot: string, changeId: string, options: any) => Promise<any>,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export declare function runChangeValidateCommand(input: any, deps: any): Promise<{
+    output: string;
+    stderr: string;
+    errorToThrow: any;
+}>;

package/dist/commands/change-validate-entry.js

@@ -0,0 +1,44 @@
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   options: { strict: boolean, allowTruthDrift: boolean, checkEvidence: boolean, checkScope: boolean }
+ * }} input
+ * @param {{
+ *   appendMetricsEvent: (gitRoot: string, changeId: string, type: string, payload: any) => Promise<void>,
+ *   validateChangeArtifacts: (gitRoot: string, changeId: string, options: any) => Promise<any>,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export async function runChangeValidateCommand(input, deps) {
+    const { gitRoot, changeId, options } = input;
+    const result = await deps.validateChangeArtifacts(gitRoot, changeId, {
+        strict: options.strict === true,
+        allowTruthDrift: options.allowTruthDrift === true,
+        checkEvidence: options.checkEvidence === true,
+        checkScope: options.checkScope === true,
+    });
+    await deps.appendMetricsEvent(gitRoot, changeId, "validate", {
+        ok: result.ok === true,
+        strict: options.strict === true,
+        allow_truth_drift: options.allowTruthDrift === true,
+        check_evidence: options.checkEvidence === true,
+        check_scope: options.checkScope === true,
+        errors: Array.isArray(result.errors) ? result.errors.length : 0,
+        warnings: Array.isArray(result.warnings) ? result.warnings.length : 0,
+        exit_code: result.exitCode,
+    });
+    if (result.raw) {
+        return {
+            output: result.ok ? `ok: change validated (${changeId})\n` : "",
+            stderr: result.raw + "\n",
+            errorToThrow: result.ok ? null : new deps.UserError(""),
+        };
+    }
+    return {
+        output: result.ok ? `ok: change validated (${changeId})\n` : "",
+        stderr: "",
+        errorToThrow: result.ok ? null : new deps.UserError(""),
+    };
+}
+//# sourceMappingURL=change-validate-entry.js.map

package/dist/commands/change-validate-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-validate-entry.js","sourceRoot":"","sources":["../../src/commands/change-validate-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAAU,EAAE,IAAS;IAClE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,QAAQ,EAAE;QACnE,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;QAC/B,eAAe,EAAE,OAAO,CAAC,eAAe,KAAK,IAAI;QACjD,aAAa,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI;QAC7C,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,IAAI;KACxC,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE;QAC3D,EAAE,EAAE,MAAM,CAAC,EAAE,KAAK,IAAI;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;QAC/B,iBAAiB,EAAE,OAAO,CAAC,eAAe,KAAK,IAAI;QACnD,cAAc,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI;QAC9C,WAAW,EAAE,OAAO,CAAC,UAAU,KAAK,IAAI;QACxC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrE,SAAS,EAAE,MAAM,CAAC,QAAQ;KAC3B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,yBAAyB,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE;YAC/D,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,IAAI;YACzB,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;SACxD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,yBAAyB,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE;QAC/D,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/dist/commands/change-validate.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{ strict: boolean, allowTruthDrift: boolean, checkEvidence?: boolean, checkScope?: boolean }} options
+ * @param {{
+ *   assertValidChangeId: (changeId: string) => void,
+ *   collectFinishGateErrors: (changeId: string, reviewGates: any) => string[],
+ *   computeChangeStatus: (gitRoot: string, changeId: string) => Promise<any>,
+ *   ensureTruthFiles: (gitRoot: string) => Promise<void>,
+ *   resolveWsChangeChecker: (gitRoot: string) => Promise<{ args: string[] }>,
+ *   runPython: (cwd: string, args: string[]) => Promise<{ code: number, stdout: string, stderr: string }>
+ * }} deps
+ */
+export declare function validateChangeArtifacts(gitRoot: string, changeId: string, options: {
+    strict: boolean;
+    allowTruthDrift: boolean;
+    checkEvidence?: boolean;
+    checkScope?: boolean;
+}, deps: any): Promise<{
+    ok: boolean;
+    changeId: string;
+    strict: boolean;
+    allowTruthDrift: boolean;
+    exitCode: any;
+    errors: string[];
+    warnings: string[];
+    groups: Record<string, {
+        errors: string[];
+        warnings: string[];
+    }>;
+    raw: string;
+}>;