agentera 3.0.0-dev.2 → 3.0.0-dev.20

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 (612) hide show
  1. package/README.md +65 -6
  2. package/bundle/.agentera-npx-bundle.json +1 -1
  3. package/bundle/.codex-plugin/plugin.json +92 -0
  4. package/bundle/.cursor/agents/agentera.md +7 -0
  5. package/bundle/.cursor/hooks.json +32 -0
  6. package/bundle/.cursor-plugin/plugin.json +34 -0
  7. package/bundle/.github/hooks/postToolUse.json +9 -0
  8. package/bundle/.github/hooks/preToolUse.json +8 -0
  9. package/bundle/.github/hooks/sessionEnd.json +8 -0
  10. package/bundle/.github/hooks/sessionStart.json +8 -0
  11. package/bundle/.github/plugin/plugin.json +7 -0
  12. package/bundle/.opencode/agents/agentera.md +12 -0
  13. package/bundle/.opencode/commands/agentera.md +5 -0
  14. package/bundle/.opencode/package.json +31 -0
  15. package/bundle/.opencode/plugins/agentera.js +820 -0
  16. package/bundle/CHANGELOG.md +1108 -0
  17. package/bundle/DESIGN.md +233 -0
  18. package/bundle/LICENSE +201 -0
  19. package/bundle/README.md +141 -0
  20. package/bundle/UPGRADE.md +227 -0
  21. package/bundle/agents/openai.yaml +87 -0
  22. package/bundle/extract-corpus-parity.json +21 -0
  23. package/bundle/hooks/codex-hooks.json +31 -0
  24. package/bundle/hooks/codex-plugin-hooks.json +31 -0
  25. package/bundle/plugin.json +13 -0
  26. package/bundle/references/adapters/cursor.md +53 -42
  27. package/bundle/references/adapters/opencode.md +46 -47
  28. package/bundle/references/adapters/package-manifest-interface-model.yaml +32 -43
  29. package/bundle/references/adapters/package-registry.yaml +19 -53
  30. package/bundle/references/adapters/package-surface-characterization.md +61 -48
  31. package/bundle/references/adapters/runtime-adapter-characterization.md +44 -79
  32. package/bundle/references/adapters/runtime-adapter-registry.yaml +21 -182
  33. package/bundle/references/adapters/runtime-feature-parity.md +114 -174
  34. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +288 -0
  35. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +90 -0
  36. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
  37. package/bundle/references/adapters/runtime-retired-resources.yaml +33 -0
  38. package/bundle/references/analysis/benchmark.md +6 -6
  39. package/bundle/references/analysis/startup-measurement-contract.yaml +37 -26
  40. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +6 -5
  41. package/bundle/references/cli/agent-ready-state-contract.yaml +26 -23
  42. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +4 -4
  43. package/bundle/references/cli/audience-namespace-cli-migration.yaml +40 -26
  44. package/bundle/references/cli/bundle-skill-vocabulary.yaml +4 -32
  45. package/bundle/references/cli/capability-instruction-contract.yaml +98 -57
  46. package/bundle/references/cli/capability-instruction-structure.md +144 -0
  47. package/bundle/references/cli/capability-tool-classification.yaml +12 -12
  48. package/bundle/references/cli/coexistence-probe.yaml +13 -0
  49. package/bundle/references/cli/parity-expected-actual-template.md +30 -0
  50. package/bundle/references/cli/routing-execution-vocabulary.yaml +12 -12
  51. package/bundle/references/cli/routing-model.md +94 -0
  52. package/bundle/references/cli/single-name-protocol.yaml +42 -0
  53. package/bundle/references/cli/trigger-schema-enrichment.md +136 -0
  54. package/bundle/references/cli/update-channels.yaml +43 -7
  55. package/bundle/references/cli/upgrade-repair-wording.md +45 -0
  56. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +98 -0
  57. package/bundle/references/cli/vocabulary-index.yaml +20 -15
  58. package/bundle/references/cli/vocabulary.md +342 -326
  59. package/bundle/references/meta/documentation-inventory.md +9 -3
  60. package/bundle/registry.json +14 -14
  61. package/bundle/skills/agentera/SKILL.md +136 -408
  62. package/bundle/skills/agentera/agents/audit.toml +6 -0
  63. package/bundle/skills/agentera/agents/build.toml +6 -0
  64. package/bundle/skills/agentera/agents/design.toml +6 -0
  65. package/bundle/skills/agentera/agents/discuss.toml +6 -0
  66. package/bundle/skills/agentera/agents/document.toml +6 -0
  67. package/bundle/skills/agentera/agents/optimize.toml +6 -0
  68. package/bundle/skills/agentera/agents/orchestrate.toml +6 -0
  69. package/bundle/skills/agentera/agents/plan.toml +6 -0
  70. package/bundle/skills/agentera/agents/profile.toml +6 -0
  71. package/bundle/skills/agentera/agents/research.toml +6 -0
  72. package/bundle/skills/agentera/agents/status.toml +6 -0
  73. package/bundle/skills/agentera/agents/vision.toml +6 -0
  74. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/artifacts.yaml +10 -10
  75. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +2 -2
  76. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/triggers.yaml +15 -6
  77. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +13 -12
  78. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/artifacts.yaml +12 -12
  79. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +3 -3
  80. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/triggers.yaml +13 -3
  81. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/validation.yaml +11 -11
  82. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +6 -6
  83. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +5 -5
  84. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/triggers.yaml +15 -3
  85. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +7 -7
  86. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/artifacts.yaml +12 -11
  87. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +2 -2
  88. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/triggers.yaml +11 -3
  89. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/validation.yaml +9 -8
  90. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/artifacts.yaml +10 -10
  91. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/triggers.yaml +14 -4
  92. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +8 -8
  93. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +9 -9
  94. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +2 -2
  95. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/triggers.yaml +11 -3
  96. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +9 -9
  97. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/artifacts.yaml +12 -11
  98. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +7 -6
  99. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/triggers.yaml +16 -3
  100. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +120 -0
  101. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +63 -0
  102. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
  103. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/triggers.yaml +15 -3
  104. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +89 -0
  105. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/artifacts.yaml +2 -2
  106. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +3 -3
  107. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/triggers.yaml +7 -3
  108. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/validation.yaml +2 -2
  109. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +24 -0
  110. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/triggers.yaml +9 -3
  111. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
  112. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/artifacts.yaml +14 -11
  113. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/triggers.yaml +12 -8
  114. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
  115. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +8 -8
  116. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +7 -6
  117. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/triggers.yaml +19 -5
  118. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +18 -20
  119. package/bundle/skills/agentera/capability_schema_contract.yaml +201 -38
  120. package/bundle/skills/agentera/protocol.yaml +29 -29
  121. package/bundle/skills/agentera/references/contract.md +338 -322
  122. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +4 -4
  123. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +10 -10
  124. package/bundle/skills/agentera/schemas/artifacts/design.yaml +4 -4
  125. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +8 -7
  126. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +5 -5
  127. package/bundle/skills/agentera/schemas/artifacts/health.yaml +5 -5
  128. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +4 -4
  129. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +263 -11
  130. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +20 -41
  131. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +43 -24
  132. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
  133. package/dist/analytics/extractCorpus/cli.js +163 -0
  134. package/dist/analytics/extractCorpus/cli.js.map +1 -0
  135. package/dist/analytics/extractCorpus/copilotSessions.js +276 -0
  136. package/dist/analytics/extractCorpus/copilotSessions.js.map +1 -0
  137. package/dist/analytics/extractCorpus/core.js +393 -0
  138. package/dist/analytics/extractCorpus/core.js.map +1 -0
  139. package/dist/analytics/extractCorpus/corpus.js +168 -0
  140. package/dist/analytics/extractCorpus/corpus.js.map +1 -0
  141. package/dist/analytics/extractCorpus/coverageAudit.js +261 -0
  142. package/dist/analytics/extractCorpus/coverageAudit.js.map +1 -0
  143. package/dist/analytics/extractCorpus/cursorSessions.js +426 -0
  144. package/dist/analytics/extractCorpus/cursorSessions.js.map +1 -0
  145. package/dist/analytics/extractCorpus/extractCorpusParity.js +105 -0
  146. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +1 -0
  147. package/dist/analytics/extractCorpus/filesystemSources.js +119 -0
  148. package/dist/analytics/extractCorpus/filesystemSources.js.map +1 -0
  149. package/dist/analytics/extractCorpus/index.js +12 -0
  150. package/dist/analytics/extractCorpus/index.js.map +1 -0
  151. package/dist/analytics/extractCorpus/jsonlSessions.js +205 -0
  152. package/dist/analytics/extractCorpus/jsonlSessions.js.map +1 -0
  153. package/dist/analytics/extractCorpus/sqliteCaps.js +44 -0
  154. package/dist/analytics/extractCorpus/sqliteCaps.js.map +1 -0
  155. package/dist/analytics/extractCorpus/sqliteSessions.js +368 -0
  156. package/dist/analytics/extractCorpus/sqliteSessions.js.map +1 -0
  157. package/dist/analytics/extractCorpus.js +2 -1790
  158. package/dist/analytics/extractCorpus.js.map +1 -1
  159. package/dist/analytics/usageStats.js +93 -27
  160. package/dist/analytics/usageStats.js.map +1 -1
  161. package/dist/bin/agentera.js +3 -1
  162. package/dist/bin/agentera.js.map +1 -1
  163. package/dist/capabilities/audit/instructions.js +4 -0
  164. package/dist/capabilities/audit/instructions.js.map +1 -0
  165. package/dist/capabilities/build/instructions.js +5 -0
  166. package/dist/capabilities/build/instructions.js.map +1 -0
  167. package/dist/capabilities/design/instructions.js +5 -0
  168. package/dist/capabilities/design/instructions.js.map +1 -0
  169. package/dist/capabilities/discuss/instructions.js +6 -0
  170. package/dist/capabilities/discuss/instructions.js.map +1 -0
  171. package/dist/capabilities/document/instructions.js +4 -0
  172. package/dist/capabilities/document/instructions.js.map +1 -0
  173. package/dist/capabilities/index.js +38 -0
  174. package/dist/capabilities/index.js.map +1 -0
  175. package/dist/capabilities/optimize/instructions.js +5 -0
  176. package/dist/capabilities/optimize/instructions.js.map +1 -0
  177. package/dist/capabilities/orchestrate/instructions.js +10 -0
  178. package/dist/capabilities/orchestrate/instructions.js.map +1 -0
  179. package/dist/capabilities/plan/instructions.js +6 -0
  180. package/dist/capabilities/plan/instructions.js.map +1 -0
  181. package/dist/capabilities/profile/instructions.js +5 -0
  182. package/dist/capabilities/profile/instructions.js.map +1 -0
  183. package/dist/capabilities/research/instructions.js +6 -0
  184. package/dist/capabilities/research/instructions.js.map +1 -0
  185. package/dist/capabilities/status/instructions.js +5 -0
  186. package/dist/capabilities/status/instructions.js.map +1 -0
  187. package/dist/capabilities/vision/instructions.js +5 -0
  188. package/dist/capabilities/vision/instructions.js.map +1 -0
  189. package/dist/cli/appContext.js +16 -17
  190. package/dist/cli/appContext.js.map +1 -1
  191. package/dist/cli/capabilityContext/benchmark.js +564 -0
  192. package/dist/cli/capabilityContext/benchmark.js.map +1 -0
  193. package/dist/cli/capabilityContext/bespoke.js +36 -0
  194. package/dist/cli/capabilityContext/bespoke.js.map +1 -0
  195. package/dist/cli/capabilityContext/build.js +190 -0
  196. package/dist/cli/capabilityContext/build.js.map +1 -0
  197. package/dist/cli/capabilityContext/closeout.js +230 -0
  198. package/dist/cli/capabilityContext/closeout.js.map +1 -0
  199. package/dist/cli/capabilityContext/contract.js +190 -0
  200. package/dist/cli/capabilityContext/contract.js.map +1 -0
  201. package/dist/cli/capabilityContext/evidence.js +456 -0
  202. package/dist/cli/capabilityContext/evidence.js.map +1 -0
  203. package/dist/cli/capabilityContext/index.js +4 -0
  204. package/dist/cli/capabilityContext/index.js.map +1 -0
  205. package/dist/cli/capabilityContext/orchestration.js +117 -0
  206. package/dist/cli/capabilityContext/orchestration.js.map +1 -0
  207. package/dist/cli/capabilityContext/planState.js +279 -0
  208. package/dist/cli/capabilityContext/planState.js.map +1 -0
  209. package/dist/cli/capabilityContext/progress.js +138 -0
  210. package/dist/cli/capabilityContext/progress.js.map +1 -0
  211. package/dist/cli/capabilityContext/shared.js +94 -0
  212. package/dist/cli/capabilityContext/shared.js.map +1 -0
  213. package/dist/cli/capabilityContext/slim.js +108 -0
  214. package/dist/cli/capabilityContext/slim.js.map +1 -0
  215. package/dist/cli/capabilityContext/startup.js +217 -0
  216. package/dist/cli/capabilityContext/startup.js.map +1 -0
  217. package/dist/cli/capabilityContext/types.js +41 -0
  218. package/dist/cli/capabilityContext/types.js.map +1 -0
  219. package/dist/cli/capabilityContext.js +1 -2420
  220. package/dist/cli/capabilityContext.js.map +1 -1
  221. package/dist/cli/commands/appHome.js +23 -0
  222. package/dist/cli/commands/appHome.js.map +1 -0
  223. package/dist/cli/commands/capability.js +3 -10
  224. package/dist/cli/commands/capability.js.map +1 -1
  225. package/dist/cli/commands/compact.js +1 -1
  226. package/dist/cli/commands/compact.js.map +1 -1
  227. package/dist/cli/commands/doctor.js +116 -96
  228. package/dist/cli/commands/doctor.js.map +1 -1
  229. package/dist/cli/commands/lint.js +16 -41
  230. package/dist/cli/commands/lint.js.map +1 -1
  231. package/dist/cli/commands/prime/bundleStatus.js +185 -0
  232. package/dist/cli/commands/prime/bundleStatus.js.map +1 -0
  233. package/dist/cli/commands/prime/collectOrientationState.js +179 -0
  234. package/dist/cli/commands/prime/collectOrientationState.js.map +1 -0
  235. package/dist/cli/commands/prime/orientationOutput.js +233 -0
  236. package/dist/cli/commands/prime/orientationOutput.js.map +1 -0
  237. package/dist/cli/commands/prime/types.js +2 -0
  238. package/dist/cli/commands/prime/types.js.map +1 -0
  239. package/dist/cli/commands/prime/v1Migration.js +39 -0
  240. package/dist/cli/commands/prime/v1Migration.js.map +1 -0
  241. package/dist/cli/commands/prime.js +11 -519
  242. package/dist/cli/commands/prime.js.map +1 -1
  243. package/dist/cli/commands/query.js +5 -2
  244. package/dist/cli/commands/query.js.map +1 -1
  245. package/dist/cli/commands/report.js +50 -14
  246. package/dist/cli/commands/report.js.map +1 -1
  247. package/dist/cli/commands/schema.js +113 -24
  248. package/dist/cli/commands/schema.js.map +1 -1
  249. package/dist/cli/commands/state/decisions.js +403 -0
  250. package/dist/cli/commands/state/decisions.js.map +1 -0
  251. package/dist/cli/commands/state/docs.js +97 -0
  252. package/dist/cli/commands/state/docs.js.map +1 -0
  253. package/dist/cli/commands/state/experiments.js +68 -0
  254. package/dist/cli/commands/state/experiments.js.map +1 -0
  255. package/dist/cli/commands/state/health.js +116 -0
  256. package/dist/cli/commands/state/health.js.map +1 -0
  257. package/dist/cli/commands/state/index.js +51 -0
  258. package/dist/cli/commands/state/index.js.map +1 -0
  259. package/dist/cli/commands/state/objective.js +69 -0
  260. package/dist/cli/commands/state/objective.js.map +1 -0
  261. package/dist/cli/commands/state/plan.js +274 -0
  262. package/dist/cli/commands/state/plan.js.map +1 -0
  263. package/dist/cli/commands/state/progress.js +47 -0
  264. package/dist/cli/commands/state/progress.js.map +1 -0
  265. package/dist/cli/commands/state/shared.js +15 -0
  266. package/dist/cli/commands/state/shared.js.map +1 -0
  267. package/dist/cli/commands/state/todo.js +121 -0
  268. package/dist/cli/commands/state/todo.js.map +1 -0
  269. package/dist/cli/commands/state/write.js +341 -0
  270. package/dist/cli/commands/state/write.js.map +1 -0
  271. package/dist/cli/commands/upgrade.js +79 -1
  272. package/dist/cli/commands/upgrade.js.map +1 -1
  273. package/dist/cli/commands/upgradeVerify.js +81 -0
  274. package/dist/cli/commands/upgradeVerify.js.map +1 -0
  275. package/dist/cli/commands/validate.js +56 -96
  276. package/dist/cli/commands/validate.js.map +1 -1
  277. package/dist/cli/commands/verify.js +13 -7
  278. package/dist/cli/commands/verify.js.map +1 -1
  279. package/dist/cli/contracts/bundleStatus.js +2 -0
  280. package/dist/cli/contracts/bundleStatus.js.map +1 -0
  281. package/dist/cli/contracts/orientationState.js +2 -0
  282. package/dist/cli/contracts/orientationState.js.map +1 -0
  283. package/dist/cli/dispatch/argvParser.js +33 -0
  284. package/dist/cli/dispatch/argvParser.js.map +1 -0
  285. package/dist/cli/dispatch/check.js +328 -0
  286. package/dist/cli/dispatch/check.js.map +1 -0
  287. package/dist/cli/dispatch/commands.js +27 -0
  288. package/dist/cli/dispatch/commands.js.map +1 -0
  289. package/dist/cli/dispatch/index.js +183 -0
  290. package/dist/cli/dispatch/index.js.map +1 -0
  291. package/dist/cli/dispatch/lifecycle.js +671 -0
  292. package/dist/cli/dispatch/lifecycle.js.map +1 -0
  293. package/dist/cli/dispatch/prime.js +104 -0
  294. package/dist/cli/dispatch/prime.js.map +1 -0
  295. package/dist/cli/dispatch/shared.js +64 -0
  296. package/dist/cli/dispatch/shared.js.map +1 -0
  297. package/dist/cli/dispatch/state.js +148 -0
  298. package/dist/cli/dispatch/state.js.map +1 -0
  299. package/dist/cli/dispatch.js +1 -957
  300. package/dist/cli/dispatch.js.map +1 -1
  301. package/dist/cli/errors.js +54 -0
  302. package/dist/cli/errors.js.map +1 -0
  303. package/dist/cli/help.js +262 -0
  304. package/dist/cli/help.js.map +1 -0
  305. package/dist/cli/orientation/attention.js +163 -0
  306. package/dist/cli/orientation/attention.js.map +1 -0
  307. package/dist/cli/orientation/corpusCoverage.js +71 -0
  308. package/dist/cli/orientation/corpusCoverage.js.map +1 -0
  309. package/dist/cli/orientation.js +194 -114
  310. package/dist/cli/orientation.js.map +1 -1
  311. package/dist/cli/planArtifacts.js +172 -0
  312. package/dist/cli/planArtifacts.js.map +1 -0
  313. package/dist/cli/planEvidence.js +158 -0
  314. package/dist/cli/planEvidence.js.map +1 -0
  315. package/dist/cli/planLifecycleState.js +34 -0
  316. package/dist/cli/planLifecycleState.js.map +1 -0
  317. package/dist/cli/prime-blob.js +68 -2
  318. package/dist/cli/prime-blob.js.map +1 -1
  319. package/dist/cli/startupCompletenessContract.js +56 -0
  320. package/dist/cli/startupCompletenessContract.js.map +1 -0
  321. package/dist/cli/stateQuery.js +17 -2
  322. package/dist/cli/stateQuery.js.map +1 -1
  323. package/dist/cli/todoMarkdown.js +33 -0
  324. package/dist/cli/todoMarkdown.js.map +1 -0
  325. package/dist/cli/todoSeverity.js +19 -0
  326. package/dist/cli/todoSeverity.js.map +1 -0
  327. package/dist/core/atomicWriter.js +21 -0
  328. package/dist/core/atomicWriter.js.map +1 -0
  329. package/dist/core/envPaths.js +21 -0
  330. package/dist/core/envPaths.js.map +1 -0
  331. package/dist/core/jsonValue.js +6 -0
  332. package/dist/core/jsonValue.js.map +1 -0
  333. package/dist/core/pyjson.js +67 -2
  334. package/dist/core/pyjson.js.map +1 -1
  335. package/dist/core/yaml.js +8 -0
  336. package/dist/core/yaml.js.map +1 -1
  337. package/dist/eval/evalSkills.js +30 -25
  338. package/dist/eval/evalSkills.js.map +1 -1
  339. package/dist/eval/semanticEval.js +43 -19
  340. package/dist/eval/semanticEval.js.map +1 -1
  341. package/dist/eval/semanticFixtures.js +16 -4
  342. package/dist/eval/semanticFixtures.js.map +1 -1
  343. package/dist/hooks/common.js +9 -26
  344. package/dist/hooks/common.js.map +1 -1
  345. package/dist/hooks/compaction/apply.js +269 -0
  346. package/dist/hooks/compaction/apply.js.map +1 -0
  347. package/dist/hooks/compaction/dryRun.js +183 -0
  348. package/dist/hooks/compaction/dryRun.js.map +1 -0
  349. package/dist/hooks/compaction/index.js +23 -0
  350. package/dist/hooks/compaction/index.js.map +1 -0
  351. package/dist/hooks/compaction/parse.js +258 -0
  352. package/dist/hooks/compaction/parse.js.map +1 -0
  353. package/dist/hooks/compaction/retention.js +202 -0
  354. package/dist/hooks/compaction/retention.js.map +1 -0
  355. package/dist/hooks/compaction/status.js +243 -0
  356. package/dist/hooks/compaction/status.js.map +1 -0
  357. package/dist/hooks/compaction/types.js +6 -0
  358. package/dist/hooks/compaction/types.js.map +1 -0
  359. package/dist/hooks/cursorPreToolUse.js +1 -1
  360. package/dist/hooks/cursorPreToolUse.js.map +1 -1
  361. package/dist/hooks/cursorSessionStart.js +10 -2
  362. package/dist/hooks/cursorSessionStart.js.map +1 -1
  363. package/dist/hooks/sessionStart.js +18 -11
  364. package/dist/hooks/sessionStart.js.map +1 -1
  365. package/dist/hooks/sessionStop.js +8 -14
  366. package/dist/hooks/sessionStop.js.map +1 -1
  367. package/dist/hooks/validateArtifact/agentFacing.js +10 -0
  368. package/dist/hooks/validateArtifact/agentFacing.js.map +1 -0
  369. package/dist/hooks/validateArtifact/index.js +151 -0
  370. package/dist/hooks/validateArtifact/index.js.map +1 -0
  371. package/dist/hooks/validateArtifact/markdown.js +146 -0
  372. package/dist/hooks/validateArtifact/markdown.js.map +1 -0
  373. package/dist/hooks/validateArtifact/runtime.js +86 -0
  374. package/dist/hooks/validateArtifact/runtime.js.map +1 -0
  375. package/dist/hooks/validateArtifact/schema.js +541 -0
  376. package/dist/hooks/validateArtifact/schema.js.map +1 -0
  377. package/dist/hooks/validateArtifact/traversal.js +106 -0
  378. package/dist/hooks/validateArtifact/traversal.js.map +1 -0
  379. package/dist/hooks/validateArtifact/violations.js +108 -0
  380. package/dist/hooks/validateArtifact/violations.js.map +1 -0
  381. package/dist/migrate/v2HandoffManifest.js +455 -0
  382. package/dist/migrate/v2HandoffManifest.js.map +1 -0
  383. package/dist/registries/artifactProtocolIds.js +77 -0
  384. package/dist/registries/artifactProtocolIds.js.map +1 -0
  385. package/dist/registries/artifactRegistry.js +62 -15
  386. package/dist/registries/artifactRegistry.js.map +1 -1
  387. package/dist/registries/capabilityContract.js +156 -12
  388. package/dist/registries/capabilityContract.js.map +1 -1
  389. package/dist/registries/evaluatorHandoffContract.js +171 -0
  390. package/dist/registries/evaluatorHandoffContract.js.map +1 -0
  391. package/dist/registries/packageRegistry.js +40 -6
  392. package/dist/registries/packageRegistry.js.map +1 -1
  393. package/dist/registries/runtimeAdapterRegistry.js +30 -21
  394. package/dist/registries/runtimeAdapterRegistry.js.map +1 -1
  395. package/dist/registries/triggerLoader.js +211 -0
  396. package/dist/registries/triggerLoader.js.map +1 -0
  397. package/dist/release/releaseMetadata.js +235 -0
  398. package/dist/release/releaseMetadata.js.map +1 -0
  399. package/dist/runtime/lifecycleAdapterContract.js +458 -0
  400. package/dist/runtime/lifecycleAdapterContract.js.map +1 -0
  401. package/dist/runtime/lifecycleAdapters.js +766 -0
  402. package/dist/runtime/lifecycleAdapters.js.map +1 -0
  403. package/dist/runtime/lifecycleAuthority.js +493 -0
  404. package/dist/runtime/lifecycleAuthority.js.map +1 -0
  405. package/dist/runtime/lifecycleOperationContract.js +113 -0
  406. package/dist/runtime/lifecycleOperationContract.js.map +1 -0
  407. package/dist/runtime/lifecycleOperations.js +635 -0
  408. package/dist/runtime/lifecycleOperations.js.map +1 -0
  409. package/dist/runtime/lifecycleOwnershipJournal.js +623 -0
  410. package/dist/runtime/lifecycleOwnershipJournal.js.map +1 -0
  411. package/dist/runtime/lifecyclePublication.js +395 -0
  412. package/dist/runtime/lifecyclePublication.js.map +1 -0
  413. package/dist/runtime/lifecycleSnapshot.js +439 -0
  414. package/dist/runtime/lifecycleSnapshot.js.map +1 -0
  415. package/dist/runtime/retiredRuntimeCleanup.js +238 -0
  416. package/dist/runtime/retiredRuntimeCleanup.js.map +1 -0
  417. package/dist/setup/codex/agents.js +96 -0
  418. package/dist/setup/codex/agents.js.map +1 -0
  419. package/dist/setup/codex/cli.js +161 -0
  420. package/dist/setup/codex/cli.js.map +1 -0
  421. package/dist/setup/codex/configToml.js +639 -0
  422. package/dist/setup/codex/configToml.js.map +1 -0
  423. package/dist/setup/codex/constants.js +29 -0
  424. package/dist/setup/codex/constants.js.map +1 -0
  425. package/dist/setup/codex/installRoot.js +64 -0
  426. package/dist/setup/codex/installRoot.js.map +1 -0
  427. package/dist/setup/codex/state.js +270 -0
  428. package/dist/setup/codex/state.js.map +1 -0
  429. package/dist/setup/codex.js +11 -1055
  430. package/dist/setup/codex.js.map +1 -1
  431. package/dist/setup/copilot.js +1 -1
  432. package/dist/setup/copilot.js.map +1 -1
  433. package/dist/setup/cursor.js +7 -5
  434. package/dist/setup/cursor.js.map +1 -1
  435. package/dist/setup/cursorSurfaces.js +67 -0
  436. package/dist/setup/cursorSurfaces.js.map +1 -0
  437. package/dist/setup/doctor/core.js +296 -0
  438. package/dist/setup/doctor/core.js.map +1 -0
  439. package/dist/setup/doctor/diagnostics.js +201 -0
  440. package/dist/setup/doctor/diagnostics.js.map +1 -0
  441. package/dist/setup/doctor/opencode.js +301 -0
  442. package/dist/setup/doctor/opencode.js.map +1 -0
  443. package/dist/setup/doctor/report.js +425 -0
  444. package/dist/setup/doctor/report.js.map +1 -0
  445. package/dist/setup/doctor.js +9 -1275
  446. package/dist/setup/doctor.js.map +1 -1
  447. package/dist/setup/opencode.js +13 -0
  448. package/dist/setup/opencode.js.map +1 -0
  449. package/dist/setup/opencodeConstants.js +2 -0
  450. package/dist/setup/opencodeConstants.js.map +1 -0
  451. package/dist/setup/smokeChecks.js +109 -0
  452. package/dist/setup/smokeChecks.js.map +1 -0
  453. package/dist/state/installRoot.js +64 -24
  454. package/dist/state/installRoot.js.map +1 -1
  455. package/dist/state/startupAnalysis/benchmark.js +371 -0
  456. package/dist/state/startupAnalysis/benchmark.js.map +1 -0
  457. package/dist/state/startupAnalysis/contract.js +126 -0
  458. package/dist/state/startupAnalysis/contract.js.map +1 -0
  459. package/dist/state/startupAnalysis/helpers.js +287 -0
  460. package/dist/state/startupAnalysis/helpers.js.map +1 -0
  461. package/dist/state/startupAnalysis/index.js +7 -0
  462. package/dist/state/startupAnalysis/index.js.map +1 -0
  463. package/dist/state/startupAnalysis/metrics.js +341 -0
  464. package/dist/state/startupAnalysis/metrics.js.map +1 -0
  465. package/dist/state/startupAnalysis/records.js +199 -0
  466. package/dist/state/startupAnalysis/records.js.map +1 -0
  467. package/dist/state/startupAnalysis/report.js +112 -0
  468. package/dist/state/startupAnalysis/report.js.map +1 -0
  469. package/dist/state/startupAnalysis/threshold.js +500 -0
  470. package/dist/state/startupAnalysis/threshold.js.map +1 -0
  471. package/dist/state/startupAnalysis.js +2 -1952
  472. package/dist/state/startupAnalysis.js.map +1 -1
  473. package/dist/state/write/assign.js +21 -0
  474. package/dist/state/write/assign.js.map +1 -0
  475. package/dist/state/write/errors.js +12 -0
  476. package/dist/state/write/errors.js.map +1 -0
  477. package/dist/state/write/explain.js +155 -0
  478. package/dist/state/write/explain.js.map +1 -0
  479. package/dist/state/write/fields.js +62 -0
  480. package/dist/state/write/fields.js.map +1 -0
  481. package/dist/state/write/index.js +11 -0
  482. package/dist/state/write/index.js.map +1 -0
  483. package/dist/state/write/input.js +22 -0
  484. package/dist/state/write/input.js.map +1 -0
  485. package/dist/state/write/lock.js +108 -0
  486. package/dist/state/write/lock.js.map +1 -0
  487. package/dist/state/write/operations.js +220 -0
  488. package/dist/state/write/operations.js.map +1 -0
  489. package/dist/state/write/serialize.js +2 -0
  490. package/dist/state/write/serialize.js.map +1 -0
  491. package/dist/state/write/transaction.js +787 -0
  492. package/dist/state/write/transaction.js.map +1 -0
  493. package/dist/state/write/validate.js +8 -0
  494. package/dist/state/write/validate.js.map +1 -0
  495. package/dist/upgrade/appContentRefresh.js +374 -0
  496. package/dist/upgrade/appContentRefresh.js.map +1 -0
  497. package/dist/upgrade/appModel.js +11 -6
  498. package/dist/upgrade/appModel.js.map +1 -1
  499. package/dist/upgrade/atomicWriter.js +2 -0
  500. package/dist/upgrade/atomicWriter.js.map +1 -0
  501. package/dist/upgrade/bundleEvidence.js +34 -0
  502. package/dist/upgrade/bundleEvidence.js.map +1 -0
  503. package/dist/upgrade/channels.js +27 -7
  504. package/dist/upgrade/channels.js.map +1 -1
  505. package/dist/upgrade/coexistenceProbe.js +105 -0
  506. package/dist/upgrade/coexistenceProbe.js.map +1 -0
  507. package/dist/upgrade/compatibility.js +52 -16
  508. package/dist/upgrade/compatibility.js.map +1 -1
  509. package/dist/upgrade/doctor.js +195 -193
  510. package/dist/upgrade/doctor.js.map +1 -1
  511. package/dist/upgrade/doctorClassifier.js +188 -0
  512. package/dist/upgrade/doctorClassifier.js.map +1 -0
  513. package/dist/upgrade/installedHooksRetirement.js +190 -0
  514. package/dist/upgrade/installedHooksRetirement.js.map +1 -0
  515. package/dist/upgrade/legacyAgentCleanup.js +183 -0
  516. package/dist/upgrade/legacyAgentCleanup.js.map +1 -0
  517. package/dist/upgrade/lifecycleUpgrade.js +427 -0
  518. package/dist/upgrade/lifecycleUpgrade.js.map +1 -0
  519. package/dist/upgrade/migrateArtifactsV1ToV2.js +568 -0
  520. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +1 -0
  521. package/dist/upgrade/migrateArtifactsV2ToV3.js +273 -144
  522. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -1
  523. package/dist/upgrade/nextMajorDoctor.js +156 -0
  524. package/dist/upgrade/nextMajorDoctor.js.map +1 -0
  525. package/dist/upgrade/npxPlatformStatus.js +23 -0
  526. package/dist/upgrade/npxPlatformStatus.js.map +1 -0
  527. package/dist/upgrade/projectIntegration.js +259 -104
  528. package/dist/upgrade/projectIntegration.js.map +1 -1
  529. package/dist/upgrade/projectIntegrationDecision.js +141 -0
  530. package/dist/upgrade/projectIntegrationDecision.js.map +1 -0
  531. package/dist/upgrade/runtimeMigration.js +342 -89
  532. package/dist/upgrade/runtimeMigration.js.map +1 -1
  533. package/dist/upgrade/upgradeCommands.js +8 -0
  534. package/dist/upgrade/upgradeCommands.js.map +1 -1
  535. package/dist/upgrade/upgradeLock.js +54 -0
  536. package/dist/upgrade/upgradeLock.js.map +1 -0
  537. package/dist/upgrade/upgradeOrchestrator.js +170 -46
  538. package/dist/upgrade/upgradeOrchestrator.js.map +1 -1
  539. package/dist/upgrade/upgradeSnapshot.js +93 -0
  540. package/dist/upgrade/upgradeSnapshot.js.map +1 -0
  541. package/dist/upgrade/v3CapabilitySurface.js +15 -0
  542. package/dist/upgrade/v3CapabilitySurface.js.map +1 -0
  543. package/dist/upgrade/versionResolution.js +12 -4
  544. package/dist/upgrade/versionResolution.js.map +1 -1
  545. package/dist/validate/appHomeContract.js +5 -5
  546. package/dist/validate/appHomeContract.js.map +1 -1
  547. package/dist/validate/capability.js +135 -14
  548. package/dist/validate/capability.js.map +1 -1
  549. package/dist/validate/crossCapability.js +1 -1
  550. package/dist/validate/crossCapability.js.map +1 -1
  551. package/dist/validate/lifecycleAdapters/legacyPythonParity.js +93 -0
  552. package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +1 -0
  553. package/dist/validate/lifecycleAdapters/nodeFormChecks.js +481 -0
  554. package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +1 -0
  555. package/dist/validate/lifecycleAdapters/shared.js +198 -0
  556. package/dist/validate/lifecycleAdapters/shared.js.map +1 -0
  557. package/dist/validate/lifecycleAdapters.js +91 -702
  558. package/dist/validate/lifecycleAdapters.js.map +1 -1
  559. package/dist/validate/selfAudit.js +63 -21
  560. package/dist/validate/selfAudit.js.map +1 -1
  561. package/dist/validate/vocabularyAuthority.js +303 -0
  562. package/dist/validate/vocabularyAuthority.js.map +1 -0
  563. package/package.json +30 -27
  564. package/bundle/references/v1-section-mapping.md +0 -47
  565. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  566. package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
  567. package/bundle/skills/agentera/agents/hej.toml +0 -6
  568. package/bundle/skills/agentera/agents/inspektera.toml +0 -6
  569. package/bundle/skills/agentera/agents/inspirera.toml +0 -6
  570. package/bundle/skills/agentera/agents/optimera.toml +0 -6
  571. package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
  572. package/bundle/skills/agentera/agents/planera.toml +0 -6
  573. package/bundle/skills/agentera/agents/profilera.toml +0 -6
  574. package/bundle/skills/agentera/agents/realisera.toml +0 -6
  575. package/bundle/skills/agentera/agents/resonera.toml +0 -6
  576. package/bundle/skills/agentera/agents/visionera.toml +0 -6
  577. package/bundle/skills/agentera/agents/visualisera.toml +0 -6
  578. package/bundle/skills/agentera/capabilities/dokumentera/instructions.md +0 -428
  579. package/bundle/skills/agentera/capabilities/hej/instructions.md +0 -331
  580. package/bundle/skills/agentera/capabilities/inspektera/instructions.md +0 -514
  581. package/bundle/skills/agentera/capabilities/inspirera/instructions.md +0 -280
  582. package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
  583. package/bundle/skills/agentera/capabilities/optimera/instructions.md +0 -437
  584. package/bundle/skills/agentera/capabilities/orkestrera/instructions.md +0 -433
  585. package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -107
  586. package/bundle/skills/agentera/capabilities/planera/instructions.md +0 -368
  587. package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
  588. package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
  589. package/bundle/skills/agentera/capabilities/profilera/instructions.md +0 -419
  590. package/bundle/skills/agentera/capabilities/realisera/instructions.md +0 -403
  591. package/bundle/skills/agentera/capabilities/resonera/instructions.md +0 -329
  592. package/bundle/skills/agentera/capabilities/visionera/instructions.md +0 -309
  593. package/bundle/skills/agentera/capabilities/visualisera/instructions.md +0 -400
  594. package/bundle/skills/hej/.claude-plugin/plugin.json +0 -6
  595. package/bundle/skills/hej/SKILL.md +0 -69
  596. package/bundle/skills/hej/agents/hej.toml +0 -11
  597. package/bundle/skills/hej/agents/openai.yaml +0 -8
  598. package/dist/cli/commands/backfill.js +0 -84
  599. package/dist/cli/commands/backfill.js.map +0 -1
  600. package/dist/cli/commands/state.js +0 -1012
  601. package/dist/cli/commands/state.js.map +0 -1
  602. package/dist/core/git.js +0 -43
  603. package/dist/core/git.js.map +0 -1
  604. package/dist/hooks/compaction.js +0 -935
  605. package/dist/hooks/compaction.js.map +0 -1
  606. package/dist/hooks/validateArtifact.js +0 -933
  607. package/dist/hooks/validateArtifact.js.map +0 -1
  608. package/dist/state/progressCommit.js +0 -289
  609. package/dist/state/progressCommit.js.map +0 -1
  610. /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
  611. /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
  612. /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
