agentbundle 0.2.0__py3-none-any.whl

agentbundle/_data/adapter.toml

@@ -0,0 +1,584 @@
+# Adapter contract — every (primitive × adapter) pair enumerated.
+# Validates against ./adapter.schema.json.
+# Managed by: docs/specs/distribution-adapters/spec.md
+# RFC reference: RFC-0001 (base contract); RFC-0004 (scope dimension, v0.2);
+# RFC-0005 (hook-body / hook-wiring forks, v0.3);
+# RFC-0008 (claude-plugins install route, v0.4);
+# RFC-0010 (apm install route, v0.5);
+# RFC-0011 / docs/specs/pack-allowed-adapters (codex user-scope table, v0.6);
+# RFC-0012 / docs/specs/repo-scope-per-adapter-projection (per-IDE projection
+# at repo scope; `allowed-prefixes.repo` on every adapter; copilot scope
+# table; v0.7).
+# RFC-0013 / docs/specs/credential-broker-contract (governance bump, v0.7 —
+# admitted as a co-residing v0.7 contributor; the `metadata.auth` lint
+# surface lives in tools/lint-agent-artifacts.py, not in this file).
+# docs/specs/dropped-primitives-coverage (v0.8): codex `agent` projects to
+# `.codex/agents/<name>.toml` via new `codex-agent-toml` mode; codex
+# `hook-wiring` projects to `.codex/hooks.json` via existing `merge-json`
+# mode; codex `.codex/` added to allowed-prefixes; new `codex-agent-
+# frontmatter-v0.8` mapping. Dropped-primitives warning rail introduced
+# in `agentbundle install` for any (adapter, pack) pair where the
+# resolved adapter projects a primitive type the pack ships as `dropped`.
+# RFC-0022 / docs/specs/kiro-adapter-split (v0.9): kiro adapter split into
+# `kiro-ide` (IDE, .md agents, kiro-ide-hook active, flat path confirmed by
+# Q6 probe no×yes 2026-06-01) and `kiro-cli` (CLI binary, .json agents,
+# hook-wiring retained). `kiro` retained as deprecated alias for `kiro-ide`.
+# `kiro-ide-hook` primitive activated; `kiro-ide-agent-frontmatter-v0.9` renamed
+# to `kiro-ide-agent-frontmatter-v0.9`.
+# RFC-0024 / ADR-0013 / docs/specs/copilot-full-parity (v0.10): copilot becomes
+# a full-parity, user-scope-capable adapter. `agent` flips `dropped`→
+# `copilot-agent-md` (markdown → `.github/agents/<name>.agent.md`); `hook-wiring`
+# flips `dropped`→`copilot-hooks-json` (one self-contained `<name>.json` per
+# source file at `.github/hooks/`); `hook-body` retargets `tools/hooks/`→
+# `.github/hooks/`; `skill` gains a user target (`~/.copilot/instructions/`);
+# `[adapter.copilot.scope]` gains `user = "~"` + `allowed-prefixes.user`; new
+# `copilot-agent-frontmatter-v0.10` mapping. `command` stays `dropped`
+# (copilot-cli#618/#1113). Two-pack bump (research + core), not all-pack.
+
+[contract]
+version = "0.10"
+
+# Sibling schemas this contract references — pack metadata and the
+# per-pack Claude-plugin manifest. Defined by spec AC #3 + #4.
+[contract.schemas]
+pack = "pack.schema.json"
+plugin-manifest = "plugin-manifest.schema.json"
+
+# ---------------------------------------------------------------------------
+# Primitive types — source paths within a pack's .apm/ directory
+# ---------------------------------------------------------------------------
+
+[primitive.skill]
+source-path = ".apm/skills/"
+
+[primitive.agent]
+source-path = ".apm/agents/"
+
+[primitive."hook-body"]
+source-path = ".apm/hooks/"
+
+[primitive."hook-wiring"]
+source-path = ".apm/hook-wiring/"
+
+[primitive.command]
+source-path = ".apm/commands/"
+
+# RFC-0022 / kiro-ide-hook: standalone IDE event hook files (.kiro.hook JSON).
+# Activated at v0.9 for the kiro-ide adapter; dropped for kiro-cli and others.
+[primitive."kiro-ide-hook"]
+source-path = ".apm/kiro-ide-hooks/"
+
+# RFC-0013 § 4c — `shared-libs/` carries Python sibling files that the
+# build pipeline projects into every consumer skill declaring
+# `metadata.auth: creds`. The projection is cross-cutting (not adapter-
+# keyed) and lives in `agentbundle.build.shared_libs`; the declaration
+# here documents the source path so future readers see the full
+# primitive surface in one place.
+[primitive."shared-libs"]
+source-path = ".apm/shared-libs/"
+
+# RFC-0013 § 4d — `adapter-root-bins/` carries executable scripts that
+# project to the per-scope artifact root (`~/.agentbundle/bin/` at user
+# scope, `<repo>/.agentbundle/bin/` at repo scope). T6 wires the
+# projection; the declaration is here so the contract is complete at
+# v0.7. Adapter projection rules for `adapter-root-bins` are NOT
+# declared because the target is `<scope-root>/.agentbundle/bin/`,
+# which is fenced by `allowed-prefixes.<scope>`, not by per-adapter
+# target paths.
+[primitive."adapter-root-bins"]
+source-path = ".apm/adapter-root-bins/"
+
+# ---------------------------------------------------------------------------
+# Claude Code adapter — 5 projections (one per primitive) + v0.3 forks
+#
+# The legacy `[[adapter."claude-code".projection]]` array carries the
+# repo-scope shape every adapter has consumed since v0.1. RFC-0005 adds two
+# forward-looking `[adapter."claude-code".projections.<primitive>]` tables
+# (hook-body / hook-wiring) carrying the scope-conditional shape that the
+# v0.3 user-scope pipeline reads. Until that pipeline lands, the legacy
+# entries remain authoritative; the new tables are declarative metadata.
+# ---------------------------------------------------------------------------
+
+# Install routes declared for this adapter (RFC-0008 / spec claude-plugins-install-route;
+# RFC-0010 / spec apm-install-route-parity adds "apm").
+# Kiro, Copilot, and Codex do not declare install-routes; the field defaults to ["cli"]
+# on read for adapters that omit it.
+[adapter."claude-code"]
+install-routes = ["cli", "claude-plugins", "apm"]
+
+[[adapter."claude-code".projection]]
+primitive = "skill"
+mode = "direct-directory"
+target-path = ".claude/skills/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter."claude-code".projection]]
+primitive = "agent"
+mode = "direct-file"
+target-path = ".claude/agents/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter."claude-code".projection]]
+primitive = "hook-body"
+mode = "direct-file"
+target-path = "tools/hooks/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter."claude-code".projection]]
+primitive = "hook-wiring"
+mode = "merge-json"
+target-path = ".claude/settings.local.json"
+managed-key = "hooks"
+on-conflict = "merge-managed-key-only"
+
+[[adapter."claude-code".projection]]
+primitive = "command"
+mode = "direct-file"
+target-path = ".claude/commands/"
+on-conflict = "prompt-then-preserve"
+
+# hook-body — scope-conditional target (RFC-0005 § hook-body at user scope).
+# Forward-looking v0.3 declaration; the legacy array entry above remains the
+# pipeline-of-record until T5/T7 land.
+[adapter."claude-code".projections.hook-body]
+mode = "direct-file"
+target.repo = "tools/hooks/<name>.{sh,py}"
+target.user = ".claude/hooks/<name>.{sh,py}"
+on-conflict = "prompt-then-preserve"
+
+# hook-wiring — scope-conditional mode/target; user-scope `managed-key`
+# required (RFC-0005 § hook-wiring for Claude Code at user scope).
+[adapter."claude-code".projections.hook-wiring]
+mode.repo = "merge-json"
+mode.user = "user-merge-json"
+target.repo = ".claude/settings.local.json"
+target.user = ".claude/settings.json"
+managed-key.user = "hooks"
+
+# Scope dimension (RFC-0004). Two roots: repo-local and user-local.
+# `allowed-prefixes.<scope>` fences every write under that scope to a
+# declared prefix list — at user scope this stops a buggy projection
+# rule from resolving under `~/Documents/`. The two-prefix shape covers
+# projected primitives (`.claude/`) and CLI infrastructure writes
+# (`.agentbundle/` — user-scope state file, per-scope discovery and
+# pending artifacts).
+[adapter."claude-code".scope]
+repo = "."
+user = "~"
+# RFC-0012: repo-scope projection lands primitives under `.claude/` (skills,
+# agents, commands, hook-wiring) plus `tools/hooks/` for hook bodies — the
+# legacy repo-scope hook-body target that pre-dates the scope dimension.
+allowed-prefixes.repo = [".claude/", ".agentbundle/", "tools/hooks/"]
+allowed-prefixes.user = [".claude/", ".agentbundle/"]
+
+# ---------------------------------------------------------------------------
+# Kiro adapter — DEPRECATED ALIAS for kiro-ide (RFC-0022 D1).
+#
+# `kiro` is retained as a working alias with no removal timeline so existing
+# packs declaring `allowed-adapters = ["kiro"]` keep working. The Python
+# registry maps "kiro" → kiro_ide.project and emits a build-time
+# DeprecationWarning on use. Update `allowed-adapters` to `["kiro-ide"]` or
+# `["kiro-cli"]` in pack.toml to silence the warning.
+#
+# The projection blocks below are preserved verbatim so `validate` keeps
+# accepting "kiro" and `_shipped_for_cli` (derived from the adapter key set)
+# continues to include it.
+# ---------------------------------------------------------------------------
+
+[[adapter.kiro.projection]]
+primitive = "skill"
+mode = "direct-directory"
+target-path = ".kiro/skills/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro.projection]]
+primitive = "agent"
+mode = "direct-file"
+target-path = ".kiro/agents/"
+frontmatter-mapping = "kiro-ide-agent-frontmatter-v0.9"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro.projection]]
+primitive = "hook-body"
+mode = "direct-file"
+target-path = "tools/hooks/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro.projection]]
+primitive = "command"
+mode = "dropped"
+
+# hook-body — scope-conditional target. User-scope lands under `~/.kiro/hooks/`
+# per RFC-0005 § hook-body at user scope. Forward-looking v0.3 declaration;
+# the legacy array entry above remains authoritative until T5/T7.
+[adapter.kiro.projections.hook-body]
+mode = "direct-file"
+target.repo = "tools/hooks/<name>.{sh,py}"
+target.user = ".kiro/hooks/<name>.{sh,py}"
+on-conflict = "prompt-then-preserve"
+
+# hook-wiring — merge into the pack-owned agent JSON. Same mode at both scopes;
+# the agent-file target is scope-conditional via scope-root resolution
+# (RFC-0005 § hook-wiring for Kiro at both scopes). The legacy
+# `degraded-info-log` array entry is removed (AC2).
+[adapter.kiro.projections.hook-wiring]
+mode = "merge-into-agent-json"
+target.repo = ".kiro/agents/<attach-to-agent>.json"
+target.user = ".kiro/agents/<attach-to-agent>.json"
+managed-key = "hooks"
+agent-event-vocabulary = [
+  "agentSpawn",
+  "userPromptSubmit",
+  "preToolUse",
+  "postToolUse",
+  "stop",
+]
+
+# Scope dimension for Kiro (RFC-0005 § hook-wiring for Kiro at both scopes).
+# User-scope agents live under `~/.kiro/agents/` per Kiro's documented layout
+# (https://kiro.dev/docs/cli/custom-agents/creating/); CLI infrastructure
+# shares the `.agentbundle/` prefix.
+[adapter.kiro.scope]
+repo = "."
+user = "~"
+# RFC-0012: Kiro projects skills/agents to `.kiro/`; hook bodies land in the
+# legacy `tools/hooks/` at repo scope (matching the contract's hook-body
+# array entry above).
+allowed-prefixes.repo = [".kiro/", ".agentbundle/", "tools/hooks/"]
+allowed-prefixes.user = [".kiro/", ".agentbundle/"]
+
+# ---------------------------------------------------------------------------
+# kiro-ide adapter — targets the Kiro VS Code-fork IDE (RFC-0022).
+#
+# Projects agents as `.md` (gray-matter YAML frontmatter + body); the IDE
+# reads `.kiro/agents/<name>.md` via its gray-matter loader. hook-wiring is
+# DROPPED — the IDE loader silently drops any agent carrying a `hooks` key
+# (RFC-0022 E2). kiro-ide-hook is ACTIVATED with the flat path confirmed by
+# Q6 probe (no-recursion, yes-extension-filter, 2026-06-01, Kiro 0.12.224):
+# `.kiro/hooks/<pack>--<name>.kiro.hook`. RFC-0022 assumed yes-recursion;
+# T1 carries the corrected no-recursion flat path (no T-E1b fires).
+# ---------------------------------------------------------------------------
+
+[[adapter.kiro-ide.projection]]
+primitive = "skill"
+mode = "direct-directory"
+target-path = ".kiro/skills/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro-ide.projection]]
+primitive = "agent"
+mode = "direct-file"
+target-path = ".kiro/agents/"
+frontmatter-mapping = "kiro-ide-agent-frontmatter-v0.9"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro-ide.projection]]
+primitive = "hook-body"
+mode = "direct-file"
+target-path = "tools/hooks/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro-ide.projection]]
+primitive = "hook-wiring"
+mode = "dropped"
+
+[[adapter.kiro-ide.projection]]
+primitive = "command"
+mode = "dropped"
+
+# hook-body — scope-conditional target (RFC-0005 § hook-body at user scope).
+[adapter.kiro-ide.projections.hook-body]
+mode = "direct-file"
+target.repo = "tools/hooks/<name>.{sh,py}"
+target.user = ".kiro/hooks/<name>.{sh,py}"
+on-conflict = "prompt-then-preserve"
+
+# kiro-ide-hook — activated for the IDE target (Q6 probe: no-recursion,
+# yes-extension-filter). Flat path uses `<pack>--<name>` prefix separator
+# so pack hooks coexist in the single flat `.kiro/hooks/` directory.
+[adapter.kiro-ide.projections.kiro-ide-hook]
+mode = "direct-file"
+target.repo = ".kiro/hooks/<pack>--<name>.kiro.hook"
+ide-event-vocabulary = [
+  "fileEdited",
+  "fileCreated",
+  "fileDeleted",
+  "userTriggered",
+  "promptSubmit",
+  "agentStop",
+  "preToolUse",
+  "postToolUse",
+  "preTaskExecution",
+  "postTaskExecution",
+  "sessionStart",
+]
+ide-action-vocabulary = ["askAgent", "runCommand"]
+
+[adapter.kiro-ide.scope]
+repo = "."
+user = "~"
+allowed-prefixes.repo = [".kiro/", ".agentbundle/", "tools/hooks/"]
+allowed-prefixes.user = [".kiro/", ".agentbundle/"]
+
+# ---------------------------------------------------------------------------
+# kiro-cli adapter — targets the `kiro` terminal binary (RFC-0022).
+#
+# Projects agents as `.json` with CLI short-name tool tokens. Retains
+# `hook-wiring` via `merge-into-agent-json`. `kiro-ide-hook` is dropped —
+# the IDE-only event-hook primitive is not supported by the CLI target.
+# ---------------------------------------------------------------------------
+
+[[adapter.kiro-cli.projection]]
+primitive = "skill"
+mode = "direct-directory"
+target-path = ".kiro/skills/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro-cli.projection]]
+primitive = "agent"
+mode = "direct-file"
+target-path = ".kiro/agents/"
+frontmatter-mapping = "kiro-cli-agent-frontmatter-v1.0"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro-cli.projection]]
+# Legacy repo-scope entry — the pipeline-of-record for repo-scope hook-body
+# projection (mirrors the `kiro` adapter's RFC-0005 hybrid). The table form
+# below is the scope-conditional declaration for the user-scope pipeline;
+# both coexist intentionally. `_iter_primitives` deduplicates via set union.
+primitive = "hook-body"
+mode = "direct-file"
+target-path = "tools/hooks/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.kiro-cli.projection]]
+primitive = "command"
+mode = "dropped"
+
+# hook-body — scope-conditional target (RFC-0005 § hook-body at user scope).
+[adapter.kiro-cli.projections.hook-body]
+mode = "direct-file"
+target.repo = "tools/hooks/<name>.{sh,py}"
+target.user = ".kiro/hooks/<name>.{sh,py}"
+on-conflict = "prompt-then-preserve"
+
+# hook-wiring — merge into the pack-owned agent JSON (same as legacy kiro).
+[adapter.kiro-cli.projections.hook-wiring]
+mode = "merge-into-agent-json"
+target.repo = ".kiro/agents/<attach-to-agent>.json"
+target.user = ".kiro/agents/<attach-to-agent>.json"
+managed-key = "hooks"
+agent-event-vocabulary = [
+  "agentSpawn",
+  "userPromptSubmit",
+  "preToolUse",
+  "postToolUse",
+  "stop",
+]
+
+# kiro-ide-hook — dropped for the CLI target. The IDE-only event-hook
+# primitive is not supported by the kiro binary; packs shipping
+# .apm/kiro-ide-hooks/ content must use the kiro-ide adapter instead.
+[adapter.kiro-cli.projections.kiro-ide-hook]
+mode = "dropped"
+
+[adapter.kiro-cli.scope]
+repo = "."
+user = "~"
+allowed-prefixes.repo = [".kiro/", ".agentbundle/", "tools/hooks/"]
+allowed-prefixes.user = [".kiro/", ".agentbundle/"]
+
+# ---------------------------------------------------------------------------
+# Copilot adapter — 5 projections (one per primitive)
+# ---------------------------------------------------------------------------
+
+[[adapter.copilot.projection]]
+primitive = "skill"
+mode = "instruction-file"
+target-path = ".github/instructions/"
+frontmatter-default = "copilot-instruction"
+on-conflict = "prompt-then-overwrite"
+
+[[adapter.copilot.projection]]
+primitive = "agent"
+mode = "copilot-agent-md"
+target-path = ".github/agents/"
+frontmatter-mapping = "copilot-agent-frontmatter-v0.10"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.copilot.projection]]
+primitive = "hook-body"
+mode = "direct-file"
+target-path = ".github/hooks/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.copilot.projection]]
+primitive = "hook-wiring"
+mode = "copilot-hooks-json"
+target-path = ".github/hooks/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.copilot.projection]]
+primitive = "command"
+mode = "dropped"
+
+# Scope dimension for Copilot (RFC-0024 / ADR-0013 / docs/specs/copilot-full-parity).
+# Copilot is now a full-parity, user-scope-capable adapter: the app + CLI
+# discover agents/instructions/hooks from `.github/` (repo) and `~/.copilot/`
+# (user). The repo-only restriction RFC-0012 recorded is superseded-in-part.
+# `skill` keeps its `instruction-file` mode; its user target
+# (`~/.copilot/instructions/<name>.instructions.md`) is produced by the install
+# handler's copilot user-scope prefix rewrite (`.github/X/`→`.copilot/X/`),
+# since the build adapter is scope-agnostic and emits repo-relpaths.
+[adapter.copilot.scope]
+repo = "."
+user = "~"
+# RFC-0024: repo-scope agents at `.github/agents/`, instructions at
+# `.github/instructions/`, hook wiring + bodies at `.github/hooks/`.
+allowed-prefixes.repo = [".github/instructions/", ".github/agents/", ".github/hooks/"]
+# User-scope home is `~/.copilot/` — the prefix the install rewrite produces
+# from the adapter's repo-relpaths. `.agentbundle/` carries the install
+# state file (`~/.agentbundle/state.toml`), same as every other user-scope-
+# capable adapter (claude-code, codex).
+allowed-prefixes.user = [".copilot/agents/", ".copilot/instructions/", ".copilot/hooks/", ".agentbundle/"]
+
+# ---------------------------------------------------------------------------
+# Codex adapter — 5 projections (one per primitive)
+# ---------------------------------------------------------------------------
+
+[[adapter.codex.projection]]
+primitive = "skill"
+mode = "direct-directory"
+target-path = ".agents/skills/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.codex.projection]]
+primitive = "agent"
+mode = "codex-agent-toml"
+target-path = ".codex/agents/"
+frontmatter-mapping = "codex-agent-frontmatter-v0.8"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.codex.projection]]
+primitive = "hook-body"
+mode = "direct-file"
+target-path = "tools/hooks/"
+on-conflict = "prompt-then-preserve"
+
+[[adapter.codex.projection]]
+primitive = "hook-wiring"
+mode = "merge-json"
+target-path = ".codex/hooks.json"
+managed-key = "hooks"
+on-conflict = "merge-managed-key-only"
+
+[[adapter.codex.projection]]
+primitive = "command"
+mode = "dropped"
+
+# Scope dimension for Codex (RFC-0011 / docs/specs/pack-allowed-adapters).
+# User-scope skills live under `~/.agents/skills/` per the codex
+# `direct-directory` projection's `.agents/skills/` target-path above;
+# CLI infrastructure shares the `.agentbundle/` prefix.
+[adapter.codex.scope]
+repo = "."
+user = "~"
+# RFC-0012: codex projects skills to `.agents/skills/`; hook bodies land in
+# the legacy `tools/hooks/` (matching codex's hook-body array entry).
+allowed-prefixes.repo = [".agents/skills/", ".codex/", ".agentbundle/", "tools/hooks/"]
+allowed-prefixes.user = [".agents/skills/", ".codex/", ".agentbundle/"]
+
+# ---------------------------------------------------------------------------
+# Frontmatter mappings — rewrite rules applied when projecting a primitive
+# ---------------------------------------------------------------------------
+
+# Kiro agent frontmatter v0.9: renames Claude Code agent fields to Kiro's schema.
+# Adapters consume this table generically; no field dictionary hardcoded in Python.
+[frontmatter-mapping."kiro-ide-agent-frontmatter-v0.9"]
+
+[frontmatter-mapping."kiro-ide-agent-frontmatter-v0.9".description]
+rename = "description"
+
+[frontmatter-mapping."kiro-ide-agent-frontmatter-v0.9".tools]
+normalize = "to-list"
+# Translate Claude Code tool names to specific Kiro tool *ids*. Kiro matches
+# an agent's `tools` entries by id or tag (never by Claude Code names); we
+# prefer ids for a faithful, least-privilege 1:1 mapping rather than the
+# broad category tags (the `read` tag also grants diagnostics + read_code;
+# `write` also grants delete_file). `WebSearch` is the exception — the IDE
+# exposes no granular web-search tool id, so it maps to the `web` tag.
+# Applied per list element after `to-list`; duplicates collapse and an
+# unmapped token drops with a build-time warning. These are Kiro IDE ids;
+# the Kiro CLI's short names land in the kiro-cli adapter.
+values = { Read = "read_file", Grep = "grep_search", Glob = "file_search", Edit = "str_replace", Write = "fs_write", MultiEdit = "str_replace", Bash = "execute_bash", WebFetch = "web_fetch", WebSearch = "web" }
+
+[frontmatter-mapping."kiro-ide-agent-frontmatter-v0.9".model]
+rename = "model"
+# Translate Claude Code's friendly aliases to Kiro's documented model IDs
+# (https://kiro.dev/docs/cli/custom-agents/configuration-reference/). A
+# source value not in the map is dropped from the JSON output, leaving
+# Kiro to fall back to its CLI default with a warning rather than
+# rejecting the agent for an unknown model.
+values = { opus = "claude-opus-4.6", sonnet = "claude-sonnet-4.5", haiku = "claude-haiku-4.5" }
+
+# kiro-cli agent frontmatter v1.0 (RFC-0022): rewrite rules from Claude Code
+# agent markdown to Kiro CLI JSON. Tools map to CLI short-names (not IDE ids).
+# The `kiro` CLI matches agents' `tools` entries by short name; the IDE uses
+# ids — hence the separate table rather than reusing kiro-ide-agent-frontmatter-v0.9.
+[frontmatter-mapping."kiro-cli-agent-frontmatter-v1.0"]
+
+[frontmatter-mapping."kiro-cli-agent-frontmatter-v1.0".description]
+rename = "description"
+
+[frontmatter-mapping."kiro-cli-agent-frontmatter-v1.0".tools]
+normalize = "to-list"
+# Translate Claude Code tool names to Kiro CLI short-name tool tokens.
+# Applied per list element after `to-list`; duplicates collapse and an
+# unmapped token drops with a build-time warning.
+values = { Read = "read", Grep = "grep", Glob = "glob", Edit = "write", Write = "write", MultiEdit = "write", Bash = "shell", WebFetch = "web_fetch", WebSearch = "web_search" }
+
+[frontmatter-mapping."kiro-cli-agent-frontmatter-v1.0".model]
+rename = "model"
+values = { opus = "claude-opus-4.6", sonnet = "claude-sonnet-4.5", haiku = "claude-haiku-4.5" }
+
+# Codex agent frontmatter v0.8 (docs/specs/dropped-primitives-coverage):
+# rewrite rules from claude-code-style markdown agent (YAML frontmatter with
+# `name`, `description`, optionally `tools`, `model`) to codex's TOML agent
+# shape (`name`, `description`, `developer_instructions`). The markdown body
+# lands in TOML `developer_instructions` via a mode-level convention in the
+# `codex-agent-toml` projection mode, NOT via a rename rule (frontmatter
+# mapping is keyed on frontmatter fields; the body is not one). Fields not
+# in this mapping (e.g., `tools`, `model`) drop silently — codex TOML agent
+# format has no equivalent slots; a future RFC can add MCP-server mapping.
+[frontmatter-mapping."codex-agent-frontmatter-v0.8"]
+
+[frontmatter-mapping."codex-agent-frontmatter-v0.8".name]
+rename = "name"
+
+[frontmatter-mapping."codex-agent-frontmatter-v0.8".description]
+rename = "description"
+
+# Copilot agent frontmatter v0.10 (RFC-0024 / docs/specs/copilot-full-parity):
+# rewrite rules from claude-code-style markdown agent (YAML frontmatter with
+# `name`, `description`, optionally `tools`, `model`) to Copilot's `.agent.md`
+# shape. `name` / `description` pass through (identity renames). `tools` is
+# NOT a rename rule — the `copilot-agent-md` mode emits it verbatim after an
+# allow-list validation (Copilot's parser self-resolves the Claude names), so
+# a `values` map here would be redundant. `model` is absent from this mapping
+# and so drops on projection (the CLI ignores it; our values aren't Copilot
+# model ids — copilot-cli#2133/#1195). `target` is never emitted.
+[frontmatter-mapping."copilot-agent-frontmatter-v0.10"]
+
+[frontmatter-mapping."copilot-agent-frontmatter-v0.10".name]
+rename = "name"
+
+[frontmatter-mapping."copilot-agent-frontmatter-v0.10".description]
+rename = "description"
+
+# ---------------------------------------------------------------------------
+# Frontmatter defaults — fields injected when a primitive has no frontmatter
+# ---------------------------------------------------------------------------
+
+# Copilot instruction file default: applyTo covers the whole repo.
+[frontmatter-default."copilot-instruction"]
+applyTo = "**"