agentera 3.0.0-dev.2 → 3.0.0-dev.21

package/bundle/references/adapters/runtime-feature-parity.md

@@ -1,189 +1,129 @@
-# Runtime feature parity reference
-
-Tracks release-relevant runtime behavior for the portable agentera suite.
-
-This reference distinguishes implemented behavior from host support. A runtime
-may expose an event while agentera still lacks a shipped adapter path for it.
-
-## Summary
-
-| Runtime | Skill loading | Session preload | Artifact validation | Session bookmark |
-|---------|---------------|-----------------|---------------------|------------------|
-| Claude Code | Full: marketplace plugin and native skill paths load `skills/<name>/SKILL.md` | Active via `SessionStart` in `hooks/hooks.json` | Advisory after mutation via `PostToolUse` for `Edit` or `Write` | Active via `Stop` |
-| OpenCode | Full: native `skill` tool loads `.opencode`, `.claude`, and `.agents` skill paths | Deferred for session start: `session.created` is observable, but no model-context injection path is verified. Active for compaction through bounded `experimental.session.compacting` context from `agentera hej --format json`. | Conditional hard gate for reconstructable `write` and `edit` candidates via `tool.execute.before`; `tool.execute.after` remains advisory | Active via generic `event` hook on `session.idle` |
-| Copilot CLI | Full for portable skills through plugin or skill-folder install paths | Active via `sessionStart` | Conditional hard gate via `preToolUse` when `toolArgs` include path plus candidate content or exact replacement evidence | Active via `sessionEnd` |
-| Codex CLI | Full for portable skills through plugin install, `.agents/skills`, and `$skill` invocation | Not wired by the shipped hook config | Advisory `apply_patch` path validation through shipped PreToolUse and PostToolUse hooks; final patch content is not reconstructed | Not wired by the shipped hook config |
-| Cursor IDE | Full for portable skills through local plugin (`~/.cursor/plugins/local/agentera` via `.cursor-plugin/plugin.json`), repo-native surfaces, and upgrade-installed `.cursor/` targets | Active via `sessionStart` env export plus optional `additional_context` digest; plugin-root fallback when `AGENTERA_HOME` env and project walk-up fail (`hooks/cursor_session_start.py`) | Conditional hard gate for reconstructable `Write` and `Edit` candidates via `preToolUse`; verified after live preToolUse Write smoke (2026-05-24) | Active via `sessionEnd` |
-| Cursor Agent CLI | Full when workspace surfaces are installed; degraded when launched outside a Cursor project | Degraded relative to IDE sessionStart env export | Degraded hook parity; follows IDE smoke evidence only | Degraded relative to IDE `sessionEnd` wiring |
-
-## Profilera session corpus
-
-| Runtime | Local session mining | Evidence |
-| ------- | -------------------- | -------- |
-| Claude Code | Yes: `~/.claude/projects/**/*.jsonl` | `scripts/extract_corpus.py` |
-| Codex CLI | Yes: `~/.codex/sessions/**/*.jsonl` | `scripts/extract_corpus.py` |
-| OpenCode | Yes: `opencode.db` SQLite stores | `scripts/extract_corpus.py`, `references/adapters/opencode.md` |
-| Copilot CLI | Yes: `session-store.db` SQLite stores | `scripts/extract_corpus.py` |
-| Cursor IDE | Yes: `~/.cursor/projects/*/agent-transcripts/*/*.jsonl` | `scripts/extract_corpus.py`, `references/adapters/cursor.md` |
-| Cursor Agent CLI | Yes: gap-fill from `~/.config/cursor/chats/<md5(project)>/<session>/store.db` when no IDE JSONL exists | `scripts/extract_corpus.py`, `references/adapters/cursor.md` |
-
-## Bare `hej` routing
-
-| Runtime | Bare text `hej` behavior | Evidence |
-|---------|--------------------------|----------|
-| OpenCode | Deterministic exact-match adapter route through `chat.message`; only a complete lowercase text message `hej` is rewritten to load `agentera` and run the `agentera hej` dashboard path, accepting OpenCode's CLI-added single trailing newline as a transport artifact. | `.opencode/plugins/agentera.js`, `scripts/smoke_opencode_bootstrap.mjs`, OpenCode `packages/plugin/src/index.ts` Hooks interface |
-| Claude Code | Metadata/context only; `UserPromptSubmit` can observe or add context but is not a verified prompt rewrite router. | `skills/agentera/SKILL.md`, marketplace metadata |
-| Copilot CLI | Metadata/context only; skills, prompts, hooks, and plugins expose Agentera but do not guarantee pre-model bare-prompt routing. | `plugin.json`, `.github/plugin/plugin.json`, `.github/hooks` |
-| Codex CLI | Metadata/context only; `$agentera` is explicit and the legacy `$hej` bridge is not implicitly invocable. | `.codex-plugin/plugin.json`, `agents/openai.yaml` |
-| Cursor IDE | Metadata/context only; `beforeSubmitPrompt` is supported by the host but Agentera v1 does not rewrite bare `hej`. | `.cursor-plugin/plugin.json`, `.cursor/agents/*.md` |
-| Cursor Agent CLI | Metadata/context only like Claude, Copilot, and Codex. | `references/adapters/cursor.md`, eval runner metadata |
-
-## Artifact validation
-
-| Runtime | Blocking surface | Implemented gate | Evidence-insufficient paths | Verification surface |
-|---------|------------------|------------------|-----------------------------|----------------------|
-| Claude Code | None in shipped config; validation runs after `Edit` or `Write` | No pre-write hard gate is claimed | Any invalid artifact can already be written before the warning appears | `hooks/hooks.json`, `hooks/validate_artifact.py` |
-| OpenCode | `tool.execute.before` can throw before mutation | Invalid reconstructable artifact `write` and `edit` candidates are blocked | Sparse payloads and `apply_patch` `patchText` without reconstructed full content are allowed | `.opencode/plugins/agentera.js`, `scripts/smoke_opencode_bootstrap.mjs` |
-| Copilot CLI | `preToolUse` returns `permissionDecision: deny` | Invalid reconstructable artifact candidates are denied | Malformed, sparse, or non-reconstructable `toolArgs` are allowed | `.github/hooks/preToolUse.json`, `hooks/validate_artifact.py`, `tests/test_validate_artifact.py` |
-| Codex CLI | `codex_hooks` can run before and after `apply_patch` | No content hard gate is claimed; the copied user hook config parses touched paths and validates existing files; optional plugin-bundled hooks require `[features].plugin_hooks = true` plus `/hooks` review | Add-file targets and final post-patch candidate content are not reconstructed by the adapter | `~/.codex/hooks.json` generated by upgrade, `.codex-plugin/plugin.json` `hooks`, `hooks/codex-plugin-hooks.json`, `hooks/validate_artifact.py`, live apply_patch hook firing smoke |
-| Cursor IDE | `preToolUse` returns `permission: deny` when wired | Invalid reconstructable artifact candidates are denied; live preToolUse Write smoke passed 2026-05-24 | Malformed, sparse, or non-reconstructable tool_input payloads are allowed | `.cursor/hooks.json`, `hooks/cursor_pre_tool_use.py`, `hooks/validate_artifact.py`, `.agentera/smoke-cursor-pretooluse-evidence.txt` |
-| Cursor Agent CLI | None claimed for standalone CLI | No IDE-equivalent hard gate is claimed | CLI may run without project hook wiring | `scripts/eval_skills.py --runtime cursor-agent` |
-
-Docs may claim functional hard-gate parity only for closeable paths that are
-implemented and verified. Today that means OpenCode, Copilot, and Cursor IDE
-reconstructable artifact candidates. Claude Code and Codex remain active validation
-surfaces, but neither shipped configuration blocks every invalid artifact candidate
-before mutation.
-
-## Lifecycle notes
-
-| Runtime | Runtime reason for degraded or blocked capability |
-|---------|---------------------------------------------------|
-| OpenCode preload | The `event` hook observes `session.created`, but no supported adapter path injects text into model context. |
-| OpenCode compaction context | `experimental.session.compacting` appends bounded Agentera state from `agentera hej --format json`; the plugin does not read raw `.agentera` artifacts for compaction. |
-| OpenCode `apply_patch` hard gate | The adapter receives `patchText` without reconstructing full candidate content. It allows that path rather than guessing. |
-| Copilot sparse edits | Copilot `preToolUse` stdin may omit full content or unique old/new replacement evidence. The hook allows those payloads. |
-| Codex preload/bookmarks | `codex_hooks` supports lifecycle events, but Agentera ships only `apply_patch` PreToolUse/PostToolUse wiring for copied user hooks and optional plugin-bundled hooks. |
-| Codex artifact hard gate | The adapter parses patch headers for touched paths, but it does not reconstruct final candidate content for blocking validation. |
-| Codex plugin hook trust | Plugin-bundled hooks require `[features].plugin_hooks = true` and deliberate `/hooks` review; copied `~/.codex/hooks.json` remains the default reliable install path with generated `[hooks.state]` trust hashes. |
-| Cursor cloud agents | Cloud agents are unsupported in v1; repo hooks and managed agents target local IDE sessions only. |
-| Cursor CLI hook parity | `cursor-agent` print mode is eval-covered but hook/session env parity is degraded relative to IDE wiring. |
-| Cursor hard-gate release gate | Live preToolUse Write smoke passed 2026-05-24; release tagging and publication stay blocked pending broader release closeout. |
-
-## Subagent Dispatch
-
-| Runtime | Dispatch surface | Descriptor source | Tool Access | Verification surface |
-|---------|------------------|-------------------|-------------|----------------------|
-| Claude Code | Native Task/subagent surface | Host-managed; no Agentera descriptor files shipped for this phase | None (no descriptors) | RuntimeAdapter registry |
-| OpenCode | `@<capability>` descriptors under `~/.config/opencode/agents` | `.opencode/agents/*.md`, bootstrapped by `.opencode/plugins/agentera.js` | Per-agent `permission` frontmatter | `scripts/smoke_opencode_bootstrap.mjs`, `agentera validate descriptors` |
-| Copilot CLI | User-driven host action such as `/fleet` when available | Host-managed; no Agentera descriptor files shipped for this phase | N/A (no descriptors) | RuntimeAdapter registry |
-| Codex CLI | Native agent descriptors under `~/.codex/agents` or project `.codex/agents` with bounded `[agents]` settings | `skills/agentera/agents/*.toml`, installed by `scripts/setup_codex.py` and `agentera upgrade` | Global sandbox policy (no per-agent) | `agentera validate descriptors`, `tests/test_setup_codex.py`, `tests/test_upgrade_cli.py` |
-| Cursor IDE | Cursor agent picker / @-mention for managed capability descriptors | `.cursor/agents/*.md`, via local plugin or `agentera upgrade --runtime cursor` | Global full access (no per-agent) | `references/adapters/cursor.md`, `scripts/validate_lifecycle_adapters.py`, `tests/test_upgrade_cli.py` |
-| Cursor Agent CLI | Host-managed `cursor-agent -p` print mode | Workspace `.cursor/agents/*.md` when present; no separate CLI descriptor install | Global full access (no per-agent) | `scripts/eval_skills.py --runtime cursor-agent`, `tests/test_eval_skills.py` |
-
-Agentera v2 does not write legacy `[agents.<name>]` Codex config blocks. Capability dispatch must use runtime-native subagent descriptors or host Task surfaces, not unsupported `agentera <capability>` CLI commands.
-
-## Copilot install notes
-
-Recommended marketplace install:
+# Runtime feature parity
+
+Release-relevant behavior is governed by
+`runtime-lifecycle-authority.yaml` and `runtime-lifecycle-adapters.yaml`.
+Active runtime IDs are exactly `opencode`, `codex`, `cursor`, and `copilot`.
+
+`cursor-agent` is an inactive compatibility alias and Cursor CLI source-product
+name beneath the single `cursor` identity. It is never an active runtime ID.
+Claude Code is a retired migration and consent-gated historical-import source,
+not a supported runtime.
+
+## Lifecycle identity and support floor
+
+| Runtime | Required surface | Conditional surface | Canonical skill |
+| --- | --- | --- | --- |
+| OpenCode | host | — | `~/.agents/skills/agentera` |
+| Codex | CLI | — | `~/.agents/skills/agentera` |
+| Cursor | Agent CLI | IDE | `~/.agents/skills/agentera` |
+| GitHub Copilot | CLI | — | `~/.agents/skills/agentera` |
+
+The support floor requires the canonical skill, complete diagnosis, and
+resolved mandatory evidence. Unknown or missing mandatory evidence and denied
+trust block release. A known false installation or enablement state is
+diagnosed as degraded. An unobserved conditional Cursor IDE is
+`not_applicable` and does not block CLI support.
+
+`prime` projects a bounded summary from this lifecycle snapshot. `doctor`
+projects detailed evidence and exact actions from the same snapshot. The
+`status` projection and project-integration recommendation consume that same
+snapshot, so runtime identities, counts, blockers, and next actions do not
+drift between surfaces.
+
+## Common adapter contract
+
+Every active runtime reports the same eight categories:
+
+| Category | Meaning |
+| --- | --- |
+| skills | Canonical and additional skill discovery locations |
+| plugins | Agentera plugin package or host plugin state |
+| hooks | Session and tool lifecycle wiring |
+| agents | Runtime-native Agentera descriptors |
+| configuration | User or project configuration evidence |
+| enablement | Whether the host has enabled the integration |
+| trust | Observed trust state; never inferred or approved |
+| native actions | Exact user-owned host/package-manager steps |
+
+Each runtime/surface/category claim declares capability, evidence, and
+remediation. Unsupported or unverified host behavior cannot satisfy a mandatory
+support floor.
+
+## Host behavior
+
+| Runtime | Skill/package source | Hook and validation behavior | Agent behavior |
+| --- | --- | --- | --- |
+| OpenCode | Portable skill plus `.opencode/plugins/agentera.js` | Conditional hard gate for reconstructable write/edit candidates; sparse or unreconstructed patches remain advisory | Single Agentera descriptor in `.opencode/agents/agentera.md` |
+| Codex | `.codex-plugin/plugin.json`, shared skill, and marketplace entry | Plugin and copied-hook sources validate `apply_patch` paths before/after use; final patch content is not reconstructed | Capability TOML descriptors under `skills/agentera/agents/` |
+| Cursor | One identity spanning Agent CLI and optional IDE plugin | IDE hooks provide session context and conditional hard-gate validation for reconstructable Write/Edit candidates | One IDE Agentera descriptor; CLI uses the Cursor-owned binary surface |
+| GitHub Copilot | Root and repository plugin manifests | `sessionStart`, `sessionEnd`, `preToolUse`, and `postToolUse`; reconstructable candidates are denied before mutation | Host-managed dispatch; no Agentera-specific Copilot agent descriptor |
+
+The validated hard-gate claims retain their exact scope:
+
+- OpenCode: Conditional hard gate for reconstructable write and edit candidates. Sparse payloads and apply_patch patchText without reconstructed full content are allowed.
+- GitHub Copilot: Conditional hard gate via preToolUse. Malformed, sparse, or non-reconstructable toolArgs are allowed.
+- Cursor: Conditional hard gate for reconstructable Write and Edit candidates via preToolUse; verified after live preToolUse Write smoke (2026-05-24). Malformed, sparse, or non-reconstructable tool_input payloads are allowed.
+
+Agentera never upgrades a runtime binary, runs a native marketplace/package
+manager, authenticates, enables a plugin, or approves trust. Those operations
+are emitted as `action_required`.
+
+## Lifecycle repair
+
+On the v3 development channel, a dry-run without `--runtime` previews all
+active runtimes. Applying without a selector remains the existing app-only
+operation; runtime apply requires an explicit selector and `--yes`:
 
 ```bash
-copilot plugin marketplace add jgabor/agentera
-copilot plugin install <skill>@agentera
+agentera upgrade --dry-run --channel development
+agentera upgrade --runtime all --dry-run
+agentera upgrade --runtime all --yes
 ```
 
-Umbrella install:
+Preview is side-effect free. Apply is limited to declared Agentera-owned
+resources with matching ownership-journal evidence. Secure automatic
+publication currently requires Linux `/proc/self/fd`; other platforms receive
+the same plan as explicit actions.
 
-```bash
-copilot plugin install jgabor/agentera
-```
-
-The marketplace install path is verified working. Granular installs avoid
-umbrella discovery bug `github/copilot-cli#2390`.
-
-Granular installs provide core `SKILL.md` behavior. App-home tools such as
-doctor, installer, validators, and shared setup helpers require the managed
-Agentera app or a local clone with the shared `scripts/` directory.
+Outcomes are `applied`, `noop`, `failed`, `blocked_unowned`,
+`skipped_dependency`, and `action_required`. Independent operations continue
+after a local failure, and retries re-observe state so completed work becomes
+`noop`.
 
-Deprecated fallback: `copilot plugin install OWNER/REPO`, Git URLs, and local
-paths still work, but Copilot warns they are deprecated.
+## Corpus sources
 
-## Cursor install notes
+| Runtime identity | Source product | Default analytics |
+| --- | --- | --- |
+| Codex | Codex session JSONL | included |
+| OpenCode | OpenCode SQLite store | included |
+| Cursor | Cursor IDE JSONL | included |
+| Cursor | Cursor Agent CLI SQLite source (`cursor-agent`) | included as Cursor gap-fill |
+| GitHub Copilot | Copilot session SQLite store | included |
+| none | Claude Code JSONL | excluded; requires `--import-source claude` |
 
