agentera 3.0.0-dev.4 → 3.0.0-dev.41

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 (840) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +79 -22
  3. package/bundle/.agentera-npx-bundle.json +1 -1
  4. package/bundle/CHANGELOG.md +1261 -0
  5. package/bundle/DESIGN.md +229 -0
  6. package/bundle/LICENSE +201 -0
  7. package/bundle/README.md +136 -0
  8. package/bundle/UPGRADE.md +201 -0
  9. package/bundle/extract-corpus-parity.json +21 -0
  10. package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
  11. package/bundle/references/adapters/package-manifest-interface-model.yaml +42 -252
  12. package/bundle/references/adapters/package-publication.json +43 -0
  13. package/bundle/references/adapters/package-registry.yaml +20 -188
  14. package/bundle/references/adapters/package-surface-characterization.md +59 -48
  15. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
  16. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
  17. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
  18. package/bundle/references/adapters/runtime-retired-resources.yaml +97 -0
  19. package/bundle/references/analysis/benchmark.md +10 -6
  20. package/bundle/references/analysis/evidence-tier-authority.yaml +518 -0
  21. package/bundle/references/analysis/startup-measurement-contract.yaml +37 -26
  22. package/bundle/references/analysis/verification-policy.yaml +143 -0
  23. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +20 -10
  24. package/bundle/references/artifacts/glossary-entry-contract.yaml +1254 -0
  25. package/bundle/references/artifacts/state-storage-authority.yaml +2930 -0
  26. package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
  27. package/bundle/references/cli/agent-ready-state-contract.yaml +133 -71
  28. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +7 -8
  29. package/bundle/references/cli/audience-namespace-cli-migration.yaml +73 -33
  30. package/bundle/references/cli/bundle-skill-vocabulary.yaml +12 -49
  31. package/bundle/references/cli/capability-instruction-contract.yaml +96 -58
  32. package/bundle/references/cli/capability-instruction-structure.md +144 -0
  33. package/bundle/references/cli/capability-tool-classification.yaml +14 -14
  34. package/bundle/references/cli/coexistence-probe.yaml +13 -0
  35. package/bundle/references/cli/hybrid-route-contract.yaml +416 -0
  36. package/bundle/references/cli/parity-expected-actual-template.md +30 -0
  37. package/bundle/references/cli/prime-consumer-compatibility.yaml +701 -0
  38. package/bundle/references/cli/routing-execution-vocabulary.yaml +16 -38
  39. package/bundle/references/cli/routing-model.md +139 -0
  40. package/bundle/references/cli/single-name-protocol.yaml +42 -0
  41. package/bundle/references/cli/trigger-schema-enrichment.md +140 -0
  42. package/bundle/references/cli/update-channels.yaml +35 -2
  43. package/bundle/references/cli/upgrade-repair-wording.md +25 -0
  44. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +97 -0
  45. package/bundle/references/cli/vocabulary-index.yaml +23 -18
  46. package/bundle/references/cli/vocabulary.md +341 -328
  47. package/bundle/references/meta/documentation-inventory.md +10 -3
  48. package/bundle/registry.json +14 -14
  49. package/bundle/skills/agentera/SKILL.md +202 -408
  50. package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +84 -0
  51. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +2 -2
  52. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +25 -0
  53. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +37 -18
  54. package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +102 -0
  55. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +6 -5
  56. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +27 -0
  57. package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +176 -0
  58. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +12 -12
  59. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +5 -5
  60. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +16 -0
  61. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +7 -7
  62. package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +51 -0
  63. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +2 -2
  64. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +20 -0
  65. package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +144 -0
  66. package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +80 -0
  67. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +16 -0
  68. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +18 -18
  69. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +17 -17
  70. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +2 -2
  71. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +16 -0
  72. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +9 -9
  73. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +76 -0
  74. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +9 -7
  75. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +23 -0
  76. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +121 -0
  77. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +66 -0
  78. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
  79. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +23 -0
  80. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +121 -0
  81. package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +23 -0
  82. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +6 -5
  83. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +20 -0
  84. package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +115 -0
  85. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +24 -0
  86. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +16 -0
  87. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
  88. package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +73 -0
  89. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +22 -0
  90. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
  91. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +16 -16
  92. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +7 -6
  93. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +23 -0
  94. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +18 -20
  95. package/bundle/skills/agentera/capability_schema_contract.yaml +200 -37
  96. package/bundle/skills/agentera/protocol.yaml +31 -31
  97. package/bundle/skills/agentera/references/contract.md +387 -329
  98. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  99. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +5 -4
  100. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +40 -22
  101. package/bundle/skills/agentera/schemas/artifacts/design.yaml +5 -4
  102. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +15 -19
  103. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +145 -14
  104. package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +82 -0
  105. package/bundle/skills/agentera/schemas/artifacts/health.yaml +58 -21
  106. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +22 -8
  107. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +419 -33
  108. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +143 -53
  109. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +343 -31
  110. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
  111. package/dist/analytics/extractCorpus/cli.js +191 -0
  112. package/dist/analytics/extractCorpus/cli.js.map +1 -0
  113. package/dist/analytics/extractCorpus/copilotSessions.js +276 -0
  114. package/dist/analytics/extractCorpus/copilotSessions.js.map +1 -0
  115. package/dist/analytics/extractCorpus/core.js +393 -0
  116. package/dist/analytics/extractCorpus/core.js.map +1 -0
  117. package/dist/analytics/extractCorpus/corpus.js +168 -0
  118. package/dist/analytics/extractCorpus/corpus.js.map +1 -0
  119. package/dist/analytics/extractCorpus/coverageAudit.js +261 -0
  120. package/dist/analytics/extractCorpus/coverageAudit.js.map +1 -0
  121. package/dist/analytics/extractCorpus/cursorSessions.js +426 -0
  122. package/dist/analytics/extractCorpus/cursorSessions.js.map +1 -0
  123. package/dist/analytics/extractCorpus/evidenceTiers.js +604 -0
  124. package/dist/analytics/extractCorpus/evidenceTiers.js.map +1 -0
  125. package/dist/analytics/extractCorpus/extractCorpusParity.js +106 -0
  126. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +1 -0
  127. package/dist/analytics/extractCorpus/filesystemSources.js +119 -0
  128. package/dist/analytics/extractCorpus/filesystemSources.js.map +1 -0
  129. package/dist/analytics/extractCorpus/index.js +15 -0
  130. package/dist/analytics/extractCorpus/index.js.map +1 -0
  131. package/dist/analytics/extractCorpus/jsonlSessions.js +205 -0
  132. package/dist/analytics/extractCorpus/jsonlSessions.js.map +1 -0
  133. package/dist/analytics/extractCorpus/sqliteCaps.js +44 -0
  134. package/dist/analytics/extractCorpus/sqliteCaps.js.map +1 -0
  135. package/dist/analytics/extractCorpus/sqliteSessions.js +368 -0
  136. package/dist/analytics/extractCorpus/sqliteSessions.js.map +1 -0
  137. package/dist/analytics/extractCorpus/tierReader.js +109 -0
  138. package/dist/analytics/extractCorpus/tierReader.js.map +1 -0
  139. package/dist/analytics/extractCorpus.js +2 -1790
  140. package/dist/analytics/extractCorpus.js.map +1 -1
  141. package/dist/analytics/glossaryAdviceResolution.js +167 -0
  142. package/dist/analytics/glossaryAdviceResolution.js.map +1 -0
  143. package/dist/analytics/glossaryInputAcquisition.js +320 -0
  144. package/dist/analytics/glossaryInputAcquisition.js.map +1 -0
  145. package/dist/analytics/personalGlossaryAdmission.js +134 -0
  146. package/dist/analytics/personalGlossaryAdmission.js.map +1 -0
  147. package/dist/analytics/personalGlossaryProfile.js +220 -0
  148. package/dist/analytics/personalGlossaryProfile.js.map +1 -0
  149. package/dist/analytics/profileSignals.js +212 -0
  150. package/dist/analytics/profileSignals.js.map +1 -0
  151. package/dist/analytics/usageStats.js +169 -41
  152. package/dist/analytics/usageStats.js.map +1 -1
  153. package/dist/audit/terminologyDrift.js +282 -0
  154. package/dist/audit/terminologyDrift.js.map +1 -0
  155. package/dist/bin/agentera.js +3 -1
  156. package/dist/bin/agentera.js.map +1 -1
  157. package/dist/capabilities/audit/instructions.js +17 -0
  158. package/dist/capabilities/audit/instructions.js.map +1 -0
  159. package/dist/capabilities/build/instructions.js +57 -0
  160. package/dist/capabilities/build/instructions.js.map +1 -0
  161. package/dist/capabilities/design/instructions.js +5 -0
  162. package/dist/capabilities/design/instructions.js.map +1 -0
  163. package/dist/capabilities/discuss/instructions.js +30 -0
  164. package/dist/capabilities/discuss/instructions.js.map +1 -0
  165. package/dist/capabilities/document/instructions.js +12 -0
  166. package/dist/capabilities/document/instructions.js.map +1 -0
  167. package/dist/capabilities/index.js +39 -0
  168. package/dist/capabilities/index.js.map +1 -0
  169. package/dist/capabilities/optimize/instructions.js +15 -0
  170. package/dist/capabilities/optimize/instructions.js.map +1 -0
  171. package/dist/capabilities/orchestrate/instructions.js +41 -0
  172. package/dist/capabilities/orchestrate/instructions.js.map +1 -0
  173. package/dist/capabilities/plan/instructions.js +33 -0
  174. package/dist/capabilities/plan/instructions.js.map +1 -0
  175. package/dist/capabilities/profile/instructions.js +71 -0
  176. package/dist/capabilities/profile/instructions.js.map +1 -0
  177. package/dist/capabilities/research/instructions.js +6 -0
  178. package/dist/capabilities/research/instructions.js.map +1 -0
  179. package/dist/capabilities/status/instructions.js +12 -0
  180. package/dist/capabilities/status/instructions.js.map +1 -0
  181. package/dist/capabilities/status/startupInstructions.js +39 -0
  182. package/dist/capabilities/status/startupInstructions.js.map +1 -0
  183. package/dist/capabilities/vision/instructions.js +5 -0
  184. package/dist/capabilities/vision/instructions.js.map +1 -0
  185. package/dist/cli/appContext.js +30 -23
  186. package/dist/cli/appContext.js.map +1 -1
  187. package/dist/cli/argvalidate.js.map +1 -1
  188. package/dist/cli/capabilityContext/benchmark.js +565 -0
  189. package/dist/cli/capabilityContext/benchmark.js.map +1 -0
  190. package/dist/cli/capabilityContext/bespoke.js +45 -0
  191. package/dist/cli/capabilityContext/bespoke.js.map +1 -0
  192. package/dist/cli/capabilityContext/build.js +244 -0
  193. package/dist/cli/capabilityContext/build.js.map +1 -0
  194. package/dist/cli/capabilityContext/closeout.js +235 -0
  195. package/dist/cli/capabilityContext/closeout.js.map +1 -0
  196. package/dist/cli/capabilityContext/contract.js +214 -0
  197. package/dist/cli/capabilityContext/contract.js.map +1 -0
  198. package/dist/cli/capabilityContext/evidence.js +465 -0
  199. package/dist/cli/capabilityContext/evidence.js.map +1 -0
  200. package/dist/cli/capabilityContext/index.js +4 -0
  201. package/dist/cli/capabilityContext/index.js.map +1 -0
  202. package/dist/cli/capabilityContext/orchestration.js +133 -0
  203. package/dist/cli/capabilityContext/orchestration.js.map +1 -0
  204. package/dist/cli/capabilityContext/planState.js +261 -0
  205. package/dist/cli/capabilityContext/planState.js.map +1 -0
  206. package/dist/cli/capabilityContext/progress.js +143 -0
  207. package/dist/cli/capabilityContext/progress.js.map +1 -0
  208. package/dist/cli/capabilityContext/projectVerification.js +410 -0
  209. package/dist/cli/capabilityContext/projectVerification.js.map +1 -0
  210. package/dist/cli/capabilityContext/shared.js +100 -0
  211. package/dist/cli/capabilityContext/shared.js.map +1 -0
  212. package/dist/cli/capabilityContext/slim.js +153 -0
  213. package/dist/cli/capabilityContext/slim.js.map +1 -0
  214. package/dist/cli/capabilityContext/startup.js +278 -0
  215. package/dist/cli/capabilityContext/startup.js.map +1 -0
  216. package/dist/cli/capabilityContext/types.js +56 -0
  217. package/dist/cli/capabilityContext/types.js.map +1 -0
  218. package/dist/cli/capabilityContext.js +1 -2420
  219. package/dist/cli/capabilityContext.js.map +1 -1
  220. package/dist/cli/commands/appHome.js +23 -0
  221. package/dist/cli/commands/appHome.js.map +1 -0
  222. package/dist/cli/commands/capability.js +3 -10
  223. package/dist/cli/commands/capability.js.map +1 -1
  224. package/dist/cli/commands/compact.js +41 -12
  225. package/dist/cli/commands/compact.js.map +1 -1
  226. package/dist/cli/commands/doctor.js +34 -99
  227. package/dist/cli/commands/doctor.js.map +1 -1
  228. package/dist/cli/commands/durability.js +82 -0
  229. package/dist/cli/commands/durability.js.map +1 -0
  230. package/dist/cli/commands/entityMigrate.js +132 -0
  231. package/dist/cli/commands/entityMigrate.js.map +1 -0
  232. package/dist/cli/commands/glossaryAdvice.js +139 -0
  233. package/dist/cli/commands/glossaryAdvice.js.map +1 -0
  234. package/dist/cli/commands/lint.js +26 -43
  235. package/dist/cli/commands/lint.js.map +1 -1
  236. package/dist/cli/commands/personalGlossary.js +177 -0
  237. package/dist/cli/commands/personalGlossary.js.map +1 -0
  238. package/dist/cli/commands/prime/briefOrientation.js +808 -0
  239. package/dist/cli/commands/prime/briefOrientation.js.map +1 -0
  240. package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
  241. package/dist/cli/commands/prime/buildExecutionRequest.js.map +1 -0
  242. package/dist/cli/commands/prime/bundleStatus.js +191 -0
  243. package/dist/cli/commands/prime/bundleStatus.js.map +1 -0
  244. package/dist/cli/commands/prime/collectEntityOrientation.js +291 -0
  245. package/dist/cli/commands/prime/collectEntityOrientation.js.map +1 -0
  246. package/dist/cli/commands/prime/collectOrientationState.js +178 -0
  247. package/dist/cli/commands/prime/collectOrientationState.js.map +1 -0
  248. package/dist/cli/commands/prime/orientationOutput.js +377 -0
  249. package/dist/cli/commands/prime/orientationOutput.js.map +1 -0
  250. package/dist/cli/commands/prime/types.js +2 -0
  251. package/dist/cli/commands/prime/types.js.map +1 -0
  252. package/dist/cli/commands/prime/v1Migration.js +39 -0
  253. package/dist/cli/commands/prime/v1Migration.js.map +1 -0
  254. package/dist/cli/commands/prime.js +96 -556
  255. package/dist/cli/commands/prime.js.map +1 -1
  256. package/dist/cli/commands/profileGrounding.js +56 -0
  257. package/dist/cli/commands/profileGrounding.js.map +1 -0
  258. package/dist/cli/commands/query.js +77 -52
  259. package/dist/cli/commands/query.js.map +1 -1
  260. package/dist/cli/commands/report.js +96 -24
  261. package/dist/cli/commands/report.js.map +1 -1
  262. package/dist/cli/commands/route.js +142 -0
  263. package/dist/cli/commands/route.js.map +1 -0
  264. package/dist/cli/commands/schema.js +258 -105
  265. package/dist/cli/commands/schema.js.map +1 -1
  266. package/dist/cli/commands/state/decisions.js +388 -0
  267. package/dist/cli/commands/state/decisions.js.map +1 -0
  268. package/dist/cli/commands/state/docs.js +71 -0
  269. package/dist/cli/commands/state/docs.js.map +1 -0
  270. package/dist/cli/commands/state/experimentRecords.js +152 -0
  271. package/dist/cli/commands/state/experimentRecords.js.map +1 -0
  272. package/dist/cli/commands/state/experiments.js +15 -0
  273. package/dist/cli/commands/state/experiments.js.map +1 -0
  274. package/dist/cli/commands/state/get.js +130 -0
  275. package/dist/cli/commands/state/get.js.map +1 -0
  276. package/dist/cli/commands/state/health.js +15 -0
  277. package/dist/cli/commands/state/health.js.map +1 -0
  278. package/dist/cli/commands/state/index.js +17 -0
  279. package/dist/cli/commands/state/index.js.map +1 -0
  280. package/dist/cli/commands/state/list.js +195 -0
  281. package/dist/cli/commands/state/list.js.map +1 -0
  282. package/dist/cli/commands/state/objective.js +26 -0
  283. package/dist/cli/commands/state/objective.js.map +1 -0
  284. package/dist/cli/commands/state/plan.js +15 -0
  285. package/dist/cli/commands/state/plan.js.map +1 -0
  286. package/dist/cli/commands/state/planTasks.js +155 -0
  287. package/dist/cli/commands/state/planTasks.js.map +1 -0
  288. package/dist/cli/commands/state/plans.js +155 -0
  289. package/dist/cli/commands/state/plans.js.map +1 -0
  290. package/dist/cli/commands/state/progress.js +14 -0
  291. package/dist/cli/commands/state/progress.js.map +1 -0
  292. package/dist/cli/commands/state/shared.js +15 -0
  293. package/dist/cli/commands/state/shared.js.map +1 -0
  294. package/dist/cli/commands/state/todo.js +43 -0
  295. package/dist/cli/commands/state/todo.js.map +1 -0
  296. package/dist/cli/commands/state/write.js +425 -0
  297. package/dist/cli/commands/state/write.js.map +1 -0
  298. package/dist/cli/commands/upgrade.js +146 -4
  299. package/dist/cli/commands/upgrade.js.map +1 -1
  300. package/dist/cli/commands/upgradeVerify.js +119 -0
  301. package/dist/cli/commands/upgradeVerify.js.map +1 -0
  302. package/dist/cli/commands/validate.js +173 -210
  303. package/dist/cli/commands/validate.js.map +1 -1
  304. package/dist/cli/commands/verify.js +24 -8
  305. package/dist/cli/commands/verify.js.map +1 -1
  306. package/dist/cli/contracts/bundleStatus.js +2 -0
  307. package/dist/cli/contracts/bundleStatus.js.map +1 -0
  308. package/dist/cli/contracts/orientationState.js +2 -0
  309. package/dist/cli/contracts/orientationState.js.map +1 -0
  310. package/dist/cli/dispatch/argvParser.js +33 -0
  311. package/dist/cli/dispatch/argvParser.js.map +1 -0
  312. package/dist/cli/dispatch/check.js +390 -0
  313. package/dist/cli/dispatch/check.js.map +1 -0
  314. package/dist/cli/dispatch/commands.js +27 -0
  315. package/dist/cli/dispatch/commands.js.map +1 -0
  316. package/dist/cli/dispatch/index.js +234 -0
  317. package/dist/cli/dispatch/index.js.map +1 -0
  318. package/dist/cli/dispatch/lifecycle.js +698 -0
  319. package/dist/cli/dispatch/lifecycle.js.map +1 -0
  320. package/dist/cli/dispatch/prime.js +140 -0
  321. package/dist/cli/dispatch/prime.js.map +1 -0
  322. package/dist/cli/dispatch/shared.js +64 -0
  323. package/dist/cli/dispatch/shared.js.map +1 -0
  324. package/dist/cli/dispatch/state.js +141 -0
  325. package/dist/cli/dispatch/state.js.map +1 -0
  326. package/dist/cli/dispatch.js +1 -995
  327. package/dist/cli/dispatch.js.map +1 -1
  328. package/dist/cli/errors.js +53 -0
  329. package/dist/cli/errors.js.map +1 -0
  330. package/dist/cli/help.js +356 -30
  331. package/dist/cli/help.js.map +1 -1
  332. package/dist/cli/migrationRequired.js +89 -0
  333. package/dist/cli/migrationRequired.js.map +1 -0
  334. package/dist/cli/orientation/attention.js +72 -0
  335. package/dist/cli/orientation/attention.js.map +1 -0
  336. package/dist/cli/orientation/corpusCoverage.js +103 -0
  337. package/dist/cli/orientation/corpusCoverage.js.map +1 -0
  338. package/dist/cli/orientation.js +443 -172
  339. package/dist/cli/orientation.js.map +1 -1
  340. package/dist/cli/planArtifacts.js +351 -0
  341. package/dist/cli/planArtifacts.js.map +1 -0
  342. package/dist/cli/planEvidence.js +158 -0
  343. package/dist/cli/planEvidence.js.map +1 -0
  344. package/dist/cli/planLifecycleState.js +36 -0
  345. package/dist/cli/planLifecycleState.js.map +1 -0
  346. package/dist/cli/planTaskIndex.js +12 -0
  347. package/dist/cli/planTaskIndex.js.map +1 -0
  348. package/dist/cli/prime-blob.js +70 -2
  349. package/dist/cli/prime-blob.js.map +1 -1
  350. package/dist/cli/profileAcquisition.js +168 -0
  351. package/dist/cli/profileAcquisition.js.map +1 -0
  352. package/dist/cli/startupCompletenessContract.js +60 -0
  353. package/dist/cli/startupCompletenessContract.js.map +1 -0
  354. package/dist/cli/stateQuery.js +63 -10
  355. package/dist/cli/stateQuery.js.map +1 -1
  356. package/dist/cli/structured.js.map +1 -1
  357. package/dist/cli/todoMarkdown.js +47 -0
  358. package/dist/cli/todoMarkdown.js.map +1 -0
  359. package/dist/cli/todoReadinessSelection.js +192 -0
  360. package/dist/cli/todoReadinessSelection.js.map +1 -0
  361. package/dist/cli/todoSeverity.js +19 -0
  362. package/dist/cli/todoSeverity.js.map +1 -0
  363. package/dist/core/atomicWriter.js +21 -0
  364. package/dist/core/atomicWriter.js.map +1 -0
  365. package/dist/core/difflib.js.map +1 -1
  366. package/dist/core/envPaths.js +21 -0
  367. package/dist/core/envPaths.js.map +1 -0
  368. package/dist/core/jsonValue.js +6 -0
  369. package/dist/core/jsonValue.js.map +1 -0
  370. package/dist/core/paths.js.map +1 -1
  371. package/dist/core/pyjson.js +67 -2
  372. package/dist/core/pyjson.js.map +1 -1
  373. package/dist/core/shell.js +5 -0
  374. package/dist/core/shell.js.map +1 -0
  375. package/dist/core/skillIdentity.js +24 -0
  376. package/dist/core/skillIdentity.js.map +1 -0
  377. package/dist/core/sourceRoot.js.map +1 -1
  378. package/dist/core/text.js +11 -0
  379. package/dist/core/text.js.map +1 -0
  380. package/dist/core/toml.js.map +1 -1
  381. package/dist/core/yaml.js +8 -0
  382. package/dist/core/yaml.js.map +1 -1
  383. package/dist/eval/evalSkills.js +30 -25
  384. package/dist/eval/evalSkills.js.map +1 -1
  385. package/dist/eval/hybridRouteEvaluation.js +156 -0
  386. package/dist/eval/hybridRouteEvaluation.js.map +1 -0
  387. package/dist/eval/semanticEval.js +43 -19
  388. package/dist/eval/semanticEval.js.map +1 -1
  389. package/dist/eval/semanticFixtures.js +16 -4
  390. package/dist/eval/semanticFixtures.js.map +1 -1
  391. package/dist/hooks/common.js +10 -27
  392. package/dist/hooks/common.js.map +1 -1
  393. package/dist/hooks/compaction/apply.js +447 -0
  394. package/dist/hooks/compaction/apply.js.map +1 -0
  395. package/dist/hooks/compaction/dryRun.js +185 -0
  396. package/dist/hooks/compaction/dryRun.js.map +1 -0
  397. package/dist/hooks/compaction/index.js +23 -0
  398. package/dist/hooks/compaction/index.js.map +1 -0
  399. package/dist/hooks/compaction/parse.js +326 -0
  400. package/dist/hooks/compaction/parse.js.map +1 -0
  401. package/dist/hooks/compaction/retention.js +203 -0
  402. package/dist/hooks/compaction/retention.js.map +1 -0
  403. package/dist/hooks/compaction/status.js +361 -0
  404. package/dist/hooks/compaction/status.js.map +1 -0
  405. package/dist/hooks/compaction/types.js +6 -0
  406. package/dist/hooks/compaction/types.js.map +1 -0
  407. package/dist/hooks/cursorPreToolUse.js +1 -1
  408. package/dist/hooks/cursorPreToolUse.js.map +1 -1
  409. package/dist/hooks/cursorSessionStart.js +14 -21
  410. package/dist/hooks/cursorSessionStart.js.map +1 -1
  411. package/dist/hooks/projectHookInput.js +26 -0
  412. package/dist/hooks/projectHookInput.js.map +1 -0
  413. package/dist/hooks/sessionStart.js +55 -170
  414. package/dist/hooks/sessionStart.js.map +1 -1
  415. package/dist/hooks/sessionStop.js +12 -26
  416. package/dist/hooks/sessionStop.js.map +1 -1
  417. package/dist/hooks/validateArtifact/agentFacing.js +10 -0
  418. package/dist/hooks/validateArtifact/agentFacing.js.map +1 -0
  419. package/dist/hooks/validateArtifact/index.js +151 -0
  420. package/dist/hooks/validateArtifact/index.js.map +1 -0
  421. package/dist/hooks/validateArtifact/markdown.js +146 -0
  422. package/dist/hooks/validateArtifact/markdown.js.map +1 -0
  423. package/dist/hooks/validateArtifact/runtime.js +86 -0
  424. package/dist/hooks/validateArtifact/runtime.js.map +1 -0
  425. package/dist/hooks/validateArtifact/schema.js +547 -0
  426. package/dist/hooks/validateArtifact/schema.js.map +1 -0
  427. package/dist/hooks/validateArtifact/traversal.js +108 -0
  428. package/dist/hooks/validateArtifact/traversal.js.map +1 -0
  429. package/dist/hooks/validateArtifact/violations.js +108 -0
  430. package/dist/hooks/validateArtifact/violations.js.map +1 -0
  431. package/dist/migrate/v2HandoffManifest.js +455 -0
  432. package/dist/migrate/v2HandoffManifest.js.map +1 -0
  433. package/dist/registries/artifactProtocolIds.js +79 -0
  434. package/dist/registries/artifactProtocolIds.js.map +1 -0
  435. package/dist/registries/artifactRegistry.js +224 -62
  436. package/dist/registries/artifactRegistry.js.map +1 -1
  437. package/dist/registries/artifactSchemaProjection.js +46 -0
  438. package/dist/registries/artifactSchemaProjection.js.map +1 -0
  439. package/dist/registries/capabilityContract.js +141 -12
  440. package/dist/registries/capabilityContract.js.map +1 -1
  441. package/dist/registries/evaluatorHandoffContract.js +171 -0
  442. package/dist/registries/evaluatorHandoffContract.js.map +1 -0
  443. package/dist/registries/evidenceTierContract.js +372 -0
  444. package/dist/registries/evidenceTierContract.js.map +1 -0
  445. package/dist/registries/glossaryAdviceContract.js +79 -0
  446. package/dist/registries/glossaryAdviceContract.js.map +1 -0
  447. package/dist/registries/glossaryCaveatContract.js +68 -0
  448. package/dist/registries/glossaryCaveatContract.js.map +1 -0
  449. package/dist/registries/glossaryConsumerContractValidation.js +788 -0
  450. package/dist/registries/glossaryConsumerContractValidation.js.map +1 -0
  451. package/dist/registries/glossaryEntryContract.js +757 -0
  452. package/dist/registries/glossaryEntryContract.js.map +1 -0
  453. package/dist/registries/glossaryTermIdentity.js +18 -0
  454. package/dist/registries/glossaryTermIdentity.js.map +1 -0
  455. package/dist/registries/glossaryTermOccurrence.js +21 -0
  456. package/dist/registries/glossaryTermOccurrence.js.map +1 -0
  457. package/dist/registries/hybridRoute.js +203 -0
  458. package/dist/registries/hybridRoute.js.map +1 -0
  459. package/dist/registries/hybridRouteReceipt.js +221 -0
  460. package/dist/registries/hybridRouteReceipt.js.map +1 -0
  461. package/dist/registries/packageRegistry.js +90 -230
  462. package/dist/registries/packageRegistry.js.map +1 -1
  463. package/dist/registries/todoReadinessContract.js +449 -0
  464. package/dist/registries/todoReadinessContract.js.map +1 -0
  465. package/dist/registries/triggerLoader.js +175 -0
  466. package/dist/registries/triggerLoader.js.map +1 -0
  467. package/dist/registries/verbosityBudgetContract.js +206 -0
  468. package/dist/registries/verbosityBudgetContract.js.map +1 -0
  469. package/dist/release/releaseMetadata.js +319 -0
  470. package/dist/release/releaseMetadata.js.map +1 -0
  471. package/dist/runtime/lifecycleAdapterContract.js +458 -0
  472. package/dist/runtime/lifecycleAdapterContract.js.map +1 -0
  473. package/dist/runtime/lifecycleAdapters.js +778 -0
  474. package/dist/runtime/lifecycleAdapters.js.map +1 -0
  475. package/dist/runtime/lifecycleAuthority.js +454 -0
  476. package/dist/runtime/lifecycleAuthority.js.map +1 -0
  477. package/dist/runtime/lifecycleOperationContract.js +114 -0
  478. package/dist/runtime/lifecycleOperationContract.js.map +1 -0
  479. package/dist/runtime/lifecycleOperations.js +635 -0
  480. package/dist/runtime/lifecycleOperations.js.map +1 -0
  481. package/dist/runtime/lifecycleOwnershipJournal.js +623 -0
  482. package/dist/runtime/lifecycleOwnershipJournal.js.map +1 -0
  483. package/dist/runtime/lifecyclePublication.js +416 -0
  484. package/dist/runtime/lifecyclePublication.js.map +1 -0
  485. package/dist/runtime/lifecycleSnapshot.js +439 -0
  486. package/dist/runtime/lifecycleSnapshot.js.map +1 -0
  487. package/dist/runtime/nativeResourceCleanup.js +317 -0
  488. package/dist/runtime/nativeResourceCleanup.js.map +1 -0
  489. package/dist/setup/codex/cli.js +130 -0
  490. package/dist/setup/codex/cli.js.map +1 -0
  491. package/dist/setup/codex/configToml.js +558 -0
  492. package/dist/setup/codex/configToml.js.map +1 -0
  493. package/dist/setup/codex/constants.js +14 -0
  494. package/dist/setup/codex/constants.js.map +1 -0
  495. package/dist/setup/codex/installRoot.js +64 -0
  496. package/dist/setup/codex/installRoot.js.map +1 -0
  497. package/dist/setup/codex/state.js +252 -0
  498. package/dist/setup/codex/state.js.map +1 -0
  499. package/dist/setup/codex.js +9 -1055
  500. package/dist/setup/codex.js.map +1 -1
  501. package/dist/setup/opencode.js +21 -0
  502. package/dist/setup/opencode.js.map +1 -0
  503. package/dist/setup/opencodeConstants.js +2 -0
  504. package/dist/setup/opencodeConstants.js.map +1 -0
  505. package/dist/setup/sharedSkill.js +46 -0
  506. package/dist/setup/sharedSkill.js.map +1 -0
  507. package/dist/setup/smokeChecks.js +24 -53
  508. package/dist/setup/smokeChecks.js.map +1 -1
  509. package/dist/state/archiveDiscovery.js +581 -0
  510. package/dist/state/archiveDiscovery.js.map +1 -0
  511. package/dist/state/archivePublication.js +226 -0
  512. package/dist/state/archivePublication.js.map +1 -0
  513. package/dist/state/archiveRecovery.js +238 -0
  514. package/dist/state/archiveRecovery.js.map +1 -0
  515. package/dist/state/archiveReplay.js +54 -0
  516. package/dist/state/archiveReplay.js.map +1 -0
  517. package/dist/state/canonicalMigrationRecord.js +37 -0
  518. package/dist/state/canonicalMigrationRecord.js.map +1 -0
  519. package/dist/state/changelog.js +222 -0
  520. package/dist/state/changelog.js.map +1 -0
  521. package/dist/state/decisionEntities.js +368 -0
  522. package/dist/state/decisionEntities.js.map +1 -0
  523. package/dist/state/decisionLegacyValidation.js +216 -0
  524. package/dist/state/decisionLegacyValidation.js.map +1 -0
  525. package/dist/state/decisionMigrationProvenance.js +200 -0
  526. package/dist/state/decisionMigrationProvenance.js.map +1 -0
  527. package/dist/state/decisionOverlay.js +255 -0
  528. package/dist/state/decisionOverlay.js.map +1 -0
  529. package/dist/state/decisionRevision.js +257 -0
  530. package/dist/state/decisionRevision.js.map +1 -0
  531. package/dist/state/decisionRevisionMigration.js +90 -0
  532. package/dist/state/decisionRevisionMigration.js.map +1 -0
  533. package/dist/state/directRetrieval.js +324 -0
  534. package/dist/state/directRetrieval.js.map +1 -0
  535. package/dist/state/durability.js +325 -0
  536. package/dist/state/durability.js.map +1 -0
  537. package/dist/state/entityCutover.js +294 -0
  538. package/dist/state/entityCutover.js.map +1 -0
  539. package/dist/state/entityCutoverGit.js +128 -0
  540. package/dist/state/entityCutoverGit.js.map +1 -0
  541. package/dist/state/entityGlossaryAuthority.js +14 -0
  542. package/dist/state/entityGlossaryAuthority.js.map +1 -0
  543. package/dist/state/entityListProjection.js +188 -0
  544. package/dist/state/entityListProjection.js.map +1 -0
  545. package/dist/state/entityListRuntimeRegistry.js +50 -0
  546. package/dist/state/entityListRuntimeRegistry.js.map +1 -0
  547. package/dist/state/entityMigrationCausality.js +99 -0
  548. package/dist/state/entityMigrationCausality.js.map +1 -0
  549. package/dist/state/entityMigrationIdentity.js +6 -0
  550. package/dist/state/entityMigrationIdentity.js.map +1 -0
  551. package/dist/state/entityMigrationPreview.js +884 -0
  552. package/dist/state/entityMigrationPreview.js.map +1 -0
  553. package/dist/state/entityPublicationContext.js +807 -0
  554. package/dist/state/entityPublicationContext.js.map +1 -0
  555. package/dist/state/entityRetrievalHelp.js +476 -0
  556. package/dist/state/entityRetrievalHelp.js.map +1 -0
  557. package/dist/state/entityStorage.js +897 -0
  558. package/dist/state/entityStorage.js.map +1 -0
  559. package/dist/state/exactReplacementRecovery.js +19 -0
  560. package/dist/state/exactReplacementRecovery.js.map +1 -0
  561. package/dist/state/experimentArchive.js +64 -0
  562. package/dist/state/experimentArchive.js.map +1 -0
  563. package/dist/state/experimentIdentity.js +203 -0
  564. package/dist/state/experimentIdentity.js.map +1 -0
  565. package/dist/state/healthEntities.js +263 -0
  566. package/dist/state/healthEntities.js.map +1 -0
  567. package/dist/state/healthEntityValidation.js +19 -0
  568. package/dist/state/healthEntityValidation.js.map +1 -0
  569. package/dist/state/healthRepair.js +70 -0
  570. package/dist/state/healthRepair.js.map +1 -0
  571. package/dist/state/installRoot.js +64 -24
  572. package/dist/state/installRoot.js.map +1 -1
  573. package/dist/state/legacyEntityCutoverEvidence.js +66 -0
  574. package/dist/state/legacyEntityCutoverEvidence.js.map +1 -0
  575. package/dist/state/legacyIdentity.js +48 -0
  576. package/dist/state/legacyIdentity.js.map +1 -0
  577. package/dist/state/legacySummaryRecord.js +7 -0
  578. package/dist/state/legacySummaryRecord.js.map +1 -0
  579. package/dist/state/listAccounting.js +55 -0
  580. package/dist/state/listAccounting.js.map +1 -0
  581. package/dist/state/listClassification.js +18 -0
  582. package/dist/state/listClassification.js.map +1 -0
  583. package/dist/state/listCursor.js +43 -0
  584. package/dist/state/listCursor.js.map +1 -0
  585. package/dist/state/listRetrieval.js +782 -0
  586. package/dist/state/listRetrieval.js.map +1 -0
  587. package/dist/state/migrationSourceBinding.js +31 -0
  588. package/dist/state/migrationSourceBinding.js.map +1 -0
  589. package/dist/state/objectiveExperimentEntities.js +323 -0
  590. package/dist/state/objectiveExperimentEntities.js.map +1 -0
  591. package/dist/state/planEntities.js +531 -0
  592. package/dist/state/planEntities.js.map +1 -0
  593. package/dist/state/planIdentity.js +48 -0
  594. package/dist/state/planIdentity.js.map +1 -0
  595. package/dist/state/planRetrieval.js +314 -0
  596. package/dist/state/planRetrieval.js.map +1 -0
  597. package/dist/state/planTaskRetrieval.js +295 -0
  598. package/dist/state/planTaskRetrieval.js.map +1 -0
  599. package/dist/state/progressEntities.js +513 -0
  600. package/dist/state/progressEntities.js.map +1 -0
  601. package/dist/state/progressGlossaryCaveat.js +169 -0
  602. package/dist/state/progressGlossaryCaveat.js.map +1 -0
  603. package/dist/state/progressPublicationOrder.js +20 -0
  604. package/dist/state/progressPublicationOrder.js.map +1 -0
  605. package/dist/state/projectRoot.js +63 -0
  606. package/dist/state/projectRoot.js.map +1 -0
  607. package/dist/state/projectionPolicy.js +191 -0
  608. package/dist/state/projectionPolicy.js.map +1 -0
  609. package/dist/state/retrievalAuthority.js +157 -0
  610. package/dist/state/retrievalAuthority.js.map +1 -0
  611. package/dist/state/safeProjectFile.js +156 -0
  612. package/dist/state/safeProjectFile.js.map +1 -0
  613. package/dist/state/startupAnalysis/benchmark.js +433 -0
  614. package/dist/state/startupAnalysis/benchmark.js.map +1 -0
  615. package/dist/state/startupAnalysis/contract.js +126 -0
  616. package/dist/state/startupAnalysis/contract.js.map +1 -0
  617. package/dist/state/startupAnalysis/helpers.js +287 -0
  618. package/dist/state/startupAnalysis/helpers.js.map +1 -0
  619. package/dist/state/startupAnalysis/index.js +7 -0
  620. package/dist/state/startupAnalysis/index.js.map +1 -0
  621. package/dist/state/startupAnalysis/metrics.js +341 -0
  622. package/dist/state/startupAnalysis/metrics.js.map +1 -0
  623. package/dist/state/startupAnalysis/records.js +199 -0
  624. package/dist/state/startupAnalysis/records.js.map +1 -0
  625. package/dist/state/startupAnalysis/report.js +112 -0
  626. package/dist/state/startupAnalysis/report.js.map +1 -0
  627. package/dist/state/startupAnalysis/threshold.js +513 -0
  628. package/dist/state/startupAnalysis/threshold.js.map +1 -0
  629. package/dist/state/startupAnalysis.js +2 -1952
  630. package/dist/state/startupAnalysis.js.map +1 -1
  631. package/dist/state/startupProjection.js +499 -0
  632. package/dist/state/startupProjection.js.map +1 -0
  633. package/dist/state/stateMode.js +86 -0
  634. package/dist/state/stateMode.js.map +1 -0
  635. package/dist/state/stateStorageAuthority.js +48 -0
  636. package/dist/state/stateStorageAuthority.js.map +1 -0
  637. package/dist/state/summaryEntityRead.js +26 -0
  638. package/dist/state/summaryEntityRead.js.map +1 -0
  639. package/dist/state/summaryMigrationProvenance.js +67 -0
  640. package/dist/state/summaryMigrationProvenance.js.map +1 -0
  641. package/dist/state/summarySourceRowAuthority.js +37 -0
  642. package/dist/state/summarySourceRowAuthority.js.map +1 -0
  643. package/dist/state/todoDocsEntities.js +986 -0
  644. package/dist/state/todoDocsEntities.js.map +1 -0
  645. package/dist/state/todoDocsEntityValidation.js +159 -0
  646. package/dist/state/todoDocsEntityValidation.js.map +1 -0
  647. package/dist/state/todoReconciliationActivation.js +63 -0
  648. package/dist/state/todoReconciliationActivation.js.map +1 -0
  649. package/dist/state/todoReconciliationTransaction.js +554 -0
  650. package/dist/state/todoReconciliationTransaction.js.map +1 -0
  651. package/dist/state/write/assign.js +21 -0
  652. package/dist/state/write/assign.js.map +1 -0
  653. package/dist/state/write/candidateMutation.js +270 -0
  654. package/dist/state/write/candidateMutation.js.map +1 -0
  655. package/dist/state/write/errors.js +12 -0
  656. package/dist/state/write/errors.js.map +1 -0
  657. package/dist/state/write/experimentPublication.js +193 -0
  658. package/dist/state/write/experimentPublication.js.map +1 -0
  659. package/dist/state/write/explain.js +333 -0
  660. package/dist/state/write/explain.js.map +1 -0
  661. package/dist/state/write/fields.js +62 -0
  662. package/dist/state/write/fields.js.map +1 -0
  663. package/dist/state/write/glossaryPublication.js +264 -0
  664. package/dist/state/write/glossaryPublication.js.map +1 -0
  665. package/dist/state/write/grammar.js +271 -0
  666. package/dist/state/write/grammar.js.map +1 -0
  667. package/dist/state/write/helpers.js +30 -0
  668. package/dist/state/write/helpers.js.map +1 -0
  669. package/dist/state/write/index.js +13 -0
  670. package/dist/state/write/index.js.map +1 -0
  671. package/dist/state/write/input.js +368 -0
  672. package/dist/state/write/input.js.map +1 -0
  673. package/dist/state/write/lock.js +838 -0
  674. package/dist/state/write/lock.js.map +1 -0
  675. package/dist/state/write/mutation.js +235 -0
  676. package/dist/state/write/mutation.js.map +1 -0
  677. package/dist/state/write/operations.js +170 -0
  678. package/dist/state/write/operations.js.map +1 -0
  679. package/dist/state/write/planEvaluation.js +129 -0
  680. package/dist/state/write/planEvaluation.js.map +1 -0
  681. package/dist/state/write/planPublication.js +180 -0
  682. package/dist/state/write/planPublication.js.map +1 -0
  683. package/dist/state/write/runtimeOperations.js +65 -0
  684. package/dist/state/write/runtimeOperations.js.map +1 -0
  685. package/dist/state/write/serialize.js +2 -0
  686. package/dist/state/write/serialize.js.map +1 -0
  687. package/dist/state/write/transaction.js +53 -0
  688. package/dist/state/write/transaction.js.map +1 -0
  689. package/dist/state/write/validate.js +8 -0
  690. package/dist/state/write/validate.js.map +1 -0
  691. package/dist/upgrade/appContentRefresh.js +384 -0
  692. package/dist/upgrade/appContentRefresh.js.map +1 -0
  693. package/dist/upgrade/appModel.js +8 -6
  694. package/dist/upgrade/appModel.js.map +1 -1
  695. package/dist/upgrade/atomicWriter.js +2 -0
  696. package/dist/upgrade/atomicWriter.js.map +1 -0
  697. package/dist/upgrade/bundleEvidence.js +34 -0
  698. package/dist/upgrade/bundleEvidence.js.map +1 -0
  699. package/dist/upgrade/channels.js +12 -7
  700. package/dist/upgrade/channels.js.map +1 -1
  701. package/dist/upgrade/coexistenceProbe.js +105 -0
  702. package/dist/upgrade/coexistenceProbe.js.map +1 -0
  703. package/dist/upgrade/compatibility.js +56 -20
  704. package/dist/upgrade/compatibility.js.map +1 -1
  705. package/dist/upgrade/doctor.js +197 -191
  706. package/dist/upgrade/doctor.js.map +1 -1
  707. package/dist/upgrade/doctorClassifier.js +188 -0
  708. package/dist/upgrade/doctorClassifier.js.map +1 -0
  709. package/dist/upgrade/installedHooksRetirement.js +197 -0
  710. package/dist/upgrade/installedHooksRetirement.js.map +1 -0
  711. package/dist/upgrade/legacyAgentCleanup.js +283 -0
  712. package/dist/upgrade/legacyAgentCleanup.js.map +1 -0
  713. package/dist/upgrade/lifecycleUpgrade.js +114 -0
  714. package/dist/upgrade/lifecycleUpgrade.js.map +1 -0
  715. package/dist/upgrade/migrateArtifactsV2ToV3.js +363 -137
  716. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -1
  717. package/dist/upgrade/migrationPublication.js +123 -0
  718. package/dist/upgrade/migrationPublication.js.map +1 -0
  719. package/dist/upgrade/nextMajorDoctor.js +156 -0
  720. package/dist/upgrade/nextMajorDoctor.js.map +1 -0
  721. package/dist/upgrade/npxPlatformStatus.js +23 -0
  722. package/dist/upgrade/npxPlatformStatus.js.map +1 -0
  723. package/dist/upgrade/projectIntegration.js +142 -171
  724. package/dist/upgrade/projectIntegration.js.map +1 -1
  725. package/dist/upgrade/projectIntegrationDecision.js +51 -0
  726. package/dist/upgrade/projectIntegrationDecision.js.map +1 -0
  727. package/dist/upgrade/runtimeMigration.js +336 -281
  728. package/dist/upgrade/runtimeMigration.js.map +1 -1
  729. package/dist/upgrade/upgradeCommands.js +9 -0
  730. package/dist/upgrade/upgradeCommands.js.map +1 -1
  731. package/dist/upgrade/upgradeLock.js +86 -0
  732. package/dist/upgrade/upgradeLock.js.map +1 -0
  733. package/dist/upgrade/upgradeOrchestrator.js +217 -56
  734. package/dist/upgrade/upgradeOrchestrator.js.map +1 -1
  735. package/dist/upgrade/v3CapabilitySurface.js +15 -0
  736. package/dist/upgrade/v3CapabilitySurface.js.map +1 -0
  737. package/dist/upgrade/versionResolution.js +12 -4
  738. package/dist/upgrade/versionResolution.js.map +1 -1
  739. package/dist/validate/appHomeContract.js +5 -9
  740. package/dist/validate/appHomeContract.js.map +1 -1
  741. package/dist/validate/capability.js +144 -14
  742. package/dist/validate/capability.js.map +1 -1
  743. package/dist/validate/crossCapability.js +15 -9
  744. package/dist/validate/crossCapability.js.map +1 -1
  745. package/dist/validate/selfAudit.js +73 -36
  746. package/dist/validate/selfAudit.js.map +1 -1
  747. package/dist/validate/v1LegacyCruft.js +141 -0
  748. package/dist/validate/v1LegacyCruft.js.map +1 -0
  749. package/dist/validate/vocabularyAuthority.js +305 -0
  750. package/dist/validate/vocabularyAuthority.js.map +1 -0
  751. package/package.json +46 -27
  752. package/bundle/references/adapters/cursor.md +0 -213
  753. package/bundle/references/adapters/opencode.md +0 -530
  754. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  755. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  756. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -548
  757. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  758. package/bundle/references/v1-section-mapping.md +0 -47
  759. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  760. package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
  761. package/bundle/skills/agentera/agents/hej.toml +0 -6
  762. package/bundle/skills/agentera/agents/inspektera.toml +0 -6
  763. package/bundle/skills/agentera/agents/inspirera.toml +0 -6
  764. package/bundle/skills/agentera/agents/optimera.toml +0 -6
  765. package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
  766. package/bundle/skills/agentera/agents/planera.toml +0 -6
  767. package/bundle/skills/agentera/agents/profilera.toml +0 -6
  768. package/bundle/skills/agentera/agents/realisera.toml +0 -6
  769. package/bundle/skills/agentera/agents/resonera.toml +0 -6
  770. package/bundle/skills/agentera/agents/visionera.toml +0 -6
  771. package/bundle/skills/agentera/agents/visualisera.toml +0 -6
  772. package/bundle/skills/agentera/capabilities/dokumentera/instructions.md +0 -428
  773. package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +0 -73
  774. package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +0 -35
  775. package/bundle/skills/agentera/capabilities/hej/instructions.md +0 -331
  776. package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +0 -69
  777. package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +0 -58
  778. package/bundle/skills/agentera/capabilities/inspektera/instructions.md +0 -514
  779. package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +0 -76
  780. package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +0 -38
  781. package/bundle/skills/agentera/capabilities/inspirera/instructions.md +0 -280
  782. package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
  783. package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +0 -34
  784. package/bundle/skills/agentera/capabilities/optimera/instructions.md +0 -437
  785. package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +0 -39
  786. package/bundle/skills/agentera/capabilities/orkestrera/instructions.md +0 -433
  787. package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +0 -64
  788. package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +0 -42
  789. package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -107
  790. package/bundle/skills/agentera/capabilities/planera/instructions.md +0 -368
  791. package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
  792. package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +0 -34
  793. package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
  794. package/bundle/skills/agentera/capabilities/profilera/instructions.md +0 -419
  795. package/bundle/skills/agentera/capabilities/profilera/schemas/artifacts.yaml +0 -18
  796. package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +0 -45
  797. package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +0 -57
  798. package/bundle/skills/agentera/capabilities/realisera/instructions.md +0 -403
  799. package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +0 -80
  800. package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +0 -39
  801. package/bundle/skills/agentera/capabilities/realisera/schemas/validation.yaml +0 -110
  802. package/bundle/skills/agentera/capabilities/resonera/instructions.md +0 -329
  803. package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +0 -47
  804. package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +0 -46
  805. package/bundle/skills/agentera/capabilities/resonera/schemas/validation.yaml +0 -77
  806. package/bundle/skills/agentera/capabilities/visionera/instructions.md +0 -309
  807. package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +0 -41
  808. package/bundle/skills/agentera/capabilities/visualisera/instructions.md +0 -400
  809. package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +0 -33
  810. package/bundle/skills/hej/.claude-plugin/plugin.json +0 -6
  811. package/bundle/skills/hej/SKILL.md +0 -69
  812. package/bundle/skills/hej/agents/hej.toml +0 -11
  813. package/bundle/skills/hej/agents/openai.yaml +0 -8
  814. package/dist/cli/commands/backfill.js +0 -84
  815. package/dist/cli/commands/backfill.js.map +0 -1
  816. package/dist/cli/commands/state.js +0 -1012
  817. package/dist/cli/commands/state.js.map +0 -1
  818. package/dist/core/git.js +0 -43
  819. package/dist/core/git.js.map +0 -1
  820. package/dist/hooks/compaction.js +0 -935
  821. package/dist/hooks/compaction.js.map +0 -1
  822. package/dist/hooks/validateArtifact.js +0 -933
  823. package/dist/hooks/validateArtifact.js.map +0 -1
  824. package/dist/registries/runtimeAdapterRegistry.js +0 -315
  825. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  826. package/dist/setup/copilot.js +0 -227
  827. package/dist/setup/copilot.js.map +0 -1
  828. package/dist/setup/cursor.js +0 -127
  829. package/dist/setup/cursor.js.map +0 -1
  830. package/dist/setup/doctor.js +0 -1297
  831. package/dist/setup/doctor.js.map +0 -1
  832. package/dist/state/progressCommit.js +0 -289
  833. package/dist/state/progressCommit.js.map +0 -1
  834. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -571
  835. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  836. package/dist/validate/lifecycleAdapters.js +0 -772
  837. package/dist/validate/lifecycleAdapters.js.map +0 -1
  838. /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
  839. /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
  840. /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
@@ -0,0 +1,76 @@
1
+ ARTIFACTS:
2
+ 1:
3
+ id: A1
4
+ artifact: plan
5
+ local_role: produces_and_consumes
6
+ description: >-
7
+ Orchestrate consumes plan task queue state through
8
+ `agentera prime --context orchestrate --format json` before raw
9
+ artifact access, then updates status (pending -> complete/blocked) only
10
+ when resolving a task. Superseded tasks are terminal dependency
11
+ satisfiers and stay out of ready and blocked queues. Failed evaluator results are recorded through the
12
+ retry-safe typed `record-evaluation` mutation before retry or blocking.
13
+ 2:
14
+ id: A2
15
+ artifact: progress
16
+ local_role: consumes
17
+ description: >-
18
+ Orchestrate consumes progress verification state from the returned
19
+ orchestration context first, then bounded `agentera state progress list
20
+ --limit 20 --format json` fallback output. Exact detail uses `state
21
+ progress get --id ID`; raw reads are diagnostic-only for corruption or
22
+ CLI-defect investigation.
23
+ 3:
24
+ id: A3
25
+ artifact: health
26
+ local_role: produces_and_consumes
27
+ description: >-
28
+ For an active plan whose tasks are all terminal, Orchestrate consumes
29
+ returned health state and delegates a limited staleness closure check.
30
+ On PASS it publishes one typed `artifact_freshness` health record through
31
+ `agentera state health append --input PATH --format json` before setting
32
+ the still-open plan complete. WARN or FAIL leaves the plan open and
33
+ surfaces the finding. Bounded `agentera state health list --limit 20
34
+ --format json` and exact `state health get --id ID` are fallback
35
+ contracts. Raw reads are diagnostic-only for corruption or CLI-defect
36
+ investigation.
37
+ 4:
38
+ id: A4
39
+ artifact: todo
40
+ local_role: produces
41
+ description: >-
42
+ Orchestrate consumes TODO caveats from CLI startup context and writes
43
+ blocked task logging only when a task exhausts its retry budget.
44
+ 5:
45
+ id: A5
46
+ artifact: decisions
47
+ local_role: consumes
48
+ description: >-
49
+ Orchestrate consumes included decision context or bounded
50
+ `agentera state decisions list --limit 20 --format json` discovery and
51
+ exact `state decisions get --id ID` retrieval, preserving firm
52
+ constraints, exploratory uncertainties, and compacted-entry caveats.
53
+ Raw reads are diagnostic-only for corruption or CLI-defect investigation.
54
+ 6:
55
+ id: A6
56
+ artifact: vision
57
+ local_role: consumes
58
+ description: >-
59
+ Orchestrate consumes returned vision state or missing-state caveats during
60
+ bootstrap when chaining research for vision-gap analysis.
61
+ 7:
62
+ id: A7
63
+ artifact: profile
64
+ local_role: consumes
65
+ description: >-
66
+ Orchestrate consumes returned profile status and caveats first for persona
67
+ context. If missing or stale, it proceeds without refreshing profile
68
+ state and preserves the caveat.
69
+ 8:
70
+ id: A8
71
+ artifact: docs
72
+ local_role: consumes
73
+ description: >-
74
+ Orchestrate uses docs mapping from CLI startup context first to resolve
75
+ project-local artifact mappings before any diagnostic-only raw artifact
76
+ read or artifact write.
@@ -3,8 +3,9 @@ EXIT_CONDITIONS:
3
3
  id: E1
4
4
  condition: complete
5
5
  description: >-
6
- All PLAN.md tasks are complete, the health check passed, and the
7
- orchestration session concluded with all planned work finished.
6
+ All plan tasks are complete or validly superseded, the limited post-plan
7
+ health check passed, its typed health record was published, and the
8
+ still-open plan was then set complete without invoking archive.
8
9
  exit_signal: complete
9
10
  2:
10
11
  id: E2
@@ -18,7 +19,7 @@ EXIT_CONDITIONS:
18
19
  id: E3
19
20
  condition: stuck
20
21
  description: >-
21
- Cannot proceed. PLAN.md has circular dependencies preventing any task
22
+ Cannot proceed. The plan has circular dependencies preventing any task
22
23
  from becoming eligible, no target capabilities are available to
23
24
  delegate, or file access prevents reading or updating artifacts.
24
25
  The exit marker explains what is blocking progress.
@@ -27,8 +28,9 @@ EXIT_CONDITIONS:
27
28
  id: E4
28
29
  condition: waiting
29
30
  description: >-
30
- No PLAN.md exists and the bootstrap chain cannot proceed because
31
- VISION.md is absent and the user has not confirmed how to create one,
32
- or a dispatched capability returned waiting status requiring user input.
33
- The waiting bullet identifies the specific decision needed.
31
+ No plan exists and the bootstrap chain cannot proceed because the
32
+ vision artifact is absent and the user has not confirmed how to
33
+ create one, or a dispatched capability returned waiting status
34
+ requiring user input. The waiting bullet identifies the specific
35
+ decision needed.
34
36
  exit_signal: waiting
