smol-symphony 0.2.0 → 0.3.0

package/dist/tests/core/sleep-cycle.test.js

@@ -0,0 +1,150 @@
+// Pure unit tests for the sleep-cycle (recurring reflection spawn) core (no mocks
+// — the functions are pure data → data). Covers decideSpawn's trigger branches +
+// precedence + idle gating, the max_in_flight guard, the title/body derivation,
+// and the recordSleepCycleProgress terminal-transition fold (terminal vs
+// non-terminal, the structural exclusion of a reflection's own move by from-state,
+// unconfigured no-op).
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { decideSpawn, recordSleepCycleProgress, } from '../../src/core/schedule/sleep-cycle.js';
+// ─── fixtures ──────────────────────────────────────────────────────────────
+function spawnInput(over = {}) {
+    return {
+        enabled: true,
+        onIdle: true,
+        afterTerminal: 3,
+        doneSinceReflect: 0,
+        idle: false,
+        inFlight: 0,
+        maxInFlight: 1,
+        nowIso: '2026-06-03T13:56:12.000Z',
+        titleTemplate: 'Reflection {{ stamp }}',
+        bodyLeadIn: null,
+        ...over,
+    };
+}
+function transition(over = {}) {
+    return {
+        from_state: 'Review',
+        to_state: 'Done',
+        notes: '',
+        actor: 'claude/default',
+        terminal: true,
+        ...over,
+    };
+}
+function progressEntry(over = {}) {
+    return {
+        issue_id: 'ISS-9',
+        identifier: '9',
+        last_transition: transition(),
+        ...over,
+    };
+}
+// ─── decideSpawn: disabled / capped ────────────────────────────────────────
+test('decideSpawn returns null when spawning is disabled', () => {
+    assert.equal(decideSpawn(spawnInput({ enabled: false, doneSinceReflect: 99 })), null);
+});
+test('decideSpawn returns null when max_in_flight is already reached', () => {
+    // A trigger WOULD fire (done_threshold), but one reflection is already live.
+    assert.equal(decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 9, inFlight: 1, maxInFlight: 1 })), null);
+});
+test('decideSpawn mints when below the in-flight cap', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 9, inFlight: 1, maxInFlight: 2 }));
+    assert.equal(d?.trigger, 'done_threshold');
+});
+// ─── decideSpawn: done_threshold ───────────────────────────────────────────
+test('decideSpawn fires done_threshold when the counter meets the threshold', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 3, idle: false }));
+    assert.equal(d?.trigger, 'done_threshold');
+});
+test('decideSpawn fires done_threshold when the counter exceeds the threshold', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 5 }));
+    assert.equal(d?.trigger, 'done_threshold');
+});
+test('decideSpawn does NOT fire done_threshold below the threshold', () => {
+    assert.equal(decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 2, idle: false })), null);
+});
+test('decideSpawn treats afterTerminal:0 as disabling the done trigger', () => {
+    // afterTerminal 0 must not match (0 >= 0 would be a runaway spawn-every-tick bug).
+    assert.equal(decideSpawn(spawnInput({ afterTerminal: 0, doneSinceReflect: 0, onIdle: false })), null);
+});
+// ─── decideSpawn: idle (gated on doneSinceReflect > 0) ─────────────────────
+test('decideSpawn fires idle when idle and there is fresh terminal work', () => {
+    // below the done threshold so only the idle path can fire
+    const d = decideSpawn(spawnInput({ afterTerminal: 10, doneSinceReflect: 1, idle: true }));
+    assert.equal(d?.trigger, 'idle');
+});
+test('decideSpawn does NOT fire idle when nothing finished since last run', () => {
+    // The anti-spin guard: idle + doneSinceReflect === 0 → no spawn.
+    assert.equal(decideSpawn(spawnInput({ afterTerminal: 10, doneSinceReflect: 0, idle: true })), null);
+});
+test('decideSpawn does NOT fire idle when not idle', () => {
+    assert.equal(decideSpawn(spawnInput({ afterTerminal: 10, doneSinceReflect: 5, idle: false })), null);
+});
+test('decideSpawn does NOT fire idle when onIdle is off', () => {
+    assert.equal(decideSpawn(spawnInput({ onIdle: false, afterTerminal: 10, doneSinceReflect: 5, idle: true })), null);
+});
+// ─── decideSpawn: done_threshold precedence over idle ──────────────────────
+test('decideSpawn prefers done_threshold over idle when both hold', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 4, onIdle: true, idle: true }));
+    assert.equal(d?.trigger, 'done_threshold');
+});
+// ─── decideSpawn: title + body derivation (purely from nowIso) ─────────────
+test('decideSpawn renders {{ stamp }} into the title from nowIso', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 3 }));
+    assert.equal(d?.title, 'Reflection 2026-06-03 13:56');
+});
+test('decideSpawn uses a title template without a placeholder verbatim', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 3, titleTemplate: 'Nightly reflection' }));
+    assert.equal(d?.title, 'Nightly reflection');
+});
+test('decideSpawn renders the done_threshold provenance body (count + threshold + stamp)', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 10, doneSinceReflect: 12 }));
+    assert.match(d.body, /^Auto-spawned reflection cycle\./);
+    assert.match(d.body, /Trigger: done_threshold — 12 issues reached a terminal state/);
+    assert.match(d.body, /threshold: 10/);
+    assert.match(d.body, /Spawned at: 2026-06-03T13:56:12\.000Z\./);
+    // Plain provenance only — no instructions / guardrails (those live in the prompt).
+    assert.doesNotMatch(d.body, /approve\/discard|Triage|propose_issue/);
+});
+test('decideSpawn renders the idle provenance body', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 10, doneSinceReflect: 2, idle: true }));
+    assert.match(d.body, /Trigger: idle — the orchestrator went idle with 2 issue\(s\) finished/);
+});
+test('decideSpawn honours a configured body lead-in', () => {
+    const d = decideSpawn(spawnInput({ afterTerminal: 3, doneSinceReflect: 3, bodyLeadIn: 'Custom lead-in.' }));
+    assert.match(d.body, /^Custom lead-in\./);
+});
+// ─── recordSleepCycleProgress ──────────────────────────────────────────────
+test('recordSleepCycleProgress increments on a terminal transition (from a normal state)', () => {
+    assert.equal(recordSleepCycleProgress(2, progressEntry(), 'Reflect'), 3);
+});
+test('recordSleepCycleProgress does NOT increment on a non-terminal transition', () => {
+    const entry = progressEntry({ last_transition: transition({ terminal: false, to_state: 'In Review' }) });
+    assert.equal(recordSleepCycleProgress(2, entry, 'Reflect'), 2);
+});
+test('recordSleepCycleProgress does NOT increment when there was no transition', () => {
+    assert.equal(recordSleepCycleProgress(2, progressEntry({ last_transition: null }), 'Reflect'), 2);
+});
+test("recordSleepCycleProgress excludes a finished reflection's own move (terminal out of the spawn state)", () => {
+    // A reflection terminates Reflect → Reflected; its own terminal move must NOT
+    // count toward spawning the next cycle.
+    const entry = progressEntry({
+        last_transition: transition({ from_state: 'Reflect', to_state: 'Reflected' }),
+    });
+    assert.equal(recordSleepCycleProgress(2, entry, 'Reflect'), 2);
+});
+test('recordSleepCycleProgress excludes the spawn-state move case-insensitively', () => {
+    const entry = progressEntry({
+        last_transition: transition({ from_state: 'reflect', to_state: 'Cancelled' }),
+    });
+    assert.equal(recordSleepCycleProgress(2, entry, 'Reflect'), 2);
+});
+test('recordSleepCycleProgress is a no-op when spawning is unconfigured (null spawn state)', () => {
+    assert.equal(recordSleepCycleProgress(7, progressEntry(), null), 7);
+});
+test('recordSleepCycleProgress counts an unrelated terminal exit from zero', () => {
+    assert.equal(recordSleepCycleProgress(0, progressEntry(), 'Reflect'), 1);
+});
+//# sourceMappingURL=sleep-cycle.test.js.map

