@aperant/framework 0.6.2

package/dist/__tests__/integration/smoke-wfrun.test.js.map

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

package/dist/__tests__/integration/smoke-worktree-install.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * smoke-worktree-install.test.ts — C30 integration coverage for C54
+ * worktree-install command. Happy + error markers required by
+ * command-coverage matrix.
+ */
+export {};
+//# sourceMappingURL=smoke-worktree-install.test.d.ts.map

package/dist/__tests__/integration/smoke-worktree-install.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-worktree-install.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-worktree-install.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/integration/smoke-worktree-install.test.js

@@ -0,0 +1,40 @@
+/**
+ * smoke-worktree-install.test.ts — C30 integration coverage for C54
+ * worktree-install command. Happy + error markers required by
+ * command-coverage matrix.
+ */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './helpers/make-fixture-project';
+import { runCli } from './helpers/run-cli';
+describe('worktree-install', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('worktree-install happy: returns install_status=skipped when bootstrap_worktree is off (default)', () => {
+        // happy: default config ⇒ bootstrap is off ⇒ install_status: "skipped"
+        const worktreePath = join(fx.root, 'wt');
+        mkdirSync(worktreePath, { recursive: true });
+        writeFileSync(join(fx.root, '.aperant', 'state.json'), JSON.stringify({
+            version: 2,
+            active_tasks: { t1: { id: 't1', worktree_path: worktreePath } },
+        }));
+        const r = runCli(['worktree-install', fx.root, '--task', 't1']);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(parsed.command).toBe('worktree-install');
+        expect(parsed.install_status).toBe('skipped');
+    });
+    it('worktree-install error: missing --task flag is a structured error', () => {
+        // error: worktree-install without --task returns a fail envelope
+        const r = runCli(['worktree-install', fx.root]);
+        expect(r.status).not.toBe(0);
+        // Should be a structured { error: "..." } envelope, NOT "Unknown command".
+        const body = r.stdout + r.stderr;
+        expect(body).not.toMatch(/Unknown command/);
+    });
+});
+//# sourceMappingURL=smoke-worktree-install.test.js.map

package/dist/__tests__/integration/smoke-worktree-install.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-worktree-install.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-worktree-install.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IACjC,IAAI,EAAyC,CAAA;IAC7C,UAAU,CAAC,GAAG,EAAE;QACf,EAAE,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IAE7B,EAAE,CAAC,iGAAiG,EAAE,GAAG,EAAE;QAC1G,uEAAuE;QACvE,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,aAAa,CACZ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,EACvC,IAAI,CAAC,SAAS,CAAC;YACd,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE;SAC/D,CAAC,CACF,CAAA;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;QAC/D,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAIjB,CAAA;QACJ,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC5E,iEAAiE;QACjE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;QAC/C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,2EAA2E;QAC3E,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAA;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/integration/smoke-worktree.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * smoke-worktree.test.ts — C30 integration coverage for worktree-family:
+ *   worktree, detect-worktree.
+ */
+export {};
+//# sourceMappingURL=smoke-worktree.test.d.ts.map

package/dist/__tests__/integration/smoke-worktree.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-worktree.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/smoke-worktree.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/__tests__/integration/smoke-worktree.test.js

