Skip to content

Commit dd16fd1

Browse files
5000Stadiaclaude
andcommitted
Docs: ADOPTION note — the situation lens is only as live as your caused_by links
Construct (live host) hit exactly this on assessment: with no caused_by effect links emitted, situation returns the standing floor only. Make the dependency an explicit adopter warning so the next consumer doesn't read the fail-safe empty live-set as a lens defect. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 327b0a2 commit dd16fd1

1 file changed

Lines changed: 5 additions & 0 deletions

File tree

docs/ADOPTION.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,11 @@ world.materialize(scope, as_of=None, frame="canon",
6363
# effect sits (walk back via caused_by), not by who participated. The
6464
# standing-truth floor is never truncated by budget; live events yield to it
6565
# by recency. Derived every read, nothing stored.
66+
# ADOPTER NOTE: the lens is only as live as your caused_by links. An event
67+
# with no caused_by-bound surviving effect (or open thread) about a scope
68+
# entity reads as DEAD and won't surface — fail-safe, not an error, but it
69+
# means situation returns the standing floor only until you wire durable
70+
# consequences to their causing event. Model the residue, link it, it lights up.
6671
world.confidence(entity, attribute, frame="canon", as_of=None,
6772
asserted_as_of=None) -> dict
6873
# frame accepts str | list[str]: a list is trust over an observer's EFFECTIVE

0 commit comments

Comments
 (0)