<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/context/identity-fields/">
  <id>https://docs.spec-kitty.ai/context/identity-fields/</id>
  <title>Context: Identity Fields</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/identity-fields/"/>
  <summary>Glossary context for the 3-tier identity model from mission 081: the repository, collaboration, and build/machine identity fields and their boundaries.</summary>
  <content type="html">&lt;h2 id=&quot;context-identity-fields&quot;&gt;Context: Identity Fields&lt;/h2&gt;
&lt;p&gt;Terms describing the 3-tier identity model that mission 081 defined as a terminology contract. Mission 081 named the fields; it did not rename them in the code. The code still uses the earlier names (&lt;code dir=&quot;auto&quot;&gt;ProjectIdentity&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/identity/project.py&lt;/code&gt;, written by &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; under &lt;code dir=&quot;auto&quot;&gt;project:&lt;/code&gt; as &lt;code dir=&quot;auto&quot;&gt;uuid&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;slug&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;node_id&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;build_id&lt;/code&gt; and an optional &lt;code dir=&quot;auto&quot;&gt;repo_slug&lt;/code&gt;). Each entry below says what the code holds today. The identity layer separates three boundary levels:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Repository&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;repository_uuid&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;repository_label&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;repo_slug&lt;/code&gt;): The local Git resource. &lt;code dir=&quot;auto&quot;&gt;repository_uuid&lt;/code&gt; is the primary stable identity, minted once per repository. &lt;code dir=&quot;auto&quot;&gt;repo_slug&lt;/code&gt; is the optional &lt;code dir=&quot;auto&quot;&gt;owner/repo&lt;/code&gt; Git provider reference.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Collaboration&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;project_uuid&lt;/code&gt;): In mission 081’s contract, an optional external binding to a hosted project. Nothing in open-core assigns it (#6164); in the code, &lt;code dir=&quot;auto&quot;&gt;project_uuid&lt;/code&gt; is the locally minted repository identity.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Build / Machine&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;build_id&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;node_id&lt;/code&gt;): Build and machine fingerprints for execution context isolation.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;See &lt;code dir=&quot;auto&quot;&gt;kitty-specs/081-canonical-baseline-and-repository-boundary/spec.md&lt;/code&gt; for the full contract.&lt;/p&gt;
&lt;h3 id=&quot;repository_uuid&quot;&gt;repository_uuid&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;Stable local repository identity, minted once per repository. Mission 081 gave this name to the value the code calls &lt;code dir=&quot;auto&quot;&gt;project_uuid&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;Identity Fields&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;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Scope&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Repository&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;This is the primary local identity. It must never be reassigned or reused across different repositories. The code has not been renamed: the value is still stored as &lt;code dir=&quot;auto&quot;&gt;project.uuid&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Code today&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;No &lt;code dir=&quot;auto&quot;&gt;repository_uuid&lt;/code&gt; field exists in &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt;. The value is still &lt;code dir=&quot;auto&quot;&gt;ProjectIdentity.project_uuid&lt;/code&gt;, a UUID4 that &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; mints locally and writes to &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; as &lt;code dir=&quot;auto&quot;&gt;project.uuid&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;generate_project_uuid&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;ensure_identity&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;#repository_label&quot;&gt;repository_label&lt;/a&gt;, &lt;a href=&quot;#project_uuid&quot;&gt;project_uuid&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#repository&quot;&gt;Repository&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;repository_label&quot;&gt;repository_label&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;Human-readable repository display name derived from git remote or directory name. Mutable, not a stable identity. Mission 081 gave this name to the value the code calls &lt;code dir=&quot;auto&quot;&gt;project_slug&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;Identity Fields&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;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Scope&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Repository&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;Display-only value used in CLI output. Must not be used as a namespace key or deduplication anchor because it can change.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Code today&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;No &lt;code dir=&quot;auto&quot;&gt;repository_label&lt;/code&gt; field exists in &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt;. The value is still &lt;code dir=&quot;auto&quot;&gt;ProjectIdentity.project_slug&lt;/code&gt;, written as &lt;code dir=&quot;auto&quot;&gt;project.slug&lt;/code&gt; and derived from the git remote’s repository name or, without a remote, the directory name (&lt;code dir=&quot;auto&quot;&gt;derive_project_slug&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;#repository_uuid&quot;&gt;repository_uuid&lt;/a&gt;, &lt;a href=&quot;#repo_slug&quot;&gt;repo_slug&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#repository&quot;&gt;Repository&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;project_uuid&quot;&gt;project_uuid&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;In mission 081’s contract: an optional collaboration identity that a hosted service would assign when a repository is bound to a project.&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;Identity Fields&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;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Scope&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Collaboration&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 hosted surfaces were removed from open-core (#6164), so nothing in this repository assigns such an identity.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Code today&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The field named &lt;code dir=&quot;auto&quot;&gt;project_uuid&lt;/code&gt; in the code is the locally minted repository identity that 081 calls &lt;a href=&quot;#repository_uuid&quot;&gt;repository_uuid&lt;/a&gt;: &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; generates it as a UUID4 and writes it to &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; as &lt;code dir=&quot;auto&quot;&gt;project.uuid&lt;/code&gt;. It is locally minted, not assigned.&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;#repository_uuid&quot;&gt;repository_uuid&lt;/a&gt;, &lt;a href=&quot;#repo_slug&quot;&gt;repo_slug&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#project&quot;&gt;Project&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;repo_slug&quot;&gt;repo_slug&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 &lt;code dir=&quot;auto&quot;&gt;owner/repo&lt;/code&gt; Git provider reference (e.g. &lt;code dir=&quot;auto&quot;&gt;spec-kitty/spec-kitty&lt;/code&gt;). Unchanged from pre-081 meaning.&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;Identity Fields&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;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Scope&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Repository&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;In the code it is an optional operator override stored as &lt;code dir=&quot;auto&quot;&gt;project.repo_slug&lt;/code&gt;; it is not generated automatically (&lt;code dir=&quot;auto&quot;&gt;ProjectIdentity.with_defaults&lt;/code&gt;). This is a repository-scoped field: it names the repository on the Git provider, not a hosted collaboration binding.&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;#repository_label&quot;&gt;repository_label&lt;/a&gt;, &lt;a href=&quot;#repository_uuid&quot;&gt;repository_uuid&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#repository&quot;&gt;Repository&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;build_id&quot;&gt;build_id&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;Build identity, written to &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; as &lt;code dir=&quot;auto&quot;&gt;project.build_id&lt;/code&gt;. Unchanged from pre-081.&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;Identity Fields&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;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Scope&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Build&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;When it is missing, the code derives it deterministically as a UUID5 of &lt;code dir=&quot;auto&quot;&gt;project_uuid&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;node_id&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;derive_build_id&lt;/code&gt;), so one project on one machine gets the same value across calls.&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;#node_id&quot;&gt;node_id&lt;/a&gt;, &lt;a href=&quot;#repository_uuid&quot;&gt;repository_uuid&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#build&quot;&gt;Build&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;node_id&quot;&gt;node_id&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;Stable machine fingerprint (12-char hex). Unchanged from pre-081.&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;Identity Fields&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;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Scope&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Machine&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 first 12 hex characters of a SHA-256 of the hostname and user name (&lt;code dir=&quot;auto&quot;&gt;generate_node_id&lt;/code&gt;), so it is stable across CLI restarts and differs per user on a shared machine. Used alongside &lt;code dir=&quot;auto&quot;&gt;build_id&lt;/code&gt; to fully qualify an execution context.&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;#build_id&quot;&gt;build_id&lt;/a&gt;, &lt;a href=&quot;#repository_uuid&quot;&gt;repository_uuid&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;</content>
</entry>
