agentera 3.0.0-dev.14 → 3.0.0-dev.16

package/bundle/references/adapters/opencode.md

@@ -62,7 +62,8 @@ Each Agentera skill entry file contains YAML frontmatter with `name` and `descri
 
 **Skill loading**: OpenCode loads skills on-demand via a native `skill` tool. Agents see available skills listed in the tool description and load full content by calling `skill({ name: "agentera" })`. Agentera works unmodified: it is loaded into the agent's context when invoked.
 
-**Gap**: None. OpenCode's skill discovery is more flexible than Claude Code's (supports `.opencode/`, `.claude/`, and `.agents/` paths). Agentera skills install cleanly.
+**Gap**: None. OpenCode skill discovery supports `.opencode/`, `.claude/`
+compatibility, and `.agents/` paths. Agentera skills install cleanly.
 
 ### Artifact resolution (Required)
 
@@ -133,8 +134,8 @@ Read PROFILE.md from the runtime-provided profile path (Section 21). In OpenCode
 **Concrete mapping for build Step 5 dispatch**:
 
 ```
-# Claude Code (reference)
-Spawn a Sonnet implementation agent in a worktree (isolation: "worktree")
+# Runtime-neutral requirement
+Spawn an implementation agent in an isolated worktree
 
 # OpenCode Strategy A
 Invoke the Agentera agent (@agentera) with the implementation plan
@@ -167,7 +168,8 @@ opencode run "Explain closures in JavaScript"
 opencode run --format json "Explain closures in JavaScript"
 ```
 
-The `--format json` flag produces a raw JSON event stream, comparable to `claude -p --output-format json`. Each event is a separate JSON object representing a message part, tool call, or status update.
+The `--format json` flag produces a raw JSON event stream. Each event is a
+separate JSON object representing a message part, tool call, or status update.
 
 For long-running sessions, OpenCode's server mode provides an HTTP API with the same structured output:
 
@@ -176,15 +178,8 @@ opencode serve --port 4096
 # Then POST to the API with session creation and message sending
 ```
 
-**Adapter approach**: Map `claude -p --output-format json` to `opencode run --format json`:
-
-| Claude Code | OpenCode |
-|-------------|----------|
-| `claude -p "prompt"` | `opencode run "prompt"` |
-| `claude -p --output-format json` | `opencode run --format json "prompt"` |
-| `claude -p --skill build` | `opencode run "prompt"` (skill loaded via discovery) |
-
-The agentera eval runner (`scripts/eval_skills.py`) would need an OpenCode dispatch mode that calls `opencode run --format json` instead of `claude -p --output-format json`. The dispatch wrapper:
+**Adapter approach**: The eval runner invokes `opencode run --format json`
+directly and parses OpenCode's event schema. The dispatch wrapper:
 
 ```python
 def dispatch_opencode(skill_name: str, prompt: str) -> dict:
@@ -195,7 +190,9 @@ def dispatch_opencode(skill_name: str, prompt: str) -> dict:
     return {"output": result.stdout, "exit_code": result.returncode}
 ```
 
