@junghanacs/entwurf 0.19.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/AGENTS.md +1 -1
  2. package/BASELINE.md +23 -5
  3. package/CHANGELOG.md +236 -0
  4. package/DELIVERY.md +59 -6
  5. package/README.md +40 -9
  6. package/VERIFY.md +9 -1
  7. package/docs/acp-backend-rail.md +9 -1
  8. package/docs/external-mcp-host.md +6 -3
  9. package/docs/setup-clean-host.md +93 -7
  10. package/mcp/entwurf-bridge/dist/pi-extensions/lib/acp/models.js +3 -3
  11. package/mcp/entwurf-bridge/dist/pi-extensions/lib/acp/overlay.js +6 -2
  12. package/package.json +2 -2
  13. package/pi-extensions/acp-provider.ts +1 -1
  14. package/pi-extensions/lib/acp/models.ts +3 -3
  15. package/pi-extensions/lib/acp/overlay.ts +6 -2
  16. package/pi-extensions/lib/meta-session.ts +25 -0
  17. package/run.sh +71 -26
  18. package/scripts/agy-bridge.sh +1 -1
  19. package/scripts/agy-imprint.sh +10 -7
  20. package/scripts/check-acp-carrier-augment.ts +6 -5
  21. package/scripts/check-acp-cortex.ts +41 -0
  22. package/scripts/check-acp-provider-surface.ts +9 -6
  23. package/scripts/check-copilot-birth-hook.ts +3 -1
  24. package/scripts/check-copilot-receive-arm.ts +169 -21
  25. package/scripts/check-copilot-statusline.ts +3 -1
  26. package/scripts/check-gate-qualification.ts +10 -9
  27. package/scripts/check-hook-launch-topology.ts +6 -5
  28. package/scripts/check-install-surface.ts +2 -1
  29. package/scripts/check-meta-facts.ts +6 -4
  30. package/scripts/check-meta-hook-session-switch.ts +4 -3
  31. package/scripts/check-meta-identity-consumers.ts +8 -7
  32. package/scripts/check-meta-receiver-marker.ts +2 -1
  33. package/scripts/check-omp-birth-hook.ts +3 -2
  34. package/scripts/check-probe-bridge-command.ts +3 -1
  35. package/scripts/check-setup-qualification.sh +21 -0
  36. package/scripts/copilot-bridge-doctor.sh +15 -5
  37. package/scripts/copilot-bridge-install.sh +6 -2
  38. package/scripts/copilot-launch.sh +16 -2
  39. package/scripts/copilot-receive-bridge.sh +80 -13
  40. package/scripts/lib/reclaim-on-exit.ts +86 -0
  41. package/scripts/meta-bridge-doctor.sh +56 -15
  42. package/scripts/meta-bridge-install.sh +13 -7
  43. package/scripts/meta-bridge-uninstall.sh +6 -4
  44. package/scripts/mutants/acp-cortex.json +26 -2
  45. package/scripts/mutants/copilot-receive.json +26 -0
  46. package/scripts/mutants/omp-birth.json +23 -6
  47. package/scripts/mutants/setup-verdict.json +13 -0
  48. package/scripts/omp-bridge-doctor.sh +110 -41
  49. package/scripts/omp-bridge-install.sh +6 -2
  50. package/scripts/omp-receive-install.sh +7 -2
  51. package/scripts/raw-async-delivery/README.md +10 -1
  52. package/scripts/raw-codex-measure/README.md +689 -0
  53. package/scripts/raw-codex-measure/source-audit.md +243 -0
  54. package/scripts/raw-macos-measure/README.md +148 -0
  55. package/scripts/raw-macos-measure/probe.sh +389 -0
  56. package/scripts/smoke-meta-async-drift.sh +7 -5
  57. package/scripts/smoke-meta-install-state.sh +70 -19
  58. package/scripts/smoke-omp-bridge-state.sh +38 -0
  59. package/scripts/smoke-setup-verdict.sh +100 -0
package/AGENTS.md CHANGED
@@ -28,7 +28,7 @@ For agents that own this repo: invariant principles and reproducible verificatio
28
28
  - **entwurf-core (v2)** owns garden-id addressing, peer facts, liveness interfaces, dispatch decisions, rail choice, and delivery evidence.
29
29
  - **Record authority** owns citizen identity. Every addressable citizen uses the same V3 `MetaIdentity` schema. `backend` selects capability/rail behavior; it does not create an identity hierarchy.
30
30
  - **pi adapter** attaches a pi session to a record at `session_start`, hosts the record-keyed control socket, and exposes the native pi tool surface.
31
- - **Native bridges** register already-running native sessions without taking over their transcript or auth: Claude Code and Copilot CLI are mailbox/self-fetch (a Claude hook arms the watch; a forked Copilot extension holds it); Antigravity is probe-backed native-push. Codex has archived probe evidence, but its managed native lane was declined because pi already supplies the official GPT provider path; do not duplicate it as a native citizen or ACP backend.
31
+ - **Native bridges** register already-running native sessions without taking over their transcript or auth: Claude Code and Copilot CLI are mailbox/self-fetch (a Claude hook arms the watch; a forked Copilot extension holds it); Antigravity is probe-backed native-push. Codex's decline was reversed by GLG on 2026-09-08: lane #95 is open at step 1 (`scripts/raw-codex-measure/`), mints no record, and must not become an ACP backend.
32
32
  - **ACP plugin** registers provider `entwurf` inside a pi host session and drives a backend under an isolated overlay. The host pi session is already a record-backed socket citizen; the plugin does not mint another citizen/socket/peer layer.
