@animalabs/agent-framework 0.8.0 → 0.10.0

package/dist/test/checkpoint-attribution.test.js

@@ -1,5 +1,6 @@
 import { describe, it } from 'node:test';
 import assert from 'node:assert';
+import { AgentFramework } from '../src/framework.js';
 import { CheckpointManager } from '../src/mcpl/checkpoint-manager.js';
 // Minimal in-memory JsStore covering the slots CheckpointManager touches.
 function fakeStore() {
@@ -10,31 +11,190 @@ function fakeStore() {
         setStateJson(id, v) { m.set(id, v); },
     };
 }
+function tool(name, attribution) {
+    return {
+        name,
+        inputSchema: { type: 'object' },
+        ...(attribution?.direct ? { featureSet: attribution.direct } : {}),
+        ...(attribution?.meta ? { _meta: { featureSet: attribution.meta } } : {}),
+    };
+}
+function makeFrameworkHarness(tools, resultFor) {
+    const checkpointManager = new CheckpointManager(fakeStore(), () => { });
+    const calls = [];
+    const server = {
+        id: 'srv',
+        async sendToolsList() { return { tools }; },
+        async sendToolsCall(name, _args, stateParams) {
+            calls.push({ name, stateParams });
+            return resultFor(name);
+        },
+    };
+    const framework = Object.create(AgentFramework.prototype);
+    framework.mcplTools = [];
+    framework.mcplToolFeatureSets = new Map();
+    framework.mcplServerConfigs = new Map([['srv', { id: 'srv', toolPrefix: 'test' }]]);
+    framework.mcplServerRegistry = {
+        getAllServers: () => [server],
+        getServer: (id) => id === 'srv' ? server : null,
+    };
+    framework.checkpointManager = checkpointManager;
+    framework.channelRegistry = null;
+    framework.emitTrace = () => { };
+    async function callTool(name) {
+        await framework.refreshMcplTools();
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => reject(new Error(`Timed out waiting for ${name} result`)), 1000);
+            framework.pushEvent = (event) => {
+                if (event.type === 'tool-result' && event.callId === `call-${name}`) {
+                    clearTimeout(timeout);
+                    resolve();
+                }
+            };
+            framework.dispatchMcplToolCall('agent', { id: `call-${name}`, name: `test--${name}`, input: {} }, 'srv', 'test');
+        });
+    }
+    return { checkpointManager, calls, callTool };
+}
+function checkpoint(checkpoint, featureSet) {
+    return { checkpoint, parent: null, ...(featureSet ? { featureSet } : {}) };
+}
 describe('CheckpointManager host-managed attribution', () => {
-    it('threads the host-managed set even when a server-managed set registers first', () => {
+    it('threads the host-managed set even when server-managed sets register first', () => {
         const cm = new CheckpointManager(fakeStore(), () => { });
         const srv = 'xgate';
-        // Mirror x-mcpl's declaration order: x.post (rollback) BEFORE x.feed (host).
         cm.registerFeatureSet(srv, 'x.post', { hostState: false, rollback: true });
         cm.registerFeatureSet(srv, 'x.feed', { hostState: true, rollback: true });
         cm.registerFeatureSet(srv, 'x.dm', { hostState: false, rollback: true });
-        // The old blind "first stateful" pick returns x.post (the bug); the fix
-        // selects the host-managed set for state threading.
-        assert.equal(cm.getStatefulFeatureSet(srv), 'x.post');
+        assert.equal(cm.getStatefulFeatureSet(srv), null);
+        assert.equal(cm.hasAmbiguousServerManagedFeatureSets(srv), true);
+        assert.equal(cm.getStatefulFeatureSet(srv, 'x.post'), 'x.post');
         assert.equal(cm.getHostManagedFeatureSet(srv), 'x.feed');
-        // A tagged feed checkpoint lands on x.feed and is retrievable for injection.
         cm.recordCheckpoint(srv, 'x.feed', {
             checkpoint: '1', parent: null, featureSet: 'x.feed', data: { sources: ['alice'] },
         });
         assert.deepEqual(cm.getCurrentState(srv, 'x.feed'), { sources: ['alice'] });
-        // The server-managed set is not polluted by the feed's state.
         assert.equal(cm.getCurrentState(srv, 'x.post'), undefined);
     });
-    it('getHostManagedFeatureSet is null when the server has no host-managed set', () => {
+    it('keeps the unique server-managed fallback when there is no host-managed set', () => {
         const cm = new CheckpointManager(fakeStore(), () => { });
         cm.registerFeatureSet('s', 'x.post', { hostState: false, rollback: true });
         assert.equal(cm.getHostManagedFeatureSet('s'), null);
         assert.equal(cm.getStatefulFeatureSet('s'), 'x.post');
+        assert.equal(cm.hasAmbiguousServerManagedFeatureSets('s'), false);
+    });
+});
+describe('AgentFramework tool-call checkpoint attribution', () => {
+    it('uses direct tool featureSet metadata for injection and untagged recording', async () => {
+        const harness = makeFrameworkHarness([tool('post', { direct: 'x.post' })], () => ({ content: [], state: checkpoint('post-2') }));
+        harness.checkpointManager.registerFeatureSet('srv', 'x.post', { hostState: false, rollback: true });
+        harness.checkpointManager.registerFeatureSet('srv', 'x.dm', { hostState: false, rollback: true });
+        harness.checkpointManager.recordCheckpoint('srv', 'x.post', checkpoint('post-1'));
+        harness.checkpointManager.recordCheckpoint('srv', 'x.dm', checkpoint('dm-1'));
+        await harness.callTool('post');
+        assert.deepEqual(harness.calls[0]?.stateParams, { checkpoint: 'post-1' });
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.post'), 'post-2');
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.dm'), 'dm-1');
+    });
+    it('uses _meta.featureSet metadata the same way', async () => {
+        const harness = makeFrameworkHarness([tool('dm', { meta: 'x.dm' })], () => ({ content: [], state: checkpoint('dm-2') }));
+        harness.checkpointManager.registerFeatureSet('srv', 'x.post', { hostState: false, rollback: true });
+        harness.checkpointManager.registerFeatureSet('srv', 'x.dm', { hostState: false, rollback: true });
+        harness.checkpointManager.recordCheckpoint('srv', 'x.post', checkpoint('post-1'));
+        harness.checkpointManager.recordCheckpoint('srv', 'x.dm', checkpoint('dm-1'));
+        await harness.callTool('dm');
+        assert.deepEqual(harness.calls[0]?.stateParams, { checkpoint: 'dm-1' });
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.post'), 'post-1');
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.dm'), 'dm-2');
+    });
+    it('keeps explicit result.state.featureSet authoritative over tool metadata', async () => {
+        const harness = makeFrameworkHarness([tool('post', { direct: 'x.post' })], () => ({ content: [], state: checkpoint('dm-2', 'x.dm') }));
+        harness.checkpointManager.registerFeatureSet('srv', 'x.post', { hostState: false, rollback: true });
+        harness.checkpointManager.registerFeatureSet('srv', 'x.dm', { hostState: false, rollback: true });
+        harness.checkpointManager.recordCheckpoint('srv', 'x.post', checkpoint('post-1'));
+        harness.checkpointManager.recordCheckpoint('srv', 'x.dm', checkpoint('dm-1'));
+        await harness.callTool('post');
+        assert.deepEqual(harness.calls[0]?.stateParams, { checkpoint: 'post-1' });
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.post'), 'post-1');
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.dm'), 'dm-2');
+    });
+    it('does not fall back when explicit result attribution is not stateful', async () => {
+        const harness = makeFrameworkHarness([tool('post', { direct: 'x.post' })], () => ({ content: [], state: checkpoint('wrong-2', 'x.events') }));
+        harness.checkpointManager.registerFeatureSet('srv', 'x.post', { hostState: false, rollback: true });
+        harness.checkpointManager.recordCheckpoint('srv', 'x.post', checkpoint('post-1'));
+        await harness.callTool('post');
+        assert.deepEqual(harness.calls[0]?.stateParams, { checkpoint: 'post-1' });
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.post'), 'post-1');
+    });
+    it('records explicit result attribution even when an untagged tool is ambiguous', async () => {
+        const originalWarn = console.warn;
+        const warnings = [];
+        console.warn = (...args) => { warnings.push(args); };
+        try {
+            const harness = makeFrameworkHarness([tool('explicit')], () => ({ content: [], state: checkpoint('dm-2', 'x.dm') }));
+            harness.checkpointManager.registerFeatureSet('srv', 'x.post', { hostState: false, rollback: true });
+            harness.checkpointManager.registerFeatureSet('srv', 'x.dm', { hostState: false, rollback: true });
+            harness.checkpointManager.recordCheckpoint('srv', 'x.post', checkpoint('post-1'));
+            harness.checkpointManager.recordCheckpoint('srv', 'x.dm', checkpoint('dm-1'));
+            await harness.callTool('explicit');
+            assert.equal(harness.calls[0]?.stateParams, undefined);
+            assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.post'), 'post-1');
+            assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.dm'), 'dm-2');
+            assert.equal(warnings.length, 1);
+        }
+        finally {
+            console.warn = originalWarn;
+        }
+    });
+    it('retains injection and recording for an untagged tool with one stateful set', async () => {
+        const harness = makeFrameworkHarness([tool('single')], () => ({ content: [], state: checkpoint('only-2') }));
+        harness.checkpointManager.registerFeatureSet('srv', 'x.only', { hostState: false, rollback: true });
+        harness.checkpointManager.recordCheckpoint('srv', 'x.only', checkpoint('only-1'));
+        await harness.callTool('single');
+        assert.deepEqual(harness.calls[0]?.stateParams, { checkpoint: 'only-1' });
+        assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.only'), 'only-2');
+    });
+    it('warns and skips untagged state exchange when server-managed sets are ambiguous', async () => {
+        const originalWarn = console.warn;
+        const warnings = [];
+        console.warn = (...args) => { warnings.push(args); };
+        try {
+            const harness = makeFrameworkHarness([tool('ambiguous')], () => ({ content: [], state: checkpoint('wrong-2') }));
+            harness.checkpointManager.registerFeatureSet('srv', 'x.post', { hostState: false, rollback: true });
+            harness.checkpointManager.registerFeatureSet('srv', 'x.dm', { hostState: false, rollback: true });
+            harness.checkpointManager.recordCheckpoint('srv', 'x.post', checkpoint('post-1'));
+            harness.checkpointManager.recordCheckpoint('srv', 'x.dm', checkpoint('dm-1'));
+            await harness.callTool('ambiguous');
+            assert.equal(harness.calls[0]?.stateParams, undefined);
+            assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.post'), 'post-1');
+            assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.dm'), 'dm-1');
+            assert.equal(warnings.length, 1);
+            assert.match(String(warnings[0]?.[0]), /multiple server-managed/);
+        }
+        finally {
+            console.warn = originalWarn;
+        }
+    });
+    it('warns and skips state exchange for unknown or non-stateful tool tags', async () => {
+        const originalWarn = console.warn;
+        const warnings = [];
+        console.warn = (...args) => { warnings.push(args); };
+        try {
+            const harness = makeFrameworkHarness([tool('unknown', { direct: 'x.missing' }), tool('stateless', { meta: 'x.events' })], () => ({ content: [], state: checkpoint('wrong-2') }));
+            harness.checkpointManager.registerFeatureSet('srv', 'x.post', { hostState: false, rollback: true });
+            harness.checkpointManager.recordCheckpoint('srv', 'x.post', checkpoint('post-1'));
+            await harness.callTool('unknown');
+            await harness.callTool('stateless');
+            assert.equal(harness.calls[0]?.stateParams, undefined);
+            assert.equal(harness.calls[1]?.stateParams, undefined);
+            assert.equal(harness.checkpointManager.getCurrentCheckpoint('srv', 'x.post'), 'post-1');
+            assert.equal(warnings.length, 2);
+            assert.match(String(warnings[0]?.[0]), /unknown or non-stateful/);
+            assert.match(String(warnings[1]?.[0]), /unknown or non-stateful/);
+        }
+        finally {
+            console.warn = originalWarn;
+        }
     });
 });
 //# sourceMappingURL=checkpoint-attribution.test.js.map

package/dist/test/checkpoint-attribution.test.js.map

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

package/dist/test/conversation-fork-injection-scoping.test.js

@@ -49,9 +49,11 @@ function installChannelRegistry(framework, channelIds = ['chanA', 'chanB']) {
         homeChannelResolver: (agentName) => internals.conversationAgentHomes.get(agentName),
     });
     for (const channelId of channelIds) {
-        // An incoming lifecycle message is authoritative evidence that the
-        // transport is actually open. ensureChannelRegistered alone deliberately
-        // keeps one-shot/direct-address channels closed.
+        // §14.5: register first (a conforming server's channels/register),
+        // then the incoming message marks the registered channel open.
+        registry.channels.set(`srv:${channelId}`, {
+            serverId: 'srv', descriptor: { id: channelId, type: 'srv', label: channelId }, open: false,
+        });
         registry.handleIncoming('srv', {
             messages: [{
                     channelId,
@@ -70,6 +72,9 @@ function bindForkHome(framework, agentName = FORK_AGENT, channelId = 'chanA') {
 function installHookInjections(framework, injections) {
     frameworkInternals(framework).hookOrchestrator = {
         beforeInference: async () => injections,
+        // §10.5: driveStream emits started/terminal lifecycle notifications
+        // through the orchestrator on every turn now.
+        emitLifecycle: () => { },
     };
 }
 function triggerEvent() {

package/dist/test/conversation-fork-injection-scoping.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-fork-injection-scoping.test.js","sourceRoot":"","sources":["../../test/conversation-fork-injection-scoping.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation-fork-injection-scoping.test.js","sourceRoot":"","sources":["../../test/conversation-fork-injection-scoping.test.ts"],"names":[],"mappings":"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"}

package/dist/test/event-gate-passthrough.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * af#105 — intuitive wake-gate composition.
+ *
+ * Covers the four pieces that grew out of the 2026-08-08 Mythos
+ * stand-back-density incident (a prepended catch-all passive_sample silently
+ * made the DM/mention wake rules unreachable for the whole incoming lane):
+ *
+ *   ① `passthrough` observer rules — non-firing counting behaviors fall
+ *     through to later policies instead of consuming the event;
+ *   ② shadow lint — provably-dead rules are reported at config time;
+ *   ③ dry-run probes — side-effect-free "who would win" evaluation;
+ *   ④ anchored positions — addPolicy({before}/{after}) placement.
+ */
+export {};
+//# sourceMappingURL=event-gate-passthrough.test.d.ts.map

package/dist/test/event-gate-passthrough.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-gate-passthrough.test.d.ts","sourceRoot":"","sources":["../../test/event-gate-passthrough.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/test/event-gate-passthrough.test.js

@@ -0,0 +1,289 @@
+/**
+ * af#105 — intuitive wake-gate composition.
+ *
+ * Covers the four pieces that grew out of the 2026-08-08 Mythos
+ * stand-back-density incident (a prepended catch-all passive_sample silently
+ * made the DM/mention wake rules unreachable for the whole incoming lane):
+ *
+ *   ① `passthrough` observer rules — non-firing counting behaviors fall
+ *     through to later policies instead of consuming the event;
+ *   ② shadow lint — provably-dead rules are reported at config time;
+ *   ③ dry-run probes — side-effect-free "who would win" evaluation;
+ *   ④ anchored positions — addPolicy({before}/{after}) placement.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { existsSync, mkdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { EventGate, findShadowedPolicies, formatShadowWarning } from '../src/gate/event-gate.js';
+const TMP_DIR = join(import.meta.dirname, '../.test-tmp-gate-passthrough');
+function makeGate(initialConfig) {
+    mkdirSync(TMP_DIR, { recursive: true });
+    const configPath = join(TMP_DIR, `gate-${Math.random().toString(36).slice(2)}.json`);
+    const traces = [];
+    const gate = new EventGate({
+        configPath,
+        initialConfig,
+        emitTrace: (e) => traces.push(e),
+        addMessage: () => '',
+        requestInference: () => { },
+        getAgentNames: () => ['agent'],
+        now: () => 1_000_000,
+    });
+    return { gate, configPath, traces };
+}
+function event(overrides) {
+    return {
+        content: 'test',
+        eventType: 'mcpl:channel-incoming',
+        serverId: 'discord',
+        channelId: 'discord:dm:1',
+        metadata: {},
+        ...overrides,
+    };
+}
+/** The Mythos incident's policy shapes, reusable across cases. */
+const SAMPLER = {
+    name: 'stand-back-density',
+    match: { scope: ['mcpl:channel-incoming'] },
+    behavior: { passive_sample: { every: 3 } },
+};
+const DIRECT_ADDRESS = {
+    name: 'discord-direct-address',
+    match: { scope: ['mcpl:push-event', 'mcpl:channel-incoming'], metadataTrue: ['isMention', 'isDM'] },
+    behavior: 'always',
+};
+const AMBIENT = {
+    name: 'discord-ambient',
+    match: { scope: ['mcpl:push-event', 'mcpl:channel-incoming'] },
+    behavior: 'skip',
+};
+beforeEach(() => {
+    mkdirSync(TMP_DIR, { recursive: true });
+});
+afterEach(() => {
+    if (existsSync(TMP_DIR)) {
+        rmSync(TMP_DIR, { recursive: true, force: true });
+    }
+});
+// ---------------------------------------------------------------------------
+// ① passthrough
+// ---------------------------------------------------------------------------
+describe('passthrough observer rules', () => {
+    it('non-firing passthrough sampler falls through to a later always rule (the incident, fixed)', () => {
+        const { gate } = makeGate({
+            policies: [
+                { ...SAMPLER, passthrough: true },
+                DIRECT_ADDRESS,
+                AMBIENT,
+            ],
+            default: 'skip',
+        });
+        // A DM: with the consuming sampler this was swallowed 149/150 times.
+        // With passthrough it must reach discord-direct-address every time the
+        // sampler doesn't fire.
+        const d1 = gate.evaluate(event({ metadata: { isDM: true } }));
+        assert.strictEqual(d1.trigger, true);
+        assert.strictEqual(d1.policyName, 'discord-direct-address');
+        assert.deepStrictEqual(d1.observed, ['stand-back-density']);
+    });
+    it('passthrough sampler still fires every Nth match, and consumes on fire', () => {
+        const { gate } = makeGate({
+            policies: [{ ...SAMPLER, passthrough: true }, AMBIENT],
+            default: 'skip',
+        });
+        // every:3 — two ambient events fall through to the ambient skip, the
+        // third fires the sampler itself.
+        const d1 = gate.evaluate(event());
+        const d2 = gate.evaluate(event());
+        const d3 = gate.evaluate(event());
+        assert.strictEqual(d1.trigger, false);
+        assert.strictEqual(d1.policyName, 'discord-ambient');
+        assert.strictEqual(d2.policyName, 'discord-ambient');
+        assert.strictEqual(d3.trigger, true);
+        assert.strictEqual(d3.policyName, 'stand-back-density');
+        assert.strictEqual(d3.observed, undefined);
+    });
+    it('counts every matching event even when a later rule wakes anyway', () => {
+        const { gate } = makeGate({
+            policies: [{ ...SAMPLER, passthrough: true }, DIRECT_ADDRESS, AMBIENT],
+            default: 'skip',
+        });
+        // Two DMs (wake via direct-address, sampler counts both), then one
+        // ambient event: sampler is at 2, the ambient event is its 3rd → fires.
+        gate.evaluate(event({ metadata: { isDM: true } }));
+        gate.evaluate(event({ metadata: { isDM: true } }));
+        const d3 = gate.evaluate(event());
+        assert.strictEqual(d3.trigger, true);
+        assert.strictEqual(d3.policyName, 'stand-back-density');
+    });
+    it('falls through to the gate default when nothing later matches', () => {
+        const { gate } = makeGate({
+            policies: [{ ...SAMPLER, passthrough: true }],
+            default: 'skip',
+        });
+        const d = gate.evaluate(event());
+        assert.strictEqual(d.trigger, false);
+        assert.strictEqual(d.policyName, null);
+        assert.deepStrictEqual(d.observed, ['stand-back-density']);
+        // The fall-to-default is counted in default decision stats.
+        assert.strictEqual(gate.getStatus().defaultDecisions.skipped, 1);
+    });
+    it('rejects passthrough on non-counting behaviors', () => {
+        for (const behavior of ['always', 'skip', { debounce: 1000 }]) {
+            const { gate } = makeGate({
+                policies: [{ name: 'p', match: {}, behavior, passthrough: true }],
+            });
+            const errors = gate.getStatus().errors;
+            assert.ok(errors.some((e) => /passthrough is only valid/.test(e)), `expected passthrough validation error for ${JSON.stringify(behavior)}, got: ${JSON.stringify(errors)}`);
+        }
+    });
+    it('accepts passthrough on rate_limit and falls through when the bucket is empty', () => {
+        const { gate } = makeGate({
+            policies: [
+                {
+                    name: 'burst-governor',
+                    match: {},
+                    behavior: { rate_limit: { tokens: 1, refillIntervalMs: 60_000 } },
+                    passthrough: true,
+                },
+                { name: 'catch-all', match: {}, behavior: 'skip' },
+            ],
+            default: 'always',
+        });
+        const d1 = gate.evaluate(event());
+        assert.strictEqual(d1.trigger, true); // token available → fires
+        const d2 = gate.evaluate(event());
+        assert.strictEqual(d2.trigger, false); // bucket empty → falls through
+        assert.strictEqual(d2.policyName, 'catch-all');
+        assert.deepStrictEqual(d2.observed, ['burst-governor']);
+    });
+});
+// ---------------------------------------------------------------------------
+// ② shadow lint
+// ---------------------------------------------------------------------------
+describe('shadow lint', () => {
+    it('flags the incident shape: prepended scope catch-all shadows direct-address for the overlapped scope', () => {
+        const warnings = findShadowedPolicies([SAMPLER, DIRECT_ADDRESS, AMBIENT]);
+        const hit = warnings.find((w) => w.later === 'discord-direct-address');
+        assert.ok(hit, `expected direct-address shadow warning, got ${JSON.stringify(warnings)}`);
+        assert.strictEqual(hit.earlier, 'stand-back-density');
+        assert.deepStrictEqual(hit.eventTypes, ['mcpl:channel-incoming']);
+        assert.match(formatShadowWarning(hit), /unreachable for mcpl:channel-incoming/);
+    });
+    it('a passthrough observer shadows nothing', () => {
+        const warnings = findShadowedPolicies([
+            { ...SAMPLER, passthrough: true },
+            DIRECT_ADDRESS,
+            AMBIENT,
+        ]);
+        assert.ok(!warnings.some((w) => w.earlier === 'stand-back-density'));
+    });
+    it('does not flag rules the earlier one cannot fully cover', () => {
+        // direct-address has a metadataTrue discriminator ambient lacks: events
+        // with no truthy flags slip past it, so ambient stays reachable.
+        const warnings = findShadowedPolicies([DIRECT_ADDRESS, AMBIENT]);
+        assert.deepStrictEqual(warnings, []);
+    });
+    it('subset metadataTrue IS flagged (earlier OR-list covers later)', () => {
+        const warnings = findShadowedPolicies([
+            { name: 'broad', match: { metadataTrue: ['isMention', 'isDM'] }, behavior: 'skip' },
+            { name: 'narrow', match: { metadataTrue: ['isDM'] }, behavior: 'always' },
+        ]);
+        assert.strictEqual(warnings.length, 1);
+        assert.strictEqual(warnings[0].later, 'narrow');
+        assert.strictEqual(warnings[0].eventTypes, 'all');
+    });
+    it('surfaces via gate:shadow-warnings trace and getStatus on mutation', () => {
+        const { gate, traces } = makeGate({ policies: [DIRECT_ADDRESS, AMBIENT], default: 'skip' });
+        assert.deepStrictEqual(gate.getStatus().shadowWarnings, []);
+        gate.addPolicy(SAMPLER, { position: 'prepend' });
+        const status = gate.getStatus();
+        assert.ok(status.shadowWarnings.some((w) => /discord-direct-address/.test(w)), `expected shadow warning in status, got ${JSON.stringify(status.shadowWarnings)}`);
+        assert.ok(traces.some((t) => t.type === 'gate:shadow-warnings'));
+    });
+});
+// ---------------------------------------------------------------------------
+// ③ dry-run probes
+// ---------------------------------------------------------------------------
+describe('dry-run probes', () => {
+    it('probe reports the winner without advancing counters', () => {
+        const { gate } = makeGate({ policies: [SAMPLER, DIRECT_ADDRESS], default: 'skip' });
+        // Probe the same DM three times — a MUTATING evaluate would fire the
+        // every:3 sampler on the third call; probes must not.
+        for (let i = 0; i < 3; i++) {
+            const p = gate.probe(event({ metadata: { isDM: true } }));
+            assert.strictEqual(p.policyName, 'stand-back-density');
+            assert.strictEqual(p.trigger, false);
+        }
+        // Real evaluation still starts from a cold counter.
+        const d = gate.evaluate(event({ metadata: { isDM: true } }));
+        assert.strictEqual(d.trigger, false);
+    });
+    it('probe honors passthrough fall-through', () => {
+        const { gate } = makeGate({
+            policies: [{ ...SAMPLER, passthrough: true }, DIRECT_ADDRESS],
+            default: 'skip',
+        });
+        const p = gate.probe(event({ metadata: { isDM: true } }));
+        assert.strictEqual(p.policyName, 'discord-direct-address');
+        assert.strictEqual(p.trigger, true);
+    });
+    it('probeTable makes the incident visible as a changed dm row', () => {
+        const { gate } = makeGate({ policies: [DIRECT_ADDRESS, AMBIENT], default: 'skip' });
+        const before = gate.probeTable();
+        const dmBefore = before.find((r) => r.probe === 'dm (open channel)');
+        assert.ok(dmBefore);
+        assert.strictEqual(dmBefore.policy, 'discord-direct-address');
+        assert.strictEqual(dmBefore.wouldWake, true);
+        gate.addPolicy(SAMPLER, { position: 'prepend' });
+        const after = gate.probeTable();
+        const dmAfter = after.find((r) => r.probe === 'dm (open channel)');
+        assert.ok(dmAfter);
+        assert.strictEqual(dmAfter.policy, 'stand-back-density');
+        assert.strictEqual(dmAfter.wouldWake, false);
+        // The closed-channel (push/event) dm row is untouched — exactly the
+        // asymmetry that made the incident look intermittent.
+        const dmPush = after.find((r) => r.probe === 'dm (closed channel)');
+        assert.ok(dmPush);
+        assert.strictEqual(dmPush.policy, 'discord-direct-address');
+        assert.strictEqual(dmPush.wouldWake, true);
+    });
+});
+// ---------------------------------------------------------------------------
+// ④ anchored positions
+// ---------------------------------------------------------------------------
+describe('anchored positions', () => {
+    it('inserts before/after a named anchor', () => {
+        const { gate } = makeGate({ policies: [DIRECT_ADDRESS, AMBIENT], default: 'skip' });
+        gate.addPolicy(SAMPLER, { position: { before: 'discord-ambient' } });
+        assert.deepStrictEqual(gate.listPolicyNames(), [
+            'discord-direct-address', 'stand-back-density', 'discord-ambient',
+        ]);
+        gate.addPolicy({ name: 'after-anchor', match: {}, behavior: 'skip' }, { position: { after: 'discord-direct-address' } });
+        assert.deepStrictEqual(gate.listPolicyNames(), [
+            'discord-direct-address', 'after-anchor', 'stand-back-density', 'discord-ambient',
+        ]);
+    });
+    it('throws on a missing anchor, naming the available rules', () => {
+        const { gate } = makeGate({ policies: [AMBIENT], default: 'skip' });
+        assert.throws(() => gate.addPolicy(SAMPLER, { position: { before: 'no-such-rule' } }), /no policy named "no-such-rule".*discord-ambient/s);
+    });
+    it('replacement without a position stays in place; with a position it moves', () => {
+        const { gate } = makeGate({
+            policies: [SAMPLER, DIRECT_ADDRESS, AMBIENT],
+            default: 'skip',
+        });
+        // In-place update keeps the (bad) prepended slot.
+        gate.addPolicy({ ...SAMPLER, behavior: { passive_sample: { every: 5 } } });
+        assert.deepStrictEqual(gate.listPolicyNames(), [
+            'stand-back-density', 'discord-direct-address', 'discord-ambient',
+        ]);
+        // Re-issuing WITH an anchor is the repair path for the incident.
+        gate.addPolicy(SAMPLER, { position: { before: 'discord-ambient' } });
+        assert.deepStrictEqual(gate.listPolicyNames(), [
+            'discord-direct-address', 'stand-back-density', 'discord-ambient',
+        ]);
+    });
+});
+//# sourceMappingURL=event-gate-passthrough.test.js.map