<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/plans/agent-moment-delivery-4216/">
  <id>https://docs.spec-kitty.ai/plans/agent-moment-delivery-4216/</id>
  <title>Agent moment delivery policy</title>
  <updated>2026-09-30T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/plans/agent-moment-delivery-4216/"/>
  <summary>Agent moment delivery for #4216: team-scoped default for unfamiliar peer activity, identity-scoped receipts as the novelty policy, bounded catch-up shared by CLI and MCP.</summary>
  <content type="html">&lt;span id=&quot;agent-moment-delivery-policy&quot;&gt;&lt;/span&gt;
&lt;p&gt;This page describes shipped behaviour: how an agent receives Team Kitty moments (#4216),
delivered in &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/pull/4224&quot;&gt;PR #4224&lt;/a&gt; (merged
2026-09-16). Provenance is in the footnote at the end.&lt;/p&gt;
&lt;p&gt;An agent should discover unfamiliar missions and mission-less activity in the
single repository it requested. &lt;code dir=&quot;auto&quot;&gt;team&lt;/code&gt; changes admission within that scope; it
does not enumerate credentials or subscribe to additional repositories.
&lt;code dir=&quot;auto&quot;&gt;mine&lt;/code&gt; means locally known missions, not authenticated assignment.&lt;/p&gt;
&lt;h2 id=&quot;approach-and-boundaries&quot;&gt;Approach and boundaries&lt;/h2&gt;
&lt;p&gt;One delivery service applies the same settings, canonical event identity,
receipt checks and event budget to CLI and MCP. The relay suppresses own-session activity before subscriber queueing; the
explicit raw mode requests the complete transport feed. Retained history is an explicit catch-up/replay source, using the
relay’s existing &lt;code dir=&quot;auto&quot;&gt;/managed/events&lt;/code&gt; endpoint and its coverage metadata.&lt;/p&gt;
&lt;p&gt;A receipt means the logical consumer acknowledged the returned batch. MCP
clients pass the previous &lt;code dir=&quot;auto&quot;&gt;receipt&lt;/code&gt; back as &lt;code dir=&quot;auto&quot;&gt;acknowledge&lt;/code&gt; on their next call;
this avoids recording failed tool delivery as read. CLI acknowledges only after
successful output and flush. Unacknowledged batches may be offered again.
Receipts store identities and timestamps, never event prose. Outstanding batches
reserve rolling-minute quota without being marked read; an atomic reservation
check prevents concurrent polls from multiplying that quota. A stable consumer
identifier is shared across reconnects and CLI/MCP processes through the
canonical publisher/credential session selector (#4217). Explicit &lt;code dir=&quot;auto&quot;&gt;--consumer&lt;/code&gt;
can select a separate receipt context; the default never derives from the
authenticated human account or mints a second process identity.&lt;/p&gt;
&lt;p&gt;Receipt contexts include the consumer, requested repo, relay admission metadata and
effective filters. Legacy credentials without team/host/repo metadata start a
fresh context on rotation conservatively;
no opaque credential is decoded or treated as proof of authorization. The relay
continues to enforce the actual authorization boundary. No account-wide mark-read
flag exists. Source event IDs are normalized through the event contract package;
frames without a source event ID use relay epoch and sequence. Replay ignores
receipts intentionally, but still respects settings and context bounds.&lt;/p&gt;
&lt;h2 id=&quot;design-decisions-and-limitations&quot;&gt;Design decisions and limitations&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Receipts are acknowledged explicitly, not on frame selection or rate rejection.&lt;/li&gt;
&lt;li&gt;A bounded receipt store fails explicitly when full instead of forgetting old
identities silently. It contains no local event archive.&lt;/li&gt;
&lt;li&gt;Withheld frames do not advance a delivery cursor. Catch-up re-reads retained
history and suppresses receipts before spending the context budget.&lt;/li&gt;
&lt;li&gt;Existing history is bounded and volatile. &lt;code dir=&quot;auto&quot;&gt;gap&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;reset&lt;/code&gt; and truncation remain
visible; an empty result does not establish that nothing ever happened.&lt;/li&gt;
&lt;li&gt;Relay #295 owns own-publisher suppression. Agent stream and history readers
request &lt;code dir=&quot;auto&quot;&gt;filterOwn=true&lt;/code&gt;, forward both cached issuer session refs, and require
the relay acknowledgment before consuming frames. They never derive opaque
references locally or filter by human account. Missing identity fails loudly.
CLI raw mode and MCP &lt;code dir=&quot;auto&quot;&gt;filter_own=false&lt;/code&gt; explicitly include own activity.
The relay acceptance suite exercises real command publication and a separate
CLI reader process against these candidates.&lt;/li&gt;
&lt;li&gt;Relay #296 owns race-safe history/live handoff. Explicit history and live watch
here remain separate reads, with overlap deduplicated after acknowledgement;
this implementation does not claim a gap-free initial snapshot/live handoff.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;issue-matrix&quot;&gt;Issue matrix&lt;/h2&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Issue&lt;/th&gt;&lt;th&gt;Claim&lt;/th&gt;&lt;th&gt;Delivery&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;spec-kitty/spec-kitty#4216&lt;/td&gt;&lt;td&gt;Assigned and &lt;code dir=&quot;auto&quot;&gt;status:claimed&lt;/code&gt;; Op in the provenance footnote&lt;/td&gt;&lt;td&gt;Client defaults/policy/receipts/catch-up and relay-backed own-identity integration&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;spec-kitty/spec-kitty-zeitgeist#295&lt;/td&gt;&lt;td&gt;External dependency&lt;/td&gt;&lt;td&gt;Verified publisher/subscriber identity and relay own-event suppression&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;spec-kitty/spec-kitty-zeitgeist#296&lt;/td&gt;&lt;td&gt;External dependency&lt;/td&gt;&lt;td&gt;Initial snapshot and race-safe history/live handoff&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;tooling-friction&quot;&gt;Tooling friction&lt;/h2&gt;
&lt;p&gt;The prep inventory rejects the current owner-qualified CLI name. Its historical
&lt;code dir=&quot;auto&quot;&gt;spec-kitty&lt;/code&gt; entry follows GitHub’s redirect to &lt;code dir=&quot;auto&quot;&gt;spec-kitty/spec-kitty&lt;/code&gt; correctly.
&lt;code dir=&quot;auto&quot;&gt;uv sync --frozen --all-extras&lt;/code&gt; warmed the checkout; pytest separately constructs
its own cached subprocess environment. The installed Spec Kitty dispatch opened
the Op and loaded governance; no mission or fabricated workflow state was created.&lt;/p&gt;
&lt;p&gt;The installed &lt;code dir=&quot;auto&quot;&gt;profile-invocation complete --artifact&lt;/code&gt; coerced the PR URL to a
filesystem path (&lt;code dir=&quot;auto&quot;&gt;https:/...&lt;/code&gt;). The canonical Op log is preserved verbatim;
its evidence document is this file, which carries the correct PR link above.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;em&gt;Provenance.&lt;/em&gt; Governed Op &lt;code dir=&quot;auto&quot;&gt;01M2808ND3ATY3DGYTG470R04A&lt;/code&gt; (a spec-kitty invocation record). The
original Op closed with outcome &lt;code dir=&quot;auto&quot;&gt;failed&lt;/code&gt; while the relay contract was pending. The continuation
integrated relay #295 (&lt;code dir=&quot;auto&quot;&gt;spec-kitty/spec-kitty-zeitgeist#295&lt;/code&gt;, the upstream relay) using the merged
#4217 issuer identity contract; the original Op log remains unchanged.&lt;/p&gt;</content>
</entry>
