<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/context/system-events/">
  <id>https://docs.spec-kitty.ai/context/system-events/</id>
  <title>Context: System Events</title>
  <updated>2026-11-13T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/context/system-events/"/>
  <summary>Glossary context for system events: Spec Kitty&apos;s append-only event model, replay behavior, and system-level event types like the event envelope.</summary>
  <content type="html">&lt;h2 id=&quot;context-system-events&quot;&gt;Context: System Events&lt;/h2&gt;
&lt;p&gt;Terms describing Spec Kitty’s append-only event model, replay behavior, and system-level event types.&lt;/p&gt;
&lt;h3 id=&quot;event-envelope&quot;&gt;Event Envelope&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Standard wrapper for an emitted event, including identity, ordering, and payload fields.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Common fields&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;event_id&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;event_type&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;aggregate_id&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;lamport_clock&lt;/code&gt; (optional), &lt;code dir=&quot;auto&quot;&gt;payload&lt;/code&gt; (the &lt;code dir=&quot;auto&quot;&gt;Event&lt;/code&gt; model in &lt;code dir=&quot;auto&quot;&gt;spec_kitty_events.models&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;glossary-evolution-log&quot;&gt;Glossary Evolution Log&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Append-only sequence of glossary-related events that records candidate extraction, semantic checks, clarifications, and sense updates. Stored per Mission in &lt;code dir=&quot;auto&quot;&gt;.kittify/events/glossary/&amp;#x3C;mission_id&gt;.events.jsonl&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;src/glossary/events.py&lt;/code&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/execution/#semantic-check&quot;&gt;Semantic Check&lt;/a&gt;, &lt;a href=&quot;/context/execution/#clarification-prompt&quot;&gt;Clarification Prompt&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;glossary-scope&quot;&gt;Glossary Scope&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Bounded semantic scope used for term/sense resolution.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Allowed values&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec_kitty_core&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;team_domain&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;audience_domain&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission_local&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;GlossaryScope&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;src/glossary/scope.py&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;semantic-check-evaluation&quot;&gt;Semantic Check Evaluation&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Deterministic pre-generation evaluation of extracted terms against active glossary scopes.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Block rule&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Depends on the glossary strictness (&lt;code dir=&quot;auto&quot;&gt;src/glossary/strictness.py&lt;/code&gt;): &lt;code dir=&quot;auto&quot;&gt;off&lt;/code&gt; never blocks, &lt;code dir=&quot;auto&quot;&gt;medium&lt;/code&gt; blocks on an unresolved high-severity conflict, &lt;code dir=&quot;auto&quot;&gt;max&lt;/code&gt; blocks on any unresolved conflict&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;replay&quot;&gt;Replay&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Reconstructing effective glossary state and decisions from canonical append-only events.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Invariant&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;No side-channel state may be required for correctness&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;telemetry-out-of-scope-for-this-slice&quot;&gt;Telemetry (Out of Scope for This Slice)&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Optional usage/cost analytics and operational observability fields layered on top of core event contracts.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Note&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Not required for glossary semantic integrity in this 2.x adoption slice&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;dossier-event&quot;&gt;Dossier Event&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;An event emitted during dossier operations. Four types: &lt;code dir=&quot;auto&quot;&gt;MissionDossierArtifactIndexed&lt;/code&gt; (artifact scanned), &lt;code dir=&quot;auto&quot;&gt;MissionDossierSnapshotComputed&lt;/code&gt; (snapshot created), &lt;code dir=&quot;auto&quot;&gt;MissionDossierArtifactMissing&lt;/code&gt; (required artifact not found), &lt;code dir=&quot;auto&quot;&gt;MissionDossierParityDriftDetected&lt;/code&gt; (content changed since baseline).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Note&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The four emitters in &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/dossier/events.py&lt;/code&gt; are defined, but no code path in &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt; calls them today.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/dossier/#mission-dossier&quot;&gt;Mission Dossier&lt;/a&gt;, &lt;a href=&quot;#anomaly-event&quot;&gt;Anomaly Event&lt;/a&gt;, &lt;a href=&quot;#event-envelope&quot;&gt;Event Envelope&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;anomaly-event&quot;&gt;Anomaly Event&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;An event that is only emitted when something unexpected happens — such as a required artifact being missing or parity drift being detected. Unlike routine lifecycle events, anomaly events signal conditions that may need the Human-in-Charge’s attention.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Note&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The dossier anomaly events (&lt;code dir=&quot;auto&quot;&gt;MissionDossierArtifactMissing&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;MissionDossierParityDriftDetected&lt;/code&gt;) are not emitted by any code path in &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt; today; see &lt;a href=&quot;#dossier-event&quot;&gt;Dossier Event&lt;/a&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#dossier-event&quot;&gt;Dossier Event&lt;/a&gt;, &lt;a href=&quot;/context/identity/#human-in-charge-hic&quot;&gt;Human-in-Charge (HiC)&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;wpstatuschanged&quot;&gt;WPStatusChanged&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The event type that carries a work package’s move from one status lane to another (e.g., from &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt;). Part of the status model’s event contract: the CLI writes each move as a &lt;code dir=&quot;auto&quot;&gt;StatusEvent&lt;/code&gt; row in &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;build_status_event_payload&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/status/wire_payload.py&lt;/code&gt;) renders that row as a &lt;code dir=&quot;auto&quot;&gt;WPStatusChanged&lt;/code&gt; payload.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/orchestration/#work-package&quot;&gt;work package&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#lane&quot;&gt;Lane&lt;/a&gt;, &lt;a href=&quot;#event-envelope&quot;&gt;Event Envelope&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;lamport-clock&quot;&gt;Lamport Clock&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;A logical counter included in event envelopes that tracks the order events happened in, without relying on wall-clock time. Each new event increments the counter, ensuring events can be reliably ordered even across different machines.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Note&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The field is optional in the envelope. The CLI’s status lane transitions carry no Lamport clock, and the status reducer orders them by the writer’s &lt;code dir=&quot;auto&quot;&gt;at&lt;/code&gt; timestamp, then &lt;code dir=&quot;auto&quot;&gt;event_id&lt;/code&gt; (ADR &lt;a href=&quot;/adr/2.x/2026-02-09-3-event-log-merge-semantics/&quot;&gt;2026-02-09-3&lt;/a&gt;, Amendment 2026-10-22). Do not describe the status path as Lamport-ordered.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#event-envelope&quot;&gt;Event Envelope&lt;/a&gt;, &lt;a href=&quot;#replay&quot;&gt;Replay&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;tail-cursor&quot;&gt;Tail cursor&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The reader’s resumable position in &lt;code dir=&quot;auto&quot;&gt;spec-kitty events tail&lt;/code&gt; — a byte offset into the selected log of a named Mission (&lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt; by default; &lt;code dir=&quot;auto&quot;&gt;--log&lt;/code&gt; selects &lt;code dir=&quot;auto&quot;&gt;decisions&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;run&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;ops&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;canonical&lt;/code&gt;), plus a content invariant (a fixed-size SHA-256 hex digest of the last-consumed line/boundary bytes at that offset, never the raw bytes themselves) used to re-verify on every poll that growth at that offset is a true continuation and not a rollback-then-regrow landing back at or above the same size. Always caller-supplied/caller-owned: &lt;code dir=&quot;auto&quot;&gt;events tail&lt;/code&gt; is stateless across invocations and never persists cursor or resume state to disk anywhere.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Distinct from&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#event-envelope&quot;&gt;Event Envelope&lt;/a&gt; — a Tail cursor is reader-side position/verification state (offset + content-invariant digest), never a wrapper around an emitted event’s own identity/ordering/payload fields (&lt;code dir=&quot;auto&quot;&gt;event_id&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;event_type&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;aggregate_id&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;lamport_clock&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;payload&lt;/code&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#tail-envelope&quot;&gt;Tail envelope&lt;/a&gt;, &lt;a href=&quot;#resume-token&quot;&gt;resume token&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;resume-token&quot;&gt;resume token&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The &lt;code dir=&quot;auto&quot;&gt;(offset, content_invariant)&lt;/code&gt; pair a consumer of &lt;code dir=&quot;auto&quot;&gt;spec-kitty events tail&lt;/code&gt; persists across restarts and supplies back via &lt;code dir=&quot;auto&quot;&gt;--from-offset&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;--from-invariant&lt;/code&gt;, so a cold-started process can resume where a prior run left off. Persisting the offset alone (with no invariant) only enables structural resume validation; supplying both enables FR-013’s cross-restart content-mismatch check, which refuses the resume (structured stderr error, non-zero exit, no Tail envelope emitted) rather than silently trusting a stale or rolled-back-then-regrown position.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Distinct from&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#event-envelope&quot;&gt;Event Envelope&lt;/a&gt; — a resume token is the consumer’s own persisted &lt;code dir=&quot;auto&quot;&gt;(offset, content_invariant)&lt;/code&gt; value, never an emitted event’s &lt;code dir=&quot;auto&quot;&gt;event_id&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;lamport_clock&lt;/code&gt;-shaped wrapper; also distinct from &lt;a href=&quot;#tail-cursor&quot;&gt;Tail cursor&lt;/a&gt;, which is the reader’s own live in-memory position — a resume token is what a consumer chooses to durably persist FROM a Tail cursor’s offset/invariant, across process restarts, never automatically.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#tail-cursor&quot;&gt;Tail cursor&lt;/a&gt;, &lt;a href=&quot;#tail-envelope&quot;&gt;Tail envelope&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;log_truncated&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;log_truncated&lt;/code&gt;&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The Tail envelope stream’s truncation-resync signal shape, emitted when &lt;code dir=&quot;auto&quot;&gt;spec-kitty events tail&lt;/code&gt; detects a rollback (a size shrink, or a truncate-then-regrow whose content invariant no longer matches at the previously-consumed offset) while running. Carries a &lt;code dir=&quot;auto&quot;&gt;&quot;type&quot;: &quot;log_truncated&quot;&lt;/code&gt; discriminator (absent from ordinary pass-through rows), a &lt;code dir=&quot;auto&quot;&gt;reason&lt;/code&gt; of &lt;code dir=&quot;auto&quot;&gt;&quot;size_shrink&quot;&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;&quot;content_mismatch&quot;&lt;/code&gt;, the &lt;code dir=&quot;auto&quot;&gt;detected_at_offset&lt;/code&gt;, and a resync &lt;code dir=&quot;auto&quot;&gt;tail_offset&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;tail_invariant&lt;/code&gt; pair at offset 0 — never silently absorbed as “no new data.”&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Distinct from&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#event-envelope&quot;&gt;Event Envelope&lt;/a&gt; — &lt;code dir=&quot;auto&quot;&gt;log_truncated&lt;/code&gt; is one of the Tail envelope stream’s own signal shapes, never a &lt;code dir=&quot;auto&quot;&gt;StatusEvent&lt;/code&gt;/canonical-Event-Envelope row; its &lt;code dir=&quot;auto&quot;&gt;&quot;type&quot;&lt;/code&gt; discriminator is exactly what lets a consumer tell the two apart on the same stream.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#tail-envelope&quot;&gt;Tail envelope&lt;/a&gt;, &lt;a href=&quot;#tail-cursor&quot;&gt;Tail cursor&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;tail-envelope&quot;&gt;Tail envelope&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;One JSON line emitted on stdout by &lt;code dir=&quot;auto&quot;&gt;spec-kitty events tail&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;--json&lt;/code&gt; mode (#6611) — either a pass-through of an existing line of the selected log (for the default status log, a &lt;code dir=&quot;auto&quot;&gt;StatusEvent&lt;/code&gt; dict as already serialized by &lt;code dir=&quot;auto&quot;&gt;store.py&lt;/code&gt;), or one of the two new signal shapes this command defines: the &lt;a href=&quot;#log_truncated&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;log_truncated&lt;/code&gt;&lt;/a&gt; truncation-resync signal (FR-005/FR-007) and a resolve-failure/error signal (FR-009), the latter emitted on stderr only, never on the stdout Tail-envelope stream itself. Every pass-through envelope also carries the offset and content-invariant value immediately past the emitted event, so a consumer can persist both (as a &lt;a href=&quot;#resume-token&quot;&gt;resume token&lt;/a&gt;) without deriving them itself. Without &lt;code dir=&quot;auto&quot;&gt;--json&lt;/code&gt; the command prints one human-readable plain-text line per event instead (the reader-injected cursor keys omitted); the Tail envelope is the machine channel.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;System Events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Distinct from&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#event-envelope&quot;&gt;Event Envelope&lt;/a&gt; — the canonical Event Envelope term names a differently-shaped wrapper (&lt;code dir=&quot;auto&quot;&gt;event_id&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;event_type&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;aggregate_id&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;lamport_clock&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;payload&lt;/code&gt;); a Tail envelope here is always either a raw line of the selected log (a &lt;code dir=&quot;auto&quot;&gt;StatusEvent&lt;/code&gt; JSON line for the status log) or one of &lt;code dir=&quot;auto&quot;&gt;events tail&lt;/code&gt;’s own signal shapes, never that canonical schema.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#tail-cursor&quot;&gt;Tail cursor&lt;/a&gt;, &lt;a href=&quot;#resume-token&quot;&gt;resume token&lt;/a&gt;, &lt;a href=&quot;#log_truncated&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;log_truncated&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;</content>
</entry>
