agentera 3.0.0-dev.4 → 3.0.0-dev.46

package/bundle/references/adapters/runtime-retired-resources.yaml

@@ -0,0 +1,333 @@
+schema_version: agentera.nativeResourceCleanup.v1
+status: resource_retirement_contract
+decision: nksvqmnevm
+authority: references/adapters/runtime-lifecycle-authority.yaml
+operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
+policy:
+  host_inventory_exposure: evidence_only
+  selection: native_agentera_resource_only
+  preview: strictly_read_only
+  apply_requires: explicit_approval
+  ownership: matching_whole_resource_ledger_identity_and_fingerprint
+  shared_configuration: action_required_without_key_level_ownership
+  forbidden_ownership_evidence:
+    - value_equality
+    - managed_marker
+    - resource_name
+    - file_equality
+  unsupported_platform_result: action_required
+accepted_host_evidence:
+  - host: codex
+    state: supported
+    proof: Codex loaded Agentera's specific canonical skill instructions and bootstrap command.
+  - host: cursor
+    state: supported
+    proof: Cursor loaded Agentera's specific canonical skill instructions and bootstrap command.
+  - host: opencode
+    state: supported
+    proof: OpenCode's native CLI listed ~/.agents/skills/agentera/SKILL.md.
+  - host: copilot
+    state: supported_disabled
+    proof: Copilot's native CLI listed the canonical personal-agents skill; its disabled state is intentional.
+hosts:
+  - id: codex
+    display_name: Codex
+    support_status: supported
+  - id: cursor
+    display_name: Cursor
+    support_status: supported
+  - id: opencode
+    display_name: OpenCode
+    support_status: supported
+  - id: copilot
+    display_name: Copilot
+    support_status: supported_disabled
+  - id: claude
+    display_name: Claude Code historical migration
+    support_status: retired_historical
+resource_vocabulary:
+  - id: claude.skill-link
+    resource_class: legacy_skill_link
+    migration_scope: explicit_cleanup
+    resource_ids:
+      - claude.agentera-skill-link
+    historical_ids: []
+  - id: codex.agent-descriptor
+    resource_class: capability_descriptor
+    migration_scope: explicit_cleanup
+    resource_ids:
+      - codex.agent-descriptor.status
+      - codex.agent-descriptor.vision
+      - codex.agent-descriptor.discuss
+      - codex.agent-descriptor.research
+      - codex.agent-descriptor.plan
+      - codex.agent-descriptor.build
+      - codex.agent-descriptor.optimize
+      - codex.agent-descriptor.audit
+      - codex.agent-descriptor.document
+      - codex.agent-descriptor.profile
+      - codex.agent-descriptor.design
+      - codex.agent-descriptor.orchestrate
+    historical_ids:
+      - codex.agents.status
+      - codex.agents.vision
+      - codex.agents.discuss
+      - codex.agents.research
+      - codex.agents.plan
+      - codex.agents.build
+      - codex.agents.optimize
+      - codex.agents.audit
+      - codex.agents.document
+      - codex.agents.profile
+      - codex.agents.design
+      - codex.agents.orchestrate
+  - id: opencode.plugin
+    resource_class: plugin
+    migration_scope: v2_upgrade_only
+    resource_ids:
+      - opencode.plugin.agentera
+    historical_ids: []
+  - id: opencode.command
+    resource_class: command
+    migration_scope: v2_upgrade_only
+    resource_ids:
+      - opencode.command.agentera
+      - opencode.command.hej
+    historical_ids: []
+  - id: legacy.primary-agent
+    resource_class: primary_agent
+    migration_scope: v2_upgrade_only
+    resource_ids:
+      - cursor.agent.agentera
+      - opencode.agent.agentera
+    historical_ids: []
+  - id: legacy.capability-agent
+    resource_class: capability_agent
+    migration_scope: v2_upgrade_only
+    resource_ids:
+      - cursor.agent.audit
+      - cursor.agent.build
+      - cursor.agent.design
+      - cursor.agent.discuss
+      - cursor.agent.document
+      - cursor.agent.optimize
+      - cursor.agent.orchestrate
+      - cursor.agent.plan
+      - cursor.agent.profile
+      - cursor.agent.research
+      - cursor.agent.status
+      - cursor.agent.vision
+      - cursor.agent.dokumentera
+      - cursor.agent.hej
+      - cursor.agent.inspektera
+      - cursor.agent.inspirera
+      - cursor.agent.optimera
+      - cursor.agent.orkestrera
+      - cursor.agent.planera
+      - cursor.agent.profilera
+      - cursor.agent.realisera
+      - cursor.agent.resonera
+      - cursor.agent.visionera
+      - cursor.agent.visualisera
+      - opencode.agent.audit
+      - opencode.agent.build
+      - opencode.agent.design
+      - opencode.agent.discuss
+      - opencode.agent.document
+      - opencode.agent.optimize
+      - opencode.agent.orchestrate
+      - opencode.agent.plan
+      - opencode.agent.profile
+      - opencode.agent.research
+      - opencode.agent.status
+      - opencode.agent.vision
+      - opencode.agent.dokumentera
+      - opencode.agent.hej
+      - opencode.agent.inspektera
+      - opencode.agent.inspirera
+      - opencode.agent.optimera
+      - opencode.agent.orkestrera
+      - opencode.agent.planera
+      - opencode.agent.profilera
+      - opencode.agent.realisera
+      - opencode.agent.resonera
+      - opencode.agent.visionera
+      - opencode.agent.visualisera
+    historical_ids: []
+  - id: opencode.stale-skill-link
+    resource_class: stale_skill_link
+    migration_scope: v2_upgrade_only
+    resource_ids:
+      - opencode.skill-link.agentera
+      - opencode.skill-link.status
+    historical_ids: []
+  - id: installed.hook
+    resource_class: installed_hook
+    migration_scope: v2_upgrade_only
+    resource_ids:
+      - agentera.installed-hook.validate_artifact.py
+      - agentera.installed-hook.cursor_session_start.py
+      - agentera.installed-hook.cursor_pre_tool_use.py
+      - agentera.installed-hook.cursor_session_stop.py
+      - agentera.installed-hook.session_start.py
+      - agentera.installed-hook.session_stop.py
+      - agentera.installed-hook.codex-hooks.json
+    historical_ids: []
+  - id: agentera.registration
+    resource_class: registration
+    migration_scope: v2_upgrade_only
+    resource_ids:
+      - agentera.registration.marketplace.cursor
+      - agentera.registration.plugin.codex
+      - agentera.registration.restorer.codex
+    historical_ids: []
+    identity_evidence:
+      - "Cursor marketplace registration: {project}/.cursor-plugin/plugin.json"
+      - "Codex plugin registration: [plugins.\"agentera@agentera\"] in {home}/.codex/config.toml"
+      - "Codex restorer registration: AGENTERA_HOME in {home}/.codex/config.toml"
+      - "No independent plugin, marketplace, skill, hook, or restorer file was installed for any other host; those former template labels are not resource identities."
+diagnostic_inventory:
+  maximum_resources: 96
+  maximum_file_bytes: 65536
+  resources:
+    - vocabulary: claude.skill-link
+      id: claude.agentera-skill-link
+      destinations:
+        - "{home}/.claude/skills/agentera"
+    - vocabulary: codex.agent-descriptor
+      id: codex.agent-descriptor.{name}
+      names: [status, vision, discuss, research, plan, build, optimize, audit, document, profile, design, orchestrate]
+      destinations:
+        - "{home}/.codex/agents/{name}.toml"
+    - vocabulary: opencode.plugin
+      id: opencode.plugin.agentera
+      destinations:
+        - "{home}/.config/opencode/plugins/agentera.js"
+    - vocabulary: opencode.command
+      id: opencode.command.{name}
+      names: [agentera, hej]
+      destinations:
+        - "{home}/.config/opencode/commands/{name}.md"
+    - vocabulary: legacy.primary-agent
+      id: cursor.agent.agentera
+      destinations:
+        - "{home}/.cursor/agents/agentera.md"
+        - "{project}/.cursor/agents/agentera.md"
+    - vocabulary: legacy.primary-agent
+      id: opencode.agent.agentera
+      destinations:
+        - "{home}/.config/opencode/agents/agentera.md"
+    - vocabulary: legacy.capability-agent
+      id: cursor.agent.{name}
+      names: [audit, build, design, discuss, document, optimize, orchestrate, plan, profile, research, status, vision, dokumentera, hej, inspektera, inspirera, optimera, orkestrera, planera, profilera, realisera, resonera, visionera, visualisera]
+      destinations:
+        - "{home}/.cursor/agents/{name}.md"
+        - "{project}/.cursor/agents/{name}.md"
+    - vocabulary: legacy.capability-agent
+      id: opencode.agent.{name}
+      names: [audit, build, design, discuss, document, optimize, orchestrate, plan, profile, research, status, vision, dokumentera, hej, inspektera, inspirera, optimera, orkestrera, planera, profilera, realisera, resonera, visionera, visualisera]
+      destinations:
+        - "{home}/.config/opencode/agents/{name}.md"
+    - vocabulary: opencode.stale-skill-link
+      id: opencode.skill-link.{name}
+      names: [agentera, status]
+      destinations:
+        - "{home}/.config/opencode/skills/{name}"
+    - vocabulary: installed.hook
+      id: agentera.installed-hook.{name}
+      names: [validate_artifact.py, cursor_session_start.py, cursor_pre_tool_use.py, cursor_session_stop.py, session_start.py, session_stop.py, codex-hooks.json]
+      destinations:
+        - "{install_root}/hooks/{name}"
+    - vocabulary: agentera.registration
+      id: agentera.registration.marketplace.cursor
+      destinations:
+        - "{project}/.cursor-plugin/plugin.json"
+    - vocabulary: agentera.registration
+      id: agentera.registration.plugin.codex
+      destinations:
+        - "{home}/.codex/config.toml"
+      contains: '[plugins."agentera@agentera"]'
+    - vocabulary: agentera.registration
+      id: agentera.registration.restorer.codex
+      destinations:
+        - "{home}/.codex/config.toml"
+      contains: AGENTERA_HOME
+resources:
+  - id: claude.agentera-skill-link
+    vocabulary: claude.skill-link
+    host: claude
+    kind: symlink
+    intent: remove
+    destination: "{home}/.claude/skills/agentera"
+    ledger_status: legacy
+    durable_proof: matching whole-resource legacy ledger identity and fingerprint
+    never_touch:
+      - "{home}/.claude/projects"
+      - "{home}/.claude/statsig"
+      - "{home}/.claude/settings.json"
+      - "{home}/.claude/settings.local.json"
+      - "{home}/.claude.json"
+      - "{home}/.claude/cache"
+      - "{home}/.claude/caches"
+      - "{home}/.claude/conversations"
+      - "{home}/.claude/credentials"
+    safety_note: Only the declared Agentera skill symlink may be removed, and only when a matching legacy ownership ledger still binds its identity and target fingerprint. Transcript, settings, credential, conversation, stats, cache, and ambiguous paths are never cleanup targets.
+  - id: codex.agent-descriptor
+    vocabulary: codex.agent-descriptor
+    host: codex
+    kind: file
+    intent: remove
+    destination: "{home}/.codex/agents/{descriptor}.toml"
+    descriptors: [status, vision, discuss, research, plan, build, optimize, audit, document, profile, design, orchestrate]
+    historical_ids:
+      - codex.agents.{descriptor}
+    ledger_status: managed
+    durable_proof: matching whole-resource ledger identity and fingerprint for each declared descriptor file
+    safety_note: Each descriptor is an independently owned file. A managed marker, descriptor name, or matching content never establishes ownership.
+configuration_inventory:
+  - id: codex.config.shell_environment_policy.set.AGENTERA_HOME
+    host: codex
+    destination: "{home}/.codex/config.toml"
+    key: shell_environment_policy.set.AGENTERA_HOME
+    durable_proof: key-level ownership ledger identity and fingerprint
+    ownership_available: false
+    result_without_proof: action_required
+  - id: codex.config.agents.max_depth
+    host: codex
+    destination: "{home}/.codex/config.toml"
+    key: agents.max_depth
+    durable_proof: key-level ownership ledger identity and fingerprint
+    ownership_available: false
+    result_without_proof: action_required
+  - id: codex.config.features.multi_agent_v2
+    host: codex
+    destination: "{home}/.codex/config.toml"
+    key: features.multi_agent_v2
+    durable_proof: key-level ownership ledger identity and fingerprint
+    ownership_available: false
+    result_without_proof: action_required
+cutover_deletion_inventory:
+  schema_version: agentera.v2CutoverDeletionInventory.v1
+  approval_gate: approved_stable_cutover
+  policy: delete_only_after_approved_stable_cutover
+  entries:
+    - path: packages/cli/src/migrate/v2HandoffManifest.ts
+      responsibility: tracked_v2_handoff_preflight
+    - path: packages/cli/src/upgrade/appContentRefresh.ts
+      responsibility: v2_managed_app_content_refresh
+    - path: packages/cli/src/upgrade/compatibility.ts
+      responsibility: v2_install_classification
+    - path: packages/cli/src/upgrade/installedHooksRetirement.ts
+      responsibility: installed_v2_hook_retirement
+    - path: packages/cli/src/upgrade/legacyAgentCleanup.ts
+      responsibility: v2_native_agent_retirement
+    - path: packages/cli/src/upgrade/migrateArtifactsV2ToV3.ts
+      responsibility: v2_project_artifact_migration
+    - path: packages/cli/src/upgrade/runtimeMigration.ts
+      responsibility: v2_native_hook_retirement
+    - path: packages/cli/src/upgrade/versionResolution.ts
+      responsibility: cross_major_v2_upgrade_resolution
+    - path: packages/cli/shim/lib/exec.mjs
+      responsibility: v2_shim_handoff
+    - path: packages/cli/test/upgrade/fixtures/v2-*
+      responsibility: v2_migration_fixtures