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,403 @@
1
+ /**
2
+ * `state decisions` query (decisions.yaml + archive) plus the
3
+ * decision context enrichment utilities consumed by prime.
4
+ *
5
+ * The contract for decision context: never infer satisfaction from
6
+ * downstream references, commits, or compacted history. Only
7
+ * `state == user_confirmed_satisfied` with explicit
8
+ * `user_confirmation` metadata is reported as user-confirmed
9
+ * satisfied; everything else carries a `review_needed` flag and
10
+ * a `caveats` array.
11
+ */
12
+ import { emitStateStructured, extractEntries, loadArtifact, missingSchemaError, sourceMetadata, stringFieldNames, structuredState, } from "../../stateQuery.js";
13
+ import { artifactPath } from "../../appContext.js";
14
+ import { out, err } from "./shared.js";
15
+ const DECISION_CONTEXT_FIELDS = [
16
+ "number",
17
+ "date",
18
+ "question",
19
+ "context",
20
+ "alternatives",
21
+ "choice",
22
+ "reasoning",
23
+ "confidence",
24
+ "feeds_into",
25
+ "satisfaction",
26
+ ];
27
+ const PRIORITY_FIELDS = [
28
+ "number", "name", "title", "date", "timestamp", "status",
29
+ "phase", "choice", "grade", "type", "label", "trajectory", "confidence",
30
+ ];
31
+ const DECISION_ARCHIVE_RE = /Decision\s+(?<number>\d+)(?:\s+\((?<date>\d{4}-\d{2}-\d{2})\))?:\s*(?<summary>.*)/;
32
+ export function displayFields(fields, limit = 6) {
33
+ const ordered = PRIORITY_FIELDS.filter((p) => p in fields);
34
+ for (const fn of Object.keys(fields)) {
35
+ if (!ordered.includes(fn))
36
+ ordered.push(fn);
37
+ }
38
+ return ordered.slice(0, limit);
39
+ }
40
+ function isEmptyValue(v) {
41
+ // cast: v is a field value from a parsed decisions.yaml entry (IO boundary)
42
+ return (v === null ||
43
+ v === undefined ||
44
+ v === "" ||
45
+ (Array.isArray(v) && v.length === 0) ||
46
+ (typeof v === "object" && !Array.isArray(v) && Object.keys(v).length === 0));
47
+ }
48
+ function decisionArchiveEntry(entry) {
49
+ // cast: entry comes from the parsed decisions archive array (YAML IO boundary)
50
+ const archiveEntry = entry && typeof entry === "object" && !Array.isArray(entry) ? { ...entry } : { summary: String(entry) };
51
+ archiveEntry.compacted = true;
52
+ const summary = String(archiveEntry.summary ?? "");
53
+ const match = DECISION_ARCHIVE_RE.exec(summary);
54
+ if (match && match.groups) {
55
+ if (!("number" in archiveEntry))
56
+ archiveEntry.number = parseInt(match.groups.number, 10);
57
+ if (match.groups.date && !("date" in archiveEntry))
58
+ archiveEntry.date = match.groups.date;
59
+ }
60
+ return archiveEntry;
61
+ }
62
+ export function extractDecisionEntries(data) {
63
+ if (!data || typeof data !== "object" || Array.isArray(data))
64
+ return extractEntries(data);
65
+ // cast: data is the parsed decisions artifact from loadArtifact (YAML IO boundary)
66
+ const d = data;
67
+ const decisions = d.decisions ?? [];
68
+ const archive = d.archive ?? [];
69
+ const entries = Array.isArray(decisions)
70
+ ? decisions.filter((e) => Boolean(e && typeof e === "object" && !Array.isArray(e)))
71
+ : [];
72
+ if (Array.isArray(archive)) {
73
+ for (const entry of archive)
74
+ entries.push(decisionArchiveEntry(entry));
75
+ }
76
+ return entries;
77
+ }
78
+ function filterDecisionsByTopic(entries, topic, fields) {
79
+ const t = topic.toLowerCase();
80
+ const fnames = [...stringFieldNames(fields), "summary", "outcome"];
81
+ return entries.filter((entry) => fnames.some((f) => String(entry[f] ?? "").toLowerCase().includes(t)));
82
+ }
83
+ function decisionFieldMissing(entry, field) {
84
+ return isEmptyValue(entry[field]);
85
+ }
86
+ function decisionDownstreamReferences(entry) {
87
+ const value = entry.feeds_into;
88
+ if (value === null || value === undefined || value === "")
89
+ return null;
90
+ let refs;
91
+ if (Array.isArray(value)) {
92
+ refs = value.map((item) => String(item).trim()).filter((s) => s);
93
+ }
94
+ else {
95
+ refs = String(value)
96
+ .split(",")
97
+ .map((part) => part.trim())
98
+ .filter((s) => s);
99
+ }
100
+ if (refs.length === 0)
101
+ return null;
102
+ return refs.map((ref) => ({ source_field: "feeds_into", reference: ref }));
103
+ }
104
+ export function decisionSatisfactionContext(entry) {
105
+ const satisfaction = entry.satisfaction;
106
+ if (!satisfaction || typeof satisfaction !== "object" || Array.isArray(satisfaction)) {
107
+ return {
108
+ state: null,
109
+ evidence: null,
110
+ user_confirmation: null,
111
+ review_needed: true,
112
+ source: "missing_legacy_state",
113
+ caveats: ["Missing legacy satisfaction state is not treated as satisfied."],
114
+ };
115
+ }
116
+ // cast: satisfaction is read from a parsed decisions.yaml entry (IO boundary)
117
+ const sat = satisfaction;
118
+ const state = sat.state;
119
+ const evidence = sat.evidence ?? null;
120
+ const userConfirmation = sat.user_confirmation ?? null;
121
+ const explicitReviewNeeded = sat.review_needed === true;
122
+ let caveats = [];
123
+ let reviewNeeded = true;
124
+ if (state === "user_confirmed_satisfied") {
125
+ // cast: user_confirmation is read from a parsed decisions.yaml entry (IO boundary)
126
+ reviewNeeded =
127
+ !(userConfirmation && typeof userConfirmation === "object" && !Array.isArray(userConfirmation)) ||
128
+ Object.keys(userConfirmation).length === 0;
129
+ if (reviewNeeded)
130
+ caveats.push("User-confirmed satisfaction is missing explicit user confirmation metadata.");
131
+ }
132
+ else if (state === "provisionally_satisfied") {
133
+ if (isEmptyValue(evidence))
134
+ caveats.push("Provisional satisfaction is missing concrete evidence.");
135
+ caveats.push("Provisional satisfaction still requires user confirmation.");
136
+ }
137
+ else if (state === "open") {
138
+ caveats.push("Satisfaction state is open and requires review.");
139
+ }
140
+ else {
141
+ caveats.push("Satisfaction state is missing or unrecognized and requires review.");
142
+ }
143
+ if (explicitReviewNeeded) {
144
+ reviewNeeded = true;
145
+ caveats.push("Decision satisfaction is explicitly marked review_needed.");
146
+ }
147
+ const originalCaveats = sat.caveats;
148
+ if (Array.isArray(originalCaveats))
149
+ caveats = [...originalCaveats.map((c) => String(c)), ...caveats];
150
+ else if (typeof originalCaveats === "string")
151
+ caveats = [originalCaveats, ...caveats];
152
+ const enriched = { ...sat };
153
+ if (!("evidence" in enriched))
154
+ enriched.evidence = evidence;
155
+ if (!("user_confirmation" in enriched))
156
+ enriched.user_confirmation = userConfirmation;
157
+ enriched.review_needed = reviewNeeded;
158
+ enriched.source = "decision.satisfaction";
159
+ enriched.caveats = caveats;
160
+ return enriched;
161
+ }
162
+ export function decisionContextEntry(entry) {
163
+ const enriched = { ...entry };
164
+ if ((enriched.outcome === null || enriched.outcome === undefined || enriched.outcome === "") &&
165
+ enriched.choice !== null && enriched.choice !== undefined && enriched.choice !== "") {
166
+ enriched.outcome = enriched.choice;
167
+ }
168
+ const compacted = Boolean(enriched.compacted) ||
169
+ ("summary" in enriched &&
170
+ ["question", "reasoning", "confidence"].some((field) => decisionFieldMissing(enriched, field)));
171
+ const missingFields = DECISION_CONTEXT_FIELDS.filter((field) => decisionFieldMissing(enriched, field));
172
+ if (decisionFieldMissing(enriched, "choice") && decisionFieldMissing(enriched, "outcome")) {
173
+ missingFields.push("outcome");
174
+ }
175
+ const downstreamReferences = decisionDownstreamReferences(enriched);
176
+ const caveats = [];
177
+ if (compacted)
178
+ caveats.push("Decision entry is compacted; full decision context is not available in this CLI result.");
179
+ if (missingFields.length > 0)
180
+ caveats.push("Decision entry is missing one or more full-detail context fields.");
181
+ if (downstreamReferences === null) {
182
+ caveats.push("No explicit downstream consequence references were present; none were inferred.");
183
+ }
184
+ const satisfaction = decisionSatisfactionContext(enriched);
185
+ if (satisfaction.review_needed) {
186
+ caveats.push("Decision satisfaction requires user review; missing legacy state is not treated as satisfied.");
187
+ }
188
+ enriched.satisfaction = satisfaction;
189
+ enriched.downstream_consequence_references = downstreamReferences;
190
+ enriched.context_complete =
191
+ !compacted && missingFields.length === 0 && downstreamReferences !== null && !satisfaction.review_needed;
192
+ enriched.missing_fields = missingFields;
193
+ enriched.compacted = compacted;
194
+ enriched.caveats = caveats;
195
+ return enriched;
196
+ }
197
+ export function decisionSourceContract(source, entries, filters) {
198
+ const sourceExists = Boolean(source.exists);
199
+ const activeFilters = Object.fromEntries(Object.entries(filters).filter(([, v]) => v !== null && v !== undefined));
200
+ const filteredNoMatch = sourceExists && Object.keys(activeFilters).length > 0 && entries.length === 0;
201
+ const compactedEntries = entries.filter((e) => e.compacted).length;
202
+ const entriesWithMissingFields = entries.filter((e) => Array.isArray(e.missing_fields) && e.missing_fields.length > 0).length;
203
+ const entriesWithoutDownstream = entries.filter((e) => e.downstream_consequence_references === null).length;
204
+ const entriesRequiringSatisfactionReview = entries.filter((e) => e.satisfaction && typeof e.satisfaction === "object" && !Array.isArray(e.satisfaction) && e.satisfaction.review_needed).length;
205
+ const userConfirmedSatisfied = entries.filter((e) => e.satisfaction &&
206
+ typeof e.satisfaction === "object" &&
207
+ !Array.isArray(e.satisfaction) &&
208
+ e.satisfaction.state === "user_confirmed_satisfied" &&
209
+ !e.satisfaction.review_needed).length;
210
+ const completeForReturned = sourceExists && entries.every((e) => e.context_complete === true);
211
+ const completeForNormalDeliberation = sourceExists;
212
+ const caveats = [
213
+ "Downstream consequence references are derived only from explicit structured feeds_into values; no references are inferred.",
214
+ "Compacted archive decisions are not expanded by this command and are not complete full-detail decision context.",
215
+ ];
216
+ if (!sourceExists)
217
+ caveats.push("Decision artifact is missing or unavailable; no decision context is available from this command result.");
218
+ if (filteredNoMatch)
219
+ caveats.push("Filtered result is empty; no returned decisions match the filter, but the decision artifact was available.");
220
+ if (entriesWithMissingFields)
221
+ caveats.push("One or more returned decisions are missing full-detail context fields.");
222
+ if (entriesWithoutDownstream)
223
+ caveats.push("One or more returned decisions lack explicit downstream consequence references.");
224
+ if (entriesRequiringSatisfactionReview)
225
+ caveats.push("One or more returned decisions require satisfaction review; satisfaction is never inferred from downstream references.");
226
+ return {
227
+ artifact: "decisions",
228
+ canonical_artifact_label: "decisions",
229
+ path: source.path,
230
+ complete_for_returned_decisions: completeForReturned,
231
+ complete_for_decision_context: completeForReturned,
232
+ complete_for_returned_full_detail: completeForReturned,
233
+ complete_for_normal_deliberation_context: completeForNormalDeliberation,
234
+ completeness: {
235
+ returned_decisions: entries.length,
236
+ context_complete: completeForReturned,
237
+ returned_full_detail_complete: completeForReturned,
238
+ normal_deliberation_context: completeForNormalDeliberation,
239
+ filtered_no_match: filteredNoMatch,
240
+ source_exists: sourceExists,
241
+ compacted_entries: compactedEntries,
242
+ entries_with_missing_fields: entriesWithMissingFields,
243
+ entries_without_downstream_references: entriesWithoutDownstream,
244
+ entries_requiring_satisfaction_review: entriesRequiringSatisfactionReview,
245
+ user_confirmed_satisfied_entries: userConfirmedSatisfied,
246
+ },
247
+ included_fields: [
248
+ ...DECISION_CONTEXT_FIELDS,
249
+ "outcome",
250
+ "downstream_consequence_references",
251
+ "context_complete",
252
+ "missing_fields",
253
+ "compacted",
254
+ "caveats",
255
+ ],
256
+ satisfaction_context: {
257
+ owner: "decision entry",
258
+ state_field: "satisfaction.state",
259
+ evidence_field: "satisfaction.evidence",
260
+ confirmation_field: "satisfaction.user_confirmation",
261
+ review_needed_field: "satisfaction.review_needed",
262
+ confirmation_policy: "Only satisfaction.state=user_confirmed_satisfied with explicit user_confirmation metadata is reported as user-confirmed satisfied.",
263
+ non_inference_policy: "Do not infer satisfaction from feeds_into, commits, downstream files, generated references, or compacted history.",
264
+ },
265
+ normal_deliberation_context: {
266
+ use_complete_for_normal_deliberation_context: true,
267
+ legacy_full_detail_signal: "complete_for_decision_context",
268
+ guidance: "For normal deliberation, use returned entries plus missing_fields, compacted, caveats, " +
269
+ "and satisfaction review state. Do not use the legacy full-detail completeness flag " +
270
+ "as a reason to reread the raw decision artifact.",
271
+ },
272
+ decision_context_truth_table: {
273
+ full_detail_entries: {
274
+ full_detail_complete: true,
275
+ normal_deliberation_context_complete: true,
276
+ raw_artifact_read_required: false,
277
+ },
278
+ compacted_archive_entries: {
279
+ full_detail_complete: false,
280
+ normal_deliberation_context_complete: true,
281
+ raw_artifact_read_required: false,
282
+ carry_forward: ["missing_fields", "compacted", "caveats"],
283
+ },
284
+ entries_with_missing_full_detail_fields: {
285
+ full_detail_complete: false,
286
+ normal_deliberation_context_complete: true,
287
+ raw_artifact_read_required: false,
288
+ carry_forward: ["missing_fields", "caveats"],
289
+ },
290
+ satisfaction_review_needed: {
291
+ full_detail_complete: false,
292
+ normal_deliberation_context_complete: true,
293
+ raw_artifact_read_required: false,
294
+ carry_forward: ["satisfaction.review_needed", "caveats"],
295
+ },
296
+ filtered_no_match: {
297
+ full_detail_complete: true,
298
+ normal_deliberation_context_complete: true,
299
+ raw_artifact_read_required: false,
300
+ meaning: "The artifact exists, but no returned decisions matched the filter.",
301
+ },
302
+ missing_or_unavailable_artifact: {
303
+ full_detail_complete: false,
304
+ normal_deliberation_context_complete: false,
305
+ raw_artifact_read_required: false,
306
+ meaning: "No decision state is available from the CLI result; use CLI fallback or diagnostics before raw artifact repair.",
307
+ },
308
+ },
309
+ missing_full_detail_boundary: {
310
+ applies_when: "returned decisions have missing_fields or context_complete=false",
311
+ normal_behavior: "Use present structured fields only and preserve missing_fields/caveats downstream.",
312
+ raw_artifact_read_required: false,
313
+ do_not: "Do not infer absent reasoning, alternatives, confidence, feeds_into, outcome, or downstream references.",
314
+ },
315
+ missing_artifact_boundary: {
316
+ applies_when: "source.exists=false",
317
+ normal_behavior: "Treat decision context as unavailable from this result; do not infer historical decisions.",
318
+ raw_artifact_read_required: false,
319
+ diagnostic_boundary: "Raw artifact access is reserved for explicit artifact repair/corruption or CLI-defect investigation.",
320
+ },
321
+ filtered_result_boundary: {
322
+ applies_when: "filters are present and entries=[] while source.exists=true",
323
+ normal_behavior: "Treat the result as no matching returned decisions, not as missing decision state.",
324
+ raw_artifact_read_required: false,
325
+ },
326
+ satisfaction_review_boundary: {
327
+ applies_when: "one or more entries have satisfaction.review_needed=true",
328
+ normal_behavior: "Carry satisfaction review pressure forward; only user confirmation can make a decision user-confirmed satisfied.",
329
+ raw_artifact_read_required: false,
330
+ do_not: "Do not infer satisfaction from downstream references, commits, generated files, or compacted history.",
331
+ },
332
+ compacted_history_boundary: {
333
+ applies_when: "returned entries have compacted=true",
334
+ normal_behavior: "Use the compact summary and retained fields; preserve compacted/missing_fields/caveats downstream.",
335
+ raw_artifact_read_required: false,
336
+ do_not: "Do not expand archive decisions or reconstruct missing context from git history.",
337
+ },
338
+ raw_artifact_access_boundary: {
339
+ normal_deliberation: "skip raw `.agentera/decisions.yaml` reads when complete_for_normal_deliberation_context=true",
340
+ allowed_raw_artifact_uses: [
341
+ "Discuss-owned decision writes or repairs",
342
+ "artifact corruption diagnostics",
343
+ "CLI defect investigation",
344
+ ],
345
+ },
346
+ raw_artifact_reads_required: false,
347
+ raw_artifact_read_policy: "Use `agentera decisions --format json` for normal deliberation context and key normal use off " +
348
+ "complete_for_normal_deliberation_context. " +
349
+ "Do not read `.agentera/decisions.yaml` unless investigating artifact corruption or CLI defects; " +
350
+ "historical compacted gaps are exposed through missing_fields and caveats.",
351
+ caveats,
352
+ fallback_behavior: {
353
+ normal: "Use this command's entries and source_contract; no raw decision artifact read is required for returned full-detail or compacted decision entries.",
354
+ filtered_result: "The same per-decision guarantees apply after filters; an empty filtered result means no matching returned decisions.",
355
+ missing_or_incomplete: "If a required field is missing, treat only the present structured fields as authoritative and do not infer absent context.",
356
+ satisfaction: "Use only each entry's satisfaction object for satisfaction state. Missing, open, provisional, or unconfirmed satisfaction requires review and must not be reported as user-confirmed satisfied.",
357
+ compacted_history: "Compacted archive decisions are included with explicit missing_fields and caveats; treat absent historical context as unavailable during normal deliberation.",
358
+ },
359
+ fallback_policy: "If the decision artifact is missing or CLI state appears defective, use CLI fallback/diagnostic paths before raw artifact repair; do not raw-read merely because returned decisions are compacted or incomplete.",
360
+ filters: activeFilters,
361
+ };
362
+ }
363
+ export function queryDecisions(args, schemas, io) {
364
+ const o = out(io);
365
+ const e = err(io);
366
+ const info = schemas.decisions;
367
+ if (!info) {
368
+ e(missingSchemaError("decisions") + "\n");
369
+ return 1;
370
+ }
371
+ const p = artifactPath(info, "decisions");
372
+ const data = loadArtifact(p);
373
+ let entries = extractDecisionEntries(data);
374
+ const topic = args.topic ?? null;
375
+ if (topic)
376
+ entries = filterDecisionsByTopic(entries, topic, info.fields);
377
+ const format = args.format ?? "text";
378
+ if (format !== "text") {
379
+ const enriched = entries.map((entry) => decisionContextEntry(entry));
380
+ const source = sourceMetadata("decisions", p);
381
+ const filters = { topic };
382
+ return emitStateStructured("decisions", structuredState("decisions", enriched, source, {
383
+ filters,
384
+ sourceContract: decisionSourceContract(source, enriched, filters),
385
+ }), format, args.fields, o, e);
386
+ }
387
+ if (entries.length === 0)
388
+ return 0;
389
+ const disp = displayFields(info.fields);
390
+ for (const entry of entries) {
391
+ const parts = [];
392
+ for (const fn of disp) {
393
+ const v = entry[fn];
394
+ if (v !== null && v !== undefined && v !== "" && !Array.isArray(v) && typeof v !== "object") {
395
+ parts.push(`${fn}=${v}`);
396
+ }
397
+ }
398
+ if (parts.length > 0)
399
+ o(parts.join(" | ") + "\n");
400
+ }
401
+ return 0;
402
+ }
403
+ //# sourceMappingURL=decisions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../../../src/cli/commands/state/decisions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * `state docs` query (DOCS.md / docs.yaml).
3
+ *
4
+ * Returns the docs index (document, path, last_updated, status) and
5
+ * a source_contract that asserts
6
+ * `capability_startup_complete` so prime can skip raw
7
+ * `.agentera/docs.yaml` reads.
8
+ */
9
+ import { asList, emitStateStructured, filterByFieldValue, formatEntry, loadArtifact, missingSchemaError, printStatusCounts, sourceMetadata, statusCounts, structuredState, truncate, } from "../../stateQuery.js";
10
+ import { artifactPath, discoverSchemasDir } from "../../appContext.js";
11
+ import fs from "node:fs";
12
+ import { registryArtifactPath } from "../../orientation.js";
13
+ import { capabilityStartupComplete } from "../../startupCompletenessContract.js";
14
+ import { out, err } from "./shared.js";
15
+ export function queryDocs(args, schemas, io) {
16
+ const o = out(io);
17
+ const e = err(io);
18
+ const profilePath = registryArtifactPath("profile", discoverSchemasDir());
19
+ const profileStatus = fs.existsSync(profilePath) ? "loaded" : "not found";
20
+ const info = schemas.docs;
21
+ if (!info) {
22
+ e(missingSchemaError("docs") + "\n");
23
+ return 1;
24
+ }
25
+ const p = artifactPath(info, "docs");
26
+ const data = loadArtifact(p);
27
+ const format = args.format ?? "text";
28
+ const isDict = data !== null && typeof data === "object" && !Array.isArray(data);
29
+ if (!isDict) {
30
+ if (format !== "text") {
31
+ return emitStateStructured("docs", structuredState("docs", [], sourceMetadata("docs", p), {
32
+ filters: { topic: args.topic ?? null, status: args.status ?? null },
33
+ }), format, args.fields, o, e);
34
+ }
35
+ return 0;
36
+ }
37
+ const d = data;
38
+ const legacyEntries = asList(d.entries);
39
+ if (legacyEntries.length > 0) {
40
+ let entries = legacyEntries;
41
+ const statusFilter = args.status ?? null;
42
+ if (statusFilter)
43
+ entries = filterByFieldValue(entries, "status", statusFilter);
44
+ if (format !== "text") {
45
+ return emitStateStructured("docs", structuredState("docs", entries, sourceMetadata("docs", p), { filters: { status: statusFilter } }), format, args.fields, o, e);
46
+ }
47
+ for (const entry of entries) {
48
+ const line = formatEntry(entry, ["last_audit", "document", "path", "status"]);
49
+ if (line)
50
+ o(line + "\n");
51
+ }
52
+ return 0;
53
+ }
54
+ const mapping = asList(d.mapping);
55
+ let index = asList(d.index);
56
+ const coverage = d.coverage && typeof d.coverage === "object" && !Array.isArray(d.coverage) ? d.coverage : {};
57
+ const conventions = d.conventions && typeof d.conventions === "object" && !Array.isArray(d.conventions) ? d.conventions : {};
58
+ const topic = args.topic ?? null;
59
+ if (topic) {
60
+ const t = topic.toLowerCase();
61
+ index = index.filter((entry) => String(entry.document ?? "").toLowerCase().includes(t) ||
62
+ String(entry.path ?? "").toLowerCase().includes(t) ||
63
+ String(entry.status ?? "").toLowerCase().includes(t));
64
+ }
65
+ const statusFilter = args.status ?? null;
66
+ if (statusFilter)
67
+ index = filterByFieldValue(index, "status", statusFilter);
68
+ if (format !== "text") {
69
+ return emitStateStructured("docs", structuredState("docs", index, sourceMetadata("docs", p), {
70
+ filters: { topic, status: statusFilter },
71
+ summary: {
72
+ last_audit: d.last_audit,
73
+ conventions,
74
+ mapping,
75
+ mapping_entries: mapping.length,
76
+ coverage,
77
+ source_contract: {
78
+ capability_startup_complete: capabilityStartupComplete({ profileStatus }),
79
+ raw_artifact_reads_required: false,
80
+ },
81
+ },
82
+ }), format, args.fields, o, e);
83
+ }
84
+ o(`Docs: last_audit=${d.last_audit ?? "-"}\n`);
85
+ o(`Mapping: entries=${mapping.length}\n`);
86
+ if (Object.keys(coverage).length > 0) {
87
+ o("Coverage: " + Object.entries(coverage).map(([k, v]) => `${k}=${truncate(v)}`).join(" | ") + "\n");
88
+ }
89
+ printStatusCounts("Docs status", statusCounts(index), o);
90
+ for (const entry of index.slice(0, 10)) {
91
+ const line = formatEntry(entry, ["document", "path", "last_updated", "status"]);
92
+ if (line)
93
+ o(line + "\n");
94
+ }
95
+ return 0;
96
+ }
97
+ //# sourceMappingURL=docs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../../src/cli/commands/state/docs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * `state experiments` query (experiments.yaml).
3
+ *
4
+ * Returns the most recent N experiments (default 5) filtered by
5
+ * topic or status, including per-entry metric and conclusion.
6
+ */
7
+ import { asList, emitStateStructured, filterByFieldValue, filterByTopic, formatEntry, loadArtifact, missingSchemaError, printStatusCounts, sourceMetadata, statusCounts, structuredState, truncate, } from "../../stateQuery.js";
8
+ import { artifactPath } from "../../appContext.js";
9
+ import { out, err } from "./shared.js";
10
+ export function queryExperiments(args, schemas, io) {
11
+ const o = out(io);
12
+ const e = err(io);
13
+ const info = schemas.experiments;
14
+ if (!info) {
15
+ e(missingSchemaError("experiments") + "\n");
16
+ return 1;
17
+ }
18
+ const p = artifactPath(info, "experiments");
19
+ const data = loadArtifact(p);
20
+ const format = args.format ?? "text";
21
+ const isDict = data !== null && typeof data === "object" && !Array.isArray(data);
22
+ if (!isDict) {
23
+ if (format !== "text") {
24
+ return emitStateStructured("experiments", structuredState("experiments", [], sourceMetadata("experiments", p), {
25
+ filters: { topic: args.topic ?? null, status: args.status ?? null, limit: args.limit ?? 5 },
26
+ }), format, args.fields, o, e);
27
+ }
28
+ return 0;
29
+ }
30
+ // cast: data is the parsed experiments artifact from loadArtifact (YAML IO boundary)
31
+ const d = data;
32
+ let entries = asList(d.experiments);
33
+ const statusFilter = args.status ?? null;
34
+ if (statusFilter)
35
+ entries = filterByFieldValue(entries, "status", statusFilter);
36
+ const topic = args.topic ?? null;
37
+ if (topic)
38
+ entries = filterByTopic(entries, topic, info.fields);
39
+ const limit = (args.limit ?? 5) || 5;
40
+ entries = entries.slice(-limit);
41
+ const closure = d.closure && typeof d.closure === "object" && !Array.isArray(d.closure) ? d.closure : {};
42
+ if (format !== "text") {
43
+ return emitStateStructured("experiments", structuredState("experiments", entries, sourceMetadata("experiments", p), {
44
+ filters: { topic, status: statusFilter, limit },
45
+ summary: { closure },
46
+ }), format, args.fields, o, e);
47
+ }
48
+ printStatusCounts("Experiment status", statusCounts(entries), o);
49
+ for (const entry of entries) {
50
+ o(formatEntry(entry, ["number", "date", "label", "status"]) + "\n");
51
+ const metric = entry.metric;
52
+ if (metric && typeof metric === "object" && !Array.isArray(metric)) {
53
+ const metricLine = formatEntry(metric, ["primary_value", "delta_vs_baseline"]);
54
+ if (metricLine)
55
+ o(` metric: ${metricLine}\n`);
56
+ }
57
+ for (const key of ["conclusion", "next"]) {
58
+ const value = entry[key];
59
+ if (value)
60
+ o(` ${key}: ${truncate(value)}\n`);
61
+ }
62
+ }
63
+ if (Object.keys(closure).length > 0) {
64
+ o("Closure: " + formatEntry(closure, ["final_value", "target", "reason"]) + "\n");
65
+ }
66
+ return 0;
67
+ }
68
+ //# sourceMappingURL=experiments.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../../../src/cli/commands/state/experiments.ts"],"names":[],"mappings":"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"}