@@ -0,0 +1,90 @@
1
+ schema_version: agentera.runtimeLifecycleAuthority.v1
2
+ status: active_authority
3
+ decision: 92
4
+ operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
5
+ adapter_contract: references/adapters/runtime-lifecycle-adapters.yaml
6
+ retired_cleanup_contract: references/adapters/runtime-retired-resources.yaml
7
+ canonical_skill:
8
+ path: ~/.agents/skills/agentera
9
+ required_for_support_floor: true
10
+ projection_contract:
11
+ schema_version: agentera.runtimeLifecycleProjection.v1
12
+ snapshot_identity: deterministic_sha256
13
+ applicability:
14
+ - required
15
+ - conditional
16
+ - not_applicable
17
+ action_classes:
18
+ - repairable_owned
19
+ - manual_verification
20
+ - unobservable_gap
21
+ command_eligibility:
22
+ - preview
23
+ - apply
24
+ - manual
25
+ - diagnostic
26
+ shared_resource_rule: selected_and_required_by_at_least_one_selected_runtime
27
+ evidence_contract:
28
+ mandatory_fields:
29
+ - host_present
30
+ - installed
31
+ - enabled
32
+ - trusted
33
+ values:
34
+ - true
35
+ - false
36
+ - unknown
37
+ - denied
38
+ - not_applicable
39
+ trust_policy: Trust is observed only; unknown trust must never be promoted to trusted.
40
+ support_floor:
41
+ requirements:
42
+ - canonical_shared_skill_detected
43
+ - diagnosis_complete
44
+ - mandatory_evidence_resolved
45
+ evidence_rules:
46
+ unknown_or_missing_mandatory_blocks: true
47
+ denied_mandatory_trust_blocks: true
48
+ known_false_diagnoses_degraded:
49
+ - host_present
50
+ - installed
51
+ - enabled
52
+ not_applicable_scope: unobserved_conditional_surface_only
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
82
+ retired_runtime_inputs:
83
+ - id: claude
84
+ purposes:
85
+ - consent_gated_historical_import
86
+ - owned_legacy_resource_cleanup
87
+ migration_aliases:
88
+ cursor-agent:
89
+ runtime_id: cursor
90
+ surface_id: cli
@@ -0,0 +1,84 @@
1
+ schema_version: agentera.lifecycleOperationContract.v1
2
+ status: active_contract
3
+ decision: 92
4
+ scope: runtime_neutral_filesystem_resources
5
+ ownership:
6
+ manifest_schema: agentera.lifecycleOwnershipManifest.v1
7
+ ledger_schema: agentera.lifecycleOwnershipLedger.v1
8
+ owner: agentera
9
+ mutation_rule: A destination declaration is always required. Existing resources additionally require one matching whole-resource ledger record.
10
+ equality_rule: Content equality and resource names never establish ownership.
11
+ collision_rule: Pre-existing resources without matching ledger ownership are never replaced or removed.
12
+ identity_rule: Managed and published pending-create records bind the filesystem device and inode observed at publication.
13
+ removal_rule: Removal requires a matching whole-resource ledger identity and fingerprint, a pinned non-symlink parent, and Linux /proc/self/fd directory-relative access.
14
+ manual_review_guidance: The destination is not ledger-owned; review the collision manually. Agentera will not adopt it by name or equality.
15
+ interrupted_create_rule: A pending_create record may be finalized when its recorded identity and expected fingerprint match, or when the durable pre-create record survived and the exclusively declared resource is observed at the exact expected kind and fingerprint after restart.
16
+ journal_rule: Apply publishes fsynced append-only ledger snapshots atomically at final names and accepts only a contiguous sequence-one hash chain with no gaps, forks, duplicate sequences, digest mismatches, or disconnected events.
17
+ journal_statuses:
18
+ absent: No journal directory exists; preview remains zero-write and apply may publish sequence one.
19
+ clean: Every authoritative final event is complete, schema-valid, digest-valid, and connected; mutation may append the next sequence.
20
+ recoverable_terminal_tail: Exactly one syntactically incomplete final event follows the clean prefix with no successor; reads preserve the prefix but every mutation is blocked until the tail is resolved.
21
+ corrupt: Any malformed complete event, middle incomplete event, gap, fork, duplicate sequence, body or filename mismatch, digest mismatch, disconnection, or unsafe entry blocks every mutation.
22
+ recovery_rule: Restart ignores uniquely named non-authoritative publication temporaries, folds only the strict connected final chain, and re-observes each resource before retry; append never continues from a rolled-back prefix or past an unresolved final tail.
23
+ resource_states:
24
+ - exact
25
+ - modified
26
+ - missing
27
+ - legacy
28
+ - symlinked
29
+ - wrong_type
30
+ - partial_managed
31
+ - unowned
32
+ - unsafe_path
33
+ - ambiguous_ownership
34
+ plan_actions:
35
+ - create
36
+ - update
37
+ - remove
38
+ - finalize_ownership
39
+ - noop
40
+ - blocked_unowned
41
+ - action_required
42
+ apply_results:
43
+ - applied
44
+ - noop
45
+ - failed
46
+ - blocked_unowned
47
+ - skipped_dependency
48
+ - action_required
49
+ aggregate_rule: Required results other than applied or noop make the aggregate non_success.
50
+ dependency_rule: Independent operations continue after failure. Dependents skip with their failed dependency IDs.
51
+ retry_rule: Successful work replans to noop; pending and failed work retries from observed filesystem and ledger state.
52
+ preview_policy:
53
+ mode: strictly_read_only
54
+ forbidden:
55
+ - filesystem mutation
56
+ - directory creation
57
+ - locks
58
+ - temporary target files
59
+ - ownership record writes
60
+ - caches
61
+ - telemetry
62
+ - native commands
63
+ - package managers
64
+ - authentication
65
+ - trust changes
66
+ path_safety:
67
+ - Destinations must be absolute and contained by an explicit existing allowed root.
68
+ - Apply pins the allowed root and every parent through Linux /proc/self/fd, then revalidates directory identities at the final publication boundary.
69
+ - Parent symlink traversal, parent identity substitution, link-target escapes, target identity substitution, hard-linked files, wrong types, partial ownership, and ambiguous ownership require action or fail safely.
70
+ publication_policy:
71
+ supported_platform: linux_proc_self_fd
72
+ unsupported_platform_result: action_required
73
+ apply_serialization: lifecycle apply prepares a complete fsynced uniquely named lock directory and atomically renames it into final position; a complete live preparation blocks contenders, and the immutable owner record binds token, PID, Linux boot ID, and /proc process start ticks.
74
+ lock_recovery: Malformed or incomplete final locks fail closed. A complete lock is stale only when boot ID or process start ticks prove that exact owner identity is gone; release verifies the full identity and token before removing the owner record and lock directory.
75
+ journal_publication: Event bytes are fsynced under a unique non-authoritative temporary name, hard-linked atomically to the exclusive final event name, and followed by directory fsync before temporary cleanup.
76
+ create_protocol: directory-relative exclusive no-follow creation with no sibling temporary path
77
+ owned_file_update_protocol: directory-relative no-follow open, ledger and observation identity match, descriptor-local fingerprint check, in-place descriptor write, and post-write path identity check
78
+ destructive_path_mutations: owned_removal_only
79
+ destructive_path_reason: Removal is limited to declared resources whose whole-resource ledger identity and fingerprint still match through a pinned parent; every weaker case fails closed.
80
+ cleanup_rule: Publication creates no sibling temporary entry and never unlinks a colliding or replaced path; approved cleanup may unlink only the validated owned resource.
81
+ crash_boundary: Creates and owned file updates preserve the never-overwrite-unowned invariant but are not promised crash-atomic; a recorded pending identity makes partial Agentera-created files retryable.
82
+ native_policy:
83
+ install_update_auth_trust_operations: forbidden
84
+ trust_is_observed_only: true
@@ -0,0 +1,33 @@
1
+ schema_version: agentera.retiredRuntimeResources.v1
2
+ status: retired_migration_contract
3
+ decision: 92
4
+ authority: references/adapters/runtime-lifecycle-authority.yaml
5
+ operation_contract: references/adapters/runtime-lifecycle-operation-contract.yaml
6
+ policy:
7
+ active_inventory_exposure: forbidden
8
+ preview: strictly_read_only
9
+ apply_requires: explicit_approval
10
+ ownership: matching_whole_resource_legacy_ledger_identity_and_fingerprint
11
+ unsupported_platform_result: action_required
12
+ retired_runtimes:
13
+ - id: claude
14
+ display_name: Claude Code historical migration
15
+ active_runtime: false
16
+ source_product: claude-code
17
+ resources:
18
+ - id: claude.agentera-skill-link
19
+ kind: symlink
20
+ intent: remove
21
+ destination: "{home}/.claude/skills/agentera"
22
+ ledger_status: legacy
23
+ never_touch:
24
+ - "{home}/.claude/projects"
25
+ - "{home}/.claude/statsig"
26
+ - "{home}/.claude/settings.json"
27
+ - "{home}/.claude/settings.local.json"
28
+ - "{home}/.claude.json"
29
+ - "{home}/.claude/cache"
30
+ - "{home}/.claude/caches"
31
+ - "{home}/.claude/conversations"
32
+ - "{home}/.claude/credentials"
33
+ safety_note: Only the declared Agentera skill symlink may be removed, and only when a matching legacy ownership ledger still binds its identity and target fingerprint. Transcript, settings, credential, conversation, stats, cache, and ambiguous paths are never cleanup targets.
@@ -83,11 +83,11 @@ Status interpretation is intentionally split:
83
83
  | No matching records | `sparse` / `no_matching_records` | Candidate storage was readable and schema-compatible, but no supported records were extracted. Treat this as sparse coverage evidence. |
