@a1hvdy/cc-openclaw 0.3.2

package/dist/tests/register-guard-stacking.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createRegisterGuard, defaultRegisterGuard } from '../src/lib/register-guard.js';
+describe('register-guard 1,000-cycle stacking proof', () => {
+    it('PRP NFR: same api repeated 1,000 times → exactly 1 body invocation', () => {
+        const guard = createRegisterGuard();
+        const body = vi.fn();
+        const api = { on: vi.fn() };
+        for (let i = 0; i < 1000; i++) {
+            guard.guard('test/module', api, body);
+        }
+        expect(body).toHaveBeenCalledTimes(1);
+    });
+    it('1,000 alternating new-api cycles → exactly 1 body invocation (id-only tracking, prevents listener stacking across plugin contexts)', () => {
+        // Production reality (observed 2026-04-29): the openclaw gateway calls
+        // register() multiple times per process — once per plugin context
+        // (gateway thread, per-agent thread). Each context passes a different
+        // `api` instance, but every api wraps the SAME shared event bus.
+        // Re-firing on new api would stack listeners N× → duplicate emissions
+        // (the doubled-greeting bug). We track by id only.
+        const guard = createRegisterGuard();
+        const body = vi.fn();
+        for (let i = 0; i < 1000; i++) {
+            const freshApi = { on: vi.fn() };
+            guard.guard('test/module', freshApi, body);
+        }
+        expect(body).toHaveBeenCalledTimes(1);
+    });
+    it('1,000 cycles: api.on() never accumulates listeners on same api', () => {
+        const guard = createRegisterGuard();
+        const api = { on: vi.fn() };
+        for (let i = 0; i < 1000; i++) {
+            guard.guard('test/module', api, () => {
+                api.on('event', () => { });
+            });
+        }
+        // Body ran once → exactly 1 api.on() call total
+        expect(api.on).toHaveBeenCalledTimes(1);
+    });
+    it('multi-id 1,000-cycle test: 5 module ids × 200 cycles each = 5 unique body calls per module', () => {
+        const guard = createRegisterGuard();
+        const bodies = Array.from({ length: 5 }, () => vi.fn());
+        const api = { on: vi.fn() };
+        for (let cycle = 0; cycle < 200; cycle++) {
+            for (let i = 0; i < 5; i++) {
+                guard.guard(`module/${i}`, api, bodies[i]);
+            }
+        }
+        bodies.forEach((b) => expect(b).toHaveBeenCalledTimes(1));
+    });
+    it('defaultRegisterGuard singleton: 1,000 cycles same id+api → 1 body call', () => {
+        defaultRegisterGuard._resetForTests();
+        const body = vi.fn();
+        const api = { on: vi.fn() };
+        for (let i = 0; i < 1000; i++) {
+            defaultRegisterGuard.guard('singleton-test', api, body);
+        }
+        expect(body).toHaveBeenCalledTimes(1);
+        defaultRegisterGuard._resetForTests();
+    });
+});
+//# sourceMappingURL=register-guard-stacking.test.js.map

package/dist/tests/register-guard-stacking.test.js.map

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

package/dist/tests/register-guard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register-guard.test.d.ts.map

package/dist/tests/register-guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-guard.test.d.ts","sourceRoot":"","sources":["../../tests/register-guard.test.ts"],"names":[],"mappings":""}

