@jstn-sdk/rcs 0.1.0

package/dist/hooks/__tests__/codebase-map.test.js

@@ -0,0 +1,218 @@
+/**
+ * Tests for Codebase Map Generator
+ *
+ * Covers: empty project, git-tracked files, directory grouping,
+ * src/ sub-directory expansion, size cap, and error resilience.
+ */
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm, mkdir, readFile, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { execSync } from 'child_process';
+import { generateCodebaseMap } from '../codebase-map.js';
+async function makeTempGitRepo() {
+    const dir = await mkdtemp(join(tmpdir(), 'rcs-codebase-map-test-'));
+    execSync('git init', { cwd: dir, stdio: 'ignore' });
+    execSync('git config user.email "test@test.com"', { cwd: dir, stdio: 'ignore' });
+    execSync('git config user.name "Test"', { cwd: dir, stdio: 'ignore' });
+    return dir;
+}
+async function gitAdd(dir, ...files) {
+    execSync(`git add ${files.join(' ')}`, { cwd: dir, stdio: 'ignore' });
+}
+describe('generateCodebaseMap', () => {
+    let tempDir;
+    before(async () => { tempDir = await makeTempGitRepo(); });
+    after(async () => { await rm(tempDir, { recursive: true, force: true }); });
+    it('returns empty string when no tracked source files exist', async () => {
+        const map = await generateCodebaseMap(tempDir);
+        assert.strictEqual(map, '');
+    });
+    it('returns empty string for non-git directory', async () => {
+        const plainDir = await mkdtemp(join(tmpdir(), 'rcs-plain-'));
+        try {
+            await writeFile(join(plainDir, 'foo.ts'), 'export function foo() {}');
+            const map = await generateCodebaseMap(plainDir);
+            // git ls-files won't track it - result is empty
+            assert.strictEqual(map, '');
+        }
+        finally {
+            await rm(plainDir, { recursive: true, force: true });
+        }
+    });
+    it('lists tracked TypeScript files grouped by directory', async () => {
+        await mkdir(join(tempDir, 'src', 'hooks'), { recursive: true });
+        await writeFile(join(tempDir, 'src', 'hooks', 'session.ts'), 'export function startSession() {}');
+        await writeFile(join(tempDir, 'src', 'hooks', 'overlay.ts'), 'export function applyOverlay() {}');
+        await gitAdd(tempDir, 'src/hooks/session.ts', 'src/hooks/overlay.ts');
+        const map = await generateCodebaseMap(tempDir);
+        assert.ok(map.length > 0, 'map should not be empty');
+        assert.ok(map.includes('src/hooks'), 'should include src/hooks directory');
+        assert.ok(map.includes('session'), 'should include session module name');
+        assert.ok(map.includes('overlay'), 'should include overlay module name');
+    });
+    it('expands src/ into sub-directories', async () => {
+        await mkdir(join(tempDir, 'src', 'cli'), { recursive: true });
+        await mkdir(join(tempDir, 'src', 'mcp'), { recursive: true });
+        await writeFile(join(tempDir, 'src', 'cli', 'index.ts'), 'export function main() {}');
+        await writeFile(join(tempDir, 'src', 'mcp', 'state-server.ts'), 'export function serve() {}');
+        await gitAdd(tempDir, 'src/cli/index.ts', 'src/mcp/state-server.ts');
+        const map = await generateCodebaseMap(tempDir);
+        assert.ok(map.includes('src/cli'), 'should expand src into sub-dirs');
+        assert.ok(map.includes('src/mcp'), 'should include mcp sub-dir');
+        assert.ok(map.includes('state-server'), 'should include state-server');
+    });
+    it('includes non-src top-level directories', async () => {
+        await mkdir(join(tempDir, 'scripts'), { recursive: true });
+        await writeFile(join(tempDir, 'scripts', 'notify-hook.js'), 'export function notify() {}');
+        await gitAdd(tempDir, 'scripts/notify-hook.js');
+        const map = await generateCodebaseMap(tempDir);
+        assert.ok(map.includes('scripts'), 'should include scripts directory');
+        assert.ok(map.includes('notify-hook'), 'should include notify-hook');
+    });
+    it('caps output at MAX_MAP_CHARS (1000)', async () => {
+        // Add many files to trigger truncation
+        await mkdir(join(tempDir, 'src', 'generated'), { recursive: true });
+        const filePaths = [];
+        for (let i = 0; i < 30; i++) {
+            const name = `module-with-a-very-long-name-to-force-truncation-${i}.ts`;
+            const path = join(tempDir, 'src', 'generated', name);
+            await writeFile(path, `export function fn${i}() {}`);
+            filePaths.push(`src/generated/${name}`);
+        }
+        await gitAdd(tempDir, ...filePaths);
+        const map = await generateCodebaseMap(tempDir);
+        assert.ok(map.length <= 1000, `map length ${map.length} should be <= 1000`);
+    });
+    it('omits index.ts basename when it is the only file', async () => {
+        await mkdir(join(tempDir, 'src', 'utils'), { recursive: true });
+        await writeFile(join(tempDir, 'src', 'utils', 'index.ts'), 'export function helper() {}');
+        await gitAdd(tempDir, 'src/utils/index.ts');
+        const map = await generateCodebaseMap(tempDir);
+        // index alone should still produce output (kept when sole file)
+        assert.ok(map.includes('src/utils'), 'should include src/utils dir');
+    });
+    it('does not include untracked files (security: no filename leakage)', async () => {
+        const secDir = await mkdtemp(join(tmpdir(), 'rcs-untracked-test-'));
+        try {
+            execSync('git init', { cwd: secDir, stdio: 'ignore' });
+            execSync('git config user.email "test@test.com"', { cwd: secDir, stdio: 'ignore' });
+            execSync('git config user.name "Test"', { cwd: secDir, stdio: 'ignore' });
+            await mkdir(join(secDir, 'src'), { recursive: true });
+            // This file is tracked
+            await writeFile(join(secDir, 'src', 'tracked.ts'), 'export function tracked() {}');
+            execSync('git add src/tracked.ts', { cwd: secDir, stdio: 'ignore' });
+            // This file is untracked (never git-added)
+            await writeFile(join(secDir, 'src', 'secret-wip.ts'), 'export function secretWork() {}');
+            const map = await generateCodebaseMap(secDir);
+            assert.ok(map.includes('tracked'), 'should include tracked file');
+            assert.ok(!map.includes('secret-wip'), 'must not expose untracked filename');
+        }
+        finally {
+            await rm(secDir, { recursive: true, force: true });
+        }
+    });
+    it('uses a durable cache for unchanged git index state', async () => {
+        const cacheDir = await mkdtemp(join(tmpdir(), 'rcs-codebase-cache-'));
+        try {
+            execSync('git init', { cwd: cacheDir, stdio: 'ignore' });
+            execSync('git config user.email "test@test.com"', { cwd: cacheDir, stdio: 'ignore' });
+            execSync('git config user.name "Test"', { cwd: cacheDir, stdio: 'ignore' });
+            await mkdir(join(cacheDir, 'src'), { recursive: true });
+            await writeFile(join(cacheDir, 'src', 'tracked.ts'), 'export function tracked() {}');
+            execSync('git add src/tracked.ts', { cwd: cacheDir, stdio: 'ignore' });
+            const map = await generateCodebaseMap(cacheDir);
+            assert.ok(map.includes('tracked'));
+            const cachePath = join(cacheDir, '.rcs', 'cache', 'codebase-map.json');
+            const cache = JSON.parse(await readFile(cachePath, 'utf-8'));
+            cache.map = '  src/: cached-only';
+            await writeFile(cachePath, JSON.stringify(cache, null, 2));
+            assert.equal(await generateCodebaseMap(cacheDir), '  src/: cached-only');
+        }
+        finally {
+            await rm(cacheDir, { recursive: true, force: true });
+        }
+    });
+    it('invalidates stale and corrupt durable cache entries safely', async () => {
+        const cacheDir = await mkdtemp(join(tmpdir(), 'rcs-codebase-cache-stale-'));
+        try {
+            execSync('git init', { cwd: cacheDir, stdio: 'ignore' });
+            execSync('git config user.email "test@test.com"', { cwd: cacheDir, stdio: 'ignore' });
+            execSync('git config user.name "Test"', { cwd: cacheDir, stdio: 'ignore' });
+            await mkdir(join(cacheDir, 'src'), { recursive: true });
+            await writeFile(join(cacheDir, 'src', 'first.ts'), 'export function first() {}');
+            execSync('git add src/first.ts', { cwd: cacheDir, stdio: 'ignore' });
+            assert.ok((await generateCodebaseMap(cacheDir)).includes('first'));
+            const cachePath = join(cacheDir, '.rcs', 'cache', 'codebase-map.json');
+            await writeFile(cachePath, '{not-json');
+            assert.ok((await generateCodebaseMap(cacheDir)).includes('first'), 'corrupt cache should regenerate');
+            await writeFile(join(cacheDir, 'src', 'second.ts'), 'export function second() {}');
+            execSync('git add src/second.ts', { cwd: cacheDir, stdio: 'ignore' });
+            const updated = await generateCodebaseMap(cacheDir);
+            assert.ok(updated.includes('first'));
+            assert.ok(updated.includes('second'), 'index change should invalidate stale cache');
+            assert.ok(!updated.includes('secret-wip'), 'cache regeneration must not leak untracked names');
+        }
+        finally {
+            await rm(cacheDir, { recursive: true, force: true });
+        }
+    });
+    it('caches empty tracked-source results without exposing .rcs paths', async () => {
+        const emptyDir = await mkdtemp(join(tmpdir(), 'rcs-codebase-empty-cache-'));
+        try {
+            execSync('git init', { cwd: emptyDir, stdio: 'ignore' });
+            await writeFile(join(emptyDir, 'README.md'), '# empty source set\n');
+            execSync('git add README.md', { cwd: emptyDir, stdio: 'ignore' });
+            await mkdir(join(emptyDir, '.rcs', 'cache'), { recursive: true });
+            await writeFile(join(emptyDir, '.rcs', 'cache', 'secret.ts'), 'export const secret = true;');
+            assert.equal(await generateCodebaseMap(emptyDir), '');
+            const cache = JSON.parse(await readFile(join(emptyDir, '.rcs', 'cache', 'codebase-map.json'), 'utf-8'));
+            assert.equal(cache.map, '');
+            assert.doesNotMatch(JSON.stringify(cache), /secret\.ts/);
+        }
+        finally {
+            await rm(emptyDir, { recursive: true, force: true });
+        }
+    });
+    it('does not throw on unreadable directory (graceful failure)', async () => {
+        const map = await generateCodebaseMap('/nonexistent/path/xyz');
+        assert.strictEqual(map, '');
+    });
+});
+describe('generateCodebaseMap integration with generateOverlay', () => {
+    let tempDir;
+    before(async () => {
+        tempDir = await makeTempGitRepo();
+        await mkdir(join(tempDir, '.rcs', 'state'), { recursive: true });
+        // Add a source file so the map is non-empty
+        await mkdir(join(tempDir, 'src', 'hooks'), { recursive: true });
+        await writeFile(join(tempDir, 'src', 'hooks', 'my-module.ts'), 'export function myFn() {}');
+        execSync('git add src/hooks/my-module.ts', { cwd: tempDir, stdio: 'ignore' });
+    });
+    after(async () => { await rm(tempDir, { recursive: true, force: true }); });
+    it('injects codebase map section into overlay', async () => {
+        const { generateOverlay } = await import('../agents-overlay.js');
+        const overlay = await generateOverlay(tempDir, 'test-map-session');
+        assert.ok(overlay.includes('Codebase Map'), 'overlay should contain Codebase Map section');
+        assert.ok(overlay.includes('src/hooks'), 'overlay should include src/hooks from map');
+        assert.ok(overlay.includes('my-module'), 'overlay should include module name');
+    });
+    it('overlay is still valid when project has no tracked files', async () => {
+        const emptyDir = await mkdtemp(join(tmpdir(), 'rcs-empty-git-'));
+        try {
+            execSync('git init', { cwd: emptyDir, stdio: 'ignore' });
+            await mkdir(join(emptyDir, '.rcs', 'state'), { recursive: true });
+            const { generateOverlay } = await import('../agents-overlay.js');
+            const overlay = await generateOverlay(emptyDir, 'empty-session');
+            assert.ok(overlay.includes('<!-- RCS:RUNTIME:START -->'));
+            assert.ok(overlay.includes('<!-- RCS:RUNTIME:END -->'));
+            // No codebase map section when no files
+            assert.ok(!overlay.includes('Codebase Map'), 'should not inject empty map');
+        }
+        finally {
+            await rm(emptyDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=codebase-map.test.js.map

package/dist/hooks/__tests__/codebase-map.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-map.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/codebase-map.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,KAAK,UAAU,eAAe;IAC5B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,GAAG,KAAe;IACnD,QAAQ,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAI,OAAe,CAAC;IACpB,MAAM,CAAC,KAAK,IAAI,EAAE,GAAG,OAAO,GAAG,MAAM,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,0BAA0B,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAChD,gDAAgD;YAChD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,mCAAmC,CAAC,CAAC;QAClG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,mCAAmC,CAAC,CAAC;QAClG,MAAM,MAAM,CAAC,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,CAAC,CAAC;QAEtE,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,oCAAoC,CAAC,CAAC;QAC3E,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,oCAAoC,CAAC,CAAC;QACzE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,oCAAoC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,2BAA2B,CAAC,CAAC;QACtF,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,CAAC,EAAE,4BAA4B,CAAC,CAAC;QAC9F,MAAM,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,CAAC,CAAC;QAErE,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,iCAAiC,CAAC,CAAC;QACtE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACjE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAC3F,MAAM,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;QAEhD,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,kCAAkC,CAAC,CAAC;QACvE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,4BAA4B,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,uCAAuC;QACvC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,oDAAoD,CAAC,KAAK,CAAC;YACxE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;YACrD,MAAM,SAAS,CAAC,IAAI,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACrD,SAAS,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;QAEpC,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,cAAc,GAAG,CAAC,MAAM,oBAAoB,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAC1F,MAAM,MAAM,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAE5C,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC/C,gEAAgE;QAChE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,8BAA8B,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,QAAQ,CAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpF,QAAQ,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtD,uBAAuB;YACvB,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,8BAA8B,CAAC,CAAC;YACnF,QAAQ,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAErE,2CAA2C;YAC3C,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,iCAAiC,CAAC,CAAC;YAEzF,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,6BAA6B,CAAC,CAAC;YAClE,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,oCAAoC,CAAC,CAAC;QAC/E,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,QAAQ,CAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtF,QAAQ,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5E,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,8BAA8B,CAAC,CAAC;YACrF,QAAQ,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAEvE,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YAC7D,KAAK,CAAC,GAAG,GAAG,qBAAqB,CAAC;YAClC,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE3D,MAAM,CAAC,KAAK,CAAC,MAAM,mBAAmB,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAC3E,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC;YACH,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,QAAQ,CAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtF,QAAQ,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5E,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,4BAA4B,CAAC,CAAC;YACjF,QAAQ,CAAC,sBAAsB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAErE,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACnE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;YACvE,MAAM,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACxC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,iCAAiC,CAAC,CAAC;YAEtG,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,6BAA6B,CAAC,CAAC;YACnF,QAAQ,CAAC,uBAAuB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YACpD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,4CAA4C,CAAC,CAAC;YACpF,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,kDAAkD,CAAC,CAAC;QACjG,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC;YACH,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,sBAAsB,CAAC,CAAC;YACrE,QAAQ,CAAC,mBAAmB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,6BAA6B,CAAC,CAAC;YAE7F,MAAM,CAAC,KAAK,CAAC,MAAM,mBAAmB,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACxG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;QAC3D,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;QAC/D,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sDAAsD,EAAE,GAAG,EAAE;IACpE,IAAI,OAAe,CAAC;IACpB,MAAM,CAAC,KAAK,IAAI,EAAE;QAChB,OAAO,GAAG,MAAM,eAAe,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,4CAA4C;QAC5C,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,2BAA2B,CAAC,CAAC;QAC5F,QAAQ,CAAC,gCAAgC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,6CAA6C,CAAC,CAAC;QAC3F,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,2CAA2C,CAAC,CAAC;QACtF,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,oCAAoC,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;YACjE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,CAAC;YAC1D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC;YACxD,wCAAwC;YACxC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAC9E,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hooks/__tests__/consensus-execution-handoff.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Consensus mode execution handoff regression tests
+ *
+ * Verifies that the plan skill's consensus mode (ralplan) mandates:
+ * 1. Structured question UI for approval (not plain text)
+ * 2. Explicit $ralph invocation on approval
+ * 3. Prohibition of direct implementation from the planning agent
+ * 4. User feedback step after Planner but before Architect/Critic
+ * 5. RALPLAN-DR short mode and deliberate mode requirements
+ *
+ * Also verifies non-consensus modes (interview, direct, review) are unaffected,
+ * and that architect/critic prompts contain required RALPLAN-DR sections.
+ *
+ * Note: This file loads SKILL.md and prompt content directly via fs.readFileSync()
+ * instead of getBuiltinSkill() (which does not exist in RCS).
+ */
+export {};
+//# sourceMappingURL=consensus-execution-handoff.test.d.ts.map

package/dist/hooks/__tests__/consensus-execution-handoff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consensus-execution-handoff.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/consensus-execution-handoff.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/hooks/__tests__/consensus-execution-handoff.test.js

@@ -0,0 +1,234 @@
+/**
+ * Consensus mode execution handoff regression tests
+ *
+ * Verifies that the plan skill's consensus mode (ralplan) mandates:
+ * 1. Structured question UI for approval (not plain text)
+ * 2. Explicit $ralph invocation on approval
+ * 3. Prohibition of direct implementation from the planning agent
+ * 4. User feedback step after Planner but before Architect/Critic
+ * 5. RALPLAN-DR short mode and deliberate mode requirements
+ *
+ * Also verifies non-consensus modes (interview, direct, review) are unaffected,
+ * and that architect/critic prompts contain required RALPLAN-DR sections.
+ *
+ * Note: This file loads SKILL.md and prompt content directly via fs.readFileSync()
+ * instead of getBuiltinSkill() (which does not exist in RCS).
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const planSkill = readFileSync(join(__dirname, '../../../skills/plan/SKILL.md'), 'utf-8');
+const ralplanSkill = readFileSync(join(__dirname, '../../../skills/ralplan/SKILL.md'), 'utf-8');
+const plannerPrompt = readFileSync(join(__dirname, '../../../prompts/planner.md'), 'utf-8');
+const architectPrompt = readFileSync(join(__dirname, '../../../prompts/architect.md'), 'utf-8');
+const criticPrompt = readFileSync(join(__dirname, '../../../prompts/critic.md'), 'utf-8');
+/**
+ * Extract a markdown section by heading using regex.
+ */
+function extractSection(content, heading) {
+    const pattern = new RegExp(`###\\s+${heading}[\\s\\S]*?(?=###|$)`);
+    const match = content.match(pattern);
+    return match?.[0];
+}
+describe('Consensus mode execution handoff (plan/SKILL.md)', () => {
+    it('should mandate structured question UI for the approval step', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(consensusSection.includes('structured question UI'), 'Consensus mode should mandate structured question UI');
+    });
+    it('should mandate $ralph invocation for execution on user approval', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(consensusSection.includes('$ralph'), 'Consensus mode should reference $ralph invocation');
+    });
+    it('should use MUST language for execution handoff', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(/MUST.*\$ralph/s.test(consensusSection) || /\$ralph.*MUST/s.test(consensusSection), 'Consensus mode should use MUST language around $ralph invocation');
+    });
+    it('should prohibit direct implementation from the planning agent', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(/Do NOT implement directly/i.test(consensusSection), 'Consensus mode should prohibit direct implementation');
+    });
+    it('should not modify Interview Mode steps', () => {
+        const interviewSection = extractSection(planSkill, 'Interview Mode');
+        assert.ok(interviewSection, 'Interview Mode section should exist');
+        assert.ok(interviewSection.includes('Classify the request'));
+        assert.ok(interviewSection.includes('Ask one focused question'));
+        assert.ok(interviewSection.includes('Gather codebase facts first'));
+    });
+    it('should not modify Direct Mode steps', () => {
+        const directSection = extractSection(planSkill, 'Direct Mode');
+        assert.ok(directSection, 'Direct Mode section should exist');
+        assert.ok(directSection.includes('Quick Analysis'));
+        assert.ok(directSection.includes('Create plan'));
+    });
+    it('should not modify Review Mode steps', () => {
+        const reviewSection = extractSection(planSkill, 'Review Mode');
+        assert.ok(reviewSection, 'Review Mode section should exist');
+        assert.ok(reviewSection.includes('Read plan file'));
+        assert.ok(reviewSection.includes('Evaluate via Critic'));
+    });
+    it('should reference $ralph in Escalation section', () => {
+        assert.ok(planSkill.includes('$ralph'), 'plan/SKILL.md should reference $ralph for execution handoff');
+    });
+    it('should require RALPLAN-DR structured deliberation in consensus mode', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(consensusSection.includes('RALPLAN-DR'), 'Should mention RALPLAN-DR');
+        assert.ok(consensusSection.includes('**Principles** (3-5)'), 'Should require Principles');
+        assert.ok(consensusSection.includes('**Decision Drivers** (top 3)'), 'Should require Decision Drivers');
+        assert.ok(consensusSection.includes('**Viable Options** (>=2)'), 'Should require Viable Options');
+        assert.ok(consensusSection.includes('**invalidation rationale**'), 'Should require invalidation rationale');
+    });
+    it('should require ADR fields in final consensus output', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(consensusSection.includes('ADR'), 'Should reference ADR');
+        assert.ok(consensusSection.includes('**Decision**'), 'ADR should include Decision');
+        assert.ok(consensusSection.includes('**Drivers**'), 'ADR should include Drivers');
+        assert.ok(consensusSection.includes('**Alternatives considered**'), 'ADR should include Alternatives considered');
+        assert.ok(consensusSection.includes('**Why chosen**'), 'ADR should include Why chosen');
+        assert.ok(consensusSection.includes('**Consequences**'), 'ADR should include Consequences');
+        assert.ok(consensusSection.includes('**Follow-ups**'), 'ADR should include Follow-ups');
+    });
+    it('should require available-agent-types roster and staffing guidance in handoff output', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.match(consensusSection, /available-agent-types roster/i);
+        assert.match(consensusSection, /staffing guidance|role allocation/i);
+        assert.match(consensusSection, /reasoning levels? by lane|suggested reasoning/i);
+        assert.match(consensusSection, /rcs team|launch hint/i);
+        assert.match(consensusSection, /team verification path/i);
+    });
+    it('should mention deliberate mode requirements in consensus mode', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(consensusSection.includes('**Deliberate**') || consensusSection.includes('deliberate mode'));
+        assert.ok(consensusSection.includes('`--deliberate`') || consensusSection.includes('--deliberate'));
+        assert.ok(consensusSection.includes('pre-mortem'));
+        assert.ok(consensusSection.includes('expanded test plan'));
+        assert.ok(consensusSection.includes('unit / integration / e2e / observability'));
+    });
+});
+describe('User feedback step between Planner and Architect/Critic (plan/SKILL.md)', () => {
+    it('should have a user feedback step after Planner and before Architect', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        const plannerIdx = consensusSection.indexOf('**Planner**');
+        const feedbackIdx = consensusSection.indexOf('**User feedback**');
+        const architectIdx = consensusSection.indexOf('**Architect**');
+        assert.ok(plannerIdx > -1, 'Should have Planner step');
+        assert.ok(feedbackIdx > -1, 'Should have User feedback step');
+        assert.ok(architectIdx > -1, 'Should have Architect step');
+        assert.ok(feedbackIdx > plannerIdx, 'User feedback should come after Planner');
+        assert.ok(architectIdx > feedbackIdx, 'Architect should come after User feedback');
+    });
+    it('should mandate structured question UI for the user feedback step', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(/User feedback.*MUST.*structured question UI/s.test(consensusSection), 'User feedback step should mandate structured question UI');
+    });
+    it('should offer Proceed/Request changes/Skip review options in user feedback step', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(consensusSection.includes('Proceed to review'));
+        assert.ok(consensusSection.includes('Request changes'));
+        assert.ok(consensusSection.includes('Skip review'));
+    });
+    it('should place Critic after Architect in the consensus flow', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        const architectIdx = consensusSection.indexOf('**Architect**');
+        const criticIdx = consensusSection.indexOf('**Critic**');
+        assert.ok(architectIdx > -1, 'Should have Architect step');
+        assert.ok(criticIdx > -1, 'Should have Critic step');
+        assert.ok(criticIdx > architectIdx, 'Critic should come after Architect');
+    });
+    it('should require architect antithesis and critic rejection gates in consensus flow', () => {
+        const consensusSection = extractSection(planSkill, 'Consensus Mode');
+        assert.ok(consensusSection, 'Consensus Mode section should exist');
+        assert.ok(consensusSection.includes('steelman counterargument (antithesis)') ||
+            consensusSection.includes('steelman counterargument'), 'Architect step should require steelman counterargument');
+        assert.ok(consensusSection.includes('tradeoff tension'), 'Should require tradeoff tension');
+        assert.ok(/Critic.*MUST.*explicitly reject shallow alternatives/s.test(consensusSection) ||
+            consensusSection.includes('Critic **MUST** explicitly reject shallow alternatives'), 'Critic should explicitly reject shallow alternatives');
+        assert.ok(consensusSection.includes('driver contradictions') ||
+            consensusSection.includes('driver contradiction'), 'Should mention driver contradictions');
+        assert.ok(consensusSection.includes('weak verification'), 'Should mention weak verification');
+    });
+});
+it('should require adaptive step sizing instead of a fixed five-step template', () => {
+    assert.match(planSkill, /adaptive step count|right-sized to task scope/i);
+    assert.match(planSkill, /do not default to exactly five steps|not a fixed five-step template/i);
+    assert.match(ralplanSkill, /do not default to exactly five steps/i);
+});
+describe('RALPLAN-DR in ralplan/SKILL.md', () => {
+    it('should contain RALPLAN-DR structured deliberation description', () => {
+        assert.ok(ralplanSkill.includes('RALPLAN-DR'), 'ralplan/SKILL.md should mention RALPLAN-DR');
+    });
+    it('should document the --deliberate flag', () => {
+        assert.ok(ralplanSkill.includes('--deliberate'), 'ralplan/SKILL.md should document --deliberate flag');
+    });
+    it('should contain Pre-Execution Gate section', () => {
+        assert.ok(ralplanSkill.includes('Pre-Execution Gate'), 'ralplan/SKILL.md should contain Pre-Execution Gate section');
+    });
+    it('should document gate bypass prefixes force: and !', () => {
+        assert.ok(ralplanSkill.includes('force:') && ralplanSkill.includes('! '), 'ralplan/SKILL.md should document force: and ! bypass prefixes');
+    });
+    it('should document sequential Architect then Critic execution', () => {
+        assert.ok(/step[s]? 3 and 4 MUST run sequentially|Do NOT.*parallel/i.test(ralplanSkill) ||
+            ralplanSkill.includes('await completion before step 4'), 'ralplan/SKILL.md should require sequential Architect/Critic execution');
+    });
+    it('should document ADR requirement', () => {
+        assert.ok(ralplanSkill.includes('ADR'), 'ralplan/SKILL.md should reference ADR requirement');
+    });
+    it('should document roster-aware team and ralph follow-up guidance', () => {
+        assert.match(ralplanSkill, /available-agent-types roster/i);
+        assert.match(ralplanSkill, /staffing guidance|role\/staffing allocation/i);
+        assert.match(ralplanSkill, /reasoning levels? by lane|reasoning-by-lane/i);
+        assert.match(ralplanSkill, /rcs team|launch hints?/i);
+        assert.match(ralplanSkill, /team verification/i);
+    });
+});
+describe('Architect prompt RALPLAN-DR sections', () => {
+    it('should have steelman antithesis requirement', () => {
+        assert.ok(architectPrompt.includes('antithesis') || architectPrompt.includes('steelman'), 'architect.md should require steelman antithesis');
+    });
+    it('should have tradeoff tension requirement', () => {
+        assert.ok(architectPrompt.includes('tradeoff tension'), 'architect.md should require tradeoff tension');
+    });
+    it('should have synthesis requirement', () => {
+        assert.ok(architectPrompt.includes('synthesis'), 'architect.md should mention synthesis');
+    });
+    it('should reference ralplan consensus reviews', () => {
+        assert.ok(architectPrompt.includes('ralplan'), 'architect.md should reference ralplan consensus reviews');
+    });
+});
+describe('Planner prompt follow-up staffing guidance', () => {
+    it('should require roster-aware staffing guidance for team and ralph handoff', () => {
+        assert.match(plannerPrompt, /available-agent-types roster/i);
+        assert.match(plannerPrompt, /team and ralph follow-up paths/i);
+        assert.match(plannerPrompt, /reasoning levels? by lane|suggested reasoning/i);
+        assert.match(plannerPrompt, /launch hints?/i);
+        assert.match(plannerPrompt, /team verification path/i);
+    });
+});
+describe('Critic prompt RALPLAN-DR sections', () => {
+    it('should have gate checks for ralplan reviews', () => {
+        assert.ok(criticPrompt.includes('ralplan') && criticPrompt.includes('gate'), 'critic.md should mention ralplan gate checks');
+    });
+    it('should explicitly REJECT shallow alternatives', () => {
+        assert.ok(/REJECT.*shallow alternatives/i.test(criticPrompt) ||
+            criticPrompt.includes('REJECT shallow alternatives'), 'critic.md should explicitly REJECT shallow alternatives');
+    });
+    it('should enforce deliberate mode requirements', () => {
+        assert.ok(criticPrompt.includes('deliberate') &&
+            (criticPrompt.includes('pre-mortem') || criticPrompt.includes('expanded test plan')), 'critic.md should enforce deliberate mode requirements');
+    });
+});
+//# sourceMappingURL=consensus-execution-handoff.test.js.map

