@passioncode-ai/passioncode 0.2.42 → 0.2.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/family.json +1 -1
  3. package/package.json +1 -1
  4. package/payload/.claude-plugin/marketplace.json +2 -2
  5. package/payload/manifest.json +8 -8
  6. package/payload/plugins/fabric-agent-adapter/.claude-plugin/plugin.json +1 -1
  7. package/payload/plugins/fabric-agent-adapter/hooks/hooks.json +1 -1
  8. package/payload/plugins/fabric-agent-adapter/skills/adapting-projects-to-fabric/SKILL.md +1 -1
  9. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/SKILL.md +7 -3
  10. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/references/board.md +82 -11
  11. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/references/interop.md +2 -1
  12. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/references/lifecycle.md +1 -1
  13. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/fabric-board-link.mjs +33 -3
  14. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/fabric-board-session.mjs +146 -7
  15. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/fabric_board_link.py +34 -3
  16. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/fabric_board_session.py +149 -45
  17. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/kit.json +181 -5
  18. package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/sample_service.py +13 -1
  19. package/payload/plugins/fabric-agent-adapter/skills/creating-fabric-agents/SKILL.md +1 -1
  20. package/payload/plugins/fabric-agent-adapter/skills/working-with-fabric/SKILL.md +15 -10
  21. package/payload/plugins/fabric-agent-adapter/skills/working-with-fabric/references/project-board.md +4 -1
  22. package/payload/plugins/fabric-agent-adapter/skills/working-with-fabric/references/session-hooks.md +38 -9
  23. package/payload/plugins/fabric-agent-adapter/skills/working-with-fabric/scripts/fabric_session.py +11 -0
  24. package/payload/plugins/fabric-agent-adapter/skills/working-with-fabric/scripts/fabric_session_cli.py +12 -3
  25. package/payload/plugins/fabric-agent-adapter/skills/working-with-fabric/scripts/fabric_session_env.py +11 -1
  26. package/payload/plugins/fabric-agent-adapter/skills/working-with-fabric/scripts/fabric_session_mcp.py +358 -14
  27. package/payload/plugins/passioncode/.claude-plugin/plugin.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.43 - 2026-10-27
4
+
5
+ ### Changed
6
+
7
+ - **Fabric Agent Adapter is pinned at `v0.53.1`** (it was `v0.52.0`): working-with-fabric's Stop hook names the other
8
+ repositories a turn touched once Fabric takes them (never on Windows), a board responder stops when the operator
9
+ moves its slot, and Step 4 reads Fabric 0.3.14's answer when a piece is filed. `v0.53.0` was never released. Notes
10
+ are in the adapter's CHANGELOG.
11
+
3
12
  ## 0.2.42 - 2026-10-26
4
13
 
5
14
  ### Changed
package/family.json CHANGED
@@ -8,7 +8,7 @@
8
8
  "name": "fabric-agent-adapter",
9
9
  "displayName": "Fabric Agent Adapter",
10
10
  "repo": "passioncode-ai/fabric-agent-adapter",
11
- "ref": "v0.52.0",
11
+ "ref": "v0.53.1",
12
12
  "kind": "plugin",
13
13
  "path": "plugins/fabric-agent-adapter",
14
14
  "legacyPluginIds": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@passioncode-ai/passioncode",
3
- "version": "0.2.42",
3
+ "version": "0.2.43",
4
4
  "description": "Set up PassionCode.ai on a computer with one command — the apps from their verified releases, their MCP servers for every coding agent and the PassionCode.ai skills — and check and repair it with the same command or `doctor`.",
