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
@@ -1,69 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: vision
5
- local_role: consumes
6
- description: >-
7
- Hej reads this for the briefing's project context.
8
- 2:
9
- id: A2
10
- artifact_id: decisions
11
- local_role: consumes
12
- description: >-
13
- Hej reads this to identify unresolved decisions requiring follow-up.
14
- 3:
15
- id: A3
16
- artifact_id: plan
17
- local_role: consumes
18
- description: >-
19
- Hej reads this to identify the next executable task and plan progress.
20
- 4:
21
- id: A4
22
- artifact_id: progress
23
- local_role: consumes
24
- description: >-
25
- Hej reads this for the briefing's "what shipped" context.
26
- 5:
27
- id: A5
28
- artifact_id: todo
29
- local_role: consumes
30
- description: >-
31
- Hej reads this to identify high-severity open items for routing.
32
- 6:
33
- id: A6
34
- artifact_id: health
35
- local_role: consumes
36
- description: >-
37
- Hej reads this for the health status line and attention items.
38
- 7:
39
- id: A7
40
- artifact_id: objective
41
- local_role: consumes
42
- description: >-
43
- Hej reads this to check for active optimization objectives.
44
- 8:
45
- id: A8
46
- artifact_id: experiments
47
- local_role: consumes
48
- description: >-
49
- Hej reads this alongside the active optimization target to determine
50
- optimization status.
51
- 9:
52
- id: A9
53
- artifact_id: docs
54
- local_role: consumes
55
- description: >-
56
- Hej reads this first to resolve project-local artifact mappings before
57
- reading other artifacts.
58
- 10:
59
- id: A10
60
- artifact_id: design
61
- local_role: consumes
62
- description: >-
63
- Hej reads this for the briefing's design status.
64
- 11:
65
- id: A11
66
- artifact_id: profile
67
- local_role: consumes
68
- description: >-
69
- Hej reads this to report profile status (loaded/not found) in the briefing.
@@ -1,58 +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 hej.
7
- priority: high
8
- patterns:
9
- - "hej"
10
- - "/hej"
11
- 2:
12
- id: T2
13
- description: >-
14
- Greetings and session-start signals. Matches casual greetings or
15
- explicit session start requests.
16
- priority: medium
17
- patterns:
18
- - "hello"
19
- - "hi"
20
- - "start"
21
- - "begin"
22
- - "getting started"
23
- - "onboard me"
24
- 3:
25
- id: T3
26
- description: >-
27
- Status and orientation requests. Matches when the user wants to know
28
- the current state of the project or get a briefing.
29
- priority: medium
30
- patterns:
31
- - "status"
32
- - "dashboard"
33
- - "pulse"
34
- - "brief"
35
- - "brief me"
36
- - "update me"
37
- - "what needs attention"
38
- 4:
39
- id: T4
40
- description: >-
41
- Returning-to-project signals. Matches when the user resumes work
42
- on a known project and wants to pick up where they left off.
43
- priority: medium
44
- patterns:
45
- - "where were we"
46
- - "catch me up"
47
- - "what should I work on"
48
- - "what's next"
49
- 5:
50
- id: T5
51
- description: >-
52
- Fallback. Hej is the default capability when no other capability's
53
- trigger patterns match. This entry documents the fallback behavior
54
- defined in the routing layer routing logic.
55
- patterns:
56
- - "*"
57
- fallback: true
58
- priority: low
@@ -1,76 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: health
5
- local_role: produces_and_consumes
6
- description: >-
7
- Codebase health assessment with findings, dimension grades, and trajectory.
8
- Inspektera writes audit entries with per-dimension grades, findings with
9
- severity and confidence scores, trend comparisons, and de facto
10
- architecture patterns. During evaluation startup, Inspektera consumes health
11
- state through CLI `evidence_context` before raw health artifact fallback.
12
- 2:
13
- id: A2
14
- artifact_id: vision
15
- local_role: consumes
16
- description: >-
17
- Inspektera treats vision state as protected during evidence-context startup;
18
- missing or not-checked vision caveats from CLI `evidence_context` are preserved
19
- instead of forcing a raw vision read.
20
- 3:
21
- id: A3
22
- artifact_id: decisions
23
- local_role: consumes
24
- description: >-
25
- Inspektera consumes decision caveats through CLI `evidence_context` and the
26
- listed `agentera decisions --format json` fallback before raw decisions artifact fallback.
27
- Compacted decision caveats must be preserved rather than reconstructed.
28
- 4:
29
- id: A4
30
- artifact_id: todo
31
- local_role: produces_and_consumes
32
- description: >-
33
- Inspektera reads this to avoid re-reporting known issues and writes to it
34
- with user confirmation when filing
35
- critical and warning findings. During evaluation startup, known TODO state is
36
- consumed through CLI `evidence_context` before raw TODO artifact fallback.
37
- 5:
38
- id: A5
39
- artifact_id: progress
40
- local_role: consumes
41
- description: >-
42
- Inspektera consumes latest progress verification and progress caveats through
43
- CLI `evidence_context` before raw progress artifact fallback.
44
- 6:
45
- id: A6
46
- artifact_id: plan
47
- local_role: consumes
48
- description: >-
49
- Inspektera consumes evaluation target and plan criteria through CLI
50
- `evidence_context` before raw plan artifact fallback. The plan's Created date
51
- still provides the artifact-current-state baseline when that state is needed.
52
- 7:
53
- id: A7
54
- artifact_id: design
55
- local_role: consumes
56
- description: >-
57
- Inspektera treats design state as optional during evidence-context startup;
58
- missing design caveats from CLI `evidence_context` are preserved before any raw
59
- design artifact fallback.
60
- 8:
61
- id: A8
62
- artifact_id: docs
63
- local_role: consumes
64
- description: >-
65
- Inspektera reads this first to resolve project-local artifact mappings
66
- and checks the versioning convention for the version health dimension. During
67
- evaluation startup, docs state and version-boundary caveats are consumed through
68
- CLI `evidence_context` before raw docs artifact fallback.
69
- 9:
70
- id: A9
71
- artifact_id: profile
72
- local_role: consumes
73
- description: >-
74
- Inspektera consumes profile status and stale-profile caveats through CLI
75
- `evidence_context`; stale or missing profile state is preserved as a caveat and
76
- is not approval to refresh profile state or read profile directly during startup.
@@ -1,38 +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 inspektera.
7
- priority: high
8
- patterns:
9
- - "inspektera"
10
- - "/inspektera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Audit and codebase health requests. Matches when the user wants to
15
- assess codebase health, architecture quality, or structural integrity.
16
- priority: medium
17
- patterns:
18
- - "audit the codebase"
19
- - "check code health"
20
- - "architecture review"
21
- - "find technical debt"
22
- - "assess code quality"
23
- - "how healthy is this codebase"
24
- - "what needs fixing"
25
- - "structural review"
26
- - "pattern audit"
27
- - "dependency check"
28
- - "test coverage audit"
29
- 3:
30
- id: T3
31
- description: >-
32
- Implicit trigger after extended realisera activity. Matches when
33
- realisera has run 5+ cycles without a health check and the system
34
- detects an overdue audit.
35
- priority: medium
36
- patterns:
37
- - "health check overdue"
38
- - "audit after realisera"
@@ -1,24 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: todo
5
- local_role: produces
6
- description: >-
7
- Open problems by severity. Inspirera writes actionable findings here
8
- (with user confirmation), classifying each by severity per protocol
9
- SF1-SF3. Realisera picks up changes automatically in its next cycle.
10
- 2:
11
- id: A2
12
- artifact_id: vision
13
- local_role: produces
14
- description: >-
15
- Inspirera may refine project direction with user confirmation when the
16
- analysis shifts thinking about the project's direction.
17
- 3:
18
- id: A3
19
- artifact_id: profile
20
- local_role: consumes
21
- description: >-
22
- Inspirera reads this via the effective profile script to weight
23
- applicability judgments. If missing, inspirera proceeds without persona
24
- grounding.
@@ -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 inspirera.
7
- priority: high
8
- patterns:
9
- - "inspirera"
10
- - "/inspirera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Applicability assessment requests. Matches when the user provides
15
- an external URL and asks how it applies to their project or whether
16
- they should adopt it.
17
- priority: medium
18
- patterns:
19
- - "could I use this in"
20
- - "how does this apply to my project"
21
- - "is this relevant to"
22
- - "what can I take from this"
23
- - "should I adopt"
24
- 3:
25
- id: T3
26
- description: >-
27
- External resource review requests. Matches when the user wants
28
- analysis of a library, repo, or approach for ideas and patterns.
29
- priority: medium
30
- patterns:
31
- - "what do you think of this library"
32
- - "review this repo for ideas"
33
- - "anything worth stealing from"
34
- - "how does this compare to what I'm doing"
@@ -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 optimera.
7
- priority: high
8
- patterns:
9
- - "optimera"
10
- - "/optimera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Metric-driven optimization requests. Matches when the user wants to
15
- improve a concrete, quantifiable property of their codebase.
16
- priority: medium
17
- patterns:
18
- - "optimize"
19
- - "improve performance"
20
- - "reduce latency"
21
- - "increase test coverage"
22
- - "lower bundle size"
23
- - "speed up"
24
- - "make faster"
25
- - "make smaller"
26
- - "get the score up"
27
- - "hit the target"
28
- - "improve the metric"
29
- 3:
30
- id: T3
31
- description: >-
32
- Iterative experimentation requests. Matches when the user wants to
33
- run experiments, benchmark, or iterate on a measurable objective.
34
- priority: medium
35
- patterns:
36
- - "benchmark and iterate"
37
- - "run experiments"
38
- - "tune"
39
- - "experiment until"
@@ -1,64 +0,0 @@
1
- ARTIFACTS:
2
- 1:
3
- id: A1
4
- artifact_id: plan
5
- local_role: produces_and_consumes
6
- description: >-
7
- Orkestrera consumes plan task queue state through
8
- `agentera prime --context orkestrera --format json` before raw
9
- artifact access, then updates status (pending -> complete/blocked) only
10
- when resolving a task.
11
- 2:
12
- id: A2
13
- artifact_id: progress
14
- local_role: consumes
15
- description: >-
16
- Orkestrera consumes progress verification state from the returned
17
- orchestration context first, then routine CLI fallback output before any
18
- last-resort raw artifact read for the Step 3 presence check.
19
- 3:
20
- id: A3
21
- artifact_id: health
22
- local_role: consumes
23
- description: >-
24
- Orkestrera consumes returned health state first after plan completion to
25
- decide whether to start a new plan cycle; raw reads are last-resort after
26
- listed CLI fallbacks.
27
- 4:
28
- id: A4
29
- artifact_id: todo
30
- local_role: produces
31
- description: >-
32
- Orkestrera consumes TODO caveats from CLI startup context and writes
33
- blocked task logging only when a task exhausts its retry budget.
34
- 5:
35
- id: A5
36
- artifact_id: decisions
37
- local_role: consumes
38
- description: >-
39
- Orkestrera consumes included decision context or the listed
40
- `agentera decisions --format json` fallback before raw access, preserving
41
- firm constraints, exploratory uncertainties, and compacted-entry caveats.
42
- 6:
43
- id: A6
44
- artifact_id: vision
45
- local_role: consumes
46
- description: >-
47
- Orkestrera consumes returned vision state or missing-state caveats during
48
- bootstrap when chaining inspirera for vision-gap analysis.
49
- 7:
50
- id: A7
51
- artifact_id: profile
52
- local_role: consumes
53
- description: >-
54
- Orkestrera consumes returned profile status and caveats first for persona
55
- context. If missing or stale, it proceeds without refreshing profile
56
- state and preserves the caveat.
57
- 8:
58
- id: A8
59
- artifact_id: docs
60
- local_role: consumes
61
- description: >-
62
- Orkestrera uses docs mapping from CLI startup context first to resolve
63
- project-local artifact mappings before any last-resort raw artifact read
64
- or artifact write.
@@ -1,42 +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 orkestrera.
7
- priority: high
8
- patterns:
9
- - "orkestrera"
10
- - "/orkestrera"
11
- 2:
12
- id: T2
13
- description: >-
14
- Multi-cycle execution signals. Matches when the user wants to execute
15
- an entire plan autonomously or run tasks through evaluation gating.
16
- priority: medium
17
- patterns:
18
- - "run the plan"
19
- - "execute the plan"
20
- - "run all tasks"
21
- - "keep going until done"
22
- - "run through the plan"
23
- - "build everything"
24
- 3:
25
- id: T3
26
- description: >-
27
- Orchestration and delegation signals. Matches when the user wants to
28
- chain multiple capabilities, delegate work, or coordinate multi-step
29
- execution.
30
- priority: medium
31
- patterns:
32
- - "orchestrate"
33
- - "orchestrate skills"
34
- - "multi-cycle"
35
- 4:
36
- id: T4
37
- description: >-
38
- Autonomous plan execution signals. Matches when the user wants
39
- evaluated, plan-driven development without manual intervention.
40
- priority: medium
41
- patterns:
42
- - "autonomous plan execution"
@@ -1,120 +0,0 @@
1
- VALIDATION:
2
- 1:
3
- id: V1
4
- rule: never_read_source
5
- description: >-
6
- Orkestrera MUST NEVER read implementation source code. It dispatches
7
- capabilities; it does not implement. Artifact files (PLAN.md, HEALTH.md,
8
- DECISIONS.md, PROGRESS.md, etc.) are not source code and are expected
9
- to be read. This rule verifies the prose explicitly states the
10
- source-code read prohibition.
11
- severity: critical
12
- checks:
13
- - "orkestrera prose (packages/cli/src/capabilities/orkestrera/instructions.ts) contains NEVER read implementation source code"
14
- 2:
15
- id: V2
16
- rule: evaluation_gate_required
17
- description: >-
18
- Every completed task MUST be verified by inspektera before being marked
19
- complete. The orchestrator MUST NOT skip evaluation. This rule verifies
20
- the prose contains the never-skip-evaluation safety rail.
21
- severity: critical
22
- checks:
23
- - "orkestrera prose contains NEVER skip evaluation"
24
- 3:
25
- id: V3
26
- rule: retry_budget_enforced
27
- description: >-
28
- No task may be retried more than 2 times. After the second failure,
29
- the task must be marked blocked. This rule verifies the retry budget
30
- is stated in the prose and safety rails.
31
- severity: critical
32
- checks:
33
- - "orkestrera prose contains retry budget of 2"
34
- 4:
35
- id: V4
36
- rule: exit_marker_required
37
- description: >-
38
- Every orkestrera invocation MUST emit an exit marker. The marker uses
39
- the canonical glyph ⎈ (SG12) in the format ⎈ orkestrera · <status>
40
- where status is one of EX1-EX4.
41
- severity: critical
42
- checks:
43
- - "orkestrera prose contains exit marker with glyph ⎈ (SG12)"
44
- - "orkestrera prose references exit signals EX1-EX4"
45
- 5:
46
- id: V5
47
- rule: orchestrator_read_only_artifacts
48
- description: >-
49
- The orchestrator reads artifacts and updates PLAN.md task statuses and
50
- TODO.md blocked entries. It does NOT write to PROGRESS.md, CHANGELOG.md,
51
- or any other capability-owned artifact. This rule verifies the
52
- artifacts schema reflects this constraint.
53
- severity: warning
54
- checks:
55
- - "PROGRESS.md is consumes only (not produces)"
56
- - "HEALTH.md is consumes only (not produces)"
57
- - "DECISIONS.md is consumes only (not produces)"
58
- - "VISION.md is consumes only (not produces)"
59
- 6:
60
- id: V6
61
- rule: orchestration_context_first
62
- description: >-
63
- Orkestrera startup and evaluation MUST use
64
- `agentera prime --context orkestrera --format json` and the
65
- returned orchestration context before raw plan, progress, health, TODO,
66
- or decisions artifact reads.
67
- severity: critical
68
- checks:
69
- - "orkestrera prose contains agentera prime --context orkestrera --format json"
70
- - "orkestrera prose contains Use the returned `orchestration_context` before raw plan, progress, health, TODO, or decisions artifacts"
71
- - "orkestrera prose contains If `source_contract.complete_for_orchestration_context` is true, do not read raw plan, progress, health, TODO, or decisions artifacts"
72
- 7:
73
- id: V7
74
- rule: cli_fallback_before_raw_read
75
- description: >-
76
- When orchestration context is incomplete, Orkestrera MUST run listed
77
- routine CLI fallback commands before any last-resort raw artifact read.
78
- severity: critical
79
- checks:
80
- - "orkestrera prose contains run the listed routine CLI fallback commands"
81
- - "orkestrera prose contains Read a raw artifact only as a last-resort diagnostic"
82
- 8:
83
- id: V8
84
- rule: caveats_preserved_for_evaluation
85
- description: >-
86
- Orkestrera MUST preserve compacted-decision, stale health/profile/app,
87
- missing-state, and retry-state provenance caveats when handing a task to
88
- inspektera.
89
- severity: critical
90
- checks:
91
- - "orkestrera prose contains compacted decision caveats"
92
- - "orkestrera prose contains stale health/profile/app caveats"
93
- - "orkestrera prose contains retry-state provenance"
94
- 9:
95
- id: V9
96
- rule: satisfaction_authority_boundary
97
- description: >-
98
- When Orkestrera touches decision satisfaction, it may pass through or request
99
- provisional satisfaction with evidence but MUST NOT user-confirm satisfaction.
100
- Missing, compacted, open, provisional, or review-needed satisfaction state
101
- remains a caveat and review pressure; automation must not reconstruct hidden
102
- outcomes or claim it proved user intent.
103
- severity: critical
104
- checks:
105
- - "Provisional satisfaction requires evidence"
106
- - "Only the user confirms final satisfaction"
107
- - "Missing or compacted satisfaction caveats are preserved"
108
- 10:
109
- id: V10
110
- rule: inspektera_citation_required
111
- description: >-
112
- Orkestrera Step 3 Surface 2 inspektera delegation MUST require a
113
- citation: <file>:<line> (or not-applicable: <reason>) for every WARN and
114
- FAIL finding, and require verify_command for WARN rows with file:line
115
- citations. Authority: references/cli/capability-instruction-contract.yaml#evaluator_handoff.
116
- severity: critical
117
- checks:
118
- - "orkestrera prose contains citation: `<file>:<line>` OR `not-applicable: <reason>`"
119
- - "orkestrera prose contains verify_command"
120
- - "orkestrera prose contains evaluator_handoff.output_requirements"
@@ -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"