33
33
  - **mux is launch-only and deliberately small.** Shipped: the tmux placement leaf (`mux-placement.ts` — inspect/append in the caller's own session, close on its whole SERVER), the visible runtime launch composition (`mux-launch.ts`), the fresh-call composition (`mux-fresh-call.ts`), the cwd-aware resume placement composition (`mux-resume-call.ts`), and the import-free leaves they inject (`classify-tmux-cwd.ts`, `resolve-tmux-session.ts`). Fresh call is exposed as `entwurf_fresh_call`; visible same-id resume is `entwurf_resume_call`, composed at the two public surfaces by injecting `mux-resume-call` into the v2-side `entwurf-v2-visible-resume.ts`. The exact import graph is enumerated in [docs/mux-launch-rail.md](./docs/mux-launch-rail.md) §11. `entwurf_v2` behavior is unchanged and delivery still never imports launch. Fresh call learns a new sibling's garden id from the CALLBACK it makes, never from a lookup — so the pre-injected-token → identity-lookup design (rail §6) is **closed, not paused**. Do not reopen it without new evidence and explicit GLG re-approval. Fresh-call requires one explicit model and passes it in each runtime's measured CLI dialect (Pi `--model <provider/model>`, Claude Code `--model=<id-or-alias>`, Copilot `--model <name>` beside `--interactive <prompt>` and the explicit `--yolo` policy — a GLG width decision, 2026-08-25, after a callback-only `--allow-tool` grant stopped the sibling at every task tool); the Copilot backend opens through entwurf's OWN managed invocation (`entwurf copilot`), never the bare vendor, and its four required capabilities — birth, MCP hand, receiver, visible footer — are decided by `copilot-fresh-preflight.ts` BEFORE the tmux mutation, so a missing unit is a named refusal instead of a dead window; it also takes ONE optional literal absolute `cwd` (#73 — omitted/`""` means the caller's own directory; no trim, no realpath, no project-name resolver; classified by the shared `classify-tmux-cwd.ts` leaf; the receipt echoes the REQUEST only), so a cross-repo fresh sibling is a fresh-call fact and never a reason to resume a dormant record. It also takes ONE optional project seat, `placement.tmuxSession` (#105 — the exact name of an EXISTING session on the caller's OWN server, turned into a `$id` by `resolve-tmux-session.ts` before anything reaches `-t`). **It creates nothing** — `tmux-session-missing`/`tmux-session-name-invalid` are named refusals, no `ifMissing`/`new-session` axis exists (GLG, 2026-09-07), seat and cwd never infer each other, and close binds to the SERVER half since a placed window may sit outside the caller's session. Resume takes only an existing target id and gets transcript/model/provider/cwd from its record. Do not grow either narrow carrier into a generic driver, harness profile, arbitrary command/env selection, or a second creation API. Ownership and import prohibitions: [docs/mux-launch-rail.md](./docs/mux-launch-rail.md) §11.
34
34
  - **One delivery verb:** `entwurf_v2` addresses an existing garden id. Current routes are live control-socket send, active self-fetch mailbox enqueue, and probe-alive native-push. NO route starts a process: the hidden background resume for a dormant citizen was withdrawn under the visible-first rule, so a dormant in-domain citizen rejects as `dormant-fire-forget-unsupported` and the intent axis is single-valued. Every other complementary state pair rejects honestly too. Fresh creation is a separate verb — `entwurf_fresh_call` — and it returns a launch receipt only; the new sibling's address arrives asynchronously as the sender envelope of its nonce callback.
package/BASELINE.md CHANGED
@@ -18,17 +18,28 @@ This table is the operator-facing support/certification view. It complements the
18
18
  model interview below; a persuasive answer from the model cannot turn an unmeasured
19
19
  host into a certified one. Verdicts are one of **certified** (a real host ran the
20
20
  installed doctor green), **shape-only** (gates model the package, no live host),
21
- or **unverified**.
21
+ or **unverified**. Since 0.20.0 the table also carries two qualifiers:
22
+ **CERTIFIED (CI)** marks a shape-only surface observed green on a CI runner — a
23
+ runner is not a physical host, so bare **certified** still means a physical-host
24
+ doctor green; and **NOT CERTIFIED — pending physical host** marks a rail whose
25
+ missing evidence only a physical host can supply. That is an evidence boundary,
26
+ not **UNSUPPORTED** — the deliberate never, which today is native Windows only.
22
27
 
23
28
  | Surface | Verdict | Evidence |
24
29
  |---|---|---|
25
30
  | Node 24 Linux package consumer | shape-only | Required `artifact-consumer` CI |
31
+ | Node 24 macOS package consumer (GitHub Actions runner, not a physical Mac) | shape-only · CERTIFIED (CI) | Required `macos-install-surface` CI run 34303884286 @ `70eda03` (`macos-latest`, 65 s, 10/10 steps): pack → clean consumer install → bin links → `entwurf --help` → `check-bridge` (7 tools) → harness-absent `setup` (all SKIP, computed green, zero no-write-axis writes, `auth.json` byte-identical). Certifies no harness rail. |
26
32
  | Claude Code >=2.1.217 exec form | **certified** — supported floor | Topology + floor gates, doctor oracle; B2 live NixOS session |
27
33
  | Claude Code 2.1.138 | **unsupported** | Launcher refuses empty argv; no shell-form fallback |
28
34
  | Maintainer NixOS installed package | **certified** for `0.12.8-repair.1` | 2026-07-25 registry install → doctor exit 0 (HISTORY) |
29
35
  | Secondary Ubuntu installed package | **certified** for `0.12.8-repair.1` | 2026-07-25 same artifact, isolated agent dir → doctor exit 0 (HISTORY) |
30
- | macOS Claude meta-bridge | unverified | Installer refuses Darwin; no `/proc` live join |
31
- | WSL2 / Windows | unverified | None |
36
+ | macOS Claude meta-bridge | NOT CERTIFIED — pending physical host | No physical-Mac doctor yet; a CI runner has no Claude login. Physical-host rental is postponed past this 0.20.0 cut. |
37
+ | Darwin install fence (meta/copilot/omp-bridge + omp-receive) | portable (Linux or Darwin) | Four installers accept Darwin; python3/node/harness presence holds the seat, not the platform name. A Darwin install is not a rail receipt. |
38
+ | Doctor fail-closed on unreadable environ | Linux measured; Darwin unmeasured | Copilot launch-flag and omp identity-carrier: missing `/proc/<pid>/environ` as predicate INPUT is `UNVERIFIABLE` (non-green), not a benign note. omp distinguishes `pgrep` exit 1 (absent) from exit 2 (enumeration failed); copilot distinguishes ENOENT/ESRCH (gone) from other errno (read denied). |
39
+ | setup on uncertified platform with harness present | named non-green | All 13 harness units ask `harness_rail_certified_platform()`; uncertified → FAIL whose wording is not "install failed". Harness-absent Darwin setup (the CI cell) can still be computed green. |
40
+ | macOS physical-host probe | shipped, unrun on a Mac | `scripts/raw-macos-measure/` — `/bin/sh`, cells M1–M9, 3.5 s; needs neither entwurf install nor login. Still unmeasured: Darwin foreign-process environ (`ps -Eww`) and whether macOS `python3` is a CommandLineTools stub. |
41
+ | WSL2 | unverified | Counts as Linux evidence, never a Windows surface (AGENTS Hard Rule 17) |
42
+ | native Windows | UNSUPPORTED | Locked pending GLG; a scope decision, not an evidence gap |
32
43
 
33
44
  Notes the table cannot carry without becoming prose again:
34
45
 
@@ -36,13 +47,20 @@ Notes the table cannot carry without becoming prose again:
36
47
  candidate `.tgz`, checkout-invisible non-root global install, PATH shims, a frozen
37
48
  package root, the path+sha256 regular-file fence, and a strict doctor fixture. Its
38
49
  planted Claude cache/owner/bridge are synthetic — no real Claude lifecycle runs there.
50
+ - **A CI runner is not a physical host.** The macOS consumer row is `macos-latest`
51
+ — an image, not the NixOS/Ubuntu "host" of the certified rows. Its green covers
52
+ the Entwurf-only install surface (pack, install, bins, `--help`, `check-bridge`,
53
+ harness-absent `setup`); it cannot log into a harness, so no rail, marker join,
54
+ ACP turn, or mux lifecycle is certified by it.
39
55
  - **Both certified hosts are certified for the published repair artifact only**, including
40
56
  physical `entwurf_v2` delivery and the live owner join. Stable cuts earn their own host
41
57
  proof; hand-patched hooks and `plugin validate` output are never acceptance.
42
58
  - **The maintainer host first went doctor-RED** on a managed dev-bin shadowing the registry
43
59
  bridge, and now runs dev wiring again.
44
- - **macOS is not permanently excluded.** Future native validation may reopen it, and the
45
- package-level `os` field stays unrestricted.
60
+ - **macOS evidence is split, not a support claim.** The Entwurf-only install surface is
61
+ CERTIFIED (CI) (row above); the harness rails are NOT CERTIFIED — pending
62
+ physical host (rental postponed past this cut). The package-level `os` field stays
63
+ unrestricted, and native Windows is UNSUPPORTED.
46
64
 
47
65
  **Operator acceptance rule:** on a claimed Claude host, reinstall from the released
48
66
  artifact, restart every old Claude process, open a new session, and run the doctor
package/CHANGELOG.md CHANGED
@@ -4,6 +4,242 @@ All notable changes to this project will be documented here. Format follows [Kee
4
4
 
5
5
  ## Unreleased
6
6
 
7
+ ## 0.20.0 - 2026-09-09
8
+
9
+ This range carries three lanes that are not one cause: the macOS
10
+ install-surface axis (#78), `claude-fable-5-1` on the curated ACP surface,
11
+ and the Cortex `realHome` path-flavor fix (PR #77). GLG (2026-09-09)
12
+ deferred the physical-Mac loan: this cut is honest about a **CERTIFIED (CI)**
13
+ install surface and does not pretend the harness rails are certified.
14
+
15
+ **macOS in this release.** This release adds macOS support for Entwurf's
16
+ install surface: the npm package installs, `entwurf --help` and `entwurf
17
+ check-bridge` boot, and `entwurf setup` composes the integrations it finds.
18
+ The four installers that previously rejected Darwin by platform name no longer
19
+ do. We validated that surface only in macOS CI because the developers did not
20
+ have a physical Mac. So macOS native-harness rails—marker join, an ACP turn,
21
+ and mux included—are not yet certified; setup writes their wiring but reports
22
+ them non-green. Linux's certified rail status is unchanged.
23
+
24
+ ### Upgrade note — this one asks something of the operator
25
+
26
+ **On Darwin, `entwurf setup` no longer prints `result: green` when a harness
27
+ is already present.** Opening the four Darwin install fences (below) had a
28
+ side-effect the command an operator actually types did not stay honest for:
29
+ the installer that used to refuse on a platform name now writes the wiring,
30
+ and setup graded that `PASS` / `result: green` — while every harness doctor
31
+ still refuses on Darwin, and setup runs no doctor. That is cosmetic success
32
+ against Hard Rule 17 ("a detected-but-incomplete integration is named
33
+ non-green rather than cosmetic success").
34
+
35
+ All 13 harness units now ask one predicate
36
+ (`harness_rail_certified_platform`). On an uncertified platform they emit a
37
+ named non-green (FAIL) whose wording is lexically disjoint from an install
38
+ failure — `entwurf setup` says so by name:
39
+
40
+ `<unit> FAIL — the wiring WAS written and nothing failed to install, but this
41
+ harness rail is NOT CERTIFIED — pending physical host on <uname>. setup runs
42
+ no doctor; the rail axis is owned by '<doctor>'. Tracking: #78.`
43
+
44
+ `bins` and `core` are not rail axes and still PASS. A Darwin host with no
45
+ harness still five-SKIPs and `result: green` — that is the path
46
+ `macos-install-surface` asserts, and it did not move. Linux is unchanged: a
47
+ completed rail install is still PASS.
48
+ `[QK:SETUP-DARWIN-RAIL-COSMETIC-PASS]` plants the restoration of "a completed
49
+ install always PASSes" and was KILLED at that signature.
50
+
51
+ The four installers that used to refuse Darwin (`entwurf install-meta-bridge`,
52
+ `install-copilot-bridge`, `install-omp-bridge`, `install-omp-receive`) now
53
+ run; their own refusal is the toolchain check (python3 / node / harness
54
+ presence), never the platform name. A green Darwin install certifies the
55
+ install surface only, never a harness rail.
56
+
57
+ Hosts with no detected harness, and every Linux host, see no new prompt.
58
+
59
+ ### Added
60
+
61
+ - **`claude-fable-5-1` joins the curated ACP model surface.** The `entwurf` provider now registers
62
+ three unprefixed Claude ids (`claude-opus-5`, `claude-sonnet-5`, `claude-fable-5-1`) beside the
63
+ four `cortex-` rows. Routing needed no change: `backend-adapter.ts` derives `SUPPORTED_CLAUDE_IDS`
64
+ from the same constant, and `curatedClaudeModels()` filters the pi-ai registry — which carries
65
+ `claude-fable-5-1` (measured: `getModels("anthropic")` lists it beside `claude-fable-5`). The
66
+ curation comment's "verify across both axes" commitment is met by a live citizen: GLG opened B on
67
+ `entwurf/claude-fable-5-1` (garden `20260908T181437-30802a`, `backend=pi`, `liveness=alive`) and a
68
+ fire-and-forget send to it went out on the control-socket rail.
69
+ - **Two exact-set pins moved with the surface, and one of them was the real gap.**
70
+ `check-acp-provider-surface` counts the curated constants (6 → 7) and
71
+ `check-pack-install` enumerates the installed provider's own model list — that second one is a
72
+ package gate in `check:full`/`prepublishOnly` and would have gone red on the next release with a
73
+ drift message rather than a missing-support message. `check-acp-cortex` asks presence
74
+ (`includes`), not an exact set, so it needed nothing.
75
+ - **`[QK:CLAUDE-CURATED-THREE-ROWS]` — the claude curated list gets its own oracle.** The cortex list
76
+ has had `CORTEX-CURATED-FOUR-ROWS` since 0.13.0; the claude list had none, and it could not borrow
77
+ the exact-set comparison beside it: `expectedIds` derives from the same constant, so a dropped
78
+ claude row moves expected and captured together and that assertion stays green. The independent
79
+ count is what catches it, so the count now carries the claim and a committed mutant plants the
80
+ real defect (dropping `claude-fable-5-1` from `SUPPORTED_ANTHROPIC_MODEL_IDS`). Lane inventory
81
+ `acp-cortex` 12 → 13; total 386 → 387.
82
+
83
+ - **macOS gets its own evidence axis — an install surface, not a support claim.**
84
+ The `macos-install-surface` CI job (GitHub Actions `macos-latest`) was promoted
85
+ from non-voting to required after its first green at commit `70eda03`
86
+ (run 34303884286, 65 s, 10/10 steps): npm pack → checkout-invisible clean
87
+ consumer install → bin links → `entwurf --help` → `check-bridge` (direct MCP
88
+ smoke, 246 ms, the seven tools + `test.sh`) → harness-absent `setup` (pi/Claude/agy/Copilot/
89
+ OMP all SKIP, bins/core PASS, computed verdict green, zero writes on the five
90
+ no-write axes and `auth.json` byte-identical). Platform vocabulary across
91
+ README/BASELINE now separates three states: the Entwurf-only install surface on
92
+ macOS is **CERTIFIED (CI)** — a CI runner, never a physical host; the harness
93
+ rails (Claude/Copilot/OMP/agy wiring, marker join, a real ACP turn, mux) are
94
+ **NOT CERTIFIED — pending physical host**; native Windows is **UNSUPPORTED**.
95
+ - **`scripts/raw-macos-measure/` — the borrowed-Mac measurement ledger.** `probe.sh`
96
+ (`/bin/sh`, cells M1–M9) measures one host and writes nothing: no install, no
97
+ record, no state. The README maps each cell to the surface it measures and keeps a
98
+ `[host-linux]` control run so the probe itself is never the thing under test. Opened
99
+ by the promotion above; it is where a borrowed Mac produces the physical-host
100
+ evidence the CI runner cannot.
101
+ - **`scripts/raw-codex-measure/` — Codex 0.153.4 vendor measurement (#95 step 1).**
102
+ Nothing is installed: no birth hook, no record, no marker, no doctor, and
103
+ `entwurf_fresh_call` still cannot open a codex sibling. GLG reversed the
104
+ 2026-08-01 decline on 2026-09-08; live claims that still said otherwise
105
+ were repaired. The ledger closes step 1: SessionStart fires on the first
106
+ turn, not at window open; a fourth callback spelling
107
+ (`mcp__entwurf_bridge__entwurf_v2`); the delivery-capable app-server join
108
+ cannot use parent-pid as a citizen key; hook-trust is an ownership cost
109
+ (`/etc/codex`, root-owned), not a capability gap; clause 4 is
110
+ `thread/name/set` plus a status_line config. Step 2 is not opened.
111
+ `PIN_CODEX_MINOR` 0.144 → 0.153 is a re-verification of the archived drift
112
+ probe, not a product pin.
113
+
114
+ ### Changed
115
+
116
+ - **`[QK:CORTEX-PROVIDER-SIX-ROW-SURFACE]` → `[QK:CORTEX-PROVIDER-EXACT-ROW-SURFACE]`.** The claim's
117
+ substance is "the compiled entry registers the EXACT union of every adapter's curated rows", which
118
+ is count-independent; the old id carried a row count that this change made false and that any
119
+ future curation change would falsify again. Gate assertion, mutant manifest (`claim` +
120
+ `signature`), the `acp-provider.ts` comment and the `run.sh` usage line moved together. The
121
+ mutant's `find`/`replace` are untouched — it still plants the same defect (filtering the cortex
122
+ rows out of the real entry).
123
+ - **Four install fences now accept `Linux | Darwin`** — `meta-bridge-install.sh`,
124
+ `copilot-bridge-install.sh`, `omp-bridge-install.sh`, `omp-receive-install.sh`
125
+ (the `meta-bridge-uninstall.sh` precedent). The installers' own refusal is the
126
+ toolchain check (python3/node/harness presence), never the platform name. A green
127
+ Darwin install certifies the install surface only, never a harness rail —
128
+ installation portability and rail certification are separate axes (Hard Rule 17).
129
+ - **Doctor python `start_key`/`parent` now mint the same two-tier key the TS core
130
+ mints** (`/proc` stat field 22 → `linux:<ticks>`, else `ps -o lstart=` /
131
+ `ps -o ppid=`, the same argv vectors `meta-session.ts` uses). Darwin's remaining
132
+ doctor reason is per-process environment DISCOVERY, not start-key.
133
+ The `ps:` format is unchanged: 1-second resolution against `linux:` at
134
+ 10 ms, but a same-second pid reuse needs a full PID_MAX wrap inside one
135
+ second (≈99,900 spawn/s vs a measured pathological ceiling of 14,873/s).
136
+ Coarsening can mint a false `live` and never a false `dead`. The migration
137
+ axis is empty — 1,248 marker files, all `linux:`, zero `ps:`. Widening the
138
+ key with argv was measured insufficient (two same-argv children share it,
139
+ and same-argv restart is the normal harness shape).
140
+ - **Operator-surface portability substitutions (audit P1).** `grep -P` negative
141
+ lookaheads moved to awk (6 sites); `sha256sum` moved to the in-repo python3
142
+ hashlib helper (3 sites) — not a second `shasum` convention. `readlink -f` on the
143
+ operator path (`agy-imprint.sh`, `copilot-launch.sh`) replaced with the POSIX
144
+ symlink walk `mcp/entwurf-bridge/start.sh` already ships, and `agy-bridge.sh`
145
+ advice no longer prints a GNU-only command.
146
+
147
+ ### Fixed
148
+
149
+ - **The Cortex overlay's `realHome` guard now states path-flavor absoluteness, not the host it runs
150
+ on.** `ensureCortexDualHomeOverlay` refused a non-absolute `realHome` with `startsWith("/")`, so a
151
+ drive/UNC path (`C:\Users\x`, `\\server\share`) read as relative. The guard is now
152
+ `isAbsolute(realHome) || win32.isAbsolute(realHome)`; the error text and the D10 contract sentence
153
+ are unchanged. First evidence: PR #77 (@yizixu) found the defect. The flavor-explicit form is what
154
+ makes it killable on a Linux host — `check-acp-cortex` gained two positive cells (drive and UNC,
155
+ `realSnowflakeHome` pinned under tmp so only the guard is exercised) plus an empty-string negative
156
+ cell, and mutant `CORTEX-REALHOME-PLATFORM-NEUTRAL` replants `startsWith("/")` and dies at
157
+ `[QK:CORTEX-REALHOME-PLATFORM-NEUTRAL]`. This claims no native-Windows support; the certified
158
+ platform axis is unchanged.
159
+ - **Doctors no longer call an unmeasured host clean.** When `/proc` is absent, the
160
+ Copilot launch-flag and OMP identity-carrier doctors used to fail OPEN — a `note`
161
+ and a green verdict. They now emit `UNVERIFIABLE` through the existing `bad` path:
162
+ no new severity, emitter, or exit code. The same contract is pinned one step
163
+ further — absent and unknowable are no longer collapsed: a failed enumeration
164
+ (`pgrep` rc 2) or an unreadable `cmdline` is UNKNOWN and stays non-green, while a
165
+ genuine no-match or a vanished process remains the benign note it always was.
166
+ That distinction is bidirectional and holds on Linux too, where `/proc`'s presence
167
+ had merely hidden the defect.
168
+ - **Recovered-host selectors moved from GNU BRE alternation to ERE**
169
+ (`omp-bridge-doctor.sh`, `copilot-bridge-doctor.sh`), so BSD grep cannot report a
170
+ recovered host as unrecovered (a false RED that only Darwin's grep would mint).
171
+ - **A red or interrupted gate no longer leaves its children and temp roots
172
+ behind.** Teardown written as the last line ran only on the green path;
173
+ gates throw to go red, and `^C`/SIGTERM runs no statement. Measured on
174
+ oracle: 360 reparented Node receivers from the copilot-receive stub and
175
+ ~9,200 stale temp roots (3.8 G), one of them minted by a `pnpm check` that
176
+ had just reported clean. Teardown now belongs to `process.on("exit")` plus
177
+ the three signals (`scripts/lib/reclaim-on-exit.ts`); the SDK stub gains
178
+ the parent-death watchdog production already has.
179
+ `[QK:COPILOT-RECEIVE-STUB-CHILD-DIES-WITH-PARENT]` carries the watchdog.
180
+ The release skill gains P9 (prefix-blind census; delete only prefixes this
181
+ checkout's `mkdtempSync` calls mint), run at the release-gate verdict, at
182
+ the end of prepare, and after the publish smoke.
183
+
184
+ ### Verification
185
+
186
+ Lane receipts (oracle, 2026-09-09) plus prepare P4/P5 on this host. There is
187
+ **no** physical-Mac receipt.
188
+
189
+ - **`pnpm run check:full`** exit 0, 461 s (`9cc5b09`) / 469 s (`e09b84e`) /
190
+ 465 s (prepare P4, this worktree).
191
+ - **Prepare P5** `LIVE=1 ./run.sh release-gate --cut`:
192
+ scratch `/tmp/entwurf-release-gate-0.20.0.rerun`, **MUST PASS=23 FAIL=0
193
+ SKIP=0**, BEHAVIOR PASS=1, `cut: OK`. Qualification **391/391 KILLED**
194
+ inside that gate. The first attempt was `cut: BLOCKED` (MUST FAIL=2):
195
+ host `STALE writer` on the deployed omp-receive unit, and the omp-fresh
196
+ nonce callback captured by the preparing session's `PI_SESSION_ID`.
197
+ Rerun after `install-meta-bridge` / `install-omp-bridge` /
198
+ `install-omp-receive` and `env -u PI_SESSION_ID -u PI_AGENT_ID -u
199
+ CLAUDE_CONFIG_DIR`.
200
+ - **`check-gate-qualification` 390/390 → 391/391 KILLED** (`9cc5b09` then
201
+ `e09b84e`). New claims this range: `CLAUDE-CURATED-THREE-ROWS`,
202
+ `CORTEX-REALHOME-PLATFORM-NEUTRAL`,
203
+ `COPILOT-RECEIVE-STUB-CHILD-DIES-WITH-PARENT`,
204
+ `OMP-DOCTOR-UNENUMERATED-IS-UNVERIFIABLE`,
205
+ `COPILOT-RECEIVE-DOCTOR-UNREADABLE-ARGV-IS-UNVERIFIABLE`,
206
+ `SETUP-DARWIN-RAIL-COSMETIC-PASS`.
207
+ - **`check-pack-install`** exit 0. **`check-install-container`** exit 0.
208
+ - The macos-install-surface cell replayed against the packed candidate on
209
+ Linux: all 12 pins HOLD (`9cc5b09`).
210
+ - Doctors (4 files) HEAD-vs-worktree output IDENTICAL (`9cc5b09`).
211
+ - CI run
212
+ [`34303884286`](https://github.com/junghan0611/entwurf/actions/runs/34303884286)
213
+ @ `70eda03` — `macos-install-surface` required, `macos-latest`, 65 s,
214
+ steps 10/10.
215
+ - CI run
216
+ [`34316688064`](https://github.com/junghan0611/entwurf/actions/runs/34316688064)
217
+ @ `9cc5b09` — 4 jobs + qualification step `success`.
218
+ - Land exact-SHA CI run
219
+ [`34329931791`](https://github.com/junghan0611/entwurf/actions/runs/34329931791)
220
+ @ `a5a6dfe`, `event=workflow_dispatch` — 4 jobs + qualification body
221
+ `success` (the push run at this SHA skipped the body; L3 dispatch recovered it).
222
+
223
+ ### Notes
224
+
225
+ - **What this cut claims about macOS, and what it does not.** Claimed: the
226
+ Entwurf-only install surface is **CERTIFIED (CI)**; the shipped operator
227
+ path is portable (no `readlink -f`, no `grep -P`, no `sha256sum`, no GNU BRE
228
+ alternation on recovered-host selectors); doctors fail closed on an
229
+ uncertified discovery axis (`UNVERIFIABLE`, not a green note). Not claimed:
230
+ harness rails, marker join, a real ACP turn, mux, or a physical-host doctor
231
+ green — all **NOT CERTIFIED — pending physical host**. native Windows is
232
+ **UNSUPPORTED**. A CI `macos-latest` runner has no logged-in harness; it
233
+ cannot mint the stronger `certified`. macOS is never UNSUPPORTED.
234
+ - **Two cells are unmeasured, by name.** Whether Darwin can read another
235
+ process's environ (`ps -Eww`), and whether macOS `python3` is the
236
+ CommandLineTools stub. Both are cells the borrowed-Mac probe
237
+ (`scripts/raw-macos-measure/probe.sh`, M6 and M3) is built to answer. Do
238
+ not fill them from a CI image spec.
239
+ - **Codex is not a garden backend in this cut.** Step 1 of #95 closed as
240
+ measurement; step 2 is not opened. `entwurf_fresh_call` still cannot open a
241
+ codex sibling.
242
+
7
243
  ## 0.19.0 - 2026-09-07
8
244
 
9
245
  One lane: #105 slice ①, the project seat. `entwurf_fresh_call` gains an optional
package/DELIVERY.md CHANGED
@@ -80,13 +80,16 @@ axis; neither word is an admission grade or a synonym of *supported*. A pre-cont
80
80
  can be owned without being supported; a supported harness still has to walk
81
81
  [`docs/adding-a-harness.md`](./docs/adding-a-harness.md) step 9.
82
82
 
83
+ Every row in this table is Linux evidence. macOS rails are NOT CERTIFIED — pending
84
+ physical host. Do not read a D-level cell as a Darwin receipt.
85
+
83
86
  | Harness / surface | Product status | Capability | Transport and boundary |
84
87
  |---|---|---|---|
85
88
  | **pi native Entwurf** | shipped | D7; D8 partial | Record-addressed Unix control socket. A record-less socket is diagnostic only and never dispatched. |
86
89
  | **Claude Code interactive `>=2.1.217`** | shipped; Linux certified | D6; D7/D8 partial | Per-session mailbox + exec-form `FileChanged`/`asyncRewake`. B2 proved idle wake and same-session continuity on one NixOS host. |
87
90
  | **Antigravity / agy** | shipped | D6; D7 partial | Record-backed native-push through LS gRPC `agentapi send-message`; no mailbox or receiver marker. Admitted before the #82 step 9 contract and not re-evaluated under it, so it is legacy citizen evidence, not a step-9 supported harness: `entwurf_fresh_call` cannot open an agy sibling, and nothing here should be read as claiming visible lifecycle parity. |
88
- | **Codex app-server-backed TUI** | verified probe | D7; D8 unproven | WebSocket-over-UDS `turn/start` into a live `threadId`; status events expose completion. No owned native-citizen install/invocation lane. |
89
- | **Codex embedded TUI** | deferred | D0 partial | No supported receive socket/hook on the measured standalone shape. |
91
+ | **Codex app-server-backed TUI** | verified probe, re-verified at 0.153.4 | D7; D8 unproven | WebSocket-over-UDS `turn/start` into a live `threadId`; status events expose completion. Re-run as shipped on 2026-09-08 at codex-cli **0.153.4** (garden lane #95): idle plain `codex` auto-attached to a bare `codex app-server --listen`, woke with zero typing, and the model replied in the same visible session — `{"ok": true, "threadId": "01a08145-ce6d-77d0-b7a4-cfb57c608282", "turnId": "01a08146-7c06-7b83-9e65-32e3814ee490", "status_seen": ["active","active","idle"]}`. No owned native-citizen install/invocation lane. Step 1 measurement only — the lane is open (#95) but nothing is installed, so this row stays the declared pre-#82 exception `check-harness-admission-parity` reads. |
92
+ | **Codex embedded TUI** | deferred | D0 partial | No supported receive socket/hook on the measured standalone shape. Re-checked in source at 0.153.4: the hook vocabulary grew to 12 events but still has no `watchPaths`/`FileChanged`/`asyncRewake` analogue, so the negative stands. |
90
93
  | **Copilot CLI first-party extension** | raw transport probe; superseded by the owned product unit | D7 path observed; D3 control receipt incomplete; D8 unproven | CLI-spawned extension over stdio JSON-RPC; `joinSession()` + documented `fs.watch` → `session.send({mode:"enqueue"})`. Idle wake, exact-marker reply, and completion passed on 2026-08-23 (CLI 1.0.80, L4, one Linux host). Two-process isolation was observed but its decisive B log was not preserved. Kept as the transport receipt the owned receive unit was built on; the shipped unit differs deliberately — it announces the inbox instead of injecting the body. |
91
94
  | **Copilot CLI garden citizen** | shipped in 0.15.0; send + receive + visible fresh accepted on one host | D6; D7 partial; D3 pending; D8 unproven | Birth, garden id, MCP hand and record-backed sender identity are accepted; the RECEIVER is an installed first-party extension that binds to the V3 record, writes a receiver marker owned by the WATCHER pid, and rings a doorbell the model drains with `entwurf_inbox_read`. `wakeMode` is `self-fetch`, so dispatch reaches the mailbox rail: armed → delivered, unarmed/stale → the honest `mailbox-undeliverable` refusal. **D6 is the owned-invocation LIVE acceptance of 2026-08-23** — garden `20260823T181316-d9f6ba`, native `20fe30c8-b2bc-4600-91a0-8a409131be51`, CLI 1.0.80: receive log `joined`→`armed`→`doorbell fresh=1`→`rang`, mailbox `lastEnqueuedAt 09:23:41.235Z` / `lastReadAt 09:23:56.480Z`, and a model reply on the same record/native/gid chain. **Visible fresh (step 9 clause 7) is a separate LIVE, 2026-08-25** — launch window `@89`/`%89` nonce `mux-fresh-call-690529ae99f99faa2252aefb`; exact-callback garden `20260825T085721-f68be0`; one `entwurf_v2` → `meta-mailbox → enqueued`; same garden `lastReadAt 2026-08-24T23:57:47.784Z` plus same-gid reply; GLG saw footer garden id and a healthy multi-turn window. Those rows stay unmerged. D7 is PARTIAL: reply and read receipt were observed, the completion taxonomy and long-haul operation were not. D3 (second-session isolation of an owned invocation) is PENDING — observed once, decisive log lost to scratch cleanup. Evidence level L4: one host. Launch through the owned invocation `entwurf copilot`, which sets `COPILOT_CLI_ENABLED_FEATURE_FLAGS=EXTENSIONS` for that one process; `doctor-copilot-receive` reads live CLI environments because a session launched without it is silently inert. Visible fresh is operator-metered and is not a release-gate MUST. |
92
95
  | **OMP (`omp`) garden citizen** | shipped in 0.16.0; send + receive + visible fresh accepted on one host | D6; D3 proven; D7 partial; D8 partial | Two in-process extensions in the operator's own TUI: birth mints the `mode === "tui"` host (subagents mint nothing) and names it as sender; the RECEIVER unit joins that citizen in the SAME process, holds an `fs.watch` on its mailbox signal, and rings an announce-only doorbell through the vendor's `pi.sendUserMessage` — measured to be on the FACTORY object, not the event ctx, and measured to start a turn on an idle host with zero typing (`agent_start` +31ms). `wakeMode` is `self-fetch`: the model drains with `entwurf_inbox_read` and THAT read is the receipt. **D6 is the LIVE acceptance of 2026-08-30** (oracle, omp 18.0.0) — garden `20260830T140819-116f6a`, `lastEnqueuedAt 05:08:20.555Z` / `lastReadAt 05:08:23.958Z`, and the citizen's own transcript carrying `mcp__entwurf_bridge_entwurf_inbox_read` for its own garden id. **D3 is PROVEN, not pending**: with two live omp citizens armed, one addressed enqueue rang exactly one doorbell and the sibling persisted no transcript and kept an empty mailbox. D7 is PARTIAL (`lastReadAt` needs no scraping; the reply does). D8 is PARTIAL — dedupe and every stale-handling path are implemented and hermetically pinned, ordering/loop-guard/crash-recovery are not. The `/new` unarm is the rail-specific one: the watch lives in the operator's TUI, so pid + start-key cannot see a citizen change underneath a living process, and without an explicit unarm the previous garden id would keep reading deliverable. Requires `tools: xdev: false` in `~/.omp/agent/config.yml` — the vendor default hides MCP tool schemas from the prompt, so the doorbell would name a tool the model cannot call. The decisive receipt lines — the ordering probe, the D6 chain, the D3 isolation and the `/new` unarm — are pasted into `scripts/raw-omp-measure/README.md` §M7 rather than left in a host-local `/tmp` path. Evidence level L4: one Linux host, ARM. **Visible fresh (step 9) is ACCEPTED — the clause 7 LIVE went green on 2026-08-30:** `entwurf_fresh_call` opens omp on all three public surfaces through the bare `omp` runtime with an explicit `--approval-mode yolo` width and the `mcp__entwurf_bridge_entwurf_v` callback name, behind a five-axis pre-mutation preflight whose fifth axis is omp-specific (`tools.xdev !== true`, without which the model cannot call the callback tool at all). **The first turn is a TWO-STAGE BOOTSTRAP rather than a positional prompt, and that is a measured correction, not a preference.** `[LIVE 2026-08-30]` the positional-prompt candidate opened its window and minted its citizen (garden `20260830T181342-452167`, native `01a051f2-3107-7147-8806-fa2a6f527610`), delivered the byte-identical framing as a user message at `09:13:42.413Z`, and the model answered the literal text `ACK` at `09:13:47.105Z` with ZERO tool calls; the caller timed out at 240s. `[source]` the interactive UI defers MCP discovery (`sdk.ts:1847-1855`, `:1881-1905`) while the positional `initialMessage` prompts straight after `mode.init()` (`main.ts:540-565`), and `[측정]` an observer on the same runtime saw `turn_start` at +654ms with the entwurf tools absent and the callback tool present only at +1484ms. So the launcher now carries `{v,target,nonce,task}` on the fixed registered flag `--entwurf-bootstrap`, and the in-process birth extension polls `getAllTools`(`source:"mcp"`) AND `getActiveTools` for the exact callback name, sends a callback-ONLY prompt, arms the task only on a `tool_result` whose stored `toolCallId`, tool name, target, nonce and `isError === false` all match, and DELIVERS it at the next `turn_end` of that same session. `[LIVE 2026-08-30]` that last boundary is itself a measured correction: a first attempt sent the task from inside the `tool_result` handler with an explicit `deliverAs: "followUp"`, the hook log showed the full chain (`bootstrap-armed` → `bootstrap-ready` +440ms → `bootstrap-callback-observed` → `bootstrap-released`), and the task still never appeared in the session — `[source]` an explicit `deliverAs` queues without starting a turn in either state, while the omitted form starts one when idle (`agent-session.ts:6511-6513`), which the same transcript confirmed three seconds later when the Bundle B doorbell's omitted-option send landed and started a turn. `[측정 2026-08-30]` the callback-only half is what was proven to work: model `openai-codex/gpt-5.6-sol`, tool live at +1105ms, prompt injected at +1107ms, and the sibling calling `mcp__entwurf_bridge_entwurf_v` with the exact nonce (`omp-cb-btkvva4r87` → `20260830T184054-1aa1f2`, `meta-mailbox → enqueued`). **The clause 7 acceptance, `smoke-omp-fresh-live` (release-gate MUST), 2026-08-30, 21 assertions, omp 18.0.0 / `openai-codex/gpt-5.6-sol`:** launch through `tools/call entwurf_fresh_call` with nonce `mux-fresh-call-34faea228f3c3638684b40ff`; sibling garden `20260830T192913-df52b9` taken from the CALLBACK's sender envelope and never from the launch receipt; exactly one new citizen (§3.5); addressed `entwurf_v2` → `meta-mailbox → enqueued`; `lastEnqueuedAt 10:29:19.179Z` / `lastReadAt 10:29:24.673Z`; the drain visible in that session's own transcript for its own garden id. **Both bootstrap stages are in that transcript in order** — the callback-only prompt at offset 970, the caller's task at 4732, no four-backend positional framing anywhere, and an assistant message after the task proving it started a turn rather than sitting in a queue. The unit's own log carries the state machine: `bootstrap-armed 10:29:13.399Z` → `bootstrap-ready 10:29:13.819Z` (+420ms) → `bootstrap-callback-observed 10:29:18.663Z` (`toolCallId=call_KZJtkxfzy1IEE4ejKutCPWcm|fc_0858…`) → `bootstrap-released 10:29:18.731Z` → `bootstrap-task-sent 10:29:18.759Z`. Evidence level L4: one Linux host, ARM, one run. `check-harness-admission-parity` keeps the deterministic half of the admission from being a matter of memory. What this does NOT establish: multi-host, multi-model, or repeated fresh calls in one process. **Cross-harness leg, 2026-08-31 (first bidirectional live-turn roundtrip on the committed bytes + operator redeploy):** a claude-code citizen (`20260831T090152-f998ac`) opened a fresh omp sibling through the public surface (nonce `mux-fresh-call-807cb693b1913ce98ffdbfd1`, callback sender garden `20260831T124226-eac41a`), dispatched an addressed `entwurf_v2` → `meta-mailbox → enqueued`, and the omp citizen's own live turn drained and replied into the claude mailbox — its self-report (doorbell → `entwurf_inbox_read`; callback-only first user message, task second) agrees with every receipt on the chain. |
@@ -131,10 +134,60 @@ in [BASELINE.md](./BASELINE.md); deterministic ownership and sender gates run in
131
134
 
132
135
  Do not describe “Codex” as one delivery shape. The measured app-server-backed TUI can
133
136
  accept `turn/start` for a live thread and report completion; the standalone embedded
134
- TUI exposed no equivalent receive route. This remains archived method evidence, not a
135
- shipping commitment: GLG declined to own a native Codex invocation/install lane on 2026-08-01 because pi
136
- already supplies the official GPT provider path. Entwurf will not duplicate it as a
137
- native citizen or ACP backend. `turn/steer` is active-turn steering, not idle wake.
137
+ TUI exposed no equivalent receive route. `turn/steer` is active-turn steering, not idle wake.
138
+
139
+ **The 2026-08-01 decline is reversed.** GLG re-opened the Codex native lane on 2026-09-08
140
+ (“코덱스 레일 들어가자”) as one of the two 사용자층 확보 axes; the lane is
141
+ `#95` and the pi-already-supplies-GPT argument no longer settles it. Nothing here is a
142
+ support claim: no codex record has ever been minted, there is no birth hook, no sender or
143
+ receiver marker, and `entwurf_fresh_call` cannot open a codex sibling.
144
+
145
+ **But step 2 is already spent, and it is spent WRONG.** `codex` is in `META_BACKENDS`
146
+ (`meta-session.ts:84`) and `META_CITIZEN_BACKENDS` (`:308`), and `pi/entwurf-capabilities.json`
147
+ grades it `wakeMode: "direct-inject"`, `deliveryLevel: "D6"`, `nativeIdLabel: "threadId"`.
148
+ That D6 is a **registry promise with no channel behind it** — precisely the shape
149
+ `docs/adding-a-harness.md` step 8(c) names — and it predates this lane. Correcting the grade
150
+ is step 8 work; it is recorded here so the next reader does not inherit a D6 as evidence.
151
+
152
+ **Current coordinates are 0.153.4** (source `~/repos/3rd/codex` at `rust-v0.153.4`), measured
153
+ 2026-09-08 in `scripts/raw-codex-measure/` — step 1 of `docs/adding-a-harness.md` only. The
154
+ 0.136.0 rows above are preserved history. What the re-measurement changed:
155
+
156
+ - **Delivery survives 17 minor lines unchanged.** The shipped raw probe ran as-is (receipt in
157
+ the matrix row above). One method note: at 0.153.4 the rollout JSONL is materialized lazily,
158
+ so `thread/loaded/list` — not newest-rollout scraping — is the reliable `threadId` source.
159
+ - **Birth timing is first-turn, not window-open**, and the gap is ~47s wide on a live TUI.
160
+ - **A subagent raises `SubagentStart`, never `SessionStart`**, so §3.5's top-level predicate is
161
+ vendor-authoritative and costs nothing.
162
+ - **The callback dialect is `mcp__entwurf_bridge__entwurf_v2`** — a fourth spelling; the
163
+ sanitizer maps `-` to `_` but keeps the digit that omp's charset eats.
164
+ - **The step-6 join holds in both launch modes, but its owner moves — and in the
165
+ delivery-capable mode it cannot separate citizens.** Embedded:
166
+ `hook.ppid == mcp.ppid == the TUI`. App-server-attached: both resolve to the app-server, and
167
+ that is now measured rather than inferred — two live threads on one app-server, two separate
168
+ visible windows, **one `ppid` for every hook and every MCP child of both**, neither TUI in
169
+ the chain. A parent-pid sender marker would be one marker for N citizens, which Hard Rule 7's
170
+ `nativeSessionId` uniqueness forbids. **A different key was then found, and it is not a
171
+ marker at all:** every `tools/call` carries `_meta.threadId` plus an
172
+ `x-codex-turn-metadata.{session_id,thread_id,turn_id}` block, so the caller names itself on
173
+ each call — and that id is byte-identical to the hook's `session_id`, so birth, delivery and
174
+ tool calls share ONE identifier and `record.nativeSessionId = threadId` needs no mapping.
175
+ Both halves are vendor-traced, not just captured: `core/src/mcp_tool_call.rs:1328-1349`
176
+ inserts `threadId` unconditionally (constant at `:1184`) from the call site at `:506-516`,
177
+ and `:1238-1263` carries the turn-metadata block.
178
+ (The registry's pre-existing `nativeIdLabel: "threadId"` is right on that axis; its `D6` on
179
+ the same row still is not.) Consuming `_meta` is new bridge code and is step 6, unstarted.
180
+ - **Both admission questions this lane opened have since been CLOSED by measurement**, and
181
+ neither cost a design decision. The **hook trust prompt** has a real non-interactive path: a
182
+ hook in the managed `/etc/codex/config.toml` layer runs with no prompt, in both launch modes,
183
+ with `turn/start` wake intact — while `--dangerously-bypass-hook-trust` runs the hook but
184
+ kills auto-attach and is therefore unusable here. The remaining constraint is ownership:
185
+ `/etc/codex/` is root-owned, so that is a root-level operator step, not something `setup`
186
+ writes (Hard Rule 17). **Clause 4** has a working carrier: `thread/name/set` plus
187
+ `[tui] status_line = ["thread-title", …]` renders a garden id and survives turns in both
188
+ orderings, because the vendor's auto-titler is guarded on the thread being unnamed
189
+ (`tui/src/app/thread_routing.rs:1841`). It is reachable only over the app-server, and the
190
+ config key needs a writer that owns exactly it.
138
191
 
139
192
  ### Copilot CLI: one citizen, two rails, one pending receipt
140
193
 
package/README.md CHANGED
@@ -79,6 +79,33 @@ A few words that look unusual for a coding tool.
79
79
 
80
80
  ## Install
81
81
 
82
+ **Platform evidence, in one breath.** The Entwurf-only install surface on
83
+ macOS is CERTIFIED (CI) (`macos-install-surface`). On macOS every
84
+ garden-native harness rail (pi, Claude, Copilot, OMP, agy), marker join,
85
+ ACP turn, and mux is NOT CERTIFIED — pending physical host; on Linux those
86
+ same rails are the certified axis. native Windows is UNSUPPORTED.
87
+ CERTIFIED (CI) is weaker than a physical-host doctor green.
88
+ The npm package has no `os` restriction; that is installability, not a
89
+ support claim.
90
+
91
+ **macOS in this release.** This release adds macOS support for Entwurf's
92
+ install surface: the npm package installs, `entwurf --help` and `entwurf
93
+ check-bridge` boot, and `entwurf setup` composes the integrations it finds.
94
+ The four installers that previously rejected Darwin by platform name no longer
95
+ do. We validated that surface only in macOS CI because the developers did not
96
+ have a physical Mac. So macOS native-harness rails—marker join, an ACP turn,
97
+ and mux included—are not yet certified; setup writes their wiring but reports
98
+ them non-green. Linux's certified rail status is unchanged.
99
+
100
+ On Darwin, `entwurf setup` that detects a harness is intentionally
101
+ non-green: the wiring WAS written and nothing failed to install, but the
102
+ harness rail is NOT CERTIFIED — pending physical host. That FAIL is not
103
+ an install defect. An Entwurf-only host (no harness on PATH) stays green.
104
+
105
+ A physical Mac can send host facts without installing or logging in:
106
+ `scripts/raw-macos-measure/probe.sh` (`/bin/sh`, ~3.5s). Measurement,
107
+ not certification.
108
+
82
109
  `entwurf` is a neutral npm package first. Get the package, then run **`entwurf setup
83
110
  <project>`** — one command, the same front door from an npm global install, an npm
84
111
  project-local install, or a source checkout. It composes every harness it finds on the
@@ -187,6 +214,9 @@ gitignored and may be absent or stale immediately after a checkout or pull.
187
214
 
188
215
  ### Pi adapter / ACP plugin lane
189
216
 
217
+ This rail is CERTIFIED on Linux; on macOS it is NOT CERTIFIED — pending
218
+ physical host (control sockets, mux, ACP plugin hosting).
219
+
190
220
  To use the `entwurf` provider inside pi, install a compatible pi binary
191
221
  separately (`@earendil-works/pi-coding-agent >=0.85.1 <0.86`). Then point pi at
192
222
  the npm-installed package or development clone:
@@ -217,10 +247,10 @@ for every harness it detects — you do not paste this list to install. This is
217
247
  surface: each unit has its own installer, its own doctor with a named refusal, and its own
218
248
  inverse, so a single broken unit can be redone without touching the rest.
219
249
 
220
- - **Claude Code** (Linux-certified axis) — `install-meta-bridge`, `doctor-meta-bridge`.
221
- - **Antigravity / agy** — `install-agy-bridge`, `install-agy-statusline`, `install-agy-hooks`, each with a matching `doctor-agy-*`.
222
- - **GitHub Copilot CLI** — four independent units, four independent failure modes: `install-copilot-bridge` (birth: garden id + who-sent, on the first prompt), `install-copilot-mcp` (the entwurf tool hand, where `entwurf_inbox_read` lives), `install-copilot-receive` (the receiver extension: doorbell + receiver marker), `install-copilot-statusline` (optional for a manual citizen, required for supported fresh) — each with a matching `doctor-copilot-*` and `uninstall-copilot-*`.
223
- - **OMP (`omp`)** — four units, in-process extensions rather than launchers: `install-omp-bridge` (birth: the `mode === "tui"` visible host, its garden id on the status line, and who-sent), `install-omp-mcp` (the omp-native `entwurf-bridge` entry), `install-omp-config` (the one operator setting `tools: xdev: false`, without which the vendor mounts MCP tools as `xd://` devices the model cannot call), `install-omp-receive` (the receiver extension: mailbox watch + announce-only doorbell) — each with a matching `uninstall-omp-*`, and a `doctor-omp-*` for all but the setting, whose runtime axis `doctor-omp-mcp` owns. The setting writer owns exactly the lines it adds and refuses an explicit operator `tools: xdev: true` by name rather than overwriting it.
250
+ - **Claude Code** (Linux CERTIFIED; macOS NOT CERTIFIED — pending physical host) — `install-meta-bridge`, `doctor-meta-bridge`.
251
+ - **Antigravity / agy** (Linux CERTIFIED; macOS NOT CERTIFIED pending physical host) — `install-agy-bridge`, `install-agy-statusline`, `install-agy-hooks`, each with a matching `doctor-agy-*`.
252
+ - **GitHub Copilot CLI** (Linux CERTIFIED; macOS NOT CERTIFIED pending physical host) — four independent units, four independent failure modes: `install-copilot-bridge` (birth: garden id + who-sent, on the first prompt), `install-copilot-mcp` (the entwurf tool hand, where `entwurf_inbox_read` lives), `install-copilot-receive` (the receiver extension: doorbell + receiver marker), `install-copilot-statusline` (optional for a manual citizen, required for supported fresh) — each with a matching `doctor-copilot-*` and `uninstall-copilot-*`.
253
+ - **OMP (`omp`)** (Linux CERTIFIED; macOS NOT CERTIFIED pending physical host) — four units, in-process extensions rather than launchers: `install-omp-bridge` (birth: the `mode === "tui"` visible host, its garden id on the status line, and who-sent), `install-omp-mcp` (the omp-native `entwurf-bridge` entry), `install-omp-config` (the one operator setting `tools: xdev: false`, without which the vendor mounts MCP tools as `xd://` devices the model cannot call), `install-omp-receive` (the receiver extension: mailbox watch + announce-only doorbell) — each with a matching `uninstall-omp-*`, and a `doctor-omp-*` for all but the setting, whose runtime axis `doctor-omp-mcp` owns. The setting writer owns exactly the lines it adds and refuses an explicit operator `tools: xdev: true` by name rather than overwriting it.
224
254
 
225
255
  Run them as `entwurf <command>`. Which unit a doctor's refusal names, and the clean-host
226
256
  walk-through for each harness, live in [docs/setup-clean-host.md](./docs/setup-clean-host.md).
@@ -275,10 +305,10 @@ Copilot units included — and restart its existing processes; reach for a singl
275
305
  only when a **new** session using the
276
306
  installed artifact makes `doctor-meta-bridge` exit 0 with the live owner join.
277
307
 
278
- Linux is the only currently certified Claude meta-bridge axis. New macOS wiring is
279
- refused because the strict live-owner doctor depends on `/proc`; Darwin uninstall
280
- remains available for legacy cleanup, and the neutral package itself has no `os`
281
- restriction. Detailed diagnosis and clean-host steps live in
308
+ The Claude meta-bridge rail is CERTIFIED on Linux. On macOS it is
309
+ NOT CERTIFIED pending physical host. The Darwin install fence is
310
+ open; uninstall was already open. Detailed diagnosis and clean-host
311
+ steps live in
282
312
  [docs/setup-clean-host.md](./docs/setup-clean-host.md).
283
313
 
284
314
  The active citizen store is V3-only. A store that fails certification is never
@@ -303,7 +333,8 @@ host evidence boundaries are [VERIFY.md](./VERIFY.md) and [BASELINE.md](./BASELI
303
333
  2. **`require.resolve(...)` against the bundled package dependency** (`@agentclientprotocol/claude-agent-acp`). This is the default path; no extra global install needed.
304
334
  3. **`PATH:claude-agent-acp` fallback** — used when the package resolution fails (e.g. a hand-edited `node_modules`).
305
335
 
306
- The curated model registry exposes unprefixed Claude ids plus `cortex-` rows.
336
+ The curated model registry exposes unprefixed Claude ids `claude-opus-5`, `claude-sonnet-5`,
337
+ `claude-fable-5-1` — plus the `cortex-` rows below.
307
338
  Codex is not an ACP backend or a shipped managed citizen lane: it has verified
308
339
  native-delivery probe evidence only. No managed Codex support is claimed; lifecycle,
309
340
  identity, installation, and doctors remain prerequisites for any such lane.
package/VERIFY.md CHANGED
@@ -77,6 +77,7 @@ Do not collapse source, package, fixture, and native-host evidence into one “g
77
77
  | Packed install | `check-pack-install` | Real tarball, but checkout-visible. |
78
78
  | Linux artifact consumer | required `check-install-container` CI job against one preserved candidate | Fixtures prove package/oracle shape, not a real Claude lifecycle. |
79
79
  | Exact release commit | all required CI jobs green, and the `check` job's qualification body step concluded success, at the exact SHA | A different green SHA is not transferable evidence. |
80
+ | macOS Entwurf-only install | required `macos-install-surface` CI job at the exact release SHA | Shape-only, CERTIFIED (CI): certifies the Entwurf-only install path on macOS only — never Claude/Copilot/OMP/agy wiring, the pi rail, ACP or mux. Promoted from non-voting (`continue-on-error`) to required in 0.20.0 after its first CERTIFIED (CI) green on a GitHub Actions `macos-latest` runner (not a physical host): run 34303884286 @ `70eda03` (2026-09-09), 65s, all 10 steps success — the packed candidate installed clean, `entwurf --help` and `entwurf check-bridge` ran (the latter listing the seven current `entwurf-bridge` MCP tools), an all-harness-absent `entwurf setup` reached `result: green` across the five documented SKIP probes (`pi`/`claude`/`agy`/`copilot`/`omp`), and five checked paths (`.pi`, `settings.json`, `.gemini`, `.copilot`, `auth.json.bak`) plus a byte-identical `auth.json` proved zero harness/credential writes. A macOS runner failure now blocks every release cut, the same as any other required job. |
80
81
  | LIVE runtime | `LIVE=1 ./run.sh release-gate <scratch> --cut` plus any shipped on-demand backend axis | `--cut` enforces `SKIP=0`; a red wired gate blocks the cut. |
81
82
  | Native Claude host | installed strict doctor against a new real session | Missing live join is `NOT CERTIFIED`, not a fixture PASS. |
82
83
  | Native agy host | three doctors plus conversation-id-gated native-push round trip | Aggregate release-gate does not own an agy conversation id. |
@@ -155,6 +156,13 @@ Expected tail on a fully green host: `DONE: entwurf setup — result: green (com
155
156
 
156
157
  The wiring / meta-bridge / smoke steps are internal building blocks of `setup` (`install_local_package`, `scripts/meta-bridge-install.sh`, `validate_entwurf_bridge`) — call `setup`, never the parts. Consumers who `npm install @junghanacs/entwurf` get the obvious npm surface; that path is not the developer concern here.
157
158
 
159
+ Installation portability and rail certification are separate axes (Hard Rule 17).
160
+ A harness-absent `setup` on the macOS CI runner reaching `result: green` is
161
+ CERTIFIED (CI) for the Entwurf-only install surface only. On a platform that is
162
+ not certified, a detected harness is named non-green (FAIL) whose wording is
163
+ not an install failure: the wiring WAS written, but the rail is NOT CERTIFIED —
164
+ pending physical host. That FAIL is the honest setup verdict, not a skip.
165
+
158
166
  ### 1.1 Variables (optional)
159
167
 
160
168
  ```bash
@@ -286,7 +294,7 @@ Pass: user/assistant turns accumulate normally; the transcript is not broken/emp
286
294
  The minimum passing bar:
287
295
 
288
296
  1. **Deterministic floor green:** `pnpm run check:full` passes (the core tier plus the hermetic-integration and package/install tiers, incl. `check-pack`), plus a `./run.sh check-gate-qualification` green on the same candidate.
289
- 2. **All three CI jobs green on the exact release commit:** `check`, `install-surface`, and the required Linux `artifact-consumer`; preserve the latter's tarball digest and image identity.
297
+ 2. **All four required CI jobs green on the exact release commit:** `check`, `install-surface`, the required Linux `artifact-consumer`, and `macos-install-surface` — promoted from non-voting to required in 0.20.0 (see the release acceptance axes table above for what its green run does and does not certify); preserve the Linux artifact-consumer's tarball digest and image identity. A macOS runner failure now blocks the cut like any other required job.
290
298
  3. **Live floor MUST green:** `LIVE=1 ./run.sh release-gate <dir> --cut` exits 0 reporting `MUST PASS=N FAIL=0 SKIP=0`; with `--cut` a single SKIP is red, so the exit code itself now carries this condition. A BEHAVIOR FAIL is advisory, not blocking.
291
299
  4. **Native-host doctor green where the Claude meta-bridge is claimed:** a new post-install Claude session exists, live evidence is present, and the installed `doctor-meta-bridge` exits 0. `NOT CERTIFIED` is a release failure for that host, not a skip.
292
300
  5. **Honest self-recognition:** the bridged model identifies its actual harness/backend, lists `entwurf-bridge` as the single MCP server with its seven current tools, and presents a backend-native (not normalized) tool surface.
@@ -197,7 +197,7 @@ operator's repair named.
197
197
 
198
198
  | Seam | Claude | Cortex Code |
199
199
  |---|---|---|
200
- | Model ids | unprefixed `claude-sonnet-5`, `claude-opus-5` | `cortex-auto`, `cortex-claude-opus-5`, `cortex-claude-sonnet-5`, `cortex-openai-gpt-5.4`; prefix stripped before set-model |
200
+ | Model ids | unprefixed `claude-sonnet-5`, `claude-opus-5`, `claude-fable-5-1` | `cortex-auto`, `cortex-claude-opus-5`, `cortex-claude-sonnet-5`, `cortex-openai-gpt-5.4`; prefix stripped before set-model |
201
201
  | Launch | bundled `claude-agent-acp`; `CLAUDE_AGENT_ACP_COMMAND` override | `cortex acp serve`; optional connection; `CORTEX_ACP_COMMAND` override; never a launch-time `-m` |
202
202
  | Model authority | per-turn ACP set-model | per-turn ACP set-model; an unavailable curated id fails before prompt |
203
203
  | Carrier | engraving in `_meta.systemPrompt` | no system-prompt carrier; engraving rides the first-user augment |
@@ -256,6 +256,14 @@ Cortex containment was measured against the live CLI rather than copied from Cla
256
256
  exact-writes an overlay-private `cortex/mcp.json`. Non-stdio declarations fail before
257
257
  spawn. Only the `entwurf-bridge` entry receives the real operator HOME required to
258
258
  see the garden store.
259
+ - **`realHome` absoluteness:** the D10 guard judges the captured `realHome` in BOTH
260
+ path flavors (POSIX and win32), so the refusal rule states the contract rather than
261
+ the host it happens to run on. This claims no native-Windows support — native
262
+ Windows is UNSUPPORTED. The certified ACP axis remains Linux
263
+ desktop/workstation; macOS ACP turns are NOT CERTIFIED — pending physical
264
+ host. The flavor-explicit form only stops a POSIX host from reading a
265
+ drive/UNC path as relative, which is what made the defect unkillable on
266
+ Linux (PR #77).
259
267
  - **Carrier:** Cortex has no `_meta.systemPrompt` contract. The engraving is placed at
260
268
  the head of the first-user augment; claiming a system-prompt engraving is false.
261
269
 
@@ -52,9 +52,12 @@ Prerequisites on the host running the external MCP client:
52
52
  > carrier reader trims and tests truthiness, so empty and absent are the same answer by
53
53
  > construction. Pinned by `[QK:FRESHCALL-IDENTITY-SCRUB]` in the `check-mux-fresh-call` vitest lane,
54
54
  > inside `check:full`. The DETECT half is unchanged and still load-bearing, because a seam covers
55
- > only the launches that pass through it: `doctor-omp-bridge` reads `/proc/<pid>/environ` for every
56
- > live `omp` process and goes RED on its own axis when one carries either carrier. An omp the
57
- > operator started from a pi citizen's bash never touched the seam and is still unsupported, exactly
55
+ > only the launches that pass through it: `doctor-omp-bridge` reads each live `omp`
56
+ > process's environment (on Linux, `/proc/<pid>/environ`) and goes RED on its own
57
+ > axis when one carries either carrier. The remaining uncertified Darwin axis is
58
+ > per-process environment DISCOVERY, not `/proc` absence; macOS rails are
59
+ > NOT CERTIFIED — pending physical host. An omp the operator started
60
+ > from a pi citizen's bash never touched the seam and is still unsupported, exactly
58
61
  > as this boundary says.
59
62
 
60
63
  Example env file: