stories::on-config-change
Internal: re-read the stories configuration after an operator change.
- idstring
Configuration id that changed.
- okbooleanrequired
stories
v0.1.3Component stories for any React project — builds CSF story files with the project's own Vite (monorepo-aware), indexes components and their states per git line, compares the working tree with a branch, a commit or a chat turn, renders deterministic screenshots and DOM/React trees through the browser worker, and injects an explorer and compare page into the console.
Install
bash
iii trigger compose::add worker=storiesRun in your project with the iii engine running. Exact versions are immutable and digest-pinned.
Functions1
Function
Triggers2
stories:build
Fires on every build state transition (queued, running, done, failed) of any line. Config: { workspace?, metadata? }.
- metadataunknown
- workspacestring
- atstringrequired
- build_idstringrequired
- linestringrequired
- messagestring
- statusstringrequired
queued | running | done | failed
- workspacestringrequired
stories:changed
Fires after a working-tree rebuild changed components, with each change classified as direct, indirect, new or removed. Config: { workspace?, project?, kinds?, metadata? }.
- kindsstring[]
Change kinds to fire for: direct, indirect, new, removed. Omit for all.
- metadataunknown
Metadata attached to every invocation this binding receives.
- projectstring
Project name. Omit for every project.
- workspacestring
Workspace slug. Omit for every workspace.
- atstringrequired
- baseall ofrequired
The line the changes were classified against.
all of (1)Variant 1- built_atstringrequired
RFC 3339.
- dirtyboolean
Whether the working tree had uncommitted changes when built.
- keystringrequired
Stable key: `worktree`, `worktree.prev`, or a git object sha.
- kindone ofrequired
Which kind of source tree a line photographs.
Show 4 nestedHide nested
one of (4)Variant 1valuestringenum worktreeVariant 2valuestringenum prevVariant 3valuestringenum refVariant 4valuestringenum turn - labelstringrequired
Human label: the ref name, the turn, or `working tree`.
- shastring
- changesobject[]required
Only the changed components (never `unchanged`).
- a_versionstring
- b_versionstring
- filestringrequired
- filesobject[]
- hopinteger· uint32requiredmin 0
Smallest hop at which the file reaches the component.
- pathstringrequired
- statusstringrequired
added | removed | modified
- idstringrequired
- kindone ofrequiredone of (3)Variant 1valuestringenum unchanged, new, removedVariant 2valuestringenum directVariant 3valuestringenum indirect
- projectstringrequired
- statesobject[]
- idstringrequired
- namestringrequired
- statusstringrequired
added | removed | kept
- titlestringrequired
- lineobjectrequired
- built_atstringrequired
RFC 3339.
- dirtyboolean
Whether the working tree had uncommitted changes when built.
- keystringrequired
Stable key: `worktree`, `worktree.prev`, or a git object sha.
- kindone ofrequired
Which kind of source tree a line photographs.
one of (4)Variant 1valuestringenum worktreeVariant 2valuestringenum prevVariant 3valuestringenum refVariant 4valuestringenum turn - labelstringrequired
Human label: the ref name, the turn, or `working tree`.
- shastring
- summaryobjectrequired
- directinteger· uintrequiredmin 0
- indirectinteger· uintrequiredmin 0
- newinteger· uintrequiredmin 0
- removedinteger· uintrequiredmin 0
- unchangedinteger· uintrequiredmin 0
- workspacestringrequired