package/dist/tests/register-guard.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { createRegisterGuard, defaultRegisterGuard } from '../src/lib/register-guard.js';
+describe('createRegisterGuard()', () => {
+    it('runs body on first call with given (id, api)', () => {
+        const guard = createRegisterGuard();
+        const body = vi.fn();
+        guard.guard('test-id', { on: vi.fn() }, body);
+        expect(body).toHaveBeenCalledOnce();
+    });
+    it('skips body on second call with same (id, api)', () => {
+        const guard = createRegisterGuard();
+        const body = vi.fn();
+        const api = { on: vi.fn() };
+        guard.guard('test-id', api, body);
+        guard.guard('test-id', api, body);
+        expect(body).toHaveBeenCalledOnce();
+    });
+    it('skips body when api changes for same id (id-only tracking — production-correct, prevents listener stacking across plugin contexts)', () => {
+        const guard = createRegisterGuard();
+        const body = vi.fn();
+        guard.guard('test-id', { on: vi.fn() }, body);
+        guard.guard('test-id', { on: vi.fn() }, body);
+        expect(body).toHaveBeenCalledTimes(1);
+    });
+    it('isolates registration state by id', () => {
+        const guard = createRegisterGuard();
+        const body = vi.fn();
+        const api = { on: vi.fn() };
+        guard.guard('id-a', api, body);
+        guard.guard('id-b', api, body);
+        expect(body).toHaveBeenCalledTimes(2);
+    });
+    it('isRegistered() reports state per id', () => {
+        const guard = createRegisterGuard();
+        expect(guard.isRegistered('x')).toBe(false);
+        guard.guard('x', { on: vi.fn() }, () => { });
+        expect(guard.isRegistered('x')).toBe(true);
+    });
+    it('_resetForTests() clears all state', () => {
+        const guard = createRegisterGuard();
+        guard.guard('x', { on: vi.fn() }, () => { });
+        guard._resetForTests();
+        expect(guard.isRegistered('x')).toBe(false);
+    });
+    it('1,000-cycle stacking test — register-guard fires body exactly once', () => {
+        const guard = createRegisterGuard();
+        const body = vi.fn();
+        const api = { on: vi.fn() };
+        for (let i = 0; i < 1000; i++) {
+            guard.guard('stress', api, body);
+        }
+        expect(body).toHaveBeenCalledOnce();
+    });
+    describe('OPENCLAW_REGISTER_DEBUG=1 telemetry emit', () => {
+        const origDebug = process.env.OPENCLAW_REGISTER_DEBUG;
+        beforeEach(() => {
+            process.env.OPENCLAW_REGISTER_DEBUG = '1';
+        });
+        afterEach(() => {
+            if (origDebug === undefined)
+                delete process.env.OPENCLAW_REGISTER_DEBUG;
+            else
+                process.env.OPENCLAW_REGISTER_DEBUG = origDebug;
+        });
+        it('emits register-guard.fire event to stderr on first registration', () => {
+            const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+            const guard = createRegisterGuard();
+            guard.guard('debug-fire', { on: vi.fn() }, () => { });
+            expect(stderrSpy).toHaveBeenCalledOnce();
+            const written = stderrSpy.mock.calls[0][0];
+            const payload = JSON.parse(written.trim());
+            expect(payload.type).toBe('register-guard.fire');
+            expect(payload.id).toBe('debug-fire');
+            expect(payload.ts).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+            stderrSpy.mockRestore();
+        });
+        it('emits register-guard.skip event to stderr on duplicate same-api call', () => {
+            const guard = createRegisterGuard();
+            const api = { on: vi.fn() };
+            // First call — registers (fire event)
+            guard.guard('debug-skip', api, () => { });
+            const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+            // Second call with same api — should emit skip
+            guard.guard('debug-skip', api, () => { });
+            expect(stderrSpy).toHaveBeenCalledOnce();
+            const written = stderrSpy.mock.calls[0][0];
+            const payload = JSON.parse(written.trim());
+            expect(payload.type).toBe('register-guard.skip');
+            expect(payload.id).toBe('debug-skip');
+            expect(payload.reason).toBe('already-registered');
+            stderrSpy.mockRestore();
+        });
+        it('emits register-guard.skip on re-registration with new api (id-only tracking)', () => {
+            const guard = createRegisterGuard();
+            // First registration — consumes the first fire event
+            guard.guard('debug-refire', { on: vi.fn() }, () => { });
+            const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+            // Second registration with NEW api — should skip (id-only semantics)
+            guard.guard('debug-refire', { on: vi.fn() }, () => { });
+            expect(stderrSpy).toHaveBeenCalledOnce();
+            const written = stderrSpy.mock.calls[0][0];
+            const payload = JSON.parse(written.trim());
+            expect(payload.type).toBe('register-guard.skip');
+            expect(payload.id).toBe('debug-refire');
+            expect(payload.reason).toBe('already-registered');
+            stderrSpy.mockRestore();
+        });
+        it('does NOT emit to stderr when OPENCLAW_REGISTER_DEBUG is unset', () => {
+            delete process.env.OPENCLAW_REGISTER_DEBUG;
+            const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+            const guard = createRegisterGuard();
+            const api = { on: vi.fn() };
+            guard.guard('no-debug', api, () => { });
+            guard.guard('no-debug', api, () => { }); // skip path
+            expect(stderrSpy).not.toHaveBeenCalled();
+            stderrSpy.mockRestore();
+        });
+    });
+});
+describe('defaultRegisterGuard singleton', () => {
+    beforeEach(() => { defaultRegisterGuard._resetForTests(); });
+    it('exists and is usable', () => {
+        expect(defaultRegisterGuard).toBeDefined();
+        const body = vi.fn();
+        defaultRegisterGuard.guard('singleton-test', {}, body);
+        expect(body).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=register-guard.test.js.map

package/dist/tests/register-guard.test.js.map

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

package/dist/tests/route-flag-rollback.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=route-flag-rollback.test.d.ts.map

package/dist/tests/route-flag-rollback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-flag-rollback.test.d.ts","sourceRoot":"","sources":["../../tests/route-flag-rollback.test.ts"],"names":[],"mappings":""}

package/dist/tests/route-flag-rollback.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { selectEngine, captureSessionRoute, ROUTE_FLAG_ENV, } from '../src/lib/route-flag.js';
+describe('route-flag mid-session rollback (PRP backward-compat #4)', () => {
+    const original = process.env[ROUTE_FLAG_ENV];
+    beforeEach(() => { delete process.env[ROUTE_FLAG_ENV]; });
+    afterEach(() => { process.env[ROUTE_FLAG_ENV] = original; });
+    it('observes env AT CALL TIME (no caching) — flip mid-loop reflects immediately', () => {
+        const observations = [];
+        process.env[ROUTE_FLAG_ENV] = '1';
+        observations.push(selectEngine());
+        delete process.env[ROUTE_FLAG_ENV];
+        observations.push(selectEngine());
+        process.env[ROUTE_FLAG_ENV] = '1';
+        observations.push(selectEngine());
+        expect(observations).toEqual(['cc-openclaw', 'claude-local', 'cc-openclaw']);
+    });
+    it('captureSessionRoute pins engine at start; later env flips do NOT change snapshot', () => {
+        process.env[ROUTE_FLAG_ENV] = '1';
+        const route = captureSessionRoute();
+        expect(route.engine).toBe('cc-openclaw');
+        // Simulate operator flipping the env mid-session
+        delete process.env[ROUTE_FLAG_ENV];
+        expect(route.engine).toBe('cc-openclaw'); // captured value preserved
+        expect(selectEngine()).toBe('claude-local'); // but new sessions see new value
+    });
+    it('100 alternating flips: env oscillation is correctly observed', () => {
+        const results = [];
+        for (let i = 0; i < 100; i++) {
+            if (i % 2 === 0)
+                process.env[ROUTE_FLAG_ENV] = '1';
+            else
+                delete process.env[ROUTE_FLAG_ENV];
+            results.push(selectEngine());
+        }
+        const unique = [...new Set(results)];
+        expect(unique).toEqual(expect.arrayContaining(['cc-openclaw', 'claude-local']));
+        expect(results[0]).toBe('cc-openclaw');
+        expect(results[1]).toBe('claude-local');
+    });
+    it('rollback scenario: 5 sessions captured under cc-openclaw, then flag flipped — all 5 still report cc-openclaw', () => {
+        process.env[ROUTE_FLAG_ENV] = '1';
+        const sessions = Array.from({ length: 5 }, () => captureSessionRoute());
+        delete process.env[ROUTE_FLAG_ENV];
+        for (const s of sessions) {
+            expect(s.engine).toBe('cc-openclaw');
+        }
+        expect(selectEngine()).toBe('claude-local');
+    });
+    it('rollback scenario: P0/P1 incident — flip env=0, new sessions instantly route to claude-local', () => {
+        // Simulate P0 incident response per PRP "Rollback Procedure":
+        // 1. Within session boundary: set OPENCLAW_USE_CC_OPENCLAW=0; new sessions route to claude-local. No restart needed.
+        process.env[ROUTE_FLAG_ENV] = '1';
+        const before = selectEngine();
+        expect(before).toBe('cc-openclaw');
+        // Operator response — flip env
+        process.env[ROUTE_FLAG_ENV] = '0';
+        const after = selectEngine();
+        expect(after).toBe('claude-local');
+        // Rollback verified: instant within-session-boundary (next selectEngine() call)
+    });
+    it('captureSessionRoute snapshots are independent — concurrent sessions see their own pinned engine', () => {
+        process.env[ROUTE_FLAG_ENV] = '1';
+        const sessionA = captureSessionRoute();
+        delete process.env[ROUTE_FLAG_ENV];
+        const sessionB = captureSessionRoute();
+        expect(sessionA.engine).toBe('cc-openclaw');
+        expect(sessionB.engine).toBe('claude-local');
+    });
+});
+//# sourceMappingURL=route-flag-rollback.test.js.map

package/dist/tests/route-flag-rollback.test.js.map

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

package/dist/tests/route-flag.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=route-flag.test.d.ts.map

package/dist/tests/route-flag.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-flag.test.d.ts","sourceRoot":"","sources":["../../tests/route-flag.test.ts"],"names":[],"mappings":""}

package/dist/tests/route-flag.test.js

@@ -0,0 +1,101 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { selectEngine, isCcOpenclawEnabled, captureSessionRoute, ACTIVE_FLAG_ENV, ROUTE_FLAG_ENV, } from '../src/lib/route-flag.js';
+describe('route-flag basic semantics', () => {
+    const original = process.env[ROUTE_FLAG_ENV];
+    const originalActive = process.env[ACTIVE_FLAG_ENV];
+    beforeEach(() => {
+        delete process.env[ROUTE_FLAG_ENV];
+        delete process.env[ACTIVE_FLAG_ENV];
+    });
+    afterEach(() => {
+        process.env[ROUTE_FLAG_ENV] = original;
+        process.env[ACTIVE_FLAG_ENV] = originalActive;
+    });
+    it("default 'claude-local' when env unset", () => {
+        expect(selectEngine()).toBe('claude-local');
+    });
+    it("'cc-openclaw' when env='1'", () => {
+        process.env[ROUTE_FLAG_ENV] = '1';
+        expect(selectEngine()).toBe('cc-openclaw');
+    });
+    it("'cc-openclaw' when env='true' (case-insensitive)", () => {
+        process.env[ROUTE_FLAG_ENV] = 'TRUE';
+        expect(selectEngine()).toBe('cc-openclaw');
+    });
+    it("'cc-openclaw' when env='on' (case-insensitive)", () => {
+        process.env[ROUTE_FLAG_ENV] = 'ON';
+        expect(selectEngine()).toBe('cc-openclaw');
+    });
+    it("'claude-local' when env='0'", () => {
+        process.env[ROUTE_FLAG_ENV] = '0';
+        expect(selectEngine()).toBe('claude-local');
+    });
+    it("'claude-local' for any non-truthy value", () => {
+        for (const v of ['', 'no', 'off', 'false', 'random']) {
+            process.env[ROUTE_FLAG_ENV] = v;
+            expect(selectEngine()).toBe('claude-local');
+        }
+    });
+    it('isCcOpenclawEnabled() matches selectEngine logic', () => {
+        expect(isCcOpenclawEnabled()).toBe(false);
+        process.env[ROUTE_FLAG_ENV] = '1';
+        expect(isCcOpenclawEnabled()).toBe(true);
+    });
+    it('captureSessionRoute returns frozen snapshot', () => {
+        const route = captureSessionRoute();
+        expect(Object.isFrozen(route)).toBe(true);
+        expect(route.engine).toBe('claude-local');
+        expect(route.capturedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+});
+describe('route-flag B3 — ACTIVE_FLAG_ENV (new) + ROUTE_FLAG_ENV (deprecated alias)', () => {
+    const original = process.env[ROUTE_FLAG_ENV];
+    const originalActive = process.env[ACTIVE_FLAG_ENV];
+    beforeEach(() => {
+        delete process.env[ROUTE_FLAG_ENV];
+        delete process.env[ACTIVE_FLAG_ENV];
+    });
+    afterEach(() => {
+        process.env[ROUTE_FLAG_ENV] = original;
+        process.env[ACTIVE_FLAG_ENV] = originalActive;
+    });
+    it('exports ACTIVE_FLAG_ENV with the v3 §10 contract name', () => {
+        expect(ACTIVE_FLAG_ENV).toBe('OPENCLAW_CC_OPENCLAW_ACTIVE');
+    });
+    it('exports ROUTE_FLAG_ENV unchanged (deprecated alias)', () => {
+        expect(ROUTE_FLAG_ENV).toBe('OPENCLAW_USE_CC_OPENCLAW');
+    });
+    it("'cc-openclaw' when only ACTIVE_FLAG_ENV is set", () => {
+        process.env[ACTIVE_FLAG_ENV] = '1';
+        expect(selectEngine()).toBe('cc-openclaw');
+        expect(isCcOpenclawEnabled()).toBe(true);
+    });
+    it("'cc-openclaw' when only deprecated ROUTE_FLAG_ENV is set (alias still honored)", () => {
+        process.env[ROUTE_FLAG_ENV] = '1';
+        expect(selectEngine()).toBe('cc-openclaw');
+        expect(isCcOpenclawEnabled()).toBe(true);
+    });
+    it("ACTIVE_FLAG_ENV takes precedence — new=0 wins over deprecated=1", () => {
+        process.env[ACTIVE_FLAG_ENV] = '0';
+        process.env[ROUTE_FLAG_ENV] = '1';
+        expect(selectEngine()).toBe('claude-local');
+        expect(isCcOpenclawEnabled()).toBe(false);
+    });
+    it("ACTIVE_FLAG_ENV takes precedence — new=1 wins over deprecated=0", () => {
+        process.env[ACTIVE_FLAG_ENV] = '1';
+        process.env[ROUTE_FLAG_ENV] = '0';
+        expect(selectEngine()).toBe('cc-openclaw');
+        expect(isCcOpenclawEnabled()).toBe(true);
+    });
+    it("falls through to deprecated alias only when ACTIVE_FLAG_ENV is undefined (not empty)", () => {
+        process.env[ACTIVE_FLAG_ENV] = '';
+        process.env[ROUTE_FLAG_ENV] = '1';
+        // Empty string → falsy → returns false; does NOT fall through
+        expect(selectEngine()).toBe('claude-local');
+    });
+    it('default claude-local when both are unset', () => {
+        expect(selectEngine()).toBe('claude-local');
+        expect(isCcOpenclawEnabled()).toBe(false);
+    });
+});
+//# sourceMappingURL=route-flag.test.js.map

package/dist/tests/route-flag.test.js.map

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

package/dist/tests/session-bootstrap.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-bootstrap.test.d.ts.map

package/dist/tests/session-bootstrap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bootstrap.test.d.ts","sourceRoot":"","sources":["../../tests/session-bootstrap.test.ts"],"names":[],"mappings":""}

package/dist/tests/session-bootstrap.test.js

@@ -0,0 +1,183 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { registerCwdPatch, registerSyspromptStrip, registerThinkConflictResolver, stripSysprompt } from '../src/session-bootstrap/index.js';
+import { defaultRegisterGuard } from '../src/lib/register-guard.js';
+import { register as registerSyspromptStripDirect } from '../src/session-bootstrap/sysprompt-strip.js';
+describe('session-bootstrap registers', () => {
+    it('cwd-patch registers service without throwing', () => {
+        const on = vi.fn();
+        const registerService = vi.fn();
+        expect(() => registerCwdPatch({ on, registerService })).not.toThrow();
+        // cwd-patch wires prototype patches (not api.on() hooks) + registers a lifecycle service
+        expect(registerService).toHaveBeenCalledWith(expect.objectContaining({ id: 'claude-local-enhancer' }));
+    });
+    it('sysprompt-strip is callable (env-gated wiring)', () => {
+        const on = vi.fn();
+        expect(() => registerSyspromptStrip({ on })).not.toThrow();
+        expect(on).toHaveBeenCalledWith('before_prompt_build', expect.any(Function));
+    });
+    it('think-conflict-resolver wires handlers', () => {
+        const on = vi.fn();
+        registerThinkConflictResolver({ on });
+        expect(on).toHaveBeenCalled();
+        // Expects: before_dispatch (think) + before_prompt_build (think) +
+        //          before_dispatch (CoS) + before_prompt_build (CoS) = 4 hooks
+        expect(on).toHaveBeenCalledTimes(4);
+    });
+});
+describe('stripSysprompt (pure function)', () => {
+    it('returns unchanged when nothing to strip', () => {
+        const result = stripSysprompt('hello world');
+        expect(result.content).toBe('hello world');
+        expect(result.changed).toBe(false);
+        expect(result.aggressiveStripped).toBe(false);
+    });
+    it('strips SELF_IMPROVEMENT_REMINDER filename marker', () => {
+        const input = 'before\n## SELF_IMPROVEMENT_REMINDER.md\nafter';
+        const result = stripSysprompt(input);
+        expect(result.content).not.toContain('SELF_IMPROVEMENT_REMINDER.md');
+        expect(result.changed).toBe(true);
+    });
+    it('strips Self-Improvement Reminder block', () => {
+        const input = 'before\n## Self-Improvement Reminder\nsome content\n## Next Section\nafter';
+        const result = stripSysprompt(input);
+        expect(result.content).not.toContain('Self-Improvement Reminder');
+        expect(result.content).toContain('## Next Section');
+        expect(result.changed).toBe(true);
+    });
+    it('strips <location> lines from skills catalog', () => {
+        const input = 'catalog\n  <location>/home/user/.openclaw/skills/foo/SKILL.md</location>\nend';
+        const result = stripSysprompt(input);
+        expect(result.content).not.toContain('<location>');
+        expect(result.changed).toBe(true);
+    });
+    it('aggressive: strips Tool escalation block (forceEnabled)', () => {
+        const input = 'before\n**Tool escalation:**\n1. do this\n2. do that\n**Scope selection rule:**\nafter';
+        const result = stripSysprompt(input, { forceEnabled: true });
+        expect(result.content).not.toContain('Tool escalation');
+        expect(result.aggressiveStripped).toBe(true);
+    });
+    it('aggressive: does not strip when no match (forceEnabled)', () => {
+        const result = stripSysprompt('clean content', { forceEnabled: true });
+        expect(result.aggressiveStripped).toBe(false);
+        expect(result.changed).toBe(false);
+    });
+});
+describe('idempotency guards', () => {
+    it('cwd-patch is idempotent on same api', () => {
+        const on = vi.fn();
+        const registerService = vi.fn();
+        const api = { on, registerService };
+        // First call already registered above in previous test (different api object),
+        // so use a fresh module state by passing a new api object.
+        // The guard checks same api reference — calling with the same object twice logs warn.
+        registerCwdPatch(api);
+        const callsAfterFirst = on.mock.calls.length;
+        registerCwdPatch(api);
+        // No additional on() calls after the second register (idempotency guard fired)
+        expect(on.mock.calls.length).toBe(callsAfterFirst);
+    });
+    it('sysprompt-strip is idempotent on same api', () => {
+        const on = vi.fn();
+        const api = { on };
+        registerSyspromptStrip(api);
+        const callsAfterFirst = on.mock.calls.length;
+        registerSyspromptStrip(api);
+        expect(on.mock.calls.length).toBe(callsAfterFirst);
+    });
+    it('think-conflict-resolver is idempotent on same api', () => {
+        const on = vi.fn();
+        const api = { on };
+        registerThinkConflictResolver(api);
+        const callsAfterFirst = on.mock.calls.length;
+        registerThinkConflictResolver(api);
+        expect(on.mock.calls.length).toBe(callsAfterFirst);
+    });
+});
+// ── sysprompt-strip register() direct coverage ────────────────────────────
+describe('session-bootstrap/sysprompt-strip register() hook behaviour', () => {
+    beforeEach(() => {
+        defaultRegisterGuard._resetForTests();
+    });
+    afterEach(() => {
+        defaultRegisterGuard._resetForTests();
+    });
+    it('register() wires before_prompt_build hook', () => {
+        const on = vi.fn();
+        const api = { on, logger: console };
+        registerSyspromptStripDirect(api);
+        expect(on).toHaveBeenCalledWith('before_prompt_build', expect.any(Function));
+    });
+    it('before_prompt_build handler returns undefined when event is undefined', () => {
+        const on = vi.fn();
+        registerSyspromptStripDirect({ on });
+        const handler = on.mock.calls.find(([e]) => e === 'before_prompt_build')[1];
+        expect(handler(undefined)).toBeUndefined();
+    });
+    it('before_prompt_build handler returns undefined when event has no systemPrompt', () => {
+        const on = vi.fn();
+        registerSyspromptStripDirect({ on });
+        const handler = on.mock.calls.find(([e]) => e === 'before_prompt_build')[1];
+        expect(handler({})).toBeUndefined();
+    });
+    it('before_prompt_build handler returns undefined when systemPrompt is empty string', () => {
+        const on = vi.fn();
+        registerSyspromptStripDirect({ on });
+        const handler = on.mock.calls.find(([e]) => e === 'before_prompt_build')[1];
+        expect(handler({ systemPrompt: '' })).toBeUndefined();
+    });
+    it('before_prompt_build handler strips systemPrompt when content matches', () => {
+        const on = vi.fn();
+        const logger = { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn(), log: vi.fn() };
+        registerSyspromptStripDirect({ on, logger });
+        const handler = on.mock.calls.find(([e]) => e === 'before_prompt_build')[1];
+        const event = { systemPrompt: 'before\n## SELF_IMPROVEMENT_REMINDER.md\nafter' };
+        const result = handler(event);
+        expect(result).toBeUndefined(); // always returns undefined
+        expect(event.systemPrompt).not.toContain('SELF_IMPROVEMENT_REMINDER.md');
+    });
+    it('before_prompt_build handler leaves unchanged systemPrompt alone', () => {
+        const on = vi.fn();
+        registerSyspromptStripDirect({ on });
+        const handler = on.mock.calls.find(([e]) => e === 'before_prompt_build')[1];
+        const event = { systemPrompt: 'clean system prompt content' };
+        const originalPrompt = event.systemPrompt;
+        handler(event);
+        expect(event.systemPrompt).toBe(originalPrompt);
+    });
+    it('register() is idempotent — second call with same api is a no-op', () => {
+        const on = vi.fn();
+        const api = { on };
+        registerSyspromptStripDirect(api);
+        const callsAfterFirst = on.mock.calls.length;
+        registerSyspromptStripDirect(api);
+        expect(on.mock.calls.length).toBe(callsAfterFirst);
+    });
+    it('register() with OPENCLAW_AGGRESSIVE_STRIP=0 still wires the hook', () => {
+        const origEnv = process.env.OPENCLAW_AGGRESSIVE_STRIP;
+        process.env.OPENCLAW_AGGRESSIVE_STRIP = '0';
+        const on = vi.fn();
+        const logger = { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn(), log: vi.fn() };
+        registerSyspromptStripDirect({ on, logger });
+        // Hook is still registered even when strip is disabled
+        expect(on).toHaveBeenCalledWith('before_prompt_build', expect.any(Function));
+        // logger.info called with opt-out message
+        expect(logger.info).toHaveBeenCalledWith(expect.stringContaining('opt-out'));
+        if (origEnv === undefined)
+            delete process.env.OPENCLAW_AGGRESSIVE_STRIP;
+        else
+            process.env.OPENCLAW_AGGRESSIVE_STRIP = origEnv;
+    });
+    it('register() with OPENCLAW_AGGRESSIVE_STRIP=1 logs active message', () => {
+        const origEnv = process.env.OPENCLAW_AGGRESSIVE_STRIP;
+        process.env.OPENCLAW_AGGRESSIVE_STRIP = '1';
+        const on = vi.fn();
+        const logger = { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn(), log: vi.fn() };
+        registerSyspromptStripDirect({ on, logger });
+        expect(logger.info).toHaveBeenCalledWith(expect.stringContaining('aggressive strip active'));
+        if (origEnv === undefined)
+            delete process.env.OPENCLAW_AGGRESSIVE_STRIP;
+        else
+            process.env.OPENCLAW_AGGRESSIVE_STRIP = origEnv;
+    });
+});
+//# sourceMappingURL=session-bootstrap.test.js.map