abd21b2968
* feat(#1680): ADR-1239 Phase C-1 — hook-bus + stateIO seams [AC4] Phase 3 slice 4 (AC4, final #1680 slice). The last two adapter seams behind the negotiated hookBus/stateIO axes: - src/hook-bus.cts: createHookBus({bus}, {hostEmit?}) -> host/engine/none. engine = in-process pub/sub (handler errors isolated); host = host-owned, fail-closed emit until a host emitter is bound; none = silent no-op (degrade to rule-text). PORTABLE_EVENT_FLOOR = SessionStart/PreToolUse/PostToolUse/ Stop/SessionEnd (the claude dialect all hook hosts share). - src/state-io.cts: createStateIO({io}, {backend?}) -> filesystem (today's behavior — straight fs) / sandboxed-storage / session-log-append (fail-closed seams until a host backend is bound). Proactive CI gates: ADR-457 ignores + INVENTORY-MANIFEST entries for both new .cjs; injection-scan 'act as' substring audit; unused-import check. All clean locally (11 tests + security 15/15 + inventory + eslint 0 problems). Phase 3 (#1680) seam layer now complete. Concrete host binding -> Phase 5 (#1682, D15/D18). * chore(changeset): add Changed fragment for hook-bus + stateIO seams (#1680)
60 lines
2.3 KiB
JavaScript
60 lines
2.3 KiB
JavaScript
'use strict';
|
|
/**
|
|
* Tests for the state IO seam (ADR-1239 Phase C-1, AC4 / #1680).
|
|
* Pins: filesystem (today's behavior) + fail-closed non-filesystem seams +
|
|
* host-backend binding + construction gating.
|
|
*/
|
|
|
|
const { test } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('node:fs');
|
|
const path = require('node:path');
|
|
const { createStateIO } = require('../gsd-core/bin/lib/state-io.cjs');
|
|
const { createTempDir, cleanup } = require('./helpers.cjs');
|
|
|
|
test('filesystem stateIO: read/write delegate to fs (today behavior)', () => {
|
|
const io = createStateIO({ io: 'filesystem' });
|
|
assert.strictEqual(io.io, 'filesystem');
|
|
const dir = createTempDir();
|
|
try {
|
|
const file = path.join(dir, 'STATE.md');
|
|
io.write(file, '# State\n');
|
|
assert.strictEqual(io.read(file), '# State\n');
|
|
assert.strictEqual(fs.readFileSync(file, 'utf-8'), '# State\n', 'must write through to real fs');
|
|
} finally {
|
|
cleanup(dir);
|
|
}
|
|
});
|
|
|
|
test('sandboxed-storage stateIO: fail-closed until a host backend is bound', () => {
|
|
const io = createStateIO({ io: 'sandboxed-storage' });
|
|
assert.strictEqual(io.io, 'sandboxed-storage');
|
|
assert.throws(() => io.read('/x'), /no host backend bound/, 'read must fail closed when unbound');
|
|
assert.throws(() => io.write('/x', 'y'), /no host backend bound/, 'write must fail closed when unbound');
|
|
});
|
|
|
|
test('session-log-append stateIO: fail-closed until a host backend is bound', () => {
|
|
const io = createStateIO({ io: 'session-log-append' });
|
|
assert.throws(() => io.read('/x'), /no host backend bound/);
|
|
});
|
|
|
|
test('non-filesystem stateIO: host backend is used when bound', () => {
|
|
const calls = [];
|
|
const io = createStateIO(
|
|
{ io: 'sandboxed-storage' },
|
|
{ backend: {
|
|
read: (p) => { calls.push(['read', p]); return 'BACKEND:' + p; },
|
|
write: (p, c) => { calls.push(['write', p, c]); },
|
|
} },
|
|
);
|
|
assert.strictEqual(io.read('/state/log'), 'BACKEND:/state/log');
|
|
io.write('/state/log', 'entry');
|
|
assert.deepStrictEqual(calls, [['read', '/state/log'], ['write', '/state/log', 'entry']]);
|
|
});
|
|
|
|
test('createStateIO: invalid io throws (fail-closed construction)', () => {
|
|
for (const bad of ['memory', '', null, undefined, 2]) {
|
|
assert.throws(() => createStateIO({ io: bad }), TypeError, `io=${JSON.stringify(bad)} must throw`);
|
|
}
|
|
});
|