agentera 3.0.0-dev.23 → 3.0.0-dev.26

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

@@ -23,97 +23,15 @@ records:
         - id: cli-suite-marker
           path: packages/cli/package.json
           selector: agentera.suiteVersion
-        - id: copilot-root
-          path: plugin.json
-          selector: version
-        - id: copilot-repository
-          path: .github/plugin/plugin.json
-          selector: version
-        - id: codex-plugin
-          path: .codex-plugin/plugin.json
-          selector: 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:
-      manifests:
-        - id: copilot-root-manifest
-          runtime: copilot
-          path: plugin.json
-          version_bearing: true
-          package_shape: suite-bundle
-        - id: copilot-repository-manifest
-          runtime: copilot
-          path: .github/plugin/plugin.json
-          version_bearing: true
-          package_shape: suite-bundle
-        - id: codex-plugin-manifest
-          runtime: codex
-          path: .codex-plugin/plugin.json
-          version_bearing: true
-          package_shape: suite-bundle
-        - id: cursor-plugin-manifest
-          runtime: cursor
-          path: .cursor-plugin/plugin.json
-          version_bearing: true
-          package_shape: suite-bundle
-        - id: opencode-package-manifest
-          runtime: opencode
-          path: .opencode/package.json
-          version_bearing: false
-          package_shape: npm-loadable-plugin
-      shared_paths:
-        - id: skills
-          path: skills
-          kind: dir
-        - id: hooks
-          path: hooks
-          kind: dir
-        - id: registry
-          path: registry.json
-          kind: file
-        - id: copilot-root-manifest
-          path: plugin.json
-          kind: file
-        - id: readme
-          path: README.md
-          kind: file
-        - id: upgrade-guide
-          path: UPGRADE.md
-          kind: file
-      shared_paths_policy: validate minimum shared paths separately from full bundle includes
     bundle_surfaces:
       directories:
         - id: skills
           path: skills
         - id: references
           path: references
-        - id: agents
-          path: agents
-        - 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: opencode-commands
-          path: .opencode/commands
-        - id: opencode-agents
-          path: .opencode/agents
-        - id: opencode-plugins
-          path: .opencode/plugins
       files:
         - id: readme
           path: README.md
@@ -127,14 +45,15 @@ records:
           path: LICENSE
         - 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
-          path: .cursor/hooks.json
+      generated_files:
+        - id: npx-bundle-marker
+          path: .agentera-npx-bundle.json
+          format: json
+          classification: active
+        - id: extract-corpus-parity
+          path: extract-corpus-parity.json
+          format: json
+          classification: active
       skip_parts:
         - __pycache__
         - .pytest_cache
@@ -142,71 +61,16 @@ records:
       skip_suffixes:
         - .pyc
         - .pyo
-    package_commands:
-      commands:
-        - id: remove-legacy-skills
-          runtime: all
-          action: remove-legacy-skills
-          phase: cleanup
-          argv:
-            - npx
-            - skills
-            - remove
-            - hej
-            - visionera
-            - resonera
-            - inspirera
-            - planera
-            - realisera
-            - inspektera
-            - optimera
-            - orkestrera
-            - visualisera
-            - dokumentera
-            - profilera
-            - -g
-            - -y
-          skipped_without_update_packages_message: legacy skill removal skipped; pass --update-packages to run
-        - id: install-agentera-skill-opencode
-          runtime: opencode
-          action: install-agentera-skill
-          phase: runtime-install
-          argv:
-            - npx
-            - skills
-            - add
-            - jgabor/agentera
-            - -g
-            - -a
-            - opencode
-            - --skill
-            - agentera
-            - -y
-          skipped_without_update_packages_message: external package update skipped; pass --update-packages to run
-      safety:
-        argv_only: true
-        update_packages_required_to_plan: true
-        yes_required_to_execute: true
-        preserve_existing_write_gates: true
-        cleanup_phase: cleanup
-        runtime_install_phase: runtime-install
     docs_targets:
       version_files_source: .agentera/docs.yaml conventions.version_files
       version_files:
         - packages/cli/package.json
