test(fleet): make stale marker BusyBox-safe (#1043 )

test(fleet): carry identity regression in CI (#1043 )
fix(fleet): propagate roster git identity (#1043 )
2026-08-06 00:23:08 -05:00 · 2026-08-05 23:52:44 -05:00 · 2026-08-05 23:28:28 -05:00
52 changed files with 659 additions and 4592 deletions
@@ -1,68 +0,0 @@
-# C1 detector gate. The fixture itself is intentionally RED; CI is green only
-# when its exact phase verdicts/reasons match the versioned expected-RED manifest.
-when:
-  - event: [pull_request, manual]
-  - event: push
-    branch: [next, main]
-
-steps:
-  greenfield-git-present:
-    image: node:22-bookworm-slim
-    commands:
-      - |
-        set +e
-        MOSAIC_GREENFIELD_CONTAINER=1 \
-          bash tools/e2e-install-test.sh --lane next --source checkout --git present \
-          > /tmp/greenfield-git-present.log 2>&1
-        fixture_status=$?
-        set -e
-        cat /tmp/greenfield-git-present.log
-        bash tools/verify-greenfield-expected-red.sh \
-          next-git-present /tmp/greenfield-git-present.log "$fixture_status"
-
-  greenfield-main-git-present:
-    image: node:22-bookworm-slim
-    commands:
-      - |
-        set +e
-        MOSAIC_GREENFIELD_CONTAINER=1 \
-          bash tools/e2e-install-test.sh --lane main --source checkout --git present \
-          > /tmp/greenfield-main-git-present.log 2>&1
-        fixture_status=$?
-        set -e
-        cat /tmp/greenfield-main-git-present.log
-        bash tools/verify-greenfield-expected-red.sh \
-          main-git-present /tmp/greenfield-main-git-present.log "$fixture_status"
-
-  greenfield-remote-installer-contract:
-    image: node:22-bookworm-slim
-    commands:
-      - |
-        expected="$(awk 'NF {print $1; exit}' tools/install.sh.sha256)"
-        actual="$(sha256sum tools/install.sh | awk '{print $1}')"
-        test "$actual" = "$expected"
-        set +e
-        MOSAIC_GREENFIELD_CONTAINER=1 \
-          MOSAIC_FIXTURE_INSTALLER_URL="https://git.mosaicstack.dev/mosaicstack/stack/raw/commit/${CI_COMMIT_SHA}/tools/install.sh" \
-          MOSAIC_FIXTURE_INSTALLER_SHA256="$expected" \
-          bash tools/e2e-install-test.sh --lane next --source remote --git present \
-          > /tmp/greenfield-remote.log 2>&1
-        fixture_status=$?
-        set -e
-        cat /tmp/greenfield-remote.log
-        bash tools/verify-greenfield-expected-red.sh \
-          next-git-present /tmp/greenfield-remote.log "$fixture_status"
-
-  greenfield-git-absent:
-    image: node:22-bookworm-slim
-    commands:
-      - |
-        set +e
-        MOSAIC_GREENFIELD_CONTAINER=1 \
-          bash tools/e2e-install-test.sh --lane next --source checkout --git absent \
-          > /tmp/greenfield-git-absent.log 2>&1
-        fixture_status=$?
-        set -e
-        cat /tmp/greenfield-git-absent.log
-        bash tools/verify-greenfield-expected-red.sh \
-          next-git-absent /tmp/greenfield-git-absent.log "$fixture_status"
@@ -7,21 +7,20 @@ Mosaic gives you a unified launcher for Claude Code, Codex, OpenCode, and Pi —
 ## Quick Install

 ```bash
-d="$(mktemp -d)" && trap 'rm -rf "$d"' EXIT && curl -fsSL -o "$d/install.sh" https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh -o "$d/install.sh.sha256" https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh.sha256 && (cd "$d" && test -s install.sh && sha256sum -c install.sh.sha256 && bash install.sh)
+curl -fsSL https://mosaicstack.dev/install.sh | bash
 ```

-The published installer body must be non-empty and match its versioned SHA-256
-sidecar before it executes. A failed fetch, HTTP-200 empty body, or digest
-mismatch is fatal. Because both files come from the same repository and trust
-domain, this detects corruption or inconsistent publication—not repository or
-server compromise. Independently signed release provenance is explicitly
-deferred by the greenfield-install PRD.
+Or use the direct URL:
+
+```bash
+bash <(curl -fsSL https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh)
+```

 The installer auto-launches the setup wizard, which walks you through gateway install and verification. Flags for non-interactive use:

 ```bash
-(cd "$d" && bash install.sh --yes)                   # Accept all defaults
-(cd "$d" && bash install.sh --yes --no-auto-launch)  # Install only, skip wizard
+bash <(curl -fsSL …) --yes               # Accept all defaults
+bash <(curl -fsSL …) --yes --no-auto-launch  # Install only, skip wizard
 ```

 This installs both components:
@@ -31,16 +30,6 @@ This installs both components:
 | **Framework**           | Bash launcher, guides, runtime configs, tools, skills            | `~/.config/mosaic/`  |
 | **@mosaicstack/mosaic** | Unified `mosaic` CLI — TUI, gateway client, wizard, auto-updater | `~/.npm-global/bin/` |

-### Install lanes
-
-| Lane                     | Command                               | Use when                                              | Source                                                                                      |
-| ------------------------ | ------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| Stable                   | `bash tools/install.sh`               | You want the released Mosaic CLI/framework            | npm registry `@mosaicstack/mosaic@latest` + framework archive at `main`                     |
-| Prerelease integration   | `bash tools/install.sh --next`        | You want the current `next` integration branch        | Exact `@next` CLI/gateway versions + pinned `next` framework commit; pinned-source fallback |
-| Contributor/source build | `bash tools/install.sh --dev --ref X` | You are testing a branch before release; `--ref` wins | Build-from-source at the requested ref                                                      |
-
-`--next` selects the prerelease integration lane. It installs the exact CLI/gateway versions resolved from the aligned `@next` tags, and pins the framework archive to the resolved `next` commit. If the registry path fails, it builds from that pinned source. An explicit `--ref` or `MOSAIC_REF` wins and selects source mode.
-
 After install, the wizard runs automatically or you can invoke it manually:

 ```bash
@@ -49,14 +38,10 @@ mosaic wizard        # Full guided setup (gateway install → verify)

 ### Requirements

- Linux x86_64 with glibc (Debian is the greenfield CI platform; musl/Alpine, macOS, and ARM64 currently fail as unsupported)
- Node.js ≥ 20 and npm ≥ 9
- `bash`, `curl`, `git`, `python3`, `tar`, and standard core utilities (`awk`, `df`, `find`, `flock`, `grep`, `install`, `realpath`, `sed`, `sha256sum`, `stat`, `sync`)
- At least 256 MiB free disk and 1,000 free inodes at the npm prefix
+- Node.js ≥ 20
+- npm (for global @mosaicstack/mosaic install)
 - One or more runtimes: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenCode](https://opencode.ai), or [Pi](https://github.com/mariozechner/pi-coding-agent)

-The installer evaluates canonical phases P0–P9 and does not print `Done.` unless every committed postcondition passes. A failed phase exits non-zero, names the phase, and points to its durable journal under `${XDG_STATE_HOME:-~/.local/state}/mosaic/install/`. See [Installer state machine and recovery](docs/guides/installer-state-machine.md).
-
 ## Usage

 ### Launching Agent Sessions
@@ -349,10 +334,16 @@ Each stage has a dispatch mode (`exec` for research/review, `yolo` for coding),

 ## Upgrading

-Run the same verified installer flow again — it handles upgrades automatically:
+Run the installer again — it handles upgrades automatically:

 ```bash
-d="$(mktemp -d)" && trap 'rm -rf "$d"' EXIT && curl -fsSL -o "$d/install.sh" https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh -o "$d/install.sh.sha256" https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh.sha256 && (cd "$d" && test -s install.sh && sha256sum -c install.sh.sha256 && bash install.sh)
+curl -fsSL https://mosaicstack.dev/install.sh | bash
+```
+
+Or use the direct URL:
+
+```bash
+bash <(curl -fsSL https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/main/tools/install.sh)
 ```

 Or use the CLI:
@@ -367,17 +358,15 @@ The CLI also performs a background update check on every invocation (cached for
 ### Installer Flags

 ```bash
-bash tools/install.sh --check           # Side-effect-free P0-P8 postcondition check
+bash tools/install.sh --check           # Version check only
 bash tools/install.sh --framework       # Framework only (skip npm CLI)
 bash tools/install.sh --cli             # npm CLI only (skip framework)
-bash tools/install.sh --next            # Prerelease lane: exact @next versions + pinned-source fallback
-bash tools/install.sh --dev             # Contributor lane: source build at --ref/main
-bash tools/install.sh --ref v1.0        # Install from a specific git ref (--ref wins over --next)
+bash tools/install.sh --ref v1.0        # Install from a specific git ref
 bash tools/install.sh --yes             # Non-interactive, accept all defaults
 bash tools/install.sh --no-auto-launch  # Skip auto-launch of wizard
 ```

-The installer rejects unrecognized flags or positional arguments before making changes and prints the supported-option usage. `--check` reports one PASS/FAIL row for each P0–P8 predicate and exits non-zero if any row fails; it does not create the npm prefix, lock, journal, manifest, or runtime files.
+The installer rejects unrecognized flags or positional arguments before making changes and prints the supported-option usage.

 ## Contributing

@@ -146,6 +146,36 @@ lands. M0 consists only of these normative requirements, the complete task DAG,
 documentation IA checklist, and the legacy example/profile disposition inventory. Subsequent cards
 are defined in [docs/TASKS.md](./TASKS.md) and must remain one card/one PR.

+### Fleet git identity launch propagation (#1043)
+
+#### Problem and objective
+
+A fleet seat can have a registered per-agent Git credential while its launched runtime process lacks
+`MOSAIC_GIT_IDENTITY`. The credential resolver then cannot select the seat identity reliably, which
+blocks repository operations on fail-closed estates and can fall through to an unrelated identity on
+estates where that refusal is not active. The objective is to make Git identity a deterministic,
+roster-derived part of the generated launch projection and prove it reaches the launched process.
+
+#### Normative requirements
+
+1. `FGI-REQ-01`: Every generated fleet agent projection SHALL declare
+   `MOSAIC_GIT_IDENTITY=<MOSAIC_AGENT_NAME>`; a differing or unsafe identity SHALL fail closed before
+   tmux launch.
+2. `FGI-REQ-02`: The clean `/usr/bin/env -i` pane boundary SHALL pass every variable declared by the
+   generated projection, including `MOSAIC_GIT_IDENTITY`, to the launched runtime process.
+3. `FGI-REQ-03`: A behavioral integration test SHALL set-compare the complete generated projection
+   against the launched process environment. Source-text/string-presence assertions are insufficient.
+4. `FGI-REQ-04`: Verification SHALL include RED-first evidence and a delete-the-subject mutation that
+   removes Git-identity pane propagation and makes the behavioral test fail.
+
+#### Acceptance criteria
+
+1. `AC-FGI-01`: A launched seat process contains every key/value pair declared by its generated
+   environment projection, including the roster-derived Git identity.
+2. `AC-FGI-02`: Missing, unsafe, or split Git identity is rejected before a tmux session is created.
+3. `AC-FGI-03`: Focused launcher and generated-environment tests, repository quality gates,
+   independent review, and the required RED/green/R7 evidence are recorded before push.
+
 ---

 ## Exact Cross-Harness Fleet Communications Contract (#766)
@@ -1368,42 +1398,3 @@ All work is **alpha** (< 0.1.0) until Jason approves 0.1.0 beta release.
 10. ASSUMPTION: **Conversations and messages get their own PG tables** (not stored in brain's entity model). They follow a chat-specific schema with proper foreign keys to users and projects. Rationale: Chat has different access patterns (streaming, pagination, search) than brain entities.

 11. RESOLVED: **Pi handles all target LLM providers natively.** Anthropic, OpenAI/Codex, Z.ai, Ollama, LM Studio, and llama.cpp are all supported via Pi's built-in providers or `models.json` configuration with `openai-completions` API type. No custom provider adapters needed in @mosaicstack/agent — only configuration management.
-
---
-
-## Greenfield install correctness — C1 (#1050)
-
-### Problem and objective
-
-A from-zero install can report success while leaving the target host unusable because the installer has no transactional state machine capable of certifying its own postconditions. C1 supplies the structural spine and red-first fixture; later cards repair the individual failed postconditions.
-
-### Normative requirements
-
-1. The installer SHALL implement the canonical P0–P9 numbering from the greenfield-install PRD v2: P0 Resolve context; P1 Preflight; P2 Acquire artifacts; P3 Install CLI; P4 Install framework + skills; P5 Identity; P6 Runtime linking / activation; P7 Services; P8 Shell discoverability; P9 Verify + commit. P2 is scoped to installer-distribution artifacts and SHALL NOT foreclose credentialed downstream acquisition. P5 owns validating any credential capability required by requested downstream work; P7 may provision credential-dependent resources only after that P5 postcondition commits.
-2. Every phase SHALL declare preconditions, action, committed postconditions, and rollback. An unverifiable postcondition SHALL fail the install non-zero with the named phase and a remediation line; no best-effort failure may still certify success. P1's required-tool closure includes tools invoked by later phases, including `git`; a downstream prerequisite may not remain undeclared and degrade silently.
-3. A durable mutation journal SHALL open before the first mutation and commit at P9. Fallible command output needed to diagnose a phase SHALL be journaled and surfaced, never discarded.
-4. `--check` SHALL run exactly the P0–P8 postcondition predicates without mutation, report each phase PASS/FAIL, and exit non-zero if any predicate fails.
-5. P4 SHALL consume a checkout-free, lane/versioned shipped-set declaration published by the installer. C1 SHALL NOT select among the currently disagreeing framework-payload, repository-root, sync-source, and W-jarvis populations; while no declaration exists, P4 reports `NOT-MEASURED / UNDECLARED` and remains blocking rather than fabricating a count. C5 owns the declaration's contents and containment/loadability fulfillment.
-6. The from-zero fixture SHALL be lane-parametric, use Debian/glibc, run the documented install command as a non-root target user with an isolated HOME, and inherit no host credentials, npm cache, home directory, or runtime configuration.
-7. The fixture SHALL select `next` with `--next` or `MOSAIC_NEXT=1` and assert the resolved lane version. Internal predicates use P3's absolute CLI path; shell discoverability is tested only at P8.
-8. Fault injection after each P2–P8 phase SHALL prove either clean rollback or a durable, honestly reported resumable partial state, with no journal incorrectly left in progress.
-9. Unsupported musl/Alpine and unavailable Docker SHALL fail loudly rather than skip as pass. The repository's installer tests SHALL nevertheless run in the canonical Alpine CI image by explicitly modeling a supported non-root/glibc target and using portable filesystem enumeration.
-10. P0 SHALL bind the effective uid and username to the authoritative passwd HOME and shell and state/reject unsafe root or sudo-with-inherited-HOME privilege contexts.
-11. Created paths SHALL satisfy phase-specific target owner/group and mode policy: P3 executables are not group/world writable, framework/runtime trees are not group/world writable, and identity/credential material is private.
-12. The expected-RED comparator SHALL validate the complete manifest before selecting a case: exact case population, one exit and P0–P9 disposition per case, pinned require/forbid classes, and no malformed, duplicate, or unknown rows.
-13. The published installer contract SHALL reject failed fetches, HTTP-success empty bodies, and digest mismatch, then execute the exact digest-verified body. The remote CI arm SHALL bind that body to the immutable CI commit.
-14. Phase diagnostics SHALL be redacted before terminal or durable-log output. A seeded positive-control canary SHALL remain absent from observed argv, output, command logs, npm configuration, generated files, and shell history.
-
-### C1 acceptance criteria
-
-1. The pre-C1 from-zero matrix records both discriminating controls: with `git` absent, the legacy installer still exits zero while P1 fails and skill sync degrades; with `git` present, P1 passes and the observed sync store/runtime links are 101/101. The C1 installer must fail at P1 before mutation when `git` is absent.
-2. The discriminating P3 row passes: the binary exists at the expected absolute path and reports exactly the resolved `next` lane version, while P4, P5, and P8 fail.
-3. The `--check` mutation negative control proves host fingerprints are byte-identical before and after observation.
-4. Woodpecker executes and validates the expected RED fixture plus the immutable remote-installer contract; C1 does not repair P4/P5/P8 or activate #869.
-5. Negative controls prove manifest shrink/duplicates/unknown rows fail, unsafe P0/P3/P4/P5 contexts fail, the P2–P8 fault seam enters real actions rather than synthetic writes, empty/mismatched fetched bodies fail, and a deliberately emitted secret canary is redacted from every persisted/output population.
-
-### Explicit exclusions and dependencies
-
- C2 owns P8/PATH, C3 owns P5/headless identity, C4 owns P6 activation policy, and C5 owns P4/skills.
- Main-lane execution is a promotion precondition owned by #1037; C1 only makes the fixture lane-parametric.
- RM-02 and #869 activation are out of scope.
@@ -9,11 +9,6 @@
 - [Whole mutator-class gate](architecture/mutator-class-gate.md) — default-deny policy, revoke-first/promote-last state machine, TTL, runtime adapters, and T-B/T-C assurance boundary.
 - [Compaction revocation lifecycle](architecture/compaction-revocation.md) — Claude/Pi observer matrix, same-PID generation rollover, failure fencing, and the named bounded residual stale window.

-## Installation and upgrades
-
- [Installer state machine and recovery](guides/installer-state-machine.md) — canonical P0–P9 phases, side-effect-free checks, durable journal states, rollback/remediation, and the Debian greenfield CI gate.
- [Upgrade safety and recovery](guides/upgrade-safety-and-recovery.md) — framework ownership, durable operator snapshots, verify net, and projection regeneration.
-
 ## CLI and skill management

 - [Skill registration user guide](guides/user-guide.md#claude-code-skill-registration) — register, unregister, list statuses, automatic install/update reconciliation, and Claude reload behavior.
@@ -5,14 +5,14 @@ Generated environment files are rebuildable projections, not an operator-editabl

 ## Launch chain

-| Layer               | Responsibility                                                                                                                  |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| Roster              | `fleet/roster.yaml` supplies the agent name, class, supported runtime, model, reasoning, tool policy, workdir, and tmux socket. |
-| Projection writer   | Renders deterministic fleet/agents/<name>.env.generated from the roster.                                                        |
-| Optional local data | Reads a strict, data-only fleet/agents/<name>.env.local; it cannot shadow generated keys.                                       |
-| systemd             | Starts the launcher with env -i and fixed bootstrap data. It does not preload either environment file.                          |
-| session launcher    | Validates generated and local data before it queries, creates, or stops an exact tmux session.                                  |
-| runtime launch      | Derives the fixed mosaic yolo <runtime> argument array from validated roster data, then seeds the runtime contract.             |
+| Layer               | Responsibility                                                                                                                                                                     |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Roster              | `fleet/roster.yaml` supplies the agent name, class, supported runtime, model, reasoning, tool policy, workdir, and tmux socket; Git identity is derived from the exact agent name. |
+| Projection writer   | Renders deterministic fleet/agents/<name>.env.generated from the roster.                                                                                                           |
+| Optional local data | Reads a strict, data-only fleet/agents/<name>.env.local; it cannot shadow generated keys.                                                                                          |
+| systemd             | Starts the launcher with env -i and fixed bootstrap data. It does not preload either environment file.                                                                             |
+| session launcher    | Validates generated and local data before it queries, creates, or stops an exact tmux session.                                                                                     |
+| runtime launch      | Derives the fixed mosaic yolo <runtime> argument array from validated roster data, then seeds the runtime contract.                                                                |

 The launcher never `source`s or `eval`s an environment file and never accepts an environment-supplied
 command. `MOSAIC_AGENT_COMMAND`, command/channel overrides, unknown keys, generated-key shadowing,
@@ -24,6 +24,7 @@ secret-like key names, duplicate keys, comments, quoted/export syntax, and unsaf

 ```dotenv
 MOSAIC_AGENT_NAME=<roster name>
+MOSAIC_GIT_IDENTITY=<roster name>
 MOSAIC_AGENT_CLASS=<roster class>
 MOSAIC_AGENT_RUNTIME=<roster runtime>
 MOSAIC_AGENT_MODEL=<roster model hint>
@@ -33,8 +34,10 @@ MOSAIC_AGENT_WORKDIR=<absolute roster work directory>
 MOSAIC_TMUX_SOCKET=<roster socket or empty>
 ```

-The generated launch contract supports `claude`, `codex`, `opencode`, and `pi`. mosaic fleet add
-rejects another runtime before it writes the roster or modifies generated, local, or quarantine state.
+`MOSAIC_GIT_IDENTITY` is not independently configurable: it must equal `MOSAIC_AGENT_NAME`, preventing
+split runtime and repository identity authority. The generated launch contract supports `claude`,
+`codex`, `opencode`, and `pi`. mosaic fleet add rejects another runtime before it writes the roster or
+modifies generated, local, or quarantine state.
 The legacy dogfood stub remains an observability-only canary on its separate `mosaic-factory` socket;
 it has no generated-launch adapter and cannot be added through this path.

@@ -3,11 +3,12 @@
 The launcher consumes validated data, not shell configuration.

 1. Read and validate the canonical roster.
-2. Render deterministic <name>.env.generated data from that roster.
+2. Render deterministic <name>.env.generated data from that roster, including `MOSAIC_GIT_IDENTITY` derived exactly from the roster agent name.
 3. Parse optional <name>.env.local through a strict allowlist.
 4. Reject generated-key shadowing, unknown or sensitive-looking keys, unsafe paths/values, duplicates, malformed lines, shell syntax, and command overrides.
-5. Derive the runtime command from validated runtime/model/reasoning data.
-6. Target only the exact configured tmux socket and roster session after ownership checks.
+5. Reject a Git identity that is unsafe or differs from the generated agent name.
+6. Derive the runtime command from validated runtime/model/reasoning data and pass every generated projection entry through the clean process environment boundary.
+7. Target only the exact configured tmux socket and roster session after ownership checks.

 ## File precedence and ownership

@@ -35,6 +35,7 @@ values, credential material, or command text.

 ```dotenv
 MOSAIC_AGENT_NAME=<roster name>
+MOSAIC_GIT_IDENTITY=<roster name>
 MOSAIC_AGENT_CLASS=<roster class>
 MOSAIC_AGENT_RUNTIME=<roster runtime>
 MOSAIC_AGENT_MODEL=<roster model hint>
@@ -44,8 +45,9 @@ MOSAIC_AGENT_WORKDIR=<absolute roster work directory>
 MOSAIC_TMUX_SOCKET=<roster socket or empty>
 ```

-The generated launch contract supports only `claude`, `codex`, `opencode`, and `pi`. fleet add
-uses that same runtime authority and rejects any other runtime before it writes the roster or changes
+`MOSAIC_GIT_IDENTITY` is derived from and must equal `MOSAIC_AGENT_NAME`; it is not a separate
+operator-controlled identity authority. The generated launch contract supports only `claude`, `codex`,
+`opencode`, and `pi`. fleet add uses that same runtime authority and rejects any other runtime before it writes the roster or changes
 projection, local, or quarantine files. The legacy dogfood stub on its separate `mosaic-factory`
 socket remains an observability canary; it has no generated-launch adapter and cannot be added through
 this projection path.
@@ -1,99 +0,0 @@
-# Installer State Machine and Recovery
-
-The unified installer uses a transactional P0–P9 model. It may report success only after P9 reasserts every applicable committed postcondition. Internal phases invoke the CLI by P3's absolute path; shell discovery is checked only at P8.
-
-## Canonical phases
-
-| Phase                           | Responsibility                                                                                                                    | Failure disposition                                                              |
-| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
-| P0 Resolve context              | Bind uid/username to the authoritative passwd HOME/shell, state privilege mode, architecture, libc, Node, and npm                 | Fail before mutation                                                             |
-| P1 Preflight                    | Validate downstream tool closure (including `git` and `python3`), writable prefix, registry lane, disk/inodes, and exclusive lock | Fail before target mutation                                                      |
-| P2 Acquire artifacts            | Resolve exact registry versions and an immutable framework commit; record lane and SHA-256                                        | Discard temporary work                                                           |
-| P3 Install CLI                  | Install at the configured absolute prefix; require exact version plus target owner/group and non-writable executable mode         | Restore the prior prefix/npmrc snapshot                                          |
-| P4 Install framework + skills   | Sync framework and consume a checkout-free, lane/versioned shipped-skill declaration                                              | Restore prior framework/runtime trees                                            |
-| P5 Identity                     | Validate SOUL/USER content and private modes; require private credential storage and target owner/group                           | Restore generated identity/credential binding                                    |
-| P6 Runtime linking / activation | Evaluate activation honestly; never treat dead enforcement hooks as active readiness                                              | Restore runtime activation files                                                 |
-| P7 Services                     | Provision only requested services/resources after any required P5 credential commits                                              | Stop and restore requested services/resources                                    |
-| P8 Shell discoverability        | Require fresh login and non-login shells of the actual target shell to resolve P3's path                                          | Restore shell profiles                                                           |
-| P9 Verify + commit              | Re-run P0–P8, commit the manifest, and seal the journal                                                                           | Leave an honestly reported resumable failure or restore the pre-install snapshot |
-
-The phase numbers are a cross-workstream contract and must not be renumbered.
-
-## Side-effect-free check
-
-```bash
-bash tools/install.sh --check          # stable/latest lane
-bash tools/install.sh --check --next   # prerelease lane
-```
-
-`--check`:
-
- emits exactly one `[P0]` through `[P8]` PASS/FAIL row;
- exits non-zero if any predicate fails;
- does not create the npm prefix, lock, journal, manifest, shell profile, or runtime file;
- uses temporary npm observation storage outside the target HOME and removes it before exit.
-
-P4 currently fails as `NOT-MEASURED / UNDECLARED` until the installer publishes `~/.config/mosaic/.install-shipped-skills.json`. C1 deliberately does not select among the conflicting candidate populations; C5 owns publishing and fulfilling that declaration. Once present, the P4 predicate requires the declaration's lane/version to match the resolved install and every named skill to remain contained under `skills/<name>/SKILL.md` with matching loadable frontmatter.
-
-## Durable journal
-
-Each mutating run creates a private transaction directory:
-
-```text
-${XDG_STATE_HOME:-~/.local/state}/mosaic/install/
-  active.json
-  <UTC-run-id>/
-    journal.ndjson
-    journal.ndjson.sha256   # committed runs only
-    commands.log
-    snapshot/
-```
-
-Before each mutation scope is touched, `journal.ndjson` records:
-
- phase and path;
- whether prior state existed and where its snapshot lives;
- the reversal action;
- the captured command-output location and command status.
-
-Journal, action-status, manifest, or command-log write/sync failure is fatal. An unrecorded mutation is not allowed. Command diagnostics are redacted before terminal output or durable logging; credential-shaped environment values, bearer values, auth tokens, and credentialed URLs are never deliberately persisted. Successful P9 runs append a seal event, write the SHA-256 sidecar, and make the journal and sidecar read-only. Required P4/P6 action failures are persisted in the manifest so a later `--check` cannot turn a failed action into a false pass.
-
-Rollback roots must be non-overlapping, non-symlinked, target-user-owned strict descendants of canonical `HOME`; unsafe custom `MOSAIC_HOME`/`MOSAIC_PREFIX` values fail at P0. The same validation runs again immediately before recursive rollback. The OS lock is concurrency authority: if a process dies while `active.json` still says `in-progress`, a retry that acquires the free lock preserves the stale projection as `prior-active.json` and proceeds from the honestly retained partial state.
-
-`active.json` is the current projection:
-
- `in-progress`: incomplete/open transaction;
- `rolled-back`: a fault restored the snapshot;
- `rollback-failed`: restoration failed or refused a replaced/unsafe target and requires manual recovery;
- `failed-resumable`: named postconditions failed and the recorded partial state remains for remediation;
- `committed`: P9 passed and the journal is sealed.
-
-## Failure recovery
-
-1. Read the named phase and remediation line from installer stderr.
-2. Inspect `active.json`, then the referenced `journal.ndjson` and `commands.log`. Command output needed to diagnose a failure is preserved and surfaced; it is not redirected away.
-3. For `rolled-back`, verify the target paths match their pre-install state before retrying.
-4. For `failed-resumable`, repair the named phase owner requirement, then run `install.sh --check` before retrying the installer.
-5. Do not activate the #869 enforcement hooks merely to turn P6 green. A broker-less host with those hooks is a failed P6 state.
-
-## Greenfield CI gate
-
-`.woodpecker/greenfield-install.yml` runs `tools/e2e-install-test.sh` from zero in Debian/glibc as a non-root uid with `env -i`. No host HOME, npm cache, credentials, or bind mount enters the target process. Checkout mode packages the complete current checkout into an archive, pins its SHA-256 through an internal fixture seam, and copies the self-contained fixture into the container; framework-installer changes in the PR are therefore exercised rather than fetched from an older remote branch.
-
-The C1 fixture intentionally returns an attributable RED while C2–C5 remain open. CI itself remains green only when the fixture's final P0–P9 verdicts, required discriminator rows, seeded secret-canary scan, and non-zero exit match the versioned contract in `tools/fixtures/greenfield-expected-red.tsv`. The comparator validates the complete three-case schema before selecting a case: exactly one exit and P0–P9 disposition per case, pinned require/forbid populations, and no duplicate or unknown rows. Any later remediation that changes an observed verdict makes CI red until the owning lane deliberately updates that manifest:
-
- `git` present: P1 and strict P3 pass; P4/P5/P6/P8 fail for their own reasons; P9 refuses success.
- `git` absent: P1 fails before target mutation and the installer emits no `Done.`.
-
-The fixture is lane-parametric:
-
-```bash
-bash tools/e2e-install-test.sh --lane next --git present
-bash tools/e2e-install-test.sh --lane main --git present
-```
-
-CI exercises both lane parameters as expected-RED structural checks. A separate remote-contract arm fetches the installer at the immutable CI commit, rejects failed or empty HTTP-success bodies, compares it to the reviewed `tools/install.sh.sha256`, and executes that exact fetched artifact. The P2–P8 fault matrix runs the real phase actions (including the P3 npm path, P4 framework path, and wizard path) rather than synthetic representative writes, then compares the complete target tree to its pre-install fingerprint. Delivery targets `main` under the trunk-only merge rule; `next` remains a non-merging integration lane. The linked installer issue stays open after merge and closes only after Jarvis independently validates the greenfield behavior.
-
-## Source trust boundary
-
-Remote installer mode requires a non-empty body and an expected SHA-256 before execution. Remote source-archive mode separately pins the resolved commit, records the archive SHA-256, limits compressed/expanded size and entry count, and rejects traversal, links, devices, and special files before extraction. These controls provide immutable run provenance and archive safety, not an independent signing root. Signed artifact metadata/provenance is explicitly deferred by the canonical greenfield PRD; C1 does not invent a signing system. The checkout and remote CI seams verify reviewed digests before executing their artifacts.
@@ -12,20 +12,6 @@ with no snapshot to fall back to.
 Protection is layered. Each layer is independent; a later layer catches what an
 earlier one misses.

-## Layer 0 — Transaction journal (install-wide recovery)
-
-The unified installer opens a private journal under
-`${XDG_STATE_HOME:-~/.local/state}/mosaic/install/` before the first target
-mutation. Every mutation scope records its path, prior snapshot, and reversal
-instructions before it is touched. Journal write/sync failure is fatal, and P9
-seals successful journals with a SHA-256 sidecar. See
-[Installer state machine and recovery](./installer-state-machine.md).
-
-This transaction journal is distinct from the retained operator-only backup
-below. The transaction journal is required for correctness and rollback;
-Layer 2's durable backup remains a separately stated, fail-open recovery bonus
-for a manifest bug that the normal transaction did not detect.
-
 ## Layer 1 — Manifest-owned sync (prevention)

 The single source of truth for ownership is
@@ -1,14 +0,0 @@
-subject_head=3edde464b3891ad439019fcc19aad7728e4c2fb8
-source=git show HEAD:tools/install-next-lane.test.sh
-
-   477	  echo 'credentialed URL userinfo leaked to terminal output' >&2; exit 1
-   478	fi
-   479	[[ "$(grep -oF '[REDACTED]@' <<<"$OUTPUT" | wc -l | tr -d ' ')" -ge 5 ]] \
-   480	  || { echo 'credentialed URL redaction controls were not all exercised' >&2; exit 1; }
-   481	secret_active="$TMP/secret-state/active.json"
--
-   525	  echo 'framework nested capture leaked credential diagnostics' >&2; exit 1
-   526	fi
-   527	[[ "$(grep -oF '[REDACTED]@' "$framework_log" | wc -l | tr -d ' ')" -ge 5 ]] \
-   528	  || { echo 'framework URL redaction controls were not exercised' >&2; exit 1; }
-   529
@@ -1,16 +0,0 @@
-source=/tmp/c1-ci-next-x.log (exact failing canonical-image xtrace)
-credential material is already replaced by the redactor token [REDACTED]; no live secret is reproduced
-
-  urls=https://[REDACTED]@example.com/a https://[REDACTED]@example.net/b https://[REDACTED]@example.org/c https://[REDACTED]@example.dev/d https://[REDACTED]@example.io/e
-  urls=https://[REDACTED]@example.com/a https://[REDACTED]@example.net/b https://[REDACTED]@example.org/c https://[REDACTED]@example.dev/d https://[REDACTED]@example.io/e
-
-line_count=2
-occurrence_count=10
-observed_assertion_value=2 (from xtrace: [[ 2 -ge 5 ]])
-
-canonical-image discriminator (same locally cached digest as failing run):
-image_id=sha256:d40fb1a218b72d3dcbf8a427a5076facf2a6d958b6854e6bbd057f7264540841 repo_digests=["git.mosaicstack.dev/mosaicstack/stack/ci-base@sha256:0f1d996a6cfcc09e6dcf979ee66c872a1b0be4f1bfde852b4790f520ddd0d776"]
-busybox=BusyBox v1.37.0 (2026-01-10 15:38:28 UTC)
-regex_-o_single_line=5
-fixed_-oF_single_line=1
-fixed_-oF_two_lines=2
@@ -1,14 +0,0 @@
-positive_control_exit=1
-seeded_line=https://[MASKED-USERINFO]@example.io/e (actual synthetic userinfo intentionally omitted here)
-expected_failure=credentialed URL redaction control missing for example.io
-transcript_tail:
-[test] --next fast path pins resolved package versions
-[test] fast path failure falls back to source build
-[test] source-build failure is fatal and restores the pre-install prefix
-[test] corrupt source archive is fatal and restores the pre-install prefix
-[test] --dev source install does not require registry version resolution
-[test] explicit --ref keeps source lane and avoids @next lookup
-[test] --check --next rejects mismatched prerelease pipeline suffixes
-[test] full framework path receives P3 absolute CLI without relying on PATH
-[test] captured diagnostics redact seeded credential canary everywhere
-credentialed URL redaction control missing for example.io
@@ -1,10 +0,0 @@
-[test] --next fast path pins resolved package versions
-[test] fast path failure falls back to source build
-[test] source-build failure is fatal and restores the pre-install prefix
-[test] corrupt source archive is fatal and restores the pre-install prefix
-[test] --dev source install does not require registry version resolution
-[test] explicit --ref keeps source lane and avoids @next lookup
-[test] --check --next rejects mismatched prerelease pipeline suffixes
-[test] full framework path receives P3 absolute CLI without relying on PATH
-[test] captured diagnostics redact seeded credential canary everywhere
-credentialed URL redaction control missing for example.io
@@ -1,579 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT="/work"
-# shellcheck source=tools/test-enumeration-assertions.sh
-source "$ROOT/tools/test-enumeration-assertions.sh"
-TMP="$(mktemp -d "${TMPDIR:-/tmp}/mosaic-next-install-test-XXXXXX")"
-trap 'rm -rf "$TMP"' EXIT
-export TMPDIR="$TMP/runtime-tmp"
-mkdir -p "$TMPDIR"
-
-FAKE_BIN="$TMP/bin"
-HOME_DIR="$TMP/home"
-PREFIX="$HOME_DIR/prefix"
-MOSAIC_HOME="$HOME_DIR/mosaic"
-STATE="$TMP/state"
-LOG="$TMP/npm.log"
-mkdir -p "$FAKE_BIN" "$HOME_DIR" "$STATE"
-
-# Model the supported non-root/glibc target explicitly even when this harness
-# itself runs as root in Alpine/BusyBox CI.
-cat > "$FAKE_BIN/id" <<'FAKE_ID'
-#!/usr/bin/env bash
-case "${1:-}" in
-  -u) echo 1001 ;;
-  -g) echo 1001 ;;
-  -un) echo fixture-user ;;
-  *) exec /bin/id "$@" ;;
-esac
-FAKE_ID
-cat > "$FAKE_BIN/getent" <<FAKE_GETENT
-#!/usr/bin/env bash
-printf 'fixture-user:x:1001:1001::%s:/bin/bash\n' '$HOME_DIR'
-FAKE_GETENT
-cat > "$FAKE_BIN/ldd" <<'FAKE_LDD'
-#!/usr/bin/env bash
-printf 'ldd (GNU libc) 2.36\n'
-FAKE_LDD
-cat > "$FAKE_BIN/stat" <<'FAKE_STAT'
-#!/usr/bin/env bash
-if [[ "${1:-} ${2:-}" == '-c %u' ]]; then
-  [[ "${3:-}" == "${MOSAIC_TEST_WRONG_OWNER_PATH:-__none__}" ]] && echo 9999 || echo 1001
-  exit 0
-fi
-if [[ "${1:-} ${2:-}" == '-c %g' ]]; then
-  [[ "${3:-}" == "${MOSAIC_TEST_WRONG_GROUP_PATH:-__none__}" ]] && echo 9999 || echo 1001
-  exit 0
-fi
-exec /bin/stat "$@"
-FAKE_STAT
-cat > "$FAKE_BIN/realpath" <<'FAKE_REALPATH'
-#!/usr/bin/env python3
-import os, sys
-args=sys.argv[1:]
-mode=args.pop(0) if args and args[0] in ('-e','-m') else '-m'
-if args and args[0]=='--': args.pop(0)
-if len(args)!=1 or (mode=='-e' and not os.path.exists(args[0])): raise SystemExit(1)
-print(os.path.realpath(args[0]))
-FAKE_REALPATH
-chmod 0755 "$FAKE_BIN/id" "$FAKE_BIN/getent" "$FAKE_BIN/ldd" "$FAKE_BIN/stat" "$FAKE_BIN/realpath"
-
-cat > "$FAKE_BIN/npm" <<'FAKE_NPM'
-#!/usr/bin/env bash
-set -euo pipefail
-LOG="${MOSAIC_TEST_NPM_LOG:?}"
-STATE="${MOSAIC_TEST_STATE:?}"
-echo "$*" >> "$LOG"
-
-if [[ "${1:-}" == "--version" ]]; then
-  echo "10.6.2"
-  exit 0
-fi
-
-install_cli() {
-  local version="$1"
-  echo "$version" > "$STATE/mosaic"
-  mkdir -p "${MOSAIC_PREFIX:?}/bin"
-  cat > "$MOSAIC_PREFIX/bin/mosaic" <<CLI
-#!/usr/bin/env bash
-set -euo pipefail
-if [[ "\${1:-}" == "wizard" ]]; then
-  printf 'wizard\n' >> "\${MOSAIC_TEST_NPM_LOG:?}"
-  mkdir -p "\${MOSAIC_HOME:?}" "\${HOME:?}/.config/mosaic-gateway"
-  printf '# Soul\\n\\nConfigured.\\n' > "\$MOSAIC_HOME/SOUL.md"
-  printf '# User\\n\\nConfigured.\\n' > "\$MOSAIC_HOME/USER.md"
-  chmod 0600 "\$MOSAIC_HOME/SOUL.md" "\$MOSAIC_HOME/USER.md"
-  exit 0
-fi
-printf '%s\\n' '$version'
-CLI
-  chmod +x "$MOSAIC_PREFIX/bin/mosaic"
-}
-
-if [[ "$1" == "view" ]]; then
-  if [[ "${MOSAIC_TEST_FAIL_NPM_VIEW:-0}" == "1" ]]; then
-    echo "forced registry metadata failure" >&2
-    exit 1
-  fi
-  case "$2 $3" in
-    "@mosaicstack/mosaic@next version") echo "0.0.49-next.999" ;;
-    "@mosaicstack/gateway@next version") echo "${MOSAIC_TEST_GATEWAY_NEXT_VERSION:-0.0.7-next.999}" ;;
-    "@mosaicstack/mosaic version") echo "0.0.48" ;;
-    *) echo "unexpected npm view: $*" >&2; exit 1 ;;
-  esac
-  exit 0
-fi
-
-if [[ "$1" == "install" ]]; then
-  if [[ -n "${MOSAIC_INSTALL_SECRET_CANARY:-}" ]]; then
-    printf 'registry diagnostic authToken=%s\n' "$MOSAIC_INSTALL_SECRET_CANARY"
-    printf 'urls=https://alice:p@[email protected]/a https://bob:pa:[email protected]/b https://carol:p%%[email protected]/c https://[email protected]/d https://public.example/e\n'
-    printf 'Authorization: Basic QWxhZGRpbjpvcGVu\n//registry/:_auth=Ym9iOnNlY3JldA==\nCookie: session=abc123\nSet-Cookie: sid=xyz789\n'
-    printf '%s\n' "$MOSAIC_INSTALL_SECRET_CANARY" > "${MOSAIC_TEST_CANARY_OBSERVATION:?}"
-  fi
-  case "$*" in
-    *"@mosaicstack/[email protected]"*)
-      install_cli "0.0.49-next.999"
-      ;;
-    *"@mosaicstack/[email protected]"*)
-      if [[ "${MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL:-0}" == "1" ]]; then
-        echo "forced gateway install failure" >&2
-        exit 1
-      fi
-      echo "0.0.7-next.999" > "$STATE/gateway"
-      ;;
-    *"mosaicstack-mosaic-0.0.0-source.tgz"*)
-      install_cli "0.0.0-source"
-      ;;
-    *"mosaicstack-gateway-0.0.0-source.tgz"*)
-      echo "0.0.0-source" > "$STATE/gateway"
-      ;;
-    *) echo "unexpected npm install: $*" >&2; exit 1 ;;
-  esac
-  exit 0
-fi
-
-if [[ "$1" == "ls" ]]; then
-  cli="$(cat "$STATE/mosaic" 2>/dev/null || true)"
-  gateway="$(cat "$STATE/gateway" 2>/dev/null || true)"
-  node -e '
-    const cli = process.argv[1];
-    const gateway = process.argv[2];
-    const dependencies = {};
-    if (cli) dependencies["@mosaicstack/mosaic"] = { version: cli };
-    if (gateway) dependencies["@mosaicstack/gateway"] = { version: gateway };
-    process.stdout.write(JSON.stringify({ dependencies }));
-  ' "$cli" "$gateway"
-  exit 0
-fi
-
-echo "unexpected npm command: $*" >&2
-exit 1
-FAKE_NPM
-chmod +x "$FAKE_BIN/npm"
-
-cat > "$FAKE_BIN/curl" <<'FAKE_CURL'
-#!/usr/bin/env bash
-set -euo pipefail
-headers=""; output=""; url=""
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -D) headers="$2"; shift 2 ;;
-    -o) output="$2"; shift 2 ;;
-    --max-filesize) shift 2 ;;
-    -*) shift ;;
-    *) url="$1"; shift ;;
-  esac
-done
-case "$url" in
-  */api/v1/repos/mosaicstack/stack/commits?sha=*)
-    printf 'HTTP/1.1 200 OK\r\ncontent-type: application/json; charset=utf-8\r\n\r\n' > "$headers"
-    printf '[{"sha":"1111111111111111111111111111111111111111"}]\n' > "$output"
-    ;;
-  */archive/*.tar.gz)
-    if [[ "${MOSAIC_TEST_CORRUPT_ARCHIVE:-0}" == "1" ]]; then
-      printf 'not-a-tarball\n' > "$output"
-    else
-      archive_root="$(mktemp -d)"
-      mkdir -p "$archive_root/stack"
-      printf 'fixture\n' > "$archive_root/stack/.fixture"
-      /bin/tar czf "$output" -C "$archive_root" stack
-      rm -rf "$archive_root"
-    fi
-    ;;
-esac
-FAKE_CURL
-chmod +x "$FAKE_BIN/curl"
-
-cat > "$FAKE_BIN/tar" <<'FAKE_TAR'
-#!/usr/bin/env bash
-set -euo pipefail
-dest=""; list=false
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -C) dest="$2"; shift 2 ;;
-    -*t*|t*) list=true; shift ;;
-    *) shift ;;
-  esac
-done
-[[ "$list" == true ]] && exit 0
-if [[ -z "$dest" ]]; then
-  echo "fake tar missing -C destination" >&2
-  exit 1
-fi
-mkdir -p "$dest/stack/packages/mosaic/framework" "$dest/stack/apps/gateway"
-cat > "$dest/stack/packages/mosaic/framework/install.sh" <<'FRAMEWORK'
-#!/usr/bin/env bash
-set -euo pipefail
-expected="${MOSAIC_PREFIX:?}/bin/mosaic"
-[[ "${MOSAIC_CLI_PATH:-}" == "$expected" && -x "$MOSAIC_CLI_PATH" ]] || {
-  echo "framework did not receive P3 absolute CLI (got=${MOSAIC_CLI_PATH:-unset} expected=$expected)" >&2
-  exit 61
-}
-printf 'framework-cli=%s version=%s\n' "$MOSAIC_CLI_PATH" "$($MOSAIC_CLI_PATH --version)" >> "${MOSAIC_TEST_NPM_LOG:?}"
-mkdir -p "${MOSAIC_HOME:?}/credentials"
-chmod 0700 "$MOSAIC_HOME/credentials"
-printf '# framework fixture\n' > "$MOSAIC_HOME/AGENTS.md"
-FRAMEWORK
-chmod 0755 "$dest/stack/packages/mosaic/framework/install.sh"
-FAKE_TAR
-chmod +x "$FAKE_BIN/tar"
-
-cat > "$FAKE_BIN/pnpm" <<'FAKE_PNPM'
-#!/usr/bin/env bash
-set -euo pipefail
-LOG="${MOSAIC_TEST_NPM_LOG:?}"
-echo "pnpm $*" >> "$LOG"
-
-if [[ "$1" == "pack" ]]; then
-  out=""
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --pack-destination) out="$2"; shift 2 ;;
-      *) shift ;;
-    esac
-  done
-  if [[ -z "$out" ]]; then
-    echo "fake pnpm pack missing destination" >&2
-    exit 1
-  fi
-  mkdir -p "$out"
-  case "$PWD" in
-    */apps/gateway) touch "$out/mosaicstack-gateway-0.0.0-source.tgz" ;;
-    */packages/mosaic) touch "$out/mosaicstack-mosaic-0.0.0-source.tgz" ;;
-    *) echo "unexpected pnpm pack cwd: $PWD" >&2; exit 1 ;;
-  esac
-  exit 0
-fi
-
-if [[ "${MOSAIC_TEST_FAIL_PNPM_INSTALL:-0}" == "1" && "$1" == "install" ]]; then
-  echo "forced pnpm install failure" >&2
-  exit 42
-fi
-
-# Other install/build commands are no-ops in this harness.
-exit 0
-FAKE_PNPM
-chmod +x "$FAKE_BIN/pnpm"
-
-reset_state() {
-  : > "$LOG"
-  rm -f "$STATE"/*
-}
-
-tree_fingerprint() {
-  local root="$1"
-  if [[ ! -d "$root" ]]; then printf 'ABSENT\n'; return; fi
-  python3 - "$root" <<'PY'
-import hashlib, os, stat, sys
-root=os.path.abspath(sys.argv[1]); rows=[]
-for current, dirs, files in os.walk(root, topdown=True, followlinks=False):
-    for name in dirs + files:
-        path=os.path.join(current,name); meta=os.lstat(path)
-        rel=os.path.relpath(path,root)
-        target=os.readlink(path) if stat.S_ISLNK(meta.st_mode) else ''
-        digest=''
-        if stat.S_ISREG(meta.st_mode):
-            with open(path,'rb') as handle: digest=hashlib.sha256(handle.read()).hexdigest()
-        rows.append((rel,stat.S_IFMT(meta.st_mode),stat.S_IMODE(meta.st_mode),target,digest))
-payload='\n'.join('|'.join(map(str,row)) for row in sorted(rows)).encode()
-print(hashlib.sha256(payload).hexdigest())
-PY
-}
-
-prefix_fingerprint() { tree_fingerprint "$PREFIX"; }
-
-reset_state
-echo "[test] --next fast path pins resolved package versions"
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch
-)"
-
-grep -qF 'Installed @next packages: CLI 0.0.49-next.999, gateway 0.0.7-next.999' <<<"$OUTPUT"
-grep -qF 'install -g @mosaicstack/[email protected]' "$LOG"
-grep -qF 'install -g @mosaicstack/[email protected]' "$LOG"
-if grep -qE '^install -g .+@next( |$)' "$LOG"; then
-  echo "expected exact-version installs, found mutable @next install" >&2
-  exit 1
-fi
-if grep -qF 'Downloading source ref next at pinned commit' <<<"$OUTPUT"; then
-  echo "fast path unexpectedly fell back to source" >&2
-  exit 1
-fi
-
-ACTIVE="$HOME_DIR/.local/state/mosaic/install/active.json"
-[[ "$(node -p "require('$ACTIVE').status")" == "committed" ]]
-JOURNAL="$(node -p "require('$ACTIVE').journal")"
-[[ "$(stat -c '%a' "$JOURNAL")" == "444" ]]
-( cd "$(dirname "$JOURNAL")" && sha256sum -c "$(basename "$JOURNAL").sha256" >/dev/null )
-grep -q '"event":"mutation".*"phase":"P3".*path=.*prior=.*reverse=' "$JOURNAL"
-
-reset_state
-echo "[test] fast path failure falls back to source build"
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch
-)"
-
-grep -qF 'Fast gateway @next install failed.' <<<"$OUTPUT"
-grep -qF 'Falling back to source build at ref next; --next will not hard-fail on registry issues.' <<<"$OUTPUT"
-grep -qF 'Downloading source ref next at pinned commit 1111111111111111111111111111111111111111' <<<"$OUTPUT"
-grep -qF 'Installed from source: CLI 0.0.0-source' <<<"$OUTPUT"
-grep -qF 'install -g @mosaicstack/[email protected]' "$LOG"
-grep -qE 'install -g .*/mosaicstack-gateway-0\.0\.0-source\.tgz' "$LOG"
-grep -qE 'install -g .*/mosaicstack-mosaic-0\.0\.0-source\.tgz' "$LOG"
-[[ "$(cat "$STATE/mosaic")" == "0.0.0-source" ]]
-[[ "$(cat "$STATE/gateway")" == "0.0.0-source" ]]
-
-reset_state
-echo "[test] source-build failure is fatal and restores the pre-install prefix"
-before_prefix="$(prefix_fingerprint)"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL=1 \
-  MOSAIC_TEST_FAIL_PNPM_INSTALL=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch 2>&1
-)"
-FAIL_STATUS=$?
-set -e
-[[ "$FAIL_STATUS" -ne 0 ]]
-[[ "$(prefix_fingerprint)" == "$before_prefix" ]]
-grep -qF 'forced pnpm install failure' <<<"$OUTPUT"
-[[ "$(node -p "require('$ACTIVE').status")" == "rolled-back" ]]
-
-reset_state
-echo "[test] corrupt source archive is fatal and restores the pre-install prefix"
-before_prefix="$(prefix_fingerprint)"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL=1 \
-  MOSAIC_TEST_CORRUPT_ARCHIVE=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch 2>&1
-)"
-FAIL_STATUS=$?
-set -e
-[[ "$FAIL_STATUS" -ne 0 ]]
-[[ "$(prefix_fingerprint)" == "$before_prefix" ]]
-grep -qF 'archive safety/integrity check failed' <<<"$OUTPUT"
-[[ "$(node -p "require('$ACTIVE').status")" == "rolled-back" ]]
-
-reset_state
-echo "[test] --dev source install does not require registry version resolution"
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NPM_VIEW=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --dev --ref feature-x --yes --no-auto-launch
-)"
-grep -qF 'Downloading source ref feature-x at pinned commit 1111111111111111111111111111111111111111' <<<"$OUTPUT"
-grep -qF 'Installed from source: CLI 0.0.0-source' <<<"$OUTPUT"
-grep -q '^\[P2\] PASS: source_ref=feature-x pinned_commit=1111111111111111111111111111111111111111 sha256=' <<<"$OUTPUT"
-
-reset_state
-echo "[test] explicit --ref keeps source lane and avoids @next lookup"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --check --cli --next --ref feature-x
-)"
-CHECK_STATUS=$?
-set -e
-[[ "$CHECK_STATUS" -ne 0 ]]
-grep -q '^\[P2\] PASS: source_ref=feature-x pinned_commit=1111111111111111111111111111111111111111 sha256=' <<<"$OUTPUT"
-if grep -qF '@next version' "$LOG"; then
-  echo "explicit ref should not query @next dist-tags" >&2
-  exit 1
-fi
-
-reset_state
-echo "[test] --check --next rejects mismatched prerelease pipeline suffixes"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_GATEWAY_NEXT_VERSION="0.0.7-next.1000" \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --check --cli --next
-)"
-CHECK_STATUS=$?
-set -e
-[[ "$CHECK_STATUS" -ne 0 ]]
-grep -q '^\[P2\] FAIL: resolved_version=unavailable' <<<"$OUTPUT"
-
-printf '[test] full framework path receives P3 absolute CLI without relying on PATH\n'
-rm -rf "$HOME_DIR" "$STATE"; mkdir -p "$HOME_DIR" "$STATE"; reset_state
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_INSTALL_STATE_DIR="$TMP/full-state" MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --next --yes --no-auto-launch 2>&1
-)"
-FULL_STATUS=$?
-set -e
-[[ "$FULL_STATUS" -ne 0 ]] # P4 remains intentionally undeclared until C5.
-grep -qF "framework-cli=$PREFIX/bin/mosaic version=0.0.49-next.999" "$LOG"
-if grep -q "CLI not found on PATH\|did not receive P3 absolute CLI" <<<"$OUTPUT"; then
-  echo "internal framework phase depended on PATH instead of P3 absolute CLI" >&2
-  exit 1
-fi
-
-printf '[test] captured diagnostics redact seeded credential canary everywhere\n'
-rm -rf "$HOME_DIR" "$STATE"; mkdir -p "$HOME_DIR" "$STATE"; reset_state
-canary='C1_SECRET_CANARY_7df4c2'
-OUTPUT="$(
-  HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_INSTALL_STATE_DIR="$TMP/secret-state" MOSAIC_NO_COLOR=1 \
-  MOSAIC_INSTALL_SECRET_CANARY="$canary" MOSAIC_TEST_CANARY_OBSERVATION="$TMP/canary-observed" \
-  MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch 2>&1
-)"
-# Positive control: replace the removed redacted example.io source with one deliberately unredacted userinfo URL.
-OUTPUT+=$'\nhttps://[email protected]/e'
-if grep -qF "$canary" <<<"$OUTPUT"; then echo 'credential canary leaked to terminal output' >&2; exit 1; fi
-if grep -Eq 'alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789' <<<"$OUTPUT"; then
-  echo 'credentialed URL userinfo leaked to terminal output' >&2; exit 1
-fi
-for host in example.com example.net example.org example.dev example.io; do
-  grep -qF "https://[REDACTED]@$host" <<<"$OUTPUT" \
-    || { echo "credentialed URL redaction control missing for $host" >&2; exit 1; }
-done
-secret_active="$TMP/secret-state/active.json"
-secret_journal="$(node -p "require('$secret_active').journal")"
-secret_command_log="$(dirname "$secret_journal")/commands.log"
-if grep -R -F "$canary" "$secret_command_log" "$HOME_DIR" 2>/dev/null; then
-  echo 'credential canary leaked to persistent installer output' >&2; exit 1
-fi
-if grep -E 'alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789' "$secret_command_log" >/dev/null; then
-  echo 'credentialed URL userinfo leaked to persistent installer output' >&2; exit 1
-fi
-if [[ "$(cat "$TMP/canary-observed" 2>/dev/null || true)" != "$canary" ]]; then
-  echo 'credential canary positive control was not exercised' >&2; exit 1
-fi
-test_assert_find_empty 'redacted diagnostic staging files' \
-  "$TMPDIR" -maxdepth 1 -type f \
-  \( -name 'mosaic-phase-redacted.*' -o -name 'mosaic-post-redacted.*' \) || exit 1
-
-printf '[test] framework nested capture redacts the same canary and URL variants\n'
-framework_test_home="$TMP/framework-redact-home"
-framework_target="$framework_test_home/.config/mosaic"
-framework_cli="$TMP/framework-redact-cli"
-framework_log="$TMP/framework-redact-commands.log"
-framework_status="$TMP/framework-redact-status.tsv"
-mkdir -p "$framework_test_home"; : > "$framework_log"; : > "$framework_status"
-cat > "$framework_cli" <<'FRAMEWORK_CLI'
-#!/usr/bin/env bash
-printf 'nested authToken=%s\n' "${MOSAIC_INSTALL_SECRET_CANARY:?}"
-printf 'nested=https://alice:p@[email protected]/a https://bob:pa:[email protected]/b https://carol:p%%[email protected]/c https://[email protected]/d https://user%%[email protected]/e\n'
-printf 'Authorization: Basic QWxhZGRpbjpvcGVu\n//registry/:_auth=Ym9iOnNlY3JldA==\nCookie: session=abc123\nSet-Cookie: sid=xyz789\n'
-exit 1
-FRAMEWORK_CLI
-chmod 0755 "$framework_cli"
-set +e
-FRAMEWORK_OUTPUT="$(
-  HOME="$framework_test_home" MOSAIC_HOME="$framework_target" MOSAIC_INSTALL_MODE=overwrite \
-  MOSAIC_CLI_PATH="$framework_cli" MOSAIC_INSTALL_SECRET_CANARY="$canary" \
-  MOSAIC_INSTALL_COMMAND_LOG="$framework_log" MOSAIC_INSTALL_PHASE_STATUS_FILE="$framework_status" \
-  MOSAIC_ALLOW_MISSING_SEQUENTIAL_THINKING=1 MOSAIC_SKIP_SKILLS_SYNC=1 \
-  bash "$ROOT/packages/mosaic/framework/install.sh" 2>&1
-)"
-framework_install_status=$?
-set -e
-[[ "$framework_install_status" -eq 0 ]]
-if grep -Eq "$canary|alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789" <<<"$FRAMEWORK_OUTPUT" \
-  || grep -Eq "$canary|alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789" "$framework_log"; then
-  echo 'framework nested capture leaked credential diagnostics' >&2; exit 1
-fi
-for host in example.com example.net example.org example.dev example.io; do
-  grep -qF "https://[REDACTED]@$host" "$framework_log" \
-    || { echo "framework URL redaction control missing for $host" >&2; exit 1; }
-done
-
-printf '[test] real P2-P8 actions run under fault injection and restore actual surfaces\n'
-for phase in P2 P3 P4 P5 P6 P7 P8; do
-  rm -rf "$HOME_DIR" "$STATE" "$TMP/fault-$phase"; mkdir -p "$HOME_DIR" "$STATE" "$TMP/fault-$phase"
-  printf 'operator-sentinel\n' > "$HOME_DIR/operator.txt"
-  reset_state
-  before="$(tree_fingerprint "$HOME_DIR")"
-  set +e
-  HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-    MOSAIC_INSTALL_STATE_DIR="$TMP/fault-$phase" MOSAIC_INSTALL_FAULT_AFTER="$phase" \
-    MOSAIC_INSTALL_SELF_TEST_ALLOW=1 MOSAIC_NO_COLOR=1 \
-    MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-    PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-    bash "$ROOT/tools/install.sh" --state-machine-self-test --next --yes \
-    >"$TMP/fault-$phase.log" 2>&1
-  status=$?
-  set -e
-  [[ "$status" -eq 97 ]] || { echo "$phase real fault expected 97, got $status" >&2; exit 1; }
-  [[ -s "$LOG" ]] || { echo "$phase fault never entered the real action path" >&2; exit 1; }
-  [[ "$(tree_fingerprint "$HOME_DIR")" == "$before" ]] || { echo "$phase real rollback mismatch" >&2; exit 1; }
-  grep -q "phase=$phase" "$TMP/fault-$phase.log"
-  test_assert_no_file_content_match "$phase fault-state" \
-    '"status"[[:space:]]*:[[:space:]]*"in-progress"' "$TMP/fault-$phase" || exit 1
-done
-
-printf '[test] stale projection is preserved while the real fault path acquires a free OS lock\n'
-rm -rf "$HOME_DIR" "$STATE" "$TMP/stale-state"; mkdir -p "$HOME_DIR" "$STATE" "$TMP/stale-state"
-printf '{"status":"in-progress","journal":"%s"}\n' "$TMP/stale-state/dead-run/journal.ndjson" > "$TMP/stale-state/active.json"
-reset_state
-set +e
-HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_INSTALL_STATE_DIR="$TMP/stale-state" MOSAIC_INSTALL_FAULT_AFTER=P2 \
-  MOSAIC_INSTALL_SELF_TEST_ALLOW=1 MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --state-machine-self-test --next --yes >"$TMP/stale.log" 2>&1
-stale_status=$?
-set -e
-[[ "$stale_status" -eq 97 ]]
-find "$TMP/stale-state" -name prior-active.json -type f -print -quit | grep -q .
-[[ "$(node -p "require('$TMP/stale-state/active.json').status")" == rolled-back ]]
-
-echo "[test] installer next lane tests passed"
@@ -1,13 +0,0 @@
-[test] --next fast path pins resolved package versions
-[test] fast path failure falls back to source build
-[test] source-build failure is fatal and restores the pre-install prefix
-[test] corrupt source archive is fatal and restores the pre-install prefix
-[test] source archive with multiple extracted roots fails instead of selecting by find order
-[test] --dev source install does not require registry version resolution
-[test] explicit --ref keeps source lane and avoids @next lookup
-[test] --check --next rejects mismatched prerelease pipeline suffixes
-[test] full framework path receives P3 absolute CLI without relying on PATH
-[test] captured diagnostics redact seeded credential canary everywhere
-[test] framework nested capture redacts the same canary and URL variants
-[test] real P2-P8 actions run under fault injection and restore actual surfaces
-P2 left an in-progress transaction
@@ -1,14 +0,0 @@
-[test] --next fast path pins resolved package versions
-[test] fast path failure falls back to source build
-[test] source-build failure is fatal and restores the pre-install prefix
-[test] corrupt source archive is fatal and restores the pre-install prefix
-[test] source archive with multiple extracted roots fails instead of selecting by find order
-[test] --dev source install does not require registry version resolution
-[test] explicit --ref keeps source lane and avoids @next lookup
-[test] --check --next rejects mismatched prerelease pipeline suffixes
-[test] full framework path receives P3 absolute CLI without relying on PATH
-[test] captured diagnostics redact seeded credential canary everywhere
-[test] framework nested capture redacts the same canary and URL variants
-[test] real P2-P8 actions run under fault injection and restore actual surfaces
-[test] stale projection is preserved while the real fault path acquires a free OS lock
-[test] installer next lane tests passed
@@ -1,2 +0,0 @@
-[test] enumeration failure cannot mask a planted in-progress transaction
-[test] FAIL: planted in-progress transaction plus failed enumeration passed the full suite
@@ -1,14 +0,0 @@
-[test] --next fast path pins resolved package versions
-[test] fast path failure falls back to source build
-[test] source-build failure is fatal and restores the pre-install prefix
-[test] corrupt source archive is fatal and restores the pre-install prefix
-[test] source archive with multiple extracted roots fails instead of selecting by find order
-[test] --dev source install does not require registry version resolution
-[test] explicit --ref keeps source lane and avoids @next lookup
-[test] --check --next rejects mismatched prerelease pipeline suffixes
-[test] full framework path receives P3 absolute CLI without relying on PATH
-[test] captured diagnostics redact seeded credential canary everywhere
-[test] framework nested capture redacts the same canary and URL variants
-[test] real P2-P8 actions run under fault injection and restore actual surfaces
-find: ‘/tmp/mosaic-next-install-test-hqL7U0/fault-P2/blocked’: Permission denied
-[test] ERROR: P2 fault-state enumeration failed
@@ -1,33 +0,0 @@
-# #1050 C1 fix-round verification
-
-Frozen reviewed head before remediation: `378bc1afe3bc485adb8614897d66c5edccd4a527`.
-
-Status: **believed-fixed, pending jarvis validation**. PR #1054 is not self-merged and issue #1050 remains open.
-
-## Blocker B — fail-closed test enumeration
-
-The RED-first control used a real filesystem permission failure, not binary shadowing or PATH interception.
-
-1. A planted `{"status":"in-progress"}` file in a readable P2 fault tree made the complete real walk fail the frozen suite at `P2 left an in-progress transaction` (`01-pre-fix-positive-control.log`, exit 1).
-2. The same planted defect beneath a target-owned mode-0100 directory made real `find` report a permission failure. The frozen suite erased the producer failure and exited 0 with `installer next lane tests passed` (`02-pre-fix-permission-failure-attack.log`).
-3. The committed regression control initially failed because the child full-suite attack still exited 0 (`03-regression-test-red.log`).
-4. After remediation, the same child full-suite input exits 1 and names `[test] ERROR: P2 fault-state enumeration failed` (`04-post-fix-permission-failure-attack.log`). The ordinary full suite remains green.
-
-`tools/test-enumeration-assertions.sh` now captures each complete NUL-delimited population and checks the producer status before asserting absence. Content checks inspect the captured population and distinguish “no match” from a read error. The shared fail-closed implementation covers:
-
- `tools/install-next-lane.test.sh`: redacted staging-file cleanup and fault-state transaction scan;
- `tools/verified-installer-fetch.test.sh`: temporary-download cleanup;
- `tools/install-state-machine.test.sh`: symlink-target non-mutation;
- `docs/reports/verification/1050-b8-redaction-control/positive-control.test.sh`: both copied counterparts.
-
-No assertion was loosened. A1, A2, upgrade-guard, source-root, the species-2 sweep, #869, and expected-RED verdict rows remain outside this remediation.
-
-## Blocker A — installer digest
-
-The stale sidecar value was replaced with the exact `sha256sum` record for `tools/install.sh`:
-
-```text
-e59cb441a2f37ae9150f8eae470238e9d858a1816df93343d9784a6796676096  install.sh
-```
-
-Local `sha256sum -c tools/install.sh.sha256` and the workflow's exact expected/actual equality both pass. The immutable provider-fetch arm at the new `${CI_COMMIT_SHA}` is recorded in the freeze artifact after push; local equality alone is not treated as sufficient evidence.
@@ -1,22 +0,0 @@
-# Documentation completion checklist — #1050 C1 fix round
-
-## Required artifacts
-
- [x] `docs/PRD.md` exists; #1050 C1 requirements remain current and unchanged.
- [x] User guide: not applicable; no user-facing installer behavior changed.
- [x] Admin guide: not applicable; no operator procedure or deployment behavior changed.
- [x] Developer guide: existing `docs/guides/installer-state-machine.md` already defines the fail-closed and immutable-remote contracts; this round adds verification evidence without changing the contract.
- [x] OpenAPI and endpoint index: not applicable; no API changed.
- [x] Sitemap: not applicable; no navigation changed.
-
-## API and structural coverage
-
- [x] API schema/auth/error coverage: not applicable; no endpoint changed.
- [x] Guide book indexes: not applicable; no guide page was added or moved.
- [x] Root hygiene preserved; all new artifacts are under `docs/reports/verification/1050-c1-fix-round/` and the active scratchpad remains under `docs/scratchpads/`.
-
-## Review and publishing
-
- [x] Verification documentation is in the same logical change set as the shell-test remediation.
- [x] Independent code and security reviews found no documentation blocker.
- [x] Canonical evidence remains in-repo. No external publishing action was requested or performed.
@@ -1,66 +0,0 @@
-# #1050 successor remediation verification
-
-Head under test before remediation: `e5d5c8495a070af2dcd393cace287fe74a8a819e`.
-
-This change strengthens the expected-RED detector; it does not repair the intentionally failing greenfield rows. The #869 hooks remain unwired.
-
-## A1 — P0 reason binding
-
-RED first:
-
-```text
-$ bash tools/verify-greenfield-expected-red.test.sh
-[test] FAIL: vacuous P0 PASS satisfied the expected-RED contract without identity/context evidence
-exit=1
-```
-
-The pinned manifest now has an explicit `phase-reason` binding against the final P0 row: target `mosaic`, uid `1001`, equal `HOME` and passwd HOME, `/bin/bash`, `privilege=user`, `x86_64`, glibc, and version-shaped Node/npm evidence. All three cases structurally require exactly one P0 reason binding. The greenfield fixture's final P0 row now emits and validates the same complete identity/context evidence, so an unrelated earlier P0 line cannot satisfy the binding for a vacuous final row.
-
-Pipeline 2224 and the successor's pre-change fixture run also exposed a stale next-lane P6 reason left behind by the already-closed B6 remediation: actual behavior is a fail-closed runtime-link action refusal with `#869` hooks left inactive and a persisted required P6 failure, while the manifest still expected dead hooks to be active. The pinned reason now matches the stronger measured refusal (`runtime linking/activation action reported a required failure`); no verdict changed and #869 remains unwired.
-
-GREEN:
-
-```text
-[test] PASS: P0 PASS must bind target identity, HOME, shell, privilege, architecture, and runtime reason
-```
-
-## A2 — fail-closed P4 enumeration
-
-RED first: a `find` control emitted only the safe root, omitted an unsafe mode-`0666` child, and exited `73`. The process-substitution consumer discarded that status:
-
-```text
-[test] FAIL: P4 accepted a partial created-path inventory after find failed
-[test] FAIL: P4 did not report failed created-path enumeration
-exit=1
-```
-
-P4 now captures the NUL-delimited walk into a temporary file, checks `find` to completion, and only then evaluates the complete inventory. A failed walk reports that enumeration failed and returns a P4 finding.
-
-GREEN:
-
-```text
-[test] PASS: P4 rejects an incomplete created-path inventory
-[test] PASS: P4 attributes the failed created-path enumeration
-```
-
-## B — deterministic TERM no-exit control
-
-Woodpecker pipeline 2224 at the original head reported `32 passed, 2 failed`: the no-exit fixture did not exit zero or report sync success. The premise was not stale: the same fixture passed `34/34` on another filesystem.
-
-A controlled reverse-sorted `find -print0` walk reproduced the pipeline result exactly (`32 passed, 2 failed`). Root cause: signal injection was tied to `guides/E2E-DELIVERY.md`; whether required `tools/` content remained after restore depended on filesystem enumeration order. The test was measuring path order as well as trap semantics.
-
-The generated fixtures now damage a real target path after the snapshot is armed, self-signal immediately before the complete normal sync, and differ only in the explicit handler exit. Therefore a no-exit handler always restores, returns, runs the full sync, mutates the restored target again, and reports completion independent of walk order.
-
-GREEN on both native and reverse-sorted enumeration:
-
-```text
-RESULT: 36 passed, 0 failed
-```
-
-Mutation sensitivity: restoring `exit 1` to the nominal no-exit fixture makes the control RED (`32 passed, 4 failed`), including failures of the zero-exit and resumed-success assertions. The control can still fail for its stated reason.
-
-## Enumeration-class sweep
-
-The sweep covered production enumeration in `tools/install.sh` and `packages/mosaic/framework/install.sh`, plus process-substitution consumers in the C1 shell-test surfaces. Framework installer file, operator, durable-snapshot, and pruning walks already capture and check their producer status. P4's created-path walk was the reviewed unchecked instance.
-
-One additional order/completeness dependency was found in source acquisition: `find "$WORK_DIR" ... | head -1` hid `find` failure and selected arbitrarily when an archive produced multiple top-level directories. RED first, the extraction fake produced two roots and the lane test stopped at that new assertion with exit 1 because today's code selected one. Source acquisition now captures and checks the complete NUL-delimited walk and requires exactly one extracted root. The lane suite is green with the multiple-root rejection. No remaining production installer enumeration uses unchecked process substitution or first-row order as authority.
@@ -0,0 +1,198 @@
+# #1043 — Fleet pane git-identity propagation
+
+## Objective
+
+Ensure a fleet seat's launched runtime process receives its roster-derived `MOSAIC_GIT_IDENTITY`, and lock the complete generated-environment propagation boundary with an enumerated set comparison.
+
+## Tracking
+
+- External issue: `mosaicstack/stack#1043`
+- Branch: `fix/1043-pane-git-identity`
+- Coordinator: `tl-mosaic`
+- `docs/TASKS.md`: read-only by project worker contract; not modified.
+
+## Constraints
+
+- RED-first bug reproducer is mandatory.
+- R7 delete-the-subject mutation must turn the behavioral test red.
+- Assert launched-process environment, not source text.
+- One push only; do not poll CI after push.
+- Run the CI queue guard immediately before push and report its `state=` line as state, not evidence.
+- Do not modify a live host launcher or obtain/copy another credential.
+- Self-post the PR, verify provider attribution, then stop.
+- Final status wording: `believed-fixed, pending jarvis validation`.
+
+## Scope inventory
+
+Re-derived against `origin/main` at `85d2108e`:
+
+- Launch consumer: `packages/mosaic/framework/tools/fleet/start-agent-session.sh`
+- Behavioral launch test: `packages/mosaic/framework/tools/fleet/test-start-agent-session.sh`
+- Generated-environment contract/parser: `packages/mosaic/src/fleet/generated-env-boundary.ts`
+- Roster projection producers:
+  - `packages/mosaic/src/commands/fleet.ts`
+  - `packages/mosaic/src/fleet/fleet-reconciler.ts`
+  - `packages/mosaic/src/fleet/fleet-agent-crud.ts`
+  - `packages/mosaic/src/fleet/v1-v2-migration.ts`
+- Contract and producer tests discovered by repository search.
+- Generated-environment operator/developer docs and their executable documentation contract test.
+
+Discrepancy sent to `tl-mosaic`: current main no longer contains the charter's `PANE_SHELL_SNIPPET`; #772 replaced it with an `/usr/bin/env -i` argv launch boundary, and current generated projections do not declare git identity. Code-read inventory is **NOT MEASURED** behavior.
+
+## Plan
+
+1. Add the process-environment set-comparison regression first and record RED.
+2. Add roster-derived `MOSAIC_GIT_IDENTITY=<agent name>` to the complete generated projection contract.
+3. Validate identity syntax and equality with `MOSAIC_AGENT_NAME`; pass it through the clean pane environment.
+4. Update affected projection tests and generated-environment docs.
+5. Run focused and baseline gates.
+6. Perform R7 by deleting the pane propagation entry, prove RED, restore, and prove GREEN.
+7. Run independent review, remediate, commit, queue guard, one push, self-post PR, verify provider attribution, and stop without CI polling.
+
+## Budget
+
+No explicit token cap was provided. Working cap: one narrow logical unit, no dependency installation unless existing tooling requires it, no unrelated refactor.
+
+## Evidence log
+
+### TDD and mutation evidence
+
+- RED-first, repository launcher: `bash packages/mosaic/framework/tools/fleet/test-start-agent-session.sh` exited 64 on pre-fix source with `code=unknown-key key=MOSAIC_GIT_IDENTITY`. The generated seat could not launch with the required declared identity.
+- GREEN: the same repository launcher test emitted `ok - start-agent-session generated environment boundary`.
+- R7 delete-the-subject: removed only `"MOSAIC_GIT_IDENTITY=$MOSAIC_GIT_IDENTITY"` from the repository launch array; the same test exited 1 with `FAIL: runtime pane omitted or changed generated environment keys: MOSAIC_GIT_IDENTITY`.
+- R7 restoration: restored that launch entry; the same test returned green.
+- Launcher under test is explicitly `packages/mosaic/framework/tools/fleet/start-agent-session.sh` through the test's `$START`, **not** the stale installed host copy.
+
+### Situational and focused tests
+
+- Repository launcher boundary: green, including set comparison of all nine generated projection entries and fail-before-tmux cases for missing, unsafe, mismatched, and local-shadow Git identity.
+- Fleet systemd launcher integration: `bash packages/mosaic/framework/systemd/user/test-fleet-units.sh` — green.
+- Focused Mosaic Vitest set: 6 files, 311 tests — green.
+- `bash -n` on changed shell files — green.
+- `git diff --check` — green.
+
+### Baseline gates
+
+- `pnpm typecheck` — 45/45 tasks green.
+- `pnpm lint` — 25/25 tasks green.
+- `pnpm format:check` — green.
+- `pnpm test:checkout` — green.
+- Repository-wide Vitest under a hermetic current-version npm prefix: Mosaic 81/81 files and 1510/1510 tests green; other workspace test tasks shown green before the framework-shell phase.
+- Canonical `pnpm test` is not fully green on this host for unrelated environment-sensitive gates:
+  1. the first two runs exposed the globally installed Mosaic 0.0.48 update banner in three CLI smoke tests expecting empty stderr;
+  2. after isolating that global-version input, the framework wake assertion aborted at the known `#973` Bash `BASH_LINENO` convention check (exit 97; observed `[3 5]`, expected `[3 4]`).
+  No tests were weakened or bypassed; focused changed-surface tests are green. CI remains the canonical clean-environment result and is intentionally not polled after push per charter.
+
+### Independent review
+
+- Codex code review first pass: request changes for missing shell rejection-path coverage.
+- Remediation: added table-driven missing/unsafe/mismatch/local-shadow launcher cases, each asserting no tmux call.
+- Codex code re-review: **approve**, no findings, confidence 0.88.
+- Codex security review: risk `none`, no findings, confidence 0.97.
+
+### Acceptance criteria mapping
+
+| Acceptance criterion | Evidence |
+| --- | --- |
+| AC-FGI-01: launched process receives every generated key/value | Repository launcher process-environment `comm -23` set comparison; GREEN and R7 RED evidence above |
+| AC-FGI-02: missing, unsafe, or split identity fails before tmux | Table-driven shell cases plus TypeScript generated-boundary tests |
+| AC-FGI-03: focused/baseline/review evidence recorded | Commands and review outcomes above; host-sensitive full-suite limitations stated explicitly |
+
+### Documentation checklist
+
+- PRD updated with #1043 requirements and acceptance criteria.
+- Fleet launch runbook, generated-env concept, and generated-env reference updated.
+- No API/OpenAPI, sitemap, user publishing target, deployment, or external docs publication change applies.
+- `docs/TASKS.md` remains unmodified per its single-writer project contract.
+
+## Round 2 — PR #1073 review 97 remediation
+
+### Review blocker
+
+The launched-process suite was signed-excluded from CI enumeration. Manual GREEN/R7 evidence therefore did not prove a PR workflow could detect regression.
+
+### RED-first and canonical wiring
+
+1. Removed the suite's signed exclusion before adding a CI execution path.
+2. `check-test-enumeration.sh` went RED with exact `UNENUMERATED` output for `test-start-agent-session.sh`: population 49, enumerated 30, excluded 18.
+3. Added both `framework/tools/fleet/test-start-agent-session.sh` and `framework/systemd/user/test-fleet-units.sh` to `@mosaicstack/mosaic`'s canonical `test:framework-shell` chain.
+4. The guard returned GREEN: population 49, enumerated 32, excluded 18, surfaces 45. The systemd suite is outside the guard's tools-only population but now has the same explicit canonical execution disposition.
+
+### Workflow-level R7
+
+- Deleted only the pane launch entry `"MOSAIC_GIT_IDENTITY=$MOSAIC_GIT_IDENTITY"`.
+- Ran the exact `.woodpecker/ci.yml` test-step command, `pnpm test`, with only a temporary PATH-scoped npm shim reporting the checkout's current 0.0.49 version so the unrelated global 0.0.48 banner could not preempt the shell chain.
+- Result: exit 1 at `@mosaicstack/mosaic#test`, with the enumeration guard GREEN followed by `FAIL: runtime pane omitted or changed generated environment keys: MOSAIC_GIT_IDENTITY`.
+- Restored the launch entry. The canonical `test:framework-shell` chain then reached both newly wired suites and printed both GREEN markers before the known unrelated #973 host-only `BASH_LINENO` abort.
+- An actual provider PR workflow on the intentionally broken mutant is **NOT MEASURED**: the one-push constraint forbids pushing a red mutant and then a repaired head. Local execution proves the exact PR workflow command and dependency chain go RED on the subject deletion; CI on the repaired pushed head remains canonical.
+
+### Workflow population
+
+- **DEFINED:** 3 workflows (`ci.yml`, `ci-image.yml`, `publish.yml`).
+- **ELIGIBLE for `pull_request`:** 1/3 (`ci.yml`), based on top-level `when:` clauses.
+- **REPORTED:** Round-1 exact-head provider read reported 1/1 eligible context (`ci/woodpecker/pr/ci`). Post-remediation-head reported count is **NOT MEASURED** by this seat because CI polling is prohibited; workflow definitions and eligibility did not change.
+
+### Independent remediation review
+
+- First Round-2 review identified a CI-image blocker: the newly wired launcher suite used Perl, which the Alpine CI base does not install.
+- Replaced the suite's three Perl-only fixture mutations with POSIX/BusyBox-compatible `sed -i` substitutions; production behavior and assertions are unchanged.
+- Codex re-review: **APPROVE**, confidence 0.93, no findings.
+
+### Vitest denominator reconciliation
+
+The PR's `311/311` is correct for its explicitly named six-file command at both the original and remediation worktrees:
+
+- generated environment boundary: 24
+- fleet documentation: 23
+- Tess service profile: 6
+- fleet regen command: 27
+- fleet agent CRUD command: 22
+- fleet command: 209
+- total: **311**
+
+Review 97 reported 312/312 without naming its six files. That is a different or miscounted population and cannot replace the command-scoped 311 denominator; the PR follow-up will name the exact files and arithmetic.
+
+## Round 3 — Alpine stale-marker portability
+
+### Objective and plan
+
+- Replace the GNU-only relative-date fixture with a deterministic POSIX/BusyBox timestamp while preserving the required stale-marker assertion.
+- Re-run the launcher suite in the canonical `ci-base:latest` Alpine image, then run applicable repository gates and independent review.
+- Update the PR body to name the repeated GNU-host/Alpine-CI portability pattern, run the mandatory queue guard, push once, verify provider attribution, and stop without CI polling.
+- Working budget: 8K tokens; scope is one fixture line plus delivery evidence. No production behavior changes.
+
+### RED-first evidence
+
+Before the fix, the canonical CI image command
+`docker run --rm -v "$PWD:/work" -w /work git.mosaicstack.dev/mosaicstack/stack/ci-base:latest bash packages/mosaic/framework/tools/fleet/test-start-agent-session.sh`
+exited 1 at the stale-marker setup with exact BusyBox output
+`touch: invalid date '10 seconds ago'`. The prior fresh-marker assertions had already executed, matching pipeline 2233's failure location.
+
+### Root cause and fix
+
+The test used GNU `touch -d` relative-date parsing although the PR workflow runs on Alpine/BusyBox. The fixture now uses POSIX `touch -t 200001010000.00`, a fixed timestamp that is unconditionally stale; the stale assertion remains mandatory and was not made tolerant of missing timestamp metadata.
+
+### Structural pattern
+
+This is the third GNU-host/Alpine-CI portability defect in the lane: GNU `grep` multi-match counting, Perl-only fixture mutation, and GNU `touch -d` date parsing. The repeated cause is shell suites authored on a GNU host but executed in an Alpine CI image; durable prevention belongs in CI-image execution or portability lint, not assertion weakening.
+
+### GREEN and quality evidence
+
+- Focused launcher suite in `ci-base:latest`: exit 0, `ok - start-agent-session generated environment boundary`.
+- Canonical test step in `ci-base:latest` with the pipeline's `pgvector/pgvector:pg17` service, readiness check, migration, and `pnpm test`: exit 0; 46/46 Turbo tasks; Mosaic 81/81 files and 1510/1510 tests; Gateway 57 passed/5 skipped files and 629 passed/11 skipped tests; enumeration 49 population / 32 enumerated / 18 signed exclusions / 45 named surfaces.
+- The first image-only `pnpm test` attempt lacked the pipeline PostgreSQL service and failed only on connection refusal after the launcher suite was GREEN. The rerun supplied the canonical service precondition and passed.
+- Canonical-image baseline: typecheck 45/45 tasks, lint 25/25 tasks, format check GREEN; `git diff --check` GREEN.
+- Independent Codex code review: APPROVE, confidence 0.96, 2/2 Round-3 files, no findings.
+- Independent Codex security review: risk none, confidence 0.99, 2/2 Round-3 files, no findings.
+
+### Re-derived inventory and denominators
+
+- Round-3 git delta: **2/2 files** — launcher suite and task scratchpad; 25 insertions / 1 deletion before evidence finalization.
+- Full PR path inventory against `origin/main` at `85d2108e`: **19/19 changed paths**; Round 3 adds no new PR path.
+- Workflow definition population: **1/3 pull-request-eligible** (`ci.yml` of `ci.yml`, `ci-image.yml`, `publish.yml`).
+- Do not re-litigate the settled 311/312 populations; both are valid for their separately named Tess6 and CRUD-core7 sets.
+
+## Residual risk
+
+- Landing on `main` does not update the currently installed host launcher. Host framework installation/reseed and Jarvis live-seat validation are separate downstream events.
+- Canonical CI result is pending and will not be polled by this seat.
@@ -1,88 +0,0 @@
-# #1050 — Installer P0–P9 state machine and red-first fixture
-
-## Objective
-
-Implement C1 from the canonical greenfield-install PRD v2: a transactional P0–P9 installer spine, a side-effect-free P0–P8 `--check`, and a lane-parametric Debian/glibc non-root from-zero fixture. The acceptance milestone is an attributable RED on the pre-C1 installer while preserving P3 PASS.
-
-## Authority and scope
-
- Canonical requirements: `jason.woltje/jarvis-brain` `docs/plans/2026-08-04-greenfield-install-blockers-PRD-v2.md`. Currency was re-derived after compaction: authenticated fetch resolved `origin/main` to `cb23e5fbc8a282fa967b93d7a134fa48d11b4bb1`; the PRD and charters are byte-identical to the previously read remote copies.
- Tracking: `mosaicstack/stack#1050` on `git.mosaicstack.dev` (author read back as `be-coder-05`).
- Historical implementation base: `origin/next` `4df478cdd150fdf8d52ea109f02ade5d85017acd`. Delivery PR #1054 targets `main` under L0's trunk-only rule; `next` remains a non-merging integration lane.
- Out of scope: PATH, skills, headless wizard/identity, activation remediation, #869 wiring, RM-02, main promotion.
- `docs/TASKS.md` is orchestrator-single-writer and is not modified by this worker.
-
-## Plan
-
-1. Pre-register the canonical phase/output/side-effect-free/fault-injection checks and observe RED against the base installer.
-2. Commit the immutable red-first acceptance fixture before implementation.
-3. Add the state-machine/journal/postcondition spine without repairing P4/P5/P8 symptoms.
-4. Wire the expected-RED from-zero fixture into Woodpecker using Debian/glibc and a non-root target user.
-5. Run shell/static baselines, situational container validation, code review, security review, then deliver through a PR to `next` under the coordinator-owned merge path.
-
-## Budget
-
- Working estimate: 32K reasoning/output tokens.
- Hard external cap: none stated.
- Adaptation: keep implementation in shell surfaces already in scope; no package dependency install unless repository gates require it.
-
-## Pre-registered acceptance checks
-
-| ID | Exact case | Expected pre-fix result |
-|---|---|---|
-| C1-R1 | `tools/e2e-install-test.sh --lane next` in a clean Debian 12 container as uid 1001 | non-zero; P3 PASS; P4 `NOT-MEASURED / UNDECLARED`; P5/P6/P8 FAIL with own reasons |
-| C1-R2 | `tools/install-state-machine.test.sh` phase table case | RED because base installer does not enumerate canonical P0–P9 contracts |
-| C1-R3 | side-effect-free `--check` case over a fingerprinted HOME | RED because base `--check` is version-only rather than P0–P8 predicates |
-| C1-R4 | fault injection after each P2…P8 | RED because base installer has no injectable durable journal/rollback state |
-| C1-R5 | Docker unavailable | base harness incorrectly exits 0; replacement must fail non-zero |
-| C1-R6 | lane resolution | bare checkout is forbidden; fixture must pass `--next` and assert the resolved prerelease version |
-| C1-R7 | same Debian fixture with `git` absent vs present | absent: P1 FAIL while legacy installer exits 0 and sync degrades; present: P1 PASS and observed store/runtime containment 101/101 |
-
-## Progress
-
- [x] Charter, doctrine, delivery/CI/QA/docs guides read and re-anchored after compaction.
- [x] Canonical PRD v2/v3 addenda and charters read from fetched `origin/main`; numbering reconciles with the TL spec. No numbering conflict found. INV-B/C/D are binding and implemented without renumbering.
- [x] Target base reachability verified with `merge-base --is-ancestor`.
- [x] Issue #1050 created and provider author read back.
- [x] Initial RED captured; TL rejected P4's repo-root count as a false RED. Four populations disagree (framework payload 1, repo root 13, sync store 101 in the fixture, W-jarvis observation 7), so C1 now requires a checkout-free declared shipped-set artifact and reports P4 `NOT-MEASURED / UNDECLARED` until C5 supplies it.
- [x] P6 strengthens #869: the two dead enforcement hooks reproduce from zero on a clean broker-less container. C1 asserts the breach but neither wires nor unwires it.
- [x] P1 false pass identified from the P4 evidence row: `git` is absent from the Debian base and was undeclared even though skill sync shells out to it. C1 adds `git` to P1; the fixture matrix preserves absent/present controls. The prior claim that web1's missing runtime skills reproduce this greenfield mechanism is withdrawn by the TL and is not carried here.
- [x] Corrected RED transcript captured and reported, including the git-present/absent controls and strict P3 PASS.
- [x] State-machine implementation complete: private pre-mutation journal/snapshot, P0–P8 `--check`, P2–P8 fault seam, rollback, durable manifest/journal seal, action-status persistence, safe rollback roots, and stale-projection recovery.
- [x] Debian/glibc checkout fixture now packages the complete current checkout, verifies its digest in-container, and reaches the expected attributable RED without host inheritance. CI compares its exact final phase map/reasons to `tools/fixtures/greenfield-expected-red.tsv`; the fixture remains red while the detector job is green only on an exact match.
- [ ] Reviews complete. Reviews 80 (`rev-security-02`) and 81 (`rev-974`) requested changes at `3934e03f`; their eight non-overlapping detector findings are being remediated red-first. Current remediation adds canonical-image portability, absolute P3 CLI propagation, exact expected-RED schema/cardinality, passwd-HOME binding, created-path owner/mode policy, real-action P2–P8 fault injection, verified non-empty remote installer execution, and seeded secret-canary/redacted diagnostics. Both old verdicts become void when the remediation head moves and require fresh independent review.
- [x] Successor remediation for review 90 is RED-first and recorded in `docs/reports/verification/1050-successor-remediation/`: the manifest now binds the complete supported final P0 reason; P4 rejects an incomplete created-path walk instead of discarding `find` failure; and the TERM no-exit control is independent of filesystem enumeration order while retaining a proven RED mutation. Pipeline 2224's 32/2 result was a path-order-sensitive control, not evidence that the resume bug's premise became stale. The enumeration-class sweep additionally replaced order-dependent `find | head -1` source-root selection with a checked complete inventory requiring exactly one extracted root.
- [x] C1 fix round for reviews 92/93: Blocker B was completed first. RED was reproduced before implementation: a planted `{"status":"in-progress"}` record makes the complete real walk fail the suite at P2, while the same planted defect beneath a target-owned mode-0100 directory makes real `find` fail and the frozen suite falsely exit 0 with `installer next lane tests passed`. One shared helper now captures and checks the complete NUL-delimited population before testing absence across the primary and copied harness sites; grep no-match is distinct from read failure. The same attack child drives the full suite RED with a named enumeration error, while ordinary native and root/container runs pass. Blocker A then regenerated the exact installer sidecar; provider-fetch validation remains the required post-push bar. Working estimate: 16K tokens; no external hard cap; 60% context is the stop/report gate.
-
-## Risks / blockers
-
- The deployed create wrappers do not expose `--dry-run`; identity preflight was performed through `pr-merge.sh --dry-run` on the same HOMELAB repo, which resolved `git.mosaicstack.dev` + `be-coder-05`. The issue create then fell back from tea to the API but provider read-back confirmed author `be-coder-05`.
- `next` is a non-merging integration lane; PR #1054 targets `main`. The old “pending promotion to main” caution dissolved when the base moved. #1050 remains open after merge and closes only after Jarvis validates the greenfield behavior.
- #869 must remain staged and inactive.
- Late sequencing input MB-BRAIN-01 is accommodated without implementation or renumbering: P2 covers installer distribution only; P5 owns requested credential capability; P7 leaves an ordered seam for credential-dependent resource provisioning after P5.
-
-## Remediation review controls
-
- B1 RED: the next-lane harness failed immediately under `ci-base:latest` as root/musl; it now models uid 1001/glibc explicitly and uses Python tree fingerprints instead of GNU `find -printf`.
- B2 RED: framework/runtime linking consumed bare `mosaic` from PATH after P3 had committed an absolute path. The unified installer now exports/passes `MOSAIC_CLI_PATH`; the linker invokes that absolute artifact, and wizard auto-launch has no stale-PATH fallback.
- B3 RED: a one-row manifest (`exit=1`) certified any exit-1 log. Full-manifest validation now requires the exact three cases, one exit and P0–P9 row each, pinned require/forbid populations, and rejects malformed/duplicate/unknown rows; shrink is a negative control.
- B4 RED: uid 1001 with a passwd HOME different from ambient HOME produced P0 PASS. P0 now binds uid, username, passwd HOME and shell and explicitly rejects root and sudo-with-inherited-HOME controls.
- B5 RED: mode-0777 CLI, mode-0644 identity, and mode-0755 credential storage passed. P3/P4/P5 now apply target owner/group plus executable/shared/private policies; framework credential storage is created 0700.
- B6 RED: fault injection only wrote `.selftest-*` files. The synthetic path was removed; the P2–P8 matrix enters the normal action flow, proves an action observation occurred, injects after each real phase, and fingerprints rollback.
- B7 RED: an HTTP-200 empty body exits zero when piped to Bash. The fetched installer must now be non-empty, digest-equal to `tools/install.sh.sha256`, and that exact file is executed; failed/empty/mismatch controls are blocking and CI has a remote immutable-commit arm.
- B8 RED: raw combined command output was duplicated to terminal and `commands.log`. Both capture layers now redact before output/persistence; a seeded canary is positively emitted by the fake credential-capable registry and must remain absent from terminal, command log, npmrc, generated files and observed argv. The real greenfield fixture also scans those populations.
- Advisory code review findings are fixed: URL userinfo redaction now handles raw `@`, token-only and percent-encoded forms, repeated `:`, multiple URLs, Authorization/Basic, npm `_auth`, and Cookie headers in both capture layers; the real greenfield path positively emits its canary through `state_run_captured`; verified-fetch removes its temporary body after successful execution; and plaintext diagnostics exist only in process-substitution pipes rather than interruptible temporary files.
- Advisory security review's independent trust-root finding is **DEFERRED by canonical PRD v2 §3**, which explicitly excludes signed provenance. README now states precisely that the same-origin sidecar detects empty/corrupt/inconsistent publication but cannot authenticate against repository/server compromise; no stronger claim remains.
- The web1 no-manifest representativeness observation is recorded but intentionally not acted on: it is explicitly outside these eight blockers. This remediation does not weaken or otherwise change P9's manifest-presence assertion.
-
-## Verification log
-
- `bash -n` and ShellCheck pass for all changed shell surfaces; `git diff --check` passes.
- `bash tools/install-state-machine.test.sh` passes, including exact P0–P8 rows, passwd-HOME/privilege discrimination, owner/group/mode attacks, persisted P4/P6 action failures, no synthetic fault implementation, unsafe/overlapping/symlink roots, and fatal journal initialization.
- `bash tools/install-next-lane.test.sh` passes inside `ci-base:latest`, including exact `@next` versions, immutable source fallback, source-build/archive-failure rollback, offline `--dev`, explicit refs, prerelease suffix mismatch, absolute P3 CLI propagation, secret redaction, real-action P2–P8 rollback, and stale projection recovery.
- Comparator controls pass for verdict drift, unexpected exit, manifest shrink, missing phases, duplicate rows, unknown cases, and unknown kinds. Verified-fetch controls pass for successful execution and failed/empty/digest-mismatch rejection.
- `bash tools/e2e-install-test.sh --lane next --source checkout --git present` returns the required expected RED in clean Debian/glibc as uid 1001: installer P0/P1/P2/P3/P7 PASS; P4/P5/P6/P8 and P9 blocking; no `Done.` claim; checkout archive digest pinned and current framework installer exercised. `tools/verify-greenfield-expected-red.sh` converts that expected detector result into a green CI assertion and fails on any unreviewed verdict drift.
- Earlier repository gates passed: `pnpm typecheck`, `pnpm lint`, `pnpm format:check`, upgrade manifest/rollback/durable-snapshot/migration suites, and focused `@mosaicstack/mosaic` tests with an isolated npm prefix. Full exact-remediation rerun is required before push.
- Review-93 RED evidence at frozen `378bc1a`: isolated positive-control full-suite exit `1` with `P2 left an in-progress transaction`; isolated permission-failure attack full-suite exit `0` with final `installer next lane tests passed`. No binary shadowing or PATH interception was used; the failure came from a real target-owned mode-0100 directory.
- Fix-round GREEN: `pnpm test:installer`, native next-lane, root/`ci-base:latest` next-lane, state-machine, verified-fetch, Bash syntax, ShellCheck, `pnpm typecheck`, `pnpm lint`, `pnpm format:check`, and `git diff --check` pass. The direct attack child exits 1 and names `P2 fault-state enumeration failed`. All 81 Mosaic Vitest files / 1508 tests pass under an isolated npm prefix; the wider framework-shell chain reaches the pre-existing #973 Bash-line-number gate and exits 97, matching the known host-specific condition rather than this delta. Codex code review approved at 0.93 confidence with zero findings; Codex security review reported no risk at 0.96 confidence with zero findings.
- Sidecar GREEN locally: `sha256sum -c tools/install.sh.sha256` and the workflow's expected/actual comparison both resolve `e59cb441a2f37ae9150f8eae470238e9d858a1816df93343d9784a6796676096`. This is not substituted for the required immutable provider-fetch arm at the pushed head.
@@ -10,8 +10,7 @@
    "clean:generated": "node scripts/clean-generated.mjs",
    "typecheck": "pnpm preflight && turbo run typecheck",
    "test:checkout": "node --test scripts/*.test.mjs",
-    "test": "pnpm test:checkout && turbo run test && pnpm run test:installer",
-    "test:installer": "bash tools/install-state-machine.test.sh && bash tools/install-next-lane.test.sh && bash tools/verify-greenfield-expected-red.test.sh && bash tools/verified-installer-fetch.test.sh",
+    "test": "pnpm test:checkout && turbo run test",
    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md}\"",
    "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md}\"",
    "prepare": "node scripts/install-hooks.mjs"
@@ -58,7 +58,6 @@ done
 # packages/mosaic/src/framework/manifest.ts — both consume framework-manifest.txt.
 # Sourcing does not run its CLI dispatch (guarded by BASH_SOURCE==$0).
 # shellcheck source=tools/_lib/manifest.sh
-# shellcheck disable=SC1091 # Dynamic SOURCE_DIR; the path is validated by set -e.
 source "$SOURCE_DIR/tools/_lib/manifest.sh"

 # Which paths a keep-mode upgrade may touch is no longer a hand-maintained
@@ -223,14 +222,12 @@ prune_durable_snapshots() {
  [[ "$keep" =~ ^[0-9]+$ ]] && (( keep >= 1 )) || keep=5
  list="$(mktemp)"
  if ! find "$root" -maxdepth 1 -type d -name 'pre-update-*' > "$list"; then
-    warn "Backup pruning skipped; policy: retention cleanup is optional and a failed enumeration must preserve every existing recovery snapshot."
    rm -f "$list"; return 0
  fi
  # Newest-first ordering needs `sort` (`-o` writes back in place — no `mv`
  # dependency); if it is somehow unavailable, leave the backups untouched rather
  # than risk pruning in an undefined order.
  if ! LC_ALL=C sort -r -o "$list" "$list" 2>/dev/null; then
-    warn "Backup pruning skipped; policy: ordering failure preserves all snapshots rather than risking deletion in an undefined order."
    rm -f "$list"; return 0
  fi
  while IFS= read -r d; do
@@ -269,11 +266,7 @@ make_durable_snapshot() {
    warn "Durable snapshot skipped: cannot create backup dir $root (upgrade continues; operator files remain manifest-protected)."
    return 0
  fi
-  if ! chmod 700 "$root"; then
-    umask "$old_umask"
-    warn "Durable snapshot skipped: backup root permissions could not be made private; policy: never write operator data to an insufficiently protected location."
-    return 0
-  fi
+  chmod 700 "$root" 2>/dev/null || true
  dir="$root/pre-update-$ts"
  if [[ -e "$dir" ]]; then           # same-second re-run: disambiguate
    local n=1; while [[ -e "$dir-$n" ]]; do n=$((n + 1)); done; dir="$dir-$n"
@@ -288,10 +281,7 @@ make_durable_snapshot() {
  if ! enumerate_operator_files "$list"; then
    umask "$old_umask"
    warn "Durable snapshot skipped: could not enumerate operator files (upgrade continues)."
-    rm -f "$list"
-    if ! rmdir "$dir"; then
-      warn "Durable snapshot cleanup left $dir in place; policy: preserve unexpected content rather than deleting it recursively."
-    fi
+    rm -f "$list"; rmdir "$dir" 2>/dev/null || true
    return 0
  fi
  while IFS= read -r -d '' rel; do
@@ -302,18 +292,12 @@ make_durable_snapshot() {
      warn "Durable snapshot: could not copy operator file '$rel' (skipped)."
      continue
    fi
-    if ! chmod 600 "$dst"; then
-      rm -f "$dst"
-      warn "Durable snapshot: copied '$rel' could not be made private and was removed; policy: do not retain an insecure recovery copy."
-      continue
-    fi
+    chmod 600 "$dst" 2>/dev/null || true
    count=$((count + 1))
  done < "$list"
  rm -f "$list"
-  # Tighten every dir the copy created (mkdir -p already honored umask 077).
-  if ! find "$dir" -type d -exec chmod 700 {} +; then
-    warn "Durable snapshot directory permission recheck failed; policy: continue because every directory was created under umask 077, while retaining the diagnostic."
-  fi
+  # Tighten every dir the copy created (mkdir -p honors umask, but be explicit).
+  find "$dir" -type d -exec chmod 700 {} + 2>/dev/null || true
  umask "$old_umask"   # UMASK-RESTORE-NORMAL — restore before the upgrade proper resumes (see above)
  DURABLE_SNAPSHOT_DIR="$dir"
  ok "Durable pre-update snapshot: $count operator file(s) saved to $dir (recover with: mosaic restore --list)"
@@ -360,9 +344,7 @@ verify_operator_surface() {
        continue
      fi
      if cp "$snap" "$cur"; then
-        if ! chmod 600 "$cur"; then
-          warn "Operator file '$rel' was restored but its mode could not be tightened to 0600; policy: preserve recovered content and require manual permission repair."
-        fi
+        chmod 600 "$cur" 2>/dev/null || true
        warn "Operator file was modified by the upgrade and has been restored from the pre-update snapshot: $rel"
        healed=$((healed + 1))
      else
@@ -553,7 +535,7 @@ sync_framework_keep() {
    # (unreadable dir) is surfaced as a warning rather than silently swallowed;
    # the "directory not empty" races we tolerate are ignored via -delete's own
    # rc, not by hiding stderr — so a real error is still visible to the operator.
-    if ! find "$dst/$root" -type d -empty -delete; then
+    if ! find "$dst/$root" -type d -empty -delete 2>/dev/null; then
      warn "prune: could not fully sweep empty framework dirs under $root (left as-is)"
    fi
  done < <(manifest_subtree_roots)
@@ -599,7 +581,7 @@ run_migrations() {
    MIGRATION_REMOVED_PATHS+=("bin" "rails")
    if [[ -d "$TARGET_DIR/bin" ]]; then
      ok "Removing legacy bin/ directory (executables now in npm CLI)"
-      rm -rf "${TARGET_DIR:?}/bin"
+      rm -rf "$TARGET_DIR/bin"
    fi

    # Remove old mosaic PATH entry from shell profiles
@@ -710,11 +692,9 @@ trap 'restore_snapshot; exit 1' ERR INT TERM

 sync_framework

-# Ensure persistent directories exist. Credentials are private material and
-# must never inherit a permissive umask/default mode.
+# Ensure persistent directories exist
 mkdir -p "$TARGET_DIR/memory"
 mkdir -p "$TARGET_DIR/credentials"
-chmod 0700 "$TARGET_DIR/credentials"

 # Reconcile contract files from defaults/ into the framework root: framework-owned
 # files (CONSTITUTION/AGENTS/STANDARDS) are overwritten every upgrade (a divergent
@@ -726,23 +706,13 @@ chmod 0700 "$TARGET_DIR/credentials"
 # by `mosaic init` from templates with user-supplied values.
 reconcile_framework_files

-# Ensure tool scripts are executable. These are P4 postconditions, not
-# best-effort cleanup: a chmod failure leaves shipped tools unloadable.
-if ! find "$TARGET_DIR/tools" -name "*.sh" -exec chmod +x {} +; then
-  fail "Could not mark shipped shell tools executable."
-  exit 1
-fi
-if ! find "$TARGET_DIR/tools/_scripts" -type f -exec chmod +x {} +; then
-  fail "Could not mark shipped runtime scripts executable."
-  exit 1
-fi
+# Ensure tool scripts are executable
+find "$TARGET_DIR/tools" -name "*.sh" -exec chmod +x {} + 2>/dev/null || true
+find "$TARGET_DIR/tools/_scripts" -type f -exec chmod +x {} + 2>/dev/null || true
 # git-credential-mosaic (per-agent Gitea identity helper) ships without a .sh
-# suffix — git resolves credential helpers by exact name/path, not extension.
-if [[ -f "$TARGET_DIR/tools/git/git-credential-mosaic" ]] \
-  && ! chmod +x "$TARGET_DIR/tools/git/git-credential-mosaic"; then
-  fail "Could not mark git-credential-mosaic executable."
-  exit 1
-fi
+# suffix — git resolves credential helpers by exact name/path, not extension —
+# so the *.sh glob above does not cover it; chmod it explicitly.
+[[ -f "$TARGET_DIR/tools/git/git-credential-mosaic" ]] && chmod +x "$TARGET_DIR/tools/git/git-credential-mosaic" 2>/dev/null || true

 ok "Framework synced to $TARGET_DIR"

@@ -769,162 +739,49 @@ step "Post-install tasks"

 SCRIPTS="$TARGET_DIR/tools/_scripts"

-# Capture every fallible post-install command. A failure's text is surfaced and
-# also appended to the parent transaction's private command log. Failure to
-# write that log is fatal: continuing would recreate the false-clean diagnosis
-# INV-C forbids.
-record_phase_outcome() {
-  local phase="$1" status="$2" reason="$3"
-  [[ -n "${MOSAIC_INSTALL_PHASE_STATUS_FILE:-}" ]] || return 0
-  if ! printf '%s\t%s\t%s\n' "$phase" "$status" "$reason" >> "$MOSAIC_INSTALL_PHASE_STATUS_FILE" \
-    || ! sync "$MOSAIC_INSTALL_PHASE_STATUS_FILE"; then
-    fail "Could not durably record $phase action outcome for the parent transaction."
-    exit 1
-  fi
-}
-
-redact_install_stream() {
-  # Keep this bootstrap copy behaviorally identical to tools/install.sh's
-  # state_redact_stream; neither installer can assume the other is installed.
-  python3 /dev/fd/3 3<<'PY'
-import os, re, sys
-text = sys.stdin.read()
-secret_name = re.compile(r"(?:TOKEN|PASSWORD|PASSWD|SECRET|API_KEY|AUTH|CREDENTIAL|CANARY)", re.I)
-secrets = {value for name, value in os.environ.items() if secret_name.search(name) and len(value) >= 4}
-for value in sorted(secrets, key=len, reverse=True):
-    text = text.replace(value, "[REDACTED]")
-patterns = (
-    (re.compile(r"(?im)^(\s*(?:proxy-)?authorization\s*:\s*)[^\r\n]+"), r"\1[REDACTED]"),
-    (re.compile(r"(?im)^(\s*(?:set-)?cookie\s*:\s*)[^\r\n]+"), r"\1[REDACTED]"),
-    (re.compile(r"(?i)(Bearer\s+)[^\s'\"]+"), r"\1[REDACTED]"),
-    (re.compile(r"(?i)((?:[_-]?auth(?:Token)?|token|password|passwd|secret|api[_-]?key)\s*[=:]\s*)[^\s'\"]+"), r"\1[REDACTED]"),
-)
-for pattern, replacement in patterns:
-    text = pattern.sub(replacement, text)
-url_pattern = re.compile(r"https?://[^\s'\"<>]+", re.I)
-def redact_url(match):
-    url = match.group(0)
-    scheme_end = url.find("://") + 3
-    authority_end = len(url)
-    for separator in "/?#":
-        position = url.find(separator, scheme_end)
-        if position != -1:
-            authority_end = min(authority_end, position)
-    authority = url[scheme_end:authority_end]
-    at = authority.rfind("@")
-    if at != -1:
-        return url[:scheme_end] + "[REDACTED]@" + authority[at + 1:] + url[authority_end:]
-    return url
-sys.stdout.write(url_pattern.sub(redact_url, text))
-PY
-}
-
-run_captured() {
-  local label="$1" redacted redactor_pid capture_fd status=0 redact_status=0
-  shift
-  redacted="$(mktemp "${TMPDIR:-/tmp}/mosaic-post-redacted.XXXXXX")"
-  chmod 0600 "$redacted" || { rm -f "$redacted"; exit 1; }
-  # Preserve in-shell command behavior without ever staging plaintext output on
-  # disk. Process substitution carries raw bytes only through a pipe.
-  exec {capture_fd}> >(redact_install_stream > "$redacted")
-  redactor_pid=$!
-  set +e
-  "$@" >&"$capture_fd" 2>&1
-  status=$?
-  exec {capture_fd}>&-
-  wait "$redactor_pid"
-  redact_status=$?
-  set -e
-  if [[ "$redact_status" -ne 0 ]]; then
-    rm -f "$redacted"
-    fail "Could not redact '$label' diagnostics; refusing to expose or persist raw output."
-    exit 1
-  fi
-  if [[ -n "${MOSAIC_INSTALL_COMMAND_LOG:-}" ]]; then
-    if ! { printf '\n=== %s (exit=%s) ===\n' "$label" "$status"; cat "$redacted"; } >> "$MOSAIC_INSTALL_COMMAND_LOG" \
-      || ! sync "$MOSAIC_INSTALL_COMMAND_LOG"; then
-      cat "$redacted" >&2
-      rm -f "$redacted"
-      fail "Could not durably append '$label' diagnostics to the install command log."
-      exit 1
-    fi
-  fi
-  if [[ "$status" -ne 0 ]]; then cat "$redacted" >&2; fi
-  rm -f "$redacted"
-  return "$status"
-}
-
 if [[ -x "$SCRIPTS/mosaic-link-runtime-assets" ]]; then
  link_args=()
  [[ "$ALLOW_INACTIVE_ENFORCEMENT" == "1" ]] && link_args+=(--allow-inactive-enforcement)
-  if run_captured "runtime asset linking" "$SCRIPTS/mosaic-link-runtime-assets" "${link_args[@]}"; then
-    record_phase_outcome P6 committed "runtime asset linker exited zero"
+  # stdout is suppressed as before, but stderr is left connected: the
+  # install-ordering guard's FAIL LOUD message (#869 Point-1 C2) must reach
+  # the operator, not be swallowed silently.
+  if "$SCRIPTS/mosaic-link-runtime-assets" "${link_args[@]}" >/dev/null; then
    ok "Runtime assets linked"
  else
-    record_phase_outcome P6 failed "runtime asset linker exited non-zero"
-    warn "Runtime asset linking did not commit; policy: continue only to enumerate all phase diagnostics, while P6/P9 remain blocking."
+    warn "Runtime asset linking failed (non-fatal) — see message above for details."
  fi
-else
-  record_phase_outcome P6 failed "required runtime asset linker is missing or not executable"
-  warn "Runtime asset linking was not attempted; policy: a missing required linker remains a blocking P6/P9 failure."
 fi

 if [[ -x "$SCRIPTS/mosaic-ensure-sequential-thinking" ]]; then
-  if run_captured "sequential-thinking setup" "$SCRIPTS/mosaic-ensure-sequential-thinking"; then
+  if "$SCRIPTS/mosaic-ensure-sequential-thinking" >/dev/null 2>&1; then
    ok "sequential-thinking MCP configured"
-  elif [[ "${MOSAIC_ALLOW_MISSING_SEQUENTIAL_THINKING:-0}" == "1" ]]; then
-    record_phase_outcome P6 failed "sequential-thinking setup failed under diagnostic-continuation compatibility mode"
-    warn "sequential-thinking setup did not commit; policy: the unified installer compatibility flag allows diagnostic continuation, while P6/P9 remain blocking."
  else
-    fail "sequential-thinking MCP setup failed (hard requirement)."
-    exit 1
+    if [[ "${MOSAIC_ALLOW_MISSING_SEQUENTIAL_THINKING:-0}" == "1" ]]; then
+      warn "sequential-thinking MCP setup bypassed (MOSAIC_ALLOW_MISSING_SEQUENTIAL_THINKING=1)"
+    else
+      fail "sequential-thinking MCP setup failed (hard requirement)."
+      exit 1
+    fi
  fi
 fi

 if [[ -x "$SCRIPTS/mosaic-ensure-excalidraw" ]]; then
-  if run_captured "excalidraw setup" "$SCRIPTS/mosaic-ensure-excalidraw"; then
-    ok "excalidraw MCP configured"
-  else
-    warn "excalidraw setup did not commit; policy: optional integration failure is retained in the journal and does not define core install readiness."
-  fi
+  "$SCRIPTS/mosaic-ensure-excalidraw" >/dev/null 2>&1 && ok "excalidraw MCP configured" || warn "excalidraw MCP setup failed (non-fatal)"
 fi

-if [[ "${MOSAIC_SKIP_SKILLS_SYNC:-0}" == "1" ]]; then
-  record_phase_outcome P4 failed "required skills sync explicitly skipped"
-  warn "Skills sync was skipped; policy: diagnostic continuation is allowed, but P4/P9 cannot certify an incomplete requested framework install."
-elif [[ -x "$SCRIPTS/mosaic-sync-skills" ]]; then
-  if run_captured "skills sync" "$SCRIPTS/mosaic-sync-skills"; then
-    record_phase_outcome P4 committed "skills sync exited zero"
-    ok "Skills synced"
-  else
-    record_phase_outcome P4 failed "skills sync exited non-zero"
-    warn "Skills sync did not commit; policy: continue to collect P4 diagnostics, but P4/P9 must not certify the install."
-  fi
-else
-  record_phase_outcome P4 failed "required skills sync command is missing or not executable"
-  warn "Skills sync was not attempted; policy: a missing required sync command remains a blocking P4/P9 failure."
+if [[ "${MOSAIC_SKIP_SKILLS_SYNC:-0}" != "1" ]] && [[ -x "$SCRIPTS/mosaic-sync-skills" ]]; then
+  "$SCRIPTS/mosaic-sync-skills" >/dev/null 2>&1 && ok "Skills synced" || warn "Skills sync failed (non-fatal)"
 fi

 if [[ -x "$SCRIPTS/mosaic-migrate-local-skills" ]]; then
-  if run_captured "local skills migration" "$SCRIPTS/mosaic-migrate-local-skills" --apply; then
-    ok "Local skills migrated"
-  else
-    record_phase_outcome P4 failed "local skills migration exited non-zero"
-    warn "Local skill migration did not commit; policy: preserve user content and continue diagnostics, while P4/P9 remain blocking."
-  fi
+  "$SCRIPTS/mosaic-migrate-local-skills" --apply >/dev/null 2>&1 && ok "Local skills migrated" || warn "Local skill migration failed (non-fatal)"
 fi

 if [[ -x "$SCRIPTS/mosaic-doctor" ]]; then
-  if run_captured "health audit" "$SCRIPTS/mosaic-doctor"; then
-    ok "Health audit passed"
-  else
-    warn "Health audit found unresolved state; policy: preserve its diagnostics and let P9 issue the authoritative failure."
-  fi
+  "$SCRIPTS/mosaic-doctor" >/dev/null 2>&1 && ok "Health audit passed" || warn "Health audit reported issues — run 'mosaic doctor' for details"
 fi

-# The version stamp records the successfully committed framework file sync.
-# Post-install failures are carried separately into P4/P6 and cannot be erased
-# by this stamp.
+# Write version stamp AFTER everything succeeds
 write_framework_version

 # ── Summary ──────────────────────────────────────────────────
@@ -112,6 +112,7 @@ EOF
  chmod 700 "$AGENT_HOME/fleet/agents"
  cat > "$AGENT_HOME/fleet/agents/$AGENT_NAME.env.generated" <<EOF
 MOSAIC_AGENT_NAME=$AGENT_NAME
+MOSAIC_GIT_IDENTITY=$AGENT_NAME
 MOSAIC_AGENT_CLASS=code
 MOSAIC_AGENT_RUNTIME=pi
 MOSAIC_AGENT_MODEL=
@@ -68,15 +68,8 @@ copy_claude_settings_guarded() {
    guard_args+=(--allow-inactive-enforcement)
  fi

-  local mosaic_cli="${MOSAIC_CLI_PATH:-}"
-  # Unified install passes P3's committed absolute artifact. Standalone
-  # framework installs may resolve PATH once, but still invoke the resulting
-  # absolute path rather than a bare command.
-  if [[ -z "$mosaic_cli" ]]; then
-    mosaic_cli="$(command -v mosaic 2>/dev/null || true)"
-  fi
-  if [[ "$mosaic_cli" == /* && -x "$mosaic_cli" ]]; then
-    if "$mosaic_cli" "${guard_args[@]}"; then
+  if command -v mosaic >/dev/null 2>&1; then
+    if mosaic "${guard_args[@]}"; then
      return 0
    fi
    echo "[mosaic-link] Enforcement hooks were NOT wired into $dst (see message above)." >&2
@@ -84,7 +77,7 @@ copy_claude_settings_guarded() {
    return 0
  fi

-  echo "[mosaic-link] ERROR: P3 absolute mosaic CLI unavailable — cannot confirm lease-enforcement" >&2
+  echo "[mosaic-link] ERROR: 'mosaic' CLI not found on PATH — cannot confirm lease-enforcement" >&2
  echo "[mosaic-link] activation capability. enforcement requested but activation half absent —" >&2
  echo "[mosaic-link] needs a published CLI carrying launch-runtime activation + a broker" >&2
  echo "[mosaic-link] supervisor; refusing to wire a dead gate (see #869)." >&2
@@ -97,7 +97,7 @@ is_sensitive_key() {

 is_generated_key() {
  case "$1" in
-    MOSAIC_AGENT_NAME|MOSAIC_AGENT_CLASS|MOSAIC_AGENT_RUNTIME|MOSAIC_AGENT_MODEL|MOSAIC_AGENT_REASONING|MOSAIC_AGENT_TOOL_POLICY|MOSAIC_AGENT_WORKDIR|MOSAIC_TMUX_SOCKET) return 0 ;;
+    MOSAIC_AGENT_NAME|MOSAIC_GIT_IDENTITY|MOSAIC_AGENT_CLASS|MOSAIC_AGENT_RUNTIME|MOSAIC_AGENT_MODEL|MOSAIC_AGENT_REASONING|MOSAIC_AGENT_TOOL_POLICY|MOSAIC_AGENT_WORKDIR|MOSAIC_TMUX_SOCKET) return 0 ;;
    *) return 1 ;;
  esac
 }
@@ -114,6 +114,7 @@ validate_generated_value() {
  local value="$2"
  case "$key" in
    MOSAIC_AGENT_NAME) safe_agent_name "$value" || fail_env unsafe-agent-name "$key" "$value" ;;
+    MOSAIC_GIT_IDENTITY) safe_agent_name "$value" || fail_env unsafe-git-identity "$key" "$value" ;;
    MOSAIC_AGENT_CLASS) safe_policy_name "$value" || fail_env unsafe-class "$key" "$value" ;;
    MOSAIC_AGENT_RUNTIME)
      case "$value" in claude|codex|opencode|pi) ;; *) fail_env unsupported-runtime "$key" "$value" ;; esac
@@ -175,7 +176,7 @@ load_environment_file() {

 load_environment_file "$GENERATED_ENV" generated
 for required_key in \
-  MOSAIC_AGENT_NAME MOSAIC_AGENT_CLASS MOSAIC_AGENT_RUNTIME MOSAIC_AGENT_MODEL \
+  MOSAIC_AGENT_NAME MOSAIC_GIT_IDENTITY MOSAIC_AGENT_CLASS MOSAIC_AGENT_RUNTIME MOSAIC_AGENT_MODEL \
  MOSAIC_AGENT_REASONING MOSAIC_AGENT_TOOL_POLICY MOSAIC_AGENT_WORKDIR MOSAIC_TMUX_SOCKET; do
  [ -n "${GENERATED_VALUES[$required_key]+set}" ] || fail_env missing-key "$required_key" ''
 done
@@ -183,12 +184,15 @@ load_environment_file "$LOCAL_ENV" local

 [ "${GENERATED_VALUES[MOSAIC_AGENT_NAME]}" = "$AGENT_NAME" ] || \
  fail_env agent-name-mismatch MOSAIC_AGENT_NAME "${GENERATED_VALUES[MOSAIC_AGENT_NAME]}"
+[ "${GENERATED_VALUES[MOSAIC_GIT_IDENTITY]}" = "$AGENT_NAME" ] || \
+  fail_env git-identity-mismatch MOSAIC_GIT_IDENTITY "${GENERATED_VALUES[MOSAIC_GIT_IDENTITY]}"

 MOSAIC_TMUX_SOCKET=${GENERATED_VALUES[MOSAIC_TMUX_SOCKET]}
 MOSAIC_AGENT_RUNTIME=${GENERATED_VALUES[MOSAIC_AGENT_RUNTIME]}
 MOSAIC_AGENT_MODEL=${GENERATED_VALUES[MOSAIC_AGENT_MODEL]}
 MOSAIC_AGENT_REASONING=${GENERATED_VALUES[MOSAIC_AGENT_REASONING]}
 MOSAIC_AGENT_WORKDIR=${GENERATED_VALUES[MOSAIC_AGENT_WORKDIR]}
+MOSAIC_GIT_IDENTITY=${GENERATED_VALUES[MOSAIC_GIT_IDENTITY]}
 MOSAIC_AGENT_CLASS=${GENERATED_VALUES[MOSAIC_AGENT_CLASS]}
 MOSAIC_AGENT_TOOL_POLICY=${GENERATED_VALUES[MOSAIC_AGENT_TOOL_POLICY]}
 MOSAIC_RUNTIME_BIN=${LOCAL_VALUES[MOSAIC_RUNTIME_BIN]:-}
@@ -343,6 +347,7 @@ LAUNCH_ENV=(
  "PATH=$PANE_PATH"
  "MOSAIC_HOME=$MOSAIC_HOME"
  "MOSAIC_AGENT_NAME=$AGENT_NAME"
+  "MOSAIC_GIT_IDENTITY=$MOSAIC_GIT_IDENTITY"
  "MOSAIC_AGENT_CLASS=$MOSAIC_AGENT_CLASS"
  "MOSAIC_AGENT_RUNTIME=$MOSAIC_AGENT_RUNTIME"
  "MOSAIC_AGENT_MODEL=$MOSAIC_AGENT_MODEL"
@@ -71,6 +71,7 @@ write_generated() {
  chmod 600 "$home/fleet/run/holder-owner"
  cat > "$home/fleet/agents/$agent.env.generated" <<EOF
 MOSAIC_AGENT_NAME=$agent
+MOSAIC_GIT_IDENTITY=$agent
 MOSAIC_AGENT_CLASS=code
 MOSAIC_AGENT_RUNTIME=pi
 MOSAIC_AGENT_MODEL=openai-codex/gpt-5.6-sol
@@ -114,6 +115,42 @@ fi
 echo "$valid_args" | grep -qxF '/usr/bin/env' || fail "pane does not use absolute env"
 echo "$valid_args" | grep -qxF -- '-i' || fail "pane environment is not cleared"

+# Git identity is generated authority, not an optional or independently mutable
+# local value. Each invalid form must fail before fake tmux receives a call.
+assert_git_identity_rejected() {
+  local case_name="$1"
+  local expected_code="$2"
+  local home="$ROOT/git-identity-$case_name"
+  local agent="coder-git-identity-$case_name"
+  local generated="$home/fleet/agents/$agent.env.generated"
+  write_generated "$home" "$agent"
+
+  case "$case_name" in
+    missing) grep -v '^MOSAIC_GIT_IDENTITY=' "$generated" > "$generated.next" && mv "$generated.next" "$generated" ;;
+    unsafe) sed -i 's|^MOSAIC_GIT_IDENTITY=.*$|MOSAIC_GIT_IDENTITY=bad/identity|' "$generated" ;;
+    mismatch) sed -i 's|^MOSAIC_GIT_IDENTITY=.*$|MOSAIC_GIT_IDENTITY=other-agent|' "$generated" ;;
+    local-shadow)
+      printf 'MOSAIC_GIT_IDENTITY=%s\n' "$agent" > "$home/fleet/agents/$agent.env.local"
+      chmod 600 "$home/fleet/agents/$agent.env.local"
+      ;;
+    *) fail "unknown Git identity rejection case: $case_name" ;;
+  esac
+  chmod 600 "$generated"
+
+  : > "$TMUX_CALLS"
+  if output=$(run_start "$home" "$agent" 2>&1); then
+    fail "Git identity case $case_name was accepted"
+  fi
+  [ ! -s "$TMUX_CALLS" ] || fail "tmux ran before Git identity $case_name rejection"
+  echo "$output" | grep -qF "code=$expected_code" || \
+    fail "Git identity $case_name diagnostic omitted code $expected_code"
+}
+
+assert_git_identity_rejected missing missing-key
+assert_git_identity_rejected unsafe unsafe-git-identity
+assert_git_identity_rejected mismatch git-identity-mismatch
+assert_git_identity_rejected local-shadow generated-key-shadow
+
 # The generated-file parent is a security boundary too: even a private regular
 # file is untrusted if its parent can be replaced or written by another user.
 # Validation must happen before fake tmux receives even a has-session call.
@@ -274,6 +311,18 @@ after_pane_env=$(printf '%s\n' "$pane_args" | grep -n -m1 -F '/usr/bin/env' | cu
 printf '%s\n' "$pane_args" | tail -n +"$after_pane_env" | grep -qxF -- '-i' || \
  fail "pane command did not clear its environment"
 pane_environment=$(tr '\0' '\n' < "$HOME_PANE_BOUNDARY/fleet/pane-environment")
+# Exercise the repository launcher at $START, not the independently installed
+# host copy. Set-compare every declared generated projection entry with the
+# launched process environment so a newly declared identity cannot be omitted
+# by a hand-maintained per-variable assertion.
+declared_generated_environment=$(sort "$HOME_PANE_BOUNDARY/fleet/agents/coder-pane-boundary.env.generated")
+missing_or_changed_generated_environment=$(comm -23 \
+  <(printf '%s\n' "$declared_generated_environment") \
+  <(printf '%s\n' "$pane_environment" | sort))
+if [ -n "$missing_or_changed_generated_environment" ]; then
+  missing_or_changed_keys=$(printf '%s\n' "$missing_or_changed_generated_environment" | cut -d= -f1 | paste -sd, -)
+  fail "runtime pane omitted or changed generated environment keys: $missing_or_changed_keys"
+fi
 echo "$pane_environment" | grep -qxF "HOME=$PANE_TRUSTED_HOME" || \
  fail "runtime pane did not receive trusted HOME"
 echo "$pane_environment" | grep -qF "$PANE_STALE_PATH" && fail "runtime pane received stale PATH"
@@ -290,6 +339,7 @@ write_interaction_generated() {
  chmod 600 "$home/fleet/run/holder-owner"
  cat > "$home/fleet/agents/$agent.env.generated" <<EOF
 MOSAIC_AGENT_NAME=$agent
+MOSAIC_GIT_IDENTITY=$agent
 MOSAIC_AGENT_CLASS=operator-interaction
 MOSAIC_AGENT_RUNTIME=pi
 MOSAIC_AGENT_MODEL=openai/gpt-5.6-sol
@@ -352,7 +402,7 @@ write_generated "$HOME_NATIVE_STALE" "coder-native-stale"
 write_heartbeat_local "$HOME_NATIVE_STALE" "coder-native-stale"
 STALE_HB="$HOME_NATIVE_STALE/run/coder-native-stale.hb"
 printf 'ts=native\npid=1\nstatus=busy\nmodel=stale-model\n' > "$STALE_HB"
-touch -d '10 seconds ago' "$STALE_HB.native"
+touch -t 200001010000.00 "$STALE_HB.native"
 MOSAIC_TEST_PANE_PID=$$ run_start "$HOME_NATIVE_STALE" coder-native-stale
 wait_for_sidecar_status "$STALE_HB"

@@ -381,7 +431,7 @@ echo "$output" | grep -qF 'code=unknown-key' || fail "interaction did not use sh
 : > "$TMUX_CALLS"
 HOME_INTERACTION_POLICY="$ROOT/interaction-policy"
 write_interaction_generated "$HOME_INTERACTION_POLICY" "interaction-policy"
-perl -0pi -e 's/MOSAIC_AGENT_RUNTIME=pi/MOSAIC_AGENT_RUNTIME=codex/' \
+sed -i 's|^MOSAIC_AGENT_RUNTIME=pi$|MOSAIC_AGENT_RUNTIME=codex|' \
  "$HOME_INTERACTION_POLICY/fleet/agents/interaction-policy.env.generated"
 if output=$(run_interaction "$HOME_INTERACTION_POLICY" interaction-policy 2>&1); then
  fail "interaction wrapper accepted a policy-incompatible projection"
@@ -180,16 +180,15 @@ chk "[control] without -E the mid-sync corruption survives (no rollback)" \

 # ── Part C: an INT/TERM interrupt must terminate, not resume (blocker-A) ──────
 # A bash signal trap that merely returns lets the script continue past the
-# interrupt — restoring the snapshot, then resuming the install and reporting
-# success. Generate two installer fixtures that first damage a real target path
-# after the snapshot is armed, then signal their own Bash process immediately
-# before the normal sync. This fixed injection point is independent of `find`
-# enumeration order: after a no-exit handler restores and returns, the complete
-# sync still remains to run, so the historical resume bug is deterministic on
-# every filesystem. Their TERM handlers emit the same observable before
-# diverging, so missing signal delivery fails BOTH arms rather than manufacturing
-# a pass. The only semantic difference between fixtures is the explicit `exit 1`
-# whose load-bearing behavior this control proves.
+# interrupt — restoring the snapshot, then resuming the sync and reporting
+# success. The earlier test used a child cp shim to signal its parent, making
+# child completion race Bash's interrupted wait. Concurrency is not part of the
+# guarded property: sync_framework_keep() runs in the installer's own Bash
+# process, and `kill` is a builtin. Generate two installer fixtures that signal
+# themselves at the same known mid-sync point. Their TERM handlers emit the same
+# observable before diverging, so missing signal delivery fails BOTH arms rather
+# than manufacturing a pass. The only semantic difference between fixtures is
+# the explicit `exit 1` whose load-bearing behavior this control proves.
 TERM_MARKER='[test-control] TERM handler entered'
 HANDLER_WITH_EXIT="trap 'echo \"$TERM_MARKER\" >&2; restore_snapshot; exit 1' TERM  # TEST-TERM-HANDLER"
 HANDLER_WITHOUT_EXIT="trap 'echo \"$TERM_MARKER\" >&2; restore_snapshot' TERM  # TEST-TERM-HANDLER"
@@ -197,17 +196,19 @@ HANDLER_WITHOUT_EXIT="trap 'echo \"$TERM_MARKER\" >&2; restore_snapshot' TERM  #
 make_signal_installer() {
  local output="$1" handler="$2"
  local target_trap="trap 'restore_snapshot; exit 1' ERR INT TERM"
-  local target_sync='sync_framework'
-  local inject_damage="printf '%s' '$GARBAGE' > \"\$TARGET_DIR/$POISON_REL\"  # TEST-TERM-DAMAGE"
-  local inject_kill='kill -TERM "$$"  # TEST-TERM-INJECTION'
+  local target_cp='    cp "$abs" "$dst/$rel"'
+  local inject_open="    if [[ \"\$rel\" == \"$POISON_REL\" ]]; then"
+  local inject_kill='      kill -TERM "$$"  # TEST-TERM-INJECTION'
+  local inject_close='    fi'

  if ! awk \
-    -v target_trap="$target_trap" -v target_sync="$target_sync" \
-    -v handler="$handler" -v inject_damage="$inject_damage" \
-    -v inject_kill="$inject_kill" '
-      $0 == target_sync {
-        print inject_damage
+    -v target_trap="$target_trap" -v target_cp="$target_cp" \
+    -v handler="$handler" -v inject_open="$inject_open" \
+    -v inject_kill="$inject_kill" -v inject_close="$inject_close" '
+      $0 == target_cp {
+        print inject_open
        print inject_kill
+        print inject_close
        injection_sites++
      }
      { print }
@@ -230,8 +231,7 @@ make_signal_installer "$SIGNALED" "$HANDLER_WITH_EXIT"
 make_signal_installer "$NOEXIT" "$HANDLER_WITHOUT_EXIT"
 signal_fixture_ready() {
  local fixture="$1" expected_handler="$2"
-  [[ "$(grep -cF '# TEST-TERM-DAMAGE' "$fixture")" -eq 1 ]] \
-    && [[ "$(grep -cF '# TEST-TERM-INJECTION' "$fixture")" -eq 1 ]] \
+  [[ "$(grep -cF '# TEST-TERM-INJECTION' "$fixture")" -eq 1 ]] \
    && [[ "$(grep -cF '# TEST-TERM-HANDLER' "$fixture")" -eq 1 ]] \
    && grep -Fqx "$expected_handler" "$fixture"
 }
@@ -261,12 +261,10 @@ run_signal_upgrade() {
 IFS=$'\t' read -r rcC OUTC HC < <(run_signal_upgrade "$SIGNALED")
 chk "[signal] TERM handler observable fires exactly once" \
  "[ \"\$(grep -cF '$TERM_MARKER' '$OUTC')\" -eq 1 ]"
-chk "[signal] SIGTERM after target mutation aborts non-zero (trap exits, does not resume)" \
+chk "[signal] SIGTERM mid-sync aborts non-zero (trap exits, does not resume)" \
  "[ '$rcC' -ne 0 ]"
 chk "[signal] restore_snapshot fires on the interrupt" \
  "grep -q 'restoring previous state from snapshot' '$OUTC'"
-chk "[signal] the deliberately damaged target is restored before termination" \
-  "[ \"\$(cat '$HC/$POISON_REL')\" = '$GOOD' ]"
 chk "[signal] does NOT resume to report sync success after the interrupt" \
  "! grep -q 'file phase complete' '$OUTC'"

@@ -279,8 +277,6 @@ chk "[control] without 'exit 1' the installer exits zero after resuming" \
  "[ '$rcD' -eq 0 ]"
 chk "[control] without 'exit 1' the trap resumes and reports sync success (the bug)" \
  "grep -q 'file phase complete' '$OUTD'"
-chk "[control] the resumed full sync mutates the restored target again" \
-  "! grep -qxF '$GOOD' '$HD/$POISON_REL' && cmp -s '$FW/$POISON_REL' '$HD/$POISON_REL'"

 # ── Part D: a failed source/prune `find` scan must abort + roll back (D1) ─────
 # A `< <(find …)` process substitution discards find's exit status, so an
@@ -32,7 +32,6 @@ packages/mosaic/framework/tools/tmux/test-send-message-socket.sh | requires a re
 packages/mosaic/framework/tools/tmux/test-send-message-verdict.sh | requires real tmux-pane fixtures on a throwaway socket; CI image ships no tmux; #1017 burndown (same condition as its sibling)

 # --- single-suite directories: unmeasured in CI ---
-packages/mosaic/framework/tools/fleet/test-start-agent-session.sh | unmeasured in CI image; stubs tmux via a fake bin dir, likely CI-fit; #1017 burndown
 packages/mosaic/framework/tools/glpi/test-list-http-status.sh | unmeasured in CI image; stub-based (#807 regression harness), likely CI-fit; #1017 burndown
 packages/mosaic/framework/tools/orchestrator/test-board-roll.sh | unmeasured in CI image; file-fixture based, likely CI-fit; #1017 burndown
 packages/mosaic/framework/tools/woodpecker/test-ci-wait-exit-matrix.sh | unmeasured in CI image; drives ci-wait.sh against a stub pipeline-status.sh, likely CI-fit; #1017 burndown
@@ -25,7 +25,7 @@
    "lint": "eslint src",
    "typecheck": "tsc --noEmit",
    "test": "vitest run --passWithNoTests && pnpm run test:framework-shell",
-    "test:framework-shell": "bash framework/tools/quality/scripts/check-test-enumeration.sh && bash framework/tools/quality/scripts/test-check-test-enumeration.sh && python3 src/lease-broker/daemon_deadline_unittest.py && python3 src/lease-broker/normative_fragments_unittest.py && python3 src/lease-broker/receipt_challenge_unittest.py && python3 src/lease-broker/context_recovery_unittest.py && python3 src/lease-broker/recovery_runtime_unittest.py && python3 src/lease-broker/recovery_b1_adversarial_unittest.py && python3 src/lease-broker/framework_skill_portability_unittest.py && python3 src/mutator-gate/runtime_tools_unittest.py && python3 src/mutator-gate/runtime_launch_guard_unittest.py && python3 src/mutator-gate/version_coupling_unittest.py && python3 framework/tools/lease-broker/check-runtime-launches.py --root ../.. && bash framework/tools/codex/test-pr-diff-context.sh && bash framework/tools/qa/test-deps-preflight.sh && bash framework/tools/git/test-pr-review-gitea-comment.sh && bash framework/tools/git/test-pr-review-repo-host-override.sh && bash framework/tools/git/test-ci-queue-wait-branch-absent.sh && bash framework/tools/git/test-ci-queue-wait-tristate.sh && bash framework/tools/git/test-ci-queue-wait-github-checks.sh && bash framework/tools/git/test-pr-merge-queue-branch.sh && bash framework/tools/git/test-pr-merge-head-pin.sh && bash framework/tools/git/test-git-credential-mosaic.sh && bash framework/tools/git/test-gitea-token-identity.sh && bash framework/tools/woodpecker/test-terminal-green-contract.sh && bash framework/tools/_scripts/test-install-ordering-guard.sh && bash framework/tools/tmux/agent-send.test.sh && bash framework/tools/wake/test-wake-store-ack.sh && bash framework/tools/wake/test-wake-store-enqueue-race.sh && bash framework/tools/wake/test-wake-digest-hmac.sh && bash framework/tools/wake/test-wake-digest-quarantine.sh && bash framework/tools/wake/test-wake-detector.sh && bash framework/tools/wake/test-wake-fn-oracle.sh && bash framework/tools/wake/test-wake-reconcile.sh && bash framework/tools/wake/test-wake-beacon.sh && bash framework/tools/wake/test-wake-preimage.sh && bash framework/tools/wake/test-wake-install.sh"
+    "test:framework-shell": "bash framework/tools/quality/scripts/check-test-enumeration.sh && bash framework/tools/quality/scripts/test-check-test-enumeration.sh && bash framework/tools/fleet/test-start-agent-session.sh && bash framework/systemd/user/test-fleet-units.sh && python3 src/lease-broker/daemon_deadline_unittest.py && python3 src/lease-broker/normative_fragments_unittest.py && python3 src/lease-broker/receipt_challenge_unittest.py && python3 src/lease-broker/context_recovery_unittest.py && python3 src/lease-broker/recovery_runtime_unittest.py && python3 src/lease-broker/recovery_b1_adversarial_unittest.py && python3 src/lease-broker/framework_skill_portability_unittest.py && python3 src/mutator-gate/runtime_tools_unittest.py && python3 src/mutator-gate/runtime_launch_guard_unittest.py && python3 src/mutator-gate/version_coupling_unittest.py && python3 framework/tools/lease-broker/check-runtime-launches.py --root ../.. && bash framework/tools/codex/test-pr-diff-context.sh && bash framework/tools/qa/test-deps-preflight.sh && bash framework/tools/git/test-pr-review-gitea-comment.sh && bash framework/tools/git/test-pr-review-repo-host-override.sh && bash framework/tools/git/test-ci-queue-wait-branch-absent.sh && bash framework/tools/git/test-ci-queue-wait-tristate.sh && bash framework/tools/git/test-ci-queue-wait-github-checks.sh && bash framework/tools/git/test-pr-merge-queue-branch.sh && bash framework/tools/git/test-pr-merge-head-pin.sh && bash framework/tools/git/test-git-credential-mosaic.sh && bash framework/tools/git/test-gitea-token-identity.sh && bash framework/tools/woodpecker/test-terminal-green-contract.sh && bash framework/tools/_scripts/test-install-ordering-guard.sh && bash framework/tools/tmux/agent-send.test.sh && bash framework/tools/wake/test-wake-store-ack.sh && bash framework/tools/wake/test-wake-store-enqueue-race.sh && bash framework/tools/wake/test-wake-digest-hmac.sh && bash framework/tools/wake/test-wake-digest-quarantine.sh && bash framework/tools/wake/test-wake-detector.sh && bash framework/tools/wake/test-wake-fn-oracle.sh && bash framework/tools/wake/test-wake-reconcile.sh && bash framework/tools/wake/test-wake-beacon.sh && bash framework/tools/wake/test-wake-preimage.sh && bash framework/tools/wake/test-wake-install.sh"
  },
  "dependencies": {
    "@mosaicstack/brain": "workspace:*",
@@ -131,13 +131,14 @@ async function exists(path: string): Promise<boolean> {
 }

 describe('projectRosterV2AgentGeneratedEnv', (): void => {
-  it('maps a roster-v2 agent to exactly the eight generated projection keys', (): void => {
+  it('maps a roster-v2 agent to exactly the nine generated projection keys', (): void => {
    const roster = parseRosterV2(rosterYaml, 'yaml');
    const agent = roster.agents.find((candidate) => candidate.name === 'coder0');
    expect(agent).toBeDefined();
    const values = projectRosterV2AgentGeneratedEnv(roster, agent!);
    expect(values).toEqual({
      MOSAIC_AGENT_NAME: 'coder0',
+      MOSAIC_GIT_IDENTITY: 'coder0',
      MOSAIC_AGENT_CLASS: 'code',
      MOSAIC_AGENT_RUNTIME: 'pi',
      MOSAIC_AGENT_MODEL: 'gpt-5.6-sol',
@@ -422,6 +422,7 @@ describe('fleet roster parsing', () => {
    expect(generateAgentEnv(roster, getRosterAgent(roster, 'coder0'))).toBe(
      [
        'MOSAIC_AGENT_NAME=coder0',
+        'MOSAIC_GIT_IDENTITY=coder0',
        // Reflects the roster's canonicalized compatibility class (A3a).
        'MOSAIC_AGENT_CLASS=code',
        'MOSAIC_AGENT_RUNTIME=codex',
@@ -3799,6 +3800,7 @@ describe('fleet add command', () => {
      'utf8',
    );
    expect(envContent).toContain('MOSAIC_AGENT_NAME=coder0');
+    expect(envContent).toContain('MOSAIC_GIT_IDENTITY=coder0');
    expect(envContent).toContain('MOSAIC_AGENT_RUNTIME=codex');
  });

@@ -484,6 +484,7 @@ function generateAgentEnvValues(
  const workingDirectory = agent.workingDirectory ?? roster.defaults.workingDirectory;
  return {
    MOSAIC_AGENT_NAME: agent.name,
+    MOSAIC_GIT_IDENTITY: agent.name,
    MOSAIC_AGENT_CLASS: agent.className,
    MOSAIC_AGENT_RUNTIME: agent.runtime,
    MOSAIC_AGENT_MODEL: agent.modelHint ?? '',
@@ -358,6 +358,7 @@ function generatedValues(
 ): Readonly<Record<string, string>> {
  return {
    MOSAIC_AGENT_NAME: agent.name,
+    MOSAIC_GIT_IDENTITY: agent.name,
    MOSAIC_AGENT_CLASS: agent.className,
    MOSAIC_AGENT_RUNTIME: agent.runtime,
    MOSAIC_AGENT_MODEL: agent.model,
@@ -380,7 +380,7 @@ const COMMAND_RECORDS: Readonly<Record<string, RegExp>> = {

 const DATA_PROFILE_BODIES: Readonly<Record<string, string>> = {
  'DATA.DOTENV.FLEET_LAUNCH':
-    'MOSAIC_AGENT_NAME=<roster name>\nMOSAIC_AGENT_CLASS=<roster class>\nMOSAIC_AGENT_RUNTIME=<roster runtime>\nMOSAIC_AGENT_MODEL=<roster model hint>\nMOSAIC_AGENT_REASONING=<roster reasoning>\nMOSAIC_AGENT_TOOL_POLICY=<roster tool policy>\nMOSAIC_AGENT_WORKDIR=<absolute roster work directory>\nMOSAIC_TMUX_SOCKET=<roster socket or empty>',
+    'MOSAIC_AGENT_NAME=<roster name>\nMOSAIC_GIT_IDENTITY=<roster name>\nMOSAIC_AGENT_CLASS=<roster class>\nMOSAIC_AGENT_RUNTIME=<roster runtime>\nMOSAIC_AGENT_MODEL=<roster model hint>\nMOSAIC_AGENT_REASONING=<roster reasoning>\nMOSAIC_AGENT_TOOL_POLICY=<roster tool policy>\nMOSAIC_AGENT_WORKDIR=<absolute roster work directory>\nMOSAIC_TMUX_SOCKET=<roster socket or empty>',
  'DATA.TEXT_TABLE.FLEET_TASKS':
    '| W-FLEET | in-progress | Fleet (agent-session execution layer) | Phase 2/5 | docs/fleet/TASKS.md | observability dogfooded on live stub fleet; control plane rides federation (W1) |',
  'DATA.TEXT_DIAGRAM.BACKLOG_FLOW':
@@ -406,7 +406,7 @@ const DATA_PROFILE_BODIES: Readonly<Record<string, string>> = {
  'DATA.JSON.MUTATION_RESULT':
    '{\n  "applied": false,\n  "authoritativeRoster": "committed",\n  "projections": "incomplete",\n  "recovery": {\n    "code": "projection-apply-failed",\n    "action": "regenerate-projections-from-roster"\n  }\n}',
  'DATA.DOTENV.GENERATED_ENV':
-    'MOSAIC_AGENT_NAME=<roster name>\nMOSAIC_AGENT_CLASS=<roster class>\nMOSAIC_AGENT_RUNTIME=<roster runtime>\nMOSAIC_AGENT_MODEL=<roster model hint>\nMOSAIC_AGENT_REASONING=<roster reasoning>\nMOSAIC_AGENT_TOOL_POLICY=<roster tool policy>\nMOSAIC_AGENT_WORKDIR=<absolute roster work directory>\nMOSAIC_TMUX_SOCKET=<roster socket or empty>',
+    'MOSAIC_AGENT_NAME=<roster name>\nMOSAIC_GIT_IDENTITY=<roster name>\nMOSAIC_AGENT_CLASS=<roster class>\nMOSAIC_AGENT_RUNTIME=<roster runtime>\nMOSAIC_AGENT_MODEL=<roster model hint>\nMOSAIC_AGENT_REASONING=<roster reasoning>\nMOSAIC_AGENT_TOOL_POLICY=<roster tool policy>\nMOSAIC_AGENT_WORKDIR=<absolute roster work directory>\nMOSAIC_TMUX_SOCKET=<roster socket or empty>',
  'DATA.YAML.ROSTER_FIELDS':
    'version: 2\ngeneration: 1\ntransport: tmux\ntmux:\n  socket_name: mosaic-fleet\n  holder_session: _holder\ndefaults:\n  working_directory: ~/src\n  runtime: pi\nruntimes:\n  pi:\n    reset_command: /new\nagents:\n  - name: coder0\n    alias: Coder 0\n    class: code\n    runtime: pi\n    provider: openai\n    model: gpt-5.6-sol\n    reasoning: high\n    tool_policy: code\n    working_directory: ~/src\n    persistent_persona: false\n    reset_between_tasks: true\n    lifecycle:\n      enabled: true\n      desired_state: stopped\n    launch:\n      yolo: true',
 };
@@ -922,8 +922,8 @@ describe('fleet operator documentation', (): void => {
    );
    expect(
      surfaces.filter((surface): boolean => surface.category === 'InlineLiteral'),
-    ).toHaveLength(858);
-    expect(surfaces).toHaveLength(882);
+    ).toHaveLength(863);
+    expect(surfaces).toHaveLength(887);

    const rosterSource = await readFile(join(fleetDocs, 'examples', 'roster-v2.yaml'), 'utf8');
    const auxiliary: CodeSurface = {
@@ -597,6 +597,7 @@ export function projectRosterV2AgentGeneratedEnv(
 ): Readonly<Record<string, string>> {
  return {
    MOSAIC_AGENT_NAME: agent.name,
+    MOSAIC_GIT_IDENTITY: agent.name,
    MOSAIC_AGENT_CLASS: agent.className,
    MOSAIC_AGENT_RUNTIME: agent.runtime,
    MOSAIC_AGENT_MODEL: agent.model,
@@ -22,6 +22,7 @@ import {

 const generatedValues = {
  MOSAIC_AGENT_NAME: 'coder0',
+  MOSAIC_GIT_IDENTITY: 'coder0',
  MOSAIC_AGENT_CLASS: 'code',
  MOSAIC_AGENT_RUNTIME: 'pi',
  MOSAIC_AGENT_MODEL: 'openai-codex/gpt-5.6-sol',
@@ -45,6 +46,7 @@ describe('generated fleet agent environment boundary', (): void => {
    expect(renderGeneratedAgentEnvironment(generatedValues)).toBe(
      [
        'MOSAIC_AGENT_NAME=coder0',
+        'MOSAIC_GIT_IDENTITY=coder0',
        'MOSAIC_AGENT_CLASS=code',
        'MOSAIC_AGENT_RUNTIME=pi',
        'MOSAIC_AGENT_MODEL=openai-codex/gpt-5.6-sol',
@@ -78,6 +80,22 @@ describe('generated fleet agent environment boundary', (): void => {
    expect(String(error)).toMatch(/key=.*sha256=/);
  });

+  it.each([
+    ['unsafe-git-identity', 'other/identity'],
+    ['git-identity-mismatch', 'reviewer0'],
+  ])('rejects %s before any launch consumer can use it', (code: string, identity: string): void => {
+    expect((): void => {
+      renderGeneratedAgentEnvironment({
+        ...generatedValues,
+        MOSAIC_GIT_IDENTITY: identity,
+      });
+    }).toThrow(
+      expect.objectContaining({
+        diagnostic: expect.objectContaining({ code, key: 'MOSAIC_GIT_IDENTITY' }),
+      }),
+    );
+  });
+
  it('rejects unsafe generated paths before any launch consumer can use them', (): void => {
    expect((): void => {
      renderGeneratedAgentEnvironment({
@@ -73,6 +73,7 @@ export class AgentEnvBoundaryError extends Error {

 export const GENERATED_AGENT_ENV_KEYS = [
  'MOSAIC_AGENT_NAME',
+  'MOSAIC_GIT_IDENTITY',
  'MOSAIC_AGENT_CLASS',
  'MOSAIC_AGENT_RUNTIME',
  'MOSAIC_AGENT_MODEL',
@@ -402,6 +403,7 @@ function assertGeneratedValues(values: Readonly<Record<string, string>>): void {
    if (value === undefined) throw new AgentEnvBoundaryError('missing-key', key, '');
  }
  const name = requiredGeneratedValue(values, 'MOSAIC_AGENT_NAME');
+  const gitIdentity = requiredGeneratedValue(values, 'MOSAIC_GIT_IDENTITY');
  const className = requiredGeneratedValue(values, 'MOSAIC_AGENT_CLASS');
  const runtime = requiredGeneratedValue(values, 'MOSAIC_AGENT_RUNTIME');
  const model = requiredGeneratedValue(values, 'MOSAIC_AGENT_MODEL');
@@ -412,6 +414,12 @@ function assertGeneratedValues(values: Readonly<Record<string, string>>): void {

  if (!AGENT_NAME.test(name))
    throw new AgentEnvBoundaryError('unsafe-agent-name', 'MOSAIC_AGENT_NAME', name);
+  if (!AGENT_NAME.test(gitIdentity)) {
+    throw new AgentEnvBoundaryError('unsafe-git-identity', 'MOSAIC_GIT_IDENTITY', gitIdentity);
+  }
+  if (gitIdentity !== name) {
+    throw new AgentEnvBoundaryError('git-identity-mismatch', 'MOSAIC_GIT_IDENTITY', gitIdentity);
+  }
  if (!POLICY_NAME.test(className)) {
    throw new AgentEnvBoundaryError('unsafe-class', 'MOSAIC_AGENT_CLASS', className);
  }
@@ -1405,6 +1405,7 @@ function generatedValues(
 ): Readonly<Record<string, string>> {
  return {
    MOSAIC_AGENT_NAME: agent.name,
+    MOSAIC_GIT_IDENTITY: agent.name,
    MOSAIC_AGENT_CLASS: agent.className,
    MOSAIC_AGENT_RUNTIME: agent.runtime,
    MOSAIC_AGENT_MODEL: agent.model,
@@ -1,408 +1,184 @@
 #!/usr/bin/env bash
-# Greenfield installer acceptance fixture.
+# ─── Mosaic Stack — End-to-End Install Test ────────────────────────────────────
 #
-# The fixture itself is intentionally RED until the C2-C5 phase owners repair
-# their postconditions. C1's CI gate executes it and validates that the RED is
-# attributable (including the discriminating P3 PASS); it does not turn the
-# failed install into a false green.
+# Runs a clean-container install test to verify the full first-run flow:
+#   tools/install.sh  ->  mosaic wizard (non-interactive)
+#                     ->  mosaic gateway install
+#                     ->  mosaic gateway verify
+#
+# Usage:
+#   bash tools/e2e-install-test.sh
+#
+# Requirements:
+#   - Docker (skips gracefully if not available)
+#   - Run from the repository root
+#
+# How it works:
+#   1. Mounts the repository into a node:22-alpine container.
+#   2. Installs prerequisites (bash, curl, jq, git) inside the container.
+#   3. Runs `bash tools/install.sh --yes --no-auto-launch` to install the
+#      framework and CLI from the Gitea registry.
+#   4. Runs `mosaic wizard --non-interactive` to set up SOUL/USER.
+#   5. Runs `mosaic gateway install` with piped defaults (non-interactive).
+#   6. Runs `mosaic gateway verify` and checks its exit code.
+#      NOTE: `mosaic gateway verify` is a new command added in the
+#      feat/mosaic-first-run-ux branch. If the installed CLI version
+#      pre-dates this branch (does not have `gateway verify`), the test
+#      marks this step as EXPECTED-SKIP and reports the installed version.
+#   7. Reports PASS or FAIL with a summary.
+#
+# To run manually:
+#   cd /path/to/mosaic-stack
+#   bash tools/e2e-install-test.sh
+#
+# ──────────────────────────────────────────────────────────────────────────────

 set -euo pipefail

-ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-LANE="${MOSAIC_INSTALL_LANE:-next}"
-SOURCE="${MOSAIC_INSTALL_SOURCE:-checkout}"
-IMAGE="${MOSAIC_INSTALL_IMAGE:-node:22-bookworm-slim}"
-GIT_MODE="${MOSAIC_INSTALL_GIT_MODE:-present}"
-INSTALLER_FILE="${MOSAIC_FIXTURE_INSTALLER_FILE:-$ROOT/tools/install.sh}"
-INSTALLER_URL="${MOSAIC_FIXTURE_INSTALLER_URL:-}"
-INSTALLER_SHA256="${MOSAIC_FIXTURE_INSTALLER_SHA256:-}"
-IN_CLEAN_CONTAINER="${MOSAIC_GREENFIELD_CONTAINER:-0}"
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+IMAGE="node:22-alpine"
+CONTAINER_NAME="mosaic-e2e-install-$$"

-usage() {
-  cat <<'EOF'
-Usage: tools/e2e-install-test.sh [--lane next|main] [--source checkout|remote] [--git present|absent]
-
-Runs the documented installer command from zero in Debian/glibc as a non-root
-uid with an isolated HOME. The fixture exits non-zero when any P0-P8
-postcondition fails. `next` is always selected with the --next installer flag.
-EOF
-}
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --lane) LANE="${2:-}"; shift 2 ;;
-    --source) SOURCE="${2:-}"; shift 2 ;;
-    --git) GIT_MODE="${2:-}"; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    *) echo "[fixture] unknown argument: $1" >&2; usage >&2; exit 2 ;;
-  esac
-done
-
-case "$LANE" in next|main) ;; *) echo "[fixture] unsupported lane '$LANE' (expected next|main)" >&2; exit 2 ;; esac
-case "$SOURCE" in checkout|remote) ;; *) echo "[fixture] unsupported source '$SOURCE' (expected checkout|remote)" >&2; exit 2 ;; esac
-case "$GIT_MODE" in present|absent) ;; *) echo "[fixture] unsupported git mode '$GIT_MODE' (expected present|absent)" >&2; exit 2 ;; esac
-if [[ "$SOURCE" == remote ]]; then
-  [[ -n "$INSTALLER_URL" ]] || INSTALLER_URL="https://git.mosaicstack.dev/mosaicstack/stack/raw/branch/${LANE}/tools/install.sh"
-  [[ "$INSTALLER_SHA256" =~ ^[0-9a-f]{64}$ ]] \
-    || { echo '[fixture] remote source requires MOSAIC_FIXTURE_INSTALLER_SHA256=64hex' >&2; exit 2; }
+# ─── Colour helpers ───────────────────────────────────────────────────────────
+if [[ -t 1 ]]; then
+  R=$'\033[0;31m' G=$'\033[0;32m' Y=$'\033[0;33m' BOLD=$'\033[1m' RESET=$'\033[0m'
+else
+  R="" G="" Y="" BOLD="" RESET=""
 fi

-if [[ "$IN_CLEAN_CONTAINER" != "1" ]]; then
-  if ! command -v docker >/dev/null 2>&1; then
-    echo "[fixture] FAIL: Docker is required; greenfield validation was NOT RUN." >&2
-    exit 2
-  fi
-  if ! docker info >/dev/null 2>&1; then
-    echo "[fixture] FAIL: Docker daemon is unavailable; greenfield validation was NOT RUN." >&2
-    exit 2
-  fi
+info()  { echo "${BOLD}[e2e]${RESET} $*"; }
+ok()    { echo "${G}[PASS]${RESET} $*"; }
+fail()  { echo "${R}[FAIL]${RESET} $*" >&2; }
+warn()  { echo "${Y}[WARN]${RESET} $*"; }
+
+# ─── Docker availability check ────────────────────────────────────────────────
+if ! command -v docker &>/dev/null; then
+  warn "Docker not found — skipping e2e install test."
+  warn "Install Docker and re-run this script to exercise the full install flow."
+  exit 0
 fi

-installer_b64=""
-framework_payload_count="NOT-MEASURED"
-repo_root_count="NOT-MEASURED"
-checkout_archive=""
-checkout_digest=""
-checkout_content_id=""
-if [[ "$SOURCE" == "checkout" ]]; then
-  installer_b64="$(base64 -w0 "$INSTALLER_FILE")"
-  [[ -d "$ROOT/packages/mosaic/framework/skills" ]] \
-    && framework_payload_count="$(find "$ROOT/packages/mosaic/framework/skills" -mindepth 1 -maxdepth 1 -type d | wc -l | tr -d ' ')"
-  [[ -d "$ROOT/skills" ]] \
-    && repo_root_count="$(find "$ROOT/skills" -mindepth 1 -maxdepth 1 -type d | wc -l | tr -d ' ')"
-  checkout_archive="$(mktemp "${TMPDIR:-/tmp}/mosaic-greenfield-checkout.XXXXXX")"
-  repo_parent="$(dirname "$ROOT")"
-  repo_name="$(basename "$ROOT")"
-  tar -C "$repo_parent" \
-    --exclude='*/.git' --exclude='*/node_modules' --exclude='*/dist' \
-    --exclude='*/coverage' --exclude='*/.turbo' --exclude='*/.mosaic-test-work' \
-    --exclude='*/.env' --exclude='*/.env.*' \
-    -czf "$checkout_archive" "$repo_name"
-  checkout_digest="$(sha256sum "$checkout_archive" | awk '{print $1}')"
-  checkout_content_id="${checkout_digest:0:40}"
+if ! docker info &>/dev/null 2>&1; then
+  warn "Docker daemon is not running or not accessible — skipping e2e install test."
+  exit 0
 fi

-inner="$(mktemp "${TMPDIR:-/tmp}/mosaic-greenfield-inner.XXXXXX")"
-trap 'rm -f "$inner" "$checkout_archive"' EXIT
-cat > "$inner" <<'INNER'
-#!/usr/bin/env bash
-set -euo pipefail
+info "Docker available — proceeding with e2e install test."
+info "Repo root: ${REPO_ROOT}"
+info "Container image: ${IMAGE}"

-export DEBIAN_FRONTEND=noninteractive
-apt-get update -qq
-packages=(bash ca-certificates curl jq passwd python3 util-linux)
-[[ "$FIXTURE_GIT_MODE" == "present" ]] && packages+=(git)
-apt-get install -y -qq "${packages[@]}" >/dev/null
+# ─── Inline script that runs INSIDE the container ────────────────────────────
+INNER_SCRIPT="$(mktemp /tmp/mosaic-e2e-inner-XXXXXX.sh)"
+trap 'rm -f "$INNER_SCRIPT"' EXIT

-if [[ "$FIXTURE_SOURCE" == "checkout" ]]; then
-  awk 'found { print } /^__MOSAIC_CHECKOUT_ARCHIVE__$/ { found=1; next }' "$0" | base64 -d > /tmp/source-checkout.tar.gz
-  actual_checkout_digest="$(sha256sum /tmp/source-checkout.tar.gz | awk '{print $1}')"
-  if [[ "$actual_checkout_digest" != "$FIXTURE_CHECKOUT_SHA256" ]]; then
-    echo "[fixture] checkout archive transport digest mismatch" >&2
-    exit 1
-  fi
-fi
-
-useradd --create-home --uid 1001 --shell /bin/bash mosaic
-install -d -o mosaic -g mosaic /home/mosaic/work
-
-case "$FIXTURE_SOURCE" in
-  checkout)
-    printf '%s' "$FIXTURE_INSTALLER_B64" | base64 -d > /tmp/install.sh
-    ;;
-  remote)
-    curl -fsSL "$FIXTURE_INSTALLER_URL" -o /tmp/install.sh
-    [[ -s /tmp/install.sh ]] || { echo '[fixture] remote installer returned an empty HTTP-success body' >&2; exit 1; }
-    actual_installer_sha256="$(sha256sum /tmp/install.sh | awk '{print $1}')"
-    [[ "$actual_installer_sha256" == "$FIXTURE_INSTALLER_SHA256" ]] || {
-      echo "[fixture] remote installer digest mismatch got=$actual_installer_sha256 expected=$FIXTURE_INSTALLER_SHA256" >&2
-      exit 1
-    }
-    ;;
-esac
-chmod 0755 /tmp/install.sh
-sha256sum /tmp/install.sh | sed 's/^/[fixture] installer sha256: /'
-
-cat > /tmp/run-as-target.sh <<'TARGET'
-#!/usr/bin/env bash
-set -uo pipefail
-
-lane="$FIXTURE_LANE"
-home="$HOME"
-prefix="$home/.npm-global"
-mosaic_home="$home/.config/mosaic"
-install_log="$home/install.log"
-failures=0
-
-phase_pass() { printf '[%s] PASS: %s\n' "$1" "$2"; }
-phase_fail() { printf '[%s] FAIL: %s\n' "$1" "$2"; failures=$((failures + 1)); }
-
-lane_args=()
-resolved_spec='@mosaicstack/mosaic'
-if [[ "$lane" == "next" ]]; then
-  lane_args+=(--next)
-  resolved_spec='@mosaicstack/mosaic@next'
-fi
-
-resolved_version="$(npm view "$resolved_spec" version --registry=https://git.mosaicstack.dev/api/packages/mosaicstack/npm/ 2>/dev/null || true)"
-printf '[fixture] resolved lane=%s package=%s version=%s\n' "$lane" "$resolved_spec" "${resolved_version:-UNRESOLVED}"
-
-secret_canary='MOSAIC_C1_CANARY_6f3c91e2'
-argv_capture=/tmp/mosaic-installer-argv.log
-: > "$argv_capture"
-set +e
-MOSAIC_NO_COLOR=1 MOSAIC_ASSUME_YES=1 MOSAIC_INSTALL_SECRET_CANARY="$secret_canary" \
-  MOSAIC_INSTALL_REDACTION_PROBE=1 \
-  bash /tmp/install.sh "${lane_args[@]}" --yes --no-auto-launch >"$install_log" 2>&1 &
-installer_pid=$!
-while kill -0 "$installer_pid" 2>/dev/null; do
-  for cmdline in /proc/[0-9]*/cmdline; do
-    [[ -r "$cmdline" ]] || continue
-    tr '\0' ' ' < "$cmdline" >> "$argv_capture" 2>/dev/null || true
-    printf '\n' >> "$argv_capture"
-  done
-  sleep 0.02
-done
-wait "$installer_pid"
-install_status=$?
+cat > "$INNER_SCRIPT" <<'INNER_SCRIPT_EOF'
+#!/bin/sh
+# Bootstrap: /bin/sh until bash is installed, then re-exec.
 set -e
-cat "$install_log"
-probe_ok=true
-if [[ "$FIXTURE_GIT_MODE" == present ]] \
-  && ! grep -q '^\[REDACTION-PROBE\] emitted=\[REDACTED\]$' "$install_log"; then
-  probe_ok=false
-fi
-if [[ "$probe_ok" != true ]] \
-  || grep -F "$secret_canary" "$argv_capture" >/dev/null \
-  || grep -R -F "$secret_canary" "$home" >/dev/null 2>&1; then
-  phase_fail P0 'seeded credential probe missing or canary leaked to argv, output, command log, npmrc, generated files, or shell history'
-else
-  printf '[SECRET-CONTROL] PASS: seeded captured-command canary was redacted and absent from argv/output/commands.log/npmrc/generated/history populations\n'
-fi
-printf '[fixture] installer_exit=%d done_claims=%s\n' \
-  "$install_status" "$(grep -cF 'Done.' "$install_log" || true)"

-# P0 Resolve context. Keep this final fixture row as discriminating as the
-# installer's own P0 row: the expected-RED comparator binds this exact reason.
-passwd_row="$(getent passwd "$(id -u)")"
-target_user="$(printf '%s' "$passwd_row" | cut -d: -f1)"
-passwd_home="$(printf '%s' "$passwd_row" | cut -d: -f6)"
-shell="$(printf '%s' "$passwd_row" | cut -d: -f7)"
-if [[ "$(id -u)" -eq 1001 && "$target_user" == "mosaic" \
-  && "$home" == "/home/mosaic" && "$home" == "$passwd_home" && "$shell" == "/bin/bash" ]] \
-  && ldd --version 2>&1 | grep -i 'glibc\|gnu libc' >/dev/null \
-  && [[ "$(node -p 'Number(process.versions.node.split(".")[0])')" -ge 20 ]]; then
-  phase_pass P0 "target=$target_user uid=$(id -u) HOME=$home passwd_HOME=$passwd_home shell=$shell privilege=user arch=$(uname -m) libc=glibc node=$(node --version) npm=$(npm --version)"
-else
-  phase_fail P0 "context unresolved or unsupported (target=${target_user:-unknown} uid=$(id -u) HOME=$home passwd_HOME=${passwd_home:-unknown} shell=${shell:-unknown} privilege=user)"
+echo "=== [inner] Installing system prerequisites ==="
+apk add --no-cache bash curl jq git 2>/dev/null || \
+  apt-get install -y -q bash curl jq git 2>/dev/null || true
+
+# Re-exec under bash.
+if [ -z "${BASH_VERSION:-}" ] && command -v bash >/dev/null 2>&1; then
+  exec bash "$0" "$@"
 fi

-# P1 Preflight
-missing_tools=()
-for tool in bash curl git node npm python3 tar; do
-  command -v "$tool" >/dev/null 2>&1 || missing_tools+=("$tool")
-done
-if [[ "${#missing_tools[@]}" -eq 0 && -n "$resolved_version" && -w "$home" ]]; then
-  phase_pass P1 "required tools present (including downstream git); target HOME writable; registry lane resolved"
-else
-  phase_fail P1 "undeclared/missing prerequisite(s)=${missing_tools[*]:-none}; target_writable=$([[ -w "$home" ]] && echo yes || echo no) registry_resolved=$([[ -n "$resolved_version" ]] && echo yes || echo no)"
-fi
+# ── bash from here ────────────────────────────────────────────────────────────
+set -euo pipefail

-# P2 Acquire artifacts
-if [[ -n "$resolved_version" ]] && grep -qF "$resolved_version" "$install_log"; then
-  phase_pass P2 "lane=$lane pinned_version=$resolved_version recorded in installer transcript"
-else
-  phase_fail P2 "lane=$lane did not resolve and record a pinned artifact version"
-fi
+echo "=== [inner] Node.js / npm versions ==="
+node --version
+npm --version

-# P3 Install CLI — the discriminating row. Use the known absolute path only.
-cli="$prefix/bin/mosaic"
-cli_version=""
-if [[ -x "$cli" ]]; then
-  cli_version="$($cli --version 2>/dev/null | tail -n 1 | tr -d '\r' || true)"
-fi
-if [[ -x "$cli" && "$cli_version" == "$resolved_version" ]]; then
-  phase_pass P3 "absolute_path=$cli version=$cli_version equals resolved lane version"
-else
-  phase_fail P3 "absolute_path=$cli executable=$([[ -x "$cli" ]] && echo yes || echo no) got=${cli_version:-missing} expected=${resolved_version:-unresolved}"
-fi
+echo "=== [inner] Setting up npm global prefix ==="
+export NPM_PREFIX="/root/.npm-global"
+mkdir -p "$NPM_PREFIX/bin"
+npm config set prefix "$NPM_PREFIX" 2>/dev/null || true
+export PATH="$NPM_PREFIX/bin:$PATH"

-# P4 Framework + skills. C1 does not choose among the four disagreeing
-# candidate populations. It requires the installer to publish a lane/versioned
-# shipped-set declaration that a checkout-free install can resolve; C5 owns its
-# contents. Without that artifact P4 is NOT-MEASURED, never a fabricated count.
-declared_set="$mosaic_home/.install-shipped-skills.json"
-sync_store_count=0
-runtime_link_count=0
-[[ -d "$mosaic_home/skills" ]] \
-  && sync_store_count="$(find "$mosaic_home/skills" -mindepth 1 -maxdepth 1 -type d | wc -l | tr -d ' ')"
-[[ -d "$home/.pi/agent/skills" ]] \
-  && runtime_link_count="$(find "$home/.pi/agent/skills" -mindepth 1 -maxdepth 1 \( -type d -o -type l \) | wc -l | tr -d ' ')"
-printf '[P4-EVIDENCE] candidate_populations framework_payload=%s repo_root=%s sync_store=%s jarvis_W-jarvis_observation=7 runtime_links=%s\n' \
-  "$FIXTURE_FRAMEWORK_PAYLOAD_COUNT" "$FIXTURE_REPO_ROOT_COUNT" "$sync_store_count" "$runtime_link_count"
-if [[ ! -s "$declared_set" ]]; then
-  phase_fail P4 "NOT-MEASURED / UNDECLARED: installer published no checkout-free, lane/versioned shipped-set artifact at $declared_set"
-elif EXPECTED_LANE="$([[ "$lane" == next ]] && echo next || echo latest)" EXPECTED_VERSION="$resolved_version" \
-  MOSAIC_SKILLS_ROOT="$mosaic_home/skills" node - "$declared_set" <<'NODE'
-const fs = require('fs');
-const path = require('path');
-const data = JSON.parse(fs.readFileSync(process.argv[2], 'utf8'));
-const root = path.resolve(process.env.MOSAIC_SKILLS_ROOT);
-if (!data || data.lane !== process.env.EXPECTED_LANE || data.version !== process.env.EXPECTED_VERSION ||
-    !Array.isArray(data.skills) || data.skills.length === 0) process.exit(1);
-for (const name of data.skills) {
-  if (typeof name !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name)) process.exit(1);
-  const skill = path.join(root, name, 'SKILL.md');
-  let real;
-  try { real = fs.realpathSync(skill); } catch { process.exit(1); }
-  const text = fs.readFileSync(real, 'utf8');
-  const declaredName = text.match(/^---\s*$[\s\S]*?^name:\s*([^\s]+)\s*$/m)?.[1];
-  if (!real.startsWith(root + path.sep) || !fs.statSync(real).isFile() || !text || declaredName !== name) process.exit(1);
+echo "=== [inner] Running install.sh --yes --no-auto-launch ==="
+# Install both framework and CLI from the Gitea registry.
+MOSAIC_SKIP_SKILLS_SYNC=1 \
+MOSAIC_ASSUME_YES=1 \
+  bash /repo/tools/install.sh --yes --no-auto-launch
+
+INSTALLED_VERSION="$(mosaic --version 2>/dev/null || echo 'unknown')"
+echo "[inner] mosaic CLI installed: ${INSTALLED_VERSION}"
+
+echo "=== [inner] Running mosaic wizard (non-interactive) ==="
+mosaic wizard \
+  --non-interactive \
+  --name "test-agent" \
+  --user-name "tester" \
+  --pronouns "they/them" \
+  --timezone "UTC" || {
+  echo "[WARN] mosaic wizard exited non-zero — continuing"
 }
-NODE
-then
-  declared_count="$(node -p "require('$declared_set').skills.length")"
-  if [[ -s "$mosaic_home/.install-manifest.json" ]] \
-    && [[ "$(node -p "require('$mosaic_home/.install-manifest.json').phaseOutcomes?.P4 || 'committed'")" == failed ]]; then
-    phase_fail P4 "declared skills are present but the required framework/skills action reported failure"
-  else
-    phase_pass P4 "declared shipped-set matches lane/version and all $declared_count skill(s) are contained and loadable"
-  fi
+
+echo "=== [inner] Running mosaic gateway install ==="
+# Feed non-interactive answers:
+#   "1"   → storage tier: local
+#   ""    → port: accept default (14242)
+#   ""    → ANTHROPIC_API_KEY: skip
+#   ""    → CORS origin: accept default
+#   Then admin bootstrap: name, email, password
+printf '1\n\n\n\nTest Admin\[email protected]\ntestpassword123\n' \
+  | mosaic gateway install
+INSTALL_EXIT="$?"
+if [ "${INSTALL_EXIT}" -ne 0 ]; then
+  echo "[ERR] mosaic gateway install exited ${INSTALL_EXIT}"
+  mosaic gateway status 2>/dev/null || true
+  exit "${INSTALL_EXIT}"
+fi
+
+echo "=== [inner] Running mosaic gateway verify ==="
+# `gateway verify` was added in feat/mosaic-first-run-ux.
+# If the installed version pre-dates this, skip gracefully.
+if ! mosaic gateway --help 2>&1 | grep -q 'verify'; then
+  echo "[SKIP] 'mosaic gateway verify' not available in installed version ${INSTALLED_VERSION}."
+  echo "[SKIP] This command was added in the feat/mosaic-first-run-ux release."
+  echo "[SKIP] Re-run after the new version is published to validate this step."
+  # Treat as pass — the install flow itself worked.
+  exit 0
+fi
+
+mosaic gateway verify
+VERIFY_EXIT="$?"
+echo "=== [inner] verify exit code: ${VERIFY_EXIT} ==="
+exit "${VERIFY_EXIT}"
+INNER_SCRIPT_EOF
+
+chmod +x "$INNER_SCRIPT"
+
+# ─── Pull image ───────────────────────────────────────────────────────────────
+info "Pulling ${IMAGE}…"
+docker pull "${IMAGE}" --quiet
+
+# ─── Run container ────────────────────────────────────────────────────────────
+info "Starting container ${CONTAINER_NAME}…"
+
+EXIT_CODE=0
+docker run --rm \
+  --name "${CONTAINER_NAME}" \
+  --volume "${REPO_ROOT}:/repo:ro" \
+  --volume "${INNER_SCRIPT}:/e2e-inner.sh:ro" \
+  --network host \
+  "${IMAGE}" \
+  /bin/sh /e2e-inner.sh \
+  || EXIT_CODE=$?
+
+# ─── Report ───────────────────────────────────────────────────────────────────
+echo ""
+if [[ "$EXIT_CODE" -eq 0 ]]; then
+  ok "End-to-end install test PASSED (exit ${EXIT_CODE})"
 else
-  phase_fail P4 "shipped-set artifact is malformed, wrong-lane/version, or its declared skills are not contained and loadable"
-fi
-
-# P5 Identity
-identity_ok=true
-identity_reason=()
-for f in SOUL.md USER.md; do
-  path="$mosaic_home/$f"
-  if [[ ! -s "$path" ]]; then
-    identity_ok=false; identity_reason+=("$f missing-or-empty"); continue
-  fi
-  owner="$(stat -c '%u' "$path")"; mode="$(stat -c '%a' "$path")"
-  if [[ "$owner" != "$(id -u)" || "$mode" =~ [2367]$ ]]; then
-    identity_ok=false; identity_reason+=("$f owner=$owner mode=$mode")
-  fi
-done
-if [[ "$identity_ok" == true ]]; then
-  phase_pass P5 "SOUL.md and USER.md are non-empty and target-user owned with non-world-writable modes"
-else
-  phase_fail P5 "${identity_reason[*]}"
-fi
-
-# P6 Runtime linking / activation. #869 must remain unwired without its broker.
-manifest="$mosaic_home/.install-manifest.json"
-broker_present=false
-[[ -S "${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/mosaic-lease/broker.sock" ]] && broker_present=true
-dead_hooks=0
-if [[ -f "$home/.claude/settings.json" ]]; then
-  dead_hooks="$(grep -Ec 'mutator-gate\.py|receipt-observer-client\.py' "$home/.claude/settings.json" || true)"
-fi
-p6_action_failed=false
-if [[ -s "$manifest" ]]; then
-  p6_action_failed="$(node -p "require('$manifest').phaseOutcomes?.P6 === 'failed' ? 'true' : 'false'" 2>/dev/null || echo true)"
-fi
-if [[ "$p6_action_failed" == true ]]; then
-  phase_fail P6 "runtime linking/activation action reported a required failure"
-elif [[ "$broker_present" == false && "$dead_hooks" -eq 0 ]]; then
-  phase_pass P6 "broker absent and #869 enforcement hooks remain inactive"
-elif [[ "$broker_present" == true ]]; then
-  phase_pass P6 "activation broker present; hook state is evaluable"
-else
-  phase_fail P6 "broker absent but dead enforcement hooks are active (count=$dead_hooks)"
-fi
-
-# P7 Services — none requested by --no-auto-launch.
-phase_pass P7 "no services requested by this fixture"
-
-# P8 Shell discoverability — actual target shell, fresh login and non-login.
-base_env=(env -i HOME="$home" USER=mosaic LOGNAME=mosaic SHELL=/bin/bash PATH=/usr/local/bin:/usr/bin:/bin)
-login_path="$("${base_env[@]}" /bin/bash -lc 'command -v mosaic' 2>/dev/null || true)"
-nonlogin_path="$("${base_env[@]}" /bin/bash -c 'command -v mosaic' 2>/dev/null || true)"
-if [[ "$login_path" == "$cli" && "$nonlogin_path" == "$cli" ]]; then
-  phase_pass P8 "login=$login_path nonlogin=$nonlogin_path equals P3 path"
-else
-  phase_fail P8 "fresh bash login=${login_path:-missing} nonlogin=${nonlogin_path:-missing} expected=$cli"
-fi
-
-manifest="$mosaic_home/.install-manifest.json"
-p0_p8_failures="$failures"
-if [[ "$p0_p8_failures" -eq 0 && -s "$manifest" ]]; then
-  phase_pass P9 "P0-P8 reasserted; manifest present"
-else
-  phase_fail P9 "P0-P8_failed_postconditions=$p0_p8_failures manifest=$([[ -s "$manifest" ]] && echo present || echo missing); install must not certify success"
-fi
-
-printf '[fixture] P0-P9_failed_rows=%d (includes P9 aggregate row)\n' "$failures"
-if [[ "$failures" -ne 0 ]]; then
+  fail "End-to-end install test FAILED (exit ${EXIT_CODE})"
+  echo ""
+  echo "  Troubleshooting:"
+  echo "    - Review the output above for the failing step."
+  echo "    - Re-run with bash -x tools/e2e-install-test.sh for verbose trace."
+  echo "    - Run mosaic gateway logs inside a manual container for daemon output."
  exit 1
 fi
-TARGET
-chmod 0755 /tmp/run-as-target.sh
-chown mosaic:mosaic /tmp/run-as-target.sh
-
-exec runuser -u mosaic -- env -i \
-  HOME=/home/mosaic USER=mosaic LOGNAME=mosaic SHELL=/bin/bash \
-  PATH=/usr/local/bin:/usr/bin:/bin \
-  FIXTURE_LANE="$FIXTURE_LANE" \
-  FIXTURE_GIT_MODE="$FIXTURE_GIT_MODE" \
-  FIXTURE_FRAMEWORK_PAYLOAD_COUNT="$FIXTURE_FRAMEWORK_PAYLOAD_COUNT" \
-  FIXTURE_REPO_ROOT_COUNT="$FIXTURE_REPO_ROOT_COUNT" \
-  MOSAIC_INSTALL_LOCAL_SOURCE_ARCHIVE="$([[ "$FIXTURE_SOURCE" == "checkout" ]] && echo /tmp/source-checkout.tar.gz)" \
-  MOSAIC_INSTALL_LOCAL_SOURCE_COMMIT="$FIXTURE_CHECKOUT_CONTENT_ID" \
-  MOSAIC_INSTALL_LOCAL_SOURCE_SHA256="$FIXTURE_CHECKOUT_SHA256" \
-  /bin/bash /tmp/run-as-target.sh
-INNER
-if [[ "$SOURCE" == "checkout" ]]; then
-  {
-    printf '\n__MOSAIC_CHECKOUT_ARCHIVE__\n'
-    base64 "$checkout_archive"
-  } >> "$inner"
-fi
-chmod 0755 "$inner"
-
-printf '[fixture] platform=Debian/glibc image=%s target_uid=1001 lane=%s source=%s git=%s\n' "$IMAGE" "$LANE" "$SOURCE" "$GIT_MODE"
-printf '[fixture] host inheritance: no bind mounts, no host HOME, no npm cache, no credentials\n'
-
-if [[ "$IN_CLEAN_CONTAINER" == "1" ]]; then
-  # Woodpecker already supplies the clean Debian container. The target install
-  # still runs through runuser + env -i, so CI variables/credentials do not
-  # enter the target user's process.
-  FIXTURE_LANE="$LANE" \
-  FIXTURE_SOURCE="$SOURCE" \
-  FIXTURE_GIT_MODE="$GIT_MODE" \
-  FIXTURE_INSTALLER_B64="$installer_b64" \
-  FIXTURE_INSTALLER_URL="$INSTALLER_URL" \
-  FIXTURE_INSTALLER_SHA256="$INSTALLER_SHA256" \
-  FIXTURE_CHECKOUT_SHA256="$checkout_digest" \
-  FIXTURE_CHECKOUT_CONTENT_ID="$checkout_content_id" \
-  FIXTURE_FRAMEWORK_PAYLOAD_COUNT="$framework_payload_count" \
-  FIXTURE_REPO_ROOT_COUNT="$repo_root_count" \
-    /bin/bash "$inner"
-else
-  # Copy the self-contained script+archive into a stopped container instead of
-  # bind-mounting the checkout or passing host paths. The target runtime still
-  # inherits no host HOME/cache/credentials, and the multi-megabyte checkout
-  # payload avoids argv/environment size limits.
-  fixture_cid="$(docker create \
-    --network bridge \
-    --env FIXTURE_LANE="$LANE" \
-    --env FIXTURE_SOURCE="$SOURCE" \
-    --env FIXTURE_GIT_MODE="$GIT_MODE" \
-    --env FIXTURE_INSTALLER_B64="$installer_b64" \
-    --env FIXTURE_INSTALLER_URL="$INSTALLER_URL" \
-    --env FIXTURE_INSTALLER_SHA256="$INSTALLER_SHA256" \
-    --env FIXTURE_CHECKOUT_SHA256="$checkout_digest" \
-    --env FIXTURE_CHECKOUT_CONTENT_ID="$checkout_content_id" \
-    --env FIXTURE_FRAMEWORK_PAYLOAD_COUNT="$framework_payload_count" \
-    --env FIXTURE_REPO_ROOT_COUNT="$repo_root_count" \
-    "$IMAGE" /bin/bash /tmp/mosaic-greenfield-fixture.sh)"
-  docker cp "$inner" "$fixture_cid:/tmp/mosaic-greenfield-fixture.sh"
-  set +e
-  docker start -a "$fixture_cid"
-  fixture_status=$?
-  set -e
-  docker rm "$fixture_cid" >/dev/null
-  exit "$fixture_status"
-fi
@@ -1,57 +0,0 @@
-# Pinned C1 expected-RED contract. Updating a verdict/reason requires review by the owning remediation lane.
-# case	kind	key/value
-next-git-present	exit	1
-next-git-present	phase	P0=PASS
-next-git-present	phase	P1=PASS
-next-git-present	phase	P2=PASS
-next-git-present	phase	P3=PASS
-next-git-present	phase	P4=FAIL
-next-git-present	phase	P5=FAIL
-next-git-present	phase	P6=FAIL
-next-git-present	phase	P7=PASS
-next-git-present	phase	P8=FAIL
-next-git-present	phase	P9=FAIL
-next-git-present	require	^\[fixture\] resolved lane=next .*version=[0-9]+\.[0-9]+\.[0-9]+-next\.
-next-git-present	require	^\[fixture\] installer_exit=1 done_claims=0$
-next-git-present	phase-reason	P0=target=mosaic uid=1001 HOME=/home/mosaic passwd_HOME=/home/mosaic shell=/bin/bash privilege=user arch=x86_64 libc=glibc node=v[0-9]+\.[0-9]+\.[0-9]+ npm=[0-9]+\.[0-9]+\.[0-9]+
-next-git-present	require	^\[SECRET-CONTROL\] PASS:
-next-git-present	require	^\[P3\] PASS: absolute_path=.* version=.* equals resolved lane version$
-next-git-present	require	^\[P4\] FAIL: NOT-MEASURED / UNDECLARED:
-next-git-present	require	^\[P6\] FAIL: runtime linking/activation action reported a required failure$
-next-git-present	forbid	Done\.|MOSAIC_C1_CANARY_|CLI not found on PATH
-main-git-present	exit	1
-main-git-present	phase	P0=PASS
-main-git-present	phase	P1=PASS
-main-git-present	phase	P2=PASS
-main-git-present	phase	P3=PASS
-main-git-present	phase	P4=FAIL
-main-git-present	phase	P5=FAIL
-main-git-present	phase	P6=FAIL
-main-git-present	phase	P7=PASS
-main-git-present	phase	P8=FAIL
-main-git-present	phase	P9=FAIL
-main-git-present	require	^\[fixture\] resolved lane=main .*version=[0-9]+\.[0-9]+\.[0-9]+$
-main-git-present	require	^\[fixture\] installer_exit=1 done_claims=0$
-main-git-present	phase-reason	P0=target=mosaic uid=1001 HOME=/home/mosaic passwd_HOME=/home/mosaic shell=/bin/bash privilege=user arch=x86_64 libc=glibc node=v[0-9]+\.[0-9]+\.[0-9]+ npm=[0-9]+\.[0-9]+\.[0-9]+
-main-git-present	require	^\[SECRET-CONTROL\] PASS:
-main-git-present	require	^\[P3\] PASS: absolute_path=.* version=.* equals resolved lane version$
-main-git-present	require	^\[P4\] FAIL: NOT-MEASURED / UNDECLARED:
-main-git-present	require	^\[P6\] FAIL: runtime linking/activation action reported a required failure
-main-git-present	forbid	Done\.|MOSAIC_C1_CANARY_|CLI not found on PATH
-next-git-absent	exit	1
-next-git-absent	phase	P0=PASS
-next-git-absent	phase	P1=FAIL
-next-git-absent	phase	P2=FAIL
-next-git-absent	phase	P3=FAIL
-next-git-absent	phase	P4=FAIL
-next-git-absent	phase	P5=FAIL
-next-git-absent	phase	P6=PASS
-next-git-absent	phase	P7=PASS
-next-git-absent	phase	P8=FAIL
-next-git-absent	phase	P9=FAIL
-next-git-absent	require	^\[fixture\] installer_exit=1 done_claims=0$
-next-git-absent	phase-reason	P0=target=mosaic uid=1001 HOME=/home/mosaic passwd_HOME=/home/mosaic shell=/bin/bash privilege=user arch=x86_64 libc=glibc node=v[0-9]+\.[0-9]+\.[0-9]+ npm=[0-9]+\.[0-9]+\.[0-9]+
-next-git-absent	require	^\[SECRET-CONTROL\] PASS:
-next-git-absent	require	^\[P1\] FAIL: undeclared/missing prerequisite\(s\)=git;
-next-git-absent	require	^\[P3\] FAIL: .*executable=no
-next-git-absent	forbid	Done\.|MOSAIC_C1_CANARY_
@@ -1,635 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-# shellcheck source=tools/test-enumeration-assertions.sh
-source "$ROOT/tools/test-enumeration-assertions.sh"
-TMP="$(mktemp -d "${TMPDIR:-/tmp}/mosaic-next-install-test-XXXXXX")"
-trap 'rm -rf "$TMP"' EXIT
-export TMPDIR="$TMP/runtime-tmp"
-mkdir -p "$TMPDIR"
-
-FAKE_BIN="$TMP/bin"
-HOME_DIR="$TMP/home"
-PREFIX="$HOME_DIR/prefix"
-MOSAIC_HOME="$HOME_DIR/mosaic"
-STATE="$TMP/state"
-LOG="$TMP/npm.log"
-mkdir -p "$FAKE_BIN" "$HOME_DIR" "$STATE"
-
-if [[ "${MOSAIC_TEST_ENUMERATION_FAILURE_CHILD:-0}" != "1" ]]; then
-  printf '[test] enumeration failure cannot mask a planted in-progress transaction\n'
-  set +e
-  if [[ "$(/usr/bin/id -u)" -eq 0 ]]; then
-    enumeration_control_output="$(
-      su -s /bin/bash nobody -c \
-        "TMPDIR=/tmp MOSAIC_TEST_ENUMERATION_FAILURE_CHILD=1 bash '$0'" 2>&1
-    )"
-    enumeration_control_status=$?
-  else
-    enumeration_control_output="$(MOSAIC_TEST_ENUMERATION_FAILURE_CHILD=1 bash "$0" 2>&1)"
-    enumeration_control_status=$?
-  fi
-  set -e
-  printf '%s\n' "$enumeration_control_output" > "$TMP/enumeration-failure-control.log"
-  if [[ "$enumeration_control_status" -eq 0 ]]; then
-    echo '[test] FAIL: planted in-progress transaction plus failed enumeration passed the full suite' >&2
-    exit 1
-  fi
-  grep -qF '[test] ERROR: P2 fault-state enumeration failed' "$TMP/enumeration-failure-control.log" || {
-    echo '[test] FAIL: failed fault-state enumeration was not named' >&2
-    exit 1
-  }
-fi
-
-# Model the supported non-root/glibc target explicitly even when this harness
-# itself runs as root in Alpine/BusyBox CI.
-cat > "$FAKE_BIN/id" <<'FAKE_ID'
-#!/usr/bin/env bash
-case "${1:-}" in
-  -u) echo 1001 ;;
-  -g) echo 1001 ;;
-  -un) echo fixture-user ;;
-  *) exec /bin/id "$@" ;;
-esac
-FAKE_ID
-cat > "$FAKE_BIN/getent" <<FAKE_GETENT
-#!/usr/bin/env bash
-printf 'fixture-user:x:1001:1001::%s:/bin/bash\n' '$HOME_DIR'
-FAKE_GETENT
-cat > "$FAKE_BIN/ldd" <<'FAKE_LDD'
-#!/usr/bin/env bash
-printf 'ldd (GNU libc) 2.36\n'
-FAKE_LDD
-cat > "$FAKE_BIN/stat" <<'FAKE_STAT'
-#!/usr/bin/env bash
-if [[ "${1:-} ${2:-}" == '-c %u' ]]; then
-  [[ "${3:-}" == "${MOSAIC_TEST_WRONG_OWNER_PATH:-__none__}" ]] && echo 9999 || echo 1001
-  exit 0
-fi
-if [[ "${1:-} ${2:-}" == '-c %g' ]]; then
-  [[ "${3:-}" == "${MOSAIC_TEST_WRONG_GROUP_PATH:-__none__}" ]] && echo 9999 || echo 1001
-  exit 0
-fi
-exec /bin/stat "$@"
-FAKE_STAT
-cat > "$FAKE_BIN/realpath" <<'FAKE_REALPATH'
-#!/usr/bin/env python3
-import os, sys
-args=sys.argv[1:]
-mode=args.pop(0) if args and args[0] in ('-e','-m') else '-m'
-if args and args[0]=='--': args.pop(0)
-if len(args)!=1 or (mode=='-e' and not os.path.exists(args[0])): raise SystemExit(1)
-print(os.path.realpath(args[0]))
-FAKE_REALPATH
-chmod 0755 "$FAKE_BIN/id" "$FAKE_BIN/getent" "$FAKE_BIN/ldd" "$FAKE_BIN/stat" "$FAKE_BIN/realpath"
-
-cat > "$FAKE_BIN/npm" <<'FAKE_NPM'
-#!/usr/bin/env bash
-set -euo pipefail
-LOG="${MOSAIC_TEST_NPM_LOG:?}"
-STATE="${MOSAIC_TEST_STATE:?}"
-echo "$*" >> "$LOG"
-
-if [[ "${1:-}" == "--version" ]]; then
-  echo "10.6.2"
-  exit 0
-fi
-
-install_cli() {
-  local version="$1"
-  echo "$version" > "$STATE/mosaic"
-  mkdir -p "${MOSAIC_PREFIX:?}/bin"
-  cat > "$MOSAIC_PREFIX/bin/mosaic" <<CLI
-#!/usr/bin/env bash
-set -euo pipefail
-if [[ "\${1:-}" == "wizard" ]]; then
-  printf 'wizard\n' >> "\${MOSAIC_TEST_NPM_LOG:?}"
-  mkdir -p "\${MOSAIC_HOME:?}" "\${HOME:?}/.config/mosaic-gateway"
-  printf '# Soul\\n\\nConfigured.\\n' > "\$MOSAIC_HOME/SOUL.md"
-  printf '# User\\n\\nConfigured.\\n' > "\$MOSAIC_HOME/USER.md"
-  chmod 0600 "\$MOSAIC_HOME/SOUL.md" "\$MOSAIC_HOME/USER.md"
-  exit 0
-fi
-printf '%s\\n' '$version'
-CLI
-  chmod +x "$MOSAIC_PREFIX/bin/mosaic"
-}
-
-if [[ "$1" == "view" ]]; then
-  if [[ "${MOSAIC_TEST_FAIL_NPM_VIEW:-0}" == "1" ]]; then
-    echo "forced registry metadata failure" >&2
-    exit 1
-  fi
-  case "$2 $3" in
-    "@mosaicstack/mosaic@next version") echo "0.0.49-next.999" ;;
-    "@mosaicstack/gateway@next version") echo "${MOSAIC_TEST_GATEWAY_NEXT_VERSION:-0.0.7-next.999}" ;;
-    "@mosaicstack/mosaic version") echo "0.0.48" ;;
-    *) echo "unexpected npm view: $*" >&2; exit 1 ;;
-  esac
-  exit 0
-fi
-
-if [[ "$1" == "install" ]]; then
-  if [[ -n "${MOSAIC_INSTALL_SECRET_CANARY:-}" ]]; then
-    printf 'registry diagnostic authToken=%s\n' "$MOSAIC_INSTALL_SECRET_CANARY"
-    printf 'urls=https://alice:p@[email protected]/a https://bob:pa:[email protected]/b https://carol:p%%[email protected]/c https://[email protected]/d https://user%%[email protected]/e\n'
-    printf 'Authorization: Basic QWxhZGRpbjpvcGVu\n//registry/:_auth=Ym9iOnNlY3JldA==\nCookie: session=abc123\nSet-Cookie: sid=xyz789\n'
-    printf '%s\n' "$MOSAIC_INSTALL_SECRET_CANARY" > "${MOSAIC_TEST_CANARY_OBSERVATION:?}"
-  fi
-  case "$*" in
-    *"@mosaicstack/[email protected]"*)
-      install_cli "0.0.49-next.999"
-      ;;
-    *"@mosaicstack/[email protected]"*)
-      if [[ "${MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL:-0}" == "1" ]]; then
-        echo "forced gateway install failure" >&2
-        exit 1
-      fi
-      echo "0.0.7-next.999" > "$STATE/gateway"
-      ;;
-    *"mosaicstack-mosaic-0.0.0-source.tgz"*)
-      install_cli "0.0.0-source"
-      ;;
-    *"mosaicstack-gateway-0.0.0-source.tgz"*)
-      echo "0.0.0-source" > "$STATE/gateway"
-      ;;
-    *) echo "unexpected npm install: $*" >&2; exit 1 ;;
-  esac
-  exit 0
-fi
-
-if [[ "$1" == "ls" ]]; then
-  cli="$(cat "$STATE/mosaic" 2>/dev/null || true)"
-  gateway="$(cat "$STATE/gateway" 2>/dev/null || true)"
-  node -e '
-    const cli = process.argv[1];
-    const gateway = process.argv[2];
-    const dependencies = {};
-    if (cli) dependencies["@mosaicstack/mosaic"] = { version: cli };
-    if (gateway) dependencies["@mosaicstack/gateway"] = { version: gateway };
-    process.stdout.write(JSON.stringify({ dependencies }));
-  ' "$cli" "$gateway"
-  exit 0
-fi
-
-echo "unexpected npm command: $*" >&2
-exit 1
-FAKE_NPM
-chmod +x "$FAKE_BIN/npm"
-
-cat > "$FAKE_BIN/curl" <<'FAKE_CURL'
-#!/usr/bin/env bash
-set -euo pipefail
-headers=""; output=""; url=""
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -D) headers="$2"; shift 2 ;;
-    -o) output="$2"; shift 2 ;;
-    --max-filesize) shift 2 ;;
-    -*) shift ;;
-    *) url="$1"; shift ;;
-  esac
-done
-case "$url" in
-  */api/v1/repos/mosaicstack/stack/commits?sha=*)
-    printf 'HTTP/1.1 200 OK\r\ncontent-type: application/json; charset=utf-8\r\n\r\n' > "$headers"
-    printf '[{"sha":"1111111111111111111111111111111111111111"}]\n' > "$output"
-    ;;
-  */archive/*.tar.gz)
-    if [[ "${MOSAIC_TEST_CORRUPT_ARCHIVE:-0}" == "1" ]]; then
-      printf 'not-a-tarball\n' > "$output"
-    else
-      archive_root="$(mktemp -d)"
-      mkdir -p "$archive_root/stack"
-      printf 'fixture\n' > "$archive_root/stack/.fixture"
-      /bin/tar czf "$output" -C "$archive_root" stack
-      rm -rf "$archive_root"
-    fi
-    ;;
-esac
-FAKE_CURL
-chmod +x "$FAKE_BIN/curl"
-
-cat > "$FAKE_BIN/tar" <<'FAKE_TAR'
-#!/usr/bin/env bash
-set -euo pipefail
-dest=""; list=false
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -C) dest="$2"; shift 2 ;;
-    -*t*|t*) list=true; shift ;;
-    *) shift ;;
-  esac
-done
-[[ "$list" == true ]] && exit 0
-if [[ -z "$dest" ]]; then
-  echo "fake tar missing -C destination" >&2
-  exit 1
-fi
-mkdir -p "$dest/stack/packages/mosaic/framework" "$dest/stack/apps/gateway"
-if [[ "${MOSAIC_TEST_EXTRA_ARCHIVE_ROOT:-0}" == "1" ]]; then
-  mkdir -p "$dest/unexpected-second-root"
-fi
-cat > "$dest/stack/packages/mosaic/framework/install.sh" <<'FRAMEWORK'
-#!/usr/bin/env bash
-set -euo pipefail
-expected="${MOSAIC_PREFIX:?}/bin/mosaic"
-[[ "${MOSAIC_CLI_PATH:-}" == "$expected" && -x "$MOSAIC_CLI_PATH" ]] || {
-  echo "framework did not receive P3 absolute CLI (got=${MOSAIC_CLI_PATH:-unset} expected=$expected)" >&2
-  exit 61
-}
-printf 'framework-cli=%s version=%s\n' "$MOSAIC_CLI_PATH" "$($MOSAIC_CLI_PATH --version)" >> "${MOSAIC_TEST_NPM_LOG:?}"
-mkdir -p "${MOSAIC_HOME:?}/credentials"
-chmod 0700 "$MOSAIC_HOME/credentials"
-printf '# framework fixture\n' > "$MOSAIC_HOME/AGENTS.md"
-FRAMEWORK
-chmod 0755 "$dest/stack/packages/mosaic/framework/install.sh"
-FAKE_TAR
-chmod +x "$FAKE_BIN/tar"
-
-cat > "$FAKE_BIN/pnpm" <<'FAKE_PNPM'
-#!/usr/bin/env bash
-set -euo pipefail
-LOG="${MOSAIC_TEST_NPM_LOG:?}"
-echo "pnpm $*" >> "$LOG"
-
-if [[ "$1" == "pack" ]]; then
-  out=""
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --pack-destination) out="$2"; shift 2 ;;
-      *) shift ;;
-    esac
-  done
-  if [[ -z "$out" ]]; then
-    echo "fake pnpm pack missing destination" >&2
-    exit 1
-  fi
-  mkdir -p "$out"
-  case "$PWD" in
-    */apps/gateway) touch "$out/mosaicstack-gateway-0.0.0-source.tgz" ;;
-    */packages/mosaic) touch "$out/mosaicstack-mosaic-0.0.0-source.tgz" ;;
-    *) echo "unexpected pnpm pack cwd: $PWD" >&2; exit 1 ;;
-  esac
-  exit 0
-fi
-
-if [[ "${MOSAIC_TEST_FAIL_PNPM_INSTALL:-0}" == "1" && "$1" == "install" ]]; then
-  echo "forced pnpm install failure" >&2
-  exit 42
-fi
-
-# Other install/build commands are no-ops in this harness.
-exit 0
-FAKE_PNPM
-chmod +x "$FAKE_BIN/pnpm"
-
-reset_state() {
-  : > "$LOG"
-  rm -f "$STATE"/*
-}
-
-tree_fingerprint() {
-  local root="$1"
-  if [[ ! -d "$root" ]]; then printf 'ABSENT\n'; return; fi
-  python3 - "$root" <<'PY'
-import hashlib, os, stat, sys
-root=os.path.abspath(sys.argv[1]); rows=[]
-for current, dirs, files in os.walk(root, topdown=True, followlinks=False):
-    for name in dirs + files:
-        path=os.path.join(current,name); meta=os.lstat(path)
-        rel=os.path.relpath(path,root)
-        target=os.readlink(path) if stat.S_ISLNK(meta.st_mode) else ''
-        digest=''
-        if stat.S_ISREG(meta.st_mode):
-            with open(path,'rb') as handle: digest=hashlib.sha256(handle.read()).hexdigest()
-        rows.append((rel,stat.S_IFMT(meta.st_mode),stat.S_IMODE(meta.st_mode),target,digest))
-payload='\n'.join('|'.join(map(str,row)) for row in sorted(rows)).encode()
-print(hashlib.sha256(payload).hexdigest())
-PY
-}
-
-prefix_fingerprint() { tree_fingerprint "$PREFIX"; }
-
-reset_state
-echo "[test] --next fast path pins resolved package versions"
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch
-)"
-
-grep -qF 'Installed @next packages: CLI 0.0.49-next.999, gateway 0.0.7-next.999' <<<"$OUTPUT"
-grep -qF 'install -g @mosaicstack/[email protected]' "$LOG"
-grep -qF 'install -g @mosaicstack/[email protected]' "$LOG"
-if grep -qE '^install -g .+@next( |$)' "$LOG"; then
-  echo "expected exact-version installs, found mutable @next install" >&2
-  exit 1
-fi
-if grep -qF 'Downloading source ref next at pinned commit' <<<"$OUTPUT"; then
-  echo "fast path unexpectedly fell back to source" >&2
-  exit 1
-fi
-
-ACTIVE="$HOME_DIR/.local/state/mosaic/install/active.json"
-[[ "$(node -p "require('$ACTIVE').status")" == "committed" ]]
-JOURNAL="$(node -p "require('$ACTIVE').journal")"
-[[ "$(stat -c '%a' "$JOURNAL")" == "444" ]]
-( cd "$(dirname "$JOURNAL")" && sha256sum -c "$(basename "$JOURNAL").sha256" >/dev/null )
-grep -q '"event":"mutation".*"phase":"P3".*path=.*prior=.*reverse=' "$JOURNAL"
-
-reset_state
-echo "[test] fast path failure falls back to source build"
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch
-)"
-
-grep -qF 'Fast gateway @next install failed.' <<<"$OUTPUT"
-grep -qF 'Falling back to source build at ref next; --next will not hard-fail on registry issues.' <<<"$OUTPUT"
-grep -qF 'Downloading source ref next at pinned commit 1111111111111111111111111111111111111111' <<<"$OUTPUT"
-grep -qF 'Installed from source: CLI 0.0.0-source' <<<"$OUTPUT"
-grep -qF 'install -g @mosaicstack/[email protected]' "$LOG"
-grep -qE 'install -g .*/mosaicstack-gateway-0\.0\.0-source\.tgz' "$LOG"
-grep -qE 'install -g .*/mosaicstack-mosaic-0\.0\.0-source\.tgz' "$LOG"
-[[ "$(cat "$STATE/mosaic")" == "0.0.0-source" ]]
-[[ "$(cat "$STATE/gateway")" == "0.0.0-source" ]]
-
-reset_state
-echo "[test] source-build failure is fatal and restores the pre-install prefix"
-before_prefix="$(prefix_fingerprint)"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL=1 \
-  MOSAIC_TEST_FAIL_PNPM_INSTALL=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch 2>&1
-)"
-FAIL_STATUS=$?
-set -e
-[[ "$FAIL_STATUS" -ne 0 ]]
-[[ "$(prefix_fingerprint)" == "$before_prefix" ]]
-grep -qF 'forced pnpm install failure' <<<"$OUTPUT"
-[[ "$(node -p "require('$ACTIVE').status")" == "rolled-back" ]]
-
-reset_state
-echo "[test] corrupt source archive is fatal and restores the pre-install prefix"
-before_prefix="$(prefix_fingerprint)"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL=1 \
-  MOSAIC_TEST_CORRUPT_ARCHIVE=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch 2>&1
-)"
-FAIL_STATUS=$?
-set -e
-[[ "$FAIL_STATUS" -ne 0 ]]
-[[ "$(prefix_fingerprint)" == "$before_prefix" ]]
-grep -qF 'archive safety/integrity check failed' <<<"$OUTPUT"
-[[ "$(node -p "require('$ACTIVE').status")" == "rolled-back" ]]
-
-reset_state
-echo "[test] source archive with multiple extracted roots fails instead of selecting by find order"
-before_prefix="$(prefix_fingerprint)"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NEXT_GATEWAY_INSTALL=1 \
-  MOSAIC_TEST_EXTRA_ARCHIVE_ROOT=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch 2>&1
-)"
-FAIL_STATUS=$?
-set -e
-[[ "$FAIL_STATUS" -ne 0 ]]
-[[ "$(prefix_fingerprint)" == "$before_prefix" ]]
-grep -qF 'expected exactly one extracted source root' <<<"$OUTPUT"
-[[ "$(node -p "require('$ACTIVE').status")" == "rolled-back" ]]
-
-reset_state
-echo "[test] --dev source install does not require registry version resolution"
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_FAIL_NPM_VIEW=1 \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --cli --dev --ref feature-x --yes --no-auto-launch
-)"
-grep -qF 'Downloading source ref feature-x at pinned commit 1111111111111111111111111111111111111111' <<<"$OUTPUT"
-grep -qF 'Installed from source: CLI 0.0.0-source' <<<"$OUTPUT"
-grep -q '^\[P2\] PASS: source_ref=feature-x pinned_commit=1111111111111111111111111111111111111111 sha256=' <<<"$OUTPUT"
-
-reset_state
-echo "[test] explicit --ref keeps source lane and avoids @next lookup"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --check --cli --next --ref feature-x
-)"
-CHECK_STATUS=$?
-set -e
-[[ "$CHECK_STATUS" -ne 0 ]]
-grep -q '^\[P2\] PASS: source_ref=feature-x pinned_commit=1111111111111111111111111111111111111111 sha256=' <<<"$OUTPUT"
-if grep -qF '@next version' "$LOG"; then
-  echo "explicit ref should not query @next dist-tags" >&2
-  exit 1
-fi
-
-reset_state
-echo "[test] --check --next rejects mismatched prerelease pipeline suffixes"
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" \
-  MOSAIC_HOME="$MOSAIC_HOME" \
-  MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" \
-  MOSAIC_TEST_STATE="$STATE" \
-  MOSAIC_TEST_GATEWAY_NEXT_VERSION="0.0.7-next.1000" \
-  PATH="$FAKE_BIN:$PATH" \
-  bash "$ROOT/tools/install.sh" --check --cli --next
-)"
-CHECK_STATUS=$?
-set -e
-[[ "$CHECK_STATUS" -ne 0 ]]
-grep -q '^\[P2\] FAIL: resolved_version=unavailable' <<<"$OUTPUT"
-
-printf '[test] full framework path receives P3 absolute CLI without relying on PATH\n'
-rm -rf "$HOME_DIR" "$STATE"; mkdir -p "$HOME_DIR" "$STATE"; reset_state
-set +e
-OUTPUT="$(
-  HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_INSTALL_STATE_DIR="$TMP/full-state" MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --next --yes --no-auto-launch 2>&1
-)"
-FULL_STATUS=$?
-set -e
-[[ "$FULL_STATUS" -ne 0 ]] # P4 remains intentionally undeclared until C5.
-grep -qF "framework-cli=$PREFIX/bin/mosaic version=0.0.49-next.999" "$LOG"
-if grep -q "CLI not found on PATH\|did not receive P3 absolute CLI" <<<"$OUTPUT"; then
-  echo "internal framework phase depended on PATH instead of P3 absolute CLI" >&2
-  exit 1
-fi
-
-printf '[test] captured diagnostics redact seeded credential canary everywhere\n'
-rm -rf "$HOME_DIR" "$STATE"; mkdir -p "$HOME_DIR" "$STATE"; reset_state
-canary='C1_SECRET_CANARY_7df4c2'
-OUTPUT="$(
-  HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_INSTALL_STATE_DIR="$TMP/secret-state" MOSAIC_NO_COLOR=1 \
-  MOSAIC_INSTALL_SECRET_CANARY="$canary" MOSAIC_TEST_CANARY_OBSERVATION="$TMP/canary-observed" \
-  MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch 2>&1
-)"
-if grep -qF "$canary" <<<"$OUTPUT"; then echo 'credential canary leaked to terminal output' >&2; exit 1; fi
-if grep -Eq 'alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789' <<<"$OUTPUT"; then
-  echo 'credentialed URL userinfo leaked to terminal output' >&2; exit 1
-fi
-for host in example.com example.net example.org example.dev example.io; do
-  grep -qF "https://[REDACTED]@$host" <<<"$OUTPUT" \
-    || { echo "credentialed URL redaction control missing for $host" >&2; exit 1; }
-done
-secret_active="$TMP/secret-state/active.json"
-secret_journal="$(node -p "require('$secret_active').journal")"
-secret_command_log="$(dirname "$secret_journal")/commands.log"
-if grep -R -F "$canary" "$secret_command_log" "$HOME_DIR" 2>/dev/null; then
-  echo 'credential canary leaked to persistent installer output' >&2; exit 1
-fi
-if grep -E 'alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789' "$secret_command_log" >/dev/null; then
-  echo 'credentialed URL userinfo leaked to persistent installer output' >&2; exit 1
-fi
-if [[ "$(cat "$TMP/canary-observed" 2>/dev/null || true)" != "$canary" ]]; then
-  echo 'credential canary positive control was not exercised' >&2; exit 1
-fi
-test_assert_find_empty 'redacted diagnostic staging files' \
-  "$TMPDIR" -maxdepth 1 -type f \
-  \( -name 'mosaic-phase-redacted.*' -o -name 'mosaic-post-redacted.*' \) || exit 1
-
-printf '[test] framework nested capture redacts the same canary and URL variants\n'
-framework_test_home="$TMP/framework-redact-home"
-framework_target="$framework_test_home/.config/mosaic"
-framework_cli="$TMP/framework-redact-cli"
-framework_log="$TMP/framework-redact-commands.log"
-framework_status="$TMP/framework-redact-status.tsv"
-mkdir -p "$framework_test_home"; : > "$framework_log"; : > "$framework_status"
-cat > "$framework_cli" <<'FRAMEWORK_CLI'
-#!/usr/bin/env bash
-printf 'nested authToken=%s\n' "${MOSAIC_INSTALL_SECRET_CANARY:?}"
-printf 'nested=https://alice:p@[email protected]/a https://bob:pa:[email protected]/b https://carol:p%%[email protected]/c https://[email protected]/d https://user%%[email protected]/e\n'
-printf 'Authorization: Basic QWxhZGRpbjpvcGVu\n//registry/:_auth=Ym9iOnNlY3JldA==\nCookie: session=abc123\nSet-Cookie: sid=xyz789\n'
-exit 1
-FRAMEWORK_CLI
-chmod 0755 "$framework_cli"
-set +e
-FRAMEWORK_OUTPUT="$(
-  HOME="$framework_test_home" MOSAIC_HOME="$framework_target" MOSAIC_INSTALL_MODE=overwrite \
-  MOSAIC_CLI_PATH="$framework_cli" MOSAIC_INSTALL_SECRET_CANARY="$canary" \
-  MOSAIC_INSTALL_COMMAND_LOG="$framework_log" MOSAIC_INSTALL_PHASE_STATUS_FILE="$framework_status" \
-  MOSAIC_ALLOW_MISSING_SEQUENTIAL_THINKING=1 MOSAIC_SKIP_SKILLS_SYNC=1 \
-  bash "$ROOT/packages/mosaic/framework/install.sh" 2>&1
-)"
-framework_install_status=$?
-set -e
-[[ "$framework_install_status" -eq 0 ]]
-if grep -Eq "$canary|alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789" <<<"$FRAMEWORK_OUTPUT" \
-  || grep -Eq "$canary|alice:p@ss|bob:pa:ss|carol:p%40ss|token@example|user%3Apass|QWxhZGRpbjpvcGVu|Ym9iOnNlY3JldA|session=abc123|sid=xyz789" "$framework_log"; then
-  echo 'framework nested capture leaked credential diagnostics' >&2; exit 1
-fi
-for host in example.com example.net example.org example.dev example.io; do
-  grep -qF "https://[REDACTED]@$host" "$framework_log" \
-    || { echo "framework URL redaction control missing for $host" >&2; exit 1; }
-done
-
-printf '[test] real P2-P8 actions run under fault injection and restore actual surfaces\n'
-for phase in P2 P3 P4 P5 P6 P7 P8; do
-  rm -rf "$HOME_DIR" "$STATE" "$TMP/fault-$phase"; mkdir -p "$HOME_DIR" "$STATE" "$TMP/fault-$phase"
-  printf 'operator-sentinel\n' > "$HOME_DIR/operator.txt"
-  reset_state
-  before="$(tree_fingerprint "$HOME_DIR")"
-  set +e
-  HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-    MOSAIC_INSTALL_STATE_DIR="$TMP/fault-$phase" MOSAIC_INSTALL_FAULT_AFTER="$phase" \
-    MOSAIC_INSTALL_SELF_TEST_ALLOW=1 MOSAIC_NO_COLOR=1 \
-    MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-    PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-    bash "$ROOT/tools/install.sh" --state-machine-self-test --next --yes \
-    >"$TMP/fault-$phase.log" 2>&1
-  status=$?
-  set -e
-  [[ "$status" -eq 97 ]] || { echo "$phase real fault expected 97, got $status" >&2; exit 1; }
-  [[ -s "$LOG" ]] || { echo "$phase fault never entered the real action path" >&2; exit 1; }
-  [[ "$(tree_fingerprint "$HOME_DIR")" == "$before" ]] || { echo "$phase real rollback mismatch" >&2; exit 1; }
-  grep -q "phase=$phase" "$TMP/fault-$phase.log"
-  if [[ "${MOSAIC_TEST_ENUMERATION_FAILURE_CHILD:-0}" == "1" && "$phase" == "P2" ]]; then
-    mkdir -p "$TMP/fault-$phase/blocked"
-    printf '{"status":"in-progress"}\n' > "$TMP/fault-$phase/blocked/planted-in-progress.json"
-    chmod 0666 "$TMP/fault-$phase/blocked/planted-in-progress.json"
-    chmod 0100 "$TMP/fault-$phase/blocked"
-    trap 'chmod 0700 "$TMP/fault-P2/blocked" 2>/dev/null || true; rm -rf "$TMP"' EXIT
-  fi
-  test_assert_no_file_content_match "$phase fault-state" \
-    '"status"[[:space:]]*:[[:space:]]*"in-progress"' "$TMP/fault-$phase" || exit 1
-done
-
-printf '[test] stale projection is preserved while the real fault path acquires a free OS lock\n'
-rm -rf "$HOME_DIR" "$STATE" "$TMP/stale-state"; mkdir -p "$HOME_DIR" "$STATE" "$TMP/stale-state"
-printf '{"status":"in-progress","journal":"%s"}\n' "$TMP/stale-state/dead-run/journal.ndjson" > "$TMP/stale-state/active.json"
-reset_state
-set +e
-HOME="$HOME_DIR" MOSAIC_HOME="$MOSAIC_HOME" MOSAIC_PREFIX="$PREFIX" \
-  MOSAIC_INSTALL_STATE_DIR="$TMP/stale-state" MOSAIC_INSTALL_FAULT_AFTER=P2 \
-  MOSAIC_INSTALL_SELF_TEST_ALLOW=1 MOSAIC_NO_COLOR=1 \
-  MOSAIC_TEST_NPM_LOG="$LOG" MOSAIC_TEST_STATE="$STATE" \
-  PATH="$FAKE_BIN:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --state-machine-self-test --next --yes >"$TMP/stale.log" 2>&1
-stale_status=$?
-set -e
-[[ "$stale_status" -eq 97 ]]
-find "$TMP/stale-state" -name prior-active.json -type f -print -quit | grep -q .
-[[ "$(node -p "require('$TMP/stale-state/active.json').status")" == rolled-back ]]
-
-echo "[test] installer next lane tests passed"
@@ -1,431 +0,0 @@
-#!/usr/bin/env bash
-# Red-first acceptance checks for #1050. This file is committed before the
-# installer implementation. Do not weaken these properties to make it green.
-
-# pass_case always returns zero and fail_case records the aggregate failure;
-# the compact A&&pass||fail assertions are intentional.
-# shellcheck disable=SC2015
-set -uo pipefail
-
-ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-# shellcheck source=tools/test-enumeration-assertions.sh
-source "$ROOT/tools/test-enumeration-assertions.sh"
-TMP="$(mktemp -d "${TMPDIR:-/tmp}/mosaic-install-state-test.XXXXXX")"
-trap 'rm -rf "$TMP"' EXIT
-failures=0
-COMPAT_BIN="$TMP/compat-bin"
-mkdir -p "$COMPAT_BIN"
-cat > "$COMPAT_BIN/realpath" <<'REALPATH'
-#!/usr/bin/env python3
-import os
-import sys
-
-args = sys.argv[1:]
-mode = args.pop(0) if args and args[0] in ("-e", "-m") else "-m"
-if args and args[0] == "--":
-    args.pop(0)
-if len(args) != 1 or (mode == "-e" and not os.path.exists(args[0])):
-    raise SystemExit(1)
-print(os.path.realpath(args[0]))
-REALPATH
-chmod 0755 "$COMPAT_BIN/realpath"
-
-fail_case() { printf '[test] FAIL: %s\n' "$*" >&2; failures=$((failures + 1)); }
-pass_case() { printf '[test] PASS: %s\n' "$*"; }
-
-fingerprint() {
-  local dir="$1"
-  if [[ ! -d "$dir" ]]; then printf 'ABSENT\n'; return; fi
-  python3 - "$dir" <<'PY'
-import hashlib
-import os
-import stat
-import sys
-
-root = os.path.abspath(sys.argv[1])
-rows = []
-for current, dirs, files in os.walk(root, topdown=True, followlinks=False):
-    for name in dirs + files:
-        path = os.path.join(current, name)
-        rel = os.path.relpath(path, root)
-        meta = os.lstat(path)
-        target = os.readlink(path) if stat.S_ISLNK(meta.st_mode) else ""
-        digest = ""
-        if stat.S_ISREG(meta.st_mode):
-            with open(path, "rb") as handle:
-                digest = hashlib.sha256(handle.read()).hexdigest()
-        rows.append((rel, stat.S_IFMT(meta.st_mode), stat.S_IMODE(meta.st_mode), meta.st_uid, meta.st_gid, target, digest))
-payload = "\n".join("|".join(map(str, row)) for row in sorted(rows)).encode()
-print(hashlib.sha256(payload).hexdigest())
-PY
-}
-
-make_fake_npm() {
-  local bin="$1"
-  mkdir -p "$bin"
-  cat > "$bin/npm" <<'FAKE'
-#!/bin/bash
-set -euo pipefail
-if [[ "${1:-}" == "--version" ]]; then echo '10.6.2'; exit 0; fi
-case "${1:-} ${2:-} ${3:-}" in
-  'view @mosaicstack/mosaic@next version') echo '0.0.50-next.999' ;;
-  'view @mosaicstack/gateway@next version') echo '0.0.7-next.999' ;;
-  'view @mosaicstack/mosaic version') echo '0.0.49' ;;
-  'ls -g --depth=0'|'ls -g --json') echo '{"dependencies":{"@mosaicstack/mosaic":{"version":"0.0.50-next.999"},"@mosaicstack/gateway":{"version":"0.0.7-next.999"}}}' ;;
-  ls*) echo '{"dependencies":{"@mosaicstack/mosaic":{"version":"0.0.50-next.999"},"@mosaicstack/gateway":{"version":"0.0.7-next.999"}}}' ;;
-  *) echo "unexpected fake npm command: $*" >&2; exit 1 ;;
-esac
-FAKE
-  chmod 0755 "$bin/npm"
-}
-
-printf '[test] case: --check enumerates exactly P0-P8, discriminates, and mutates nothing\n'
-check_home="$TMP/check-home"
-check_bin="$TMP/check-bin"
-mkdir -p "$check_home/.config/mosaic/skills/alpha" "$check_home/.npm-global/bin" "$check_bin"
-printf '# framework\n' > "$check_home/.config/mosaic/AGENTS.md"
-printf '# skill\n' > "$check_home/.config/mosaic/skills/alpha/SKILL.md"
-cat > "$check_home/.npm-global/bin/mosaic" <<'CLI'
-#!/usr/bin/env bash
-printf '0.0.50-next.999\n'
-CLI
-chmod 0755 "$check_home/.npm-global/bin/mosaic"
-make_fake_npm "$check_bin"
-before="$(fingerprint "$check_home")"
-set +e
-HOME="$check_home" MOSAIC_HOME="$check_home/.config/mosaic" MOSAIC_PREFIX="$check_home/.npm-global" \
-  MOSAIC_NO_COLOR=1 PATH="$check_bin:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --check --next >"$TMP/check.log" 2>&1
-check_status=$?
-set -e
-after="$(fingerprint "$check_home")"
-
-[[ "$before" == "$after" ]] && pass_case '--check left the complete HOME fingerprint unchanged' \
-  || fail_case "--check mutated HOME (before=$before after=$after)"
-[[ "$check_status" -ne 0 ]] && pass_case '--check exited non-zero for failed P4/P5/P8 predicates' \
-  || fail_case '--check returned zero on the deliberately broken host'
-
-phase_rows=0
-for phase in P0 P1 P2 P3 P4 P5 P6 P7 P8; do
-  count="$(grep -Ec "^\[$phase\] (PASS|FAIL):" "$TMP/check.log" || true)"
-  [[ "$count" -eq 1 ]] || fail_case "$phase expected exactly one PASS/FAIL row, got $count"
-  phase_rows=$((phase_rows + count))
-done
-[[ "$phase_rows" -eq 9 ]] && pass_case '--check emitted exactly nine P0-P8 result rows' \
-  || fail_case "--check emitted $phase_rows canonical rows instead of 9"
-grep -q '^\[P3\] PASS:.*0\.0\.50-next\.999' "$TMP/check.log" \
-  && pass_case 'P3 preserves the absolute-path exact-version discriminator' \
-  || fail_case 'P3 did not PASS with the exact resolved next-lane version'
-grep -q '^\[P4\] FAIL: NOT-MEASURED / UNDECLARED:' "$TMP/check.log" \
-  && pass_case 'P4 refuses fabricated precision when no shipped-set declaration exists' \
-  || fail_case 'P4 did not report the declared-set population as NOT-MEASURED / UNDECLARED'
-for phase in P5 P8; do
-  grep -q "^\[$phase\] FAIL:" "$TMP/check.log" \
-    && pass_case "$phase remains an attributable expected RED" \
-    || fail_case "$phase did not report its own expected failure"
-done
-
-printf '[test] case: --check discriminates a constructed good host without mutation\n'
-good_home="$TMP/good-home"
-good_bin="$TMP/good-bin"
-good_prefix="$good_home/.npm-global"
-good_mosaic="$good_home/.config/mosaic"
-mkdir -p "$good_bin" "$good_prefix/bin" "$good_mosaic/skills/declared-skill"
-make_fake_npm "$good_bin"
-cp "$COMPAT_BIN/realpath" "$good_bin/realpath"
-cat > "$good_bin/id" <<'ID'
-#!/bin/bash
-uid="${MOSAIC_TEST_UID:-1001}"
-gid="${MOSAIC_TEST_GID:-1001}"
-user="${MOSAIC_TEST_USER:-fixture-user}"
-case "${1:-}" in
-  -u) echo "$uid" ;;
-  -g) echo "$gid" ;;
-  -un) echo "$user" ;;
-  *) exec /bin/id "$@" ;;
-esac
-ID
-cat > "$good_bin/stat" <<'STAT'
-#!/bin/bash
-if [[ "${1:-} ${2:-}" == '-c %u' ]]; then
-  [[ "${3:-}" == "${MOSAIC_TEST_WRONG_OWNER_PATH:-__none__}" ]] && echo 9999 || echo "${MOSAIC_TEST_UID:-1001}"
-  exit 0
-fi
-if [[ "${1:-} ${2:-}" == '-c %g' ]]; then
-  [[ "${3:-}" == "${MOSAIC_TEST_WRONG_GROUP_PATH:-__none__}" ]] && echo 9999 || echo "${MOSAIC_TEST_GID:-1001}"
-  exit 0
-fi
-exec /bin/stat "$@"
-STAT
-cat > "$good_bin/curl" <<'CURL'
-#!/bin/bash
-exit 0
-CURL
-cat > "$good_bin/ldd" <<'LDD'
-#!/bin/bash
-echo 'ldd (GNU libc) 2.36'
-LDD
-chmod 0755 "$good_bin/id" "$good_bin/stat" "$good_bin/curl" "$good_bin/ldd"
-cat > "$good_prefix/bin/mosaic" <<'CLI'
-#!/usr/bin/env bash
-printf '0.0.50-next.999\n'
-CLI
-chmod 0755 "$good_prefix/bin/mosaic"
-cat > "$good_bin/getent" <<GETENT
-#!/bin/bash
-printf '%s:x:%s:%s::%s:%s\\n' "\${MOSAIC_TEST_USER:-fixture-user}" "\${MOSAIC_TEST_UID:-1001}" "\${MOSAIC_TEST_GID:-1001}" "\${MOSAIC_TEST_PASSWD_HOME:-$good_home}" '$good_bin/bash'
-GETENT
-cat > "$good_bin/bash" <<SHELL
-#!/bin/bash
-if [[ "\${*: -1}" == 'command -v mosaic' ]]; then
-  printf '%s\\n' '$good_prefix/bin/mosaic'
-  exit 0
-fi
-exec /bin/bash "\$@"
-SHELL
-chmod 0755 "$good_bin/getent" "$good_bin/bash"
-printf '# Soul\n\nConfigured.\n' > "$good_mosaic/SOUL.md"
-printf '# User\n\nConfigured.\n' > "$good_mosaic/USER.md"
-chmod 0600 "$good_mosaic/SOUL.md" "$good_mosaic/USER.md"
-cat > "$good_mosaic/skills/declared-skill/SKILL.md" <<'SKILL'
---
-name: declared-skill
-description: Constructed loadable acceptance skill.
---
-
-# Declared skill
-SKILL
-printf '{"lane":"next","version":"0.0.50-next.999","skills":["declared-skill"]}\n' > "$good_mosaic/.install-shipped-skills.json"
-printf '{\n  "lane": "next",\n  "cliVersion": "0.0.50-next.999"\n}\n' > "$good_mosaic/.install-manifest.json"
-before="$(fingerprint "$good_home")"
-set +e
-HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" \
-  MOSAIC_NO_COLOR=1 PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --check --next >"$TMP/good-check.log" 2>&1
-status=$?
-set -e
-after="$(fingerprint "$good_home")"
-[[ "$status" -eq 0 ]] && pass_case 'good-host --check exited zero' || fail_case "good-host --check exited $status"
-[[ "$before" == "$after" ]] && pass_case 'good-host --check left HOME unchanged' || fail_case 'good-host --check mutated HOME'
-good_rows="$(grep -Ec '^\[P[0-8]\] PASS:' "$TMP/good-check.log" || true)"
-[[ "$good_rows" -eq 9 ]] && pass_case 'good-host --check emitted nine PASS rows' \
-  || { cat "$TMP/good-check.log" >&2; fail_case "good-host --check emitted $good_rows PASS rows"; }
-
-printf '[test] case: P0 binds uid, username, passwd HOME, shell, and privilege mode\n'
-passwd_home="$TMP/passwd-authoritative-home"
-mkdir -p "$passwd_home"
-set +e
-HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" \
-  MOSAIC_TEST_PASSWD_HOME="$passwd_home" MOSAIC_NO_COLOR=1 \
-  PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --check --next >"$TMP/wrong-home.log" 2>&1
-wrong_home_status=$?
-set -e
-[[ "$wrong_home_status" -ne 0 ]] || fail_case 'P0 accepted ambient HOME that disagrees with passwd HOME'
-grep -q '^\[P0\] FAIL:.*HOME mismatch' "$TMP/wrong-home.log" \
-  && pass_case 'P0 rejects ambient HOME that disagrees with passwd HOME' \
-  || fail_case 'P0 did not attribute the passwd HOME mismatch'
-
-for privilege_case in root-with-home sudo-with-inherited-home; do
-  extra_env=()
-  [[ "$privilege_case" == sudo-with-inherited-home ]] && extra_env+=(SUDO_USER=fixture-user SUDO_UID=1001)
-  set +e
-  env HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" \
-    MOSAIC_TEST_UID=0 MOSAIC_TEST_GID=0 MOSAIC_TEST_USER=root MOSAIC_TEST_PASSWD_HOME=/root \
-    MOSAIC_NO_COLOR=1 PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" "${extra_env[@]}" \
-    bash "$ROOT/tools/install.sh" --check --next >"$TMP/$privilege_case.log" 2>&1
-  privilege_status=$?
-  set -e
-  [[ "$privilege_status" -ne 0 ]] || fail_case "P0 accepted unsafe $privilege_case context"
-  grep -q '^\[P0\] FAIL:.*privilege=' "$TMP/$privilege_case.log" \
-    && pass_case "P0 states and rejects $privilege_case privilege context" \
-    || fail_case "P0 did not state $privilege_case privilege mode"
-done
-
-printf '[test] case: P3/P5 reject unsafe owner, group, and mode\n'
-chmod 0777 "$good_prefix/bin/mosaic"
-set +e
-HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" MOSAIC_NO_COLOR=1 \
-  PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" bash "$ROOT/tools/install.sh" --check --next >"$TMP/p3-mode.log" 2>&1
-p3_mode_status=$?
-set -e
-[[ "$p3_mode_status" -ne 0 ]] || fail_case 'P3 accepted mode-0777 CLI'
-grep -q '^\[P3\] FAIL:.*unsafe owner/group/mode' "$TMP/p3-mode.log" \
-  && pass_case 'P3 rejects group/world-writable CLI' || fail_case 'P3 did not attribute unsafe CLI mode'
-chmod 0755 "$good_prefix/bin/mosaic"
-
-for ownership_case in owner group; do
-  wrong_env=()
-  [[ "$ownership_case" == owner ]] && wrong_env+=(MOSAIC_TEST_WRONG_OWNER_PATH="$good_prefix/bin/mosaic")
-  [[ "$ownership_case" == group ]] && wrong_env+=(MOSAIC_TEST_WRONG_GROUP_PATH="$good_prefix/bin/mosaic")
-  set +e
-  env HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" MOSAIC_NO_COLOR=1 \
-    PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" "${wrong_env[@]}" \
-    bash "$ROOT/tools/install.sh" --check --next >"$TMP/p3-$ownership_case.log" 2>&1
-  owner_status=$?
-  set -e
-  [[ "$owner_status" -ne 0 ]] || fail_case "P3 accepted wrong CLI $ownership_case"
-  grep -q '^\[P3\] FAIL:.*unsafe owner/group/mode' "$TMP/p3-$ownership_case.log" \
-    && pass_case "P3 rejects wrong CLI $ownership_case" || fail_case "P3 did not attribute wrong CLI $ownership_case"
-done
-
-chmod 0644 "$good_mosaic/SOUL.md" "$good_mosaic/USER.md"
-set +e
-HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" MOSAIC_NO_COLOR=1 \
-  PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" bash "$ROOT/tools/install.sh" --check --next >"$TMP/p5-mode.log" 2>&1
-p5_mode_status=$?
-set -e
-[[ "$p5_mode_status" -ne 0 ]] || fail_case 'P5 accepted world-readable identity files'
-grep -q '^\[P5\] FAIL:' "$TMP/p5-mode.log" \
-  && pass_case 'P5 rejects world-readable identity files' || fail_case 'P5 did not reject identity mode 0644'
-chmod 0600 "$good_mosaic/SOUL.md" "$good_mosaic/USER.md"
-
-mkdir -p "$good_mosaic/credentials"
-chmod 0755 "$good_mosaic/credentials"
-set +e
-HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" MOSAIC_NO_COLOR=1 \
-  PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" bash "$ROOT/tools/install.sh" --check --next >"$TMP/p5-credentials.log" 2>&1
-credential_status=$?
-set -e
-[[ "$credential_status" -ne 0 ]] || fail_case 'P5 accepted mode-0755 credentials directory'
-grep -q '^\[P5\] FAIL:.*credentials' "$TMP/p5-credentials.log" \
-  && pass_case 'P5 rejects group/world-readable credential storage' \
-  || fail_case 'P5 did not attribute unsafe credential directory mode'
-chmod 0700 "$good_mosaic/credentials"
-
-printf '# framework\n' > "$good_mosaic/AGENTS.md"
-chmod 0666 "$good_mosaic/AGENTS.md"
-set +e
-HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" MOSAIC_NO_COLOR=1 \
-  PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" bash "$ROOT/tools/install.sh" --check --next >"$TMP/p4-tree-mode.log" 2>&1
-framework_mode_status=$?
-set -e
-[[ "$framework_mode_status" -ne 0 ]] || fail_case 'P4 accepted group/world-writable framework path'
-grep -q '^\[P4\] FAIL:.*owner/mode policy' "$TMP/p4-tree-mode.log" \
-  && pass_case 'P4 inventories and rejects unsafe created framework paths' \
-  || fail_case 'P4 did not attribute unsafe created-path mode'
-chmod 0644 "$good_mosaic/AGENTS.md"
-
-printf '[test] case: P4 fails closed when created-path enumeration is incomplete\n'
-real_find="$(command -v find)"
-cat > "$good_bin/find" <<FIND
-#!/bin/bash
-if [[ "\${1:-}" == '$good_mosaic' && "\${2:-}" == '-xdev' && "\${3:-}" == '-print0' ]]; then
-  printf '%s\\0' '$good_mosaic'
-  exit 73
-fi
-exec '$real_find' "\$@"
-FIND
-chmod 0755 "$good_bin/find"
-printf '# hidden unsafe child\n' > "$good_mosaic/AGENTS.md"
-chmod 0666 "$good_mosaic/AGENTS.md"
-set +e
-HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" MOSAIC_NO_COLOR=1 \
-  PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" bash "$ROOT/tools/install.sh" --check --next \
-  >"$TMP/p4-enumeration-failure.log" 2>&1
-p4_enumeration_status=$?
-set -e
-rm -f "$good_bin/find"
-[[ "$p4_enumeration_status" -ne 0 ]] \
-  && pass_case 'P4 rejects an incomplete created-path inventory' \
-  || fail_case 'P4 accepted a partial created-path inventory after find failed'
-grep -q '^\[P4\] FAIL:.*enumeration failed' "$TMP/p4-enumeration-failure.log" \
-  && pass_case 'P4 attributes the failed created-path enumeration' \
-  || fail_case 'P4 did not report failed created-path enumeration'
-chmod 0644 "$good_mosaic/AGENTS.md"
-
-printf '[test] case: persisted required-action failures remain blocking\n'
-for blocked_phase in P4 P6; do
-  node -e '
-    const fs=require("fs"); const p=process.argv[1]; const phase=process.argv[2];
-    const m=JSON.parse(fs.readFileSync(p,"utf8")); m.phaseOutcomes={P4:"committed",P6:"committed"};
-    m.phaseOutcomes[phase]="failed"; fs.writeFileSync(p,JSON.stringify(m)+"\n");
-  ' "$good_mosaic/.install-manifest.json" "$blocked_phase"
-  set +e
-  HOME="$good_home" MOSAIC_HOME="$good_mosaic" MOSAIC_PREFIX="$good_prefix" \
-    MOSAIC_NO_COLOR=1 PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" \
-    bash "$ROOT/tools/install.sh" --check --next >"$TMP/action-$blocked_phase.log" 2>&1
-  status=$?
-  set -e
-  [[ "$status" -ne 0 ]] || fail_case "$blocked_phase action failure returned zero"
-  grep -q "^\[$blocked_phase\] FAIL:.*action reported a required $blocked_phase failure" "$TMP/action-$blocked_phase.log" \
-    && pass_case "$blocked_phase action failure remained blocking in a later --check" \
-    || fail_case "$blocked_phase persisted action failure was not attributed"
-done
-printf '{\n  "lane": "next",\n  "cliVersion": "0.0.50-next.999",\n  "phaseOutcomes": {"P4":"committed","P6":"committed"}\n}\n' > "$good_mosaic/.install-manifest.json"
-
-printf '[test] case: fault injection has no synthetic mutation implementation\n'
-if grep -q '\.selftest-' "$ROOT/tools/install.sh"; then
-  fail_case 'synthetic .selftest mutation path remains in the production fault seam'
-else
-  pass_case 'fault seam is attached only to real P2-P8 action flow (exercised by install-next-lane.test.sh)'
-fi
-
-printf '[test] case: unsafe and overlapping rollback roots fail before mutation\n'
-unsafe_home="$TMP/unsafe-home"
-mkdir -p "$unsafe_home"
-for case_name in root-target home-target overlap-target; do
-  case "$case_name" in
-    root-target) unsafe_mosaic=/; unsafe_prefix="$unsafe_home/.npm-global" ;;
-    home-target) unsafe_mosaic="$unsafe_home"; unsafe_prefix="$unsafe_home/.npm-global" ;;
-    overlap-target) unsafe_mosaic="$unsafe_home/.config"; unsafe_prefix="$unsafe_home/.config/mosaic/prefix" ;;
-  esac
-  before="$(fingerprint "$unsafe_home")"
-  set +e
-  HOME="$unsafe_home" MOSAIC_HOME="$unsafe_mosaic" MOSAIC_PREFIX="$unsafe_prefix" \
-    MOSAIC_TEST_PASSWD_HOME="$unsafe_home" MOSAIC_NO_COLOR=1 PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" \
-    bash "$ROOT/tools/install.sh" --check --next >"$TMP/$case_name.log" 2>&1
-  status=$?
-  set -e
-  after="$(fingerprint "$unsafe_home")"
-  [[ "$status" -ne 0 ]] || fail_case "$case_name unsafe path returned zero"
-  grep -q '^\[P0\] FAIL:.*unsafe context' "$TMP/$case_name.log" \
-    && pass_case "$case_name was rejected by P0" || fail_case "$case_name lacked an attributable P0 failure"
-  [[ "$before" == "$after" ]] || fail_case "$case_name mutated HOME"
-done
-
-symlink_home="$TMP/symlink-home"
-symlink_outside="$TMP/symlink-outside"
-mkdir -p "$symlink_home" "$symlink_outside"
-ln -s "$symlink_outside" "$symlink_home/.config"
-set +e
-HOME="$symlink_home" MOSAIC_HOME="$symlink_home/.config/mosaic" MOSAIC_PREFIX="$symlink_home/.npm-global" \
-  MOSAIC_TEST_PASSWD_HOME="$symlink_home" MOSAIC_NO_COLOR=1 PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --check --next >"$TMP/symlink-target.log" 2>&1
-status=$?
-set -e
-[[ "$status" -ne 0 ]] || fail_case 'symlink-parent unsafe path returned zero'
-grep -q '^\[P0\] FAIL:.*unsafe context' "$TMP/symlink-target.log" \
-  && pass_case 'symlinked rollback parent was rejected by P0' \
-  || fail_case 'symlinked rollback parent lacked an attributable P0 failure'
-test_assert_find_empty 'symlink target mutation check' "$symlink_outside" -mindepth 1 \
-  || fail_case 'symlink target was mutated or could not be enumerated'
-
-printf '[test] case: journal initialization failure is fatal before mutation\n'
-journal_home="$TMP/journal-failure/home"
-mkdir -p "$journal_home/.config/mosaic"
-printf 'journal-sentinel\n' > "$journal_home/.config/mosaic/operator.txt"
-before="$(fingerprint "$journal_home")"
-set +e
-HOME="$journal_home" MOSAIC_HOME="$journal_home/.config/mosaic" MOSAIC_PREFIX="$journal_home/.npm-global" \
-  MOSAIC_TEST_PASSWD_HOME="$journal_home" MOSAIC_INSTALL_STATE_DIR="/proc/mosaic-journal-denied-$$" \
-  MOSAIC_NO_COLOR=1 PATH="$good_bin:/usr/local/bin:/usr/bin:/bin" \
-  bash "$ROOT/tools/install.sh" --cli --next --yes --no-auto-launch \
-  >"$TMP/journal-failure.log" 2>&1
-status=$?
-set -e
-after="$(fingerprint "$journal_home")"
-[[ "$status" -ne 0 ]] && pass_case 'unwritable journal directory failed non-zero' \
-  || fail_case 'unwritable journal directory returned zero'
-grep -q 'cannot create private journal directory' "$TMP/journal-failure.log" \
-  && pass_case 'journal initialization failure was named' \
-  || fail_case 'journal initialization failure lacked a named diagnostic'
-[[ "$before" == "$after" ]] && pass_case 'journal failure occurred before target mutation' \
-  || fail_case "journal failure mutated target HOME (before=$before after=$after)"
-
-if [[ "$failures" -ne 0 ]]; then
-  printf '[test] install state-machine acceptance RED: %d failed assertion(s)\n' "$failures" >&2
-  printf '[test] --check transcript: %s\n' "$TMP/check.log" >&2
-  exit 1
-fi
-printf '[test] installer state-machine acceptance passed\n'
@@ -1 +0,0 @@
-e59cb441a2f37ae9150f8eae470238e9d858a1816df93343d9784a6796676096  install.sh
@@ -1,72 +0,0 @@
-#!/usr/bin/env bash
-# Fail-closed filesystem-enumeration assertions for shell test harnesses.
-
-# Usage: test_assert_find_empty <label> <find arguments...>
-test_assert_find_empty() {
-  local label="$1"
-  shift
-  local inventory
-
-  inventory="$(mktemp "${TMPDIR:-/tmp}/mosaic-test-find.XXXXXX")" || {
-    printf '[test] ERROR: %s inventory allocation failed\n' "$label" >&2
-    return 2
-  }
-
-  if ! find "$@" -print0 > "$inventory"; then
-    rm -f "$inventory"
-    printf '[test] ERROR: %s enumeration failed\n' "$label" >&2
-    return 2
-  fi
-
-  if [[ -s "$inventory" ]]; then
-    rm -f "$inventory"
-    printf '[test] FAIL: %s was not empty\n' "$label" >&2
-    return 1
-  fi
-
-  rm -f "$inventory"
-  return 0
-}
-
-# Usage: test_assert_no_file_content_match <label> <extended-regex> <find roots/options...>
-test_assert_no_file_content_match() {
-  local label="$1"
-  local pattern="$2"
-  shift 2
-  local inventory path grep_status result=0
-
-  inventory="$(mktemp "${TMPDIR:-/tmp}/mosaic-test-find.XXXXXX")" || {
-    printf '[test] ERROR: %s inventory allocation failed\n' "$label" >&2
-    return 2
-  }
-
-  if ! find "$@" -type f -print0 > "$inventory"; then
-    rm -f "$inventory"
-    printf '[test] ERROR: %s enumeration failed\n' "$label" >&2
-    return 2
-  fi
-
-  while IFS= read -r -d '' path; do
-    grep_status=0
-    grep -Eq -- "$pattern" "$path" || grep_status=$?
-    if [[ "$grep_status" -eq 0 ]]; then
-      result=1
-      break
-    fi
-    if [[ "$grep_status" -ne 1 ]]; then
-      result=2
-      break
-    fi
-  done < "$inventory"
-
-  rm -f "$inventory"
-  if [[ "$result" -eq 1 ]]; then
-    printf '[test] FAIL: %s contained a forbidden match\n' "$label" >&2
-    return 1
-  fi
-  if [[ "$result" -eq 2 ]]; then
-    printf '[test] ERROR: %s content inspection failed\n' "$label" >&2
-    return 2
-  fi
-  return 0
-}
@@ -1,20 +0,0 @@
-#!/usr/bin/env bash
-# Fetch, authenticate, and execute the exact downloaded installer body.
-set -euo pipefail
-url="${1:?usage: verified-installer-fetch.sh <url> <sha256> [-- installer-args...]}"
-expected="${2:?usage: verified-installer-fetch.sh <url> <sha256> [-- installer-args...]}"
-shift 2
-[[ "${1:-}" != -- ]] || shift
-[[ "$expected" =~ ^[0-9a-f]{64}$ ]] || { echo 'installer expected SHA-256 must be 64 lowercase hex characters' >&2; exit 2; }
-tmp="$(mktemp "${TMPDIR:-/tmp}/mosaic-installer-body.XXXXXX")"
-trap 'rm -f "$tmp"' EXIT
-chmod 0600 "$tmp"
-curl -fsSL "$url" -o "$tmp"
-[[ -s "$tmp" ]] || { echo 'installer fetch returned an empty HTTP-success body' >&2; exit 1; }
-actual="$(sha256sum "$tmp" | awk '{print $1}')"
-[[ "$actual" == "$expected" ]] || { echo "installer SHA-256 mismatch (got=$actual expected=$expected)" >&2; exit 1; }
-status=0
-bash "$tmp" "$@" || status=$?
-rm -f "$tmp"
-trap - EXIT
-exit "$status"
@@ -1,66 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-# shellcheck source=tools/test-enumeration-assertions.sh
-source "$ROOT/tools/test-enumeration-assertions.sh"
-TMP="$(mktemp -d "${TMPDIR:-/tmp}/mosaic-fetch-contract.XXXXXX")"
-trap 'rm -rf "$TMP"' EXIT
-FAKE_BIN="$TMP/bin"; mkdir -p "$FAKE_BIN"
-cat > "$FAKE_BIN/curl" <<'CURL'
-#!/usr/bin/env bash
-set -euo pipefail
-url=""; output=""
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -o) output="$2"; shift 2 ;;
-    -*) shift ;;
-    *) url="$1"; shift ;;
-  esac
-done
-emit() { if [[ -n "$output" ]]; then cat > "$output"; else cat; fi; }
-case "$url" in
-  fixture://ok)
-    emit <<'SCRIPT'
-#!/usr/bin/env bash
-set -euo pipefail
-printf 'executed:%s\n' "${1:-missing}"
-SCRIPT
-    ;;
-  fixture://empty) : > "$output" ;;
-  fixture://failed) exit 22 ;;
-  *) exit 2 ;;
-esac
-CURL
-chmod 0755 "$FAKE_BIN/curl"
-cat > "$TMP/ok.sh" <<'SCRIPT'
-#!/usr/bin/env bash
-set -euo pipefail
-printf 'executed:%s\n' "${1:-missing}"
-SCRIPT
-ok_sha="$(sha256sum "$TMP/ok.sh" | awk '{print $1}')"
-empty_sha="$(printf '' | sha256sum | awk '{print $1}')"
-
-mkdir -p "$TMP/downloads"
-output="$(TMPDIR="$TMP/downloads" PATH="$FAKE_BIN:$PATH" bash "$ROOT/tools/verified-installer-fetch.sh" fixture://ok "$ok_sha" -- marker)"
-[[ "$output" == 'executed:marker' ]]
-test_assert_find_empty 'verified-installer temporary downloads' "$TMP/downloads" -mindepth 1
-printf '[test] PASS: digest-pinned fetched artifact executes and its temporary body is removed\n'
-
-for row in 'fixture://empty empty-body' 'fixture://failed failed-fetch'; do
-  url="${row%% *}"; name="${row#* }"
-  set +e
-  PATH="$FAKE_BIN:$PATH" bash "$ROOT/tools/verified-installer-fetch.sh" "$url" "$empty_sha" -- marker \
-    >"$TMP/$name.log" 2>&1
-  status=$?
-  set -e
-  [[ "$status" -ne 0 ]] || { echo "[test] FAIL: $name certified success" >&2; exit 1; }
-done
-printf '[test] PASS: failed fetch and HTTP-200 empty body are both rejected\n'
-
-set +e
-PATH="$FAKE_BIN:$PATH" bash "$ROOT/tools/verified-installer-fetch.sh" fixture://ok "${ok_sha/0/1}" -- marker \
-  >"$TMP/mismatch.log" 2>&1
-status=$?
-set -e
-[[ "$status" -ne 0 ]] || { echo '[test] FAIL: digest mismatch was accepted' >&2; exit 1; }
-printf '[test] PASS: fetched installer digest mismatch is blocking\n'
@@ -1,142 +0,0 @@
-#!/usr/bin/env bash
-# Verify that the detector found exactly the pinned C1 phase verdicts. The
-# fixture is expected to exit non-zero; this verifier is the green CI contract.
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-MANIFEST="${MOSAIC_EXPECTED_RED_MANIFEST:-$ROOT/tools/fixtures/greenfield-expected-red.tsv}"
-CASE="${1:?usage: verify-greenfield-expected-red.sh <case> <log> <fixture-exit>}"
-LOG="${2:?usage: verify-greenfield-expected-red.sh <case> <log> <fixture-exit>}"
-FIXTURE_EXIT="${3:?usage: verify-greenfield-expected-red.sh <case> <log> <fixture-exit>}"
-
-[[ -r "$MANIFEST" ]] || { echo "expected-RED manifest is unreadable: $MANIFEST" >&2; exit 2; }
-[[ -r "$LOG" ]] || { echo "fixture log is unreadable: $LOG" >&2; exit 2; }
-[[ "$FIXTURE_EXIT" =~ ^[0-9]+$ ]] || { echo "fixture exit is not numeric: $FIXTURE_EXIT" >&2; exit 2; }
-
-# Validate the entire pinned contract before selecting one case. Otherwise a
-# deleted case/phase silently disappears from the gate and a one-row manifest
-# can certify any exit-1 transcript.
-expected_cases=(next-git-present main-git-present next-git-absent)
-declare -A allowed_case=(
-  [next-git-present]=1 [main-git-present]=1 [next-git-absent]=1
-)
-declare -A expected_requires=(
-  [next-git-present]=6 [main-git-present]=6 [next-git-absent]=4
-)
-declare -A row_count=() exit_count=() require_count=() forbid_count=() phase_count=() phase_reason_count=() unique_rows=()
-while IFS= read -r raw; do
-  [[ -n "$raw" && "${raw:0:1}" != "#" ]] || continue
-  field_count="$(awk -F '\t' '{print NF}' <<<"$raw")"
-  [[ "$field_count" -eq 3 ]] || { echo "invalid expected-RED manifest row (expected exactly 3 tab fields): $raw" >&2; exit 2; }
-  IFS=$'\t' read -r case_name kind expectation <<<"$raw"
-  [[ -n "${allowed_case[$case_name]:-}" ]] || { echo "invalid expected-RED manifest case: $case_name" >&2; exit 2; }
-  unique_key="$case_name|$kind|$expectation"
-  [[ -z "${unique_rows[$unique_key]:-}" ]] || { echo "duplicate expected-RED manifest row: $raw" >&2; exit 2; }
-  unique_rows[$unique_key]=1
-  row_count[$case_name]=$((${row_count[$case_name]:-0} + 1))
-  case "$kind" in
-    exit)
-      [[ "$expectation" == 1 ]] || { echo "invalid expected-RED exit contract: case=$case_name expected=$expectation" >&2; exit 2; }
-      exit_count[$case_name]=$((${exit_count[$case_name]:-0} + 1))
-      ;;
-    phase)
-      [[ "$expectation" =~ ^(P[0-9])=(PASS|FAIL)$ ]] \
-        || { echo "invalid expected-RED phase disposition: case=$case_name value=$expectation" >&2; exit 2; }
-      phase="${BASH_REMATCH[1]}"
-      phase_key="$case_name|$phase"
-      phase_count[$phase_key]=$((${phase_count[$phase_key]:-0} + 1))
-      ;;
-    phase-reason)
-      [[ "$expectation" =~ ^P0=(.+)$ ]] \
-        || { echo "invalid expected-RED phase reason: case=$case_name value=$expectation" >&2; exit 2; }
-      phase_reason_count[$case_name|P0]=$((${phase_reason_count[$case_name|P0]:-0} + 1))
-      ;;
-    require)
-      [[ -n "$expectation" ]] || { echo "empty expected-RED require row: case=$case_name" >&2; exit 2; }
-      require_count[$case_name]=$((${require_count[$case_name]:-0} + 1))
-      ;;
-    forbid)
-      [[ -n "$expectation" ]] || { echo "empty expected-RED forbid row: case=$case_name" >&2; exit 2; }
-      forbid_count[$case_name]=$((${forbid_count[$case_name]:-0} + 1))
-      ;;
-    *) echo "invalid expected-RED manifest kind: case=$case_name kind=$kind" >&2; exit 2 ;;
-  esac
-done < "$MANIFEST"
-
-for case_name in "${expected_cases[@]}"; do
-  [[ "${exit_count[$case_name]:-0}" -eq 1 ]] \
-    || { echo "expected-RED manifest requires exactly one exit row for case=$case_name" >&2; exit 2; }
-  for phase in P0 P1 P2 P3 P4 P5 P6 P7 P8 P9; do
-    [[ "${phase_count[$case_name|$phase]:-0}" -eq 1 ]] \
-      || { echo "expected-RED manifest requires exactly one $phase disposition for case=$case_name" >&2; exit 2; }
-  done
-  [[ "${phase_reason_count[$case_name|P0]:-0}" -eq 1 ]] \
-    || { echo "expected-RED manifest requires exactly one P0 reason binding for case=$case_name" >&2; exit 2; }
-  [[ "${require_count[$case_name]:-0}" -eq "${expected_requires[$case_name]}" ]] \
-    || { echo "expected-RED manifest require-row population changed for case=$case_name" >&2; exit 2; }
-  [[ "${forbid_count[$case_name]:-0}" -eq 1 ]] \
-    || { echo "expected-RED manifest requires exactly one forbid row for case=$case_name" >&2; exit 2; }
-  expected_total=$((1 + 10 + 1 + expected_requires[$case_name] + 1))
-  [[ "${row_count[$case_name]:-0}" -eq "$expected_total" ]] \
-    || { echo "expected-RED manifest row population changed for case=$case_name" >&2; exit 2; }
-done
-[[ -n "${allowed_case[$CASE]:-}" ]] || { echo "unknown expected-RED verification case: $CASE" >&2; exit 2; }
-
-checks=0
-failures=0
-while IFS=$'\t' read -r case_name kind expectation; do
-  [[ -n "$case_name" && "${case_name:0:1}" != "#" ]] || continue
-  [[ "$case_name" == "$CASE" ]] || continue
-  checks=$((checks + 1))
-  case "$kind" in
-    exit)
-      if [[ "$FIXTURE_EXIT" != "$expectation" ]]; then
-        echo "expected-RED mismatch: case=$CASE fixture_exit=$FIXTURE_EXIT expected=$expectation" >&2
-        failures=$((failures + 1))
-      fi
-      ;;
-    phase)
-      phase="${expectation%%=*}"
-      expected_verdict="${expectation#*=}"
-      last_row="$(grep -E "^\[$phase\] (PASS|FAIL):" "$LOG" | tail -n 1 || true)"
-      actual_verdict="$(printf '%s\n' "$last_row" | sed -n "s/^\[$phase\] \(PASS\|FAIL\):.*/\1/p")"
-      if [[ "$actual_verdict" != "$expected_verdict" ]]; then
-        echo "expected-RED mismatch: case=$CASE phase=$phase got=${actual_verdict:-missing} expected=$expected_verdict" >&2
-        failures=$((failures + 1))
-      fi
-      ;;
-    phase-reason)
-      phase="${expectation%%=*}"
-      expected_reason="${expectation#*=}"
-      last_row="$(grep -E "^\[$phase\] (PASS|FAIL):" "$LOG" | tail -n 1 || true)"
-      actual_reason="${last_row#*: }"
-      if [[ -z "$last_row" ]] || ! grep -Eq -- "^${expected_reason}$" <<<"$actual_reason"; then
-        echo "expected-RED phase reason mismatch: case=$CASE phase=$phase reason=${actual_reason:-missing}" >&2
-        failures=$((failures + 1))
-      fi
-      ;;
-    require)
-      if ! grep -Eq -- "$expectation" "$LOG"; then
-        echo "expected-RED missing required evidence: case=$CASE regex=$expectation" >&2
-        failures=$((failures + 1))
-      fi
-      ;;
-    forbid)
-      if grep -Eq -- "$expectation" "$LOG"; then
-        echo "expected-RED found forbidden evidence: case=$CASE regex=$expectation" >&2
-        failures=$((failures + 1))
-      fi
-      ;;
-    *)
-      echo "invalid expected-RED manifest kind: case=$case_name kind=$kind" >&2
-      exit 2
-      ;;
-  esac
-done < "$MANIFEST"
-
-[[ "$checks" -gt 0 ]] || { echo "expected-RED manifest has no checks for case=$CASE" >&2; exit 2; }
-if [[ "$failures" -ne 0 ]]; then
-  echo "expected-RED verification failed: case=$CASE failures=$failures checks=$checks" >&2
-  exit 1
-fi
-printf 'expected-RED verification passed: case=%s checks=%d\n' "$CASE" "$checks"
@@ -1,91 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-TMP="$(mktemp -d "${TMPDIR:-/tmp}/mosaic-expected-red-test.XXXXXX")"
-trap 'rm -rf "$TMP"' EXIT
-
-cat > "$TMP/match.log" <<'LOG'
-[fixture] resolved lane=next package=@mosaicstack/mosaic@next version=0.0.50-next.999
-[fixture] installer_exit=1 done_claims=0
-[SECRET-CONTROL] PASS: seeded canary absent from complete scan population
-[P0] PASS: target=mosaic uid=1001 HOME=/home/mosaic passwd_HOME=/home/mosaic shell=/bin/bash privilege=user arch=x86_64 libc=glibc node=v24.0.0 npm=10.6.2
-[P1] PASS: preflight complete
-[P2] PASS: pinned artifact
-[P3] PASS: absolute_path=/home/test/.npm-global/bin/mosaic version=0.0.50-next.999 equals resolved lane version
-[P4] FAIL: NOT-MEASURED / UNDECLARED: declaration absent
-[P5] FAIL: identity absent
-[P6] FAIL: runtime linking/activation action reported a required failure
-[P7] PASS: no services requested
-[P8] FAIL: shell path absent
-[P9] FAIL: aggregate refusal
-LOG
-
-bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 1 >/dev/null
-printf '[test] PASS: matching detector findings make the CI verifier green\n'
-
-sed 's/^\[P0\] PASS:.*/[P0] PASS: arbitrary unconditional success/' "$TMP/match.log" > "$TMP/vacuous-p0.log"
-if bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/vacuous-p0.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: vacuous P0 PASS satisfied the expected-RED contract without identity/context evidence' >&2
-  exit 1
-fi
-printf '[test] PASS: P0 PASS must bind target identity, HOME, shell, privilege, architecture, and runtime reason\n'
-
-sed 's/^\[P4\] FAIL:/[P4] PASS:/' "$TMP/match.log" > "$TMP/drift.log"
-if bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/drift.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: changed P4 verdict did not invalidate the pinned manifest' >&2
-  exit 1
-fi
-printf '[test] PASS: changed phase verdict requires a deliberate manifest update\n'
-
-if bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 0 >/dev/null 2>&1; then
-  echo '[test] FAIL: unexpected fixture exit did not invalidate the pinned manifest' >&2
-  exit 1
-fi
-printf '[test] PASS: unexpected fixture exit remains blocking\n'
-
-printf 'next-git-present\texit\t1\n' > "$TMP/shrunk.tsv"
-if MOSAIC_EXPECTED_RED_MANIFEST="$TMP/shrunk.tsv" \
-  bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: one-row manifest shrink still certified the detector' >&2
-  exit 1
-fi
-printf '[test] PASS: manifest shrink cannot delete the structural contract\n'
-
-manifest="$ROOT/tools/fixtures/greenfield-expected-red.tsv"
-grep -v $'^next-git-present\tphase\tP8=' "$manifest" > "$TMP/missing-phase.tsv"
-if MOSAIC_EXPECTED_RED_MANIFEST="$TMP/missing-phase.tsv" \
-  bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: missing P8 disposition was accepted' >&2; exit 1
-fi
-printf '[test] PASS: every case requires one P0-P9 disposition\n'
-
-grep -v $'^next-git-present\tphase-reason\tP0=' "$manifest" > "$TMP/missing-p0-reason.tsv"
-if MOSAIC_EXPECTED_RED_MANIFEST="$TMP/missing-p0-reason.tsv" \
-  bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: missing P0 reason binding was accepted' >&2; exit 1
-fi
-printf '[test] PASS: every case requires one discriminating P0 reason binding\n'
-
-cp "$manifest" "$TMP/duplicate.tsv"
-printf 'next-git-present\tphase\tP3=PASS\n' >> "$TMP/duplicate.tsv"
-if MOSAIC_EXPECTED_RED_MANIFEST="$TMP/duplicate.tsv" \
-  bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: duplicate phase key was accepted' >&2; exit 1
-fi
-printf '[test] PASS: duplicate structural keys are rejected\n'
-
-cp "$manifest" "$TMP/unknown-case.tsv"
-printf 'invented-case\texit\t1\n' >> "$TMP/unknown-case.tsv"
-if MOSAIC_EXPECTED_RED_MANIFEST="$TMP/unknown-case.tsv" \
-  bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: unknown case was accepted' >&2; exit 1
-fi
-printf '[test] PASS: unknown case rows are rejected\n'
-
-cp "$manifest" "$TMP/unknown-kind.tsv"
-printf 'next-git-present\toptional\tanything\n' >> "$TMP/unknown-kind.tsv"
-if MOSAIC_EXPECTED_RED_MANIFEST="$TMP/unknown-kind.tsv" \
-  bash "$ROOT/tools/verify-greenfield-expected-red.sh" next-git-present "$TMP/match.log" 1 >/dev/null 2>&1; then
-  echo '[test] FAIL: unknown row kind was accepted' >&2; exit 1
-fi
-printf '[test] PASS: unknown manifest kinds are rejected\n'
Author	SHA1	Message	Date
coder-mos1	e3d13d6dc1	test(fleet): make stale marker BusyBox-safe (#1043 ) ci/woodpecker/pr/ci Pipeline is running Details	2026-08-06 00:23:08 -05:00
be-coder-06	e0c00e4209	test(fleet): carry identity regression in CI (#1043 ) ci/woodpecker/pr/ci Pipeline failed Details	2026-08-05 23:52:44 -05:00
be-coder-06	ab360d443c	fix(fleet): propagate roster git identity (#1043 ) ci/woodpecker/pr/ci Pipeline was successful Details	2026-08-05 23:28:28 -05:00
				`@@ -1 +0,0 @@`
				`e59cb441a2f37ae9150f8eae470238e9d858a1816df93343d9784a6796676096 install.sh`