package/dist/tests/core/sleep-cycle.test.js.map

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

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

@@ -0,0 +1,201 @@
+// Pure unit tests for src/core/schedule/slots.ts (node:test + node:assert).
+// The module is pure/synchronous, so no mocks are needed — every test feeds
+// plain-data snapshots and asserts on the returned decision.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { availableGlobalSlots, hasGlobalSlot, hasPerStateSlot, resolvePerStateCap, sortForDispatch, } from '../../src/core/schedule/slots.js';
+function snapshot(over = {}) {
+    return {
+        effectiveCap: 3,
+        runningCount: 0,
+        runningStates: [],
+        pendingRetries: [],
+        ...over,
+    };
+}
+function issue(over = {}) {
+    return {
+        id: 'i',
+        identifier: 'ISSUE-1',
+        title: 't',
+        description: null,
+        priority: null,
+        state: 'Todo',
+        branch_name: null,
+        url: null,
+        labels: [],
+        blocked_by: [],
+        created_at: null,
+        updated_at: null,
+        ...over,
+    };
+}
+// ---------------------------------------------------------------------------
+// availableGlobalSlots
+// ---------------------------------------------------------------------------
+test('availableGlobalSlots: empty system returns the full cap', () => {
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 3 })), 3);
+});
+test('availableGlobalSlots: running attempts consume slots', () => {
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 3, runningCount: 2 })), 1);
+});
+test('availableGlobalSlots: pending CONTINUATION holds a slot', () => {
+    const pendingRetries = [{ kind: 'continuation', target_state: 'Review' }];
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 3, runningCount: 1, pendingRetries })), 1);
+});
+test('availableGlobalSlots: failure retries do NOT hold a slot', () => {
+    const pendingRetries = [
+        { kind: 'failure', target_state: 'Todo' },
+        { kind: 'failure', target_state: 'Todo' },
+    ];
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 3, runningCount: 1, pendingRetries })), 2);
+});
+test('availableGlobalSlots: mixed continuations + failures only count continuations', () => {
+    const pendingRetries = [
+        { kind: 'continuation', target_state: 'Review' },
+        { kind: 'failure', target_state: 'Todo' },
+        { kind: 'continuation', target_state: 'Done' },
+    ];
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 5, runningCount: 1, pendingRetries })), 2);
+});
+test('availableGlobalSlots: never negative (clamped at 0)', () => {
+    const pendingRetries = [{ kind: 'continuation', target_state: 'Review' }];
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 1, runningCount: 2, pendingRetries })), 0);
+});
+test('availableGlobalSlots: a clamped effectiveCap below running yields 0', () => {
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 0, runningCount: 0 })), 0);
+    assert.equal(availableGlobalSlots(snapshot({ effectiveCap: 1, runningCount: 3 })), 0);
+});
+test('hasGlobalSlot reflects availableGlobalSlots > 0', () => {
+    assert.equal(hasGlobalSlot(snapshot({ effectiveCap: 1, runningCount: 0 })), true);
+    assert.equal(hasGlobalSlot(snapshot({ effectiveCap: 1, runningCount: 1 })), false);
+});
+// ---------------------------------------------------------------------------
+// resolvePerStateCap
+// ---------------------------------------------------------------------------
+test('resolvePerStateCap: case-insensitive lookup', () => {
+    const caps = { Review: { max_concurrent: 2 } };
+    assert.equal(resolvePerStateCap('review', caps), 2);
+    assert.equal(resolvePerStateCap('REVIEW', caps), 2);
+    assert.equal(resolvePerStateCap('Review', caps), 2);
+});
+test('resolvePerStateCap: unknown state returns undefined', () => {
+    assert.equal(resolvePerStateCap('Nope', { Review: { max_concurrent: 2 } }), undefined);
+});
+test('resolvePerStateCap: missing or zero cap collapses to undefined', () => {
+    assert.equal(resolvePerStateCap('A', { A: {} }), undefined);
+    assert.equal(resolvePerStateCap('B', { B: { max_concurrent: 0 } }), undefined);
+});
+// ---------------------------------------------------------------------------
+// hasPerStateSlot
+// ---------------------------------------------------------------------------
+test('hasPerStateSlot: no per-state cap falls back to the global gate', () => {
+    const caps = {}; // no caps declared
+    assert.equal(hasPerStateSlot('Todo', snapshot({ effectiveCap: 1, runningCount: 0 }), caps), true);
+    assert.equal(hasPerStateSlot('Todo', snapshot({ effectiveCap: 1, runningCount: 1 }), caps), false);
+});
+test('hasPerStateSlot: under the per-state cap with a free global slot', () => {
+    const caps = { Review: { max_concurrent: 2 } };
+    const snap = snapshot({ effectiveCap: 5, runningCount: 1, runningStates: ['Review'] });
+    assert.equal(hasPerStateSlot('Review', snap, caps), true); // inState=1 < 2, global free
+});
+test('hasPerStateSlot: at the per-state cap blocks even with global slots free', () => {
+    const caps = { Review: { max_concurrent: 2 } };
+    const snap = snapshot({ effectiveCap: 10, runningCount: 2, runningStates: ['Review', 'Review'] });
+    assert.equal(hasPerStateSlot('Review', snap, caps), false); // inState=2 == cap
+});
+test('hasPerStateSlot: under per-state cap but global gate full blocks', () => {
+    const caps = { Review: { max_concurrent: 5 } };
+    const snap = snapshot({ effectiveCap: 2, runningCount: 2, runningStates: ['Review', 'Other'] });
+    // inState=1 < 5 but global slots = 0
+    assert.equal(hasPerStateSlot('Review', snap, caps), false);
+});
+test('hasPerStateSlot: pending continuation targeting the state counts against its cap', () => {
+    const caps = { Review: { max_concurrent: 2 } };
+    const pendingRetries = [{ kind: 'continuation', target_state: 'review' }];
+    const snap = snapshot({
+        effectiveCap: 10,
+        runningCount: 1,
+        runningStates: ['Review'],
+        pendingRetries,
+    });
+    // inState = 1 running + 1 continuation = 2 == cap → blocked
+    assert.equal(hasPerStateSlot('Review', snap, caps), false);
+});
+test('hasPerStateSlot: failure retry targeting the state does NOT count against its cap', () => {
+    const caps = { Review: { max_concurrent: 2 } };
+    const pendingRetries = [{ kind: 'failure', target_state: 'Review' }];
+    const snap = snapshot({
+        effectiveCap: 10,
+        runningCount: 1,
+        runningStates: ['Review'],
+        pendingRetries,
+    });
+    // inState = 1 running only (failure ignored) < 2 → allowed
+    assert.equal(hasPerStateSlot('Review', snap, caps), true);
+});
+test('hasPerStateSlot: running state matching is case-insensitive', () => {
+    const caps = { Review: { max_concurrent: 1 } };
+    const snap = snapshot({ effectiveCap: 10, runningCount: 1, runningStates: ['rEvIeW'] });
+    assert.equal(hasPerStateSlot('Review', snap, caps), false); // inState=1 == cap
+});
+// ---------------------------------------------------------------------------
+// sortForDispatch
+// ---------------------------------------------------------------------------
+test('sortForDispatch: priority ASC, null priority ordered last', () => {
+    const a = issue({ identifier: 'A', priority: 3 });
+    const b = issue({ identifier: 'B', priority: 1 });
+    const c = issue({ identifier: 'C', priority: null });
+    const d = issue({ identifier: 'D', priority: 2 });
+    const sorted = sortForDispatch([a, b, c, d]);
+    assert.deepEqual(sorted.map((i) => i.identifier), ['B', 'D', 'A', 'C']);
+});
+test('sortForDispatch: equal priority breaks by created_at ASC', () => {
+    const a = issue({ identifier: 'A', priority: 1, created_at: '2026-06-02T12:00:00Z' });
+    const b = issue({ identifier: 'B', priority: 1, created_at: '2026-06-01T12:00:00Z' });
+    const sorted = sortForDispatch([a, b]);
+    assert.deepEqual(sorted.map((i) => i.identifier), ['B', 'A']);
+});
+test('sortForDispatch: missing created_at ordered after a dated one at same priority', () => {
+    const dated = issue({ identifier: 'A', priority: 1, created_at: '2026-06-01T00:00:00Z' });
+    const undatedX = issue({ identifier: 'X', priority: 1, created_at: null });
+    const undatedY = issue({ identifier: 'Y', priority: 1, created_at: null });
+    const sorted = sortForDispatch([undatedY, dated, undatedX]);
+    // dated keeps no advantage by the created_at branch (finite guard skips when
+    // one side is non-finite), so the order is decided by identifier across the
+    // whole equal-priority group: A, X, Y.
+    assert.deepEqual(sorted.map((i) => i.identifier), ['A', 'X', 'Y']);
+});
+test('sortForDispatch: identifier localeCompare is the final tiebreak', () => {
+    const a = issue({ identifier: 'B', priority: 1, created_at: '2026-06-01T00:00:00Z' });
+    const b = issue({ identifier: 'A', priority: 1, created_at: '2026-06-01T00:00:00Z' });
+    const sorted = sortForDispatch([a, b]);
+    assert.deepEqual(sorted.map((i) => i.identifier), ['A', 'B']);
+});
+test('sortForDispatch: does not mutate the input array', () => {
+    const a = issue({ identifier: 'A', priority: 2 });
+    const b = issue({ identifier: 'B', priority: 1 });
+    const input = [a, b];
+    const sorted = sortForDispatch(input);
+    assert.deepEqual(input.map((i) => i.identifier), ['A', 'B']); // original order intact
+    assert.deepEqual(sorted.map((i) => i.identifier), ['B', 'A']);
+    assert.notEqual(sorted, input);
+});
+test('sortForDispatch: malformed created_at treated as unparseable (ordered by identifier)', () => {
+    const good = issue({ identifier: 'A', priority: 1, created_at: '2026-06-01T00:00:00Z' });
+    const bad = issue({ identifier: 'Z', priority: 1, created_at: 'not-a-date' });
+    const sorted = sortForDispatch([bad, good]);
+    assert.deepEqual(sorted.map((i) => i.identifier), ['A', 'Z']);
+});
+test('sortForDispatch: injected parseTimestamp is honoured', () => {
+    // Reverse the natural order via a custom parser to prove injection works.
+    const a = issue({ identifier: 'A', priority: 1, created_at: '1' });
+    const b = issue({ identifier: 'B', priority: 1, created_at: '2' });
+    const parse = (iso) => (iso ? -Number(iso) : Number.NaN);
+    const sorted = sortForDispatch([a, b], parse);
+    assert.deepEqual(sorted.map((i) => i.identifier), ['B', 'A']); // -2 < -1
+});
+test('sortForDispatch: empty array returns empty array', () => {
+    assert.deepEqual(sortForDispatch([]), []);
+});
+//# sourceMappingURL=slots.test.js.map

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

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

package/dist/tests/core/state-resolve.test.js

@@ -0,0 +1,80 @@
+// Pure unit tests for src/core/state-resolve.ts — the ONE canonical
+// case-insensitive declared-state-name resolver. No mocks (every export is pure).
+//
+// Migrated from the deleted core/states.ts:resolveStateKey suite, plus direct
+// coverage of the shape-agnostic resolveDeclaredName the MCP states-view path uses.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { resolveStateKey, resolveDeclaredName } from '../../src/core/state-resolve.js';
+const STATES = {
+    Todo: { role: 'holding' },
+    Doing: { role: 'active' },
+    Review: { role: 'active' },
+    Done: { role: 'terminal' },
+};
+// ─── resolveStateKey (Record-shaped) ─────────────────────────────────────────
+test('resolveStateKey: exact match wins', () => {
+    assert.equal(resolveStateKey(STATES, 'Doing'), 'Doing');
+});
+test('resolveStateKey: case-insensitive fallback resolves to canonical key', () => {
+    assert.equal(resolveStateKey(STATES, 'doing'), 'Doing');
+    assert.equal(resolveStateKey(STATES, 'DONE'), 'Done');
+});
+test('resolveStateKey: unknown state returns null', () => {
+    assert.equal(resolveStateKey(STATES, 'Nope'), null);
+});
+test('resolveStateKey: exact own-property match wins over a case-insensitive twin', () => {
+    const states = {
+        work: { role: 'active' },
+        Work: { role: 'active' },
+    };
+    assert.equal(resolveStateKey(states, 'Work'), 'Work');
+    assert.equal(resolveStateKey(states, 'work'), 'work');
+});
+test('resolveStateKey: empty map returns null', () => {
+    assert.equal(resolveStateKey({}, 'X'), null);
+});
+// ─── resolveDeclaredName (shape-agnostic, ordered name list) ─────────────────
+test('resolveDeclaredName: exact match wins', () => {
+    assert.equal(resolveDeclaredName(['Todo', 'Doing', 'Done'], 'Doing'), 'Doing');
+});
+test('resolveDeclaredName: case-insensitive fallback returns declared casing', () => {
+    assert.equal(resolveDeclaredName(['Todo', 'Doing', 'Done'], 'doing'), 'Doing');
+    assert.equal(resolveDeclaredName(['Todo', 'Doing', 'Done'], 'DONE'), 'Done');
+});
+test('resolveDeclaredName: first case-insensitive match in declaration order wins', () => {
+    // Two names that lowercase to the same value: declaration order decides.
+    assert.equal(resolveDeclaredName(['Work', 'work'], 'WORK'), 'Work');
+});
+test('resolveDeclaredName: exact match short-circuits the case-insensitive scan', () => {
+    assert.equal(resolveDeclaredName(['Work', 'work'], 'work'), 'work');
+});
+test('resolveDeclaredName: unknown name + empty list return null', () => {
+    assert.equal(resolveDeclaredName(['Todo'], 'Nope'), null);
+    assert.equal(resolveDeclaredName([], 'X'), null);
+});
+test('resolveDeclaredName: empty-string name never matches a declared state', () => {
+    assert.equal(resolveDeclaredName(['Todo', 'Done'], ''), null);
+});
+// ─── cross-shape equivalence (the load-bearing claim of the consolidation) ────
+//
+// The MCP dispatch path (resolveDeclaredName over McpStatesView.order) and the
+// Record-keyed resolveStateKey must agree for every input — the substitution of
+// `order.includes(name)` for `hasOwnProperty(views, name)` is only safe because
+// `order` lists exactly the declared keys in declaration order.
+test('resolveStateKey and resolveDeclaredName agree over Object.keys(states)', () => {
+    const order = Object.keys(STATES);
+    for (const probe of ['Doing', 'doing', 'DONE', 'Todo', 'tODo', 'Nope', '']) {
+        assert.equal(resolveDeclaredName(order, probe), resolveStateKey(STATES, probe), `disagreement for probe "${probe}"`);
+    }
+});
+test('cross-shape: both honor declaration-order first-match for case-insensitive twins', () => {
+    const states = {
+        Work: { role: 'active' },
+        work: { role: 'active' },
+    };
+    const order = Object.keys(states); // ['Work', 'work']
+    assert.equal(resolveDeclaredName(order, 'WORK'), 'Work');
+    assert.equal(resolveStateKey(states, 'WORK'), 'Work');
+});
+//# sourceMappingURL=state-resolve.test.js.map

package/dist/tests/core/state-resolve.test.js.map

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