smol-symphony 0.2.0 → 0.3.0

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

@@ -0,0 +1,215 @@
+// Pure unit tests for the memory-admission decider (no mocks — the functions are
+// pure data → data). Covers parseMemAvailableMib + computeMemoryAdmission's
+// branches + decideAvailableGlobalSlots's clamp-transition log decision.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { parseMemAvailableMib, computeMemoryAdmission, decideAvailableGlobalSlots, } from '../../src/core/schedule/admission.js';
+// ─── parseMemAvailableMib ──────────────────────────────────────────────────
+test('parseMemAvailableMib pulls MemAvailable and converts KiB → MiB (floored)', () => {
+    const meminfo = [
+        'MemTotal:       16384000 kB',
+        'MemFree:         1000000 kB',
+        'MemAvailable:    8388608 kB', // 8388608 / 1024 = 8192
+        'Buffers:          200000 kB',
+    ].join('\n');
+    assert.equal(parseMemAvailableMib(meminfo), 8192);
+});
+test('parseMemAvailableMib floors a non-exact KiB value', () => {
+    // 2049 kB / 1024 = 2.0009… → floor 2
+    assert.equal(parseMemAvailableMib('MemAvailable:    2049 kB\n'), 2);
+});
+test('parseMemAvailableMib returns null when the line is missing', () => {
+    assert.equal(parseMemAvailableMib('MemTotal: 16384000 kB\n'), null);
+});
+test('parseMemAvailableMib returns null when the line is malformed', () => {
+    assert.equal(parseMemAvailableMib('MemAvailable: not-a-number kB\n'), null);
+});
+// ─── computeMemoryAdmission ────────────────────────────────────────────────
+test('disabled → static cap passes through, clamp inactive, room null', () => {
+    const r = computeMemoryAdmission({
+        enabled: false,
+        staticCap: 4,
+        running: 1,
+        probe: { memAvailableMib: 100000 },
+        reserveMib: 2048,
+        perVmMib: 4096,
+    });
+    assert.equal(r.effectiveCap, 4);
+    assert.equal(r.clampActive, false);
+    assert.equal(r.admissionRoom, null);
+    // memAvailableMib still echoed through for the dashboard.
+    assert.equal(r.memAvailableMib, 100000);
+});
+test('null probe reading (unsupported host) → skip clamp, static cap', () => {
+    const r = computeMemoryAdmission({
+        enabled: true,
+        staticCap: 4,
+        running: 0,
+        probe: { memAvailableMib: null },
+        reserveMib: 2048,
+        perVmMib: 4096,
+    });
+    assert.equal(r.effectiveCap, 4);
+    assert.equal(r.clampActive, false);
+    assert.equal(r.admissionRoom, null);
+    assert.equal(r.memAvailableMib, null);
+});
+test('perVmMib <= 0 → skip clamp (no divide-by-zero), static cap', () => {
+    const r = computeMemoryAdmission({
+        enabled: true,
+        staticCap: 4,
+        running: 0,
+        probe: { memAvailableMib: 100000 },
+        reserveMib: 2048,
+        perVmMib: 0,
+    });
+    assert.equal(r.effectiveCap, 4);
+    assert.equal(r.clampActive, false);
+    assert.equal(r.admissionRoom, null);
+});
+test('plenty of memory → effective cap == static cap, clamp inactive but room reported', () => {
+    // headroom = 100000 - 2048 = 97952; room = floor(97952 / 4096) = 23.
+    // running(0) + room(23) = 23 >= staticCap(4) ⇒ effective = 4, clamp off.
+    const r = computeMemoryAdmission({
+        enabled: true,
+        staticCap: 4,
+        running: 0,
+        probe: { memAvailableMib: 100000 },
+        reserveMib: 2048,
+        perVmMib: 4096,
+    });
+    assert.equal(r.admissionRoom, 23);
+    assert.equal(r.effectiveCap, 4);
+    assert.equal(r.clampActive, false);
+});
+test('memory-constrained → clamp active, effective cap below static cap', () => {
+    // headroom = 10240 - 2048 = 8192; room = floor(8192 / 4096) = 2.
+    // running(1) + room(2) = 3 < staticCap(8) ⇒ effective = 3, clamp ON.
+    const r = computeMemoryAdmission({
+        enabled: true,
+        staticCap: 8,
+        running: 1,
+        probe: { memAvailableMib: 10240 },
+        reserveMib: 2048,
+        perVmMib: 4096,
+    });
+    assert.equal(r.admissionRoom, 2);
+    assert.equal(r.effectiveCap, 3);
+    assert.equal(r.clampActive, true);
+});
+test('headroom at or below reserve → room 0, effective cap == running', () => {
+    // headroom = 2048 - 2048 = 0 ⇒ room 0. running(2) + 0 = 2 < staticCap(5) ⇒ clamp on.
+    const r = computeMemoryAdmission({
+        enabled: true,
+        staticCap: 5,
+        running: 2,
+        probe: { memAvailableMib: 2048 },
+        reserveMib: 2048,
+        perVmMib: 4096,
+    });
+    assert.equal(r.admissionRoom, 0);
+    assert.equal(r.effectiveCap, 2);
+    assert.equal(r.clampActive, true);
+});
+test('negative headroom (mem below reserve) → room 0', () => {
+    const r = computeMemoryAdmission({
+        enabled: true,
+        staticCap: 5,
+        running: 0,
+        probe: { memAvailableMib: 1000 },
+        reserveMib: 2048,
+        perVmMib: 4096,
+    });
+    assert.equal(r.admissionRoom, 0);
+    assert.equal(r.effectiveCap, 0);
+    assert.equal(r.clampActive, true);
+});
+// ─── decideAvailableGlobalSlots ────────────────────────────────────────────
+const clampedAdmission = {
+    enabled: true,
+    staticCap: 8,
+    effectiveCap: 3,
+    admissionRoom: 2,
+    memAvailableMib: 10240,
+    reserveMib: 2048,
+    perVmMib: 4096,
+    clampActive: true,
+};
+const unclampedAdmission = {
+    enabled: true,
+    staticCap: 8,
+    effectiveCap: 8,
+    admissionRoom: 23,
+    memAvailableMib: 100000,
+    reserveMib: 2048,
+    perVmMib: 4096,
+    clampActive: false,
+};
+test('available slots = effectiveCap - running - pendingContinuations, floored at 0', () => {
+    const r = decideAvailableGlobalSlots({
+        admission: unclampedAdmission,
+        running: 2,
+        pendingContinuations: 1,
+        previousClampActive: false,
+    });
+    assert.equal(r.availableSlots, 5); // 8 - 2 - 1
+    assert.equal(r.nextClampActive, false);
+    assert.deepEqual(r.logs, []);
+});
+test('available slots never goes negative', () => {
+    const r = decideAvailableGlobalSlots({
+        admission: clampedAdmission,
+        running: 3,
+        pendingContinuations: 2,
+        previousClampActive: true,
+    });
+    assert.equal(r.availableSlots, 0); // max(0, 3 - 3 - 2)
+});
+test('clamp transition OFF→ON emits a single "clamping concurrency" info log', () => {
+    const r = decideAvailableGlobalSlots({
+        admission: clampedAdmission,
+        running: 1,
+        pendingContinuations: 0,
+        previousClampActive: false,
+    });
+    assert.equal(r.nextClampActive, true);
+    assert.equal(r.logs.length, 1);
+    const [logEffect] = r.logs;
+    assert.equal(logEffect.family, 'log');
+    assert.equal(logEffect.level, 'info');
+    assert.equal(logEffect.message, 'memory admission clamping concurrency');
+    assert.deepEqual(logEffect.fields, {
+        static_cap: 8,
+        effective_cap: 3,
+        mem_available_mib: 10240,
+        reserve_mib: 2048,
+        per_vm_mib: 4096,
+    });
+});
+test('clamp transition ON→OFF emits a single "cleared" info log', () => {
+    const r = decideAvailableGlobalSlots({
+        admission: unclampedAdmission,
+        running: 0,
+        pendingContinuations: 0,
+        previousClampActive: true,
+    });
+    assert.equal(r.nextClampActive, false);
+    assert.equal(r.logs.length, 1);
+    const [logEffect] = r.logs;
+    assert.equal(logEffect.message, 'memory admission cleared; full static cap available');
+    assert.deepEqual(logEffect.fields, {
+        static_cap: 8,
+        mem_available_mib: 100000,
+    });
+});
+test('no clamp transition (steady clamped) emits no log', () => {
+    const r = decideAvailableGlobalSlots({
+        admission: clampedAdmission,
+        running: 1,
+        pendingContinuations: 0,
+        previousClampActive: true,
+    });
+    assert.deepEqual(r.logs, []);
+    assert.equal(r.nextClampActive, true);
+});
+//# sourceMappingURL=admission.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admission.test.js","sourceRoot":"","sources":["../../../tests/core/admission.test.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4EAA4E;AAC5E,yEAAyE;AAEzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,sCAAsC,CAAC;AAE9C,8EAA8E;AAE9E,IAAI,CAAC,0EAA0E,EAAE,GAAG,EAAE;IACpF,MAAM,OAAO,GAAG;QACd,6BAA6B;QAC7B,6BAA6B;QAC7B,6BAA6B,EAAE,wBAAwB;QACvD,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,qCAAqC;IACrC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,yBAAyB,CAAC,EAAE,IAAI,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;IACxE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,iCAAiC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,MAAM,CAAC,GAAG,sBAAsB,CAAC;QAC/B,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;QAClC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACpC,0DAA0D;IAC1D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,CAAC,GAAG,sBAAsB,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QAChC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,CAAC,GAAG,sBAAsB,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;QAClC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,CAAC;KACZ,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kFAAkF,EAAE,GAAG,EAAE;IAC5F,qEAAqE;IACrE,yEAAyE;IACzE,MAAM,CAAC,GAAG,sBAAsB,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;QAClC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC7E,iEAAiE;IACjE,qEAAqE;IACrE,MAAM,CAAC,GAAG,sBAAsB,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;QACjC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,qFAAqF;IACrF,MAAM,CAAC,GAAG,sBAAsB,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QAChC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC1D,MAAM,CAAC,GAAG,sBAAsB,CAAC;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QAChC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,MAAM,gBAAgB,GAAoB;IACxC,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,KAAK;IACtB,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF,MAAM,kBAAkB,GAAoB;IAC1C,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,MAAM;IACvB,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,IAAI,CAAC,+EAA+E,EAAE,GAAG,EAAE;IACzF,MAAM,CAAC,GAAG,0BAA0B,CAAC;QACnC,SAAS,EAAE,kBAAkB;QAC7B,OAAO,EAAE,CAAC;QACV,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,KAAK;KAC3B,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY;IAC/C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;IAC/C,MAAM,CAAC,GAAG,0BAA0B,CAAC;QACnC,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,CAAC;QACV,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,oBAAoB;AACzD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;IAClF,MAAM,CAAC,GAAG,0BAA0B,CAAC;QACnC,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,CAAC;QACV,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,KAAK;KAC3B,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,MAAM,CAAC,KAAK,CAAC,SAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,SAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,SAAU,CAAC,OAAO,EAAE,uCAAuC,CAAC,CAAC;IAC1E,MAAM,CAAC,SAAS,CAAC,SAAU,CAAC,MAAM,EAAE;QAClC,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,CAAC;QAChB,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,CAAC,GAAG,0BAA0B,CAAC;QACnC,SAAS,EAAE,kBAAkB;QAC7B,OAAO,EAAE,CAAC;QACV,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,MAAM,CAAC,KAAK,CAAC,SAAU,CAAC,OAAO,EAAE,qDAAqD,CAAC,CAAC;IACxF,MAAM,CAAC,SAAS,CAAC,SAAU,CAAC,MAAM,EAAE;QAClC,UAAU,EAAE,CAAC;QACb,iBAAiB,EAAE,MAAM;KAC1B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,CAAC,GAAG,0BAA0B,CAAC;QACnC,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,CAAC;QACV,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,132 @@
+// Pure unit tests for src/core/cli/args.ts — no mocks (parseCli is pure).
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { parseCli, USAGE, DEFAULT_WORKFLOW_FILENAME, } from '../../src/core/cli/args.js';
+const CWD = '/home/op/project';
+/** Narrow to the ok branch (throws with the actual result on a non-ok directive). */
+function ok(r) {
+    assert.equal(r.kind, 'ok', `expected ok, got ${JSON.stringify(r)}`);
+    return r;
+}
+// ── default subcommand + default workflow path ───────────────────────────────
+test('no args → serve with default WORKFLOW.yaml resolved against injected cwd', () => {
+    const { cli } = ok(parseCli([], CWD));
+    assert.equal(cli.subcommand, 'serve');
+    assert.equal(cli.workflow, `${CWD}/${DEFAULT_WORKFLOW_FILENAME}`);
+    assert.equal(cli.port, null);
+    assert.equal(cli.reconcileForce, false);
+    assert.equal(cli.verbose, false);
+});
+test('default workflow join tolerates a trailing slash on cwd', () => {
+    const { cli } = ok(parseCli([], '/a/b/'));
+    assert.equal(cli.workflow, '/a/b/WORKFLOW.yaml');
+});
+test('empty cwd collapses the default workflow to a root-absolute path', () => {
+    const { cli } = ok(parseCli([], ''));
+    assert.equal(cli.workflow, '/WORKFLOW.yaml');
+});
+// ── positional workflow path ─────────────────────────────────────────────────
+test('positional path wins over the default and is taken verbatim', () => {
+    const { cli } = ok(parseCli(['/custom/Flow.md'], CWD));
+    assert.equal(cli.subcommand, 'serve');
+    assert.equal(cli.workflow, '/custom/Flow.md');
+});
+// ── subcommand detection ─────────────────────────────────────────────────────
+test('reconcile subcommand is detected and preserved', () => {
+    const { cli } = ok(parseCli(['reconcile'], CWD));
+    assert.equal(cli.subcommand, 'reconcile');
+    assert.equal(cli.workflow, `${CWD}/${DEFAULT_WORKFLOW_FILENAME}`);
+});
+test('doctor subcommand is detected and preserved', () => {
+    assert.equal(ok(parseCli(['doctor'], CWD)).cli.subcommand, 'doctor');
+});
+// ── --port (both shapes + validation) ────────────────────────────────────────
+test('--port PORT and -p PORT parse the value', () => {
+    assert.equal(ok(parseCli(['--port', '9000'], CWD)).cli.port, 9000);
+    assert.equal(ok(parseCli(['-p', '0'], CWD)).cli.port, 0);
+});
+test('--port=PORT inline shape parses the value', () => {
+    assert.equal(ok(parseCli(['--port=8181'], CWD)).cli.port, 8181);
+});
+test('--port without a value → error directive (exit 2, stderr message)', () => {
+    const r = parseCli(['--port'], CWD);
+    assert.equal(r.kind, 'error');
+    assert.equal(r.kind === 'error' && r.exitCode, 2);
+    assert.equal(r.kind === 'error' && r.message, 'error: --port requires a value\n');
+});
+test('--port with a non-numeric value → error (whole-arg shape uses the value)', () => {
+    const r = parseCli(['--port', 'abc'], CWD);
+    assert.equal(r.kind, 'error');
+    assert.equal(r.kind === 'error' && r.message, 'error: invalid --port value: abc\n');
+});
+test('--port with a negative value → error', () => {
+    const r = parseCli(['--port', '-5'], CWD);
+    // parseInt('-5') = -5, which is < 0.
+    assert.equal(r.kind, 'error');
+    assert.equal(r.kind === 'error' && r.message, 'error: invalid --port value: -5\n');
+});
+test('--port=BAD interpolates the WHOLE arg into the message (original behavior)', () => {
+    const r = parseCli(['--port=foo'], CWD);
+    assert.equal(r.kind, 'error');
+    assert.equal(r.kind === 'error' && r.message, 'error: invalid --port value: --port=foo\n');
+});
+// ── --force ──────────────────────────────────────────────────────────────────
+test('reconcile --force sets reconcileForce only under the reconcile subcommand', () => {
+    assert.equal(ok(parseCli(['reconcile', '--force'], CWD)).cli.reconcileForce, true);
+});
+test('bare --force under serve is not a force flag (taken as the positional workflow)', () => {
+    // Under serve, `--force` is not recognized and (since no positional taken yet)
+    // would be captured as the workflow path? No: the workflow slot is still open,
+    // so `--force` is taken as the positional workflow. Assert that faithfully.
+    const { cli } = ok(parseCli(['--force'], CWD));
+    assert.equal(cli.reconcileForce, false);
+    assert.equal(cli.workflow, '--force');
+});
+test('the retired top-level --reconcile-force alias no longer parses', () => {
+    // The alias was removed; `--reconcile-force` is now an unrecognized flag. With
+    // the workflow slot still open it is captured as the positional workflow path,
+    // and the force flag stays off — `symphony reconcile --force` is the only form.
+    const { cli } = ok(parseCli(['--reconcile-force'], CWD));
+    assert.equal(cli.subcommand, 'serve');
+    assert.equal(cli.reconcileForce, false);
+    assert.equal(cli.workflow, '--reconcile-force');
+});
+// ── --verbose / aliases ──────────────────────────────────────────────────────
+test('--verbose, -v, and --foreground all set verbose', () => {
+    assert.equal(ok(parseCli(['--verbose'], CWD)).cli.verbose, true);
+    assert.equal(ok(parseCli(['-v'], CWD)).cli.verbose, true);
+    assert.equal(ok(parseCli(['--foreground'], CWD)).cli.verbose, true);
+});
+// ── help ─────────────────────────────────────────────────────────────────────
+test('-h / --help → help directive carrying USAGE and exit 0', () => {
+    for (const flag of ['-h', '--help']) {
+        const r = parseCli([flag], CWD);
+        assert.equal(r.kind, 'help');
+        assert.equal(r.kind === 'help' && r.exitCode, 0);
+        assert.equal(r.kind === 'help' && r.message, USAGE);
+    }
+});
+// ── unexpected argument ──────────────────────────────────────────────────────
+test('a second positional → unexpected-argument error directive', () => {
+    const r = parseCli(['/a/Flow.md', '/b/Other.md'], CWD);
+    assert.equal(r.kind, 'error');
+    assert.equal(r.kind === 'error' && r.exitCode, 2);
+    assert.equal(r.kind === 'error' && r.message, 'error: unexpected argument: /b/Other.md\n');
+});
+// ── combined / ordering ──────────────────────────────────────────────────────
+test('reconcile with path, --force, and --port all combine', () => {
+    const { cli } = ok(parseCli(['reconcile', '/flow.md', '--force', '--port', '7777'], CWD));
+    assert.equal(cli.subcommand, 'reconcile');
+    assert.equal(cli.workflow, '/flow.md');
+    assert.equal(cli.reconcileForce, true);
+    assert.equal(cli.port, 7777);
+});
+test('parseCli is pure: same inputs → deeply-equal output, inputs not mutated', () => {
+    const argv = ['reconcile', '--force', '--port=8080', '/x.md'];
+    const before = [...argv];
+    const a = parseCli(argv, CWD);
+    const b = parseCli(argv, CWD);
+    assert.deepEqual(a, b);
+    assert.deepEqual(argv, before); // argv not mutated
+});
+//# sourceMappingURL=args.test.js.map

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

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

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

