@salesforce/afv-skills 1.22.0 → 1.24.0

package/skills/investigating-agentforce-architecture/assets/soql/functions_by_plugins.soql

@@ -1,5 +0,0 @@
-SELECT Id, DeveloperName, MasterLabel, Description, InvocationTargetType, InvocationTarget,
-       IsLocal, IsConfirmationRequired, IsIncludeInProgressIndicator, ProgressIndicatorMessage,
-       Source, PluginId, PlannerId, ParentId, LocalDeveloperName
-FROM GenAiFunctionDefinition
-WHERE PluginId IN ({{PLUGIN_IDS}})

package/skills/investigating-agentforce-architecture/assets/soql/planner_attrs_by_parent_ids.soql

@@ -1,3 +0,0 @@
-SELECT Id, ParentId, DeveloperName, MasterLabel, Description, MappingType, ParameterName
-FROM GenAiPlannerAttrDefinition
-WHERE ParentId IN ({{PARENT_IDS}})

package/skills/investigating-agentforce-architecture/assets/soql/planner_bundle_functions.soql

@@ -1,3 +0,0 @@
-SELECT Id, PlannerId, Plugin
-FROM GenAiPlannerFunctionDef
-WHERE PlannerId = '{{PLANNER_ID}}'

package/skills/investigating-agentforce-architecture/assets/soql/planner_definition_by_agent_chain.soql

@@ -1,3 +0,0 @@
-SELECT Id, DeveloperName, MasterLabel, Description, PlannerType, Capabilities, AgentGraph
-FROM GenAiPlannerDefinition
-WHERE DeveloperName LIKE '{{AGENT_NAME}}%\_{{VERSION}}'

package/skills/investigating-agentforce-architecture/assets/soql/plugin_functions_by_plugin_ids.soql

@@ -1,3 +0,0 @@
-SELECT Id, PluginId, Function
-FROM GenAiPluginFunctionDef
-WHERE PluginId IN ({{PLUGIN_IDS}})

package/skills/investigating-agentforce-architecture/assets/soql/plugin_instructions_by_plugin_ids.soql

@@ -1,3 +0,0 @@
-SELECT Id, GenAiPluginDefinitionId, DeveloperName, MasterLabel, Description, SortOrder
-FROM GenAiPluginInstructionDef
-WHERE GenAiPluginDefinitionId IN ({{PLUGIN_IDS}})

package/skills/investigating-agentforce-architecture/assets/soql/plugins_by_planner.soql

@@ -1,4 +0,0 @@
-SELECT Id, DeveloperName, MasterLabel, Description, PluginType, Scope,
-       IsLocal, CanEscalate, Source, ParentId, LocalDeveloperName
-FROM GenAiPluginDefinition
-WHERE PlannerId = '{{PLANNER_ID}}'

package/skills/investigating-agentforce-architecture/references/architecture_sections.md

