@aperant/framework 0.6.2

package/dist/__tests__/milestone-rollup.test.js

@@ -0,0 +1,175 @@
+/**
+ * milestone-rollup.test.ts — truth table + applyRollup + writeRollup integration.
+ *
+ * Covers AC8 (CLI rollup), AC9 (5-row truth table), AC10 (lifecycle integration).
+ */
+import { execSync } from 'node:child_process';
+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 { applyLifecyclePhaseSideEffect } from '../cli/roadmap/lifecycle.mjs';
+import { applyRollup, rollupMilestoneStatus, writeRollup } from '../cli/roadmap/rollup.mjs';
+describe('rollupMilestoneStatus — AC9 truth table', () => {
+    const rows = [
+        // spec AC9:
+        ['all completed', ['completed', 'completed', 'completed'], 'completed'],
+        ['completed + in-progress', ['completed', 'completed', 'in-progress'], 'in-progress'],
+        ['completed + planned', ['completed', 'planned', 'planned'], 'in-progress'],
+        ['all planned', ['planned', 'planned', 'planned'], 'planned'],
+        ['blocked wins', ['in-progress', 'blocked', 'planned'], 'blocked'],
+        // Extra: skipped counts as done
+        ['completed + skipped', ['completed', 'skipped'], 'completed'],
+    ];
+    for (const [label, statuses, expected] of rows) {
+        it(`${label} → ${expected}`, () => {
+            const milestone = { phases: statuses.map((status) => ({ status })) };
+            expect(rollupMilestoneStatus(milestone)).toBe(expected);
+        });
+    }
+    it('empty phases array → null', () => {
+        expect(rollupMilestoneStatus({ phases: [] })).toBe(null);
+    });
+    it('null / missing milestone → null', () => {
+        // @ts-expect-error — intentional null input
+        expect(rollupMilestoneStatus(null)).toBe(null);
+        expect(rollupMilestoneStatus({})).toBe(null);
+    });
+});
+describe('applyRollup — change detection', () => {
+    it('returns changed:false when stored status already matches', () => {
+        const roadmap = {
+            milestones: [
+                {
+                    id: 'm1',
+                    status: 'completed',
+                    phases: [{ status: 'completed' }, { status: 'skipped' }],
+                },
+            ],
+        };
+        const result = applyRollup(roadmap, 'm1');
+        expect(result.changed).toBe(false);
+        expect(result.before).toBe('completed');
+        expect(result.after).toBe('completed');
+    });
+    it('returns changed:true and mutates the milestone when computed differs', () => {
+        const roadmap = {
+            milestones: [
+                {
+                    id: 'm1',
+                    status: 'planned',
+                    phases: [{ status: 'completed' }, { status: 'in-progress' }],
+                },
+            ],
+        };
+        const result = applyRollup(roadmap, 'm1');
+        expect(result.changed).toBe(true);
+        expect(result.before).toBe('planned');
+        expect(result.after).toBe('in-progress');
+        expect(roadmap.milestones[0].status).toBe('in-progress');
+    });
+    it('missing milestone returns changed:false without mutating roadmap', () => {
+        const roadmap = { milestones: [] };
+        const result = applyRollup(roadmap, 'nonexistent');
+        expect(result.changed).toBe(false);
+        expect(result.after).toBe(null);
+    });
+});
+describe('writeRollup — tmpdir integration (AC8)', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-rollup-'));
+        // git init for the sync path to succeed.
+        try {
+            execSync('git init -q', { cwd: tmp, stdio: 'ignore' });
+            execSync('git config user.email t@t.t', { cwd: tmp, stdio: 'ignore' });
+            execSync('git config user.name t', { cwd: tmp, stdio: 'ignore' });
+            execSync('git config commit.gpgsign false', { cwd: tmp, stdio: 'ignore' });
+        }
+        catch {
+            /* best-effort */
+        }
+    });
+    afterEach(() => rmSync(tmp, { recursive: true, force: true }));
+    function seedRoadmap(scope, milestones) {
+        const dir = join(tmp, '.aperant', 'roadmap', scope);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'milestones.json'), JSON.stringify({ version: 1, scope, milestones }, null, 2));
+    }
+    it('writes status="completed" when every phase is completed', () => {
+        seedRoadmap('test', [
+            {
+                id: 'm1',
+                title: 'Test',
+                phases: [
+                    { id: 'p1', status: 'completed' },
+                    { id: 'p2', status: 'completed' },
+                ],
+            },
+        ]);
+        const result = writeRollup(tmp, 'test', 'm1');
+        expect(result.after).toBe('completed');
+        expect(result.changed).toBe(true);
+        const raw = JSON.parse(readFileSync(join(tmp, '.aperant', 'roadmap', 'test', 'milestones.json'), 'utf-8'));
+        expect(raw.milestones.find((m) => m.id === 'm1')?.status).toBe('completed');
+    });
+    it('second call is a no-op when stored status matches', () => {
+        seedRoadmap('test', [
+            {
+                id: 'm1',
+                title: 'Test',
+                phases: [{ id: 'p1', status: 'completed' }],
+            },
+        ]);
+        writeRollup(tmp, 'test', 'm1');
+        const second = writeRollup(tmp, 'test', 'm1');
+        expect(second.changed).toBe(false);
+    });
+});
+describe('applyLifecyclePhaseSideEffect — AC10 end-to-end', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), 'apt-lifecycle-'));
+        try {
+            execSync('git init -q', { cwd: tmp, stdio: 'ignore' });
+            execSync('git config user.email t@t.t', { cwd: tmp, stdio: 'ignore' });
+            execSync('git config user.name t', { cwd: tmp, stdio: 'ignore' });
+            execSync('git config commit.gpgsign false', { cwd: tmp, stdio: 'ignore' });
+        }
+        catch {
+            /* best-effort */
+        }
+    });
+    afterEach(() => rmSync(tmp, { recursive: true, force: true }));
+    it('last phase transition to completed flips milestone.status to "completed"', () => {
+        const dir = join(tmp, '.aperant', 'roadmap', 'project');
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'milestones.json'), JSON.stringify({
+            version: 1,
+            scope: 'project',
+            milestones: [
+                {
+                    id: 'm1',
+                    title: 'Test',
+                    phases: [
+                        { id: 'p1', status: 'completed' },
+                        { id: 'p2', status: 'in-progress' },
+                    ],
+                },
+            ],
+        }, null, 2));
+        const task = {
+            scope: 'project',
+            milestone_id: 'm1',
+            phase_id: 'p2',
+        };
+        const result = applyLifecyclePhaseSideEffect(tmp, task, { from: 'in-progress', to: 'completed' }, 'test.close');
+        expect(result).not.toBeNull();
+        expect(result?.rollup?.changed).toBe(true);
+        expect(result?.rollup?.after).toBe('completed');
+        // Re-read milestones.json and verify status was written.
+        const raw = JSON.parse(readFileSync(join(tmp, '.aperant', 'roadmap', 'project', 'milestones.json'), 'utf-8'));
+        expect(raw.milestones.find((m) => m.id === 'm1')?.status).toBe('completed');
+    });
+});
+//# sourceMappingURL=milestone-rollup.test.js.map

