agentera 3.0.0-dev.3 → 3.0.0-dev.31

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 (766) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +96 -6
  3. package/bundle/.agentera-npx-bundle.json +1 -1
  4. package/bundle/CHANGELOG.md +1144 -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-registry.yaml +20 -188
  13. package/bundle/references/adapters/package-surface-characterization.md +36 -37
  14. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
  15. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
  16. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
  17. package/bundle/references/adapters/runtime-retired-resources.yaml +97 -0
  18. package/bundle/references/analysis/benchmark.md +10 -6
  19. package/bundle/references/analysis/evidence-tier-authority.yaml +516 -0
  20. package/bundle/references/analysis/startup-measurement-contract.yaml +37 -26
  21. package/bundle/references/analysis/verification-policy.yaml +142 -0
  22. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +9 -8
  23. package/bundle/references/artifacts/state-storage-authority.yaml +2167 -0
  24. package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
  25. package/bundle/references/cli/agent-ready-state-contract.yaml +64 -81
  26. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +7 -8
  27. package/bundle/references/cli/audience-namespace-cli-migration.yaml +58 -29
  28. package/bundle/references/cli/bundle-skill-vocabulary.yaml +12 -49
  29. package/bundle/references/cli/capability-instruction-contract.yaml +96 -58
  30. package/bundle/references/cli/capability-instruction-structure.md +144 -0
  31. package/bundle/references/cli/capability-tool-classification.yaml +14 -14
  32. package/bundle/references/cli/coexistence-probe.yaml +13 -0
  33. package/bundle/references/cli/hybrid-route-contract.yaml +416 -0
  34. package/bundle/references/cli/parity-expected-actual-template.md +30 -0
  35. package/bundle/references/cli/prime-consumer-compatibility.yaml +651 -0
  36. package/bundle/references/cli/routing-execution-vocabulary.yaml +16 -38
  37. package/bundle/references/cli/routing-model.md +139 -0
  38. package/bundle/references/cli/single-name-protocol.yaml +42 -0
  39. package/bundle/references/cli/trigger-schema-enrichment.md +140 -0
  40. package/bundle/references/cli/update-channels.yaml +45 -7
  41. package/bundle/references/cli/upgrade-repair-wording.md +25 -0
  42. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +97 -0
  43. package/bundle/references/cli/vocabulary-index.yaml +23 -18
  44. package/bundle/references/cli/vocabulary.md +346 -331
  45. package/bundle/references/meta/documentation-inventory.md +10 -3
  46. package/bundle/registry.json +14 -14
  47. package/bundle/skills/agentera/SKILL.md +182 -407
  48. package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +84 -0
  49. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +2 -2
  50. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +25 -0
  51. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +20 -19
  52. package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +85 -0
  53. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +3 -3
  54. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +27 -0
  55. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/validation.yaml +16 -16
  56. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +12 -12
  57. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +5 -5
  58. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +16 -0
  59. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +7 -7
  60. package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +49 -0
  61. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +2 -2
  62. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +20 -0
  63. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/validation.yaml +9 -8
  64. package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +80 -0
  65. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +16 -0
  66. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +18 -18
  67. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +17 -17
  68. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +2 -2
  69. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +16 -0
  70. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +9 -9
  71. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +76 -0
  72. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +9 -7
  73. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +23 -0
  74. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +121 -0
  75. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +63 -0
  76. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
  77. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +23 -0
  78. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +89 -0
  79. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/artifacts.yaml +4 -4
  80. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +3 -3
  81. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +20 -0
  82. package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +85 -0
  83. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +24 -0
  84. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +16 -0
  85. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
  86. package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +72 -0
  87. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +22 -0
  88. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
  89. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +16 -16
  90. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +7 -6
  91. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +23 -0
  92. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +18 -20
  93. package/bundle/skills/agentera/capability_schema_contract.yaml +200 -37
  94. package/bundle/skills/agentera/protocol.yaml +31 -31
  95. package/bundle/skills/agentera/references/contract.md +387 -329
  96. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  97. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +5 -4
  98. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +40 -22
  99. package/bundle/skills/agentera/schemas/artifacts/design.yaml +5 -4
  100. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +15 -19
  101. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +145 -14
  102. package/bundle/skills/agentera/schemas/artifacts/health.yaml +58 -21
  103. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +22 -8
  104. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +327 -15
  105. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +51 -53
  106. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +257 -28
  107. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
  108. package/dist/analytics/extractCorpus/cli.js +191 -0
  109. package/dist/analytics/extractCorpus/cli.js.map +1 -0
  110. package/dist/analytics/extractCorpus/copilotSessions.js +276 -0
  111. package/dist/analytics/extractCorpus/copilotSessions.js.map +1 -0
  112. package/dist/analytics/extractCorpus/core.js +393 -0
  113. package/dist/analytics/extractCorpus/core.js.map +1 -0
  114. package/dist/analytics/extractCorpus/corpus.js +168 -0
  115. package/dist/analytics/extractCorpus/corpus.js.map +1 -0
  116. package/dist/analytics/extractCorpus/coverageAudit.js +261 -0
  117. package/dist/analytics/extractCorpus/coverageAudit.js.map +1 -0
  118. package/dist/analytics/extractCorpus/cursorSessions.js +426 -0
  119. package/dist/analytics/extractCorpus/cursorSessions.js.map +1 -0
  120. package/dist/analytics/extractCorpus/evidenceTiers.js +561 -0
  121. package/dist/analytics/extractCorpus/evidenceTiers.js.map +1 -0
  122. package/dist/analytics/extractCorpus/extractCorpusParity.js +106 -0
  123. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +1 -0
  124. package/dist/analytics/extractCorpus/filesystemSources.js +119 -0
  125. package/dist/analytics/extractCorpus/filesystemSources.js.map +1 -0
  126. package/dist/analytics/extractCorpus/index.js +15 -0
  127. package/dist/analytics/extractCorpus/index.js.map +1 -0
  128. package/dist/analytics/extractCorpus/jsonlSessions.js +205 -0
  129. package/dist/analytics/extractCorpus/jsonlSessions.js.map +1 -0
  130. package/dist/analytics/extractCorpus/sqliteCaps.js +44 -0
  131. package/dist/analytics/extractCorpus/sqliteCaps.js.map +1 -0
  132. package/dist/analytics/extractCorpus/sqliteSessions.js +368 -0
  133. package/dist/analytics/extractCorpus/sqliteSessions.js.map +1 -0
  134. package/dist/analytics/extractCorpus/tierReader.js +109 -0
  135. package/dist/analytics/extractCorpus/tierReader.js.map +1 -0
  136. package/dist/analytics/extractCorpus.js +2 -1790
  137. package/dist/analytics/extractCorpus.js.map +1 -1
  138. package/dist/analytics/profileSignals.js +212 -0
  139. package/dist/analytics/profileSignals.js.map +1 -0
  140. package/dist/analytics/usageStats.js +191 -41
  141. package/dist/analytics/usageStats.js.map +1 -1
  142. package/dist/bin/agentera.js +3 -1
  143. package/dist/bin/agentera.js.map +1 -1
  144. package/dist/capabilities/audit/instructions.js +16 -0
  145. package/dist/capabilities/audit/instructions.js.map +1 -0
  146. package/dist/capabilities/build/instructions.js +18 -0
  147. package/dist/capabilities/build/instructions.js.map +1 -0
  148. package/dist/capabilities/design/instructions.js +5 -0
  149. package/dist/capabilities/design/instructions.js.map +1 -0
  150. package/dist/capabilities/discuss/instructions.js +16 -0
  151. package/dist/capabilities/discuss/instructions.js.map +1 -0
  152. package/dist/capabilities/document/instructions.js +12 -0
  153. package/dist/capabilities/document/instructions.js.map +1 -0
  154. package/dist/capabilities/index.js +39 -0
  155. package/dist/capabilities/index.js.map +1 -0
  156. package/dist/capabilities/optimize/instructions.js +14 -0
  157. package/dist/capabilities/optimize/instructions.js.map +1 -0
  158. package/dist/capabilities/orchestrate/instructions.js +41 -0
  159. package/dist/capabilities/orchestrate/instructions.js.map +1 -0
  160. package/dist/capabilities/plan/instructions.js +15 -0
  161. package/dist/capabilities/plan/instructions.js.map +1 -0
  162. package/dist/capabilities/profile/instructions.js +5 -0
  163. package/dist/capabilities/profile/instructions.js.map +1 -0
  164. package/dist/capabilities/research/instructions.js +6 -0
  165. package/dist/capabilities/research/instructions.js.map +1 -0
  166. package/dist/capabilities/status/instructions.js +5 -0
  167. package/dist/capabilities/status/instructions.js.map +1 -0
  168. package/dist/capabilities/status/startupInstructions.js +39 -0
  169. package/dist/capabilities/status/startupInstructions.js.map +1 -0
  170. package/dist/capabilities/vision/instructions.js +5 -0
  171. package/dist/capabilities/vision/instructions.js.map +1 -0
  172. package/dist/cli/appContext.js +30 -23
  173. package/dist/cli/appContext.js.map +1 -1
  174. package/dist/cli/argvalidate.js.map +1 -1
  175. package/dist/cli/capabilityContext/benchmark.js +564 -0
  176. package/dist/cli/capabilityContext/benchmark.js.map +1 -0
  177. package/dist/cli/capabilityContext/bespoke.js +44 -0
  178. package/dist/cli/capabilityContext/bespoke.js.map +1 -0
  179. package/dist/cli/capabilityContext/build.js +191 -0
  180. package/dist/cli/capabilityContext/build.js.map +1 -0
  181. package/dist/cli/capabilityContext/closeout.js +231 -0
  182. package/dist/cli/capabilityContext/closeout.js.map +1 -0
  183. package/dist/cli/capabilityContext/contract.js +214 -0
  184. package/dist/cli/capabilityContext/contract.js.map +1 -0
  185. package/dist/cli/capabilityContext/evidence.js +469 -0
  186. package/dist/cli/capabilityContext/evidence.js.map +1 -0
  187. package/dist/cli/capabilityContext/index.js +4 -0
  188. package/dist/cli/capabilityContext/index.js.map +1 -0
  189. package/dist/cli/capabilityContext/orchestration.js +128 -0
  190. package/dist/cli/capabilityContext/orchestration.js.map +1 -0
  191. package/dist/cli/capabilityContext/planState.js +280 -0
  192. package/dist/cli/capabilityContext/planState.js.map +1 -0
  193. package/dist/cli/capabilityContext/progress.js +143 -0
  194. package/dist/cli/capabilityContext/progress.js.map +1 -0
  195. package/dist/cli/capabilityContext/shared.js +100 -0
  196. package/dist/cli/capabilityContext/shared.js.map +1 -0
  197. package/dist/cli/capabilityContext/slim.js +153 -0
  198. package/dist/cli/capabilityContext/slim.js.map +1 -0
  199. package/dist/cli/capabilityContext/startup.js +257 -0
  200. package/dist/cli/capabilityContext/startup.js.map +1 -0
  201. package/dist/cli/capabilityContext/types.js +51 -0
  202. package/dist/cli/capabilityContext/types.js.map +1 -0
  203. package/dist/cli/capabilityContext.js +1 -2420
  204. package/dist/cli/capabilityContext.js.map +1 -1
  205. package/dist/cli/commands/appHome.js +23 -0
  206. package/dist/cli/commands/appHome.js.map +1 -0
  207. package/dist/cli/commands/capability.js +3 -10
  208. package/dist/cli/commands/capability.js.map +1 -1
  209. package/dist/cli/commands/compact.js +41 -12
  210. package/dist/cli/commands/compact.js.map +1 -1
  211. package/dist/cli/commands/doctor.js +59 -97
  212. package/dist/cli/commands/doctor.js.map +1 -1
  213. package/dist/cli/commands/durability.js +82 -0
  214. package/dist/cli/commands/durability.js.map +1 -0
  215. package/dist/cli/commands/entityMigrate.js +132 -0
  216. package/dist/cli/commands/entityMigrate.js.map +1 -0
  217. package/dist/cli/commands/lint.js +26 -43
  218. package/dist/cli/commands/lint.js.map +1 -1
  219. package/dist/cli/commands/prime/briefOrientation.js +592 -0
  220. package/dist/cli/commands/prime/briefOrientation.js.map +1 -0
  221. package/dist/cli/commands/prime/bundleStatus.js +191 -0
  222. package/dist/cli/commands/prime/bundleStatus.js.map +1 -0
  223. package/dist/cli/commands/prime/collectEntityOrientation.js +266 -0
  224. package/dist/cli/commands/prime/collectEntityOrientation.js.map +1 -0
  225. package/dist/cli/commands/prime/collectOrientationState.js +180 -0
  226. package/dist/cli/commands/prime/collectOrientationState.js.map +1 -0
  227. package/dist/cli/commands/prime/orientationOutput.js +360 -0
  228. package/dist/cli/commands/prime/orientationOutput.js.map +1 -0
  229. package/dist/cli/commands/prime/types.js +2 -0
  230. package/dist/cli/commands/prime/types.js.map +1 -0
  231. package/dist/cli/commands/prime/v1Migration.js +39 -0
  232. package/dist/cli/commands/prime/v1Migration.js.map +1 -0
  233. package/dist/cli/commands/prime.js +61 -556
  234. package/dist/cli/commands/prime.js.map +1 -1
  235. package/dist/cli/commands/query.js +66 -51
  236. package/dist/cli/commands/query.js.map +1 -1
  237. package/dist/cli/commands/report.js +100 -24
  238. package/dist/cli/commands/report.js.map +1 -1
  239. package/dist/cli/commands/route.js +142 -0
  240. package/dist/cli/commands/route.js.map +1 -0
  241. package/dist/cli/commands/schema.js +260 -78
  242. package/dist/cli/commands/schema.js.map +1 -1
  243. package/dist/cli/commands/state/decisions.js +388 -0
  244. package/dist/cli/commands/state/decisions.js.map +1 -0
  245. package/dist/cli/commands/state/docs.js +71 -0
  246. package/dist/cli/commands/state/docs.js.map +1 -0
  247. package/dist/cli/commands/state/experimentRecords.js +139 -0
  248. package/dist/cli/commands/state/experimentRecords.js.map +1 -0
  249. package/dist/cli/commands/state/experiments.js +15 -0
  250. package/dist/cli/commands/state/experiments.js.map +1 -0
  251. package/dist/cli/commands/state/get.js +127 -0
  252. package/dist/cli/commands/state/get.js.map +1 -0
  253. package/dist/cli/commands/state/health.js +15 -0
  254. package/dist/cli/commands/state/health.js.map +1 -0
  255. package/dist/cli/commands/state/index.js +60 -0
  256. package/dist/cli/commands/state/index.js.map +1 -0
  257. package/dist/cli/commands/state/list.js +176 -0
  258. package/dist/cli/commands/state/list.js.map +1 -0
  259. package/dist/cli/commands/state/objective.js +26 -0
  260. package/dist/cli/commands/state/objective.js.map +1 -0
  261. package/dist/cli/commands/state/plan.js +15 -0
  262. package/dist/cli/commands/state/plan.js.map +1 -0
  263. package/dist/cli/commands/state/planTasks.js +142 -0
  264. package/dist/cli/commands/state/planTasks.js.map +1 -0
  265. package/dist/cli/commands/state/plans.js +143 -0
  266. package/dist/cli/commands/state/plans.js.map +1 -0
  267. package/dist/cli/commands/state/progress.js +14 -0
  268. package/dist/cli/commands/state/progress.js.map +1 -0
  269. package/dist/cli/commands/state/shared.js +15 -0
  270. package/dist/cli/commands/state/shared.js.map +1 -0
  271. package/dist/cli/commands/state/todo.js +42 -0
  272. package/dist/cli/commands/state/todo.js.map +1 -0
  273. package/dist/cli/commands/state/write.js +418 -0
  274. package/dist/cli/commands/state/write.js.map +1 -0
  275. package/dist/cli/commands/upgrade.js +146 -4
  276. package/dist/cli/commands/upgrade.js.map +1 -1
  277. package/dist/cli/commands/upgradeVerify.js +119 -0
  278. package/dist/cli/commands/upgradeVerify.js.map +1 -0
  279. package/dist/cli/commands/validate.js +133 -210
  280. package/dist/cli/commands/validate.js.map +1 -1
  281. package/dist/cli/commands/verify.js +30 -8
  282. package/dist/cli/commands/verify.js.map +1 -1
  283. package/dist/cli/contracts/bundleStatus.js +2 -0
  284. package/dist/cli/contracts/bundleStatus.js.map +1 -0
  285. package/dist/cli/contracts/orientationState.js +2 -0
  286. package/dist/cli/contracts/orientationState.js.map +1 -0
  287. package/dist/cli/dispatch/argvParser.js +33 -0
  288. package/dist/cli/dispatch/argvParser.js.map +1 -0
  289. package/dist/cli/dispatch/check.js +390 -0
  290. package/dist/cli/dispatch/check.js.map +1 -0
  291. package/dist/cli/dispatch/commands.js +27 -0
  292. package/dist/cli/dispatch/commands.js.map +1 -0
  293. package/dist/cli/dispatch/index.js +226 -0
  294. package/dist/cli/dispatch/index.js.map +1 -0
  295. package/dist/cli/dispatch/lifecycle.js +653 -0
  296. package/dist/cli/dispatch/lifecycle.js.map +1 -0
  297. package/dist/cli/dispatch/prime.js +119 -0
  298. package/dist/cli/dispatch/prime.js.map +1 -0
  299. package/dist/cli/dispatch/shared.js +64 -0
  300. package/dist/cli/dispatch/shared.js.map +1 -0
  301. package/dist/cli/dispatch/state.js +174 -0
  302. package/dist/cli/dispatch/state.js.map +1 -0
  303. package/dist/cli/dispatch.js +1 -957
  304. package/dist/cli/dispatch.js.map +1 -1
  305. package/dist/cli/errors.js +53 -0
  306. package/dist/cli/errors.js.map +1 -0
  307. package/dist/cli/help.js +419 -0
  308. package/dist/cli/help.js.map +1 -0
  309. package/dist/cli/migrationRequired.js +87 -0
  310. package/dist/cli/migrationRequired.js.map +1 -0
  311. package/dist/cli/orientation/attention.js +67 -0
  312. package/dist/cli/orientation/attention.js.map +1 -0
  313. package/dist/cli/orientation/corpusCoverage.js +103 -0
  314. package/dist/cli/orientation/corpusCoverage.js.map +1 -0
  315. package/dist/cli/orientation.js +407 -159
  316. package/dist/cli/orientation.js.map +1 -1
  317. package/dist/cli/planArtifacts.js +351 -0
  318. package/dist/cli/planArtifacts.js.map +1 -0
  319. package/dist/cli/planEvidence.js +158 -0
  320. package/dist/cli/planEvidence.js.map +1 -0
  321. package/dist/cli/planLifecycleState.js +34 -0
  322. package/dist/cli/planLifecycleState.js.map +1 -0
  323. package/dist/cli/planTaskIndex.js +12 -0
  324. package/dist/cli/planTaskIndex.js.map +1 -0
  325. package/dist/cli/prime-blob.js +69 -2
  326. package/dist/cli/prime-blob.js.map +1 -1
  327. package/dist/cli/startupCompletenessContract.js +57 -0
  328. package/dist/cli/startupCompletenessContract.js.map +1 -0
  329. package/dist/cli/stateQuery.js +63 -10
  330. package/dist/cli/stateQuery.js.map +1 -1
  331. package/dist/cli/structured.js.map +1 -1
  332. package/dist/cli/todoMarkdown.js +33 -0
  333. package/dist/cli/todoMarkdown.js.map +1 -0
  334. package/dist/cli/todoReadinessSelection.js +157 -0
  335. package/dist/cli/todoReadinessSelection.js.map +1 -0
  336. package/dist/cli/todoSeverity.js +19 -0
  337. package/dist/cli/todoSeverity.js.map +1 -0
  338. package/dist/core/atomicWriter.js +21 -0
  339. package/dist/core/atomicWriter.js.map +1 -0
  340. package/dist/core/difflib.js.map +1 -1
  341. package/dist/core/envPaths.js +21 -0
  342. package/dist/core/envPaths.js.map +1 -0
  343. package/dist/core/jsonValue.js +6 -0
  344. package/dist/core/jsonValue.js.map +1 -0
  345. package/dist/core/paths.js.map +1 -1
  346. package/dist/core/pyjson.js +67 -2
  347. package/dist/core/pyjson.js.map +1 -1
  348. package/dist/core/skillIdentity.js +24 -0
  349. package/dist/core/skillIdentity.js.map +1 -0
  350. package/dist/core/sourceRoot.js.map +1 -1
  351. package/dist/core/text.js +11 -0
  352. package/dist/core/text.js.map +1 -0
  353. package/dist/core/toml.js.map +1 -1
  354. package/dist/core/yaml.js +8 -0
  355. package/dist/core/yaml.js.map +1 -1
  356. package/dist/eval/evalSkills.js +30 -25
  357. package/dist/eval/evalSkills.js.map +1 -1
  358. package/dist/eval/hybridRouteEvaluation.js +156 -0
  359. package/dist/eval/hybridRouteEvaluation.js.map +1 -0
  360. package/dist/eval/semanticEval.js +43 -19
  361. package/dist/eval/semanticEval.js.map +1 -1
  362. package/dist/eval/semanticFixtures.js +16 -4
  363. package/dist/eval/semanticFixtures.js.map +1 -1
  364. package/dist/hooks/common.js +10 -27
  365. package/dist/hooks/common.js.map +1 -1
  366. package/dist/hooks/compaction/apply.js +447 -0
  367. package/dist/hooks/compaction/apply.js.map +1 -0
  368. package/dist/hooks/compaction/dryRun.js +185 -0
  369. package/dist/hooks/compaction/dryRun.js.map +1 -0
  370. package/dist/hooks/compaction/index.js +23 -0
  371. package/dist/hooks/compaction/index.js.map +1 -0
  372. package/dist/hooks/compaction/parse.js +326 -0
  373. package/dist/hooks/compaction/parse.js.map +1 -0
  374. package/dist/hooks/compaction/retention.js +203 -0
  375. package/dist/hooks/compaction/retention.js.map +1 -0
  376. package/dist/hooks/compaction/status.js +361 -0
  377. package/dist/hooks/compaction/status.js.map +1 -0
  378. package/dist/hooks/compaction/types.js +6 -0
  379. package/dist/hooks/compaction/types.js.map +1 -0
  380. package/dist/hooks/cursorPreToolUse.js +1 -1
  381. package/dist/hooks/cursorPreToolUse.js.map +1 -1
  382. package/dist/hooks/cursorSessionStart.js +14 -21
  383. package/dist/hooks/cursorSessionStart.js.map +1 -1
  384. package/dist/hooks/projectHookInput.js +26 -0
  385. package/dist/hooks/projectHookInput.js.map +1 -0
  386. package/dist/hooks/sessionStart.js +55 -170
  387. package/dist/hooks/sessionStart.js.map +1 -1
  388. package/dist/hooks/sessionStop.js +12 -26
  389. package/dist/hooks/sessionStop.js.map +1 -1
  390. package/dist/hooks/validateArtifact/agentFacing.js +10 -0
  391. package/dist/hooks/validateArtifact/agentFacing.js.map +1 -0
  392. package/dist/hooks/validateArtifact/index.js +151 -0
  393. package/dist/hooks/validateArtifact/index.js.map +1 -0
  394. package/dist/hooks/validateArtifact/markdown.js +146 -0
  395. package/dist/hooks/validateArtifact/markdown.js.map +1 -0
  396. package/dist/hooks/validateArtifact/runtime.js +86 -0
  397. package/dist/hooks/validateArtifact/runtime.js.map +1 -0
  398. package/dist/hooks/validateArtifact/schema.js +541 -0
  399. package/dist/hooks/validateArtifact/schema.js.map +1 -0
  400. package/dist/hooks/validateArtifact/traversal.js +108 -0
  401. package/dist/hooks/validateArtifact/traversal.js.map +1 -0
  402. package/dist/hooks/validateArtifact/violations.js +108 -0
  403. package/dist/hooks/validateArtifact/violations.js.map +1 -0
  404. package/dist/migrate/v2HandoffManifest.js +455 -0
  405. package/dist/migrate/v2HandoffManifest.js.map +1 -0
  406. package/dist/registries/artifactProtocolIds.js +77 -0
  407. package/dist/registries/artifactProtocolIds.js.map +1 -0
  408. package/dist/registries/artifactRegistry.js +222 -62
  409. package/dist/registries/artifactRegistry.js.map +1 -1
  410. package/dist/registries/capabilityContract.js +141 -12
  411. package/dist/registries/capabilityContract.js.map +1 -1
  412. package/dist/registries/evaluatorHandoffContract.js +171 -0
  413. package/dist/registries/evaluatorHandoffContract.js.map +1 -0
  414. package/dist/registries/evidenceTierContract.js +362 -0
  415. package/dist/registries/evidenceTierContract.js.map +1 -0
  416. package/dist/registries/hybridRoute.js +203 -0
  417. package/dist/registries/hybridRoute.js.map +1 -0
  418. package/dist/registries/hybridRouteReceipt.js +221 -0
  419. package/dist/registries/hybridRouteReceipt.js.map +1 -0
  420. package/dist/registries/packageRegistry.js +90 -230
  421. package/dist/registries/packageRegistry.js.map +1 -1
  422. package/dist/registries/todoReadinessContract.js +406 -0
  423. package/dist/registries/todoReadinessContract.js.map +1 -0
  424. package/dist/registries/triggerLoader.js +175 -0
  425. package/dist/registries/triggerLoader.js.map +1 -0
  426. package/dist/registries/verbosityBudgetContract.js +206 -0
  427. package/dist/registries/verbosityBudgetContract.js.map +1 -0
  428. package/dist/release/releaseMetadata.js +319 -0
  429. package/dist/release/releaseMetadata.js.map +1 -0
  430. package/dist/runtime/lifecycleAdapterContract.js +458 -0
  431. package/dist/runtime/lifecycleAdapterContract.js.map +1 -0
  432. package/dist/runtime/lifecycleAdapters.js +778 -0
  433. package/dist/runtime/lifecycleAdapters.js.map +1 -0
  434. package/dist/runtime/lifecycleAuthority.js +454 -0
  435. package/dist/runtime/lifecycleAuthority.js.map +1 -0
  436. package/dist/runtime/lifecycleOperationContract.js +114 -0
  437. package/dist/runtime/lifecycleOperationContract.js.map +1 -0
  438. package/dist/runtime/lifecycleOperations.js +635 -0
  439. package/dist/runtime/lifecycleOperations.js.map +1 -0
  440. package/dist/runtime/lifecycleOwnershipJournal.js +623 -0
  441. package/dist/runtime/lifecycleOwnershipJournal.js.map +1 -0
  442. package/dist/runtime/lifecyclePublication.js +416 -0
  443. package/dist/runtime/lifecyclePublication.js.map +1 -0
  444. package/dist/runtime/lifecycleSnapshot.js +439 -0
  445. package/dist/runtime/lifecycleSnapshot.js.map +1 -0
  446. package/dist/runtime/nativeResourceCleanup.js +317 -0
  447. package/dist/runtime/nativeResourceCleanup.js.map +1 -0
  448. package/dist/setup/codex/cli.js +130 -0
  449. package/dist/setup/codex/cli.js.map +1 -0
  450. package/dist/setup/codex/configToml.js +558 -0
  451. package/dist/setup/codex/configToml.js.map +1 -0
  452. package/dist/setup/codex/constants.js +14 -0
  453. package/dist/setup/codex/constants.js.map +1 -0
  454. package/dist/setup/codex/installRoot.js +64 -0
  455. package/dist/setup/codex/installRoot.js.map +1 -0
  456. package/dist/setup/codex/state.js +252 -0
  457. package/dist/setup/codex/state.js.map +1 -0
  458. package/dist/setup/codex.js +9 -1055
  459. package/dist/setup/codex.js.map +1 -1
  460. package/dist/setup/opencode.js +21 -0
  461. package/dist/setup/opencode.js.map +1 -0
  462. package/dist/setup/opencodeConstants.js +2 -0
  463. package/dist/setup/opencodeConstants.js.map +1 -0
  464. package/dist/setup/sharedSkill.js +46 -0
  465. package/dist/setup/sharedSkill.js.map +1 -0
  466. package/dist/setup/smokeChecks.js +82 -0
  467. package/dist/setup/smokeChecks.js.map +1 -0
  468. package/dist/state/archiveDiscovery.js +578 -0
  469. package/dist/state/archiveDiscovery.js.map +1 -0
  470. package/dist/state/archivePublication.js +226 -0
  471. package/dist/state/archivePublication.js.map +1 -0
  472. package/dist/state/archiveRecovery.js +238 -0
  473. package/dist/state/archiveRecovery.js.map +1 -0
  474. package/dist/state/archiveReplay.js +54 -0
  475. package/dist/state/archiveReplay.js.map +1 -0
  476. package/dist/state/canonicalMigrationRecord.js +37 -0
  477. package/dist/state/canonicalMigrationRecord.js.map +1 -0
  478. package/dist/state/decisionEntities.js +322 -0
  479. package/dist/state/decisionEntities.js.map +1 -0
  480. package/dist/state/decisionLegacyValidation.js +216 -0
  481. package/dist/state/decisionLegacyValidation.js.map +1 -0
  482. package/dist/state/decisionMigrationProvenance.js +117 -0
  483. package/dist/state/decisionMigrationProvenance.js.map +1 -0
  484. package/dist/state/decisionOverlay.js +278 -0
  485. package/dist/state/decisionOverlay.js.map +1 -0
  486. package/dist/state/decisionRevision.js +632 -0
  487. package/dist/state/decisionRevision.js.map +1 -0
  488. package/dist/state/decisionRevisionPublication.js +532 -0
  489. package/dist/state/decisionRevisionPublication.js.map +1 -0
  490. package/dist/state/directRetrieval.js +373 -0
  491. package/dist/state/directRetrieval.js.map +1 -0
  492. package/dist/state/durability.js +325 -0
  493. package/dist/state/durability.js.map +1 -0
  494. package/dist/state/entityCutover.js +294 -0
  495. package/dist/state/entityCutover.js.map +1 -0
  496. package/dist/state/entityCutoverGit.js +128 -0
  497. package/dist/state/entityCutoverGit.js.map +1 -0
  498. package/dist/state/entityMigrationCausality.js +99 -0
  499. package/dist/state/entityMigrationCausality.js.map +1 -0
  500. package/dist/state/entityMigrationPreview.js +864 -0
  501. package/dist/state/entityMigrationPreview.js.map +1 -0
  502. package/dist/state/entityPublicationContext.js +662 -0
  503. package/dist/state/entityPublicationContext.js.map +1 -0
  504. package/dist/state/entityStorage.js +881 -0
  505. package/dist/state/entityStorage.js.map +1 -0
  506. package/dist/state/experimentArchive.js +64 -0
  507. package/dist/state/experimentArchive.js.map +1 -0
  508. package/dist/state/experimentIdentity.js +203 -0
  509. package/dist/state/experimentIdentity.js.map +1 -0
  510. package/dist/state/experimentRetrieval.js +447 -0
  511. package/dist/state/experimentRetrieval.js.map +1 -0
  512. package/dist/state/healthEntities.js +266 -0
  513. package/dist/state/healthEntities.js.map +1 -0
  514. package/dist/state/healthEntityValidation.js +19 -0
  515. package/dist/state/healthEntityValidation.js.map +1 -0
  516. package/dist/state/healthRepair.js +70 -0
  517. package/dist/state/healthRepair.js.map +1 -0
  518. package/dist/state/installRoot.js +64 -24
  519. package/dist/state/installRoot.js.map +1 -1
  520. package/dist/state/legacyEntityCutoverEvidence.js +66 -0
  521. package/dist/state/legacyEntityCutoverEvidence.js.map +1 -0
  522. package/dist/state/legacyIdentity.js +48 -0
  523. package/dist/state/legacyIdentity.js.map +1 -0
  524. package/dist/state/legacySummaryRecord.js +7 -0
  525. package/dist/state/legacySummaryRecord.js.map +1 -0
  526. package/dist/state/listAccounting.js +55 -0
  527. package/dist/state/listAccounting.js.map +1 -0
  528. package/dist/state/listClassification.js +18 -0
  529. package/dist/state/listClassification.js.map +1 -0
  530. package/dist/state/listCursor.js +43 -0
  531. package/dist/state/listCursor.js.map +1 -0
  532. package/dist/state/listRetrieval.js +813 -0
  533. package/dist/state/listRetrieval.js.map +1 -0
  534. package/dist/state/migrationSourceBinding.js +31 -0
  535. package/dist/state/migrationSourceBinding.js.map +1 -0
  536. package/dist/state/objectiveExperimentEntities.js +323 -0
  537. package/dist/state/objectiveExperimentEntities.js.map +1 -0
  538. package/dist/state/planEntities.js +444 -0
  539. package/dist/state/planEntities.js.map +1 -0
  540. package/dist/state/planIdentity.js +45 -0
  541. package/dist/state/planIdentity.js.map +1 -0
  542. package/dist/state/planRetrieval.js +314 -0
  543. package/dist/state/planRetrieval.js.map +1 -0
  544. package/dist/state/planTaskRetrieval.js +285 -0
  545. package/dist/state/planTaskRetrieval.js.map +1 -0
  546. package/dist/state/progressEntities.js +360 -0
  547. package/dist/state/progressEntities.js.map +1 -0
  548. package/dist/state/projectRoot.js +63 -0
  549. package/dist/state/projectRoot.js.map +1 -0
  550. package/dist/state/projectionPolicy.js +184 -0
  551. package/dist/state/projectionPolicy.js.map +1 -0
  552. package/dist/state/retrievalAuthority.js +343 -0
  553. package/dist/state/retrievalAuthority.js.map +1 -0
  554. package/dist/state/safeProjectFile.js +153 -0
  555. package/dist/state/safeProjectFile.js.map +1 -0
  556. package/dist/state/startupAnalysis/benchmark.js +433 -0
  557. package/dist/state/startupAnalysis/benchmark.js.map +1 -0
  558. package/dist/state/startupAnalysis/contract.js +126 -0
  559. package/dist/state/startupAnalysis/contract.js.map +1 -0
  560. package/dist/state/startupAnalysis/helpers.js +287 -0
  561. package/dist/state/startupAnalysis/helpers.js.map +1 -0
  562. package/dist/state/startupAnalysis/index.js +7 -0
  563. package/dist/state/startupAnalysis/index.js.map +1 -0
  564. package/dist/state/startupAnalysis/metrics.js +341 -0
  565. package/dist/state/startupAnalysis/metrics.js.map +1 -0
  566. package/dist/state/startupAnalysis/records.js +199 -0
  567. package/dist/state/startupAnalysis/records.js.map +1 -0
  568. package/dist/state/startupAnalysis/report.js +112 -0
  569. package/dist/state/startupAnalysis/report.js.map +1 -0
  570. package/dist/state/startupAnalysis/threshold.js +513 -0
  571. package/dist/state/startupAnalysis/threshold.js.map +1 -0
  572. package/dist/state/startupAnalysis.js +2 -1952
  573. package/dist/state/startupAnalysis.js.map +1 -1
  574. package/dist/state/startupProjection.js +567 -0
  575. package/dist/state/startupProjection.js.map +1 -0
  576. package/dist/state/stateMode.js +83 -0
  577. package/dist/state/stateMode.js.map +1 -0
  578. package/dist/state/summaryEntityRead.js +26 -0
  579. package/dist/state/summaryEntityRead.js.map +1 -0
  580. package/dist/state/summaryMigrationProvenance.js +67 -0
  581. package/dist/state/summaryMigrationProvenance.js.map +1 -0
  582. package/dist/state/summarySourceRowAuthority.js +37 -0
  583. package/dist/state/summarySourceRowAuthority.js.map +1 -0
  584. package/dist/state/todoDocsEntities.js +267 -0
  585. package/dist/state/todoDocsEntities.js.map +1 -0
  586. package/dist/state/todoDocsEntityValidation.js +34 -0
  587. package/dist/state/todoDocsEntityValidation.js.map +1 -0
  588. package/dist/state/write/assign.js +21 -0
  589. package/dist/state/write/assign.js.map +1 -0
  590. package/dist/state/write/candidateMutation.js +281 -0
  591. package/dist/state/write/candidateMutation.js.map +1 -0
  592. package/dist/state/write/errors.js +12 -0
  593. package/dist/state/write/errors.js.map +1 -0
  594. package/dist/state/write/experimentPublication.js +193 -0
  595. package/dist/state/write/experimentPublication.js.map +1 -0
  596. package/dist/state/write/explain.js +303 -0
  597. package/dist/state/write/explain.js.map +1 -0
  598. package/dist/state/write/fields.js +62 -0
  599. package/dist/state/write/fields.js.map +1 -0
  600. package/dist/state/write/helpers.js +30 -0
  601. package/dist/state/write/helpers.js.map +1 -0
  602. package/dist/state/write/index.js +12 -0
  603. package/dist/state/write/index.js.map +1 -0
  604. package/dist/state/write/input.js +22 -0
  605. package/dist/state/write/input.js.map +1 -0
  606. package/dist/state/write/lock.js +838 -0
  607. package/dist/state/write/lock.js.map +1 -0
  608. package/dist/state/write/mutation.js +235 -0
  609. package/dist/state/write/mutation.js.map +1 -0
  610. package/dist/state/write/operations.js +375 -0
  611. package/dist/state/write/operations.js.map +1 -0
  612. package/dist/state/write/planEvaluation.js +121 -0
  613. package/dist/state/write/planEvaluation.js.map +1 -0
  614. package/dist/state/write/planPublication.js +135 -0
  615. package/dist/state/write/planPublication.js.map +1 -0
  616. package/dist/state/write/serialize.js +2 -0
  617. package/dist/state/write/serialize.js.map +1 -0
  618. package/dist/state/write/transaction.js +44 -0
  619. package/dist/state/write/transaction.js.map +1 -0
  620. package/dist/state/write/validate.js +8 -0
  621. package/dist/state/write/validate.js.map +1 -0
  622. package/dist/upgrade/appContentRefresh.js +384 -0
  623. package/dist/upgrade/appContentRefresh.js.map +1 -0
  624. package/dist/upgrade/appModel.js +8 -6
  625. package/dist/upgrade/appModel.js.map +1 -1
  626. package/dist/upgrade/atomicWriter.js +2 -0
  627. package/dist/upgrade/atomicWriter.js.map +1 -0
  628. package/dist/upgrade/bundleEvidence.js +34 -0
  629. package/dist/upgrade/bundleEvidence.js.map +1 -0
  630. package/dist/upgrade/channels.js +21 -10
  631. package/dist/upgrade/channels.js.map +1 -1
  632. package/dist/upgrade/coexistenceProbe.js +105 -0
  633. package/dist/upgrade/coexistenceProbe.js.map +1 -0
  634. package/dist/upgrade/compatibility.js +56 -20
  635. package/dist/upgrade/compatibility.js.map +1 -1
  636. package/dist/upgrade/doctor.js +197 -191
  637. package/dist/upgrade/doctor.js.map +1 -1
  638. package/dist/upgrade/doctorClassifier.js +188 -0
  639. package/dist/upgrade/doctorClassifier.js.map +1 -0
  640. package/dist/upgrade/installedHooksRetirement.js +197 -0
  641. package/dist/upgrade/installedHooksRetirement.js.map +1 -0
  642. package/dist/upgrade/legacyAgentCleanup.js +283 -0
  643. package/dist/upgrade/legacyAgentCleanup.js.map +1 -0
  644. package/dist/upgrade/lifecycleUpgrade.js +114 -0
  645. package/dist/upgrade/lifecycleUpgrade.js.map +1 -0
  646. package/dist/upgrade/migrateArtifactsV2ToV3.js +363 -137
  647. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -1
  648. package/dist/upgrade/migrationPublication.js +123 -0
  649. package/dist/upgrade/migrationPublication.js.map +1 -0
  650. package/dist/upgrade/nextMajorDoctor.js +156 -0
  651. package/dist/upgrade/nextMajorDoctor.js.map +1 -0
  652. package/dist/upgrade/npxPlatformStatus.js +23 -0
  653. package/dist/upgrade/npxPlatformStatus.js.map +1 -0
  654. package/dist/upgrade/projectIntegration.js +142 -171
  655. package/dist/upgrade/projectIntegration.js.map +1 -1
  656. package/dist/upgrade/projectIntegrationDecision.js +51 -0
  657. package/dist/upgrade/projectIntegrationDecision.js.map +1 -0
  658. package/dist/upgrade/runtimeMigration.js +336 -281
  659. package/dist/upgrade/runtimeMigration.js.map +1 -1
  660. package/dist/upgrade/upgradeCommands.js +9 -0
  661. package/dist/upgrade/upgradeCommands.js.map +1 -1
  662. package/dist/upgrade/upgradeLock.js +86 -0
  663. package/dist/upgrade/upgradeLock.js.map +1 -0
  664. package/dist/upgrade/upgradeOrchestrator.js +212 -56
  665. package/dist/upgrade/upgradeOrchestrator.js.map +1 -1
  666. package/dist/upgrade/v3CapabilitySurface.js +15 -0
  667. package/dist/upgrade/v3CapabilitySurface.js.map +1 -0
  668. package/dist/upgrade/versionResolution.js +12 -4
  669. package/dist/upgrade/versionResolution.js.map +1 -1
  670. package/dist/validate/appHomeContract.js +5 -9
  671. package/dist/validate/appHomeContract.js.map +1 -1
  672. package/dist/validate/capability.js +144 -14
  673. package/dist/validate/capability.js.map +1 -1
  674. package/dist/validate/crossCapability.js +12 -9
  675. package/dist/validate/crossCapability.js.map +1 -1
  676. package/dist/validate/selfAudit.js +73 -36
  677. package/dist/validate/selfAudit.js.map +1 -1
  678. package/dist/validate/vocabularyAuthority.js +303 -0
  679. package/dist/validate/vocabularyAuthority.js.map +1 -0
  680. package/package.json +45 -27
  681. package/bundle/references/adapters/cursor.md +0 -213
  682. package/bundle/references/adapters/opencode.md +0 -530
  683. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  684. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  685. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -548
  686. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  687. package/bundle/references/v1-section-mapping.md +0 -47
  688. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  689. package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
  690. package/bundle/skills/agentera/agents/hej.toml +0 -6
  691. package/bundle/skills/agentera/agents/inspektera.toml +0 -6
  692. package/bundle/skills/agentera/agents/inspirera.toml +0 -6
  693. package/bundle/skills/agentera/agents/optimera.toml +0 -6
  694. package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
  695. package/bundle/skills/agentera/agents/planera.toml +0 -6
  696. package/bundle/skills/agentera/agents/profilera.toml +0 -6
  697. package/bundle/skills/agentera/agents/realisera.toml +0 -6
  698. package/bundle/skills/agentera/agents/resonera.toml +0 -6
  699. package/bundle/skills/agentera/agents/visionera.toml +0 -6
  700. package/bundle/skills/agentera/agents/visualisera.toml +0 -6
  701. package/bundle/skills/agentera/capabilities/dokumentera/instructions.md +0 -428
  702. package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +0 -73
  703. package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +0 -35
  704. package/bundle/skills/agentera/capabilities/hej/instructions.md +0 -331
  705. package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +0 -69
  706. package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +0 -58
  707. package/bundle/skills/agentera/capabilities/inspektera/instructions.md +0 -514
  708. package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +0 -76
  709. package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +0 -38
  710. package/bundle/skills/agentera/capabilities/inspirera/instructions.md +0 -280
  711. package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
  712. package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +0 -34
  713. package/bundle/skills/agentera/capabilities/optimera/instructions.md +0 -437
  714. package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +0 -39
  715. package/bundle/skills/agentera/capabilities/orkestrera/instructions.md +0 -433
  716. package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +0 -64
  717. package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +0 -42
  718. package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -107
  719. package/bundle/skills/agentera/capabilities/planera/instructions.md +0 -368
  720. package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
  721. package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +0 -34
  722. package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
  723. package/bundle/skills/agentera/capabilities/profilera/instructions.md +0 -419
  724. package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +0 -45
  725. package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +0 -57
  726. package/bundle/skills/agentera/capabilities/realisera/instructions.md +0 -403
  727. package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +0 -80
  728. package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +0 -39
  729. package/bundle/skills/agentera/capabilities/resonera/instructions.md +0 -329
  730. package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +0 -47
  731. package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +0 -46
  732. package/bundle/skills/agentera/capabilities/visionera/instructions.md +0 -309
  733. package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +0 -41
  734. package/bundle/skills/agentera/capabilities/visualisera/instructions.md +0 -400
  735. package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +0 -33
  736. package/bundle/skills/hej/.claude-plugin/plugin.json +0 -6
  737. package/bundle/skills/hej/SKILL.md +0 -69
  738. package/bundle/skills/hej/agents/hej.toml +0 -11
  739. package/bundle/skills/hej/agents/openai.yaml +0 -8
  740. package/dist/cli/commands/backfill.js +0 -84
  741. package/dist/cli/commands/backfill.js.map +0 -1
  742. package/dist/cli/commands/state.js +0 -1012
  743. package/dist/cli/commands/state.js.map +0 -1
  744. package/dist/core/git.js +0 -43
  745. package/dist/core/git.js.map +0 -1
  746. package/dist/hooks/compaction.js +0 -935
  747. package/dist/hooks/compaction.js.map +0 -1
  748. package/dist/hooks/validateArtifact.js +0 -933
  749. package/dist/hooks/validateArtifact.js.map +0 -1
  750. package/dist/registries/runtimeAdapterRegistry.js +0 -315
  751. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  752. package/dist/setup/copilot.js +0 -227
  753. package/dist/setup/copilot.js.map +0 -1
  754. package/dist/setup/cursor.js +0 -127
  755. package/dist/setup/cursor.js.map +0 -1
  756. package/dist/setup/doctor.js +0 -1276
  757. package/dist/setup/doctor.js.map +0 -1
  758. package/dist/state/progressCommit.js +0 -289
  759. package/dist/state/progressCommit.js.map +0 -1
  760. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -571
  761. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  762. package/dist/validate/lifecycleAdapters.js +0 -772
  763. package/dist/validate/lifecycleAdapters.js.map +0 -1
  764. /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
  765. /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
  766. /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