84
84
  | Successful zero-record window | `ok` / `records_extracted` with `record_count: 0` and `error_count: 0` | Extraction succeeded, but the incremental benchmark window has no records after the previous watermark. Treat this as compatible successful behavior. |
85
85
 
86
- Current known runtime caveats are extraction caveats, not CLI behavior evidence:
87
- `claude-code` is degraded by `schema_divergent` with 4836 candidates, 0 records,
88
- and 2 errors; `github-copilot` is degraded by `schema_divergent` with 1
89
- candidate, 0 records, and 1 error; `opencode` currently contributes records;
90
- `codex` can validly report `ok` with zero records and zero errors for an empty
86
+ Known active-runtime caveats are extraction caveats, not CLI behavior evidence:
87
+ `cursor` is degraded by `schema_divergent` with 4836 candidates, 0 records,
88
+ and 2 errors; `copilot` is degraded by `schema_divergent` with 1 candidate,
89
+ 0 records, and 1 error; `opencode` currently contributes records; `codex` can
90
+ validly report `ok` with zero records and zero errors for an empty
91
91
  incremental window.
92
92
 
93
93
  Runtime-store runs are incremental by default. The first run for a runtime scope
@@ -121,7 +121,7 @@ Follow this loop:
121
121
  by `raw_artifact_access_after_cli_counts` when the read is not redundant yet