-**Local plugin (no Marketplace listing required)**
+Claude imports use `historical_import` provenance and `active_runtime: false`.
+They never add Claude to runtime inventories, readiness, or default analytics.
 
-```bash
-git clone https://github.com/jgabor/agentera.git ~/.cursor/plugins/local/agentera
-# or: ln -s /path/to/agentera ~/.cursor/plugins/local/agentera
-```
+## Package release surface
 
-Restart Cursor or run **Developer: Reload Window**. The plugin root must contain
-`.cursor-plugin/plugin.json`. Agentera is not published to the Cursor Marketplace
-yet.
+The npm bundle contains the shared skill and contract data plus every declared
+runtime source:
 
-The plugin loads skills, managed capability agents, and hooks. When you open a
-project that is not an Agentera install root, `sessionStart` exports
-`AGENTERA_HOME` from the plugin checkout (including a plugin-root fallback when
-env and project walk-up do not resolve a managed root).
+- OpenCode package, plugin, command, and agent files;
+- Codex plugin manifest, plugin hooks, copied-hook fallback, and capability agents;
+- Cursor plugin manifest, IDE hooks, and agent descriptor;
+- GitHub Copilot root/repository manifests and lifecycle hook files.
 
-**Portable skill plus project upgrade**
+`.claude-plugin/marketplace.json` is retired and must not be packaged.
 