@@ -0,0 +1,406 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { resolveSourceRoot } from "../core/sourceRoot.js";
4
+ import { loadYamlMapping } from "../core/yaml.js";
5
+ const SCHEMA_VERSION = "agentera.todoReadiness.v1";
6
+ const PHASE_AUTHORITY = "protocol.yaml#PHASES[*].capabilities";
7
+ const REQUIRED_FIELDS = [
8
+ "capability",
9
+ "reason",
10
+ "dependencies",
11
+ "blocked",
12
+ "gate",
13
+ "queue_rank",
14
+ "order_reason",
15
+ ];
16
+ const EVALUATION_PRECEDENCE = [
17
+ "todo_resolved",
18
+ "readiness_absent",
19
+ "blocked",
20
+ "gate_pending",
21
+ "dependency_cross_artifact",
22
+ "dependency_missing",
23
+ "dependency_cycle",
24
+ "dependency_open",
25
+ "ordering_conflict",
26
+ "actionable",
27
+ ];
28
+ const PROHIBITED_TIEBREAKERS = [
29
+ "entity_id",
30
+ "file_order",
31
+ "filesystem_time",
32
+ "created_or_modified_time",
33
+ "description_text",
34
+ ];
35
+ const OUTCOME_EXPECTATIONS = {
36
+ todo_resolved: { result: "resolved", eligible: false, attention: "none", recovery: "null" },
37
+ readiness_absent: { result: "needs-triage", eligible: false, attention: "item", recovery: "required" },
38
+ blocked: { result: "blocked", eligible: false, attention: "item", recovery: "required" },
39
+ gate_pending: { result: "gated", eligible: false, attention: "none", recovery: "required" },
40
+ dependency_cross_artifact: { result: "needs-triage", eligible: false, attention: "item", recovery: "required" },
41
+ dependency_missing: { result: "needs-triage", eligible: false, attention: "item", recovery: "required" },
42
+ dependency_cycle: { result: "needs-triage", eligible: false, attention: "item", recovery: "required" },
43
+ dependency_open: { result: "waiting", eligible: false, attention: "none", recovery: "required" },
44
+ dependency_resolved: { result: "satisfied", eligible: null, attention: "none", recovery: "null" },
45
+ ordering_conflict: { result: "needs-triage", eligible: false, attention: "item", recovery: "required" },
46
+ actionable: { result: "actionable", eligible: true, attention: "none", recovery: "null" },
47
+ };
48
+ const QUEUE_EXPECTATIONS = {
49
+ mixed_actionable_and_triage: {
50
+ selection: "highest_ordered_actionable",
51
+ attention: "bounded_triage_summary",
52
+ },
53
+ all_non_actionable: {
54
+ selection: "abstain",
55
+ attention: "bounded_highest_severity_summary",
56
+ },
57
+ };
58
+ function isMapping(value) {
59
+ return value !== null && typeof value === "object" && !Array.isArray(value);
60
+ }
61
+ function stringList(value) {
62
+ if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string"))
63
+ return null;
64
+ return value;
65
+ }
66
+ function sameList(actual, expected) {
67
+ const list = stringList(actual);
68
+ return list !== null && list.length === expected.length && list.every((value, index) => value === expected[index]);
69
+ }
70
+ function canonicalCapabilities(capabilityContract, errors, sourceLabel) {
71
+ const aliases = isMapping(capabilityContract.ROUTE_ALIASES)
72
+ ? capabilityContract.ROUTE_ALIASES.primary_aliases
73
+ : null;
74
+ if (!Array.isArray(aliases)) {
75
+ errors.push(`${sourceLabel}: ROUTE_ALIASES.primary_aliases must be a list`);
76
+ return [];
77
+ }
78
+ const capabilities = [];
79
+ for (const alias of aliases) {
80
+ if (!isMapping(alias) || typeof alias.capability !== "string" || !alias.capability.trim()) {
81
+ errors.push(`${sourceLabel}: each ROUTE_ALIASES.primary_aliases entry must declare capability`);
82
+ continue;
83
+ }
84
+ capabilities.push(alias.capability);
85
+ }
86
+ return capabilities;
87
+ }
88
+ function derivePhaseMapping(protocol, canonical, errors, sourceLabel) {
89
+ const mapping = new Map();
90
+ if (!isMapping(protocol.PHASES)) {
91
+ errors.push(`${sourceLabel}: protocol PHASES must be a mapping`);
92
+ return mapping;
93
+ }
94
+ for (const entry of Object.values(protocol.PHASES)) {
95
+ if (!isMapping(entry))
96
+ continue;
97
+ const phase = typeof entry.value === "string" ? entry.value : "";
98
+ const capabilities = stringList(entry.capabilities);
99
+ if (!phase || capabilities === null) {
100
+ errors.push(`${sourceLabel}: each PHASES entry must declare a value and capabilities list`);
101
+ continue;
102
+ }
103
+ for (const capability of capabilities) {
104
+ if (!canonical.has(capability)) {
105
+ errors.push(`${sourceLabel}: PHASES capability '${capability}' is not canonical`);
106
+ }
107
+ if (mapping.has(capability)) {
108
+ errors.push(`${sourceLabel}: capability '${capability}' appears in multiple PHASES entries`);
109
+ }
110
+ else {
111
+ mapping.set(capability, phase);
112
+ }
113
+ }
114
+ }
115
+ return mapping;
116
+ }
117
+ function validateFields(readiness, errors, sourceLabel) {
118
+ const fields = readiness.fields;
119
+ if (!isMapping(fields)) {
120
+ errors.push(`${sourceLabel}: READINESS.fields must be a mapping`);
121
+ return;
122
+ }
123
+ for (const name of REQUIRED_FIELDS) {
124
+ const field = fields[name];
125
+ if (!isMapping(field)) {
126
+ errors.push(`${sourceLabel}: READINESS.fields.${name} must be a mapping`);
127
+ continue;
128
+ }
129
+ if (field.required !== true) {
130
+ errors.push(`${sourceLabel}: READINESS.fields.${name}.required must be true`);
131
+ }
132
+ }
133
+ const capability = fields.capability;
134
+ if (isMapping(capability) && capability.enum_source !== PHASE_AUTHORITY) {
135
+ errors.push(`${sourceLabel}: READINESS.fields.capability.enum_source must be ${PHASE_AUTHORITY}`);
136
+ }
137
+ const dependencies = fields.dependencies;
138
+ const dependencyEntries = isMapping(dependencies) && isMapping(dependencies.entries)
139
+ ? dependencies.entries
140
+ : null;
141
+ const dependencyArtifact = dependencyEntries && isMapping(dependencyEntries.artifact)
142
+ ? dependencyEntries.artifact
143
+ : null;
144
+ if (dependencyArtifact?.const !== "todo") {
145
+ errors.push(`${sourceLabel}: dependency artifact const must be todo`);
146
+ }
147
+ }
148
+ function validateOutcomes(readiness, errors, sourceLabel) {
149
+ const outcomes = readiness.outcomes;
150
+ if (!isMapping(outcomes)) {
151
+ errors.push(`${sourceLabel}: READINESS.outcomes must be a mapping`);
152
+ return;
153
+ }
154
+ for (const [name, expected] of Object.entries(OUTCOME_EXPECTATIONS)) {
155
+ const outcome = outcomes[name];
156
+ if (!isMapping(outcome)) {
157
+ errors.push(`${sourceLabel}: READINESS.outcomes.${name} must be a mapping`);
158
+ continue;
159
+ }
160
+ if (outcome.result !== expected.result) {
161
+ errors.push(`${sourceLabel}: READINESS.outcomes.${name}.result must be ${expected.result}`);
162
+ }
163
+ if (outcome.eligible !== expected.eligible) {
164
+ errors.push(`${sourceLabel}: READINESS.outcomes.${name}.eligible must be ${String(expected.eligible)}`);
165
+ }
166
+ if (outcome.attention !== expected.attention) {
167
+ errors.push(`${sourceLabel}: READINESS.outcomes.${name}.attention must be one of: none, item`);
168
+ }
169
+ const validRecovery = expected.recovery === "null"
170
+ ? outcome.recovery === null
171
+ : typeof outcome.recovery === "string" && outcome.recovery.trim().length > 0;
172
+ if (!validRecovery) {
173
+ errors.push(`${sourceLabel}: READINESS.outcomes.${name}.recovery must be ${expected.recovery === "null" ? "null" : "a non-empty string"}`);
174
+ }
175
+ }
176
+ }
177
+ function validateQueueOutcomes(readiness, errors, sourceLabel) {
178
+ const outcomes = readiness.queue_outcomes;
179
+ if (!isMapping(outcomes)) {
180
+ errors.push(`${sourceLabel}: READINESS.queue_outcomes must be a mapping`);
181
+ return;
182
+ }
183
+ for (const [name, expected] of Object.entries(QUEUE_EXPECTATIONS)) {
184
+ const outcome = outcomes[name];
185
+ if (!isMapping(outcome)) {
186
+ errors.push(`${sourceLabel}: READINESS.queue_outcomes.${name} must be a mapping`);
187
+ continue;
188
+ }
189
+ if (outcome.selection !== expected.selection || outcome.attention !== expected.attention) {
190
+ errors.push(`${sourceLabel}: READINESS.queue_outcomes.${name} must use selection=${expected.selection} and attention=${expected.attention}`);
191
+ }
192
+ if (typeof outcome.recovery !== "string" || !outcome.recovery.trim()) {
193
+ errors.push(`${sourceLabel}: READINESS.queue_outcomes.${name}.recovery must be a non-empty string`);
194
+ }
195
+ }
196
+ }
197
+ function validateOrdering(readiness, errors, sourceLabel) {
198
+ const ordering = readiness.ordering;
199
+ if (!isMapping(ordering)) {
200
+ errors.push(`${sourceLabel}: READINESS.ordering must be a mapping`);
201
+ return;
202
+ }
203
+ if (ordering.primary !== "protocol.yaml#SEVERITY_ISSUE") {
204
+ errors.push(`${sourceLabel}: READINESS.ordering.primary must be protocol.yaml#SEVERITY_ISSUE`);
205
+ }
206
+ if (ordering.within_severity !== "queue_rank_ascending") {
207
+ errors.push(`${sourceLabel}: READINESS.ordering.within_severity must be queue_rank_ascending`);
208
+ }
209
+ if (ordering.duplicate_rank !== "ordering_conflict") {
210
+ errors.push(`${sourceLabel}: READINESS.ordering.duplicate_rank must be ordering_conflict`);
211
+ }
212
+ if (!sameList(ordering.prohibited_tiebreakers, PROHIBITED_TIEBREAKERS)) {
213
+ errors.push(`${sourceLabel}: READINESS.ordering.prohibited_tiebreakers must equal ${PROHIBITED_TIEBREAKERS.join(", ")}`);
214
+ }
215
+ }
216
+ export function validateTodoReadinessContract(todoSchema, protocol, capabilityContract, sourceLabel = "TODO readiness contract") {
217
+ const errors = [];
218
+ const readiness = todoSchema.READINESS;
219
+ if (!isMapping(readiness))
220
+ return [`${sourceLabel}: READINESS must be a mapping`];
221
+ if (readiness.schema_version !== SCHEMA_VERSION) {
222
+ errors.push(`${sourceLabel}: READINESS.schema_version must be ${SCHEMA_VERSION}`);
223
+ }
224
+ const canonicalList = canonicalCapabilities(capabilityContract, errors, sourceLabel);
225
+ const canonical = new Set(canonicalList);
226
+ const phaseByCapability = derivePhaseMapping(protocol, canonical, errors, sourceLabel);
227
+ const destination = readiness.destination;
228
+ if (!isMapping(destination)) {
229
+ errors.push(`${sourceLabel}: READINESS.destination must be a mapping`);
230
+ }
231
+ else {
232
+ if (destination.phase_authority !== PHASE_AUTHORITY) {
233
+ errors.push(`${sourceLabel}: READINESS.destination.phase_authority must be ${PHASE_AUTHORITY}`);
234
+ }
235
+ for (const duplicate of ["allowed_destinations", "phase_mapping"]) {
236
+ if (duplicate in destination) {
237
+ errors.push(`${sourceLabel}: READINESS.destination.${duplicate} duplicates the canonical PHASES authority`);
238
+ }
239
+ }
240
+ const excluded = destination.excluded_capabilities;
241
+ if (!isMapping(excluded)) {
242
+ errors.push(`${sourceLabel}: READINESS.destination.excluded_capabilities must be a mapping`);
243
+ }
244
+ else {
245
+ for (const capability of canonicalList) {
246
+ const mapped = phaseByCapability.has(capability);
247
+ const exclusion = excluded[capability];
248
+ if (mapped && exclusion !== undefined) {
249
+ errors.push(`${sourceLabel}: mapped capability '${capability}' must not also be excluded`);
250
+ }
251
+ else if (!mapped && (typeof exclusion !== "string" || !exclusion.trim())) {
252
+ errors.push(`${sourceLabel}: canonical capability '${capability}' must be mapped to one phase or explicitly excluded`);
253
+ }
254
+ }
255
+ for (const [capability, reason] of Object.entries(excluded)) {
256
+ if (!canonical.has(capability)) {
257
+ errors.push(`${sourceLabel}: excluded capability '${capability}' is not canonical`);
258
+ }
259
+ if (typeof reason !== "string" || !reason.trim()) {
260
+ errors.push(`${sourceLabel}: excluded capability '${capability}' must have a non-empty reason`);
261
+ }
262
+ }
263
+ }
264
+ }
265
+ validateFields(readiness, errors, sourceLabel);
266
+ const evaluation = readiness.evaluation;
267
+ if (!isMapping(evaluation) || !sameList(evaluation.precedence, EVALUATION_PRECEDENCE)) {
268
+ errors.push(`${sourceLabel}: READINESS.evaluation.precedence must equal ${EVALUATION_PRECEDENCE.join(", ")}`);
269
+ }
270
+ validateOutcomes(readiness, errors, sourceLabel);
271
+ validateQueueOutcomes(readiness, errors, sourceLabel);
272
+ validateOrdering(readiness, errors, sourceLabel);
273
+ return errors;
274
+ }
275
+ function requiredMappingFields(label, value, names) {
276
+ if (!isMapping(value))
277
+ return [`${label} must be a mapping or null`];
278
+ const errors = [];
279
+ for (const name of names) {
280
+ if (!(name in value))
281
+ errors.push(`${label}.${name} is required`);
282
+ else if (typeof value[name] !== "string" || !String(value[name]).trim())
283
+ errors.push(`${label}.${name} must be a non-empty string`);
284
+ }
285
+ for (const name of Object.keys(value)) {
286
+ if (!names.includes(name))
287
+ errors.push(`${label} has unsupported field '${name}'`);
288
+ }
289
+ return errors;
290
+ }
291
+ export function todoReadinessRecordViolations(readiness, contract = loadTodoReadinessContract()) {
292
+ if (!isMapping(readiness))
293
+ return ["readiness must be a mapping"];
294
+ const errors = [];
295
+ for (const field of REQUIRED_FIELDS) {
296
+ if (!(field in readiness))
297
+ errors.push(`${field} is required when readiness is declared`);
298
+ }
299
+ for (const field of Object.keys(readiness)) {
300
+ if (!REQUIRED_FIELDS.includes(field))
301
+ errors.push(`readiness has unsupported field '${field}'`);
302
+ }
303
+ if (typeof readiness.capability !== "string" || !contract.allowedDestinations.includes(readiness.capability)) {
304
+ errors.push(`capability must be one of: ${contract.allowedDestinations.join(", ")}`);
305
+ }
306
+ if (typeof readiness.reason !== "string" || !readiness.reason.trim())
307
+ errors.push("reason must be a non-empty string");
308
+ if (!Array.isArray(readiness.dependencies))
309
+ errors.push("dependencies must be a list");
310
+ else
311
+ for (const [index, dependency] of readiness.dependencies.entries()) {
312
+ if (!isMapping(dependency)) {
313
+ errors.push(`dependencies[${index}] must be a mapping`);
314
+ continue;
315
+ }
316
+ for (const field of Object.keys(dependency)) {
317
+ if (field !== "artifact" && field !== "id")
318
+ errors.push(`dependencies[${index}] has unsupported field '${field}'`);
319
+ }
320
+ if (dependency.artifact !== "todo")
321
+ errors.push(`dependencies[${index}] dependency artifact must be 'todo'`);
322
+ if (!/^[a-z]{10}$/.test(String(dependency.id ?? "")))
323
+ errors.push(`dependencies[${index}] dependency ID must be ten lowercase letters`);
324
+ }
325
+ if (readiness.blocked !== null)
326
+ errors.push(...requiredMappingFields("blocked", readiness.blocked, ["reason", "recovery"]));
327
+ if (readiness.gate !== null) {
328
+ errors.push(...requiredMappingFields("gate", readiness.gate, ["state", "reason", "recovery"]));
329
+ const gate = isMapping(readiness.gate) ? readiness.gate : {};
330
+ const gateFields = isMapping(contract.fields.gate) && isMapping(contract.fields.gate.fields) ? contract.fields.gate.fields : {};
331
+ const stateField = isMapping(gateFields.state) ? gateFields.state : {};
332
+ const allowed = stringList(stateField.enum) ?? [];
333
+ if (typeof gate.state === "string" && !allowed.includes(gate.state))
334
+ errors.push(`gate.state must be one of: ${allowed.join(", ")}`);
335
+ }
336
+ const queueField = isMapping(contract.fields.queue_rank) ? contract.fields.queue_rank : {};
337
+ const minimum = typeof queueField.minimum === "number" ? queueField.minimum : 1;
338
+ if (!Number.isInteger(readiness.queue_rank) || Number(readiness.queue_rank) < minimum)
339
+ errors.push(`queue_rank must be an integer greater than or equal to ${minimum}`);
340
+ if (typeof readiness.order_reason !== "string" || !readiness.order_reason.trim())
341
+ errors.push("order_reason must be a non-empty string");
342
+ return [...new Set(errors)];
343
+ }
344
+ export function todoReadinessReferenceViolations(itemId, readiness, todos) {
345
+ if (!isMapping(readiness) || !Array.isArray(readiness.dependencies))
346
+ return [];
347
+ const dependencies = readiness.dependencies
348
+ .filter(isMapping)
349
+ .map((dependency) => String(dependency.id ?? ""))
350
+ .filter((id) => /^[a-z]{10}$/.test(id));
351
+ const byId = new Map(todos.map((todo) => [todo.id, todo.record]));
352
+ const errors = [];
353
+ for (const dependency of dependencies) {
354
+ if (dependency === itemId)
355
+ errors.push(`TODO '${itemId}' cannot depend on itself`);
356
+ else if (!byId.has(dependency))
357
+ errors.push(`TODO dependency '${dependency}' does not exist`);
358
+ }
359
+ const reachesItem = (id, seen) => {
360
+ if (id === itemId)
361
+ return true;
362
+ if (seen.has(id))
363
+ return false;
364
+ seen.add(id);
365
+ const record = byId.get(id);
366
+ const nested = isMapping(record?.readiness) && Array.isArray(record.readiness.dependencies)
367
+ ? record.readiness.dependencies.filter(isMapping).map((dependency) => String(dependency.id ?? ""))
368
+ : [];
369
+ return nested.some((dependency) => reachesItem(dependency, seen));
370
+ };
371
+ if (!errors.length && dependencies.some((dependency) => reachesItem(dependency, new Set()))) {
372
+ errors.push(`TODO '${itemId}' would create a dependency cycle`);
373
+ }
374
+ return errors;
375
+ }
376
+ export class TodoReadinessContractError extends Error {
377
+ errors;
378
+ constructor(errors) {
379
+ super(errors.join("; "));
380
+ this.errors = errors;
381
+ this.name = "TodoReadinessContractError";
382
+ }
383
+ }
384
+ export function loadTodoReadinessContract(todoSchemaPath = path.join(resolveSourceRoot(), "skills", "agentera", "schemas", "artifacts", "todo.yaml"), protocolPath = path.join(resolveSourceRoot(), "skills", "agentera", "protocol.yaml"), capabilityContractPath = path.join(resolveSourceRoot(), "skills", "agentera", "capability_schema_contract.yaml")) {
385
+ const todoSchema = loadYamlMapping(fs.readFileSync(todoSchemaPath, "utf8"));
386
+ const protocol = loadYamlMapping(fs.readFileSync(protocolPath, "utf8"));
387
+ const capabilityContract = loadYamlMapping(fs.readFileSync(capabilityContractPath, "utf8"));
388
+ const errors = validateTodoReadinessContract(todoSchema, protocol, capabilityContract, todoSchemaPath);
389
+ if (errors.length)
390
+ throw new TodoReadinessContractError(errors);
391
+ const readiness = todoSchema.READINESS;
392
+ const destination = readiness.destination;
393
+ const phaseByCapability = derivePhaseMapping(protocol, new Set(canonicalCapabilities(capabilityContract, [], capabilityContractPath)), [], protocolPath);
394
+ return {
395
+ schemaVersion: readiness.schema_version,
396
+ allowedDestinations: [...phaseByCapability.keys()],
397
+ phaseByCapability,
398
+ excludedCapabilities: destination.excluded_capabilities,
399
+ fields: readiness.fields,
400
+ precedence: readiness.evaluation.precedence,
401
+ outcomes: readiness.outcomes,
402
+ queueOutcomes: readiness.queue_outcomes,
403
+ ordering: readiness.ordering,
404
+ };
405
+ }
406
+ //# sourceMappingURL=todoReadinessContract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"todoReadinessContract.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera/packages/cli/src/registries/todoReadinessContract.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,175 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { loadYamlMapping } from "../core/yaml.js";
4
+ import { resolveSourceRoot } from "../core/sourceRoot.js";
5
+ export class TriggerLoaderError extends Error {
6
+ errors;
7
+ constructor(errors) {
8
+ super(errors.join("; "));
9
+ this.name = "TriggerLoaderError";
10
+ this.errors = errors;
11
+ }
12
+ }
13
+ function isMapping(value) {
14
+ return value !== null && typeof value === "object" && !Array.isArray(value);
15
+ }
16
+ function isNumericKey(key) {
17
+ return /^\d+$/.test(key) && Number(key) >= 1;
18
+ }
19
+ /** Absolute directory holding the Agentera capability schemas. */
20
+ export function capabilitiesBaseDir(sourceRoot = resolveSourceRoot()) {
21
+ return path.join(sourceRoot, "skills", "agentera", "capabilities");
22
+ }
23
+ /** Absolute path to a capability's triggers.yaml. */
24
+ export function triggersYamlPath(capability, sourceRoot = resolveSourceRoot()) {
25
+ return path.join(capabilitiesBaseDir(sourceRoot), capability, "schemas", "triggers.yaml");
26
+ }
27
+ function readTriggersYaml(filePath) {
28
+ if (!fs.existsSync(filePath)) {
29
+ throw new TriggerLoaderError([`triggers.yaml not found at ${filePath}`]);
30
+ }
31
+ return loadYamlMapping(fs.readFileSync(filePath, "utf8")); // cast: YAML parse IO boundary
32
+ }
33
+ function resolveDisambiguation(value, location, allowedCapabilityIds) {
34
+ if (value === undefined || value === null)
35
+ return [];
36
+ if (!Array.isArray(value)) {
37
+ throw new TriggerLoaderError([
38
+ `${location} disambiguates_against must be a list of mappings`,
39
+ ]);
40
+ }
41
+ const entries = [];
42
+ for (let i = 0; i < value.length; i++) {
43
+ const item = value[i];
44
+ if (!isMapping(item)) {
45
+ throw new TriggerLoaderError([
46
+ `${location} disambiguates_against[${i}] must be a mapping with 'capability' and 'hint'`,
47
+ ]);
48
+ }
49
+ const capability = item.capability;
50
+ if (typeof capability !== "string" || !capability) {
51
+ throw new TriggerLoaderError([
52
+ `${location} disambiguates_against[${i}] missing 'capability' (must be one of: ${allowedCapabilityIds.join(", ")})`,
53
+ ]);
54
+ }
55
+ if (!allowedCapabilityIds.includes(capability)) {
56
+ throw new TriggerLoaderError([
57
+ `${location} disambiguates_against[${i}].capability=${JSON.stringify(capability)} is not a canonical capability ID (must be one of: ${allowedCapabilityIds.join(", ")})`,
58
+ ]);
59
+ }
60
+ const hint = item.hint;
61
+ if (typeof hint !== "string" || hint.trim() === "") {
62
+ throw new TriggerLoaderError([
63
+ `${location} disambiguates_against[${i}] missing or empty 'hint' (must be a non-empty string)`,
64
+ ]);
65
+ }
66
+ entries.push({ capability, hint });
67
+ }
68
+ return entries;
69
+ }
70
+ function buildTriggerEntry(key, raw, capability, contract) {
71
+ const location = `TRIGGERS entry ${key} in ${capability}/schemas/triggers.yaml`;
72
+ const id = raw.id;
73
+ if (typeof id !== "string" || !id) {
74
+ throw new TriggerLoaderError([`${location} missing 'id'`]);
75
+ }
76
+ const description = raw.description;
77
+ if (typeof description !== "string" || description.trim() === "") {
78
+ throw new TriggerLoaderError([`${location} missing 'description'`]);
79
+ }
80
+ const priorityRaw = raw.priority;
81
+ if (typeof priorityRaw !== "string" ||
82
+ !contract.triggerPriorityRules.allowedValues.includes(priorityRaw)) {
83
+ throw new TriggerLoaderError([
84
+ `${location} has invalid priority=${JSON.stringify(priorityRaw)} (must be one of: ${contract.triggerPriorityRules.allowedValues.join(", ")})`,
85
+ ]);
86
+ }
87
+ const priority = priorityRaw;
88
+ const disambiguatesAgainst = resolveDisambiguation(raw.disambiguates_against, location, contract.triggerEnrichment.allowedCapabilityIds);
89
+ const fallback = raw.fallback === true;
90
+ return {
91
+ id,
92
+ description,
93
+ priority,
94
+ disambiguatesAgainst,
95
+ fallback,
96
+ };
97
+ }
98
+ function buildCapabilityTriggers(capability, contract, sourceRoot) {
99
+ const filePath = triggersYamlPath(capability, sourceRoot);
100
+ const data = readTriggersYaml(filePath);
101
+ const triggersGroup = data.TRIGGERS;
102
+ if (!isMapping(triggersGroup)) {
103
+ throw new TriggerLoaderError([
104
+ `${capability}/schemas/triggers.yaml is missing the TRIGGERS group`,
105
+ ]);
106
+ }
107
+ const triggers = [];
108
+ for (const key of Object.keys(triggersGroup)) {
109
+ if (!isNumericKey(key)) {
110
+ throw new TriggerLoaderError([
111
+ `${capability}/schemas/triggers.yaml has non-numeric key ${JSON.stringify(key)} in TRIGGERS`,
112
+ ]);
113
+ }
114
+ const entry = triggersGroup[key];
115
+ if (!isMapping(entry)) {
116
+ throw new TriggerLoaderError([
117
+ `TRIGGERS entry ${key} in ${capability}/schemas/triggers.yaml is not a mapping`,
118
+ ]);
119
+ }
120
+ triggers.push(buildTriggerEntry(key, entry, capability, contract));
121
+ }
122
+ return { capability, triggers };
123
+ }
124
+ /**
125
+ * Load all twelve capability triggers.yaml files into a typed active
126
+ * TriggerModel.
127
+ * The capability set is the ROUTE_ALIASES.primary_aliases list owned by the
128
+ * capability schema contract. Absent `disambiguates_against` defaults to an
129
+ * empty list; its capability references are validated against the canonical
130
+ * capability IDs and each must resolve to a capability present in the returned
131
+ * model.
132
+ */
133
+ export function loadTriggerModel(contract, options = {}) {
134
+ const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
135
+ const capabilities = contract.routeAliases.primaryAliases.map((alias) => alias.capability);
136
+ const errors = [];
137
+ const model = new Map();
138
+ for (const capability of capabilities) {
139
+ try {
140
+ model.set(capability, buildCapabilityTriggers(capability, contract, sourceRoot));
141
+ }
142
+ catch (exc) {
143
+ if (exc instanceof TriggerLoaderError) {
144
+ errors.push(...exc.errors);
145
+ }
146
+ else {
147
+ throw exc;
148
+ }
149
+ }
150
+ }
151
+ if (errors.length > 0) {
152
+ throw new TriggerLoaderError(errors);
153
+ }
154
+ // Resolve disambiguates_against references: each capability referenced must
155
+ // resolve to a capability present in the model with at least one trigger.
156
+ const resolutionErrors = [];
157
+ for (const { capability, triggers } of model.values()) {
158
+ for (const entry of triggers) {
159
+ for (const ref of entry.disambiguatesAgainst) {
160
+ const referenced = model.get(ref.capability);
161
+ if (!referenced) {
162
+ resolutionErrors.push(`TRIGGERS entry ${entry.id} in ${capability}/schemas/triggers.yaml disambiguates_against.capability=${JSON.stringify(ref.capability)} does not resolve to a loaded capability`);
163
+ }
164
+ else if (referenced.triggers.length === 0) {
165
+ resolutionErrors.push(`TRIGGERS entry ${entry.id} in ${capability}/schemas/triggers.yaml disambiguates_against.capability=${JSON.stringify(ref.capability)} resolves to a capability with no trigger entries`);
166
+ }
167
+ }
168
+ }
169
+ }
170
+ if (resolutionErrors.length > 0) {
171
+ throw new TriggerLoaderError(resolutionErrors);
172
+ }
173
+ return { capabilities: model };
174
+ }
175
+ //# sourceMappingURL=triggerLoader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"triggerLoader.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera/packages/cli/src/registries/triggerLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAsC1D,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,MAAM,CAAW;IAC1B,YAAY,MAAgB;QAC1B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,mBAAmB,CAAC,aAAqB,iBAAiB,EAAE;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;AACrE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,aAAqB,iBAAiB,EAAE;IAC3F,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,kBAAkB,CAAC,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,eAAe,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAe,CAAC,CAAC,+BAA+B;AAC1G,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,QAAgB,EAChB,oBAAuC;IAEvC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,kBAAkB,CAAC;YAC3B,GAAG,QAAQ,mDAAmD;SAC/D,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,GAAG,QAAQ,0BAA0B,CAAC,kDAAkD;aACzF,CAAC,CAAC;QACL,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;YAClD,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,GAAG,QAAQ,0BAA0B,CAAC,2CAA2C,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACpH,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,GAAG,QAAQ,0BAA0B,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,sDAAsD,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACzK,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,GAAG,QAAQ,0BAA0B,CAAC,wDAAwD;aAC/F,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CACxB,GAAW,EACX,GAAe,EACf,UAAkB,EAClB,QAAkC;IAElC,MAAM,QAAQ,GAAG,kBAAkB,GAAG,OAAO,UAAU,wBAAwB,CAAC;IAEhF,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;IAClB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,kBAAkB,CAAC,CAAC,GAAG,QAAQ,eAAe,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACpC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,kBAAkB,CAAC,CAAC,GAAG,QAAQ,wBAAwB,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;IACjC,IACE,OAAO,WAAW,KAAK,QAAQ;QAC/B,CAAC,QAAQ,CAAC,oBAAoB,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,EAClE,CAAC;QACD,MAAM,IAAI,kBAAkB,CAAC;YAC3B,GAAG,QAAQ,yBAAyB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,qBAAqB,QAAQ,CAAC,oBAAoB,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAC9I,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,WAAwC,CAAC;IAE1D,MAAM,oBAAoB,GAAG,qBAAqB,CAChD,GAAG,CAAC,qBAAqB,EACzB,QAAQ,EACR,QAAQ,CAAC,iBAAiB,CAAC,oBAAoB,CAChD,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC;IAEvC,OAAO;QACL,EAAE;QACF,WAAW;QACX,QAAQ;QACR,oBAAoB;QACpB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,UAAkB,EAClB,QAAkC,EAClC,UAAkB;IAElB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAAC;YAC3B,GAAG,UAAU,sDAAsD;SACpE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,GAAG,UAAU,8CAA8C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc;aAC7F,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAI,aAA4B,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,kBAAkB,GAAG,OAAO,UAAU,yCAAyC;aAChF,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAkC,EAClC,UAAmC,EAAE;IAErC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAE3F,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsC,CAAC;IAE5D,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,uBAAuB,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,KAAK,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACtD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;gBAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,gBAAgB,CAAC,IAAI,CACnB,kBAAkB,KAAK,CAAC,EAAE,OAAO,UAAU,2DAA2D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,0CAA0C,CAC/K,CAAC;gBACJ,CAAC;qBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5C,gBAAgB,CAAC,IAAI,CACnB,kBAAkB,KAAK,CAAC,EAAE,OAAO,UAAU,2DAA2D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,mDAAmD,CACxL,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC"}