122
122
  but still happens after a successful CLI state call.
123
123
  4. Map each repeated raw read to the CLI state owner. Prefer enriching existing
124
- routine commands or the `hej` composite startup result. Do not add Decision 43
124
+ routine commands or the `prime` composite startup result. Do not add Decision 43
125
125
  slash-route aliases as CLI commands.
126
126
  5. Make CLI completeness explicit. A startup-capable response should say whether
127
127
  it is complete for the requested capability, whether raw artifact reads are
@@ -15,7 +15,7 @@ boundary:
15
15
  rule: include records with timestamps strictly after committed_at
16
16
 
17
17
  section_22_compatibility:
18
- consumes_adapter_version: agentera-v2-corpus-1
18
+ consumes_adapter_version: agentera-v3-corpus-2
19
19
  required_record_families:
20
20
  - conversation_turn
21
21
  - tool_call
@@ -39,7 +39,9 @@ benchmark_execution:
39
39
  live_host_checks: forbidden_by_default
40
40
  runtime_path_approval: >-
41
41
  Running mage bench:startupState authorizes inspection of the documented
42
- default runtime stores for codex, claude-code, opencode, and github-copilot.
42
+ default active-runtime stores for codex, cursor, opencode, and copilot.
43
+ Claude history is excluded unless the caller separately supplies
44
+ --import-source claude with its concrete local path.
43
45
  Custom runtime history sources must be supplied as exact runtime labels and