@@ -1,243 +0,0 @@
-# architecture.md section reference
-
-Per-section rendering spec for `scripts/render_architecture.py::render`.
-One `# Architecture` H1, seven numbered `## N. ...` sections, plus one
-conditional "Dependency graph" appendix. Source of truth: the
-`metadata_tree.json` schema produced by `scripts/parse_wave.py` at the
-end of phase 9.
-
-**Source of truth: the live tree** — field shapes evolve as parse_wave
-learns new agent generations. When this doc disagrees with the
-`metadata_tree.json` written by `parse_wave.py` for an actual agent on
-your machine (under `~/.vibe/data/investigating-agentforce-architecture/<org>/<agent>__<ver>/`),
-trust the live tree.
-
-The Mermaid templates live at `assets/mermaid/*.mmd` and are the sole
-consumer of the renderer helpers; each `{{PARAM}}` contract is
-documented in the template's own header comment.
-
----
-
-## Per-diagram node caps
-
-Default caps (override via `render(..., max_mermaid_nodes={...})`):
-
-| Diagram kind | Default cap | Over-cap behaviour |
-|---|---|---|
-| `flowchart` | 200 | summary placeholder + top-5 fan-out + catalog pointer |
-| `stateDiagram` | 40 | summary placeholder (no fan-out — states are not nodes) |
-| `sequenceDiagram` | 60 | summary placeholder + top-5 fan-out |
-| `graph` | 100 | summary placeholder + top-5 fan-out |
-
-Cap is measured in rendered elements (nodes + edges for flowchart/graph,
-messages for sequenceDiagram, states + transitions for stateDiagram).
-Above cap, the renderer emits a `> [diagram truncated: ...]` blockquote
-with the element count, the top-5 nodes by fan-out (when applicable),
-and a pointer to the catalog section that enumerates the same data
-without compression.
-
----
-
-## 1. Header + agent overview
-
-**Purpose**: identify the agent and its planner in a single kv table.
-
-**Input fields** (`tree.agent.*`):
-
-- `api_name` — agent developer name
-- `version` — `v<N>` label
-- `master_label` — human-readable name
-- `description` — prose summary
-- `agent_type` — `EinsteinAgentKind` / `EinsteinCopilotForSalesforce` / …
-- `type` — `ExternalCopilot` / `InternalCopilot` / …
-- `agent_template`
-- `bot_source`
-- `generation` — `classic` / `nga` / `search` / `byop`
-- `planner_name`
-- `planner_type`
-- `bot_id`
-
-Plus `tree._schema_version`.
-
-**Output shape**: `# <H1>` with api_name + version, followed by a 2-col
-markdown table.
-
-**Empty/degenerate cases**:
-
-- Missing `api_name` / `version` renders `?` in the H1 (not `None`).
-- Any missing field renders `-` in its row — not empty, because GitHub
- table rendering collapses empty cells and the row loses alignment.
-
----
-
-## 2. Anatomy summary
-
-**Purpose**: one-paragraph executive summary plus health callouts.
-
-**Input fields**:
-
-- `tree._kind_counts` — preferred source for topic / action / flow /
- apex / prompt counts.
-- `tree.depth`, `tree.node_count` — size metrics.
-- `tree._partial`, `tree._partial_reason` — health flag + prose reason.
-- `tree._pending_fetches` — `{"FLOW":[...],"APEX":[...],
- "PROMPT_TEMPLATE":[...],"STANDARD_ACTION":[...]}`. Count determines
- the "pending fetches: N" line in the callout.
-- `tree._unresolved` — triggers a second warn callout with the count.
-- `tree.agent.planner_name` — missing -> warn callout.
-
-**Output shape**: `## 2. Anatomy summary` + paragraph + zero-to-three
-blockquote callouts. Callouts render as `> **Health: PARTIAL.**` /
-`> **Health: WARN.**` prefixes with bullet sub-lines.
-
-**Empty/degenerate cases**: if `_kind_counts` is absent, the walker
-supplies counts from its own pass over the tree. Zero topics is valid
-(SequentialPlannerIntentClassifier).
-
----
-
-## 3. Action tree
-
-**Purpose**: the full declared action tree as a flowchart with per-topic
-subgraphs, plus a deterministic ASCII appendix for diff review.
-
-**Input fields**:
-
-- Walker-derived `topics[]` -> one subgraph per topic.
-- Walker-derived `edges[]` -> `parent_api_name --> child_api_name`.
-- `node._cycle_back_to` -> dotted back-edge `A -.->|cycle_back_to: X| B`.
-- Planner-level actions (top-level `GEN_AI_FUNCTION` with no parent
- topic) -> synthetic `_plannerActions` subgraph.
-
-**Output shape**: ` ```mermaid ` block with `flowchart TB` + subgraphs
-+ edges, followed by a `<details>` with ASCII-tree appendix. When
-above cap, the mermaid block is replaced with the truncation
-placeholder; the ASCII appendix still renders.
-
-**Empty/degenerate cases**:
-
-- No topics, no planner actions -> `%% no topics` + `%% no edges`
- mermaid comments; diagram still parses.
-- Cycle annotations render in both the mermaid (dotted edge) and the
- ASCII appendix (`[cycle]` marker on the node line).
-
----
-
-## 4. Topic anatomy
-
-**Purpose**: per-topic detail dump. One H3 per topic with a bullet list
-of actions.
-
-**Input fields**:
-
-- Walker-derived `topics[]` with `api_name`, `label`, `actions`.
-- `topic.raw.master_label` (preferred) or api_name for the label.
-
-**Output shape**: `## 4. Topic anatomy` + one `### \`<api_name>\``
-block per topic + kv list (`- Label:`, `- Action count:`, `- Actions:`
-with sub-bullets).
-
-**Empty/degenerate cases**: 0 topics -> `_No topics defined (planner
-exposes actions directly)._` italic fallback. This is the expected
-case for `SequentialPlannerIntentClassifier`.
-
----
-
-## 5. Action catalog
-
-**Purpose**: flat markdown table of every declared action.
-
-**Input fields**:
-
-- Walker-derived `actions[]` with `api_name`, `topic`, `raw.unwraps_to`.
-
-**Output shape**: 3-col table (`Action | Topic | Unwraps to`). Unwraps
-column renders as `KIND \`api_name\`` when `unwraps_to` is present, `-`
-otherwise. Planner-level actions show `(plannerAction)` in the topic
-column.
-
-**Empty/degenerate cases**: no actions -> `_No actions declared._`
-italic fallback.
-
----
-
-## 6. Data flow / context propagation
-
-**Purpose**: show which slot values propagate from user utterance
-through the planner into each action.
-
-**Input fields**:
-
-- Walker-derived `topics[]` and `actions[]`.
-- `action.raw.planner_attr.variable_name` + `planner_attr.data_type` —
- labels the edge `A -->|var: Type| B`. When absent, the edge is bare.
-
-**Output shape**: `flowchart LR` via `load_mermaid("data_flow", ...)`.
-Skeleton: `User` -> `Planner` -> each `Topic` -> each `Action` under
-that topic.
-
-**Empty/degenerate cases**: no planner_attr metadata -> every edge is
-bare. 0 topics -> only `User --> Planner` renders (no action-level
-edges). Above cap -> truncation placeholder.
-
----
-
-## 7. Flow / Apex / Prompt catalogs
-
-**Purpose**: per-artifact detail section for every backing flow, apex
-class, and prompt template referenced by any action.
-
-**Input fields**:
-
-- Walker-derived `flows{}`, `apex{}`, `prompts{}`, keyed on api_name.
-- `node.signature` (or `_signature` fallback) — signature block.
-
-**Output shape**: `### Flows` / `### Apex classes` / `### Prompt
-templates` H3 buckets, each containing `#### \`<api_name>\`` + a fenced
-signature block or `_Signature not captured._` fallback. Prompt
-templates render as a flat bullet list (signature capture is
-per-template prose, not a flow/apex shape).
-
-**Empty/degenerate cases**: no backing artifacts in the tree ->
-`_No backing artifacts in tree._` italic fallback.
-
----
-
-## 8. Unresolved refs + artifact pointers
-
-**Purpose**: surface every `_unresolved[]` entry and point at the
-sidecar files the reader can open.
-
-**Input fields**:
-
-- `tree._unresolved[]` — list of `{kind, api_name, reason}` records.
-
-**Output shape**: Either a 3-col `Kind | Api name | Reason` table or
-an `_No unresolved references._` italic fallback. Followed by an
-`### Artifact pointers` sub-heading with a bullet list of relative
-paths (tree JSON, manifest, summary).
-
-**Empty/degenerate cases**: always renders — the artifact-pointer list
-is unconditional.
-
----
-
-## Conditional: Dependency graph
-
-**Purpose**: rendered only when `tree._unresolved[]` is non-empty OR
-the tree contains cycle annotations. Shows cross-artifact dependencies
-plus the unresolved nodes as dashed-outline markers.
-
-**Input fields**:
-
-- Walker-derived `edges[]`.
-- `tree._unresolved[]` — each becomes a `:::unresolved` styled node.
-- Walker-derived `cycles[]` — each becomes a dotted back-edge.
-
-**Output shape**: `graph LR` via `load_mermaid("dependency_graph",
-...)`. Includes a `classDef unresolved` class marker at the bottom of
-the template so unresolved nodes render with `stroke-dasharray`.
-
-**Empty/degenerate cases**: not rendered at all when both conditions
-are false. Above the `graph` cap -> truncation placeholder replaces
-the mermaid block.