-Install the bundled skill, then install managed project surfaces:
+## Validation boundary
 
-```bash
-npx skills add jgabor/agentera -g -a cursor --skill agentera -y
-uv run scripts/agentera upgrade --runtime cursor --dry-run
-uv run scripts/agentera upgrade --runtime cursor --yes
-uv run scripts/agentera doctor --runtime cursor
-```
-
-Use the plugin path for a user-global install. Use upgrade when you need
-project-committed `.cursor/hooks.json` and `.cursor/agents/` copies. Both paths can
-be combined.
-
-Repo-native dogfood in this repository uses committed `.cursor/hooks.json` and
-`.cursor/agents/*.md`. Other projects install managed surfaces with the upgrade
-commands above.
-
-Cloud agents are unsupported in v1. Conditional hard-gate validation for IDE
-reconstructable Write and Edit candidates is verified after live preToolUse Write
-smoke (2026-05-24); release tagging and publication remain blocked until explicitly
-approved.
-
-Eval coverage for automation uses:
-
-```bash
-uv run scripts/eval_skills.py --runtime cursor-agent --dry-run
-```
+`agentera check validate lifecycle-adapters` validates:
 
-## Source of truth
-
-Runtime adapter facts are owned by the RuntimeAdapter registry at
-`references/adapters/runtime-adapter-registry.yaml` and loaded through
-`scripts/runtime_adapter_registry.py`. This reference may describe registry
-claims, but changes to runtime identity, lifecycle events, artifact-validation
-support, subagent dispatch, config targets, diagnostics, or documentation claims must be validated
-against the registry rather than duplicated here as an independent table.
-
-App-home classification is not runtime-specific. `scripts/install_root.py` is
-the shared Module for `AGENTERA_HOME`, the normal user data root, managed app,
-out-of-date app, unknown directories, and diagnostic semantics. Package metadata
-registry work stays outside both the RuntimeAdapter registry and this shared
-classification Module.
-
-| Surface | Path |
-|---------|------|
-| Shared artifact validator | `hooks/validate_artifact.py` |
-| Claude Code hook registry | `hooks/hooks.json` |
-| OpenCode plugin | `.opencode/plugins/agentera.js` |
-| OpenCode agent descriptors | `.opencode/agents/*.md` |
-| Copilot pre-write hook | `.github/hooks/preToolUse.json` |
-| Codex copied user hook config | `~/.codex/hooks.json` generated from `hooks/codex-hooks.json` with a resolved validator command |
-| Codex plugin hook config | `hooks/codex-plugin-hooks.json` via `.codex-plugin/plugin.json` `hooks` |
-| Codex agent descriptors | `skills/agentera/agents/*.toml` |
-| Cursor hook registry | `.cursor/hooks.json` |
-| Cursor agent descriptors | `.cursor/agents/*.md` |
-| Cursor plugin manifest | `.cursor-plugin/plugin.json` |
-| RuntimeAdapter registry | `references/adapters/runtime-adapter-registry.yaml` |
-| RuntimeAdapter registry loader | `scripts/runtime_adapter_registry.py` |
-| Lifecycle metadata validator | `scripts/validate_lifecycle_adapters.py` |
+- lifecycle authority and exact four-runtime identity parity;
+- all eight categories and every declared runtime surface;
+- package-manifest coverage for all active runtimes;
+- npm-bundle coverage for every lifecycle source and runtime manifest;
+- 3.0.0 suite mirrors and the development package core;
+- runtime-specific hook and documentation claims;
+- absence of retired Claude package manifests.