@@ -0,0 +1,59 @@
+/**
+ * smoke-worktree.test.ts — C30 integration coverage for worktree-family:
+ *   worktree, detect-worktree.
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeFixtureProject } from './helpers/make-fixture-project';
+import { runCli } from './helpers/run-cli';
+describe('worktree', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('worktree list happy: returns an empty worktree list', () => {
+        // happy: worktree list on project with no extra trees
+        const r = runCli(['worktree', 'list', fx.root]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(Array.isArray(parsed.worktrees)).toBe(true);
+    });
+    it('worktree error: no subcommand', () => {
+        // error: worktree called without a subcommand
+        const r = runCli(['worktree', fx.root]);
+        expect(r.status).not.toBe(0);
+    });
+    it('worktree error: unknown subcommand', () => {
+        // error: worktree nosuch
+        const r = runCli(['worktree', 'nosuch', fx.root]);
+        expect(r.status).not.toBe(0);
+    });
+});
+describe('detect-worktree', () => {
+    let fx;
+    beforeEach(() => {
+        fx = makeFixtureProject({ runInit: true });
+    });
+    afterEach(() => fx.cleanup());
+    it('detect-worktree happy: reports is_worktree=false on main repo', () => {
+        // happy: detect-worktree on a fresh git repo
+        const r = runCli(['detect-worktree', fx.root]);
+        expect(r.status).toBe(0);
+        const parsed = r.json();
+        expect(typeof parsed.is_worktree).toBe('boolean');
+    });
+    it('detect-worktree error: non-git directory returns structured JSON (no crash)', () => {
+        // error: detect-worktree on a non-git path must emit a parseable JSON
+        // envelope — either an `error` or `is_worktree=false`.
+        const other = makeFixtureProject({ withGitRepo: false, withState: false, withConfig: false });
+        try {
+            const r = runCli(['detect-worktree', other.root]);
+            const parsed = JSON.parse(r.stdout);
+            expect(parsed.is_worktree !== undefined || parsed.error !== undefined).toBe(true);
+        }
+        finally {
+            other.cleanup();
+        }
+    });
+});
+//# sourceMappingURL=smoke-worktree.test.js.map

package/dist/__tests__/integration/smoke-worktree.test.js.map

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

package/dist/__tests__/lifecycle-shipped-pending-merge.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * C56 B5 — `shipped-pending-merge` lifecycle phase enum addition.
+ *
+ * Covers:
+ *   (a) isLifecyclePhase('shipped-pending-merge') === true
+ *   (b) LIFECYCLE_PHASES contains the value in the correct slot (between
+ *       'reviewing' and 'completed').
+ *   (c) `apt-tools task update . --id X --lifecycle-phase shipped-pending-merge`
+ *       succeeds and round-trips the value back via `task get`.
+ *   (d) update to `shipped-pending-merge` does NOT flip the roadmap phase
+ *       (no roadmap sync commit is produced for this transition).
+ *   (e) statusline renders the compact label `shipped` (not the verbose enum).
+ */
+export {};
+//# sourceMappingURL=lifecycle-shipped-pending-merge.test.d.ts.map

package/dist/__tests__/lifecycle-shipped-pending-merge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-shipped-pending-merge.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/lifecycle-shipped-pending-merge.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/__tests__/lifecycle-shipped-pending-merge.test.js

@@ -0,0 +1,150 @@
+/**
+ * C56 B5 — `shipped-pending-merge` lifecycle phase enum addition.
+ *
+ * Covers:
+ *   (a) isLifecyclePhase('shipped-pending-merge') === true
+ *   (b) LIFECYCLE_PHASES contains the value in the correct slot (between
+ *       'reviewing' and 'completed').
+ *   (c) `apt-tools task update . --id X --lifecycle-phase shipped-pending-merge`
+ *       succeeds and round-trips the value back via `task get`.
+ *   (d) update to `shipped-pending-merge` does NOT flip the roadmap phase
+ *       (no roadmap sync commit is produced for this transition).
+ *   (e) statusline renders the compact label `shipped` (not the verbose enum).
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { statusLine } from '../cli/output-style/helpers.mjs';
+import { isLifecyclePhase, LIFECYCLE_PHASES } from '../types/lifecycle';
+const APT_TOOLS = resolve(__dirname, '..', '..', 'bin', 'apt-tools.mjs');
+function initRepo() {
+    const dir = mkdtempSync(join(tmpdir(), 'apt-lifecycle-c56-'));
+    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) {
+    return execFileSync('node', [APT_TOOLS, ...args], {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+}
+function snapshotDir(root) {
+    const out = {};
+    if (!existsSync(root))
+        return out;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true }).map((e) => ({
+                name: e.name,
+                isDir: e.isDirectory(),
+            }));
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const abs = join(dir, entry.name);
+            if (entry.isDir)
+                walk(abs);
+            else {
+                const rel = abs.slice(root.length + 1);
+                try {
+                    out[rel] = readFileSync(abs, 'utf-8');
+                }
+                catch {
+                    out[rel] = '';
+                }
+            }
+        }
+    };
+    walk(root);
+    return out;
+}
+describe('C56 B5 — shipped-pending-merge lifecycle phase', () => {
+    it('isLifecyclePhase recognizes the new value', () => {
+        expect(isLifecyclePhase('shipped-pending-merge')).toBe(true);
+    });
+    it('LIFECYCLE_PHASES has all 6 values in canonical order', () => {
+        expect([...LIFECYCLE_PHASES]).toEqual([
+            'planning',
+            'executing',
+            'verifying',
+            'reviewing',
+            'shipped-pending-merge',
+            'completed',
+        ]);
+    });
+    it('LIFECYCLE_PHASES slots shipped-pending-merge between reviewing and completed', () => {
+        const ix = LIFECYCLE_PHASES.indexOf('shipped-pending-merge');
+        expect(LIFECYCLE_PHASES[ix - 1]).toBe('reviewing');
+        expect(LIFECYCLE_PHASES[ix + 1]).toBe('completed');
+    });
+    it('rejects unknown lifecycle strings via isLifecyclePhase', () => {
+        expect(isLifecyclePhase('shipped')).toBe(false);
+        expect(isLifecyclePhase('pending-merge')).toBe(false);
+        expect(isLifecyclePhase(42)).toBe(false);
+        expect(isLifecyclePhase(null)).toBe(false);
+    });
+    it('statusLine renders "shipped" for shipped-pending-merge (compact label)', () => {
+        const line = statusLine({ active_tasks: 1, current_phase: 'shipped-pending-merge', team_count: 0 }, { color: false });
+        expect(line).toContain('phase shipped');
+        expect(line).not.toContain('shipped-pending-merge');
+    });
+    it('statusLine passes through unknown phase strings verbatim (additive-enum safety)', () => {
+        const line = statusLine({ active_tasks: 1, current_phase: 'some-future-phase', team_count: 0 }, { color: false });
+        expect(line).toContain('phase some-future-phase');
+    });
+    describe('CLI round-trip via apt-tools task update', () => {
+        it('accepts shipped-pending-merge and writes it to state.json without flipping a roadmap phase', () => {
+            const repo = initRepo();
+            try {
+                runApt(repo, ['init', repo, '--yes']);
+                const created = runApt(repo, [
+                    'task',
+                    'create',
+                    repo,
+                    '--description',
+                    'test shipped-pending-merge transition',
+                ]);
+                const createEnv = JSON.parse(created);
+                const taskId = createEnv.task_id || createEnv.task?.id || createEnv.id;
+                expect(typeof taskId).toBe('string');
+                const roadmapDir = join(repo, '.aperant', 'roadmap');
+                const beforeRoadmap = snapshotDir(roadmapDir);
+                const updated = runApt(repo, [
+                    'task',
+                    'update',
+                    repo,
+                    '--id',
+                    taskId,
+                    '--lifecycle-phase',
+                    'shipped-pending-merge',
+                ]);
+                const updateEnv = JSON.parse(updated);
+                expect(updateEnv.status).toBe('ok');
+                const got = runApt(repo, ['task', 'get', repo, '--id', taskId]);
+                const getEnv = JSON.parse(got);
+                expect(getEnv.status).toBe('ok');
+                const task = getEnv.task ?? getEnv.record ?? getEnv;
+                expect(task.lifecycle_phase).toBe('shipped-pending-merge');
+                const afterRoadmap = snapshotDir(roadmapDir);
+                expect(afterRoadmap).toEqual(beforeRoadmap);
+                expect(updateEnv.lifecycle_transition ?? null).toBeNull();
+            }
+            finally {
+                rmSync(repo, { recursive: true, force: true });
+            }
+        });
+    });
+});
+//# sourceMappingURL=lifecycle-shipped-pending-merge.test.js.map

package/dist/__tests__/lifecycle-shipped-pending-merge.test.js.map

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

package/dist/__tests__/lock-proper-lockfile.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AC #2 (C28) — `withLock` demonstrates mutual exclusion across concurrent
+ * writers. Two subprocesses contending for the same file must serialize.
+ *
+ * Also AC #3 — ad-hoc `writeFileSync(.lock, {flag:'wx'})` pattern is gone
+ * from the CLI kernel.
+ */
+export {};
+//# sourceMappingURL=lock-proper-lockfile.test.d.ts.map

package/dist/__tests__/lock-proper-lockfile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-proper-lockfile.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/lock-proper-lockfile.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/lock-proper-lockfile.test.js

