agentera 3.0.0-dev.25 → 3.0.0-dev.27
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.md +29 -23
- package/bundle/CHANGELOG.md +18 -25
- package/bundle/README.md +13 -34
- package/bundle/UPGRADE.md +71 -165
- package/bundle/references/adapters/package-manifest-interface-model.yaml +40 -241
- package/bundle/references/adapters/package-registry.yaml +0 -145
- package/bundle/references/adapters/package-surface-characterization.md +22 -42
- package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +5 -219
- package/bundle/references/adapters/runtime-lifecycle-authority.yaml +2 -29
- package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +1 -1
- package/bundle/references/analysis/analytics-boundary-proportional-2026-07-20.yaml +74 -0
- package/bundle/references/analysis/benchmark.md +11 -0
- package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-1.json.gz +0 -0
- package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-2.json.gz +0 -0
- package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-3.json.gz +0 -0
- package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-1.json.gz +0 -0
- package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-2.json.gz +0 -0
- package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-3.json.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli-route.log.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli.log.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-documentation.log.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/recompute.mjs +98 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-1.json.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-2.json.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-3.json.gz +0 -0
- package/bundle/references/analysis/migration-pagination-proportional-2026-07-20.yaml +64 -0
- package/bundle/references/analysis/verification-baseline-2026-07-20.yaml +313 -0
- package/bundle/references/analysis/verification-final-proof-2026-07-21.yaml +340 -0
- package/bundle/references/analysis/verification-policy.yaml +142 -0
- package/bundle/references/analysis/worker-policy-2026-07-21.yaml +207 -0
- package/bundle/references/artifacts/state-storage-authority.yaml +48 -448
- package/bundle/references/cli/agent-ready-state-contract.yaml +9 -9
- package/bundle/references/cli/app-lifecycle-vocabulary.yaml +3 -4
- package/bundle/references/cli/bundle-skill-vocabulary.yaml +9 -18
- package/bundle/references/cli/capability-tool-classification.yaml +2 -2
- package/bundle/references/cli/prime-consumer-compatibility.yaml +86 -112
- package/bundle/references/cli/routing-execution-vocabulary.yaml +4 -22
- package/bundle/references/cli/upgrade-repair-wording.md +8 -28
- package/bundle/references/cli/v3-handoff-manifest.schema.yaml +2 -3
- package/bundle/references/cli/vocabulary.md +18 -23
- package/bundle/references/meta/documentation-inventory.md +3 -1
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +3 -2
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/exit.yaml +1 -1
- package/bundle/skills/agentera/schemas/artifacts/docs.yaml +3 -11
- package/bundle/skills/agentera/schemas/artifacts/plan.yaml +23 -5
- package/dist/analytics/extractCorpus/cli.js.map +1 -1
- package/dist/analytics/extractCorpus/copilotSessions.js.map +1 -1
- package/dist/analytics/extractCorpus/core.js.map +1 -1
- package/dist/analytics/extractCorpus/corpus.js.map +1 -1
- package/dist/analytics/extractCorpus/coverageAudit.js.map +1 -1
- package/dist/analytics/extractCorpus/cursorSessions.js.map +1 -1
- package/dist/analytics/extractCorpus/evidenceTiers.js.map +1 -1
- package/dist/analytics/extractCorpus/extractCorpusParity.js +1 -1
- package/dist/analytics/extractCorpus/extractCorpusParity.js.map +1 -1
- package/dist/analytics/extractCorpus/filesystemSources.js.map +1 -1
- package/dist/analytics/extractCorpus/index.js.map +1 -1
- package/dist/analytics/extractCorpus/jsonlSessions.js.map +1 -1
- package/dist/analytics/extractCorpus/sqliteCaps.js.map +1 -1
- package/dist/analytics/extractCorpus/sqliteSessions.js.map +1 -1
- package/dist/analytics/extractCorpus/tierReader.js.map +1 -1
- package/dist/analytics/extractCorpus.js.map +1 -1
- package/dist/analytics/profileSignals.js.map +1 -1
- package/dist/analytics/usageStats.js.map +1 -1
- package/dist/bin/agentera.js.map +1 -1
- package/dist/capabilities/audit/instructions.js.map +1 -1
- package/dist/capabilities/build/instructions.js.map +1 -1
- package/dist/capabilities/design/instructions.js.map +1 -1
- package/dist/capabilities/discuss/instructions.js.map +1 -1
- package/dist/capabilities/document/instructions.js.map +1 -1
- package/dist/capabilities/index.js.map +1 -1
- package/dist/capabilities/optimize/instructions.js.map +1 -1
- package/dist/capabilities/orchestrate/instructions.js +1 -1
- package/dist/capabilities/orchestrate/instructions.js.map +1 -1
- package/dist/capabilities/plan/instructions.js.map +1 -1
- package/dist/capabilities/profile/instructions.js.map +1 -1
- package/dist/capabilities/research/instructions.js.map +1 -1
- package/dist/capabilities/status/instructions.js.map +1 -1
- package/dist/capabilities/status/startupInstructions.js.map +1 -1
- package/dist/capabilities/vision/instructions.js.map +1 -1
- package/dist/cli/appContext.js.map +1 -1
- package/dist/cli/argvalidate.js.map +1 -1
- package/dist/cli/capabilityContext/benchmark.js.map +1 -1
- package/dist/cli/capabilityContext/bespoke.js +8 -2
- package/dist/cli/capabilityContext/bespoke.js.map +1 -1
- package/dist/cli/capabilityContext/build.js.map +1 -1
- package/dist/cli/capabilityContext/closeout.js +3 -3
- package/dist/cli/capabilityContext/closeout.js.map +1 -1
- package/dist/cli/capabilityContext/contract.js.map +1 -1
- package/dist/cli/capabilityContext/evidence.js +52 -40
- package/dist/cli/capabilityContext/evidence.js.map +1 -1
- package/dist/cli/capabilityContext/index.js.map +1 -1
- package/dist/cli/capabilityContext/orchestration.js +15 -5
- package/dist/cli/capabilityContext/orchestration.js.map +1 -1
- package/dist/cli/capabilityContext/planState.js +1 -1
- package/dist/cli/capabilityContext/planState.js.map +1 -1
- package/dist/cli/capabilityContext/progress.js.map +1 -1
- package/dist/cli/capabilityContext/shared.js.map +1 -1
- package/dist/cli/capabilityContext/slim.js +16 -3
- package/dist/cli/capabilityContext/slim.js.map +1 -1
- package/dist/cli/capabilityContext/startup.js +4 -1
- package/dist/cli/capabilityContext/startup.js.map +1 -1
- package/dist/cli/capabilityContext/types.js.map +1 -1
- package/dist/cli/capabilityContext.js.map +1 -1
- package/dist/cli/commands/appHome.js.map +1 -1
- package/dist/cli/commands/capability.js.map +1 -1
- package/dist/cli/commands/compact.js.map +1 -1
- package/dist/cli/commands/doctor.js +6 -64
- package/dist/cli/commands/doctor.js.map +1 -1
- package/dist/cli/commands/durability.js +12 -48
- package/dist/cli/commands/durability.js.map +1 -1
- package/dist/cli/commands/entityMigrate.js.map +1 -1
- package/dist/cli/commands/lint.js.map +1 -1
- package/dist/cli/commands/prime/briefOrientation.js +25 -24
- package/dist/cli/commands/prime/briefOrientation.js.map +1 -1
- package/dist/cli/commands/prime/bundleStatus.js +8 -2
- package/dist/cli/commands/prime/bundleStatus.js.map +1 -1
- package/dist/cli/commands/prime/collectEntityOrientation.js +76 -24
- package/dist/cli/commands/prime/collectEntityOrientation.js.map +1 -1
- package/dist/cli/commands/prime/collectOrientationState.js +34 -53
- package/dist/cli/commands/prime/collectOrientationState.js.map +1 -1
- package/dist/cli/commands/prime/orientationOutput.js +9 -14
- package/dist/cli/commands/prime/orientationOutput.js.map +1 -1
- package/dist/cli/commands/prime/types.js.map +1 -1
- package/dist/cli/commands/prime/v1Migration.js.map +1 -1
- package/dist/cli/commands/prime.js +43 -25
- package/dist/cli/commands/prime.js.map +1 -1
- package/dist/cli/commands/query.js +17 -49
- package/dist/cli/commands/query.js.map +1 -1
- package/dist/cli/commands/report.js.map +1 -1
- package/dist/cli/commands/schema.js +19 -78
- package/dist/cli/commands/schema.js.map +1 -1
- package/dist/cli/commands/state/decisions.js +11 -57
- package/dist/cli/commands/state/decisions.js.map +1 -1
- package/dist/cli/commands/state/docs.js +56 -120
- package/dist/cli/commands/state/docs.js.map +1 -1
- package/dist/cli/commands/state/experimentRecords.js +22 -121
- package/dist/cli/commands/state/experimentRecords.js.map +1 -1
- package/dist/cli/commands/state/experiments.js +9 -75
- package/dist/cli/commands/state/experiments.js.map +1 -1
- package/dist/cli/commands/state/get.js +62 -143
- package/dist/cli/commands/state/get.js.map +1 -1
- package/dist/cli/commands/state/health.js +9 -123
- package/dist/cli/commands/state/health.js.map +1 -1
- package/dist/cli/commands/state/index.js +2 -2
- package/dist/cli/commands/state/index.js.map +1 -1
- package/dist/cli/commands/state/list.js +20 -36
- package/dist/cli/commands/state/list.js.map +1 -1
- package/dist/cli/commands/state/objective.js +19 -86
- package/dist/cli/commands/state/objective.js.map +1 -1
- package/dist/cli/commands/state/plan.js +9 -388
- package/dist/cli/commands/state/plan.js.map +1 -1
- package/dist/cli/commands/state/planTasks.js +58 -93
- package/dist/cli/commands/state/planTasks.js.map +1 -1
- package/dist/cli/commands/state/plans.js +13 -40
- package/dist/cli/commands/state/plans.js.map +1 -1
- package/dist/cli/commands/state/progress.js +10 -55
- package/dist/cli/commands/state/progress.js.map +1 -1
- package/dist/cli/commands/state/shared.js.map +1 -1
- package/dist/cli/commands/state/todo.js +24 -133
- package/dist/cli/commands/state/todo.js.map +1 -1
- package/dist/cli/commands/state/write.js +13 -35
- package/dist/cli/commands/state/write.js.map +1 -1
- package/dist/cli/commands/upgrade.js +48 -18
- package/dist/cli/commands/upgrade.js.map +1 -1
- package/dist/cli/commands/upgradeVerify.js +21 -15
- package/dist/cli/commands/upgradeVerify.js.map +1 -1
- package/dist/cli/commands/validate.js +1 -9
- package/dist/cli/commands/validate.js.map +1 -1
- package/dist/cli/commands/verify.js.map +1 -1
- package/dist/cli/contracts/bundleStatus.js.map +1 -1
- package/dist/cli/contracts/orientationState.js.map +1 -1
- package/dist/cli/dispatch/argvParser.js.map +1 -1
- package/dist/cli/dispatch/check.js +5 -12
- package/dist/cli/dispatch/check.js.map +1 -1
- package/dist/cli/dispatch/commands.js.map +1 -1
- package/dist/cli/dispatch/index.js +30 -29
- package/dist/cli/dispatch/index.js.map +1 -1
- package/dist/cli/dispatch/lifecycle.js +23 -40
- package/dist/cli/dispatch/lifecycle.js.map +1 -1
- package/dist/cli/dispatch/prime.js.map +1 -1
- package/dist/cli/dispatch/shared.js.map +1 -1
- package/dist/cli/dispatch/state.js.map +1 -1
- package/dist/cli/dispatch.js.map +1 -1
- package/dist/cli/errors.js.map +1 -1
- package/dist/cli/help.js +20 -100
- package/dist/cli/help.js.map +1 -1
- package/dist/cli/migrationRequired.js +22 -19
- package/dist/cli/migrationRequired.js.map +1 -1
- package/dist/cli/orientation/attention.js +1 -97
- package/dist/cli/orientation/attention.js.map +1 -1
- package/dist/cli/orientation/corpusCoverage.js.map +1 -1
- package/dist/cli/orientation.js +18 -4
- package/dist/cli/orientation.js.map +1 -1
- package/dist/cli/planArtifacts.js.map +1 -1
- package/dist/cli/planEvidence.js.map +1 -1
- package/dist/cli/planLifecycleState.js.map +1 -1
- package/dist/cli/planTaskIndex.js +12 -0
- package/dist/cli/planTaskIndex.js.map +1 -0
- package/dist/cli/prime-blob.js +1 -1
- package/dist/cli/prime-blob.js.map +1 -1
- package/dist/cli/startupCompletenessContract.js.map +1 -1
- package/dist/cli/stateQuery.js +1 -2
- package/dist/cli/stateQuery.js.map +1 -1
- package/dist/cli/structured.js.map +1 -1
- package/dist/cli/todoMarkdown.js.map +1 -1
- package/dist/cli/todoSeverity.js.map +1 -1
- package/dist/core/atomicWriter.js.map +1 -1
- package/dist/core/difflib.js.map +1 -1
- package/dist/core/envPaths.js.map +1 -1
- package/dist/core/jsonValue.js.map +1 -1
- package/dist/core/paths.js.map +1 -1
- package/dist/core/pyjson.js.map +1 -1
- package/dist/core/skillIdentity.js +24 -0
- package/dist/core/skillIdentity.js.map +1 -0
- package/dist/core/sourceRoot.js.map +1 -1
- package/dist/core/text.js.map +1 -1
- package/dist/core/toml.js.map +1 -1
- package/dist/core/yaml.js.map +1 -1
- package/dist/eval/evalSkills.js.map +1 -1
- package/dist/eval/semanticEval.js.map +1 -1
- package/dist/eval/semanticFixtures.js.map +1 -1
- package/dist/hooks/common.js +1 -1
- package/dist/hooks/common.js.map +1 -1
- package/dist/hooks/compaction/apply.js.map +1 -1
- package/dist/hooks/compaction/dryRun.js.map +1 -1
- package/dist/hooks/compaction/index.js.map +1 -1
- package/dist/hooks/compaction/parse.js.map +1 -1
- package/dist/hooks/compaction/retention.js.map +1 -1
- package/dist/hooks/compaction/status.js +2 -1
- package/dist/hooks/compaction/status.js.map +1 -1
- package/dist/hooks/compaction/types.js.map +1 -1
- package/dist/hooks/cursorPreToolUse.js.map +1 -1
- package/dist/hooks/cursorSessionStart.js +4 -25
- package/dist/hooks/cursorSessionStart.js.map +1 -1
- package/dist/hooks/projectHookInput.js +26 -0
- package/dist/hooks/projectHookInput.js.map +1 -0
- package/dist/hooks/sessionStart.js +23 -239
- package/dist/hooks/sessionStart.js.map +1 -1
- package/dist/hooks/sessionStop.js +4 -12
- package/dist/hooks/sessionStop.js.map +1 -1
- package/dist/hooks/validateArtifact/agentFacing.js.map +1 -1
- package/dist/hooks/validateArtifact/index.js.map +1 -1
- package/dist/hooks/validateArtifact/markdown.js.map +1 -1
- package/dist/hooks/validateArtifact/runtime.js.map +1 -1
- package/dist/hooks/validateArtifact/schema.js.map +1 -1
- package/dist/hooks/validateArtifact/traversal.js +1 -1
- package/dist/hooks/validateArtifact/traversal.js.map +1 -1
- package/dist/hooks/validateArtifact/violations.js.map +1 -1
- package/dist/migrate/v2HandoffManifest.js.map +1 -1
- package/dist/registries/artifactProtocolIds.js.map +1 -1
- package/dist/registries/artifactRegistry.js +2 -1
- package/dist/registries/artifactRegistry.js.map +1 -1
- package/dist/registries/capabilityContract.js.map +1 -1
- package/dist/registries/evaluatorHandoffContract.js.map +1 -1
- package/dist/registries/evidenceTierContract.js.map +1 -1
- package/dist/registries/packageRegistry.js +57 -231
- package/dist/registries/packageRegistry.js.map +1 -1
- package/dist/registries/triggerLoader.js.map +1 -1
- package/dist/registries/verbosityBudgetContract.js.map +1 -1
- package/dist/release/releaseMetadata.js +1 -13
- package/dist/release/releaseMetadata.js.map +1 -1
- package/dist/runtime/lifecycleAdapterContract.js +4 -4
- package/dist/runtime/lifecycleAdapterContract.js.map +1 -1
- package/dist/runtime/lifecycleAdapters.js +14 -2
- package/dist/runtime/lifecycleAdapters.js.map +1 -1
- package/dist/runtime/lifecycleAuthority.js +5 -43
- package/dist/runtime/lifecycleAuthority.js.map +1 -1
- package/dist/runtime/lifecycleOperationContract.js +3 -2
- package/dist/runtime/lifecycleOperationContract.js.map +1 -1
- package/dist/runtime/lifecycleOperations.js.map +1 -1
- package/dist/runtime/lifecycleOwnershipJournal.js.map +1 -1
- package/dist/runtime/lifecyclePublication.js +21 -0
- package/dist/runtime/lifecyclePublication.js.map +1 -1
- package/dist/runtime/lifecycleSnapshot.js.map +1 -1
- package/dist/runtime/retiredRuntimeCleanup.js.map +1 -1
- package/dist/setup/codex/agents.js.map +1 -1
- package/dist/setup/codex/cli.js.map +1 -1
- package/dist/setup/codex/configToml.js.map +1 -1
- package/dist/setup/codex/constants.js.map +1 -1
- package/dist/setup/codex/installRoot.js.map +1 -1
- package/dist/setup/codex/state.js.map +1 -1
- package/dist/setup/codex.js.map +1 -1
- package/dist/setup/opencode.js +20 -12
- package/dist/setup/opencode.js.map +1 -1
- package/dist/setup/opencodeConstants.js.map +1 -1
- package/dist/setup/sharedSkill.js +46 -0
- package/dist/setup/sharedSkill.js.map +1 -0
- package/dist/setup/smokeChecks.js +16 -43
- package/dist/setup/smokeChecks.js.map +1 -1
- package/dist/state/archiveDiscovery.js.map +1 -1
- package/dist/state/archivePublication.js.map +1 -1
- package/dist/state/archiveRecovery.js.map +1 -1
- package/dist/state/archiveReplay.js.map +1 -1
- package/dist/state/decisionEntities.js +7 -4
- package/dist/state/decisionEntities.js.map +1 -1
- package/dist/state/decisionLegacyValidation.js.map +1 -1
- package/dist/state/decisionOverlay.js.map +1 -1
- package/dist/state/decisionRevision.js.map +1 -1
- package/dist/state/decisionRevisionPublication.js.map +1 -1
- package/dist/state/directRetrieval.js.map +1 -1
- package/dist/state/durability.js +4 -240
- package/dist/state/durability.js.map +1 -1
- package/dist/state/entityCutover.js +90 -186
- package/dist/state/entityCutover.js.map +1 -1
- package/dist/state/entityCutoverGit.js.map +1 -1
- package/dist/state/entityMigrationPreview.js +3 -3
- package/dist/state/entityMigrationPreview.js.map +1 -1
- package/dist/state/entityPublicationContext.js.map +1 -1
- package/dist/state/entityStorage.js +49 -10
- package/dist/state/entityStorage.js.map +1 -1
- package/dist/state/experimentArchive.js.map +1 -1
- package/dist/state/experimentIdentity.js.map +1 -1
- package/dist/state/experimentRetrieval.js.map +1 -1
- package/dist/state/healthEntities.js +7 -4
- package/dist/state/healthEntities.js.map +1 -1
- package/dist/state/healthEntityValidation.js.map +1 -1
- package/dist/state/healthRepair.js.map +1 -1
- package/dist/state/installRoot.js.map +1 -1
- package/dist/state/legacyEntityCutoverEvidence.js.map +1 -1
- package/dist/state/legacyIdentity.js.map +1 -1
- package/dist/state/listAccounting.js.map +1 -1
- package/dist/state/listClassification.js.map +1 -1
- package/dist/state/listRetrieval.js.map +1 -1
- package/dist/state/objectiveExperimentEntities.js +7 -5
- package/dist/state/objectiveExperimentEntities.js.map +1 -1
- package/dist/state/planEntities.js +60 -12
- package/dist/state/planEntities.js.map +1 -1
- package/dist/state/planIdentity.js.map +1 -1
- package/dist/state/planRetrieval.js.map +1 -1
- package/dist/state/planTaskRetrieval.js.map +1 -1
- package/dist/state/progressEntities.js +4 -2
- package/dist/state/progressEntities.js.map +1 -1
- package/dist/state/projectRoot.js.map +1 -1
- package/dist/state/projectionPolicy.js.map +1 -1
- package/dist/state/retrievalAuthority.js.map +1 -1
- package/dist/state/safeProjectFile.js.map +1 -1
- package/dist/state/startupAnalysis/benchmark.js.map +1 -1
- package/dist/state/startupAnalysis/contract.js.map +1 -1
- package/dist/state/startupAnalysis/helpers.js.map +1 -1
- package/dist/state/startupAnalysis/index.js.map +1 -1
- package/dist/state/startupAnalysis/metrics.js.map +1 -1
- package/dist/state/startupAnalysis/records.js.map +1 -1
- package/dist/state/startupAnalysis/report.js.map +1 -1
- package/dist/state/startupAnalysis/threshold.js.map +1 -1
- package/dist/state/startupAnalysis.js.map +1 -1
- package/dist/state/startupProjection.js +5 -3
- package/dist/state/startupProjection.js.map +1 -1
- package/dist/state/stateMode.js +7 -0
- package/dist/state/stateMode.js.map +1 -1
- package/dist/state/todoDocsEntities.js +6 -4
- package/dist/state/todoDocsEntities.js.map +1 -1
- package/dist/state/todoDocsEntityValidation.js.map +1 -1
- package/dist/state/write/assign.js.map +1 -1
- package/dist/state/write/candidateMutation.js.map +1 -1
- package/dist/state/write/errors.js.map +1 -1
- package/dist/state/write/experimentPublication.js.map +1 -1
- package/dist/state/write/explain.js +10 -12
- package/dist/state/write/explain.js.map +1 -1
- package/dist/state/write/fields.js.map +1 -1
- package/dist/state/write/helpers.js.map +1 -1
- package/dist/state/write/index.js.map +1 -1
- package/dist/state/write/input.js.map +1 -1
- package/dist/state/write/lock.js.map +1 -1
- package/dist/state/write/mutation.js.map +1 -1
- package/dist/state/write/operations.js +6 -0
- package/dist/state/write/operations.js.map +1 -1
- package/dist/state/write/planEvaluation.js +19 -5
- package/dist/state/write/planEvaluation.js.map +1 -1
- package/dist/state/write/planPublication.js +7 -0
- package/dist/state/write/planPublication.js.map +1 -1
- package/dist/state/write/serialize.js.map +1 -1
- package/dist/state/write/transaction.js +23 -532
- package/dist/state/write/transaction.js.map +1 -1
- package/dist/state/write/validate.js.map +1 -1
- package/dist/upgrade/appContentRefresh.js +54 -44
- package/dist/upgrade/appContentRefresh.js.map +1 -1
- package/dist/upgrade/appModel.js.map +1 -1
- package/dist/upgrade/atomicWriter.js.map +1 -1
- package/dist/upgrade/bundleEvidence.js.map +1 -1
- package/dist/upgrade/channels.js.map +1 -1
- package/dist/upgrade/coexistenceProbe.js.map +1 -1
- package/dist/upgrade/compatibility.js.map +1 -1
- package/dist/upgrade/doctor.js +5 -1
- package/dist/upgrade/doctor.js.map +1 -1
- package/dist/upgrade/doctorClassifier.js.map +1 -1
- package/dist/upgrade/installedHooksRetirement.js +46 -39
- package/dist/upgrade/installedHooksRetirement.js.map +1 -1
- package/dist/upgrade/legacyAgentCleanup.js +132 -32
- package/dist/upgrade/legacyAgentCleanup.js.map +1 -1
- package/dist/upgrade/lifecycleUpgrade.js +65 -378
- package/dist/upgrade/lifecycleUpgrade.js.map +1 -1
- package/dist/upgrade/migrateArtifactsV2ToV3.js +151 -52
- package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -1
- package/dist/upgrade/migrationPublication.js +123 -0
- package/dist/upgrade/migrationPublication.js.map +1 -0
- package/dist/upgrade/nextMajorDoctor.js.map +1 -1
- package/dist/upgrade/npxPlatformStatus.js.map +1 -1
- package/dist/upgrade/projectIntegration.js +46 -113
- package/dist/upgrade/projectIntegration.js.map +1 -1
- package/dist/upgrade/projectIntegrationDecision.js +6 -96
- package/dist/upgrade/projectIntegrationDecision.js.map +1 -1
- package/dist/upgrade/runtimeMigration.js +222 -402
- package/dist/upgrade/runtimeMigration.js.map +1 -1
- package/dist/upgrade/upgradeCommands.js +5 -4
- package/dist/upgrade/upgradeCommands.js.map +1 -1
- package/dist/upgrade/upgradeLock.js +73 -41
- package/dist/upgrade/upgradeLock.js.map +1 -1
- package/dist/upgrade/upgradeOrchestrator.js +91 -158
- package/dist/upgrade/upgradeOrchestrator.js.map +1 -1
- package/dist/upgrade/v3CapabilitySurface.js +2 -2
- package/dist/upgrade/v3CapabilitySurface.js.map +1 -1
- package/dist/upgrade/versionResolution.js.map +1 -1
- package/dist/validate/appHomeContract.js +0 -4
- package/dist/validate/appHomeContract.js.map +1 -1
- package/dist/validate/capability.js.map +1 -1
- package/dist/validate/crossCapability.js.map +1 -1
- package/dist/validate/selfAudit.js.map +1 -1
- package/dist/validate/vocabularyAuthority.js.map +1 -1
- package/package.json +23 -8
- package/bundle/.codex-plugin/plugin.json +0 -92
- package/bundle/.cursor/agents/agentera.md +0 -7
- package/bundle/.cursor/hooks.json +0 -32
- package/bundle/.cursor-plugin/plugin.json +0 -34
- package/bundle/.github/hooks/postToolUse.json +0 -9
- package/bundle/.github/hooks/preToolUse.json +0 -8
- package/bundle/.github/hooks/sessionEnd.json +0 -8
- package/bundle/.github/hooks/sessionStart.json +0 -8
- package/bundle/.github/plugin/plugin.json +0 -7
- package/bundle/.opencode/agents/agentera.md +0 -12
- package/bundle/.opencode/commands/agentera.md +0 -5
- package/bundle/.opencode/package.json +0 -31
- package/bundle/.opencode/plugins/agentera.js +0 -820
- package/bundle/agents/openai.yaml +0 -87
- package/bundle/hooks/codex-hooks.json +0 -31
- package/bundle/hooks/codex-plugin-hooks.json +0 -31
- package/bundle/plugin.json +0 -13
- package/bundle/references/adapters/cursor.md +0 -224
- package/bundle/references/adapters/opencode.md +0 -529
- package/bundle/references/adapters/runtime-adapter-characterization.md +0 -44
- package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
- package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -387
- package/bundle/references/adapters/runtime-feature-parity.md +0 -129
- package/dist/cli/commands/backfill.js +0 -231
- package/dist/cli/commands/backfill.js.map +0 -1
- package/dist/cli/commands/migrate.js +0 -681
- package/dist/cli/commands/migrate.js.map +0 -1
- package/dist/registries/runtimeAdapterRegistry.js +0 -324
- package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
- package/dist/setup/copilot.js +0 -227
- package/dist/setup/copilot.js.map +0 -1
- package/dist/setup/cursor.js +0 -129
- package/dist/setup/cursor.js.map +0 -1
- package/dist/setup/cursorSurfaces.js +0 -67
- package/dist/setup/cursorSurfaces.js.map +0 -1
- package/dist/setup/doctor/core.js +0 -296
- package/dist/setup/doctor/core.js.map +0 -1
- package/dist/setup/doctor/diagnostics.js +0 -201
- package/dist/setup/doctor/diagnostics.js.map +0 -1
- package/dist/setup/doctor/opencode.js +0 -301
- package/dist/setup/doctor/opencode.js.map +0 -1
- package/dist/setup/doctor/report.js +0 -425
- package/dist/setup/doctor/report.js.map +0 -1
- package/dist/setup/doctor.js +0 -10
- package/dist/setup/doctor.js.map +0 -1
- package/dist/state/gitBackfill.js +0 -561
- package/dist/state/gitBackfill.js.map +0 -1
- package/dist/state/gitBackfillAuthority.js +0 -141
- package/dist/state/gitBackfillAuthority.js.map +0 -1
- package/dist/state/gitBackfillHistory.js +0 -278
- package/dist/state/gitBackfillHistory.js.map +0 -1
- package/dist/state/gitBackfillOutput.js +0 -209
- package/dist/state/gitBackfillOutput.js.map +0 -1
- package/dist/state/legacyMigration.js +0 -516
- package/dist/state/legacyMigration.js.map +0 -1
- package/dist/state/legacyMigrationParser.js +0 -489
- package/dist/state/legacyMigrationParser.js.map +0 -1
- package/dist/state/migrationAuthority.js +0 -413
- package/dist/state/migrationAuthority.js.map +0 -1
- package/dist/state/migrationEnrichment.js +0 -35
- package/dist/state/migrationEnrichment.js.map +0 -1
- package/dist/state/projectionRecovery.js +0 -458
- package/dist/state/projectionRecovery.js.map +0 -1
- package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -568
- package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
- package/dist/validate/lifecycleAdapters/legacyPythonParity.js +0 -93
- package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +0 -1
- package/dist/validate/lifecycleAdapters/lifecycleMain.js +0 -154
- package/dist/validate/lifecycleAdapters/lifecycleMain.js.map +0 -1
- package/dist/validate/lifecycleAdapters/nodeFormChecks.js +0 -481
- package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +0 -1
- package/dist/validate/lifecycleAdapters/shared.js +0 -198
- package/dist/validate/lifecycleAdapters/shared.js.map +0 -1
- package/dist/validate/lifecycleAdapters.js +0 -10
- package/dist/validate/lifecycleAdapters.js.map +0 -1
|
@@ -12,7 +12,7 @@ scope:
|
|
|
12
12
|
includes:
|
|
13
13
|
- Current user-facing and diagnostic prose that names Agentera app files.
|
|
14
14
|
- Package and distribution metadata that names the suite package shape.
|
|
15
|
-
-
|
|
15
|
+
- Historical classification of retired runtime hook packaging prose and metadata.
|
|
16
16
|
- Historical references to the removed `bundle-status` command.
|
|
17
17
|
- Current references to `skills/agentera/SKILL.md`.
|
|
18
18
|
excludes:
|
|
@@ -52,8 +52,7 @@ canonical_concepts:
|
|
|
52
52
|
suite_package:
|
|
53
53
|
definition: >-
|
|
54
54
|
The packaged distribution shape that ships the Agentera skill, CLI,
|
|
55
|
-
|
|
56
|
-
one suite artifact.
|
|
55
|
+
references, and package metadata as one suite artifact.
|
|
57
56
|
allowed_terms:
|
|
58
57
|
- suite package
|
|
59
58
|
- Agentera package
|
|
@@ -63,10 +62,10 @@ canonical_concepts:
|
|
|
63
62
|
- bundle
|
|
64
63
|
- single-bundle model
|
|
65
64
|
- bundled suite
|
|
66
|
-
|
|
65
|
+
retired_plugin_shipped_hooks:
|
|
67
66
|
definition: >-
|
|
68
|
-
|
|
69
|
-
|
|
67
|
+
Historical term for hooks shipped by retired v2 host-native packages.
|
|
68
|
+
Current Agentera packages ship no host-native hooks or plugin metadata.
|
|
70
69
|
allowed_terms:
|
|
71
70
|
- plugin-shipped hooks
|
|
72
71
|
- plugin-bundled hooks
|
|
@@ -155,6 +154,7 @@ focused_scan:
|
|
|
155
154
|
allowed_classifications:
|
|
156
155
|
- canonical
|
|
157
156
|
- compatibility-preserved
|
|
157
|
+
- migration-only
|
|
158
158
|
- historical
|
|
159
159
|
- fixture-only
|
|
160
160
|
- generic
|
|
@@ -162,7 +162,6 @@ focused_scan:
|
|
|
162
162
|
- AGENTS.md
|
|
163
163
|
- README.md
|
|
164
164
|
- references/cli/vocabulary.md
|
|
165
|
-
- references/adapters/opencode.md
|
|
166
165
|
- (retired maintainer measurement tool)
|
|
167
166
|
- skills/agentera/SKILL.md
|
|
168
167
|
- skills/agentera/capabilities/hej/schemas/triggers.yaml
|
|
@@ -193,16 +192,8 @@ focused_scan:
|
|
|
193
192
|
reason: Vocabulary docs use concrete skill entry file paths and source-index references.
|
|
194
193
|
- path: ^references/cli/vocabulary\.md$
|
|
195
194
|
text: --only bundle|\.agentera-bundle\.json|bundle\.status|activeBundleRoot|bundle-status
|
|
196
|
-
classification:
|
|
197
|
-
reason: Vocabulary docs
|
|
198
|
-
- path: ^references/adapters/opencode\.md$
|
|
199
|
-
text: bundled Agentera dashboard path|bundled `agentera` skill|bundled Agentera
|
|
200
|
-
classification: generic
|
|
201
|
-
reason: OpenCode adapter prose uses bundled in the ordinary package-shipping sense, not as Agentera app-file terminology.
|
|
202
|
-
- path: ^references/adapters/opencode\.md$
|
|
203
|
-
text: SKILL\.md files|<name>/SKILL\.md|skills/\*/SKILL\.md|skills/agentera/SKILL\.md
|
|
204
|
-
classification: compatibility-preserved
|
|
205
|
-
reason: OpenCode adapter prose documents concrete runtime skill entry file paths.
|
|
195
|
+
classification: migration-only
|
|
196
|
+
reason: Vocabulary docs classify retired v2 identifiers for migration evidence and released history only.
|
|
206
197
|
- path: ^scripts/measure_token_payload\.py$
|
|
207
198
|
text: 'v1 baseline: all 12 v1 SKILL\.md files|skill_root / "SKILL\.md"'
|
|
208
199
|
classification: historical
|
|
@@ -223,7 +214,7 @@ focused_scan:
|
|
|
223
214
|
text: .
|
|
224
215
|
classification: fixture-only
|
|
225
216
|
reason: Runtime adapter tests use fixture paths, expected diagnostics, package metadata, and compatibility test class names.
|
|
226
|
-
|
|
217
|
+
migration_identifiers:
|
|
227
218
|
bundle:
|
|
228
219
|
- .agentera-bundle.json
|
|
229
220
|
- bundle.status
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Capability tool classification authority
|
|
2
2
|
# Defines which tools each capability subagent needs to fulfill its purpose.
|
|
3
|
-
# Consumed by
|
|
4
|
-
#
|
|
3
|
+
# Consumed by shared-skill worker metadata validation and regression tests.
|
|
4
|
+
# Hosts provide and enforce their own tool surfaces; Agentera ships no native adapter.
|
|
5
5
|
|
|
6
6
|
classification:
|
|
7
7
|
mutation_capable:
|
|
@@ -22,34 +22,6 @@ exclusions:
|
|
|
22
22
|
# Tasks 2-4 MUST keep every consumed field resolvable from a declared surface.
|
|
23
23
|
# ---------------------------------------------------------------------------
|
|
24
24
|
consumers:
|
|
25
|
-
- id: opencode_compaction_context
|
|
26
|
-
startup_command: agentera prime --format json
|
|
27
|
-
evidence: .opencode/plugins/agentera.js:502-517
|
|
28
|
-
consumed_fields:
|
|
29
|
-
- mode
|
|
30
|
-
- profile.status
|
|
31
|
-
- profile
|
|
32
|
-
- health.grade
|
|
33
|
-
- health.trajectory
|
|
34
|
-
- health
|
|
35
|
-
- issues
|
|
36
|
-
- plan
|
|
37
|
-
- plan.exists
|
|
38
|
-
- plan.status
|
|
39
|
-
- plan.title
|
|
40
|
-
- plan.first_pending.name
|
|
41
|
-
- progress
|
|
42
|
-
- progress.latest
|
|
43
|
-
- progress.latest.id
|
|
44
|
-
- progress.latest.what
|
|
45
|
-
- progress.latest.next
|
|
46
|
-
- next_action
|
|
47
|
-
- next_action.object
|
|
48
|
-
- attention
|
|
49
|
-
notes: >-
|
|
50
|
-
Reads the deprecated `issues` alias instead of `todo` (lines 480-486).
|
|
51
|
-
This is the only documented runtime consumer of the deprecated alias, so
|
|
52
|
-
`issues` is transition-required until the stable cut.
|
|
53
25
|
- id: status_dashboard_renderer
|
|
54
26
|
startup_command: agentera prime --context status --format json
|
|
55
27
|
evidence: skills/agentera/SKILL.md:68
|
|
@@ -75,43 +47,35 @@ consumers:
|
|
|
75
47
|
through the named command in the status context, never by raw artifact read.
|
|
76
48
|
- id: capability_context_dispatcher
|
|
77
49
|
startup_command: agentera prime --context <capability> --format json
|
|
78
|
-
evidence:
|
|
79
|
-
|
|
80
|
-
runtime_evidence: packages/cli/src/cli/capabilityContext/startup.ts:250
|
|
50
|
+
evidence: packages/cli/src/cli/capabilityContext/startup.ts:250
|
|
51
|
+
skill_evidence: skills/agentera/SKILL.md:68-103
|
|
81
52
|
consumed_fields:
|
|
82
53
|
- command
|
|
83
54
|
- status
|
|
84
55
|
- capability_context
|
|
85
56
|
- capability_context.instructions
|
|
86
57
|
notes: >-
|
|
87
|
-
Per-capability startup capsule. The
|
|
58
|
+
Per-capability startup capsule. The CLI emits
|
|
88
59
|
`capability_context.instructions` (the capability's instructions module),
|
|
89
|
-
not `prose
|
|
90
|
-
|
|
91
|
-
v3 runtime never emits; they were reconciled to
|
|
92
|
-
`capability_context.instructions` to match
|
|
93
|
-
packages/cli/src/cli/capabilityContext/startup.ts:250 and
|
|
94
|
-
skills/agentera/SKILL.md (lines 68, 103), which already documented
|
|
95
|
-
`capability_context.instructions`. This consumer governs the `--context`
|
|
60
|
+
not `prose`; the shared skill consumes that field directly. This consumer
|
|
61
|
+
governs the `--context`
|
|
96
62
|
surface, not the bare briefing; the bounded decision brief (Task 3) must
|
|
97
63
|
not break the `--context` capsule. Executable fixture proves the emitted
|
|
98
64
|
payload contains `capability_context.instructions` and NOT `prose`.
|
|
99
65
|
- id: packaging_distribution_gate
|
|
100
66
|
startup_command: agentera prime --format json
|
|
101
|
-
evidence:
|
|
67
|
+
evidence: packages/cli/test/packaging/packageVerification.test.ts
|
|
102
68
|
consumed_fields:
|
|
103
69
|
- command
|
|
104
70
|
- status
|
|
105
71
|
- app_home
|
|
106
72
|
- app_home.source
|
|
107
73
|
notes: >-
|
|
108
|
-
Distribution
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
prime JSON shape stable so packaged binaries and fresh-cache npx gates
|
|
114
|
-
keep passing. Not a dashboard consumer; does not read state families.
|
|
74
|
+
Distribution-boundary consumer. The one extracted-package conjunction
|
|
75
|
+
asserts `command: "prime"`, `status: "ok"`, and that `app_home.source`
|
|
76
|
+
reflects resolution after the packed upgrade path. Tasks 2-4 must keep
|
|
77
|
+
the published prime JSON shape stable so fresh-cache npx gates keep
|
|
78
|
+
passing. Not a dashboard consumer; does not read state families.
|
|
115
79
|
- id: json_output_surface_manifest
|
|
116
80
|
startup_command: agentera prime [ --dashboard | --context <capability> ] --format json
|
|
117
81
|
evidence: scripts/json_output_surface_manifest.yaml:47-161
|
|
@@ -136,9 +100,8 @@ consumers:
|
|
|
136
100
|
from the retired `prose` field to the v3 `capability_context.instructions`
|
|
137
101
|
field after the second Task 1 evaluation found this guidance was the one
|
|
138
102
|
remaining live consumer contradiction. Runtime authority
|
|
139
|
-
(capabilityContext/startup.ts:250)
|
|
140
|
-
|
|
141
|
-
all already used `capability_context.instructions`. The
|
|
103
|
+
(capabilityContext/startup.ts:250) and SKILL.md (lines 68, 103) both use
|
|
104
|
+
`capability_context.instructions`. The
|
|
142
105
|
`documentation_drift` guard below prevents this guidance from drifting
|
|
143
106
|
back to `prose`; it does not execute a prime command.
|
|
144
107
|
|
|
@@ -149,12 +112,13 @@ consumers:
|
|
|
149
112
|
# (public_output_policy.canonical_field_set). Each list below now derives from
|
|
150
113
|
# that authority, so schema discovery, the emitted JSON source_contract.fields,
|
|
151
114
|
# the text-mode fields line, and the agent-ready-state contract advertise the
|
|
152
|
-
# same canonical 27-field set. The `issues` deprecated transition
|
|
153
|
-
#
|
|
154
|
-
#
|
|
155
|
-
#
|
|
156
|
-
#
|
|
157
|
-
#
|
|
115
|
+
# same canonical 27-field set. The `issues` deprecated transition field preserves
|
|
116
|
+
# the four legacy severity counts (`critical`, `degraded`, `normal`, `annoying`)
|
|
117
|
+
# with a stderr deprecation warning, but intentionally excludes canonical
|
|
118
|
+
# `todo.detail` so bounded detail is serialized once. It remains until the 3.0.0
|
|
119
|
+
# stable cut and is excluded from the canonical advertised
|
|
120
|
+
# `source_contract.fields` set (`todo` is canonical). It is NOT selector-only: it
|
|
121
|
+
# ships in the default bare briefing as bounded CLI transition compatibility.
|
|
158
122
|
# ---------------------------------------------------------------------------
|
|
159
123
|
field_authorities:
|
|
160
124
|
- id: orientation_output_emission
|
|
@@ -164,9 +128,9 @@ field_authorities:
|
|
|
164
128
|
role: actual_emission_authority
|
|
165
129
|
notes: >-
|
|
166
130
|
Emits PRIME_STRUCTURED_FIELDS as source_contract.fields; the keys actually
|
|
167
|
-
serialized by buildOrientationJsonPayload. `issues`
|
|
168
|
-
|
|
169
|
-
canonical set.
|
|
131
|
+
serialized by buildOrientationJsonPayload. `issues` emits only `todo`'s
|
|
132
|
+
four legacy severity counts with a stderr warning; canonical `todo.detail`
|
|
133
|
+
is not duplicated. `issues` is not a member of the canonical set.
|
|
170
134
|
- id: schema_advertised
|
|
171
135
|
location: packages/cli/src/cli/commands/schema.ts
|
|
172
136
|
authority: packages/cli/src/cli/stateQuery.ts:PRIME_STRUCTURED_FIELDS
|
|
@@ -194,7 +158,7 @@ field_authorities:
|
|
|
194
158
|
notes: >-
|
|
195
159
|
Reconciled by Task 2: both hej.fields lists now mirror the canonical
|
|
196
160
|
27-field set (retired `bundle` dropped; app, app_home, project_integration,
|
|
197
|
-
|
|
161
|
+
shared_skill, project_integration, and history added).
|
|
198
162
|
|
|
199
163
|
# ---------------------------------------------------------------------------
|
|
200
164
|
# Field classification. Every field proposed for omission is classified with a
|
|
@@ -264,8 +228,8 @@ field_classification:
|
|
|
264
228
|
- field: project_integration
|
|
265
229
|
status: required
|
|
266
230
|
rationale: >-
|
|
267
|
-
Status routing consumes the
|
|
268
|
-
|
|
231
|
+
Status routing consumes the app and project-state recommendation; the
|
|
232
|
+
bounded brief retains that routing projection even when no upgrade
|
|
269
233
|
recommendation is active.
|
|
270
234
|
- field: attention
|
|
271
235
|
status: required
|
|
@@ -276,11 +240,9 @@ field_classification:
|
|
|
276
240
|
Startup history. The bounded brief retains counts and named retrieval
|
|
277
241
|
pointers while omitting entry detail; explicit state list/get commands
|
|
278
242
|
recover the current history.
|
|
279
|
-
- field:
|
|
280
|
-
status:
|
|
281
|
-
rationale:
|
|
282
|
-
Diagnostic. Plan constraint: unrelated lifecycle diagnostics are omitted
|
|
283
|
-
unless status declares them necessary for the current brief (Task 4).
|
|
243
|
+
- field: shared_skill
|
|
244
|
+
status: required
|
|
245
|
+
rationale: Canonical shared-skill path and read-only diagnosis.
|
|
284
246
|
- field: decision_attention
|
|
285
247
|
status: conditional
|
|
286
248
|
rationale: Null unless returned decisions require satisfaction review.
|
|
@@ -326,10 +288,11 @@ field_classification:
|
|
|
326
288
|
- field: issues
|
|
327
289
|
status: deprecated_transition
|
|
328
290
|
rationale: >-
|
|
329
|
-
Deprecated
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
the
|
|
291
|
+
Deprecated count-only compatibility projection of `todo`. It preserves
|
|
292
|
+
critical, degraded, normal, and annoying for legacy consumers while
|
|
293
|
+
excluding canonical `todo.detail` to prevent startup payload duplication.
|
|
294
|
+
No current consumer in this inventory reads it; the projection remains
|
|
295
|
+
until its owning contract removes it.
|
|
333
296
|
- field: bundle
|
|
334
297
|
status: retired
|
|
335
298
|
rationale: >-
|
|
@@ -347,9 +310,21 @@ public_output_policy:
|
|
|
347
310
|
authority for the bare prime briefing. Task 2 reconciles schema.ts, the text
|
|
348
311
|
briefing hardcoded list, and agent-ready-state-contract.yaml hej.fields to
|
|
349
312
|
this set, removing the four-way drift documented above.
|
|
350
|
-
deprecated_alias_rule:
|
|
351
|
-
|
|
352
|
-
|
|
313
|
+
deprecated_alias_rule:
|
|
314
|
+
field: issues
|
|
315
|
+
status: retained_until_3_0_0_stable_cut
|
|
316
|
+
retained_fields:
|
|
317
|
+
- critical
|
|
318
|
+
- degraded
|
|
319
|
+
- normal
|
|
320
|
+
- annoying
|
|
321
|
+
excluded_fields:
|
|
322
|
+
- detail
|
|
323
|
+
rationale: >-
|
|
324
|
+
`issues` preserves the four legacy severity counts with a stderr
|
|
325
|
+
deprecation warning. Canonical bounded detail belongs only to `todo.detail`
|
|
326
|
+
and is intentionally excluded to prevent duplicate startup payload. No
|
|
327
|
+
task in this plan may remove the compatibility projection before the cut.
|
|
353
328
|
default_only_omission_rule: >-
|
|
354
329
|
Fields classified conditional or diagnostic may be omitted by Task 2 when
|
|
355
330
|
they are in their default/empty state, provided missing-versus-empty
|
|
@@ -367,17 +342,41 @@ public_output_policy:
|
|
|
367
342
|
Task 4 folds the bounded state into one `agentera prime --context status
|
|
368
343
|
--format json` response (<=25000 bytes) so the status dashboard needs no
|
|
369
344
|
separate bare-prime call or raw artifact read. The `--context` capsule
|
|
370
|
-
contract (command/status/capability_context) is unchanged
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
345
|
+
contract (command/status/capability_context) is unchanged, including
|
|
346
|
+
contract-owned state declarations, inventory, included/missing families,
|
|
347
|
+
schema diagnostics, and first-invocation reads. The status capsule assembles
|
|
348
|
+
and measures that fixed envelope first, then bounds
|
|
349
|
+
`capability_context.context.status_context` to the remaining complete-capsule
|
|
350
|
+
budget. If a projection leaves the complete envelope over budget, the next
|
|
351
|
+
allowance is set one byte below that projection's actual serialized size,
|
|
352
|
+
forcing a strictly smaller bounded form; projection continues monotonically
|
|
353
|
+
until the capsule fits or the routing-preserving irreducible form fails
|
|
354
|
+
explicitly. The status-specific degraded envelope retains TODO
|
|
355
|
+
aggregate/detail recovery, attention, and next_action rather than collapsing
|
|
356
|
+
to non-routing metadata. App/project integration and shared-skill diagnosis
|
|
357
|
+
remain available through the bounded status state while unrelated rich
|
|
358
|
+
copies are omitted.
|
|
375
359
|
status_context_contract:
|
|
376
360
|
startup_command: agentera prime --context status --format json
|
|
377
361
|
state_path: capability_context.context.status_context
|
|
378
362
|
instructions_path: capability_context.instructions
|
|
379
363
|
max_utf8_bytes: 25000
|
|
380
364
|
measurement: Buffer.byteLength(JSON.stringify(payload, null, 2) + "\n", "utf8")
|
|
365
|
+
budget_allocation: >-
|
|
366
|
+
Assemble contract-owned capability metadata, instructions, and context
|
|
367
|
+
keys and measure the complete envelope. When it is over budget, set the
|
|
368
|
+
next status_context allowance one byte below the current nested
|
|
369
|
+
projection's measured serialized size. Every accepted retry is therefore
|
|
370
|
+
strictly smaller; terminate only with a <=25000-byte capsule or explicit
|
|
371
|
+
irreducible routing-envelope failure.
|
|
372
|
+
required_capability_metadata:
|
|
373
|
+
- capability_context.state.declared_read_needs
|
|
374
|
+
- capability_context.state.declared_write_targets
|
|
375
|
+
- capability_context.state.artifact_inventory
|
|
376
|
+
- capability_context.state.included
|
|
377
|
+
- capability_context.state.schema_error
|
|
378
|
+
- capability_context.context.first_invocation_read
|
|
379
|
+
- capability_context.context.schema_error
|
|
381
380
|
required_state:
|
|
382
381
|
- health
|
|
383
382
|
- todo
|
|
@@ -387,6 +386,10 @@ public_output_policy:
|
|
|
387
386
|
- attention
|
|
388
387
|
- state_presence
|
|
389
388
|
- source_contract
|
|
389
|
+
budget_fallback_retains:
|
|
390
|
+
- todo
|
|
391
|
+
- attention
|
|
392
|
+
- next_action
|
|
390
393
|
omitted_detail_recovery: capability_context.context.status_context.brief.omitted_rich_state
|
|
391
394
|
raw_artifact_reads_required: false
|
|
392
395
|
fail_visible_rule: >-
|
|
@@ -474,10 +477,11 @@ default_emission_omission_contract:
|
|
|
474
477
|
only; diagnostics measured separately on stderr.
|
|
475
478
|
retained_top_level_fields: >-
|
|
476
479
|
Every field in never_omitted plus command, status, app_home, app, mode,
|
|
477
|
-
history,
|
|
480
|
+
history, shared_skill, project_integration, decision_attention, and
|
|
478
481
|
the bespoke context pointers (kept null on the bare surface). The
|
|
479
482
|
conditional v1_migration/docs/objective are retained when active (see
|
|
480
|
-
omitted_when_default). issues ships as the deprecated
|
|
483
|
+
omitted_when_default). issues ships as the deprecated count-only
|
|
484
|
+
transition projection and excludes canonical todo.detail.
|
|
481
485
|
projected_subdetail:
|
|
482
486
|
- field: plan.tasks
|
|
483
487
|
reason: plan_task_detail
|
|
@@ -491,9 +495,6 @@ default_emission_omission_contract:
|
|
|
491
495
|
- field: history.{progress,decisions,health}.entries
|
|
492
496
|
reason: startup_history_entries
|
|
493
497
|
recovery: agentera state <artifact> list --limit 20 --format json
|
|
494
|
-
- field: runtime_lifecycle.runtimes
|
|
495
|
-
reason: lifecycle_runtime_detail
|
|
496
|
-
recovery: agentera upgrade --dry-run --format json
|
|
497
498
|
- field: project_integration.phases
|
|
498
499
|
reason: phase_blockers
|
|
499
500
|
recovery: agentera doctor --format json
|
|
@@ -546,7 +547,7 @@ declared_available_fields:
|
|
|
546
547
|
- project_integration
|
|
547
548
|
- attention
|
|
548
549
|
- history
|
|
549
|
-
-
|
|
550
|
+
- shared_skill
|
|
550
551
|
- decision_attention
|
|
551
552
|
- next_action
|
|
552
553
|
- orchestration_context
|
|
@@ -560,33 +561,6 @@ declared_available_fields:
|
|
|
560
561
|
- issues
|
|
561
562
|
fixtures:
|
|
562
563
|
pass:
|
|
563
|
-
- consumer: opencode_compaction_context
|
|
564
|
-
executable_command: agentera prime --format json
|
|
565
|
-
depends_on:
|
|
566
|
-
- mode
|
|
567
|
-
- profile
|
|
568
|
-
- health
|
|
569
|
-
- issues
|
|
570
|
-
- plan
|
|
571
|
-
- progress
|
|
572
|
-
- next_action
|
|
573
|
-
- attention
|
|
574
|
-
nested_fields:
|
|
575
|
-
- profile.status
|
|
576
|
-
- next_action.object
|
|
577
|
-
conditional_nested_fields:
|
|
578
|
-
- path: health.grade
|
|
579
|
-
present_when: health.exists
|
|
580
|
-
- path: health.trajectory
|
|
581
|
-
present_when: health.exists
|
|
582
|
-
- path: plan.first_pending.name
|
|
583
|
-
present_when: plan.first_pending
|
|
584
|
-
- path: progress.latest.id
|
|
585
|
-
present_when: progress.latest
|
|
586
|
-
- path: progress.latest.what
|
|
587
|
-
present_when: progress.latest
|
|
588
|
-
- path: progress.latest.next
|
|
589
|
-
present_when: progress.latest
|
|
590
564
|
- consumer: status_dashboard_renderer
|
|
591
565
|
executable_command: agentera prime --context status --format json
|
|
592
566
|
depends_on:
|
|
@@ -2,7 +2,7 @@ schema_version: agentera.routing_execution_vocabulary.v1
|
|
|
2
2
|
status: active_authority
|
|
3
3
|
purpose: >-
|
|
4
4
|
Define routing and execution vocabulary boundaries so request routing, next-action
|
|
5
|
-
recommendation, Orkestrera task assignment, worker launch,
|
|
5
|
+
recommendation, Orkestrera task assignment, worker launch, host-provided worker support, and
|
|
6
6
|
worker-safety Git commits stay distinct without forcing mechanical renames of
|
|
7
7
|
shipped compatibility identifiers or historical evidence.
|
|
8
8
|
sources:
|
|
@@ -14,7 +14,7 @@ scope:
|
|
|
14
14
|
- Hej and capability next-action recommendations that wait for confirmation.
|
|
15
15
|
- Orkestrera assignment of approved plan work to worker capabilities.
|
|
16
16
|
- Realisera and Optimera launch of runtime workers.
|
|
17
|
-
-
|
|
17
|
+
- Host-provided worker mechanisms without Agentera-owned runtime integration.
|
|
18
18
|
- Git commit safety language before spawning isolated worker execution.
|
|
19
19
|
excludes:
|
|
20
20
|
- Broad current-prose replacement across capability instructions.
|
|
@@ -96,8 +96,8 @@ canonical_concepts:
|
|
|
96
96
|
- launch substrate
|
|
97
97
|
runtime_subagent_support:
|
|
98
98
|
definition: >-
|
|
99
|
-
|
|
100
|
-
descriptor
|
|
99
|
+
A worker mechanism supplied by the coding host. Agentera may request a
|
|
100
|
+
worker but ships no host-specific descriptor, adapter, plugin, or hook.
|
|
101
101
|
preferred_terms:
|
|
102
102
|
- subagent mechanism
|
|
103
103
|
- runtime subagent mechanism
|
|
@@ -167,7 +167,6 @@ focused_scan:
|
|
|
167
167
|
paths:
|
|
168
168
|
- AGENTS.md
|
|
169
169
|
- references/cli/vocabulary.md
|
|
170
|
-
- references/adapters/runtime-feature-parity.md
|
|
171
170
|
- (retired maintainer measurement tool)
|
|
172
171
|
- skills/agentera/SKILL.md
|
|
173
172
|
- skills/agentera/references/contract.md
|
|
@@ -198,10 +197,6 @@ focused_scan:
|
|
|
198
197
|
text: subagent_dispatch|fixture names
|
|
199
198
|
classification: compatibility-preserved
|
|
200
199
|
reason: Routing vocabulary docs preserve explicit compatibility identifiers and fixture terminology.
|
|
201
|
-
- path: ^references/adapters/runtime-feature-parity\.md$
|
|
202
|
-
text: prompt rewrite router|Subagent Dispatch|Dispatch surface|Capability dispatch|subagent dispatch
|
|
203
|
-
classification: compatibility-preserved
|
|
204
|
-
reason: Runtime parity docs name concrete host and compatibility surfaces around descriptor dispatch support.
|
|
205
200
|
- path: ^scripts/measure_token_payload\.py$
|
|
206
201
|
text: static dispatch payload|Agentera router
|
|
207
202
|
classification: historical
|
|
@@ -238,20 +233,7 @@ focused_scan:
|
|
|
238
233
|
text: '`dispatch`: invoke another capability autonomously|`chain`: dispatch multiple capabilities autonomously|In orkestrera only, `dispatch` and `chain` are autonomous'
|
|
239
234
|
classification: fixture-only
|
|
240
235
|
reason: Skill dispatch contract tests assert the canonical Orkestrera dispatch reservation.
|
|
241
|
-
- path: ^tests/test_runtime_adapters\.py$
|
|
242
|
-
text: opencode bare-hej router|routeBareHejMessage|subagent_dispatch
|
|
243
|
-
classification: fixture-only
|
|
244
|
-
reason: Runtime adapter tests assert plugin routing helpers and compatibility identifier fixtures.
|
|
245
|
-
- path: ^tests/test_runtime_adapter_registry\.py$
|
|
246
|
-
text: subagent_dispatch
|
|
247
|
-
classification: code-identifier
|
|
248
|
-
reason: Runtime adapter registry tests preserve the shipped subagent_dispatch field name.
|
|
249
236
|
compatibility_identifiers:
|
|
250
|
-
runtime_adapter:
|
|
251
|
-
- subagent_dispatch
|
|
252
|
-
- RuntimeAdapter.subagent_dispatch
|
|
253
|
-
- subagent_dispatch.supported
|
|
254
|
-
- subagent_dispatch.group
|
|
255
237
|
route_aliases:
|
|
256
238
|
- ROUTE_ALIASES
|
|
257
239
|
- primary_aliases
|
|
@@ -1,34 +1,14 @@
|
|
|
1
|
-
# Upgrade repair wording
|
|
1
|
+
# Upgrade repair wording
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
**project** directory, managed `.cursor/agents/*.md` descriptors are normally
|
|
5
|
-
copied from the active app-home bundle. On a **v3 capability-surface** project
|
|
6
|
-
that signal is suppressed so D65 `prime --context` bodies are not regressed to
|
|
7
|
-
the retired `instructions.md` read path.
|
|
3
|
+
## Runtime migration boundary
|
|
8
4
|
|
|
9
|
-
|
|
5
|
+
Recognized v2-to-v3 project migration rewires existing Agentera v2 hook
|
|
6
|
+
configurations to the npm CLI and retires only proven Agentera-owned legacy hook
|
|
7
|
+
files. It does not copy or refresh plugins, agents, commands, or skill links.
|
|
10
8
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
`
|
|
14
|
-
|
|
15
|
-
for every routed capability (`status`, `vision`, `discuss`, `research`,
|
|
16
|
-
`plan`, `build`, `optimize`, `audit`, `document`, `profile`,
|
|
17
|
-
`design`, `orchestrate`).
|
|
18
|
-
|
|
19
|
-
If any module is missing, preserve v2 upgrade behavior (copy/refresh managed
|
|
20
|
-
agents from the bundle).
|
|
21
|
-
|
|
22
|
-
## Orchestrator behavior
|
|
23
|
-
|
|
24
|
-
| Orchestrator | Branch | Behavior |
|
|
25
|
-
| --- | --- | --- |
|
|
26
|
-
| TypeScript (`packages/cli/src/upgrade/runtimeMigration.ts`) | `feat/v3` | On v3 probe match, emit `skipped` `copy-agent` items for in-tree `.cursor/agents/` instead of copying from the bundle. |
|
|
27
|
-
| Python (`scripts/agentera_upgrade.py`) | `main` (stable) | Same probe before the cursor agent copy loop; do not schedule `copy-agent` targets under the project when the probe matches. Backport per the both-branch pattern. |
|
|
28
|
-
|
|
29
|
-
## User-visible skip message
|
|
30
|
-
|
|
31
|
-
`v3 capability instruction modules present; in-tree .cursor/agents/ uses prime --context and is not overwritten`
|
|
9
|
+
Runtime lifecycle installation and remediation are separate. Apply requires an
|
|
10
|
+
explicit `--runtime` selector and `--yes`; declared ownership, collision
|
|
11
|
+
remediation, and convergent retry behavior remain governed by `UPGRADE.md`.
|
|
32
12
|
|
|
33
13
|
## v2 install track successor surfacing (#32)
|
|
34
14
|
|
|
@@ -47,9 +47,8 @@ required_top_level_fields:
|
|
|
47
47
|
items:
|
|
48
48
|
type: string
|
|
49
49
|
description: >-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
pass at write time.
|
|
50
|
+
Historical runtime adapter ids that the v2 install actively used at handoff.
|
|
51
|
+
The v3 reader treats these as migration evidence, not active runtime inventory.
|
|
53
52
|
user_data_inventory_catalog:
|
|
54
53
|
- id: benchmarks
|
|
55
54
|
relative_path: benchmarks
|