package/dist/__tests__/milestone-rollup.test.js.map

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

package/dist/__tests__/milestone-schema-focus-fields.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * C50 — milestone-schema.json (new fields) + roadmap round-trip tests.
+ *
+ * Validates:
+ *   - schemas/milestone-schema.json is parseable JSON Schema and declares the
+ *     three new optional fields (focus_tier, focus_personas, focus_tier_enforcement)
+ *   - backward-compat: milestones WITHOUT the fields still load + save via
+ *     loadRoadmapForScope / saveRoadmapForScope
+ *   - forward-compat: milestones WITH the fields round-trip losslessly
+ *   - field-shape invariants from the schema (focus_tier is an array, not a
+ *     single string; focus_tier_enforcement enum constrained)
+ */
+export {};
+//# sourceMappingURL=milestone-schema-focus-fields.test.d.ts.map

package/dist/__tests__/milestone-schema-focus-fields.test.d.ts.map

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

package/dist/__tests__/milestone-schema-focus-fields.test.js

@@ -0,0 +1,159 @@
+/**
+ * C50 — milestone-schema.json (new fields) + roadmap round-trip tests.
+ *
+ * Validates:
+ *   - schemas/milestone-schema.json is parseable JSON Schema and declares the
+ *     three new optional fields (focus_tier, focus_personas, focus_tier_enforcement)
+ *   - backward-compat: milestones WITHOUT the fields still load + save via
+ *     loadRoadmapForScope / saveRoadmapForScope
+ *   - forward-compat: milestones WITH the fields round-trip losslessly
+ *   - field-shape invariants from the schema (focus_tier is an array, not a
+ *     single string; focus_tier_enforcement enum constrained)
+ */
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { loadRoadmapForScope, saveRoadmapForScope } from '../cli/roadmap/io.mjs';
+const SCHEMA_PATH = resolve(new URL('.', import.meta.url).pathname, '..', '..', 'schemas', 'milestone-schema.json');
+function readSchema() {
+    return JSON.parse(readFileSync(SCHEMA_PATH, 'utf-8'));
+}
+function makeProject() {
+    return mkdtempSync(join(tmpdir(), 'apt-milestone-schema-'));
+}
+describe('C50 milestone-schema.json', () => {
+    it('is parseable JSON Schema', () => {
+        const schema = readSchema();
+        expect(schema).toBeDefined();
+        expect(typeof schema).toBe('object');
+    });
+    it('declares focus_tier as an array of tier-enum strings', () => {
+        const schema = readSchema();
+        const prop = schema.properties.focus_tier;
+        expect(prop).toBeDefined();
+        expect(prop?.type).toBe('array');
+        expect(prop?.items?.enum).toEqual(expect.arrayContaining(['primary', 'secondary', 'tertiary']));
+    });
+    it('declares focus_personas as an array', () => {
+        const schema = readSchema();
+        const prop = schema.properties.focus_personas;
+        expect(prop).toBeDefined();
+        expect(prop?.type).toBe('array');
+    });
+    it('declares focus_tier_enforcement as warn|blocking with default "warn"', () => {
+        const schema = readSchema();
+        const prop = schema.properties.focus_tier_enforcement;
+        expect(prop).toBeDefined();
+        expect(prop?.enum).toEqual(expect.arrayContaining(['warn', 'blocking']));
+        expect(prop?.default).toBe('warn');
+    });
+});
+describe('milestone load/save — backward-compat without focus fields', () => {
+    it('loads a legacy milestone (no focus_tier fields) without error', () => {
+        const root = makeProject();
+        const scope = 'framework';
+        const dir = join(root, '.aperant', 'roadmap', scope);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'milestones.json'), JSON.stringify({
+            version: 1,
+            scope,
+            milestones: [
+                {
+                    id: 'm-legacy',
+                    title: 'Legacy milestone',
+                    goal: 'pre-C50 baseline',
+                    scope,
+                    phases: [],
+                },
+            ],
+        }));
+        const rm = loadRoadmapForScope(root, scope);
+        expect(rm).toBeDefined();
+        expect(rm?.milestones).toHaveLength(1);
+        expect(rm?.milestones[0].id).toBe('m-legacy');
+        // Focus fields are simply absent — not null, not {}.
+        expect(rm?.milestones[0].focus_tier).toBeUndefined();
+        expect(rm?.milestones[0].focus_tier_enforcement).toBeUndefined();
+        rmSync(root, { recursive: true, force: true });
+    });
+    it('round-trips a milestone WITH focus fields losslessly', () => {
+        const root = makeProject();
+        const scope = 'framework';
+        const dir = join(root, '.aperant', 'roadmap', scope);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'milestones.json'), JSON.stringify({
+            version: 1,
+            scope,
+            milestones: [
+                {
+                    id: 'm-focus',
+                    title: 'Focused milestone',
+                    goal: 'C50 test',
+                    scope,
+                    phases: [],
+                    focus_tier: ['primary', 'secondary'],
+                    focus_personas: ['mobile-dev', 'admin'],
+                    focus_tier_enforcement: 'blocking',
+                },
+            ],
+        }));
+        const rm = loadRoadmapForScope(root, scope);
+        expect(rm?.milestones[0].focus_tier).toEqual(['primary', 'secondary']);
+        expect(rm?.milestones[0].focus_personas).toEqual(['mobile-dev', 'admin']);
+        expect(rm?.milestones[0].focus_tier_enforcement).toBe('blocking');
+        // Now save it back and re-read to ensure the fields survive a full
+        // io.mjs round-trip (including the dual-write to phases/).
+        saveRoadmapForScope(root, scope, rm);
+        const re = loadRoadmapForScope(root, scope);
+        expect(re?.milestones[0].focus_tier).toEqual(['primary', 'secondary']);
+        expect(re?.milestones[0].focus_tier_enforcement).toBe('blocking');
+        rmSync(root, { recursive: true, force: true });
+    });
+    it('accepts mixed milestones (some with focus, some without) in the same roadmap', () => {
+        const root = makeProject();
+        const scope = 'framework';
+        const dir = join(root, '.aperant', 'roadmap', scope);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'milestones.json'), JSON.stringify({
+            version: 1,
+            scope,
+            milestones: [
+                { id: 'm-legacy', title: 'Legacy', goal: '', scope, phases: [] },
+                {
+                    id: 'm-focus',
+                    title: 'Focused',
+                    goal: '',
+                    scope,
+                    phases: [],
+                    focus_tier: ['primary'],
+                },
+            ],
+        }));
+        const rm = loadRoadmapForScope(root, scope);
+        expect(rm?.milestones).toHaveLength(2);
+        expect(rm?.milestones[0].focus_tier).toBeUndefined();
+        expect(rm?.milestones[1].focus_tier).toEqual(['primary']);
+        rmSync(root, { recursive: true, force: true });
+    });
+    it('the existing framework milestones.json continues to load cleanly (D-01 backward-compat)', () => {
+        // Smoke-check the real roadmap in this repo — it must continue to load
+        // without focus_tier set. This is the D-01 acceptance criterion: the
+        // project's own framework roadmap must not break.
+        const actualRepo = resolve(new URL('.', import.meta.url).pathname, '..', '..', '..', '..');
+        const rm = loadRoadmapForScope(actualRepo, 'framework');
+        // The roadmap may or may not exist depending on where tests run — skip if absent.
+        if (!rm)
+            return;
+        expect(Array.isArray(rm.milestones)).toBe(true);
+        // None of the existing milestones is required to have focus_tier; they
+        // just must not crash the loader.
+        for (const m of rm.milestones) {
+            // focus_tier is either absent or a non-empty array of known tiers
+            if (m.focus_tier !== undefined) {
+                expect(Array.isArray(m.focus_tier)).toBe(true);
+            }
+        }
+    });
+});
+//# sourceMappingURL=milestone-schema-focus-fields.test.js.map

