smol-symphony 0.2.0 → 0.3.0

package/dist/tests/core/parse.test.js

@@ -0,0 +1,174 @@
+// Pure unit tests for src/core/issue/parse.ts.
+// The module is pure (data-in / data-out), so no mocks are needed.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { idOf, parseIssue, normalizeIssues, activeStateNames, terminalStateNames, pickHoldingState, selectCandidateIssues, selectIssuesByStates, selectIssuesByIds, resolveMatch, matchingCandidates, pickNextNumericIdentifier, } from '../../src/core/issue/parse.js';
+import { TrackerError, NoHoldingStateError } from '../../src/types/errors.js';
+// ─── fixtures ────────────────────────────────────────────────────────────────
+function raw(over) {
+    return {
+        filePath: `/tracker/${over.state}/${over.identifier}.md`,
+        frontMatter: {},
+        description: '',
+        ...over,
+    };
+}
+const STATES = {
+    Triage: { role: 'holding' },
+    Todo: { role: 'active' },
+    'In Progress': { role: 'active' },
+    Done: { role: 'terminal' },
+    Closed: { role: 'terminal' },
+};
+// ─── idOf ─────────────────────────────────────────────────────────────────────
+test('idOf prefers non-blank front-matter id, else falls back to filename stem', () => {
+    assert.equal(idOf(raw({ identifier: 'ABC-1', state: 'Todo', frontMatter: { id: 'XYZ-9' } })), 'XYZ-9');
+    assert.equal(idOf(raw({ identifier: 'ABC-1', state: 'Todo' })), 'ABC-1');
+    // blank / whitespace-only id falls back to the stem
+    assert.equal(idOf(raw({ identifier: 'ABC-1', state: 'Todo', frontMatter: { id: '  ' } })), 'ABC-1');
+    // non-string id is ignored
+    assert.equal(idOf(raw({ identifier: 'ABC-1', state: 'Todo', frontMatter: { id: 42 } })), 'ABC-1');
+});
+// ─── parseIssue / coercion ──────────────────────────────────────────────────
+test('parseIssue normalizes front matter, coercing types and lowercasing labels', () => {
+    const issue = parseIssue(raw({
+        identifier: 'ABC-1',
+        state: 'In Progress',
+        description: 'a body',
+        frontMatter: {
+            identifier: 'ABC-1',
+            title: 'Fix the thing',
+            priority: '2', // string int → coerced
+            labels: ['Bug', 'Foo', 123], // non-strings dropped, rest lowercased
+            branch_name: 'feat/x',
+            url: 'https://example/abc-1',
+            created_at: '2026-05-18T12:00:00Z',
+            updated_at: '2026-05-18T13:00:00Z',
+        },
+    }));
+    assert.equal(issue.id, 'ABC-1');
+    assert.equal(issue.title, 'Fix the thing');
+    assert.equal(issue.priority, 2);
+    assert.deepEqual(issue.labels, ['bug', 'foo']);
+    assert.equal(issue.branch_name, 'feat/x');
+    assert.equal(issue.url, 'https://example/abc-1');
+    assert.equal(issue.state, 'In Progress');
+    assert.equal(issue.description, 'a body');
+    assert.equal(issue.created_at, '2026-05-18T12:00:00Z');
+});
+test('parseIssue applies defaults: title=identifier, empty body→null, ISO-string timestamp passes through', () => {
+    // Core operates over PLAIN DATA: the `yaml` lib decodes an ISO timestamp to a
+    // string, and any `Date` is normalized to its ISO string at the SHELL decode
+    // boundary (shell/interp/tracker-parse.ts:normalizeDates) BEFORE parseIssue sees
+    // it. So parseIssue receives a string, never a Date (finding #6).
+    const issue = parseIssue(raw({ identifier: 'DEF-7', state: 'Todo', description: '', frontMatter: { created_at: '2026-01-02T03:04:05.000Z' } }));
+    assert.equal(issue.title, 'DEF-7'); // default = identifier
+    assert.equal(issue.description, null); // empty body → null
+    assert.equal(issue.priority, null);
+    assert.deepEqual(issue.labels, []);
+    assert.deepEqual(issue.blocked_by, []);
+    assert.equal(issue.created_at, '2026-01-02T03:04:05.000Z'); // ISO string passes through
+});
+// ─── normalizeIssues + blocker resolution ───────────────────────────────────
+test('normalizeIssues resolves blocked_by against the full file set, by any alias', () => {
+    const all = [
+        raw({ identifier: 'A-1', state: 'Todo', frontMatter: { id: 'A-1', identifier: 'A-1', blocked_by: ['A-2', 'GHOST'] } }),
+        raw({ identifier: 'A-2', state: 'Done', frontMatter: { id: 'A-2', identifier: 'A-2' } }),
+    ];
+    const [issue] = normalizeIssues([all[0]], all);
+    assert.equal(issue.blocked_by.length, 2);
+    // resolved blocker carries the blocker's real state
+    const resolved = issue.blocked_by.find((b) => b.identifier === 'A-2');
+    assert.deepEqual(resolved, { id: 'A-2', identifier: 'A-2', state: 'Done' });
+    // unresolved blocker keeps the raw ident, null id/state
+    const ghost = issue.blocked_by.find((b) => b.identifier === 'GHOST');
+    assert.deepEqual(ghost, { id: null, identifier: 'GHOST', state: null });
+});
+// ─── state-role helpers ──────────────────────────────────────────────────────
+test('activeStateNames / terminalStateNames return declaration-order names by role', () => {
+    assert.deepEqual(activeStateNames(STATES), ['Todo', 'In Progress']);
+    assert.deepEqual(terminalStateNames(STATES), ['Done', 'Closed']);
+});
+test('the *Names helpers tolerate an empty map', () => {
+    assert.deepEqual(activeStateNames({}), []);
+    assert.deepEqual(terminalStateNames({}), []);
+});
+test('pickHoldingState returns first holding state; throws NoHoldingStateError when none', () => {
+    assert.equal(pickHoldingState(STATES), 'Triage');
+    assert.throws(() => pickHoldingState({ Todo: { role: 'active' }, Done: { role: 'terminal' } }), NoHoldingStateError);
+});
+// ─── active-candidate filtering ──────────────────────────────────────────────
+test('selectCandidateIssues keeps active non-terminal files, case-insensitively', () => {
+    const all = [
+        raw({ identifier: '1', state: 'todo' }), // active (case-insensitive match)
+        raw({ identifier: '2', state: 'In Progress' }), // active
+        raw({ identifier: '3', state: 'Done' }), // terminal → excluded
+        raw({ identifier: '4', state: 'Triage' }), // holding → excluded
+        raw({ identifier: '5', state: 'Scratch' }), // undeclared → excluded
+    ];
+    const ids = selectCandidateIssues(all, STATES).map((i) => i.id).sort();
+    assert.deepEqual(ids, ['1', '2']);
+});
+test('selectCandidateIssues excludes a state that is both active and terminal (!terminal wins)', () => {
+    const states = {
+        Weird: { role: 'active' },
+        WeirdDup: { role: 'terminal' },
+    };
+    // "weird" lowercases to active only; make a state that is declared twice via
+    // case to land in both sets.
+    const both = { foo: { role: 'active' }, Foo: { role: 'terminal' } };
+    const all = [raw({ identifier: '1', state: 'foo' })];
+    assert.deepEqual(selectCandidateIssues(all, both).map((i) => i.id), []);
+    // sanity: the plain active case still passes
+    assert.deepEqual(selectCandidateIssues([raw({ identifier: '1', state: 'Weird' })], states).map((i) => i.id), ['1']);
+});
+test('selectIssuesByStates / selectIssuesByIds filter and short-circuit on empty input', () => {
+    const all = [
+        raw({ identifier: '1', state: 'Done' }),
+        raw({ identifier: '2', state: 'Todo' }),
+    ];
+    assert.deepEqual(selectIssuesByStates(all, ['done']).map((i) => i.id), ['1']);
+    assert.deepEqual(selectIssuesByStates(all, []), []);
+    assert.deepEqual(selectIssuesByIds(all, ['2']).map((i) => i.id), ['2']);
+    assert.deepEqual(selectIssuesByIds(all, []), []);
+});
+// ─── multi-match disambiguation ──────────────────────────────────────────────
+test('resolveMatch: single candidate returns it; empty throws not_found', () => {
+    const c = raw({ identifier: 'X', state: 'Todo' });
+    assert.equal(resolveMatch([c], 'X', undefined), c);
+    assert.throws(() => resolveMatch([], 'X', undefined), (e) => e instanceof TrackerError && e.code === 'local_issue_not_found');
+});
+test('resolveMatch: disambiguates duplicates via fromState, else throws ambiguous', () => {
+    const live = raw({ identifier: 'X', state: 'In Progress' });
+    const stale = raw({ identifier: 'X', state: 'Done' });
+    // fromState picks the live copy even though readdir order put stale first
+    assert.equal(resolveMatch([stale, live], 'X', 'In Progress'), live);
+    // no fromState → refuse to guess
+    assert.throws(() => resolveMatch([stale, live], 'X', undefined), (e) => e instanceof TrackerError && e.code === 'local_issue_ambiguous');
+    // fromState that matches >1 (or 0) → still ambiguous
+    const dupA = raw({ identifier: 'X', state: 'Done' });
+    const dupB = raw({ identifier: 'X', state: 'Done' });
+    assert.throws(() => resolveMatch([dupA, dupB], 'X', 'Done'), (e) => e instanceof TrackerError && e.code === 'local_issue_ambiguous');
+});
+test('matchingCandidates filters by canonical id (front-matter id wins)', () => {
+    const all = [
+        raw({ identifier: 'file-a', state: 'Todo', frontMatter: { id: 'SHARED' } }),
+        raw({ identifier: 'file-b', state: 'Done', frontMatter: { id: 'SHARED' } }),
+        raw({ identifier: 'other', state: 'Todo' }),
+    ];
+    const matches = matchingCandidates(all, 'SHARED');
+    assert.deepEqual(matches.map((m) => m.identifier).sort(), ['file-a', 'file-b']);
+    assert.deepEqual(matchingCandidates(all, 'other').map((m) => m.identifier), ['other']);
+});
+// ─── next-free-identifier collision pick ─────────────────────────────────────
+test('pickNextNumericIdentifier counts up from 1 past every taken numeric id', () => {
+    assert.equal(pickNextNumericIdentifier(new Set()), '1');
+    assert.equal(pickNextNumericIdentifier(new Set(['1', '2'])), '3');
+    // gaps are filled: 1 and 3 taken, 2 free → '2'
+    assert.equal(pickNextNumericIdentifier(new Set(['1', '3'])), '2');
+    // title-slug files are inert (don't consume numeric slots)
+    assert.equal(pickNextNumericIdentifier(new Set(['add-changelog', 'fix-bug'])), '1');
+    // numeric + slug mix
+    assert.equal(pickNextNumericIdentifier(new Set(['1', 'add-changelog', '2'])), '3');
+});
+//# sourceMappingURL=parse.test.js.map

