@aperant/framework 0.6.2

package/dist/__tests__/synthesize-unit.test.js

@@ -0,0 +1,138 @@
+/**
+ * synthesize-unit.test.ts — narrow unit coverage for
+ * design/synthesize.mjs (C44 subtask 4).
+ *
+ * Asserts the v1 contract:
+ *   - `synthesizeDesignMd` is exported as an async function
+ *   - a fake llmClient returning a valid DESIGN.md yields a valid text +
+ *     provenance with the populated slot names listed
+ *   - invalid output twice → provenance.warnings populated (caller decides)
+ *
+ * The broader principle-#9 SEAM test lives in
+ * __tests__/integration/smoke-design-synthesize.test.ts (subtask 5).
+ */
+import { describe, expect, it } from 'vitest';
+import { synthesizeDesignMd } from '../cli/design/synthesize.mjs';
+const VALID_DESIGN = `---
+meta:
+  name: "Fixture"
+  version: "0.1.0"
+  updated: "2026-04-19"
+tokens:
+  colors:
+    bg: "#0B0B0F"
+    surface: "#16161D"
+    accent: "#7C5CFF"
+    text: "#F5F5F7"
+    border: "#2A2A32"
+  typography:
+    families:
+      primary: "Inter"
+    scale: ["14px", "16px", "20px"]
+  spacing: ["4px", "8px"]
+---
+
+# Design System — Fixture
+
+## 2. Color Palette
+
+notes
+
+## 3. Typography
+
+notes
+`;
+const INVALID_DESIGN = `---
+meta:
+  name: "Fixture"
+  version: "0.1.0"
+  updated: "2026-04-19"
+tokens:
+  colors:
+    bg: "#0B0B0F"
+    surface: "#16161D"
+    text: "#F5F5F7"
+    border: "#2A2A32"
+  typography:
+    families:
+      primary: "Inter"
+    scale: ["14px", "16px", "20px"]
+  spacing: ["4px", "8px"]
+---
+
+# Design System — Fixture (invalid: missing tokens.colors.accent)
+`;
+describe('synthesizeDesignMd (v1 API)', () => {
+    it('exports synthesizeDesignMd as an async function', () => {
+        expect(typeof synthesizeDesignMd).toBe('function');
+        // Async functions have a specific AsyncFunction constructor name.
+        expect(synthesizeDesignMd.constructor.name).toBe('AsyncFunction');
+    });
+    it('returns valid text + provenance when fake llmClient emits valid DESIGN.md (all-null slots)', async () => {
+        const fakeClient = {
+            generateText: async () => ({ text: VALID_DESIGN, model: 'fake-test-v1' }),
+        };
+        const result = await synthesizeDesignMd({
+            productContext: null,
+            taste: null,
+            observedTokens: null,
+            referenceDesignMd: null,
+            styleSeed: null,
+            llmClient: fakeClient,
+        });
+        expect(result.text).toBe(VALID_DESIGN);
+        expect(result.provenance.model).toBe('fake-test-v1');
+        // All slots null → no populated inputs recorded.
+        expect(result.provenance.inputs).toEqual([]);
+    });
+    it('records populated slot names in provenance.inputs', async () => {
+        const fakeClient = {
+            generateText: async () => ({ text: VALID_DESIGN, model: 'fake' }),
+        };
+        const result = await synthesizeDesignMd({
+            productContext: {
+                productName: 'X',
+                productDescription: 'y',
+                targetAudience: 'z',
+                features: [],
+            },
+            taste: { direction: 'enterprise-clean' },
+            observedTokens: null,
+            referenceDesignMd: null,
+            styleSeed: null,
+            llmClient: fakeClient,
+        });
+        expect(result.provenance.inputs).toContain('product_context');
+        expect(result.provenance.inputs).toContain('taste');
+        expect(result.provenance.inputs).not.toContain('observed_tokens');
+        expect(result.provenance.inputs).not.toContain('reference_design_md');
+        expect(result.provenance.inputs).not.toContain('style_seed');
+    });
+    it('retries once and returns warnings when the client emits invalid DESIGN.md twice', async () => {
+        let calls = 0;
+        const fakeClient = {
+            generateText: async () => {
+                calls += 1;
+                return { text: INVALID_DESIGN, model: 'fake-bad' };
+            },
+        };
+        const result = await synthesizeDesignMd({
+            productContext: null,
+            taste: null,
+            observedTokens: null,
+            referenceDesignMd: null,
+            styleSeed: null,
+            llmClient: fakeClient,
+        });
+        // Exactly two attempts: first + one retry.
+        expect(calls).toBe(2);
+        expect(result.provenance.warnings.length).toBeGreaterThan(0);
+        expect(result.provenance.warnings.some((w) => w.includes('validator failed twice'))).toBe(true);
+    });
+    it('throws when llmClient is missing', async () => {
+        await expect(
+        // @ts-expect-error — intentional misuse for the error-path assertion
+        synthesizeDesignMd({ productContext: null })).rejects.toThrow(/llmClient/);
+    });
+});
+//# sourceMappingURL=synthesize-unit.test.js.map

