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
@@ -23,97 +23,15 @@ records:
23
23
  - id: cli-suite-marker
24
24
  path: packages/cli/package.json
25
25
  selector: agentera.suiteVersion
26
- - id: copilot-root
27
- path: plugin.json
28
- selector: version
29
- - id: copilot-repository
30
- path: .github/plugin/plugin.json
31
- selector: version
32
- - id: codex-plugin
33
- path: .codex-plugin/plugin.json
34
- selector: version
35
- - id: cursor-plugin
36
- path: .cursor-plugin/plugin.json
37
- selector: version
38
- - id: opencode-plugin-marker
39
- path: .opencode/plugins/agentera.js
40
- selector: AGENTERA_VERSION
41
26
  - id: skill-frontmatter
42
27
  path: skills/agentera/SKILL.md
43
28
  selector: frontmatter.version
44
- excluded_runtime_manifests:
45
- - .opencode/package.json
46
- runtime_package_manifests:
47
- manifests:
48
- - id: copilot-root-manifest
49
- runtime: copilot
50
- path: plugin.json
51
- version_bearing: true
52
- package_shape: suite-bundle
53
- - id: copilot-repository-manifest
54
- runtime: copilot
55
- path: .github/plugin/plugin.json
56
- version_bearing: true
57
- package_shape: suite-bundle
58
- - id: codex-plugin-manifest
59
- runtime: codex
60
- path: .codex-plugin/plugin.json
61
- version_bearing: true
62
- package_shape: suite-bundle
63
- - id: cursor-plugin-manifest
64
- runtime: cursor
65
- path: .cursor-plugin/plugin.json
66
- version_bearing: true
67
- package_shape: suite-bundle
68
- - id: opencode-package-manifest
69
- runtime: opencode
70
- path: .opencode/package.json
71
- version_bearing: false
72
- package_shape: npm-loadable-plugin
73
- shared_paths:
74
- - id: skills
75
- path: skills
76
- kind: dir
77
- - id: hooks
78
- path: hooks
79
- kind: dir
80
- - id: registry
81
- path: registry.json
82
- kind: file
83
- - id: copilot-root-manifest
84
- path: plugin.json
85
- kind: file
86
- - id: readme
87
- path: README.md
88
- kind: file
89
- - id: upgrade-guide
90
- path: UPGRADE.md
91
- kind: file
92
- shared_paths_policy: validate minimum shared paths separately from full bundle includes
93
29
  bundle_surfaces:
94
30
  directories:
95
31
  - id: skills
96
32
  path: skills
97
33
  - id: references
98
34
  path: references
99
- - id: agents
100
- path: agents
101
- - id: hooks
102
- path: hooks
103
- - id: github-hooks
104
- path: .github/hooks
105
- - id: codex-plugin
106
- path: .codex-plugin
107
- - id: cursor-plugin
108
- path: .cursor-plugin
109
- - id: cursor-agents
110
- path: .cursor/agents
111
- - id: opencode-commands
112
- path: .opencode/commands
113
- - id: opencode-agents
114
- path: .opencode/agents
115
- - id: opencode-plugins
116
- path: .opencode/plugins
117
35
  files:
118
36
  - id: readme
119
37
  path: README.md
@@ -127,14 +45,6 @@ records:
127
45
  path: LICENSE
128
46
  - id: registry
129
47
  path: registry.json
130
- - id: copilot-root-manifest
131
- path: plugin.json
132
- - id: copilot-repository-manifest
133
- path: .github/plugin/plugin.json
134
- - id: opencode-package-manifest
135
- path: .opencode/package.json
136
- - id: cursor-hooks
137
- path: .cursor/hooks.json
138
48
  generated_files:
139
49
  - id: npx-bundle-marker
140
50
  path: .agentera-npx-bundle.json
@@ -151,71 +61,16 @@ records:
151
61
  skip_suffixes:
152
62
  - .pyc
153
63
  - .pyo
154
- package_commands:
155
- commands:
156
- - id: remove-legacy-skills
157
- runtime: all
158
- action: remove-legacy-skills
159
- phase: cleanup
160
- argv:
161
- - npx
162
- - skills
163
- - remove
164
- - hej
165
- - visionera
166
- - resonera
167
- - inspirera
168
- - planera
169
- - realisera
170
- - inspektera
171
- - optimera
172
- - orkestrera
173
- - visualisera
174
- - dokumentera
175
- - profilera
176
- - -g
177
- - -y
178
- skipped_without_update_packages_message: legacy skill removal skipped; pass --update-packages to run
179
- - id: install-agentera-skill-opencode
180
- runtime: opencode
181
- action: install-agentera-skill
182
- phase: runtime-install
183
- argv:
184
- - npx
185
- - skills
186
- - add
187
- - jgabor/agentera
188
- - -g
189
- - -a
190
- - opencode
191
- - --skill
192
- - agentera
193
- - -y
194
- skipped_without_update_packages_message: external package update skipped; pass --update-packages to run
195
- safety:
196
- argv_only: true
197
- update_packages_required_to_plan: true
198
- yes_required_to_execute: true
199
- preserve_existing_write_gates: true
200
- cleanup_phase: cleanup
201
- runtime_install_phase: runtime-install
202
64
  docs_targets:
203
65
  version_files_source: .agentera/docs.yaml conventions.version_files
204
66
  version_files:
205
67
  - packages/cli/package.json
206
- - plugin.json
207
- - .github/plugin/plugin.json
208
- - .codex-plugin/plugin.json
209
- - .cursor-plugin/plugin.json
210
- - .opencode/plugins/agentera.js
211
68
  - skills/agentera/SKILL.md
212
69
  - registry.json
213
70
  index_targets:
214
71
  - references/adapters/package-surface-characterization.md
215
72
  - references/adapters/package-manifest-interface-model.yaml
216
73
  - references/adapters/package-registry.yaml
217
- excluded_version_files:
218
- - .opencode/package.json
219
74
  release_policy:
220
75
  semver_policy_source: .agentera/docs.yaml conventions.semver_policy
221
76
  version_bump_required_for_interface_only_change: false
@@ -2,7 +2,8 @@
2
2
 
3
3
  Current Agentera 3.0 package behavior is owned by
4
4
  `references/adapters/package-registry.yaml` and the TypeScript
5
- `PackageRegistry` loader.
5
+ `PackageRegistry` loader. The package has two product surfaces: the CLI and the
6
+ canonical shared skill.
6
7
 
7
8
  ## Version matrix
8
9
 
@@ -13,16 +14,8 @@ development pre-release suffix, but its `X.Y.Z` core must match the suite:
13
14
  | Surface | Selector |
14
15
  | --- | --- |
15
16
  | `packages/cli/package.json` | `version` (development pre-release) and `agentera.suiteVersion` (suite) |
16
- | `plugin.json` | `version` |
17
- | `.github/plugin/plugin.json` | `version` |
18
- | `.codex-plugin/plugin.json` | `version` |
19
- | `.cursor-plugin/plugin.json` | `version` |
20
- | `.opencode/plugins/agentera.js` | `AGENTERA_VERSION` |
21
17
  | `skills/agentera/SKILL.md` | frontmatter `version` |
22
18
 
23
- `.opencode/package.json` is a runtime package manifest but intentionally has no
24
- suite-version field.
25
-
26
19
  `packages/cli/package.json#agentera.gitRef` identifies the last substantive
27
20
  package-source commit, not a later verification-only commit. Repository-local
28
21
  release validation requires that commit to exist and compares the package
@@ -30,39 +23,26 @@ contract, compiled-source inputs, scripts, and bundled-data inputs against it.
30
23
  Only the package version and `gitRef`, project state, and the release validator
31
24
  implementing this check are excluded, avoiding a circular source reference.
32
25
 
33
- ## Active runtime manifests
34
-
35
- The runtime manifest set covers exactly OpenCode, Codex, Cursor, and GitHub
36
- Copilot. Claude has no package or marketplace manifest.
37
-
38
- | Runtime | Manifest sources |
39
- | --- | --- |
40
- | OpenCode | `.opencode/package.json` |
41
- | Codex | `.codex-plugin/plugin.json` |
42
- | Cursor | `.cursor-plugin/plugin.json` |
43
- | GitHub Copilot | `plugin.json`, `.github/plugin/plugin.json` |
44
-
45
26
  ## npm bundle
46
27
 
47
- The self-contained npm package ships `dist/` plus `bundle/`. Bundle data
48
- includes the shared skill, contracts, references, release docs, and every
49
- runtime lifecycle/package source declared by the registry:
50
-
51
- - `.opencode/commands`, `.opencode/agents`, `.opencode/plugins`, and package manifest;
52
- - `.codex-plugin` and both Codex hook sources under `hooks/`;
53
- - `.cursor-plugin`, `.cursor/hooks.json`, and `.cursor/agents`;
54
- - Copilot root/repository manifests and `.github/hooks`;
55
- - `skills`, `references`, `registry.json`, README, upgrade guide, changelog,
56
- design, and license.
57
-
58
- Packaging tests inspect `npm pack --dry-run --json --ignore-scripts` and fail if
59
- any declared runtime source disappears. The retired Claude manifest is also a
60
- negative assertion.
28
+ Contributor construction, checkout-generation, and recovery behavior is owned
29
+ by [`docs/packaging/v3-packaging.md`](../../docs/packaging/v3-packaging.md).
61
30
 
62
- ## Package-manager boundary
63
-
64
- Lifecycle upgrade does not execute runtime-native package managers. Legacy
65
- portable-skill cleanup and the OpenCode portable-skill install specification
66
- remain argv-only package-registry records behind their existing update and
67
- approval gates. Native installation, enablement, authentication, and trust are
68
- user-owned actions.
31
+ The self-contained npm package ships `dist/` plus `bundle/`. Bundle data
32
+ includes the canonical `skills/` tree, required `references/`, `registry.json`,
33
+ and package guidance. Compiled commands ship in `dist/`. The shared-skill tree
34
+ includes its capability schemas, artifact schemas, and canonical
35
+ `skills/agentera/agents/*.toml` descriptors.
36
+
37
+ The package lane's isolated package fixture invokes `npm pack --json
38
+ --ignore-scripts` after governed construction and fails if the CLI or required
39
+ bundle data disappears, or if a current host-native descriptor/runtime path
40
+ enters the package. Contributors use `pnpm -C packages/cli run pack:dry-run`;
41
+ direct checkout packing remains rejected by the canonical packaging authority.
42
+
43
+ ## Native package boundary
44
+
45
+ The package registry defines no host-native manifest parity, package-manager
46
+ command, runtime source tree, or native install command. Historical migration
47
+ readers and fixtures remain source-only compatibility data; they do not create a
48
+ current integration surface in the npm inventory.
@@ -1,5 +1,5 @@
1
1
  schema_version: agentera.runtimeLifecycleAdapters.v1
2
- status: active_contract
2
+ status: migration_only_contract
3
3
  decision: 92
4
4
  authority: references/adapters/runtime-lifecycle-authority.yaml
5
5
  operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
@@ -68,221 +68,7 @@ path_policy:
68
68
  - marketplace-cache
69
69
  known_caveats:
70
70
  - Append-only ownership journal recovery accepts only a strict contiguous hash chain, ignores uniquely named non-authoritative publication temporaries, blocks malformed or disconnected final events, and re-observes every resource before retry.
71
- shared_resources:
72
- - id: canonical_skill
73
- category: skills
74
- kind: symlink
75
- source: "{source_root}/skills/agentera"
76
- destination: "{home}/.agents/skills/agentera"
77
- required: true
78
- managed_resources:
79
- - id: opencode.plugin
80
- runtime_id: opencode
81
- surface_id: host
82
- category: plugins
83
- kind: file
84
- source: "{source_root}/.opencode/plugins/agentera.js"
85
- destination: "{opencode_config}/plugins/agentera.js"
86
- required: false
87
- - id: opencode.agent
88
- runtime_id: opencode
89
- surface_id: host
90
- category: agents
91
- kind: file
92
- source: "{source_root}/.opencode/agents/agentera.md"
93
- destination: "{opencode_config}/agents/agentera.md"
94
- required: false
95
- - id: codex.hooks
96
- runtime_id: codex
97
- surface_id: cli
98
- category: hooks
99
- kind: file
100
- source: "{source_root}/hooks/codex-hooks.json"
101
- destination: "{home}/.codex/hooks.json"
102
- required: false
103
- - id: codex.agents
104
- runtime_id: codex
105
- surface_id: cli
106
- category: agents
107
- kind: directory_files
108
- source: "{source_root}/skills/agentera/agents"
109
- destination: "{home}/.codex/agents"
110
- extension: .toml
111
- required: false
112
- - id: cursor.plugin
113
- runtime_id: cursor
114
- surface_id: ide
115
- category: plugins
116
- kind: file
117
- source: "{source_root}/.cursor-plugin/plugin.json"
118
- destination: "{project}/.cursor-plugin/plugin.json"
119
- required: false
120
- - id: cursor.hooks
121
- runtime_id: cursor
122
- surface_id: ide
123
- category: hooks
124
- kind: file
125
- source: "{source_root}/.cursor/hooks.json"
126
- destination: "{project}/.cursor/hooks.json"
127
- required: false
128
- - id: cursor.agent
129
- runtime_id: cursor
130
- surface_id: ide
131
- category: agents
132
- kind: file
133
- source: "{source_root}/.cursor/agents/agentera.md"
134
- destination: "{project}/.cursor/agents/agentera.md"
135
- required: false
136
- adapters:
137
- - runtime_id: opencode
138
- binaries:
139
- host: [opencode]
140
- resource_refs: [canonical_skill, opencode.plugin, opencode.agent]
141
- skill_locations:
142
- - path: "{project}/.opencode/skills/agentera"
143
- scope: project_runtime
144
- - path: "{project}/.agents/skills/agentera"
145
- scope: project_shared
146
- - path: "{home}/.agents/skills/agentera"
147
- scope: personal_shared
148
- canonical: true
149
- - path: "{opencode_config}/skills/agentera"
150
- scope: personal_runtime
151
- categories:
152
- skills:
153
- host: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
154
- plugins:
155
- host: { capability: repairable, evidence: filesystem, remediation: shared_engine }
156
- hooks:
157
- host: { capability: observable, evidence: managed_resource:opencode.plugin, remediation: shared_engine:opencode.plugin }
158
- agents:
159
- host: { capability: repairable, evidence: filesystem, remediation: shared_engine }
160
- configuration:
161
- host: { capability: not_applicable, evidence: plugin_autodiscovery, remediation: none }
162
- enablement:
163
- host: { capability: observable, evidence: managed_resource:opencode.plugin, remediation: shared_engine:opencode.plugin }
164
- trust:
165
- host: { capability: unverified, evidence: external_observation, remediation: unavailable }
166
- native_actions:
167
- host: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
168
- native_actions: []
169
- - runtime_id: codex
170
- binaries:
171
- cli: [codex]
172
- resource_refs: [canonical_skill, codex.hooks, codex.agents]
173
- skill_locations:
174
- - path: "{project}/.agents/skills/agentera"
175
- scope: project_shared
176
- - path: "{home}/.agents/skills/agentera"
177
- scope: personal_shared
178
- canonical: true
179
- categories:
180
- skills:
181
- cli: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
182
- plugins:
183
- cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
184
- hooks:
185
- cli: { capability: repairable, evidence: filesystem, remediation: shared_engine }
186
- agents:
187
- cli: { capability: repairable, evidence: filesystem, remediation: shared_engine }
188
- configuration:
189
- cli: { capability: observable, evidence: "path:{home}/.codex/config.toml", remediation: action_required }
190
- enablement:
191
- cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
192
- trust:
193
- cli: { capability: observable, evidence: external_observation, remediation: action_required }
194
- native_actions:
195
- cli: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
196
- native_actions: []
197
- - runtime_id: cursor
198
- binaries:
199
- cli: [cursor-agent]
200
- ide: [cursor]
201
- resource_refs: [canonical_skill, cursor.plugin, cursor.hooks, cursor.agent]
202
- skill_locations:
203
- - path: "{project}/.agents/skills/agentera"
204
- scope: project_shared
205
- surfaces: [cli, ide]
206
- - path: "{project}/.cursor/skills/agentera"
207
- scope: project_runtime
208
- surfaces: [cli, ide]
209
- - path: "{home}/.agents/skills/agentera"
210
- scope: personal_shared
211
- surfaces: [cli, ide]
212
- canonical: true
213
- - path: "{home}/.cursor/skills/agentera"
214
- scope: personal_runtime
215
- surfaces: [cli, ide]
216
- categories:
217
- skills:
218
- cli: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
219
- ide: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: false }
220
- plugins:
221
- cli: { capability: not_applicable, evidence: no_cli_plugin_claim, remediation: none }
222
- ide: { capability: repairable, evidence: filesystem, remediation: shared_engine }
223
- hooks:
224
- cli: { capability: unverified, evidence: no_verified_cli_hook_claim, remediation: unavailable }
225
- ide: { capability: repairable, evidence: filesystem, remediation: shared_engine }
226
- agents:
227
- cli: { capability: unverified, evidence: no_verified_cli_agent_claim, remediation: unavailable }
228
- ide: { capability: repairable, evidence: filesystem, remediation: shared_engine }
229
- configuration:
230
- cli: { capability: not_applicable, evidence: skill_autodiscovery, remediation: none }
231
- ide: { capability: not_applicable, evidence: plugin_manifest, remediation: none }
232
- enablement:
233
- cli: { capability: observable, evidence: canonical_skill, remediation: shared_engine:canonical_skill }
234
- ide: { capability: unverified, evidence: external_observation, remediation: unavailable }
235
- trust:
236
- cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
237
- ide: { capability: observable, evidence: external_observation, remediation: action_required }
238
- native_actions:
239
- cli: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
240
- ide: { capability: unverified, evidence: no_verified_native_action, remediation: unavailable }
241
- native_actions: []
242
- - runtime_id: copilot
243
- binaries:
244
- cli: [copilot]
245
- resource_refs: [canonical_skill]
246
- skill_locations:
247
- - path: "{project}/.github/skills/agentera"
248
- scope: project_runtime
249
- - path: "{project}/.agents/skills/agentera"
250
- scope: project_shared
251
- - path: "{home}/.copilot/skills/agentera"
252
- scope: personal_runtime
253
- - path: "{home}/.agents/skills/agentera"
254
- scope: personal_shared
255
- canonical: true
256
- categories:
257
- skills:
258
- cli: { capability: repairable, evidence: filesystem, remediation: shared_engine, required: true }
259
- plugins:
260
- cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
261
- hooks:
262
- cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
263
- agents:
264
- cli: { capability: unsupported, evidence: no_verified_agent_surface, remediation: unavailable }
265
- configuration:
266
- cli: { capability: observable, evidence: env:AGENTERA_HOME, remediation: action_required }
267
- enablement:
268
- cli: { capability: observable, evidence: canonical_skill, remediation: shared_engine:canonical_skill }
269
- trust:
270
- cli: { capability: unverified, evidence: external_observation, remediation: unavailable }
271
- native_actions:
272
- cli: { capability: action_required, evidence: verified_host_actions, remediation: action_required }
273
- native_actions:
274
- - id: copilot.skills.list
275
- surface_id: cli
276
- action_kind: slash_action
277
- command: /skills list
278
- instruction: Run `/skills list` in Copilot CLI to inspect discovered skills.
279
- - id: copilot.skills.info
280
- surface_id: cli
281
- action_kind: slash_action
282
- command: /skills info agentera
283
- instruction: Run `/skills info agentera` in Copilot CLI to inspect the Agentera skill.
284
- - id: copilot.skills.reload
285
- surface_id: cli
286
- action_kind: slash_action
287
- command: /skills reload
288
- instruction: Run `/skills reload` in Copilot CLI after an approved filesystem repair.
71
+ - This contract is retained only for migration and minimum-cleanup readers; it declares no current runtime adapters or repository-native resources.
72
+ shared_resources: []
73
+ managed_resources: []
74
+ adapters: []
@@ -1,5 +1,5 @@
1
1
  schema_version: agentera.runtimeLifecycleAuthority.v1
2
- status: active_authority
2
+ status: migration_only_authority
3
3
  decision: 92
4
4
  operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
5
5
  adapter_contract: references/adapters/runtime-lifecycle-adapters.yaml
@@ -51,34 +51,7 @@ support_floor:
51
51
  - enabled
52
52
  not_applicable_scope: unobserved_conditional_surface_only
53
53
  unmet_blocks_release: true
54
- active_runtimes:
55
- - id: opencode
56
- display_name: OpenCode
57
- surfaces:
58
- - id: host
59
- display_name: OpenCode host
60
- presence: required
61
- - id: codex
62
- display_name: Codex
63
- surfaces:
64
- - id: cli
65
- display_name: Codex CLI
66
- presence: required
67
- - id: cursor
68
- display_name: Cursor
69
- surfaces:
70
- - id: cli
71
- display_name: Cursor Agent CLI
72
- presence: required
73
- - id: ide
74
- display_name: Cursor IDE
75
- presence: conditional
76
- - id: copilot
77
- display_name: GitHub Copilot
78
- surfaces:
79
- - id: cli
80
- display_name: Copilot CLI
81
- presence: required
54
+ active_runtimes: []
82
55
  retired_runtime_inputs:
83
56
  - id: claude
84
57
  purposes:
@@ -1,5 +1,5 @@
1
1
  schema_version: agentera.lifecycleOperationContract.v1
2
- status: active_contract
2
+ status: migration_only_contract
3
3
  decision: 92
4
4
  scope: runtime_neutral_filesystem_resources
5
5
  ownership:
@@ -0,0 +1,74 @@
1
+ schemaVersion: agentera.verificationMeasurement.v1
2
+ status: pass
3
+ captured: 2026-07-20
4
+
5
+ comparison:
6
+ metric: assertion_duration_ms
7
+ direction: lower
8
+ before:
9
+ authority: references/analysis/verification-baseline-2026-07-20.yaml
10
+ production_shard_byte_cap: 67108864
11
+ assertions:
12
+ - test: reports oversized with the artifact path when a shard exceeds the cap
13
+ samples_ms: [13089, 10497, 10245]
14
+ median_ms: 10497
15
+ disposition: consolidated_into_retention_assertion
16
+ - test: retains an oversized record in its own shard and reports oversized state
17
+ samples_ms: [9350, 8554, 8589]
18
+ median_ms: 8589
19
+ cumulative_median_ms: 19086
20
+ after:
21
+ proportional_shard_byte_cap: 8192
22
+ test: retains an oversized record in its own shard and reports oversized state
23
+ samples_ms: [25.284901, 25.359614, 24.883412]
24
+ median_ms: 25.284901
25
+ raw_report_compression: gzip_lossless_mtime_zero
26
+ raw_reports:
27
+ - references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-1.json.gz
28
+ - references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-2.json.gz
29
+ - references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-3.json.gz
30
+ retained_assertion_reduction_ms: 8563.715099
31
+ retained_assertion_reduction_percent: 99.705613
32
+ cumulative_dense_assertion_reduction_ms: 19060.715099
33
+ cumulative_dense_assertion_reduction_percent: 99.867521
34
+
35
+ protocol:
36
+ inherited_from: references/analysis/verification-baseline-2026-07-20.yaml#protocol.source
37
+ environment:
38
+ VITEST_MAX_WORKERS: "4"
39
+ warmup_runs: 1
40
+ retained_runs: 3
41
+ command: >-
42
+ pnpm -C packages/cli exec vp test run --config vite.config.ts
43
+ test/analytics/tierReader.test.ts -t "retains an oversized record"
44
+ --reporter=json
45
+ note: >-
46
+ Before samples are Task 1's exact full-source assertion durations. After
47
+ samples isolate the retained assertion; the duplicate artifact-path case
48
+ was consolidated into it rather than assigned a synthetic zero duration.
49
+
50
+ coverage:
51
+ proportional_shard_boundary:
52
+ owner: source
53
+ path: packages/cli/test/analytics/tierReader.test.ts
54
+ byte_cap: 8192
55
+ pass: reports current when tiers are published and complete
56
+ fail: retains an oversized record in its own shard and reports oversized state
57
+ guarantees: [retention, recovery, state, artifact_path]
58
+ production_constants:
59
+ owner: source
60
+ path: packages/cli/test/analytics/oversizedRegression.test.ts
61
+ shard_byte_cap: 67108864
62
+ signal_byte_cap: 67108864
63
+ reader_byte_cap: 67108864
64
+ production_wiring:
65
+ owner: performance
66
+ path: packages/cli/test/performance/analyticsEvidenceTierCap.test.ts
67
+ shard_byte_cap: 67108864
68
+ owner_command: pnpm -C packages/cli test:performance
69
+ policies: [scheduled, release]
70
+
71
+ caveats:
72
+ - The decisions query remained degraded; omitted decision detail was not reconstructed.
73
+ - Build startup omitted decisions, vision, and profile state; no refresh or inferred approval was performed.
74
+ - Decision satisfaction remained unavailable for llavvlpcmb and djmjbmruyk.
@@ -23,6 +23,17 @@ contract validators, and runtime smoke checks.
23
23
  | --- | --- | --- | --- |
24
24
  | Startup state benchmark | `mage bench:startupState` | Measures how often Agentera CLI state reads are followed by raw artifact access during startup/state gathering. | Manual only; forbidden in normal CI. |
25
25
 
26
+ Verification optimization uses a separate retained baseline rather than this
27
+ runtime-history benchmark. The 2026-07-20 source and pre-commit samples,
28
+ production-scale ownership map, and unresolved worker/lane criteria live in
29
+ [`verification-baseline-2026-07-20.yaml`](./verification-baseline-2026-07-20.yaml).
30
+ That baseline remains measurement authority. Current test ownership, independent
31
+ owner commands, mixed-file separation markers, conservative routing, and named
32
+ execution-policy compositions live in
33
+ [`verification-policy.yaml`](./verification-policy.yaml).
34
+ Losslessly compressed raw reports live beside a dependency-free recomputation
35
+ command under `references/analysis/evidence/verification-baseline-2026-07-20/`.
36
+
26
37
  The startup benchmark is an optimization signal for Decision 51 and Decision 52.
27
38
  It does not implement a startup state envelope or change runtime behavior.
28
39