-        - plugin.json
-        - .github/plugin/plugin.json
-        - .codex-plugin/plugin.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:
       semver_policy_source: .agentera/docs.yaml conventions.semver_policy
       version_bump_required_for_interface_only_change: false

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

@@ -2,7 +2,8 @@
 
 Current Agentera 3.0 package behavior is owned by
 `references/adapters/package-registry.yaml` and the TypeScript
-`PackageRegistry` loader.
+`PackageRegistry` loader. The package has two product surfaces: the CLI and the
+canonical shared skill.
 
 ## Version matrix
 
@@ -13,16 +14,8 @@ development pre-release suffix, but its `X.Y.Z` core must match the suite:
 | Surface | Selector |
 | --- | --- |
 | `packages/cli/package.json` | `version` (development pre-release) and `agentera.suiteVersion` (suite) |
-| `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.
-
 `packages/cli/package.json#agentera.gitRef` identifies the last substantive
 package-source commit, not a later verification-only commit. Repository-local
 release validation requires that commit to exist and compares the package
@@ -30,39 +23,21 @@ contract, compiled-source inputs, scripts, and bundled-data inputs against it.
 Only the package version and `gitRef`, project state, and the release validator
 implementing this check are excluded, avoiding a circular source reference.
 
-## 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.
+includes the canonical `skills/` tree, required `references/`, `registry.json`,
+and package guidance. Compiled commands ship in `dist/`. The shared-skill tree
+includes its capability schemas, artifact schemas, and canonical
+`skills/agentera/agents/*.toml` descriptors.
 
 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.
+the CLI or required bundle data disappears, or if a current host-native
+descriptor/runtime path enters the package.
 
-## Package-manager boundary
+## Native package 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.
+The package registry defines no host-native manifest parity, package-manager
+command, runtime source tree, or native install command. Historical migration
+readers and fixtures remain source-only compatibility data; they do not create a
+current integration surface in the npm inventory.

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

@@ -1,5 +1,5 @@
 schema_version: agentera.runtimeLifecycleAdapters.v1
-status: active_contract
+status: migration_only_contract
 decision: 92
 authority: references/adapters/runtime-lifecycle-authority.yaml
 operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
@@ -68,221 +68,7 @@ path_policy:
     - 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.
+  - This contract is retained only for migration and minimum-cleanup readers; it declares no current runtime adapters or repository-native resources.
+shared_resources: []
+managed_resources: []
+adapters: []

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

@@ -1,5 +1,5 @@
 schema_version: agentera.runtimeLifecycleAuthority.v1
-status: active_authority
+status: migration_only_authority
 decision: 92
 operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
 adapter_contract: references/adapters/runtime-lifecycle-adapters.yaml
@@ -51,34 +51,7 @@ support_floor:
       - enabled
     not_applicable_scope: unobserved_conditional_surface_only
   unmet_blocks_release: true
-active_runtimes:
-  - id: opencode
-    display_name: OpenCode
-    surfaces:
-      - id: host
-        display_name: OpenCode host
-        presence: required
-  - id: codex
-    display_name: Codex
-    surfaces:
-      - id: cli
-        display_name: Codex CLI
-        presence: required
-  - id: cursor
-    display_name: Cursor
-    surfaces:
-      - id: cli
-        display_name: Cursor Agent CLI
-        presence: required
-      - id: ide
-        display_name: Cursor IDE
-        presence: conditional
-  - id: copilot
-    display_name: GitHub Copilot
-    surfaces:
-      - id: cli
-        display_name: Copilot CLI
-        presence: required
+active_runtimes: []
 retired_runtime_inputs:
   - id: claude
     purposes:

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

@@ -1,5 +1,5 @@
 schema_version: agentera.lifecycleOperationContract.v1
-status: active_contract
+status: migration_only_contract
 decision: 92
 scope: runtime_neutral_filesystem_resources
 ownership: