@aperant/framework 0.6.2

package/bin/apt-tools.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+
+/**
+ * apt-tools — Deterministic CLI kernel for @aperant/framework
+ *
+ * Handles operations that the LLM should never do itself (file I/O, git, state).
+ * All output is JSON to stdout. No external dependencies — pure Node.js.
+ *
+ * Usage: apt-tools <command> [args]
+ *
+ * Layer 3 of the post-refactor architecture (D-04). Owns: argv parsing,
+ * gitignore-drift warning, --help / --version, and the IS_CLI_ENTRYPOINT
+ * guard. The DISPATCH map + wrap() helper live in
+ * ../src/cli/dispatch.mjs; every command body lives under
+ * ../src/cli/commands/{command}.mjs.
+ *
+ * The `parseAcceptanceCriteria` / `resolveSpecPath` re-exports below preserve
+ * the test-time import surface that existed before the C29/C30 modularization
+ * refactors. Canonical home (C30): src/cli/coverage-check/acceptance-criteria.mjs.
+ */
+
+import { realpathSync } from 'node:fs'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { emitDriftWarningIfAny } from '../src/cli/config/gitignore-drift.mjs'
+import { maybeSweepShippedMergedTasks } from '../src/cli/config/post-merge-sweep.mjs'
+import { DISPATCH } from '../src/cli/dispatch.mjs'
+import { printHelp } from '../src/cli/help.mjs'
+import { fail, getVersion } from '../src/cli/util/io.mjs'
+
+// When imported (e.g. from a unit test via `await import(...)`) we want the
+// named helper exports to be usable without the CLI dispatch at the bottom of
+// this file taking over the test runner's argv. This flag gates the dispatch.
+const IS_CLI_ENTRYPOINT = (() => {
+	try {
+		if (!process.argv[1]) return false
+		const invokedPath = realpathSync(process.argv[1])
+		const currentPath = realpathSync(fileURLToPath(import.meta.url))
+		return pathToFileURL(currentPath).href === pathToFileURL(invokedPath).href
+	} catch {
+		return false
+	}
+})()
+
+// ---------------------------------------------------------------------------
+// Named exports — for in-process unit testing of pure helpers.
+// Keep surface area minimal: only helpers that are useful in isolation.
+// ---------------------------------------------------------------------------
+
+export {
+	parseAcceptanceCriteria,
+	resolveSpecPath,
+} from '../src/cli/coverage-check/acceptance-criteria.mjs'
+
+// ---------------------------------------------------------------------------
+// Dispatch
+// ---------------------------------------------------------------------------
+
+// Only run the CLI dispatch when this file is invoked as the entrypoint.
+// When imported by tests (`await import('./apt-tools.mjs')`) we skip dispatch
+// so the test runner's argv does not get interpreted as an apt-tools command.
+if (IS_CLI_ENTRYPOINT) {
+	const args = process.argv.slice(2)
+	const command = args[0]
+
+	// C34a — non-blocking drift warning when `.aperant/.gitignore` no longer
+	// matches the policy-expected template. Skipped for hot-path commands,
+	// silenced by `APT_SUPPRESS_GITIGNORE_DRIFT=1`, never throws.
+	try {
+		emitDriftWarningIfAny(process.cwd(), command)
+	} catch {
+		/* never block user command on drift check */
+	}
+
+	// C57 Piece 2 — passive post-merge sweep. On every dispatch (modulo
+	// allowlist + cooldown + recursion guards), check if any task is stuck
+	// in `shipped-pending-merge` and spawn a detached `task close-merged`
+	// child to poll `gh pr view` and clean them up. Same fail-soft contract
+	// as the gitignore-drift hook: silenced by APT_SUPPRESS_MERGE_SWEEP=1,
+	// recursion-guarded by APT_INTERNAL_MERGE_SWEEP=1, never throws.
+	try {
+		maybeSweepShippedMergedTasks(process.cwd(), command)
+	} catch {
+		/* never block user command on merge sweep */
+	}
+
+	if (!command || command === '--help' || command === '-h') {
+		printHelp()
+		process.exit(0)
+	}
+
+	if (command === '--version' || command === '-v') {
+		process.stdout.write(getVersion() + '\n')
+		process.exit(0)
+	}
+
+	const handler = DISPATCH[command]
+	if (handler) {
+		// All handlers return a Promise. wrap() handles output(),
+		// process.exit(), and synchronous-error → fail() conversion. Top-level
+		// .catch keeps unhandled rejections out of the event loop.
+		handler(args).catch((err) => {
+			fail(err && err.message ? err.message : String(err))
+		})
+	} else {
+		fail(`Unknown command: ${command}. Run apt-tools --help for usage.`)
+	}
+} // end if (IS_CLI_ENTRYPOINT)