@@ -0,0 +1,23 @@
1
+ TRIGGERS:
2
+ 1:
3
+ id: T1
4
+ description: Execute an entire plan or coordinate multiple tasks and capabilities.
5
+ priority: high
6
+ 2:
7
+ id: T2
8
+ description: Run every task in a plan or execute a full plan autonomously.
9
+ priority: high
10
+ disambiguates_against:
11
+ - capability: build
12
+ hint: "orchestrate runs the whole plan autonomously; build executes one development cycle"
13
+ 3:
14
+ id: T3
15
+ description: Coordinate multiple tasks or capability handoffs through completion.
16
+ priority: medium
17
+ 4:
18
+ id: T4
19
+ description: Run evaluated, plan-driven development across multiple tasks without manual sequencing.
20
+ priority: medium
21
+ disambiguates_against:
22
+ - capability: build
23
+ hint: "orchestrate chains multi-cycle execution; build runs a single cycle"
@@ -0,0 +1,121 @@
1
+ VALIDATION:
2
+ 1:
3
+ id: V1
4
+ rule: must_not_read_source
5
+ description: >-
6
+ Orchestrate MUST NOT read implementation source code. It dispatches
7
+ capabilities; it does not implement. Artifact files (`.agentera/*.yaml`,
8
+ `TODO.md`) are state records, not source code; raw reads are last-resort
9
+ after CLI context and listed fallback commands. This rule verifies the
10
+ instructions explicitly state the source-code read prohibition.
11
+ severity: critical
12
+ checks:
13
+ - "orchestrate instructions (packages/cli/src/capabilities/orchestrate/instructions.ts) contains MUST NOT read implementation source code"
14
+ 2:
15
+ id: V2
16
+ rule: evaluation_gate_required
17
+ description: >-
18
+ Every completed task MUST be verified by audit before being marked
19
+ complete. The orchestrator MUST NOT skip evaluation. This rule verifies
20
+ the instructions contain the must-not-skip-evaluation safety rail.
21
+ severity: critical
22
+ checks:
23
+ - "orchestrate instructions contains MUST NOT skip evaluation"
24
+ 3:
25
+ id: V3
26
+ rule: retry_budget_enforced
27
+ description: >-
28
+ No task may be retried more than 2 times. After the second failure,
29
+ the task must be marked blocked. This rule verifies the retry budget
30
+ is stated in the instructions and safety rails.
31
+ severity: critical
32
+ checks:
33
+ - "orchestrate instructions contains retry a task more than 2 times"
34
+ 4:
35
+ id: V4
36
+ rule: exit_marker_required
37
+ description: >-
38
+ Every orchestrate invocation MUST emit an exit marker. The marker uses
39
+ the canonical glyph ⎈ (SG12) in the format ⎈ orchestrate · <status>
40
+ where status is one of EX1-EX4.
41
+ severity: critical
42
+ checks:
43
+ - "orchestrate instructions contains exit marker with glyph ⎈ (SG12)"
44
+ - "orchestrate instructions references exit signals EX1-EX4"
45
+ 5:
46
+ id: V5
47
+ rule: orchestrator_read_only_artifacts
48
+ description: >-
49
+ The orchestrator updates plan task statuses and TODO.md blocked entries.
50
+ During terminal-open closure only, it writes the typed limited-scope
51
+ health record before plan completion. It does NOT write progress or
52
+ changelog. This rule verifies the artifacts schema reflects this
53
+ constraint.
54
+ severity: warning
55
+ checks:
56
+ - "progress is consumes only (not produces)"
57
+ - "health is produces_and_consumes for terminal-open closure only"
58
+ - "decisions is consumes only (not produces)"
59
+ - "vision is consumes only (not produces)"
60
+ 6:
61
+ id: V6
62
+ rule: orchestration_context_first
63
+ description: >-
64
+ Orchestrate startup and evaluation MUST use
65
+ `agentera prime --context orchestrate --format json` and the
66
+ returned orchestration context before raw plan, progress, health, TODO,
67
+ or decisions artifact reads.
68
+ severity: critical
69
+ checks:
70
+ - "orchestrate instructions contains agentera prime --context orchestrate --format json"
71
+ - "orchestrate instructions contains complete_for_orchestration_context"
72
+ - "orchestrate instructions contains no raw plan, progress, health, TODO, or decisions reads"
73
+ 7:
74
+ id: V7
75
+ rule: cli_fallback_before_raw_read
76
+ description: >-
77
+ When orchestration context is incomplete, Orchestrate MUST run listed
78
+ fallback commands before any raw artifact read.
79
+ severity: critical
80
+ checks:
81
+ - "orchestrate instructions contains run listed fallback commands"
82
+ - "orchestrate instructions contains last-resort diagnostics"
83
+ 8:
84
+ id: V8
85
+ rule: caveats_preserved_for_evaluation
86
+ description: >-
87
+ Orchestrate MUST preserve compacted-decision, stale health/profile/app,
88
+ missing-state, and retry-state provenance caveats when handing a task to
89
+ audit.
90
+ severity: critical
91
+ checks:
92
+ - "orchestrate instructions contains compacted decision caveats"
93
+ - "orchestrate instructions contains stale health/profile/app caveats"
94
+ - "orchestrate instructions contains retry-state provenance"
95
+ 9:
96
+ id: V9
97
+ rule: satisfaction_authority_boundary
98
+ description: >-
99
+ When Orchestrate touches decision satisfaction, it may pass through or request
100
+ provisional satisfaction with evidence but MUST NOT user-confirm satisfaction.
101
+ Missing, compacted, open, provisional, or review-needed satisfaction state
102
+ remains a caveat and review pressure; automation must not reconstruct hidden
103
+ outcomes or claim it proved user intent.
104
+ severity: critical
105
+ checks:
106
+ - "Provisional satisfaction requires evidence"
107
+ - "Only the user confirms final satisfaction"
108
+ - "Missing or compacted satisfaction caveats are preserved"
109
+ 10:
110
+ id: V10
111
+ rule: audit_citation_required
112
+ description: >-
113
+ Orchestrate Step 3 Surface 2 audit delegation MUST require a
114
+ citation: <file>:<line> (or not-applicable: <reason>) for every FAIL
115
+ finding, and require verify_command for FAIL rows with file:line
116
+ citations. Authority: references/cli/capability-instruction-contract.yaml#evaluator_handoff.
117
+ severity: critical
118
+ checks:
119
+ - "orchestrate instructions contains citation: `<file>:<line>` OR `not-applicable: <reason>`"
120
+ - "orchestrate instructions contains verify_command"
121
+ - "orchestrate instructions contains evaluator_handoff.output_requirements"
@@ -0,0 +1,66 @@
1
+ ARTIFACTS:
2
+ 1:
3
+ id: A1
4
+ artifact: plan
5
+ local_role: produces_and_consumes
6
+ description: >-
7
+ Current plan with tasks, dependencies, and behavioral acceptance criteria.
8
+ Its active position is derived from the docs-mapped current-plan path,
9
+ not persisted lifecycle status. Plan writes this during the planning
10
+ session and may read existing plan context before replacing or refining it.
11
+ 2:
12
+ id: A2
13
+ artifact: plan_archive
14
+ local_role: produces
15
+ description: >-
16
+ Immutable, non-executable history created when a plan is complete or
17
+ explicitly force-archived. Forced archival preserves an unfinished
18
+ plan's open status rather than claiming completion.
19
+ 3:
20
+ id: A3
21
+ artifact: vision
22
+ local_role: consumes
23
+ description: >-
24
+ Plan reads this during Orient to understand project direction and
25
+ align the plan with the vision.
26
+ 4:
27
+ id: A4
28
+ artifact: decisions
29
+ local_role: consumes
30
+ description: >-
31
+ Plan reads firm (DL1) entries only as hard constraints for planning.
32
+ 5:
33
+ id: A5
34
+ artifact: todo
35
+ local_role: consumes
36
+ description: >-
37
+ Plan reads this to identify related known
38
+ issues that the plan should address.
39
+ 6:
40
+ id: A6
41
+ artifact: health
42
+ local_role: consumes
43
+ description: >-
44
+ Plan reads this to factor structural issues into the plan.
45
+ 7:
46
+ id: A7
47
+ artifact: progress
48
+ local_role: consumes
49
+ description: >-
50
+ Plan reads this to understand what was built recently.
51
+ 8:
52
+ id: A8
53
+ artifact: profile
54
+ local_role: consumes
55
+ description: >-
56
+ Plan reads only sanitized non-glossary content from `agentera report
57
+ profile-grounding --format json` to calibrate planning depth and pattern
58
+ preferences. It never direct-reads the profile path and uses content only
59
+ for shared validity `valid`; absent and repair-needed results fail closed.
60
+ 9:
61
+ id: A9
62
+ artifact: docs
63
+ local_role: consumes
64
+ description: >-
65
+ Plan reads this first to resolve project-local artifact mappings and
66
+ reads the versioning block for version bump task generation.
@@ -4,8 +4,8 @@ EXIT_CONDITIONS:
4
4
  condition: complete
