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

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

@@ -2,19 +2,16 @@ interface: PackageManifest
 status: implemented
 implemented_by: references/adapters/package-registry.yaml
 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 TypeScript PackageRegistry loader
-  now implement this interface; this model remains the authoritative design contract.
+  Define the self-contained Agentera package as the TypeScript CLI plus one
+  canonical shared skill and its required contracts. Host-native manifests,
+  runtime source trees, and native installation commands are not package
+  surfaces.
 record:
   required_groups:
     - identity
     - version_authority
     - version_surfaces
-    - runtime_package_manifests
     - bundle_surfaces
-    - package_commands
     - docs_targets
     - release_policy
   groups:
@@ -23,7 +20,7 @@ record:
       owns:
         - package id
         - suite name
-        - skill path
+        - canonical shared-skill path
         - capability count expectation
       required_fields:
         id: string
@@ -44,56 +41,59 @@ record:
     version_surfaces:
       type: object
       owns:
-        - version-bearing repository surfaces
+        - CLI and shared-skill version surfaces
         - version extraction selectors
-        - non-version surface exclusions
       required_fields:
         surfaces: list[object]
-        excluded_runtime_manifests: list[repo_relative_path]
-    runtime_package_manifests:
-      type: object
-      owns:
-        - runtime package manifest paths
-        - runtime package shape expectations
-        - shared package path expectations
-      required_fields:
-        manifests: list[object]
-        shared_paths_policy: string
     bundle_surfaces:
       type: object
       owns:
-        - bundled directories
-        - bundled files
-        - generated-only bundled files
+        - canonical bundled directories
+        - canonical bundled files
+        - generated bundled files
         - bundle skip rules
-        - bundle mismatch standardization target
       required_fields:
-        directories: list[repo_relative_path]
-        files: list[repo_relative_path]
+        directories: list[object]
+        files: list[object]
         generated_files: list[generated_bundle_file]
         skip_parts: list[string]
         skip_suffixes: list[string]
-    package_commands:
-      type: object
-      owns:
-        - package-manager command specifications
-        - package command action names
-        - package command runtime scope
-        - package write-gate preservation
-      required_fields:
-        commands: list[object]
-        safety: object
+      entry_contracts:
+        directory_and_file:
+          applies_to:
+            - directories
+            - files
+          required_fields:
+            - id
+            - path
+          allowed_fields:
+            - id
+            - path
+          field_types:
+            id: string
+            path: repo_relative_path
+          uniqueness:
+            id: global_across_directories_and_files
+            path: global_across_directories_and_files
+          path_format: normalized_relative_posix
+          forbidden_path_forms:
+            - posix_absolute
+            - windows_absolute_or_drive_prefixed
+            - backslash
+            - dot_or_dot_dot_segment
+            - leading_dot_slash
+            - trailing_separator
+            - noncanonical_posix_normalization
+      value_authority: references/adapters/package-registry.yaml records[*].bundle_surfaces
     docs_targets:
       type: object
       owns:
         - docs version targets
         - docs index targets for package surfaces
-        - non-version docs exclusions
       required_fields:
         version_files_source: string
         version_files: list[repo_relative_path]
         index_targets: list[repo_relative_path]
-        excluded_version_files: list[repo_relative_path]
     release_policy:
       type: object
       owns:
@@ -113,8 +113,8 @@ ownership:
     access_interface: PackageManifest
     rule: >
       registry.json remains the persisted suite-version authority. PackageManifest
-      becomes the typed access Interface for consumers after migration, unless an
-      explicit future ADR changes persisted authority.
+      is the typed access interface unless an explicit future ADR changes that
+      authority.
     future_authority_change_requires: explicit ADR
   install_root_delegated:
     owner: packages/cli/src/state/installRoot.ts
@@ -125,204 +125,3 @@ ownership:
       - stale classification
       - unmanaged classification
       - app-home diagnostics
-  runtime_adapter_delegated:
-    owner: packages/cli/src/registries/runtimeAdapterRegistry.ts
-    forbidden_in_package_manifest:
-      - runtime discovery
-      - lifecycle events
-      - artifact validation hooks
-      - config target paths
-      - runtime diagnostics
-      - documentation claims
-command_safety:
-  argv_only: true
-  approved_executables:
-    - npx
-  approved_actions:
-    - remove-legacy-skills
-    - install-agentera-skill
-  approved_runtimes:
-    - all
-    - opencode
-    - codex
-    - cursor
-    - copilot
-  approved_runtime_agents:
-    - opencode
-  approved_package_tool:
-    executable: npx
-    command_namespace: skills
-    actions:
-      - remove
-      - add
-  cleanup_actions:
-    - remove-legacy-skills
-  runtime_install_actions:
-    - install-agentera-skill
-  gates:
-    update_packages_required_to_plan: true
-    yes_required_to_execute: true
-    preserve_existing_write_gates: true
-sample_manifest:
-  identity:
-    id: agentera
-    name: agentera
-    skill_path: skills/agentera
-    expected_capabilities: 12
-  version_authority:
-    persisted_authority: registry.json
-    selector: skills[0].version
-    access_interface: PackageManifest
-    future_authority_change_requires: explicit ADR
-  version_surfaces:
-    surfaces:
-      - id: registry
-        path: registry.json
-        selector: skills[0].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
-      - 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:
-      - runtime: copilot
-        path: plugin.json
-        version_bearing: true
-        package_shape: suite-bundle
-      - runtime: copilot
-        path: .github/plugin/plugin.json
-        version_bearing: true
-        package_shape: suite-bundle
-      - runtime: codex
-        path: .codex-plugin/plugin.json
-        version_bearing: true
-        package_shape: suite-bundle
-      - 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: npm-loadable-plugin
-    shared_paths_policy: validate minimum shared paths separately from full bundle includes
-  bundle_surfaces:
-    directories:
-      - skills
-      - references
-      - agents
-      - hooks
-      - .github/hooks
-      - .codex-plugin
-      - .cursor-plugin
-      - .cursor/agents
-      - .opencode/commands
-      - .opencode/agents
-      - .opencode/plugins
-    files:
-      - README.md
-      - UPGRADE.md
-      - CHANGELOG.md
-      - DESIGN.md
-      - LICENSE
-      - registry.json
-      - plugin.json
-      - .github/plugin/plugin.json
-      - .opencode/package.json
-      - .cursor/hooks.json
-    skip_parts:
-      - __pycache__
-      - .pytest_cache
-      - node_modules
-    skip_suffixes:
-      - .pyc
-      - .pyo
-  package_commands:
-    commands:
-      - 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
-      - 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
-    release_publication_in_scope: false

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,6 @@ 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
@@ -151,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.