44
46
  concrete filesystem paths. A generic consent flag or runtime label without
45
47
  its concrete path is insufficient for custom sources.
@@ -59,10 +61,10 @@ benchmark_execution:
59
61
 
60
62
  runtime_extraction_contract:
61
63
  supported_runtime_order:
62
- - codex
63
- - claude-code
64
64
  - opencode
65
- - github-copilot
65
+ - codex
66
+ - cursor
67
+ - copilot
66
68
  normalized_record_fields:
67
69
  required:
68
70
  - source_id
@@ -70,6 +72,9 @@ runtime_extraction_contract:
70
72
  - project_id
71
73
  - source_kind
72
74
  - runtime
75
+ - source_class
76
+ - source_product
77
+ - active_runtime
73
78
  - adapter_version
74
79
  - data
75
80
  optional:
@@ -90,16 +95,16 @@ runtime_extraction_contract:
90
95
  parsing encountered schema errors. This is extraction failure evidence,
91
96
  not a successful zero-record benchmark window.
92
97
  required_counts:
93
- - candidate_count when discovery can count candidates
98
+ - file_count when discovery can count store files
94
99
  - record_count, which may be zero or partial
95
100
  - error_count greater than zero
96
101
  current_examples:
97
- - runtime: claude-code
98
- candidate_count: 4836
102
+ - runtime: cursor
103
+ file_count: 4836
99
104
  record_count: 0
