@jstn-sdk/rcs 0.1.0

package/dist/cli/__tests__/exec.test.js

@@ -0,0 +1,213 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { existsSync } from 'node:fs';
+import { chmod, mkdir, mkdtemp, readFile, readdir, rm, writeFile } from 'node:fs/promises';
+import { spawnSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildExecFollowupStopOutput, injectExecFollowup, readPendingExecFollowups, } from '../../exec/followup.js';
+import { writeSessionStart } from '../../hooks/session.js';
+function runRcsCli(cwd, argv, envOverrides = {}) {
+    const testDir = dirname(fileURLToPath(import.meta.url));
+    const repoRoot = join(testDir, '..', '..', '..');
+    const rcsBin = join(repoRoot, 'dist', 'cli', 'rcs.js');
+    const result = spawnSync(process.execPath, [rcsBin, ...argv], {
+        cwd,
+        encoding: 'utf-8',
+        env: {
+            ...process.env,
+            CODEX_HOME: '',
+            RCS_MODEL_INSTRUCTIONS_FILE: '',
+            RCS_TEAM_WORKER: '',
+            RCS_TEAM_STATE_ROOT: '',
+            RCS_TEAM_LEADER_CWD: '',
+            ...envOverrides,
+        },
+    });
+    return {
+        status: result.status,
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+        error: result.error?.message || '',
+    };
+}
+describe('rcs exec', () => {
+    it('persists audited follow-up prompts for the active exec session without pane input', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-exec-followup-'));
+        try {
+            const session = await writeSessionStart(wd, 'rcs-test-followup');
+            const result = await injectExecFollowup({
+                cwd: wd,
+                sessionId: session.session_id,
+                actor: 'test-operator',
+                prompt: 'Please include the new migration note before finishing.',
+                nowIso: '2026-04-27T10:00:00.000Z',
+            });
+            assert.equal(result.queued.session_id, 'rcs-test-followup');
+            assert.equal(result.queued.actor, 'test-operator');
+            assert.equal(result.queued.prompt, 'Please include the new migration note before finishing.');
+            assert.match(result.queuePath, /exec-followups\.json$/);
+            const persisted = JSON.parse(await readFile(result.queuePath, 'utf-8'));
+            assert.equal(persisted.records.length, 1);
+            assert.equal(persisted.records[0]?.delivered_at, undefined);
+            const auditPath = join(wd, '.rcs', 'logs', 'exec-followups-2026-04-27.jsonl');
+            assert.match(await readFile(auditPath, 'utf-8'), /exec_followup_queued/);
+            assert.match(await readFile(auditPath, 'utf-8'), /Please include the new migration note/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('preserves all follow-up prompts from concurrent injections', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-exec-followup-concurrent-'));
+        try {
+            const session = await writeSessionStart(wd, 'rcs-test-concurrent-followup');
+            const count = 25;
+            const results = await Promise.all(Array.from({ length: count }, async (_, index) => (injectExecFollowup({
+                cwd: wd,
+                sessionId: session.session_id,
+                actor: `operator-${index}`,
+                prompt: `Concurrent follow-up ${index}`,
+                nowIso: '2026-04-27T10:01:00.000Z',
+            }))));
+            const pending = await readPendingExecFollowups(wd, session.session_id);
+            assert.equal(pending.pending.length, count);
+            assert.deepEqual([...new Set(pending.pending.map((record) => record.id))].sort(), results.map((result) => result.queued.id).sort());
+            assert.deepEqual(pending.pending.map((record) => record.prompt).sort(), Array.from({ length: count }, (_, index) => `Concurrent follow-up ${index}`).sort());
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('delivers queued follow-ups through Stop hook output and marks them delivered', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-exec-followup-stop-'));
+        try {
+            const session = await writeSessionStart(wd, 'rcs-test-stop-followup');
+            const queued = await injectExecFollowup({
+                cwd: wd,
+                sessionId: session.session_id,
+                actor: 'qa',
+                prompt: 'Before stopping, verify the targeted exec tests.',
+                nowIso: '2026-04-27T10:05:00.000Z',
+            });
+            const output = await buildExecFollowupStopOutput(wd, session.session_id);
+            assert.equal(output?.decision, 'block');
+            assert.match(String(output?.reason), new RegExp(queued.queued.id));
+            assert.match(String(output?.systemMessage), /queued follow-up instruction/);
+            assert.match(String(output?.systemMessage), /Before stopping, verify the targeted exec tests/);
+            const after = await readPendingExecFollowups(wd, session.session_id);
+            assert.equal(after.pending.length, 0);
+            const persisted = JSON.parse(await readFile(queued.queuePath, 'utf-8'));
+            assert.equal(persisted.records[0]?.delivery_event, 'stop-hook');
+            assert.ok(persisted.records[0]?.delivered_at);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('quarantines malformed follow-up queue JSON instead of crashing Stop delivery', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-exec-followup-corrupt-'));
+        try {
+            const session = await writeSessionStart(wd, 'rcs-test-corrupt-followup');
+            const queuePath = join(wd, '.rcs', 'state', 'sessions', session.session_id, 'exec-followups.json');
+            await mkdir(dirname(queuePath), { recursive: true });
+            await writeFile(queuePath, '{"version":1,"records":[', 'utf-8');
+            const output = await buildExecFollowupStopOutput(wd, session.session_id);
+            assert.equal(output, null);
+            const recovered = JSON.parse(await readFile(queuePath, 'utf-8'));
+            assert.deepEqual(recovered.records, []);
+            const queueDirEntries = await readdir(dirname(queuePath));
+            assert.ok(queueDirEntries.some((entry) => entry.startsWith('exec-followups.json.corrupt-')), 'malformed queue should be quarantined beside the recovered queue');
+            const auditPath = join(wd, '.rcs', 'logs', `exec-followups-${new Date().toISOString().slice(0, 10)}.jsonl`);
+            assert.match(await readFile(auditPath, 'utf-8'), /exec_followup_queue_corrupt_recovered/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('runs codex exec with session-scoped instructions that preserve AGENTS and overlay content', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-exec-cli-'));
+        try {
+            const home = join(wd, 'home');
+            const fakeBin = join(wd, 'bin');
+            const fakeCodexPath = join(fakeBin, 'codex');
+            const fakePsPath = join(fakeBin, 'ps');
+            await mkdir(join(home, '.codex'), { recursive: true });
+            await mkdir(fakeBin, { recursive: true });
+            await writeFile(join(home, '.codex', 'AGENTS.md'), '# User Instructions\n\nGlobal guidance.\n');
+            await writeFile(join(wd, 'AGENTS.md'), '# Project Instructions\n\nProject guidance.\n');
+            await writeFile(fakeCodexPath, [
+                '#!/bin/sh',
+                'printf \'fake-codex:%s\\n\' "$*"',
+                'for arg in "$@"; do',
+                '  case "$arg" in',
+                '    model_instructions_file=*)',
+                '      file=$(printf %s "$arg" | sed \'s/^model_instructions_file="//; s/"$//\')',
+                '      printf \'instructions-path:%s\\n\' "$file"',
+                '      printf \'instructions-start\\n\'',
+                '      cat "$file"',
+                '      printf \'instructions-end\\n\'',
+                '      ;;',
+                '  esac',
+                'done',
+            ].join('\n'));
+            await chmod(fakeCodexPath, 0o755);
+            await writeFile(fakePsPath, '#!/bin/sh\nexit 0\n');
+            await chmod(fakePsPath, 0o755);
+            const result = runRcsCli(wd, ['exec', '--model', 'gpt-5', 'say hi'], {
+                HOME: home,
+                NODE_OPTIONS: '',
+                PATH: `${fakeBin}:/usr/bin:/bin`,
+                RCS_AUTO_UPDATE: '0',
+                RCS_NOTIFY_FALLBACK: '0',
+                RCS_HOOK_DERIVED_SIGNALS: '0',
+            });
+            assert.equal(result.status, 0, result.error || result.stderr || result.stdout);
+            assert.match(result.stdout, /fake-codex:exec --model gpt-5 say hi /);
+            assert.match(result.stdout, /instructions-path:.*\/\.rcs\/state\/sessions\/rcs-.*\/AGENTS\.md/);
+            assert.match(result.stdout, /# User Instructions/);
+            assert.match(result.stdout, /# Project Instructions/);
+            assert.match(result.stdout, /<!-- RCS:RUNTIME:START -->/);
+            const sessionRoot = join(wd, '.rcs', 'state', 'sessions');
+            const sessionEntries = await readdir(sessionRoot);
+            assert.equal(sessionEntries.length, 1);
+            const sessionFiles = await readdir(join(sessionRoot, sessionEntries[0]));
+            assert.equal(sessionFiles.includes('AGENTS.md'), false, 'session-scoped AGENTS file should be cleaned up after exec exits');
+            assert.equal(existsSync(join(wd, '.rcs', 'state', 'session.json')), false);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('passes exec --help through to codex exec', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-exec-help-'));
+        try {
+            const home = join(wd, 'home');
+            const fakeBin = join(wd, 'bin');
+            const fakeCodexPath = join(fakeBin, 'codex');
+            const fakePsPath = join(fakeBin, 'ps');
+            await mkdir(home, { recursive: true });
+            await mkdir(fakeBin, { recursive: true });
+            await writeFile(fakeCodexPath, '#!/bin/sh\nprintf \'fake-codex:%s\\n\' \"$*\"\n');
+            await chmod(fakeCodexPath, 0o755);
+            await writeFile(fakePsPath, '#!/bin/sh\nexit 0\n');
+            await chmod(fakePsPath, 0o755);
+            const result = runRcsCli(wd, ['exec', '--help'], {
+                HOME: home,
+                NODE_OPTIONS: '',
+                PATH: `${fakeBin}:/usr/bin:/bin`,
+                RCS_AUTO_UPDATE: '0',
+                RCS_NOTIFY_FALLBACK: '0',
+                RCS_HOOK_DERIVED_SIGNALS: '0',
+            });
+            assert.equal(result.status, 0, result.error || result.stderr || result.stdout);
+            assert.match(result.stdout, /fake-codex:exec --help\b/);
+            assert.doesNotMatch(result.stdout, /roblox-ai-os-creator-skills \(rcs\) - Multi-agent orchestration for Codex CLI/i);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=exec.test.js.map

package/dist/cli/__tests__/exec.test.js.map

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

package/dist/cli/__tests__/explore-windows-diagnostics.test.d.ts

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

package/dist/cli/__tests__/explore-windows-diagnostics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-windows-diagnostics.test.d.ts","sourceRoot":"","sources":["../../../src/cli/__tests__/explore-windows-diagnostics.test.ts"],"names":[],"mappings":""}

package/dist/cli/__tests__/explore-windows-diagnostics.test.js

@@ -0,0 +1,17 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { assertBuiltinExploreHarnessSupported, getBuiltinExploreHarnessUnsupportedReason, } from '../explore.js';
+describe('explore Windows built-in harness diagnostics', () => {
+    it('reports the built-in harness as unsupported on Windows unless a custom override is set', () => {
+        assert.match(getBuiltinExploreHarnessUnsupportedReason('win32', {}) || '', /not ready on Windows/i);
+        assert.equal(getBuiltinExploreHarnessUnsupportedReason('win32', { RCS_EXPLORE_BIN: 'custom-harness.exe' }), undefined);
+        assert.equal(getBuiltinExploreHarnessUnsupportedReason('linux', {}), undefined);
+    });
+    it('fails early with actionable guidance for the built-in harness on Windows', () => {
+        assert.throws(() => assertBuiltinExploreHarnessSupported('win32', {}), /built-in explore harness is not ready on Windows/i);
+        assert.doesNotThrow(() => assertBuiltinExploreHarnessSupported('win32', {
+            RCS_EXPLORE_BIN: 'custom-harness.exe',
+        }));
+    });
+});
+//# sourceMappingURL=explore-windows-diagnostics.test.js.map

package/dist/cli/__tests__/explore-windows-diagnostics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-windows-diagnostics.test.js","sourceRoot":"","sources":["../../../src/cli/__tests__/explore-windows-diagnostics.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EACL,oCAAoC,EACpC,yCAAyC,GAC1C,MAAM,eAAe,CAAC;AAEvB,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC5D,EAAE,CAAC,wFAAwF,EAAE,GAAG,EAAE;QAChG,MAAM,CAAC,KAAK,CACV,yCAAyC,CAAC,OAAO,EAAE,EAAuB,CAAC,IAAI,EAAE,EACjF,uBAAuB,CACxB,CAAC;QACF,MAAM,CAAC,KAAK,CACV,yCAAyC,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,oBAAoB,EAAuB,CAAC,EAClH,SAAS,CACV,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,OAAO,EAAE,EAAuB,CAAC,EAAE,SAAS,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,oCAAoC,CAAC,OAAO,EAAE,EAAuB,CAAC,EAC5E,mDAAmD,CACpD,CAAC;QACF,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,oCAAoC,CAAC,OAAO,EAAE;YACtE,eAAe,EAAE,oBAAoB;SACjB,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/__tests__/explore.test.d.ts

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

package/dist/cli/__tests__/explore.test.d.ts.map

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