@nurix/etna 0.19.22 → 0.19.23

package/lib/codex/gen-agents.mjs

@@ -1,157 +0,0 @@
-// packages/cli/lib/codex/gen-agents.mjs
-// AUTHORING-TIME generator — runs ON A LAPTOP with the Codex CLI installed and
-// authenticated, NEVER in CI. For each Claude subagent (agents/<name>.md in the
-// shared catalog, plus harness/*/agents/*.md with --include-harness) it runs
-// `codex exec` to translate the markdown into an OpenAI Codex subagent TOML and
-// writes a committed sibling agents/<name>.codex.toml. The shippers (build-data.js,
-// publish.mjs) then carry those committed files; the installer copies them into a
-// consumer's .codex/agents/ with no Codex CLI required downstream.
-//
-// Usage:
-//   node packages/cli/lib/codex/gen-agents.mjs            # shared catalog, only stale/missing
-//   node packages/cli/lib/codex/gen-agents.mjs --force    # regenerate all shared agents
-//   node packages/cli/lib/codex/gen-agents.mjs --include-harness  # + harness/*/agents/*.md
-
-import {
-    existsSync,
-    readdirSync,
-    readFileSync,
-    writeFileSync,
-    statSync,
-} from 'node:fs';
-import { dirname, join, resolve, basename } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const repoRoot = resolve(__dirname, '..', '..', '..', '..');
-
-// Pinned conversion prompt — deterministic instructions so re-runs stay stable.
-// Codex does the semantic md→toml; the body is copied verbatim, tools are dropped
-// (no Codex equivalent) and recorded in a leading comment.
-const CONVERSION_PROMPT = [
-    'Convert the Claude Code subagent definition provided on stdin into an OpenAI Codex subagent TOML document.',
-    'Output ONLY the raw TOML — no prose, no markdown code fences, nothing before or after.',
-    'Set `name` from the frontmatter `name`.',
-    'Set `description` as a TOML basic string (double quotes) from the frontmatter `description`, escaping any interior double-quote as \\".',
-    'Put the ENTIRE markdown body (everything after the closing frontmatter ---) VERBATIM into a TOML multi-line',
-    "LITERAL string delimited by triple SINGLE quotes: developer_instructions = '''<body>'''.",
-    'A literal string is verbatim — do NOT escape anything inside it, and do NOT use triple double-quotes (backslashes like \\s in the body must survive unchanged).',
-    'If frontmatter `model` is a real model id, set `model`; if it is `inherit`, omit `model`.',
-    'If frontmatter has a `tools:` line, do NOT translate it — instead put a single comment line',
-    '`# dropped Claude tools: <the list>` as the first line of the file.',
-    'Emit no keys other than name, description, model (optional), developer_instructions.',
-].join(' ');
-
-const args = process.argv.slice(2);
-const force = args.includes('--force');
-const includeHarness = args.includes('--include-harness');
-
-function die(msg) {
-    console.error(`gen-codex-agents: ${msg}`);
-    process.exit(1);
-}
-
-// Codex must be present + authenticated — this step cannot run in CI.
-function assertCodexReady() {
-    const which = spawnSync('codex', ['--version'], { encoding: 'utf8' });
-    if (which.status !== 0) {
-        die('the `codex` CLI is not installed / not on PATH. This generator runs only on an authoring laptop.');
-    }
-}
-
-// Every agents/<name>.md to convert: the shared catalog, plus harness-owned agents on request.
-function collectAgentFiles() {
-    const files = [];
-    const shared = join(repoRoot, 'agents');
-    if (existsSync(shared)) {
-        for (const f of readdirSync(shared)) {
-            if (f.endsWith('.md')) files.push(join(shared, f));
-        }
-    }
-    if (includeHarness) {
-        const harnessDir = join(repoRoot, 'harness');
-        if (existsSync(harnessDir)) {
-            for (const harness of readdirSync(harnessDir)) {
-                if (harness === 'common') continue; // not a harness — the shared root-files folder
-                const agentsDir = join(harnessDir, harness, 'agents');
-                if (!existsSync(agentsDir)) continue;
-                for (const f of readdirSync(agentsDir)) {
-                    if (f.endsWith('.md')) files.push(join(agentsDir, f));
-                }
-            }
-        }
-    }
-    return files.sort();
-}
-
-// A regen is due when forced, the toml is missing, or the md is newer than the toml.
-function needsRegen(mdPath, tomlPath) {
-    if (force || !existsSync(tomlPath)) return true;
-    return statSync(mdPath).mtimeMs > statSync(tomlPath).mtimeMs;
-}
-
-// Strip an accidental ```toml fence if the model wrapped its output despite the prompt.
-function stripFences(text) {
-    const trimmed = text.trim();
-    const fence = trimmed.match(/^```(?:toml)?\n([\s\S]*?)\n```$/);
-    return (fence ? fence[1] : trimmed) + '\n';
-}
-
-// Validate that the produced TOML parses. Uses python3's tomllib when present
-// (returns true/error string); returns null when python3 is unavailable so the
-// caller proceeds best-effort rather than hard-failing on a missing dev tool.
-function tomlError(toml) {
-    const res = spawnSync('python3', ['-c', 'import tomllib,sys; tomllib.loads(sys.stdin.read())'], {
-        input: toml,
-        encoding: 'utf8',
-    });
-    if (res.error && res.error.code === 'ENOENT') return null;
-    return res.status === 0 ? '' : (res.stderr || 'invalid TOML').trim();
-}
-
-function convert(mdPath) {
-    const md = readFileSync(mdPath, 'utf8');
-    const res = spawnSync('codex', ['exec', '--sandbox', 'read-only', CONVERSION_PROMPT], {
-        input: md,
-        encoding: 'utf8',
-        maxBuffer: 32 * 1024 * 1024,
-    });
-    if (res.status !== 0) {
-        throw new Error(`codex exec failed for ${mdPath}: ${(res.stderr || '').slice(-400)}`);
-    }
-    const toml = stripFences(res.stdout || '');
-    if (!/^\s*name\s*=/m.test(toml)) {
-        throw new Error(`codex output for ${mdPath} has no \`name =\` key — refusing to write. Got:\n${toml.slice(0, 200)}`);
-    }
-    const err = tomlError(toml);
-    if (err) {
-        throw new Error(`codex output for ${mdPath} is not valid TOML — refusing to write:\n${err.slice(0, 300)}`);
-    }
-    return toml;
-}
-
-assertCodexReady();
-const files = collectAgentFiles();
-if (!files.length) die('no agents/*.md found to convert.');
-
-let wrote = 0;
-let skipped = 0;
-for (const mdPath of files) {
-    const name = basename(mdPath, '.md');
-    const tomlPath = join(dirname(mdPath), `${name}.codex.toml`);
-    if (!needsRegen(mdPath, tomlPath)) {
-        skipped += 1;
-        continue;
-    }
-    process.stdout.write(`converting ${name} … `);
-    try {
-        writeFileSync(tomlPath, convert(mdPath));
-        wrote += 1;
-        console.log('ok');
-    } catch (e) {
-        console.log('FAILED');
-        console.error(`  ${e.message}`);
-    }
-}
-console.log(`\ngen-codex-agents: wrote ${wrote}, skipped ${skipped} (up-to-date) of ${files.length} agent(s).`);