agentera 3.0.0-dev.5 → 3.0.0-dev.51

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 (598) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +119 -22
  3. package/bundle/CHANGELOG.md +1351 -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 +236 -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 +437 -0
  11. package/bundle/references/adapters/package-registry.yaml +435 -189
  12. package/bundle/references/adapters/package-surface-characterization.md +66 -35
  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 +191 -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 +3022 -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 -1
  29. package/bundle/references/cli/vocabulary-index.yaml +20 -17
  30. package/bundle/references/cli/vocabulary.md +326 -361
  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 +224 -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 +102 -0
  39. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +6 -5
  40. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +27 -0
  41. package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +176 -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 +458 -36
  91. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +128 -17
  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 +190 -0
  95. package/dist/analytics/extractCorpus/copilotSessions.js +275 -0
  96. package/dist/analytics/extractCorpus/core.js +392 -0
  97. package/dist/analytics/extractCorpus/corpus.js +167 -0
  98. package/dist/analytics/extractCorpus/coverageAudit.js +260 -0
  99. package/dist/analytics/extractCorpus/cursorSessions.js +425 -0
  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 +118 -0
  103. package/dist/analytics/extractCorpus/index.js +14 -0
  104. package/dist/analytics/extractCorpus/jsonlSessions.js +204 -0
  105. package/dist/analytics/extractCorpus/sqliteCaps.js +43 -0
  106. package/dist/analytics/extractCorpus/sqliteSessions.js +367 -0
  107. package/dist/analytics/extractCorpus/tierReader.js +108 -0
  108. package/dist/analytics/extractCorpus.js +2 -1791
  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 +56 -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 +565 -0
  134. package/dist/cli/capabilityContext/bespoke.js +44 -0
  135. package/dist/cli/capabilityContext/build.js +242 -0
  136. package/dist/cli/capabilityContext/closeout.js +233 -0
  137. package/dist/cli/capabilityContext/contract.js +179 -0
  138. package/dist/cli/capabilityContext/evidence.js +463 -0
  139. package/dist/cli/capabilityContext/index.js +3 -0
  140. package/dist/cli/capabilityContext/orchestration.js +131 -0
  141. package/dist/cli/capabilityContext/planState.js +260 -0
  142. package/dist/cli/capabilityContext/progress.js +142 -0
  143. package/dist/cli/capabilityContext/projectVerification.js +409 -0
  144. package/dist/cli/capabilityContext/shared.js +83 -0
  145. package/dist/cli/capabilityContext/slim.js +152 -0
  146. package/dist/cli/capabilityContext/startup.js +150 -0
  147. package/dist/cli/capabilityContext/startupAggregation.js +68 -0
  148. package/dist/cli/capabilityContext/types.js +56 -0
  149. package/dist/cli/capabilityContext.js +1 -2487
  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 +164 -14
  153. package/dist/cli/commands/doctor.js +122 -97
  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 +26 -44
  157. package/dist/cli/commands/personalGlossary.js +176 -0
  158. package/dist/cli/commands/prime/briefOrientation.js +747 -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 +212 -0
  163. package/dist/cli/commands/prime/orientationOutput.js +399 -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 +78 -53
  169. package/dist/cli/commands/report.js +96 -25
  170. package/dist/cli/commands/route.js +142 -0
  171. package/dist/cli/commands/schema.js +266 -143
  172. package/dist/cli/commands/state/decisions.js +387 -0
  173. package/dist/cli/commands/state/docs.js +70 -0
  174. package/dist/cli/commands/state/experimentRecords.js +151 -0
  175. package/dist/cli/commands/state/experiments.js +14 -0
  176. package/dist/cli/commands/state/get.js +129 -0
  177. package/dist/cli/commands/state/health.js +14 -0
  178. package/dist/cli/commands/state/index.js +16 -0
  179. package/dist/cli/commands/state/list.js +194 -0
  180. package/dist/cli/commands/state/objective.js +25 -0
  181. package/dist/cli/commands/state/plan.js +14 -0
  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 +13 -0
  185. package/dist/cli/commands/state/shared.js +14 -0
  186. package/dist/cli/commands/state/todo.js +42 -0
  187. package/dist/cli/commands/state/write.js +430 -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 +272 -223
  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 +372 -0
  196. package/dist/cli/dispatch/commands.js +27 -0
  197. package/dist/cli/dispatch/index.js +207 -0
  198. package/dist/cli/dispatch/lifecycle.js +652 -0
  199. package/dist/cli/dispatch/prime.js +139 -0
  200. package/dist/cli/dispatch/projections.js +17 -0
  201. package/dist/cli/dispatch/shared.js +63 -0
  202. package/dist/cli/dispatch/state.js +140 -0
  203. package/dist/cli/dispatch.js +1 -1294
  204. package/dist/cli/errors.js +16 -17
  205. package/dist/cli/help.js +394 -43
  206. package/dist/cli/migrationRequired.js +87 -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 +11 -79
  242. package/dist/hooks/compaction/apply.js +446 -0
  243. package/dist/hooks/compaction/dryRun.js +184 -0
  244. package/dist/hooks/compaction/index.js +22 -0
  245. package/dist/hooks/compaction/parse.js +325 -0
  246. package/dist/hooks/compaction/retention.js +202 -0
  247. package/dist/hooks/compaction/status.js +360 -0
  248. package/dist/hooks/compaction/types.js +5 -0
  249. package/dist/hooks/validateArtifact/agentFacing.js +9 -0
  250. package/dist/hooks/validateArtifact/index.js +92 -0
  251. package/dist/hooks/validateArtifact/markdown.js +145 -0
  252. package/dist/hooks/validateArtifact/schema.js +546 -0
  253. package/dist/hooks/validateArtifact/traversal.js +107 -0
  254. package/dist/hooks/validateArtifact/violations.js +107 -0
  255. package/dist/migrate/v2HandoffManifest.js +452 -0
  256. package/dist/registries/activationContract.js +2 -0
  257. package/dist/registries/activationTuples.js +107 -0
  258. package/dist/registries/artifactProtocolIds.js +78 -0
  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 +229 -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 +385 -0
  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 -0
  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 +846 -0
  313. package/dist/state/entityMigrationTodo.js +133 -0
  314. package/dist/state/entityPublicationContext.js +806 -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 +982 -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/projectRoot.js +62 -0
  343. package/dist/state/projectionPolicy.js +190 -0
  344. package/dist/state/retrievalAuthority.js +156 -0
  345. package/dist/state/safeProjectFile.js +155 -0
  346. package/dist/state/startupAnalysis/benchmark.js +432 -0
  347. package/dist/state/startupAnalysis/contract.js +160 -0
  348. package/dist/state/startupAnalysis/helpers.js +286 -0
  349. package/dist/state/startupAnalysis/index.js +6 -0
  350. package/dist/state/startupAnalysis/metrics.js +340 -0
  351. package/dist/state/startupAnalysis/records.js +198 -0
  352. package/dist/state/startupAnalysis/report.js +111 -0
  353. package/dist/state/startupAnalysis/threshold.js +512 -0
  354. package/dist/state/startupAnalysis.js +2 -1953
  355. package/dist/state/startupProjection.js +499 -0
  356. package/dist/state/stateMode.js +85 -0
  357. package/dist/state/stateStorageAuthority.js +47 -0
  358. package/dist/state/summaryEntityRead.js +25 -0
  359. package/dist/state/summaryMigrationProvenance.js +66 -0
  360. package/dist/state/summarySourceRowAuthority.js +36 -0
  361. package/dist/state/todoActivationSafety.js +58 -0
  362. package/dist/state/todoDocsEntities.js +1069 -0
  363. package/dist/state/todoDocsEntityValidation.js +158 -0
  364. package/dist/state/todoMarkdownProjection.js +51 -0
  365. package/dist/state/todoReconciliationActivation.js +140 -0
  366. package/dist/state/todoReconciliationInspection.js +169 -0
  367. package/dist/state/todoReconciliationRepair.js +170 -0
  368. package/dist/state/todoReconciliationTransaction.js +582 -0
  369. package/dist/state/write/assign.js +20 -0
  370. package/dist/state/write/candidateMutation.js +269 -0
  371. package/dist/state/write/errors.js +11 -0
  372. package/dist/state/write/experimentPublication.js +192 -0
  373. package/dist/state/write/explain.js +363 -0
  374. package/dist/state/write/fields.js +61 -0
  375. package/dist/state/write/glossaryPublication.js +263 -0
  376. package/dist/state/write/grammar.js +285 -0
  377. package/dist/state/write/helpers.js +29 -0
  378. package/dist/state/write/index.js +12 -0
  379. package/dist/state/write/input.js +367 -0
  380. package/dist/state/write/lock.js +837 -0
  381. package/dist/state/write/mutation.js +234 -0
  382. package/dist/state/write/operations.js +170 -0
  383. package/dist/state/write/planEvaluation.js +128 -0
  384. package/dist/state/write/planPublication.js +179 -0
  385. package/dist/state/write/runtimeOperations.js +144 -0
  386. package/dist/state/write/serialize.js +1 -0
  387. package/dist/state/write/transaction.js +52 -0
  388. package/dist/state/write/validate.js +7 -0
  389. package/dist/upgrade/appContentRefresh.js +383 -0
  390. package/dist/upgrade/appModel.js +8 -7
  391. package/dist/upgrade/atomicWriter.js +1 -0
  392. package/dist/upgrade/bundleEvidence.js +33 -0
  393. package/dist/upgrade/channels.js +12 -8
  394. package/dist/upgrade/compatibility.js +56 -21
  395. package/dist/upgrade/doctor.js +197 -192
  396. package/dist/upgrade/doctorClassifier.js +187 -0
  397. package/dist/upgrade/installedHooksRetirement.js +196 -0
  398. package/dist/upgrade/legacyAgentCleanup.js +282 -0
  399. package/dist/upgrade/lifecycleUpgrade.js +113 -0
  400. package/dist/upgrade/migrateArtifactsV2ToV3.js +367 -149
  401. package/dist/upgrade/migrationPublication.js +122 -0
  402. package/dist/upgrade/nextMajorDoctor.js +42 -8
  403. package/dist/upgrade/npxPlatformStatus.js +22 -0
  404. package/dist/upgrade/projectIntegration.js +145 -187
  405. package/dist/upgrade/projectIntegrationDecision.js +50 -0
  406. package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
  407. package/dist/upgrade/runtimeMigration.js +273 -363
  408. package/dist/upgrade/upgradeCommands.js +14 -1
  409. package/dist/upgrade/upgradeLock.js +85 -0
  410. package/dist/upgrade/upgradeOrchestrator.js +263 -59
  411. package/dist/upgrade/v3CapabilitySurface.js +14 -0
  412. package/dist/upgrade/versionResolution.js +8 -1
  413. package/dist/validate/activationArtifactEvidence.js +844 -0
  414. package/dist/validate/activationConjunction.js +816 -0
  415. package/dist/validate/activationEvidenceManifest.js +515 -0
  416. package/dist/validate/activationPackageSemantics.js +29 -0
  417. package/dist/validate/appHomeContract.js +5 -11
  418. package/dist/validate/bootstrapAuthority.js +44 -0
  419. package/dist/validate/capability.js +133 -12
  420. package/dist/validate/crossCapability.js +15 -10
  421. package/dist/validate/retainedReferenceAuthority.js +879 -0
  422. package/dist/validate/selfAudit.js +73 -37
  423. package/dist/validate/v1LegacyCruft.js +131 -0
  424. package/dist/validate/vocabularyAuthority.js +303 -0
  425. package/package.json +53 -27
  426. package/bundle/references/adapters/cursor.md +0 -213
  427. package/bundle/references/adapters/opencode.md +0 -530
  428. package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
  429. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  430. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  431. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -548
  432. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  433. package/bundle/references/analysis/benchmark.md +0 -267
  434. package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
  435. package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
  436. package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -355
  437. package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -278
  438. package/bundle/references/cli/capability-tool-classification.yaml +0 -53
  439. package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
  440. package/bundle/references/meta/documentation-inventory.md +0 -43
  441. package/bundle/references/v1-section-mapping.md +0 -47
  442. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  443. package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
  444. package/bundle/skills/agentera/agents/hej.toml +0 -6
  445. package/bundle/skills/agentera/agents/inspektera.toml +0 -6
  446. package/bundle/skills/agentera/agents/inspirera.toml +0 -6
  447. package/bundle/skills/agentera/agents/optimera.toml +0 -6
  448. package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
  449. package/bundle/skills/agentera/agents/planera.toml +0 -6
  450. package/bundle/skills/agentera/agents/profilera.toml +0 -6
  451. package/bundle/skills/agentera/agents/realisera.toml +0 -6
  452. package/bundle/skills/agentera/agents/resonera.toml +0 -6
  453. package/bundle/skills/agentera/agents/visionera.toml +0 -6
  454. package/bundle/skills/agentera/agents/visualisera.toml +0 -6
  455. package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +0 -73
  456. package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +0 -35
  457. package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +0 -69
  458. package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +0 -58
  459. package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +0 -76
  460. package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +0 -38
  461. package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
  462. package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +0 -34
  463. package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +0 -39
  464. package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +0 -64
  465. package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +0 -42
  466. package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -120
  467. package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
  468. package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +0 -34
  469. package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
  470. package/bundle/skills/agentera/capabilities/profilera/schemas/artifacts.yaml +0 -18
  471. package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +0 -45
  472. package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +0 -57
  473. package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +0 -80
  474. package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +0 -39
  475. package/bundle/skills/agentera/capabilities/realisera/schemas/validation.yaml +0 -110
  476. package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +0 -47
  477. package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +0 -46
  478. package/bundle/skills/agentera/capabilities/resonera/schemas/validation.yaml +0 -77
  479. package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +0 -41
  480. package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +0 -33
  481. package/bundle/skills/agentera/references/contract.md +0 -1039
  482. package/bundle/skills/hej/.claude-plugin/plugin.json +0 -6
  483. package/bundle/skills/hej/SKILL.md +0 -69
  484. package/bundle/skills/hej/agents/hej.toml +0 -11
  485. package/bundle/skills/hej/agents/openai.yaml +0 -8
  486. package/dist/analytics/extractCorpus.js.map +0 -1
  487. package/dist/analytics/usageStats.js.map +0 -1
  488. package/dist/bin/agentera.js.map +0 -1
  489. package/dist/capabilities/dokumentera/instructions.js +0 -6
  490. package/dist/capabilities/dokumentera/instructions.js.map +0 -1
  491. package/dist/capabilities/hej/instructions.js +0 -6
  492. package/dist/capabilities/hej/instructions.js.map +0 -1
  493. package/dist/capabilities/index.js.map +0 -1
  494. package/dist/capabilities/inspektera/instructions.js +0 -6
  495. package/dist/capabilities/inspektera/instructions.js.map +0 -1
  496. package/dist/capabilities/inspirera/instructions.js +0 -6
  497. package/dist/capabilities/inspirera/instructions.js.map +0 -1
  498. package/dist/capabilities/optimera/instructions.js +0 -6
  499. package/dist/capabilities/optimera/instructions.js.map +0 -1
  500. package/dist/capabilities/orkestrera/instructions.js +0 -6
  501. package/dist/capabilities/orkestrera/instructions.js.map +0 -1
  502. package/dist/capabilities/planera/instructions.js +0 -6
  503. package/dist/capabilities/planera/instructions.js.map +0 -1
  504. package/dist/capabilities/profilera/instructions.js +0 -6
  505. package/dist/capabilities/profilera/instructions.js.map +0 -1
  506. package/dist/capabilities/realisera/instructions.js +0 -6
  507. package/dist/capabilities/realisera/instructions.js.map +0 -1
  508. package/dist/capabilities/resonera/instructions.js +0 -6
  509. package/dist/capabilities/resonera/instructions.js.map +0 -1
  510. package/dist/capabilities/visionera/instructions.js +0 -6
  511. package/dist/capabilities/visionera/instructions.js.map +0 -1
  512. package/dist/capabilities/visualisera/instructions.js +0 -6
  513. package/dist/capabilities/visualisera/instructions.js.map +0 -1
  514. package/dist/cli/appContext.js.map +0 -1
  515. package/dist/cli/argvalidate.js.map +0 -1
  516. package/dist/cli/capabilityContext.js.map +0 -1
  517. package/dist/cli/commands/capability.js.map +0 -1
  518. package/dist/cli/commands/compact.js.map +0 -1
  519. package/dist/cli/commands/doctor.js.map +0 -1
  520. package/dist/cli/commands/lint.js.map +0 -1
  521. package/dist/cli/commands/prime.js.map +0 -1
  522. package/dist/cli/commands/query.js.map +0 -1
  523. package/dist/cli/commands/report.js.map +0 -1
  524. package/dist/cli/commands/schema.js.map +0 -1
  525. package/dist/cli/commands/state.js +0 -1023
  526. package/dist/cli/commands/state.js.map +0 -1
  527. package/dist/cli/commands/upgrade.js.map +0 -1
  528. package/dist/cli/commands/validate.js.map +0 -1
  529. package/dist/cli/commands/verify.js.map +0 -1
  530. package/dist/cli/dispatch.js.map +0 -1
  531. package/dist/cli/errors.js.map +0 -1
  532. package/dist/cli/help.js.map +0 -1
  533. package/dist/cli/orientation.js.map +0 -1
  534. package/dist/cli/prime-blob.js.map +0 -1
  535. package/dist/cli/stateQuery.js.map +0 -1
  536. package/dist/cli/structured.js.map +0 -1
  537. package/dist/cli/todoMarkdown.js.map +0 -1
  538. package/dist/core/difflib.js.map +0 -1
  539. package/dist/core/paths.js.map +0 -1
  540. package/dist/core/pyjson.js.map +0 -1
  541. package/dist/core/sourceRoot.js.map +0 -1
  542. package/dist/core/toml.js.map +0 -1
  543. package/dist/core/yaml.js.map +0 -1
  544. package/dist/eval/evalSkills.js.map +0 -1
  545. package/dist/eval/semanticEval.js.map +0 -1
  546. package/dist/eval/semanticFixtures.js.map +0 -1
  547. package/dist/hooks/common.js.map +0 -1
  548. package/dist/hooks/compaction.js +0 -935
  549. package/dist/hooks/compaction.js.map +0 -1
  550. package/dist/hooks/cursorPreToolUse.js +0 -19
  551. package/dist/hooks/cursorPreToolUse.js.map +0 -1
  552. package/dist/hooks/cursorSessionStart.js +0 -71
  553. package/dist/hooks/cursorSessionStart.js.map +0 -1
  554. package/dist/hooks/sessionStart.js +0 -209
  555. package/dist/hooks/sessionStart.js.map +0 -1
  556. package/dist/hooks/sessionStop.js +0 -212
  557. package/dist/hooks/sessionStop.js.map +0 -1
  558. package/dist/hooks/validateArtifact.js +0 -935
  559. package/dist/hooks/validateArtifact.js.map +0 -1
  560. package/dist/registries/artifactRegistry.js.map +0 -1
  561. package/dist/registries/capabilityContract.js.map +0 -1
  562. package/dist/registries/evaluatorHandoffContract.js.map +0 -1
  563. package/dist/registries/packageRegistry.js.map +0 -1
  564. package/dist/registries/runtimeAdapterRegistry.js +0 -315
  565. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  566. package/dist/setup/codex.js +0 -1197
  567. package/dist/setup/codex.js.map +0 -1
  568. package/dist/setup/copilot.js +0 -227
  569. package/dist/setup/copilot.js.map +0 -1
  570. package/dist/setup/cursor.js +0 -127
  571. package/dist/setup/cursor.js.map +0 -1
  572. package/dist/setup/doctor.js +0 -1297
  573. package/dist/setup/doctor.js.map +0 -1
  574. package/dist/setup/smokeChecks.js.map +0 -1
  575. package/dist/state/installRoot.js.map +0 -1
  576. package/dist/state/startupAnalysis.js.map +0 -1
  577. package/dist/upgrade/appModel.js.map +0 -1
  578. package/dist/upgrade/channels.js.map +0 -1
  579. package/dist/upgrade/compatibility.js.map +0 -1
  580. package/dist/upgrade/doctor.js.map +0 -1
  581. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
  582. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  583. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
  584. package/dist/upgrade/nextMajorDoctor.js.map +0 -1
  585. package/dist/upgrade/projectIntegration.js.map +0 -1
  586. package/dist/upgrade/runtimeMigration.js.map +0 -1
  587. package/dist/upgrade/upgradeCommands.js.map +0 -1
  588. package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
  589. package/dist/upgrade/versionResolution.js.map +0 -1
  590. package/dist/validate/appHomeContract.js.map +0 -1
  591. package/dist/validate/capability.js.map +0 -1
  592. package/dist/validate/crossCapability.js.map +0 -1
  593. package/dist/validate/lifecycleAdapters.js +0 -772
  594. package/dist/validate/lifecycleAdapters.js.map +0 -1
  595. package/dist/validate/selfAudit.js.map +0 -1
  596. /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
  597. /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
  598. /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