-**Gap**: Minimal. `opencode run --format json` provides structured JSON events directly comparable to `claude -p --output-format json`. The eval runner adapter parses the JSON event stream using the same pattern as the Claude Code adapter, though the event schema differs and requires a separate parser module. For smoke tests (the eval runner's primary use case), text output with exit-code checking is also sufficient.
+**Gap**: Minimal. `opencode run --format json` provides structured JSON events.
+The eval runner uses a dedicated OpenCode parser. For smoke tests, text output
+with exit-code checking is also sufficient.
 
 ### Hook lifecycle (Optional but recommended)
 
@@ -276,9 +273,11 @@ This keeps the plugin thin while matching the packaged Python script contract.
 
 Profilera mines five canonical record types from host session data. This section maps each record type to OpenCode's data sources.
 
-### memory_entry (Claude Code runtime extension)
+### memory_entry (retired historical-import extension)
 
-**Agentera contract**: This record type is a Claude Code runtime extension, not part of the portable corpus. Claude Code's memory files are emitted as instruction_document records with `doc_type: "claude_memory"`.
+**Agentera contract**: This retired-source record type is not part of the
+portable active corpus. It may appear only in explicitly consented historical
+imports and remains excluded from default analytics.
 
 **OpenCode source**: OpenCode does not have a built-in memory system. The memory_entry extension does not apply.
 
@@ -315,7 +314,7 @@ Profilera mines five canonical record types from host session data. This section
 }
 ```
 
-**Gap**: None. OpenCode has richer instruction document support than Claude Code (remote URLs, glob patterns, explicit config).
+**Gap**: None. OpenCode supports remote URLs, glob patterns, and explicit config.
 
 ### history_prompt
 
@@ -336,7 +335,7 @@ The SDK exposes message history with timestamps, project context, and session me
 1. Enumerate sessions via `opencode session list --format json`
 2. Export each session via `opencode export [sessionID]`
 3. Filter for user-originated messages from the export JSON
-4. Apply decision-pattern regex (same patterns profile uses for Claude Code history) to classify prompts as `"decision"`, `"correction"`, or `"question"`
+4. Apply the shared decision-pattern classifier to label prompts as `"decision"`, `"correction"`, or `"question"`
 5. Produce history_prompt records with session and project metadata
 
 ```python