package/context/installed/verification.md

@@ -0,0 +1,47 @@
+# Verification Context Profile
+
+Agent mindset for proof verification. You are an adversarial QA engineer, not a helpful assistant.
+
+## Mindset
+
+- **Assume broken until proven otherwise.** A blinking cursor is not proof a terminal works. A rendered page is not proof interactions work. Prove each claim with actions.
+- **Test behavior, not appearance.** Screenshots of static states are meaningless. You must interact (type, click, submit) and capture the result.
+- **No hallucinated passes.** If you cannot verify something, mark it `blocked` or `skip` — never `pass`. A pass requires evidence of the expected behavior actually occurring.
+- **Every screenshot follows an action.** Never take a screenshot "of the page." Take a screenshot of what happened after you did something specific.
+
+## Verification Rules
+
+1. **Action → Evidence → Verdict.** For every test: perform the action, capture evidence (screenshot/terminal output), compare against expected, record verdict.
+2. **Type into inputs.** If a feature has an input field, type real text. If it has a submit button, click it. If it has a terminal, run a command.
+3. **Video captures the real session.** Start CDP capture BEFORE running tests so the video shows the actual test session. The video must reflect the same interactions as the screenshots.
+4. **AI analysis is mandatory AND critical.** Every screenshot must be analyzed adversarially. Describe what you ACTUALLY see — not what you expect. Look for:
+   - Rendering artifacts, stray characters, broken formatting
+   - Missing elements that should be present (prompts, paths, git branches)
+   - Visual quality compared to production expectations
+   - "The terminal shows a cursor" is NOT analysis. "The terminal shows a blinking cursor at (0,0) with no shell prompt — PTY not connected" IS analysis.
+5. **Failures are valuable.** Finding a bug during verification is a success. Hiding a bug is a failure. Report what you find honestly.
+6. **Test exhaustively, not superficially.** If a settings panel has 5 sliders, test all 5 — not just "settings panel opens." If a toolbar has 4 buttons, test all 4. Surface-level "it renders" checks are worthless.
+7. **Read the code first.** Before writing tests, read the source code to discover ALL features. Do not guess what exists — enumerate from the implementation.
+8. **Write verification.json, not VERIFICATION.md.** JSON is the single source of truth. Never write a VERIFICATION.md file. The HTML report is generated from verification.json by the tooling — no markdown parsing involved.
+9. **Every test must have a registry_id linking to the feature registry.** Each test references exactly one sub-feature `id` from `.aperant/features/{area}.json`. This makes coverage tracking automatic and prevents orphaned tests.
+10. **Every untested registered feature must be in the skipped array with a reason.** Silence about untested features is not acceptable. Valid reasons: `time_constraint`, `blocked_by_platform`, `depends_on_other`, `not_applicable`. The sum of tested + skipped must equal the total registered sub-features.
+11. **Coverage below 50% is a workflow failure — add more tests before executing.** The coverage gate is enforced before test execution begins (step 4f). If fewer than half the registered sub-features have tests, stop and write more tests. Do not proceed with thin coverage.
+
+## Output Style
+
+- Terse, factual verdicts. No praise, no filler.
+- Group findings by severity: blocker → major → minor → cosmetic.
+- State what works AND what doesn't — confirm the good parts too.
+
+## Severity Inference
+
+Infer severity from observed behavior, never ask the user:
+
+| Observed | Severity |
+|----------|----------|
+| Crash, error, exception, blank screen, unresponsive | blocker |
+| Feature doesn't work, wrong output, missing element | major |
+| Works but slow, visual glitch, minor UX issue | minor |
+| Color, spacing, alignment, font, cosmetic difference | cosmetic |
+
+Default: **major** (safe default — downgrade only with evidence).

