# Worker identity — Stage 1: what is running, and what it is doing *(Revision 1 was subtitled "and who asked for it". With `owner` removed that title overclaimed the lane: it answers **what**, and — under `pmacs.workers.dispatch` — **under which registered handler**. Neither is who owns it.)* **Status: framing pass, revision 3. Pre-implementation. Awaiting approval.** **Revision 3 closes a hole in revision 2's ambient: the extent it called "synchronous" is not.** A registered handler is arbitrary Lua and may `Handle:await()`, parking the coroutine with the name still pushed so that unrelated later work inherits it. Rule 1 now **enforces** non-yieldability rather than assuming it, following the guard this file already carries for `pmacs.window.commit_to`. Scouting that guard turned up a second yield point it does not cover — Q#W-7, a pre-existing defect in another lane's invariant, reported rather than patched in silence. **Revision 2 removes `owner` and respecifies the handler-name path, after review found the first dishonest and the second unbuildable as described.** `owner` populated from static per-subsystem constants is an *origin*, not an owner, and would misattribute third-party work at exactly the point §9 wants attribution. And "the name is in hand at the one place that throws it away" was **wrong about the call chain** — it is thrown away across three layers, one of which callers are documented to bypass. Both re-scouted in the tree. --- ## 1. Why this, and why now `COHERENCE.md` §9 grades the worker model **mechanism without identity**, and §0 names **step 11 (background-work ownership)** as one of the two remaining thin ends of the golden journey. §20 Priority 1 is blunt about where that leaves things: > **The remaining thin end is no longer inside this priority.** Step 1 > is install, which is **P8**; step 11 is background-work ownership, > which is §9. So this is the last of Priority 1's own journey, sitting in another section's arc. Everything else P1 named has landed. **The felt gap is smaller and sharper than the arc.** §9's audit ends with a claim that is checkable, and I checked it: > **No progress indicator exists anywhere** — no statusline spinner, no > busy count. `grep -c -i "spinner\|progress\|busy" src/statusline.rs` returns **0**. So §3's promise of "visible asynchronous work" is **false today** unless the user knows to run `M-x editor.list-workers`. Every build, LSP index, grep, parse and — as of the lane merging beside this one — every `git status` runs with no indication that anything is happening at all. **And the git Stage 1 lane in flight right now makes it worse, by its own admission.** `docs/git-integration-framing.md` Q#G-5 states it plainly: git runs as a spawned process, spawned processes do not appear in `*workers*`, and the lane therefore "adds a fifth thing that runs in the background and is not attributable from one place". It accepted that cost because these are short-lived reads. This lane is the one that repays it. ## 2. Ground truth Scouted in the tree, not recalled from the audit — and the audit has drifted in one place, recorded below. - **The audit's `PendingJob` field list is stale, and the drift is informative.** §9 lists seven fields; the struct (`src/async_runtime.rs:367-411`) carries **eight**. The addition is `resource: Option`, from dired Stage 2a — and **its doc comment cites `COHERENCE.md` §9 by name** as the reason it is a field on the job rather than a side map: > `COHERENCE.md` §9 is why this is a field on the job and not a side > map — the parse job→buffer link already lives in a side map and §9 > names that as the defect. So the precedent for putting identity **on the job** is already set, already argued, and already merged. This lane extends a decision rather than introducing one. - **There is a SINGLE allocation funnel, and that is what makes this tractable.** Every job in the system is born in `allocate` (`src/async_runtime.rs:746`), which delegates to `allocate_with_resource` (`:757`). The ten `dispatch_*` methods (`:803`–`:980`) and `register_external` (`:1011`, used by MCP and LSP) all pass through it. An identity field added there reaches every job by construction — there is no second birth site to miss. - **The two-function split is itself a warning.** `allocate_with_resource` exists only because one prior lane needed one extra parameter. A second lane doing the same produces `allocate_with_resource_and_identity`, and a third produces something worse. This is the point to collapse it (Q#W-1). - **`JobKind` is still a closed 12-variant enum** (`src/async_runtime.rs:305-343`) — Sleep, ComputeSum, EmitN, Grep, Parse, FsReadDir, FsStat, FsRename, FsChmod, FsRemove, McpRequest, LspRequest. Confirmed unchanged since the audit. - **A third-party job's own name is retained nowhere, and recovering it is NOT cheap. Revision 1 said it was, and was wrong about the call chain.** The full path, read rather than assumed: ``` pmacs.workers.dispatch(name, args, opts) -- async.lua:369 → handlers[name](args, opts) -- arbitrary Lua → dispatch_grep(spec, opts) -- Lua wrapper, :312 → async_mod._dispatch_grep(spec, supersede_key(opts), max_batch) → the Rust binding → allocate() ``` **`name` is not a parameter of any layer below the first.** The Rust dispatchers accept job arguments, a supersede key and stream data — nothing else. So revision 1's "change the allocation funnel and the name is recovered" is false: changing `allocate` gives the name nowhere to arrive *from*. **And the wrapper layer cannot be the capture point either.** `async.lua:337-345` deliberately exposes `pmacs.workers._new_handle` / `_new_stream` so that "other builtin runtime files (`pmacs.fs` in M8.1, future siblings) can construct handles for ids dispatched through **their own raw `_dispatch_*` primitives**". A handler that goes straight to `async_mod._dispatch_*` bypasses `dispatch_grep` and friends entirely — and those are precisely the callers doing non-standard work, i.e. the ones attribution is for. The audit's "every third-party job renders under a builtin's label" is exact. The mechanism that fixes it is Q#W-2, and it is a real mechanism, not a parameter. - **`ProcessSpec` has one identity field and it is a convention** (`src/process.rs:193-235`): `label: String`, documented as "human-readable ... surfaced in events and the `pmacs.process.list` output". No owner, no purpose, no parent. Callers spell it however they like (`lsp:{name}`, a terminal buffer name). - **A dynamic scope that must not be yielded out of ALREADY EXISTS here, guard and rationale included.** `Handle:await()` refuses to run inside `pmacs.window.commit_to` (`builtin/runtime/async.lua:87-90`), raising *"await: cannot await inside pmacs.window.commit_to; await first, then commit"*. Its comment states the hazard in general terms: yielding out of the extent "would restore the scope while this coroutine is still parked, so the rest of the commit would resume ambient". `commit_to` itself is "an RAII guard on the Rust stack" — the same shape this lane needs. - **There are TWO yield points, not one.** `Handle:await()` yields at `async.lua:95`; **`pmacs.async.yield_to_next_tick()` yields at `async.lua:244`** and is public (`pmacs.async` is `async_public`, `:247`). Any rule about a non-yieldable extent has to cover both. The `commit_to` guard covers only the first — see Q#W-7. And the two findings that actually shape the design: - **A statusline provider API already exists, with three Lua adopters.** `pmacs.statusline.register` is live in `terminal.lua:477`, `syntax.lua:551` and `lsp.lua:1145`, taking `{ name, side, priority, face, fn(ctx) }` and returning a string or `nil`. An activity indicator is a **fourth registration**, not a new mechanism. **And it is evaluated per frame**: `evaluate_statusline` is called inside `paint_frame` (`src/editor.rs:4560`), before the long mutable core borrow. So an indicator updates while work is in flight without any new tick machinery — and, decisively for scheduling, **without touching the wire**. `EvaluatedStatuslineSegment` is already `Vec`-valued on an existing message; a fourth provider adds an element, not a variant. - **`pmacs.process.list` deliberately hides terminal PTYs, and un-hiding them is NOT free.** The binding filters to `AnsiParserProfile::LineOriented` (`src/lua_bindings/mod.rs:8980-8984`). `git log -S` dates that filter to `bbc1f33 feat(vterm): add Stage 1 terminal core` — terminals were excluded on purpose. **Three acceptance suites use `#pmacs.process.list()` as a leak detector**: `tests/m6_8_multi_repl_acceptance.rs:385`/`:459` ("size must not grow across cycles"), `tests/compile_mode_acceptance.rs:133`/ `:458` ("process list returns to baseline"), and `tests/lean4_stage1_acceptance.rs:327`/`:349`. **Removing the filter would inflate every one of those baselines by each open terminal.** This is why §9's "a terminal PTY appears in no user-visible activity view" is a real defect with a **non-obvious fix**, and why this lane does not casually widen the existing accessor (Q#W-4). ## 3. The staging, and why the line falls where it does §9's full statement wants owner, workspace, buffer, parent, children, latency class, cancellation scope, resource budget, execution location, progress, and failure attribution. **Two of those cannot be built at all right now**: `Workspace` is §7, graded *missing*, and `Location` is §8, graded *missing (architecture ready)*. A lane that added `workspace: Option` would be adding a field typed on a thing that does not exist. **Stage 1 (this lane): a required `purpose` on the job and the process, and the first indicator. NO WIRE CHANGE. NO `owner`.** - **`purpose`, non-optional**, on `PendingJob`, carried through the single allocation funnel, and on `ProcessSpec` alongside the existing `label`. - **A dispatch-identity ambient** so `pmacs.workers.dispatch` stops discarding the registered handler name (Q#W-2). - `*workers*` renders `purpose`. - **A statusline activity indicator** — the fourth provider registration, and the part a user feels on day one. **`owner` is deliberately absent, and revision 1 was wrong to include it.** The proposal was `owner = "lsp"` populated from a static per-subsystem constant at each dispatcher. But a generic dispatcher has no trustworthy knowledge of who invoked it, and `pmacs.process.spawn` is callable by any package — so a static subsystem label is an **origin or category, not an owner**, and it would confidently misattribute third-party work to a builtin at exactly the point §9 wants attribution. A field that asserts a falsehood is worse than an absent one: `*workers*` would *look* attributed while naming the wrong party. **Nor is it retained under a safer name.** Calling it `origin` or `subsystem` would be honest, but a second string field sitting beside `purpose` and grouping the view would be *adopted* as ownership by the next reader regardless of its name — and it would squat on the slot P3's real package signal has to fill. Stage 2 needs a grouping key; it should get a real one, not a placeholder promoted by use. **Stage 2 (separate lane): join the planes.** One activity view over jobs, processes, LSP servers and terminals. This is what Stage 1's identity is *for* — the audit's own conclusion is that "the four views exist precisely because there is no common key to merge them on". It also owns the terminal-visibility decision (Q#W-4), because that is a question about the unified view, not about the accessor. **Stage 3 (unscheduled): the tree and scoped cancellation.** `parent`/`children`, and cancel-by-owner / by-buffer / by-subtree. This needs an ambient "currently-running job" context so a child dispatched inside a job can find its parent without every call site threading it — a real mechanism with its own failure modes, and the reason parent is **not** in Stage 1 (Q#W-5). **Workspace and location are never this arc's**, at any stage. They arrive from §7 and §8 and this arc consumes them. **The line falls at the wire on purpose, and it is again a scheduling decision.** The discovery Stage 2 lane holds the v22→v23 bump slot, and git Stage 2 is already queued behind it. `PROTOCOL_VERSION` is a strict serialization point. Stage 1 here touching no wire is what lets it run beside both. ## 4. Coherence impact (§20) - **§9 worker ownership — the direct target**, and specifically the audit's named prerequisite: *"Owner/purpose/parent fields on the job and process specs are the prerequisite; the unified view and the ownership tree fall out of them."* **Stage 1 takes ONE of the three — `purpose`.** `owner` waits for P3 to supply a package signal worth recording (§3); `parent` waits for Stage 3 (Q#W-5). Taking one of three named prerequisites is a deviation from the audit, and it is stated here rather than left to be noticed. - **Journey step 11 — the direct target.** §0 names background-work ownership as one of two remaining thin ends. This does not close the step (Stage 2's unified view is most of that) but it is the first thing that makes work *visible*, which is what step 11 is about. - **§3 zero-configuration state:** repairs a claim that is currently false. "Visible asynchronous work" becomes true by default, with no configuration and no command to know about. - **Interaction islands (§6): none added.** The indicator is a statusline provider; it intercepts no keys and adds no precedence rung. - **§14 workbench primitives: untouched.** `*workers*` already exists; this changes what it renders, not what renders it. - **Config registry:** one setting at most, and my vote is a *visibility* toggle only (Q#W-6). - **The debt this repays is named and dated.** `git-integration-framing.md` Q#G-5 recorded a deliberate negative §9 impact. This lane does not fully discharge it — a labelled process is still not in `*workers*` until Stage 2 — but it makes the process state *what it is doing* in a required field rather than a caller-spelled convention. - **No P3 alignment is claimed.** Revision 1 argued this lane aligned with P3's ownership arc. With `owner` removed, it does not: P3 stays entirely ahead of it, and this lane deliberately leaves that slot empty rather than filling it with something P3 would have to displace. ## 5. Open questions ### Q#W-1 — how is identity supplied at the allocation funnel? The existing shape is `allocate(kind, supersede, stream)` delegating to `allocate_with_resource(kind, supersede, stream, resource)`. Adding two more positional parameters gives a five-argument function and a six-argument variant, and the next lane adds a seventh. *My vote: **collapse the pair into one funnel taking a struct***, e.g. `allocate(JobSpec { kind, supersede, stream, resource, purpose })`, so the ten dispatchers read as named-field literals rather than positional soup. Ten call sites plus `register_external` is a bounded, mechanical edit, and it removes the `_with_resource` wart rather than adding beside it. **`JobSpec` is private, and `purpose` is non-optional.** Private because the public dispatcher APIs should not grow a parameter every time this arc adds a field; non-optional because that is what makes the compiler, rather than a test, the thing that proves every caller supplied one (§6). A `Default` impl would defeat exactly that, so `purpose` is not defaulted even if other fields are. **The counter-argument, which is real:** this touches every dispatcher in a lane whose subject is identity, which is scope the reviewer did not ask for. **If review prefers the minimal edit**, the alternative is one more parameter on the existing pair, and the collapse becomes its own small lane. I would rather be told than assume. ### Q#W-2 — the dispatch identity path **(rewritten in rev 2, rule 1 added in rev 3)** Revision 1 treated this as a parameter-passing detail. §2 shows it is not: `name` dies at `pmacs.workers.dispatch` and nothing below it takes a name, so the value must be carried *out of band* across an arbitrary handler. **Revision 2 then called the extent "synchronous" and assumed it. Review found that it is not.** A registered handler is arbitrary Lua running inside `pmacs.async`, and it may call `Handle:await()` — a legal, yieldable path that the existing tests already exercise inside `pcall`. While a handler is parked, its pushed name **stays on the stack**, and every tick callback and every other coroutine that allocates a job in the meantime inherits it. That is not a corner case; it is the ordinary shape of a handler that awaits. So rule 1 below is no longer an observation about how handlers happen to behave. It is an **enforced** property, and the enforcement already has a precedent in this exact file (§2a). **The capture point is Rust, not Lua**, and the reason is the bypass in §2. If the ambient lived in the Lua wrapper layer, a handler calling `async_mod._dispatch_*` directly — the documented pattern for runtime files with their own primitives — would produce an unattributed job, and those are the callers attribution exists for. Putting it in the runtime means it is read at `allocate`, **the same single funnel Q#W-1 is already collapsing**. One mechanism, one site, no path around it. *My vote: **a dispatch-name stack owned by the async runtime***, with `pmacs.workers.dispatch` bracketing its handler call through two runtime-internal bindings (`_push_dispatch_name` / `_pop_dispatch_name`). **The contract, in full:** 1. **THE EXTENT IS NON-YIELDABLE, AND THAT IS ENFORCED, NOT ASSUMED.** Awaiting inside a dispatch-name scope is **refused**, because yielding would park the coroutine with the name still pushed and hand it to whatever allocates next. The guard is modelled on the one already in the file (§2): `_in_dispatch_name_scope()` joins `_in_commit_scope()` as a refusal in the same place, with the same shape of message and the same remedy — **await first, then dispatch**. Three details that decide whether the guard actually holds: - **It rejects BEFORE parking.** The `commit_to` guard is the first thing in `await`, ahead of the `_is_complete` check and the `coroutine.yield`. The new one sits beside it, for the same reason: a guard that fires after the yield has already happened guards nothing. - **It rejects UNCONDITIONALLY, not only when the handle is incomplete.** A guard that fires only when a yield would really occur has behaviour depending on whether the job happened to finish first — it would pass under test and fail in production, intermittently. `commit_to`'s guard is unconditional and this one matches it. - **`await` is NOT the only yield point.** `pmacs.async.yield_to_next_tick()` (`async.lua:243-245`) yields too, and is public. It gets the same refusal. Guarding only `await` would leave the hole open through a second door — see Q#W-7, because the existing `commit_to` guard has exactly that gap today. 2. **Work dispatched later is NOT covered, deliberately.** A job dispatched from an `on_complete` callback or a resumed coroutine runs ticks later, outside the extent, and carries only its own `purpose`. Pretending otherwise would need the asynchronous lifetime mechanism this lane defers (Q#W-5). 3. **Nesting is a stack; innermost wins.** Handler `a` calling `pmacs.workers.dispatch("b", …)` gives jobs allocated inside `b` the name `b`, and restores `a` on return. 4. **Fan-out shares the name.** A handler dispatching five jobs produces five jobs named alike. They *were* all dispatched under it; that is the fact being recorded, not a collision. 5. **Unwind-safe, and this is the one that makes a naive version worse than none.** A handler that errors must still pop — otherwise one failure poisons every subsequent dispatch in the session with a stale name, and the feature silently starts lying. `pmacs.workers. dispatch` runs the handler under `pcall`, pops, and rethrows. 6. **Precedence over a caller-supplied purpose: COMPOSE, do not replace.** Where the dispatch site supplied its own purpose, the recorded value is `": "`; where it did not, the recorded value is `""`. Replacing would recreate blocker 1 in a new place — `dispatch_grep` supplies `"grep: …"`, and letting that win would lose the third party again, while letting the name win would discard the only description of the actual work. Composition is capped at the innermost name by rule 3, so no unbounded chain. 7. **Outside any extent, nothing changes.** A builtin invoked directly records its own `purpose`. **A known and accepted property, stated rather than discovered later:** the ambient captures *causal* extent, not *intent*. If a handler triggers unrelated work within its extent — an edit that schedules a parse — that job takes the name. Because rule 1 makes the extent non-yieldable, that window is bounded by a single un-parked call, and within such a window I think "this ran because that handler ran" is the honest reading. It is also the only definition enforceable at a single funnel. **If review disagrees, the alternative is capture-at-the-Lua-wrapper**, which is narrower and misses the raw `_dispatch_*` callers — a trade of false positives for false negatives, and I would rather over-attribute inside a bounded call than silently drop the third-party case. **Why this ambient is admissible while Q#W-5's is not.** They are not the same mechanism — **and revision 2 was entitled to that claim only after rule 1 made it true.** As written in revision 2 the extent could be parked by any awaiting handler, which is most of the way to the asynchronous lifetime I used as the reason for deferring `parent`. With rule 1 the difference is real and enforced: this is a single-threaded dynamic extent that **cannot** be suspended, with a deterministic pop on both the normal and the error path. A `parent` ambient must span a job's asynchronous lifetime by design — across ticks, through callbacks that run after the parent settled — and cannot be fixed by refusing to yield, because yielding is the whole point. The first is a stack; the second is a lifetime model. ### Q#W-3 — what does the indicator actually show? *My vote: **a count plus the oldest in-flight job's `purpose`, and nothing when idle*** — e.g. `⋯2 lsp: indexing`, absent entirely at zero. With `owner` gone (§3) `purpose` is the only identity there is, which is also why it is required rather than optional. **Oldest, not newest or "busiest".** Revision 1 said "busiest", which is not a defined quantity — jobs carry no cost estimate. Oldest is computable from `dispatched_at`, which `PendingJob` already has, and it answers the question a user actually asks of a stuck editor: *what is taking so long?* - **Absent at zero, not `0 jobs`.** A statusline segment that is always present costs width forever to say "nothing is happening". The existing providers already return `nil` to render nothing (`lsp.lua:1156`), so this is the established idiom. - **A count, not a spinner.** A spinner needs an animation frame clock and says only "something"; a count says how much. Per-frame evaluation makes either possible, so this is a product choice, not a constraint. - **Not names plural.** One purpose keeps it to a bounded width; the full list is what `*workers*` is for. ### Q#W-4 — do terminal PTYs become visible in Stage 1? **No — and the reason is evidence, not caution.** `pmacs.process.list` filters to `LineOriented`, and three acceptance suites assert on `#pmacs.process.list()` as a leak baseline (§2). Widening that accessor would inflate all three with every open terminal, and "fix the tests" is the wrong response to a test that is correctly detecting a semantic change. *My vote: **leave the accessor alone in Stage 1**, and let Stage 2's unified view introduce a **separate** enumeration that includes PTYs.* The leak detectors keep asserting what they were written to assert; the new surface answers the new question. Two accessors with different contracts is better than one accessor whose meaning silently changed under its existing callers. ### Q#W-5 — does `parent` belong in Stage 1? *My vote: **no.*** The audit names owner/purpose/**parent** together as the prerequisite, and after revision 2 this lane takes only `purpose` — so both omissions need justifying, not just this one. `owner`'s is in §3; `parent`'s is here. `purpose` is a **value the dispatcher already knows** at the call site. A parent is not — it is whatever job is *currently running* when a child is dispatched. A `parent` field that nothing populates is worse than no field: it renders as `None` everywhere and reads as "this job has no parent" rather than "this system does not track parents". **And the objection this has to answer, since the lane now builds an ambient of its own (Q#W-2):** why is one admissible and not the other? Because Q#W-2's extent **cannot be suspended** — rule 1 refuses both yield points, so it is bounded by one un-parked call with a deterministic pop on the normal and the error path. **That distinction is only load-bearing because rule 1 exists.** Revision 2 asserted this same paragraph while its ambient *could* be parked by any awaiting handler, which made the two mechanisms far more alike than the argument admitted. The honest version: a `parent` ambient must identify the running job *across ticks* — a job dispatched from an `on_complete` callback should name the job whose completion fired it, and that callback runs after the parent settled, outside any dispatch call. Refusing to yield cannot rescue it, because yielding is the mechanism it needs. That is a lifetime model, not a stack, and it is Stage 3's subject rather than a field this lane can add cheaply. Stage 3 builds the lifetime model and the field together, where the field can be tested by a populated case. ### Q#W-7 — the same hole exists in `commit_to` today **(new in rev 3)** Found while scouting rule 1, and reported rather than quietly patched. `Handle:await()` refuses to run inside `pmacs.window.commit_to` (`async.lua:87-90`) precisely so a coroutine cannot park with the frontend scope pushed. **But `pmacs.async.yield_to_next_tick()` (`async.lua:243-245`) also yields, is public, and carries no such refusal.** A coroutine inside `commit_to` can therefore park through that door and produce exactly the misrouting the `await` guard exists to prevent. Journey Stage 1a's Q#JR14b invariant has a second entrance. I have **not** verified that a real caller does this — the reachability of the bug is unproven, and I would rather say so than dress a code-reading up as a repro. *My vote: **fix it in this lane, in the same commit as rule 1.*** It is one refusal in a function this lane is already editing, in the same family, for the same reason. The alternative — ship a document that explains the hazard in detail, add the guard for the new scope, and leave the identical gap open beside it — is how a codebase teaches its next reader that the rule is optional. **But it is another lane's invariant**, so it is a question rather than an assumption. If review prefers it separate, it should be its own small lane *before* this one, and this framing should say so; what it should not be is discovered a third time. ### Q#W-6 — is any of this configurable? *My vote: **one boolean, `ui.activity-indicator` (default `true`), through `pmacs.config.define`.*** §11 grades the registry "partial (foundation only)" and this document's sibling framings have both resisted speculative settings — but a permanently-visible statusline element is different in kind from an internal behaviour: it costs width on every frame, and "I do not want this in my modeline" is a preference someone will genuinely hold on day one rather than a hypothetical. `git.enabled` and `ui.line-wrap` are the precedent shape. No setting for `purpose` capture itself — that is substrate, not preference. ## 6. Verification - **Presence is enforced by the COMPILER, not by a test.** `purpose` is non-optional in `JobSpec`, so a dispatcher that supplies none does not build. Revision 1 claimed a single funnel assertion proved "every job carries an identity"; **it does not** — a funnel test proves the funnel stores what it was handed, and says nothing about whether fourteen callers handed it anything meaningful. Presence is a type obligation; the tests below are for *semantics*. - **Representative entry paths assert the semantics**, one per distinct shape rather than one per dispatcher: a pool dispatcher, an `register_external` job (MCP/LSP bypass the worker pool entirely and are the likeliest to be missed), and a spawned process. - **A `pmacs.workers.dispatch("name", …)` job reports `"name"`**, and the witness is **a handler registered from Lua that calls a real dispatcher** — not a synthetic funnel test. A test that pushes the ambient by hand proves the stack works and leaves the actual defect (`name` dying in an arbitrary handler) unwitnessed. - **Awaiting inside a handler is REFUSED, and the scope restores after the refusal** (Q#W-2 rule 1). Two assertions, and the second is the load-bearing one: a guard that raises but leaves the name pushed has converted a silent misattribution into a silent misattribution plus an error. The witness dispatches again after the rejection and asserts the new job carries **no** stale name. - **`pmacs.async.yield_to_next_tick()` inside a handler is refused too**, with the same restore-after assertion. Guarding one yield point and not the other leaves the hole open through a second door (§2). - **The refusal fires even when the awaited handle is already complete** (rule 1) — the case that separates an unconditional guard from one whose behaviour depends on a race. - **The ambient survives a failing handler** (Q#W-2 rule 5): a handler that errors, then a subsequent unrelated dispatch, asserting the second job does **not** carry the first's name. This is the regression that would otherwise appear as intermittent misattribution long after the lane lands. - **Nesting and fan-out** (rules 3–4): a handler dispatching two jobs gives both its name; a handler dispatching through another registered handler gives the inner jobs the inner name and restores the outer. - **Composition, not replacement** (rule 6): a handler calling a dispatcher that supplies its own purpose yields `": "` — asserted for both halves, since a test on the prefix alone passes when the description is dropped. - **Work dispatched from an `on_complete` callback carries no handler name** (rule 2) — the boundary of the extent, asserted deliberately so it reads as designed rather than broken. - **The statusline shows nothing at idle**, asserted as *absent segment*, not as empty string — a zero-width segment still consumes a separator. - **The statusline shows a count while work is in flight**, witnessed through the real per-frame evaluation path (`paint_frame`), not by calling the provider function directly. A provider that works in isolation and never gets evaluated is the failure this must exclude. - **The indicator honours `ui.activity-indicator = false`** (Q#W-6), witnessed as an absent segment with work genuinely in flight — the case that separates "disabled" from "idle". - **`#pmacs.process.list()` is UNCHANGED for every existing caller** (Q#W-4). The three leak-detector suites (`m6_8_multi_repl_acceptance`, `compile_mode_acceptance`, `lean4_stage1_acceptance`) are the assertion, and they must pass untouched. **If any of them needs editing, the design is wrong**, and that is the signal to stop rather than to adjust a baseline. - **A spawned process carries a required `purpose` alongside its existing `label`**, and **`label`'s current callers keep working unchanged** — `lsp:{name}` and terminal buffer names are live conventions with existing consumers. - **Both frontends render the segment**, since it rides the existing `StatuslineSegments` path — asserted for the grid TUI and `pmacs-gpu`, because "it is on an existing message" is a claim about the producer and says nothing about whether a consumer draws it. **What this will NOT prove:** that background work is attributable from one place (that is Stage 2's unified view — this lane makes it *possible*, not *done*), that a terminal PTY is visible anywhere (Q#W-4), that cancellation can range over an owner (Stage 3), or **that any job is attributed to the PACKAGE responsible for it** — `purpose` records what work is being done and, under `pmacs.workers.dispatch`, which registered handler it ran under. Neither is package ownership, which waits for P3 (§3). Gates via `scripts/gate --acceptance `. **No `--protocol`**: this lane has no wire change, which is the property that lets it run beside the two lanes already in flight. ## 7. Not in scope **`owner`, in any spelling** — including `origin` or `subsystem` (§3). The slot stays empty until P3 can fill it with a package signal; nothing in this lane may be promoted into it later by use. `Workspace` and `Location` fields (§7/§8 — the entities do not exist). `parent`/`children` and the ownership tree (Stage 3, Q#W-5). Scoped cancellation of any kind — cancel-all, by-kind, by-buffer, by-owner, by-subtree (Stage 3; there is nothing to range over until identity exists). The unified activity view joining the four planes (Stage 2). Making terminal PTYs visible (Stage 2, Q#W-4). Widening `JobKind` or making it open — third-party jobs are described by `purpose`, which is the point, and reopening a closed wire-adjacent enum is a separate decision. Latency classes and resource budgets (§9 names them; neither has a consumer yet). Supersession coverage — §9 notes parse jobs and MCP requests pass `None`, which is a real defect and a **different** one. P3's package-ownership signal — §3 defers `owner` to it and makes no claim of alignment with it.