agentera 3.0.0-dev.5 → 3.0.0-dev.7

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 (510) hide show
  1. package/README.md +4 -3
  2. package/bundle/extract-corpus-parity.json +23 -0
  3. package/bundle/references/adapters/cursor.md +10 -9
  4. package/bundle/references/adapters/opencode.md +26 -26
  5. package/bundle/references/adapters/package-registry.yaml +0 -1
  6. package/bundle/references/adapters/package-surface-characterization.md +1 -2
  7. package/bundle/references/adapters/runtime-adapter-characterization.md +1 -1
  8. package/bundle/references/adapters/runtime-adapter-registry.yaml +16 -10
  9. package/bundle/references/adapters/runtime-feature-parity.md +2 -2
  10. package/bundle/references/analysis/benchmark.md +1 -1
  11. package/bundle/references/analysis/startup-measurement-contract.yaml +18 -18
  12. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +4 -3
  13. package/bundle/references/cli/agent-ready-state-contract.yaml +6 -6
  14. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +4 -4
  15. package/bundle/references/cli/audience-namespace-cli-migration.yaml +40 -26
  16. package/bundle/references/cli/bundle-skill-vocabulary.yaml +1 -29
  17. package/bundle/references/cli/capability-tool-classification.yaml +12 -12
  18. package/bundle/references/cli/coexistence-probe.yaml +13 -0
  19. package/bundle/references/cli/parity-expected-actual-template.md +30 -0
  20. package/bundle/references/cli/routing-execution-vocabulary.yaml +6 -6
  21. package/bundle/references/cli/routing-model.md +96 -0
  22. package/bundle/references/cli/single-name-protocol.yaml +42 -0
  23. package/bundle/references/cli/trigger-schema-enrichment.md +136 -0
  24. package/bundle/references/cli/update-channels.yaml +16 -0
  25. package/bundle/references/cli/upgrade-repair-wording.md +45 -0
  26. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +98 -0
  27. package/bundle/references/cli/vocabulary-index.yaml +17 -12
  28. package/bundle/references/cli/vocabulary.md +316 -309
  29. package/bundle/references/meta/documentation-inventory.md +9 -3
  30. package/bundle/registry.json +13 -13
  31. package/bundle/skills/agentera/.claude-plugin/plugin.json +13 -13
  32. package/bundle/skills/agentera/SKILL.md +99 -415
  33. package/bundle/skills/agentera/agents/audit.toml +6 -0
  34. package/bundle/skills/agentera/agents/build.toml +6 -0
  35. package/bundle/skills/agentera/agents/design.toml +6 -0
  36. package/bundle/skills/agentera/agents/{planera.toml → discuss.toml} +3 -3
  37. package/bundle/skills/agentera/agents/{resonera.toml → document.toml} +3 -3
  38. package/bundle/skills/agentera/agents/{optimera.toml → optimize.toml} +2 -2
  39. package/bundle/skills/agentera/agents/orchestrate.toml +6 -0
  40. package/bundle/skills/agentera/agents/plan.toml +6 -0
  41. package/bundle/skills/agentera/agents/profile.toml +6 -0
  42. package/bundle/skills/agentera/agents/research.toml +6 -0
  43. package/bundle/skills/agentera/agents/status.toml +6 -0
  44. package/bundle/skills/agentera/agents/vision.toml +6 -0
  45. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/artifacts.yaml +10 -10
  46. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/triggers.yaml +15 -6
  47. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +9 -9
  48. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/artifacts.yaml +11 -11
  49. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/triggers.yaml +13 -3
  50. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/validation.yaml +7 -7
  51. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +6 -6
  52. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/triggers.yaml +15 -3
  53. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +5 -5
  54. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/artifacts.yaml +6 -6
  55. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/triggers.yaml +11 -3
  56. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/validation.yaml +4 -4
  57. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/artifacts.yaml +10 -10
  58. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/triggers.yaml +14 -3
  59. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +8 -8
  60. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +8 -8
  61. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/triggers.yaml +11 -3
  62. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +7 -7
  63. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/artifacts.yaml +10 -10
  64. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/triggers.yaml +16 -3
  65. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/validation.yaml +27 -27
  66. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/artifacts.yaml +8 -8
  67. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
  68. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/triggers.yaml +15 -3
  69. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/validation.yaml +3 -3
  70. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/artifacts.yaml +2 -2
  71. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +2 -1
  72. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/triggers.yaml +7 -3
  73. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/validation.yaml +2 -2
  74. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/artifacts.yaml +5 -5
  75. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/triggers.yaml +9 -3
  76. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
  77. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/artifacts.yaml +14 -11
  78. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/triggers.yaml +10 -4
  79. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
  80. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +8 -8
  81. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/triggers.yaml +17 -3
  82. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +7 -7
  83. package/bundle/skills/agentera/capability_schema_contract.yaml +178 -34
  84. package/bundle/skills/agentera/protocol.yaml +29 -29
  85. package/bundle/skills/agentera/references/contract.md +328 -319
  86. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +4 -4
  87. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +9 -9
  88. package/bundle/skills/agentera/schemas/artifacts/design.yaml +4 -4
  89. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +8 -7
  90. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +5 -5
  91. package/bundle/skills/agentera/schemas/artifacts/health.yaml +5 -5
  92. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +4 -4
  93. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +5 -5
  94. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +5 -5
  95. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +40 -35
  96. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
  97. package/dist/analytics/extractCorpus/cli.js +149 -0
  98. package/dist/analytics/extractCorpus/cli.js.map +1 -0
  99. package/dist/analytics/extractCorpus/copilotSessions.js +273 -0
  100. package/dist/analytics/extractCorpus/copilotSessions.js.map +1 -0
  101. package/dist/analytics/extractCorpus/core.js +364 -0
  102. package/dist/analytics/extractCorpus/core.js.map +1 -0
  103. package/dist/analytics/extractCorpus/corpus.js +145 -0
  104. package/dist/analytics/extractCorpus/corpus.js.map +1 -0
  105. package/dist/analytics/extractCorpus/coverageAudit.js +261 -0
  106. package/dist/analytics/extractCorpus/coverageAudit.js.map +1 -0
  107. package/dist/analytics/extractCorpus/cursorSessions.js +423 -0
  108. package/dist/analytics/extractCorpus/cursorSessions.js.map +1 -0
  109. package/dist/analytics/extractCorpus/extractCorpusParity.js +105 -0
  110. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +1 -0
  111. package/dist/analytics/extractCorpus/filesystemSources.js +122 -0
  112. package/dist/analytics/extractCorpus/filesystemSources.js.map +1 -0
  113. package/dist/analytics/extractCorpus/index.js +12 -0
  114. package/dist/analytics/extractCorpus/index.js.map +1 -0
  115. package/dist/analytics/extractCorpus/jsonlSessions.js +185 -0
  116. package/dist/analytics/extractCorpus/jsonlSessions.js.map +1 -0
  117. package/dist/analytics/extractCorpus/sqliteCaps.js +44 -0
  118. package/dist/analytics/extractCorpus/sqliteCaps.js.map +1 -0
  119. package/dist/analytics/extractCorpus/sqliteSessions.js +368 -0
  120. package/dist/analytics/extractCorpus/sqliteSessions.js.map +1 -0
  121. package/dist/analytics/extractCorpus.js +2 -1790
  122. package/dist/analytics/extractCorpus.js.map +1 -1
  123. package/dist/analytics/usageStats.js +20 -20
  124. package/dist/analytics/usageStats.js.map +1 -1
  125. package/dist/capabilities/audit/instructions.js +6 -0
  126. package/dist/capabilities/audit/instructions.js.map +1 -0
  127. package/dist/capabilities/build/instructions.js +6 -0
  128. package/dist/capabilities/build/instructions.js.map +1 -0
  129. package/dist/capabilities/design/instructions.js +5 -0
  130. package/dist/capabilities/design/instructions.js.map +1 -0
  131. package/dist/capabilities/discuss/instructions.js +6 -0
  132. package/dist/capabilities/discuss/instructions.js.map +1 -0
  133. package/dist/capabilities/document/instructions.js +6 -0
  134. package/dist/capabilities/document/instructions.js.map +1 -0
  135. package/dist/capabilities/index.js +24 -24
  136. package/dist/capabilities/index.js.map +1 -1
  137. package/dist/capabilities/inspirera/instructions.js +1 -1
  138. package/dist/capabilities/inspirera/instructions.js.map +1 -1
  139. package/dist/capabilities/optimize/instructions.js +6 -0
  140. package/dist/capabilities/optimize/instructions.js.map +1 -0
  141. package/dist/capabilities/orchestrate/instructions.js +6 -0
  142. package/dist/capabilities/orchestrate/instructions.js.map +1 -0
  143. package/dist/capabilities/plan/instructions.js +6 -0
  144. package/dist/capabilities/plan/instructions.js.map +1 -0
  145. package/dist/capabilities/planera/instructions.js +1 -1
  146. package/dist/capabilities/planera/instructions.js.map +1 -1
  147. package/dist/capabilities/profile/instructions.js +6 -0
  148. package/dist/capabilities/profile/instructions.js.map +1 -0
  149. package/dist/capabilities/profilera/instructions.js +1 -1
  150. package/dist/capabilities/profilera/instructions.js.map +1 -1
  151. package/dist/capabilities/realisera/instructions.js +1 -1
  152. package/dist/capabilities/realisera/instructions.js.map +1 -1
  153. package/dist/capabilities/research/instructions.js +6 -0
  154. package/dist/capabilities/research/instructions.js.map +1 -0
  155. package/dist/capabilities/resonera/instructions.js +1 -1
  156. package/dist/capabilities/resonera/instructions.js.map +1 -1
  157. package/dist/capabilities/status/instructions.js +6 -0
  158. package/dist/capabilities/status/instructions.js.map +1 -0
  159. package/dist/capabilities/vision/instructions.js +6 -0
  160. package/dist/capabilities/vision/instructions.js.map +1 -0
  161. package/dist/capabilities/visionera/instructions.js +1 -1
  162. package/dist/capabilities/visionera/instructions.js.map +1 -1
  163. package/dist/capabilities/visualisera/instructions.js +3 -4
  164. package/dist/capabilities/visualisera/instructions.js.map +1 -1
  165. package/dist/cli/appContext.js +16 -17
  166. package/dist/cli/appContext.js.map +1 -1
  167. package/dist/cli/capabilityContext/benchmark.js +564 -0
  168. package/dist/cli/capabilityContext/benchmark.js.map +1 -0
  169. package/dist/cli/capabilityContext/bespoke.js +36 -0
  170. package/dist/cli/capabilityContext/bespoke.js.map +1 -0
  171. package/dist/cli/capabilityContext/build.js +177 -0
  172. package/dist/cli/capabilityContext/build.js.map +1 -0
  173. package/dist/cli/capabilityContext/closeout.js +230 -0
  174. package/dist/cli/capabilityContext/closeout.js.map +1 -0
  175. package/dist/cli/capabilityContext/contract.js +188 -0
  176. package/dist/cli/capabilityContext/contract.js.map +1 -0
  177. package/dist/cli/capabilityContext/evidence.js +456 -0
  178. package/dist/cli/capabilityContext/evidence.js.map +1 -0
  179. package/dist/cli/capabilityContext/index.js +4 -0
  180. package/dist/cli/capabilityContext/index.js.map +1 -0
  181. package/dist/cli/capabilityContext/orchestration.js +107 -0
  182. package/dist/cli/capabilityContext/orchestration.js.map +1 -0
  183. package/dist/cli/capabilityContext/planState.js +271 -0
  184. package/dist/cli/capabilityContext/planState.js.map +1 -0
  185. package/dist/cli/capabilityContext/progress.js +103 -0
  186. package/dist/cli/capabilityContext/progress.js.map +1 -0
  187. package/dist/cli/capabilityContext/realisera.js +174 -0
  188. package/dist/cli/capabilityContext/realisera.js.map +1 -0
  189. package/dist/cli/capabilityContext/shared.js +94 -0
  190. package/dist/cli/capabilityContext/shared.js.map +1 -0
  191. package/dist/cli/capabilityContext/slim.js +108 -0
  192. package/dist/cli/capabilityContext/slim.js.map +1 -0
  193. package/dist/cli/capabilityContext/startup.js +213 -0
  194. package/dist/cli/capabilityContext/startup.js.map +1 -0
  195. package/dist/cli/capabilityContext/types.js +40 -0
  196. package/dist/cli/capabilityContext/types.js.map +1 -0
  197. package/dist/cli/capabilityContext.js +1 -2486
  198. package/dist/cli/capabilityContext.js.map +1 -1
  199. package/dist/cli/commands/appHome.js +23 -0
  200. package/dist/cli/commands/appHome.js.map +1 -0
  201. package/dist/cli/commands/backfill.js +84 -0
  202. package/dist/cli/commands/backfill.js.map +1 -0
  203. package/dist/cli/commands/capability.js +2 -2
  204. package/dist/cli/commands/capability.js.map +1 -1
  205. package/dist/cli/commands/compact.js +1 -1
  206. package/dist/cli/commands/compact.js.map +1 -1
  207. package/dist/cli/commands/doctor.js +17 -98
  208. package/dist/cli/commands/doctor.js.map +1 -1
  209. package/dist/cli/commands/lint.js +4 -36
  210. package/dist/cli/commands/lint.js.map +1 -1
  211. package/dist/cli/commands/prime/bundleStatus.js +140 -0
  212. package/dist/cli/commands/prime/bundleStatus.js.map +1 -0
  213. package/dist/cli/commands/prime/collectOrientationState.js +156 -0
  214. package/dist/cli/commands/prime/collectOrientationState.js.map +1 -0
  215. package/dist/cli/commands/prime/orientationOutput.js +210 -0
  216. package/dist/cli/commands/prime/orientationOutput.js.map +1 -0
  217. package/dist/cli/commands/prime/routeOutput.js +50 -0
  218. package/dist/cli/commands/prime/routeOutput.js.map +1 -0
  219. package/dist/cli/commands/prime/types.js +2 -0
  220. package/dist/cli/commands/prime/types.js.map +1 -0
  221. package/dist/cli/commands/prime/v1Migration.js +39 -0
  222. package/dist/cli/commands/prime/v1Migration.js.map +1 -0
  223. package/dist/cli/commands/prime.js +11 -554
  224. package/dist/cli/commands/prime.js.map +1 -1
  225. package/dist/cli/commands/query.js +5 -2
  226. package/dist/cli/commands/query.js.map +1 -1
  227. package/dist/cli/commands/report.js +27 -10
  228. package/dist/cli/commands/report.js.map +1 -1
  229. package/dist/cli/commands/schema.js +24 -20
  230. package/dist/cli/commands/schema.js.map +1 -1
  231. package/dist/cli/commands/state/decisions.js +403 -0
  232. package/dist/cli/commands/state/decisions.js.map +1 -0
  233. package/dist/cli/commands/state/docs.js +97 -0
  234. package/dist/cli/commands/state/docs.js.map +1 -0
  235. package/dist/cli/commands/state/experiments.js +68 -0
  236. package/dist/cli/commands/state/experiments.js.map +1 -0
  237. package/dist/cli/commands/state/health.js +116 -0
  238. package/dist/cli/commands/state/health.js.map +1 -0
  239. package/dist/cli/commands/state/index.js +51 -0
  240. package/dist/cli/commands/state/index.js.map +1 -0
  241. package/dist/cli/commands/state/objective.js +69 -0
  242. package/dist/cli/commands/state/objective.js.map +1 -0
  243. package/dist/cli/commands/state/plan.js +173 -0
  244. package/dist/cli/commands/state/plan.js.map +1 -0
  245. package/dist/cli/commands/state/progress.js +47 -0
  246. package/dist/cli/commands/state/progress.js.map +1 -0
  247. package/dist/cli/commands/state/shared.js +15 -0
  248. package/dist/cli/commands/state/shared.js.map +1 -0
  249. package/dist/cli/commands/state/todo.js +121 -0
  250. package/dist/cli/commands/state/todo.js.map +1 -0
  251. package/dist/cli/commands/state.js +7 -7
  252. package/dist/cli/commands/state.js.map +1 -1
  253. package/dist/cli/commands/validate.js +50 -100
  254. package/dist/cli/commands/validate.js.map +1 -1
  255. package/dist/cli/commands/verify.js +1 -1
  256. package/dist/cli/commands/verify.js.map +1 -1
  257. package/dist/cli/contracts/bundleStatus.js +2 -0
  258. package/dist/cli/contracts/bundleStatus.js.map +1 -0
  259. package/dist/cli/contracts/orientationState.js +2 -0
  260. package/dist/cli/contracts/orientationState.js.map +1 -0
  261. package/dist/cli/dispatch/argvParser.js +33 -0
  262. package/dist/cli/dispatch/argvParser.js.map +1 -0
  263. package/dist/cli/dispatch/check.js +328 -0
  264. package/dist/cli/dispatch/check.js.map +1 -0
  265. package/dist/cli/dispatch/commands.js +27 -0
  266. package/dist/cli/dispatch/commands.js.map +1 -0
  267. package/dist/cli/dispatch/index.js +182 -0
  268. package/dist/cli/dispatch/index.js.map +1 -0
  269. package/dist/cli/dispatch/lifecycle.js +597 -0
  270. package/dist/cli/dispatch/lifecycle.js.map +1 -0
  271. package/dist/cli/dispatch/prime.js +104 -0
  272. package/dist/cli/dispatch/prime.js.map +1 -0
  273. package/dist/cli/dispatch/shared.js +64 -0
  274. package/dist/cli/dispatch/shared.js.map +1 -0
  275. package/dist/cli/dispatch/state.js +144 -0
  276. package/dist/cli/dispatch/state.js.map +1 -0
  277. package/dist/cli/dispatch.js +1 -1293
  278. package/dist/cli/dispatch.js.map +1 -1
  279. package/dist/cli/help.js +41 -8
  280. package/dist/cli/help.js.map +1 -1
  281. package/dist/cli/orientation/attention.js +61 -0
  282. package/dist/cli/orientation/attention.js.map +1 -0
  283. package/dist/cli/orientation/corpusCoverage.js +71 -0
  284. package/dist/cli/orientation/corpusCoverage.js.map +1 -0
  285. package/dist/cli/orientation.js +129 -78
  286. package/dist/cli/orientation.js.map +1 -1
  287. package/dist/cli/prime-blob.js +1 -1
  288. package/dist/cli/startupCompletenessContract.js +56 -0
  289. package/dist/cli/startupCompletenessContract.js.map +1 -0
  290. package/dist/cli/stateQuery.js +9 -2
  291. package/dist/cli/stateQuery.js.map +1 -1
  292. package/dist/cli/todoSeverity.js +19 -0
  293. package/dist/cli/todoSeverity.js.map +1 -0
  294. package/dist/core/envPaths.js +21 -0
  295. package/dist/core/envPaths.js.map +1 -0
  296. package/dist/core/git.js +43 -0
  297. package/dist/core/git.js.map +1 -0
  298. package/dist/core/jsonValue.js +6 -0
  299. package/dist/core/jsonValue.js.map +1 -0
  300. package/dist/core/pyjson.js +67 -2
  301. package/dist/core/pyjson.js.map +1 -1
  302. package/dist/eval/evalSkills.js +17 -12
  303. package/dist/eval/evalSkills.js.map +1 -1
  304. package/dist/eval/semanticEval.js +43 -19
  305. package/dist/eval/semanticEval.js.map +1 -1
  306. package/dist/eval/semanticFixtures.js +16 -4
  307. package/dist/eval/semanticFixtures.js.map +1 -1
  308. package/dist/hooks/common.js +8 -23
  309. package/dist/hooks/common.js.map +1 -1
  310. package/dist/hooks/compaction/apply.js +269 -0
  311. package/dist/hooks/compaction/apply.js.map +1 -0
  312. package/dist/hooks/compaction/dryRun.js +183 -0
  313. package/dist/hooks/compaction/dryRun.js.map +1 -0
  314. package/dist/hooks/compaction/index.js +23 -0
  315. package/dist/hooks/compaction/index.js.map +1 -0
  316. package/dist/hooks/compaction/parse.js +258 -0
  317. package/dist/hooks/compaction/parse.js.map +1 -0
  318. package/dist/hooks/compaction/retention.js +199 -0
  319. package/dist/hooks/compaction/retention.js.map +1 -0
  320. package/dist/hooks/compaction/status.js +241 -0
  321. package/dist/hooks/compaction/status.js.map +1 -0
  322. package/dist/hooks/compaction/todoResolved.js +137 -0
  323. package/dist/hooks/compaction/todoResolved.js.map +1 -0
  324. package/dist/hooks/compaction/types.js +6 -0
  325. package/dist/hooks/compaction/types.js.map +1 -0
  326. package/dist/hooks/compaction.js +20 -20
  327. package/dist/hooks/compaction.js.map +1 -1
  328. package/dist/hooks/cursorPreToolUse.js +1 -1
  329. package/dist/hooks/cursorPreToolUse.js.map +1 -1
  330. package/dist/hooks/cursorSessionStart.js +10 -2
  331. package/dist/hooks/cursorSessionStart.js.map +1 -1
  332. package/dist/hooks/sessionStart.js +18 -11
  333. package/dist/hooks/sessionStart.js.map +1 -1
  334. package/dist/hooks/sessionStop.js +6 -12
  335. package/dist/hooks/sessionStop.js.map +1 -1
  336. package/dist/hooks/todoLayout.js +177 -0
  337. package/dist/hooks/todoLayout.js.map +1 -0
  338. package/dist/hooks/validateArtifact/agentFacing.js +10 -0
  339. package/dist/hooks/validateArtifact/agentFacing.js.map +1 -0
  340. package/dist/hooks/validateArtifact/index.js +151 -0
  341. package/dist/hooks/validateArtifact/index.js.map +1 -0
  342. package/dist/hooks/validateArtifact/markdown.js +146 -0
  343. package/dist/hooks/validateArtifact/markdown.js.map +1 -0
  344. package/dist/hooks/validateArtifact/runtime.js +86 -0
  345. package/dist/hooks/validateArtifact/runtime.js.map +1 -0
  346. package/dist/hooks/validateArtifact/schema.js +459 -0
  347. package/dist/hooks/validateArtifact/schema.js.map +1 -0
  348. package/dist/hooks/validateArtifact/traversal.js +106 -0
  349. package/dist/hooks/validateArtifact/traversal.js.map +1 -0
  350. package/dist/hooks/validateArtifact/violations.js +105 -0
  351. package/dist/hooks/validateArtifact/violations.js.map +1 -0
  352. package/dist/hooks/validateArtifact.js +29 -40
  353. package/dist/hooks/validateArtifact.js.map +1 -1
  354. package/dist/migrate/v2HandoffManifest.js +447 -0
  355. package/dist/migrate/v2HandoffManifest.js.map +1 -0
  356. package/dist/registries/artifactProtocolIds.js +77 -0
  357. package/dist/registries/artifactProtocolIds.js.map +1 -0
  358. package/dist/registries/artifactRegistry.js +23 -9
  359. package/dist/registries/artifactRegistry.js.map +1 -1
  360. package/dist/registries/capabilityContract.js +144 -1
  361. package/dist/registries/capabilityContract.js.map +1 -1
  362. package/dist/registries/evaluatorHandoffContract.js +2 -2
  363. package/dist/registries/evaluatorHandoffContract.js.map +1 -1
  364. package/dist/registries/packageRegistry.js +4 -3
  365. package/dist/registries/packageRegistry.js.map +1 -1
  366. package/dist/registries/runtimeAdapterRegistry.js +5 -4
  367. package/dist/registries/runtimeAdapterRegistry.js.map +1 -1
  368. package/dist/registries/triggerLoader.js +211 -0
  369. package/dist/registries/triggerLoader.js.map +1 -0
  370. package/dist/release/releaseMetadata.js +235 -0
  371. package/dist/release/releaseMetadata.js.map +1 -0
  372. package/dist/routing/index.js +2 -0
  373. package/dist/routing/index.js.map +1 -0
  374. package/dist/routing/routeEngine.js +189 -0
  375. package/dist/routing/routeEngine.js.map +1 -0
  376. package/dist/setup/codex/agents.js +96 -0
  377. package/dist/setup/codex/agents.js.map +1 -0
  378. package/dist/setup/codex/cli.js +161 -0
  379. package/dist/setup/codex/cli.js.map +1 -0
  380. package/dist/setup/codex/configToml.js +639 -0
  381. package/dist/setup/codex/configToml.js.map +1 -0
  382. package/dist/setup/codex/constants.js +29 -0
  383. package/dist/setup/codex/constants.js.map +1 -0
  384. package/dist/setup/codex/installRoot.js +64 -0
  385. package/dist/setup/codex/installRoot.js.map +1 -0
  386. package/dist/setup/codex/state.js +270 -0
  387. package/dist/setup/codex/state.js.map +1 -0
  388. package/dist/setup/codex.js +11 -1196
  389. package/dist/setup/codex.js.map +1 -1
  390. package/dist/setup/cursor.js +6 -4
  391. package/dist/setup/cursor.js.map +1 -1
  392. package/dist/setup/cursorSurfaces.js +67 -0
  393. package/dist/setup/cursorSurfaces.js.map +1 -0
  394. package/dist/setup/doctor/core.js +300 -0
  395. package/dist/setup/doctor/core.js.map +1 -0
  396. package/dist/setup/doctor/diagnostics.js +240 -0
  397. package/dist/setup/doctor/diagnostics.js.map +1 -0
  398. package/dist/setup/doctor/opencode.js +313 -0
  399. package/dist/setup/doctor/opencode.js.map +1 -0
  400. package/dist/setup/doctor/report.js +425 -0
  401. package/dist/setup/doctor/report.js.map +1 -0
  402. package/dist/setup/doctor.js +9 -1296
  403. package/dist/setup/doctor.js.map +1 -1
  404. package/dist/setup/opencode.js +13 -0
  405. package/dist/setup/opencode.js.map +1 -0
  406. package/dist/setup/smokeChecks.js +11 -11
  407. package/dist/setup/smokeChecks.js.map +1 -1
  408. package/dist/state/installRoot.js +49 -18
  409. package/dist/state/installRoot.js.map +1 -1
  410. package/dist/state/progressCommit.js +289 -0
  411. package/dist/state/progressCommit.js.map +1 -0
  412. package/dist/state/startupAnalysis/benchmark.js +371 -0
  413. package/dist/state/startupAnalysis/benchmark.js.map +1 -0
  414. package/dist/state/startupAnalysis/contract.js +126 -0
  415. package/dist/state/startupAnalysis/contract.js.map +1 -0
  416. package/dist/state/startupAnalysis/helpers.js +287 -0
  417. package/dist/state/startupAnalysis/helpers.js.map +1 -0
  418. package/dist/state/startupAnalysis/index.js +7 -0
  419. package/dist/state/startupAnalysis/index.js.map +1 -0
  420. package/dist/state/startupAnalysis/metrics.js +341 -0
  421. package/dist/state/startupAnalysis/metrics.js.map +1 -0
  422. package/dist/state/startupAnalysis/records.js +199 -0
  423. package/dist/state/startupAnalysis/records.js.map +1 -0
  424. package/dist/state/startupAnalysis/report.js +112 -0
  425. package/dist/state/startupAnalysis/report.js.map +1 -0
  426. package/dist/state/startupAnalysis/threshold.js +500 -0
  427. package/dist/state/startupAnalysis/threshold.js.map +1 -0
  428. package/dist/state/startupAnalysis.js +2 -1952
  429. package/dist/state/startupAnalysis.js.map +1 -1
  430. package/dist/upgrade/appContentRefresh.js +342 -0
  431. package/dist/upgrade/appContentRefresh.js.map +1 -0
  432. package/dist/upgrade/appModel.js +8 -6
  433. package/dist/upgrade/appModel.js.map +1 -1
  434. package/dist/upgrade/bundleEvidence.js +34 -0
  435. package/dist/upgrade/bundleEvidence.js.map +1 -0
  436. package/dist/upgrade/channels.js +11 -4
  437. package/dist/upgrade/channels.js.map +1 -1
  438. package/dist/upgrade/cliProbe.js +22 -0
  439. package/dist/upgrade/cliProbe.js.map +1 -0
  440. package/dist/upgrade/coexistenceProbe.js +107 -0
  441. package/dist/upgrade/coexistenceProbe.js.map +1 -0
  442. package/dist/upgrade/compatibility.js +13 -4
  443. package/dist/upgrade/compatibility.js.map +1 -1
  444. package/dist/upgrade/doctor.js +165 -183
  445. package/dist/upgrade/doctor.js.map +1 -1
  446. package/dist/upgrade/doctorClassifier.js +177 -0
  447. package/dist/upgrade/doctorClassifier.js.map +1 -0
  448. package/dist/upgrade/installedHooksRetirement.js +190 -0
  449. package/dist/upgrade/installedHooksRetirement.js.map +1 -0
  450. package/dist/upgrade/legacyAgentCleanup.js +116 -0
  451. package/dist/upgrade/legacyAgentCleanup.js.map +1 -0
  452. package/dist/upgrade/migrateArtifactsV2ToV3.js +57 -109
  453. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +1 -1
  454. package/dist/upgrade/nextMajorDoctor.js +42 -7
  455. package/dist/upgrade/nextMajorDoctor.js.map +1 -1
  456. package/dist/upgrade/npxPlatformStatus.js +23 -0
  457. package/dist/upgrade/npxPlatformStatus.js.map +1 -0
  458. package/dist/upgrade/projectIntegration.js +69 -73
  459. package/dist/upgrade/projectIntegration.js.map +1 -1
  460. package/dist/upgrade/projectIntegrationDecision.js +93 -0
  461. package/dist/upgrade/projectIntegrationDecision.js.map +1 -0
  462. package/dist/upgrade/runtimeMigration.js +169 -68
  463. package/dist/upgrade/runtimeMigration.js.map +1 -1
  464. package/dist/upgrade/v3CapabilitySurface.js +15 -0
  465. package/dist/upgrade/v3CapabilitySurface.js.map +1 -0
  466. package/dist/upgrade/versionResolution.js +8 -0
  467. package/dist/upgrade/versionResolution.js.map +1 -1
  468. package/dist/validate/appHomeContract.js +4 -4
  469. package/dist/validate/appHomeContract.js.map +1 -1
  470. package/dist/validate/capability.js +124 -11
  471. package/dist/validate/capability.js.map +1 -1
  472. package/dist/validate/crossCapability.js +1 -1
  473. package/dist/validate/crossCapability.js.map +1 -1
  474. package/dist/validate/lifecycleAdapters/legacyPythonParity.js +93 -0
  475. package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +1 -0
  476. package/dist/validate/lifecycleAdapters/nodeFormChecks.js +488 -0
  477. package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +1 -0
  478. package/dist/validate/lifecycleAdapters/shared.js +198 -0
  479. package/dist/validate/lifecycleAdapters/shared.js.map +1 -0
  480. package/dist/validate/lifecycleAdapters.js +13 -723
  481. package/dist/validate/lifecycleAdapters.js.map +1 -1
  482. package/dist/validate/selfAudit.js +62 -20
  483. package/dist/validate/selfAudit.js.map +1 -1
  484. package/dist/validate/vocabularyAuthority.js +303 -0
  485. package/dist/validate/vocabularyAuthority.js.map +1 -0
  486. package/package.json +27 -24
  487. package/bundle/references/v1-section-mapping.md +0 -47
  488. package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
  489. package/bundle/skills/agentera/agents/hej.toml +0 -6
  490. package/bundle/skills/agentera/agents/inspektera.toml +0 -6
  491. package/bundle/skills/agentera/agents/inspirera.toml +0 -6
  492. package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
  493. package/bundle/skills/agentera/agents/profilera.toml +0 -6
  494. package/bundle/skills/agentera/agents/realisera.toml +0 -6
  495. package/bundle/skills/agentera/agents/visionera.toml +0 -6
  496. package/bundle/skills/agentera/agents/visualisera.toml +0 -6
  497. package/bundle/skills/hej/.claude-plugin/plugin.json +0 -6
  498. package/bundle/skills/hej/SKILL.md +0 -69
  499. package/bundle/skills/hej/agents/hej.toml +0 -11
  500. package/bundle/skills/hej/agents/openai.yaml +0 -8
  501. /package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +0 -0
  502. /package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +0 -0
  503. /package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +0 -0
  504. /package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +0 -0
  505. /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
  506. /package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +0 -0
  507. /package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +0 -0
  508. /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
  509. /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
  510. /package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +0 -0
@@ -0,0 +1,459 @@
1
+ /**
2
+ * Schema-driven validation helpers for the v2 artifact protocol.
3
+ *
4
+ * Walks the schema (skills/agentera/schemas/artifacts/<name>.yaml) and
5
+ * a parsed artifact mapping, producing a list of human-readable
6
+ * violation strings. The helpers in this file are pure (no I/O) and
7
+ * are orchestrated by `violations.ts` for the YAML side and by
8
+ * `markdown.ts` for the human-facing side.
9
+ */
10
+ export function isMapping(v) {
11
+ return v !== null && typeof v === "object" && !Array.isArray(v);
12
+ }
13
+ export function pyTypeName(v) {
14
+ if (v === null || v === undefined)
15
+ return "NoneType";
16
+ if (typeof v === "boolean")
17
+ return "bool";
18
+ if (typeof v === "number")
19
+ return Number.isInteger(v) ? "int" : "float";
20
+ if (typeof v === "string")
21
+ return "str";
22
+ if (Array.isArray(v))
23
+ return "list";
24
+ if (typeof v === "object")
25
+ return "dict";
26
+ return typeof v;
27
+ }
28
+ export function wordCount(text) {
29
+ return (text.match(/\S+/g) ?? []).length;
30
+ }
31
+ const SKIP_META = new Set(["meta", "GROUP_PREFIXES", "BUDGET", "COMPACTION", "VALIDATION", "CONVENTION"]);
32
+ const LIST_INDICATORS = new Set(["number", "entry", "summary"]);
33
+ const SEQUENCE_KEYS_BY_ARTIFACT = {
34
+ decisions: { DECISION: "decisions", ARCHIVE: "archive" },
35
+ docs: { MAPPING: "mapping", INDEX: "index", AUDIT_LOG: "audit_log" },
36
+ experiments: { EXPERIMENT: "experiments", ARCHIVE: "archive" },
37
+ plan: { TASK: "tasks" },
38
+ progress: { CYCLE: "cycles", ARCHIVE: "archive" },
39
+ session: { BOOKMARK: "bookmarks" },
40
+ vision: { PERSONA: "personas", PRINCIPLE: "principles" },
41
+ };
42
+ const NESTED_SEQUENCE_KEYS = [[["DECISION", "ALTERNATIVE"], "alternatives"]];
43
+ const SEQUENCE_ORDER_BY_ARTIFACT = { "progress\0cycles": "descending" };
44
+ export function collectSingletonGroups(schema) {
45
+ const result = [];
46
+ for (const [gk, gv] of Object.entries(schema)) {
47
+ if (SKIP_META.has(gk) || !isMapping(gv))
48
+ continue;
49
+ let isListOrSub = false;
50
+ for (const e of Object.values(gv)) {
51
+ if (isMapping(e) && (LIST_INDICATORS.has(String(e.field)) || e.parent)) {
52
+ isListOrSub = true;
53
+ break;
54
+ }
55
+ }
56
+ if (isListOrSub)
57
+ continue;
58
+ const fields = [];
59
+ for (const e of Object.values(gv)) {
60
+ if (isMapping(e) && e.required && "field" in e)
61
+ fields.push(String(e.field));
62
+ }
63
+ if (fields.length > 0)
64
+ result.push([gk, gk.toLowerCase(), fields]);
65
+ }
66
+ return result;
67
+ }
68
+ export function isEmptyRequired(value) {
69
+ if (value === null || value === undefined)
70
+ return true;
71
+ if (typeof value === "string")
72
+ return !value.trim();
73
+ if (Array.isArray(value))
74
+ return value.length === 0;
75
+ if (typeof value === "object")
76
+ return Object.keys(value).length === 0;
77
+ return false;
78
+ }
79
+ export function* iterGroupEntries(schema, group) {
80
+ const gv = schema[group];
81
+ if (!isMapping(gv))
82
+ return;
83
+ for (const entry of Object.values(gv)) {
84
+ if (isMapping(entry) && "field" in entry)
85
+ yield entry;
86
+ }
87
+ }
88
+ export function validateField(violations, name, scope, field, p) {
89
+ const fullPath = p ? `${p}.${field}` : field;
90
+ if (!(field in scope)) {
91
+ violations.push(`${name}: missing required field '${fullPath}'`);
92
+ }
93
+ else if (isEmptyRequired(scope[field])) {
94
+ violations.push(`${name}: empty required field '${fullPath}'`);
95
+ }
96
+ }
97
+ export function allowedValues(entry) {
98
+ // cast: schema `validation` rules parsed from a YAML artifact schema file
99
+ for (const rule of entry.validation ?? []) {
100
+ if (typeof rule === "string" && rule.startsWith("Must be one of: ")) {
101
+ return rule.slice("Must be one of: ".length).split(",").map((v) => v.trim());
102
+ }
103
+ }
104
+ return [];
105
+ }
106
+ export function validateAllowedValue(violations, name, scope, entry, p) {
107
+ const field = String(entry.field);
108
+ const allowed = allowedValues(entry);
109
+ if (!field || allowed.length === 0 || !(field in scope) || isEmptyRequired(scope[field]))
110
+ return;
111
+ const value = scope[field];
112
+ if (typeof value === "string" && !allowed.includes(value)) {
113
+ violations.push(`${name}: invalid value '${value}' for '${p}.${field}' (expected one of: ${allowed.join(", ")})`);
114
+ }
115
+ }
116
+ export function validateFieldType(violations, name, scope, entry, p) {
117
+ const field = String(entry.field);
118
+ if (!field || !(field in scope))
119
+ return true;
120
+ const value = scope[field];
121
+ const expectedType = entry.type;
122
+ if (!expectedType || isEmptyRequired(value))
123
+ return true;
124
+ const fullPath = p ? `${p}.${field}` : field;
125
+ let isValid = true;
126
+ if (expectedType === "integer") {
127
+ if (typeof value === "boolean" || !(typeof value === "number" && Number.isInteger(value))) {
128
+ violations.push(`${name}: '${fullPath}' must be an integer, got ${pyTypeName(value)}`);
129
+ isValid = false;
130
+ }
131
+ }
132
+ else if (expectedType === "string") {
133
+ if (typeof value !== "string") {
134
+ violations.push(`${name}: '${fullPath}' must be a string, got ${pyTypeName(value)}`);
135
+ isValid = false;
136
+ }
137
+ }
138
+ else if (expectedType === "map") {
139
+ if (!isMapping(value)) {
140
+ violations.push(`${name}: '${fullPath}' must be a mapping, got ${pyTypeName(value)}`);
141
+ isValid = false;
142
+ }
143
+ }
144
+ else if (expectedType === "list[string]") {
145
+ if (!Array.isArray(value) || !value.every((x) => typeof x === "string")) {
146
+ violations.push(`${name}: '${fullPath}' must be a list of strings`);
147
+ isValid = false;
148
+ }
149
+ }
150
+ else if (expectedType === "list[map]") {
151
+ if (!Array.isArray(value) || !value.every((x) => isMapping(x))) {
152
+ violations.push(`${name}: '${fullPath}' must be a list of mappings`);
153
+ isValid = false;
154
+ }
155
+ }
156
+ return isValid;
157
+ }
158
+ export function validateFieldConstraints(violations, name, scope, entry, p) {
159
+ const field = String(entry.field);
160
+ if (!field || !(field in scope))
161
+ return;
162
+ const value = scope[field];
163
+ // cast: schema `validation` rules parsed from a YAML artifact schema file
164
+ for (const rule of entry.validation ?? []) {
165
+ if (typeof rule !== "string")
166
+ continue;
167
+ if (rule === "Must be a positive integer") {
168
+ if (typeof value === "boolean" || !(typeof value === "number" && Number.isInteger(value)) || value <= 0) {
169
+ const fullPath = p ? `${p}.${field}` : field;
170
+ violations.push(`${name}: '${fullPath}' must be a positive integer`);
171
+ }
172
+ }
173
+ }
174
+ }
175
+ export function validateRequiredFields(violations, name, schema, group, scope, p) {
176
+ for (const entry of iterGroupEntries(schema, group)) {
177
+ const field = String(entry.field);
178
+ if (entry.parent || field === "entry")
179
+ continue;
180
+ if (entry.required)
181
+ validateField(violations, name, scope, field, p);
182
+ if (field in scope && !isEmptyRequired(scope[field])) {
183
+ if (validateFieldType(violations, name, scope, entry, p)) {
184
+ validateAllowedValue(violations, name, scope, entry, p);
185
+ validateFieldConstraints(violations, name, scope, entry, p);
186
+ }
187
+ }
188
+ const value = scope[field];
189
+ if (isMapping(value)) {
190
+ // cast: schema `children` list parsed from a YAML artifact schema file
191
+ for (const child of entry.children ?? []) {
192
+ if (isMapping(child) && child.field) {
193
+ const childField = String(child.field);
194
+ const childPath = p ? `${p}.${field}` : field;
195
+ if (child.required)
196
+ validateField(violations, name, value, childField, childPath);
197
+ if (childField in value && !isEmptyRequired(value[childField])) {
198
+ if (validateFieldType(violations, name, value, child, childPath)) {
199
+ validateAllowedValue(violations, name, value, child, childPath);
200
+ validateFieldConstraints(violations, name, value, child, childPath);
201
+ }
202
+ }
203
+ }
204
+ }
205
+ }
206
+ }
207
+ }
208
+ export function validateSingletonGroup(violations, name, schema, group, scope, p) {
209
+ for (const entry of iterGroupEntries(schema, group)) {
210
+ const field = String(entry.field);
211
+ if (entry.parent || field === "entry")
212
+ continue;
213
+ if (entry.required)
214
+ validateField(violations, name, scope, field, p);
215
+ if (field in scope && !isEmptyRequired(scope[field])) {
216
+ if (validateFieldType(violations, name, scope, entry, p)) {
217
+ validateAllowedValue(violations, name, scope, entry, p);
218
+ validateFieldConstraints(violations, name, scope, entry, p);
219
+ }
220
+ }
221
+ }
222
+ }
223
+ export function schemaFieldNames(schema, group) {
224
+ const out = new Set();
225
+ for (const entry of iterGroupEntries(schema, group)) {
226
+ if (entry.field && !entry.parent && entry.field !== "entry")
227
+ out.add(String(entry.field));
228
+ }
229
+ return out;
230
+ }
231
+ export function validateUnknownFields(violations, name, scope, allowed, p) {
232
+ for (const field of Object.keys(scope)) {
233
+ if (!allowed.has(field)) {
234
+ const fullPath = p ? `${p}.${field}` : field;
235
+ violations.push(`${name}: unsupported field '${fullPath}'`);
236
+ }
237
+ }
238
+ }
239
+ export function validatePlanKnownFields(data, schema, violations) {
240
+ const groupedScopes = { header: "HEADER", scope: "SCOPE" };
241
+ const sequenceKeys = new Set(Object.values(SEQUENCE_KEYS_BY_ARTIFACT.plan ?? {}));
242
+ const allowedTopLevel = new Set([
243
+ ...schemaFieldNames(schema, "PLAN"),
244
+ ...Object.keys(groupedScopes),
245
+ ...sequenceKeys,
246
+ ]);
247
+ validateUnknownFields(violations, "plan", data, allowedTopLevel, "");
248
+ for (const [key, group] of Object.entries(groupedScopes)) {
249
+ const scope = data[key];
250
+ if (isMapping(scope)) {
251
+ validateUnknownFields(violations, "plan", scope, schemaFieldNames(schema, group), key);
252
+ }
253
+ }
254
+ }
255
+ export function validateFullPlanContract(data, violations) {
256
+ const header = isMapping(data.header) ? data.header : {};
257
+ if (String(header.level ?? "").toLowerCase() !== "full")
258
+ return;
259
+ for (const field of ["reviewed", "critic_issues"]) {
260
+ validateField(violations, "plan", header, field, "header");
261
+ }
262
+ validateField(violations, "plan", data, "design", "");
263
+ const criticIssues = header.critic_issues;
264
+ if (!isEmptyRequired(criticIssues)) {
265
+ const match = /^\s*(\d+)\s+found,\s*(\d+)\s+addressed,\s*(\d+)\s+dismissed\s*$/.exec(String(criticIssues));
266
+ if (!match) {
267
+ violations.push("plan: header.critic_issues must match 'N found, M addressed, K dismissed'");
268
+ }
269
+ else {
270
+ const [found, addressed, dismissed] = [match[1], match[2], match[3]].map((v) => parseInt(v, 10));
271
+ if (found < 1)
272
+ violations.push("plan: header.critic_issues must record at least 1 found issue");
273
+ if (addressed + dismissed !== found) {
274
+ violations.push("plan: header.critic_issues counts must satisfy addressed + dismissed == found");
275
+ }
276
+ }
277
+ }
278
+ const tasks = data.tasks;
279
+ if (!Array.isArray(tasks))
280
+ return;
281
+ tasks.forEach((task, index) => {
282
+ if (isMapping(task))
283
+ validateField(violations, "plan", task, "acceptance", `tasks[${index}]`);
284
+ });
285
+ }
286
+ export function entryMinCount(schema, group) {
287
+ for (const entry of iterGroupEntries(schema, group)) {
288
+ if (entry.field === "entry" && entry.required)
289
+ return entry.min_count || 1;
290
+ }
291
+ return null;
292
+ }
293
+ export function parentRequirements(schema, parentGroup) {
294
+ const requirements = {};
295
+ const prefix = `${parentGroup}.`;
296
+ for (const group of Object.keys(schema)) {
297
+ if (SKIP_META.has(group))
298
+ continue;
299
+ for (const entry of iterGroupEntries(schema, group)) {
300
+ const parent = entry.parent;
301
+ if (typeof parent === "string" &&
302
+ parent.startsWith(prefix) &&
303
+ parent !== `${group}.entry` &&
304
+ entry.required &&
305
+ entry.field) {
306
+ const parentField = parent.slice(prefix.length);
307
+ (requirements[parentField] ??= []).push(String(entry.field));
308
+ }
309
+ }
310
+ }
311
+ return requirements;
312
+ }
313
+ export function entryRequirements(schema, group) {
314
+ const parent = `${group}.entry`;
315
+ const out = [];
316
+ for (const entry of iterGroupEntries(schema, group)) {
317
+ if (entry.parent === parent && entry.required && entry.field)
318
+ out.push(String(entry.field));
319
+ }
320
+ return out;
321
+ }
322
+ export function validateSequences(data, schema, name, violations) {
323
+ for (const [group, key] of Object.entries(SEQUENCE_KEYS_BY_ARTIFACT[name] ?? {})) {
324
+ const seq = data[key];
325
+ if (seq === null || seq === undefined)
326
+ continue;
327
+ if (!Array.isArray(seq)) {
328
+ violations.push(`${name}: '${key}' must be a list`);
329
+ continue;
330
+ }
331
+ if (seq.length === 0) {
332
+ violations.push(`${name}: '${key}' requires at least 1 entry`);
333
+ continue;
334
+ }
335
+ const childRequirements = parentRequirements(schema, group);
336
+ seq.forEach((item, index) => {
337
+ const p = `${key}[${index}]`;
338
+ if (!isMapping(item)) {
339
+ violations.push(`${name}: '${p}' must be a mapping`);
340
+ return;
341
+ }
342
+ validateRequiredFields(violations, name, schema, group, item, p);
343
+ for (const [parentField, childFields] of Object.entries(childRequirements)) {
344
+ const childScope = item[parentField];
345
+ if (!isMapping(childScope))
346
+ continue;
347
+ for (const childField of childFields) {
348
+ validateField(violations, name, childScope, childField, `${p}.${parentField}`);
349
+ }
350
+ }
351
+ for (const [[parentGroup, childGroup], childKey] of NESTED_SEQUENCE_KEYS) {
352
+ if (parentGroup !== group)
353
+ continue;
354
+ const childSeq = item[childKey];
355
+ const minCount = entryMinCount(schema, childGroup);
356
+ if (minCount && (!Array.isArray(childSeq) || childSeq.length < minCount)) {
357
+ violations.push(`${name}: '${p}.${childKey}' requires at least ${minCount} entry`);
358
+ continue;
359
+ }
360
+ if (!Array.isArray(childSeq))
361
+ continue;
362
+ const required = entryRequirements(schema, childGroup);
363
+ childSeq.forEach((child, childIndex) => {
364
+ const childPath = `${p}.${childKey}[${childIndex}]`;
365
+ if (!isMapping(child)) {
366
+ violations.push(`${name}: '${childPath}' must be a mapping`);
367
+ return;
368
+ }
369
+ for (const field of required)
370
+ validateField(violations, name, child, field, childPath);
371
+ });
372
+ }
373
+ });
374
+ }
375
+ }
376
+ export function validateDecisionAlternatives(data, name) {
377
+ const violations = [];
378
+ // cast: `decisions` read from a parsed YAML artifact mapping
379
+ (data.decisions ?? []).forEach((decision, index) => {
380
+ if (!isMapping(decision))
381
+ return;
382
+ const alternatives = decision.alternatives ?? [];
383
+ if (!Array.isArray(alternatives))
384
+ return;
385
+ const chosen = alternatives.filter((alt) => isMapping(alt) && alt.status === "chosen");
386
+ if (chosen.length !== 1) {
387
+ violations.push(`${name}: 'decisions[${index}].alternatives' must have exactly one chosen entry`);
388
+ }
389
+ });
390
+ return violations;
391
+ }
392
+ export function validateDecisionSatisfaction(data, name) {
393
+ const violations = [];
394
+ const allowedStates = new Set(["open", "provisionally_satisfied", "user_confirmed_satisfied"]);
395
+ const entries = [
396
+ ...(data.decisions ?? []).map((d, i) => [`decisions[${i}]`, d]),
397
+ ...(data.archive ?? []).map((d, i) => [`archive[${i}]`, d]),
398
+ ];
399
+ for (const [entryPath, decision] of entries) {
400
+ if (!isMapping(decision) || !("satisfaction" in decision))
401
+ continue;
402
+ const p = `${entryPath}.satisfaction`;
403
+ const satisfaction = decision.satisfaction;
404
+ if (!isMapping(satisfaction)) {
405
+ violations.push(`${name}: '${p}' must be a mapping`);
406
+ continue;
407
+ }
408
+ validateUnknownFields(violations, name, satisfaction, new Set(["state", "evidence", "user_confirmation"]), p);
409
+ const state = satisfaction.state;
410
+ if (typeof state !== "string" || !state.trim()) {
411
+ violations.push(`${name}: missing required field '${p}.state'`);
412
+ continue;
413
+ }
414
+ if (!allowedStates.has(state)) {
415
+ violations.push(`${name}: invalid value '${state}' for '${p}.state' (expected one of: open, provisionally_satisfied, user_confirmed_satisfied)`);
416
+ continue;
417
+ }
418
+ if (state === "provisionally_satisfied" && isEmptyRequired(satisfaction.evidence)) {
419
+ violations.push(`${name}: '${p}.evidence' is required for provisionally_satisfied`);
420
+ }
421
+ if (state === "user_confirmed_satisfied") {
422
+ const confirmation = satisfaction.user_confirmation;
423
+ if (confirmation === null || confirmation === undefined) {
424
+ violations.push(`${name}: '${p}.user_confirmation' is required for user_confirmed_satisfied`);
425
+ continue;
426
+ }
427
+ if (!isMapping(confirmation)) {
428
+ violations.push(`${name}: '${p}.user_confirmation' must be a mapping with confirmed_by and confirmed_at, got ${pyTypeName(confirmation)}`);
429
+ continue;
430
+ }
431
+ for (const field of ["confirmed_by", "confirmed_at"]) {
432
+ if (isEmptyRequired(confirmation[field])) {
433
+ violations.push(`${name}: missing required field '${p}.user_confirmation.${field}'`);
434
+ }
435
+ }
436
+ }
437
+ }
438
+ return violations;
439
+ }
440
+ export function validationRuleSeverity(schema, rule) {
441
+ for (const groupKey of ["VALIDATION", "VALIDATION_RULES"]) {
442
+ for (const entry of Object.values(schema[groupKey] ?? {})) {
443
+ if (isMapping(entry) && entry.rule === rule) {
444
+ const severity = entry.severity;
445
+ return severity ? String(severity) : null;
446
+ }
447
+ }
448
+ }
449
+ return null;
450
+ }
451
+ export function expectedSequenceOrder(name, key) {
452
+ return SEQUENCE_ORDER_BY_ARTIFACT[`${name}\0${key}`] ?? "ascending";
453
+ }
454
+ export function sequenceInOrder(nums, direction) {
455
+ const reverse = direction === "descending";
456
+ const sorted = [...nums].sort((a, b) => (reverse ? b - a : a - b));
457
+ return nums.length === sorted.length && nums.every((n, i) => n === sorted[i]);
458
+ }
459
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/hooks/validateArtifact/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,106 @@
1
+ /**
2
+ * Path resolution and artifact identification.
3
+ *
4
+ * Given an arbitrary `cwd` and a candidate write path, decide which
5
+ * (if any) protocol-tracked artifact the write targets, applying
6
+ * `.agentera/docs.yaml` path overrides when present.
7
+ */
8
+ import fs from "node:fs";
9
+ import path from "node:path";
10
+ import { resolvePath } from "../../core/paths.js";
11
+ import { loadYamlMapping } from "../../core/yaml.js";
12
+ import { ARTIFACT_PROTOCOL_PATHS, HUMAN_FACING_ARTIFACT_IDS, normalizeArtifactProtocolId, } from "../../registries/artifactProtocolIds.js";
13
+ import { DEFAULT_ARTIFACT_PATHS } from "../common.js";
14
+ import { COMPACTABLE_YAML_ARTIFACTS, compactFile, compactYamlFile } from "../compaction/index.js";
15
+ import { isMapping } from "./schema.js";
16
+ const AGENT_YAML_RE = /\.agentera\/([a-z_]+)\.yaml$/;
17
+ function resolvePathRel(fp, cwd) {
18
+ return path.isAbsolute(fp) ? fp : path.join(cwd, fp);
19
+ }
20
+ function docsPathOverrides(cwd) {
21
+ const docsPath = path.join(cwd, ".agentera", "docs.yaml");
22
+ if (!fs.existsSync(docsPath) || !fs.statSync(docsPath).isFile())
23
+ return {};
24
+ let data;
25
+ try {
26
+ // cast: docs.yaml path-override mapping parsed from a YAML file
27
+ data = loadYamlMapping(fs.readFileSync(docsPath, "utf8"));
28
+ }
29
+ catch (exc) {
30
+ process.stderr.write(`warning: failed to load docs path overrides: ${exc.message}\n`);
31
+ return {};
32
+ }
33
+ const mapping = data.mapping;
34
+ if (!Array.isArray(mapping))
35
+ return {};
36
+ const overrides = {};
37
+ for (const entry of mapping) {
38
+ if (!isMapping(entry))
39
+ continue;
40
+ const artifact = entry.artifact;
41
+ const p = entry.path;
42
+ if (typeof artifact === "string" && typeof p === "string")
43
+ overrides[artifact] = p;
44
+ }
45
+ return overrides;
46
+ }
47
+ export function defaultArtifactPath(artifact, cwd) {
48
+ const rel = docsPathOverrides(cwd)[artifact] ?? DEFAULT_ARTIFACT_PATHS[artifact] ?? "";
49
+ return rel ? resolvePathRel(rel, cwd) : "";
50
+ }
51
+ export function artifactPaths(cwd) {
52
+ const paths = { ...DEFAULT_ARTIFACT_PATHS, ...docsPathOverrides(cwd) };
53
+ const resolved = {};
54
+ for (const [artifact, p] of Object.entries(paths))
55
+ resolved[artifact] = resolvePathRel(p, cwd);
56
+ return resolved;
57
+ }
58
+ function samePath(left, right) {
59
+ return resolvePath(left) === resolvePath(right);
60
+ }
61
+ export function artifactForWrite(absPath, relPath, basename, cwd) {
62
+ for (const [artifact, mappedPath] of Object.entries(artifactPaths(cwd))) {
63
+ if (samePath(absPath, mappedPath))
64
+ return artifact;
65
+ }
66
+ const match = AGENT_YAML_RE.exec(relPath);
67
+ if (match) {
68
+ const id = match[1];
69
+ return id in ARTIFACT_PROTOCOL_PATHS ? id : null;
70
+ }
71
+ if (HUMAN_FACING_ARTIFACT_IDS.has(normalizeArtifactProtocolId(basename) ?? "")) {
72
+ return normalizeArtifactProtocolId(basename);
73
+ }
74
+ return null;
75
+ }
76
+ function readIfNeeded(content, absPath) {
77
+ if (content !== null && content !== undefined)
78
+ return content;
79
+ try {
80
+ return fs.readFileSync(absPath, "utf8");
81
+ }
82
+ catch {
83
+ return null;
84
+ }
85
+ }
86
+ function compactAfterValidWrite(artifact, absPath) {
87
+ if (!fs.existsSync(absPath))
88
+ return [];
89
+ try {
90
+ if (artifact === "todo") {
91
+ compactFile(absPath, "todo-resolved");
92
+ }
93
+ else if (artifact in COMPACTABLE_YAML_ARTIFACTS) {
94
+ compactYamlFile(absPath, artifact);
95
+ }
96
+ else {
97
+ return [];
98
+ }
99
+ }
100
+ catch (exc) {
101
+ return [`${artifact}: compaction failed: ${exc.message}`];
102
+ }
103
+ return [];
104
+ }
105
+ export { readIfNeeded, compactAfterValidWrite };
106
+ //# sourceMappingURL=traversal.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"traversal.js","sourceRoot":"","sources":["../../../src/hooks/validateArtifact/traversal.ts"],"names":[],"mappings":"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"}