DSH familySearch GitHub

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

One row per hook that declares this seam, with the effect it has and the knobs it documents.

Every hook declared on the fs/observed seam
HookEffectWhat it doesConfiguration
hook-dsh-cargo-governorrewriteKeeps Cargo.toml in order without asking11 knob
hook-dsh-package-governorrewriteKeeps package.json in order without asking10 knob
hook-dsh-package-pinnerrewritePins every dependency to the version actually used7 knob
hook-dsh-workspace-approverecordBinds an approved proposal to its execution4 knob
hook-dsh-workspace-auditrecordRecords what the workspace did, as events and ledger lines7 knob
hook-dsh-workspace-journalrecordKeeps undo, checkpoints, and crash recovery8 knob
hook-dsh-workspace-mergerewriteMerges a batch atomically, file by file8 knob
hook-dsh-workspace-monitorrecordWatches the workspace and sweeps it on a schedule8 knob
hook-dsh-workspace-observerecordObserves the workspace so the family can reason about it4 knob
ets-hook-dsh-cargo-governorrewriteKeeps Cargo.toml in order without asking11 knob
ets-hook-dsh-package-governorrewriteKeeps package.json in order without asking10 knob
ets-hook-dsh-package-pinnerrewritePins every dependency to the version actually used7 knob
ets-hook-dsh-workspace-approverecordBinds an approved proposal to its execution4 knob
ets-hook-dsh-workspace-auditrecordRecords what the workspace did, as events and ledger lines7 knob
ets-hook-dsh-workspace-journalrecordKeeps undo, checkpoints, and crash recovery8 knob
ets-hook-dsh-workspace-mergerewriteMerges a batch atomically, file by file8 knob
ets-hook-dsh-workspace-monitorrecordWatches the workspace and sweeps it on a schedule4 knob
ets-hook-dsh-workspace-observerecordObserves the workspace so the family can reason about it4 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.