5
5
  description: >-
6
6
  PLAN.md was written and approved (or skip level confirmed), the
7
- adversarial review ran for full plans, and the handoff to realisera
8
- or orkestrera was suggested.
7
+ adversarial review ran for full plans, and the handoff to build
8
+ or orchestrate was suggested.
9
9
  exit_signal: complete
10
10
  2:
11
11
  id: E2
@@ -0,0 +1,23 @@
1
+ TRIGGERS:
2
+ 1:
3
+ id: T1
4
+ description: Requests to structure work into a plan before implementation.
5
+ priority: high
6
+ 2:
7
+ id: T2
8
+ description: Create a plan, break work down, or specify requirements before building.
9
+ priority: high
10
+ disambiguates_against:
11
+ - capability: build
12
+ hint: "plan structures work into tasks before coding; build implements the work"
13
+ - capability: discuss
14
+ hint: "plan structures committed work; discuss explores an undecided choice or tradeoff"
15
+ - capability: vision
16
+ hint: "plan structures work toward known direction; vision defines the direction itself"
17
+ 3:
18
+ id: T3
19
+ description: Plan a multi-step feature or approach too large for one development cycle.
20
+ priority: medium
21
+ disambiguates_against:
22
+ - capability: build
23
+ hint: "plan sizes work before implementation; build runs the development cycle"
@@ -0,0 +1,121 @@
1
+ VALIDATION:
2
+ 1:
3
+ id: V1
4
+ rule: behavioral_acceptance_criteria
5
+ description: >-
6
+ All acceptance criteria MUST be behavioral (Given/When/Then format)
7
+ and MUST NOT reference implementation details (class names, API
8
+ endpoints, database tables, function names, line numbers).
9
+ severity: critical
10
+ checks:
11
+ - "Acceptance criteria use Given/When/Then format"
12
+ - "No implementation details in acceptance criteria"
13
+ 2:
14
+ id: V2
15
+ rule: coherent_lifecycle_scope
16
+ description: >-
17
+ Full plans MUST keep all tasks within a coherent lifecycle boundary.
18
+ Split plans only when work crosses a real lifecycle or coherence boundary.
19
+ severity: critical
20
+ checks:
21
+ - "Tasks stay within one coherent lifecycle boundary"
22
+ - "Splits follow real lifecycle or coherence boundaries"
23
+ 3:
24
+ id: V3
25
+ rule: adversarial_review_required
26
+ description: >-
27
+ Full plans MUST undergo adversarial review. The critic MUST find at
28
+ least one issue. "Looks good" is not acceptable. Skip level and
29
+ light plans are exempt.
30
+ severity: critical
31
+ checks:
32
+ - "Adversarial review ran for full plans"
33
+ 4:
34
+ id: V4
35
+ rule: plan_final_state_sync
36
+ description: >-
37
+ Every full plan MUST end with a "final state sync" task that depends
38
+ on all prior tasks. This ensures aggregate plan-level CHANGELOG.md,
39
+ PROGRESS.md, and TODO.md updates.
40
+ severity: critical
41
+ checks:
42
+ - "Full plan has final state sync task as last task"
43
+ 5:
44
+ id: V5
45
+ rule: test_proportionality_target
46
+ description: >-
47
+ Tasks that include writing tests MUST have a proportionality target
48
+ in their acceptance criteria. Default: one pass + one fail per
49
+ testable unit. Override only with explicit rationale.
50
+ severity: warning
51
+ checks:
52
+ - "Test tasks state proportionality target"
53
+ 6:
54
+ id: V6
55
+ rule: skip_level_for_trivial_work
56
+ description: >-
57
+ Plan MUST detect skip level for trivial work (single-file change,
58
+ localized defect fix, or config tweak that touches no shared
59
+ abstraction) and route directly to /build without producing a
60
+ PLAN.md. LOC count is not a skip signal because small changes to
61
+ shared exports can ripple across many consumers.
62
+ severity: critical
63
+ checks:
64
+ - "Trivial work routed to /build without plan"
65
+ 7:
66
+ id: V7
67
+ rule: full_plan_unknowns_required
68
+ description: >-
69
+ Every full plan MUST surface at least one planning-time known-unknown
70
+ in the `unknowns:` field. Each entry MUST include question,
71
+ affects_task, and resolve_by. Skip level and light plans are exempt
72
+ because they do not decompose work into interdependent tasks.
73
+ severity: warning
74
+ checks:
75
+ - "Full plans have a non-empty `unknowns:` list"
76
+ - "Each unknown entry has question, affects_task, resolve_by fields"
77
+ 8:
78
+ id: V8
79
+ rule: adversarial_review_dismissals_persisted
80
+ description: >-
81
+ Full plans MUST persist dismissed adversarial-review findings in the
82
+ artifact's `rejected:` field, each with issue text and rationale, so
83
+ downstream consumers (build, orchestrate, audit) inherit the
84
+ adjudication rather than relitigating. V3 enforces the review ran;
85
+ V8 enforces the dismissal provenance persists.
86
+ severity: warning
87
+ checks:
88
+ - "Full plans with dismissed critic findings have `rejected:` entries"
89
+ - "Each rejection has issue and rationale fields"
90
+ 9:
91
+ id: V9
92
+ rule: sanitized_profile_grounding
93
+ description: >-
94
+ Plan MUST ground only from the `content` returned by `agentera report
95
+ profile-grounding --format json` when shared validity is valid; it MUST
96
+ preserve absent/repair-needed recovery and MUST NOT direct-read PROFILE.md.
97
+ severity: critical
98
+ checks:
99
+ - "Sanitized grounding command used during Orient"
100
+ - "Prime and report validity objects agree before content use"
101
+ - "Raw profile path not read"
102
+ 10:
103
+ id: V10
104
+ rule: governed_terminology_advice
105
+ description: >-
106
+ Plan MUST consume terminology advice through the shared glossary consumer
107
+ authority at governed meaning-sensitive user events. Interactive review
108
+ MUST precede fixing affected requirements. Autonomous unresolved review
109
+ MUST abstain, defer the affected requirements, and emit at most one bounded
110
+ current writer intent without delivering or storing it or writing plan
111
+ conflict or progress state.
112
+ severity: critical
113
+ checks:
114
+ - "Advice refreshes only for authority-declared Plan events"
115
+ - "Mode follows explicit authority precedence and unknown mode waits"
116
+ - "Interactive review precedes affected requirements and acceptance"
117
+ - "Autonomous unresolved meaning remains deferred without a Plan write"
118
+ - "Emitted-only handoff intent contains exactly event=current, reason, and ownership state"
119
+ - "Writer owns caveat identity, Build capability, and transition fields"
120
+ - "Exact project authority suppresses personal-unavailable durable handoff"
121
+ - "Plan artifacts exclude private glossary content"
@@ -0,0 +1,23 @@
1
+ ARTIFACTS:
2
+ 1:
3
+ id: A1
4
+ artifact: profile
5
+ local_role: produces_and_consumes
6
+ description: >-
7
+ Decision profile with per-entry confidence scoring, permanence
8
+ classification, and temporal metadata. Profile Full also owns one
9
+ deterministic personal Glossary section containing shared glossary entries
10
+ and lifecycle metadata; rendering and persistence are active while lookup
11
+ remains deferred. Profile writes this in both Full and Validate modes,
12
+ then reads it for validation and update context. Prime exposes its
13
+ canonical resolved path only inside `prime --context profile`; no other
14
+ Prime context or profile-grounding failure may serialize that path.
15
+ 2:
16
+ id: A2
17
+ artifact: decisions
18
+ local_role: consumes
19
+ description: >-
20
+ Profile treats this as a high-signal source for extraction scripts.
21
+ Each decision entry captures
22
+ reasoning, tradeoffs, and confidence, making deliberation sessions
23
+ one of the richest inputs for decision profile generation.
@@ -4,15 +4,17 @@ EXIT_CONDITIONS:
4
4
  condition: complete
5
5
  description: >-
6
6
  PROFILE.md was written (Full mode) or updated (Validate mode).
7
- Metadata changes were applied, prediction accuracy was assessed
8
- (Full mode), and changes were summarized.
7
+ In Full mode its owned personal Glossary section was rendered and persisted,
8
+ metadata changes were applied, prediction accuracy was assessed, and
9
+ changes were summarized.
9
10
  exit_signal: complete
10
11
  2:
11
12
  id: E2
12
13
  condition: flagged
13
14
  description: >-
14
15
  Profile generation or validation completed but with data quality
15
- issues: extraction failed for one or more sources, prediction
16
+ issues: available runtime history was skipped without explicit
17
+ acceptance, extraction failed for one or more sources, prediction
16
18
  accuracy was below 3/5, or significant unresolved tensions were
17
19
  found.
18
20
  exit_signal: flagged
@@ -21,8 +23,7 @@ EXIT_CONDITIONS:
21
23
  condition: stuck
22
24
  description: >-
23
25
  Cannot generate or validate a profile because extraction scripts
24
- failed entirely, Python is unavailable, or session data sources
25
- are unreadable.
26
+ failed entirely or session data sources are unreadable.
26
27
  exit_signal: stuck
27
28
  4:
28
29
  id: E4
@@ -0,0 +1,20 @@
1
+ TRIGGERS:
2
+ 1:
3
+ id: T1
4
+ description: Create, maintain, or analyze a reusable decision profile.
5
+ priority: high
6
+ 2:
7
+ id: T2
8
+ description: Build, generate, or regenerate a decision profile.
9
+ priority: high
10
+ disambiguates_against:
11
+ - capability: build
12
+ hint: "profile builds a reusable decision profile; build implements a software task"
13
+ 3:
14
+ id: T3
15
+ description: Update, validate, or refresh an existing decision profile.
16
+ priority: medium
17
+ 4:
18
+ id: T4
19
+ description: Analyze personal decision patterns or review decision history.
20
+ priority: medium
@@ -0,0 +1,115 @@
1
+ VALIDATION:
2
+ 1:
3
+ id: V1
4
+ rule: evidence_grounded
5
+ description: >-
6
+ Every profile entry MUST be grounded in observed evidence from session
7
+ history, memory files, configs, or conversation data. Fabricated
8
+ decision patterns are never acceptable. Synthesis reads the bounded
9
+ signal tier; a claim's source identity is verified by resolving its
10
+ evidence_anchor to a retained full-evidence shard rather than re-scanning
11
+ unbounded history.
12
+ severity: critical
13
+ checks:
14
+ - "Each profile entry traces to a source record"
15
+ - "No profile entry is fabricated without evidence"
16
+ - "Each claim's evidence_anchor resolves to a retained full-evidence shard"
17
+ 2:
18
+ id: V2
19
+ rule: confidence_calibration
20
+ description: >-
21
+ Confidence scores MUST match the evidence tier (protocol CS1-CS5).
22
+ A single data point is 30-49 (CS4), not 70+. Bias check: confidence
23
+ is earned through evidence, not assigned by how insightful the
24
+ decision sounds. When bounded_signals.sufficiency is insufficient,
25
+ affected categories are capped to CS4 (30-49) or below.
26
+ severity: critical
27
+ checks:
28
+ - "Confidence values fall within protocol tier boundaries"
29
+ - "Single-source entries are capped at CS4 (30-49)"
30
+ - "Insufficient families cap affected categories to CS4 or below"
31
+ 3:
32
+ id: V3
33
+ rule: tension_honesty
34
+ description: >-
35
+ Contradictions MUST be recorded as tensions, not smoothed into a
36
+ coherent narrative. When evidence conflicts, the tension section
37
+ captures the divergence explicitly.
38
+ severity: critical
39
+ checks:
40
+ - "Conflicting evidence produces tension entries"
41
+ - "No smoothing over contradictions"
42
+ 4:
43
+ id: V4
44
+ rule: read_only_sources
45
+ description: >-
46
+ Profile MUST NOT modify session history, memory files, or config
47
+ files. It reads these sources for extraction but never writes to them.
48
+ The only artifact profile produces is PROFILE.md. Profile MUST NOT
49
+ load the monolithic corpus.json whole: synthesis reads the bounded
50
+ signal tier and retrieves full evidence one shard at a time via
51
+ evidence_anchor. Legacy/missing tiers require a refresh to publish
52
+ bounded tiers first, never a whole-corpus load.
53
+ severity: critical
54
+ checks:
55
+ - "No writes to session history files"
56
+ - "No writes to memory or config files"
57
+ - "Monolithic corpus.json is never loaded whole"
58
+ - "Full-evidence records are retrieved one shard at a time"
59
+ 5:
60
+ id: V5
61
+ rule: prediction_accuracy
62
+ description: >-
63
+ Full mode MUST validate predictions against 5 decision-rich prompts
64
+ not used to create the profile. Accuracy below 3/5 triggers a flag
65
+ noting categories needing more signal.
66
+ severity: warning
67
+ checks:
68
+ - "5 predictions tested against held-out prompts"
69
+ - "Accuracy below 3/5 is flagged in profile header"
70
+ 6:
71
+ id: V6
72
+ rule: bounded_signal_sufficiency
73
+ description: >-
74
+ Profile synthesis MUST consume the bounded signal tier published by
75
+ extraction, not all full evidence. The sufficiency gate reports
76
+ underrepresented source families with their retained and intended
77
+ counts and surfaces the limitation in the profile output and exit
78
+ signal rather than silently reducing confidence. Sufficiency is
79
+ assessed per family against the contract minimum_family_retention
80
+ threshold; a family with zero intended signals is not a violation.
81
+ severity: warning
82
+ checks:
83
+ - "Signal tier state, count, and sufficiency are read before synthesizing"
84
+ - "Underrepresented families are surfaced with retained and intended counts"
85
+ - "No high-confidence claims are fabricated from sparse or missing evidence"
86
+ 7:
87
+ id: V7
88
+ rule: personal_glossary_output
89
+ description: >-
90
+ Profile Full MUST render and persist exactly one owned Glossary section
91
+ through `agentera report profile-glossary`. Entries use only the shared
92
+ primitive and personal provenance variants. Replacement preserves every
93
+ non-glossary byte, malformed or ambiguous boundaries fail before effects,
94
+ and personal production never reads a project glossary.
95
+ severity: critical
96
+ checks:
97
+ - "Explicit entries retain exactly one evidence anchor"
98
+ - "Inferred entries retain exactly two pairwise-distinct evidence anchors"
99
+ - "Non-glossary PROFILE.md bytes and decision-pattern confidence are unchanged"
100
+ - "No project glossary identity, path, parameter, import, or read is used"
101
+ 8:
102
+ id: V8
103
+ rule: personal_glossary_lifecycle
104
+ description: >-
105
+ Established entries MUST survive regeneration without fresh evidence.
106
+ Confidence is deterministically derived from the retained confidence basis,
107
+ unchanged permanence class, injected date, existing Profile decay formula,
108
+ and floor; permanence and observed_at remain unchanged. Matching fresh
109
+ evidence follows the shared authority refresh rule. Lookup remains deferred.
110
+ severity: critical
111
+ checks:
112
+ - "Same-date replay is idempotent and decay never compounds from rendered confidence"
113
+ - "Stable, durable, and situational classes use their existing lambdas and floor"
114
+ - "Fresh evidence refreshes only matching meaning and provenance kind"
115
+ - "Glossary confidence never mutates decision-pattern confidence"