<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/governed-profile-invocation/">
  <id>https://docs.spec-kitty.ai/architecture/governed-profile-invocation/</id>
  <title>Understanding Governed Profile Invocation</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/architecture/governed-profile-invocation/"/>
  <summary>How standalone dispatch works under governance: route, inject context, open an Op, do work, close the trail.</summary>
  <content type="html">&lt;span id=&quot;understanding-governed-profile-invocation&quot;&gt;&lt;/span&gt;
&lt;p&gt;This document explains governed profile invocation. For how to run a governed
mission, see &lt;a href=&quot;/guides/how-to/governance/run-governed-mission/&quot;&gt;How to Run a Governed Mission&lt;/a&gt;.
For the CLI reference, see
&lt;a href=&quot;/api/profile-invocation/&quot;&gt;Profile Invocation Reference&lt;/a&gt;.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;the-governed-invocation-primitive&quot;&gt;The Governed Invocation Primitive&lt;/h2&gt;
&lt;p&gt;Standalone governed work in Spec Kitty is a triple:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Profile&lt;/strong&gt;: the resolved agent profile used to select the right governance
context. Users normally do not need to choose this; the router does it. A
caller can pass &lt;code dir=&quot;auto&quot;&gt;--profile &amp;#x3C;profile-id&gt;&lt;/code&gt; when they intentionally want a
specific profile.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Action&lt;/strong&gt;: the action token resolved for the request, such as &lt;code dir=&quot;auto&quot;&gt;implement&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;review&lt;/code&gt;, or &lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Governance context&lt;/strong&gt;: the Charter bundle context injected at invocation
time. This is the DRG-derived, action-scoped set of directives, tactics, and
glossary terms that the agent receives.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;When &lt;code dir=&quot;auto&quot;&gt;spec-kitty next&lt;/code&gt; prepares a prompt for the current mission step, it
resolves the action and renders governance context into the prompt file returned
to the calling agent. For standalone work, &lt;code dir=&quot;auto&quot;&gt;spec-kitty dispatch &quot;&amp;#x3C;request&gt;&quot;&lt;/code&gt;
does the same governance-context loading and records an Op trail.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;standalone-dispatch&quot;&gt;Standalone Dispatch&lt;/h2&gt;
&lt;p&gt;Use standalone dispatch when the user wants Spec Kitty involved but is not
asking for a full mission:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;uv&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;run&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;dispatch&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Review this approach&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--json&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;uv&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;run&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;dispatch&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Implement token validation&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--profile&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;implementer-ivan&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--json&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The command returns &lt;code dir=&quot;auto&quot;&gt;governance_context_text&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;invocation_id&lt;/code&gt;, and a
&lt;code dir=&quot;auto&quot;&gt;close_contract&lt;/code&gt;. The host agent must read &lt;code dir=&quot;auto&quot;&gt;governance_context_text&lt;/code&gt;, treat it
as binding context, do the work, then close the Op.&lt;/p&gt;
&lt;h3 id=&quot;re-dispatching-without-re-embedding-the-payload-6990&quot;&gt;Re-dispatching without re-embedding the payload (#6990)&lt;/h3&gt;
&lt;p&gt;Every dispatch assembles and returns the whole governance context — ~24 KB on
this repository, mostly the profile-cited directives. A harness that dispatches
repeatedly pays that as prompt context on every call, although after the first
read the marginal information is near zero. &lt;code dir=&quot;auto&quot;&gt;--brief&lt;/code&gt; makes that re-read
cheap without changing what is loaded:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;uv&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;run&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;dispatch&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Implement token validation&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--profile&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;python-pedro&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--brief&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--json&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;With &lt;code dir=&quot;auto&quot;&gt;--brief&lt;/code&gt; the envelope keeps every routing and orientation field (profile,
action, router confidence, alternatives, model-routing advice,
&lt;code dir=&quot;auto&quot;&gt;governance_context_hash&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;invocation_id&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;close_contract&lt;/code&gt;) and replaces
&lt;code dir=&quot;auto&quot;&gt;governance_context_text&lt;/code&gt; with &lt;code dir=&quot;auto&quot;&gt;null&lt;/code&gt; plus
&lt;code dir=&quot;auto&quot;&gt;governance_context_reference&lt;/code&gt;:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;json&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;governance_context_reference&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: {&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;digest&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;367d55bc23c18daf&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;bytes&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;23739&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;lines&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;308&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;fetch_command&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;spec-kitty charter context --action generate --profile python-pedro --json --no-mark-loaded&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;action&lt;/code&gt; here is the payload’s own derived action — &lt;code dir=&quot;auto&quot;&gt;generate&lt;/code&gt;, the
implementer role’s default verb for that request, not the word “Implement” the
caller typed. The reference therefore always names the grain that was actually
omitted, and the printed command re-renders that grain. &lt;code dir=&quot;auto&quot;&gt;digest&lt;/code&gt; is the first
16 hex characters of the SHA-256 of the text, the same value the envelope’s
&lt;code dir=&quot;auto&quot;&gt;governance_context_hash&lt;/code&gt; carries, so a consumer can verify a fetched &lt;code dir=&quot;auto&quot;&gt;text&lt;/code&gt;
against it.&lt;/p&gt;
&lt;p&gt;Three rules make this safe:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Opt-in, never automatic.&lt;/strong&gt; There is no session detection and no state file;
dispatch still assembles governance on every call. Use &lt;code dir=&quot;auto&quot;&gt;--brief&lt;/code&gt; only when
this session has already read the full text for the resolved profile and
action — the first contact must be the full payload (or the fetch command).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The reference must resolve.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;--brief&lt;/code&gt; leaves the payload untouched when
there is no text or no way to reproduce it — governance unavailable, an
empty render, or the empty-charter fallback (whose render suppresses the
project resolver and &lt;code dir=&quot;auto&quot;&gt;charter context&lt;/code&gt; cannot reproduce it) — so it never
hides governance it cannot hand back.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The fetch command is exact.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;--json&lt;/code&gt; gives the byte-identical &lt;code dir=&quot;auto&quot;&gt;text&lt;/code&gt;
field (the plain render wraps long lines to the terminal width), and
&lt;code dir=&quot;auto&quot;&gt;--no-mark-loaded&lt;/code&gt; mirrors dispatch’s own &lt;code dir=&quot;auto&quot;&gt;mark_loaded=False&lt;/code&gt;, so fetching
does not record a first-load and shrink the next mission prompt.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The reference is a command that rebuilds the text on fetch, not a snapshot, so
a charter, DRG or profile change made between dispatch and fetch can make the
fetched text differ from the one &lt;code dir=&quot;auto&quot;&gt;digest&lt;/code&gt; describes. The consumer must compare
the first 16 hex characters of the SHA-256 of the fetched &lt;code dir=&quot;auto&quot;&gt;text&lt;/code&gt; with &lt;code dir=&quot;auto&quot;&gt;digest&lt;/code&gt;
and, on a mismatch, discard it and re-dispatch without &lt;code dir=&quot;auto&quot;&gt;--brief&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;The Op record, the glossary scan and the routing decision are unchanged in
brief mode: only the rendered text is replaced.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;invocation-lifecycle&quot;&gt;Invocation Lifecycle&lt;/h2&gt;
&lt;p&gt;Every standalone dispatch follows the same append-only lifecycle:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Opened&lt;/strong&gt;: A &lt;code dir=&quot;auto&quot;&gt;started&lt;/code&gt; event is written to
&lt;code dir=&quot;auto&quot;&gt;kitty-ops/{invocation_id}.jsonl&lt;/code&gt; before the executor returns. This write is
unconditional: it happens regardless of SaaS connectivity or charter state.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Work happens outside the CLI&lt;/strong&gt;: The CLI has returned the context payload.
The caller or agent performs the work.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Completed&lt;/strong&gt;: When execution finishes, &lt;code dir=&quot;auto&quot;&gt;spec-kitty profile-invocation complete&lt;/code&gt; closes the trail. This appends a &lt;code dir=&quot;auto&quot;&gt;completed&lt;/code&gt; event to the same
JSONL file. &lt;code dir=&quot;auto&quot;&gt;--artifact&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;--commit&lt;/code&gt; append separate correlation events
after the completed event.&lt;/li&gt;
&lt;/ol&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;uv&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;run&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;profile-invocation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;complete&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--invocation-id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;ULID&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--outcome&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;done&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--artifact&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;path/to/produced/file.md&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--commit&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;git-sha&gt;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Options for &lt;code dir=&quot;auto&quot;&gt;profile-invocation complete&lt;/code&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;--outcome&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;failed&lt;/code&gt;, or &lt;code dir=&quot;auto&quot;&gt;abandoned&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;--artifact&lt;/code&gt;: path to an artifact produced by this invocation (repeatable)&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;--commit&lt;/code&gt;: the primary git commit SHA produced by this invocation (singular)&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;--evidence&lt;/code&gt;: promote a file to a Tier 2 evidence artifact when the record is
evidence-eligible&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;the-invocation-trail&quot;&gt;The Invocation Trail&lt;/h2&gt;
&lt;p&gt;The invocation trail is the local audit record written by every governed
invocation. It provides:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Local accountability&lt;/strong&gt;: operators can reconstruct what happened on any
checkout without SaaS connectivity.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SaaS coherence&lt;/strong&gt;: the dashboard timeline shows the same history as the
local audit log.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Governance provenance&lt;/strong&gt;: retrospective and doctrine work can reference
specific invocations.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Trail files live at &lt;code dir=&quot;auto&quot;&gt;kitty-ops/{invocation_id}.jsonl&lt;/code&gt;: one JSONL file per
invocation. Each line is an event (&lt;code dir=&quot;auto&quot;&gt;started&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;completed&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary_checked&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;artifact_link&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;commit_link&lt;/code&gt;, or future additive events).&lt;/p&gt;
&lt;p&gt;Key fields on the &lt;code dir=&quot;auto&quot;&gt;started&lt;/code&gt; event:&lt;/p&gt;













































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Field&lt;/th&gt;&lt;th&gt;Type&lt;/th&gt;&lt;th&gt;Description&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;profile_id&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Resolved profile identifier&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;action&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Resolved action token&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;request_text&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Request supplied to &lt;code dir=&quot;auto&quot;&gt;dispatch&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;governance_context_hash&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Hash of the rendered Charter context&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;governance_context_available&lt;/code&gt;&lt;/td&gt;&lt;td&gt;boolean&lt;/td&gt;&lt;td&gt;Whether Charter context was available&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;started_at&lt;/code&gt;&lt;/td&gt;&lt;td&gt;ISO timestamp&lt;/td&gt;&lt;td&gt;When the invocation was opened&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;mode_of_work&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;Work mode used for trail policy&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Key fields on the &lt;code dir=&quot;auto&quot;&gt;completed&lt;/code&gt; event:&lt;/p&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Field&lt;/th&gt;&lt;th&gt;Type&lt;/th&gt;&lt;th&gt;Description&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;invocation_id&lt;/code&gt;&lt;/td&gt;&lt;td&gt;ULID&lt;/td&gt;&lt;td&gt;Matches the &lt;code dir=&quot;auto&quot;&gt;started&lt;/code&gt; event&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;outcome&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;failed&lt;/code&gt;, or &lt;code dir=&quot;auto&quot;&gt;abandoned&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;completed_at&lt;/code&gt;&lt;/td&gt;&lt;td&gt;ISO timestamp&lt;/td&gt;&lt;td&gt;When &lt;code dir=&quot;auto&quot;&gt;profile-invocation complete&lt;/code&gt; was called&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;closed_by&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;agent&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;doctor_sweep&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;evidence_ref&lt;/code&gt;&lt;/td&gt;&lt;td&gt;string/null&lt;/td&gt;&lt;td&gt;Evidence path or text supplied with &lt;code dir=&quot;auto&quot;&gt;--evidence&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id=&quot;evidence-and-artifact-correlation&quot;&gt;Evidence and Artifact Correlation&lt;/h2&gt;
&lt;p&gt;Artifacts produced during an invocation are linked back to the trail record via
separate &lt;code dir=&quot;auto&quot;&gt;artifact_link&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;commit_link&lt;/code&gt; events appended by the &lt;code dir=&quot;auto&quot;&gt;--artifact&lt;/code&gt;
and &lt;code dir=&quot;auto&quot;&gt;--commit&lt;/code&gt; options on &lt;code dir=&quot;auto&quot;&gt;profile-invocation complete&lt;/code&gt;. This correlation
provides:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A local audit link from an invocation to the artifacts or commit it produced&lt;/li&gt;
&lt;li&gt;Governance provenance context for humans and future automated consumers&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Evidence files promoted via &lt;code dir=&quot;auto&quot;&gt;--evidence&lt;/code&gt; receive Tier 2 status in the trail.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See Also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/context/charter-overview/&quot;&gt;How Charter Works&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/governance/run-governed-mission/&quot;&gt;How to Run a Governed Mission&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/profile-invocation/&quot;&gt;Profile Invocation Reference&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