@@ -9,13 +9,7 @@
9
9
  # 3. Deprecation protocol (deprecated + replaced_by)
10
10
  # 4. Directory structure requirements (instruction module, schemas/)
11
11
  # 5. Machine-readable validation rules consumed by future contract loaders
12
- #
13
- # D65: the per-capability `instructions.md` Markdown file is retired. The
14
- # behavioral instructions now live at
15
- # `packages/cli/src/capabilities/<name>/instructions.ts` as a default-exported
16
- # string constant. The directory requirement below points at the new path;
17
- # the V1 directory_structure rule's `checks` list and the ARTIFACTS A3 path
18
- # text follow the same move.
12
+ # 6. Optional trigger-entry intent documentation (TRIGGER_ENRICHMENT)
19
13
 
20
14
  meta:
21
15
  name: capability_schema_contract
@@ -54,9 +48,10 @@ ENTRY_SCHEMA:
54
48
  type: string
55
49
  required: false
56
50
  description: >-
57
- Priority of this trigger entry for routing confidence. Used in the
58
- five-layer routing model (Decision 42). Valid values: high, medium, low.
51
+ Advisory relevance-precedence hint a host reads alongside the entry
52
+ description only after deterministic routing returns semantic_required.
59
53
  Required for all TRIGGERS entries.
