@sabaiway/agent-workflow-kit 14.22.0 → 14.24.0

package/bridges/codex-cli-bridge/SKILL.md

@@ -2,7 +2,7 @@
 name: codex-cli-bridge
 description: Delegate work to the OpenAI Codex CLI (`codex`) under a ChatGPT subscription — run plan/instruction EXECUTION in a sandboxed workspace, or get a read-only ADVISORY review of a plan or working-tree diff — as a second delegated-execution backend beside Antigravity. Use when the user wants to hand a bounded coding task or plan to `codex exec`, get a second-opinion review from codex, install or authenticate Codex CLI, understand its sandbox/network/approval policy, drive codex efficiently from the main agent (exec vs review, resume, the commit boundary), bridge project context (`AGENTS.md`) into codex, or troubleshoot codex flags, models, auth, or its no-TTY headless behaviour.
 metadata:
-  version: '4.0.0'
+  version: '5.0.0'
 ---
 
 # codex-cli-bridge
@@ -18,7 +18,8 @@ or a working-tree diff and only emits findings (`codex-review`).
 
 Use this skill when the user wants to:
 
-- Delegate plan or instruction EXECUTION to `codex` in a workspace-write sandbox (network OFF).
+- Delegate plan or instruction EXECUTION to `codex` in a workspace-write sandbox (network to
+  `api.typesafe.ai` and `docs.typesafe.ai` only where the permissions profile `jev` runs, off elsewhere).
 - Get a second-opinion ADVISORY review of an implementation plan or the current diff.
 - Install, authenticate, smoke-test, or troubleshoot `codex`, or understand its sandbox/flags/models.
 - Drive codex efficiently from the main agent (exec vs review, `resume`, the commit boundary).
@@ -39,8 +40,9 @@ binary, run `codex login` once under a ChatGPT subscription, then expose this sk
 print, copy, commit, or package `~/.codex/auth.json` — it is personal and is **never bundled** with
 this skill. Both wrappers enforce the subscription path before invoking codex:
 
-- they **unset every `*_API_KEY`** (plus `OPENAI_API_KEY` / `CODEX_API_KEY` / `OPENAI_BASE_URL`) so a
-  stray key can never silently switch you to paid api-key billing;
+- they **unset `OPENAI_BASE_URL` and every `*_API_KEY` except `TYPESAFE_API_KEY`** (`OPENAI_API_KEY`
+  and `CODEX_API_KEY` included; `TYPESAFE_API_KEY` passes as given) so a stray key can never silently
+  switch you to paid api-key billing;
 - they pass **`--ignore-user-config`** so a personal `~/.codex/config.toml` cannot change model,
   sandbox, or approval behaviour (auth still works — codex reads the login from `CODEX_HOME`
   regardless of that flag);