100
105
  error_count: 2
101
- - runtime: github-copilot
102
- candidate_count: 1
106
+ - runtime: copilot
107
+ file_count: 1
103
108
  record_count: 0
104
109
  error_count: 1
105
110
  no_matching_records:
@@ -110,7 +115,7 @@ runtime_extraction_contract:
110
115
  shape, but no supported message or tool records were extracted. This is
111
116
  sparse coverage evidence and remains distinct from schema divergence.
112
117
  required_counts:
113
- - candidate_count when discovery can count candidates
118
+ - file_count when discovery can count store files
114
119
  - "record_count: 0"
115
120
  - no error_count greater than zero
116
121
  successful_zero_record_window:
@@ -127,7 +132,7 @@ runtime_extraction_contract:
127
132
  - runtime: codex
128
133
  record_count: 0
129
134
  error_count: 0
130
- supported_runtimes:
135
+ source_products:
131
136
  codex:
132
137
  accepted_input_schema_classes:
133
138
  - JSONL session files containing session_meta or turn_context records
@@ -146,6 +151,9 @@ runtime_extraction_contract:
146
151
  - Do not retain cwd, project_path, store_path, file_path, raw session ids, or generated salted hashes.
147
152
  - Retain only canonical runtime labels, canonical artifact labels, bounded counts, and aggregate status fields.