54
+ Valid values: high, medium, low.
60
55
  deprecated:
61
56
  type: boolean
62
57
  required: false
@@ -85,7 +80,7 @@ DIRECTORY_REQUIREMENTS:
85
80
  TypeScript module that exports the capability's behavioral instructions
86
81
  as a default-exported string constant. The runtime loads it via the
87
82
  compiled .js path and surfaces the prose through
88
- `agentera prime --context <name> --format json`.
83
+ `npx -y agentera@next prime --context <name> --format json`.
89
84
  schemas_directory:
90
85
  path: schemas
91
86
  type: directory
@@ -141,7 +136,112 @@ FIELD_RULES:
141
136
  - high
142
137
  - medium
143
138
  - low
144
- description: Priority of this trigger entry for routing confidence.
139
+ description: >-
140
+ Relevance-precedence hint a host reads when ordering capability intent
141
+ after deterministic abstention. See
142
+ references/cli/routing-model.md for routing semantics.
143
+
144
+ TRIGGER_ENRICHMENT:
145
+ description: >-
146
+ Optional trigger-entry fields. Every field is OPTIONAL: a triggers.yaml
147
+ entry that omits all enriched fields remains valid. A host consumes
148
+ disambiguates_against as semantic-phase intent documentation only after
149
+ deterministic abstention. patterns,
150
+ confidence_threshold, borderline_band, and patterns_regex are legacy
151
+ compatibility fields: they remain shape-validated only and never enter the
152
+ active semantic trigger model.
153
+ spec: references/cli/trigger-schema-enrichment.md
154
+ fields:
155
+ patterns:
156
+ type: list_of_strings
157
+ required: false
158
+ description: >-
159
+ Legacy matcher strings retained only so existing trigger files load and
160
+ validate. They are never matched or returned by the active model.
161
+ confidence_threshold:
162
+ type: integer
163
+ required: false
164
+ min: 0
165
+ max: 100
166
+ description: >-
167
+ Legacy integer 0-100. Not consumed by the LLM host; retained so
168
+ triggers.yaml files carrying the field still validate. A non-integer
169
+ or value outside 0..100 fails V7 validation with the valid range
170
+ and the offending entry ID.
171
+ borderline_band:
172
+ type: integer
173
+ required: false
174
+ min: 0
175
+ max: 100
176
+ description: >-
177
+ Legacy integer 0-100. Not consumed by the LLM host; retained so
178
+ triggers.yaml files carrying the field still validate. A non-integer
179
+ or value outside 0..100 fails V7 validation.
180
+ patterns_regex:
181
+ type: list_of_strings
182
+ required: false
183
+ each_must_be_valid_regex: true
184
+ description: >-
185
+ Legacy list of regex strings. Not consumed by the LLM host; retained
186
+ so triggers.yaml files carrying the field still validate. The loader
187
+ syntax-validates each entry but never returns a RegExp or matches it.
188
+ disambiguates_against:
189
+ type: list_of_mappings
190
+ required: false
191
+ description: >-
192
+ Declares which other capabilities this trigger's intent could be
193
+ confused with, with a hint the LLM host consults when a request could
194
+ match more than one capability (spec §1.2). Advisory: the LLM host
195
+ resolves ambiguity natively and MAY surface the hint when asking the
196
+ user to confirm or clarify. Each entry MUST be a mapping with
197
+ `capability` and `hint`.
198
+ entries:
199
+ capability:
200
+ type: string
201
+ required: true
202
+ enum_source: ROUTE_ALIASES.primary_aliases.capability
203
+ description: >-
204
+ Canonical capability ID. Must be one of the twelve English
205
+ canonical IDs enumerated by ROUTE_ALIASES.primary_aliases
206
+ (status, vision, discuss, research, plan, build, optimize, audit,
207
+ document, profile, design, orchestrate). A non-canonical value
208
+ fails V7 validation with the offending entry ID.
209
+ hint:
210
+ type: string
211
+ required: true
212
+ non_empty: true
213
+ description: >-
214
+ Non-empty string distinguishing this trigger's intent from the
215
+ named capability on near-equal requests. A missing or empty hint
216
+ fails V7 validation.
217
+
218
+ PROSE_CONVENTIONS:
219
+ description: >-
220
+ Authoring rules for capability behavioral instructions. These
221
+ conventions govern the prose in
222
+ packages/cli/src/capabilities/<name>/instructions.ts.
223
+ modal_vocabulary:
224
+ authority: RFC 2119
225
+ keywords:
226
+ - MUST
227
+ - MUST NOT
228
+ - SHOULD
229
+ - SHOULD NOT
230
+ - MAY
231
+ rule: >-
232
+ Capitalized keywords carry protocol force. Lowercase modal verbs
233
+ (should, must, may) remain ordinary English with no protocol force.
234
+ Use capitalized keywords when stating hard requirements, strong
235
+ recommendations, or optional behavior. Use lowercase modals in
236
+ natural prose that does not bind the agent.
237
+ rationale: >-
238
+ Weak models read capability instructions literally as user commands.
239
+ Deliberate modal vocabulary disambiguates intent: a capitalized MUST
240
+ signals a hard constraint, while lowercase "should" in descriptive
241
+ prose does not bind. This is the disambiguator, not the offender.
242
+ example: >-
243
+ Steps SHOULD be ordered by value/effort ratio. Each matrix cell
244
+ MUST be ≤15 words. A concept MAY reference external sources.
145
245
 
