@cleocode/core 2026.9.21 → 2026.9.23

package/dist/tasks/component-pr.js

@@ -0,0 +1,275 @@
+/**
+ * Component PRs landed by an integration PR (T12671, T12672).
+ *
+ * A task's own PR (the COMPONENT) often merges into an integration branch,
+ * whose PR (the INTEGRATION PR) then lands on the default branch. The
+ * integration PR carries the merge commit on the default branch and the CI
+ * that ran; the component PR carries the task linkage and the task's change.
+ * `pr:<component>@<integration>` and `ci:<component>@<integration>` record
+ * both, and this module is the one place that verifies the relationship and
+ * derives the component's files:
+ *
+ *  - the component PR merged into the integration PR's head branch;
+ *  - its merge commit is an ancestor of the integration PR's final head, so
+ *    the integration PR carried it;
+ *  - its files are the ones its merge commit changed that still exist in the
+ *    integration PR's merge commit — never the whole integration diff.
+ *
+ * @task T12671
+ * @task T12672
+ */
+import { execFileSync } from 'node:child_process';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ghQueryTimeoutMs } from '../release/github-pr.js';
+function git(root, args) {
+    try {
+        return execFileSync('git', args, {
+            cwd: root,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function hasCommit(root, sha) {
+    return (typeof sha === 'string' &&
+        sha !== '' &&
+        git(root, ['cat-file', '-e', `${sha}^{commit}`]) !== null);
+}
+/** Default {@link ViewComponentPr}: `gh pr view <n>`. */
+export const defaultViewComponentPr = async (prNumber, root) => {
+    let row;
+    try {
+        row = JSON.parse(execFileSync('gh', [
+            'pr',
+            'view',
+            String(prNumber),
+            '--json',
+            'number,title,body,headRefName,baseRefName,state,mergeCommit',
+        ], {
+            cwd: root,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: ghQueryTimeoutMs(),
+        }));
+    }
+    catch {
+        return null;
+    }
+    if (typeof row.number !== 'number')
+        return null;
+    const str = (v) => (typeof v === 'string' ? v : '');
+    const merge = row.mergeCommit;
+    return {
+        number: row.number,
+        title: str(row.title),
+        body: str(row.body),
+        headRefName: str(row.headRefName),
+        baseRefName: str(row.baseRefName),
+        state: str(row.state),
+        mergeCommitSha: typeof merge?.oid === 'string' ? merge.oid : null,
+    };
+};
+/**
+ * The component's change as it landed: first-parent name-status of its merge
+ * (or squash) commit, keeping only the changes the landing merge commit still
+ * carries (T12671 review HIGH) — a changed file whose blob in the landing
+ * commit equals the component's resulting blob, and a deletion whose path is
+ * absent from the landing commit. A path that merely exists is not enough: a
+ * component reverted on the integration branch lands its paths unchanged.
+ *
+ * Limitation: a REBASE-merged component's `mergeCommit` is only the last
+ * rebased commit, so earlier commits' files are not seen. That under-reports
+ * the change and fails closed (fewer surviving files, possibly a refusal);
+ * GitHub does not report the merge method needed to diff the whole range.
+ *
+ * @param root - Git checkout holding both commits.
+ * @param componentMerge - The component PR's merge commit.
+ * @param landingMerge - The integration PR's merge commit.
+ * @returns Surviving changed files and the component's deletions.
+ * @task T12672
+ */
+export function componentLandedChanges(root, componentMerge, landingMerge) {
+    const out = git(root, [
+        'diff-tree',
+        '--root',
+        '--no-commit-id',
+        '-r',
+        '--name-status',
+        '--no-renames',
+        '-m',
+        '--first-parent',
+        componentMerge,
+    ]) ?? '';
+    const files = [];
+    const deleted = [];
+    const blob = (commit, path) => git(root, ['rev-parse', '--verify', '--quiet', `${commit}:${path}`]);
+    const stillApplies = hunkChecker(root, componentMerge, landingMerge);
+    try {
+        for (const line of out.split('\n')) {
+            const [status, ...rest] = line.split('\t');
+            const path = rest.join('\t');
+            if (!status || !path)
+                continue;
+            if (status.startsWith('D')) {
+                if (blob(landingMerge, path) === null)
+                    deleted.push(path);
+                continue;
+            }
+            const own = blob(componentMerge, path);
+            const landed = blob(landingMerge, path);
+            // Identical bytes, or (T12689) a file a later change also edited whose
+            // own hunks the landing version still carries.
+            if (own !== null && landed !== null && (own === landed || stillApplies(path)))
+                files.push(path);
+        }
+    }
+    finally {
+        stillApplies.dispose();
+    }
+    return { files: [...new Set(files)], deleted: [...new Set(deleted)] };
+}
+/**
+ * Whether the component's hunks for one path are still present in the
+ * landing commit: its first-parent patch reverse-applies cleanly to the
+ * landing tree (checked in a throwaway index, never the working tree). A
+ * revert fails this; a later edit elsewhere in the file does not (T12689).
+ */
+function hunkChecker(root, componentMerge, landingMerge) {
+    let dir = null;
+    let env = null;
+    let failed = false;
+    const ready = () => {
+        if (env || failed)
+            return env;
+        dir = mkdtempSync(join(tmpdir(), 'cleo-component-index-'));
+        const candidate = { ...process.env, GIT_INDEX_FILE: join(dir, 'index') };
+        try {
+            execFileSync('git', ['read-tree', landingMerge], {
+                cwd: root,
+                env: candidate,
+                stdio: ['ignore', 'ignore', 'ignore'],
+            });
+            env = candidate;
+        }
+        catch {
+            // No index, no credit — and no retry leaving another temp dir behind.
+            failed = true;
+            rmSync(dir, { recursive: true, force: true });
+            dir = null;
+        }
+        return env;
+    };
+    const applies = (patch, indexEnv, reverse) => {
+        try {
+            execFileSync('git', ['apply', '--cached', '--check', ...(reverse ? ['-R'] : [])], {
+                cwd: root,
+                env: indexEnv,
+                input: `${patch}\n`,
+                stdio: ['pipe', 'ignore', 'ignore'],
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const check = (path) => {
+        const patch = git(root, [
+            'diff',
+            '--binary',
+            '--no-renames',
+            '--no-color',
+            `${componentMerge}^1`,
+            componentMerge,
+            '--',
+            path,
+        ]);
+        const indexEnv = patch ? ready() : null;
+        if (!patch || !indexEnv)
+            return false;
+        // `git apply` finds a hunk at ANY offset (T12689 review MED): the reverse
+        // patch can match an identical block elsewhere while the component's own
+        // lines were reverted. So the change must also NOT be re-applicable — a
+        // reverted change is, at its original spot. When both could match the
+        // file is not credited (fails closed).
+        return applies(patch, indexEnv, true) && !applies(patch, indexEnv, false);
+    };
+    return Object.assign(check, {
+        dispose: () => {
+            if (dir)
+                rmSync(dir, { recursive: true, force: true });
+        },
+    });
+}
+/**
+ * Verify that `componentPrNumber` is a component the integration PR landed,
+ * and derive its landed files.
+ *
+ * @param componentPrNumber - The task's own (component) PR.
+ * @param landing - The integration PR that reached the default branch.
+ * @param root - Git checkout (the execution root).
+ * @param view - PR reader (tests inject).
+ * @returns The component's linkage fields and files, or the refusal.
+ * @task T12671
+ */
+export async function resolveComponentPr(componentPrNumber, landing, root, view = defaultViewComponentPr) {
+    const c = await view(componentPrNumber, root);
+    if (!c) {
+        return {
+            ok: false,
+            codeName: 'E_EVIDENCE_TOOL_FAILED',
+            reason: `gh pr view ${componentPrNumber} failed; component PR #${componentPrNumber} cannot be verified.`,
+        };
+    }
+    if (c.state !== 'MERGED') {
+        return {
+            ok: false,
+            codeName: 'E_EVIDENCE_INSUFFICIENT',
+            reason: `Component PR #${componentPrNumber} is ${c.state.toLowerCase() || 'not merged'}.`,
+        };
+    }
+    if (c.baseRefName !== landing.headRefName) {
+        return {
+            ok: false,
+            codeName: 'E_EVIDENCE_CONTENT_MISMATCH',
+            reason: `Component PR #${componentPrNumber} merged into ${c.baseRefName || 'an unknown branch'}, not ${landing.headRefName}, the head of PR #${landing.prNumber}.`,
+        };
+    }
+    if (!hasCommit(root, c.mergeCommitSha) || !hasCommit(root, landing.headRefOid)) {
+        return {
+            ok: false,
+            codeName: 'E_EVIDENCE_INSUFFICIENT',
+            reason: `PR #${componentPrNumber}'s merge commit or PR #${landing.prNumber}'s head is not available locally in ${root} (git fetch origin).`,
+        };
+    }
+    if (git(root, ['merge-base', '--is-ancestor', c.mergeCommitSha, landing.headRefOid]) === null) {
+        return {
+            ok: false,
+            codeName: 'E_EVIDENCE_CONTENT_MISMATCH',
+            reason: `PR #${landing.prNumber}'s head does not contain component PR #${componentPrNumber}'s merge ${c.mergeCommitSha.slice(0, 12)}.`,
+        };
+    }
+    const { files, deleted } = componentLandedChanges(root, c.mergeCommitSha, landing.mergeCommitSha);
+    if (files.length === 0 && deleted.length === 0) {
+        return {
+            ok: false,
+            codeName: 'E_EVIDENCE_CONTENT_MISMATCH',
+            reason: `None of component PR #${componentPrNumber}'s changes survive in PR #${landing.prNumber}'s merge commit.`,
+        };
+    }
+    return {
+        ok: true,
+        prNumber: componentPrNumber,
+        title: c.title,
+        body: c.body,
+        headRefName: c.headRefName,
+        files,
+        deleted,
+    };
+}
+//# sourceMappingURL=component-pr.js.map

package/dist/tasks/component-pr.js.map

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

package/dist/tasks/delete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/tasks/delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AAGvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEvD,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,IAAI,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAoI3B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,YAAY,CAAC;IAAE,WAAW,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,CAoBjG"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/tasks/delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AAGvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAW9D,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEvD,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,IAAI,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAsJ3B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,YAAY,CAAC;IAAE,WAAW,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,CAoBjG"}

package/dist/tasks/delete.js

@@ -11,6 +11,7 @@ import { cleoErrorToEngineResult } from '../errors-to-engine.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
 import { removeChildProjectionAc } from './ac-table.js';
 import { taskToRecord } from './engine-converters.js';
+import { rankingAuditEntry, rankingSnapshot, resolveRankingActor, } from './ranking-audit.js';
 /**
  * Delete a task (soft delete - moves to archive).
  * @task T4461
@@ -68,10 +69,14 @@ export async function deleteTask(options, cwd, accessor) {
     const tasksById = new Map((await acc.loadTasks([...idsToDelete])).map((t) => [t.id, t]));
     // Gather dependency cleanup data before the transaction (reads outside)
     const depsToUpdate = [];
+    // T12693: each dependent's ranking inputs before the cascade edits them.
+    const dependsBefore = new Map();
     for (const deletedId of idsToDelete) {
         const dependents = await acc.getDependents(deletedId);
         for (const dep of dependents) {
             if (!idsToDelete.has(dep.id)) {
+                if (!dependsBefore.has(dep.id))
+                    dependsBefore.set(dep.id, rankingSnapshot(dep));
                 dep.depends = (dep.depends ?? []).filter((d) => !idsToDelete.has(d));
                 if (dep.depends.length === 0)
                     delete dep.depends;
@@ -80,6 +85,7 @@ export async function deleteTask(options, cwd, accessor) {
         }
     }
     const now = new Date().toISOString();
+    const rankingActor = depsToUpdate.length > 0 ? await resolveRankingActor(cwd) : null;
     // Wrap all writes in a transaction for TOCTOU safety (T023)
     await acc.transaction(async (tx) => {
         // Orphan children if force (mutations prepared above)
@@ -105,6 +111,20 @@ export async function deleteTask(options, cwd, accessor) {
         // Clean up dependency references
         for (const dep of depsToUpdate) {
             await tx.upsertSingleTask(dep);
+            // T12693 (D11161): removing a deleted prerequisite changes depends.
+            const before = dependsBefore.get(dep.id);
+            const entry = before && rankingActor
+                ? rankingAuditEntry({
+                    taskId: dep.id,
+                    before,
+                    after: rankingSnapshot(dep),
+                    actor: rankingActor,
+                    reason: `dependency ${[...idsToDelete].join(', ')} deleted`,
+                    source: 'delete-cascade',
+                })
+                : null;
+            if (entry)
+                await tx.appendLog(entry);
         }
         // Audit log
         await tx.appendLog({

package/dist/tasks/delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/tasks/delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,mEAAmE;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAqB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAWtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAA0B,EAC1B,GAAY,EACZ,QAAuB;IAEvB,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAErD,mDAAmD;IACnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,OAAO,CAAC,MAAM,EAAE,EAAE;YAC3E,GAAG,EAAE,mBAAmB,OAAO,CAAC,MAAM,cAAc;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACvC,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,YAAY,EACrB,QAAQ,OAAO,CAAC,MAAM,QAAQ,QAAQ,CAAC,MAAM,wEAAwE,EACrH;gBACE,YAAY,EAAE;oBACZ,EAAE,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,eAAe,OAAO,CAAC,MAAM,YAAY,EAAE;oBACtF;wBACE,MAAM,EAAE,gCAAgC;wBACxC,OAAO,EAAE,eAAe,OAAO,CAAC,MAAM,UAAU;qBACjD;iBACF;aACF,CACF,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,kDAAkD;YAClD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC5B,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACzB,yEAAyE;YACzE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACtB,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,cAAc,EACvB,QAAQ,OAAO,CAAC,MAAM,wBAAwB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtF,EAAE,GAAG,EAAE,6DAA6D,EAAE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzF,wEAAwE;IACxE,MAAM,YAAY,GAAW,EAAE,CAAC;IAChC,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACtD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrE,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;gBACjD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,4DAA4D;IAC5D,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACjC,sDAAsD;QACtD,IAAI,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC7D,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,MAAM,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,wEAAwE;QACxE,uEAAuE;QACvE,iDAAiD;QACjD,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;gBAC3B,MAAM,uBAAuB,CAAC,EAAE,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE;gBAC7B,UAAU,EAAE,GAAG;gBACf,aAAa,EAAE,WAAW;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,iCAAiC;QACjC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,YAAY;QACZ,MAAM,EAAE,CAAC,SAAS,CAAC;YACjB,EAAE,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YAC1G,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,cAAc,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;aACvE;YACD,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,cAAc,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;aACvE;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,MAAc,EACd,KAAe,EACf,OAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,EAC5D,WAAW,EACX,QAAQ,CACT,CAAC;QACF,OAAO,aAAa,CAAC;YACnB,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC;YAC7C,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,+DAA+D;QAC/D,sEAAsE;QACtE,iEAAiE;QACjE,wCAAwC;QACxC,OAAO,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/tasks/delete.ts"],"names":[],"mappings":"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"}

package/dist/tasks/done-plan.d.ts

@@ -23,7 +23,7 @@
  *
  * @task T12623
  */
-import type { DonePlan } from '@cleocode/contracts';
+import type { DonePlan, VerificationGate } from '@cleocode/contracts';
 import { type EngineResult } from '../engine-result.js';
 import { type ChangeSetDeps } from './change-set.js';
 /** Options for {@link deriveTaskEvidence}. */
@@ -38,7 +38,27 @@ export interface DeriveTaskEvidenceOptions {
     prNumber?: number;
     /** Injectable change-set I/O (tests). */
     deps?: ChangeSetDeps;
+    /** Evidence preview (tests inject; defaults to the write's own validators). */
+    previewEvidence?: DoneEvidencePreview;
+    /**
+     * Queue for the `test` slot while resolving the affected scope. `cleo done`
+     * does (it runs the tests next); `--plan` never waits and reports
+     * `scope pending: test slot busy` instead (T12656 review).
+     */
+    waitForTestSlot?: boolean;
 }
+/**
+ * Validate a derived multi-gate write without writing it: the same validators
+ * `cleo done` records through (T12672).
+ */
+export type DoneEvidencePreview = (storeRoot: string, taskId: string, gateEvidence: Partial<Record<VerificationGate, string | string[]>>) => Promise<{
+    ok: true;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+    fix?: string;
+}>;
 /**
  * POSIX single-quote a shell word (bare when it is already safe).
  *

package/dist/tasks/done-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"done-plan.d.ts","sourceRoot":"","sources":["../../src/tasks/done-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAGV,QAAQ,EAWT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AASvE,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,iBAAiB,CAAC;AA8E1E,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC;IACtC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAwUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAyInB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAMjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,OAAO,EAClB,EAAE,EAAE,OAAO,GAET;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE,WAAW,GAAG,UAAU,CAAC,CAAA;CAAE,GAChF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAajC"}
+{"version":3,"file":"done-plan.d.ts","sourceRoot":"","sources":["../../src/tasks/done-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAGV,QAAQ,EASR,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AAUvE,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,iBAAiB,CAAC;AAsE1E,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC;IACtC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,KAC/D,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AA8IxF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAwUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAyKnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAMjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,OAAO,EAClB,EAAE,EAAE,OAAO,GAET;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE,WAAW,GAAG,UAAU,CAAC,CAAA;CAAE,GAChF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAajC"}