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.
Files changed (495) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +29 -23
  3. package/bundle/CHANGELOG.md +18 -25
  4. package/bundle/README.md +13 -34
  5. package/bundle/UPGRADE.md +71 -165
  6. package/bundle/references/adapters/package-manifest-interface-model.yaml +40 -241
  7. package/bundle/references/adapters/package-registry.yaml +0 -145
  8. package/bundle/references/adapters/package-surface-characterization.md +22 -42
  9. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +5 -219
  10. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +2 -29
  11. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +1 -1
  12. package/bundle/references/analysis/analytics-boundary-proportional-2026-07-20.yaml +74 -0
  13. package/bundle/references/analysis/benchmark.md +11 -0
  14. package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-1.json.gz +0 -0
  15. package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-2.json.gz +0 -0
  16. package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-3.json.gz +0 -0
  17. package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-1.json.gz +0 -0
  18. package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-2.json.gz +0 -0
  19. package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-3.json.gz +0 -0
  20. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli-route.log.gz +0 -0
  21. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli.log.gz +0 -0
  22. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-documentation.log.gz +0 -0
  23. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/recompute.mjs +98 -0
  24. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-1.json.gz +0 -0
  25. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-2.json.gz +0 -0
  26. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-3.json.gz +0 -0
  27. package/bundle/references/analysis/migration-pagination-proportional-2026-07-20.yaml +64 -0
  28. package/bundle/references/analysis/verification-baseline-2026-07-20.yaml +313 -0
  29. package/bundle/references/analysis/verification-final-proof-2026-07-21.yaml +340 -0
  30. package/bundle/references/analysis/verification-policy.yaml +142 -0
  31. package/bundle/references/analysis/worker-policy-2026-07-21.yaml +207 -0
  32. package/bundle/references/artifacts/state-storage-authority.yaml +48 -448
  33. package/bundle/references/cli/agent-ready-state-contract.yaml +9 -9
  34. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +3 -4
  35. package/bundle/references/cli/bundle-skill-vocabulary.yaml +9 -18
  36. package/bundle/references/cli/capability-tool-classification.yaml +2 -2
  37. package/bundle/references/cli/prime-consumer-compatibility.yaml +86 -112
  38. package/bundle/references/cli/routing-execution-vocabulary.yaml +4 -22
  39. package/bundle/references/cli/upgrade-repair-wording.md +8 -28
  40. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +2 -3
  41. package/bundle/references/cli/vocabulary.md +18 -23
  42. package/bundle/references/meta/documentation-inventory.md +3 -1
  43. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +3 -2
  44. package/bundle/skills/agentera/capabilities/orchestrate/schemas/exit.yaml +1 -1
  45. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +3 -11
  46. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +23 -5
  47. package/dist/analytics/extractCorpus/cli.js.map +1 -1
  48. package/dist/analytics/extractCorpus/copilotSessions.js.map +1 -1
  49. package/dist/analytics/extractCorpus/core.js.map +1 -1
  50. package/dist/analytics/extractCorpus/corpus.js.map +1 -1
  51. package/dist/analytics/extractCorpus/coverageAudit.js.map +1 -1
  52. package/dist/analytics/extractCorpus/cursorSessions.js.map +1 -1
  53. package/dist/analytics/extractCorpus/evidenceTiers.js.map +1 -1
  54. package/dist/analytics/extractCorpus/extractCorpusParity.js +1 -1
  55. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +1 -1
  56. package/dist/analytics/extractCorpus/filesystemSources.js.map +1 -1
  57. package/dist/analytics/extractCorpus/index.js.map +1 -1
  58. package/dist/analytics/extractCorpus/jsonlSessions.js.map +1 -1
  59. package/dist/analytics/extractCorpus/sqliteCaps.js.map +1 -1
  60. package/dist/analytics/extractCorpus/sqliteSessions.js.map +1 -1
  61. package/dist/analytics/extractCorpus/tierReader.js.map +1 -1
  62. package/dist/analytics/extractCorpus.js.map +1 -1
  63. package/dist/analytics/profileSignals.js.map +1 -1
  64. package/dist/analytics/usageStats.js.map +1 -1
  65. package/dist/bin/agentera.js.map +1 -1
  66. package/dist/capabilities/audit/instructions.js.map +1 -1
  67. package/dist/capabilities/build/instructions.js.map +1 -1
  68. package/dist/capabilities/design/instructions.js.map +1 -1
  69. package/dist/capabilities/discuss/instructions.js.map +1 -1
  70. package/dist/capabilities/document/instructions.js.map +1 -1
  71. package/dist/capabilities/index.js.map +1 -1
  72. package/dist/capabilities/optimize/instructions.js.map +1 -1
  73. package/dist/capabilities/orchestrate/instructions.js +1 -1
  74. package/dist/capabilities/orchestrate/instructions.js.map +1 -1
  75. package/dist/capabilities/plan/instructions.js.map +1 -1
  76. package/dist/capabilities/profile/instructions.js.map +1 -1
  77. package/dist/capabilities/research/instructions.js.map +1 -1
  78. package/dist/capabilities/status/instructions.js.map +1 -1
  79. package/dist/capabilities/status/startupInstructions.js.map +1 -1
  80. package/dist/capabilities/vision/instructions.js.map +1 -1
  81. package/dist/cli/appContext.js.map +1 -1
  82. package/dist/cli/argvalidate.js.map +1 -1
  83. package/dist/cli/capabilityContext/benchmark.js.map +1 -1
  84. package/dist/cli/capabilityContext/bespoke.js +8 -2
  85. package/dist/cli/capabilityContext/bespoke.js.map +1 -1
  86. package/dist/cli/capabilityContext/build.js.map +1 -1
  87. package/dist/cli/capabilityContext/closeout.js +3 -3
  88. package/dist/cli/capabilityContext/closeout.js.map +1 -1
  89. package/dist/cli/capabilityContext/contract.js.map +1 -1
  90. package/dist/cli/capabilityContext/evidence.js +52 -40
  91. package/dist/cli/capabilityContext/evidence.js.map +1 -1
  92. package/dist/cli/capabilityContext/index.js.map +1 -1
  93. package/dist/cli/capabilityContext/orchestration.js +15 -5
  94. package/dist/cli/capabilityContext/orchestration.js.map +1 -1
  95. package/dist/cli/capabilityContext/planState.js +1 -1
  96. package/dist/cli/capabilityContext/planState.js.map +1 -1
  97. package/dist/cli/capabilityContext/progress.js.map +1 -1
  98. package/dist/cli/capabilityContext/shared.js.map +1 -1
  99. package/dist/cli/capabilityContext/slim.js +16 -3
  100. package/dist/cli/capabilityContext/slim.js.map +1 -1
  101. package/dist/cli/capabilityContext/startup.js +4 -1
  102. package/dist/cli/capabilityContext/startup.js.map +1 -1
  103. package/dist/cli/capabilityContext/types.js.map +1 -1
  104. package/dist/cli/capabilityContext.js.map +1 -1
  105. package/dist/cli/commands/appHome.js.map +1 -1
  106. package/dist/cli/commands/capability.js.map +1 -1
  107. package/dist/cli/commands/compact.js.map +1 -1
  108. package/dist/cli/commands/doctor.js +6 -64
  109. package/dist/cli/commands/doctor.js.map +1 -1
  110. package/dist/cli/commands/durability.js +12 -48
  111. package/dist/cli/commands/durability.js.map +1 -1
  112. package/dist/cli/commands/entityMigrate.js.map +1 -1
  113. package/dist/cli/commands/lint.js.map +1 -1
  114. package/dist/cli/commands/prime/briefOrientation.js +25 -24
  115. package/dist/cli/commands/prime/briefOrientation.js.map +1 -1
  116. package/dist/cli/commands/prime/bundleStatus.js +8 -2
  117. package/dist/cli/commands/prime/bundleStatus.js.map +1 -1
  118. package/dist/cli/commands/prime/collectEntityOrientation.js +76 -24
  119. package/dist/cli/commands/prime/collectEntityOrientation.js.map +1 -1
  120. package/dist/cli/commands/prime/collectOrientationState.js +34 -53
  121. package/dist/cli/commands/prime/collectOrientationState.js.map +1 -1
  122. package/dist/cli/commands/prime/orientationOutput.js +9 -14
  123. package/dist/cli/commands/prime/orientationOutput.js.map +1 -1
  124. package/dist/cli/commands/prime/types.js.map +1 -1
  125. package/dist/cli/commands/prime/v1Migration.js.map +1 -1
  126. package/dist/cli/commands/prime.js +43 -25
  127. package/dist/cli/commands/prime.js.map +1 -1
  128. package/dist/cli/commands/query.js +17 -49
  129. package/dist/cli/commands/query.js.map +1 -1
  130. package/dist/cli/commands/report.js.map +1 -1
  131. package/dist/cli/commands/schema.js +19 -78
  132. package/dist/cli/commands/schema.js.map +1 -1
  133. package/dist/cli/commands/state/decisions.js +11 -57
  134. package/dist/cli/commands/state/decisions.js.map +1 -1
  135. package/dist/cli/commands/state/docs.js +56 -120
  136. package/dist/cli/commands/state/docs.js.map +1 -1
  137. package/dist/cli/commands/state/experimentRecords.js +22 -121
  138. package/dist/cli/commands/state/experimentRecords.js.map +1 -1
  139. package/dist/cli/commands/state/experiments.js +9 -75
  140. package/dist/cli/commands/state/experiments.js.map +1 -1
  141. package/dist/cli/commands/state/get.js +62 -143
  142. package/dist/cli/commands/state/get.js.map +1 -1
  143. package/dist/cli/commands/state/health.js +9 -123
  144. package/dist/cli/commands/state/health.js.map +1 -1
  145. package/dist/cli/commands/state/index.js +2 -2
  146. package/dist/cli/commands/state/index.js.map +1 -1
  147. package/dist/cli/commands/state/list.js +20 -36
  148. package/dist/cli/commands/state/list.js.map +1 -1
  149. package/dist/cli/commands/state/objective.js +19 -86
  150. package/dist/cli/commands/state/objective.js.map +1 -1
  151. package/dist/cli/commands/state/plan.js +9 -388
  152. package/dist/cli/commands/state/plan.js.map +1 -1
  153. package/dist/cli/commands/state/planTasks.js +58 -93
  154. package/dist/cli/commands/state/planTasks.js.map +1 -1
  155. package/dist/cli/commands/state/plans.js +13 -40
  156. package/dist/cli/commands/state/plans.js.map +1 -1
  157. package/dist/cli/commands/state/progress.js +10 -55
  158. package/dist/cli/commands/state/progress.js.map +1 -1
  159. package/dist/cli/commands/state/shared.js.map +1 -1
  160. package/dist/cli/commands/state/todo.js +24 -133
  161. package/dist/cli/commands/state/todo.js.map +1 -1
  162. package/dist/cli/commands/state/write.js +13 -35
  163. package/dist/cli/commands/state/write.js.map +1 -1
  164. package/dist/cli/commands/upgrade.js +48 -18
  165. package/dist/cli/commands/upgrade.js.map +1 -1
  166. package/dist/cli/commands/upgradeVerify.js +21 -15
  167. package/dist/cli/commands/upgradeVerify.js.map +1 -1
  168. package/dist/cli/commands/validate.js +1 -9
  169. package/dist/cli/commands/validate.js.map +1 -1
  170. package/dist/cli/commands/verify.js.map +1 -1
  171. package/dist/cli/contracts/bundleStatus.js.map +1 -1
  172. package/dist/cli/contracts/orientationState.js.map +1 -1
  173. package/dist/cli/dispatch/argvParser.js.map +1 -1
  174. package/dist/cli/dispatch/check.js +5 -12
  175. package/dist/cli/dispatch/check.js.map +1 -1
  176. package/dist/cli/dispatch/commands.js.map +1 -1
  177. package/dist/cli/dispatch/index.js +30 -29
  178. package/dist/cli/dispatch/index.js.map +1 -1
  179. package/dist/cli/dispatch/lifecycle.js +23 -40
  180. package/dist/cli/dispatch/lifecycle.js.map +1 -1
  181. package/dist/cli/dispatch/prime.js.map +1 -1
  182. package/dist/cli/dispatch/shared.js.map +1 -1
  183. package/dist/cli/dispatch/state.js.map +1 -1
  184. package/dist/cli/dispatch.js.map +1 -1
  185. package/dist/cli/errors.js.map +1 -1
  186. package/dist/cli/help.js +20 -100
  187. package/dist/cli/help.js.map +1 -1
  188. package/dist/cli/migrationRequired.js +22 -19
  189. package/dist/cli/migrationRequired.js.map +1 -1
  190. package/dist/cli/orientation/attention.js +1 -97
  191. package/dist/cli/orientation/attention.js.map +1 -1
  192. package/dist/cli/orientation/corpusCoverage.js.map +1 -1
  193. package/dist/cli/orientation.js +18 -4
  194. package/dist/cli/orientation.js.map +1 -1
  195. package/dist/cli/planArtifacts.js.map +1 -1
  196. package/dist/cli/planEvidence.js.map +1 -1
  197. package/dist/cli/planLifecycleState.js.map +1 -1
  198. package/dist/cli/planTaskIndex.js +12 -0
  199. package/dist/cli/planTaskIndex.js.map +1 -0
  200. package/dist/cli/prime-blob.js +1 -1
  201. package/dist/cli/prime-blob.js.map +1 -1
  202. package/dist/cli/startupCompletenessContract.js.map +1 -1
  203. package/dist/cli/stateQuery.js +1 -2
  204. package/dist/cli/stateQuery.js.map +1 -1
  205. package/dist/cli/structured.js.map +1 -1
  206. package/dist/cli/todoMarkdown.js.map +1 -1
  207. package/dist/cli/todoSeverity.js.map +1 -1
  208. package/dist/core/atomicWriter.js.map +1 -1
  209. package/dist/core/difflib.js.map +1 -1
  210. package/dist/core/envPaths.js.map +1 -1
  211. package/dist/core/jsonValue.js.map +1 -1
  212. package/dist/core/paths.js.map +1 -1
  213. package/dist/core/pyjson.js.map +1 -1
  214. package/dist/core/skillIdentity.js +24 -0
  215. package/dist/core/skillIdentity.js.map +1 -0
  216. package/dist/core/sourceRoot.js.map +1 -1
  217. package/dist/core/text.js.map +1 -1
  218. package/dist/core/toml.js.map +1 -1
  219. package/dist/core/yaml.js.map +1 -1
  220. package/dist/eval/evalSkills.js.map +1 -1
  221. package/dist/eval/semanticEval.js.map +1 -1
  222. package/dist/eval/semanticFixtures.js.map +1 -1
  223. package/dist/hooks/common.js +1 -1
  224. package/dist/hooks/common.js.map +1 -1
  225. package/dist/hooks/compaction/apply.js.map +1 -1
  226. package/dist/hooks/compaction/dryRun.js.map +1 -1
  227. package/dist/hooks/compaction/index.js.map +1 -1
  228. package/dist/hooks/compaction/parse.js.map +1 -1
  229. package/dist/hooks/compaction/retention.js.map +1 -1
  230. package/dist/hooks/compaction/status.js +2 -1
  231. package/dist/hooks/compaction/status.js.map +1 -1
  232. package/dist/hooks/compaction/types.js.map +1 -1
  233. package/dist/hooks/cursorPreToolUse.js.map +1 -1
  234. package/dist/hooks/cursorSessionStart.js +4 -25
  235. package/dist/hooks/cursorSessionStart.js.map +1 -1
  236. package/dist/hooks/projectHookInput.js +26 -0
  237. package/dist/hooks/projectHookInput.js.map +1 -0
  238. package/dist/hooks/sessionStart.js +23 -239
  239. package/dist/hooks/sessionStart.js.map +1 -1
  240. package/dist/hooks/sessionStop.js +4 -12
  241. package/dist/hooks/sessionStop.js.map +1 -1
  242. package/dist/hooks/validateArtifact/agentFacing.js.map +1 -1
  243. package/dist/hooks/validateArtifact/index.js.map +1 -1
  244. package/dist/hooks/validateArtifact/markdown.js.map +1 -1
  245. package/dist/hooks/validateArtifact/runtime.js.map +1 -1
  246. package/dist/hooks/validateArtifact/schema.js.map +1 -1
  247. package/dist/hooks/validateArtifact/traversal.js +1 -1
  248. package/dist/hooks/validateArtifact/traversal.js.map +1 -1
  249. package/dist/hooks/validateArtifact/violations.js.map +1 -1
  250. package/dist/migrate/v2HandoffManifest.js.map +1 -1
  251. package/dist/registries/artifactProtocolIds.js.map +1 -1
  252. package/dist/registries/artifactRegistry.js +2 -1
  253. package/dist/registries/artifactRegistry.js.map +1 -1
  254. package/dist/registries/capabilityContract.js.map +1 -1
  255. package/dist/registries/evaluatorHandoffContract.js.map +1 -1
  256. package/dist/registries/evidenceTierContract.js.map +1 -1
  257. package/dist/registries/packageRegistry.js +57 -231
  258. package/dist/registries/packageRegistry.js.map +1 -1
  259. package/dist/registries/triggerLoader.js.map +1 -1
  260. package/dist/registries/verbosityBudgetContract.js.map +1 -1
  261. package/dist/release/releaseMetadata.js +1 -13
  262. package/dist/release/releaseMetadata.js.map +1 -1
  263. package/dist/runtime/lifecycleAdapterContract.js +4 -4
  264. package/dist/runtime/lifecycleAdapterContract.js.map +1 -1
  265. package/dist/runtime/lifecycleAdapters.js +14 -2
  266. package/dist/runtime/lifecycleAdapters.js.map +1 -1
  267. package/dist/runtime/lifecycleAuthority.js +5 -43
  268. package/dist/runtime/lifecycleAuthority.js.map +1 -1
  269. package/dist/runtime/lifecycleOperationContract.js +3 -2
  270. package/dist/runtime/lifecycleOperationContract.js.map +1 -1
  271. package/dist/runtime/lifecycleOperations.js.map +1 -1
  272. package/dist/runtime/lifecycleOwnershipJournal.js.map +1 -1
  273. package/dist/runtime/lifecyclePublication.js +21 -0
  274. package/dist/runtime/lifecyclePublication.js.map +1 -1
  275. package/dist/runtime/lifecycleSnapshot.js.map +1 -1
  276. package/dist/runtime/retiredRuntimeCleanup.js.map +1 -1
  277. package/dist/setup/codex/agents.js.map +1 -1
  278. package/dist/setup/codex/cli.js.map +1 -1
  279. package/dist/setup/codex/configToml.js.map +1 -1
  280. package/dist/setup/codex/constants.js.map +1 -1
  281. package/dist/setup/codex/installRoot.js.map +1 -1
  282. package/dist/setup/codex/state.js.map +1 -1
  283. package/dist/setup/codex.js.map +1 -1
  284. package/dist/setup/opencode.js +20 -12
  285. package/dist/setup/opencode.js.map +1 -1
  286. package/dist/setup/opencodeConstants.js.map +1 -1
  287. package/dist/setup/sharedSkill.js +46 -0
  288. package/dist/setup/sharedSkill.js.map +1 -0
  289. package/dist/setup/smokeChecks.js +16 -43
  290. package/dist/setup/smokeChecks.js.map +1 -1
  291. package/dist/state/archiveDiscovery.js.map +1 -1
  292. package/dist/state/archivePublication.js.map +1 -1
  293. package/dist/state/archiveRecovery.js.map +1 -1
  294. package/dist/state/archiveReplay.js.map +1 -1
  295. package/dist/state/decisionEntities.js +7 -4
  296. package/dist/state/decisionEntities.js.map +1 -1
  297. package/dist/state/decisionLegacyValidation.js.map +1 -1
  298. package/dist/state/decisionOverlay.js.map +1 -1
  299. package/dist/state/decisionRevision.js.map +1 -1
  300. package/dist/state/decisionRevisionPublication.js.map +1 -1
  301. package/dist/state/directRetrieval.js.map +1 -1
  302. package/dist/state/durability.js +4 -240
  303. package/dist/state/durability.js.map +1 -1
  304. package/dist/state/entityCutover.js +90 -186
  305. package/dist/state/entityCutover.js.map +1 -1
  306. package/dist/state/entityCutoverGit.js.map +1 -1
  307. package/dist/state/entityMigrationPreview.js +3 -3
  308. package/dist/state/entityMigrationPreview.js.map +1 -1
  309. package/dist/state/entityPublicationContext.js.map +1 -1
  310. package/dist/state/entityStorage.js +49 -10
  311. package/dist/state/entityStorage.js.map +1 -1
  312. package/dist/state/experimentArchive.js.map +1 -1
  313. package/dist/state/experimentIdentity.js.map +1 -1
  314. package/dist/state/experimentRetrieval.js.map +1 -1
  315. package/dist/state/healthEntities.js +7 -4
  316. package/dist/state/healthEntities.js.map +1 -1
  317. package/dist/state/healthEntityValidation.js.map +1 -1
  318. package/dist/state/healthRepair.js.map +1 -1
  319. package/dist/state/installRoot.js.map +1 -1
  320. package/dist/state/legacyEntityCutoverEvidence.js.map +1 -1
  321. package/dist/state/legacyIdentity.js.map +1 -1
  322. package/dist/state/listAccounting.js.map +1 -1
  323. package/dist/state/listClassification.js.map +1 -1
  324. package/dist/state/listRetrieval.js.map +1 -1
  325. package/dist/state/objectiveExperimentEntities.js +7 -5
  326. package/dist/state/objectiveExperimentEntities.js.map +1 -1
  327. package/dist/state/planEntities.js +60 -12
  328. package/dist/state/planEntities.js.map +1 -1
  329. package/dist/state/planIdentity.js.map +1 -1
  330. package/dist/state/planRetrieval.js.map +1 -1
  331. package/dist/state/planTaskRetrieval.js.map +1 -1
  332. package/dist/state/progressEntities.js +4 -2
  333. package/dist/state/progressEntities.js.map +1 -1
  334. package/dist/state/projectRoot.js.map +1 -1
  335. package/dist/state/projectionPolicy.js.map +1 -1
  336. package/dist/state/retrievalAuthority.js.map +1 -1
  337. package/dist/state/safeProjectFile.js.map +1 -1
  338. package/dist/state/startupAnalysis/benchmark.js.map +1 -1
  339. package/dist/state/startupAnalysis/contract.js.map +1 -1
  340. package/dist/state/startupAnalysis/helpers.js.map +1 -1
  341. package/dist/state/startupAnalysis/index.js.map +1 -1
  342. package/dist/state/startupAnalysis/metrics.js.map +1 -1
  343. package/dist/state/startupAnalysis/records.js.map +1 -1
  344. package/dist/state/startupAnalysis/report.js.map +1 -1
  345. package/dist/state/startupAnalysis/threshold.js.map +1 -1
  346. package/dist/state/startupAnalysis.js.map +1 -1
  347. package/dist/state/startupProjection.js +5 -3
  348. package/dist/state/startupProjection.js.map +1 -1
  349. package/dist/state/stateMode.js +7 -0
  350. package/dist/state/stateMode.js.map +1 -1
  351. package/dist/state/todoDocsEntities.js +6 -4
  352. package/dist/state/todoDocsEntities.js.map +1 -1
  353. package/dist/state/todoDocsEntityValidation.js.map +1 -1
  354. package/dist/state/write/assign.js.map +1 -1
  355. package/dist/state/write/candidateMutation.js.map +1 -1
  356. package/dist/state/write/errors.js.map +1 -1
  357. package/dist/state/write/experimentPublication.js.map +1 -1
  358. package/dist/state/write/explain.js +10 -12
  359. package/dist/state/write/explain.js.map +1 -1
  360. package/dist/state/write/fields.js.map +1 -1
  361. package/dist/state/write/helpers.js.map +1 -1
  362. package/dist/state/write/index.js.map +1 -1
  363. package/dist/state/write/input.js.map +1 -1
  364. package/dist/state/write/lock.js.map +1 -1
  365. package/dist/state/write/mutation.js.map +1 -1
  366. package/dist/state/write/operations.js +6 -0
  367. package/dist/state/write/operations.js.map +1 -1
  368. package/dist/state/write/planEvaluation.js +19 -5
  369. package/dist/state/write/planEvaluation.js.map +1 -1
  370. package/dist/state/write/planPublication.js +7 -0
  371. package/dist/state/write/planPublication.js.map +1 -1
  372. package/dist/state/write/serialize.js.map +1 -1
  373. package/dist/state/write/transaction.js +23 -532
  374. package/dist/state/write/transaction.js.map +1 -1
  375. package/dist/state/write/validate.js.map +1 -1
  376. package/dist/upgrade/appContentRefresh.js +54 -44
  377. package/dist/upgrade/appContentRefresh.js.map +1 -1
  378. package/dist/upgrade/appModel.js.map +1 -1
  379. package/dist/upgrade/atomicWriter.js.map +1 -1
  380. package/dist/upgrade/bundleEvidence.js.map +1 -1
  381. package/dist/upgrade/channels.js.map +1 -1
  382. package/dist/upgrade/coexistenceProbe.js.map +1 -1
  383. package/dist/upgrade/compatibility.js.map +1 -1
  384. package/dist/upgrade/doctor.js +5 -1
  385. package/dist/upgrade/doctor.js.map +1 -1
  386. package/dist/upgrade/doctorClassifier.js.map +1 -1
  387. package/dist/upgrade/installedHooksRetirement.js +46 -39
  388. package/dist/upgrade/installedHooksRetirement.js.map +1 -1
  389. package/dist/upgrade/legacyAgentCleanup.js +132 -32
  390. package/dist/upgrade/legacyAgentCleanup.js.map +1 -1
  391. package/dist/upgrade/lifecycleUpgrade.js +65 -378
  392. package/dist/upgrade/lifecycleUpgrade.js.map +1 -1
  393. package/dist/upgrade/migrateArtifactsV2ToV3.js +151 -52
  394. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -1
  395. package/dist/upgrade/migrationPublication.js +123 -0
  396. package/dist/upgrade/migrationPublication.js.map +1 -0
  397. package/dist/upgrade/nextMajorDoctor.js.map +1 -1
  398. package/dist/upgrade/npxPlatformStatus.js.map +1 -1
  399. package/dist/upgrade/projectIntegration.js +46 -113
  400. package/dist/upgrade/projectIntegration.js.map +1 -1
  401. package/dist/upgrade/projectIntegrationDecision.js +6 -96
  402. package/dist/upgrade/projectIntegrationDecision.js.map +1 -1
  403. package/dist/upgrade/runtimeMigration.js +222 -402
  404. package/dist/upgrade/runtimeMigration.js.map +1 -1
  405. package/dist/upgrade/upgradeCommands.js +5 -4
  406. package/dist/upgrade/upgradeCommands.js.map +1 -1
  407. package/dist/upgrade/upgradeLock.js +73 -41
  408. package/dist/upgrade/upgradeLock.js.map +1 -1
  409. package/dist/upgrade/upgradeOrchestrator.js +91 -158
  410. package/dist/upgrade/upgradeOrchestrator.js.map +1 -1
  411. package/dist/upgrade/v3CapabilitySurface.js +2 -2
  412. package/dist/upgrade/v3CapabilitySurface.js.map +1 -1
  413. package/dist/upgrade/versionResolution.js.map +1 -1
  414. package/dist/validate/appHomeContract.js +0 -4
  415. package/dist/validate/appHomeContract.js.map +1 -1
  416. package/dist/validate/capability.js.map +1 -1
  417. package/dist/validate/crossCapability.js.map +1 -1
  418. package/dist/validate/selfAudit.js.map +1 -1
  419. package/dist/validate/vocabularyAuthority.js.map +1 -1
  420. package/package.json +23 -8
  421. package/bundle/.codex-plugin/plugin.json +0 -92
  422. package/bundle/.cursor/agents/agentera.md +0 -7
  423. package/bundle/.cursor/hooks.json +0 -32
  424. package/bundle/.cursor-plugin/plugin.json +0 -34
  425. package/bundle/.github/hooks/postToolUse.json +0 -9
  426. package/bundle/.github/hooks/preToolUse.json +0 -8
  427. package/bundle/.github/hooks/sessionEnd.json +0 -8
  428. package/bundle/.github/hooks/sessionStart.json +0 -8
  429. package/bundle/.github/plugin/plugin.json +0 -7
  430. package/bundle/.opencode/agents/agentera.md +0 -12
  431. package/bundle/.opencode/commands/agentera.md +0 -5
  432. package/bundle/.opencode/package.json +0 -31
  433. package/bundle/.opencode/plugins/agentera.js +0 -820
  434. package/bundle/agents/openai.yaml +0 -87
  435. package/bundle/hooks/codex-hooks.json +0 -31
  436. package/bundle/hooks/codex-plugin-hooks.json +0 -31
  437. package/bundle/plugin.json +0 -13
  438. package/bundle/references/adapters/cursor.md +0 -224
  439. package/bundle/references/adapters/opencode.md +0 -529
  440. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -44
  441. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  442. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -387
  443. package/bundle/references/adapters/runtime-feature-parity.md +0 -129
  444. package/dist/cli/commands/backfill.js +0 -231
  445. package/dist/cli/commands/backfill.js.map +0 -1
  446. package/dist/cli/commands/migrate.js +0 -681
  447. package/dist/cli/commands/migrate.js.map +0 -1
  448. package/dist/registries/runtimeAdapterRegistry.js +0 -324
  449. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  450. package/dist/setup/copilot.js +0 -227
  451. package/dist/setup/copilot.js.map +0 -1
  452. package/dist/setup/cursor.js +0 -129
  453. package/dist/setup/cursor.js.map +0 -1
  454. package/dist/setup/cursorSurfaces.js +0 -67
  455. package/dist/setup/cursorSurfaces.js.map +0 -1
  456. package/dist/setup/doctor/core.js +0 -296
  457. package/dist/setup/doctor/core.js.map +0 -1
  458. package/dist/setup/doctor/diagnostics.js +0 -201
  459. package/dist/setup/doctor/diagnostics.js.map +0 -1
  460. package/dist/setup/doctor/opencode.js +0 -301
  461. package/dist/setup/doctor/opencode.js.map +0 -1
  462. package/dist/setup/doctor/report.js +0 -425
  463. package/dist/setup/doctor/report.js.map +0 -1
  464. package/dist/setup/doctor.js +0 -10
  465. package/dist/setup/doctor.js.map +0 -1
  466. package/dist/state/gitBackfill.js +0 -561
  467. package/dist/state/gitBackfill.js.map +0 -1
  468. package/dist/state/gitBackfillAuthority.js +0 -141
  469. package/dist/state/gitBackfillAuthority.js.map +0 -1
  470. package/dist/state/gitBackfillHistory.js +0 -278
  471. package/dist/state/gitBackfillHistory.js.map +0 -1
  472. package/dist/state/gitBackfillOutput.js +0 -209
  473. package/dist/state/gitBackfillOutput.js.map +0 -1
  474. package/dist/state/legacyMigration.js +0 -516
  475. package/dist/state/legacyMigration.js.map +0 -1
  476. package/dist/state/legacyMigrationParser.js +0 -489
  477. package/dist/state/legacyMigrationParser.js.map +0 -1
  478. package/dist/state/migrationAuthority.js +0 -413
  479. package/dist/state/migrationAuthority.js.map +0 -1
  480. package/dist/state/migrationEnrichment.js +0 -35
  481. package/dist/state/migrationEnrichment.js.map +0 -1
  482. package/dist/state/projectionRecovery.js +0 -458
  483. package/dist/state/projectionRecovery.js.map +0 -1
  484. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -568
  485. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  486. package/dist/validate/lifecycleAdapters/legacyPythonParity.js +0 -93
  487. package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +0 -1
  488. package/dist/validate/lifecycleAdapters/lifecycleMain.js +0 -154
  489. package/dist/validate/lifecycleAdapters/lifecycleMain.js.map +0 -1
  490. package/dist/validate/lifecycleAdapters/nodeFormChecks.js +0 -481
  491. package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +0 -1
  492. package/dist/validate/lifecycleAdapters/shared.js +0 -198
  493. package/dist/validate/lifecycleAdapters/shared.js.map +0 -1
  494. package/dist/validate/lifecycleAdapters.js +0 -10
  495. 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