@@ -0,0 +1,121 @@
+/**
+ * AC #2 (C28) — `withLock` demonstrates mutual exclusion across concurrent
+ * writers. Two subprocesses contending for the same file must serialize.
+ *
+ * Also AC #3 — ad-hoc `writeFileSync(.lock, {flag:'wx'})` pattern is gone
+ * from the CLI kernel.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { describe, expect, it } from 'vitest';
+function pathToFileUrl(p) {
+    return pathToFileURL(p).href;
+}
+import { withLock } from '../helpers/lock';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const FRAMEWORK_ROOT = resolve(__dirname, '..', '..');
+const REPO_ROOT = resolve(FRAMEWORK_ROOT, '..', '..');
+describe('withLock (C28 R4)', () => {
+    it('serializes concurrent in-process writers', async () => {
+        const dir = mkdtempSync(join(tmpdir(), 'apt-lock-test-'));
+        const target = join(dir, 'counter.json');
+        writeFileSync(target, JSON.stringify({ n: 0 }));
+        const bumpOnce = () => withLock(target, async () => {
+            const state = JSON.parse(readFileSync(target, 'utf-8'));
+            await new Promise((r) => setTimeout(r, 5));
+            state.n += 1;
+            writeFileSync(target, JSON.stringify(state));
+        });
+        await Promise.all(Array.from({ length: 10 }, () => bumpOnce()));
+        const final = JSON.parse(readFileSync(target, 'utf-8'));
+        expect(final.n).toBe(10);
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('serializes concurrent Node subprocesses writing to the same target', async () => {
+        const dir = mkdtempSync(join(tmpdir(), 'apt-lock-cross-'));
+        const target = join(dir, 'counter.json');
+        writeFileSync(target, JSON.stringify({ n: 0 }));
+        // Child uses lockSync with a manual retry loop (the sync API doesn't
+        // accept a retries object). Resolve `proper-lockfile` via an absolute
+        // path into the framework's node_modules so subprocesses find it
+        // regardless of cwd.
+        const properLockfilePath = resolve(FRAMEWORK_ROOT, 'node_modules', 'proper-lockfile', 'index.js');
+        const asFileUrl = pathToFileUrl(properLockfilePath);
+        const childSrc = `
+			import properLockfile from ${JSON.stringify(asFileUrl)}
+			import { readFileSync, writeFileSync } from 'node:fs'
+			const target = process.argv[2]
+			let release = null
+			for (let attempt = 0; attempt < 40; attempt++) {
+				try {
+					release = properLockfile.lockSync(target, { stale: 5000, realpath: false })
+					break
+				} catch (err) {
+					const t0 = Date.now(); while (Date.now() - t0 < 25) { /* spin */ }
+				}
+			}
+			if (!release) process.exit(1)
+			try {
+				const state = JSON.parse(readFileSync(target, 'utf-8'))
+				const t0 = Date.now(); while (Date.now() - t0 < 20) { /* spin */ }
+				state.n += 1
+				writeFileSync(target, JSON.stringify(state))
+			} finally { release() }
+		`;
+        const childPath = join(dir, 'child.mjs');
+        writeFileSync(childPath, childSrc);
+        const spawnOnce = () => new Promise((resolvePromise, reject) => {
+            const cp = spawn(process.execPath, [childPath, target], {
+                // Run inside the framework package so `proper-lockfile`
+                // resolves via its local node_modules.
+                cwd: FRAMEWORK_ROOT,
+                stdio: 'ignore',
+                env: process.env,
+            });
+            cp.on('exit', (code) => code === 0 ? resolvePromise() : reject(new Error('child exit ' + code)));
+            cp.on('error', reject);
+        });
+        await Promise.all(Array.from({ length: 5 }, () => spawnOnce()));
+        const final = JSON.parse(readFileSync(target, 'utf-8'));
+        expect(final.n).toBe(5);
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('emits a structured lock_timeout event when retries are exhausted', async () => {
+        const root = mkdtempSync(join(tmpdir(), 'apt-lock-timeout-'));
+        const eventsDir = join(root, '.aperant', 'events');
+        const target = join(root, 'held.json');
+        writeFileSync(target, '{}');
+        const properLockfile = (await import('proper-lockfile')).default;
+        const release = await properLockfile.lock(target, {
+            stale: 60_000,
+            realpath: false,
+            retries: 0,
+        });
+        try {
+            await expect(withLock(target, async () => {
+                /* never reached */
+            }, {
+                projectRoot: root,
+                retries: 2,
+                retryDelayMs: 10,
+                maxRetryDelayMs: 20,
+                stale: 60_000,
+            })).rejects.toThrow();
+        }
+        finally {
+            try {
+                await release();
+            }
+            catch {
+                /* */
+            }
+        }
+        const files = existsSync(eventsDir) ? readdirSync(eventsDir) : [];
+        expect(files.some((f) => f.startsWith('lock_timeout_'))).toBe(true);
+        rmSync(root, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=lock-proper-lockfile.test.js.map

package/dist/__tests__/lock-proper-lockfile.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-proper-lockfile.test.js","sourceRoot":"","sources":["../../src/__tests__/lock-proper-lockfile.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,SAAS,aAAa,CAAC,CAAS;IAC/B,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7B,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AACrD,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAErD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAA;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;QACxC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAE/C,MAAM,QAAQ,GAAG,GAAG,EAAE,CACrB,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;YACvD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAC1C,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;YACZ,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7C,CAAC,CAAC,CAAA;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QAE/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACxB,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;QACxC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAE/C,qEAAqE;QACrE,sEAAsE;QACtE,iEAAiE;QACjE,qBAAqB;QACrB,MAAM,kBAAkB,GAAG,OAAO,CACjC,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,UAAU,CACV,CAAA;QACD,MAAM,SAAS,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAA;QACnD,MAAM,QAAQ,GAAG;gCACa,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;GAmBtD,CAAA;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;QACxC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAElC,MAAM,SAAS,GAAG,GAAG,EAAE,CACtB,IAAI,OAAO,CAAO,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE;YAC5C,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;gBACvD,wDAAwD;gBACxD,uCAAuC;gBACvC,GAAG,EAAE,cAAc;gBACnB,KAAK,EAAE,QAAQ;gBACf,GAAG,EAAE,OAAO,CAAC,GAAG;aAChB,CAAC,CAAA;YACF,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CACvE,CAAA;YACD,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAEvB,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAA;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QACtC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAE3B,MAAM,cAAc,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAA;QAChE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE;YACjD,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,CAAC;SACV,CAAC,CAAA;QACF,IAAI,CAAC;YACJ,MAAM,MAAM,CACX,QAAQ,CACP,MAAM,EACN,KAAK,IAAI,EAAE;gBACV,mBAAmB;YACpB,CAAC,EACD;gBACC,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,CAAC;gBACV,YAAY,EAAE,EAAE;gBAChB,eAAe,EAAE,EAAE;gBACnB,KAAK,EAAE,MAAM;aACb,CACD,CACD,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;QACpB,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC;gBACJ,MAAM,OAAO,EAAE,CAAA;YAChB,CAAC;YAAC,MAAM,CAAC;gBACR,KAAK;YACN,CAAC;QACF,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACjE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEnE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/manifest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.test.d.ts.map

package/dist/__tests__/manifest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/manifest.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/manifest.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, it } from 'vitest';
+import { APERANT_MANIFEST } from '../manifest.js';
+describe('APERANT_MANIFEST', () => {
+    it('has correct id and name', () => {
+        expect(APERANT_MANIFEST.id).toBe('aperant');
+        expect(APERANT_MANIFEST.name).toBe('Aperant Framework');
+    });
+    it('has all 4 lifecycle stages', () => {
+        expect(APERANT_MANIFEST.stages).toHaveLength(4);
+        const stageNames = APERANT_MANIFEST.stages.map((s) => s.stage);
+        expect(stageNames).toEqual(['context', 'plan', 'execute', 'verify']);
+    });
+    it('every stage has artifacts and mapper path', () => {
+        for (const stage of APERANT_MANIFEST.stages) {
+            expect(stage.artifacts.length).toBeGreaterThan(0);
+            expect(stage.mapper).toContain('aperant-mapper');
+        }
+    });
+    it('has runtime pointing to apt-tools', () => {
+        expect(APERANT_MANIFEST.runtime).toContain('apt-tools');
+    });
+    it('artifact declarations have required fields', () => {
+        for (const stage of APERANT_MANIFEST.stages) {
+            for (const artifact of stage.artifacts) {
+                expect(artifact.nativeName).toBeTruthy();
+                expect(artifact.role).toBeTruthy();
+                expect(['markdown', 'json', 'yaml']).toContain(artifact.format);
+            }
+        }
+    });
+});
+//# sourceMappingURL=manifest.test.js.map

package/dist/__tests__/manifest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.test.js","sourceRoot":"","sources":["../../src/__tests__/manifest.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC3C,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAC9D,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACpD,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;YACjD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;QACjD,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACrD,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;YAC7C,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAA;gBACxC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAA;gBAClC,MAAM,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAChE,CAAC;QACF,CAAC;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/milestone-rollup.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * milestone-rollup.test.ts — truth table + applyRollup + writeRollup integration.
+ *
+ * Covers AC8 (CLI rollup), AC9 (5-row truth table), AC10 (lifecycle integration).
+ */
+export {};
+//# sourceMappingURL=milestone-rollup.test.d.ts.map

package/dist/__tests__/milestone-rollup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-rollup.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/milestone-rollup.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}