agentera 3.0.0-dev.25 → 3.0.0-dev.26

package/bundle/references/adapters/runtime-adapter-interface-model.yaml

@@ -1,200 +0,0 @@
-interface: RuntimeAdapter
-status: design_contract
-purpose: >-
-  Define the runtime-owned facts that a later registry Module may expose without
-  absorbing package metadata, app-home classification, or caller behavior.
-record:
-  required_groups:
-    - identity
-    - host_detection
-    - lifecycle_events
-    - artifact_validation
-    - subagent_dispatch
-    - config_targets
-    - diagnostics
-    - documentation_claims
-  groups:
-    identity:
-      type: object
-      owns:
-        - runtime_id
-        - display_name
-        - adapter_family
-        - support_status
-      required_fields:
-        runtime_id: string
-        display_name: string
-        adapter_family: string
-        support_status: enum
-    host_detection:
-      type: object
-      owns:
-        - binary_names
-        - host_config_locations
-        - availability_probe_label
-      required_fields:
-        binary_names: list[string]
-        host_config_locations: list[string]
-        availability_probe_label: string
-    lifecycle_events:
-      type: object
-      owns:
-        - supported_events
-        - unsupported_events
-        - event_status
-        - limitations
-      required_fields:
-        supported_events: list[string]
-        unsupported_events: list[string]
-        event_status: map[string,string]
-        limitations: list[string]
-    artifact_validation:
-      type: object
-      owns:
-        - validation_events
-        - hard_gate_claims
-        - payload_reconstruction_limitations
-      required_fields:
-        validation_events: list[string]
-        hard_gate_claims: list[string]
-        payload_reconstruction_limitations: list[string]
-    subagent_dispatch:
-      type: object
-      owns:
-        - mechanism
-        - setup_targets
-        - descriptor_sources
-        - invocation_pattern
-        - limitations
-        - tool_configuration
-      required_fields:
-        mechanism: string
-        setup_targets: list[string]
-        descriptor_sources: list[string]
-        invocation_pattern: string
-        limitations: list[string]
-    config_targets:
-      type: object
-      owns:
-        - runtime_config_files
-        - hook_targets
-        - plugin_targets
-        - environment_exports
-        - write_safety_labels
-      required_fields:
-        runtime_config_files: list[string]
-        hook_targets: list[string]
-        plugin_targets: list[string]
-        environment_exports: list[string]
-        write_safety_labels: list[string]
-    diagnostics:
-      type: object
-      owns:
-        - check_names
-        - status_labels
-        - gap_labels
-        - primary_messages
-      required_fields:
-        check_names: list[string]
-        status_labels: list[string]
-        gap_labels: list[string]
-        primary_messages: list[string]
-    documentation_claims:
-      type: object
-      owns:
-        - reference_paths
-        - parity_claims
-        - install_claims
-        - known_drifts
-      required_fields:
-        reference_paths: list[string]
-        parity_claims: list[string]
-        install_claims: list[string]
-        known_drifts: list[string]
-ownership:
-  runtime_adapter_owns:
-    - runtime identity and display labels
-    - host detection facts used by runtime-facing consumers
-    - lifecycle event support and limitations
-    - artifact validation support claims
-    - runtime-native subagent dispatch descriptor and invocation facts
-    - runtime config, hook, plugin, and environment target paths
-    - diagnostic check names, statuses, gaps, and messages
-        - adapter documentation parity and known-mismatch claims
-  package_metadata_out_of_scope:
-    owner: package_manifest_registry
-    deferred_todo: arch-package-manifest-registry
-    facts:
-      - version_authority
-      - package_manifest_schemas
-      - shared_package_paths
-      - release_metadata
-  install_root_out_of_scope:
-    owner: scripts/install_root.py
-    facts:
-      - AGENTERA_HOME precedence
-      - default app home
-      - managed classification
-      - stale classification
-      - unmanaged classification
-      - app-home diagnostics
-consumer_permissions:
-  lifecycle_validation:
-    allowed_groups:
-      - identity
-      - lifecycle_events
-      - artifact_validation
-      - subagent_dispatch
-      - documentation_claims
-    forbidden_ownership:
-      - package_metadata_out_of_scope
-      - install_root_out_of_scope
-  doctor:
-    allowed_groups:
-      - identity
-      - host_detection
-      - config_targets
-      - diagnostics
-      - documentation_claims
-    forbidden_ownership:
-      - package_metadata_out_of_scope
-      - install_root_out_of_scope
-  upgrade:
-    allowed_groups:
-      - identity
-      - host_detection
-      - subagent_dispatch
-      - config_targets
-      - diagnostics
-    forbidden_ownership:
-      - package_metadata_out_of_scope
-      - install_root_out_of_scope
-  docs:
-    allowed_groups:
-      - identity
-      - lifecycle_events
-      - artifact_validation
-      - subagent_dispatch
-      - config_targets
-      - diagnostics
-      - documentation_claims
-    forbidden_ownership:
-      - package_metadata_out_of_scope
-      - install_root_out_of_scope
-  tests:
-    allowed_groups:
-      - identity
-      - host_detection
-      - lifecycle_events
-      - artifact_validation
-      - subagent_dispatch
-      - config_targets
-      - diagnostics
-      - documentation_claims
-    forbidden_ownership:
-      - package_metadata_out_of_scope
-      - install_root_out_of_scope
-non_goals:
-  - Do not introduce an executable RuntimeAdapter registry Module in this task.
-  - Do not migrate lifecycle validation, doctor, upgrade, docs, or runtime tests to consume a registry in this task.
-  - Do not change app-home classification, package metadata validation, artifact write validation, or live runtime behavior.

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

@@ -1,387 +0,0 @@
-schema_version: agentera.runtimeAdapterRegistry.v1
-lifecycle_authority: references/adapters/runtime-lifecycle-authority.yaml
-adapter_record_order:
-  - opencode
-  - copilot
-  - codex
-  - cursor
-records:
-  - 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
-        - tool.execute.before
-        - tool.execute.after
-        - experimental.session.compacting
-        - session.created
-        - session.idle
-      unsupported_events: []
-      event_status:
-        shell.env: 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 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.
-      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.
-  - identity:
-      runtime_id: copilot
-      display_name: GitHub Copilot
-      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
-      adapter_family: portable-plugin
-      support_status: supported
-    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
-      adapter_family: native-plugin
-      support_status: supported
-    host_detection:
-      binary_names:
-        - cursor-agent
-        - 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.