- - Runtime hook packaging prose and metadata for plugin-shipped hooks.
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
- scripts, hooks, references, runtime descriptors, and package metadata as
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
- plugin_shipped_hooks:
65
+ retired_plugin_shipped_hooks:
67
66
  definition: >-
68
- Hooks that are shipped by active runtime plugin package surfaces such as
69
- Codex, OpenCode, Cursor, or GitHub plugin metadata.
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: compatibility-preserved
197
- reason: Vocabulary docs preserve shipped compatibility identifiers and removed command references.
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
- compatibility_identifiers:
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: descriptor validation, regression tests, runtime adapter docs.
4
- # Source of truth for per-capability tool requirements across all runtimes.
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: .opencode/agents/agentera.md:12
79
- alt_evidence: .cursor/agents/agentera.md:7
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 runtime emits
58
+ Per-capability startup capsule. The CLI emits
88
59
  `capability_context.instructions` (the capability's instructions module),
89
- not `prose`. The agent descriptors (.opencode/agents/agentera.md and
90
- .cursor/agents/agentera.md) formerly documented a `prose` field that the
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: docs/packaging/v3-packaging.md:130-139
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/packaging verification matrix consumer. The Prime gate
109
- (line 136) asserts `command: "prime"`, `status: "ok"`, and that
110
- `app_home.source` reflects resolution; the Bun smoke gate (line 139)
111
- asserts the published single binary runs `agentera prime --format json`
112
- and exits 0 with the same JSON shape. Tasks 2-4 must keep the published
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), SKILL.md (lines 68, 103), and the
140
- agent descriptors (.opencode/agents/agentera.md, .cursor/agents/agentera.md)
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 alias is
153
- # emitted by default as a duplicate of `todo` (with a stderr deprecation warning)
154
- # and kept until the 3.0.0 stable cut; it is excluded only from the canonical
155
- # advertised `source_contract.fields` set (one canonical representation `todo`
156
- # is canonical). It is NOT selector-only: it ships in the default bare briefing
157
- # for the opencode_compaction_context consumer that still reads it.
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` is emitted as a
168
- deprecated alias of `todo` with a stderr warning, not as a member of the
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
- runtime_lifecycle, and history added).
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 recommendation and aggregate lifecycle state;
268
- the bounded brief retains the routing projection even when no upgrade
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: runtime_lifecycle
280
- status: conditional
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 alias of `todo`. opencode_compaction_context reads it
330
- (.opencode/plugins/agentera.js:480-486). Removable at the 3.0.0 stable cut
331
- only; tracked in TODO.md [fix:3.0.0]. Tasks 2-4 must keep the alias and
332
- the stderr deprecation warning.
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
- `issues` remains a transition alias of `todo` with a stderr deprecation
352
- warning until the 3.0.0 stable cut. No task in this plan may remove it.
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. The status
371
- capsule puts the canonical Task 3 projection at
372
- `capability_context.context.status_context`; unrelated per-runtime
373
- lifecycle diagnostics are omitted while aggregate release-blocking state
374
- remains available for routing.
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, runtime_lifecycle, project_integration, decision_attention, and
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 transition alias.
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
- - runtime_lifecycle
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, runtime support, and
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
- - Runtime subagent support mechanisms and compatibility identifiers.
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
- Runtime-specific support that lets Agentera use a host's subagent surface,
100
- descriptor model, or equivalent worker mechanism.
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 — v3 cursor agent skip
1
+ # Upgrade repair wording
2
2
 
3
- When `agentera upgrade --runtime cursor` (or a full runtime phase) runs against a
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
- ## v3 surface probe
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
- Treat the project as v3 when **all twelve** instruction modules exist:
12
-
13
- `packages/cli/src/capabilities/<name>/instructions.ts`
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
- Runtime adapter ids (references/adapters/runtime-adapter-registry.yaml)
51
- that the v2 install actively uses runtimes whose setup doctor status is
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