package/dist/__tests__/milestone-schema-focus-fields.test.js.map

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

package/dist/__tests__/null-backend.test.d.ts

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

package/dist/__tests__/null-backend.test.d.ts.map

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

package/dist/__tests__/null-backend.test.js

@@ -0,0 +1,54 @@
+import { describe, expect, it } from 'vitest';
+import { NullMemoryBackend } from '../memory/null-backend.js';
+describe('NullMemoryBackend', () => {
+    it('store() returns a generated UUID', async () => {
+        const backend = new NullMemoryBackend();
+        const id = await backend.store({
+            content: 'some memory',
+            type: 'decision',
+            scope: 'global',
+            tags: ['auth'],
+            source: 'test',
+            deprecated: false,
+        });
+        expect(id).toBeDefined();
+        expect(typeof id).toBe('string');
+        expect(id.length).toBeGreaterThan(0);
+    });
+    it('retrieve() returns empty array', async () => {
+        const backend = new NullMemoryBackend();
+        await backend.store({
+            content: 'some memory',
+            type: 'decision',
+            scope: 'global',
+            tags: [],
+            source: 'test',
+            deprecated: false,
+        });
+        const results = await backend.retrieve({ text: 'some' });
+        expect(results).toEqual([]);
+    });
+    it('delete() resolves without error', async () => {
+        const backend = new NullMemoryBackend();
+        await expect(backend.delete('non-existent-id')).resolves.toBeUndefined();
+    });
+    it('deprecate() resolves without error', async () => {
+        const backend = new NullMemoryBackend();
+        await expect(backend.deprecate('non-existent-id')).resolves.toBeUndefined();
+    });
+    it('close() resolves without error', async () => {
+        const backend = new NullMemoryBackend();
+        await expect(backend.close()).resolves.toBeUndefined();
+    });
+    it("has tier set to 'none'", () => {
+        const backend = new NullMemoryBackend();
+        expect(backend.tier).toBe('none');
+    });
+});
+describe('MemoryBackendTier', () => {
+    it("accepts 'none', 'file', and 'full' as valid values", () => {
+        const tiers = ['none', 'file', 'full'];
+        expect(tiers).toEqual(['none', 'file', 'full']);
+    });
+});
+//# sourceMappingURL=null-backend.test.js.map