package/dist/__tests__/synthesize-unit.test.js.map

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

package/dist/__tests__/task-close-auto-phase.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * C56 A2 — `task close` auto_close_phase gating + `--pr-url` tests.
+ *
+ * Covers:
+ *   (1) flag off + approved → flip happens (regression: today's behavior).
+ *   (2) flag on + approved + PR MERGED → flip happens.
+ *   (3) flag on + approved + PR OPEN → no flip, envelope carries pr_state='open'.
+ *   (4) flag on + approved + no pr_url → warning + fall through to default flip.
+ *   (5) gh failure → warning, fall-open to default flip.
+ *   (6) `task update --pr-url <url>` persists to task.pr_url.
+ */
+export {};
+//# sourceMappingURL=task-close-auto-phase.test.d.ts.map

package/dist/__tests__/task-close-auto-phase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-close-auto-phase.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/task-close-auto-phase.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/task-close-auto-phase.test.js

@@ -0,0 +1,197 @@
+/**
+ * C56 A2 — `task close` auto_close_phase gating + `--pr-url` tests.
+ *
+ * Covers:
+ *   (1) flag off + approved → flip happens (regression: today's behavior).
+ *   (2) flag on + approved + PR MERGED → flip happens.
+ *   (3) flag on + approved + PR OPEN → no flip, envelope carries pr_state='open'.
+ *   (4) flag on + approved + no pr_url → warning + fall through to default flip.
+ *   (5) gh failure → warning, fall-open to default flip.
+ *   (6) `task update --pr-url <url>` persists to task.pr_url.
+ */
+import { execFileSync, spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+const APT_TOOLS = resolve(__dirname, '..', '..', 'bin', 'apt-tools.mjs');
+function initRepo() {
+    const dir = mkdtempSync(join(tmpdir(), 'apt-close-auto-'));
+    execFileSync('git', ['init', '-q', '-b', 'main'], { cwd: dir });
+    execFileSync('git', ['config', 'user.email', 't@t.t'], { cwd: dir });
+    execFileSync('git', ['config', 'user.name', 't'], { cwd: dir });
+    execFileSync('git', ['config', 'commit.gpgsign', 'false'], { cwd: dir });
+    writeFileSync(join(dir, 'README.md'), '# fixture\n');
+    execFileSync('git', ['add', 'README.md'], { cwd: dir });
+    execFileSync('git', ['commit', '-q', '-m', 'init'], { cwd: dir });
+    return dir;
+}
+function runApt(cwd, args, env = {}) {
+    const r = spawnSync('node', [APT_TOOLS, ...args], {
+        cwd,
+        encoding: 'utf-8',
+        env: { ...process.env, ...env },
+    });
+    return { stdout: r.stdout || '', stderr: r.stderr || '', status: r.status ?? -1 };
+}
+function enableAutoClosePhase(repo) {
+    const path = join(repo, '.aperant', 'config.json');
+    const cfg = existsSync(path) ? JSON.parse(readFileSync(path, 'utf-8')) : {};
+    cfg.task_isolation = cfg.task_isolation || {};
+    cfg.task_isolation.auto_close_phase = true;
+    mkdirSync(join(repo, '.aperant'), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(cfg, null, 2)}\n`);
+}
+function seedLinkedTask(repo, id) {
+    runApt(repo, ['roadmap', 'init', repo, '--scope', 'project']);
+    runApt(repo, ['roadmap', 'add-milestone', repo, '--id', 'ms1', '--title', 'M1']);
+    runApt(repo, ['roadmap', 'add-phase', repo, '--milestone', 'ms1', '--id', 'p1', '--title', 'P1']);
+    // Flip the phase to in-progress so the close→completed transition can fire.
+    runApt(repo, [
+        'roadmap',
+        'set-phase-status',
+        repo,
+        '--milestone',
+        'ms1',
+        '--phase',
+        'p1',
+        '--status',
+        'in-progress',
+    ]);
+    runApt(repo, ['task', 'create', repo, '--description', id, '--milestone', 'ms1', '--phase', 'p1']);
+    // Fetch actual task id from state.json (CLI generates it).
+    const state = JSON.parse(readFileSync(join(repo, '.aperant', 'state.json'), 'utf-8'));
+    return Object.keys(state.active_tasks)[0];
+}
+function phaseStatus(repo) {
+    const path = join(repo, '.aperant', 'roadmap', 'project', 'milestones.json');
+    if (!existsSync(path))
+        return null;
+    const rm = JSON.parse(readFileSync(path, 'utf-8'));
+    const phase = rm.milestones[0]?.phases?.find((p) => p.id === 'p1');
+    return phase?.status ?? null;
+}
+describe('C56 A2 — task close auto_close_phase + --pr-url', () => {
+    let repo;
+    beforeEach(() => {
+        repo = initRepo();
+        runApt(repo, ['init', repo, '--yes']);
+    });
+    afterEach(() => {
+        try {
+            rmSync(repo, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+    });
+    it('task update --pr-url persists the URL on the task record', () => {
+        const taskId = seedLinkedTask(repo, 'url-test');
+        const { stdout, status } = runApt(repo, [
+            'task',
+            'update',
+            repo,
+            '--id',
+            taskId,
+            '--pr-url',
+            'https://github.com/org/repo/pull/77',
+        ]);
+        expect(status).toBe(0);
+        const env = JSON.parse(stdout);
+        expect(env.status).toBe('ok');
+        expect(env.task.pr_url).toBe('https://github.com/org/repo/pull/77');
+    });
+    it('flag off + approved → phase flips (regression: today behavior)', () => {
+        const taskId = seedLinkedTask(repo, 'flag-off');
+        expect(phaseStatus(repo)).toBe('in-progress');
+        const { stdout } = runApt(repo, [
+            'task',
+            'close',
+            repo,
+            '--id',
+            taskId,
+            '--verdict',
+            'approved',
+        ]);
+        const env = JSON.parse(stdout);
+        expect(env.status).toBe('ok');
+        // Phase should flip because auto_close_phase is off.
+        expect(phaseStatus(repo)).toBe('completed');
+        expect(env.pr_check).toBeUndefined();
+    });
+    it('flag on + approved + PR MERGED → phase flips', () => {
+        enableAutoClosePhase(repo);
+        const taskId = seedLinkedTask(repo, 'merged');
+        runApt(repo, [
+            'task',
+            'update',
+            repo,
+            '--id',
+            taskId,
+            '--pr-url',
+            'https://github.com/org/repo/pull/1',
+        ]);
+        const { stdout } = runApt(repo, ['task', 'close', repo, '--id', taskId, '--verdict', 'approved'], {
+            APT_GH_FIXTURE_JSON: JSON.stringify({ state: 'MERGED', mergedAt: '2026-01-01T00:00:00Z' }),
+        });
+        const env = JSON.parse(stdout);
+        expect(env.pr_check?.state).toBe('MERGED');
+        expect(phaseStatus(repo)).toBe('completed');
+    });
+    it('flag on + approved + PR OPEN → no flip, pr_state=open', () => {
+        enableAutoClosePhase(repo);
+        const taskId = seedLinkedTask(repo, 'open');
+        runApt(repo, [
+            'task',
+            'update',
+            repo,
+            '--id',
+            taskId,
+            '--pr-url',
+            'https://github.com/org/repo/pull/2',
+        ]);
+        const { stdout } = runApt(repo, ['task', 'close', repo, '--id', taskId, '--verdict', 'approved'], { APT_GH_FIXTURE_JSON: JSON.stringify({ state: 'OPEN', mergedAt: null }) });
+        const env = JSON.parse(stdout);
+        expect(env.pr_check?.state).toBe('OPEN');
+        expect(env.pr_state).toBe('open');
+        // Phase should NOT flip.
+        expect(phaseStatus(repo)).toBe('in-progress');
+    });
+    it('flag on + approved + PR CLOSED-not-merged → no flip, pr_state=closed_not_merged', () => {
+        enableAutoClosePhase(repo);
+        const taskId = seedLinkedTask(repo, 'closed');
+        runApt(repo, [
+            'task',
+            'update',
+            repo,
+            '--id',
+            taskId,
+            '--pr-url',
+            'https://github.com/org/repo/pull/3',
+        ]);
+        const { stdout } = runApt(repo, ['task', 'close', repo, '--id', taskId, '--verdict', 'approved'], { APT_GH_FIXTURE_JSON: JSON.stringify({ state: 'CLOSED', mergedAt: null }) });
+        const env = JSON.parse(stdout);
+        expect(env.pr_check?.state).toBe('CLOSED');
+        expect(env.pr_state).toBe('closed_not_merged');
+        expect(phaseStatus(repo)).toBe('in-progress');
+    });
+    it('flag on + approved + no pr_url → warning + falls through to default flip', () => {
+        enableAutoClosePhase(repo);
+        const taskId = seedLinkedTask(repo, 'no-url');
+        const { stdout } = runApt(repo, [
+            'task',
+            'close',
+            repo,
+            '--id',
+            taskId,
+            '--verdict',
+            'approved',
+        ]);
+        const env = JSON.parse(stdout);
+        expect(env.pr_check).toBeTruthy();
+        expect(env.pr_check.warning).toContain('no pr_url');
+        // Phase flips (fail-open).
+        expect(phaseStatus(repo)).toBe('completed');
+    });
+});
+//# sourceMappingURL=task-close-auto-phase.test.js.map

package/dist/__tests__/task-close-auto-phase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-close-auto-phase.test.js","sourceRoot":"","sources":["../../src/__tests__/task-close-auto-phase.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/task-close-merged-closed-not-merged.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * C57 Piece 1 — `apt-tools task close-merged` MUST handle CLOSED-not-merged
+ * tasks symmetrically with MERGED.
+ *
+ * Before C57, only `state === 'MERGED'` flipped the task to completed; CLOSED
+ * (abandoned/superseded) PRs left the task rotting in `shipped-pending-merge`
+ * forever. The dispatch-time sweeper would then infinite-poll those zombies.
+ *
+ * C57 mirrors the symmetric pattern used by `pr-review.maybeRunCloseRoundCleanup`:
+ *   - MERGED  → spawn `task close --verdict approved`  (existing behavior)
+ *   - CLOSED  → spawn `task close --verdict rejected`  (new — Piece 1)
+ *   - other   → skip (existing behavior)
+ *
+ * In both terminal cases the per-PR authorship override is stripped from
+ * config and `task.closed.merged` event fires with verdict + pr_state in the
+ * payload so log replay can distinguish them.
+ */
+export {};
+//# sourceMappingURL=task-close-merged-closed-not-merged.test.d.ts.map

package/dist/__tests__/task-close-merged-closed-not-merged.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-close-merged-closed-not-merged.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/task-close-merged-closed-not-merged.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/__tests__/task-close-merged-closed-not-merged.test.js

@@ -0,0 +1,177 @@
+/**
+ * C57 Piece 1 — `apt-tools task close-merged` MUST handle CLOSED-not-merged
+ * tasks symmetrically with MERGED.
+ *
+ * Before C57, only `state === 'MERGED'` flipped the task to completed; CLOSED
+ * (abandoned/superseded) PRs left the task rotting in `shipped-pending-merge`
+ * forever. The dispatch-time sweeper would then infinite-poll those zombies.
+ *
+ * C57 mirrors the symmetric pattern used by `pr-review.maybeRunCloseRoundCleanup`:
+ *   - MERGED  → spawn `task close --verdict approved`  (existing behavior)
+ *   - CLOSED  → spawn `task close --verdict rejected`  (new — Piece 1)
+ *   - other   → skip (existing behavior)
+ *
+ * In both terminal cases the per-PR authorship override is stripped from
+ * config and `task.closed.merged` event fires with verdict + pr_state in the
+ * payload so log replay can distinguish them.
+ */
+import { execFileSync, spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+const APT_TOOLS = resolve(__dirname, '..', '..', 'bin', 'apt-tools.mjs');
+function initRepo() {
+    const dir = mkdtempSync(join(tmpdir(), 'apt-close-merged-closed-'));
+    execFileSync('git', ['init', '-q', '-b', 'main'], { cwd: dir });
+    execFileSync('git', ['config', 'user.email', 't@t.t'], { cwd: dir });
+    execFileSync('git', ['config', 'user.name', 't'], { cwd: dir });
+    execFileSync('git', ['config', 'commit.gpgsign', 'false'], { cwd: dir });
+    writeFileSync(join(dir, 'README.md'), '# fixture\n');
+    execFileSync('git', ['add', 'README.md'], { cwd: dir });
+    execFileSync('git', ['commit', '-q', '-m', 'init'], { cwd: dir });
+    return dir;
+}
+function runApt(cwd, args, env = {}) {
+    const r = spawnSync('node', [APT_TOOLS, ...args], {
+        cwd,
+        encoding: 'utf-8',
+        env: { ...process.env, ...env },
+    });
+    return { stdout: r.stdout || '', stderr: r.stderr || '', status: r.status ?? -1 };
+}
+function seedShippedTask(repo, id, prUrl) {
+    const statePath = join(repo, '.aperant', 'state.json');
+    const state = existsSync(statePath)
+        ? JSON.parse(readFileSync(statePath, 'utf-8'))
+        : { active_tasks: {}, completed_tasks: [] };
+    state.active_tasks = state.active_tasks || {};
+    state.active_tasks[id] = {
+        id,
+        description: `test-${id}`,
+        scope: 'project',
+        lifecycle_phase: 'shipped-pending-merge',
+        milestone_id: null,
+        phase_id: null,
+        progress: { subtasks_total: 0, subtasks_completed: 0, current_subtask: null },
+        history: [],
+        created_at: new Date().toISOString(),
+        pr_url: prUrl,
+    };
+    mkdirSync(join(repo, '.aperant'), { recursive: true });
+    writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`);
+    mkdirSync(join(repo, '.aperant', 'tasks', id), { recursive: true });
+}
+describe('C57 Piece 1 — task close-merged handles CLOSED-not-merged', () => {
+    let repo;
+    beforeEach(() => {
+        repo = initRepo();
+        runApt(repo, ['init', repo, '--yes']);
+        const aperantDir = join(repo, '.aperant');
+        mkdirSync(aperantDir, { recursive: true });
+        const statePath = join(aperantDir, 'state.json');
+        if (!existsSync(statePath)) {
+            writeFileSync(statePath, `${JSON.stringify({ active_tasks: {}, completed_tasks: [] }, null, 2)}\n`);
+        }
+        const cfgPath = join(aperantDir, 'config.json');
+        if (!existsSync(cfgPath)) {
+            writeFileSync(cfgPath, `${JSON.stringify({}, null, 2)}\n`);
+        }
+    });
+    afterEach(() => {
+        try {
+            rmSync(repo, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+    });
+    it('MERGED still flips with verdict=approved (regression)', () => {
+        seedShippedTask(repo, 'merged_task', 'https://github.com/x/y/pull/100');
+        const { stdout, status } = runApt(repo, ['task', 'close-merged', repo, '--task', 'merged_task'], {
+            APT_GH_FIXTURE_JSON: JSON.stringify({
+                state: 'MERGED',
+                mergedAt: '2026-01-01',
+                number: 100,
+            }),
+        });
+        expect(status).toBe(0);
+        const env = JSON.parse(stdout);
+        expect(env.closed[0]).toMatchObject({
+            id: 'merged_task',
+            verdict: 'approved',
+            pr_state: 'MERGED',
+        });
+    });
+    it('CLOSED-not-merged flips with verdict=rejected and strips config override', () => {
+        seedShippedTask(repo, 'abandoned_task', 'https://github.com/x/y/pull/200');
+        // Stamp a stale authorship override that should be stripped on CLOSED.
+        const cfgPath = join(repo, '.aperant', 'config.json');
+        const cfg = JSON.parse(readFileSync(cfgPath, 'utf-8'));
+        cfg.pr_review = cfg.pr_review || {};
+        cfg.pr_review.authorship_overrides = { 'pr-200': 'owned' };
+        writeFileSync(cfgPath, `${JSON.stringify(cfg, null, 2)}\n`);
+        const { stdout, status } = runApt(repo, ['task', 'close-merged', repo, '--task', 'abandoned_task'], {
+            APT_GH_FIXTURE_JSON: JSON.stringify({ state: 'CLOSED', mergedAt: null, number: 200 }),
+        });
+        expect(status).toBe(0);
+        const env = JSON.parse(stdout);
+        expect(env.closed.length).toBe(1);
+        expect(env.closed[0]).toMatchObject({
+            id: 'abandoned_task',
+            verdict: 'rejected',
+            pr_state: 'CLOSED',
+        });
+        expect(env.skipped).toEqual([]);
+        // Config override stripped on CLOSED, same as MERGED.
+        const cfgAfter = JSON.parse(readFileSync(cfgPath, 'utf-8'));
+        expect(cfgAfter?.pr_review?.authorship_overrides?.['pr-200']).toBeUndefined();
+        // Task moved from active_tasks → completed_tasks with rejected verdict.
+        const state = JSON.parse(readFileSync(join(repo, '.aperant', 'state.json'), 'utf-8'));
+        expect(state.active_tasks?.abandoned_task).toBeUndefined();
+        const completed = (state.completed_tasks || []).find((r) => r.id === 'abandoned_task');
+        expect(completed).toBeDefined();
+        expect(completed.qa_verdict).toBe('rejected');
+        // Event log: task.closed.merged includes verdict + pr_state for replay.
+        const todayISO = new Date().toISOString().slice(0, 10);
+        const eventsPath = join(repo, '.aperant', 'events', `${todayISO}.jsonl`);
+        expect(existsSync(eventsPath)).toBe(true);
+        const events = readFileSync(eventsPath, 'utf-8')
+            .trim()
+            .split('\n')
+            .map((line) => JSON.parse(line));
+        const ev = events.find((e) => e.op === 'task.closed.merged' && e.task === 'abandoned_task');
+        expect(ev).toBeDefined();
+        expect(ev.data).toMatchObject({ verdict: 'rejected', pr_state: 'CLOSED' });
+    });
+    it('OPEN still skips (regression — non-terminal state)', () => {
+        seedShippedTask(repo, 'still_open_task', 'https://github.com/x/y/pull/300');
+        const { stdout, status } = runApt(repo, ['task', 'close-merged', repo, '--task', 'still_open_task'], {
+            APT_GH_FIXTURE_JSON: JSON.stringify({ state: 'OPEN', mergedAt: null, number: 300 }),
+        });
+        expect(status).toBe(0);
+        const env = JSON.parse(stdout);
+        expect(env.closed).toEqual([]);
+        expect(env.skipped[0]).toMatchObject({ id: 'still_open_task', reason: 'pr_open' });
+        // Task still in active_tasks awaiting next sweep.
+        const state = JSON.parse(readFileSync(join(repo, '.aperant', 'state.json'), 'utf-8'));
+        expect(state.active_tasks?.still_open_task?.lifecycle_phase).toBe('shipped-pending-merge');
+    });
+    it('--dry-run on CLOSED reports verdict=rejected without mutating state', () => {
+        seedShippedTask(repo, 'dry_closed_task', 'https://github.com/x/y/pull/400');
+        const before = JSON.parse(readFileSync(join(repo, '.aperant', 'state.json'), 'utf-8'));
+        const { stdout, status } = runApt(repo, ['task', 'close-merged', repo, '--task', 'dry_closed_task', '--dry-run'], {
+            APT_GH_FIXTURE_JSON: JSON.stringify({ state: 'CLOSED', mergedAt: null, number: 400 }),
+        });
+        expect(status).toBe(0);
+        const env = JSON.parse(stdout);
+        expect(env.closed[0]).toMatchObject({
+            id: 'dry_closed_task',
+            verdict: 'rejected',
+            dry_run: true,
+        });
+        const after = JSON.parse(readFileSync(join(repo, '.aperant', 'state.json'), 'utf-8'));
+        expect(after.active_tasks).toEqual(before.active_tasks);
+    });
+});
+//# sourceMappingURL=task-close-merged-closed-not-merged.test.js.map

package/dist/__tests__/task-close-merged-closed-not-merged.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-close-merged-closed-not-merged.test.js","sourceRoot":"","sources":["../../src/__tests__/task-close-merged-closed-not-merged.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/task-close-merged-pr-mutated.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * C57 Piece 4 guardrail — defend against task-mutated races.
+ *
+ * Between the moment `close-merged` snapshots a candidate's `pr_url` and the
+ * moment it would fire the destructive `task close` child, another agent
+ * could re-ship the task to a different PR (rare, but parallel-agent setups
+ * make it possible). The closer MUST re-read state under lock and verify
+ * `pr_url` is unchanged before closing — otherwise we risk closing the wrong
+ * PR with the wrong verdict.
+ *
+ * Per spec, the re-verification belongs IN `task.mjs:close-merged`'s loop,
+ * not in the dispatcher hook.
+ */
+export {};
+//# sourceMappingURL=task-close-merged-pr-mutated.test.d.ts.map

package/dist/__tests__/task-close-merged-pr-mutated.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-close-merged-pr-mutated.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/task-close-merged-pr-mutated.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}