package/dist/tests/core/parse.test.js.map

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

package/dist/tests/core/path.test.js

@@ -0,0 +1,50 @@
+// Pure unit tests for src/core/path.ts — the canonical lexical POSIX helpers.
+// These PIN the edge cases the ~6 former copies disagreed on (trailing slash,
+// double separator, empty base, absolute rel), so the drift can't silently
+// reappear. See core/path.ts header.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { joinPosix, joinPosixParts, basename, posixDirname } from '../../src/core/path.js';
+// ─── joinPosix: the superset (predicates) behaviour is canonical ──────────────
+test('joinPosix: plain join with exactly one separator at the seam', () => {
+    assert.equal(joinPosix('/ws', 'file.txt'), '/ws/file.txt');
+});
+test('joinPosix: a single trailing slash on base is collapsed (no double sep)', () => {
+    assert.equal(joinPosix('/ws/', 'README.md'), '/ws/README.md');
+});
+test('joinPosix: an absolute rel (leading /) is returned VERBATIM', () => {
+    // The vm-guards copy used to strip the leading slash + re-anchor; the canonical
+    // (predicates) form returns the absolute rel as-is. This is the resolved drift.
+    assert.equal(joinPosix('/ws', '/etc/hosts'), '/etc/hosts');
+});
+test('joinPosix: an empty base returns rel verbatim', () => {
+    assert.equal(joinPosix('', 'rel/path'), 'rel/path');
+});
+// ─── joinPosixParts: variadic, empty-filtering, multi-sep collapsing ──────────
+test('joinPosixParts: joins literal segments and collapses any 2+ separator run', () => {
+    assert.equal(joinPosixParts('/home/x/', '.claude', '.credentials.json'), '/home/x/.claude/.credentials.json');
+});
+test('joinPosixParts: empty parts are dropped', () => {
+    assert.equal(joinPosixParts('/base', '', 'leaf'), '/base/leaf');
+});
+// ─── basename: strips trailing separator(s), handles / and \ ──────────────────
+test('basename: final segment of a POSIX path', () => {
+    assert.equal(basename('/repo/workflow.md'), 'workflow.md');
+});
+test('basename: a trailing slash is stripped before taking the segment', () => {
+    assert.equal(basename('/repo/dir/'), 'dir');
+});
+test('basename: a no-separator input returns itself', () => {
+    assert.equal(basename('workflow.md'), 'workflow.md');
+});
+test('basename: a Windows-style separator is also honoured', () => {
+    assert.equal(basename('C:\\proj\\workflow.md'), 'workflow.md');
+});
+// ─── posixDirname: everything before the final /, root collapses to / ─────────
+test('posixDirname: parent directory of an absolute path', () => {
+    assert.equal(posixDirname('/ws/sub/file'), '/ws/sub');
+});
+test('posixDirname: a path whose only separator is leading collapses to /', () => {
+    assert.equal(posixDirname('/file'), '/');
+});
+//# sourceMappingURL=path.test.js.map