@@ -400,13 +399,13 @@ The SDK approach remains preferable for programmatic integration (e.g., as an Op
 
 **OpenCode source**: OpenCode projects are standard filesystem directories. Config files are accessible via direct file reads.
 
-**Adapter extraction**: Identical to Claude Code extraction. Scan the project root for known config types:
+**Adapter extraction**: Scan the project root for known config types:
 
 - `package.json`, `go.mod`, `Cargo.toml`, `pyproject.toml`
 - `.golangci.yml`, `tsconfig.json`, `ruff.toml`
 - `Makefile`, `magefile.go`, `justfile`, `taskfile.yaml`
 
-No runtime-specific adaptation needed. The adapter uses the same config type list and extraction logic as the Claude Code adapter.
+No runtime-specific adaptation is needed; the config scan is runtime-agnostic.
 
 ```python
 {
@@ -436,7 +435,7 @@ Summary of which corpus families the OpenCode adapter can produce:
 | Crystallized decisions | instruction_document | Yes | AGENTS.md files (global and project), instructions config |
 | Decision history | history_prompt | Yes (CLI) | `opencode session list --format json` enumerates sessions; `opencode export [sessionID]` provides full message JSON for prompt extraction |
 | Conversation exchanges | conversation_turn | Yes (CLI) | `opencode export [sessionID]` provides full session JSON with paired user-assistant turns |
-| Config patterns | project_config_signal | Yes | Direct filesystem scan, identical to Claude Code |
+| Config patterns | project_config_signal | Yes | Direct filesystem scan |
 
 **Initial port profile mode**: Full. All four source families are available via included OpenCode functionality. Crystallized decisions come from AGENTS.md files and instructions config. Decision history and conversation exchanges come from `opencode export` CLI output. Config patterns come from direct filesystem scan.
 
@@ -511,7 +510,7 @@ OpenCode repair is ownership-gated. Managed slash commands include `agentera_man
 | Gap | Impact | Mitigation |
 |-----|--------|------------|
 | Sub-agent dispatch lacks built-in worktree isolation | build/orchestrate run in same working tree | Strategy A (Task tool) for initial port; manual `git worktree` commands for full isolation |
-| `opencode run --format json` event schema differs from `claude -p --output-format json` | Eval runner needs a separate JSON event parser | Implement an OpenCode-specific parser module in eval_skills.py; event stream structure is straightforward |
+| `opencode run --format json` uses an OpenCode-specific event schema | Eval runner needs a dedicated parser | Use the OpenCode parser module in eval_skills.py; event stream structure is straightforward |
 | Session history requires JSON event schema mapping | history_prompt and conversation_turn need export parser | `opencode export [sessionID]` provides full session JSON; adapter parses the export output |
 | Python scripts require Python runtime | Hook plugin calls Python via shell | Python is already a prerequisite for agentera scripts |
 
@@ -523,7 +522,7 @@ To verify the adapter is sufficient, check each acceptance criterion from PLAN.m
 
 1. **Each of the six host capabilities is mapped**: Yes. Skill discovery, artifact resolution, and profile path have direct OpenCode equivalents with no gaps. Sub-agent dispatch maps to the Task tool (with manual git worktree as an alternative). Eval mechanism maps to `opencode run --format json`. Hook lifecycle maps to the plugin event system.
 
-2. **Session Corpus Contract is mapped per record type**: Yes. All four portable record types are mapped. instruction_document and project_config_signal have immediate extraction paths. history_prompt and conversation_turn are extractable via `opencode export` CLI output. The memory_entry Claude Code extension does not apply to OpenCode.
+2. **Session Corpus Contract is mapped per record type**: Yes. All four portable record types are mapped. instruction_document and project_config_signal have immediate extraction paths. history_prompt and conversation_turn are extractable via `opencode export` CLI output. The retired historical-import extension does not apply to OpenCode.
 
 3. **A developer can implement OpenCode support without reading skill entry file source**: Yes. This document specifies the adapter mapping, installation steps, extraction logic, and remaining gaps independently.
 

package/bundle/references/adapters/package-manifest-interface-model.yaml

@@ -5,7 +5,7 @@ intent: >
   Define the package and release-surface access Interface before introducing an
   executable registry Module. This model records ownership boundaries and the
   validation contract for future PackageManifest records. The executable registry
-  at references/adapters/package-registry.yaml and its loader scripts/package_registry.py
+  at references/adapters/package-registry.yaml and its TypeScript PackageRegistry loader
   now implement this interface; this model remains the authoritative design contract.
 record:
   required_groups:
@@ -115,7 +115,7 @@ ownership:
       explicit future ADR changes persisted authority.
     future_authority_change_requires: explicit ADR
   install_root_delegated:
-    owner: scripts/install_root.py
+    owner: packages/cli/src/state/installRoot.ts
     forbidden_in_package_manifest:
       - AGENTERA_HOME precedence
       - default app home
@@ -124,7 +124,7 @@ ownership:
       - unmanaged classification
       - app-home diagnostics
   runtime_adapter_delegated:
-    owner: scripts/runtime_adapter_registry.py
+    owner: packages/cli/src/registries/runtimeAdapterRegistry.ts
     forbidden_in_package_manifest:
       - runtime discovery
       - lifecycle events
@@ -141,10 +141,11 @@ command_safety:
     - install-agentera-skill
   approved_runtimes:
     - all
-    - claude
     - opencode
+    - codex
+    - cursor
+    - copilot
   approved_runtime_agents:
-    - claude-code
     - opencode
   approved_package_tool:
     executable: npx
@@ -176,9 +177,15 @@ sample_manifest:
       - id: registry
         path: registry.json
         selector: skills[0].version
-      - id: python-project
-        path: pyproject.toml
-        selector: project.version
+      - id: cli-package
+        path: packages/cli/package.json
+        selector: version
+      - id: cli-suite-marker
+        path: packages/cli/package.json
+        selector: agentera.suiteVersion
+      - id: cli-package-lock
+        path: packages/cli/package-lock.json
+        selector: version
       - id: copilot-root
         path: plugin.json
         selector: version
@@ -188,15 +195,15 @@ sample_manifest:
       - id: codex-plugin
         path: .codex-plugin/plugin.json
         selector: version
-      - id: claude-marketplace-metadata
-        path: .claude-plugin/marketplace.json
-        selector: metadata.version
-      - id: claude-marketplace-plugins
-        path: .claude-plugin/marketplace.json
-        selector: plugins[*].version
+      - id: cursor-plugin
+        path: .cursor-plugin/plugin.json
+        selector: version
       - id: opencode-plugin-marker
         path: .opencode/plugins/agentera.js
         selector: AGENTERA_VERSION
+      - id: skill-frontmatter
+        path: skills/agentera/SKILL.md
+        selector: frontmatter.version
     excluded_runtime_manifests:
       - .opencode/package.json
   runtime_package_manifests:
@@ -213,28 +220,27 @@ sample_manifest:
         path: .codex-plugin/plugin.json
         version_bearing: true
         package_shape: suite-bundle
-      - runtime: claude
-        path: .claude-plugin/marketplace.json
+      - runtime: cursor
+        path: .cursor-plugin/plugin.json
         version_bearing: true
         package_shape: suite-bundle
       - runtime: opencode
         path: .opencode/package.json
         version_bearing: false
-        package_shape: suite-bundle
+        package_shape: npm-loadable-plugin
     shared_paths_policy: validate minimum shared paths separately from full bundle includes
   bundle_surfaces:
     directories:
       - skills
-      - scripts
-      - hooks
       - references
       - agents
-      - .agents/plugins
-      - .codex-plugin
-      - .claude-plugin
+      - hooks
       - .github/hooks
-      - .github/plugin
+      - .codex-plugin
+      - .cursor-plugin
+      - .cursor/agents
       - .opencode/commands
+      - .opencode/agents
       - .opencode/plugins
     files:
       - README.md
@@ -242,11 +248,11 @@ sample_manifest:
       - CHANGELOG.md
       - DESIGN.md
       - LICENSE
-      - pyproject.toml
-      - uv.lock
       - registry.json
       - plugin.json
+      - .github/plugin/plugin.json
       - .opencode/package.json
+      - .cursor/hooks.json
     skip_parts:
       - __pycache__
       - .pytest_cache
@@ -278,21 +284,6 @@ sample_manifest:
           - -g
           - -y
         skipped_without_update_packages_message: legacy skill removal skipped; pass --update-packages to run
-      - runtime: claude
-        action: install-agentera-skill
-        phase: runtime-install
-        argv:
-          - npx
-          - skills
-          - add
-          - jgabor/agentera
-          - -g
-          - -a
-          - claude-code
-          - --skill
-          - agentera
-          - -y
-        skipped_without_update_packages_message: external package update skipped; pass --update-packages to run
       - runtime: opencode
         action: install-agentera-skill
         phase: runtime-install
@@ -318,17 +309,19 @@ sample_manifest:
   docs_targets:
     version_files_source: .agentera/docs.yaml conventions.version_files
     version_files:
-      - pyproject.toml
-      - uv.lock
+      - packages/cli/package.json
+      - packages/cli/package-lock.json
       - plugin.json
       - .github/plugin/plugin.json
       - .codex-plugin/plugin.json
-      - .claude-plugin/marketplace.json
+      - .cursor-plugin/plugin.json
       - .opencode/plugins/agentera.js
+      - skills/agentera/SKILL.md
       - registry.json
     index_targets:
       - references/adapters/package-surface-characterization.md
       - references/adapters/package-manifest-interface-model.yaml
+      - references/adapters/package-registry.yaml
     excluded_version_files:
       - .opencode/package.json
   release_policy:

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

@@ -17,9 +17,12 @@ records:
         - id: registry
           path: registry.json
           selector: skills[0].version
-        - id: python-project
-          path: pyproject.toml
-          selector: project.version
+        - id: cli-package
+          path: packages/cli/package.json
+          selector: version
+        - id: cli-suite-marker
+          path: packages/cli/package.json
+          selector: agentera.suiteVersion
         - id: copilot-root
           path: plugin.json
           selector: version
@@ -29,15 +32,15 @@ records:
         - id: codex-plugin
           path: .codex-plugin/plugin.json
           selector: version
-        - id: claude-marketplace-metadata
-          path: .claude-plugin/marketplace.json
-          selector: metadata.version
-        - id: claude-marketplace-plugins
-          path: .claude-plugin/marketplace.json
-          selector: plugins[*].version
+        - id: cursor-plugin
+          path: .cursor-plugin/plugin.json
+          selector: version
         - id: opencode-plugin-marker
           path: .opencode/plugins/agentera.js
           selector: AGENTERA_VERSION
+        - id: skill-frontmatter
+          path: skills/agentera/SKILL.md
+          selector: frontmatter.version
       excluded_runtime_manifests:
         - .opencode/package.json
     runtime_package_manifests:
@@ -62,11 +65,6 @@ records:
           path: .cursor-plugin/plugin.json
           version_bearing: true
           package_shape: suite-bundle
-        - id: claude-marketplace-manifest
-          runtime: claude
-          path: .claude-plugin/marketplace.json
-          version_bearing: true
-          package_shape: suite-bundle
         - id: opencode-package-manifest
           runtime: opencode
           path: .opencode/package.json
@@ -76,9 +74,6 @@ records:
         - id: skills
           path: skills
           kind: dir
-        - id: scripts
-          path: scripts
-          kind: dir
         - id: hooks
           path: hooks
           kind: dir
@@ -99,28 +94,20 @@ records:
       directories:
         - id: skills
           path: skills
-        - id: scripts
-          path: scripts
-        - id: hooks
-          path: hooks
         - id: references
           path: references
         - id: agents
           path: agents
-        - id: agents-plugins
-          path: .agents/plugins
+        - id: hooks
+          path: hooks
+        - id: github-hooks
+          path: .github/hooks
         - id: codex-plugin
           path: .codex-plugin
         - id: cursor-plugin
           path: .cursor-plugin
         - id: cursor-agents
           path: .cursor/agents
-        - id: claude-plugin
-          path: .claude-plugin
-        - id: github-hooks
-          path: .github/hooks
-        - id: github-plugin
-          path: .github/plugin
         - id: opencode-commands
           path: .opencode/commands
         - id: opencode-agents
@@ -138,14 +125,12 @@ records:
           path: DESIGN.md
         - id: license
           path: LICENSE
-        - id: python-project
-          path: pyproject.toml
-        - id: python-lock
-          path: uv.lock
         - id: registry
           path: registry.json
         - id: copilot-root-manifest
           path: plugin.json
+        - id: copilot-repository-manifest
+          path: .github/plugin/plugin.json
         - id: opencode-package-manifest
           path: .opencode/package.json
         - id: cursor-hooks
@@ -182,22 +167,6 @@ records:
             - -g
             - -y
           skipped_without_update_packages_message: legacy skill removal skipped; pass --update-packages to run
-        - id: install-agentera-skill-claude
-          runtime: claude
-          action: install-agentera-skill
-          phase: runtime-install
-          argv:
-            - npx
-            - skills
-            - add
-            - jgabor/agentera
-            - -g
-            - -a
-            - claude-code
-            - --skill
-            - agentera
-            - -y
-          skipped_without_update_packages_message: external package update skipped; pass --update-packages to run
         - id: install-agentera-skill-opencode
           runtime: opencode
           action: install-agentera-skill
@@ -224,13 +193,11 @@ records:
     docs_targets:
       version_files_source: .agentera/docs.yaml conventions.version_files
       version_files:
-        - pyproject.toml
-        - uv.lock
+        - packages/cli/package.json
         - plugin.json
         - .github/plugin/plugin.json
         - .codex-plugin/plugin.json
         - .cursor-plugin/plugin.json
-        - .claude-plugin/marketplace.json
         - .opencode/plugins/agentera.js
         - skills/agentera/SKILL.md
         - registry.json

package/bundle/references/adapters/package-surface-characterization.md

@@ -1,47 +1,61 @@
-# Package Surface Characterization
-
-Characterized on 2026-05-06 before the PackageManifest registry migration. This file records current behavior only; it is not the registry design.
-
-The executable PackageManifest registry at `references/adapters/package-registry.yaml` and its loader `scripts/package_registry.py` now own the single source of truth for version surfaces, runtime package manifests, bundle surfaces, package commands, and docs targets. Validators, upgrade, and tests consume registry facts instead of duplicating constants.
-
-## Version-Bearing Surfaces
-
-`registry.json` is the persisted suite-version authority. The current suite version is `2.2.0` at `skills[0].version`.
-
-The current version-bearing surfaces are:
-
-| Surface | Kind | Current behavior |
-| --- | --- | --- |
-| `registry.json` | version-bearing surface | `skills[0].version` is the suite authority. |
-| `pyproject.toml` | version-bearing surface | `[project].version` matches the registry suite version. |
-| `plugin.json` | version-bearing surface and runtime package manifest | root Copilot manifest `version` matches the suite version. |
-| `.github/plugin/plugin.json` | version-bearing surface and runtime package manifest | repository Copilot manifest `version` matches the suite version. |
-| `.codex-plugin/plugin.json` | version-bearing surface and runtime package manifest | Codex manifest `version` matches the suite version. |
-| `.claude-plugin/marketplace.json` | version-bearing surface and runtime package manifest | `metadata.version` and the bundled `agentera` plugin entry version match the suite version. |
-| `.opencode/plugins/agentera.js` | version-bearing surface | `AGENTERA_VERSION` matches the registry suite version and drives the OpenCode command marker file `.agentera-version`. |
-
-`.opencode/package.json` is intentionally not version-bearing. Its current behavior is runtime package manifest behavior only: it keeps `type: "module"`, `main`/`exports` pointing at `./plugins/agentera.js`, `dependencies["@opencode-ai/plugin"] == "1.14.33"`, and an `agentera` npm-loadable plugin metadata block, but it has no top-level `name` or `version` field.
-
-## Package-Manager Command Surface
-
-Upgrade package planning currently emits package-manager commands only for Claude Code and OpenCode runtime selections.
-
-| Runtime | Action | Command argv | Skipped message | Dry-run behavior | Apply behavior with mocked command |
-| --- | --- | --- | --- | --- | --- |
-| `all` | `remove-legacy-skills` | `npx skills remove hej visionera resonera inspirera planera realisera inspektera optimera orkestrera visualisera dokumentera profilera -g -y` | `legacy skill removal skipped; pass --update-packages to run` | `--update-packages` without `--yes` leaves status `pending` and does not execute. | status becomes `applied`, message `package update completed`, and command result tails are recorded. |
-| `claude` | `install-agentera-skill` | `npx skills add jgabor/agentera -g -a claude-code --skill agentera -y` | `external package update skipped; pass --update-packages to run` | `--update-packages` without `--yes` leaves status `pending` and does not execute. | status becomes `applied`, message `package update completed`, and command result tails are recorded. |
-| `opencode` | `install-agentera-skill` | `npx skills add jgabor/agentera -g -a opencode --skill agentera -y` | `external package update skipped; pass --update-packages to run` | `--update-packages` without `--yes` leaves status `pending` and does not execute. | status becomes `applied`, message `package update completed`, and command result tails are recorded. |
-
-Write gating is preserved: `--update-packages` changes package items from `skipped` to `pending`, but package-manager commands execute only during apply mode behind `--yes`. Focused tests mock `subprocess.run`; no live package-manager call is part of this characterization.
-
-## Bundle And Docs Drift Inventory
-
-| Drift point | Surface class | Decision | Current behavior to preserve before migration |
-| --- | --- | --- | --- |
-| `pyproject.toml` force-includes and `scripts/agentera_upgrade.py` bundle lists duplicate the same shipped bundle directories and files. | bundle metadata surface | `standardize` | Keep both lists aligned now; later PackageManifest should own the list once. |
-| Lifecycle validation requires only the minimal shared runtime package paths (`skills`, `scripts`, `hooks`, `registry.json`, `plugin.json`, `pyproject.toml`, `README.md`) while pyproject and upgrade copy the larger distributable bundle. | runtime package manifest | `standardize` | Keep the validator as a minimum package-shape check now; later PackageManifest should separate minimal runtime metadata from full bundle includes. |
-| Runtime manifest `agentera.sharedPaths` includes `UPGRADE.md`, but `SUITE_BUNDLE_REQUIRED_PATHS` does not require it. | runtime package manifest | `standardize` | Keep current validator leniency now; later PackageManifest should make required shared paths explicit in one place. |
-| `.agentera/docs.yaml` `version_files` includes version-bearing surfaces and excludes `.opencode/package.json`. | version-bearing surface | `preserve` | Keep `.opencode/package.json` out of version checks because it is a runtime package manifest, not a suite version surface. |
-| `.opencode/package.json` is force-included and bundled, but it is not in docs `version_files`. | runtime package manifest | `preserve` | Keep packaging it without treating it as version-bearing. |
-| Upgrade package commands are represented as argv lists for Claude Code and OpenCode only; Codex and Copilot have runtime manifests but no package-manager command entries. | package-manager command surface | `preserve` | Keep command planning limited to currently managed package runtimes. |
-| Live package-manager behavior is not characterized by this task. | package-manager command surface | `defer` | Keep tests mocked; do not introduce live `npx skills` execution. |
+# Package surface characterization
+
+Current Agentera 3.0 package behavior is owned by
+`references/adapters/package-registry.yaml` and the TypeScript
+`PackageRegistry` loader.
+
+## Version matrix
+
+`registry.json` `skills[0].version` is the persisted suite authority. These
+mirrors must match it:
+
+| Surface | Selector |
+| --- | --- |
+| `packages/cli/package.json` | `version` and `agentera.suiteVersion` |
+| `packages/cli/package-lock.json` | `version` |
+| `plugin.json` | `version` |
+| `.github/plugin/plugin.json` | `version` |
+| `.codex-plugin/plugin.json` | `version` |
+| `.cursor-plugin/plugin.json` | `version` |
+| `.opencode/plugins/agentera.js` | `AGENTERA_VERSION` |
+| `skills/agentera/SKILL.md` | frontmatter `version` |
+
+`.opencode/package.json` is a runtime package manifest but intentionally has no
+suite-version field.
+
+## Active runtime manifests
+
+The runtime manifest set covers exactly OpenCode, Codex, Cursor, and GitHub
+Copilot. Claude has no package or marketplace manifest.
+
+| Runtime | Manifest sources |
+| --- | --- |
+| OpenCode | `.opencode/package.json` |
+| Codex | `.codex-plugin/plugin.json` |
+| Cursor | `.cursor-plugin/plugin.json` |
+| GitHub Copilot | `plugin.json`, `.github/plugin/plugin.json` |
+
+## npm bundle
+
+The self-contained npm package ships `dist/` plus `bundle/`. Bundle data
+includes the shared skill, contracts, references, release docs, and every
+runtime lifecycle/package source declared by the registry:
+
+- `.opencode/commands`, `.opencode/agents`, `.opencode/plugins`, and package manifest;
+- `.codex-plugin` and both Codex hook sources under `hooks/`;
+- `.cursor-plugin`, `.cursor/hooks.json`, and `.cursor/agents`;
+- Copilot root/repository manifests and `.github/hooks`;
+- `skills`, `references`, `registry.json`, README, upgrade guide, changelog,
+  design, and license.
+
+Packaging tests inspect `npm pack --dry-run --json --ignore-scripts` and fail if
+any declared runtime source disappears. The retired Claude manifest is also a
+negative assertion.
+
+## Package-manager boundary
+
+Lifecycle upgrade does not execute runtime-native package managers. Legacy
+portable-skill cleanup and the OpenCode portable-skill install specification
+remain argv-only package-registry records behind their existing update and
+approval gates. Native installation, enablement, authentication, and trust are
+user-owned actions.