agentera 3.0.0-dev.7 → 3.0.0-dev.74

package/bundle/references/adapters/runtime-adapter-registry.yaml

@@ -1,554 +0,0 @@
-schema_version: agentera.runtimeAdapterRegistry.v1
-runtime_order:
-  - claude
-  - opencode
-  - copilot
-  - codex
-  - cursor
-  - cursor-agent
-records:
-  - identity:
-      runtime_id: claude
-      display_name: Claude Code
-      adapter_family: native-plugin
-      support_status: supported
-    host_detection:
-      binary_names:
-        - claude
-      host_config_locations:
-        - CLAUDE_PLUGIN_ROOT
-      availability_probe_label: runtime_binary
-    lifecycle_events:
-      supported_events:
-        - PreToolUse
-        - PostToolUse
-        - UserPromptSubmit
-        - SessionStart
-        - Stop
-        - SubagentStop
-      unsupported_events: []
-      event_status:
-        PreToolUse: native
-        PostToolUse: native
-        UserPromptSubmit: native
-        SessionStart: native
-        Stop: native
-        SubagentStop: native
-      limitations:
-        - Claude lifecycle behavior is validated through native hook files rather than lifecycle metadata.
-    artifact_validation:
-      validation_events:
-        - PreToolUse
-      hard_gate_claims:
-        - Native hook files can run artifact validation before tool writes.
-      payload_reconstruction_limitations: []
-    subagent_dispatch:
-      mechanism: Claude Code native subagent dispatch
-      setup_targets: []
-      descriptor_sources: []
-      invocation_pattern: Use the host Task/subagent surface with the selected Agentera capability context.
-      tool_configuration: none
-      limitations:
-        - Agentera does not install per-capability Claude descriptors in this package phase.
-    config_targets:
-      runtime_config_files: []
-      hook_targets:
-        - .claude-plugin/marketplace.json
-      plugin_targets:
-        - skills/*/.claude-plugin/plugin.json
-      environment_exports:
-        - CLAUDE_PLUGIN_ROOT
-      write_safety_labels:
-        - Claude Code plugin installs expose the app home without local config writes
-    diagnostics:
-      check_names:
-        - CLAUDE_PLUGIN_ROOT
-      status_labels:
-        - pass
-        - warn
-        - fail
-        - skip
-      gap_labels:
-        - runtime_config
-        - user_environment
-      primary_messages:
-        - runtime can reach shared Agentera helper scripts
-        - Claude Code plugin root is not present in this process environment
-    documentation_claims:
-      reference_paths:
-        - references/adapters/runtime-feature-parity.md
-      parity_claims:
-        - Claude Code uses native plugin and hook surfaces.
-      install_claims:
-        - Claude Code plugin installs expose the app home without local config writes.
-      known_drifts:
-        - Claude lifecycle behavior is validated through native hook files, not lifecycle metadata.
-  - identity:
-      runtime_id: opencode
-      display_name: OpenCode
-      adapter_family: javascript-plugin
-      support_status: supported
-    host_detection:
-      binary_names:
-        - opencode
-      host_config_locations:
-        - OPENCODE_CONFIG_DIR
-        - AGENTERA_HOME
-      availability_probe_label: runtime_binary
-    lifecycle_events:
-      supported_events:
-        - shell.env
-        - chat.message
-        - tool.execute.before
-        - tool.execute.after
-        - experimental.session.compacting
-        - session.created
-        - session.idle
-      unsupported_events: []
-      event_status:
-        shell.env: supported
-        chat.message: supported
-        tool.execute.before: supported
-        tool.execute.after: supported
-        experimental.session.compacting: supported
-        session.created: supported_via_event
-        session.idle: supported_via_event
-      limitations:
-        - OpenCode session preload observes session.created but has no verified context injection path.
-        - OpenCode docs omit chat.message, but the exported plugin Hooks interface defines it.
-        - OpenCode compaction context is bounded to CLI-first Agentera summaries.
-    artifact_validation:
-      validation_events:
-        - tool.execute.before
-      hard_gate_claims:
-        - Conditional hard gate for reconstructable write and edit candidates.
-      payload_reconstruction_limitations:
-        - Sparse payloads and apply_patch patchText without reconstructed full content are allowed.
-    subagent_dispatch:
-      mechanism: OpenCode .opencode/agents single primary agent (D73)
-      setup_targets:
-        - ~/.config/opencode/agents
-      descriptor_sources:
-        - .opencode/agents/agentera.md
-      invocation_pattern: Use @agentera for the single Agentera primary agent; routing via skill, dispatch to general subagent.
-      tool_configuration: per_agent_permission
-      limitations:
-        - OpenCode descriptor bootstrap is file-based and preserves user-owned descriptor collisions.
-    config_targets:
-      runtime_config_files:
-        - ~/.config/opencode/plugins/agentera.js
-      hook_targets: []
-      plugin_targets:
-        - .opencode/plugins/agentera.js
-      environment_exports:
-        - AGENTERA_HOME
-      write_safety_labels:
-        - copy-plugin
-        - copy-agent
-    diagnostics:
-      check_names:
-        - plugin_file
-        - AGENTERA_HOME
-        - opencode_managed_commands
-        - opencode_skill_paths
-        - bundled_support_references
-        - profile_dir_deprecated
-        - profile_dir_schema_literal
-      status_labels:
-        - pass
-        - warn
-        - fail
-        - skip
-      gap_labels:
-        - runtime_config
-        - user_environment
-        - command_drift
-        - skill_path_drift
-        - validation_drift
-      primary_messages:
-        - OpenCode plugin file is present
-        - OpenCode plugin file is not installed at the native plugin path
-        - runtime can reach shared Agentera helper scripts
-        - OpenCode cannot see AGENTERA_HOME or a documented default Agentera app home
-        - OpenCode managed Agentera commands are current
-        - OpenCode managed Agentera commands are missing or stale
-        - OpenCode Agentera skill paths resolve to SKILL.md
-        - OpenCode Agentera skill paths are missing or broken
-        - bundled support references validate separately from installer status
-        - bundled reference validation mismatch found despite installer status
-        - profile dir env var is current
-        - v2 env var PROFILERA_PROFILE_DIR detected; run `agentera upgrade` to migrate to AGENTERA_PROFILE_DIR
-        - OpenCode plugin profile-dir schema is current
-        - OpenCode plugin source uses unmigrated profile-dir schema literal (PROFILERA_PROFILE_DIR without AGENTERA_PROFILE_DIR); run `agentera upgrade`
-    documentation_claims:
-      reference_paths:
-        - references/adapters/runtime-feature-parity.md
-        - references/adapters/opencode.md
-      parity_claims:
-        - Blocks invalid reconstructable artifact candidates.
-        - Routes exact bare text /agentera through chat.message to the bundled Agentera dashboard path.
-      install_claims:
-        - OpenCode plugin is copied to the native plugin path.
-      known_drifts:
-        - OpenCode session preload observes session.created but has no verified context injection path.
-        - OpenCode docs omit chat.message even though the plugin source Hooks interface exposes it.
-  - identity:
-      runtime_id: copilot
-      display_name: Copilot CLI
-      adapter_family: portable-plugin
-      support_status: supported
-    host_detection:
-      binary_names:
-        - copilot
-      host_config_locations:
-        - AGENTERA_HOME
-        - ~/.bashrc
-        - ~/.zshrc
-        - ~/.config/fish/config.fish
-      availability_probe_label: runtime_binary
-    lifecycle_events:
-      supported_events:
-        - sessionStart
-        - sessionEnd
-        - userPromptSubmitted
-        - preToolUse
-        - postToolUse
-        - errorOccurred
-      unsupported_events: []
-      event_status:
-        sessionStart: supported
-        sessionEnd: supported
-        userPromptSubmitted: supported
-        preToolUse: supported
-        postToolUse: supported
-        errorOccurred: supported
-      limitations:
-        - Profile exposes bounded corpus metadata limits with missing source families.
-    artifact_validation:
-      validation_events:
-        - preToolUse
-      hard_gate_claims:
-        - Conditional hard gate via preToolUse.
-      payload_reconstruction_limitations:
-        - Malformed, sparse, or non-reconstructable toolArgs are allowed.
-    subagent_dispatch:
-      mechanism: Copilot CLI host-managed dispatch
-      setup_targets: []
-      descriptor_sources: []
-      invocation_pattern: Use the host-native agent selection surface when available.
-      tool_configuration: none
-      limitations:
-        - Agentera does not install per-capability Copilot descriptors in this package phase.
-    config_targets:
-      runtime_config_files: []
-      hook_targets:
-        - .github/hooks
-      plugin_targets:
-        - plugin.json
-      environment_exports:
-        - AGENTERA_HOME
-      write_safety_labels:
-        - configure
-    diagnostics:
-      check_names:
-        - AGENTERA_HOME
-      status_labels:
-        - pass
-        - warn
-        - fail
-        - skip
-      gap_labels:
-        - runtime_config
-        - user_environment
-      primary_messages:
-        - runtime can reach shared Agentera helper scripts
-        - Copilot helper access is not configured in the environment or known shell rc files
-        - Copilot rc file is configured; restart the shell to load AGENTERA_HOME
-    documentation_claims:
-      reference_paths:
-        - references/adapters/runtime-feature-parity.md
-      parity_claims:
-        - Copilot supports lifecycle hook JSON files under .github/hooks.
-      install_claims:
-        - Copilot marketplace install path is verified working.
-      known_drifts:
-        - Upgrade package phase currently has no Copilot package command item.
-        - Upgrade runtime configure is noop; shell rc paths in host_detection are doctor diagnostic probes only.
-  - identity:
-      runtime_id: codex
-      display_name: Codex CLI
-      adapter_family: portable-plugin
-      support_status: degraded
-    host_detection:
-      binary_names:
-        - codex
-      host_config_locations:
-        - ~/.codex/config.toml
-      availability_probe_label: runtime_binary
-    lifecycle_events:
-      supported_events:
-        - SessionStart
-        - Stop
-        - UserPromptSubmit
-        - PreToolUse
-        - PostToolUse
-        - PermissionRequest
-      unsupported_events:
-        - SubagentStop
-        - PreCompact
-        - Notification
-      event_status:
-        SessionStart: beta
-        Stop: beta
-        UserPromptSubmit: beta
-        PreToolUse: beta
-        PostToolUse: beta
-        PermissionRequest: beta
-        SubagentStop: unsupported
-      limitations:
-        - codex_hooks status is beta and shipped Agentera wiring intercepts apply_patch validation only; see openai/codex#18391.
-    artifact_validation:
-      validation_events:
-        - PreToolUse
-      hard_gate_claims:
-        - Codex can route pre-tool validation through codex_hooks when configured.
-      payload_reconstruction_limitations:
-        - Shipped config wires apply_patch validation only.
-    subagent_dispatch:
-      mechanism: Codex ~/.codex/agents TOML descriptors
-      setup_targets:
-        - ~/.codex/agents
-      descriptor_sources:
-        - skills/agentera/agents/*.toml
-      invocation_pattern: Use the configured capability agent name through Codex-native subagent dispatch.
-      tool_configuration: global_sandbox_policy
-      limitations:
-        - Codex hook wiring remains limited to apply_patch validation; descriptor dispatch is separate runtime state.
-    config_targets:
-      runtime_config_files:
-        - ~/.codex/config.toml
-      hook_targets:
-        - ~/.codex/hooks.json
-      plugin_targets:
-        - .codex-plugin/plugin.json
-        - .agents/plugins/marketplace.json
-      environment_exports:
-        - AGENTERA_HOME
-      write_safety_labels:
-        - configure
-        - copy-hooks
-        - copy-agent
-    diagnostics:
-      check_names:
-        - config.AGENTERA_HOME
-      status_labels:
-        - pass
-        - warn
-        - fail
-        - skip
-      gap_labels:
-        - runtime_config
-        - user_environment
-      primary_messages:
-        - runtime can reach shared Agentera helper scripts
-        - Codex config cannot provide helper-script access
-    documentation_claims:
-      reference_paths:
-        - references/adapters/runtime-feature-parity.md
-      parity_claims:
-        - Codex supports codex_hooks events but shipped config wires only apply_patch validation.
-      install_claims:
-        - Codex config and hook files are planned as runtime updates.
-      known_drifts:
-        - Codex supports hook events but shipped config wires only apply_patch validation.
-  - identity:
-      runtime_id: cursor
-      display_name: Cursor IDE
-      adapter_family: native-plugin
-      support_status: supported
-    host_detection:
-      binary_names:
-        - cursor
-      host_config_locations:
-        - AGENTERA_HOME
-        - .cursor/hooks.json
-      availability_probe_label: runtime_binary
-    lifecycle_events:
-      supported_events:
-        - sessionStart
-        - sessionEnd
-        - preToolUse
-        - postToolUse
-        - subagentStart
-        - subagentStop
-        - beforeSubmitPrompt
-        - preCompact
-        - stop
-      unsupported_events:
-        - beforeShellExecution
-        - afterShellExecution
-        - beforeMCPExecution
-        - afterMCPExecution
-        - beforeReadFile
-        - afterFileEdit
-      event_status:
-        sessionStart: supported
-        sessionEnd: supported
-        preToolUse: supported
-        postToolUse: supported
-        subagentStart: supported
-        subagentStop: supported
-        beforeSubmitPrompt: supported
-        preCompact: supported
-        stop: supported
-      limitations:
-        - Cloud agents are unsupported in v1; repo hooks and managed agents target local IDE sessions only.
-        - Bare text /agentera routing is metadata-only; sessionStart injects context but does not rewrite prompts.
-    artifact_validation:
-      validation_events:
-        - preToolUse
-      hard_gate_claims:
-        - Conditional hard gate for reconstructable Write and Edit candidates via preToolUse; verified after live preToolUse Write smoke (2026-05-24).
-      payload_reconstruction_limitations:
-        - Malformed, sparse, or non-reconstructable tool_input payloads are allowed.
-    subagent_dispatch:
-      mechanism: Cursor .cursor/agents single agent descriptor (D73)
-      setup_targets:
-        - .cursor/agents
-      descriptor_sources:
-        - .cursor/agents/agentera.md
-      invocation_pattern: Use the Cursor agent picker or @-mention the single Agentera agent; routing via skill, dispatch to general subagent.
-      tool_configuration: global_full_access
-      limitations:
-        - Cloud agent sessions do not load project hooks or managed agents in v1.
-    config_targets:
-      runtime_config_files: []
-      hook_targets:
-        - .cursor/hooks.json
-      plugin_targets:
-        - .cursor-plugin/plugin.json
-      environment_exports:
-        - AGENTERA_HOME
-      write_safety_labels:
-        - copy-hooks
-        - copy-agent
-        - copy-plugin
-    diagnostics:
-      check_names:
-        - AGENTERA_HOME
-        - cursor_hooks
-        - cursor_managed_agents
-      status_labels:
-        - pass
-        - warn
-        - fail
-        - skip
-      gap_labels:
-        - runtime_config
-        - user_environment
-        - hook_drift
-        - agent_drift
-      primary_messages:
-        - runtime can reach shared Agentera helper scripts
-        - Cursor hooks.json is present and references Agentera helpers
-        - Cursor hooks.json is missing or stale
-        - Cursor managed capability agents are current
-        - Cursor managed capability agents are missing or stale
-    documentation_claims:
-      reference_paths:
-        - references/adapters/runtime-feature-parity.md
-        - references/adapters/cursor.md
-      parity_claims:
-        - Cursor sessionStart exports AGENTERA_HOME and injects bounded session context.
-        - Cursor preToolUse denies invalid reconstructable artifact candidates; live preToolUse Write smoke passed 2026-05-24.
-      install_claims:
-        - Repo-native .cursor/ surfaces ship in this repository; upgrade installs managed hooks and agents elsewhere.
-      known_drifts:
-        - Release tagging and marketplace publication remain blocked pending broader release closeout despite passed live preToolUse Write smoke.
-        - Cloud agents are unsupported in v1.
-  - identity:
-      runtime_id: cursor-agent
-      display_name: Cursor Agent CLI
-      adapter_family: portable-cli
-      support_status: degraded
-    host_detection:
-      binary_names:
-        - cursor-agent
-        - agent
-      host_config_locations:
-        - AGENTERA_HOME
-        - ~/.bashrc
-        - ~/.zshrc
-        - ~/.config/fish/config.fish
-      availability_probe_label: runtime_binary
-    lifecycle_events:
-      supported_events:
-        - sessionStart
-        - sessionEnd
-        - preToolUse
-        - postToolUse
-      unsupported_events:
-        - subagentStart
-        - subagentStop
-        - beforeSubmitPrompt
-        - preCompact
-        - stop
-      event_status:
-        sessionStart: degraded
-        sessionEnd: degraded
-        preToolUse: degraded
-        postToolUse: degraded
-      limitations:
-        - CLI sessions may not inherit IDE sessionStart env; persistent shell configuration is a fallback only when shell-tool smoke fails.
-        - Non-interactive print mode may hang after completion in some host builds; eval and smoke harnesses use bounded timeouts.
-        - Cloud agents are unsupported in v1.
-    artifact_validation:
-      validation_events:
-        - preToolUse
-      hard_gate_claims:
-        - CLI hook parity is degraded relative to IDE; hard-gate claims follow IDE smoke evidence only.
-      payload_reconstruction_limitations:
-        - CLI may omit hook wiring entirely when launched outside a Cursor workspace with project hooks.
-    subagent_dispatch:
-      mechanism: Cursor Agent CLI host-managed dispatch
-      setup_targets: []
-      descriptor_sources: []
-      invocation_pattern: Use cursor-agent with explicit capability context; managed .cursor/agents descriptors apply only when the workspace is loaded.
-      tool_configuration: global_full_access
-      limitations:
-        - Agentera does not install per-capability cursor-agent descriptors separately from IDE managed agents.
-    config_targets:
-      runtime_config_files: []
-      hook_targets: []
-      plugin_targets: []
-      environment_exports:
-        - AGENTERA_HOME
-      write_safety_labels:
-        - configure
-    diagnostics:
-      check_names:
-        - AGENTERA_HOME
-        - cursor-agent
-      status_labels:
-        - pass
-        - warn
-        - fail
-        - skip
-      gap_labels:
-        - runtime_config
-        - user_environment
-      primary_messages:
-        - runtime can reach shared Agentera helper scripts
-        - cursor-agent binary is not on PATH
-        - cursor-agent helper access depends on AGENTERA_HOME or shell rc configuration
-    documentation_claims:
-      reference_paths:
-        - references/adapters/runtime-feature-parity.md
-        - references/adapters/cursor.md
-      parity_claims:
-        - cursor-agent supports eval_skills --runtime cursor-agent print-mode dispatch.
-      install_claims:
-        - cursor-agent inherits IDE hook wiring only when run inside a workspace with installed Cursor surfaces.
-      known_drifts:
-        - CLI hook and session env parity is degraded relative to Cursor IDE.
-        - Bare text /agentera routing is metadata-only like Claude, Copilot, and Codex.