package/dist/hooks/__tests__/consensus-execution-handoff.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consensus-execution-handoff.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/consensus-execution-handoff.test.ts"],"names":[],"mappings":"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"}

package/dist/hooks/__tests__/debugger-log-recency-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=debugger-log-recency-contract.test.d.ts.map

package/dist/hooks/__tests__/debugger-log-recency-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger-log-recency-contract.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/debugger-log-recency-contract.test.ts"],"names":[],"mappings":""}

package/dist/hooks/__tests__/debugger-log-recency-contract.test.js

@@ -0,0 +1,20 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { listTrackedAgentSurfaces, loadSurface } from './prompt-guidance-test-helpers.js';
+describe('debugger log recency guidance contract', () => {
+    it('root guidance prioritizes newer same-thread evidence over stale context', () => {
+        for (const surface of listTrackedAgentSurfaces()) {
+            const content = loadSurface(surface);
+            assert.match(content, /newer same-thread evidence/i);
+            assert.match(content, /current source of truth/i);
+            assert.match(content, /do not anchor on older evidence unless the user reaffirms it/i);
+        }
+    });
+    it('debugger guidance prioritizes the latest logs in the current turn', () => {
+        const content = loadSurface('prompts/debugger.md');
+        assert.match(content, /newly provided logs, stack traces, and diagnostics in the current turn/i);
+        assert.match(content, /primary evidence/i);
+        assert.match(content, /instead of anchoring on older logs/i);
+    });
+});
+//# sourceMappingURL=debugger-log-recency-contract.test.js.map

package/dist/hooks/__tests__/debugger-log-recency-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger-log-recency-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/debugger-log-recency-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAE1F,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,KAAK,MAAM,OAAO,IAAI,wBAAwB,EAAE,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,+DAA+D,CAAC,CAAC;QACzF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,OAAO,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,yEAAyE,CAAC,CAAC;QACjG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hooks/__tests__/deep-interview-contract.test.d.ts

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

package/dist/hooks/__tests__/deep-interview-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-interview-contract.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/deep-interview-contract.test.ts"],"names":[],"mappings":""}