agentera 3.0.0-dev.6 → 3.0.0-dev.69

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 (696) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +118 -22
  3. package/bundle/CHANGELOG.md +1361 -0
  4. package/bundle/DESIGN.md +229 -0
  5. package/bundle/LICENSE +201 -0
  6. package/bundle/README.md +143 -0
  7. package/bundle/UPGRADE.md +252 -0
  8. package/bundle/extract-corpus-parity.json +21 -0
  9. package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
  10. package/bundle/references/adapters/package-publication.json +488 -0
  11. package/bundle/references/adapters/package-registry.yaml +435 -188
  12. package/bundle/references/adapters/package-surface-characterization.md +66 -34
  13. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
  14. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
  15. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
  16. package/bundle/references/adapters/runtime-retired-resources.yaml +333 -0
  17. package/bundle/references/analysis/evidence-tier-authority.yaml +518 -0
  18. package/bundle/references/analysis/verification-policy.yaml +266 -0
  19. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +20 -10
  20. package/bundle/references/artifacts/glossary-entry-contract.yaml +1254 -0
  21. package/bundle/references/artifacts/state-storage-authority.yaml +3061 -0
  22. package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
  23. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +7 -8
  24. package/bundle/references/cli/capability-instruction-contract.yaml +11 -14
  25. package/bundle/references/cli/hybrid-route-contract.yaml +438 -0
  26. package/bundle/references/cli/routing-model.md +155 -0
  27. package/bundle/references/cli/trigger-schema-enrichment.md +147 -0
  28. package/bundle/references/cli/update-channels.yaml +19 -2
  29. package/bundle/references/cli/vocabulary-index.yaml +20 -17
  30. package/bundle/references/cli/vocabulary.md +325 -362
  31. package/bundle/references/meta/retained-reference-authority.yaml +151 -0
  32. package/bundle/registry.json +13 -13
  33. package/bundle/skills/agentera/SKILL.md +226 -422
  34. package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +84 -0
  35. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +2 -2
  36. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +25 -0
  37. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +37 -18
  38. package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +103 -0
  39. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +8 -6
  40. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +27 -0
  41. package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +184 -0
  42. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +12 -12
  43. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +5 -5
  44. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +16 -0
  45. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +7 -7
  46. package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +51 -0
  47. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +2 -2
  48. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +20 -0
  49. package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +144 -0
  50. package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +80 -0
  51. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +16 -0
  52. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +18 -18
  53. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +18 -18
  54. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +2 -2
  55. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +16 -0
  56. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +9 -9
  57. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +76 -0
  58. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +9 -7
  59. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +23 -0
  60. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +121 -0
  61. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +66 -0
  62. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
  63. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +23 -0
  64. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +121 -0
  65. package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +23 -0
  66. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +6 -5
  67. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +20 -0
  68. package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +115 -0
  69. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +24 -0
  70. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +16 -0
  71. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
  72. package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +73 -0
  73. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +22 -0
  74. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
  75. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +16 -16
  76. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +7 -6
  77. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +23 -0
  78. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +18 -20
  79. package/bundle/skills/agentera/capability_schema_contract.yaml +178 -34
  80. package/bundle/skills/agentera/protocol.yaml +31 -31
  81. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  82. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +5 -4
  83. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +39 -21
  84. package/bundle/skills/agentera/schemas/artifacts/design.yaml +5 -4
  85. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +15 -19
  86. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +145 -14
  87. package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +82 -0
  88. package/bundle/skills/agentera/schemas/artifacts/health.yaml +58 -21
  89. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +22 -8
  90. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +461 -36
  91. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +133 -20
  92. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +342 -42
  93. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
  94. package/dist/analytics/extractCorpus/cli.js +101 -12
  95. package/dist/analytics/extractCorpus/copilotSessions.js +53 -9
  96. package/dist/analytics/extractCorpus/core.js +59 -24
  97. package/dist/analytics/extractCorpus/corpus.js +58 -23
  98. package/dist/analytics/extractCorpus/coverageAudit.js +260 -0
  99. package/dist/analytics/extractCorpus/cursorSessions.js +12 -7
  100. package/dist/analytics/extractCorpus/evidenceTiers.js +603 -0
  101. package/dist/analytics/extractCorpus/extractCorpusParity.js +105 -0
  102. package/dist/analytics/extractCorpus/filesystemSources.js +1 -5
  103. package/dist/analytics/extractCorpus/index.js +6 -1
  104. package/dist/analytics/extractCorpus/jsonlSessions.js +24 -5
  105. package/dist/analytics/extractCorpus/sqliteCaps.js +43 -0
  106. package/dist/analytics/extractCorpus/sqliteSessions.js +98 -6
  107. package/dist/analytics/extractCorpus/tierReader.js +108 -0
  108. package/dist/analytics/extractCorpus.js +0 -1
  109. package/dist/analytics/glossaryAdviceResolution.js +166 -0
  110. package/dist/analytics/glossaryInputAcquisition.js +319 -0
  111. package/dist/analytics/personalGlossaryAdmission.js +133 -0
  112. package/dist/analytics/personalGlossaryProfile.js +219 -0
  113. package/dist/analytics/profileSignals.js +211 -0
  114. package/dist/analytics/usageStats.js +169 -42
  115. package/dist/audit/terminologyDrift.js +281 -0
  116. package/dist/bin/agentera.js +3 -2
  117. package/dist/capabilities/audit/instructions.js +16 -0
  118. package/dist/capabilities/build/instructions.js +59 -0
  119. package/dist/capabilities/design/instructions.js +4 -0
  120. package/dist/capabilities/discuss/instructions.js +29 -0
  121. package/dist/capabilities/document/instructions.js +11 -0
  122. package/dist/capabilities/index.js +29 -27
  123. package/dist/capabilities/optimize/instructions.js +14 -0
  124. package/dist/capabilities/orchestrate/instructions.js +42 -0
  125. package/dist/capabilities/plan/instructions.js +33 -0
  126. package/dist/capabilities/profile/instructions.js +70 -0
  127. package/dist/capabilities/research/instructions.js +5 -0
  128. package/dist/capabilities/status/instructions.js +15 -0
  129. package/dist/capabilities/status/startupInstructions.js +34 -0
  130. package/dist/capabilities/vision/instructions.js +4 -0
  131. package/dist/cli/appContext.js +30 -24
  132. package/dist/cli/argvalidate.js +0 -1
  133. package/dist/cli/capabilityContext/benchmark.js +25 -17
  134. package/dist/cli/capabilityContext/bespoke.js +31 -12
  135. package/dist/cli/capabilityContext/build.js +251 -0
  136. package/dist/cli/capabilityContext/closeout.js +33 -30
  137. package/dist/cli/capabilityContext/contract.js +39 -46
  138. package/dist/cli/capabilityContext/evidence.js +90 -73
  139. package/dist/cli/capabilityContext/index.js +1 -2
  140. package/dist/cli/capabilityContext/orchestration.js +45 -21
  141. package/dist/cli/capabilityContext/planState.js +93 -100
  142. package/dist/cli/capabilityContext/progress.js +60 -14
  143. package/dist/cli/capabilityContext/projectVerification.js +409 -0
  144. package/dist/cli/capabilityContext/shared.js +9 -20
  145. package/dist/cli/capabilityContext/slim.js +56 -10
  146. package/dist/cli/capabilityContext/startup.js +57 -115
  147. package/dist/cli/capabilityContext/startupAggregation.js +68 -0
  148. package/dist/cli/capabilityContext/types.js +37 -24
  149. package/dist/cli/capabilityContext.js +1 -2
  150. package/dist/cli/commands/appHome.js +22 -0
  151. package/dist/cli/commands/capability.js +4 -4
  152. package/dist/cli/commands/compact.js +163 -13
  153. package/dist/cli/commands/doctor.js +122 -114
  154. package/dist/cli/commands/durability.js +81 -0
  155. package/dist/cli/commands/glossaryAdvice.js +138 -0
  156. package/dist/cli/commands/lint.js +22 -8
  157. package/dist/cli/commands/personalGlossary.js +176 -0
  158. package/dist/cli/commands/prime/briefOrientation.js +746 -0
  159. package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
  160. package/dist/cli/commands/prime/bundleStatus.js +190 -0
  161. package/dist/cli/commands/prime/collectEntityOrientation.js +326 -0
  162. package/dist/cli/commands/prime/collectOrientationState.js +219 -0
  163. package/dist/cli/commands/prime/orientationOutput.js +421 -0
  164. package/dist/cli/commands/prime/types.js +1 -0
  165. package/dist/cli/commands/prime/v1Migration.js +38 -0
  166. package/dist/cli/commands/prime.js +80 -558
  167. package/dist/cli/commands/profileGrounding.js +55 -0
  168. package/dist/cli/commands/query.js +77 -52
  169. package/dist/cli/commands/report.js +88 -26
  170. package/dist/cli/commands/route.js +142 -0
  171. package/dist/cli/commands/schema.js +266 -142
  172. package/dist/cli/commands/state/decisions.js +51 -61
  173. package/dist/cli/commands/state/docs.js +63 -86
  174. package/dist/cli/commands/state/experimentRecords.js +151 -0
  175. package/dist/cli/commands/state/experiments.js +11 -64
  176. package/dist/cli/commands/state/get.js +129 -0
  177. package/dist/cli/commands/state/health.js +11 -111
  178. package/dist/cli/commands/state/index.js +6 -41
  179. package/dist/cli/commands/state/list.js +194 -0
  180. package/dist/cli/commands/state/objective.js +21 -64
  181. package/dist/cli/commands/state/plan.js +11 -169
  182. package/dist/cli/commands/state/planTasks.js +154 -0
  183. package/dist/cli/commands/state/plans.js +154 -0
  184. package/dist/cli/commands/state/progress.js +11 -45
  185. package/dist/cli/commands/state/shared.js +0 -1
  186. package/dist/cli/commands/state/todo.js +29 -108
  187. package/dist/cli/commands/state/write.js +433 -0
  188. package/dist/cli/commands/upgrade.js +146 -5
  189. package/dist/cli/commands/upgradeVerify.js +118 -0
  190. package/dist/cli/commands/validate.js +246 -211
  191. package/dist/cli/commands/verify.js +24 -9
  192. package/dist/cli/contracts/bundleStatus.js +1 -0
  193. package/dist/cli/contracts/orientationState.js +1 -0
  194. package/dist/cli/dispatch/argvParser.js +32 -0
  195. package/dist/cli/dispatch/check.js +94 -50
  196. package/dist/cli/dispatch/commands.js +27 -0
  197. package/dist/cli/dispatch/index.js +82 -52
  198. package/dist/cli/dispatch/lifecycle.js +268 -108
  199. package/dist/cli/dispatch/prime.js +68 -29
  200. package/dist/cli/dispatch/projections.js +17 -0
  201. package/dist/cli/dispatch/shared.js +1 -2
  202. package/dist/cli/dispatch/state.js +68 -77
  203. package/dist/cli/dispatch.js +0 -1
  204. package/dist/cli/errors.js +16 -17
  205. package/dist/cli/help.js +395 -41
  206. package/dist/cli/migrationRequired.js +122 -0
  207. package/dist/cli/orientation/attention.js +61 -0
  208. package/dist/cli/orientation/corpusCoverage.js +102 -0
  209. package/dist/cli/orientation.js +438 -170
  210. package/dist/cli/planArtifacts.js +350 -0
  211. package/dist/cli/planEvidence.js +157 -0
  212. package/dist/cli/planLifecycleState.js +36 -0
  213. package/dist/cli/planTaskIndex.js +11 -0
  214. package/dist/cli/preCutoverCommand.js +32 -0
  215. package/dist/cli/prime-blob.js +71 -3
  216. package/dist/cli/profileAcquisition.js +167 -0
  217. package/dist/cli/startupCompletenessContract.js +59 -0
  218. package/dist/cli/stateQuery.js +56 -14
  219. package/dist/cli/structured.js +0 -1
  220. package/dist/cli/todoMarkdown.js +25 -12
  221. package/dist/cli/todoReadinessSelection.js +192 -0
  222. package/dist/cli/todoSeverity.js +18 -0
  223. package/dist/core/atomicWriter.js +20 -0
  224. package/dist/core/developmentChannel.js +1 -0
  225. package/dist/core/developmentInvocation.js +374 -0
  226. package/dist/core/difflib.js +0 -1
  227. package/dist/core/envPaths.js +20 -0
  228. package/dist/core/jsonValue.js +5 -0
  229. package/dist/core/paths.js +0 -1
  230. package/dist/core/pyjson.js +67 -3
  231. package/dist/core/shell.js +4 -0
  232. package/dist/core/skillIdentity.js +23 -0
  233. package/dist/core/sourceRoot.js +9 -12
  234. package/dist/core/text.js +10 -0
  235. package/dist/core/toml.js +0 -1
  236. package/dist/core/yaml.js +8 -1
  237. package/dist/eval/evalSkills.js +30 -26
  238. package/dist/eval/hybridRouteEvaluation.js +155 -0
  239. package/dist/eval/semanticEval.js +43 -20
  240. package/dist/eval/semanticFixtures.js +16 -5
  241. package/dist/hooks/common.js +3 -56
  242. package/dist/hooks/compaction/apply.js +252 -50
  243. package/dist/hooks/compaction/dryRun.js +7 -4
  244. package/dist/hooks/compaction/index.js +5 -6
  245. package/dist/hooks/compaction/parse.js +201 -5
  246. package/dist/hooks/compaction/retention.js +30 -25
  247. package/dist/hooks/compaction/status.js +149 -32
  248. package/dist/hooks/compaction/types.js +0 -1
  249. package/dist/hooks/validateArtifact/agentFacing.js +0 -1
  250. package/dist/hooks/validateArtifact/index.js +7 -64
  251. package/dist/hooks/validateArtifact/markdown.js +57 -7
  252. package/dist/hooks/validateArtifact/schema.js +110 -19
  253. package/dist/hooks/validateArtifact/traversal.js +13 -11
  254. package/dist/hooks/validateArtifact/violations.js +7 -5
  255. package/dist/migrate/v2HandoffManifest.js +127 -8
  256. package/dist/registries/activationContract.js +2 -0
  257. package/dist/registries/activationTuples.js +108 -0
  258. package/dist/registries/artifactProtocolIds.js +2 -1
  259. package/dist/registries/artifactRegistry.js +224 -63
  260. package/dist/registries/artifactSchemaProjection.js +45 -0
  261. package/dist/registries/capabilityContract.js +129 -2
  262. package/dist/registries/evaluatorHandoffContract.js +2 -3
  263. package/dist/registries/evidenceTierContract.js +371 -0
  264. package/dist/registries/glossaryAdviceContract.js +79 -0
  265. package/dist/registries/glossaryCaveatContract.js +67 -0
  266. package/dist/registries/glossaryConsumerContractValidation.js +787 -0
  267. package/dist/registries/glossaryEntryContract.js +757 -0
  268. package/dist/registries/glossaryTermIdentity.js +17 -0
  269. package/dist/registries/glossaryTermOccurrence.js +20 -0
  270. package/dist/registries/hybridRoute.js +274 -0
  271. package/dist/registries/hybridRouteReceipt.js +221 -0
  272. package/dist/registries/packagePublication.js +273 -0
  273. package/dist/registries/packageRegistry.js +187 -211
  274. package/dist/registries/todoReadinessContract.js +448 -0
  275. package/dist/registries/triggerLoader.js +174 -0
  276. package/dist/registries/verbosityBudgetContract.js +205 -0
  277. package/dist/release/releaseMetadata.js +156 -6
  278. package/dist/runtime/lifecycleAdapterContract.js +457 -0
  279. package/dist/runtime/lifecycleAdapters.js +777 -0
  280. package/dist/runtime/lifecycleAuthority.js +453 -0
  281. package/dist/runtime/lifecycleOperationContract.js +123 -0
  282. package/dist/runtime/lifecycleOperations.js +634 -0
  283. package/dist/runtime/lifecycleOwnershipJournal.js +622 -0
  284. package/dist/runtime/lifecyclePublication.js +415 -0
  285. package/dist/runtime/lifecycleSnapshot.js +438 -0
  286. package/dist/runtime/nativeResourceCleanup.js +502 -0
  287. package/dist/setup/opencode.js +20 -13
  288. package/dist/setup/opencodeConstants.js +1 -0
  289. package/dist/setup/sharedSkill.js +45 -0
  290. package/dist/setup/smokeChecks.js +21 -82
  291. package/dist/state/archiveDiscovery.js +580 -0
  292. package/dist/state/archivePublication.js +225 -0
  293. package/dist/state/archiveRecovery.js +237 -0
  294. package/dist/state/archiveReplay.js +53 -0
  295. package/dist/state/canonicalMigrationRecord.js +36 -0
  296. package/dist/state/changelog.js +221 -0
  297. package/dist/state/decisionEntities.js +367 -0
  298. package/dist/state/decisionLegacyValidation.js +215 -0
  299. package/dist/state/decisionMigrationProvenance.js +199 -0
  300. package/dist/state/decisionOverlay.js +254 -0
  301. package/dist/state/decisionRevision.js +256 -0
  302. package/dist/state/decisionRevisionMigration.js +89 -0
  303. package/dist/state/directRetrieval.js +323 -0
  304. package/dist/state/durability.js +324 -0
  305. package/dist/state/entityCutover.js +459 -0
  306. package/dist/state/entityCutoverGit.js +127 -0
  307. package/dist/state/entityGlossaryAuthority.js +13 -0
  308. package/dist/state/entityListProjection.js +187 -0
  309. package/dist/state/entityListRuntimeRegistry.js +85 -0
  310. package/dist/state/entityMigrationCausality.js +97 -0
  311. package/dist/state/entityMigrationIdentity.js +5 -0
  312. package/dist/state/entityMigrationPreview.js +840 -0
  313. package/dist/state/entityMigrationTodo.js +133 -0
  314. package/dist/state/entityPublicationContext.js +859 -0
  315. package/dist/state/entityRetrievalHelp.js +506 -0
  316. package/dist/state/entityStorage.js +899 -0
  317. package/dist/state/exactReplacementRecovery.js +18 -0
  318. package/dist/state/experimentArchive.js +63 -0
  319. package/dist/state/experimentIdentity.js +202 -0
  320. package/dist/state/healthEntities.js +262 -0
  321. package/dist/state/healthEntityValidation.js +18 -0
  322. package/dist/state/healthRepair.js +69 -0
  323. package/dist/state/installRoot.js +64 -25
  324. package/dist/state/legacyEntityCutoverEvidence.js +65 -0
  325. package/dist/state/legacyIdentity.js +47 -0
  326. package/dist/state/legacySummaryRecord.js +6 -0
  327. package/dist/state/listAccounting.js +54 -0
  328. package/dist/state/listClassification.js +17 -0
  329. package/dist/state/listCursor.js +42 -0
  330. package/dist/state/listRetrieval.js +781 -0
  331. package/dist/state/migrationSourceBinding.js +30 -0
  332. package/dist/state/objectiveExperimentEntities.js +322 -0
  333. package/dist/state/planEntities.js +1027 -0
  334. package/dist/state/planIdentity.js +47 -0
  335. package/dist/state/planLineageValidation.js +52 -0
  336. package/dist/state/planReplacementTransaction.js +475 -0
  337. package/dist/state/planRetrieval.js +313 -0
  338. package/dist/state/planTaskRetrieval.js +294 -0
  339. package/dist/state/progressEntities.js +512 -0
  340. package/dist/state/progressGlossaryCaveat.js +168 -0
  341. package/dist/state/progressPublicationOrder.js +19 -0
  342. package/dist/state/progressWritePolicy.js +33 -0
  343. package/dist/state/projectRoot.js +62 -0
  344. package/dist/state/projectionPolicy.js +190 -0
  345. package/dist/state/retrievalAuthority.js +156 -0
  346. package/dist/state/safeProjectFile.js +155 -0
  347. package/dist/state/startupAnalysis/benchmark.js +92 -27
  348. package/dist/state/startupAnalysis/contract.js +48 -10
  349. package/dist/state/startupAnalysis/helpers.js +27 -73
  350. package/dist/state/startupAnalysis/index.js +0 -1
  351. package/dist/state/startupAnalysis/metrics.js +25 -19
  352. package/dist/state/startupAnalysis/records.js +13 -10
  353. package/dist/state/startupAnalysis/report.js +26 -38
  354. package/dist/state/startupAnalysis/threshold.js +19 -7
  355. package/dist/state/startupAnalysis.js +0 -1
  356. package/dist/state/startupProjection.js +499 -0
  357. package/dist/state/stateMode.js +222 -0
  358. package/dist/state/stateStorageAuthority.js +47 -0
  359. package/dist/state/summaryEntityRead.js +25 -0
  360. package/dist/state/summaryMigrationProvenance.js +66 -0
  361. package/dist/state/summarySourceRowAuthority.js +36 -0
  362. package/dist/state/todoActivationSafety.js +58 -0
  363. package/dist/state/todoDocsEntities.js +1124 -0
  364. package/dist/state/todoDocsEntityValidation.js +158 -0
  365. package/dist/state/todoMarkdownProjection.js +51 -0
  366. package/dist/state/todoReconciliationActivation.js +182 -0
  367. package/dist/state/todoReconciliationInspection.js +171 -0
  368. package/dist/state/todoReconciliationRepair.js +318 -0
  369. package/dist/state/todoReconciliationTransaction.js +595 -0
  370. package/dist/state/write/assign.js +20 -0
  371. package/dist/state/write/candidateMutation.js +269 -0
  372. package/dist/state/write/errors.js +11 -0
  373. package/dist/state/write/experimentPublication.js +192 -0
  374. package/dist/state/write/explain.js +377 -0
  375. package/dist/state/write/fields.js +61 -0
  376. package/dist/state/write/glossaryPublication.js +263 -0
  377. package/dist/state/write/grammar.js +285 -0
  378. package/dist/state/write/helpers.js +29 -0
  379. package/dist/state/write/index.js +12 -0
  380. package/dist/state/write/input.js +391 -0
  381. package/dist/state/write/lock.js +837 -0
  382. package/dist/state/write/mutation.js +234 -0
  383. package/dist/state/write/operations.js +170 -0
  384. package/dist/state/write/planEvaluation.js +128 -0
  385. package/dist/state/write/planPublication.js +179 -0
  386. package/dist/state/write/runtimeOperations.js +146 -0
  387. package/dist/state/write/serialize.js +1 -0
  388. package/dist/state/write/transaction.js +57 -0
  389. package/dist/state/write/validate.js +7 -0
  390. package/dist/upgrade/appContentRefresh.js +383 -0
  391. package/dist/upgrade/appModel.js +8 -7
  392. package/dist/upgrade/atomicWriter.js +1 -0
  393. package/dist/upgrade/bundleEvidence.js +33 -0
  394. package/dist/upgrade/channels.js +12 -8
  395. package/dist/upgrade/compatibility.js +56 -21
  396. package/dist/upgrade/doctor.js +165 -199
  397. package/dist/upgrade/doctorClassifier.js +187 -0
  398. package/dist/upgrade/installedHooksRetirement.js +196 -0
  399. package/dist/upgrade/legacyAgentCleanup.js +282 -0
  400. package/dist/upgrade/lifecycleUpgrade.js +113 -0
  401. package/dist/upgrade/migrateArtifactsV2ToV3.js +375 -79
  402. package/dist/upgrade/migrationPublication.js +122 -0
  403. package/dist/upgrade/nextMajorDoctor.js +29 -10
  404. package/dist/upgrade/npxPlatformStatus.js +22 -0
  405. package/dist/upgrade/projectIntegration.js +145 -189
  406. package/dist/upgrade/projectIntegrationDecision.js +50 -0
  407. package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
  408. package/dist/upgrade/runtimeMigration.js +272 -373
  409. package/dist/upgrade/upgradeCommands.js +14 -1
  410. package/dist/upgrade/upgradeLock.js +85 -0
  411. package/dist/upgrade/upgradeOrchestrator.js +263 -59
  412. package/dist/upgrade/v3CapabilitySurface.js +2 -3
  413. package/dist/upgrade/versionResolution.js +2 -3
  414. package/dist/validate/activationArtifactEvidence.js +852 -0
  415. package/dist/validate/activationArtifactEvidenceTypes.js +12 -0
  416. package/dist/validate/activationConjunction.js +816 -0
  417. package/dist/validate/activationEvidenceManifest.js +531 -0
  418. package/dist/validate/activationPackageSemantics.js +29 -0
  419. package/dist/validate/appHomeContract.js +2 -8
  420. package/dist/validate/bootstrapAuthority.js +44 -0
  421. package/dist/validate/capability.js +133 -12
  422. package/dist/validate/crossCapability.js +15 -10
  423. package/dist/validate/retainedReferenceAuthority.js +879 -0
  424. package/dist/validate/selfAudit.js +39 -45
  425. package/dist/validate/v1LegacyCruft.js +131 -0
  426. package/dist/validate/vocabularyAuthority.js +18 -13
  427. package/package.json +60 -29
  428. package/bundle/references/adapters/cursor.md +0 -213
  429. package/bundle/references/adapters/opencode.md +0 -530
  430. package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
  431. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  432. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  433. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -548
  434. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  435. package/bundle/references/analysis/benchmark.md +0 -267
  436. package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
  437. package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
  438. package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -369
  439. package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -250
  440. package/bundle/references/cli/capability-tool-classification.yaml +0 -53
  441. package/bundle/references/cli/coexistence-probe.yaml +0 -9
  442. package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
  443. package/bundle/references/cli/single-name-protocol.yaml +0 -42
  444. package/bundle/references/cli/upgrade-repair-wording.md +0 -31
  445. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +0 -98
  446. package/bundle/references/meta/documentation-inventory.md +0 -49
  447. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  448. package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
  449. package/bundle/skills/agentera/agents/hej.toml +0 -6
  450. package/bundle/skills/agentera/agents/inspektera.toml +0 -6
  451. package/bundle/skills/agentera/agents/inspirera.toml +0 -6
  452. package/bundle/skills/agentera/agents/optimera.toml +0 -6
  453. package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
  454. package/bundle/skills/agentera/agents/planera.toml +0 -6
  455. package/bundle/skills/agentera/agents/profilera.toml +0 -6
  456. package/bundle/skills/agentera/agents/realisera.toml +0 -6
  457. package/bundle/skills/agentera/agents/resonera.toml +0 -6
  458. package/bundle/skills/agentera/agents/visionera.toml +0 -6
  459. package/bundle/skills/agentera/agents/visualisera.toml +0 -6
  460. package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +0 -73
  461. package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +0 -35
  462. package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +0 -69
  463. package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +0 -58
  464. package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +0 -76
  465. package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +0 -38
  466. package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
  467. package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +0 -34
  468. package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +0 -39
  469. package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +0 -64
  470. package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +0 -42
  471. package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -120
  472. package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
  473. package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +0 -34
  474. package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
  475. package/bundle/skills/agentera/capabilities/profilera/schemas/artifacts.yaml +0 -18
  476. package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +0 -45
  477. package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +0 -57
  478. package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +0 -80
  479. package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +0 -39
  480. package/bundle/skills/agentera/capabilities/realisera/schemas/validation.yaml +0 -110
  481. package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +0 -47
  482. package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +0 -46
  483. package/bundle/skills/agentera/capabilities/resonera/schemas/validation.yaml +0 -77
  484. package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +0 -41
  485. package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +0 -33
  486. package/bundle/skills/agentera/references/contract.md +0 -1039
  487. package/dist/analytics/extractCorpus/cli.js.map +0 -1
  488. package/dist/analytics/extractCorpus/copilotSessions.js.map +0 -1
  489. package/dist/analytics/extractCorpus/core.js.map +0 -1
  490. package/dist/analytics/extractCorpus/corpus.js.map +0 -1
  491. package/dist/analytics/extractCorpus/cursorSessions.js.map +0 -1
  492. package/dist/analytics/extractCorpus/filesystemSources.js.map +0 -1
  493. package/dist/analytics/extractCorpus/index.js.map +0 -1
  494. package/dist/analytics/extractCorpus/jsonlSessions.js.map +0 -1
  495. package/dist/analytics/extractCorpus/sqliteSessions.js.map +0 -1
  496. package/dist/analytics/extractCorpus.js.map +0 -1
  497. package/dist/analytics/usageStats.js.map +0 -1
  498. package/dist/bin/agentera.js.map +0 -1
  499. package/dist/capabilities/dokumentera/instructions.js +0 -6
  500. package/dist/capabilities/dokumentera/instructions.js.map +0 -1
  501. package/dist/capabilities/hej/instructions.js +0 -6
  502. package/dist/capabilities/hej/instructions.js.map +0 -1
  503. package/dist/capabilities/index.js.map +0 -1
  504. package/dist/capabilities/inspektera/instructions.js +0 -6
  505. package/dist/capabilities/inspektera/instructions.js.map +0 -1
  506. package/dist/capabilities/inspirera/instructions.js +0 -6
  507. package/dist/capabilities/inspirera/instructions.js.map +0 -1
  508. package/dist/capabilities/optimera/instructions.js +0 -6
  509. package/dist/capabilities/optimera/instructions.js.map +0 -1
  510. package/dist/capabilities/orkestrera/instructions.js +0 -6
  511. package/dist/capabilities/orkestrera/instructions.js.map +0 -1
  512. package/dist/capabilities/planera/instructions.js +0 -6
  513. package/dist/capabilities/planera/instructions.js.map +0 -1
  514. package/dist/capabilities/profilera/instructions.js +0 -6
  515. package/dist/capabilities/profilera/instructions.js.map +0 -1
  516. package/dist/capabilities/realisera/instructions.js +0 -6
  517. package/dist/capabilities/realisera/instructions.js.map +0 -1
  518. package/dist/capabilities/resonera/instructions.js +0 -6
  519. package/dist/capabilities/resonera/instructions.js.map +0 -1
  520. package/dist/capabilities/visionera/instructions.js +0 -6
  521. package/dist/capabilities/visionera/instructions.js.map +0 -1
  522. package/dist/capabilities/visualisera/instructions.js +0 -6
  523. package/dist/capabilities/visualisera/instructions.js.map +0 -1
  524. package/dist/cli/appContext.js.map +0 -1
  525. package/dist/cli/argvalidate.js.map +0 -1
  526. package/dist/cli/capabilityContext/benchmark.js.map +0 -1
  527. package/dist/cli/capabilityContext/bespoke.js.map +0 -1
  528. package/dist/cli/capabilityContext/closeout.js.map +0 -1
  529. package/dist/cli/capabilityContext/contract.js.map +0 -1
  530. package/dist/cli/capabilityContext/evidence.js.map +0 -1
  531. package/dist/cli/capabilityContext/index.js.map +0 -1
  532. package/dist/cli/capabilityContext/orchestration.js.map +0 -1
  533. package/dist/cli/capabilityContext/planState.js.map +0 -1
  534. package/dist/cli/capabilityContext/progress.js.map +0 -1
  535. package/dist/cli/capabilityContext/realisera.js +0 -174
  536. package/dist/cli/capabilityContext/realisera.js.map +0 -1
  537. package/dist/cli/capabilityContext/shared.js.map +0 -1
  538. package/dist/cli/capabilityContext/slim.js.map +0 -1
  539. package/dist/cli/capabilityContext/startup.js.map +0 -1
  540. package/dist/cli/capabilityContext/types.js.map +0 -1
  541. package/dist/cli/capabilityContext.js.map +0 -1
  542. package/dist/cli/commands/backfill.js +0 -84
  543. package/dist/cli/commands/backfill.js.map +0 -1
  544. package/dist/cli/commands/capability.js.map +0 -1
  545. package/dist/cli/commands/compact.js.map +0 -1
  546. package/dist/cli/commands/doctor.js.map +0 -1
  547. package/dist/cli/commands/lint.js.map +0 -1
  548. package/dist/cli/commands/prime.js.map +0 -1
  549. package/dist/cli/commands/query.js.map +0 -1
  550. package/dist/cli/commands/report.js.map +0 -1
  551. package/dist/cli/commands/schema.js.map +0 -1
  552. package/dist/cli/commands/state/decisions.js.map +0 -1
  553. package/dist/cli/commands/state/docs.js.map +0 -1
  554. package/dist/cli/commands/state/experiments.js.map +0 -1
  555. package/dist/cli/commands/state/health.js.map +0 -1
  556. package/dist/cli/commands/state/index.js.map +0 -1
  557. package/dist/cli/commands/state/objective.js.map +0 -1
  558. package/dist/cli/commands/state/plan.js.map +0 -1
  559. package/dist/cli/commands/state/progress.js.map +0 -1
  560. package/dist/cli/commands/state/shared.js.map +0 -1
  561. package/dist/cli/commands/state/todo.js.map +0 -1
  562. package/dist/cli/commands/state.js +0 -1023
  563. package/dist/cli/commands/state.js.map +0 -1
  564. package/dist/cli/commands/upgrade.js.map +0 -1
  565. package/dist/cli/commands/validate.js.map +0 -1
  566. package/dist/cli/commands/verify.js.map +0 -1
  567. package/dist/cli/dispatch/check.js.map +0 -1
  568. package/dist/cli/dispatch/index.js.map +0 -1
  569. package/dist/cli/dispatch/lifecycle.js.map +0 -1
  570. package/dist/cli/dispatch/prime.js.map +0 -1
  571. package/dist/cli/dispatch/shared.js.map +0 -1
  572. package/dist/cli/dispatch/state.js.map +0 -1
  573. package/dist/cli/dispatch.js.map +0 -1
  574. package/dist/cli/errors.js.map +0 -1
  575. package/dist/cli/help.js.map +0 -1
  576. package/dist/cli/orientation.js.map +0 -1
  577. package/dist/cli/prime-blob.js.map +0 -1
  578. package/dist/cli/stateQuery.js.map +0 -1
  579. package/dist/cli/structured.js.map +0 -1
  580. package/dist/cli/todoMarkdown.js.map +0 -1
  581. package/dist/core/difflib.js.map +0 -1
  582. package/dist/core/git.js +0 -43
  583. package/dist/core/git.js.map +0 -1
  584. package/dist/core/paths.js.map +0 -1
  585. package/dist/core/pyjson.js.map +0 -1
  586. package/dist/core/sourceRoot.js.map +0 -1
  587. package/dist/core/toml.js.map +0 -1
  588. package/dist/core/yaml.js.map +0 -1
  589. package/dist/eval/evalSkills.js.map +0 -1
  590. package/dist/eval/semanticEval.js.map +0 -1
  591. package/dist/eval/semanticFixtures.js.map +0 -1
  592. package/dist/hooks/common.js.map +0 -1
  593. package/dist/hooks/compaction/apply.js.map +0 -1
  594. package/dist/hooks/compaction/dryRun.js.map +0 -1
  595. package/dist/hooks/compaction/index.js.map +0 -1
  596. package/dist/hooks/compaction/parse.js.map +0 -1
  597. package/dist/hooks/compaction/retention.js.map +0 -1
  598. package/dist/hooks/compaction/status.js.map +0 -1
  599. package/dist/hooks/compaction/types.js.map +0 -1
  600. package/dist/hooks/compaction.js +0 -935
  601. package/dist/hooks/compaction.js.map +0 -1
  602. package/dist/hooks/cursorPreToolUse.js +0 -19
  603. package/dist/hooks/cursorPreToolUse.js.map +0 -1
  604. package/dist/hooks/cursorSessionStart.js +0 -71
  605. package/dist/hooks/cursorSessionStart.js.map +0 -1
  606. package/dist/hooks/sessionStart.js +0 -209
  607. package/dist/hooks/sessionStart.js.map +0 -1
  608. package/dist/hooks/sessionStop.js +0 -203
  609. package/dist/hooks/sessionStop.js.map +0 -1
  610. package/dist/hooks/validateArtifact/agentFacing.js.map +0 -1
  611. package/dist/hooks/validateArtifact/index.js.map +0 -1
  612. package/dist/hooks/validateArtifact/markdown.js.map +0 -1
  613. package/dist/hooks/validateArtifact/runtime.js +0 -83
  614. package/dist/hooks/validateArtifact/runtime.js.map +0 -1
  615. package/dist/hooks/validateArtifact/schema.js.map +0 -1
  616. package/dist/hooks/validateArtifact/traversal.js.map +0 -1
  617. package/dist/hooks/validateArtifact/violations.js.map +0 -1
  618. package/dist/hooks/validateArtifact.js +0 -924
  619. package/dist/hooks/validateArtifact.js.map +0 -1
  620. package/dist/migrate/v2HandoffManifest.js.map +0 -1
  621. package/dist/registries/artifactProtocolIds.js.map +0 -1
  622. package/dist/registries/artifactRegistry.js.map +0 -1
  623. package/dist/registries/capabilityContract.js.map +0 -1
  624. package/dist/registries/evaluatorHandoffContract.js.map +0 -1
  625. package/dist/registries/packageRegistry.js.map +0 -1
  626. package/dist/registries/runtimeAdapterRegistry.js +0 -315
  627. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  628. package/dist/release/releaseMetadata.js.map +0 -1
  629. package/dist/setup/codex/agents.js +0 -96
  630. package/dist/setup/codex/agents.js.map +0 -1
  631. package/dist/setup/codex/cli.js +0 -161
  632. package/dist/setup/codex/cli.js.map +0 -1
  633. package/dist/setup/codex/configToml.js +0 -644
  634. package/dist/setup/codex/configToml.js.map +0 -1
  635. package/dist/setup/codex/constants.js +0 -29
  636. package/dist/setup/codex/constants.js.map +0 -1
  637. package/dist/setup/codex/installRoot.js +0 -64
  638. package/dist/setup/codex/installRoot.js.map +0 -1
  639. package/dist/setup/codex/state.js +0 -270
  640. package/dist/setup/codex/state.js.map +0 -1
  641. package/dist/setup/codex.js +0 -12
  642. package/dist/setup/codex.js.map +0 -1
  643. package/dist/setup/copilot.js +0 -227
  644. package/dist/setup/copilot.js.map +0 -1
  645. package/dist/setup/cursor.js +0 -127
  646. package/dist/setup/cursor.js.map +0 -1
  647. package/dist/setup/doctor/core.js +0 -300
  648. package/dist/setup/doctor/core.js.map +0 -1
  649. package/dist/setup/doctor/diagnostics.js +0 -247
  650. package/dist/setup/doctor/diagnostics.js.map +0 -1
  651. package/dist/setup/doctor/opencode.js +0 -281
  652. package/dist/setup/doctor/opencode.js.map +0 -1
  653. package/dist/setup/doctor/report.js +0 -474
  654. package/dist/setup/doctor/report.js.map +0 -1
  655. package/dist/setup/doctor.js +0 -10
  656. package/dist/setup/doctor.js.map +0 -1
  657. package/dist/setup/opencode.js.map +0 -1
  658. package/dist/setup/smokeChecks.js.map +0 -1
  659. package/dist/state/installRoot.js.map +0 -1
  660. package/dist/state/progressCommit.js +0 -289
  661. package/dist/state/progressCommit.js.map +0 -1
  662. package/dist/state/startupAnalysis/benchmark.js.map +0 -1
  663. package/dist/state/startupAnalysis/contract.js.map +0 -1
  664. package/dist/state/startupAnalysis/helpers.js.map +0 -1
  665. package/dist/state/startupAnalysis/index.js.map +0 -1
  666. package/dist/state/startupAnalysis/metrics.js.map +0 -1
  667. package/dist/state/startupAnalysis/records.js.map +0 -1
  668. package/dist/state/startupAnalysis/report.js.map +0 -1
  669. package/dist/state/startupAnalysis/threshold.js.map +0 -1
  670. package/dist/state/startupAnalysis.js.map +0 -1
  671. package/dist/upgrade/appModel.js.map +0 -1
  672. package/dist/upgrade/channels.js.map +0 -1
  673. package/dist/upgrade/coexistenceProbe.js +0 -83
  674. package/dist/upgrade/coexistenceProbe.js.map +0 -1
  675. package/dist/upgrade/compatibility.js.map +0 -1
  676. package/dist/upgrade/doctor.js.map +0 -1
  677. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
  678. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  679. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
  680. package/dist/upgrade/nextMajorDoctor.js.map +0 -1
  681. package/dist/upgrade/projectIntegration.js.map +0 -1
  682. package/dist/upgrade/runtimeMigration.js.map +0 -1
  683. package/dist/upgrade/upgradeCommands.js.map +0 -1
  684. package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
  685. package/dist/upgrade/v3CapabilitySurface.js.map +0 -1
  686. package/dist/upgrade/versionResolution.js.map +0 -1
  687. package/dist/validate/appHomeContract.js.map +0 -1
  688. package/dist/validate/capability.js.map +0 -1
  689. package/dist/validate/crossCapability.js.map +0 -1
  690. package/dist/validate/lifecycleAdapters.js +0 -772
  691. package/dist/validate/lifecycleAdapters.js.map +0 -1
  692. package/dist/validate/selfAudit.js.map +0 -1
  693. package/dist/validate/vocabularyAuthority.js.map +0 -1
  694. /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
  695. /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
  696. /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