@@ -97,7 +99,7 @@ waste, never lowering quality. Full knob list: [§ Environment knobs](#environme
 Drive codex only through the two wrappers (installed on `PATH`), run from the target project root:
 
 ```bash
-# EXECUTION (workspace-write sandbox, network OFF, never prompts):
+# EXECUTION (workspace writes; network to api.typesafe.ai and docs.typesafe.ai under the profile `jev`, else off; never prompts):
 codex-exec docs/plans/<slug>.md                 # drive a plan file
 echo "apply review fix: ..." | codex-exec -      # ad-hoc instruction from stdin
 codex-exec <file|-> -- <extra codex flags...>     # GUARDED passthrough after `--` (policy/model/capture flags rejected; some relaxed only under CODEX_PROBE=1)
@@ -109,7 +111,7 @@ echo "now do step 2 ..." | codex-exec --resume <session-id> -
 # ACCOUNTED EXECUTION (the delegation ledger's exec lane — see "Dispatch identity" below):
 codex-exec --nonce <n> docs/plans/<slug>-dispatch.md   # mints a fail-closed exec receipt
 
-# REVIEW (read-only sandbox — codex cannot edit anything, only emits findings):
+# REVIEW (read-only: the profile `jev` with no write entry, or --sandbox read-only — codex only emits findings):
 codex-review plan docs/plans/<slug>.md           # critique a plan
 codex-review code                                # review the current working-tree diff (precomputed)
 codex-review code "focus on the new reducer"     # review with extra focus
@@ -118,12 +120,20 @@ codex-review code "focus on the new reducer"     # review with extra focus
 **Honesty + posture (D4/D5):** a run whose final message has no recognized
 `Verdict: <ship|revise|rethink>` line — empty or missing output included — **exits 4 with NO
 receipt**: treat it as a *failed review to re-run*, never a fatal session error. One stderr banner
-states the actual posture (`review posture: model=… effort=… tier=… source=… timeout=…`) and the
+states the actual posture (`review posture: model=… effort=… tier=… jev=… source=… timeout=…`) and the
 receipt records the same `posture {model, effort, tier}` (tier `null` on the standard tier); control
 bytes in a posture value refuse pre-spend in every mode. `codex-exec` states its posture the same way —
-ONE `exec posture: model=… effort=… tier=… sandbox=workspace-write session=fresh|resume:<id>
-source=… timeout=…` stderr line before dispatch (the resume id validated pre-spend). The `source=`
-field (`model:<s>,effort:<s>`, each `default`, `setting` or `environment`) and the `timeout=` field
+ONE `exec posture: model=… effort=… tier=… sandbox=jev-profile|workspace-write session=fresh|resume:<id>
+jev=… source=… timeout=…` stderr line before dispatch (the resume id validated pre-spend). The `jev=`
+field says what the run reaches: `jev=api.typesafe.ai,docs.typesafe.ai` under the permissions profile `jev`
+(Linux, codex-cli 0.160.0 or newer, for `codex-exec` a repository outside every temp root, a codex
+version and profile digest not recorded as refused), else `jev=unreachable (<reason>)` on today's flags.
+A run whose codex refuses the profile (a profile error before the turn starts, or `bwrap: execvp` in a
+failed command) **exits 72** with no success receipt (a review writes none); a refused profile key is
+recorded in `${XDG_STATE_HOME:-~/.local/state}/agent-workflow/codex-jev-profile-refused` when that file
+can be written, so the next run of that wrapper on that version and digest takes today's flags; a
+`bwrap: execvp` failure records nothing. The `jev=`, `source=` (`model:<s>,effort:<s>`,
+each `default`, `setting` or `environment`) and `timeout=` fields
 are **banner-only** (`timeout=` is exactly the duration handed to `timeout(1)`; on exec `uncapped`
 without a capping binary, while `codex-review` **fails CLOSED pre-spend** there) — informational,
 never a receipt field. **Quote the posture banner verbatim** when labeling a dispatch.
@@ -172,8 +182,9 @@ anything that would defeat a policy is guarded — see [§ Models](#models-the-h
 | `CODEX_REVIEW_SCHEMA` | unset | `codex-review`: `=1` returns findings as a validated JSON object (`--output-schema`), with a raw-text fallback. Default off. |
 | `CODEX_PROBE` | unset | `=1` ⇒ throwaway-probe mode: the one route to a one-off model or effort, and it relaxes the tier-2 passthrough guard (echoed loudly); a probe review's receipt never attests. Never for real work. |
 
-The git-write shim, `--ignore-user-config`, and the `*_API_KEY` scrub are NOT env-tunable — they are
-fixed invariants.
+The git-write shim, `--ignore-user-config`, the key rule (`OPENAI_BASE_URL` and every `*_API_KEY` but
+`TYPESAFE_API_KEY` unset) and the choice between the profile and today's flags are NOT env-tunable —
+they are fixed invariants.
 
 ### Dispatch identity — the accounted exec lane
 
@@ -238,11 +249,17 @@ avoided). And the execution contract tells codex: if the project declares **no**
 set, **STOP and report** rather than invent checks. Pass `--skip-git-repo-check` to codex only when
 you truly mean it.
 
-**The Jev skill in a delegated run.** A `codex-exec` run loads the vendor's Jev skill from the user root the kit's
-`jev-skill` command fills, `~/.agents/skills` — measured 2026-10-02: a run under `--ignore-user-config` listed the
-skills of that root. The run never inherits `TYPESAFE_API_KEY`: the wrappers unset every `*_API_KEY` before codex
-starts. codex exec has no network, so Jev requests are the orchestrator's own, made in the user's environment, and
-their answers are passed into a brief as text.
+**The Jev skill in a delegated run.** A `codex-exec` or `codex-review` run loads the vendor's Jev skill from the
+user root the kit's `jev-skill` command fills, `~/.agents/skills` (a run under `--ignore-user-config` listed its
+skills, measured 2026-10-02; `codex-review` links that root into its fence home), and `TYPESAFE_API_KEY` passes the
+wrappers as given while every other `*_API_KEY` is unset. On Linux with codex-cli 0.160.0 or newer, off a codex
+version and profile digest recorded as refused and, for `codex-exec`, from a repository outside every temp root, the
+run carries the permissions profile `jev`: it reaches `api.typesafe.ai` and `docs.typesafe.ai` and no other host, a review still
+writes nothing, and the banner reads `jev=api.typesafe.ai,docs.typesafe.ai`; anywhere else the run keeps today's
+flags with network off and the banner says `jev=unreachable (<reason>)`. Two residuals stand: codex's server-side
+`web_search` reaches pages outside the profile, and the key now sits in every run's environment, the `web_search`
+channel included. A codex release that stops recognizing a profile key costs one run per version and profile digest
+(exit 72), while the state file can be written, before the recorded fallback takes over.
 
 ## How the main agent drives `codex` efficiently
 
@@ -263,11 +280,12 @@ See [`references/driving-codex.md`](references/driving-codex.md) for the full pl
   resume entrypoint re-establishes EVERY wrapper invariant (subscription-only, `--ignore-user-config`,
   the host posture's model/effort) and **restates the full posture via `-c`** — `codex exec resume` resets the
   sandbox/approval/network posture and rejects the `-s`/`--add-dir`/`-C` posture flags, so the wrapper
-  sets `sandbox_mode=workspace-write` + `approval_policy=never` +
-  `sandbox_workspace_write.network_access=false` explicitly. It reads the session id from the sidecar
-  (`--resume-last`) or takes it as an argument.
-- **Network is OFF in exec.** New dependencies and any network step are installed by hand, then codex
-  is re-dispatched.
+  sets `approval_policy=never` and the run's own posture explicitly — the profile `jev`'s four overrides,
+  or `sandbox_mode=workspace-write` + `sandbox_workspace_write.network_access=false` — chosen afresh on
+  each resume. It reads the session id from the sidecar (`--resume-last`) or takes it as an argument.
+- **Network: two hosts at most in exec.** Under the profile `jev` a run reaches `api.typesafe.ai` and
+  `docs.typesafe.ai` only; under today's flags none. New dependencies and any other network step are
+  installed by hand, then codex is re-dispatched.
 - **`codex-review code` precomputes the diff.** The wrapper assembles the change set (repo map, status,
   staged + unstaged diff, untracked file contents) and feeds it in, so codex does not roam the
   filesystem rediscovering it; a clean tree exits 0 before a run is spent. Native `codex review` is
@@ -293,8 +311,10 @@ The wrappers work in any git repo where `codex` is installed and authenticated.
 
 ## Known limitations
 
-- **Network is OFF** in `codex-exec` (`sandbox_workspace_write.network_access=false`): codex cannot
-  install dependencies or reach the network — do that by hand, then re-dispatch.
+- **Network: two hosts at most** in `codex-exec` — the profile `jev` reaches `api.typesafe.ai` and
+  `docs.typesafe.ai` only, today's flags (`sandbox_workspace_write.network_access=false`) none: codex
+  cannot install dependencies — do that by hand, then re-dispatch. The profile runs only on Linux with
+  codex-cli 0.160.0 or newer; Windows and macOS keep today's flags until its round-trip is probed there.
 - **No live approvals** — `codex exec` has no TTY, so `approval_policy=never`; an action that would
   need escalation is reported, not approved interactively.
 - **`resume` resets the posture** — `codex exec resume` rejects `-s`/`--add-dir`/`-C` and forgets the

package/bridges/codex-cli-bridge/bin/codex-exec-jev.test.mjs

@@ -0,0 +1,385 @@
+// codex-exec-jev.test.mjs — spec jev-every-run on codex-exec: the shared key rule, the posture the wrapper chooses
+// (the jev permissions profile or today's flags), the loud failure, the banner, the directive and the probe
+// passthrough. Standalone harness with its own fake codex and a fake uname.
+import { describe, it, after } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdirSync, mkdtempSync, writeFileSync, readFileSync, existsSync, rmSync, cpSync, chmodSync, realpathSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const EXEC = join(HERE, 'codex-exec.sh');
+const HOSTS = 'api.typesafe.ai,docs.typesafe.ai';
+// The repositories sit outside every temp root: under the package's node_modules, TMPDIR their sibling, never an ancestor.
+const FIXTURES = join(HERE, '..', 'node_modules', '.aw-fixtures');
+const TMP = join(FIXTURES, 'tmp');
+mkdirSync(TMP, { recursive: true });
+mkdirSync(join(FIXTURES, 'repos'), { recursive: true });
+const ROOT = mkdtempSync(join(FIXTURES, 'repos', 'exec-jev-'));
+after(() => rmSync(ROOT, { recursive: true, force: true }));
+const REAL_UNAME = spawnSync('bash', ['-c', 'type -P uname'], { encoding: 'utf8' }).stdout.trim();
+
+// Every spawn of the CLI appends one line: its kind and the state of each key ([value] or unset).
+const FAKE_CODEX = [
+  '#!/usr/bin/env bash',
+  'set -u',
+  'st() { if [[ -n "${!1+x}" ]]; then printf "[%s]" "${!1}"; else printf unset; fi; }',
+  'rec() { echo "$1 key=$(st TYPESAFE_API_KEY) openai=$(st OPENAI_API_KEY) codex=$(st CODEX_API_KEY) foo=$(st FOO_API_KEY) base=$(st OPENAI_BASE_URL)" >>"$CODEX_FAKE_LOG"; }',
+  'case "${1:-}" in',
+  '  login) rec login; echo "Logged in using ChatGPT"; exit 0 ;;',
+  '  --version) rec version; echo "${CODEX_FAKE_VERSION-codex-cli 0.160.0}"; exit 0 ;;',
+  '  debug) rec catalog; cat <<EOF',
+  '{"models":[{"slug":"gpt-6.1-sol","priority":1,"visibility":"list","default_reasoning_level":"low","supported_reasoning_levels":[{"effort":"low"},{"effort":"medium"},{"effort":"high"}]}]}',
+  'EOF',
+  '    exit 0 ;;',
+  'esac',
+  'rec run',
+  '{ for a in "$@"; do echo "$a"; done; } >"$CODEX_FAKE_ARGV"',
+  'cat >"$CODEX_FAKE_STDIN"',
+  'out=""; prev=""; for a in "$@"; do if [[ "$prev" == "-o" ]]; then out="$a"; fi; prev="$a"; done',
+  'if [[ -n "$out" ]]; then echo "${CODEX_FAKE_FINAL:-FAKE_FINAL}" >"$out"; fi',
+  'echo "{\\"type\\":\\"thread.started\\",\\"thread_id\\":\\"sess-jev\\"}"',
+  'if [[ -n "${CODEX_FAKE_PRE:-}" ]]; then echo "$CODEX_FAKE_PRE"; fi',
+  'echo "{\\"type\\":\\"turn.started\\"}"',
+  'if [[ -n "${CODEX_FAKE_POST:-}" ]]; then echo "$CODEX_FAKE_POST"; fi',
+  'echo "{\\"type\\":\\"turn.completed\\",\\"usage\\":{}}"',
+  'exit "${CODEX_FAKE_EXIT:-0}"',
+  '',
+].join('\n');
+const FAKE_UNAME = ['#!/usr/bin/env bash', 'if [[ $# -eq 0 || "$1" == "-s" ]]; then echo "${CODEX_FAKE_UNAME:-Linux}"; exit 0; fi',
+  `exec "${REAL_UNAME}" "$@"`, ''].join('\n');
+const CONTRACT = '# dispatch\n\n```aw-dispatch-contract\n{"nonce":"n1","scope":"probe"}\n```\n';
+
+const initRepo = (repo) => {
+  mkdirSync(repo, { recursive: true });
+  const git = (...args) => spawnSync('git', args, { cwd: repo, encoding: 'utf8' });
+  git('init', '-q');
+  git('config', 'user.email', 'probe@example.com');
+  git('config', 'user.name', 'probe');
+  writeFileSync(join(repo, 'AGENTS.md'), '# AGENTS\n\nHard Constraints: none (test fixture).\n');
+  git('add', '-A');
+  git('commit', '-qm', 'base');
+  writeFileSync(join(repo, 'task.md'), CONTRACT);
+};
+const TEMPLATE = join(ROOT, 'template');
+mkdirSync(join(TEMPLATE, 'bin'), { recursive: true });
+mkdirSync(join(TEMPLATE, 'home'));
+writeFileSync(join(TEMPLATE, 'bin', 'codex'), FAKE_CODEX);
+writeFileSync(join(TEMPLATE, 'bin', 'uname'), FAKE_UNAME);
+initRepo(join(TEMPLATE, 'repo'));
+
+let sequence = 0;
+const sandbox = () => {
+  const dir = join(ROOT, `sb-${++sequence}`);
+  cpSync(TEMPLATE, dir, { recursive: true });
+  for (const name of ['codex', 'uname']) chmodSync(join(dir, 'bin', name), 0o755);
+  return { dir, bin: join(dir, 'bin'), home: join(dir, 'home'), repo: join(dir, 'repo'),
+    state: join(dir, 'home', '.local', 'state', 'agent-workflow', 'codex-jev-profile-refused') };
+};
+const drive = (sb, args, env = {}, cwd = sb.repo) => {
+  const cap = (name) => join(sb.dir, name);
+  for (const name of ['log', 'argv', 'stdin']) rmSync(cap(name), { force: true });
+  const r = spawnSync('bash', [EXEC, ...args], {
+    cwd, input: 'do the thing', encoding: 'utf8', timeout: 60000,
+    env: { PATH: `${sb.bin}:${process.env.PATH}`, HOME: sb.home, TMPDIR: TMP, CODEX_FAKE_LOG: cap('log'),
+      CODEX_FAKE_ARGV: cap('argv'), CODEX_FAKE_STDIN: cap('stdin'), ...env },
+  });
+  const read = (name) => (existsSync(cap(name)) ? readFileSync(cap(name), 'utf8') : '');
+  return { status: r.status, stdout: r.stdout, stderr: r.stderr, log: read('log'), argv: read('argv').split('\n').slice(0, -1),
+    prompt: read('stdin').replace(/\s+/g, ' ') };
+};
+
+// -c key=value pairs of the run's argv, and a reader for the TOML inline tables a profile override carries.
+const overrides = (argv) => Object.fromEntries(argv.flatMap((arg, i) => (argv[i - 1] === '-c'
+  ? [[arg.slice(0, arg.indexOf('=')), arg.slice(arg.indexOf('=') + 1)]] : [])));
+const inline = (text) => {
+  let at = 0;
+  const eat = (re) => {
+    const m = re.exec(text.slice(at));
+    assert.ok(m, `an inline table: ${text}`);
+    at += m[0].length;
+    return m;
+  };
+  const value = () => {
+    if (eat(/^\s*(\{?)/)[1] === '') return eat(/^"([^"]*)"|^([\w.:-]+)/).slice(1).find((part) => part !== undefined);
+    const table = {};
+    while (eat(/^\s*(\}?)/)[1] === '') {
+      const key = value();
+      eat(/^\s*=/);
+      table[key] = value();
+      eat(/^\s*,?/);
+    }
+    return table;
+  };
+  const parsed = value();
+  assert.equal(text.slice(at).trim(), '', `nothing after the inline table: ${text}`);
+  return parsed;
+};
+const EXEC_FS = { ':root': 'read', ':tmpdir': 'write', ':slash_tmp': 'write', ':workspace_roots': { '.': 'write' } };
+const PROFILE_KEYS = ['default_permissions', 'permissions.jev.filesystem', 'permissions.jev.network.domains', 'permissions.jev.network.enabled'];
+const profileKeys = (c) => Object.keys(c).filter((key) => key === 'default_permissions' || key.startsWith('permissions.')).sort();
+const assertProfile = (r) => {
+  assert.equal(r.status, 0, r.stderr);
+  const c = overrides(r.argv);
+  assert.deepEqual(profileKeys(c), PROFILE_KEYS, r.argv.join(' '));
+  assert.equal(c.default_permissions.replace(/^"(.*)"$/, '$1'), 'jev');
+  assert.equal(c['permissions.jev.network.enabled'], 'true');
+  assert.deepEqual(inline(c['permissions.jev.network.domains']), { 'api.typesafe.ai': 'allow', 'docs.typesafe.ai': 'allow' });
+  assert.deepEqual(inline(c['permissions.jev.filesystem']), EXEC_FS);
+  assert.equal(r.argv.includes('--sandbox') || 'sandbox_mode' in c, false, 'neither --sandbox nor sandbox_mode beside the profile');
+};
+const assertFallback = (r) => {
+  assert.equal(r.status, 0, r.stderr);
+  const c = overrides(r.argv);
+  assert.deepEqual(profileKeys(c), [], r.argv.join(' '));
+  assert.ok(r.argv[r.argv.indexOf('--sandbox') + 1] === 'workspace-write' || c.sandbox_mode === 'workspace-write', r.argv.join(' '));
+  assert.equal(c['sandbox_workspace_write.network_access'], 'false');
+};
+const bannerOf = (r) => r.stderr.split('\n').find((line) => line.startsWith('exec posture: ')) ?? '';
+const banner = (sandboxValue, jev, session = 'fresh') => 'exec posture: model=gpt-6.1-sol effort=high tier=standard '
+  + `sandbox=${sandboxValue} session=${session} jev=${jev} source=model:default,effort:default timeout=3600s`;
+const unreachable = (reason) => banner('workspace-write', `unreachable (${reason})`);
+const KEYS = { TYPESAFE_API_KEY: 'jev-key', OPENAI_API_KEY: 'sk-live', CODEX_API_KEY: 'ck', FOO_API_KEY: 'foo', OPENAI_BASE_URL: 'http://proxy' };
+const PASSED = 'key=[jev-key] openai=unset codex=unset foo=unset base=unset';
+const spawnsOf = (r) => r.log.split('\n').filter(Boolean).map((line) => [line.slice(0, line.indexOf(' ')), line.slice(line.indexOf(' ') + 1)]);
+const runEnv = (r) => (spawnsOf(r).find(([kind]) => kind === 'run') ?? [])[1];
+const item = (body) => JSON.stringify({ type: 'item.completed', item: body });
+const P13_TEXT = 'Configured filesystem path `:slash_tmp` is not recognized by this version of Codex and will be ignored. Upgrade Codex if this path is required.';
+const P13 = item({ id: 'item_0', type: 'error', message: P13_TEXT });
+const P1 = item({ id: 'item_0', type: 'error', message: 'Permissions profile `jev` does not define any recognized filesystem entries for this version of Codex. Filesystem access will remain restricted.' });
+const OTHER_SHAPE = item({ id: 'item_0', type: 'error', message: 'Unknown configuration key `permissions.jev.network.mode`.' });
+const command = (output, exitCode, status) => item({ id: 'item_1', type: 'command_execution', command: 'bash -lc ls', aggregated_output: output, exit_code: exitCode, status });
+const BWRAP = 'bwrap: execvp /usr/lib/node_modules/@openai/codex/vendor/x86_64-unknown-linux-musl/bin/codex: No such file or directory\n';
+const receiptOf = (sb) => JSON.parse(readFileSync(join(sb.repo, '.git', 'agent-workflow-exec-receipt-5-codex-n1.json'), 'utf8'));
+const RECEIPT_KEYS = ['schema', 'kind', 'state', 'backend', 'nonce', 'owner', 'contractDigest', 'wrapperVersion', 'posture', 'capS',
+  'killGraceS', 'sessionId', 'exitStatus', 'outcome', 'reportDigest', 'reportLength', 'timestamp'];
+const stateLines = (sb) => (existsSync(sb.state) ? readFileSync(sb.state, 'utf8').split('\n').filter(Boolean) : []);
+
+describe('the key rule on codex-exec — spec:jev-every-run/S1', () => {
+  it('a fresh run hands codex only TYPESAFE_API_KEY of the keys, and the login, version and catalog spawns see the same env', () => {
+    const r = drive(sandbox(), ['-'], KEYS);
+    assert.equal(r.status, 0, r.stderr);
+    assert.deepEqual([...new Set(spawnsOf(r).map(([kind]) => kind))].sort(), ['catalog', 'login', 'run', 'version'], r.log);
+    for (const [kind, env] of spawnsOf(r)) assert.equal(env, PASSED, `${kind} spawn`);
+  });
+});
+
+describe('a resumed run — spec:jev-every-run/S2', () => {
+  it('keeps the key rule and carries the profile overrides with no sandbox_mode', () => {
+    const r = drive(sandbox(), ['--resume', 'sess-1', '-'], KEYS);
+    assertProfile(r);
+    assert.deepEqual(r.argv.slice(0, 3), ['exec', 'resume', 'sess-1']);
+    for (const [kind, env] of spawnsOf(r)) assert.equal(env, PASSED, `${kind} spawn`);
+  });
+});
+
+describe('an empty key and an unset key — spec:jev-every-run/S5', () => {
+  it('an empty TYPESAFE_API_KEY reaches codex empty, an unset one stays unset, and the argv is the same with the key set', () => {
+    const runs = ['jev-key', '', undefined].map((value) => drive(sandbox(), ['-'], { TYPESAFE_API_KEY: value }));
+    assert.deepEqual(runs.map((r) => runEnv(r)?.split(' ')[0]), ['key=[jev-key]', 'key=[]', 'key=unset']);
+    const normalized = runs.map((r) => r.argv.map((arg, i) => (r.argv[i - 1] === '-o' ? '<out>' : arg)).join(' '));
+    assert.equal(normalized[1], normalized[0]);
+    assert.equal(normalized[2], normalized[0]);
+    assertProfile(runs[0]);
+  });
+});
+
+describe('the exec profile on Linux from codex-cli 0.160.0 — spec:jev-every-run/S7', () => {
+  for (const version of ['0.160.0', '0.161.0', '1.0.0']) {
+    it(`codex-cli ${version}: the exec profile exactly, neither --sandbox nor sandbox_mode`, () => {
+      assertProfile(drive(sandbox(), ['-'], { CODEX_FAKE_VERSION: `codex-cli ${version}` }));
+    });
+  }
+});
+
+describe('the fallback by OS and by temp root — spec:jev-every-run/S9', () => {
+  it('a uname other than Linux runs today\'s flags with the key passed and names the reason', () => {
+    const r = drive(sandbox(), ['-'], { ...KEYS, CODEX_FAKE_UNAME: 'Darwin' });
+    assertFallback(r);
+    assert.equal(runEnv(r), PASSED);
+    assert.equal(bannerOf(r), unreachable('not linux (Darwin)'));
+  });
+  it('a repository root under the realpath of TMPDIR falls back; a sibling sharing its name prefix does not', () => {
+    const sb = sandbox();
+    const root = join(sb.dir, 'pfx');
+    cpSync(sb.repo, join(root, 'repo'), { recursive: true });
+    const under = drive(sb, ['-'], { ...KEYS, TMPDIR: root }, join(root, 'repo'));
+    assertFallback(under);
+    assert.equal(runEnv(under), PASSED);
+    assert.equal(bannerOf(under), unreachable(`repository under ${realpathSync(root)}`));
+    cpSync(sb.repo, join(sb.dir, 'pfx-repo'), { recursive: true });
+    assertProfile(drive(sb, ['-'], { TMPDIR: root }, join(sb.dir, 'pfx-repo')));
+  });
+  it('a worktree whose git common dir is under TMPDIR falls back', () => {
+    const sb = sandbox();
+    const root = join(sb.dir, 'tmproot');
+    cpSync(sb.repo, join(root, 'main'), { recursive: true });
+    spawnSync('git', ['worktree', 'add', '-q', join(sb.dir, 'wt')], { cwd: join(root, 'main'), encoding: 'utf8' });
+    writeFileSync(join(sb.dir, 'wt', 'task.md'), CONTRACT);
+    const r = drive(sb, ['-'], { TMPDIR: root }, join(sb.dir, 'wt'));
+    assertFallback(r);
+    assert.equal(bannerOf(r), unreachable(`repository under ${realpathSync(root)}`));
+    // A git older than 2.31 echoes an unknown --path-format=… as its own line before the answer.
+    const realGit = spawnSync('bash', ['-c', 'command -v git'], { encoding: 'utf8' }).stdout.trim();
+    writeFileSync(join(sb.bin, 'git'), ['#!/usr/bin/env bash', 'args=()', 'for a in "$@"; do',
+      '  if [[ "$a" == --path-format=* ]]; then echo "$a"; else args+=("$a"); fi', 'done', `exec ${realGit} "\${args[@]}"`, ''].join('\n'));
+    chmodSync(join(sb.bin, 'git'), 0o755);
+    const old = drive(sb, ['-'], { TMPDIR: root }, join(sb.dir, 'wt'));
+    assertFallback(old);
+    assert.equal(bannerOf(old), unreachable(`repository under ${realpathSync(root)}`));
+  });
+  it('a repository under /tmp falls back naming /tmp', () => {
+    const repo = mkdtempSync(join(tmpdir(), 'exec-jev-tmp-'));
+    try {
+      cpSync(join(TEMPLATE, 'repo'), repo, { recursive: true });
+      const underTmp = realpathSync(repo).startsWith(`${realpathSync('/tmp')}/`);
+      const r = drive(sandbox(), ['-'], { TMPDIR: underTmp ? TMP : tmpdir() }, repo);
+      assertFallback(r);
+      assert.equal(bannerOf(r), unreachable(`repository under ${underTmp ? '/tmp' : realpathSync(tmpdir())}`));
+    } finally {
+      rmSync(repo, { recursive: true, force: true });
+    }
+  });
+});
+
+describe('the fallback by version and by the refused record — spec:jev-every-run/S10', () => {
+  const cases = [['codex-cli 0.159.0', 'codex 0.159.0 below 0.160.0'], ['codex-cli 0.160.0-alpha.1', 'codex 0.160.0-alpha.1 below 0.160.0'],
+    ['codex-cli', 'codex version unreadable']];
+  for (const [line, reason] of cases) {
+    it(`a version line '${line}' runs today's flags with the key passed: ${reason}`, () => {
+      const r = drive(sandbox(), ['-'], { ...KEYS, CODEX_FAKE_VERSION: line });
+      assertFallback(r);
+      assert.equal(runEnv(r), PASSED);
+      assert.equal(bannerOf(r), unreachable(reason));
+    });
+  }
+  it('a listed version with this run\'s digest falls back naming the file; another digest or another version runs the profile', () => {
+    const sb = sandbox();
+    assert.equal(drive(sb, ['-'], { CODEX_FAKE_PRE: P13 }).status, 72);
+    const [entry] = stateLines(sb);
+    assert.match(entry ?? '', /^0\.160\.0 [0-9a-f]{64}$/);
+    const refused = drive(sb, ['-'], KEYS);
+    assertFallback(refused);
+    assert.equal(runEnv(refused), PASSED);
+    assert.ok(bannerOf(refused).includes('jev=unreachable (profile not recognized by codex 0.160.0'), bannerOf(refused));
+    assert.ok(bannerOf(refused).includes(sb.state), 'the banner reason names the file');
+    for (const other of [`0.160.0 ${'a'.repeat(64)}`, `0.161.0 ${entry.split(' ')[1]}`]) {
+      writeFileSync(sb.state, `${other}\n`);
+      assertProfile(drive(sb, ['-']));
+    }
+  });
+});
+
+describe('the profile error item before the turn — spec:jev-every-run/S11', () => {
+  for (const [label, shape] of [['the P13 shape', P13], ['the P1 shape', P1]]) {
+    it(`${label}, printed twice before turn.started: exit 72, one entry appended, a transport-failure receipt`, () => {
+      const sb = sandbox();
+      const r = drive(sb, ['--nonce', 'n1', 'task.md'], { CODEX_FAKE_PRE: `${shape}\n${shape}` });
+      assert.equal(r.status, 72, r.stderr);
+      assert.ok(r.stderr.includes(JSON.parse(shape).item.message), 'the matched message is printed');
+      assert.doesNotMatch(r.stderr, /update codex/i);
+      assert.doesNotMatch(r.stdout, /FAKE_FINAL/, 'no final message is printed');
+      assert.equal(stateLines(sb).length, 1);
+      assert.match(stateLines(sb)[0], /^0\.160\.0 [0-9a-f]{64}$/);
+      assert.equal(statSync(dirname(sb.state)).mode & 0o777, 0o700);
+      assert.equal(receiptOf(sb).outcome, 'transport-failure');
+    });
+  }
+  for (const [label, env] of [['after turn.started', { CODEX_FAKE_POST: P13 }], ['in another shape', { CODEX_FAKE_PRE: OTHER_SHAPE }]]) {
+    it(`${label}: the run ends as today and nothing is appended`, () => {
+      const sb = sandbox();
+      const r = drive(sb, ['-'], env);
+      assertProfile(r);
+      assert.equal(existsSync(sb.state), false);
+    });
+  }
+  it('a failed write warns once naming the path and still exits 72 with its receipt', () => {
+    const sb = sandbox();
+    mkdirSync(dirname(dirname(sb.state)), { recursive: true });
+    writeFileSync(dirname(sb.state), 'a file where the state directory belongs\n');
+    const r = drive(sb, ['--nonce', 'n1', 'task.md'], { CODEX_FAKE_PRE: P13 });
+    assert.equal(r.status, 72, r.stderr);
+    assert.equal(r.stderr.split('\n').filter((line) => line.includes(sb.state)).length, 1, r.stderr);
+    assert.equal(receiptOf(sb).outcome, 'transport-failure');
+  });
+});
+
+describe('bwrap: execvp in a failed command — spec:jev-every-run/S12', () => {
+  it('exits 72 without touching the state file', () => {
+    const sb = sandbox();
+    const r = drive(sb, ['--nonce', 'n1', 'task.md'], { CODEX_FAKE_POST: command(BWRAP, 1, 'failed') });
+    assert.equal(r.status, 72, r.stderr);
+    assert.ok(r.stderr.includes('bwrap: execvp'), r.stderr);
+    assert.equal(existsSync(sb.state), false);
+    assert.equal(receiptOf(sb).outcome, 'transport-failure');
+  });
+});
+
+describe('the same strings where they never fire — spec:jev-every-run/S13', () => {
+  it('inside a successful command\'s output and in the final message: exit 0, a success receipt, no state file', () => {
+    const sb = sandbox();
+    const r = drive(sb, ['--nonce', 'n1', 'task.md'], { CODEX_FAKE_POST: command(`${P13_TEXT}\n${BWRAP}`, 0, 'completed'),
+      CODEX_FAKE_FINAL: `${P13_TEXT} ${BWRAP}` });
+    assertProfile(r);
+    assert.ok(r.stdout.includes(P13_TEXT));
+    assert.equal(receiptOf(sb).outcome, 'success');
+    assert.equal(existsSync(sb.state), false);
+  });
+});
+
+describe('the exec banner and the receipt — spec:jev-every-run/S14', () => {
+  it('a profile run reads sandbox=jev-profile and the two hosts before source=, the receipt keys unchanged', () => {
+    const sb = sandbox();
+    const r = drive(sb, ['--nonce', 'n1', 'task.md']);
+    assertProfile(r);
+    assert.equal(bannerOf(r), banner('jev-profile', HOSTS));
+    assert.deepEqual(Object.keys(receiptOf(sb)), RECEIPT_KEYS);
+    assert.deepEqual(Object.keys(receiptOf(sb).posture), ['model', 'effort', 'tier']);
+  });
+  it('a fallback run reads sandbox=workspace-write and jev=unreachable, timeout= last', () => {
+    const r = drive(sandbox(), ['--resume', 'sess-1', '-'], { CODEX_FAKE_VERSION: 'codex-cli 0.159.0' });
+    assert.equal(bannerOf(r), banner('workspace-write', 'unreachable (codex 0.159.0 below 0.160.0)', 'resume:sess-1'));
+  });
+});
+
+describe('the execution directive and the resume reminder — spec:jev-every-run/S17', () => {
+  const HOST_LINE = 'the hosts api.typesafe.ai and docs.typesafe.ai are reachable; network access to any other host is an escalation: STOP and report';
+  it('a fresh profile run names the two hosts and the other-host escalation; a fallback run keeps network access whole', () => {
+    const profile = drive(sandbox(), ['-']);
+    assertProfile(profile);
+    assert.ok(profile.prompt.includes(HOST_LINE), profile.prompt);
+    const fallback = drive(sandbox(), ['-'], { CODEX_FAKE_UNAME: 'Darwin' });
+    assert.ok(fallback.prompt.includes('escalation (network access, writes outside the repo'), fallback.prompt);
+    assert.doesNotMatch(fallback.prompt, /typesafe/);
+  });
+  it('a resume states its current posture: the hosts on a profile run, network access on the next run of the same session that falls back', () => {
+    const sb = sandbox();
+    const profile = drive(sb, ['--resume', 'sess-1', '-']);
+    assertProfile(profile);
+    assert.ok(profile.prompt.includes(HOST_LINE), profile.prompt);
+    const fallback = drive(sb, ['--resume', 'sess-1', '-'], { CODEX_FAKE_UNAME: 'Darwin' });
+    assertFallback(fallback);
+    assert.match(fallback.prompt, /network access/);
+    assert.doesNotMatch(fallback.prompt, /typesafe/);
+  });
+});
+
+describe('the probe passthrough under the profile — spec:jev-every-run/S18', () => {
+  for (const flag of [['--add-dir', '/x'], ['-C', '/x'], ['--cd', '/x'], ['--enable', 'foo'], ['--disable', 'foo']]) {
+    it(`CODEX_PROBE=1 with ${flag[0]}: refused pre-spend under the profile, admitted under the fallback`, () => {
+      const refused = drive(sandbox(), ['-', '--', ...flag], { CODEX_PROBE: '1' });
+      assert.equal(refused.status, 2, refused.stderr);
+      assert.equal(spawnsOf(refused).some(([kind]) => kind === 'run'), false, 'no run is spent');
+      const admitted = drive(sandbox(), ['-', '--', ...flag], { CODEX_PROBE: '1', CODEX_FAKE_UNAME: 'Darwin' });
+      assertFallback(admitted);
+      assert.ok(admitted.argv.includes(flag[0]), admitted.argv.join(' '));
+    });
+  }
+  it('exactly these five: --ignore-rules stays admitted under the profile', () => {
+    const r = drive(sandbox(), ['-', '--', '--ignore-rules'], { CODEX_PROBE: '1' });
+    assertProfile(r);
+    assert.ok(r.argv.includes('--ignore-rules'));
+  });
+});