package/bundle/references/adapters/runtime-lifecycle-adapters.yaml

@@ -0,0 +1,288 @@
+schema_version: agentera.runtimeLifecycleAdapters.v1
+status: active_contract
+decision: 92
+authority: references/adapters/runtime-lifecycle-authority.yaml
+operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
+categories:
+  - skills
+  - plugins
+  - hooks
+  - agents
+  - configuration
+  - enablement
+  - trust
+  - native_actions
+category_contract:
+  required_fields:
+    - capability
+    - evidence
+    - remediation
+  capabilities:
+    - repairable
+    - observable
+    - action_required
+    - unsupported
+    - unverified
+    - not_applicable
+  evidence_states:
+    - confirmed
+    - absent
+    - drifted
+    - shadowed
+    - denied
+    - unknown
+    - blocked_unowned
+    - unsupported
+    - not_applicable
+    - action_required
+  remediation_kinds:
+    - none
+    - repair
+    - action_required
+    - unavailable
+support_floor:
+  authority: references/adapters/runtime-lifecycle-authority.yaml#support_floor
+  required_category: skills
+  required_capability: repairable
+  unknown_or_unverified_required_detection_blocks: true
+  incomplete_required_diagnosis_blocks: true
+  unknown_or_missing_mandatory_evidence_blocks: true
+  denied_required_trust_blocks: true
+  known_false_presence_install_enable_is_diagnosed_degraded: true
+  not_applicable_only_for_unobserved_conditional_surface: true
+native_policy:
+  execution: forbidden
+  exact_action_required_only: true
+  install_update_enable_auth_trust_are_user_owned: true
+path_policy:
+  destination_templates_are_declarations: true
+  matching_ledger_required_for_existing_resources: true
+  equality_or_name_never_establishes_ownership: true
+  forbidden_destination_segments:
+    - cache
+    - caches
+    - cacheddata
+    - node_modules
+    - .npm
+    - .pnpm-store
+    - marketplace-cache
+known_caveats:
+  - Append-only ownership journal recovery accepts only a strict contiguous hash chain, ignores uniquely named non-authoritative publication temporaries, blocks malformed or disconnected final events, and re-observes every resource before retry.
+shared_resources:
+  - id: canonical_skill
+    category: skills
+    kind: symlink
+    source: "{source_root}/skills/agentera"
+    destination: "{home}/.agents/skills/agentera"
+    required: true
+managed_resources:
+  - id: opencode.plugin
+    runtime_id: opencode
+    surface_id: host
+    category: plugins
+    kind: file
+    source: "{source_root}/.opencode/plugins/agentera.js"
+    destination: "{opencode_config}/plugins/agentera.js"
+    required: false
+  - id: opencode.agent
+    runtime_id: opencode
+    surface_id: host
+    category: agents
+    kind: file
+    source: "{source_root}/.opencode/agents/agentera.md"
+    destination: "{opencode_config}/agents/agentera.md"
+    required: false
+  - id: codex.hooks
+    runtime_id: codex
+    surface_id: cli
+    category: hooks
+    kind: file
+    source: "{source_root}/hooks/codex-hooks.json"
+    destination: "{home}/.codex/hooks.json"
+    required: false
+  - id: codex.agents
+    runtime_id: codex
+    surface_id: cli
+    category: agents
+    kind: directory_files
+    source: "{source_root}/skills/agentera/agents"
+    destination: "{home}/.codex/agents"
+    extension: .toml
+    required: false
+  - id: cursor.plugin
+    runtime_id: cursor
+    surface_id: ide
+    category: plugins
+    kind: file
+    source: "{source_root}/.cursor-plugin/plugin.json"
+    destination: "{project}/.cursor-plugin/plugin.json"
+    required: false
+  - id: cursor.hooks
+    runtime_id: cursor
+    surface_id: ide
+    category: hooks
+    kind: file
+    source: "{source_root}/.cursor/hooks.json"
+    destination: "{project}/.cursor/hooks.json"
+    required: false
+  - id: cursor.agent
+    runtime_id: cursor
+    surface_id: ide
+    category: agents
+    kind: file
+    source: "{source_root}/.cursor/agents/agentera.md"
+    destination: "{project}/.cursor/agents/agentera.md"
+    required: false
+adapters:
+  - runtime_id: opencode
+    binaries:
+      host: [opencode]
+    resource_refs: [canonical_skill, opencode.plugin, opencode.agent]
+    skill_locations:
+      - path: "{project}/.opencode/skills/agentera"
+        scope: project_runtime
+      - path: "{project}/.agents/skills/agentera"
+        scope: project_shared
+      - path: "{home}/.agents/skills/agentera"
+        scope: personal_shared
+        canonical: true
+      - path: "{opencode_config}/skills/agentera"
+        scope: personal_runtime
+    categories:
+      skills:
+        host: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
+      plugins:
+        host: { capability: repairable, evidence: filesystem, remediation: shared_engine }
+      hooks:
+        host: { capability: observable, evidence: managed_resource:opencode.plugin, remediation: shared_engine:opencode.plugin }
+      agents:
+        host: { capability: repairable, evidence: filesystem, remediation: shared_engine }
+      configuration:
+        host: { capability: not_applicable, evidence: plugin_autodiscovery, remediation: none }
+      enablement:
+        host: { capability: observable, evidence: managed_resource:opencode.plugin, remediation: shared_engine:opencode.plugin }
+      trust:
+        host: { capability: unverified, evidence: external_observation, remediation: unavailable }
+      native_actions:
+        host: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
+    native_actions: []
+  - runtime_id: codex
+    binaries:
+      cli: [codex]
+    resource_refs: [canonical_skill, codex.hooks, codex.agents]
+    skill_locations:
+      - path: "{project}/.agents/skills/agentera"
+        scope: project_shared
+      - path: "{home}/.agents/skills/agentera"
+        scope: personal_shared
+        canonical: true
+    categories:
+      skills:
+        cli: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
+      plugins:
+        cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
+      hooks:
+        cli: { capability: repairable, evidence: filesystem, remediation: shared_engine }
+      agents:
+        cli: { capability: repairable, evidence: filesystem, remediation: shared_engine }
+      configuration:
+        cli: { capability: observable, evidence: "path:{home}/.codex/config.toml", remediation: action_required }
+      enablement:
+        cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
+      trust:
+        cli: { capability: observable, evidence: external_observation, remediation: action_required }
+      native_actions:
+        cli: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
+    native_actions: []
+  - runtime_id: cursor
+    binaries:
+      cli: [cursor-agent]
+      ide: [cursor]
+    resource_refs: [canonical_skill, cursor.plugin, cursor.hooks, cursor.agent]
+    skill_locations:
+      - path: "{project}/.agents/skills/agentera"
+        scope: project_shared
+        surfaces: [cli, ide]
+      - path: "{project}/.cursor/skills/agentera"
+        scope: project_runtime
+        surfaces: [cli, ide]
+      - path: "{home}/.agents/skills/agentera"
+        scope: personal_shared
+        surfaces: [cli, ide]
+        canonical: true
+      - path: "{home}/.cursor/skills/agentera"
+        scope: personal_runtime
+        surfaces: [cli, ide]
+    categories:
+      skills:
+        cli: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
+        ide: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: false }
+      plugins:
+        cli: { capability: not_applicable, evidence: no_cli_plugin_claim, remediation: none }
+        ide: { capability: repairable, evidence: filesystem, remediation: shared_engine }
+      hooks:
+        cli: { capability: unverified, evidence: no_verified_cli_hook_claim, remediation: unavailable }
+        ide: { capability: repairable, evidence: filesystem, remediation: shared_engine }
+      agents:
+        cli: { capability: unverified, evidence: no_verified_cli_agent_claim, remediation: unavailable }
+        ide: { capability: repairable, evidence: filesystem, remediation: shared_engine }
+      configuration:
+        cli: { capability: not_applicable, evidence: skill_autodiscovery, remediation: none }
+        ide: { capability: not_applicable, evidence: plugin_manifest, remediation: none }
+      enablement:
+        cli: { capability: observable, evidence: canonical_skill, remediation: shared_engine:canonical_skill }
+        ide: { capability: unverified, evidence: external_observation, remediation: unavailable }
+      trust:
+        cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
+        ide: { capability: observable, evidence: external_observation, remediation: action_required }
+      native_actions:
+        cli: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
+        ide: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
+    native_actions: []
+  - runtime_id: copilot
+    binaries:
+      cli: [copilot]
+    resource_refs: [canonical_skill]
+    skill_locations:
+      - path: "{project}/.github/skills/agentera"
+        scope: project_runtime
+      - path: "{project}/.agents/skills/agentera"
+        scope: project_shared
+      - path: "{home}/.copilot/skills/agentera"
+        scope: personal_runtime
+      - path: "{home}/.agents/skills/agentera"
+        scope: personal_shared
+        canonical: true
+    categories:
+      skills:
+        cli: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
+      plugins:
+        cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
+      hooks:
+        cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
+      agents:
+        cli: { capability: unsupported, evidence: no_verified_agent_surface, remediation: unavailable }
+      configuration:
+        cli: { capability: observable, evidence: env:AGENTERA_HOME, remediation: action_required }
+      enablement:
+        cli: { capability: observable, evidence: canonical_skill, remediation: shared_engine:canonical_skill }
+      trust:
+        cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
+      native_actions:
+        cli: { capability: action_required, evidence: verified_host_actions, remediation: action_required }
+    native_actions:
+      - id: copilot.skills.list
+        surface_id: cli
+        action_kind: slash_action
+        command: /skills list
+        instruction: Run `/skills list` in Copilot CLI to inspect discovered skills.
+      - id: copilot.skills.info
+        surface_id: cli
+        action_kind: slash_action
+        command: /skills info agentera
+        instruction: Run `/skills info agentera` in Copilot CLI to inspect the Agentera skill.
+      - id: copilot.skills.reload
+        surface_id: cli
+        action_kind: slash_action
+        command: /skills reload
+        instruction: Run `/skills reload` in Copilot CLI after an approved filesystem repair.