@aperant/framework 0.6.2

package/dist/__tests__/bootstrap-detect-mode.test.js.map

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

package/dist/__tests__/bootstrap-product-context-sidecar.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * bootstrap-product-context-sidecar.test.ts — coverage for
+ * cli/bootstrap/product-context-sidecar.mjs (C47 D-01).
+ *
+ * Pins the PROJECT.md → product-context.json derivation: the 7 canonical
+ * sections (D-06) parse correctly, confidence comments are extracted and
+ * stripped, missing sections produce empty defaults, and the output satisfies
+ * the shape required by the C44 product-context schema.
+ */
+export {};
+//# sourceMappingURL=bootstrap-product-context-sidecar.test.d.ts.map

package/dist/__tests__/bootstrap-product-context-sidecar.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-product-context-sidecar.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bootstrap-product-context-sidecar.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/bootstrap-product-context-sidecar.test.js

@@ -0,0 +1,145 @@
+/**
+ * bootstrap-product-context-sidecar.test.ts — coverage for
+ * cli/bootstrap/product-context-sidecar.mjs (C47 D-01).
+ *
+ * Pins the PROJECT.md → product-context.json derivation: the 7 canonical
+ * sections (D-06) parse correctly, confidence comments are extracted and
+ * stripped, missing sections produce empty defaults, and the output satisfies
+ * the shape required by the C44 product-context schema.
+ */
+import { describe, expect, it } from 'vitest';
+import { CANONICAL_SECTIONS, deriveSidecar } from '../cli/bootstrap/product-context-sidecar.mjs';
+function makeProjectMd({ name = 'Aperant', coreValue = 'The first AI coding framework that covers the full software lifecycle.', scopeIn = ['Plan', 'Execute', 'Verify'], scopeOut = ['Hosting', 'Billing'], context = 'Early-stage two-founder team.', personas = 'See .aperant/personas.json', constraints = ['TypeScript strict', 'No time estimates'], keyDecisions = ['Single source of truth: PROJECT.md'], confidenceBlock = '', } = {}) {
+    return [
+        `# ${name}`,
+        '',
+        '## What This Is',
+        `**${name}** — an agentic IDE.`,
+        confidenceBlock,
+        '',
+        '## Core Value',
+        coreValue,
+        '',
+        '## Scope',
+        '### In',
+        ...scopeIn.map((s) => `- ${s}`),
+        '### Out',
+        ...scopeOut.map((s) => `- ${s}`),
+        '',
+        '## Context',
+        context,
+        '',
+        '## Personas',
+        personas,
+        '',
+        '## Constraints',
+        ...constraints.map((s) => `- ${s}`),
+        '',
+        '## Key Decisions',
+        ...keyDecisions.map((s) => `- ${s}`),
+        '',
+    ].join('\n');
+}
+describe('deriveSidecar — PROJECT.md → product-context.json (D-01)', () => {
+    it('covers all 7 D-06 canonical sections in a single pass', () => {
+        const md = makeProjectMd();
+        const sidecar = deriveSidecar(md);
+        expect(sidecar.productName).toBe('Aperant');
+        expect(sidecar.productDescription).toMatch(/first AI coding framework/);
+        expect(sidecar.scopeIn).toEqual(['Plan', 'Execute', 'Verify']);
+        expect(sidecar.scopeOut).toEqual(['Hosting', 'Billing']);
+        expect(sidecar.context).toMatch(/two-founder/);
+        expect(sidecar.personasRef).toBe('.aperant/personas.json');
+        expect(sidecar.constraints).toEqual(['TypeScript strict', 'No time estimates']);
+        expect(sidecar.keyDecisions).toEqual(['Single source of truth: PROJECT.md']);
+    });
+    it('emits a valid product-context schema subset (productName/Description/targetAudience/features)', () => {
+        const md = makeProjectMd();
+        const sidecar = deriveSidecar(md);
+        expect(typeof sidecar.productName).toBe('string');
+        expect(sidecar.productName.length).toBeGreaterThan(0);
+        expect(typeof sidecar.productDescription).toBe('string');
+        expect(typeof sidecar.targetAudience).toBe('string');
+        expect(Array.isArray(sidecar.features)).toBe(true);
+        for (const f of sidecar.features) {
+            expect(typeof f.id).toBe('string');
+            expect(typeof f.name).toBe('string');
+            expect(f.id.length).toBeGreaterThan(0);
+            expect(f.name.length).toBeGreaterThan(0);
+        }
+    });
+    it('derives features from scopeIn when a Features section is absent', () => {
+        const md = makeProjectMd({ scopeIn: ['Plan', 'Execute', 'Verify'] });
+        const sidecar = deriveSidecar(md);
+        expect(sidecar.features.map((f) => f.name)).toEqual(['Plan', 'Execute', 'Verify']);
+        // Ids are unique + slugified.
+        const ids = sidecar.features.map((f) => f.id);
+        expect(new Set(ids).size).toBe(ids.length);
+        expect(ids.every((id) => /^[a-z0-9-]+$/.test(id))).toBe(true);
+    });
+    it('extracts inline description from "Name — description" bullets', () => {
+        const md = makeProjectMd({
+            scopeIn: ['Plan — spec and plan a task', 'Execute — run the plan'],
+        });
+        const sidecar = deriveSidecar(md);
+        expect(sidecar.features).toEqual([
+            { id: 'plan', name: 'Plan', description: 'spec and plan a task' },
+            { id: 'execute', name: 'Execute', description: 'run the plan' },
+        ]);
+    });
+    it('extracts confidence markers and strips them from the body', () => {
+        const md = makeProjectMd({
+            confidenceBlock: '<!-- confidence: medium | evidence: README.md:1-20 -->',
+        });
+        const sidecar = deriveSidecar(md);
+        expect(sidecar._confidence).toMatchObject({
+            what_this_is: { level: 'medium', evidence: 'README.md:1-20' },
+        });
+        // The context/body must not leak the HTML comment.
+        expect(sidecar.productDescription).not.toMatch(/confidence:/);
+    });
+    it('handles missing sections without throwing; emits empty defaults', () => {
+        const md = '# Unnamed\n\n## What This Is\nA product of some kind.\n';
+        const sidecar = deriveSidecar(md);
+        expect(sidecar.productName).toBeTruthy();
+        expect(sidecar.scopeIn).toEqual([]);
+        expect(sidecar.scopeOut).toEqual([]);
+        expect(sidecar.features).toEqual([]);
+        expect(sidecar.constraints).toEqual([]);
+        expect(sidecar.keyDecisions).toEqual([]);
+        expect(sidecar.personasRef).toBeNull();
+    });
+    it('falls back to package name when PROJECT.md has no leading bold/colon line', () => {
+        const md = '# Title\n\n## What This Is\nWe build things.\n\n## Core Value\nProductivity.\n';
+        const sidecar = deriveSidecar(md, { packageName: '@scope/my-thing' });
+        // "We build things." is a short first line so it qualifies as a name.
+        // The fallback only kicks in when the first-line is empty or overlong.
+        expect(sidecar.productName.length).toBeGreaterThan(0);
+    });
+    it('derives personasRef from a content mention even with no explicit path', () => {
+        const md = makeProjectMd({ personas: 'Our target users are agentic IDE operators.' });
+        const sidecar = deriveSidecar(md);
+        expect(sidecar.personasRef).toBe('.aperant/personas.json');
+    });
+    it('writes an ISO timestamp into _meta.updatedAt when unspecified', () => {
+        const sidecar = deriveSidecar(makeProjectMd());
+        expect(sidecar._meta.source).toBe('PROJECT.md');
+        expect(sidecar._meta.updatedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+    it('honors an injected `now` for deterministic tests', () => {
+        const sidecar = deriveSidecar(makeProjectMd(), { now: '2026-04-22T12:00:00.000Z' });
+        expect(sidecar._meta.updatedAt).toBe('2026-04-22T12:00:00.000Z');
+    });
+    it('exports the canonical section list for downstream consumers', () => {
+        expect(CANONICAL_SECTIONS).toEqual([
+            'What This Is',
+            'Core Value',
+            'Scope',
+            'Context',
+            'Personas',
+            'Constraints',
+            'Key Decisions',
+        ]);
+    });
+});
+//# sourceMappingURL=bootstrap-product-context-sidecar.test.js.map

package/dist/__tests__/bootstrap-product-context-sidecar.test.js.map

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

package/dist/__tests__/bootstrap-recon.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * bootstrap-recon.test.ts — unit coverage for cli/bootstrap/recon.mjs (C47).
+ *
+ * Pins the D-02 allowlist behavior: the recon pass reads exactly the set of
+ * signals defined in the context file and gracefully handles missing files.
+ *
+ * No subprocess spawning for git — we create a real git repo in a tmp dir
+ * using execFileSync so the test validates the real path (not a mocked one).
+ */
+export {};
+//# sourceMappingURL=bootstrap-recon.test.d.ts.map

package/dist/__tests__/bootstrap-recon.test.d.ts.map

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

package/dist/__tests__/bootstrap-recon.test.js

@@ -0,0 +1,136 @@
+/**
+ * bootstrap-recon.test.ts — unit coverage for cli/bootstrap/recon.mjs (C47).
+ *
+ * Pins the D-02 allowlist behavior: the recon pass reads exactly the set of
+ * signals defined in the context file and gracefully handles missing files.
+ *
+ * No subprocess spawning for git — we create a real git repo in a tmp dir
+ * using execFileSync so the test validates the real path (not a mocked one).
+ */
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { READ_CAP_BYTES, runRecon } from '../cli/bootstrap/recon.mjs';
+let root;
+beforeEach(() => {
+    root = mkdtempSync(join(tmpdir(), 'apt-c47-recon-'));
+});
+afterEach(() => {
+    try {
+        rmSync(root, { recursive: true, force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+});
+describe('runRecon — D-02 allowlist', () => {
+    it('handles a completely empty directory without throwing', () => {
+        const res = runRecon(root);
+        expect(res.projectDir).toBe(root);
+        expect(res.readme.present).toBe(false);
+        expect(res.claudeMd.present).toBe(false);
+        expect(res.agentsMd.present).toBe(false);
+        expect(res.packageJson.present).toBe(false);
+        expect(res.packageJson.data).toBeNull();
+        expect(res.topLevelFolders).toEqual([]);
+        expect(res.gitRemoteUrl).toBeNull();
+        expect(res.firstCommitMessage).toBeNull();
+    });
+    it('reads README.md, CLAUDE.md, AGENTS.md bodies when present', () => {
+        writeFileSync(join(root, 'README.md'), '# Hello\n\nSample product.\n', 'utf-8');
+        writeFileSync(join(root, 'CLAUDE.md'), '## Project\n\nClaude instructions.\n', 'utf-8');
+        writeFileSync(join(root, 'AGENTS.md'), 'Constitution.\n', 'utf-8');
+        const res = runRecon(root);
+        expect(res.readme.present).toBe(true);
+        expect(res.readme.body).toMatch(/Hello/);
+        expect(res.readme.truncated).toBe(false);
+        expect(res.claudeMd.present).toBe(true);
+        expect(res.claudeMd.body).toMatch(/Claude instructions/);
+        expect(res.agentsMd.present).toBe(true);
+    });
+    it('truncates markdown bodies at the 8KB cap and flags the truncation', () => {
+        const oversized = '# Big\n' + 'a'.repeat(READ_CAP_BYTES + 500);
+        writeFileSync(join(root, 'README.md'), oversized, 'utf-8');
+        const res = runRecon(root);
+        expect(res.readme.present).toBe(true);
+        expect(res.readme.body?.length).toBe(READ_CAP_BYTES);
+        expect(res.readme.truncated).toBe(true);
+    });
+    it('extracts only the allowlisted package.json fields', () => {
+        writeFileSync(join(root, 'package.json'), JSON.stringify({
+            name: '@scope/thing',
+            version: '1.2.3',
+            description: 'A helpful CLI tool.',
+            keywords: ['cli', 'productivity'],
+            repository: { type: 'git', url: 'https://github.com/me/thing.git' },
+            dependencies: { react: '^19.0.0' },
+            scripts: { test: 'vitest' },
+        }), 'utf-8');
+        const res = runRecon(root);
+        expect(res.packageJson.present).toBe(true);
+        expect(res.packageJson.data).toEqual({
+            name: '@scope/thing',
+            description: 'A helpful CLI tool.',
+            keywords: ['cli', 'productivity'],
+            repository: 'https://github.com/me/thing.git',
+        });
+    });
+    it('accepts repository as a bare string', () => {
+        writeFileSync(join(root, 'package.json'), JSON.stringify({ name: 'x', repository: 'github:me/thing' }), 'utf-8');
+        const res = runRecon(root);
+        expect(res.packageJson.data?.repository).toBe('github:me/thing');
+    });
+    it('returns null package data on malformed JSON without throwing', () => {
+        writeFileSync(join(root, 'package.json'), '{ not valid json', 'utf-8');
+        const res = runRecon(root);
+        expect(res.packageJson.present).toBe(true);
+        expect(res.packageJson.data).toBeNull();
+    });
+    it('lists top-level folders one level deep, skipping hidden and ignored', () => {
+        mkdirSync(join(root, 'apps'));
+        mkdirSync(join(root, 'packages'));
+        mkdirSync(join(root, 'node_modules'));
+        mkdirSync(join(root, '.github'));
+        mkdirSync(join(root, '.aperant'));
+        mkdirSync(join(root, 'apps', 'desktop')); // should NOT be reported — one level only
+        const res = runRecon(root);
+        expect(res.topLevelFolders.sort()).toEqual(['apps', 'packages']);
+    });
+    it('captures git remote URL and first commit message when git is available', () => {
+        // Create a real git repo with one commit + origin remote.
+        execFileSync('git', ['init'], { cwd: root, stdio: 'ignore' });
+        execFileSync('git', ['config', 'user.email', 'test@example.com'], {
+            cwd: root,
+            stdio: 'ignore',
+        });
+        execFileSync('git', ['config', 'user.name', 'Test User'], { cwd: root, stdio: 'ignore' });
+        execFileSync('git', ['config', 'commit.gpgsign', 'false'], { cwd: root, stdio: 'ignore' });
+        writeFileSync(join(root, 'a.txt'), 'hello', 'utf-8');
+        execFileSync('git', ['add', '.'], { cwd: root, stdio: 'ignore' });
+        execFileSync('git', ['commit', '-m', 'chore: initial scaffold'], {
+            cwd: root,
+            stdio: 'ignore',
+            env: {
+                ...process.env,
+                GIT_AUTHOR_DATE: '2026-01-01T00:00:00Z',
+                GIT_COMMITTER_DATE: '2026-01-01T00:00:00Z',
+            },
+        });
+        execFileSync('git', ['remote', 'add', 'origin', 'https://example.com/me/repo.git'], {
+            cwd: root,
+            stdio: 'ignore',
+        });
+        const res = runRecon(root);
+        expect(res.gitRemoteUrl).toBe('https://example.com/me/repo.git');
+        expect(res.firstCommitMessage).toBe('chore: initial scaffold');
+    });
+    it('emits a note when the project has no .git directory', () => {
+        const res = runRecon(root);
+        expect(res.notes.some((n) => n.includes('no .git'))).toBe(true);
+        expect(res.gitRemoteUrl).toBeNull();
+        expect(res.firstCommitMessage).toBeNull();
+    });
+});
+//# sourceMappingURL=bootstrap-recon.test.js.map

package/dist/__tests__/bootstrap-recon.test.js.map

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

package/dist/__tests__/build-progress-sync.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * build-progress-sync.test.ts — atomicity + idempotency + replay coverage
+ * for the build-progress ↔ plan sync helper (C33).
+ *
+ * AC1: single-id path flips plan + appends progress
+ * AC2: consolidated-id expansion ("E1+E2" → both flipped, constituent_ids recorded)
+ * AC3: idempotent re-run returns already_complete
+ * AC23: 19-04-26 reference-task replay — 29 subtasks, all flipped to completed
+ */
+export {};
+//# sourceMappingURL=build-progress-sync.test.d.ts.map

package/dist/__tests__/build-progress-sync.test.d.ts.map

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

package/dist/__tests__/build-progress-sync.test.js

@@ -0,0 +1,275 @@
+/**
+ * build-progress-sync.test.ts — atomicity + idempotency + replay coverage
+ * for the build-progress ↔ plan sync helper (C33).
+ *
+ * AC1: single-id path flips plan + appends progress
+ * AC2: consolidated-id expansion ("E1+E2" → both flipped, constituent_ids recorded)
+ * AC3: idempotent re-run returns already_complete
+ * AC23: 19-04-26 reference-task replay — 29 subtasks, all flipped to completed
+ */
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { completeSubtask, parseConsolidatedId } from '../cli/task/build-progress-sync.mjs';
+function seedFixture(tmpRoot, taskId, plan, progress) {
+    const taskDir = join(tmpRoot, '.aperant', 'tasks', taskId);
+    mkdirSync(taskDir, { recursive: true });
+    const planPath = join(taskDir, 'implementation_plan.json');
+    const progressPath = join(taskDir, 'build-progress.json');
+    writeFileSync(planPath, JSON.stringify(plan, null, 2));
+    if (progress !== null) {
+        writeFileSync(progressPath, JSON.stringify(progress, null, 2));
+    }
+    return { projectDir: tmpRoot, planPath, progressPath };
+}
+function readPlan(path) {
+    return JSON.parse(readFileSync(path, 'utf-8'));
+}
+function readProgress(path) {
+    return JSON.parse(readFileSync(path, 'utf-8'));
+}
+describe('parseConsolidatedId', () => {
+    it('expands E1+E2+F3 into [E1, E2, F3]', () => {
+        expect(parseConsolidatedId('E1+E2+F3')).toEqual(['E1', 'E2', 'F3']);
+    });
+    it('single id passes through', () => {
+        expect(parseConsolidatedId('S1')).toEqual(['S1']);
+    });
+    it('accepts legacy sub-1-2 style', () => {
+        expect(parseConsolidatedId('sub-1-2')).toEqual(['sub-1-2']);
+    });
+    it('throws on empty string', () => {
+        expect(() => parseConsolidatedId('')).toThrow(/empty id/);
+    });
+    it('throws on empty fragment inside consolidation', () => {
+        expect(() => parseConsolidatedId('E1++E2')).toThrow(/empty fragment/);
+    });
+    it('throws on non-id chars', () => {
+        expect(() => parseConsolidatedId('🤖')).toThrow(/invalid fragment/);
+    });
+    it('deduplicates repeated constituents', () => {
+        expect(parseConsolidatedId('A1+A1+B2')).toEqual(['A1', 'B2']);
+    });
+});
+describe('completeSubtask — AC1 single-id', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-bps-'));
+    });
+    afterEach(() => rmSync(tmp, { recursive: true, force: true }));
+    it('flips plan + appends to build-progress atomically', () => {
+        const { projectDir, planPath, progressPath } = seedFixture(tmp, 'test-task', {
+            task: 'test',
+            subtasks: [
+                { id: 'S1', status: 'pending' },
+                { id: 'S2', status: 'pending' },
+                { id: 'S3', status: 'pending' },
+            ],
+        }, { task_id: 'test-task', completed_subtasks: [], pending_subtasks: ['S1', 'S2', 'S3'] });
+        const result = completeSubtask({
+            projectDir,
+            taskId: 'test-task',
+            subtaskId: 'S1',
+            commit: 'abc123',
+        });
+        expect(result.status).toBe('ok');
+        expect(result.plan_updates).toBe(1);
+        expect(result.progress_updates).toBe(1);
+        const plan = readPlan(planPath);
+        expect(plan.subtasks.find((s) => s.id === 'S1')?.status).toBe('completed');
+        expect(plan.subtasks.find((s) => s.id === 'S2')?.status).toBe('pending');
+        expect(plan.subtasks.find((s) => s.id === 'S3')?.status).toBe('pending');
+        const progress = readProgress(progressPath);
+        expect(progress.completed_subtasks).toHaveLength(1);
+        expect(progress.completed_subtasks[0].id).toBe('S1');
+        expect(progress.completed_subtasks[0].commit).toBe('abc123');
+        expect(progress.completed_subtasks[0].completed_at).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/);
+        expect(progress.pending_subtasks).not.toContain('S1');
+    });
+});
+describe('completeSubtask — AC2 consolidated-id', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-bps-'));
+    });
+    afterEach(() => rmSync(tmp, { recursive: true, force: true }));
+    it('expands E1+E2 and flips both', () => {
+        const { projectDir, planPath, progressPath } = seedFixture(tmp, 'test-task', {
+            task: 'test',
+            subtasks: [
+                { id: 'E1', status: 'pending' },
+                { id: 'E2', status: 'pending' },
+                { id: 'F1', status: 'pending' },
+                { id: 'F2', status: 'pending' },
+                { id: 'F3', status: 'pending' },
+            ],
+        }, {
+            task_id: 'test-task',
+            completed_subtasks: [],
+            pending_subtasks: ['E1', 'E2', 'F1', 'F2', 'F3'],
+        });
+        const result = completeSubtask({
+            projectDir,
+            taskId: 'test-task',
+            subtaskId: 'E1+E2',
+            commit: 'sha1',
+        });
+        expect(result.plan_updates).toBe(2);
+        expect(result.constituent_ids).toEqual(['E1', 'E2']);
+        const plan = readPlan(planPath);
+        expect(plan.subtasks.find((s) => s.id === 'E1')?.status).toBe('completed');
+        expect(plan.subtasks.find((s) => s.id === 'E2')?.status).toBe('completed');
+        expect(plan.subtasks.find((s) => s.id === 'F1')?.status).toBe('pending');
+        const progress = readProgress(progressPath);
+        expect(progress.completed_subtasks).toHaveLength(1);
+        expect(progress.completed_subtasks[0].id).toBe('E1+E2');
+        expect(progress.completed_subtasks[0].constituent_ids).toEqual(['E1', 'E2']);
+    });
+});
+describe('completeSubtask — AC3 idempotent', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-bps-'));
+    });
+    afterEach(() => rmSync(tmp, { recursive: true, force: true }));
+    it('second call returns already_complete with no double-append', () => {
+        const { projectDir, progressPath } = seedFixture(tmp, 'test-task', {
+            task: 'test',
+            subtasks: [
+                { id: 'S1', status: 'pending' },
+                { id: 'S2', status: 'pending' },
+            ],
+        }, { task_id: 'test-task', completed_subtasks: [] });
+        completeSubtask({ projectDir, taskId: 'test-task', subtaskId: 'S1', commit: 'sha1' });
+        const second = completeSubtask({
+            projectDir,
+            taskId: 'test-task',
+            subtaskId: 'S1',
+            commit: 'sha2',
+        });
+        expect(second.already_complete).toBe(true);
+        expect(second.progress_updates).toBe(0);
+        const progress = readProgress(progressPath);
+        expect(progress.completed_subtasks).toHaveLength(1);
+    });
+    it('consolidated re-run detects all constituents already complete', () => {
+        const { projectDir, progressPath } = seedFixture(tmp, 'test-task', {
+            task: 'test',
+            subtasks: [
+                { id: 'E1', status: 'pending' },
+                { id: 'E2', status: 'pending' },
+            ],
+        }, { task_id: 'test-task', completed_subtasks: [] });
+        completeSubtask({ projectDir, taskId: 'test-task', subtaskId: 'E1+E2', commit: 'sha1' });
+        const second = completeSubtask({
+            projectDir,
+            taskId: 'test-task',
+            subtaskId: 'E1+E2',
+            commit: 'sha2',
+        });
+        expect(second.already_complete).toBe(true);
+        const progress = readProgress(progressPath);
+        expect(progress.completed_subtasks).toHaveLength(1);
+    });
+});
+describe('completeSubtask — error cases', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-bps-'));
+    });
+    afterEach(() => rmSync(tmp, { recursive: true, force: true }));
+    it('throws on unknown constituent id', () => {
+        const { projectDir } = seedFixture(tmp, 'test-task', { task: 'test', subtasks: [{ id: 'S1', status: 'pending' }] }, { task_id: 'test-task', completed_subtasks: [] });
+        expect(() => completeSubtask({ projectDir, taskId: 'test-task', subtaskId: 'S99' })).toThrow(/not in plan/);
+    });
+    it('throws on missing plan file', () => {
+        expect(() => completeSubtask({ projectDir: tmp, taskId: 'no-such-task', subtaskId: 'S1' })).toThrow(/plan not found/);
+    });
+});
+describe('completeSubtask — AC23 replay of a 29-subtask plan', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-bps-'));
+    });
+    afterEach(() => rmSync(tmp, { recursive: true, force: true }));
+    it('applies a 27-entry build-progress (with 6 consolidated ids) and ends with 29 completed subtasks', () => {
+        // Synthetic version of the 19-04-26 reference — 29 subtasks, 21 commits,
+        // 6 of which are consolidated (total expansion = 29).
+        const subtaskIds = [
+            'A1',
+            'A2',
+            'A3',
+            'B1',
+            'B2',
+            'B3',
+            'C1',
+            'C2',
+            'C3',
+            'C4',
+            'C5',
+            'D1',
+            'D2',
+            'D3',
+            'E1',
+            'E2',
+            'E3',
+            'F1',
+            'F2',
+            'F3',
+            'G1',
+            'G2',
+            'H1',
+            'H2',
+            'I1',
+            'I2',
+            'J1',
+            'J2',
+            'J3',
+        ];
+        expect(subtaskIds).toHaveLength(29);
+        const plan = {
+            task: 'reference-replay',
+            subtasks: subtaskIds.map((id) => ({ id, status: 'pending' })),
+        };
+        const { projectDir, planPath } = seedFixture(tmp, 'replay-task', plan, {
+            task_id: 'replay-task',
+            completed_subtasks: [],
+            pending_subtasks: subtaskIds.slice(),
+        });
+        // 21 commits mapping to 29 subtasks via 6 consolidations.
+        // 29 - 21 = 8 extra ids; we consolidate them into 6 bundles.
+        const commits = [
+            'A1',
+            'A2+A3',
+            'B1',
+            'B2+B3',
+            'C1',
+            'C2',
+            'C3+C4+C5',
+            'D1+D2',
+            'D3',
+            'E1',
+            'E2',
+            'E3',
+            'F1+F2+F3',
+            'G1+G2',
+            'H1',
+            'H2',
+            'I1',
+            'I2',
+            'J1',
+            'J2',
+            'J3',
+        ];
+        expect(commits).toHaveLength(21);
+        for (const id of commits) {
+            completeSubtask({ projectDir, taskId: 'replay-task', subtaskId: id });
+        }
+        const after = readPlan(planPath);
+        const allCompleted = after.subtasks.every((s) => s.status === 'completed');
+        expect(allCompleted).toBe(true);
+        expect(after.subtasks.filter((s) => s.status === 'completed')).toHaveLength(29);
+    });
+});
+//# sourceMappingURL=build-progress-sync.test.js.map