<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/context/lexical/">
  <id>https://docs.spec-kitty.ai/context/lexical/</id>
  <title>Context: Lexical</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/lexical/"/>
  <summary>Glossary context for the glossary&apos;s own data model: how terms are represented, resolved, and tracked, including the term-surface concept.</summary>
  <content type="html">&lt;h2 id=&quot;context-lexical&quot;&gt;Context: Lexical&lt;/h2&gt;
&lt;p&gt;Terms describing the glossary’s own internal data model — how terms are represented, resolved, and tracked.&lt;/p&gt;
&lt;h3 id=&quot;term-surface&quot;&gt;Term Surface&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 raw text of a domain term as it appears in mission inputs or outputs, before the system determines what it means. For example, the word “agent” is a term surface that could mean different things in different contexts.&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;Lexical&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;#term-sense&quot;&gt;Term Sense&lt;/a&gt;, &lt;a href=&quot;/context/system-events/#glossary-scope&quot;&gt;Glossary Scope&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;term-sense&quot;&gt;Term Sense&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 specific meaning of a term surface within a particular glossary scope. Carries the definition, where it came from (provenance), how confident the system is in it, and its status: &lt;code dir=&quot;auto&quot;&gt;draft&lt;/code&gt; (auto-extracted), &lt;code dir=&quot;auto&quot;&gt;active&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;deprecated&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;TermSense&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;SenseStatus&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;src/glossary/models.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;Lexical&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;#term-surface&quot;&gt;Term Surface&lt;/a&gt;, &lt;a href=&quot;#provenance&quot;&gt;Provenance&lt;/a&gt;, &lt;a href=&quot;#confidence-score&quot;&gt;Confidence Score&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;provenance&quot;&gt;Provenance&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;Metadata recording where a term sense or artifact originated — who created it, when, and how (e.g., entered by the Human-in-Charge during clarification, extracted automatically from a spec, or seeded from a YAML file). The &lt;code dir=&quot;auto&quot;&gt;source&lt;/code&gt; field records values such as &lt;code dir=&quot;auto&quot;&gt;user_clarification&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;seed_file&lt;/code&gt; and the extraction heuristics (&lt;code dir=&quot;auto&quot;&gt;metadata_hint&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;quoted_phrase&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;acronym&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;casing_pattern&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;repeated_noun&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;Lexical&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;#term-sense&quot;&gt;Term Sense&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;confidence-score&quot;&gt;Confidence Score&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 value between 0.0 and 1.0 indicating how certain the system is about a term extraction or sense resolution. Higher values mean higher certainty. It feeds conflict severity scoring (&lt;code dir=&quot;auto&quot;&gt;score_severity&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;src/glossary/conflict.py&lt;/code&gt;): an unknown term with confidence below 0.5 at a critical step scores high severity, which blocks generation under &lt;code dir=&quot;auto&quot;&gt;medium&lt;/code&gt; strictness.&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;Lexical&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;#term-sense&quot;&gt;Term Sense&lt;/a&gt;, &lt;a href=&quot;/context/execution/#semantic-check&quot;&gt;Semantic Check&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;</content>
</entry>