package/dist/tests/core/path.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.test.js","sourceRoot":"","sources":["../../../tests/core/path.test.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,qCAAqC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3F,iFAAiF;AAEjF,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;IACxE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,gFAAgF;IAChF,gFAAgF;IAChF,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,IAAI,CAAC,2EAA2E,EAAE,GAAG,EAAE;IACrF,MAAM,CAAC,KAAK,CACV,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,mBAAmB,CAAC,EAC1D,mCAAmC,CACpC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,aAAa,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC5E,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,aAAa,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qEAAqE,EAAE,GAAG,EAAE;IAC/E,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

package/dist/tests/core/plan.test.js

@@ -0,0 +1,218 @@
+// Pure unit tests for src/core/actions/plan.ts — no mocks (planActions is a
+// pure (data) -> data function). node:test + node:assert, run with tsx.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { planActions } from '../../src/core/actions/plan.js';
+// --- fixtures --------------------------------------------------------------
+const WS = '/work/agent-42';
+function ctx(partial = {}) {
+    return {
+        identifier: '42',
+        workspace: WS,
+        branch: 'agent/42',
+        base_branch: 'main',
+        issue_title: 'Fix the bug',
+        issue_body: 'body text',
+        repo: 'octo/repo',
+        pr_title: '[42] Fix the bug',
+        pr_body_file: '/tmp/body-42.md',
+        ...partial,
+    };
+}
+const OPTS = { workspacePath: WS };
+function plan(actions, c = ctx(), opts = OPTS) {
+    return planActions(actions, c, opts);
+}
+function runOf(p) {
+    assert.equal(p.kind, 'run', `expected run, got ${p.kind}`);
+    return p;
+}
+function git(e) {
+    assert.equal(e.family, 'git');
+    return e;
+}
+// --- snapshot keying -------------------------------------------------------
+test('snapshotKey uses kind:name when named, kind:#idx otherwise', () => {
+    const out = plan([
+        { kind: 'push_branch', name: 'pb', remote: 'origin', ref: 'main' },
+        { kind: 'push_branch', remote: 'origin', ref: 'main' },
+    ]);
+    assert.equal(out[0].snapshotKey, 'push_branch:pb');
+    assert.equal(out[1].snapshotKey, 'push_branch:#1');
+});
+// --- render failure as data ------------------------------------------------
+test('unknown template variable becomes a render_failed planned action (not a throw)', () => {
+    const out = plan([{ kind: 'push_branch', remote: 'origin', ref: '$nope' }]);
+    const p = out[0];
+    assert.equal(p.kind, 'render_failed');
+    if (p.kind === 'render_failed') {
+        assert.match(p.error.message, /unknown template variable "\$nope"/);
+    }
+});
+test('templates render against ctx before mapping to effects', () => {
+    const out = plan([{ kind: 'push_branch', remote: 'origin', ref: '$branch' }]);
+    const r = runOf(out[0]);
+    assert.equal(r.rendered.ref, 'agent/42');
+    const e = git(r.effects[0]);
+    assert.equal(e.kind, 'push');
+    assert.equal('ref' in e && e.ref, 'agent/42');
+});
+// --- policy normalization --------------------------------------------------
+test('policy defaults to count 3 / backoff 1000 / then abort', () => {
+    const r = runOf(plan([{ kind: 'push_branch', remote: 'origin', ref: 'main' }])[0]);
+    assert.deepEqual(r.policy, { retryCount: 3, backoffMs: 1000, then: 'abort' });
+});
+test('policy honors explicit on_error retry + route', () => {
+    const r = runOf(plan([
+        {
+            kind: 'push_branch',
+            remote: 'origin',
+            ref: 'main',
+            on_error: { retry: { count: 5, backoff_ms: 250 }, then: { route_to: 'Blocked' } },
+        },
+    ])[0]);
+    assert.deepEqual(r.policy, { retryCount: 5, backoffMs: 250, then: { route_to: 'Blocked' } });
+});
+// --- predicate decision carried as data ------------------------------------
+test('no if: resolves to true; string if: is a truthiness check', () => {
+    const none = runOf(plan([{ kind: 'push_branch', remote: 'origin', ref: 'main' }])[0]);
+    assert.deepEqual(none.predicate, { kind: 'resolved', value: true });
+    const truthy = runOf(plan([{ kind: 'push_branch', remote: 'origin', ref: 'main', if: '$repo' }])[0]);
+    assert.deepEqual(truthy.predicate, { kind: 'resolved', value: true });
+    const falsy = runOf(plan([{ kind: 'push_branch', remote: 'origin', ref: 'main', if: '$repo' }], ctx({ repo: null }))[0]);
+    assert.deepEqual(falsy.predicate, { kind: 'resolved', value: false });
+});
+test('branch_exists predicate becomes a probe effect', () => {
+    const r = runOf(plan([{ kind: 'push_branch', remote: 'origin', ref: 'main', if: { branch_exists: '$branch' } }])[0]);
+    assert.equal(r.predicate.kind, 'probe');
+    if (r.predicate.kind === 'probe') {
+        assert.deepEqual(r.predicate.effect, {
+            family: 'git',
+            kind: 'branch_exists',
+            cwd: WS,
+            ref: 'agent/42',
+        });
+    }
+});
+// --- push_branch + NFF fallback (the keystone) -----------------------------
+test('push_branch emits a plain push plus the NFF force-with-lease fallback as data', () => {
+    const r = runOf(plan([{ kind: 'push_branch', remote: 'origin', ref: 'agent/42' }])[0]);
+    // Primary: a single plain push.
+    assert.equal(r.effects.length, 1);
+    assert.deepEqual(r.effects[0], {
+        family: 'git',
+        kind: 'push',
+        cwd: WS,
+        remote: 'origin',
+        ref: 'agent/42',
+    });
+    // Fallback: fetch → rev_parse(remote-tracking) → push_force_with_lease.
+    assert.ok(r.nffFallback, 'nffFallback present');
+    const fb = r.nffFallback;
+    assert.equal(fb.length, 3);
+    assert.deepEqual(fb[0], { family: 'git', kind: 'fetch', cwd: WS, remote: 'origin', ref: 'agent/42' });
+    assert.deepEqual(fb[1], {
+        family: 'git',
+        kind: 'rev_parse',
+        cwd: WS,
+        ref: 'refs/remotes/origin/agent/42',
+    });
+    assert.deepEqual(fb[2], {
+        family: 'git',
+        kind: 'push_force_with_lease',
+        cwd: WS,
+        remote: 'origin',
+        ref: 'agent/42',
+        expectedRemoteSha: '', // placeholder the shell fills from the rev_parse SHA
+    });
+});
+test('only push_branch carries an nffFallback; other kinds are null', () => {
+    for (const a of [
+        { kind: 'create_pr_if_missing', base: 'main', head: 'agent/42', title_from: 't', body_from: 'b' },
+        { kind: 'run_in_vm', name: 'lint', cmd: ['npm', 'run', 'lint'] },
+    ]) {
+        assert.equal(runOf(plan([a])[0]).nffFallback, null, `${a.kind} nffFallback`);
+    }
+});
+// --- create_pr_if_missing --------------------------------------------------
+test('create_pr_if_missing emits a list probe then a create; single-line body = body-file', () => {
+    const r = runOf(plan([
+        {
+            kind: 'create_pr_if_missing',
+            base: 'main',
+            head: 'agent/42',
+            title_from: '$pr_title',
+            body_from: '$pr_body_file',
+        },
+    ])[0]);
+    assert.equal(r.effects.length, 2);
+    assert.deepEqual(r.effects[0], {
+        family: 'gh',
+        kind: 'pr_list_for_branch',
+        cwd: WS,
+        branch: 'agent/42',
+    });
+    assert.deepEqual(r.effects[1], {
+        family: 'gh',
+        kind: 'pr_create',
+        cwd: WS,
+        base: 'main',
+        head: 'agent/42',
+        title: '[42] Fix the bug',
+        bodyOrFile: '/tmp/body-42.md',
+        bodyIsFile: true,
+    });
+});
+test('multi-line body_from is NOT treated as a file', () => {
+    const r = runOf(plan([
+        {
+            kind: 'create_pr_if_missing',
+            base: 'main',
+            head: 'agent/42',
+            title_from: 't',
+            body_from: 'line one\nline two',
+        },
+    ])[0]);
+    const create = r.effects[1];
+    assert.equal(create.bodyIsFile, false);
+});
+// --- run_in_vm -------------------------------------------------------------
+test('run_in_vm emits a single uncached vm exec carrying cmd + env', () => {
+    const a = {
+        kind: 'run_in_vm',
+        name: 'tests',
+        cmd: ['npm', 'test'],
+        env: { CI: '1' },
+        timeout: 120,
+    };
+    const r = runOf(plan([a])[0]);
+    // No cache lookup/write effects — just the bare vm exec.
+    assert.equal(r.effects.length, 1);
+    const exec = r.effects[0];
+    assert.equal(exec.family, 'vm');
+    assert.equal(exec.kind, 'exec');
+    assert.deepEqual(exec.command, ['npm', 'test']);
+    assert.equal(exec.workdir, WS);
+    assert.equal(exec.timeoutMs, 120_000); // action.timeout (s) overrides default
+    assert.deepEqual(exec.env, { CI: '1' });
+});
+test('run_in_vm without timeout uses the bound default (or override)', () => {
+    const a = { kind: 'run_in_vm', name: 'lint', cmd: ['npm', 'run', 'lint'] };
+    const def = runOf(plan([a])[0]);
+    const execDef = def.effects[0];
+    assert.equal(execDef.timeoutMs, 300_000);
+    const over = runOf(plan([a], ctx(), { workspacePath: WS, defaultCommandTimeoutMs: 60_000 })[0]);
+    const execOver = over.effects[0];
+    assert.equal(execOver.timeoutMs, 60_000);
+});
+// --- ordering / multi-action ----------------------------------------------
+test('planActions preserves action order and indices', () => {
+    const out = plan([
+        { kind: 'push_branch', remote: 'origin', ref: 'agent/42' },
+        { kind: 'create_pr_if_missing', base: 'main', head: 'agent/42', title_from: 't', body_from: 'b' },
+    ]);
+    assert.equal(out.length, 2);
+    assert.equal(out[0].snapshotKey, 'push_branch:#0');
+    assert.equal(out[1].snapshotKey, 'create_pr_if_missing:#1');
+});
+//# sourceMappingURL=plan.test.js.map

package/dist/tests/core/plan.test.js.map

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