148
153
  claude-code:
154
+ source_class: historical_import
155
+ active_runtime: false
156
+ inclusion_rule: explicit --import-source claude only; excluded from default active-runtime metrics
149
157
  accepted_input_schema_classes:
150
158
  - JSONL project session files with top-level role or type user/assistant events
151
159
  - JSONL message objects with nested message.role plus content/text/message content variants
@@ -180,6 +188,9 @@ runtime_extraction_contract:
180
188
  - Do not retain SQLite file paths, project paths, transcript text, raw session ids, or generated salted hashes.
181
189
  - Retain only canonical runtime labels, canonical artifact labels, bounded counts, and aggregate status fields.
182
190
  github-copilot:
191
+ runtime: copilot
192
+ source_class: active_runtime
193
+ active_runtime: true
183
194
  accepted_input_schema_classes:
184
195
  - SQLite session-store.db with sessions and turns tables
185
196
  - session id columns id, session_id, or sessionID
@@ -312,8 +323,8 @@ state_gathering_sequence:
312
323
  start_anchor: first_agentera_state_call_after_capability_related_user_turn
313
324
  capability_invocation_markers:
314
325
  - slash route such as /agentera plan or /agentera build
315
- - bare capability name such as planera, resonera, or orkestrera
316
- - natural-language capability mention such as run orkestrera
326
+ - bare capability name such as plan, discuss, or orchestrate
327
+ - natural-language capability mention such as run orchestrate
317
328
  - assistant capability intro marker
318
329
  end_anchors:
319
330
  - first_implementation_boundary
@@ -324,7 +335,7 @@ state_gathering_sequence:
324
335
 
325
336
  counted_event_classes:
326
337
  - class: cli_state_call
327
- description: Agentera state CLI reads such as hej, todo, docs, plan, progress, decisions, health, and query.
338
+ description: Agentera state CLI reads such as prime, todo, docs, plan, progress, decisions, health, and query.
328
339
  - class: raw_artifact_access
329
340
  description: Direct read, grep, or glob access to Agentera state artifacts after CLI state access.
330
341
  - class: capability_prose_read
@@ -362,17 +373,17 @@ privacy_boundary:
362
373
  - canonical_event_class
363
374
  - salted_non_reconstructable_hash
364
375
  canonical_artifact_labels:
365
- TODO.md: TODO.md
366
- CHANGELOG.md: CHANGELOG.md
367
- DESIGN.md: DESIGN.md
368
- PLAN.md: PLAN.md
369
- PROGRESS.md: PROGRESS.md
370
- DOCS.md: DOCS.md
371
- DECISIONS.md: DECISIONS.md
372
- HEALTH.md: HEALTH.md
373
- VISION.md: VISION.md
374
- OBJECTIVE.md: OBJECTIVE.md
375
- EXPERIMENTS.md: EXPERIMENTS.md
376
+ todo: todo
377
+ changelog: changelog
378
+ design: design
379
+ plan: plan
380
+ progress: progress
381
+ docs: docs
382
+ decisions: decisions
383
+ health: health
384
+ vision: vision
385
+ objective: objective
386
+ experiments: experiments
376
387
  AGENTS.md: AGENTS.md
377
388
  SKILL.md: SKILL.md
378
389
  AGENTERA_ARTIFACTS: AGENTERA_ARTIFACTS
@@ -204,9 +204,10 @@ explicit_special_cases:
204
204
  display_name: PROFILE.md
205
205
  artifact_type: global_user_state
206
206
  scope: global_user_state
207
- default_path: $PROFILERA_PROFILE_DIR/PROFILE.md
207
+ default_path: $AGENTERA_PROFILE_DIR/PROFILE.md
208
208
  path_template:
209
209
  env_precedence:
210
+ - AGENTERA_PROFILE_DIR
210
211
  - PROFILERA_PROFILE_DIR
211
212
  - XDG_DATA_HOME/agentera
212
213
  - ~/.local/share/agentera
@@ -220,11 +221,11 @@ explicit_special_cases:
220
221
  placeholder: '{date}'
221
222
  meaning: archive date or archive-safe plan suffix
222
223
  docs_yaml_can_override_path: false
223
- - artifact_id: optimera_harness
224
+ - artifact_id: optimize_harness
224
225
  display_name: harness
225
226
  artifact_type: local_harness
226
227
  scope: local_harness
227
- default_path: .agentera/optimera/<name>/harness
228
+ default_path: .agentera/optimize/<name>/harness
228
229
  path_template:
229
230
  placeholder: <name>
230
231
  meaning: active objective directory name
@@ -235,11 +236,11 @@ explicit_special_cases:
235
236
  display_name: benchmark_context
236
237
  artifact_type: cli_context
237
238
  scope: cli_context
238
- default_path: agentera prime --context optimera --format json#benchmark_context
239
+ default_path: agentera prime --context optimize --format json#benchmark_context
239
240
  producers:
240
241
  - agentera
241
242
  consumers:
242
- - optimera
243
+ - optimize
243
244
  docs_yaml_can_override_path: false
244
245
  consumer_permissions:
245
246
  cross_capability_validator:
@@ -229,7 +229,7 @@ structured_output:
229
229
  - profile
230
230
  - v1_migration
231
231
  - health
232
- - issues
232
+ - todo
233
233
  - plan
234
234
  - docs
235
235
  - progress
@@ -282,10 +282,10 @@ structured_output:
282
282
  contract can summarize planning levels, step markers, CLI-first
283
283
  orientation, raw plan artifact boundaries, full-plan review/self-audit
284
284
  requirements, handoff expectations, and the Planera prose authority
