@aipper/aiws 0.0.29 → 0.0.30

package/dist/commands/change-review-gates.js

@@ -0,0 +1,329 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { pathExists } from "../fs.js";
+import { loadWorkflowReviewGates } from "../spec.js";
+export const TMP_REVIEW_FALLBACKS = [
+    { fileName: "codex-review.md", persistentKind: "review" },
+    { fileName: "spec-review.md", persistentKind: "review" },
+    { fileName: "quality-review.md", persistentKind: "review" },
+    { fileName: "verify-before-complete.md", persistentKind: "evidence" },
+];
+/**
+ * @param {string} input
+ */
+function normalizeSlashes(input) {
+    return String(input || "").replaceAll("\\", "/");
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} absPath
+ */
+function relFromRoot(gitRoot, absPath) {
+    return normalizeSlashes(path.relative(gitRoot, absPath));
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} fileName
+ */
+export function tmpReviewFallbackPath(gitRoot, fileName) {
+    return path.join(gitRoot, ".aiws", "tmp", "review", fileName);
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {string} fileName
+ */
+function persistentReviewPath(gitRoot, changeId, fileName) {
+    return path.join(gitRoot, ".aiws", "changes", changeId, "review", fileName);
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {string} fileName
+ */
+function persistentEvidencePath(gitRoot, changeId, fileName) {
+    return path.join(gitRoot, ".aiws", "changes", changeId, "evidence", fileName);
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ */
+async function hasGenericReviewSignal(gitRoot, changeId) {
+    const persistentCodexReview = persistentReviewPath(gitRoot, changeId, "codex-review.md");
+    if (await pathExists(persistentCodexReview))
+        return true;
+    const tmpCodexReview = tmpReviewFallbackPath(gitRoot, "codex-review.md");
+    return await pathExists(tmpCodexReview);
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {string} gateId
+ */
+function reviewGateArtifactPaths(gitRoot, changeId, gateId) {
+    switch (gateId) {
+        case "spec_review":
+            return {
+                primaryAbs: persistentReviewPath(gitRoot, changeId, "spec-review.md"),
+                fallbackAbs: tmpReviewFallbackPath(gitRoot, "spec-review.md"),
+            };
+        case "quality_review":
+            return {
+                primaryAbs: persistentReviewPath(gitRoot, changeId, "quality-review.md"),
+                fallbackAbs: tmpReviewFallbackPath(gitRoot, "quality-review.md"),
+            };
+        case "verify_before_complete":
+            return {
+                primaryAbs: persistentEvidencePath(gitRoot, changeId, "verify-before-complete.md"),
+                fallbackAbs: tmpReviewFallbackPath(gitRoot, "verify-before-complete.md"),
+            };
+        default:
+            return null;
+    }
+}
+/**
+ * @param {string} absDir
+ * @param {(fileName: string) => boolean} predicate
+ */
+async function findLatestFileByMtime(absDir, predicate) {
+    /** @type {Array<{ abs: string, mtimeMs: number }>} */
+    const matches = [];
+    if (!(await pathExists(absDir)))
+        return "";
+    try {
+        const entries = await fs.readdir(absDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            if (!predicate(entry.name))
+                continue;
+            const abs = path.join(absDir, entry.name);
+            const st = await fs.stat(abs);
+            matches.push({ abs, mtimeMs: st.mtimeMs });
+        }
+    }
+    catch {
+        return "";
+    }
+    matches.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return matches[0]?.abs || "";
+}
+/**
+ * @param {string} gitRoot
+ */
+async function listActiveChangeIds(gitRoot) {
+    const changesRoot = path.join(gitRoot, ".aiws", "changes");
+    try {
+        const entries = await fs.readdir(changesRoot, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .filter((name) => name && !name.startsWith(".") && name !== "archive" && name !== "templates")
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{ branchMatchesChange?: boolean }} [context]
+ */
+async function canAttributeTmpReviewFallback(gitRoot, changeId, context) {
+    if (context?.branchMatchesChange === true)
+        return true;
+    const activeChangeIds = await listActiveChangeIds(gitRoot);
+    return activeChangeIds.length === 1 && activeChangeIds[0] === changeId;
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{ branchMatchesChange?: boolean }} [context]
+ * @param {{ counts?: { review?: number } }} [collaboration]
+ */
+export async function collectReviewSignals(gitRoot, changeId, context, collaboration) {
+    const persistentCount = Number(collaboration?.counts?.review || 0);
+    const tmpFallbackPaths = [];
+    const canAttributeTmpFallback = await canAttributeTmpReviewFallback(gitRoot, changeId, context);
+    for (const { fileName, persistentKind } of TMP_REVIEW_FALLBACKS) {
+        if (persistentKind !== "review")
+            continue;
+        const tmpReviewPath = tmpReviewFallbackPath(gitRoot, fileName);
+        if (!(await pathExists(tmpReviewPath)))
+            continue;
+        const persistentPath = persistentReviewPath(gitRoot, changeId, fileName);
+        if (await pathExists(persistentPath))
+            continue;
+        if (!canAttributeTmpFallback)
+            continue;
+        tmpFallbackPaths.push(relFromRoot(gitRoot, tmpReviewPath));
+    }
+    const tmpFallbackExists = tmpFallbackPaths.length > 0;
+    const effectiveCount = persistentCount + tmpFallbackPaths.length;
+    let source = "none";
+    if (persistentCount > 0 && tmpFallbackExists)
+        source = "persistent+tmp_fallback";
+    else if (persistentCount > 0)
+        source = "persistent";
+    else if (tmpFallbackExists)
+        source = "tmp_fallback";
+    return {
+        persistentCount,
+        tmpFallbackExists,
+        tmpFallbackCount: tmpFallbackPaths.length,
+        tmpFallbackPath: tmpFallbackPaths[0] || "",
+        tmpFallbackPaths,
+        effectiveCount,
+        source,
+    };
+}
+/**
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {{ branchMatchesChange?: boolean }} [context]
+ */
+export async function collectReviewGates(gitRoot, changeId, context) {
+    const spec = await loadWorkflowReviewGates();
+    const canAttributeTmpFallback = await canAttributeTmpReviewFallback(gitRoot, changeId, context);
+    const genericReviewSignal = canAttributeTmpFallback ? await hasGenericReviewSignal(gitRoot, changeId) : await pathExists(persistentReviewPath(gitRoot, changeId, "codex-review.md"));
+    /** @type {Array<any>} */
+    const gates = [];
+    for (const gate of spec.gates) {
+        const paths = reviewGateArtifactPaths(gitRoot, changeId, gate.id);
+        if (!paths)
+            continue;
+        const primaryExists = await pathExists(paths.primaryAbs);
+        const fallbackExists = await pathExists(paths.fallbackAbs);
+        const primaryPath = relFromRoot(gitRoot, paths.primaryAbs);
+        const fallbackPath = relFromRoot(gitRoot, paths.fallbackAbs);
+        let ready = false;
+        let status = "missing";
+        let foundPath = "";
+        if (primaryExists) {
+            ready = true;
+            status = "persistent";
+            foundPath = primaryPath;
+        }
+        else if (fallbackExists && canAttributeTmpFallback) {
+            ready = true;
+            status = "tmp_fallback";
+            foundPath = fallbackPath;
+        }
+        else if (fallbackExists) {
+            ready = false;
+            status = "tmp_unattributed";
+            foundPath = fallbackPath;
+        }
+        gates.push({
+            id: gate.id,
+            name: gate.name,
+            stage: gate.stage,
+            focus: gate.focus,
+            next: gate.next,
+            ready,
+            status,
+            primaryPath,
+            fallbackPath,
+            foundPath,
+        });
+    }
+    const specReview = gates.find((gate) => gate.id === "spec_review") || null;
+    const qualityReview = gates.find((gate) => gate.id === "quality_review") || null;
+    const verifyBeforeComplete = gates.find((gate) => gate.id === "verify_before_complete") || null;
+    const validateStampDir = path.join(gitRoot, ".aiws", "tmp", "aiws-validate");
+    const latestValidateStamp = await findLatestFileByMtime(validateStampDir, (name) => name.endsWith(".json"));
+    const validateStamp = {
+        id: "validate_stamp",
+        name: "validate-stamp",
+        ready: Boolean(latestValidateStamp),
+        status: latestValidateStamp ? "latest" : "missing",
+        dir: relFromRoot(gitRoot, validateStampDir),
+        foundPath: latestValidateStamp ? relFromRoot(gitRoot, latestValidateStamp) : "",
+    };
+    const dualReviewMissingIds = [specReview, qualityReview].filter((gate) => !(gate && gate.ready)).map((gate) => gate?.id || "");
+    const finishGateMissingIds = [];
+    if (!specReview?.ready)
+        finishGateMissingIds.push("spec_review");
+    if (!qualityReview?.ready)
+        finishGateMissingIds.push("quality_review");
+    if (!validateStamp.ready)
+        finishGateMissingIds.push("validate_stamp");
+    if (!verifyBeforeComplete?.ready)
+        finishGateMissingIds.push("verify_before_complete");
+    const genericReviewOnly = genericReviewSignal && dualReviewMissingIds.length === 2;
+    const dualReviewPending = dualReviewMissingIds.length > 0;
+    return {
+        source: spec.source,
+        specVersion: spec.specVersion,
+        version: spec.version,
+        gates,
+        specReview,
+        qualityReview,
+        verifyBeforeComplete,
+        validateStamp,
+        summary: {
+            gateCount: gates.length,
+            gateReadyCount: gates.filter((gate) => gate.ready).length,
+            genericReviewOnly,
+            dualReviewPending,
+            dualReviewReady: dualReviewMissingIds.length === 0,
+            dualReviewMissingIds,
+            dualReviewMissingCount: dualReviewMissingIds.length,
+            finishGateReady: finishGateMissingIds.length === 0,
+            finishGateMissingIds,
+            finishGateMissingCount: finishGateMissingIds.length,
+        },
+    };
+}
+/**
+ * @param {string} changeId
+ * @param {any} reviewGates
+ */
+export function collectFinishGateErrors(changeId, reviewGates) {
+    const summary = reviewGates?.summary && typeof reviewGates.summary === "object" ? reviewGates.summary : {};
+    const missingIds = Array.isArray(summary.finishGateMissingIds) ? summary.finishGateMissingIds : [];
+    if (missingIds.length === 0)
+        return [];
+    /** @type {string[]} */
+    const errors = [];
+    for (const missingId of missingIds) {
+        if (missingId === "spec_review") {
+            const gate = reviewGates?.specReview || {};
+            if (gate.status === "tmp_unattributed") {
+                errors.push(`finish gate has unattributed tmp spec review (persist it to .aiws/changes/${changeId}/review/spec-review.md or rerun in the owning change context)`);
+            }
+            else {
+                errors.push(`finish gate missing spec review (run \`$ws-spec-review\` or write .aiws/changes/${changeId}/review/spec-review.md)`);
+            }
+            continue;
+        }
+        if (missingId === "quality_review") {
+            const gate = reviewGates?.qualityReview || {};
+            if (gate.status === "tmp_unattributed") {
+                errors.push(`finish gate has unattributed tmp quality review (persist it to .aiws/changes/${changeId}/review/quality-review.md or rerun in the owning change context)`);
+            }
+            else {
+                errors.push(`finish gate missing quality review (run \`$ws-quality-review\` or write .aiws/changes/${changeId}/review/quality-review.md)`);
+            }
+            continue;
+        }
+        if (missingId === "validate_stamp") {
+            errors.push("finish gate missing validate stamp (run `aiws validate . --stamp`)");
+            continue;
+        }
+        if (missingId === "verify_before_complete") {
+            const gate = reviewGates?.verifyBeforeComplete || {};
+            if (gate.status === "tmp_unattributed") {
+                errors.push(`finish gate has unattributed tmp verify-before-complete evidence (persist it to .aiws/changes/${changeId}/evidence/verify-before-complete.md or rerun in the owning change context)`);
+            }
+            else {
+                errors.push(`finish gate missing verify-before-complete evidence (run \`$ws-verify-before-complete\` or write .aiws/changes/${changeId}/evidence/verify-before-complete.md)`);
+            }
+            continue;
+        }
+        errors.push(`finish gate missing required artifact: ${missingId}`);
+    }
+    return errors;
+}
+//# sourceMappingURL=change-review-gates.js.map

package/dist/commands/change-review-gates.js.map

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

package/dist/commands/change-scope-gate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @param {any} lifecycle
+ */
+export declare function computeScopeGate(lifecycle: any): {
+    checked: boolean;
+    ready: boolean;
+    status: string;
+    source: string;
+    lastRunAt: string;
+    errors: number;
+    warnings: number;
+};
+/**
+ * @param {string} changeId
+ */
+export declare function scopeGateFailureAction(changeId: string): string;
+/**
+ * @param {string} changeId
+ */
+export declare function scopeGatePendingRecommendation(changeId: string): string;
+export declare function scopeGatePassedRecommendation(): string;

package/dist/commands/change-scope-gate.js

@@ -0,0 +1,32 @@
+/**
+ * @param {any} lifecycle
+ */
+export function computeScopeGate(lifecycle) {
+    const runs = Number(lifecycle?.strictScopeValidateRuns || 0);
+    const pass = lifecycle?.strictScopeValidatePass === true;
+    return {
+        checked: runs > 0,
+        ready: runs > 0 && pass,
+        status: runs === 0 ? "not_run" : pass ? "passed" : "failed",
+        source: runs > 0 ? "metrics.validate.check_scope" : "",
+        lastRunAt: String(lifecycle?.strictScopeValidateAt || ""),
+        errors: Number(lifecycle?.strictScopeValidateErrors || 0),
+        warnings: Number(lifecycle?.strictScopeValidateWarnings || 0),
+    };
+}
+/**
+ * @param {string} changeId
+ */
+export function scopeGateFailureAction(changeId) {
+    return `scope gate 未通过：更新 plan 的 \`## Scope\` / \`### In Scope\` 或收敛改动后复跑 \`aiws change validate ${changeId} --strict --check-scope\``;
+}
+/**
+ * @param {string} changeId
+ */
+export function scopeGatePendingRecommendation(changeId) {
+    return `范围门禁：\`aiws change validate ${changeId} --strict --check-scope\``;
+}
+export function scopeGatePassedRecommendation() {
+    return "范围门禁：最近一次 `--check-scope` 已通过";
+}
+//# sourceMappingURL=change-scope-gate.js.map

package/dist/commands/change-scope-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-scope-gate.js","sourceRoot":"","sources":["../../src/commands/change-scope-gate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAc;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,uBAAuB,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,SAAS,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACzD,OAAO;QACL,OAAO,EAAE,IAAI,GAAG,CAAC;QACjB,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,IAAI;QACvB,MAAM,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QAC3D,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE;QACtD,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,qBAAqB,IAAI,EAAE,CAAC;QACzD,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,yBAAyB,IAAI,CAAC,CAAC;QACzD,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,2BAA2B,IAAI,CAAC,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,OAAO,4FAA4F,QAAQ,2BAA2B,CAAC;AACzI,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,QAAgB;IAC7D,OAAO,+BAA+B,QAAQ,2BAA2B,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,+BAA+B,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * @param {string} changeDir
+ * @param {string} baseBranch
+ * @param {string} changeBranch
+ * @param {{
+ *   nowIsoUtc: () => string,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   readText: (path: string) => Promise<string>,
+ *   writeText: (path: string, content: string) => Promise<void>
+ * }} deps
+ */
+export declare function maybeRecordBaseBranch(changeDir: string, baseBranch: string, changeBranch: string, deps: any): Promise<void>;
+/**
+ * @param {string} gitRoot
+ * @param {{ branch: string, hasBranch: boolean, hasGitmodules: boolean }} options
+ * @param {{
+ *   runCommand: typeof import("../exec.js").runCommand,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export declare function switchOrCreateStartBranch(gitRoot: string, options: any, deps: any): Promise<void>;
+/**
+ * @param {string} gitRoot
+ * @param {{ branch: string, hasBranch: boolean, headReady: boolean }} options
+ * @param {{
+ *   runCommand: typeof import("../exec.js").runCommand,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export declare function prepareNoSwitchBranch(gitRoot: string, options: any, deps: any): Promise<boolean>;

package/dist/commands/change-start.js

@@ -0,0 +1,91 @@
+import path from "node:path";
+/**
+ * @param {string} changeDir
+ * @param {string} baseBranch
+ * @param {string} changeBranch
+ * @param {{
+ *   nowIsoUtc: () => string,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   readText: (path: string) => Promise<string>,
+ *   writeText: (path: string, content: string) => Promise<void>
+ * }} deps
+ */
+export async function maybeRecordBaseBranch(changeDir, baseBranch, changeBranch, deps) {
+    const base = String(baseBranch || "").trim();
+    if (!base)
+        return;
+    if (base === String(changeBranch || "").trim())
+        return;
+    const metaPath = path.join(changeDir, ".ws-change.json");
+    if (!(await deps.pathExists(metaPath)))
+        return;
+    /** @type {any} */
+    let meta = null;
+    try {
+        meta = JSON.parse(await deps.readText(metaPath));
+    }
+    catch {
+        meta = null;
+    }
+    if (!meta || typeof meta !== "object")
+        return;
+    const current = String(meta.base_branch || "").trim();
+    if (current)
+        return;
+    meta.base_branch = base;
+    meta.base_branch_set_at = deps.nowIsoUtc();
+    await deps.writeText(metaPath, JSON.stringify(meta, null, 2) + "\n");
+}
+/**
+ * @param {string} gitRoot
+ * @param {{ branch: string, hasBranch: boolean, hasGitmodules: boolean }} options
+ * @param {{
+ *   runCommand: typeof import("../exec.js").runCommand,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export async function switchOrCreateStartBranch(gitRoot, options, deps) {
+    if (options.hasBranch) {
+        if (options.hasGitmodules) {
+            console.error("warn: .gitmodules detected; switching only the superproject branch (submodules stay on their current/pin branches).");
+        }
+        let sw = await deps.runCommand("git", ["switch", options.branch], { cwd: gitRoot });
+        if (sw.code === 0)
+            return;
+        let co = await deps.runCommand("git", ["checkout", options.branch], { cwd: gitRoot });
+        if (co.code !== 0)
+            throw new deps.UserError("Failed to switch branch.", { details: co.stderr || co.stdout });
+        return;
+    }
+    if (options.hasGitmodules) {
+        console.error("warn: .gitmodules detected; creating and switching only the superproject branch (submodules stay on their current/pin branches).");
+    }
+    let sw = await deps.runCommand("git", ["switch", "-c", options.branch], { cwd: gitRoot });
+    if (sw.code === 0)
+        return;
+    let co = await deps.runCommand("git", ["checkout", "-b", options.branch], { cwd: gitRoot });
+    if (co.code !== 0)
+        throw new deps.UserError("Failed to create branch.", { details: co.stderr || co.stdout });
+}
+/**
+ * @param {string} gitRoot
+ * @param {{ branch: string, hasBranch: boolean, headReady: boolean }} options
+ * @param {{
+ *   runCommand: typeof import("../exec.js").runCommand,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export async function prepareNoSwitchBranch(gitRoot, options, deps) {
+    if (options.hasBranch)
+        return true;
+    if (!options.headReady) {
+        console.error(`warn: repo has no commits; cannot create branch "${options.branch}" without switching (skipped)`);
+        return false;
+    }
+    const branchResult = await deps.runCommand("git", ["branch", options.branch], { cwd: gitRoot });
+    if (branchResult.code !== 0) {
+        throw new deps.UserError("Failed to create branch.", { details: branchResult.stderr || branchResult.stdout });
+    }
+    return true;
+}
+//# sourceMappingURL=change-start.js.map

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

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

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

@@ -0,0 +1,3 @@
+export declare function runChangeStateCommand(input: any, deps: any): Promise<{
+    output: any;
+}>;

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

@@ -0,0 +1,32 @@
+import path from "node:path";
+import { readJournalEvents } from "../journal.js";
+export async function runChangeStateCommand(input, deps) {
+    const { gitRoot, changeId, options } = input;
+    const status = await deps.computeChangeStatus(gitRoot, changeId);
+    const advice = await deps.computeChangeNextAdvice(gitRoot, changeId);
+    const journal = await readJournalEvents(gitRoot, changeId);
+    if (journal.phase) {
+        status.phase = journal.phase;
+    }
+    const journalInfo = {
+        phase: journal.phase,
+        events: journal.events.length,
+    };
+    const output = deps.renderChangeStateMarkdown({
+        changeId,
+        gitRoot,
+        now: deps.nowIsoUtc(),
+        status,
+        advice,
+        journalInfo,
+        planVerifyLine: deps.planVerifyHint(changeId),
+    });
+    const dest = path.join(deps.changeDirAbs(gitRoot, changeId), "STATE.md");
+    if (options.write === true) {
+        await deps.writeText(dest, output);
+        await deps.appendMetricsEvent(gitRoot, changeId, "state_written", { path: path.relative(gitRoot, dest) });
+        return { output: `ok: state written: ${path.relative(gitRoot, dest)}\n` };
+    }
+    return { output };
+}
+//# sourceMappingURL=change-state-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"change-state-command.js","sourceRoot":"","sources":["../../src/commands/change-state-command.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAU,EAAE,IAAS;IAC/D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAErE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/B,CAAC;IACD,MAAM,WAAW,GAAG;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;KAC9B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,yBAAyB,CAAC;QAC5C,QAAQ;QACR,OAAO;QACP,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE;QACrB,MAAM;QACN,MAAM;QACN,WAAW;QACX,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;KAC9C,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1G,OAAO,EAAE,MAAM,EAAE,sBAAsB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   branch: string,
+ *   status: any
+ * }} input
+ * @param {{
+ *   effectiveReviewCount: (status: any) => number,
+ *   governanceGuidanceLines: (status: any) => Promise<string[]>,
+ *   planVerifyHint: (changeId: string) => string
+ * }} deps
+ */
+export declare function renderChangeStatusOutput(input: any, deps: any): Promise<string>;