package/dist/__test-helpers/cmd-fixtures.d.mts

@@ -0,0 +1,44 @@
+/**
+ * Create a throwaway project dir with `.aperant/` initialized, run `fn(dir)`,
+ * and clean up on completion (success or throw). Mirrors `createTmpProject`
+ * + a `try/finally` rmSync, with a smaller surface — most in-process tests
+ * only need the dir path.
+ *
+ * @param {(dir: string) => unknown | Promise<unknown>} fn
+ * @param {{ gitInit?: boolean }} [opts]
+ * @returns {Promise<unknown>} fn's return value (await-friendly).
+ */
+export function withTempProject(fn: (dir: string) => unknown | Promise<unknown>, opts?: {
+    gitInit?: boolean;
+}): Promise<unknown>;
+/**
+ * Seed a task into .aperant/state.json's active_tasks map.
+ *
+ * @param {string} projectDir
+ * @param {{
+ *   id: string,
+ *   description?: string,
+ *   scope?: string,
+ *   milestone_id?: string | null,
+ *   phase_id?: string | null,
+ *   lifecycle_phase?: string,
+ * }} opts
+ */
+export function seedTask(projectDir: string, opts: {
+    id: string;
+    description?: string;
+    scope?: string;
+    milestone_id?: string | null;
+    phase_id?: string | null;
+    lifecycle_phase?: string;
+}): void;
+/**
+ * Toggle the auto_close_phase config flag — many task lifecycle tests
+ * exercise the close-phase cascade and need this flipped on.
+ *
+ * @param {string} projectDir
+ */
+export function enableAutoClosePhase(projectDir: string): void;
+/** Read state.json from a project dir. */
+export function readState(projectDir: any): any;
+//# sourceMappingURL=cmd-fixtures.d.mts.map

package/dist/__test-helpers/cmd-fixtures.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-fixtures.d.mts","sourceRoot":"","sources":["../../src/__test-helpers/cmd-fixtures.mjs"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,oCAJW,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAC3C;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACnB,OAAO,CAAC,OAAO,CAAC,CAmE5B;AAED;;;;;;;;;;;;GAYG;AACH,qCAVW,MAAM,QACN;IACN,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,QAgBH;AAED;;;;;GAKG;AACH,iDAFW,MAAM,QAQhB;AAED,0CAA0C;AAC1C,gDAEC"}

package/dist/__test-helpers/cmd-fixtures.mjs