@@ -1,62 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: plan
5
- local_role: produces_and_consumes
6
- description: >-
7
- Active plan with tasks, dependencies, and behavioral acceptance criteria.
8
- Planera writes this during the planning session and may read existing
9
- plan context before replacing or refining it.
10
- 2:
11
- id: A2
12
- artifact_id: plan_archive
13
- local_role: produces
14
- description: >-
15
- Created when a plan is fully
16
- executed or explicitly discarded by the user. Preserved for historical
17
- reference.
18
- 3:
19
- id: A3
20
- artifact_id: vision
21
- local_role: consumes
22
- description: >-
23
- Planera reads this during Orient to understand project direction and
24
- align the plan with the vision.
25
- 4:
26
- id: A4
27
- artifact_id: decisions
28
- local_role: consumes
29
- description: >-
30
- Planera reads firm (DL1) entries only as hard constraints for planning.
31
- 5:
32
- id: A5
33
- artifact_id: todo
34
- local_role: consumes
35
- description: >-
36
- Planera reads this to identify related known
37
- issues that the plan should address.
38
- 6:
39
- id: A6
40
- artifact_id: health
41
- local_role: consumes
42
- description: >-
43
- Planera reads this to factor structural issues into the plan.
44
- 7:
45
- id: A7
46
- artifact_id: progress
47
- local_role: consumes
48
- description: >-
49
- Planera reads this to understand what was built recently.
50
- 8:
51
- id: A8
52
- artifact_id: profile
53
- local_role: consumes
54
- description: >-
55
- Planera reads this to calibrate planning depth and pattern preferences.
56
- 9:
57
- id: A9
58
- artifact_id: docs
59
- local_role: consumes
60
- description: >-
61
- Planera reads this first to resolve project-local artifact mappings and
62
- reads the versioning block for version bump task generation.
@@ -1,34 +0,0 @@
1
- TRIGGERS:
2
- 1:
3
- id: T1
4
- description: >-
5
- Direct invocation by name or slash command. Matches when the user
6
- explicitly requests planera for structured planning.
7
- priority: high
8
- patterns:
9
- - "planera"
10
- - "/planera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Planning requests. Matches when the user wants to create a plan,
15
- break work down, or specify requirements before building.
16
- priority: medium
17
- patterns:
18
- - "plan this"
19
- - "write a plan"
20
- - "break this down"
21
- - "decompose this"
22
- - "spec this out"
23
- - "plan before building"
24
- 3:
25
- id: T3
26
- description: >-
27
- Architectural planning signals. Matches when the user is asking how
28
- to approach building something or when the work is too large for a
29
- single development cycle.
30
- priority: medium
31
- patterns:
32
- - "how should we build this"
33
- - "multi-step feature"
34
- - "this is too big for one cycle"
@@ -1,61 +0,0 @@
1
- VALIDATION:
2
- 1:
3
- id: V1
4
- rule: behavioral_acceptance_criteria
5
- description: >-
6
- All acceptance criteria MUST be behavioral (Given/When/Then format)
7
- and MUST NOT reference implementation details (class names, API
8
- endpoints, database tables, function names, line numbers).
9
- severity: critical
10
- checks:
11
- - "Acceptance criteria use Given/When/Then format"
12
- - "No implementation details in acceptance criteria"
13
- 2:
14
- id: V2
15
- rule: max_8_tasks
16
- description: >-
17
- Full plans MUST NOT exceed 8 tasks. If work requires more, it must
18
- be split into sequential plans.
19
- severity: critical
20
- checks:
21
- - "Task count ≤ 8 in full plans"
22
- 3:
23
- id: V3
24
- rule: adversarial_review_required
25
- description: >-
26
- Full plans MUST undergo adversarial review. The critic MUST find at
27
- least one issue. "Looks good" is not acceptable. Skip level and
28
- light plans are exempt.
29
- severity: critical
30
- checks:
31
- - "Adversarial review ran for full plans"
32
- 4:
33
- id: V4
34
- rule: plan_final_state_sync
35
- description: >-
36
- Every full plan MUST end with a "final state sync" task that depends
37
- on all prior tasks. This ensures aggregate plan-level CHANGELOG.md,
38
- PROGRESS.md, and TODO.md updates.
39
- severity: critical
40
- checks:
41
- - "Full plan has final state sync task as last task"
42
- 5:
43
- id: V5
44
- rule: test_proportionality_target
45
- description: >-
46
- Tasks that include writing tests MUST have a proportionality target
47
- in their acceptance criteria. Default: one pass + one fail per
48
- testable unit. Override only with explicit rationale.
49
- severity: warning
50
- checks:
51
- - "Test tasks state proportionality target"
52
- 6:
53
- id: V6
54
- rule: skip_level_for_trivial_work
55
- description: >-
56
- Planera MUST detect skip level for trivial work (single-file change,
57
- bug fix, config tweak, < 50 lines) and route directly to /realisera
58
- without producing a PLAN.md.
59
- severity: critical
60
- checks:
61
- - "Trivial work routed to /realisera without plan"
@@ -1,18 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: profile
5
- local_role: produces_and_consumes
6
- description: >-
7
- Decision profile with per-entry confidence scoring, permanence
8
- classification, and temporal metadata. Profilera writes this in both Full
9
- and Validate modes, then reads it for validation and update context.
10
- 2:
11
- id: A2
12
- artifact_id: decisions
13
- local_role: consumes
14
- description: >-
15
- Profilera treats this as a high-signal source for extraction scripts.
16
- Each decision entry captures
17
- reasoning, tradeoffs, and confidence, making deliberation sessions
18
- one of the richest inputs for decision profile generation.
@@ -1,45 +0,0 @@
1
- TRIGGERS:
2
- 1:
3
- id: T1
4
- description: >-
5
- Direct invocation by name or slash command. Matches when the user
6
- explicitly requests profilera.
7
- priority: high
8
- patterns:
9
- - "profilera"
10
- - "/profilera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Profile generation requests. Matches when the user wants to build
15
- or regenerate their decision profile from scratch.
16
- priority: medium
17
- patterns:
18
- - "build decision profile"
19
- - "generate decision profile"
20
- - "rebuild my profile"
21
- - "regenerate profile"
22
- 3:
23
- id: T3
24
- description: >-
25
- Profile maintenance requests. Matches when the user wants to update,
26
- validate, or check their existing profile.
27
- priority: medium
28
- patterns:
29
- - "update my profile"
30
- - "refresh my decision profile"
31
- - "validate my profile"
32
- - "check my profile"
33
- - "quick profile check"
34
- 4:
35
- id: T4
36
- description: >-
37
- Decision analysis requests. Matches when the user wants to understand
38
- their own decision-making patterns or review past decisions.
39
- priority: medium
40
- patterns:
41
- - "what would I decide"
42
- - "analyze my decisions"
43
- - "mine my sessions"
44
- - "decision patterns"
45
- - "review my decision history"
@@ -1,57 +0,0 @@
1
- VALIDATION:
2
- 1:
3
- id: V1
4
- rule: evidence_grounded
5
- description: >-
6
- Every profile entry MUST be grounded in observed evidence from session
7
- history, memory files, configs, or conversation data. Fabricated
8
- decision patterns are never acceptable.
9
- severity: critical
10
- checks:
11
- - "Each profile entry traces to a source record"
12
- - "No profile entry is fabricated without evidence"
13
- 2:
14
- id: V2
15
- rule: confidence_calibration
16
- description: >-
17
- Confidence scores MUST match the evidence tier (protocol CS1-CS5).
18
- A single data point is 30-49 (CS4), not 70+. Bias check: confidence
19
- is earned through evidence, not assigned by how insightful the
20
- decision sounds.
21
- severity: critical
22
- checks:
23
- - "Confidence values fall within protocol tier boundaries"
24
- - "Single-source entries are capped at CS4 (30-49)"
25
- 3:
26
- id: V3
27
- rule: tension_honesty
28
- description: >-
29
- Contradictions MUST be recorded as tensions, not smoothed into a
30
- coherent narrative. When evidence conflicts, the tension section
31
- captures the divergence explicitly.
32
- severity: critical
33
- checks:
34
- - "Conflicting evidence produces tension entries"
35
- - "No smoothing over contradictions"
36
- 4:
37
- id: V4
38
- rule: read_only_sources
39
- description: >-
40
- Profilera MUST NOT modify session history, memory files, or config
41
- files. It reads these sources for extraction but never writes to them.
42
- The only artifact profilera produces is PROFILE.md.
43
- severity: critical
44
- checks:
45
- - "No writes to session history files"
46
- - "No writes to memory or config files"
47
- 5:
48
- id: V5
49
- rule: prediction_accuracy
50
- description: >-
51
- Full mode MUST validate predictions against 5 decision-rich prompts
52
- not used to create the profile. Accuracy below 3/5 triggers a flag
53
- noting categories needing more signal.
54
- severity: warning
55
- checks:
56
- - "5 predictions tested against held-out prompts"
57
- - "Accuracy below 3/5 is flagged in profile header"
@@ -1,80 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: vision
5
- local_role: produces_and_consumes
6
- description: >-
7
- Realisera consumes this through CLI execution_context caveats or explicit
8
- fallback state when available, and never modifies it during cycles. Created
9
- during brainstorm (bootstrap or user-requested refinement).
10
- 2:
11
- id: A2
12
- artifact_id: todo
13
- local_role: produces_and_consumes
14
- description: >-
15
- Realisera consumes TODO state from execution_context and included hej state
16
- before direct reads, then writes newly discovered issues and resolved
17
- entries. Severity classified per protocol SI1-SI4.
18
- 3:
19
- id: A3
20
- artifact_id: changelog
21
- local_role: produces_and_consumes
22
- description: >-
23
- Realisera consumes changelog boundary from execution_context or the listed
24
- CLI fallback before direct reads. It appends public change entries under
25
- [Unreleased] based on commit type and promotes on version bumps.
26
- 4:
27
- id: A4
28
- artifact_id: progress
29
- local_role: produces_and_consumes
30
- description: >-
31
- Operational cycle log. Realisera consumes latest progress evidence from
32
- execution_context first, then appends one entry per cycle with mandatory
33
- Verified field. Compacted by applying schema COMPACTION rules.
34
- 5:
35
- id: A5
36
- artifact_id: health
37
- local_role: consumes
38
- description: >-
39
- Realisera consumes health state from execution_context and included hej
40
- state before direct reads, focusing on critical and degraded findings for
41
- work selection.
42
- 6:
43
- id: A6
44
- artifact_id: decisions
45
- local_role: consumes
46
- description: >-
47
- Realisera consumes decision caveats and fallback commands from
48
- execution_context first. Firm (DL1) entries are constraints and exploratory
49
- (DL3) entries are uncertain foundations during work selection.
50
- 7:
51
- id: A7
52
- artifact_id: plan
53
- local_role: produces_and_consumes
54
- description: >-
55
- Realisera consumes selected task, acceptance criteria, dependencies,
56
- constraints, and source contract metadata from CLI execution_context before
57
- direct plan reads, then updates task status and surprises during execution.
58
- 8:
59
- id: A8
60
- artifact_id: profile
61
- local_role: consumes
62
- description: >-
63
- Realisera consumes hej profile summary first. Missing or stale profile state
64
- is a caveat and does not authorize profile refresh or direct profile reads
65
- during normal startup.
66
- 9:
67
- id: A9
68
- artifact_id: docs
69
- local_role: consumes
70
- description: >-
71
- Realisera consumes artifact mappings and docs caveats from execution_context
72
- and included hej docs state before direct docs reads.
73
- 10:
74
- id: A10
75
- artifact_id: design
76
- local_role: consumes
77
- description: >-
78
- Realisera treats design state missing from execution_context as a caveat or
79
- fallback-only need, and reads it only when building user-facing features
80
- after listed CLI fallbacks are exhausted.
@@ -1,39 +0,0 @@
1
- TRIGGERS:
2
- 1:
3
- id: T1
4
- description: >-
5
- Direct invocation by name or slash command. Matches when the user
6
- explicitly requests realisera for autonomous development.
7
- priority: high
8
- patterns:
9
- - "realisera"
10
- - "/realisera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Development cycle requests. Matches when the user wants to run an
15
- autonomous development cycle or evolve the project.
16
- priority: medium
17
- patterns:
18
- - "run a dev cycle"
19
- - "evolve the project"
20
- - "develop autonomously"
21
- - "build the next feature"
22
- 3:
23
- id: T3
24
- description: >-
25
- Continuous development signals. Matches when the user wants ongoing
26
- building or to start working on the project.
27
- priority: medium
28
- patterns:
29
- - "keep building"
30
- - "start building"
31
- - "work on the project"
32
- 4:
33
- id: T4
34
- description: >-
35
- Vision refinement within a development context. Matches when the user
36
- wants to refine the project vision as part of a development session.
37
- priority: medium
38
- patterns:
39
- - "refine the vision"
@@ -1,110 +0,0 @@
1
- VALIDATION:
2
- 1:
3
- id: V1
4
- rule: verified_field_mandatory
5
- description: >-
6
- Every PROGRESS.md cycle entry MUST have a verified field. The field
7
- carries either observed output from the primary entrypoint, an allowlisted
8
- N/A tag, or a free-form rationale of at least 8 words.
9
- severity: critical
10
- checks:
11
- - "Every cycle entry has a verified field"
12
- - "verified field is not empty"
13
- 2:
14
- id: V2
15
- rule: one_cycle_per_invocation
16
- description: >-
17
- Realisera executes exactly one cycle per invocation. After logging (Step 9),
18
- the capability MUST stop. Multiple cycles require separate invocations or
19
- /loop.
20
- severity: critical
21
- checks:
22
- - "Only one cycle entry appended to PROGRESS.md per invocation"
23
- 3:
24
- id: V3
25
- rule: no_remote_push
26
- description: >-
27
- Realisera MUST NEVER push to any remote repository. All commits are local
28
- only. Remote operations require explicit user instruction outside this
29
- capability.
30
- severity: critical
31
- checks:
32
- - "No git push commands issued"
33
- 4:
34
- id: V4
35
- rule: vision_readonly_during_cycle
36
- description: >-
37
- The canonical vision artifact MUST NOT be modified during a cycle. It may only be written
38
- during a brainstorm session (bootstrap or user-requested refinement).
39
- severity: critical
40
- checks:
41
- - "Vision artifact not modified outside brainstorm"
42
- 5:
43
- id: V5
44
- rule: consecutive_failure_guard
45
- description: >-
46
- If the last 3 PROGRESS.md entries all record failed cycles, realisera
47
- MUST stop and surface the pattern to the user. Do not attempt a 4th
48
- consecutive cycle on the same failing problem.
49
- severity: critical
50
- checks:
51
- - "Failure pattern checked before cycle start"
52
- 6:
53
- id: V6
54
- rule: artifact_path_resolution
55
- description: >-
56
- Before reading or writing any artifact, check .agentera/docs.yaml for path
57
- overrides. If absent, use the default layout (TODO.md, CHANGELOG.md,
58
- and DESIGN.md at root; canonical VISION.md at .agentera/vision.yaml;
59
- other agent-facing artifacts as YAML in .agentera/).
60
- severity: warning
61
- checks:
62
- - "DOCS.md checked before artifact access"
63
- 7:
64
- id: V7
65
- rule: execution_context_first
66
- description: >-
67
- Realisera startup SHOULD begin from `agentera prime --context realisera
68
- --format json` and consume complete execution_context
69
- state before direct reads of plan, progress, TODO, docs, health,
70
- decisions, changelog, vision, profile, or design artifacts.
71
- severity: warning
72
- checks:
73
- - "execution_context requested through supported prime --context seam"
74
- - "complete execution_context used before direct startup artifact reads"
75
- 8:
76
- id: V8
77
- rule: fallback_before_raw
78
- description: >-
79
- When execution_context is incomplete or caveated, Realisera MUST run listed
80
- CLI fallback commands before any last-resort raw artifact diagnostic and
81
- MUST preserve caveats in cycle reporting.
82
- severity: critical
83
- checks:
84
- - "CLI fallback commands run before raw artifact diagnostics"
85
- - "execution_context caveats preserved in progress or cycle report"
86
- 9:
87
- id: V9
88
- rule: context_generation_readonly
89
- description: >-
90
- Generating execution_context is read-only. It MUST NOT refresh profile or
91
- installed app state, edit vision or objective state, spawn workers, commit,
92
- push, tag, publish, or introduce unsupported capability-name CLI commands.
93
- severity: critical
94
- checks:
95
- - "No protected state mutation during context generation"
96
- - "No unsupported `agentera realisera` or `agentera build` command introduced"
97
- 10:
98
- id: V10
99
- rule: satisfaction_authority_boundary
100
- description: >-
101
- When Realisera touches decision satisfaction, it may mark provisional
102
- satisfaction with evidence but MUST NOT user-confirm satisfaction. Missing,
103
- compacted, open, provisional, or review-needed satisfaction state remains a
104
- caveat and review pressure; automation must not reconstruct hidden outcomes
105
- or claim it proved user intent.
106
- severity: critical
107
- checks:
108
- - "Provisional satisfaction requires evidence"
109
- - "Only the user confirms final satisfaction"
110
- - "Missing or compacted satisfaction caveats are preserved"
@@ -1,47 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: decisions
5
- local_role: produces_and_consumes
6
- description: >-
7
- Reasoning trail with confidence labels. Resonera reads existing decisions
8
- through `agentera decisions --format json` and its source_contract to avoid
9
- re-deliberation, and writes new decision entries with confidence (DL1
10
- firm, DL2 provisional, DL3 exploratory). Compact older entries by applying
11
- schema COMPACTION rules; incomplete compacted entries are caveated context,
12
- not a reason for historical reconstruction during normal deliberation.
13
- 2:
14
- id: A2
15
- artifact_id: vision
16
- local_role: produces_and_consumes
17
- description: >-
18
- Resonera may update project direction only with explicit user
19
- confirmation when a decision feeds into project direction. Read for
20
- context during deliberation.
21
- 3:
22
- id: A3
23
- artifact_id: todo
24
- local_role: produces_and_consumes
25
- description: >-
26
- Resonera may add tech debt items surfaced during deliberation only with
27
- explicit user confirmation. Severity per protocol SI1-SI4.
28
- 4:
29
- id: A4
30
- artifact_id: objective
31
- local_role: produces_and_consumes
32
- description: >-
33
- Resonera may write optimization decisions only with explicit user
34
- confirmation when a decision feeds into what to optimize.
35
- 5:
36
- id: A5
37
- artifact_id: profile
38
- local_role: consumes
39
- description: >-
40
- Resonera reads this at session start to acknowledge high-confidence
41
- entries and avoid re-deliberating settled ground.
42
- 6:
43
- id: A6
44
- artifact_id: docs
45
- local_role: consumes
46
- description: >-
47
- Resonera reads this first to resolve project-local artifact mappings.
@@ -1,46 +0,0 @@
1
- TRIGGERS:
2
- 1:
3
- id: T1
4
- description: >-
5
- Direct invocation by name or slash command. Matches when the user
6
- explicitly requests resonera for structured deliberation.
7
- priority: high
8
- patterns:
9
- - "resonera"
10
- - "/resonera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Decision-oriented requests. Matches when the user wants help thinking
15
- through a decision or evaluating tradeoffs.
16
- priority: medium
17
- patterns:
18
- - "deliberate"
19
- - "help me think through"
20
- - "help me decide"
21
- - "think this through with me"
22
- - "let's deliberate"
23
- - "what are the tradeoffs"
24
- - "brainstorm"
25
- - "rubber duck"
26
- 3:
27
- id: T3
28
- description: >-
29
- Option-comparison signals. Matches when the user is torn between
30
- choices or wants to evaluate competing approaches.
31
- priority: medium
32
- patterns:
33
- - "should I"
34
- - "I'm torn between"
35
- - "what's the right approach"
36
- - "let's reason about"
37
- 4:
38
- id: T4
39
- description: >-
40
- Pre-build scoping signals. Matches when the user wants to scope or
41
- reason about work before starting implementation.
42
- priority: medium
43
- patterns:
44
- - "scope this out"
45
- - "before I build this"
46
- - "talk me through"
@@ -1,77 +0,0 @@
1
- VALIDATION:
2
- 1:
3
- id: V1
4
- rule: one_question_per_turn
5
- description: >-
6
- Resonera MUST ask exactly one question per turn. Compound questions
7
- are not allowed. Every question MUST include a Done option.
8
- severity: critical
9
- checks:
10
- - "At most one question per response"
11
- - "Done option present"
12
- 2:
13
- id: V2
14
- rule: user_approval_for_artifact_writes
15
- description: >-
16
- Resonera MUST NOT modify VISION.md, OBJECTIVE.md, or TODO.md without
17
- explicit user confirmation. Present drafts and get approval.
18
- severity: critical
19
- checks:
20
- - "User confirmation obtained before writing to VISION.md, OBJECTIVE.md, or TODO.md"
21
- 3:
22
- id: V3
23
- rule: decision_confidence_required
24
- description: >-
25
- Every DECISIONS.md entry MUST have a Confidence field with one of the
26
- protocol-defined labels: firm (DL1), provisional (DL2), or
27
- exploratory (DL3).
28
- severity: critical
29
- checks:
30
- - "Decision entry has Confidence field"
31
- - "Confidence value is one of firm, provisional, exploratory"
32
- 4:
33
- id: V4
34
- rule: preserved_decision_fields
35
- description: >-
36
- DECISIONS.md entries MUST preserve the canonical top-level fields:
37
- Question, Context, Alternatives, Choice, Reasoning, Confidence,
38
- Feeds into. Win conditions stay inside Alternatives bullets.
39
- severity: critical
40
- checks:
41
- - "Decision entry has all canonical fields"
42
- 5:
43
- id: V5
44
- rule: no_implementation
45
- description: >-
46
- Resonera MUST NOT skip to implementation. It deliberates; other
47
- capabilities build. If the user wants to build, route to the
48
- appropriate capability.
49
- severity: critical
50
- checks:
51
- - "No code changes made during deliberation"
52
- 6:
53
- id: V6
54
- rule: red_flag_phrasing_banned
55
- description: >-
56
- Red-flag phrasing that weakens the challenge is banned: "That sounds
57
- reasonable", "Either way is fine", "It depends" without naming the
58
- variable, "There is no wrong answer here", "Both options are valid"
59
- when one conflicts with constraints.
60
- severity: warning
61
- checks:
62
- - "No red-flag phrases in output"
63
- 7:
64
- id: V7
65
- rule: satisfaction_authority_boundary
66
- description: >-
67
- When Resonera touches decision satisfaction, it may capture provisional
68
- satisfaction with evidence but MUST NOT user-confirm satisfaction unless the
69
- user explicitly confirms it. Missing, compacted, open, provisional, or
70
- review-needed satisfaction state remains a caveat and review pressure;
71
- automation must not reconstruct hidden outcomes or claim it proved user
72
- intent.
73
- severity: critical
74
- checks:
75
- - "Provisional satisfaction requires evidence"
76
- - "Only the user confirms final satisfaction"
77
- - "Missing or compacted satisfaction caveats are preserved"