Seam
fs/observed
18 hook, and every one of them rewrites what passes here or records it.
Harness
The harness dispatches this seam as a emit, and it already has listeners here. The family adds its hooks beside them.
It carries a write that already happened.
- Payload
- The harness docs do not state the shape at this seam.
- Power
- A listener observes a fact that already happened.
- Declared
- packages/fs/fs/src/index.ts:77
- fs-observation-policy
- skill-filesystem
- workspace-files
An emit listener observes a fact that already happened. A hook here records it, or acts on the world beside it, but it cannot change the payload.
Fan
One event, many hands. The same listener list the table below details, drawn as the dispatch it is.
- hook-dsh-cargo-governor rewrite
- hook-dsh-package-governor rewrite
- hook-dsh-package-pinner rewrite
- hook-dsh-workspace-approve record
- hook-dsh-workspace-audit record
- hook-dsh-workspace-journal record
- hook-dsh-workspace-merge rewrite
- hook-dsh-workspace-monitor record
- and 10 more
Hook
One row per hook that declares this seam, with the effect it has and the knobs it documents.
| Hook | Effect | What it does | Configuration |
|---|---|---|---|
| rewrite | Keeps Cargo.toml in order without asking | 11 knob | |
| rewrite | Keeps package.json in order without asking | 10 knob | |
| rewrite | Pins every dependency to the version actually used | 7 knob | |
| record | Binds an approved proposal to its execution | 4 knob | |
| record | Records what the workspace did, as events and ledger lines | 7 knob | |
| record | Keeps undo, checkpoints, and crash recovery | 8 knob | |
| rewrite | Merges a batch atomically, file by file | 8 knob | |
| record | Watches the workspace and sweeps it on a schedule | 8 knob | |
| record | Observes the workspace so the family can reason about it | 4 knob | |
| rewrite | Keeps Cargo.toml in order without asking | 11 knob | |
| rewrite | Keeps package.json in order without asking | 10 knob | |
| rewrite | Pins every dependency to the version actually used | 7 knob | |
| record | Binds an approved proposal to its execution | 4 knob | |
| record | Records what the workspace did, as events and ledger lines | 7 knob | |
| record | Keeps undo, checkpoints, and crash recovery | 8 knob | |
| rewrite | Merges a batch atomically, file by file | 8 knob | |
| record | Watches the workspace and sweeps it on a schedule | 4 knob | |
| record | Observes the workspace so the family can reason about it | 4 knob |
Read
A seam is the harness event a hook listens on, named area/event. This page lists the hooks the repository declares at this seam, one row per hook, with the effect it has and the configuration it documents. A row marked as an arm is a listener the package's source registers here without documenting it in its README.