285
- boundary without reading `planera/instructions.md` at runtime. It must
286
- not introduce `agentera planera`, new top-level commands, or hidden
287
- capability-name aliases; `agentera schema` owns runtime/schema
288
- introspection rather than a capability workflow payload.
285
+ boundary without reading `packages/cli/src/capabilities/planera/instructions.ts`
286
+ at runtime. It must not introduce `agentera planera`, new top-level
287
+ commands, or hidden capability-name aliases; `agentera schema` owns
288
+ runtime/schema introspection rather than a capability workflow payload.
289
289
  orchestration_context_semantics: >-
290
290
  `agentera prime --context orkestrera --format json` may include
291
291
  orchestration_context with dependency-ready tasks, blocked task reasons,
@@ -465,7 +465,7 @@ evidence_context_target_contract:
465
465
  verified_field: header.status=complete
466
466
  - reason: Inspektera prose and schemas are validated directly; complete evidence_context covers normal evaluation startup without raw plan/progress/docs/health/TODO/decisions reads.
467
467
  paths:
468
- - skills/agentera/capabilities/inspektera/instructions.md
468
+ - packages/cli/src/capabilities/inspektera/instructions.ts
469
469
  - skills/agentera/capabilities/inspektera/schemas/artifacts.yaml
470
470
  - skills/agentera/capabilities/inspektera/schemas/validation.yaml
471
471
  raw_artifact_reads_required_for_startup: false
@@ -589,7 +589,7 @@ field_selection:
589
589
  - profile
590
590
  - v1_migration
591
591
  - health
592
- - issues
592
+ - todo
593
593
  - plan
594
594
  - docs
595
595
  - progress
@@ -755,11 +755,13 @@ verify_namespace:
755
755
  rejected_umbrella_command: smoke
756
756
  purpose: >-
757
757
  Define the supported `agentera verify` namespace so agents can run or inspect
758
- smoke and eval gates through one discoverable verification surface without
759
- guessing direct script names or unsupported capability-name CLI commands.
758
+ eval gates through one discoverable verification surface without guessing direct
759
+ script names or unsupported capability-name CLI commands.
760
760
  namespace_rationale: >-
761
761
  `agentera verify` is the public command for the evaluation gates (skills and
762
- semantic). The smoke-check family was retired in the self-contained package.
762
+ semantic) on the npm self-contained CLI. The smoke-check family is retired on
763
+ @next; run smoke maintainer harnesses on the stable Python line with
764
+ `uvx --from git+https://github.com/jgabor/agentera@main agentera check verify smoke installed-skills`.
763
765
  command_shape: agentera verify <family> <target> [--format text|json] [target options]
764
766
  supported_gate_families:
765
767
  eval:
@@ -810,9 +812,11 @@ verify_namespace:
810
812
  - skipped
811
813
  invalid_input_behavior:
812
814
  family_error: >-
813
- Unknown verify families must exit nonzero, list valid families `smoke` and
814
- `eval`, show `agentera verify <family> <target> [--format text|json]`, and
815
- include concrete examples for one smoke target and one eval target.
815
+ Unknown verify families must exit nonzero, list valid family `eval`, show
816
+ `agentera verify <family> <target> [--format text|json]`, and include a
817
+ concrete eval example. Requests for the retired `smoke` family must exit
818
+ nonzero with explicit npm-retired guidance pointing to eval verify or the
819
+ stable Python maintainer path.
816
820
  target_error: >-
817
821
  Unknown targets must exit nonzero, list valid targets for the selected family,
818
822
  show the correct family syntax, and include one concrete example for that family.
@@ -831,18 +835,17 @@ verify_namespace:
831
835
  - >-
832
836
  `agentera verify eval semantic` remains callable directly with fixture path arguments
833
837
  and existing offline semantic fixture behavior.
834
- offline default behavior plus the explicit `--real-npx` opt-in path.
835
- default behavior and explicit `--live`/`--yes` live-host opt-in behavior.
836
- observable smoke-check behavior, including current non-argparse `--help` behavior.
837
- observable local bootstrap diagnostics and failure behavior.
838
+ - >-
839
+ Retired `smoke` verify requests on the npm self-contained CLI must fail with
840
+ bounded guidance instead of invoking Python smoke harnesses.
838
841
  non_goals:
839
842
  - Do not add unsupported capability-name CLI commands such as `agentera realisera` or `agentera orkestrera`.
840
843
  - Do not reintroduce the retired smoke gate-family.
841
844
  - Do not implement D48 `validate`, `corpus`, or `usage` work.
842
845
  - Do not run live network, installed-app mutation, profile refresh, publication, push, tag, or package-update flows as part of this contract definition.
843
846
  evidence_sources:
844
- - agentera --help exposes the `verify` namespace and safe smoke/eval examples.
845
- - the verify vitest tests (packages/cli/test/cli/verify.test.ts) covers smoke success, eval success, text output, JSON output, invalid input feedback, safety boundaries, and preserved direct-script compatibility.
847
+ - agentera --help exposes the `verify` namespace and eval examples only on npm @next.
848
+ - the verify vitest tests (packages/cli/test/cli/verify.test.ts) cover eval success, smoke retirement, text output, JSON output, invalid input feedback, safety boundaries, and preserved direct-script compatibility.
846
849
  - agentera verify eval skills --help defines `--skill`, `--dry-run`, `--parallel`, `--timeout`, and `--runtime`.
847
850
  - agentera verify eval semantic --help defines fixture path inputs for offline semantic evaluation.
848
851
  usage_namespace:
@@ -877,7 +880,7 @@ usage_namespace:
877
880
  behavior: >-
878
881
  Uses the supplied Section 22 corpus.json envelope. When omitted, default
879
882
  corpus lookup remains owned by `agentera usage` and follows
880
- `PROFILERA_PROFILE_DIR/intermediate/corpus.json` before platform data-home
883
+ `AGENTERA_PROFILE_DIR/intermediate/corpus.json` before platform data-home
881
884
  defaults.
882
885
  project:
883
886
  syntax: --project VALUE
@@ -897,14 +900,14 @@ usage_namespace:
897
900
  path_contract:
898
901
  report_precedence:
899
902
  - AGENTERA_USAGE_DIR/USAGE.md
900
- - PROFILERA_PROFILE_DIR/USAGE.md
903
+ - AGENTERA_PROFILE_DIR/USAGE.md
901
904
  - platform data home agentera/USAGE.md
902
905
  corpus_precedence:
903
- - PROFILERA_PROFILE_DIR/intermediate/corpus.json
906
+ - AGENTERA_PROFILE_DIR/intermediate/corpus.json
904
907
  - platform data home agentera/intermediate/corpus.json
905
908
  test_isolation: >-
906
909
  Facade tests that exercise default text writes must set temporary
907
- `AGENTERA_USAGE_DIR` and `PROFILERA_PROFILE_DIR` values and must not write the
910
+ `AGENTERA_USAGE_DIR` and `AGENTERA_PROFILE_DIR` values and must not write the
908
911
  real user data home.
909
912
  invalid_input_behavior:
910
913
  format_error: >-
@@ -2,7 +2,7 @@ schema_version: agentera.app_lifecycle_vocabulary.v1
2
2
  status: active_authority
3
3
  decision: 54
4
4
  purpose: >-
5
- Define the app lifecycle vocabulary shared by doctor, hej, upgrade, docs,
5
+ Define the app lifecycle vocabulary shared by doctor, status, upgrade, docs,
6
6
  and tests so structured status metadata, operation verbs, deprecated aliases,
7
7
  and consumer ownership boundaries have one machine-readable source.
8
8
  sources:
@@ -12,7 +12,7 @@ sources:
12
12
  - references/cli/vocabulary.md#app-lifecycle-status-vocabulary
13
13
  scope:
14
14
  includes:
15
- - Agentera app lifecycle status metadata emitted by doctor, hej, and upgrade.
15
+ - Agentera app lifecycle status metadata emitted by doctor, status, and upgrade.
16
16
  - Upgrade workflow operation verbs for app files, data migration, and no-change outcomes.
17
17
  - Cross-major status concepts that annotate migration work without adding parallel status enums.
18
18
  - Transitional deprecated aliases needed to classify shipped or historical consumers.
@@ -155,7 +155,7 @@ operation_verbs:
155
155
  lifecycle_allowed: false
156
156
  consumer_order:
157
157
  - doctor
158
- - hej
158
+ - status
159
159
  - upgrade
160
160
  - docs
161
161
  - tests
@@ -176,7 +176,7 @@ consumers:
176
176
  - migrate
177
177
  - upgrade
178
178
  may_define_new_statuses: false
179
- hej:
179
+ status:
180
180
  owns:
181
181
  - installed app gate summary exposed in the composite state briefing.
182
182
  - recovery prompts derived from doctor and upgrade metadata.