146
246
  PRIMITIVE_REFERENCE_FIELDS:
147
247
  description: >-
@@ -172,41 +272,68 @@ PRIMITIVE_REFERENCE_FIELDS:
172
272
 
173
273
  ROUTE_ALIASES:
174
274
  description: >-
175
- Primary plain slash-route aliases from Decision 43. These aliases are exact
176
- `/agentera <alias>` routes for users; the Swedish -era capability directory
177
- names remain canonical protocol identity. Alias routes are not CLI commands.
275
+ Primary `/agentera <alias>` slash-route aliases for each capability.
276
+ English capability names are canonical protocol identity; the route alias
277
+ word is the canonical ID itself. Swedish -era names are legacy v2-stable
278
+ references, preserved for the v2 stable distribution and historical
279
+ artifacts (see legacy_aliases). Alias routes are not CLI commands.
178
280
  route_prefix: /agentera
179
281
  canonical_name_precedence: true
180
282
  cli_boundary: >-
181
283
  Slash routes and state commands are distinct: `/agentera plan` routes to
182
- planera, while `agentera plan` remains the state-oriented CLI command for
183
- reading plan state. Do not add non-hej capability or alias commands to the
184
- CLI.
284
+ the plan capability, while `agentera state plan list` remains the
285
+ state-oriented CLI command for reading plan state. Do not add capability or
286
+ alias commands to the CLI.
185
287
  primary_aliases:
186
288
  - alias: status
187
- capability: hej
289
+ capability: status
188
290
  - alias: vision
189
- capability: visionera
291
+ capability: vision
190
292
  - alias: discuss
191
- capability: resonera
293
+ capability: discuss
192
294
  - alias: research
193
- capability: inspirera
295
+ capability: research
194
296
  - alias: plan
195
- capability: planera
297
+ capability: plan
196
298
  - alias: build
197
- capability: realisera
299
+ capability: build
198
300
  - alias: optimize
199
- capability: optimera
301
+ capability: optimize
200
302
  - alias: audit
201
- capability: inspektera
303
+ capability: audit
202
304
  - alias: document
203
- capability: dokumentera
305
+ capability: document
204
306
  - alias: profile
205
- capability: profilera
307
+ capability: profile
206
308
  - alias: design
207
- capability: visualisera
309
+ capability: design
208
310
  - alias: orchestrate
209
- capability: orkestrera
311
+ capability: orchestrate
312
+ legacy_aliases:
313
+ - legacy: hej
314
+ canonical: status
315
+ - legacy: visionera
316
+ canonical: vision
317
+ - legacy: resonera
318
+ canonical: discuss
319
+ - legacy: inspirera
320
+ canonical: research
321
+ - legacy: planera
322
+ canonical: plan
323
+ - legacy: realisera
324
+ canonical: build
325
+ - legacy: optimera
326
+ canonical: optimize
327
+ - legacy: inspektera
328
+ canonical: audit
329
+ - legacy: dokumentera
330
+ canonical: document
331
+ - legacy: profilera
332
+ canonical: profile
333
+ - legacy: visualisera
334
+ canonical: design
335
+ - legacy: orkestrera
336
+ canonical: orchestrate
210
337
 
211
338
  # ---------------------------------------------------------------------------
212
339
  # The four required groups follow. The contract IS a valid capability schema,
@@ -282,9 +409,7 @@ ARTIFACTS:
282
409
  Behavioral instructions the agent reads. TypeScript module that exports
283
410
  a default-exported string constant. The runtime loads it via the
284
411
  compiled .js path and serves the prose through
285
- `agentera prime --context <name> --format json`. The Markdown
286
- `instructions.md` file is no longer part of the on-disk capability
287
- surface (D65).
412
+ `npx -y agentera@next prime --context <name> --format json`.
288
413
  produces: false
289
414
  consumes: true
290
415
  4:
@@ -365,6 +490,25 @@ VALIDATION:
365
490
  - "Contract file contains all required groups"
366
491
  - "Contract file entries follow entry schema structure"
367
492
  - "Contract file passes deprecation consistency check"
493
+ 7:
494
+ id: V7
495
+ rule: trigger_enrichment_fields
496
+ description: >-
497
+ Trigger entries MAY carry the optional intent-documentation fields
498
+ defined in TRIGGER_ENRICHMENT. Enrichment is opt-in per entry;
499
+ triggers omitting every enriched field remain valid. patterns,
500
+ confidence_threshold, borderline_band, and patterns_regex are legacy
501
+ compatibility fields only; disambiguates_against is consumed by the
502
+ LLM host at runtime. Validating an entry with enriched fields fails
503
+ when the rules below are violated.
504
+ severity: error
505
+ checks:
506
+ - "patterns, when present, is a list of strings"
507
+ - "confidence_threshold, when present, is an integer in 0..100"
508
+ - "borderline_band, when present, is an integer in 0..100"
509
+ - "patterns_regex entries are strings that compile as regular expressions"
510
+ - "disambiguates_against entries are mappings with a non-empty hint"
511
+ - "disambiguates_against.capability is one of the twelve canonical capability IDs"
368
512
 
369
513
  EXIT_CONDITIONS:
370
514
  1:
@@ -378,8 +522,8 @@ EXIT_CONDITIONS:
378
522
  id: E2
379
523
  condition: invalid_structure
380
524
  description: >-
381
- Directory structure validation failed. Missing instructions.md, schemas/
382
- directory, or YAML files.
525
+ Directory structure validation failed. Missing instruction module,
526
+ schemas/ directory, or YAML files.
383
527
  exit_code: 1
384
528
  3:
385
529
  id: E3
@@ -59,18 +59,18 @@
59
59
  # Structural: inline separator (·) → VISUAL_TOKENS.16 (VT16)
60
60
  # Structural: flow/target (→) → VISUAL_TOKENS.17 (VT17)
61
61
  # Structural: progress bar (█▓░) → VISUAL_TOKENS.18 (VT18)
62
- # Skill glyph: hej (⌂) → SKILL_GLYPHS.1 (SG1)
63
- # Skill glyph: realisera (⧉) → SKILL_GLYPHS.2 (SG2)
64
- # Skill glyph: inspektera (⛶) → SKILL_GLYPHS.3 (SG3)
65
- # Skill glyph: resonera (❈) → SKILL_GLYPHS.4 (SG4)
66
- # Skill glyph: planera (≡) → SKILL_GLYPHS.5 (SG5)
67
- # Skill glyph: visionera (⛥) → SKILL_GLYPHS.6 (SG6)
68
- # Skill glyph: optimera (⎘) → SKILL_GLYPHS.7 (SG7)
69
- # Skill glyph: dokumentera (▤) → SKILL_GLYPHS.8 (SG8)
70
- # Skill glyph: profilera (♾) → SKILL_GLYPHS.9 (SG9)
71
- # Skill glyph: inspirera (⬚) → SKILL_GLYPHS.10 (SG10)
72
- # Skill glyph: visualisera (◰) → SKILL_GLYPHS.11 (SG11)
73
- # Skill glyph: orkestrera (⎈) → SKILL_GLYPHS.12 (SG12)
62
+ # Skill glyph: status (⌂) → SKILL_GLYPHS.1 (SG1)
63
+ # Skill glyph: build (⧉) → SKILL_GLYPHS.2 (SG2)
64
+ # Skill glyph: audit (⛶) → SKILL_GLYPHS.3 (SG3)
65
+ # Skill glyph: discuss (❈) → SKILL_GLYPHS.4 (SG4)
66
+ # Skill glyph: plan (≡) → SKILL_GLYPHS.5 (SG5)
67
+ # Skill glyph: vision (⛥) → SKILL_GLYPHS.6 (SG6)
68
+ # Skill glyph: optimize (⎘) → SKILL_GLYPHS.7 (SG7)
69
+ # Skill glyph: document (▤) → SKILL_GLYPHS.8 (SG8)
70
+ # Skill glyph: profile (♾) → SKILL_GLYPHS.9 (SG9)
71
+ # Skill glyph: research (⬚) → SKILL_GLYPHS.10 (SG10)
72
+ # Skill glyph: design (◰) → SKILL_GLYPHS.11 (SG11)
73
+ # Skill glyph: orchestrate (⎈) → SKILL_GLYPHS.12 (SG12)
74
74
  #
75
75
  # SPEC Section 18 (Phase Tracking):
76
76
  # Phase: envision → PHASES.1 (PH1)
@@ -349,73 +349,73 @@ VISUAL_TOKENS:
349
349
  SKILL_GLYPHS:
350
350
  1:
351
351
  id: SG1
352
- capability: hej
352
+ capability: status
353
353
  glyph: "\u2302"
354
354
  glyph_code: U+2302
355
355
  meaning: "home base"
356
356
  2:
357
357
  id: SG2
358
- capability: realisera
358
+ capability: build
359
359
  glyph: "\u29C9"
360
360
  glyph_code: U+29C9
361
361
  meaning: "joined building blocks"
362
362
  3:
363
363
  id: SG3
364
- capability: inspektera
364
+ capability: audit
365
365
  glyph: "\u26F6"
366
366
  glyph_code: U+26F6
367
367
  meaning: "viewfinder frame"
368
368
  4:
369
369
  id: SG4
370
- capability: resonera
370
+ capability: discuss
371
371
  glyph: "\u2748"
372
372
  glyph_code: U+2748
373
373
  meaning: "spark of insight"
374
374
  5:
375
375
  id: SG5
376
- capability: planera
376
+ capability: plan
377
377
  glyph: "\u2261"
378
378
  glyph_code: U+2261
379
379
  meaning: "structured layers"
380
380
  6:
381
381
  id: SG6
382
- capability: visionera
382
+ capability: vision
383
383
  glyph: "\u26E5"
384
384
  glyph_code: U+26E5
385
385
  meaning: "guiding star"
386
386
  7:
387
387
  id: SG7
388
- capability: optimera
388
+ capability: optimize
389
389
  glyph: "\u2398"
390
390
  glyph_code: U+2398
391
391
  meaning: "measurement"
392
392
  8:
393
393
  id: SG8
394
- capability: dokumentera
394
+ capability: document
395
395
  glyph: "\u25A4"
396
396
  glyph_code: U+25A4