@@ -0,0 +1,62 @@
+// PURE unit test for src/core/credential/availability.ts — node:test + node:assert.
+// The functions under test are pure (data -> data), so no mocks are needed: we
+// pass file text + env maps directly and assert the classification + messages.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { KNOWN_ADAPTER_IDS, isKnownAdapter, hostClaudeCredentialPath, hostCodexCredentialPath, codexCredentialAvailable, codexMissingCredentialMessage, } from '../../src/core/credential/availability.js';
+const HOME = '/home/tester';
+const EMPTY_ENV = {};
+// ─── known-adapter registry ──────────────────────────────────────────────────
+test('KNOWN_ADAPTER_IDS is exactly the two adapters', () => {
+    assert.deepEqual([...KNOWN_ADAPTER_IDS], ['claude', 'codex']);
+});
+test('isKnownAdapter accepts known ids and rejects others', () => {
+    assert.equal(isKnownAdapter('claude'), true);
+    assert.equal(isKnownAdapter('codex'), true);
+    assert.equal(isKnownAdapter('opencode'), false);
+    assert.equal(isKnownAdapter('gemini'), false);
+    assert.equal(isKnownAdapter(''), false);
+    assert.equal(isKnownAdapter('Claude'), false); // case-sensitive
+});
+// ─── host credential paths ───────────────────────────────────────────────────
+test('hostClaudeCredentialPath / hostCodexCredentialPath join under home', () => {
+    assert.equal(hostClaudeCredentialPath(HOME), '/home/tester/.claude/.credentials.json');
+    assert.equal(hostCodexCredentialPath(HOME), '/home/tester/.codex/auth.json');
+});
+test('host credential path collapses a trailing-slash home dir', () => {
+    assert.equal(hostCodexCredentialPath('/home/tester/'), '/home/tester/.codex/auth.json');
+});
+// ─── codexCredentialAvailable ────────────────────────────────────────────────
+test('codexCredentialAvailable: OPENAI_API_KEY env alone is enough', () => {
+    assert.equal(codexCredentialAvailable(null, { OPENAI_API_KEY: 'sk-live' }), true);
+});
+test('codexCredentialAvailable: ChatGPT-OAuth tokens.access_token in file', () => {
+    const file = JSON.stringify({ tokens: { access_token: 'oauth-tok' } });
+    assert.equal(codexCredentialAvailable(file, EMPTY_ENV), true);
+});
+test('codexCredentialAvailable: top-level OPENAI_API_KEY in file', () => {
+    const file = JSON.stringify({ OPENAI_API_KEY: 'sk-in-file' });
+    assert.equal(codexCredentialAvailable(file, EMPTY_ENV), true);
+});
+test('codexCredentialAvailable: no file and no env => false', () => {
+    assert.equal(codexCredentialAvailable(null, EMPTY_ENV), false);
+});
+test('codexCredentialAvailable: malformed JSON, no env => false', () => {
+    assert.equal(codexCredentialAvailable('}{', EMPTY_ENV), false);
+});
+test('codexCredentialAvailable: file with empty access_token and no env => false', () => {
+    const file = JSON.stringify({ tokens: { access_token: '' } });
+    assert.equal(codexCredentialAvailable(file, EMPTY_ENV), false);
+});
+test('codexCredentialAvailable: tokens not an object => false', () => {
+    assert.equal(codexCredentialAvailable(JSON.stringify({ tokens: 'x' }), EMPTY_ENV), false);
+    assert.equal(codexCredentialAvailable(JSON.stringify([1, 2]), EMPTY_ENV), false);
+});
+// ─── missing-credential messages ─────────────────────────────────────────────
+test('codexMissingCredentialMessage names the codex path and both sources', () => {
+    const msg = codexMissingCredentialMessage(HOME);
+    assert.match(msg, /adapter "codex" requires a host credential/);
+    assert.match(msg, /\/home\/tester\/\.codex\/auth\.json/);
+    assert.match(msg, /OPENAI_API_KEY/);
+});
+//# sourceMappingURL=availability.test.js.map

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

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