5
5
  "bin": {
6
6
  "passioncode": "bin/passioncode.js"
@@ -11,7 +11,7 @@
11
11
  "name": "fabric-agent-adapter",
12
12
  "displayName": "Fabric Agent Adapter",
13
13
  "source": "./plugins/fabric-agent-adapter",
14
- "version": "0.52.0",
14
+ "version": "0.53.1",
15
15
  "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles; and teach a coding agent to work in a project through Fabric (fabric-mcp, fabric_whoami, claim and release), with Claude Code session hooks.",
16
16
  "author": {
17
17
  "name": "PassionCode.ai",
@@ -35,7 +35,7 @@
35
35
  "name": "passioncode",
36
36
  "displayName": "PassionCode.ai",
37
37
  "source": "./plugins/passioncode",
38
- "version": "0.2.42",
38
+ "version": "0.2.43",
39
39
  "description": "Set up and check PassionCode.ai on a computer with one command (setting-up-passioncode), the organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
40
40
  "author": {
41
41
  "name": "PassionCode.ai",
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "family": "passioncode",
3
- "version": "0.2.42",
3
+ "version": "0.2.43",
4
4
  "release": true,
5
5
  "members": [
6
6
  {
7
7
  "name": "fabric-agent-adapter",
8
8
  "displayName": "Fabric Agent Adapter",
9
9
  "repo": "passioncode-ai/fabric-agent-adapter",
10
- "ref": "v0.52.0",
11
- "commit": "25383f4058c70d365fb5903b0ed8cde218cbe385",
12
- "version": "0.52.0",
10
+ "ref": "v0.53.1",
11
+ "commit": "e000c21642bf97b60b06eff0037053abc8e6ab3b",
12
+ "version": "0.53.1",
13
13
  "via": "clone of https://***@github.com/passioncode-ai/fabric-agent-adapter.git",
14
14
  "skills": [
15
15
  "adapting-projects-to-fabric",
@@ -23,7 +23,7 @@
23
23
  "legacyMarketplaces": [
24
24
  "fabric-agent-adapter"
25
25
  ],
26
- "contentHash": "sha256:b76014070bb894c2ab421cc774ebc1401e20815908080d932fa36a92c4f16c63",
26
+ "contentHash": "sha256:ee61e19829b4d7d78eb2928bb9d0a000efc03562e2abccb7ee408cfd3f18ca65",
27
27
  "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles; and teach a coding agent to work in a project through Fabric (fabric-mcp, fabric_whoami, claim and release), with Claude Code session hooks.",
28
28
  "author": {
29
29
  "name": "PassionCode.ai",
@@ -62,9 +62,9 @@
62
62
  "name": "passioncode",
63
63
  "displayName": "PassionCode.ai",
64
64
  "repo": "passioncode-ai/passioncode",
65
- "ref": "v0.2.42",
65
+ "ref": "v0.2.43",
66
66
  "commit": null,
67
- "version": "0.2.42",
67
+ "version": "0.2.43",
68
68
  "via": "this repository",
69
69
  "skills": [
70
70
  "setting-up-passioncode",
@@ -72,7 +72,7 @@
72
72
  ],
73
73
  "legacyPluginIds": [],
74
74
  "legacyMarketplaces": [],
75
- "contentHash": "sha256:0265b4cf8965eace837779cc775f1a8c594463cf923e1acb58961190267ccc76",
75
+ "contentHash": "sha256:175685fc4f5d6e92164bd883d9f774172cf9b184429f1fe7418e984165035cfd",
76
76
  "description": "Set up and check PassionCode.ai on a computer with one command (setting-up-passioncode), the organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
77
77
  "author": {
78
78
  "name": "PassionCode.ai",
@@ -3,7 +3,7 @@
3
3
  "name": "fabric-agent-adapter",
4
4
  "displayName": "Fabric Agent Adapter",
5
5
  "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles; and teach a coding agent to work in a project through Fabric (fabric-mcp, fabric_whoami, claim and release), with Claude Code session hooks.",
6
- "version": "0.52.0",
6
+ "version": "0.53.1",
7
7
  "author": {
8
8
  "name": "PassionCode.ai",
9
9
  "url": "https://passioncode.ai/"
@@ -1,5 +1,5 @@
1
1
  {
2
- "description": "Two silent-unless-relevant hook sets. The dashboard-kit notice: one line at session start or /clear in a repository that owns a Fabric service whose dashboard has no kit or an older one (fabric-dashboard/0.1, DEC-0036), phrased as an upgrade the agent may make itself. The Fabric session hooks (working-with-fabric, COM-04, FAA-12a): at session start or /clear, the preamble when Claude Code has the MCP server `fabric` and Fabric runs (fabric_whoami, then the project board through com.status and com.list, claim and release); when Fabric is down, one line, only in a project that uses Fabric (a Fabric contract file, a project-bound registration or a service descriptor naming the repository); nothing on compact or resume; each turn's facts (HEAD, files changed, lines added and removed, never content), the board's unread count and the session's end through Fabric, only when the running Fabric advertises session-hooks/1; at each prompt one line only when the unread count rose, then each nudge a turn's answer carried, once (watch-mail prints those of turns it delivered). All silent in a session Fabric launched. Every hook reads no token, prints at most one block, always exits 0, and hands any Fabric call to a detached worker with a 10 s deadline.",
2
+ "description": "Two silent-unless-relevant hook sets. The dashboard-kit notice: one line at session start or /clear in a repository that owns a Fabric service whose dashboard has no kit or an older one (fabric-dashboard/0.1, DEC-0036), phrased as an upgrade the agent may make itself. The Fabric session hooks (working-with-fabric, COM-04, FAA-12a): at session start or /clear, the preamble when Claude Code has the MCP server `fabric` and Fabric runs (fabric_whoami, then the project board through com.status and com.list, claim and release); when Fabric is down, one line, only in a project that uses Fabric (a Fabric contract file, a project-bound registration or a service descriptor naming the repository); nothing on compact or resume; each turn's facts (HEAD, files changed, lines added and removed, never content), the board's unread count, and, once the running Fabric's fabric_session_observe takes them (never on Windows), the other repositories the turn touched (the last 512 KB of the session transcript, message text and tool output included (a secret the session displayed can be there; read in memory only), is then read and only the current turn's tool names and path arguments are used; host/owner/name leave the machine, never a local path or text) and the session's end through Fabric, only when the running Fabric advertises session-hooks/1; at each prompt one line only when the unread count rose, then each nudge a turn's answer carried, once (watch-mail prints those of turns it delivered). All silent in a session Fabric launched. Every hook reads no Fabric token (a credential embedded in an origin URL is read by git config and dropped in memory, never spooled or sent), prints at most one block, always exits 0, and hands any Fabric call to a detached worker with a 10 s deadline.",
3
3
  "hooks": {
4
4
  "SessionStart": [
5
5
  {
@@ -5,7 +5,7 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
5
5
  compatibility: Requires filesystem access and Python 3.9+. Exact schema checks additionally need git, Node.js, pnpm, and the pinned fabric-agent-contract checkout (a public repository). Works without those tools in an explicitly degraded structural-check mode.
6
6
  metadata:
7
7
  author: PassionCode.ai
8
- version: "0.52.0"
8
+ version: "0.53.1"
9
9
  contract-version: "0.1.0"
10
10
  contract-commit: "1197a90dc4b57152cabcc71ad17db7559f35a27f"
11
11
  ---
@@ -14,7 +14,7 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
14
14
  compatibility: Python 3.9+ or Node.js 20+ for the kits (Node.js 22+ for a Linux service's instance lock); the probe needs Python 3.9+. launchd steps are macOS-only; Linux services install a systemd user unit and Windows ones a per-user Scheduled Task with the kits' writers. Dashboard handoff optionally uses Fabric Dashboards MCP link/host_status/open; without it, report unresolved host capability. The contract checkout is optional.
15
15
  metadata:
16
16
  author: PassionCode.ai
17
- version: "0.52.0"
17
+ version: "0.53.1"
18
18
  contract-version: "0.1.0"
19
19
  extension: "fabric-service/0.1"
20
20
  extension-commit: "1197a90dc4b57152cabcc71ad17db7559f35a27f"
@@ -102,7 +102,10 @@ When the service answers requests other Projects post to its Project on Fabric's
102
102
  responder in its own process: [`scripts/fabric_hub.py`](scripts/fabric_hub.py) finds the hub and joins,
103
103
  [`scripts/fabric_board.py`](scripts/fabric_board.py) enrolls, claims, accepts the exact digest, checkpoints before
104
104
  every step and stops on `fenced`, `lease_expired` or `authority_changed` (Node: `fabric-hub.mjs`, `fabric-board.mjs`).
105
- The request body is data behind the service's own input gate. Read [the board reference](references/board.md).
105
+ The request body is data behind the service's own input gate. From 0.53.0 a slot the operator moved to another
106
+ session stays moved until `take_back` (`takeBack`): give it an operator action with its tool and gate `relayed`, or it
107
+ stays moved for good (until Fabric's hub forwards decisions, CT-125, the operator reaches it through the service's page
108
+ or its elicitation). Read [the board reference](references/board.md).
106
109
 
107
110
  ## Step 2: the non-negotiables
108
111
 
@@ -256,7 +259,8 @@ or `human` with its `humanStep`) and declared with `build_well_known(actions=ser
256
259
  `extensions/actions/0.1`. A `relayed` action called by the operator's own agent with their decision in
257
260
  `_meta.decision` is the operator's act: never answer it "operator session required" or send them to the page.
258
261
  A service adopts the relayed gate once Fabric's hub forwards decisions (CT-125), as the contract says; until then its tools
259
- answer as today. Read the interop reference's *Actions* section for when to adopt, the gate, its hooks and its
262
+ answer as today, except the board responder's take-back action, declared `relayed` now and reached through the
263
+ page or elicitation until CT-125 ([board.md](references/board.md)). Read the interop reference's *Actions* section for when to adopt, the gate, its hooks and its
260
264
  refusals.
261
265
 
262
266
  **Say what the agent uses** (`fabric-connections/0.1`, DEC-0096) so Fabric Dashboards draws its chain: the other
@@ -16,6 +16,7 @@ skill's business (working-with-fabric, `references/project-board.md`).
16
16
  - Effects, observation, evidence and the reply
17
17
  - When the board says stop, and restarts
18
18
  - When the operator holds work (DEC-0079)
19
+ - When the operator moves a slot to another session (FAA-155)
19
20
  - What a board session may call
20
21
  - Looking a Project up in the directory (FAC-SEM-107)
21
22
  - Events, the probe and the live smoke
@@ -50,7 +51,11 @@ responder = fbd.Responder(
50
51
  hub=fhb.HubClient(), project_id=PROJECT, capabilities=["video.render"],
51
52
  credential_file=dirs["data"] / "board.credential", checkpoint_file=dirs["data"] / "board-checkpoint.json",
52
53
  handler=render, admit=gate, observe=look_on_disk, emit=log.append, service="example-agent")
53
- threading.Thread(target=responder.run, args=(stop_event, 5.0), daemon=True).start() # SIGTERM: set stop_event
54
+ board = threading.Thread(target=responder.run, args=(stop_event, 5.0), daemon=True) # SIGTERM: set stop_event
55
+ board.start()
56
+ # ... at stop, after stop_event is set: wait for it to leave its board session (a clean leave forgets its slot
57
+ # records, FAA-155), bounded inside the kit's hard exit, as scripts/sample_service.py does
58
+ board.join(timeout)
54
59
  ```
55
60
 
56
61
  Node: `new Responder({...same names in camelCase})`, then `responder.run({ signal, drain })`. A service that lists
@@ -63,7 +68,7 @@ One tick every 15 s ± 5 s (`step()` answers the wait):
63
68
 
64
69
  | Step | Board call | Checkpoint written first |
65
70
  |---|---|---|
66
- | hold the slot | `com.enroll` (again at about 20 s while idle: the holder's enroll renews its 60 s lease) | none |
71
+ | hold the slot | `com.enroll` (again at about 20 s while idle: the holder's enroll renews its 60 s lease) | none for a first enroll or a live holder's renew; otherwise the slot's `asking` record (FAA-155) |
67
72
  | take a request | `com.claim`, the same key while nothing is claimable | `claimed` |
68
73
  | read it | `com.get`: the digest must equal the claim's, and the request must name this Project and capability | none |
69
74
  | accept | `com.accept` with the claim's exact fence (request, generation, attempt, digest, revision) | `accepting`, then `accepted` |
@@ -73,7 +78,8 @@ One tick every 15 s ± 5 s (`step()` answers the wait):
73
78
  | settle | `com.complete {state, observed, summary?, evidence?}` | `completing`, then the entry is dropped |
74
79
 
75
80
  The checkpoint is fsynced before each call it announces. A write that fails stops the step (`board.blocked`): nothing
76
- is sent that the checkpoint does not know about. A lost answer is sent again with the same idempotency key, so the
81
+ is sent that the checkpoint does not know about. The one exception is the slot record: an `asking` or generation
82
+ record that cannot be written is skipped and the enroll or replace still goes out (see below). A lost answer is sent again with the same idempotency key, so the
77
83
  board returns the first receipt; while the lease still holds, the session and the running work stay and the call goes
78
84
  again before the lease would lapse (FAA-77). One request is in flight at a time, and one fenced call: the fence is
79
85
  built, sent and its receipt applied under one lock, so the tick's `com.renew` never carries a revision the handler's
@@ -109,10 +115,10 @@ once the kit reads it (FAA-135).
109
115
 
110
116
  | Answer | What the kit does |
111
117
  |---|---|
112
- | `fenced` | the attempt is another responder's: stop the handler, drop the entry (nothing outside had begun) |
118
+ | `fenced` | the attempt is another responder's: stop the handler, drop the entry (nothing outside had begun); accepted work on a slot this responder recorded holding stays as `lapsed`, and the next tick asks `com.status` whether the slot [moved](#when-the-operator-moves-a-slot-to-another-session-faa-155) |
113
119
  | `lease_expired` on accepted work | stop the handler; the board holds the request, and the kit takes it back with `com.responder_replace` and a transfer |
114
120
  | `authority_changed`, `not_authorized` | stop claiming; one `board.access.needed` event (notify) saying what to ask for |
115
- | `fenced` on enroll | another live holder: wait for it to lapse; never replace it on its own initiative |
121
+ | `fenced` on enroll or claim | another live holder: wait for it to lapse; never replace it on its own initiative. When this responder recorded holding the slot, it first reads `com.status`: a newer generation means the slot [moved](#when-the-operator-moves-a-slot-to-another-session-faa-155), and it is not taken again even after that holder lapses |
116
122
  | lost after an effect began | keep the entry as `unknown`; `observe(entry)` is asked to settle it with `com.reconcile` |
117
123
  | Fabric down, hub missing | bounded backoff (2 s doubling to 5 minutes, jittered), one `board.down` event, no spinning |
118
124
  | one call without an answer while the lease holds | `board.down`, but the session and the running work stay; the call goes again, with the same key, before the lease lapses |
@@ -124,7 +130,8 @@ On restart the checkpoint is read back: settled, queued, claimed or `answered` r
124
130
  the target Project's participant reply answered it, DEC-0098 and DEC-0102; not settled, the requester may still cancel
125
131
  it, but no longer this responder's); `in_progress` and `outcome_unknown` are
126
132
  reconciled from what `observe(entry)` answers (observed only; with no observation they stay unknown and notify);
127
- accepted ones go back to this responder with `com.responder_replace {expectedGeneration, transfer}`, whose receipt's
133
+ accepted ones go back to this responder with `com.responder_replace {expectedGeneration, transfer}` (unless the slot
134
+ moved to another session meanwhile: they stay `lapsed` until take-back, [below](#when-the-operator-moves-a-slot-to-another-session-faa-155)), whose receipt's
128
135
  `transferred` (DEC-0078: `{request, revision, attempt}`) carries the new fence. **A Fabric that does not answer
129
136
  `transferred` yet leaves the request held** (`board.request.held`, notify): the kit never claims it back, because the
130
137
  contract has no `com.claim` read-back and `com.claim` never moves an accepted request. A known outcome is sent after the
@@ -160,6 +167,70 @@ A receipt's request may carry `settledBy: "owner"` (DEC-0081): the estate owner
160
167
  whose responder was gone. Read it as the owner's attestation, not the responder's; it appears only on `completed` or
161
168
  `failed_known`, and its absence means the responder settled it.
162
169
 
170
+ ## When the operator moves a slot to another session (FAA-155)
171
+
172
+ The contract's DEC-0140 PR-2 (proposed, after this kit's pin; Fabric plans it for 0.3.15) lets the operator move a
173
+ (Project, capability) slot to another live session of the Project: one transition, as `com.responder_replace` would make
174
+ it for the receiving session (generation up, `claimed` back to `queued`, `in_progress` to `outcome_unknown`, `accepted`
175
+ held and not transferred). The responder keeps that move instead of undoing it:
176
+
177
+ - It records the generation it holds each slot at, in the checkpoint file beside the requests (`slots: {<capability>:
178
+ {project, generation, moved?, asking?}}`). The record is written when a receipt's generation changes and before an
179
+ enroll or a replace that can change it; a live holder's renew (about every 20 s) cannot, and writes nothing. At a
180
+ clean leave (the service stopped; the session's DELETE released its slots) the record of a slot with no request left
181
+ in the checkpoint and not moved is forgotten (a moved slot's record stays, so a clean stop never undoes a move): the slot is free, and whoever takes it next is no move. A file without the record
182
+ reads as before; a kit before 0.53.0 reads the file, ignores the record and drops it at its first checkpoint write. So a service stopped cleanly with no request left in its checkpoint, rolled back to 0.52 and up again starts as on a first
183
+ start. After a crash the record stays: if 0.52 then ran, enrolled the slot and
184
+ wrote nothing to the checkpoint, the next 0.53 start reads that enroll as a move; bring it back with the service's take-back action (below).
185
+ - An enroll or a replace is written into that record with its key before it is sent (`asking`). When its answer is
186
+ lost, the next connect (or the next enroll) sends the same call again under the same key; the board answers the
187
+ stored receipt, whose generation is this service's own, and the slot is then asked for once more for the new board
188
+ session. A refusal is an answer and drops the `asking` record, so a move that happened meanwhile is still seen; except
189
+ `idempotency_window_expired` (a retired epoch refuses even a repeat), which leaves it unknown whether the call
190
+ landed: the whole record is forgotten and the slot reads as on a first start, never as a move. An
191
+ `asking` record that cannot be written (a full disk) is skipped, as the generation record is: the call goes out
192
+ unrecorded, and a lost answer to it, or a restart before the next receipt is recorded, may then read as a move.
193
+ - It reads the slot's generation from `com.status` at every connect (a restart), and after any call refused `fenced`:
194
+ at once for a claim or an enroll, at the next tick for a fenced call on running work. Only a responder with a record
195
+ asks, so a first start sends no extra call. A generation past the recorded one, with no own call of
196
+ this service left unanswered, is a move, whatever made it: the operator, or another session that took the slot while
197
+ this one was away or after it crashed. Before 0.53.0 a restarted responder took such a slot back by itself. So a
198
+ second responder of the same capability is no longer a standby once the slot changed hands: after any change of
199
+ holder it waits for take-back, not for the other's lapse.
200
+ - A `fenced` refusal on accepted work while the slot did not move (the generation unchanged) keeps the entry
201
+ `lapsed`; the next tick takes it back with a transfer and goes on (before 0.53.0 the entry was dropped and the
202
+ request left accepted on the board).
203
+ - Then the slot is `moved`: the running handler is told to stop (`ctx.stopped`); a `claimed` entry is dropped (the move
204
+ returned it to the queue); accepted work stays as `lapsed` and work whose effect began as `unknown` (only the slot's
205
+ holder, or the estate owner, reconciles it now). No `com.claim`, `com.renew`, `com.complete`, `com.enroll` or
206
+ `com.responder_replace` is sent for that capability again: not at recovery after a restart, and not when the new
207
+ holder's lease lapses, nor when com.status later names no generation for the slot (a recorded move stays until
208
+ take-back). Accepted requests stay held on the board, unanswered, until the slot is taken back (CT-175
209
+ will hand them to the new holder). One `board.slot.moved` event (warn, notify) says so, once, also across restarts
210
+ (the record keeps `moved`).
211
+ - A responder that never held the slot (a first start: no record, or a record of another Project), or whose record
212
+ equals the current generation, behaves as before: it enrolls, recovers and replaces its own lapsed work. A recorded or
213
+ reported generation that is not an integer of at least 1, or one not past the record (lower: the record is not this
214
+ board's), is not a move either: today's behaviour, not a stop, and the next receipt rewrites the record. A crash
215
+ between a receipt and its record's write leaves the `asking` record: the next start asks again under the same key and
216
+ records its own generation. Only a replay the board refuses, or one that ran for the first time (`repeated: false`)
217
+ after the slot had moved past the record, reads as a move: the safe side; a slot such a replay took is left to lapse
218
+ unused. A generation written `2.0` is `2`.
219
+ - Only the operator brings the slot back: `take_back(capability)` (`takeBack`) forgets the record; never edit the
220
+ checkpoint's `slots` record by hand to undo a move. In the same board
221
+ session the next tick enrolls once the other session lets the slot go (a live holder is waited for) and takes the work
222
+ left `lapsed` back with a transfer. A restart or reconnect before that, with accepted work held for the slot, takes it
223
+ back at once by `com.responder_replace`, as a restart did before 0.53.0: the operator asked for the slot back, so the
224
+ other session is replaced. In recovery, a refusal that leaves no slot held reconnects; one that leaves some held keeps
225
+ the session and serves them. The kit gives it no route of its own (the reference service has none yet,
226
+ FAA-157): a service built on the kit declares it as an operator action, a button with its tool ([Every button has a
227
+ tool](../SKILL.md), `fabric-actions/0.1`) with gate `relayed` (the operator's decision), never `none`, so no other
228
+ agent can call it on its own; on a server that reads mandates (`agent_id`) it also names its effect class, for example
229
+ `change-policy` (DEC-0125); until Fabric's hub forwards decisions (CT-125) the operator reaches it through the
230
+ service's page or its elicitation, and names it in its docs; otherwise a moved slot stays moved. A move back to this service's own session is not
231
+ detected yet: the receiving side and the hand-over of accepted requests (contract CT-175) wait for Fabric's session
232
+ surface.
233
+
163
234
  ## What a board session may call
164
235
 
165
236
  A board session (`fabric.board.join`) is served the respond scope only: `com.status`, `com.list`, `com.get`,
@@ -183,8 +254,8 @@ raises `directory-invalid` rather than answering; an unlisted Project may still
183
254
  Events go to `emit(kind, level, text, notify=…, data=…)` (`JsonlEventLog.append` fits) with `data {schema, value}`
184
255
  checked by FAC-SEM-101 (no credential in data): `board.request.completed`, `board.request.refused`,
185
256
  `board.request.skipped`, `board.request.reconciled`, `board.request.held`, `board.attempt.lost`,
186
- `board.reconcile.needed`, `board.slot.contested`, `board.access.needed`, `board.blocked`, `board.down`, each
187
- notifying episode said once.
257
+ `board.reconcile.needed`, `board.slot.contested`, `board.slot.moved`, `board.access.needed`, `board.blocked`,
258
+ `board.down`, each notifying episode said once.
188
259
 
189
260
  `check_service.py <id> [--board-kit <the service's fabric_board.py or fabric-board.mjs>]` rule **board.responder**:
190
261
  `NOT_RUN` when the well-known `protocols` names no `fabric-project-comms` revision; `FAIL` for a revision this kit does
@@ -208,12 +279,12 @@ message, retryable, data)`.
208
279
 
209
280
  Python (`fabric_board`): `Responder(*, hub, project_id, capabilities, credential_file, checkpoint_file, handler,
210
281
  admit, observe=None, emit=None, service, now, rand, spawn, session_factory)` with `step()`, `run(stop, drain)`,
211
- `shutdown(drain)`; `WorkContext.progress(note)`, `.begin_effect(summary)`, `.stopped`; `BoardSession(grant)`;
282
+ `shutdown(drain)`, `take_back(capability)`; `WorkContext.progress(note)`, `.begin_effect(summary)`, `.stopped`; `BoardSession(grant)`;
212
283
  `Checkpoint(path)`; `comms_canonical(value)`, `comms_digest(operation, value)`, `receipt_problems(value, op)`,
213
284
  `refusal_problems(value)`, `directory_findings(page)`, `directory_problems(page)`, `find_project(page, project_id,
214
285
  capability)`, `artifact_ref(uri, content|path, label)`, `evidence_problems(list)`, `outcome_problems(outcome,
215
286
  effect_began)`, `self_check()`; `BoardError`, `Stopped`.
216
287
 
217
288
  Node: the same names in camelCase (`locateHub(root, {alive, estate, now})`, `new HubClient(root, {alive, timeout,
218
- estate, post})`, `new Responder({...})` with async `step()`, `run({signal, drain})`, `shutdown(drain)`; `await
219
- ctx.progress(note)`, `await ctx.beginEffect(summary)`; `selfCheck()`). Both kits read and write the same checkpoint file.
289
+ estate, post})`, `new Responder({...})` with async `step()`, `run({signal, drain})`, `shutdown(drain)`,
290
+ `takeBack(capability)`; `await ctx.progress(note)`, `await ctx.beginEffect(summary)`; `selfCheck()`). Both kits read and write the same checkpoint file.
@@ -148,7 +148,8 @@ and Fabric's hub forwarding decisions (CT-125) have landed (DEC-0121 *Compatibil
148
148
  operator's own coding agents: Claude Code and Codex cannot set `_meta`, so until the hub forwards `call.decision`
149
149
  a `relayed` gate turns "approve it" in chat into `operator-decision-required` with the page as the only route.
150
150
  Until then a service keeps its tools as they answer today, or gates a `relayed` tool only where it offers its own
151
- elicitation (the `elicited` hook). This is D8's reason, which keeps `input_actions` off, applied to tools.
151
+ elicitation (the `elicited` hook). The one exception is the board responder's take-back action: it is declared
152
+ `relayed` now and reached through the page or elicitation until CT-125 (`board.md`). This is D8's reason, which keeps `input_actions` off, applied to tools.
152
153
 
153
154
  **Parity (AP-1).** Every action the dashboard, app or page lets a person take (approve, reject, choose, edit, pause,
154
155
  resume, cancel, retry, send, publish, restore, set a policy, any other) has a tool on the MCP surface with the same
@@ -55,7 +55,7 @@ that document until `service.id` matches (at most 40 s) before it calls the serv
55
55
 
56
56
  | Id | Rule | Here | Kit (Python / Node) |
57
57
  |---|---|---|---|
58
- | LC-01 | **Quit reaches exit within a deadline.** Every trigger (`SIGTERM`, `SIGINT`, logout, the app's own quit) ends the process: within 5 s idle, within 10 s with work in flight, then a hard exit. Nothing starts after quit begins | [Shutdown](#shutdown) | `Drain` / `Drain` |
58
+ | LC-01 | **Quit reaches exit within a deadline.** Every trigger (`SIGTERM`, `SIGINT`, logout, the app's own quit) ends the process: within 5 s idle, within 10 s with work in flight, then a hard exit (a board responder leaving its session can take an idle stop up to that hard exit). Nothing starts after quit begins | [Shutdown](#shutdown) | `Drain` / `Drain` |
59
59
  | LC-02 | **Every child has an owner, a deadline and a process group.** No subprocess without a timeout; on timeout or the parent's exit the whole group goes; no orphan survives. Locks and shared resources are released in `finally` | your own code | none |
60
60
  | LC-03 | **A job is bounded and exclusive.** One copy holds `service.lock`; a scheduled job has a watchdog shorter than its interval, shares its lock with every manual entry point, bounds every network call and records each run's outcome. Long work is journalled before it starts | [One copy under a supervisor](#one-copy-under-a-supervisor) | `hold_single_instance` / `holdSingleInstance` |
61
61
  | LC-04 | **Credentials are silent after setup.** No background prompt; a credential read that is denied or absent is cached and backs off until a person acts | [Directories](#directories) (secret files 0600) | none |
@@ -83,6 +83,7 @@ export class BoardSession {
83
83
  export class Checkpoint {
84
84
  constructor(file) {
85
85
  this.file = file;
86
+ this.slots = {}; // the responder's own record of each slot it held: {project, generation, moved?} (FAA-155)
86
87
  this.entries = this.#load();
87
88
  }
88
89
  #load() {
@@ -100,13 +101,16 @@ export class Checkpoint {
100
101
  doc = null;
101
102
  }
102
103
  if (!isObj(doc) || doc.version !== 1 || !isObj(doc.requests)) throw new BoardError('checkpoint', `The board checkpoint ${this.file} is not one this kit writes.`);
104
+ // a record that is not an object is ignored, as a file without one is
105
+ this.slots = isObj(doc.slots) ? Object.fromEntries(Object.entries(doc.slots).filter(([, v]) => isObj(v))) : {};
103
106
  return doc.requests;
104
107
  }
105
- #write(entries) {
108
+ #write(entries, slots = this.slots) {
106
109
  try {
107
110
  ensurePrivateDir(path.dirname(this.file));
108
- const sorted = Object.fromEntries(Object.keys(entries).sort().map((k) => [k, entries[k]]));
109
- atomicWrite(this.file, `${JSON.stringify({ requests: sorted, version: 1 }, null, 1)}\n`, 0o600);
111
+ const sort = (o) => Object.fromEntries(Object.keys(o).sort().map((k) => [k, o[k]]));
112
+ const doc = Object.keys(slots).length ? { requests: sort(entries), slots: sort(slots), version: 1 } : { requests: sort(entries), version: 1 };
113
+ atomicWrite(this.file, `${JSON.stringify(doc, null, 1)}\n`, 0o600);
110
114
  } catch (e) {
111
115
  throw new BoardError('checkpoint', `The board checkpoint could not be written (${e.code ?? e.message}); nothing was sent.`);
112
116
  }
@@ -122,8 +126,34 @@ export class Checkpoint {
122
126
  this.#write(entries);
123
127
  this.entries = entries;
124
128
  }
129
+ /** Writes the record of a slot this responder held (null forgets it); nothing is written when it is unchanged. */
130
+ slot(capability, record) {
131
+ const { [capability]: _old, ...slots } = this.slots;
132
+ if (record !== null) slots[capability] = JSON.parse(JSON.stringify(record));
133
+ if (JSON.stringify(sortDeep(slots)) === JSON.stringify(sortDeep(this.slots))) return;
134
+ this.#write(this.entries, slots);
135
+ this.slots = slots;
136
+ }
137
+ /**
138
+ * At a clean leave (the session's DELETE released the slots): forget the record of each slot this service held for
139
+ * `project` with no request left and not moved away, so a later generation is another session taking a free slot, and
140
+ * a kit rolled back to before 0.53.0 leaves nothing that reads as a move. A record that cannot be written stays.
141
+ */
142
+ leave(project) {
143
+ const busy = new Set(Object.values(this.entries).map((e) => e.capability));
144
+ for (const [capability, record] of Object.entries(this.slots)) {
145
+ if (!isObj(record) || record.project !== project || 'moved' in record || busy.has(capability)) continue;
146
+ try {
147
+ this.slot(capability, null);
148
+ } catch {
149
+ // stays for the next start
150
+ }
151
+ }
152
+ }
125
153
  }
126
154
 
155
+ const sortDeep = (v) => (isObj(v) ? Object.fromEntries(Object.keys(v).sort().map((k) => [k, sortDeep(v[k])])) : v);
156
+
127
157
  /** A claimed request as data: never an instruction. */
128
158
  export class BoardRequest {
129
159
  constructor(message, capability) {