397
397
  meaning: "text on page"
398
398
  9:
399
399
  id: SG9
400
- capability: profilera
400
+ capability: profile
401
401
  glyph: "\u267E"
402
402
  glyph_code: U+267E
403
403
  meaning: "permanent mark"
404
404
  10:
405
405
  id: SG10
406
- capability: inspirera
406
+ capability: research
407
407
  glyph: "\u2B1A"
408
408
  glyph_code: U+2B1A
409
409
  meaning: "frame to fill"
410
410
  11:
411
411
  id: SG11
412
- capability: visualisera
412
+ capability: design
413
413
  glyph: "\u25F0"
414
414
  glyph_code: U+25F0
415
415
  meaning: "design grid"
416
416
  12:
417
417
  id: SG12
418
- capability: orkestrera
418
+ capability: orchestrate
419
419
  glyph: "\u2388"
420
420
  glyph_code: U+2388
421
421
  meaning: "helm, steering"
@@ -424,7 +424,7 @@ PHASES:
424
424
  1:
425
425
  id: PH1
426
426
  value: envision
427
- capabilities: [visionera]
427
+ capabilities: [vision]
428
428
  purpose: "Define or refine the project's north star"
429
429
  valid_successors: [deliberate, plan, build]
430
430
  terminal: false
@@ -432,15 +432,15 @@ PHASES:
432
432
  2:
433
433
  id: PH2
434
434
  value: deliberate
435
- capabilities: [resonera]
436
- purpose: "Reason through decisions before committing to a direction"
435
+ capabilities: [discuss, research]
436
+ purpose: "Reason through decisions or external evidence before committing to a direction"
437
437
  valid_successors: [plan, build, envision]
438
438
  terminal: false
439
439
  self_transition: false
440
440
  3:
441
441
  id: PH3
442
442
  value: plan
443
- capabilities: [planera]
443
+ capabilities: [plan]
444
444
  purpose: "Structure work into tasks with dependencies and acceptance criteria"
445
445
  valid_successors: [build, deliberate]
446
446
  terminal: false
@@ -448,15 +448,15 @@ PHASES:
448
448
  4:
449
449
  id: PH4
450
450
  value: build
451
- capabilities: [realisera, optimera, dokumentera, visualisera]
452
- purpose: "Implement, optimize, document, or design"
451
+ capabilities: [build, optimize, document, profile, design]
452
+ purpose: "Implement, optimize, document, profile, or design"
453
453
  valid_successors: [build, audit, plan]
454
454
  terminal: true
455
455
  self_transition: true
456
456
  5:
457
457
  id: PH5
458
458
  value: audit
459
- capabilities: [inspektera]
459
+ capabilities: [audit]
460
460
  purpose: "Evaluate structural health and alignment"
461
461
  valid_successors: [build, plan, deliberate, envision]
462
462
  terminal: true
@@ -0,0 +1,81 @@
1
+ schema_version: agentera.route_phrase_registry.v1
2
+ status: active_authority
3
+ purpose: >-
4
+ Own the small, explicit inventory of deterministic leading phrases. Trigger
5
+ schemas remain semantic intent documentation and are not a phrase source.
6
+ normalization: references/cli/hybrid-route-contract.yaml#phrase_matching
7
+ rules:
8
+ stable_ids: Phrase IDs are permanent and never reassigned.
9
+ active_matching: Only entries with status active are eligible for matching.
10
+ global_collisions: >-
11
+ Normalized phrases must be unique across active and deprecated entries; a
12
+ collision is a validation error, never a precedence decision.
13
+ direct_route_collisions: >-
14
+ A phrase cannot duplicate or begin with a canonical capability name or a
15
+ primary alias under the direct-route grammar.
16
+ deprecation: >-
17
+ Remove no entry. Mark it deprecated, retain its ID and phrase, and set
18
+ replaced_by to an active registry ID. Deprecated phrases abstain.
19
+ prohibited_sources: [legacy_patterns, regexes, thresholds, bands, trigger_descriptions]
20
+
21
+ phrases:
22
+ - id: RP_STATUS_PROJECT_BRIEFING
23
+ capability: status
24
+ phrase: show project briefing
25
+ status: active
26
+ evidence: [DEV-PHRASE-STATUS]
27
+ - id: RP_VISION_PRODUCT_DIRECTION
28
+ capability: vision
29
+ phrase: define product direction
30
+ status: active
31
+ evidence: [DEV-PHRASE-VISION]
32
+ - id: RP_DISCUSS_DECISION
33
+ capability: discuss
34
+ phrase: help me decide
35
+ status: active
36
+ evidence: [DEV-PHRASE-DISCUSS]
37
+ - id: RP_RESEARCH_EXTERNAL_PATTERNS
38
+ capability: research
39
+ phrase: study external patterns
40
+ status: active
41
+ evidence: [DEV-PHRASE-RESEARCH]
42
+ - id: RP_PLAN_IMPLEMENTATION
43
+ capability: plan
44
+ phrase: make an implementation plan
45
+ status: active
46
+ evidence: [DEV-PHRASE-PLAN]
47
+ - id: RP_BUILD_APPROVED_PLAN
48
+ capability: build
49
+ phrase: implement the approved plan
50
+ status: active
51
+ evidence: [DEV-PHRASE-BUILD]
52
+ - id: RP_OPTIMIZE_BOTTLENECK
53
+ capability: optimize
54
+ phrase: improve a measured bottleneck
55
+ status: active
56
+ evidence: [DEV-PHRASE-OPTIMIZE]
57
+ - id: RP_AUDIT_CODEBASE_HEALTH
58
+ capability: audit
59
+ phrase: check codebase health
60
+ status: active
61
+ evidence: [DEV-PHRASE-AUDIT]
62
+ - id: RP_DOCUMENT_PROJECT
63
+ capability: document
64
+ phrase: refresh project documentation
65
+ status: active
66
+ evidence: [DEV-PHRASE-DOCUMENT]
67
+ - id: RP_PROFILE_DECISION
68
+ capability: profile
69
+ phrase: save a decision profile
70
+ status: active
71
+ evidence: [DEV-PHRASE-PROFILE]
72
+ - id: RP_DESIGN_INTERFACE
73
+ capability: design
74
+ phrase: shape the interface
75
+ status: active
76
+ evidence: [DEV-PHRASE-DESIGN]
77
+ - id: RP_ORCHESTRATE_DELIVERY
78
+ capability: orchestrate
79
+ phrase: execute the approved plan
80
+ status: active
81
+ evidence: [DEV-PHRASE-ORCHESTRATE]
@@ -1,6 +1,6 @@
1
1
  # Changelog Artifact Schema
2
2
  #
3
- # Release history maintained by realisera. Tracks versioned releases with
3
+ # Release history maintained by build. Tracks versioned releases with
4
4
  # categorized changes (Added, Changed, Fixed, Removed).
5
5
  #
6
6
  # Note: CHANGELOG.md is a human-facing Markdown artifact. It remains at the
@@ -11,12 +11,12 @@ meta:
11
11
  name: changelog
12
12
  version: "1.0.0"
13
13
  description: >-
14
- Release history. Produced by realisera. Consumed by users and agents
14
+ Release history. Produced by build. Consumed by users and agents
15
15
  for version context. Human-facing: remains Markdown at project root.
16
16
  artifact_type: human_facing
17
17
  path: "CHANGELOG.md"
18
- producer: realisera
19
- consumers: [hej, all_skills]
18
+ producer: build
19
+ consumers: [status, all_skills]
20
20
  format: markdown
21
21
 
22
22
  GROUP_PREFIXES:
@@ -27,6 +27,7 @@ GROUP_PREFIXES:
27
27
  BUDGET:
28
28
  1:
29
29
  id: CB1
30
+ scope: full_file
30
31
  token_budget: 5000
31
32
  description: >-
32
33
  Maximum tokens for CHANGELOG.md content. Exceeding triggers compaction.
@@ -1,11 +1,12 @@
1
1
  # Decisions Artifact Schema
2
2
  #
3
- # Reasoning trail maintained by resonera. Each deliberation session appends
4
- # one entry. Decisions are referenced by realisera, optimera, and profilera
3
+ # Reasoning trail maintained by discuss. Each deliberation session appends
4
+ # one entry. Decisions are referenced by build, optimize, and profile
5
5
  # for context on why choices were made.
6
6
  #
7
- # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
8
- # following capability_schema_contract.yaml and protocol.yaml conventions.
7
+ # The active authority uses writer-owned decision, revision, and satisfaction
8
+ # entity files. The numbered projection model below is retained only as an exact
9
+ # legacy migration input schema; it is not an ordinary post-cutover contract.
9
10
  #
10
11
  # ── Field-by-field mapping: v1 DECISIONS.md → v2 decisions.yaml ──
11
12
  #
@@ -32,16 +33,28 @@ meta:
32
33
  name: decisions
33
34
  version: "1.0.0"
34
35
  description: >-
35
- Reasoning trail maintained by resonera. Each deliberation session
36
- appends one entry. Decisions are referenced by realisera, optimera,
37
- profilera, planera, inspektera, hej, dokumentera, visionera, resonera,
38
- and orkestrera for context on why choices were made.
36
+ Reasoning trail maintained by discuss. Each deliberation session
37
+ appends one entry. Decisions are referenced by build, optimize,
38
+ profile, plan, audit, status, document, vision, discuss,
39
+ and orchestrate for context on why choices were made.
39
40
  artifact_type: agent_facing
40
41
  path: ".agentera/decisions.yaml"
41
- producer: resonera
42
- consumers: [dokumentera, hej, inspektera, optimera, orkestrera, planera, profilera, realisera, resonera, visionera]
42
+ authority: legacy_migration_input_only
43
+ producer: discuss
44
+ consumers: [document, status, audit, optimize, orchestrate, plan, profile, build, discuss, vision]
43
45
  format: yaml
44
46
 
47
+ ENTITY_AUTHORITY:
48
+ identity_fields: [id, artifact]
49
+ artifact: decisions
50
+ boundaries: [decision, decision_revision, decision_satisfaction]
51
+ retrieval:
52
+ list: npx -y agentera@next state decisions list --format json
53
+ get: npx -y agentera@next state decisions get --id ID --format json
54
+ mutation: npx -y agentera@next state decisions explain --format json
55
+ direct_file_edits: forbidden
56
+ legacy_schema_below: migration_input_only
57
+
45
58
  GROUP_PREFIXES:
46
59
  BUDGET: DB
47
60
  COMPACTION: DX
@@ -69,10 +82,10 @@ BUDGET:
69
82
  COMPACTION:
70
83
  1:
71
84
  id: DX1
72
- rule: uniform_10_40_50
85
+ rule: lossless_projection
73
86
  description: >-
74
- Growing artifacts follow a uniform 10/40/50 rule: 10 full-detail
75
- entries, 40 one-line archive entries, drop beyond 50 total.
87
+ The 10/40/50 values are current projection defaults, not deletion limits.
88
+ Numbered archive records remain complete and unlimited.
76
89
  2:
77
90
  id: DX2
78
91
  full_detail:
@@ -93,21 +106,26 @@ COMPACTION:
93
106
  the archive section. Compact summaries preserve decision number, date,
94
107
  and chosen alternative; structured compact fields preserve outcome and
95
108
  explicit feeds_into references when present so CLI downstream references
96
- remain non-inferential.
109
+ remain non-inferential. Entries beyond the summary default are represented
110
+ by omission metadata while their numbered archive records remain available.
97
111
  4:
98
112
  id: DX4
99
- dropped:
100
- threshold: 50
101
- action: "Removed entirely"
113
+ omission:
114
+ fields: [omitted, omitted_count, omission_reason, retrieval]
115
+ reason: projection_capacity_or_byte_budget
102
116
  description: >-
103
- Decisions older than 50 are dropped entirely.
117
+ Omitted projection detail is never silently deleted or truncated. The
118
+ numbered archive is the complete historical source and retrieval points
119
+ use the direct state get contract.
104
120
  5:
105
121
  id: DX5
106
- trigger: "When resonera writes a new decision"
122
+ trigger: "When discuss writes a new decision"
107
123
  description: >-
108
124
  Compaction runs when the producing skill writes a new entry.
109
- If >10 full-detail entries exist, collapse the oldest to one-line.
110
- If >40 one-line entries exist, drop the oldest.
125
+ If >10 full-detail entries exist and their numbered archives verify,
126
+ collapse the oldest to one-line. If >40 summary entries exist, omit the
127
+ oldest from this bounded projection with metadata; never delete its
128
+ numbered archive record. Unresolved review entries do not block storage.
111
129
  6:
112
130
  id: DX6
113
131
  archive_section: