@aipper/aiws 0.0.28 → 0.0.30

package/dist/commands/change-lifecycle.js

@@ -0,0 +1,211 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { checkboxStats } from "./change-task-stats.js";
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   changeDir: string
+ * }} input
+ * @param {{
+ *   appendMetricsEvent: (gitRoot: string, changeId: string, type: string, payload: any) => Promise<void>,
+ *   ensureDir: (path: string) => Promise<void>,
+ *   nowIsoUtc: () => string,
+ *   nowStampUtc: () => string,
+ *   nowUnixSeconds: () => number,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   readText: (path: string) => Promise<string>,
+ *   snapshotTruthFiles: (gitRoot: string) => Promise<any>,
+ *   writeText: (path: string, content: string) => Promise<void>
+ * }} deps
+ */
+export async function runChangeSyncWorkflow(input, deps) {
+    const { gitRoot, changeId, changeDir } = input;
+    const metaPath = path.join(changeDir, ".ws-change.json");
+    /** @type {any} */
+    let meta = null;
+    if (await deps.pathExists(metaPath)) {
+        try {
+            meta = JSON.parse(await deps.readText(metaPath));
+        }
+        catch {
+            meta = null;
+        }
+    }
+    const truth = await deps.snapshotTruthFiles(gitRoot);
+    const nowIso = deps.nowIsoUtc();
+    const nowTs = deps.nowUnixSeconds();
+    if (!meta) {
+        meta = { ws_change_version: 1, id: changeId, title: changeId, created_at: nowIso, base_truth_files: truth };
+    }
+    const createdTruth = meta.base_truth_files && typeof meta.base_truth_files === "object" ? meta.base_truth_files : {};
+    const syncedTruth = meta.synced_truth_files && typeof meta.synced_truth_files === "object" ? meta.synced_truth_files : {};
+    const baseline = Object.keys(syncedTruth).length > 0 ? syncedTruth : createdTruth;
+    const baselineLabel = Object.keys(syncedTruth).length > 0 ? "last sync" : "creation";
+    const baselineAt = Object.keys(syncedTruth).length > 0 ? String(meta.synced_at || "") : String(meta.created_at || "");
+    /** @type {Array<{file: string, from: string | null, to: string | null}>} */
+    const changed = [];
+    for (const [rel, info] of Object.entries(truth)) {
+        const curSha = info && typeof info === "object" ? String(info.sha256 || "") : "";
+        const baseSha = baseline && typeof baseline === "object" && baseline[rel] && typeof baseline[rel] === "object" ? String(baseline[rel].sha256 || "") : "";
+        if (baseSha && curSha && baseSha !== curSha) {
+            changed.push({ file: rel, from: baseSha, to: curSha });
+        }
+        else if (!baseSha && curSha) {
+            changed.push({ file: rel, from: null, to: curSha });
+        }
+    }
+    if (baseline && typeof baseline === "object") {
+        for (const rel of Object.keys(baseline)) {
+            if (!truth[rel]) {
+                const fromSha = baseline[rel] && typeof baseline[rel] === "object" ? String(baseline[rel].sha256 || "") : null;
+                changed.push({ file: rel, from: fromSha || null, to: null });
+            }
+        }
+    }
+    meta.synced_at = nowIso;
+    meta.synced_truth_files = truth;
+    let events = meta.sync_events;
+    if (!Array.isArray(events))
+        events = [];
+    events.push({ synced_at: nowIso, baseline_from: baselineLabel, baseline_at: baselineAt, changed });
+    meta.sync_events = events.slice(-20);
+    await deps.writeText(metaPath, JSON.stringify(meta, null, 2) + "\n");
+    const stampDir = path.join(gitRoot, ".aiws", "tmp", "change-sync");
+    await deps.ensureDir(stampDir);
+    const stampPath = path.join(stampDir, `${deps.nowStampUtc()}-${changeId}.json`);
+    await deps.writeText(stampPath, JSON.stringify({
+        timestamp: nowTs,
+        ws_root: gitRoot,
+        change_id: changeId,
+        change_dir: changeDir,
+        synced_at: nowIso,
+        previous_baseline: { label: baselineLabel, at: baselineAt, truth_files: baseline },
+        new_baseline: truth,
+        changed,
+        note: "aiws change sync stamp; does not contain secrets.",
+    }, null, 2) + "\n");
+    await deps.appendMetricsEvent(gitRoot, changeId, "truth_sync", {
+        synced_at: nowIso,
+        baseline_from: baselineLabel,
+        baseline_at: baselineAt,
+        changed_files: changed.map((item) => item.file),
+    });
+    /** @type {string[]} */
+    const outputLines = [];
+    outputLines.push(`✓ aiws change sync: ${changeId}`);
+    outputLines.push(`meta: ${path.relative(gitRoot, metaPath)}`);
+    outputLines.push(`stamp: ${path.relative(gitRoot, stampPath)}`);
+    outputLines.push("");
+    if (changed.length > 0) {
+        outputLines.push("Changed files:");
+        for (const item of changed)
+            outputLines.push(`- ${item.file}`);
+    }
+    else {
+        outputLines.push("No changes detected vs baseline.");
+    }
+    return { output: outputLines.join("\n") + "\n" };
+}
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   changeDir: string,
+ *   datePrefix?: string,
+ *   force: boolean
+ * }} input
+ * @param {{
+ *   appendMetricsEvent: (gitRoot: string, changeId: string, type: string, payload: any) => Promise<void>,
+ *   changeValidateCommand: (options: { changeId: string, strict: boolean, allowTruthDrift: boolean }) => Promise<void>,
+ *   ensureDir: (path: string) => Promise<void>,
+ *   generateHandoffContent: (gitRoot: string, changeDir: string, changeId: string) => Promise<string>,
+ *   nowIsoUtc: () => string,
+ *   nowStampUtc: () => string,
+ *   nowUnixSeconds: () => number,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   readText: (path: string) => Promise<string>,
+ *   snapshotTruthFiles: (gitRoot: string) => Promise<any>,
+ *   todayLocal: () => string,
+ *   writeText: (path: string, content: string) => Promise<void>,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export async function runChangeArchiveWorkflow(input, deps) {
+    const { gitRoot, changeId, changeDir } = input;
+    await deps.changeValidateCommand({ changeId, strict: true, allowTruthDrift: input.force, allowFinishedUnarchived: true });
+    const tasksAbs = path.join(changeDir, "tasks.md");
+    if (await deps.pathExists(tasksAbs)) {
+        const tasksText = await deps.readText(tasksAbs);
+        const taskStats = checkboxStats(tasksText);
+        if (taskStats.unchecked > 0) {
+            if (!input.force) {
+                throw new deps.UserError("tasks.md still has unchecked required tasks; complete them or pass --force");
+            }
+            console.error("warn: tasks.md still has unchecked required tasks; continuing due to --force");
+        }
+    }
+    const archiveRoot = path.join(gitRoot, ".aiws", "changes", "archive");
+    await deps.ensureDir(archiveRoot);
+    const prefix = (input.datePrefix ? String(input.datePrefix) : deps.todayLocal()).trim() || deps.todayLocal();
+    let dest = path.join(archiveRoot, `${prefix}-${changeId}`);
+    if (await deps.pathExists(dest)) {
+        dest = path.join(archiveRoot, `${prefix}-${changeId}-${deps.nowStampUtc()}`);
+    }
+    await deps.appendMetricsEvent(gitRoot, changeId, "archive", { archived_to: path.relative(gitRoot, dest) });
+    await fs.rename(changeDir, dest);
+    const handoffPath = path.join(dest, "handoff.md");
+    const handoffContent = await deps.generateHandoffContent(gitRoot, dest, changeId);
+    await deps.writeText(handoffPath, handoffContent);
+    const metaPath = path.join(dest, ".ws-change.json");
+    let metaUpdated = false;
+    if (await deps.pathExists(metaPath)) {
+        try {
+            const meta = JSON.parse(await deps.readText(metaPath));
+            const truth = await deps.snapshotTruthFiles(gitRoot);
+            meta.archived_at = deps.nowIsoUtc();
+            meta.archived_to = dest;
+            meta.archived_truth_files = truth;
+            await deps.writeText(metaPath, JSON.stringify(meta, null, 2) + "\n");
+            metaUpdated = true;
+        }
+        catch {
+            metaUpdated = false;
+        }
+    }
+    const stampDir = path.join(gitRoot, ".aiws", "tmp", "change-archive");
+    await deps.ensureDir(stampDir);
+    const stampPath = path.join(stampDir, `${deps.nowStampUtc()}-${changeId}.json`);
+    const truth = await deps.snapshotTruthFiles(gitRoot);
+    await deps.writeText(stampPath, JSON.stringify({
+        timestamp: deps.nowUnixSeconds(),
+        ws_root: gitRoot,
+        archived_to: dest,
+        truth_files: truth,
+        note: "aiws change archive stamp; does not contain secrets.",
+    }, null, 2) + "\n");
+    const archivedToRel = path.relative(gitRoot, dest);
+    const handoffRel = path.relative(gitRoot, handoffPath);
+    const metaRel = path.relative(gitRoot, metaPath);
+    const stampRel = path.relative(gitRoot, stampPath);
+    /** @type {string[]} */
+    const outputLines = [];
+    outputLines.push(`✓ aiws change archive: ${changeId}`);
+    outputLines.push(`archived_to: ${archivedToRel}`);
+    outputLines.push(`handoff: ${handoffRel}`);
+    if (metaUpdated)
+        outputLines.push(`meta_updated: ${metaRel}`);
+    outputLines.push(`stamp: ${stampRel}`);
+    return {
+        output: outputLines.join("\n") + "\n",
+        archivedTo: dest,
+        archivedToRel,
+        handoffPath,
+        handoffRel,
+        metaPath: metaUpdated ? metaPath : "",
+        metaRel: metaUpdated ? metaRel : "",
+        stampPath,
+        stampRel,
+    };
+}
+//# sourceMappingURL=change-lifecycle.js.map

package/dist/commands/change-lifecycle.js.map

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

package/dist/commands/change-metrics-command.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   sinceRaw: string,
+ *   since: number
+ * }} input
+ * @param {{
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   readText: (path: string) => Promise<string>
+ * }} deps
+ */
+export declare function renderMetricsSummaryOutput(input: any, deps: any): Promise<string>;

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

@@ -0,0 +1,110 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   sinceRaw: string,
+ *   since: number
+ * }} input
+ * @param {{
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   readText: (path: string) => Promise<string>
+ * }} deps
+ */
+export async function renderMetricsSummaryOutput(input, deps) {
+    const { gitRoot, sinceRaw, since } = input;
+    const changesRoot = path.join(gitRoot, ".aiws", "changes");
+    if (!(await deps.pathExists(changesRoot))) {
+        return "(no .aiws/changes dir)\n";
+    }
+    /** @type {Array<{ changeId: string, path: string, metrics: any }>} */
+    const all = [];
+    const scanDirs = [changesRoot, path.join(changesRoot, "archive")];
+    for (const base of scanDirs) {
+        if (!(await deps.pathExists(base)))
+            continue;
+        const entries = await fs.readdir(base, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const dir = path.join(base, entry.name);
+            const metricsAbs = path.join(dir, "metrics.json");
+            if (!(await deps.pathExists(metricsAbs)))
+                continue;
+            try {
+                const metrics = JSON.parse(await deps.readText(metricsAbs));
+                const changeId = String(metrics?.change_id || "").trim() || entry.name;
+                all.push({ changeId, path: path.relative(gitRoot, metricsAbs), metrics });
+            }
+            catch {
+                // ignore invalid
+            }
+        }
+    }
+    if (all.length === 0) {
+        return "(no metrics.json found)\n";
+    }
+    /** @type {Record<string, number>} */
+    const eventCounts = {};
+    let strictValidations = 0;
+    let strictPass = 0;
+    let evidenceRuns = 0;
+    let finishRuns = 0;
+    /** @type {number[]} */
+    const durations = [];
+    for (const row of all) {
+        const events = Array.isArray(row.metrics?.events) ? row.metrics.events : [];
+        const filtered = since
+            ? events.filter((event) => {
+                const timestamp = Date.parse(String(event?.timestamp || ""));
+                return Number.isFinite(timestamp) && timestamp >= since;
+            })
+            : events;
+        for (const event of filtered) {
+            const type = String(event?.type || "unknown");
+            eventCounts[type] = (eventCounts[type] || 0) + 1;
+            if (type === "validate") {
+                const payload = event?.payload || {};
+                if (payload.strict === true) {
+                    strictValidations += 1;
+                    if (payload.ok === true)
+                        strictPass += 1;
+                }
+            }
+            if (type === "evidence")
+                evidenceRuns += 1;
+            if (type === "finish" || type === "finish_done")
+                finishRuns += 1;
+        }
+        const startedAt = events.find((event) => event?.type === "change_new")?.timestamp;
+        const finishedAt = events.find((event) => event?.type === "finish_done")?.timestamp || events.find((event) => event?.type === "finish")?.timestamp;
+        if (startedAt && finishedAt) {
+            const startTime = Date.parse(String(startedAt));
+            const finishTime = Date.parse(String(finishedAt));
+            if (Number.isFinite(startTime) && Number.isFinite(finishTime) && finishTime >= startTime) {
+                durations.push(Math.floor((finishTime - startTime) / 1000));
+            }
+        }
+    }
+    const avgSec = durations.length > 0 ? Math.floor(durations.reduce((left, right) => left + right, 0) / durations.length) : 0;
+    const avgMin = avgSec ? Math.floor(avgSec / 60) : 0;
+    /** @type {string[]} */
+    const lines = [];
+    lines.push(`AIWS Metrics Summary${sinceRaw ? ` (since ${sinceRaw})` : ""}`);
+    lines.push("================================================");
+    lines.push(`Total metric files: ${all.length}`);
+    lines.push("");
+    lines.push("Event counts:");
+    for (const key of Object.keys(eventCounts).sort())
+        lines.push(`- ${key}: ${eventCounts[key]}`);
+    lines.push("");
+    lines.push("Quality:");
+    lines.push(`- Strict validate pass rate: ${strictValidations > 0 ? `${strictPass}/${strictValidations}` : "(no data)"}`);
+    lines.push(`- Evidence runs: ${evidenceRuns}`);
+    lines.push(`- Finish runs: ${finishRuns}`);
+    lines.push("");
+    lines.push("Cycle time (best-effort):");
+    lines.push(`- Avg change_new -> finish: ${durations.length > 0 ? `${avgMin} min` : "(no data)"}`);
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=change-metrics-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"change-metrics-command.js","sourceRoot":"","sources":["../../src/commands/change-metrics-command.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAAU,EAAE,IAAS;IACpE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED,sEAAsE;IACtE,MAAM,GAAG,GAAG,EAAE,CAAC;IACf,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAAE,SAAS;QAC7C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAClD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAAE,SAAS;YACnD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC;gBACvE,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,qCAAqC;IACrC,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,uBAAuB;IACvB,MAAM,SAAS,GAAG,EAAE,CAAC;IAErB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,KAAK;YACpB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE;gBAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC7D,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC;YAC1D,CAAC,CAAC;YACJ,CAAC,CAAC,MAAM,CAAC;QAEX,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC;YAC7C,WAAsC,CAAC,IAAI,CAAC,GAAG,CAAE,WAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzG,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;gBACrC,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC5B,iBAAiB,IAAI,CAAC,CAAC;oBACvB,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI;wBAAE,UAAU,IAAI,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YACD,IAAI,IAAI,KAAK,UAAU;gBAAE,YAAY,IAAI,CAAC,CAAC;YAC3C,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,aAAa;gBAAE,UAAU,IAAI,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,CAAC,EAAE,SAAS,CAAC;QACvF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,aAAa,CAAC,EAAE,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,EAAE,SAAS,CAAC;QAC7J,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBACzF,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5H,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,uBAAuB;IACvB,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAM,WAAsC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3H,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,gCAAgC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,iBAAiB,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACzH,KAAK,CAAC,IAAI,CAAC,oBAAoB,YAAY,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,kBAAkB,UAAU,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,+BAA+B,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAClG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC"}

package/dist/commands/change-next-command.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   changeDir: string,
+ *   status: any
+ * }} input
+ * @param {{
+ *   analyzeEvidencePaths: (gitRoot: string, changeId: string, evidencePaths: string[]) => Promise<any>,
+ *   computeChangeNextAdvice: (gitRoot: string, changeId: string) => Promise<any>,
+ *   extractId: (label: string, text: string) => string,
+ *   fileState: (changeDir: string, rel: string) => Promise<any>,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   planVerifyHint: (changeId: string) => string,
+ *   splitDeclaredValues: (value: string) => string[]
+ * }} deps
+ */
+export declare function renderChangeNextOutput(input: any, deps: any): Promise<string>;

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

@@ -0,0 +1,138 @@
+import path from "node:path";
+import { checkboxStats } from "./change-task-stats.js";
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   changeDir: string,
+ *   status: any
+ * }} input
+ * @param {{
+ *   analyzeEvidencePaths: (gitRoot: string, changeId: string, evidencePaths: string[]) => Promise<any>,
+ *   computeChangeNextAdvice: (gitRoot: string, changeId: string) => Promise<any>,
+ *   extractId: (label: string, text: string) => string,
+ *   fileState: (changeDir: string, rel: string) => Promise<any>,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   planVerifyHint: (changeId: string) => string,
+ *   splitDeclaredValues: (value: string) => string[]
+ * }} deps
+ */
+export async function renderChangeNextOutput(input, deps) {
+    const { gitRoot, changeId, changeDir, status } = input;
+    const proposal = await deps.fileState(changeDir, "proposal.md");
+    const tasks = await deps.fileState(changeDir, "tasks.md");
+    const design = await deps.fileState(changeDir, "design.md");
+    const advice = await deps.computeChangeNextAdvice(gitRoot, changeId);
+    const actionSet = new Set(advice.actions);
+    const pushAction = (line) => {
+        const value = String(line || "").trim();
+        if (!value || actionSet.has(value))
+            return;
+        actionSet.add(value);
+        advice.actions.push(value);
+    };
+    if (proposal.state !== "ok" || proposal.wsTodo > 0 || proposal.placeholders > 0) {
+        pushAction(`完善 proposal：\`$EDITOR ${path.join(changeDir, "proposal.md")}\``);
+    }
+    if (design.state === "ok" && (design.wsTodo > 0 || design.placeholders > 0)) {
+        pushAction(`(可选) 完善 design：\`$EDITOR ${path.join(changeDir, "design.md")}\``);
+    }
+    if (tasks.state !== "ok" || tasks.wsTodo > 0 || tasks.placeholders > 0) {
+        pushAction(`完善 tasks：\`$EDITOR ${path.join(changeDir, "tasks.md")}\``);
+    }
+    if (proposal.state === "ok") {
+        const reqId = deps.extractId("Req_ID", proposal.text);
+        const probId = deps.extractId("Problem_ID", proposal.text);
+        if (!(reqId || probId)) {
+            pushAction("补齐归因：在 proposal.md 填写非空 `Req_ID` 或 `Problem_ID`（严格校验需要）");
+        }
+        const contractRow = deps.extractId("Contract_Row", proposal.text) || deps.extractId("Contract_Row(s)", proposal.text);
+        if (!contractRow)
+            pushAction("补齐绑定：在 proposal.md 填写非空 `Contract_Row`（严格校验需要）");
+        const planFile = deps.extractId("Plan_File", proposal.text) || deps.extractId("Plan file", proposal.text);
+        const planFiles = deps.splitDeclaredValues(planFile);
+        if (planFiles.length !== 1) {
+            pushAction("补齐绑定：proposal.md `Plan_File` 必须且只能包含 1 个 plan 路径（严格校验需要）");
+        }
+        else {
+            const planRel = String(planFiles[0] || "").replace(/^\.\//, "");
+            if (path.isAbsolute(planRel)) {
+                pushAction("修正绑定：proposal.md `Plan_File` 必须是工作区相对路径（不要绝对路径）");
+            }
+            else if (!(await deps.pathExists(path.join(gitRoot, planRel)))) {
+                pushAction(`补齐计划文件：缺少 ${planRel}（或修正 proposal.md 的 Plan_File）`);
+            }
+        }
+        const evidenceDecl = deps.extractId("Evidence_Path", proposal.text) || deps.extractId("Evidence_Path(s)", proposal.text);
+        const evidencePaths = deps.splitDeclaredValues(evidenceDecl);
+        if (evidencePaths.length === 0) {
+            pushAction("补齐绑定：在 proposal.md 填写非空 `Evidence_Path`（严格校验需要；建议优先写 `.aiws/changes/<id>/evidence/...`）");
+        }
+        else {
+            const evidence = await deps.analyzeEvidencePaths(gitRoot, changeId, evidencePaths);
+            if (evidence.counts.persistent === 0) {
+                pushAction("交付前建议生成持久证据：`.aiws/changes/<id>/evidence/...`（并把路径回填到 Evidence_Path；`.aiws/tmp/...` 可作为原始证据引用）");
+            }
+            if (evidence.missing.length > 0) {
+                const show = evidence.missing.slice(0, 5);
+                pushAction(`补齐缺失证据文件（missing=${evidence.missing.length}）：${show.join(", ")}${evidence.missing.length > show.length ? ", ..." : ""}`);
+            }
+        }
+    }
+    const prog = tasks.state === "ok" ? checkboxStats(tasks.text) : { total: 0, done: 0, unchecked: 0, hasCheckboxes: false };
+    if (!prog.hasCheckboxes) {
+        pushAction("tasks.md 需要至少一条 checkbox 任务（`- [ ]` / `- [x]`）");
+    }
+    /** @type {string[]} */
+    const lines = [];
+    if (status.terminatedReuse) {
+        for (const action of advice.actions)
+            lines.push(`- ${action}`);
+        for (const recommendation of advice.recommended)
+            lines.push(`- ${recommendation}`);
+        for (const prohibition of advice.prohibitions)
+            lines.push(`- ${prohibition}`);
+        return lines.join("\n") + "\n";
+    }
+    if (advice.actions.length > 0) {
+        lines.push(`- ${deps.planVerifyHint(changeId)}`);
+        for (const action of advice.actions)
+            lines.push(`- ${action}`);
+        if (status.blockersStrict.length > 0) {
+            lines.push(`- 修复后复跑质量门：\`aiws change validate ${changeId} --strict\``);
+            lines.push("- 质量门通过后再进入编码：simple/local 单点修复优先 `$ws-dev-lite`；否则 `$ws-dev`");
+        }
+        else if (status.tasks.unchecked > 0) {
+            lines.push(`- 处理完上述事项后复跑质量门：\`aiws change validate ${changeId} --strict\``);
+            lines.push("- 质量门通过后继续开发：simple/local 单点修复优先 `$ws-dev-lite`；否则 `$ws-dev`");
+        }
+        else {
+            for (const recommendation of advice.recommended)
+                lines.push(`- ${recommendation}`);
+        }
+        return lines.join("\n") + "\n";
+    }
+    lines.push(`- ${deps.planVerifyHint(changeId)}`);
+    if (prog.unchecked > 0) {
+        lines.push("- 若仍需继续编码，先通过质量门；simple/local 单点修复优先 `$ws-dev-lite`，否则 `$ws-dev`");
+    }
+    else {
+        for (const recommendation of advice.recommended)
+            lines.push(`- ${recommendation}`);
+    }
+    if (Number(status?.reviewSignals?.effectiveCount || 0) === 0) {
+        lines.push("- 审计与证据（推荐）：在 AI 工具内运行 `/ws-review`（或按 AI_PROJECT.md 手工审计）");
+    }
+    else if (Number(status?.reviewGates?.summary?.dualReviewMissingCount || 0) > 0) {
+        lines.push("- 已有通用 review，但 dual review gate 未齐：继续补 `$ws-spec-review` / `$ws-quality-review`，不要把 `codex-review.md` 当成 finish gate");
+    }
+    const recommendedStage = String(status.governance?.recommendedStage || "");
+    if (recommendedStage === "ws-finish") {
+        lines.push(`- 收尾：\`aiws change finish ${changeId} --push\`（成功后会自动归档并生成 handoff）`);
+    }
+    else if (recommendedStage === "ws-handoff") {
+        lines.push("- 交接：运行 `$ws-handoff` 检查归档 handoff；当前已无额外 finish 工作，无需重复执行 `aiws change finish`");
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=change-next-command.js.map

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

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

package/dist/commands/change-review-gates.d.ts

@@ -0,0 +1,107 @@
+export declare const TMP_REVIEW_FALLBACKS: {
+    fileName: string;
+    persistentKind: string;
+}[];
+/**
+ * @param {string} gitRoot
+ * @param {string} fileName
+ */
+export declare function tmpReviewFallbackPath(gitRoot: string, fileName: string): string;
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{ branchMatchesChange?: boolean }} [context]
+ * @param {{ counts?: { review?: number } }} [collaboration]
+ */
+export declare function collectReviewSignals(gitRoot: string, changeId: string, context: any, collaboration: any): Promise<{
+    persistentCount: number;
+    tmpFallbackExists: boolean;
+    tmpFallbackCount: number;
+    tmpFallbackPath: string;
+    tmpFallbackPaths: string[];
+    effectiveCount: number;
+    source: string;
+}>;
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{ branchMatchesChange?: boolean }} [context]
+ */
+export declare function collectReviewGates(gitRoot: string, changeId: string, context: any): Promise<{
+    source: any;
+    specVersion: any;
+    version: any;
+    gates: {
+        id: any;
+        name: any;
+        stage: any;
+        focus: any;
+        next: any;
+        ready: boolean;
+        status: string;
+        primaryPath: string;
+        fallbackPath: string;
+        foundPath: string;
+    }[];
+    specReview: {
+        id: any;
+        name: any;
+        stage: any;
+        focus: any;
+        next: any;
+        ready: boolean;
+        status: string;
+        primaryPath: string;
+        fallbackPath: string;
+        foundPath: string;
+    } | null;
+    qualityReview: {
+        id: any;
+        name: any;
+        stage: any;
+        focus: any;
+        next: any;
+        ready: boolean;
+        status: string;
+        primaryPath: string;
+        fallbackPath: string;
+        foundPath: string;
+    } | null;
+    verifyBeforeComplete: {
+        id: any;
+        name: any;
+        stage: any;
+        focus: any;
+        next: any;
+        ready: boolean;
+        status: string;
+        primaryPath: string;
+        fallbackPath: string;
+        foundPath: string;
+    } | null;
+    validateStamp: {
+        id: string;
+        name: string;
+        ready: boolean;
+        status: string;
+        dir: string;
+        foundPath: string;
+    };
+    summary: {
+        gateCount: number;
+        gateReadyCount: number;
+        genericReviewOnly: boolean;
+        dualReviewPending: boolean;
+        dualReviewReady: boolean;
+        dualReviewMissingIds: any[];
+        dualReviewMissingCount: number;
+        finishGateReady: boolean;
+        finishGateMissingIds: string[];
+        finishGateMissingCount: number;
+    };
+}>;
+/**
+ * @param {string} changeId
+ * @param {any} reviewGates
+ */
+export declare function collectFinishGateErrors(changeId: string, reviewGates: any): string[];