package/skills/investigating-agentforce-architecture/references/contract.json

@@ -1,244 +0,0 @@
-{
-  "_doc": "retired-name references replaced with plugin-scoped layout. Machine-readable I/O contract for investigating-agentforce-architecture. Orchestrator code reads this file (not SKILL.md prose) to discover the input schema, output keys, STATUS enum, and error-contract rules. The architecture skill runs inline (no subagent).",
-  "_schema_version": "3.1",
-  "_schema_notes": "3.1 (2026-05-05) canonicalizes `invocation_type` on STANDARD_ACTION / UNKNOWN nodes in the metadata tree. Prior versions split this across `raw_invocation_type` (bundle-sourced nodes) and `raw_action_type` (flow-actionCall-sourced nodes). Both legacy keys are still tolerated by readers for one release.",
-  "input": {
-    "required": {
-      "org_alias": {
-        "type": "string",
-        "description": "sf CLI alias (e.g. 'my-org-alias'). Auth is always derived via `sf org display --target-org $ORG_ALIAS --json`."
-      },
-      "agent_api_name": {
-        "type": "string",
-        "regex": "^[A-Za-z0-9_]+$",
-        "description": "BotDefinition.DeveloperName (e.g. 'MyAgent'). Must match the regex above; INVALID_INPUT otherwise."
-      }
-    },
-    "optional": {
-      "agent_version_api_name": {
-        "type": "string",
-        "description": "BotVersion.DeveloperName (e.g. 'v5'). When omitted, the agent auto-picks the Active version with the highest natural-key sort (v10 > v9); VERSION_AUTO_PICKED=true in the RESULT block."
-      },
-      "org_id_15": {
-        "type": "string",
-        "regex": "^[A-Za-z0-9]{15}$",
-        "description": "15-char org ID. If omitted, derived from `sf org display`."
-      },
-      "org_id_18": {
-        "type": "string",
-        "regex": "^[A-Za-z0-9]{18}$",
-        "description": "18-char org ID. If omitted, derived from `sf org display`."
-      },
-      "session_id": {
-        "type": "string",
-        "description": "Only used to name the ephemeral $WORK_DIR. Random UUID if omitted."
-      },
-      "work_dir": {
-        "type": "absolute_path",
-        "description": "Ephemeral scratch. Default: /tmp/investigating-agentforce-architecture-<epoch>-<rand>."
-      },
-      "cache_root": {
-        "type": "absolute_path",
-        "description": "Internal rebuildable cache root. Default: ~/.vibe/cache/investigating-agentforce-architecture. Override with --cache-dir <path>."
-      },
-      "data_root": {
-        "type": "absolute_path",
-        "description": "Durable user-facing output root. Default: ~/.vibe/data/investigating-agentforce-architecture. Override with --data-dir <path>."
-      },
-      "force_refresh": {
-        "type": "boolean",
-        "description": "If true, ignore cache and rewrite. Default: false."
-      }
-    },
-    "minimum_viable": {
-      "org_alias": "my-org-alias",
-      "agent_api_name": "MyAgent"
-    },
-    "notes": [
-      "Standalone and orchestrated modes accept the same input fields; no renames.",
-      "To bypass cache, delete the cache entry or pass force_refresh: true."
-    ]
-  },
-  "output": {
-    "format": "Two-part return message: (1) one-line prose status, (2) blank line, (3) === RESULT === key-value block. The KV block is always LAST in the output and always present.",
-    "parse_rule": "Find the line '=== RESULT ===', then read subsequent lines as KEY=VALUE pairs until EOF. Values are raw strings; no quoting; one pair per line.",
-    "parse_examples": {
-      "bash": "awk -F= '/^STATUS=/{print $2; exit}' <<< \"$subagent_output\"",
-      "python": "import re; dict(line.split('=', 1) for line in output.splitlines() if re.match(r'^[A-Z_]+=', line))"
-    },
-    "keys": {
-      "STATUS": {
-        "type": "enum",
-        "presence": "always",
-        "description": "Terminal status. See error_contract for per-status required keys.",
-        "values": [
-          "OK",
-          "PARTIAL_OK",
-          "INVALID_INPUT",
-          "AUTH_REQUIRED",
-          "AGENT_NOT_FOUND",
-          "AGENT_VERSION_NOT_FOUND",
-          "RETRIEVE_FAILED",
-          "WRITE_FAILED"
-        ]
-      },
-      "ERROR_DETAIL": {
-        "type": "string",
-        "presence": "on_error",
-        "description": "Human-readable explanation on any non-OK STATUS. Sanitized (no backticks/quotes/dollar signs/newlines)."
-      },
-      "AGENT_API_NAME": {
-        "type": "string",
-        "presence": "always",
-        "description": "Echo of input agent_api_name. May be empty on INVALID_INPUT if sanitize rejected before resolution."
-      },
-      "AGENT_VERSION": {
-        "type": "string",
-        "presence": "on_success_or_after_resolve",
-        "description": "Resolved BotVersion.DeveloperName (e.g. 'v5')."
-      },
-      "VERSION_AUTO_PICKED": {
-        "type": "boolean",
-        "presence": "on_success_or_after_resolve",
-        "description": "True iff agent_version_api_name was omitted and the agent auto-picked."
-      },
-      "AGENT_GENERATION": {
-        "type": "enum",
-        "presence": "always",
-        "values": ["classic", "nga", "unknown"],
-        "description": "classic = AiCopilot__ planner, nga = Atlas__ planner, unknown = anything else / not resolved."
-      },
-      "BOT_ID": {
-        "type": "string",
-        "presence": "on_success_or_after_resolve",
-        "description": "18-char BotDefinition.Id from SOQL."
-      },
-      "ORG_ID_15": {
-        "type": "string",
-        "presence": "on_success_or_after_auth",
-        "description": "15-char org ID. Cache-key prefix."
-      },
-      "ORG_ID_18": {
-        "type": "string",
-        "presence": "on_success_or_after_auth",
-        "description": "18-char org ID (from `sf org display`)."
-      },
-      "OUTPUT_JSON_PATH": {
-        "type": "absolute_path",
-        "presence": "on_success",
-        "description": "Durable {agent}_{version}_metadata_tree.json path under the resolved data_root."
-      },
-      "OUTPUT_SUMMARY_PATH": {
-        "type": "absolute_path",
-        "presence": "always_empty",
-        "description": "Reserved — historically pointed at {agent}_{version}_metadata_tree.summary.md. Dropped in ; field is now always emitted empty for RESULT-block shape stability."
-      },
-      "CACHE_PATH": {
-        "type": "absolute_path",
-        "presence": "on_success_or_after_cache_check",
-        "description": "Cache dir ($CACHE_ROOT/$ORG_ID_15/$AGENT__$VERSION/). Ends with /."
-      },
-      "CACHE_HIT": {
-        "type": "boolean",
-        "presence": "on_success_or_after_cache_check",
-        "description": "True iff the cache was served without any Metadata API retrieves."
-      },
-      "CACHED_AT_UTC": {
-        "type": "iso8601_utc_or_empty",
-        "presence": "on_success_or_after_cache_check",
-        "description": "ISO-8601 UTC built-at time. On cache hit this is the age of the cached snapshot; on cold build this is the just-computed timestamp."
-      },
-      "NODE_COUNT": {
-        "type": "integer",
-        "presence": "on_success",
-        "description": "Total nodes in the declared_action_tree."
-      },
-      "DEPTH": {
-        "type": "integer",
-        "presence": "on_success",
-        "description": "Max depth of the tree (BOT_DEFINITION = depth 0)."
-      },
-      "PARTIAL": {
-        "type": "boolean",
-        "presence": "on_success",
-        "description": "True iff the tree is incomplete (planner unresolved OR MAX_WAVE hit). When true, STATUS=PARTIAL_OK."
-      },
-      "UNRESOLVED_COUNT": {
-        "type": "integer",
-        "presence": "on_success",
-        "description": "Length of tree._unresolved[]."
-      },
-      "AVAILABLE_BOTS": {
-        "type": "csv",
-        "presence": "on_AGENT_NOT_FOUND",
-        "description": "Comma-separated list of all BotDefinition.DeveloperName values in the org."
-      },
-      "AVAILABLE_VERSIONS": {
-        "type": "csv",
-        "presence": "on_AGENT_VERSION_NOT_FOUND",
-        "description": "Format: 'v5(Active),v4(Inactive),...' — natural-key sorted DESC."
-      },
-      "RESULT_BLOCK_PATH": {
-        "type": "absolute_path",
-        "presence": "always",
-        "description": "Path to $DATA_DIR/last_result_block.txt — byte-for-byte tee written BEFORE stdout."
-      },
-      "WALL_TIME_SECONDS": {
-        "type": "float",
-        "presence": "always",
-        "description": "End-to-end wall-clock seconds. Two decimals. Target: 90-220s cold, <2s warm."
-      }
-    }
-  },
-  "error_contract": {
-    "OK": {
-      "description": "Tree built, zero unresolved, planner resolved.",
-      "required_keys": ["STATUS", "AGENT_API_NAME", "AGENT_VERSION", "VERSION_AUTO_PICKED", "AGENT_GENERATION", "BOT_ID", "ORG_ID_15", "ORG_ID_18", "OUTPUT_JSON_PATH", "OUTPUT_SUMMARY_PATH", "CACHE_PATH", "CACHE_HIT", "CACHED_AT_UTC", "NODE_COUNT", "DEPTH", "PARTIAL", "UNRESOLVED_COUNT", "RESULT_BLOCK_PATH", "WALL_TIME_SECONDS"],
-      "optional_keys": []
-    },
-    "PARTIAL_OK": {
-      "description": "Tree built but planner unresolved (Bot.bot had no planner) OR waves hit MAX_WAVE=5. tree._unresolved[] explains.",
-      "required_keys": ["STATUS", "AGENT_API_NAME", "AGENT_VERSION", "AGENT_GENERATION", "BOT_ID", "ORG_ID_15", "ORG_ID_18", "OUTPUT_JSON_PATH", "CACHE_PATH", "PARTIAL", "UNRESOLVED_COUNT", "WALL_TIME_SECONDS", "RESULT_BLOCK_PATH"],
-      "optional_keys": ["OUTPUT_SUMMARY_PATH", "CACHE_HIT", "CACHED_AT_UTC", "NODE_COUNT", "DEPTH", "VERSION_AUTO_PICKED", "ERROR_DETAIL"]
-    },
-    "INVALID_INPUT": {
-      "description": "agent_api_name failed [A-Za-z0-9_]+ regex, or other input validation (org_alias empty, ORG_ID_15 regex, $WORK_DIR symlink/foreign-owned).",
-      "required_keys": ["STATUS", "ERROR_DETAIL", "AGENT_API_NAME"],
-      "optional_keys": ["ORG_ID_15", "ORG_ID_18"]
-    },
-    "AUTH_REQUIRED": {
-      "description": "`sf org display` returned nothing, or a SOQL/Metadata call failed with an auth error. Caller must run `sf org login web --alias $ORG_ALIAS`.",
-      "required_keys": ["STATUS", "ERROR_DETAIL", "AGENT_API_NAME"],
-      "optional_keys": ["ORG_ID_15", "ORG_ID_18"]
-    },
-    "AGENT_NOT_FOUND": {
-      "description": "BotDefinition.DeveloperName not in the org. AVAILABLE_BOTS carries the CSV of what IS in the org.",
-      "required_keys": ["STATUS", "ERROR_DETAIL", "AGENT_API_NAME", "AVAILABLE_BOTS"],
-      "optional_keys": ["ORG_ID_15", "ORG_ID_18"]
-    },
-    "AGENT_VERSION_NOT_FOUND": {
-      "description": "No matching BotVersion under the bot (explicit version doesn't exist, or no Active version found during auto-pick).",
-      "required_keys": ["STATUS", "ERROR_DETAIL", "AGENT_API_NAME", "AVAILABLE_VERSIONS"],
-      "optional_keys": ["BOT_ID", "ORG_ID_15", "ORG_ID_18"]
-    },
-    "RETRIEVE_FAILED": {
-      "description": "`sf project retrieve start` failed (network, permissions, zip unreadable). ERROR_DETAIL carries the specifics.",
-      "required_keys": ["STATUS", "ERROR_DETAIL", "AGENT_API_NAME", "AGENT_VERSION", "BOT_ID"],
-      "optional_keys": ["ORG_ID_15", "ORG_ID_18", "OUTPUT_JSON_PATH"]
-    },
-    "WRITE_FAILED": {
-      "description": "Filesystem write failed during finalize (DATA_DIR rename, CACHE_DIR rename, or tree rewrite).",
-      "required_keys": ["STATUS", "ERROR_DETAIL", "AGENT_API_NAME", "AGENT_VERSION"],
-      "optional_keys": ["BOT_ID", "ORG_ID_15", "ORG_ID_18", "CACHE_HIT", "CACHED_AT_UTC"]
-    }
-  },
-  "stability": {
-    "key_names": "Stable. Key-name changes require a NOTICE.md entry and a skill reinstall; consumers read this contract to discover the current key set.",
-    "error_codes": "The STATUS enum is fixed at 8 values. A new status is a breaking change for consumers that switch on STATUS.",
-    "path_format": "All path values are absolute (no tilde expansion required). One KEY=VALUE per line. No trailing whitespace.",
-    "order": "Keys inside the RESULT block appear in a stable order — orchestrators should not depend on order but may use it for human readability."
-  },
-  "referenced_files": {
-    "skill_md": "<SKILL_ROOT>/SKILL.md"
-  }
-}