@@ -0,0 +1,113 @@
+/**
+ * cmd-fixtures.mjs — shared builders for in-process unit tests.
+ *
+ * The integration test suite already has makeFixtureProject (TypeScript) and
+ * createTmpProject (TypeScript). Those keep their existing surface for
+ * subprocess tests. The new in-process Layer 1 tests use these JS-side
+ * helpers so they can be imported from `.mjs` test files alongside the
+ * cmd functions they exercise.
+ */
+import { spawnSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Create a throwaway project dir with `.aperant/` initialized, run `fn(dir)`,
+ * and clean up on completion (success or throw). Mirrors `createTmpProject`
+ * + a `try/finally` rmSync, with a smaller surface — most in-process tests
+ * only need the dir path.
+ *
+ * @param {(dir: string) => unknown | Promise<unknown>} fn
+ * @param {{ gitInit?: boolean }} [opts]
+ * @returns {Promise<unknown>} fn's return value (await-friendly).
+ */
+export async function withTempProject(fn, opts = {}) {
+    const dir = mkdtempSync(join(tmpdir(), 'apt-cmd-'));
+    const gitInit = opts.gitInit !== false;
+    if (gitInit) {
+        spawnSync('git', ['init', '-q', '-b', 'main'], { cwd: dir });
+        spawnSync('git', ['config', 'user.email', 'test@example.com'], { cwd: dir });
+        spawnSync('git', ['config', 'user.name', 'test'], { cwd: dir });
+        spawnSync('git', ['config', 'commit.gpgsign', 'false'], { cwd: dir });
+        writeFileSync(join(dir, 'README.md'), '# test\n');
+        spawnSync('git', ['add', 'README.md'], { cwd: dir });
+        spawnSync('git', ['commit', '-q', '-m', 'init'], { cwd: dir });
+    }
+    mkdirSync(join(dir, '.aperant'), { recursive: true });
+    mkdirSync(join(dir, '.aperant', 'tasks'), { recursive: true });
+    mkdirSync(join(dir, '.aperant', 'events'), { recursive: true });
+    mkdirSync(join(dir, '.aperant', 'locks'), { recursive: true });
+    mkdirSync(join(dir, '.aperant', 'roadmap'), { recursive: true });
+    mkdirSync(join(dir, '.aperant', 'roadmap', 'project'), { recursive: true });
+    const now = new Date().toISOString();
+    writeFileSync(join(dir, '.aperant', 'state.json'), `${JSON.stringify({
+        version: 1,
+        initialized_at: now,
+        last_activity: now,
+        active_tasks: {},
+        completed_tasks: [],
+        decisions: {},
+        has_tests: false,
+    }, null, 2)}\n`);
+    writeFileSync(join(dir, '.aperant', 'config.json'), `${JSON.stringify({ version: 3, autonomy_level: 2, project_type: 'monorepo' }, null, 2)}\n`);
+    writeFileSync(join(dir, '.aperant', 'tasks', 'INDEX.md'), '# Task Index\n\n');
+    writeFileSync(join(dir, '.aperant', 'roadmap', 'project', 'milestones.json'), `${JSON.stringify({ version: 1, project: 'test', scope: 'project', milestones: [] }, null, 2)}\n`);
+    writeFileSync(join(dir, '.aperant', 'team.json'), `${JSON.stringify({ version: 1, enabled: true, members: {} }, null, 2)}\n`);
+    try {
+        return await fn(dir);
+    }
+    finally {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+/**
+ * Seed a task into .aperant/state.json's active_tasks map.
+ *
+ * @param {string} projectDir
+ * @param {{
+ *   id: string,
+ *   description?: string,
+ *   scope?: string,
+ *   milestone_id?: string | null,
+ *   phase_id?: string | null,
+ *   lifecycle_phase?: string,
+ * }} opts
+ */
+export function seedTask(projectDir, opts) {
+    const statePath = join(projectDir, '.aperant', 'state.json');
+    const state = JSON.parse(readFileSync(statePath, 'utf-8'));
+    state.active_tasks[opts.id] = {
+        id: opts.id,
+        description: opts.description ?? `seeded: ${opts.id}`,
+        scope: opts.scope ?? 'project',
+        milestone_id: opts.milestone_id ?? null,
+        phase_id: opts.phase_id ?? null,
+        lifecycle_phase: opts.lifecycle_phase ?? 'executing',
+        created_at: new Date().toISOString(),
+        history: [],
+    };
+    writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`);
+}
+/**
+ * Toggle the auto_close_phase config flag — many task lifecycle tests
+ * exercise the close-phase cascade and need this flipped on.
+ *
+ * @param {string} projectDir
+ */
+export function enableAutoClosePhase(projectDir) {
+    const cfgPath = join(projectDir, '.aperant', 'config.json');
+    const cfg = JSON.parse(readFileSync(cfgPath, 'utf-8'));
+    cfg.task_lifecycle = cfg.task_lifecycle ?? {};
+    cfg.task_lifecycle.auto_close_phase = true;
+    writeFileSync(cfgPath, `${JSON.stringify(cfg, null, 2)}\n`);
+}
+/** Read state.json from a project dir. */
+export function readState(projectDir) {
+    return JSON.parse(readFileSync(join(projectDir, '.aperant', 'state.json'), 'utf-8'));
+}
+//# sourceMappingURL=cmd-fixtures.mjs.map

package/dist/__test-helpers/cmd-fixtures.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-fixtures.mjs","sourceRoot":"","sources":["../../src/__test-helpers/cmd-fixtures.mjs"],"names":[],"mappings":"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"}

package/dist/__test-helpers/index.d.mts

@@ -0,0 +1,3 @@
+export { runCmd } from "./run-cmd.mjs";
+export { enableAutoClosePhase, seedTask, withTempProject } from "./cmd-fixtures.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/__test-helpers/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/__test-helpers/index.mjs"],"names":[],"mappings":""}

package/dist/__test-helpers/index.mjs

@@ -0,0 +1,14 @@
+/**
+ * __test-helpers/index.mjs — single import point for the in-process test
+ * harness. Re-exports the harness primitives and the fixture builders so
+ * Layer 1 unit tests can `import { runCmd, withTempProject, seedTask, ... }`
+ * from one place.
+ *
+ * Note: tmp-project.ts and the integration helpers (run-cli, makeFixtureProject)
+ * are TypeScript and are kept consumable directly via their original paths
+ * to avoid changing the legacy import surface. New in-process unit tests
+ * should pull from this index.
+ */
+export { enableAutoClosePhase, seedTask, withTempProject } from './cmd-fixtures.mjs';
+export { runCmd } from './run-cmd.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/__test-helpers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/__test-helpers/index.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA"}

package/dist/__test-helpers/run-cmd.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @param {Function} cmdFn — the Layer 1 cmd function (sync or async).
+ * @param {unknown[]} [args=[]] — argv-shaped positional args.
+ * @param {{ strictExit?: boolean, env?: Record<string, string> }} [opts]
+ * @returns {Promise<{ result: unknown, stdout: string, exitCode: number }>}
+ */
+export function runCmd(cmdFn: Function, args?: unknown[], opts?: {
+    strictExit?: boolean;
+    env?: Record<string, string>;
+}): Promise<{
+    result: unknown;
+    stdout: string;
+    exitCode: number;
+}>;
+//# sourceMappingURL=run-cmd.d.mts.map

package/dist/__test-helpers/run-cmd.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cmd.d.mts","sourceRoot":"","sources":["../../src/__test-helpers/run-cmd.mjs"],"names":[],"mappings":"AAiCA;;;;;GAKG;AACH,+CAJW,OAAO,EAAE,SACT;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACpD,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAoD1E"}

package/dist/__test-helpers/run-cmd.mjs

@@ -0,0 +1,84 @@
+/**
+ * run-cmd.mjs — D-05 in-process command harness.
+ *
+ * `runCmd(cmdFn, args, opts)` invokes a Layer 1 command function in-process
+ * (no subprocess), captures stdout, traps any process.exit calls (via a
+ * try/finally restore), and returns:
+ *
+ *     { result, stdout, exitCode }
+ *
+ * `result` is the cmd function's return value (typically `{envelope, exitCode}`
+ * after the migration; `null` if the cmd called process.exit before returning).
+ * `stdout` is the captured stdout.write payload (string). `exitCode` is the
+ * effective exit code: the trapped exit code if process.exit was called, else
+ * `result.exitCode`, else 0.
+ *
+ * D-05 (d) decision: strictExit DEFAULTS TO TRUE — the harness throws a
+ * strict-mode-violation Error any time a Layer 1 cmd calls process.exit.
+ * Legacy tests being migrated opt OUT explicitly per-test with
+ * `{ strictExit: false }` until the underlying cmd is rewritten. After Wave 5
+ * (subtask 25) zero `strictExit: false` opt-outs remain in __tests__/.
+ *
+ * Restoration: process.exit and process.stdout.write are saved at entry and
+ * restored unconditionally in a try/finally. A test that crashes mid-call
+ * still leaves the global state byte-identical for the next test in the file.
+ */
+class ExitTrap extends Error {
+    constructor(code) {
+        super(`apt-tools cmd called process.exit(${code})`);
+        this.code = code;
+    }
+}
+/**
+ * @param {Function} cmdFn — the Layer 1 cmd function (sync or async).
+ * @param {unknown[]} [args=[]] — argv-shaped positional args.
+ * @param {{ strictExit?: boolean, env?: Record<string, string> }} [opts]
+ * @returns {Promise<{ result: unknown, stdout: string, exitCode: number }>}
+ */
+export async function runCmd(cmdFn, args = [], opts = {}) {
+    const { strictExit = true } = opts;
+    let trappedExit = null;
+    const origExit = process.exit;
+    // Save the unbound original — assignment to process.stdout.write replaces
+    // the property; restoration of the original reference returns the global
+    // to byte-identical state (Function-identity check in self-tests).
+    const origWrite = process.stdout.write;
+    const stdoutBuf = [];
+    process.exit = (code) => {
+        trappedExit = typeof code === 'number' ? code : 0;
+        if (strictExit) {
+            throw new Error(`process.exit(${trappedExit}) called inside cmdFn — strict-mode violation. ` +
+                `Layer 1 commands must return { envelope, exitCode } instead of calling process.exit. ` +
+                `If this cmd is mid-migration, pass { strictExit: false } to runCmd to opt out per-test.`);
+        }
+        // Lenient mode — unwind the cmdFn's call stack so the harness can
+        // observe the trapped code via the catch block below.
+        throw new ExitTrap(trappedExit);
+    };
+    process.stdout.write = (chunk, ..._rest) => {
+        stdoutBuf.push(typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf-8'));
+        return true;
+    };
+    try {
+        const result = await cmdFn(...args);
+        const exitCode = trappedExit !== null
+            ? trappedExit
+            : typeof result === 'object' && result !== null && typeof result.exitCode === 'number'
+                ? result.exitCode
+                : 0;
+        return { result, stdout: stdoutBuf.join(''), exitCode };
+    }
+    catch (e) {
+        if (e instanceof ExitTrap) {
+            return { result: null, stdout: stdoutBuf.join(''), exitCode: e.code };
+        }
+        // Re-throw non-trap errors (including the strict-mode-violation Error
+        // thrown above) so tests can assert via expect(...).rejects.
+        throw e;
+    }
+    finally {
+        process.exit = origExit;
+        process.stdout.write = origWrite;
+    }
+}
+//# sourceMappingURL=run-cmd.mjs.map

package/dist/__test-helpers/run-cmd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cmd.mjs","sourceRoot":"","sources":["../../src/__test-helpers/run-cmd.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,QAAS,SAAQ,KAAK;IAC3B,YAAY,IAAI;QACf,KAAK,CAAC,qCAAqC,IAAI,GAAG,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE;IACvD,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAElC,IAAI,WAAW,GAAG,IAAI,CAAA;IACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,yEAAyE;IACzE,mEAAmE;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAA;IACtC,MAAM,SAAS,GAAG,EAAE,CAAA;IAEpB,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE;QACvB,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACjD,IAAI,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACd,gBAAgB,WAAW,iDAAiD;gBAC3E,uFAAuF;gBACvF,yFAAyF,CAC1F,CAAA;QACF,CAAC;QACD,kEAAkE;QAClE,sDAAsD;QACtD,MAAM,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAA;IAChC,CAAC,CAAA;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE;QAC1C,SAAS,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;QACxF,OAAO,IAAI,CAAA;IACZ,CAAC,CAAA;IAED,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;QACnC,MAAM,QAAQ,GACb,WAAW,KAAK,IAAI;YACnB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBACrF,CAAC,CAAC,MAAM,CAAC,QAAQ;gBACjB,CAAC,CAAC,CAAC,CAAA;QACN,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAA;IACxD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;YAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACtE,CAAC;QACD,sEAAsE;QACtE,6DAA6D;QAC7D,MAAM,CAAC,CAAA;IACR,CAAC;YAAS,CAAC;QACV,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAA;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,SAAS,CAAA;IACjC,CAAC;AACF,CAAC"}

package/dist/__test-helpers/tmp-project.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared helper for C28 test suites. Spins up a throwaway project dir
+ * with an initialized `.aperant/` skeleton so `apt-tools` CLI calls work
+ * without touching the real project.
+ */
+export declare const APT_TOOLS: string;
+export interface TmpProject {
+    dir: string;
+    cleanup: () => void;
+}
+export declare function createTmpProject(opts?: {
+    gitInit?: boolean;
+    initAperant?: boolean;
+    teamMode?: boolean;
+}): TmpProject;
+export interface CliResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+    json: Record<string, unknown> | null;
+}
+export declare function runCli(args: string[], cwd?: string): CliResult;
+/** Seed a milestone with one phase into .aperant/roadmap/{scope}/milestones.json. */
+export declare function seedMilestone(projectDir: string, milestoneId: string, phaseId: string, scope?: string): void;
+/** Read state.json. */
+export declare function readState(projectDir: string): {
+    active_tasks: Record<string, Record<string, unknown>>;
+    completed_tasks: Array<Record<string, unknown>>;
+    [k: string]: unknown;
+};
+//# sourceMappingURL=tmp-project.d.ts.map

package/dist/__test-helpers/tmp-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmp-project.d.ts","sourceRoot":"","sources":["../../src/__test-helpers/tmp-project.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,eAAO,MAAM,SAAS,QAAyD,CAAA;AAE/E,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,wBAAgB,gBAAgB,CAC/B,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACzE,UAAU,CAgFZ;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACpC;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAqB9D;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAkB,GACvB,IAAI,CAiCN;AAED,uBAAuB;AACvB,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG;IAC9C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACrD,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACpB,CAKA"}

package/dist/__test-helpers/tmp-project.js

@@ -0,0 +1,126 @@
+/**
+ * Shared helper for C28 test suites. Spins up a throwaway project dir
+ * with an initialized `.aperant/` skeleton so `apt-tools` CLI calls work
+ * without touching the real project.
+ */
+import { execSync, spawnSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+// __dirname = packages/framework/src/__test-helpers/
+// Go up two levels to packages/framework/, then into bin/.
+export const APT_TOOLS = resolve(__dirname, '..', '..', 'bin', 'apt-tools.mjs');
+export function createTmpProject(opts = {}) {
+    const dir = mkdtempSync(join(tmpdir(), 'apt-c28-'));
+    if (opts.gitInit !== false) {
+        spawnSync('git', ['init', '-q', '-b', 'main'], { cwd: dir });
+        spawnSync('git', ['config', 'user.email', 'test@example.com'], { cwd: dir });
+        spawnSync('git', ['config', 'user.name', 'test'], { cwd: dir });
+        spawnSync('git', ['config', 'commit.gpgsign', 'false'], { cwd: dir });
+        writeFileSync(join(dir, 'README.md'), '# test\n');
+        spawnSync('git', ['add', 'README.md'], { cwd: dir });
+        spawnSync('git', ['commit', '-q', '-m', 'init'], { cwd: dir });
+    }
+    if (opts.initAperant !== false) {
+        mkdirSync(join(dir, '.aperant'), { recursive: true });
+        mkdirSync(join(dir, '.aperant', 'tasks'), { recursive: true });
+        mkdirSync(join(dir, '.aperant', 'events'), { recursive: true });
+        mkdirSync(join(dir, '.aperant', 'locks'), { recursive: true });
+        mkdirSync(join(dir, '.aperant', 'roadmap'), { recursive: true });
+        const now = new Date().toISOString();
+        writeFileSync(join(dir, '.aperant', 'state.json'), `${JSON.stringify({
+            version: 1,
+            initialized_at: now,
+            last_activity: now,
+            active_tasks: {},
+            completed_tasks: [],
+            decisions: {},
+            has_tests: false,
+        }, null, 2)}\n`);
+        // C34: active.json is no longer seeded — per-agent team-status/ is
+        // created lazily by the coordination store.
+        writeFileSync(join(dir, '.aperant', 'config.json'), `${JSON.stringify({
+            version: 3,
+            autonomy_level: 2,
+            project_type: 'monorepo',
+        }, null, 2)}\n`);
+        writeFileSync(join(dir, '.aperant', 'tasks', 'INDEX.md'), '# Task Index\n\n');
+        mkdirSync(join(dir, '.aperant', 'roadmap', 'project'), { recursive: true });
+        writeFileSync(join(dir, '.aperant', 'roadmap', 'project', 'milestones.json'), `${JSON.stringify({ version: 1, project: 'test', scope: 'project', milestones: [] }, null, 2)}\n`);
+        // Team mode enabled by default so team-status + INDEX propagation run.
+        const teamEnabled = opts.teamMode !== false;
+        writeFileSync(join(dir, '.aperant', 'team.json'), `${JSON.stringify({ version: 1, enabled: teamEnabled, members: {} }, null, 2)}\n`);
+    }
+    return {
+        dir,
+        cleanup: () => {
+            try {
+                rmSync(dir, { recursive: true, force: true });
+            }
+            catch {
+                /* best-effort */
+            }
+        },
+    };
+}
+export function runCli(args, cwd) {
+    const result = spawnSync(process.execPath, [APT_TOOLS, ...args], {
+        cwd: cwd ?? process.cwd(),
+        encoding: 'utf-8',
+        env: process.env,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    const stdout = result.stdout ?? '';
+    const stderr = result.stderr ?? '';
+    let json = null;
+    try {
+        json = JSON.parse(stdout);
+    }
+    catch {
+        // Non-JSON output — leave as null.
+    }
+    return {
+        status: result.status ?? -1,
+        stdout,
+        stderr,
+        json,
+    };
+}
+/** Seed a milestone with one phase into .aperant/roadmap/{scope}/milestones.json. */
+export function seedMilestone(projectDir, milestoneId, phaseId, scope = 'project') {
+    const scopeDir = join(projectDir, '.aperant', 'roadmap', scope);
+    mkdirSync(scopeDir, { recursive: true });
+    writeFileSync(join(scopeDir, 'milestones.json'), `${JSON.stringify({
+        version: 1,
+        project: 'test',
+        scope,
+        milestones: [
+            {
+                id: milestoneId,
+                title: milestoneId,
+                goal: 'test',
+                scope,
+                phases: [
+                    {
+                        id: phaseId,
+                        title: phaseId,
+                        description: 'test',
+                        status: 'planned',
+                        owner: 'test',
+                        scope,
+                    },
+                ],
+            },
+        ],
+    }, null, 2)}\n`);
+}
+/** Read state.json. */
+export function readState(projectDir) {
+    const raw = execSync(`cat ${join(projectDir, '.aperant', 'state.json')}`, {
+        encoding: 'utf-8',
+    });
+    return JSON.parse(raw);
+}
+//# sourceMappingURL=tmp-project.js.map

package/dist/__test-helpers/tmp-project.js.map

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

package/dist/__tests__/agent-runtime.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * agent-runtime.test.ts — covers the four env-var branches + the
+ * deterministic precedence rule (claude-code > cursor > aider > unknown)
+ * called out in spec R4.
+ */
+export {};
+//# sourceMappingURL=agent-runtime.test.d.ts.map