package/dist/__tests__/null-backend.test.js.map

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

package/dist/__tests__/output-style-helpers.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * C22 — output-style helper tests.
+ *
+ * Every helper must:
+ *   1. Produce identical plain-text output when color is off (NO_COLOR /
+ *      explicit opts.color=false / non-TTY stream).
+ *   2. Produce ANSI-escaped output when color is on.
+ *   3. Degrade gracefully on empty / missing inputs.
+ */
+export {};
+//# sourceMappingURL=output-style-helpers.test.d.ts.map

package/dist/__tests__/output-style-helpers.test.d.ts.map

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

package/dist/__tests__/output-style-helpers.test.js

@@ -0,0 +1,173 @@
+/**
+ * C22 — output-style helper tests.
+ *
+ * Every helper must:
+ *   1. Produce identical plain-text output when color is off (NO_COLOR /
+ *      explicit opts.color=false / non-TTY stream).
+ *   2. Produce ANSI-escaped output when color is on.
+ *   3. Degrade gracefully on empty / missing inputs.
+ */
+import { describe, expect, it } from 'vitest';
+import { bold, bullet, cyan, dim, kv, relativeTime, section, statusLine, style, supportsColor, table, } from '../cli/output-style/index.mjs';
+const ESC = '\u001b[';
+describe('C22 supportsColor', () => {
+    it('returns false when NO_COLOR is set to any non-empty value', () => {
+        expect(supportsColor({ stream: { isTTY: true }, env: { NO_COLOR: '1' } })).toBe(false);
+        expect(supportsColor({ stream: { isTTY: true }, env: { NO_COLOR: 'anything' } })).toBe(false);
+    });
+    it('ignores NO_COLOR when it is the empty string', () => {
+        expect(supportsColor({ stream: { isTTY: true }, env: { NO_COLOR: '' } })).toBe(true);
+    });
+    it('returns true when FORCE_COLOR is set (non-zero, non-empty)', () => {
+        expect(supportsColor({ stream: { isTTY: false }, env: { FORCE_COLOR: '1' } })).toBe(true);
+        expect(supportsColor({ stream: { isTTY: false }, env: { FORCE_COLOR: 'true' } })).toBe(true);
+    });
+    it('FORCE_COLOR=0 does not force color on', () => {
+        expect(supportsColor({ stream: { isTTY: false }, env: { FORCE_COLOR: '0' } })).toBe(false);
+    });
+    it('falls through to stream.isTTY when no env flags', () => {
+        expect(supportsColor({ stream: { isTTY: true }, env: {} })).toBe(true);
+        expect(supportsColor({ stream: { isTTY: false }, env: {} })).toBe(false);
+    });
+    it('treats a missing stream as non-TTY', () => {
+        expect(supportsColor({ env: {} })).toBe(typeof process.stdout.isTTY === 'boolean' ? process.stdout.isTTY : false);
+    });
+});
+describe('C22 style()', () => {
+    it('returns plain text when color is false', () => {
+        expect(style('hello', '\u001b[1m', { color: false })).toBe('hello');
+    });
+    it('wraps in open code + reset when color is true', () => {
+        const out = style('hello', '\u001b[1m', { color: true });
+        expect(out).toContain(ESC);
+        expect(out).toContain('hello');
+        expect(out.endsWith('\u001b[0m')).toBe(true);
+    });
+    it('concatenates an array of codes as one open sequence', () => {
+        const out = style('x', ['\u001b[1m', '\u001b[31m'], { color: true });
+        expect(out.startsWith('\u001b[1m\u001b[31m')).toBe(true);
+    });
+    it('returns plain text when codes is empty', () => {
+        expect(style('x', '', { color: true })).toBe('x');
+    });
+});
+describe('C22 section / kv / bullet', () => {
+    it('section is bold when color on, plain when off', () => {
+        expect(section('Title', { color: false })).toBe('Title');
+        expect(section('Title', { color: true })).toContain(ESC);
+    });
+    it('kv renders "key: value" in plain mode', () => {
+        expect(kv('foo', 'bar', { color: false })).toBe('foo: bar');
+    });
+    it('kv substitutes em-dash for null/undefined values', () => {
+        expect(kv('foo', null, { color: false })).toBe('foo: —');
+        expect(kv('foo', undefined, { color: false })).toBe('foo: —');
+    });
+    it('bullet renders · when no status', () => {
+        expect(bullet('task', undefined, { color: false })).toBe('· task');
+    });
+    it('bullet renders each known status icon', () => {
+        expect(bullet('t', 'ok', { color: false })).toBe('✓ t');
+        expect(bullet('t', 'fail', { color: false })).toBe('✗ t');
+        expect(bullet('t', 'pending', { color: false })).toBe('⋯ t');
+    });
+    it('bullet falls back to · for unknown status', () => {
+        expect(bullet('t', 'weird', { color: false })).toBe('· t');
+    });
+});
+describe('C22 table()', () => {
+    it('returns empty string for empty rows', () => {
+        expect(table([], ['a', 'b'], { color: false })).toBe('');
+        expect(table([], undefined, { color: false })).toBe('');
+        // Not-an-array: still empty (defensive)
+        expect(table(null, undefined, { color: false })).toBe('');
+    });
+    it('derives headers from first row keys when not provided', () => {
+        const t = table([{ name: 'alpha', count: 3 }], undefined, { color: false });
+        const lines = t.split('\n');
+        expect(lines[0]).toContain('name');
+        expect(lines[0]).toContain('count');
+    });
+    it('aligns columns to max(header, cell) width', () => {
+        const t = table([
+            { a: 'x', b: 'longer' },
+            { a: 'abc', b: 'y' },
+        ], ['a', 'b'], { color: false });
+        const lines = t.split('\n');
+        // Separator row matches column widths; widths = [max(1,3)=3, max(1,6)=6]
+        expect(lines[1]).toBe('---  ------');
+    });
+    it('stringifies null/undefined cells as empty string', () => {
+        const t = table([{ a: null, b: undefined }], ['a', 'b'], { color: false });
+        const body = t.split('\n').slice(2).join('\n');
+        expect(body).toBe('    ');
+    });
+});
+describe('C22 relativeTime()', () => {
+    const now = Date.parse('2026-04-15T12:00:00Z');
+    it('returns em-dash for missing input', () => {
+        expect(relativeTime(null, now)).toBe('—');
+        expect(relativeTime(undefined, now)).toBe('—');
+        expect(relativeTime('not-a-date', now)).toBe('—');
+    });
+    it('returns "just now" within 5 seconds', () => {
+        expect(relativeTime(now - 2000, now)).toBe('just now');
+    });
+    it('returns s/m/h/d buckets', () => {
+        expect(relativeTime(now - 10_000, now)).toBe('10s ago');
+        expect(relativeTime(now - 10 * 60_000, now)).toBe('10m ago');
+        expect(relativeTime(now - 3 * 60 * 60_000, now)).toBe('3h ago');
+        expect(relativeTime(now - 2 * 24 * 60 * 60_000, now)).toBe('2d ago');
+    });
+    it('returns "in the future" for negative diffs', () => {
+        expect(relativeTime(now + 60_000, now)).toBe('in the future');
+    });
+});
+describe('C22 statusLine()', () => {
+    const now = Date.parse('2026-04-15T12:00:00Z');
+    it('renders with all fields present (plain mode)', () => {
+        const line = statusLine({
+            active_tasks: 2,
+            current_phase: 'executing',
+            last_activity: new Date(now - 5 * 60_000).toISOString(),
+            team_count: 3,
+        }, { color: false, now });
+        expect(line).toContain('aperant');
+        expect(line).toContain('tasks 2');
+        expect(line).toContain('phase executing');
+        expect(line).toContain('team 3');
+        expect(line).toContain('5m ago');
+        // Plain mode contains no ANSI escapes
+        expect(line.includes(ESC)).toBe(false);
+    });
+    it('renders em-dashes for missing fields', () => {
+        const line = statusLine({}, { color: false, now });
+        expect(line).toContain('tasks 0');
+        expect(line).toContain('phase —');
+        expect(line).toContain('team 0');
+        // last-activity null path
+        expect(line.endsWith('—')).toBe(true);
+    });
+    it('accepts active_tasks as a map (object)', () => {
+        const line = statusLine({ active_tasks: { a: {}, b: {}, c: {} } }, { color: false, now });
+        expect(line).toContain('tasks 3');
+    });
+    it('produces ANSI escapes when color is on', () => {
+        const line = statusLine({ active_tasks: 1, current_phase: 'planning', team_count: 1 }, { color: true, now });
+        expect(line).toContain(ESC);
+    });
+    it('respects NO_COLOR via explicit color flag chained from supportsColor', () => {
+        const color = supportsColor({ stream: { isTTY: true }, env: { NO_COLOR: '1' } });
+        const line = statusLine({ active_tasks: 1 }, { color, now });
+        expect(line.includes(ESC)).toBe(false);
+    });
+});
+describe('C22 ANSI wrapper sanity', () => {
+    it('bold/dim/cyan round-trip text in color mode', () => {
+        expect(bold('x', { color: false })).toBe('x');
+        expect(dim('x', { color: false })).toBe('x');
+        expect(cyan('x', { color: false })).toBe('x');
+        expect(bold('x', { color: true })).toContain('x');
+    });
+});
+//# sourceMappingURL=output-style-helpers.test.js.map