spine-framework 0.4.4 → 0.5.0-rc.4

package/.framework/tests/unit/agent-runner.test.ts

@@ -1,4 +1,19 @@
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/tests/unit/agent-runner.test.ts"]
+/**
+ * @module   agent-runner.test
+ * @audience both
+ * @layer    shared-core
+ * @stability stable
+ *
+ * This module sets up the testing environment for the agent-runner functionality by configuring mocks for various dependencies such as database access, audit logging, and external integrations. It ensures that all necessary components are mocked before the actual agent-runner functions are imported for testing. INVARIANT: All mocks must be properly configured to avoid test failures due to missing dependencies.
+ *
+ * @seeAlso db.ts (provides database access functionality).
+ * @seeAlso audit.ts (handles audit logging).
+ * @seeAlso outcomes.ts (manages outcome emissions).
+ * @seeAlso llm.ts (interfaces with language model APIs).
+ *
+ * @cil-generated
+ */
 // CIL[DOC-MACRO purpose="Test setup and imports for agent-runner tests"]
 // CIL[DOC-RESPONSIBILITY responsibility="Configure module mocks for db, audit, outcomes, llm, admin-data, integration-outbound, and pipeline-runner, then import the agent-runner surface under test"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -9,6 +24,7 @@
 // CIL[DOC-AUDIENCE audience="test maintainers"]
 import { describe, it, expect, vi, beforeEach } from 'vitest'
 import type { CoreContext } from '../../functions/_shared/middleware.ts'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:module_header:module_header"]
 
 vi.mock('../../functions/_shared/db.ts', () => ({
   adminDb: { from: vi.fn(), rpc: vi.fn() }
@@ -61,9 +77,7 @@ import { emitSignal } from '../../functions/_shared/funnel.ts'
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:module_header:module_header"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:makeCtx:function" type="function" identity="makeCtx" parent="none"]
 // CIL[DOC-MACRO purpose="Create a test CoreContext with a system principal"]
 // CIL[DOC-RESPONSIBILITY responsibility="Generate CoreContext objects for direct agent-runner calls"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -71,6 +85,19 @@ import { emitSignal } from '../../functions/_shared/funnel.ts'
 // CIL[DOC-MICRO logic_summary="Returns a machine-principal context with accountId acct-test and applies overrides" notable_decisions="[]"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:makeCtx:function" type="function" identity="makeCtx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
+/**
+ * Creates a test CoreContext with a system principal for unit testing purposes. This function allows for the customization of the context through optional overrides.
+ *
+ * @macro       Context generator for unit tests providing a default CoreContext structure.
+ * @micro       Merges default context values with any provided overrides to create a complete CoreContext object.
+ * @inputSpec
+ *   overrides: Partial<CoreContext> (optional) — custom values to override the default context properties.
+ * @outputSpec  CoreContext — an object representing the context with merged default and overridden properties.
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
 function makeCtx(overrides: Partial<CoreContext> = {}): CoreContext {
   return {
     principal: {
@@ -87,15 +114,14 @@ function makeCtx(overrides: Partial<CoreContext> = {}): CoreContext {
     ...overrides
   } as CoreContext
 }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:makeCtx:function"]
 // CIL[DOC-VECTOR type="context" content="purpose='Create a test CoreContext with a system principal'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:makeCtx:function"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:test_ids:block" type="block" identity="test_ids" parent="none"]
 // CIL[DOC-MACRO purpose="Shared test identifiers"]
 // CIL[DOC-RESPONSIBILITY responsibility="Provide consistent thread, agent, and prompt-config IDs across tests"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -103,18 +129,29 @@ function makeCtx(overrides: Partial<CoreContext> = {}): CoreContext {
 // CIL[DOC-MICRO logic_summary="Defines THREAD_ID, AGENT_ID, and PROMPT_CONFIG_ID constants" notable_decisions="[]"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:THREAD_ID:constant" type="constant" identity="THREAD_ID" parent="~/.framework/tests/unit/agent-runner.test.ts"]
 const THREAD_ID = 'thread-1'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:THREAD_ID:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:AGENT_ID:constant" type="constant" identity="AGENT_ID" parent="~/.framework/tests/unit/agent-runner.test.ts"]
+/**
+ * AGENT_ID is a constant that holds the identifier for the agent used in tests. It exists to provide a consistent reference to the agent's ID throughout the test suite.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
 const AGENT_ID = 'agent-1'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:AGENT_ID:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:PROMPT_CONFIG_ID:constant" type="constant" identity="PROMPT_CONFIG_ID" parent="~/.framework/tests/unit/agent-runner.test.ts"]
 const PROMPT_CONFIG_ID = 'prompt-1'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:PROMPT_CONFIG_ID:constant"]
 // CIL[DOC-VECTOR type="context" content="purpose='Shared test identifiers'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:test_ids:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockThread:function" type="function" identity="mockThread" parent="none"]
 // CIL[DOC-MACRO purpose="Build a thread fixture"]
 // CIL[DOC-RESPONSIBILITY responsibility="Return a thread record with data overrides for agent config resolution"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -122,6 +159,7 @@ const PROMPT_CONFIG_ID = 'prompt-1'
 // CIL[DOC-MICRO logic_summary="Builds a thread row with id THREAD_ID and merges data overrides" notable_decisions="[]"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockThread:function" type="function" identity="mockThread" parent="~/.framework/tests/unit/agent-runner.test.ts"]
 function mockThread(overrides: Record<string, any> = {}) {
   return {
     id: THREAD_ID,
@@ -135,15 +173,14 @@ function mockThread(overrides: Record<string, any> = {}) {
     ...overrides
   }
 }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockThread:function"]
 // CIL[DOC-VECTOR type="context" content="purpose='Build a thread fixture'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockThread:function"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockAgent:function" type="function" identity="mockAgent" parent="none"]
 // CIL[DOC-MACRO purpose="Build an agent fixture"]
 // CIL[DOC-RESPONSIBILITY responsibility="Return an agent record with model_config overrides"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -151,6 +188,7 @@ function mockThread(overrides: Record<string, any> = {}) {
 // CIL[DOC-MICRO logic_summary="Builds an agent row with id AGENT_ID and merges model_config overrides" notable_decisions="[]"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockAgent:function" type="function" identity="mockAgent" parent="~/.framework/tests/unit/agent-runner.test.ts"]
 function mockAgent(overrides: Record<string, any> = {}) {
   return {
     id: AGENT_ID,
@@ -162,15 +200,14 @@ function mockAgent(overrides: Record<string, any> = {}) {
     ...overrides
   }
 }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockAgent:function"]
 // CIL[DOC-VECTOR type="context" content="purpose='Build an agent fixture'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockAgent:function"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockPromptConfig:function" type="function" identity="mockPromptConfig" parent="none"]
 // CIL[DOC-MACRO purpose="Build a prompt config fixture"]
 // CIL[DOC-RESPONSIBILITY responsibility="Return a prompt config record with metadata overrides"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -178,6 +215,7 @@ function mockAgent(overrides: Record<string, any> = {}) {
 // CIL[DOC-MICRO logic_summary="Builds a prompt_configs row with id PROMPT_CONFIG_ID and merges metadata overrides" notable_decisions="[]"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockPromptConfig:function" type="function" identity="mockPromptConfig" parent="~/.framework/tests/unit/agent-runner.test.ts"]
 function mockPromptConfig(overrides: Record<string, any> = {}) {
   return {
     id: PROMPT_CONFIG_ID,
@@ -189,15 +227,14 @@ function mockPromptConfig(overrides: Record<string, any> = {}) {
     ...overrides
   }
 }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockPromptConfig:function"]
 // CIL[DOC-VECTOR type="context" content="purpose='Build a prompt config fixture'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockPromptConfig:function"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:setupAgentConfigMocks:function" type="function" identity="setupAgentConfigMocks" parent="none"]
 // CIL[DOC-MACRO purpose="Mock adminDb.from queries used by agent config resolution and retrieval"]
 // CIL[DOC-RESPONSIBILITY responsibility="Return thenable Supabase-style query builders per table: threads, agents, prompt_configs, embeddings, items, and messages"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -205,6 +242,22 @@ function mockPromptConfig(overrides: Record<string, any> = {}) {
 // CIL[DOC-MICRO logic_summary="Resolves thread, agent, and prompt config lookups from fixtures; the embeddings branch is a thenable builder resolving an empty successful lexical result so the always-on lexical leg degrades quietly" notable_decisions="The embeddings thenable prevents expected lexical-failure warning noise in non-retrieval tests"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:setupAgentConfigMocks:function" type="function" identity="setupAgentConfigMocks" parent="~/.framework/tests/unit/agent-runner.test.ts"]
+/**
+ * Sets up mock implementations for database interactions related to agent configuration, threads, prompts, and other entities. This function is essential for testing components that depend on these database interactions without hitting the actual database.
+ *
+ * @macro       Mock setup function for database interactions in unit tests.
+ * @micro       Utilizes conditional logic to return different mock implementations based on the specified table name.
+ * @inputSpec
+ *   threadOverrides: Record<string, any> (optional) — overrides for thread configurations.
+ *   agentOverrides: Record<string, any> (optional) — overrides for agent configurations.
+ *   promptOverrides: Record<string, any> (optional) — overrides for prompt configurations.
+ * @outputSpec  void — sets up mocks without returning a value.
+ * @sideEffects Mocks database calls for various tables, affecting how tests interact with the database layer.
+ * @stability   internal
+ * @calls       adminDb.from, mockThread, mockAgent, mockPromptConfig
+ * @cil-generated
+ */
 function setupAgentConfigMocks(
   threadOverrides: Record<string, any> = {},
   agentOverrides: Record<string, any> = {},
@@ -304,15 +357,14 @@ function setupAgentConfigMocks(
 
   vi.mocked(adminDb.rpc).mockResolvedValue({ data: [], error: null } as any)
 }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:setupAgentConfigMocks:function"]
 // CIL[DOC-VECTOR type="context" content="purpose='Mock adminDb.from queries used by agent config resolution and retrieval'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:setupAgentConfigMocks:function"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockCreateRecord:function" type="function" identity="mockCreateRecord" parent="none"]
 // CIL[DOC-MACRO purpose="Mock admin-data createRecord"]
 // CIL[DOC-RESPONSIBILITY responsibility="Control the return value of record creation in tests"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -320,18 +372,18 @@ function setupAgentConfigMocks(
 // CIL[DOC-MICRO logic_summary="Wraps vi.mocked(createRecord).mockResolvedValue" notable_decisions="[]"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockCreateRecord:function" type="function" identity="mockCreateRecord" parent="~/.framework/tests/unit/agent-runner.test.ts"]
 function mockCreateRecord(returnValue: any) {
   vi.mocked(createRecord).mockResolvedValue(returnValue)
 }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockCreateRecord:function"]
 // CIL[DOC-VECTOR type="context" content="purpose='Mock admin-data createRecord'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockCreateRecord:function"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockLlmResponse:function" type="function" identity="mockLlmResponse" parent="none"]
 // CIL[DOC-MACRO purpose="Mock callOpenAIChat JSON responses"]
 // CIL[DOC-RESPONSIBILITY responsibility="Control the LLM chat payload returned to the agent runner"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -339,18 +391,18 @@ function mockCreateRecord(returnValue: any) {
 // CIL[DOC-MICRO logic_summary="Wraps vi.mocked(callOpenAIChat).mockResolvedValue" notable_decisions="[]"]
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockLlmResponse:function" type="function" identity="mockLlmResponse" parent="~/.framework/tests/unit/agent-runner.test.ts"]
 function mockLlmResponse(response: any) {
   vi.mocked(callOpenAIChat).mockResolvedValue(response)
 }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockLlmResponse:function"]
 // CIL[DOC-VECTOR type="context" content="purpose='Mock callOpenAIChat JSON responses'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts"]
 // CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
 // CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockLlmResponse:function"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_runAgent_singleTurn:block" type="block" identity="describe_runAgent_singleTurn" parent="none"]
 // CIL[DOC-MACRO purpose="Test runAgent single-turn execution"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify single-turn agent runs return replies and persist messages"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -376,8 +428,12 @@ describe('runAgent — single-turn', () => {
     })
     mockCreateRecord({ id: 'msg-1', content: 'Here is the answer.' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant" type="constant" identity="ctx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const ctx = makeCtx()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgent(THREAD_ID, 'What is X?', ctx, 'complete')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result).toBeDefined()
     expect(createRecord).toHaveBeenCalledWith(
@@ -396,9 +452,7 @@ describe('runAgent — single-turn', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_runAgent_singleTurn:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_runAgent_stepMode:block" type="block" identity="describe_runAgent_stepMode" parent="none"]
 // CIL[DOC-MACRO purpose="Test runAgent step mode"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify step-mode agent execution and tool dispatch flow"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -420,8 +474,12 @@ describe('runAgent — step mode', () => {
     })
     mockCreateRecord({ id: 'msg-final', content: 'Final answer.' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant" type="constant" identity="ctx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const ctx = makeCtx()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgent(THREAD_ID, 'Question?', ctx, 'step')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result).toBeDefined()
     expect(createRecord).toHaveBeenCalledWith(
@@ -460,8 +518,12 @@ describe('runAgent — step mode', () => {
     })
     mockCreateRecord({ id: 'msg-ask', content: 'Which project?' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant" type="constant" identity="ctx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const ctx = makeCtx()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgent(THREAD_ID, 'Tell me about it.', ctx, 'step')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result).toBeDefined()
     expect(createRecord).toHaveBeenCalledWith(
@@ -499,8 +561,12 @@ describe('runAgent — step mode', () => {
       }
     })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant" type="constant" identity="ctx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const ctx = makeCtx()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgent(THREAD_ID, 'Question?', ctx, 'step')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result).toBeDefined()
     expect(emitSignal).not.toHaveBeenCalled()
@@ -524,10 +590,23 @@ describe('runAgent — complete mode state retention', () => {
 
     // Capture threads.update payloads — setResearchState checkpoints
     // data.research_state on each step.
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:threadUpdates:constant" type="constant" identity="threadUpdates" parent="~/.framework/tests/unit/agent-runner.test.ts"]
+/**
+ * The constant 'threadUpdates' is an array that stores updates related to threads in the agent runner tests. It exists to facilitate the tracking and management of thread-related information during testing.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
     const threadUpdates: any[] = []
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:threadUpdates:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:origFrom:constant" type="constant" identity="origFrom" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const origFrom = vi.mocked(adminDb.from).getMockImplementation()!
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:origFrom:constant"]
     vi.mocked(adminDb.from).mockImplementation(((table: string) => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:builder:constant" type="constant" identity="builder" parent="~/.framework/tests/unit/agent-runner.test.ts"]
       const builder: any = origFrom(table)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:builder:constant"]
       if (table === 'threads' && builder?.update?.mock) {
         // update() is mockReturnThis() — must return the builder, not `this`
         // captured from an unbound call.
@@ -561,23 +640,31 @@ describe('runAgent — complete mode state retention', () => {
       })
     mockCreateRecord({ id: 'msg-final', content: 'Here is the answer [1].', data: {} })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant" type="constant" identity="ctx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const ctx = makeCtx()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:ctx:constant"]
     await runAgent(THREAD_ID, 'How do I configure sshd?', ctx, 'complete', 'lease-1')
 
     expect(callOpenAIChat).toHaveBeenCalledTimes(2)
 
     // Turn 2's inference context must carry turn 1's tool output.
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:secondTurnMessages:constant" type="constant" identity="secondTurnMessages" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const secondTurnMessages = vi.mocked(callOpenAIChat).mock.calls[1][1] as any[]
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:secondTurnMessages:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:contextText:constant" type="constant" identity="contextText" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const contextText = secondTurnMessages.map((m: any) => m.content).join('\n')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:contextText:constant"]
     expect(contextText).toContain('## Tool Results')
     expect(contextText).toContain('search_knowledge')
 
     // The final checkpoint shows one accumulated result over two turns, and
     // the driver token is stamped as the lease owner.
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:lastState:constant" type="constant" identity="lastState" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const lastState = threadUpdates
       .map(u => u?.data?.research_state)
       .filter(Boolean)
       .pop()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:lastState:constant"]
     expect(lastState.turn_count).toBe(2)
     expect(lastState.gathered_results).toHaveLength(1)
     expect(lastState.status).toBe('complete')
@@ -589,6 +676,7 @@ describe('runAgent — complete mode state retention', () => {
 describe('runAgent — evidence-based escalation gating', () => {
   beforeEach(() => vi.clearAllMocks())
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:evidenceRpc:function" type="function" identity="evidenceRpc" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   const evidenceRpc = () => {
     vi.mocked(adminDb.rpc).mockResolvedValue({
       data: [{
@@ -601,6 +689,7 @@ describe('runAgent — evidence-based escalation gating', () => {
       error: null
     } as any)
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:evidenceRpc:function"]
 
   it('does not escalate an evidence_found answer below the confidence threshold', async () => {
     // Regression: sanitizeRecordData strips data.* keys the message type does
@@ -626,8 +715,10 @@ describe('runAgent — evidence-based escalation gating', () => {
 
     await runAgent(THREAD_ID, 'Question?', makeCtx(), 'complete', 'lease-1')
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:escalated:constant" type="constant" identity="escalated" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const escalated = vi.mocked(emitAudit).mock.calls
       .some((call: any[]) => call[1] === 'agent.inference.low_confidence')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:escalated:constant"]
     expect(escalated).toBe(false)
   })
 
@@ -644,8 +735,10 @@ describe('runAgent — evidence-based escalation gating', () => {
 
     await runAgent(THREAD_ID, 'Question?', makeCtx(), 'complete', 'lease-1')
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:escalated:constant" type="constant" identity="escalated" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const escalated = vi.mocked(emitAudit).mock.calls
       .some((call: any[]) => call[1] === 'agent.inference.low_confidence')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:escalated:constant"]
     expect(escalated).toBe(true)
   })
 })
@@ -655,9 +748,7 @@ describe('runAgent — evidence-based escalation gating', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_runAgent_stepMode:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_handlerModuleDispatch:block" type="block" identity="describe_executeToolAction_handlerModuleDispatch" parent="none"]
 // CIL[DOC-MACRO purpose="Test executeToolAction handler_module dispatch"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify handler_module tools dispatch to the correct module function"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -671,11 +762,13 @@ describe('executeToolAction — handler_module dispatch', () => {
   it('dispatches to executeOutbound for webhook actions', async () => {
     vi.mocked(executeOutbound).mockResolvedValue({ success: true, response_body: { ok: 1 } })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await executeToolAction(
       { handler_module: 'webhook', config: { url: 'https://example.com', method: 'POST' } },
       { foo: 'bar' },
       makeCtx()
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(executeOutbound).toHaveBeenCalled()
     expect(result).toEqual({ ok: 1 })
@@ -684,11 +777,13 @@ describe('executeToolAction — handler_module dispatch', () => {
   it('dispatches to executeOutbound for integrations actions', async () => {
     vi.mocked(executeOutbound).mockResolvedValue({ success: true, response_body: { ok: 1 } })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await executeToolAction(
       { handler_module: 'integrations', config: { integration_slug: 'github', action_config: {} } },
       { repo: 'x' },
       makeCtx()
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(executeOutbound).toHaveBeenCalledWith(
       expect.any(Object),
@@ -700,11 +795,13 @@ describe('executeToolAction — handler_module dispatch', () => {
   it('dispatches to runPipeline for pipeline actions', async () => {
     vi.mocked(runPipeline).mockResolvedValue({ status: 'completed', result: { ok: 1 } })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await executeToolAction(
       { handler_module: 'pipeline', config: { pipeline_id: 'pipe-1' } },
       { x: 1 },
       makeCtx()
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(runPipeline).toHaveBeenCalledWith('pipe-1', { x: 1 }, expect.any(Object))
     expect(result).toEqual({ success: true, result: { status: 'completed', result: { ok: 1 } } })
@@ -713,11 +810,13 @@ describe('executeToolAction — handler_module dispatch', () => {
   it('dispatches built-in functions by handler name', async () => {
     vi.mocked(adminDb.rpc).mockResolvedValue({ data: [], error: null } as any)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await executeToolAction(
       { handler: 'query_items', handler_module: 'functions' },
       { entity: 'items', limit: 5 },
       makeCtx()
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result).toEqual({ items: [] })
   })
@@ -728,9 +827,7 @@ describe('executeToolAction — handler_module dispatch', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_handlerModuleDispatch:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_runAgentStep_directQuestionFallback:block" type="block" identity="describe_runAgentStep_directQuestionFallback" parent="none"]
 // CIL[DOC-MACRO purpose="Test runAgentStep direct-question fallback and research gating"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify the ask_user gate, research tool detection, and direct-answer fallback paths"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -752,6 +849,7 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-q', content: 'Could you clarify which repository?' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
@@ -769,8 +867,11 @@ describe('runAgentStep — direct question fallback', () => {
       }),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Tell me about the code.', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('awaiting_input')
     expect(result.state.pending_question).toContain('clarify')
@@ -778,6 +879,7 @@ describe('runAgentStep — direct question fallback', () => {
 
   it('keeps a complete markdown answer with a polite sign-off as final', async () => {
     setupAgentConfigMocks()
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:answer:constant" type="constant" identity="answer" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const answer = [
       '### Overview',
       '',
@@ -797,6 +899,7 @@ describe('runAgentStep — direct question fallback', () => {
       '',
       'If you encounter any issues or need further assistance, please let me know!'
     ].join('\n')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:answer:constant"]
     mockLlmResponse({
       choices: [{
         message: { content: answer, tool_calls: undefined },
@@ -806,14 +909,18 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-final', content: answer })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Explain the engine.', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('complete')
     expect(createRecord).toHaveBeenCalledWith(
@@ -827,7 +934,9 @@ describe('runAgentStep — direct question fallback', () => {
 
   it('keeps a short answer with a sign-off as final', async () => {
     setupAgentConfigMocks()
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:answer:constant" type="constant" identity="answer" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const answer = 'Run `npm run dev` to start the server. Let me know if that works!'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:answer:constant"]
     mockLlmResponse({
       choices: [{
         message: { content: answer, tool_calls: undefined },
@@ -837,14 +946,18 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-final-2', content: answer })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'How do I start it?', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('complete')
     expect(createRecord).toHaveBeenCalledWith(
@@ -858,7 +971,9 @@ describe('runAgentStep — direct question fallback', () => {
 
   it('still treats a short question with a please-let-me-know phrase as awaiting_input', async () => {
     setupAgentConfigMocks()
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:question:constant" type="constant" identity="question" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const question = 'Please let me know which project you are working in.'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:question:constant"]
     mockLlmResponse({
       choices: [{
         message: { content: question, tool_calls: undefined },
@@ -868,6 +983,7 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-q2', content: question })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
@@ -885,8 +1001,11 @@ describe('runAgentStep — direct question fallback', () => {
       }),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Help me.', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('awaiting_input')
   })
@@ -902,6 +1021,7 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-final', content: 'Final answer.' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent({
         model_config: {
@@ -915,11 +1035,23 @@ describe('runAgentStep — direct question fallback', () => {
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
     await runAgentStep(THREAD_ID, 'Tell me about it.', makeCtx(), config)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:options:constant" type="constant" identity="options" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const options = vi.mocked(callOpenAIChat).mock.calls[0][3] as any
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:options:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant" type="constant" identity="names" parent="~/.framework/tests/unit/agent-runner.test.ts"]
+/**
+ * The 'names' constant extracts the names of functions from the tools defined in the agent's model configuration. It is used to verify the presence of the 'escalate_to_human' function in the available tools.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
     const names = (options?.tools || []).map((t: any) => t.function?.name)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant"]
     expect(names).toContain('search_knowledge')
     expect(names).not.toContain('ask_user')
   })
@@ -940,14 +1072,18 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-tool' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Tell me about it.', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('gathering')
     expect(createRecord).toHaveBeenCalledWith(
@@ -979,14 +1115,18 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-thinking' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Tell me about it.', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('gathering')
     expect(createRecord).not.toHaveBeenCalledWith(
@@ -1008,24 +1148,32 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-final', content: 'Final answer.' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig({ context_template: 'Question: {{user_message}}' }),
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
     await runAgentStep(THREAD_ID, 'Tell me about it.', makeCtx(), config)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:messages:constant" type="constant" identity="messages" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const messages = vi.mocked(callOpenAIChat).mock.calls[0][1] as any[]
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:messages:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:combined:constant" type="constant" identity="combined" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const combined = messages.map((m: any) => m.content).join('\n')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:combined:constant"]
     expect(combined).toContain('Question: Tell me about it.')
     expect(combined).not.toContain('{{user_message}}')
   })
 
   it('fences retrieved evidence as untrusted data, never instructions', async () => {
     setupAgentConfigMocks()
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant" type="constant" identity="docId" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const docId = '123e4567-e89b-42d3-a456-426614174000'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant"]
     vi.mocked(adminDb.rpc).mockResolvedValue({
       data: [{
         document_id: docId,
@@ -1036,17 +1184,21 @@ describe('runAgentStep — direct question fallback', () => {
       }],
       error: null
     } as any)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:baseImpl:constant" type="constant" identity="baseImpl" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const baseImpl = vi.mocked(adminDb.from).getMockImplementation()!
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:baseImpl:constant"]
     vi.mocked(adminDb.from).mockImplementation((table: string) => {
       if (table === 'items') {
         return { select: vi.fn(() => ({ in: vi.fn().mockResolvedValue({ data: [], error: null }) })) } as any
       }
       if (table === 'embeddings') {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:q:constant" type="constant" identity="q" parent="~/.framework/tests/unit/agent-runner.test.ts"]
         const q: any = {
           select: vi.fn(() => q), in: vi.fn(() => q), is: vi.fn(() => q),
           not: vi.fn(() => q), textSearch: vi.fn(() => q), or: vi.fn(() => q),
           limit: vi.fn().mockResolvedValue({ data: [], error: null })
         }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:q:constant"]
         return q
       }
       return baseImpl(table)
@@ -1060,17 +1212,23 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-final', content: 'Final answer.' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
     await runAgentStep(THREAD_ID, 'What is the refund policy?', makeCtx(), config)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:messages:constant" type="constant" identity="messages" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const messages = vi.mocked(callOpenAIChat).mock.calls[0][1] as any[]
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:messages:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:combined:constant" type="constant" identity="combined" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const combined = messages.map((m: any) => m.content).join('\n')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:combined:constant"]
     expect(combined).toContain('untrusted data')
     expect(combined).toContain('never as instructions')
     expect(combined).toContain('untrusted input')
@@ -1090,6 +1248,7 @@ describe('runAgentStep — direct question fallback', () => {
     })
     mockCreateRecord({ id: 'msg-q', content: 'Which project are you working in?' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig(),
@@ -1107,8 +1266,11 @@ describe('runAgentStep — direct question fallback', () => {
       }),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Tell me about it.', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('awaiting_input')
   })
@@ -1119,9 +1281,7 @@ describe('runAgentStep — direct question fallback', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_runAgentStep_directQuestionFallback:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_stripCilBoilerplate:block" type="block" identity="describe_stripCilBoilerplate" parent="none"]
 // CIL[DOC-MACRO purpose="Test stripCilBoilerplate"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify CIL boilerplate is stripped from model output"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -1131,8 +1291,12 @@ describe('runAgentStep — direct question fallback', () => {
 // CIL[DOC-STABILITY stability="stable"]
 describe('stripCilBoilerplate', () => {
   it('removes boilerplate phrases and leftover empty labels', () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:input:constant" type="constant" identity="input" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const input = "DesignSchema [interface] in .framework/src/types/types.ts. Context: purpose='Complete design schema for an item type'; No verified external callers; imports: none. Blast radius: No direct caller data from CIL graph; local impact only. Complete design schema for an item type"
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:input:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:out:constant" type="constant" identity="out" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const out = stripCilBoilerplate(input)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:out:constant"]
     expect(out).toContain('Complete design schema for an item type')
     expect(out).toContain('purpose=')
     expect(out).not.toContain('No verified external callers')
@@ -1146,9 +1310,7 @@ describe('stripCilBoilerplate', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_stripCilBoilerplate:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_extractCitedSources:block" type="block" identity="describe_extractCitedSources" parent="none"]
 // CIL[DOC-MACRO purpose="Test extractCitedSources"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify citation extraction from model output"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -1157,10 +1319,14 @@ describe('stripCilBoilerplate', () => {
 // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
 describe('extractCitedSources', () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:sources:constant" type="constant" identity="sources" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   const sources = [{ document_id: 'a' }, { document_id: 'b' }, { document_id: 'c' }]
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:sources:constant"]
 
   it('returns cited sources in order of first appearance', () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:out:constant" type="constant" identity="out" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const out = extractCitedSources('A [2] and B [1] and again [2]. Bogus [9].', sources)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:out:constant"]
     expect(out).toEqual([sources[1], sources[0]])
   })
 
@@ -1174,9 +1340,7 @@ describe('extractCitedSources', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_extractCitedSources:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_cilFetchDocument:block" type="block" identity="describe_executeToolAction_cilFetchDocument" parent="none"]
 // CIL[DOC-MACRO purpose="Test executeToolAction cil_fetch_document handler"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify CIL document fetch tool behavior and errors"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -1187,6 +1351,7 @@ describe('extractCitedSources', () => {
 describe('executeToolAction — cil_fetch_document', () => {
   beforeEach(() => vi.clearAllMocks())
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:itemsFetchQuery:function" type="function" identity="itemsFetchQuery" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function itemsFetchQuery(item: any, captured: { filterArgs?: any[] } = {}) {
     const q: any = {
       select: vi.fn(() => q),
@@ -1197,7 +1362,9 @@ describe('executeToolAction — cil_fetch_document', () => {
     }
     return q
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:itemsFetchQuery:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockFetchTables:function" type="function" identity="mockFetchTables" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function mockFetchTables(item: any, captured: { filterArgs?: any[] } = {}) {
     vi.mocked(adminDb.from).mockImplementation((table: string) => {
       if (table === 'apps') {
@@ -1226,12 +1393,17 @@ describe('executeToolAction — cil_fetch_document', () => {
       return {} as any
     })
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockFetchTables:function"]
 
   it('returns content from data.content for a KB item by UUID', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant" type="constant" identity="docId" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const docId = '123e4567-e89b-42d3-a456-426614174000'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant"]
     mockFetchTables({ id: 'item-1', title: 'Doc', data: { content: 'full body', kb_type: 'kb_article' } })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await executeToolAction({ handler: 'cil_fetch_document' }, { document_id: docId }, makeCtx())
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
 
     expect(res.content).toBe('full body')
     expect(res.item_id).toBe('item-1')
@@ -1239,14 +1411,20 @@ describe('executeToolAction — cil_fetch_document', () => {
   })
 
   it('resolves a stable_id via data->>stable_id and returns code_content', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:sid:constant" type="constant" identity="sid" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const sid = '~/.framework/src/types/types.ts:DesignSchema:interface'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:sid:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:captured:constant" type="constant" identity="captured" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const captured: { filterArgs: any[] } = { filterArgs: [] }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:captured:constant"]
     mockFetchTables(
       { id: 'item-2', title: 'DesignSchema', data: { code_content: 'export interface DesignSchema {}', kb_type: 'cil_chunk', project_id: 'proj-a', stable_id: sid } },
       captured
     )
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await executeToolAction({ handler: 'cil_fetch_document' }, { document_id: sid }, makeCtx())
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
 
     expect(captured.filterArgs).toContainEqual(['data->>stable_id', 'eq', sid])
     expect(res.content).toBe('export interface DesignSchema {}')
@@ -1259,14 +1437,18 @@ describe('executeToolAction — cil_fetch_document', () => {
   })
 
   it('rejects a cil_chunk outside the configured project scope', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant" type="constant" identity="docId" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const docId = '123e4567-e89b-42d3-a456-426614174000'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant"]
     mockFetchTables({
       id: 'item-9', title: 'Other chunk',
       data: { code_content: 'secret code', kb_type: 'cil_chunk', project_id: 'proj-other', stable_id: 's-9' }
     })
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:runCtx:constant" type="constant" identity="runCtx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const runCtx = {
       config: { thread: { data: { cil_config: { project_ids: ['proj-a'] } } } }
     } as any
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:runCtx:constant"]
 
     await expect(
       executeToolAction({ handler: 'cil_fetch_document' }, { document_id: docId }, makeCtx(), runCtx)
@@ -1274,18 +1456,24 @@ describe('executeToolAction — cil_fetch_document', () => {
   })
 
   it('allows a cil_chunk inside the configured project scope', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant" type="constant" identity="docId" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const docId = '123e4567-e89b-42d3-a456-426614174000'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:docId:constant"]
     mockFetchTables({
       id: 'item-10', title: 'In-scope chunk',
       data: { code_content: 'scoped code', kb_type: 'cil_chunk', project_id: 'proj-a', stable_id: 's-10' }
     })
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:runCtx:constant" type="constant" identity="runCtx" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const runCtx = {
       config: { thread: { data: { cil_config: { project_ids: ['proj-a'] } } } }
     } as any
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:runCtx:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await executeToolAction(
       { handler: 'cil_fetch_document' }, { document_id: docId }, makeCtx(), runCtx
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.content).toBe('scoped code')
   })
 })
@@ -1295,9 +1483,7 @@ describe('executeToolAction — cil_fetch_document', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_cilFetchDocument:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_cilChunkLookup:block" type="block" identity="describe_executeToolAction_cilChunkLookup" parent="none"]
 // CIL[DOC-MACRO purpose="Test executeToolAction cil_chunk_lookup code content search"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify CIL chunk lookup searches code content correctly"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -1309,7 +1495,10 @@ describe('executeToolAction — cil_chunk_lookup code content search', () => {
   beforeEach(() => vi.clearAllMocks())
 
   it('includes data->>code_content in the or() filter', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:orArgs:constant" type="constant" identity="orArgs" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const orArgs: string[] = []
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:orArgs:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:itemsQ:constant" type="constant" identity="itemsQ" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const itemsQ: any = {
       select: vi.fn(() => itemsQ),
       filter: vi.fn(() => itemsQ),
@@ -1319,6 +1508,7 @@ describe('executeToolAction — cil_chunk_lookup code content search', () => {
       limit: vi.fn(() => itemsQ),
       then: (resolve: any) => resolve({ data: [], error: null }),
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:itemsQ:constant"]
     vi.mocked(adminDb.from).mockImplementation((table: string) => {
       if (table === 'apps') {
         return {
@@ -1357,9 +1547,7 @@ describe('executeToolAction — cil_chunk_lookup code content search', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_cilChunkLookup:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_escalateToHuman:block" type="block" identity="describe_executeToolAction_escalateToHuman" parent="none"]
 // CIL[DOC-MACRO purpose="Test executeToolAction escalate_to_human handler"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify escalation tool creates the expected records"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -1370,6 +1558,7 @@ describe('executeToolAction — cil_chunk_lookup code content search', () => {
 describe('executeToolAction — escalate_to_human', () => {
   beforeEach(() => vi.clearAllMocks())
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockEscalationFlow:function" type="function" identity="mockEscalationFlow" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function mockEscalationFlow(opts: { escalationStatus?: string; owner?: string } = {}) {
     const updates: { table: string; payload: any }[] = []
     vi.mocked(adminDb.from).mockImplementation((table: string) => {
@@ -1397,8 +1586,11 @@ describe('executeToolAction — escalate_to_human', () => {
     })
     return updates
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockEscalationFlow:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:escConfig:constant" type="constant" identity="escConfig" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   const escConfig = { promptConfig: mockPromptConfig({ escalation_action: 'pipeline', confidence_threshold: 0.75 }) }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:escConfig:constant"]
 
   it('throws without a thread context', async () => {
     await expect(
@@ -1407,14 +1599,18 @@ describe('executeToolAction — escalate_to_human', () => {
   })
 
   it('marks the thread escalation pending and the ticket human_assigned', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:updates:constant" type="constant" identity="updates" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const updates = mockEscalationFlow()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:updates:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await executeToolAction(
       { handler: 'escalate_to_human' },
       { reason: 'no relevant docs' },
       makeCtx(),
       { threadId: THREAD_ID, config: escConfig }
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
 
     expect(res).toEqual({ escalated: true, already_escalated: false, reason: 'no relevant docs' })
     expect(updates).toContainEqual({
@@ -1428,28 +1624,36 @@ describe('executeToolAction — escalate_to_human', () => {
   })
 
   it('dedupes when the thread is already pending escalation', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:updates:constant" type="constant" identity="updates" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const updates = mockEscalationFlow({ escalationStatus: 'pending' })
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:updates:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await executeToolAction(
       { handler: 'escalate_to_human' },
       { reason: 'still stuck' },
       makeCtx(),
       { threadId: THREAD_ID, config: escConfig }
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
 
     expect(res.already_escalated).toBe(true)
     expect(updates).toHaveLength(0)
   })
 
   it('dedupes when the thread is already human-owned', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:updates:constant" type="constant" identity="updates" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const updates = mockEscalationFlow({ owner: 'human' })
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:updates:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await executeToolAction(
       { handler: 'escalate_to_human' },
       { reason: 'still stuck' },
       makeCtx(),
       { threadId: THREAD_ID, config: escConfig }
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
 
     expect(res.already_escalated).toBe(true)
     expect(updates).toHaveLength(0)
@@ -1461,9 +1665,7 @@ describe('executeToolAction — escalate_to_human', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_escalateToHuman:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_resolveAgentConfig_escalateToHumanWiring:block" type="block" identity="describe_resolveAgentConfig_escalateToHumanWiring" parent="none"]
 // CIL[DOC-MACRO purpose="Test resolveAgentConfig escalate_to_human wiring"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify the escalate_to_human tool is offered only when the prompt config sets an escalation_action"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -1477,18 +1679,26 @@ describe('resolveAgentConfig — escalate_to_human wiring', () => {
   it('offers escalate_to_human when the prompt config has an escalation_action', async () => {
     setupAgentConfigMocks({}, {}, { escalation_action: 'pipeline', available_tools: [] })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = await resolveAgentConfig(THREAD_ID, makeCtx())
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant" type="constant" identity="names" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const names = (config?.agent.model_config.tools || []).map((t: any) => t.function?.name)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant"]
     expect(names).toContain('escalate_to_human')
   })
 
   it('does not offer escalate_to_human without an escalation_action', async () => {
     setupAgentConfigMocks({}, {}, { escalation_action: null, available_tools: [] })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = await resolveAgentConfig(THREAD_ID, makeCtx())
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant" type="constant" identity="names" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const names = (config?.agent.model_config.tools || []).map((t: any) => t.function?.name)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant"]
     expect(names).not.toContain('escalate_to_human')
   })
 })
@@ -1498,9 +1708,7 @@ describe('resolveAgentConfig — escalate_to_human wiring', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_resolveAgentConfig_escalateToHumanWiring:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_retrieveKnowledge_concurrentRetrieval:block" type="block" identity="describe_retrieveKnowledge_concurrentRetrieval" parent="none"]
 // CIL[DOC-MACRO purpose="Verify retrieveKnowledge concurrent retrieval semantics"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify deterministic channel ordering, bounded vector concurrency (default 3, clamped to 1..5 and channel count), lexical fallback on embedding/vector failure, child span emission and error status, summary gating, security/project/knowledge-source filters, and independent hydration degradation"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/outcomes.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/cil.ts,.framework/functions/_shared/pipeline-runner.ts,.framework/functions/admin-data.ts,.framework/functions/integration-outbound.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -1511,15 +1719,20 @@ describe('resolveAgentConfig — escalate_to_human wiring', () => {
 describe('retrieveKnowledge — concurrent retrieval', () => {
   beforeEach(() => vi.clearAllMocks())
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:deferred:function" type="function" identity="deferred" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function deferred<T>() {
     let resolve!: (value: T) => void
     let reject!: (error: any) => void
     const promise = new Promise<T>((res, rej) => { resolve = res; reject = rej })
     return { promise, resolve, reject }
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:deferred:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:flush:function" type="function" identity="flush" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   const flush = () => new Promise<void>((r) => setImmediate(r))
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:flush:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:vectorDoc:function" type="function" identity="vectorDoc" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function vectorDoc(id: string, similarity = 0.8, vt = 'semantic', metadata: any = {}) {
     return {
       document_id: id,
@@ -1529,7 +1742,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
       account_id: 'acct-1',
     }
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:vectorDoc:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:setupRetrievalMocks:function" type="function" identity="setupRetrievalMocks" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function setupRetrievalMocks(opts: { accountError?: any } = {}) {
     const embedding = deferred<any>()
     const lexical = deferred<any>()
@@ -1598,11 +1813,15 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     })
     return { embedding, lexical, rpcCalls, itemsCalls, wasLexicalStarted: () => lexicalStarted }
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:setupRetrievalMocks:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:retrieve:function" type="function" identity="retrieve" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function retrieve(policy?: any, sources: string[] = []) {
     return retrieveKnowledge('test query', sources, 'acct-1', policy, makeCtx())
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:retrieve:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:startRetrieval:function" type="function" identity="startRetrieval" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   async function startRetrieval(m: ReturnType<typeof setupRetrievalMocks>, policy?: any, sources: string[] = []) {
     const p = retrieve(policy, sources)
     await flush()
@@ -1610,7 +1829,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     await flush()
     return { p }
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:startRetrieval:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:drainRpcs:function" type="function" identity="drainRpcs" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   async function drainRpcs(
     m: ReturnType<typeof setupRetrievalMocks>,
     resolveWith: (args: any) => any = () => ({ data: [], error: null })
@@ -1620,7 +1841,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
       await flush()
     }
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:drainRpcs:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:finishRetrieval:function" type="function" identity="finishRetrieval" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   async function finishRetrieval(
     m: ReturnType<typeof setupRetrievalMocks>,
     opts: {
@@ -1639,14 +1862,21 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     }
     await flush()
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:finishRetrieval:function"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:emittedSpans:function" type="function" identity="emittedSpans" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function emittedSpans() {
     return vi.mocked(emitSpan).mock.calls.map((c) => c[1])
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:emittedSpans:function"]
 
   it('starts the lexical query before the embedding resolves', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant" type="constant" identity="p" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const p = retrieve({ vector_types: ['semantic'] })
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant"]
     await flush()
 
     expect(m.wasLexicalStarted()).toBe(true)
@@ -1660,8 +1890,12 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('peaks at 3 active RPCs across five channels and executes each once', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant" type="constant" identity="channels" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const channels = ['semantic', 'title', 'content', 'keyword', 'caption']
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant"]
     const { p } = await startRetrieval(m, { vector_types: channels })
 
     expect(m.rpcCalls).toHaveLength(3)
@@ -1680,15 +1914,21 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     await finishRetrieval(m, {
       rpcResult: (args) => ({ data: [vectorDoc(`doc-${args.filter_vector_type}`, 0.9, args.filter_vector_type)], error: null }),
     })
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(m.rpcCalls).toHaveLength(5)
     expect(new Set(m.rpcCalls.map((c) => c.args.filter_vector_type))).toEqual(new Set(channels))
     expect(res.docs.map((d: any) => d.document_id).sort()).toEqual(channels.map((c) => `doc-${c}`).sort())
   })
 
   it('runs strictly sequentially when max_vector_concurrency is 1', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant" type="constant" identity="channels" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const channels = ['semantic', 'title', 'content']
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant"]
     const { p } = await startRetrieval(m, { vector_types: channels, max_vector_concurrency: 1 })
 
     expect(m.rpcCalls).toHaveLength(1)
@@ -1704,9 +1944,13 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('clamps max_vector_concurrency of 0 to sequential and values above 5 to five', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant" type="constant" identity="channels" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const channels = ['semantic', 'title', 'content', 'keyword', 'caption']
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m0:constant" type="constant" identity="m0" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m0 = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m0:constant"]
     const { p: p0 } = await startRetrieval(m0, { vector_types: channels, max_vector_concurrency: 0 })
     expect(m0.rpcCalls).toHaveLength(1)
     m0.rpcCalls[0].deferred.resolve({ data: [], error: null })
@@ -1716,7 +1960,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     await p0
 
     vi.clearAllMocks()
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m9:constant" type="constant" identity="m9" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m9 = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m9:constant"]
     const { p: p9 } = await startRetrieval(m9, { vector_types: channels, max_vector_concurrency: 9 })
     expect(m9.rpcCalls).toHaveLength(5)
     await finishRetrieval(m9)
@@ -1724,10 +1970,14 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('defaults invalid or non-finite max_vector_concurrency to 3', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant" type="constant" identity="channels" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const channels = ['semantic', 'title', 'content', 'keyword', 'caption']
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant"]
     for (const override of [NaN, Infinity, 'fast']) {
       vi.clearAllMocks()
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
       const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
       const { p } = await startRetrieval(m, { vector_types: channels, max_vector_concurrency: override })
       expect(m.rpcCalls).toHaveLength(3)
       await finishRetrieval(m)
@@ -1736,7 +1986,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('never starts more workers than channels', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic', 'title'], max_vector_concurrency: 5 })
     expect(m.rpcCalls).toHaveLength(2)
     await finishRetrieval(m)
@@ -1744,8 +1996,12 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('preserves configured channel order in output regardless of completion order', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant" type="constant" identity="channels" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const channels = ['semantic', 'title', 'content']
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant"]
     const { p } = await startRetrieval(m, { vector_types: channels })
     expect(m.rpcCalls).toHaveLength(3)
 
@@ -1757,16 +2013,30 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
       await flush()
     }
     await finishRetrieval(m)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs.map((d: any) => d.document_id)).toEqual(['doc-semantic', 'doc-title', 'doc-content'])
   })
 
   it('stops scheduling on a vector error, waits for in-flight work, and returns the shaped lexical fallback', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant" type="constant" identity="channels" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const channels = ['semantic', 'title', 'content', 'keyword', 'caption']
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:channels:constant"]
+
+
     let settled = false
+
+
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant" type="constant" identity="p" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const p = retrieve({ vector_types: channels }).then((r) => { settled = true; return r })
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant"]
     await flush()
     m.embedding.resolve({ data: [{ embedding: [0.1, 0.2] }] })
     await flush()
@@ -1789,7 +2059,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     expect(m.rpcCalls).toHaveLength(3)
     for (const c of m.itemsCalls) c.deferred.resolve({ data: [], error: null })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(settled).toBe(true)
     expect(vi.mocked(adminDb.from).mock.calls.filter((c) => c[0] === 'embeddings')).toHaveLength(1)
     expect(res.docs).toHaveLength(1)
@@ -1801,9 +2073,15 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('returns the already-running shaped lexical fallback when the embedding fails', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant" type="constant" identity="p" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const p = retrieve({ vector_types: ['semantic', 'title'] })
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant"]
     await flush()
     expect(m.wasLexicalStarted()).toBe(true)
 
@@ -1816,7 +2094,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     expect(m.rpcCalls).toHaveLength(0)
     for (const c of m.itemsCalls) c.deferred.resolve({ data: [], error: null })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs).toHaveLength(1)
     expect(res.docs[0].document_id).toBe('lex-2')
     expect(res.docs[0].matched_lexically).toBe(true)
@@ -1824,13 +2104,21 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('suppresses the fallback warning when the embedding fails with no_api_key', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant" type="constant" identity="p" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const p = retrieve()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:p:constant"]
     await flush()
     m.embedding.reject(new Error('no_api_key'))
     m.lexical.resolve({ data: [], error: null })
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
 
     expect(res).toEqual({ docs: [], meanSimilarity: 0 })
     expect(warn.mock.calls.every((c) => !String(c[0]).includes('vector search failed'))).toBe(true)
@@ -1838,8 +2126,12 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('returns a shaped, hydrated lexical-only doc when vectors are empty', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:lexId:constant" type="constant" identity="lexId" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const lexId = '123e4567-e89b-42d3-a456-426614174000'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:lexId:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [], error: null })
     m.lexical.resolve({
@@ -1852,9 +2144,13 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
       error: null,
     })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs).toHaveLength(1)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:d:constant" type="constant" identity="d" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const d = res.docs[0]
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:d:constant"]
     expect(d.similarity).toBe(0)
     expect(d.matched_lexically).toBe(true)
     expect(d.title).toBe('Lex Title')
@@ -1865,10 +2161,18 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('preserves ordered IDs, flags, content selection, count, and mean for fixed vector+lexical fixtures', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant" type="constant" identity="idA" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idA = '11111111-1111-4111-8111-111111111111'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idB:constant" type="constant" identity="idB" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idB = '~/.framework/src/foo.ts:Bar:function'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idB:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idC:constant" type="constant" identity="idC" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idC = '33333333-3333-4333-8333-333333333333'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idC:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic', 'title'] })
 
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc(idA, 0.9, 'semantic')], error: null })
@@ -1895,7 +2199,9 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
       }
     }
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs).toHaveLength(3)
     expect(res.docs.map((d: any) => d.document_id)).toEqual([idA, idC, idB])
     expect(res.docs[0].matched_lexically).toBe(false)
@@ -1914,17 +2220,27 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('starts UUID and stable-ID hydration concurrently and hydrates both regardless of completion order', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant" type="constant" identity="idA" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idA = '11111111-1111-4111-8111-111111111111'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idB:constant" type="constant" identity="idB" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idB = 'stable-doc-1'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idB:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc(idA, 0.9), vectorDoc(idB, 0.8)], error: null })
     m.lexical.resolve({ data: [], error: null })
     await flush()
 
     expect(m.itemsCalls).toHaveLength(2)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:uuidCall:constant" type="constant" identity="uuidCall" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const uuidCall = m.itemsCalls.find((c) => c.field === 'id')!
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:uuidCall:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:stableCall:constant" type="constant" identity="stableCall" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const stableCall = m.itemsCalls.find((c) => c.field === 'data->>stable_id')!
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:stableCall:constant"]
     expect(uuidCall.ids).toEqual([idA])
     expect(stableCall.ids).toEqual([idB])
 
@@ -1932,16 +2248,26 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     await flush()
     uuidCall.deferred.resolve({ data: [{ id: idA, title: 'A', data: {} }], error: null })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs.find((d: any) => d.document_id === idA)!.title).toBe('A')
     expect(res.docs.find((d: any) => d.document_id === idB)!.title).toBe('B')
   })
 
   it('degrades a failed hydration branch without discarding documents or the other branch', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant" type="constant" identity="idA" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idA = '11111111-1111-4111-8111-111111111111'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idB:constant" type="constant" identity="idB" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idB = 'stable-doc-1'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idB:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc(idA, 0.9), vectorDoc(idB, 0.8)], error: null })
     m.lexical.resolve({ data: [], error: null })
@@ -1953,18 +2279,26 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
       error: null,
     })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs).toHaveLength(2)
     expect(res.docs.find((d: any) => d.document_id === idA)!.title).toBe('')
     expect(res.docs.find((d: any) => d.document_id === idB)!.title).toBe('B')
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:hydSpan:constant" type="constant" identity="hydSpan" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const hydSpan = emittedSpans().find((s: any) => s.spanName === 'agent.retrieve.hydrate_uuid')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:hydSpan:constant"]
     expect(hydSpan?.status).toBe('error')
     warn.mockRestore()
   })
 
   it('emits a child span per leg with low-cardinality names and static attributes', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant" type="constant" identity="idA" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const idA = '11111111-1111-4111-8111-111111111111'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:idA:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic', 'title'] })
     await drainRpcs(m, () => ({ data: [vectorDoc(idA, 0.9)], error: null }))
     m.lexical.resolve({ data: [], error: null })
@@ -1972,20 +2306,28 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     for (const c of m.itemsCalls) c.deferred.resolve({ data: [], error: null })
     await p
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:spans:constant" type="constant" identity="spans" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const spans = emittedSpans()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:spans:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant" type="constant" identity="names" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const names = spans.map((s: any) => s.spanName)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:names:constant"]
     expect(names).toContain('agent.retrieve_knowledge')
     expect(names).toContain('agent.retrieve.account_scope')
     expect(names).toContain('agent.retrieve.embedding')
     expect(names).toContain('agent.retrieve.lexical')
     expect(names.filter((n: string) => n === 'agent.retrieve.vector')).toHaveLength(2)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:vectorSpans:constant" type="constant" identity="vectorSpans" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const vectorSpans = spans.filter((s: any) => s.spanName === 'agent.retrieve.vector')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:vectorSpans:constant"]
     expect(vectorSpans.map((s: any) => s.attributes.vector_type).sort()).toEqual(['semantic', 'title'])
     for (const s of vectorSpans) {
       expect(s.attributes.match_count).toBe(24)
       expect(s.attributes.project_filter).toBe(false)
     }
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:lexSpan:constant" type="constant" identity="lexSpan" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const lexSpan = spans.find((s: any) => s.spanName === 'agent.retrieve.lexical')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:lexSpan:constant"]
     expect(lexSpan?.attributes).toMatchObject({ limit: 8, item_type_count: 0, project_filter: false })
     expect(names).toContain('agent.retrieve.hydrate_uuid')
     expect(names).not.toContain('agent.retrieve.hydrate_stable')
@@ -1993,16 +2335,24 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('records an error span for a failed vector RPC while degradation continues', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: null, error: { message: 'rpc exploded' } })
     m.lexical.resolve({ data: [{ document_id: 'lex-9', content: 'x', metadata: {}, account_id: 'acct-1' }], error: null })
     await flush()
     for (const c of m.itemsCalls) c.deferred.resolve({ data: [], error: null })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:vSpan:constant" type="constant" identity="vSpan" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const vSpan = emittedSpans().find((s: any) => s.spanName === 'agent.retrieve.vector')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:vSpan:constant"]
     expect(vSpan?.status).toBe('error')
     expect(String(vSpan?.attributes?.error)).toContain('rpc exploded')
     expect(res.docs).toHaveLength(1)
@@ -2011,34 +2361,48 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
   })
 
   it('marks the lexical span as error and keeps vector results when lexical fails', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc('v1', 0.9)], error: null })
     m.lexical.resolve({ data: null, error: { message: 'fts down' } })
     await flush()
     for (const c of m.itemsCalls) c.deferred.resolve({ data: [], error: null })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs).toHaveLength(1)
     expect(res.docs[0].document_id).toBe('v1')
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:lexSpan:constant" type="constant" identity="lexSpan" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const lexSpan = emittedSpans().find((s: any) => s.spanName === 'agent.retrieve.lexical')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:lexSpan:constant"]
     expect(lexSpan?.status).toBe('error')
     warn.mockRestore()
   })
 
   it('skips the summary RPC when the primary vector hit is strong', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc('d1', 0.9)], error: null })
     await finishRetrieval(m)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(m.rpcCalls).toHaveLength(1)
     expect(res.docs.map((d: any) => d.document_id)).toEqual(['d1'])
   })
 
   it('runs exactly one summary RPC when the primary hit is weak', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc('weak-1', 0.4)], error: null })
     await flush()
@@ -2048,24 +2412,34 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
 
     m.rpcCalls[1].deferred.resolve({ data: [vectorDoc('sum-1', 0.6)], error: null })
     await finishRetrieval(m)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs.map((d: any) => d.document_id).sort()).toEqual(['sum-1', 'weak-1'])
   })
 
   it('does not run a duplicate summary RPC when summary is a configured channel', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic', 'summary'] })
     await drainRpcs(m, (args) => ({ data: [vectorDoc(`d-${args.filter_vector_type}`, 0.4, args.filter_vector_type)], error: null }))
     await finishRetrieval(m)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(m.rpcCalls).toHaveLength(2)
     expect(m.rpcCalls.map((c) => c.args.filter_vector_type)).toEqual(['semantic', 'summary'])
     expect(res.docs).toHaveLength(2)
   })
 
   it('keeps primary vectors when the summary RPC fails', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc('weak-1', 0.4)], error: null })
     await flush()
@@ -2073,16 +2447,24 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
     m.rpcCalls[1].deferred.resolve({ data: null, error: { message: 'summary boom' } })
     await finishRetrieval(m)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs.map((d: any) => d.document_id)).toEqual(['weak-1'])
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:sumSpan:constant" type="constant" identity="sumSpan" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const sumSpan = emittedSpans().find((s: any) => s.spanName === 'agent.retrieve.summary')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:sumSpan:constant"]
     expect(sumSpan?.status).toBe('error')
     warn.mockRestore()
   })
 
   it('keeps similarity, security, project, and knowledge-source filtering intact', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks()
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:allowed:constant" type="constant" identity="allowed" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const allowed = '44444444-4444-4444-8444-444444444444'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:allowed:constant"]
     const { p } = await startRetrieval(
       m,
       { vector_types: ['semantic'], project_ids: ['p1'], max_security_level: 'internal' },
@@ -2101,21 +2483,31 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
       error: null,
     })
     await finishRetrieval(m)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(res.docs.map((d: any) => d.document_id)).toEqual([allowed])
   })
 
   it('degrades to account-only scope when the platform account lookup fails', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant" type="constant" identity="warn" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const warn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:warn:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant" type="constant" identity="m" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const m = setupRetrievalMocks({ accountError: { message: 'accounts down' } })
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:m:constant"]
     const { p } = await startRetrieval(m, { vector_types: ['semantic'] })
     m.rpcCalls[0].deferred.resolve({ data: [vectorDoc('d1', 0.9)], error: null })
     await finishRetrieval(m)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant" type="constant" identity="res" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const res = await p
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:res:constant"]
     expect(m.rpcCalls[0].args.filter_account_ids).toEqual(['acct-1'])
     expect(res.docs).toHaveLength(1)
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:acctSpan:constant" type="constant" identity="acctSpan" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const acctSpan = emittedSpans().find((s: any) => s.spanName === 'agent.retrieve.account_scope')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:acctSpan:constant"]
     expect(acctSpan?.status).toBe('error')
     warn.mockRestore()
   })
@@ -2126,9 +2518,7 @@ describe('retrieveKnowledge — concurrent retrieval', () => {
 // CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_retrieveKnowledge_concurrentRetrieval:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_sendNotificationRoleRecipients:block" type="block" identity="describe_executeToolAction_sendNotificationRoleRecipients" parent="none"]
 // CIL[DOC-MACRO purpose="Test executeToolAction send_notification role:<slug> recipient resolution"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify the agent-runner notification writer resolves role: handles to account-scoped people ids and passes UUIDs through before the notifications insert"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/notify.ts,.framework/functions/_shared/agent-runner.ts,.framework/tests/unit/agent-runner.test.ts"]
@@ -2141,6 +2531,7 @@ describe('executeToolAction — send_notification role:<slug> recipients', () =>
     vi.spyOn(console, 'warn').mockImplementation(() => {})
   })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockNotifyTables:function" type="function" identity="mockNotifyTables" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   function mockNotifyTables(peopleRows: any[] | null, insertCapture: { rows?: any[] }) {
     const peopleQ: any = {
       select: vi.fn(() => peopleQ),
@@ -2169,16 +2560,21 @@ describe('executeToolAction — send_notification role:<slug> recipients', () =>
       } as any
     })
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:mockNotifyTables:function"]
 
   it('resolves role:member_admin to the account’s people ids', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant" type="constant" identity="cap" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const cap: { rows?: any[] } = {}
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant"]
     mockNotifyTables([{ id: 'admin-1' }, { id: 'admin-2' }], cap)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await executeToolAction(
       { handler: 'send_notification', handler_module: 'functions' },
       { message: 'Escalated', recipients: ['role:member_admin'], entity_type: 'threads' },
       makeCtx()
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.notified_count).toBe(2)
     expect(cap.rows!.map((r: any) => r.person_id)).toEqual(['admin-1', 'admin-2'])
@@ -2187,29 +2583,39 @@ describe('executeToolAction — send_notification role:<slug> recipients', () =>
   })
 
   it('passes UUID recipients through alongside resolved roles', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant" type="constant" identity="cap" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const cap: { rows?: any[] } = {}
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:uuid:constant" type="constant" identity="uuid" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const uuid = '22222222-2222-4222-8222-222222222222'
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:uuid:constant"]
     mockNotifyTables([{ id: 'admin-1' }], cap)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await executeToolAction(
       { handler: 'send_notification', handler_module: 'functions' },
       { message: 'Escalated', recipients: [uuid, 'role:member_admin'] },
       makeCtx()
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.notified_count).toBe(2)
     expect(cap.rows!.map((r: any) => r.person_id)).toEqual([uuid, 'admin-1'])
   })
 
   it('an unknown role is a valid zero-notification result, not an error', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant" type="constant" identity="cap" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const cap: { rows?: any[] } = {}
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant"]
     mockNotifyTables([], cap)
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await executeToolAction(
       { handler: 'send_notification', handler_module: 'functions' },
       { message: 'Escalated', recipients: ['role:no_such_role'] },
       makeCtx()
     )
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.notified_count).toBe(0)
     expect(cap.rows).toBeUndefined()
@@ -2217,7 +2623,9 @@ describe('executeToolAction — send_notification role:<slug> recipients', () =>
   })
 
   it('never writes a literal role: string into person_id', async () => {
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant" type="constant" identity="cap" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const cap: { rows?: any[] } = {}
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:cap:constant"]
     mockNotifyTables([{ id: 'admin-1' }], cap)
 
     await executeToolAction(
@@ -2231,9 +2639,7 @@ describe('executeToolAction — send_notification role:<slug> recipients', () =>
     }
   })
 })
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_executeToolAction_sendNotificationRoleRecipients:block"]
 
-// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_denyCilRetrievalPolicy:block" type="block" identity="describe_denyCilRetrievalPolicy" parent="none"]
 // CIL[DOC-MACRO purpose="Test the retrieval_policy.deny_cil kill switch"]
 // CIL[DOC-RESPONSIBILITY responsibility="Verify a denied prompt config resolves zero CIL tools, skips thread cil_config augmentation, and dispatchTools rejects built-in CIL calls — while the non-deny path stays unchanged"]
 // CIL[DOC-CONTEXT module="tests/unit/agent-runner" layer="test-unit" related_files=".framework/functions/_shared/agent-runner.ts,custom/apps/demo/seed/prompt-configs.json"]
@@ -2248,16 +2654,22 @@ describe('deny_cil retrieval policy', () => {
   // built-ins search_knowledge, ask_user, and escalate_to_human — denying
   // those would break ordinary agents (e.g. demo triage), so they must
   // survive a denied agent's resolved tool set.
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:CIL_NAMES:constant" type="constant" identity="CIL_NAMES" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   const CIL_NAMES = [
     'cil_chunk_lookup', 'cil_get_contract', 'cil_blast_radius', 'cil_hash_validate',
     'cil_project_status', 'cil_fetch_document',
   ]
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:CIL_NAMES:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:GENERIC_BUILTIN_NAMES:constant" type="constant" identity="GENERIC_BUILTIN_NAMES" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   const GENERIC_BUILTIN_NAMES = ['search_knowledge', 'ask_user', 'escalate_to_human']
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:GENERIC_BUILTIN_NAMES:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:cilThreadData:constant" type="constant" identity="cilThreadData" parent="~/.framework/tests/unit/agent-runner.test.ts"]
   const cilThreadData = {
     agent_id: AGENT_ID,
     prompt_config_id: PROMPT_CONFIG_ID,
     cil_config: { enabled: true, use_cil_tools: true, project_ids: ['proj-a'] },
   }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:cilThreadData:constant"]
 
   it('resolves zero CIL tools and no cil_config merge when denied', async () => {
     setupAgentConfigMocks(
@@ -2274,9 +2686,13 @@ describe('deny_cil retrieval policy', () => {
       }
     )
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = await resolveAgentConfig(THREAD_ID, makeCtx())
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolNames:constant" type="constant" identity="toolNames" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const toolNames = (config?.agent.model_config.tools || []).map((t: any) => t.function?.name)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolNames:constant"]
     for (const name of CIL_NAMES) {
       expect(toolNames).not.toContain(name)
       expect(config?.promptConfig.available_tools).not.toContain(name)
@@ -2301,9 +2717,13 @@ describe('deny_cil retrieval policy', () => {
       { available_tools: [], metadata: {} }
     )
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = await resolveAgentConfig(THREAD_ID, makeCtx())
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolNames:constant" type="constant" identity="toolNames" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const toolNames = (config?.agent.model_config.tools || []).map((t: any) => t.function?.name)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolNames:constant"]
     expect(toolNames).toContain('cil_chunk_lookup')
     expect(toolNames).toContain('ask_user') // multi-turn default still applies
     expect(config?.promptConfig.metadata.cil_config).toEqual(cilThreadData.cil_config)
@@ -2326,17 +2746,23 @@ describe('deny_cil retrieval policy', () => {
     })
     mockCreateRecord({ id: 'msg-tool' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig({ metadata: { retrieval_policy: { deny_cil: true } } }),
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Where is design_schema?', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
     expect(result.state.status).toBe('gathering')
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolResult:constant" type="constant" identity="toolResult" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const toolResult = result.state.gathered_results.find((r: any) => r.tool === 'cil_chunk_lookup')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolResult:constant"]
     expect(toolResult?.error).toBe('Tool "cil_chunk_lookup" is not permitted by the retrieval policy')
     expect(createRecord).toHaveBeenCalledWith(
       expect.any(Object),
@@ -2355,6 +2781,7 @@ describe('deny_cil retrieval policy', () => {
     // executeCilChunkLookup chains .filter().in().eq().or().limit() on the
     // items builder — the generic mock lacks .or, so give items a thenable
     // builder that resolves an empty result set.
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:itemsQ:constant" type="constant" identity="itemsQ" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const itemsQ: any = {
       select: vi.fn(() => itemsQ),
       filter: vi.fn(() => itemsQ),
@@ -2364,7 +2791,10 @@ describe('deny_cil retrieval policy', () => {
       limit: vi.fn(() => itemsQ),
       then: (onF: any, onR: any) => Promise.resolve({ data: [], error: null }).then(onF, onR),
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:itemsQ:constant"]
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:baseImpl:constant" type="constant" identity="baseImpl" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const baseImpl = vi.mocked(adminDb.from).getMockImplementation()!
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:baseImpl:constant"]
     vi.mocked(adminDb.from).mockImplementation((table: string) => {
       if (table === 'items') return itemsQ
       return baseImpl(table)
@@ -2383,6 +2813,7 @@ describe('deny_cil retrieval policy', () => {
     })
     mockCreateRecord({ id: 'msg-tool' })
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant" type="constant" identity="config" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const config = {
       agent: mockAgent(),
       promptConfig: mockPromptConfig({
@@ -2391,13 +2822,17 @@ describe('deny_cil retrieval policy', () => {
       thread: mockThread(),
       threadType: { slug: 'support_thread' }
     }
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:config:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant" type="constant" identity="result" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const result = await runAgentStep(THREAD_ID, 'Where is design_schema?', makeCtx(), config)
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:result:constant"]
 
+// CIL[BEGIN stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolResult:constant" type="constant" identity="toolResult" parent="~/.framework/tests/unit/agent-runner.test.ts"]
     const toolResult = result.state.gathered_results.find((r: any) => r.tool === 'cil_chunk_lookup')
+// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:toolResult:constant"]
     expect(toolResult).toBeDefined()
     expect(toolResult?.error).toBeUndefined()
     expect(toolResult?.result).toEqual({ results: [], count: 0 })
   })
 })
-// CIL[END stable_id="~/.framework/tests/unit/agent-runner.test.ts:describe_denyCilRetrievalPolicy:block"]