@jstn-sdk/rcs 0.1.0

package/dist/cli/__tests__/agents-init.test.js

@@ -0,0 +1,184 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { existsSync } from 'node:fs';
+import { mkdir, mkdtemp, readFile, readdir, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { agentsInit } from '../agents-init.js';
+function runRcsCli(cwd, argv) {
+    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 },
+    });
+    return {
+        status: result.status,
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+        error: result.error?.message,
+    };
+}
+function shouldSkipForSpawnPermissions(err) {
+    return typeof err === 'string' && /(EPERM|EACCES)/i.test(err);
+}
+async function withCwd(cwd, fn) {
+    const previous = process.cwd();
+    process.chdir(cwd);
+    try {
+        return await fn();
+    }
+    finally {
+        process.chdir(previous);
+    }
+}
+async function readCurrentLinuxStartTicks() {
+    if (process.platform !== 'linux')
+        return undefined;
+    try {
+        const stat = await readFile('/proc/self/stat', 'utf-8');
+        const commandEnd = stat.lastIndexOf(')');
+        if (commandEnd === -1)
+            return undefined;
+        const fields = stat.slice(commandEnd + 1).trim().split(/\s+/);
+        const ticks = Number(fields[19]);
+        return Number.isFinite(ticks) ? ticks : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+describe('rcs agents-init', () => {
+    it('creates a managed root AGENTS.md plus direct-child AGENTS.md files while skipping ignored directories', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-init-'));
+        try {
+            await mkdir(join(wd, 'src'), { recursive: true });
+            await mkdir(join(wd, 'docs'), { recursive: true });
+            await mkdir(join(wd, 'node_modules', 'dep'), { recursive: true });
+            await mkdir(join(wd, 'dist'), { recursive: true });
+            await writeFile(join(wd, 'src', 'index.ts'), 'export const value = 1;\n');
+            await writeFile(join(wd, 'docs', 'guide.md'), '# guide\n');
+            await writeFile(join(wd, 'package.json'), '{"name":"fixture"}\n');
+            await withCwd(wd, async () => {
+                await agentsInit();
+            });
+            const rootAgents = await readFile(join(wd, 'AGENTS.md'), 'utf-8');
+            const srcAgents = await readFile(join(wd, 'src', 'AGENTS.md'), 'utf-8');
+            const docsAgents = await readFile(join(wd, 'docs', 'AGENTS.md'), 'utf-8');
+            assert.match(rootAgents, /RCS:AGENTS-INIT:MANAGED/);
+            assert.match(rootAgents, /<!-- AUTONOMY DIRECTIVE — DO NOT REMOVE -->/);
+            assert.match(rootAgents, /<!-- END AUTONOMY DIRECTIVE -->\n\n# roblox-ai-os-creator-skills - Intelligent Multi-Agent Orchestration/);
+            assert.match(rootAgents, /# roblox-ai-os-creator-skills - Intelligent Multi-Agent Orchestration/);
+            assert.match(rootAgents, /\.\/\.codex/);
+            assert.match(srcAgents, /<!-- Parent: ..\/AGENTS\.md -->/);
+            assert.match(srcAgents, /`index\.ts`/);
+            assert.match(docsAgents, /`guide\.md`/);
+            assert.equal(existsSync(join(wd, 'node_modules', 'AGENTS.md')), false);
+            assert.equal(existsSync(join(wd, 'dist', 'AGENTS.md')), false);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('refreshes managed subtree files while preserving the manual notes block', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-init-'));
+        try {
+            await mkdir(join(wd, 'src', 'lib'), { recursive: true });
+            await writeFile(join(wd, 'src', 'index.ts'), 'export const index = true;\n');
+            await withCwd(wd, async () => {
+                await agentsInit({ targetPath: 'src' });
+            });
+            const agentsPath = join(wd, 'src', 'AGENTS.md');
+            const initial = await readFile(agentsPath, 'utf-8');
+            const customized = initial.replace('- Add subtree-specific constraints, ownership notes, and test commands here.', '- Preserve this custom manual note.');
+            await writeFile(agentsPath, customized);
+            await writeFile(join(wd, 'src', 'new-file.ts'), 'export const newer = true;\n');
+            await withCwd(wd, async () => {
+                await agentsInit({ targetPath: 'src' });
+            });
+            const refreshed = await readFile(agentsPath, 'utf-8');
+            assert.match(refreshed, /Preserve this custom manual note\./);
+            assert.match(refreshed, /`new-file\.ts`/);
+            assert.equal(existsSync(join(wd, 'src', 'lib', 'AGENTS.md')), true);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('skips unmanaged AGENTS.md files by default but can adopt them with --force and a backup', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-init-'));
+        const original = '# custom root guidance\n';
+        try {
+            await mkdir(join(wd, 'src'), { recursive: true });
+            await writeFile(join(wd, 'AGENTS.md'), original);
+            await writeFile(join(wd, 'src', 'index.ts'), 'export const x = 1;\n');
+            await withCwd(wd, async () => {
+                await agentsInit();
+            });
+            assert.equal(await readFile(join(wd, 'AGENTS.md'), 'utf-8'), original);
+            assert.equal(existsSync(join(wd, 'src', 'AGENTS.md')), true);
+            await withCwd(wd, async () => {
+                await agentsInit({ force: true });
+            });
+            const adopted = await readFile(join(wd, 'AGENTS.md'), 'utf-8');
+            assert.match(adopted, /RCS:AGENTS-INIT:MANAGED/);
+            const backupRoot = join(wd, '.rcs', 'backups', 'agents-init');
+            assert.equal(existsSync(backupRoot), true);
+            const timestamps = await readdir(backupRoot);
+            assert.equal(timestamps.length > 0, true);
+            const backupContent = await readFile(join(backupRoot, timestamps[0], 'AGENTS.md'), 'utf-8');
+            assert.equal(backupContent, original);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('protects project-root AGENTS.md during an active RCS session', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-init-'));
+        try {
+            const pidStartTicks = await readCurrentLinuxStartTicks();
+            await mkdir(join(wd, '.rcs', 'state'), { recursive: true });
+            await mkdir(join(wd, 'src'), { recursive: true });
+            await writeFile(join(wd, 'AGENTS.md'), '# unmanaged\n');
+            await writeFile(join(wd, 'src', 'index.ts'), 'export const x = 1;\n');
+            await writeFile(join(wd, '.rcs', 'state', 'session.json'), JSON.stringify({
+                session_id: 'session-1',
+                started_at: new Date().toISOString(),
+                cwd: wd,
+                pid: process.pid,
+                pid_start_ticks: pidStartTicks,
+            }, null, 2));
+            await withCwd(wd, async () => {
+                await agentsInit({ force: true });
+            });
+            assert.equal(await readFile(join(wd, 'AGENTS.md'), 'utf-8'), '# unmanaged\n');
+            assert.equal(existsSync(join(wd, 'src', 'AGENTS.md')), true);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('exposes help for agents-init and the deepinit alias', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-init-'));
+        try {
+            const helpRes = runRcsCli(wd, ['agents-init', '--help']);
+            if (shouldSkipForSpawnPermissions(helpRes.error))
+                return;
+            assert.equal(helpRes.status, 0, helpRes.stderr || helpRes.stdout);
+            assert.match(helpRes.stdout, /Usage: rcs agents-init/);
+            const aliasRes = runRcsCli(wd, ['deepinit', '--help']);
+            if (shouldSkipForSpawnPermissions(aliasRes.error))
+                return;
+            assert.equal(aliasRes.status, 0, aliasRes.stderr || aliasRes.stdout);
+            assert.match(aliasRes.stdout, /Usage: rcs agents-init/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=agents-init.test.js.map

package/dist/cli/__tests__/agents-init.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,137 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { chmod, mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+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, ...envOverrides },
+    });
+    return {
+        status: result.status,
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+        error: result.error?.message,
+    };
+}
+function shouldSkipForSpawnPermissions(err) {
+    return typeof err === 'string' && /(EPERM|EACCES)/i.test(err);
+}
+describe('rcs agents', () => {
+    it('lists project and user native agents with name, description, and model', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-cli-'));
+        const home = join(wd, 'home');
+        try {
+            const projectAgentsDir = join(wd, '.codex', 'agents');
+            const userAgentsDir = join(home, '.codex', 'agents');
+            await mkdir(projectAgentsDir, { recursive: true });
+            await mkdir(userAgentsDir, { recursive: true });
+            await writeFile(join(projectAgentsDir, 'planner.toml'), 'name = "planner"\ndescription = "Project planner"\nmodel = "gpt-5.5"\ndeveloper_instructions = """plan"""\n');
+            await writeFile(join(userAgentsDir, 'reviewer.toml'), 'name = "reviewer"\ndescription = "User reviewer"\ndeveloper_instructions = """review"""\n');
+            const result = runRcsCli(wd, ['agents', 'list'], {
+                HOME: home,
+                CODEX_HOME: join(home, '.codex'),
+            });
+            if (shouldSkipForSpawnPermissions(result.error))
+                return;
+            assert.equal(result.status, 0, result.stderr || result.stdout);
+            assert.match(result.stdout, /scope\s+name\s+model\s+description/i);
+            assert.match(result.stdout, /project\s+planner\s+gpt-5\.5\s+Project planner/);
+            assert.match(result.stdout, /user\s+reviewer\s+-\s+User reviewer/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('adds a scaffolded agent TOML file with required fields and commented optional fields', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-cli-'));
+        const home = join(wd, 'home');
+        try {
+            await mkdir(home, { recursive: true });
+            const result = runRcsCli(wd, ['agents', 'add', 'my-helper', '--scope', 'project'], {
+                HOME: home,
+                CODEX_HOME: join(home, '.codex'),
+            });
+            if (shouldSkipForSpawnPermissions(result.error))
+                return;
+            assert.equal(result.status, 0, result.stderr || result.stdout);
+            const agentPath = join(wd, '.codex', 'agents', 'my-helper.toml');
+            assert.equal(existsSync(agentPath), true);
+            const content = await readFile(agentPath, 'utf-8');
+            assert.match(content, /^name = "my-helper"$/m);
+            assert.match(content, /^description = "TODO: describe this agent's purpose"$/m);
+            assert.match(content, /^developer_instructions = """$/m);
+            assert.match(content, /^# model = "gpt-5\.5"$/m);
+            assert.match(content, /^# model_reasoning_effort = "medium"$/m);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('edits an existing agent via $EDITOR and removes it with --force', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-cli-'));
+        const home = join(wd, 'home');
+        try {
+            const projectAgentsDir = join(wd, '.codex', 'agents');
+            await mkdir(projectAgentsDir, { recursive: true });
+            await mkdir(home, { recursive: true });
+            const agentPath = join(projectAgentsDir, 'editor-test.toml');
+            await writeFile(agentPath, 'name = "editor-test"\ndescription = "Before edit"\ndeveloper_instructions = """before"""\n');
+            const editorScript = join(wd, 'editor.sh');
+            await writeFile(editorScript, '#!/usr/bin/env bash\nprintf \'\\nmodel = "gpt-5.5"\\n\' >> "$1"\n');
+            await chmod(editorScript, 0o755);
+            const editResult = runRcsCli(wd, ['agents', 'edit', 'editor-test', '--scope', 'project'], {
+                HOME: home,
+                CODEX_HOME: join(home, '.codex'),
+                EDITOR: editorScript,
+            });
+            if (shouldSkipForSpawnPermissions(editResult.error))
+                return;
+            assert.equal(editResult.status, 0, editResult.stderr || editResult.stdout);
+            assert.match(await readFile(agentPath, 'utf-8'), /^model = "gpt-5\.5"$/m);
+            const removeResult = runRcsCli(wd, ['agents', 'remove', 'editor-test', '--scope', 'project', '--force'], {
+                HOME: home,
+                CODEX_HOME: join(home, '.codex'),
+            });
+            if (shouldSkipForSpawnPermissions(removeResult.error))
+                return;
+            assert.equal(removeResult.status, 0, removeResult.stderr || removeResult.stdout);
+            assert.equal(existsSync(agentPath), false);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('fails with clear guidance when remove runs in non-interactive mode without --force', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-agents-cli-'));
+        const home = join(wd, 'home');
+        try {
+            const projectAgentsDir = join(wd, '.codex', 'agents');
+            await mkdir(projectAgentsDir, { recursive: true });
+            await mkdir(home, { recursive: true });
+            const agentPath = join(projectAgentsDir, 'non-interactive.toml');
+            await writeFile(agentPath, 'name = "non-interactive"\ndescription = "Remove me"\ndeveloper_instructions = """noop"""\n');
+            const result = runRcsCli(wd, ['agents', 'remove', 'non-interactive', '--scope', 'project'], {
+                HOME: home,
+                CODEX_HOME: join(home, '.codex'),
+            });
+            if (shouldSkipForSpawnPermissions(result.error))
+                return;
+            assert.notEqual(result.status, 0, 'expected non-zero exit for non-interactive remove');
+            assert.equal(existsSync(agentPath), true, 'agent file should remain when remove aborts');
+            assert.match(result.stderr, /remove requires an interactive terminal; rerun with --force in non-interactive environments/i);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=agents.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.test.js","sourceRoot":"","sources":["../../../src/cli/__tests__/agents.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,SAAS,CAChB,GAAW,EACX,IAAc,EACd,eAAuC,EAAE;IAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE;QAC5D,GAAG;QACH,QAAQ,EAAE,OAAO;QACjB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,EAAE;KACzC,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CAAC,GAAY;IACjD,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEhD,MAAM,SAAS,CACb,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,EACtC,6GAA6G,CAC9G,CAAC;YACF,MAAM,SAAS,CACb,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,EACpC,2FAA2F,CAC5F,CAAC;YAEF,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;gBAC/C,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;aACjC,CAAC,CAAC;YACH,IAAI,6BAA6B,CAAC,MAAM,CAAC,KAAK,CAAC;gBAAE,OAAO;YAExD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC;YACnE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,gDAAgD,CAAC,CAAC;YAC9E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC;QACrE,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,KAAK,IAAI,EAAE;QACpG,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEvC,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;gBACjF,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;aACjC,CAAC,CAAC;YACH,IAAI,6BAA6B,CAAC,MAAM,CAAC,KAAK,CAAC;gBAAE,OAAO;YAExD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YACjE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;YAE1C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,wDAAwD,CAAC,CAAC;YAChF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAC;YACzD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;YAC7D,MAAM,SAAS,CACb,SAAS,EACT,4FAA4F,CAC7F,CAAC;YAEF,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YAC3C,MAAM,SAAS,CACb,YAAY,EACZ,mEAAmE,CACpE,CAAC;YACF,MAAM,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAEjC,MAAM,UAAU,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;gBACxF,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAChC,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;YACH,IAAI,6BAA6B,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,OAAO;YAE5D,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YAC3E,MAAM,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,uBAAuB,CAAC,CAAC;YAE1E,MAAM,YAAY,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;gBACvG,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;aACjC,CAAC,CAAC;YACH,IAAI,6BAA6B,CAAC,YAAY,CAAC,KAAK,CAAC;gBAAE,OAAO;YAE9D,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;YACjF,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;YACjE,MAAM,SAAS,CACb,SAAS,EACT,4FAA4F,CAC7F,CAAC;YAEF,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;gBAC1F,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;aACjC,CAAC,CAAC;YACH,IAAI,6BAA6B,CAAC,MAAM,CAAC,KAAK,CAAC;gBAAE,OAAO;YAExD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,mDAAmD,CAAC,CAAC;YACvF,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,6CAA6C,CAAC,CAAC;YACzF,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,MAAM,EACb,8FAA8F,CAC/F,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,265 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { chmod, mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { parseAskArgs } from '../ask.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 r = spawnSync(process.execPath, [rcsBin, ...argv], {
+        cwd,
+        encoding: 'utf-8',
+        env: { ...process.env, ...envOverrides },
+    });
+    return { status: r.status, stdout: r.stdout || '', stderr: r.stderr || '', error: r.error?.message };
+}
+function runProviderAdvisorScript(cwd, argv) {
+    const testDir = dirname(fileURLToPath(import.meta.url));
+    const repoRoot = join(testDir, '..', '..', '..');
+    const scriptPath = join(repoRoot, 'dist', 'scripts', 'run-provider-advisor.js');
+    const r = spawnSync(process.execPath, [scriptPath, ...argv], {
+        cwd,
+        encoding: 'utf-8',
+        env: process.env,
+    });
+    return { status: r.status, stdout: r.stdout || '', stderr: r.stderr || '', error: r.error?.message };
+}
+function normalizeDarwinTmpPath(value) {
+    return process.platform === 'darwin' ? value.replaceAll('/private/var/', '/var/') : value;
+}
+function shouldSkipForSpawnPermissions(err) {
+    return typeof err === 'string' && /(EPERM|EACCES)/i.test(err);
+}
+describe('parseAskArgs', () => {
+    it('parses positional prompt form', () => {
+        assert.deepEqual(parseAskArgs(['claude', 'review', 'this']), {
+            provider: 'claude',
+            prompt: 'review this',
+        });
+    });
+    it('parses -p prompt form', () => {
+        assert.deepEqual(parseAskArgs(['gemini', '-p', 'brainstorm', 'ideas']), {
+            provider: 'gemini',
+            prompt: 'brainstorm ideas',
+        });
+    });
+    it('parses --print prompt form', () => {
+        assert.deepEqual(parseAskArgs(['claude', '--print', 'review', 'this']), {
+            provider: 'claude',
+            prompt: 'review this',
+        });
+    });
+    it('parses --prompt prompt form', () => {
+        assert.deepEqual(parseAskArgs(['gemini', '--prompt', 'brainstorm', 'ideas']), {
+            provider: 'gemini',
+            prompt: 'brainstorm ideas',
+        });
+    });
+    it('parses --agent-prompt with positional task text', () => {
+        assert.deepEqual(parseAskArgs(['claude', '--agent-prompt', 'executor', 'review', 'this']), {
+            provider: 'claude',
+            prompt: 'review this',
+            agentPromptRole: 'executor',
+        });
+    });
+    it('parses --agent-prompt=<role> with --prompt task text', () => {
+        assert.deepEqual(parseAskArgs(['gemini', '--agent-prompt=planner', '--prompt', 'brainstorm', 'ideas']), {
+            provider: 'gemini',
+            prompt: 'brainstorm ideas',
+            agentPromptRole: 'planner',
+        });
+    });
+    it('throws for invalid provider', () => {
+        assert.throws(() => parseAskArgs(['openai', 'hello']), /Invalid provider/);
+    });
+    it('throws when prompt is missing', () => {
+        assert.throws(() => parseAskArgs(['claude']), /Missing prompt text/);
+    });
+    it('throws when --agent-prompt role is missing', () => {
+        assert.throws(() => parseAskArgs(['claude', '--agent-prompt', '--prompt', 'hello']), /Missing role after --agent-prompt/);
+    });
+});
+describe('rcs ask', () => {
+    it('script usage documents provider-specific long flags from CLI help', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-usage-'));
+        try {
+            const res = runProviderAdvisorScript(wd, []);
+            if (shouldSkipForSpawnPermissions(res.error))
+                return;
+            assert.equal(res.status, 1, res.stderr || res.stdout);
+            assert.match(res.stderr, /claude --print/);
+            assert.match(res.stderr, /gemini --prompt/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('preserves child stdout/stderr and exact non-zero exit code', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-contract-'));
+        try {
+            const res = runRcsCli(wd, ['ask', 'claude', 'pass-through'], {
+                RCS_ASK_ADVISOR_SCRIPT: 'dist/scripts/fixtures/ask-advisor-stub.js',
+                RCS_ASK_STUB_STDOUT: 'artifact-path-from-stub.md\n',
+                RCS_ASK_STUB_STDERR: 'stub-warning-line\n',
+                RCS_ASK_STUB_EXIT_CODE: '7',
+            });
+            if (shouldSkipForSpawnPermissions(res.error))
+                return;
+            assert.equal(res.status, 7, res.stderr || res.stdout);
+            assert.equal(res.stdout, 'artifact-path-from-stub.md\n');
+            assert.equal(res.stderr, 'stub-warning-line\n');
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('resolves relative advisor override path from package root even on non-root cwd', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-relative-'));
+        try {
+            const res = runRcsCli(wd, ['ask', 'gemini', 'relative-check'], {
+                RCS_ASK_ADVISOR_SCRIPT: 'dist/scripts/fixtures/ask-advisor-stub.js',
+                RCS_ASK_STUB_STDOUT: 'relative-override-ok\n',
+                RCS_ASK_STUB_EXIT_CODE: '0',
+            });
+            if (shouldSkipForSpawnPermissions(res.error))
+                return;
+            assert.equal(res.status, 0, res.stderr || res.stdout);
+            assert.equal(res.stdout, 'relative-override-ok\n');
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('uses package-root advisor script path from non-package cwd and still writes artifact', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-nonroot-'));
+        try {
+            const fakeBin = join(wd, 'bin');
+            await mkdir(fakeBin, { recursive: true });
+            await writeFile(join(fakeBin, 'claude'), '#!/bin/sh\nif [ "$1" = "--version" ]; then echo "fake-claude"; exit 0; fi\nif [ "$1" = "-p" ]; then echo "NONROOT_DEFAULT_OK"; exit 0; fi\necho "unexpected" 1>&2\nexit 3\n');
+            await chmod(join(fakeBin, 'claude'), 0o755);
+            const res = runRcsCli(wd, ['ask', 'claude', 'non-root-default'], {
+                PATH: `${fakeBin}:${process.env.PATH || ''}`,
+            });
+            if (shouldSkipForSpawnPermissions(res.error))
+                return;
+            assert.equal(res.status, 0, res.stderr || res.stdout);
+            const artifactPath = res.stdout.trim();
+            assert.ok(normalizeDarwinTmpPath(artifactPath).startsWith(normalizeDarwinTmpPath(join(wd, '.rcs', 'artifacts', 'claude-'))));
+            assert.equal(existsSync(artifactPath), true);
+            const artifact = await readFile(artifactPath, 'utf-8');
+            assert.match(artifact, /NONROOT_DEFAULT_OK/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('supports claude --print and gemini --prompt end-to-end through rcs ask', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-provider-flags-'));
+        try {
+            const fakeBin = join(wd, 'bin');
+            await mkdir(fakeBin, { recursive: true });
+            await writeFile(join(fakeBin, 'claude'), '#!/bin/sh\nif [ \"$1\" = \"--version\" ]; then echo \"fake-claude\"; exit 0; fi\nif [ \"$1\" = \"-p\" ]; then echo \"CLAUDE_PRINT_OK:$2\"; exit 0; fi\necho \"unexpected\" 1>&2\nexit 3\n');
+            await chmod(join(fakeBin, 'claude'), 0o755);
+            await writeFile(join(fakeBin, 'gemini'), '#!/bin/sh\nif [ \"$1\" = \"--version\" ]; then echo \"fake-gemini\"; exit 0; fi\nif [ \"$1\" = \"-p\" ]; then echo \"GEMINI_PROMPT_OK:$2\"; exit 0; fi\necho \"unexpected\" 1>&2\nexit 4\n');
+            await chmod(join(fakeBin, 'gemini'), 0o755);
+            const env = {
+                PATH: `${fakeBin}:${process.env.PATH || ''}`,
+            };
+            const claudeRes = runRcsCli(wd, ['ask', 'claude', '--print', 'claude-long-flag'], env);
+            if (shouldSkipForSpawnPermissions(claudeRes.error))
+                return;
+            assert.equal(claudeRes.status, 0, claudeRes.stderr || claudeRes.stdout);
+            const claudeArtifactPath = claudeRes.stdout.trim();
+            const claudeArtifact = await readFile(claudeArtifactPath, 'utf-8');
+            assert.match(claudeArtifact, /CLAUDE_PRINT_OK:claude-long-flag/);
+            const geminiRes = runRcsCli(wd, ['ask', 'gemini', '--prompt', 'gemini-long-flag'], env);
+            assert.equal(geminiRes.status, 0, geminiRes.stderr || geminiRes.stdout);
+            const geminiArtifactPath = geminiRes.stdout.trim();
+            const geminiArtifact = await readFile(geminiArtifactPath, 'utf-8');
+            assert.match(geminiArtifact, /GEMINI_PROMPT_OK:gemini-long-flag/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('adds Claude skip-permissions for issue-work prompts only', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-issue-permissions-'));
+        try {
+            const fakeBin = join(wd, 'bin');
+            await mkdir(fakeBin, { recursive: true });
+            await writeFile(join(fakeBin, 'claude'), '#!/bin/sh\nif [ \"$1\" = \"--version\" ]; then echo \"fake-claude\"; exit 0; fi\necho \"CLAUDE_ARGS:$*\"; exit 0\n');
+            await chmod(join(fakeBin, 'claude'), 0o755);
+            const env = { PATH: `${fakeBin}:${process.env.PATH || ''}` };
+            const issueRes = runRcsCli(wd, ['ask', 'claude', 'Investigate issue #1536 and summarize it'], env);
+            if (shouldSkipForSpawnPermissions(issueRes.error))
+                return;
+            assert.equal(issueRes.status, 0, issueRes.stderr || issueRes.stdout);
+            const issueArtifactPath = issueRes.stdout.trim();
+            const issueArtifact = await readFile(issueArtifactPath, 'utf-8');
+            assert.match(issueArtifact, /CLAUDE_ARGS:--dangerously-skip-permissions -p Investigate issue #1536 and summarize it/);
+            const genericRes = runRcsCli(wd, ['ask', 'claude', 'Summarize the README'], env);
+            assert.equal(genericRes.status, 0, genericRes.stderr || genericRes.stdout);
+            const genericArtifactPath = genericRes.stdout.trim();
+            const genericArtifact = await readFile(genericArtifactPath, 'utf-8');
+            assert.match(genericArtifact, /CLAUDE_ARGS:-p Summarize the README/);
+            assert.doesNotMatch(genericArtifact, /--dangerously-skip-permissions/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('injects --agent-prompt content into final prompt while keeping Original task raw', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-agent-prompt-'));
+        try {
+            const fakeBin = join(wd, 'bin');
+            const codexHome = join(wd, '.codex-home');
+            const promptsDir = join(codexHome, 'prompts');
+            await mkdir(fakeBin, { recursive: true });
+            await mkdir(promptsDir, { recursive: true });
+            await writeFile(join(promptsDir, 'executor.md'), 'You are Executor.\nFollow strict verification rules.');
+            await writeFile(join(fakeBin, 'claude'), '#!/bin/sh\nif [ \"$1\" = \"--version\" ]; then echo \"fake-claude\"; exit 0; fi\nif [ \"$1\" = \"-p\" ]; then echo \"CLAUDE_FINAL_PROMPT:$2\"; exit 0; fi\necho \"unexpected\" 1>&2\nexit 3\n');
+            await chmod(join(fakeBin, 'claude'), 0o755);
+            const res = runRcsCli(wd, ['ask', 'claude', '--agent-prompt', 'executor', 'ship', 'feature'], { PATH: `${fakeBin}:${process.env.PATH || ''}`, CODEX_HOME: codexHome });
+            if (shouldSkipForSpawnPermissions(res.error))
+                return;
+            assert.equal(res.status, 0, res.stderr || res.stdout);
+            const artifactPath = res.stdout.trim();
+            const artifact = await readFile(artifactPath, 'utf-8');
+            assert.match(artifact, /## Original task\n\nship feature/);
+            assert.match(artifact, /## Final prompt[\s\S]*You are Executor\./);
+            assert.match(artifact, /## Final prompt[\s\S]*Follow strict verification rules\./);
+            assert.match(artifact, /## Final prompt[\s\S]*ship feature/);
+            assert.match(artifact, /CLAUDE_FINAL_PROMPT:/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('fails clearly when --agent-prompt role is missing from prompts directory', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-ask-agent-prompt-missing-'));
+        try {
+            const fakeBin = join(wd, 'bin');
+            const codexHome = join(wd, '.codex-home');
+            const promptsDir = join(codexHome, 'prompts');
+            await mkdir(fakeBin, { recursive: true });
+            await mkdir(promptsDir, { recursive: true });
+            await writeFile(join(fakeBin, 'gemini'), '#!/bin/sh\nif [ \"$1\" = \"--version\" ]; then echo \"fake-gemini\"; exit 0; fi\nif [ \"$1\" = \"-p\" ]; then echo \"should-not-run\"; exit 0; fi\necho \"unexpected\" 1>&2\nexit 4\n');
+            await chmod(join(fakeBin, 'gemini'), 0o755);
+            const res = runRcsCli(wd, ['ask', 'gemini', '--agent-prompt=planner', '--prompt', 'do', 'planning'], { PATH: `${fakeBin}:${process.env.PATH || ''}`, CODEX_HOME: codexHome });
+            if (shouldSkipForSpawnPermissions(res.error))
+                return;
+            assert.equal(res.status, 1, res.stderr || res.stdout);
+            assert.match(res.stderr, /--agent-prompt role "planner" not found/i);
+            assert.doesNotMatch(res.stdout, /should-not-run/);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=ask.test.js.map