agentera 3.0.0-dev.8 → 3.0.0-dev.80

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 (724) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +252 -22
  3. package/bundle/.agentera-build-source.json +8 -0
  4. package/bundle/CHANGELOG.md +1387 -0
  5. package/bundle/DESIGN.md +229 -0
  6. package/bundle/LICENSE +201 -0
  7. package/bundle/README.md +143 -0
  8. package/bundle/UPGRADE.md +271 -0
  9. package/bundle/extract-corpus-parity.json +2 -4
  10. package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
  11. package/bundle/references/adapters/package-publication.json +484 -0
  12. package/bundle/references/adapters/package-registry.yaml +443 -188
  13. package/bundle/references/adapters/package-surface-characterization.md +68 -34
  14. package/bundle/references/adapters/product-v1-reset.yaml +101 -0
  15. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
  16. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
  17. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
  18. package/bundle/references/adapters/runtime-retired-resources.yaml +333 -0
  19. package/bundle/references/analysis/evidence-tier-authority.yaml +559 -0
  20. package/bundle/references/analysis/personal-glossary-evaluation-authority.yaml +175 -0
  21. package/bundle/references/analysis/personal-glossary-evaluation-corpus.yaml +291 -0
  22. package/bundle/references/analysis/personal-glossary-holdout.yaml +192 -0
  23. package/bundle/references/analysis/verification-policy.yaml +261 -0
  24. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +17 -8
  25. package/bundle/references/artifacts/glossary-entry-contract.yaml +2906 -0
  26. package/bundle/references/artifacts/state-storage-authority.yaml +3065 -0
  27. package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
  28. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +3 -4
  29. package/bundle/references/cli/capability-instruction-contract.yaml +11 -14
  30. package/bundle/references/cli/hybrid-route-contract.yaml +438 -0
  31. package/bundle/references/cli/routing-model.md +152 -93
  32. package/bundle/references/cli/trigger-schema-enrichment.md +57 -46
  33. package/bundle/references/cli/update-channels.yaml +7 -5
  34. package/bundle/references/cli/vocabulary-index.yaml +7 -9
  35. package/bundle/references/cli/vocabulary.md +54 -97
  36. package/bundle/references/meta/retained-reference-authority.yaml +171 -0
  37. package/bundle/skills/agentera/SKILL.md +183 -63
  38. package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +27 -19
  39. package/bundle/skills/agentera/capabilities/audit/schemas/exit.yaml +2 -2
  40. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +13 -35
  41. package/bundle/skills/agentera/capabilities/audit/schemas/validation.yaml +30 -11
  42. package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +44 -21
  43. package/bundle/skills/agentera/capabilities/build/schemas/exit.yaml +8 -6
  44. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +14 -36
  45. package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +95 -21
  46. package/bundle/skills/agentera/capabilities/design/schemas/artifacts.yaml +6 -6
  47. package/bundle/skills/agentera/capabilities/design/schemas/exit.yaml +5 -5
  48. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +5 -34
  49. package/bundle/skills/agentera/capabilities/design/schemas/validation.yaml +2 -2
  50. package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +17 -13
  51. package/bundle/skills/agentera/capabilities/discuss/schemas/exit.yaml +2 -2
  52. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +6 -40
  53. package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +72 -5
  54. package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +24 -17
  55. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +5 -35
  56. package/bundle/skills/agentera/capabilities/document/schemas/validation.yaml +13 -13
  57. package/bundle/skills/agentera/capabilities/optimize/schemas/artifacts.yaml +10 -10
  58. package/bundle/skills/agentera/capabilities/optimize/schemas/exit.yaml +2 -2
  59. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +4 -35
  60. package/bundle/skills/agentera/capabilities/optimize/schemas/validation.yaml +3 -3
  61. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +34 -22
  62. package/bundle/skills/agentera/capabilities/orchestrate/schemas/exit.yaml +9 -7
  63. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +5 -37
  64. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +38 -37
  65. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +20 -16
  66. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +8 -31
  67. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +66 -6
  68. package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +13 -4
  69. package/bundle/skills/agentera/capabilities/profile/schemas/exit.yaml +8 -5
  70. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +8 -37
  71. package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +67 -3
  72. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +6 -6
  73. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +5 -29
  74. package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +13 -12
  75. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +7 -49
  76. package/bundle/skills/agentera/capabilities/vision/schemas/artifacts.yaml +8 -8
  77. package/bundle/skills/agentera/capabilities/vision/schemas/exit.yaml +7 -6
  78. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +7 -39
  79. package/bundle/skills/agentera/capabilities/vision/schemas/validation.yaml +14 -16
  80. package/bundle/skills/agentera/capability_schema_contract.yaml +32 -32
  81. package/bundle/skills/agentera/protocol.yaml +4 -4
  82. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  83. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +1 -0
  84. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +29 -30
  85. package/bundle/skills/agentera/schemas/artifacts/design.yaml +1 -0
  86. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +7 -43
  87. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +140 -34
  88. package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +87 -0
  89. package/bundle/skills/agentera/schemas/artifacts/health.yaml +53 -51
  90. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +18 -35
  91. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +453 -55
  92. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +128 -39
  93. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +305 -7
  94. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +0 -19
  95. package/dist/.agentera-build-source.json +8 -0
  96. package/dist/analytics/extractCorpus/cli.js +52 -11
  97. package/dist/analytics/extractCorpus/copilotSessions.js +19 -8
  98. package/dist/analytics/extractCorpus/core.js +262 -14
  99. package/dist/analytics/extractCorpus/corpus.js +57 -18
  100. package/dist/analytics/extractCorpus/coverageAudit.js +44 -45
  101. package/dist/analytics/extractCorpus/cursorSessions.js +28 -8
  102. package/dist/analytics/extractCorpus/evidenceTiers.js +709 -0
  103. package/dist/analytics/extractCorpus/extractCorpusParity.js +4 -4
  104. package/dist/analytics/extractCorpus/filesystemSources.js +5 -5
  105. package/dist/analytics/extractCorpus/index.js +4 -2
  106. package/dist/analytics/extractCorpus/jsonlSessions.js +76 -8
  107. package/dist/analytics/extractCorpus/sqliteCaps.js +0 -1
  108. package/dist/analytics/extractCorpus/sqliteSessions.js +12 -4
  109. package/dist/analytics/extractCorpus/tierReader.js +108 -0
  110. package/dist/analytics/extractCorpus.js +0 -1
  111. package/dist/analytics/glossaryAdviceResolution.js +166 -0
  112. package/dist/analytics/glossaryInputAcquisition.js +319 -0
  113. package/dist/analytics/personalGlossaryAdmission.js +113 -0
  114. package/dist/analytics/personalGlossaryCandidateProjection.js +788 -0
  115. package/dist/analytics/personalGlossaryCandidateProjectionExcerpts.js +144 -0
  116. package/dist/analytics/personalGlossaryCandidateProjectionModel.js +1 -0
  117. package/dist/analytics/personalGlossaryCandidateReadView.js +23 -0
  118. package/dist/analytics/personalGlossaryCurrentGeneration.js +25 -0
  119. package/dist/analytics/personalGlossaryDecision.js +203 -0
  120. package/dist/analytics/personalGlossaryExplicit.js +788 -0
  121. package/dist/analytics/personalGlossaryExplicitMining.js +285 -0
  122. package/dist/analytics/personalGlossaryExplicitScope.js +41 -0
  123. package/dist/analytics/personalGlossaryExplicitSegments.js +418 -0
  124. package/dist/analytics/personalGlossaryExplicitTypes.js +26 -0
  125. package/dist/analytics/personalGlossaryLexicalClassifier.js +175 -0
  126. package/dist/analytics/personalGlossaryProfile.js +229 -0
  127. package/dist/analytics/personalGlossaryRecurrence.js +618 -0
  128. package/dist/analytics/personalGlossaryRefreshProjection.js +351 -0
  129. package/dist/analytics/personalGlossaryReviewRecordStorage.js +428 -0
  130. package/dist/analytics/personalGlossaryReviewRecords.js +332 -0
  131. package/dist/analytics/profileSignals.js +211 -0
  132. package/dist/analytics/usageStats.js +150 -23
  133. package/dist/audit/terminologyDrift.js +281 -0
  134. package/dist/bin/agentera.js +3 -2
  135. package/dist/capabilities/audit/instructions.js +16 -6
  136. package/dist/capabilities/build/instructions.js +59 -6
  137. package/dist/capabilities/design/instructions.js +3 -4
  138. package/dist/capabilities/discuss/instructions.js +29 -6
  139. package/dist/capabilities/document/instructions.js +11 -6
  140. package/dist/capabilities/index.js +20 -14
  141. package/dist/capabilities/optimize/instructions.js +14 -6
  142. package/dist/capabilities/orchestrate/instructions.js +42 -6
  143. package/dist/capabilities/plan/instructions.js +30 -3
  144. package/dist/capabilities/profile/instructions.js +104 -5
  145. package/dist/capabilities/research/instructions.js +4 -5
  146. package/dist/capabilities/status/instructions.js +15 -6
  147. package/dist/capabilities/status/startupInstructions.js +34 -0
  148. package/dist/capabilities/vision/instructions.js +3 -5
  149. package/dist/cli/appContext.js +14 -7
  150. package/dist/cli/argvalidate.js +0 -1
  151. package/dist/cli/capabilityContext/benchmark.js +5 -4
  152. package/dist/cli/capabilityContext/bespoke.js +14 -6
  153. package/dist/cli/capabilityContext/build.js +116 -42
  154. package/dist/cli/capabilityContext/closeout.js +30 -27
  155. package/dist/cli/capabilityContext/contract.js +18 -27
  156. package/dist/cli/capabilityContext/evidence.js +84 -77
  157. package/dist/cli/capabilityContext/index.js +0 -1
  158. package/dist/cli/capabilityContext/orchestration.js +42 -18
  159. package/dist/cli/capabilityContext/planState.js +89 -96
  160. package/dist/cli/capabilityContext/progress.js +52 -12
  161. package/dist/cli/capabilityContext/projectVerification.js +409 -0
  162. package/dist/cli/capabilityContext/shared.js +9 -20
  163. package/dist/cli/capabilityContext/slim.js +52 -8
  164. package/dist/cli/capabilityContext/startup.js +51 -114
  165. package/dist/cli/capabilityContext/startupAggregation.js +68 -0
  166. package/dist/cli/capabilityContext/types.js +26 -10
  167. package/dist/cli/capabilityContext.js +0 -1
  168. package/dist/cli/commands/appHome.js +0 -1
  169. package/dist/cli/commands/capability.js +2 -2
  170. package/dist/cli/commands/compact.js +163 -13
  171. package/dist/cli/commands/doctor.js +118 -11
  172. package/dist/cli/commands/durability.js +81 -0
  173. package/dist/cli/commands/glossaryAdvice.js +138 -0
  174. package/dist/cli/commands/lint.js +22 -8
  175. package/dist/cli/commands/personalGlossaryCandidateReads.js +755 -0
  176. package/dist/cli/commands/personalGlossaryDecision.js +349 -0
  177. package/dist/cli/commands/personalGlossaryPublish.js +484 -0
  178. package/dist/cli/commands/personalGlossaryReviewRecordReads.js +209 -0
  179. package/dist/cli/commands/personalGlossaryReviewRecords.js +623 -0
  180. package/dist/cli/commands/prime/briefOrientation.js +845 -0
  181. package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
  182. package/dist/cli/commands/prime/bundleStatus.js +54 -4
  183. package/dist/cli/commands/prime/collectEntityOrientation.js +338 -0
  184. package/dist/cli/commands/prime/collectOrientationState.js +124 -68
  185. package/dist/cli/commands/prime/orientationOutput.js +271 -59
  186. package/dist/cli/commands/prime/types.js +0 -1
  187. package/dist/cli/commands/prime.js +89 -11
  188. package/dist/cli/commands/profileGrounding.js +55 -0
  189. package/dist/cli/commands/query.js +74 -52
  190. package/dist/cli/commands/report.js +187 -27
  191. package/dist/cli/commands/route.js +142 -0
  192. package/dist/cli/commands/schema.js +436 -138
  193. package/dist/cli/commands/state/decisions.js +40 -56
  194. package/dist/cli/commands/state/docs.js +58 -85
  195. package/dist/cli/commands/state/experimentRecords.js +151 -0
  196. package/dist/cli/commands/state/experiments.js +11 -65
  197. package/dist/cli/commands/state/get.js +129 -0
  198. package/dist/cli/commands/state/health.js +11 -113
  199. package/dist/cli/commands/state/index.js +6 -41
  200. package/dist/cli/commands/state/list.js +194 -0
  201. package/dist/cli/commands/state/objective.js +21 -65
  202. package/dist/cli/commands/state/plan.js +11 -170
  203. package/dist/cli/commands/state/planTasks.js +154 -0
  204. package/dist/cli/commands/state/plans.js +154 -0
  205. package/dist/cli/commands/state/progress.js +11 -45
  206. package/dist/cli/commands/state/shared.js +0 -1
  207. package/dist/cli/commands/state/todo.js +28 -107
  208. package/dist/cli/commands/state/write.js +459 -0
  209. package/dist/cli/commands/upgrade.js +176 -5
  210. package/dist/cli/commands/upgradeVerify.js +118 -0
  211. package/dist/cli/commands/validate.js +235 -136
  212. package/dist/cli/commands/verify.js +73 -16
  213. package/dist/cli/contracts/bundleStatus.js +0 -1
  214. package/dist/cli/contracts/orientationState.js +0 -1
  215. package/dist/cli/dispatch/argvParser.js +0 -1
  216. package/dist/cli/dispatch/check.js +84 -40
  217. package/dist/cli/dispatch/commands.js +3 -3
  218. package/dist/cli/dispatch/index.js +84 -52
  219. package/dist/cli/dispatch/lifecycle.js +182 -62
  220. package/dist/cli/dispatch/prime.js +37 -2
  221. package/dist/cli/dispatch/projections.js +17 -0
  222. package/dist/cli/dispatch/shared.js +1 -2
  223. package/dist/cli/dispatch/state.js +62 -66
  224. package/dist/cli/dispatch.js +0 -1
  225. package/dist/cli/errors.js +16 -17
  226. package/dist/cli/help.js +419 -41
  227. package/dist/cli/migrationRequired.js +125 -0
  228. package/dist/cli/orientation/attention.js +19 -22
  229. package/dist/cli/orientation/corpusCoverage.js +32 -1
  230. package/dist/cli/orientation.js +346 -129
  231. package/dist/cli/planArtifacts.js +350 -0
  232. package/dist/cli/planEvidence.js +157 -0
  233. package/dist/cli/planLifecycleState.js +36 -0
  234. package/dist/cli/planTaskIndex.js +11 -0
  235. package/dist/cli/preCutoverCommand.js +32 -0
  236. package/dist/cli/prime-blob.js +71 -3
  237. package/dist/cli/productV1Eol.js +55 -0
  238. package/dist/cli/profileAcquisition.js +167 -0
  239. package/dist/cli/startupCompletenessContract.js +11 -9
  240. package/dist/cli/stateQuery.js +47 -12
  241. package/dist/cli/structured.js +0 -1
  242. package/dist/cli/todoMarkdown.js +25 -12
  243. package/dist/cli/todoReadinessSelection.js +192 -0
  244. package/dist/cli/todoSeverity.js +0 -1
  245. package/dist/core/atomicWriter.js +23 -0
  246. package/dist/core/developmentChannel.js +1 -0
  247. package/dist/core/developmentInvocation.js +377 -0
  248. package/dist/core/difflib.js +0 -1
  249. package/dist/core/envPaths.js +0 -1
  250. package/dist/core/jsonValue.js +0 -1
  251. package/dist/core/paths.js +0 -1
  252. package/dist/core/pyjson.js +0 -1
  253. package/dist/core/shell.js +4 -0
  254. package/dist/core/skillIdentity.js +23 -0
  255. package/dist/core/sourceRoot.js +9 -12
  256. package/dist/core/text.js +10 -0
  257. package/dist/core/toml.js +0 -1
  258. package/dist/core/yaml.js +61 -2
  259. package/dist/eval/evalSkills.js +13 -14
  260. package/dist/eval/glossaryEvaluation.js +751 -0
  261. package/dist/eval/glossaryEvaluationProcess.js +29 -0
  262. package/dist/eval/glossaryEvaluationRunner.js +571 -0
  263. package/dist/eval/glossaryEvaluationSuccessReport.js +297 -0
  264. package/dist/eval/hybridRouteEvaluation.js +155 -0
  265. package/dist/eval/semanticEval.js +0 -1
  266. package/dist/eval/semanticFixtures.js +0 -1
  267. package/dist/hooks/common.js +3 -56
  268. package/dist/hooks/compaction/apply.js +224 -47
  269. package/dist/hooks/compaction/dryRun.js +2 -1
  270. package/dist/hooks/compaction/index.js +5 -6
  271. package/dist/hooks/compaction/parse.js +73 -6
  272. package/dist/hooks/compaction/retention.js +28 -25
  273. package/dist/hooks/compaction/status.js +145 -26
  274. package/dist/hooks/compaction/types.js +0 -1
  275. package/dist/hooks/validateArtifact/agentFacing.js +0 -1
  276. package/dist/hooks/validateArtifact/index.js +6 -65
  277. package/dist/hooks/validateArtifact/markdown.js +9 -10
  278. package/dist/hooks/validateArtifact/schema.js +96 -9
  279. package/dist/hooks/validateArtifact/traversal.js +12 -11
  280. package/dist/hooks/validateArtifact/violations.js +5 -3
  281. package/dist/migrate/v2HandoffManifest.js +8 -3
  282. package/dist/registries/activationContract.js +2 -0
  283. package/dist/registries/activationTuples.js +145 -0
  284. package/dist/registries/artifactProtocolIds.js +2 -1
  285. package/dist/registries/artifactRegistry.js +207 -60
  286. package/dist/registries/artifactSchemaProjection.js +45 -0
  287. package/dist/registries/capabilityContract.js +5 -21
  288. package/dist/registries/evaluatorHandoffContract.js +0 -1
  289. package/dist/registries/evidenceTierContract.js +375 -0
  290. package/dist/registries/explicitSegmentGrammarContract.js +619 -0
  291. package/dist/registries/glossaryAdviceContract.js +79 -0
  292. package/dist/registries/glossaryCandidateContractPaths.js +6 -0
  293. package/dist/registries/glossaryCandidateContracts.js +820 -0
  294. package/dist/registries/glossaryCandidateDecisionAuthority.js +119 -0
  295. package/dist/registries/glossaryCandidateDecisionContract.js +62 -0
  296. package/dist/registries/glossaryCandidateProjectionAuthority.js +345 -0
  297. package/dist/registries/glossaryCandidateProjectionContract.js +108 -0
  298. package/dist/registries/glossaryCaveatContract.js +67 -0
  299. package/dist/registries/glossaryConsumerContractValidation.js +787 -0
  300. package/dist/registries/glossaryEntryContract.js +759 -0
  301. package/dist/registries/glossaryEntryTemporal.js +12 -0
  302. package/dist/registries/glossaryMiningAuthority.js +764 -0
  303. package/dist/registries/glossaryProfileFullContract.js +24 -0
  304. package/dist/registries/glossaryReviewRecordsAuthority.js +426 -0
  305. package/dist/registries/glossaryReviewRecordsContract.js +129 -0
  306. package/dist/registries/glossaryTermIdentity.js +139 -0
  307. package/dist/registries/glossaryTermOccurrence.js +20 -0
  308. package/dist/registries/hybridRoute.js +274 -0
  309. package/dist/registries/hybridRouteReceipt.js +221 -0
  310. package/dist/registries/packagePublication.js +273 -0
  311. package/dist/registries/packageRegistry.js +184 -209
  312. package/dist/registries/personalGlossaryContracts.js +1 -0
  313. package/dist/registries/todoReadinessContract.js +448 -0
  314. package/dist/registries/triggerLoader.js +7 -44
  315. package/dist/registries/verbosityBudgetContract.js +205 -0
  316. package/dist/release/releaseMetadata.js +168 -11
  317. package/dist/runtime/lifecycleAdapterContract.js +457 -0
  318. package/dist/runtime/lifecycleAdapters.js +777 -0
  319. package/dist/runtime/lifecycleAuthority.js +453 -0
  320. package/dist/runtime/lifecycleOperationContract.js +123 -0
  321. package/dist/runtime/lifecycleOperations.js +634 -0
  322. package/dist/runtime/lifecycleOwnershipJournal.js +622 -0
  323. package/dist/runtime/lifecyclePublication.js +415 -0
  324. package/dist/runtime/lifecycleSnapshot.js +438 -0
  325. package/dist/runtime/nativeResourceCleanup.js +503 -0
  326. package/dist/setup/opencode.js +20 -13
  327. package/dist/setup/opencodeConstants.js +1 -0
  328. package/dist/setup/sharedSkill.js +45 -0
  329. package/dist/setup/smokeChecks.js +14 -75
  330. package/dist/state/archiveDiscovery.js +580 -0
  331. package/dist/state/archivePublication.js +225 -0
  332. package/dist/state/archiveRecovery.js +237 -0
  333. package/dist/state/archiveReplay.js +53 -0
  334. package/dist/state/canonicalMigrationRecord.js +36 -0
  335. package/dist/state/changelog.js +221 -0
  336. package/dist/state/decisionEntities.js +367 -0
  337. package/dist/state/decisionLegacyValidation.js +215 -0
  338. package/dist/state/decisionMigrationProvenance.js +199 -0
  339. package/dist/state/decisionOverlay.js +254 -0
  340. package/dist/state/decisionRevision.js +256 -0
  341. package/dist/state/decisionRevisionMigration.js +89 -0
  342. package/dist/state/directRetrieval.js +323 -0
  343. package/dist/state/durability.js +324 -0
  344. package/dist/state/entityCutover.js +459 -0
  345. package/dist/state/entityCutoverGit.js +127 -0
  346. package/dist/state/entityGlossaryAuthority.js +13 -0
  347. package/dist/state/entityListProjection.js +187 -0
  348. package/dist/state/entityListRuntimeRegistry.js +85 -0
  349. package/dist/state/entityMigrationCausality.js +97 -0
  350. package/dist/state/entityMigrationIdentity.js +5 -0
  351. package/dist/state/entityMigrationPreview.js +840 -0
  352. package/dist/state/entityMigrationTodo.js +133 -0
  353. package/dist/state/entityPublicationContext.js +859 -0
  354. package/dist/state/entityRetrievalHelp.js +506 -0
  355. package/dist/state/entityStorage.js +899 -0
  356. package/dist/state/exactReplacementRecovery.js +18 -0
  357. package/dist/state/experimentArchive.js +63 -0
  358. package/dist/state/experimentIdentity.js +202 -0
  359. package/dist/state/healthEntities.js +262 -0
  360. package/dist/state/healthEntityValidation.js +18 -0
  361. package/dist/state/healthRepair.js +69 -0
  362. package/dist/state/installRoot.js +15 -7
  363. package/dist/state/legacyEntityCutoverEvidence.js +65 -0
  364. package/dist/state/legacyIdentity.js +47 -0
  365. package/dist/state/legacySummaryRecord.js +6 -0
  366. package/dist/state/listAccounting.js +54 -0
  367. package/dist/state/listClassification.js +17 -0
  368. package/dist/state/listCursor.js +42 -0
  369. package/dist/state/listRetrieval.js +781 -0
  370. package/dist/state/migrationSourceBinding.js +30 -0
  371. package/dist/state/objectiveExperimentEntities.js +322 -0
  372. package/dist/state/planEntities.js +1027 -0
  373. package/dist/state/planIdentity.js +47 -0
  374. package/dist/state/planLineageValidation.js +52 -0
  375. package/dist/state/planReplacementTransaction.js +475 -0
  376. package/dist/state/planRetrieval.js +313 -0
  377. package/dist/state/planTaskRetrieval.js +294 -0
  378. package/dist/state/progressEntities.js +512 -0
  379. package/dist/state/progressGlossaryCaveat.js +168 -0
  380. package/dist/state/progressPublicationOrder.js +19 -0
  381. package/dist/state/progressWritePolicy.js +33 -0
  382. package/dist/state/projectRoot.js +62 -0
  383. package/dist/state/projectionPolicy.js +190 -0
  384. package/dist/state/retrievalAuthority.js +156 -0
  385. package/dist/state/safeProjectFile.js +155 -0
  386. package/dist/state/startupAnalysis/benchmark.js +70 -9
  387. package/dist/state/startupAnalysis/contract.js +44 -10
  388. package/dist/state/startupAnalysis/helpers.js +1 -2
  389. package/dist/state/startupAnalysis/index.js +0 -1
  390. package/dist/state/startupAnalysis/metrics.js +0 -1
  391. package/dist/state/startupAnalysis/records.js +0 -1
  392. package/dist/state/startupAnalysis/report.js +0 -1
  393. package/dist/state/startupAnalysis/threshold.js +13 -1
  394. package/dist/state/startupAnalysis.js +0 -1
  395. package/dist/state/startupProjection.js +499 -0
  396. package/dist/state/stateMode.js +222 -0
  397. package/dist/state/stateStorageAuthority.js +47 -0
  398. package/dist/state/summaryEntityRead.js +25 -0
  399. package/dist/state/summaryMigrationProvenance.js +66 -0
  400. package/dist/state/summarySourceRowAuthority.js +36 -0
  401. package/dist/state/todoActivationSafety.js +58 -0
  402. package/dist/state/todoCreateBatch.js +69 -0
  403. package/dist/state/todoDocsEntities.js +1339 -0
  404. package/dist/state/todoDocsEntityValidation.js +158 -0
  405. package/dist/state/todoMarkdownProjection.js +63 -0
  406. package/dist/state/todoReconciliationActivation.js +182 -0
  407. package/dist/state/todoReconciliationInspection.js +184 -0
  408. package/dist/state/todoReconciliationRepair.js +320 -0
  409. package/dist/state/todoReconciliationTransaction.js +628 -0
  410. package/dist/state/todoSeverityHeadings.js +71 -0
  411. package/dist/state/todoTransitionBatch.js +65 -0
  412. package/dist/state/todoUpdateBatch.js +50 -0
  413. package/dist/state/write/assign.js +20 -0
  414. package/dist/state/write/candidateMutation.js +269 -0
  415. package/dist/state/write/errors.js +11 -0
  416. package/dist/state/write/experimentPublication.js +192 -0
  417. package/dist/state/write/explain.js +380 -0
  418. package/dist/state/write/fields.js +61 -0
  419. package/dist/state/write/glossaryPublication.js +263 -0
  420. package/dist/state/write/grammar.js +285 -0
  421. package/dist/state/write/helpers.js +29 -0
  422. package/dist/state/write/index.js +12 -0
  423. package/dist/state/write/input.js +391 -0
  424. package/dist/state/write/lock.js +837 -0
  425. package/dist/state/write/mutation.js +234 -0
  426. package/dist/state/write/operations.js +170 -0
  427. package/dist/state/write/planEvaluation.js +128 -0
  428. package/dist/state/write/planPublication.js +179 -0
  429. package/dist/state/write/runtimeOperations.js +146 -0
  430. package/dist/state/write/serialize.js +1 -0
  431. package/dist/state/write/transaction.js +57 -0
  432. package/dist/state/write/validate.js +7 -0
  433. package/dist/upgrade/appContentRefresh.js +77 -36
  434. package/dist/upgrade/appModel.js +0 -1
  435. package/dist/upgrade/atomicWriter.js +1 -0
  436. package/dist/upgrade/bundleEvidence.js +0 -1
  437. package/dist/upgrade/channels.js +6 -9
  438. package/dist/upgrade/compatibility.js +43 -17
  439. package/dist/upgrade/doctor.js +55 -32
  440. package/dist/upgrade/doctorClassifier.js +11 -1
  441. package/dist/upgrade/installedHooksRetirement.js +46 -40
  442. package/dist/upgrade/legacyAgentCleanup.js +133 -34
  443. package/dist/upgrade/lifecycleUpgrade.js +113 -0
  444. package/dist/upgrade/migrateArtifactsV2ToV3.js +325 -82
  445. package/dist/upgrade/migrationPublication.js +122 -0
  446. package/dist/upgrade/nextMajorDoctor.js +0 -22
  447. package/dist/upgrade/npxPlatformStatus.js +2 -2
  448. package/dist/upgrade/productV1Reset.js +515 -0
  449. package/dist/upgrade/productV1ResetAuthority.js +139 -0
  450. package/dist/upgrade/projectIntegration.js +126 -134
  451. package/dist/upgrade/projectIntegrationDecision.js +21 -13
  452. package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
  453. package/dist/upgrade/runtimeMigration.js +210 -430
  454. package/dist/upgrade/upgradeCommands.js +14 -1
  455. package/dist/upgrade/upgradeLock.js +85 -0
  456. package/dist/upgrade/upgradeOrchestrator.js +253 -48
  457. package/dist/upgrade/v3CapabilitySurface.js +2 -3
  458. package/dist/upgrade/versionResolution.js +0 -1
  459. package/dist/validate/activationArtifactEvidence.js +866 -0
  460. package/dist/validate/activationArtifactEvidenceTypes.js +12 -0
  461. package/dist/validate/activationConjunction.js +816 -0
  462. package/dist/validate/activationEvidenceManifest.js +610 -0
  463. package/dist/validate/activationPackageSemantics.js +29 -0
  464. package/dist/validate/appHomeContract.js +1 -7
  465. package/dist/validate/bootstrapAuthority.js +44 -0
  466. package/dist/validate/capability.js +11 -3
  467. package/dist/validate/crossCapability.js +14 -9
  468. package/dist/validate/glossaryVariantGuard.js +96 -0
  469. package/dist/validate/retainedReferenceAuthority.js +879 -0
  470. package/dist/validate/selfAudit.js +39 -45
  471. package/dist/validate/vocabularyAuthority.js +8 -8
  472. package/package.json +39 -13
  473. package/bundle/references/adapters/cursor.md +0 -214
  474. package/bundle/references/adapters/opencode.md +0 -530
  475. package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
  476. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  477. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  478. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -554
  479. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  480. package/bundle/references/analysis/benchmark.md +0 -267
  481. package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
  482. package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
  483. package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -369
  484. package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -250
  485. package/bundle/references/cli/capability-tool-classification.yaml +0 -53
  486. package/bundle/references/cli/coexistence-probe.yaml +0 -13
  487. package/bundle/references/cli/parity-expected-actual-template.md +0 -30
  488. package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
  489. package/bundle/references/cli/single-name-protocol.yaml +0 -42
  490. package/bundle/references/cli/upgrade-repair-wording.md +0 -45
  491. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +0 -98
  492. package/bundle/references/meta/documentation-inventory.md +0 -49
  493. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  494. package/bundle/skills/agentera/agents/audit.toml +0 -6
  495. package/bundle/skills/agentera/agents/build.toml +0 -6
  496. package/bundle/skills/agentera/agents/design.toml +0 -6
  497. package/bundle/skills/agentera/agents/discuss.toml +0 -6
  498. package/bundle/skills/agentera/agents/document.toml +0 -6
  499. package/bundle/skills/agentera/agents/optimize.toml +0 -6
  500. package/bundle/skills/agentera/agents/orchestrate.toml +0 -6
  501. package/bundle/skills/agentera/agents/plan.toml +0 -6
  502. package/bundle/skills/agentera/agents/profile.toml +0 -6
  503. package/bundle/skills/agentera/agents/research.toml +0 -6
  504. package/bundle/skills/agentera/agents/status.toml +0 -6
  505. package/bundle/skills/agentera/agents/vision.toml +0 -6
  506. package/bundle/skills/agentera/references/contract.md +0 -1048
  507. package/dist/analytics/extractCorpus/cli.js.map +0 -1
  508. package/dist/analytics/extractCorpus/copilotSessions.js.map +0 -1
  509. package/dist/analytics/extractCorpus/core.js.map +0 -1
  510. package/dist/analytics/extractCorpus/corpus.js.map +0 -1
  511. package/dist/analytics/extractCorpus/coverageAudit.js.map +0 -1
  512. package/dist/analytics/extractCorpus/cursorSessions.js.map +0 -1
  513. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +0 -1
  514. package/dist/analytics/extractCorpus/filesystemSources.js.map +0 -1
  515. package/dist/analytics/extractCorpus/index.js.map +0 -1
  516. package/dist/analytics/extractCorpus/jsonlSessions.js.map +0 -1
  517. package/dist/analytics/extractCorpus/sqliteCaps.js.map +0 -1
  518. package/dist/analytics/extractCorpus/sqliteSessions.js.map +0 -1
  519. package/dist/analytics/extractCorpus.js.map +0 -1
  520. package/dist/analytics/usageStats.js.map +0 -1
  521. package/dist/bin/agentera.js.map +0 -1
  522. package/dist/capabilities/audit/instructions.js.map +0 -1
  523. package/dist/capabilities/build/instructions.js.map +0 -1
  524. package/dist/capabilities/design/instructions.js.map +0 -1
  525. package/dist/capabilities/discuss/instructions.js.map +0 -1
  526. package/dist/capabilities/document/instructions.js.map +0 -1
  527. package/dist/capabilities/index.js.map +0 -1
  528. package/dist/capabilities/optimize/instructions.js.map +0 -1
  529. package/dist/capabilities/orchestrate/instructions.js.map +0 -1
  530. package/dist/capabilities/plan/instructions.js.map +0 -1
  531. package/dist/capabilities/profile/instructions.js.map +0 -1
  532. package/dist/capabilities/research/instructions.js.map +0 -1
  533. package/dist/capabilities/status/instructions.js.map +0 -1
  534. package/dist/capabilities/vision/instructions.js.map +0 -1
  535. package/dist/cli/appContext.js.map +0 -1
  536. package/dist/cli/argvalidate.js.map +0 -1
  537. package/dist/cli/capabilityContext/benchmark.js.map +0 -1
  538. package/dist/cli/capabilityContext/bespoke.js.map +0 -1
  539. package/dist/cli/capabilityContext/build.js.map +0 -1
  540. package/dist/cli/capabilityContext/closeout.js.map +0 -1
  541. package/dist/cli/capabilityContext/contract.js.map +0 -1
  542. package/dist/cli/capabilityContext/evidence.js.map +0 -1
  543. package/dist/cli/capabilityContext/index.js.map +0 -1
  544. package/dist/cli/capabilityContext/orchestration.js.map +0 -1
  545. package/dist/cli/capabilityContext/planState.js.map +0 -1
  546. package/dist/cli/capabilityContext/progress.js.map +0 -1
  547. package/dist/cli/capabilityContext/shared.js.map +0 -1
  548. package/dist/cli/capabilityContext/slim.js.map +0 -1
  549. package/dist/cli/capabilityContext/startup.js.map +0 -1
  550. package/dist/cli/capabilityContext/types.js.map +0 -1
  551. package/dist/cli/capabilityContext.js.map +0 -1
  552. package/dist/cli/commands/appHome.js.map +0 -1
  553. package/dist/cli/commands/capability.js.map +0 -1
  554. package/dist/cli/commands/compact.js.map +0 -1
  555. package/dist/cli/commands/doctor.js.map +0 -1
  556. package/dist/cli/commands/lint.js.map +0 -1
  557. package/dist/cli/commands/prime/bundleStatus.js.map +0 -1
  558. package/dist/cli/commands/prime/collectOrientationState.js.map +0 -1
  559. package/dist/cli/commands/prime/orientationOutput.js.map +0 -1
  560. package/dist/cli/commands/prime/types.js.map +0 -1
  561. package/dist/cli/commands/prime/v1Migration.js +0 -39
  562. package/dist/cli/commands/prime/v1Migration.js.map +0 -1
  563. package/dist/cli/commands/prime.js.map +0 -1
  564. package/dist/cli/commands/query.js.map +0 -1
  565. package/dist/cli/commands/report.js.map +0 -1
  566. package/dist/cli/commands/schema.js.map +0 -1
  567. package/dist/cli/commands/state/decisions.js.map +0 -1
  568. package/dist/cli/commands/state/docs.js.map +0 -1
  569. package/dist/cli/commands/state/experiments.js.map +0 -1
  570. package/dist/cli/commands/state/health.js.map +0 -1
  571. package/dist/cli/commands/state/index.js.map +0 -1
  572. package/dist/cli/commands/state/objective.js.map +0 -1
  573. package/dist/cli/commands/state/plan.js.map +0 -1
  574. package/dist/cli/commands/state/progress.js.map +0 -1
  575. package/dist/cli/commands/state/shared.js.map +0 -1
  576. package/dist/cli/commands/state/todo.js.map +0 -1
  577. package/dist/cli/commands/upgrade.js.map +0 -1
  578. package/dist/cli/commands/validate.js.map +0 -1
  579. package/dist/cli/commands/verify.js.map +0 -1
  580. package/dist/cli/contracts/bundleStatus.js.map +0 -1
  581. package/dist/cli/contracts/orientationState.js.map +0 -1
  582. package/dist/cli/dispatch/argvParser.js.map +0 -1
  583. package/dist/cli/dispatch/check.js.map +0 -1
  584. package/dist/cli/dispatch/commands.js.map +0 -1
  585. package/dist/cli/dispatch/index.js.map +0 -1
  586. package/dist/cli/dispatch/lifecycle.js.map +0 -1
  587. package/dist/cli/dispatch/prime.js.map +0 -1
  588. package/dist/cli/dispatch/shared.js.map +0 -1
  589. package/dist/cli/dispatch/state.js.map +0 -1
  590. package/dist/cli/dispatch.js.map +0 -1
  591. package/dist/cli/errors.js.map +0 -1
  592. package/dist/cli/help.js.map +0 -1
  593. package/dist/cli/orientation/attention.js.map +0 -1
  594. package/dist/cli/orientation/corpusCoverage.js.map +0 -1
  595. package/dist/cli/orientation.js.map +0 -1
  596. package/dist/cli/prime-blob.js.map +0 -1
  597. package/dist/cli/startupCompletenessContract.js.map +0 -1
  598. package/dist/cli/stateQuery.js.map +0 -1
  599. package/dist/cli/structured.js.map +0 -1
  600. package/dist/cli/todoMarkdown.js.map +0 -1
  601. package/dist/cli/todoSeverity.js.map +0 -1
  602. package/dist/core/difflib.js.map +0 -1
  603. package/dist/core/envPaths.js.map +0 -1
  604. package/dist/core/jsonValue.js.map +0 -1
  605. package/dist/core/paths.js.map +0 -1
  606. package/dist/core/pyjson.js.map +0 -1
  607. package/dist/core/sourceRoot.js.map +0 -1
  608. package/dist/core/toml.js.map +0 -1
  609. package/dist/core/yaml.js.map +0 -1
  610. package/dist/eval/evalSkills.js.map +0 -1
  611. package/dist/eval/semanticEval.js.map +0 -1
  612. package/dist/eval/semanticFixtures.js.map +0 -1
  613. package/dist/hooks/common.js.map +0 -1
  614. package/dist/hooks/compaction/apply.js.map +0 -1
  615. package/dist/hooks/compaction/dryRun.js.map +0 -1
  616. package/dist/hooks/compaction/index.js.map +0 -1
  617. package/dist/hooks/compaction/parse.js.map +0 -1
  618. package/dist/hooks/compaction/retention.js.map +0 -1
  619. package/dist/hooks/compaction/status.js.map +0 -1
  620. package/dist/hooks/compaction/types.js.map +0 -1
  621. package/dist/hooks/cursorPreToolUse.js +0 -19
  622. package/dist/hooks/cursorPreToolUse.js.map +0 -1
  623. package/dist/hooks/cursorSessionStart.js +0 -79
  624. package/dist/hooks/cursorSessionStart.js.map +0 -1
  625. package/dist/hooks/sessionStart.js +0 -216
  626. package/dist/hooks/sessionStart.js.map +0 -1
  627. package/dist/hooks/sessionStop.js +0 -206
  628. package/dist/hooks/sessionStop.js.map +0 -1
  629. package/dist/hooks/validateArtifact/agentFacing.js.map +0 -1
  630. package/dist/hooks/validateArtifact/index.js.map +0 -1
  631. package/dist/hooks/validateArtifact/markdown.js.map +0 -1
  632. package/dist/hooks/validateArtifact/runtime.js +0 -86
  633. package/dist/hooks/validateArtifact/runtime.js.map +0 -1
  634. package/dist/hooks/validateArtifact/schema.js.map +0 -1
  635. package/dist/hooks/validateArtifact/traversal.js.map +0 -1
  636. package/dist/hooks/validateArtifact/violations.js.map +0 -1
  637. package/dist/migrate/v2HandoffManifest.js.map +0 -1
  638. package/dist/registries/artifactProtocolIds.js.map +0 -1
  639. package/dist/registries/artifactRegistry.js.map +0 -1
  640. package/dist/registries/capabilityContract.js.map +0 -1
  641. package/dist/registries/evaluatorHandoffContract.js.map +0 -1
  642. package/dist/registries/packageRegistry.js.map +0 -1
  643. package/dist/registries/runtimeAdapterRegistry.js +0 -316
  644. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  645. package/dist/registries/triggerLoader.js.map +0 -1
  646. package/dist/release/releaseMetadata.js.map +0 -1
  647. package/dist/setup/codex/agents.js +0 -96
  648. package/dist/setup/codex/agents.js.map +0 -1
  649. package/dist/setup/codex/cli.js +0 -161
  650. package/dist/setup/codex/cli.js.map +0 -1
  651. package/dist/setup/codex/configToml.js +0 -639
  652. package/dist/setup/codex/configToml.js.map +0 -1
  653. package/dist/setup/codex/constants.js +0 -29
  654. package/dist/setup/codex/constants.js.map +0 -1
  655. package/dist/setup/codex/installRoot.js +0 -64
  656. package/dist/setup/codex/installRoot.js.map +0 -1
  657. package/dist/setup/codex/state.js +0 -270
  658. package/dist/setup/codex/state.js.map +0 -1
  659. package/dist/setup/codex.js +0 -12
  660. package/dist/setup/codex.js.map +0 -1
  661. package/dist/setup/copilot.js +0 -227
  662. package/dist/setup/copilot.js.map +0 -1
  663. package/dist/setup/cursor.js +0 -129
  664. package/dist/setup/cursor.js.map +0 -1
  665. package/dist/setup/cursorSurfaces.js +0 -67
  666. package/dist/setup/cursorSurfaces.js.map +0 -1
  667. package/dist/setup/doctor/core.js +0 -300
  668. package/dist/setup/doctor/core.js.map +0 -1
  669. package/dist/setup/doctor/diagnostics.js +0 -240
  670. package/dist/setup/doctor/diagnostics.js.map +0 -1
  671. package/dist/setup/doctor/opencode.js +0 -313
  672. package/dist/setup/doctor/opencode.js.map +0 -1
  673. package/dist/setup/doctor/report.js +0 -425
  674. package/dist/setup/doctor/report.js.map +0 -1
  675. package/dist/setup/doctor.js +0 -10
  676. package/dist/setup/doctor.js.map +0 -1
  677. package/dist/setup/opencode.js.map +0 -1
  678. package/dist/setup/smokeChecks.js.map +0 -1
  679. package/dist/state/installRoot.js.map +0 -1
  680. package/dist/state/startupAnalysis/benchmark.js.map +0 -1
  681. package/dist/state/startupAnalysis/contract.js.map +0 -1
  682. package/dist/state/startupAnalysis/helpers.js.map +0 -1
  683. package/dist/state/startupAnalysis/index.js.map +0 -1
  684. package/dist/state/startupAnalysis/metrics.js.map +0 -1
  685. package/dist/state/startupAnalysis/records.js.map +0 -1
  686. package/dist/state/startupAnalysis/report.js.map +0 -1
  687. package/dist/state/startupAnalysis/threshold.js.map +0 -1
  688. package/dist/state/startupAnalysis.js.map +0 -1
  689. package/dist/upgrade/appContentRefresh.js.map +0 -1
  690. package/dist/upgrade/appModel.js.map +0 -1
  691. package/dist/upgrade/bundleEvidence.js.map +0 -1
  692. package/dist/upgrade/channels.js.map +0 -1
  693. package/dist/upgrade/coexistenceProbe.js +0 -107
  694. package/dist/upgrade/coexistenceProbe.js.map +0 -1
  695. package/dist/upgrade/compatibility.js.map +0 -1
  696. package/dist/upgrade/doctor.js.map +0 -1
  697. package/dist/upgrade/doctorClassifier.js.map +0 -1
  698. package/dist/upgrade/installedHooksRetirement.js.map +0 -1
  699. package/dist/upgrade/legacyAgentCleanup.js.map +0 -1
  700. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
  701. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  702. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
  703. package/dist/upgrade/nextMajorDoctor.js.map +0 -1
  704. package/dist/upgrade/npxPlatformStatus.js.map +0 -1
  705. package/dist/upgrade/projectIntegration.js.map +0 -1
  706. package/dist/upgrade/projectIntegrationDecision.js.map +0 -1
  707. package/dist/upgrade/runtimeMigration.js.map +0 -1
  708. package/dist/upgrade/upgradeCommands.js.map +0 -1
  709. package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
  710. package/dist/upgrade/v3CapabilitySurface.js.map +0 -1
  711. package/dist/upgrade/versionResolution.js.map +0 -1
  712. package/dist/validate/appHomeContract.js.map +0 -1
  713. package/dist/validate/capability.js.map +0 -1
  714. package/dist/validate/crossCapability.js.map +0 -1
  715. package/dist/validate/lifecycleAdapters/legacyPythonParity.js +0 -93
  716. package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +0 -1
  717. package/dist/validate/lifecycleAdapters/nodeFormChecks.js +0 -488
  718. package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +0 -1
  719. package/dist/validate/lifecycleAdapters/shared.js +0 -198
  720. package/dist/validate/lifecycleAdapters/shared.js.map +0 -1
  721. package/dist/validate/lifecycleAdapters.js +0 -62
  722. package/dist/validate/lifecycleAdapters.js.map +0 -1
  723. package/dist/validate/selfAudit.js.map +0 -1
  724. package/dist/validate/vocabularyAuthority.js.map +0 -1
@@ -1,47 +1,25 @@
1
1
  TRIGGERS:
2
2
  1:
3
3
  id: T1
4
- description: >-
5
- Direct invocation by name or slash command. Matches when the user
6
- explicitly requests audit.
4
+ description: Audit local codebase health, architecture, quality, or technical debt.
7
5
  priority: high
8
- patterns:
9
- - "audit"
10
- - "/audit"
11
- confidence_threshold: 60
12
- borderline_band: 10
13
- patterns_regex:
14
- - "\\b/audit\\b"
15
6
  2:
16
7
  id: T2
17
- description: >-
18
- Audit and codebase health requests. Matches when the user wants to
19
- assess codebase health, architecture quality, or structural integrity.
20
- priority: medium
21
- patterns:
22
- - "audit the codebase"
23
- - "check code health"
24
- - "architecture review"
25
- - "find technical debt"
26
- - "assess code quality"
27
- - "how healthy is this codebase"
28
- - "what needs fixing"
29
- - "structural review"
30
- - "pattern audit"
31
- - "dependency check"
32
- - "test coverage audit"
33
- confidence_threshold: 55
8
+ description: Review the local repository's code, architecture, dependencies, or structural health.
9
+ priority: high
10
+ disambiguates_against:
11
+ - capability: research
12
+ hint: "audit reviews this local codebase; research analyzes an external source or repository"
13
+ - capability: document
14
+ hint: "audit owns code and architecture health; document owns documentation maintenance and docs audits"
15
+ - capability: design
16
+ hint: "audit owns code and architecture health; design owns visual identity and design-system review"
17
+ - capability: optimize
18
+ hint: "audit assesses local health; optimize improves an existing system against a measurable target"
34
19
  3:
35
20
  id: T3
36
- description: >-
37
- Implicit trigger after extended build activity. Matches when
38
- build has run 5+ cycles without a health check and the system
39
- detects an overdue audit.
21
+ description: Review local health after implementation activity reveals a need for assessment.
40
22
  priority: medium
41
- patterns:
42
- - "health check overdue"
43
- - "audit after build"
44
- confidence_threshold: 50
45
23
  disambiguates_against:
46
24
  - capability: build
47
25
  hint: "audit checks codebase health after build activity; build continues development"
@@ -24,9 +24,10 @@ VALIDATION:
24
24
  id: V3
25
25
  rule: decisions_respected
26
26
  description: >-
27
- Findings that contradict deliberate decisions documented in DECISIONS.md
28
- MUST be discarded or downgraded to info (SF3). A deliberate decision is
29
- not a finding; it is an implementation of that decision.
27
+ Findings that contradict deliberate decisions returned by the bounded
28
+ decisions entity view MUST be discarded or downgraded to info
29
+ (SF3). A deliberate decision is not a finding; it is an
30
+ implementation of that decision.
30
31
  severity: critical
31
32
  checks:
32
33
  - "No finding contradicts a known deliberate decision"
@@ -65,25 +66,25 @@ VALIDATION:
65
66
  id: V7
66
67
  rule: evidence_context_first
67
68
  description: >-
68
- Audit evaluation startup MUST begin with `agentera prime --context
69
+ Audit evaluation startup MUST begin with `npx -y agentera@next prime --context
69
70
  audit --format json` and use complete CLI `evidence_context` before
70
- raw plan, progress, docs, health, TODO, or decisions artifacts.
71
+ bounded state list/get contracts for plan, progress, docs, health, TODO,
72
+ or decisions. Raw artifact access is diagnostic-only.
71
73
  severity: critical
72
74
  checks:
73
- - "Evidence context is requested through prime --context before raw artifacts"
74
- - "Complete evidence_context is used for evaluation target, criteria, evidence, caveats, and residual risks"
75
+ - "Evidence context is requested through prime --context before bounded state list/get"
75
76
  8:
76
77
  id: V8
77
78
  rule: evidence_context_fallback_before_raw
78
79
  description: >-
79
80
  When evidence_context is absent, incomplete, or caveated for needed state,
80
- Audit MUST run listed existing CLI fallback commands before any last-resort
81
- raw artifact read.
81
+ Audit MUST run listed bounded CLI fallback commands before any
82
+ diagnostic-only raw artifact read.
82
83
  severity: critical
83
84
  checks:
84
- - "evidence_context.fallback_commands are attempted before raw artifact reads"
85
+ - "evidence_context.fallback_commands are attempted before diagnostic-only raw reads"
85
86
  - "capability_context.state.fallback_commands is used when evidence_context is unavailable"
86
- - "Raw artifact reads are last-resort diagnostics, not normal evaluation startup"
87
+ - "Raw artifact reads are diagnostic-only, not normal evaluation startup"
87
88
  9:
88
89
  id: V9
89
90
  rule: evidence_context_caveats_preserved
@@ -111,3 +112,21 @@ VALIDATION:
111
112
  - "Provisional satisfaction requires evidence"
112
113
  - "Only the user confirms final satisfaction"
113
114
  - "Missing or compacted satisfaction caveats are preserved"
115
+ 11:
116
+ id: V11
117
+ rule: terminology_drift_read_only
118
+ description: >-
119
+ Terminology-drift findings MUST cite every variant with verified
120
+ project-relative file and line evidence. Canonical terms are proposals,
121
+ never decisions or writes. Optional personal-profile divergence is
122
+ comparison evidence only; missing profile evidence produces no claim.
123
+ Audit remains mutation-free and read-only. Build project-glossary
124
+ publication is active. Audit performs no consumer lookup; Discuss, Plan,
125
+ and Build use the separate active read-only advice path. Personal-profile
126
+ mutation and docs-mapping mutation remain outside both paths.
127
+ severity: critical
128
+ checks:
129
+ - "Every reported drift variant has project-file evidence"
130
+ - "Weak, deliberate, tracked, and no-drift candidates produce no finding"
131
+ - "Audit mutates no glossary, profile, docs mapping, code, or project file"
132
+ - "Build publication and read-only glossary consumers are active under separate mutation boundaries"
@@ -1,15 +1,15 @@
1
1
  ARTIFACTS:
2
2
  1:
3
3
  id: A1
4
- artifact_id: vision
4
+ artifact: vision
5
5
  local_role: produces_and_consumes
6
6
  description: >-
7
7
  Build consumes this through CLI execution_context caveats or explicit
8
8
  fallback state when available, and never modifies it during cycles. Created
9
- during brainstorm (bootstrap or user-requested refinement).
9
+ during vision bootstrap.
10
10
  2:
11
11
  id: A2
12
- artifact_id: todo
12
+ artifact: todo
13
13
  local_role: produces_and_consumes
14
14
  description: >-
15
15
  Build consumes TODO state from execution_context and included status state
@@ -17,7 +17,7 @@ ARTIFACTS:
17
17
  entries. Severity classified per protocol SI1-SI4.
18
18
  3:
19
19
  id: A3
20
- artifact_id: changelog
20
+ artifact: changelog
21
21
  local_role: produces_and_consumes
22
22
  description: >-
23
23
  Build consumes changelog boundary from execution_context or the listed
@@ -25,31 +25,38 @@ ARTIFACTS:
25
25
  [Unreleased] based on commit type and promotes on version bumps.
26
26
  4:
27
27
  id: A4
28
- artifact_id: progress
28
+ artifact: progress
29
29
  local_role: produces_and_consumes
30
30
  description: >-
31
- Operational cycle log. Build consumes latest progress evidence from
32
- execution_context first, then appends one entry per cycle with mandatory
33
- Verified field. Compacted by applying schema COMPACTION rules.
31
+ Durable project-outcome log and the sole durable channel for bounded
32
+ autonomous glossary caveat lifecycle evidence. Build consumes latest
33
+ progress evidence from execution_context first, then bounded `npx -y
34
+ agentera@next state progress list --limit 20 --format json` discovery or
35
+ exact `state progress get --id ID` retrieval. The typed writer's
36
+ progress_write_policy governs whether a cycle appends zero or one record;
37
+ every appended cycle has a mandatory non-empty verified field.
34
38
  5:
35
39
  id: A5
36
- artifact_id: health
40
+ artifact: health
37
41
  local_role: consumes
38
42
  description: >-
39
43
  Build consumes health state from execution_context and included status
40
- state before direct reads, focusing on critical and degraded findings for
41
- work selection.
44
+ state before bounded `npx -y agentera@next state health list --limit 20 --format json`
45
+ discovery or exact `state health get --id ID` retrieval, focusing on
46
+ critical and degraded findings for work selection. Raw reads are
47
+ diagnostic-only for corruption or CLI-defect investigation.
42
48
  6:
43
49
  id: A6
44
- artifact_id: decisions
50
+ artifact: decisions
45
51
  local_role: consumes
46
52
  description: >-
47
- Build consumes decision caveats and fallback commands from
53
+ Build consumes decision caveats and bounded list/get fallback commands from
48
54
  execution_context first. Firm (DL1) entries are constraints and exploratory
49
- (DL3) entries are uncertain foundations during work selection.
55
+ (DL3) entries are uncertain foundations during work selection. Raw reads are
56
+ diagnostic-only for corruption or CLI-defect investigation.
50
57
  7:
51
58
  id: A7
52
- artifact_id: plan
59
+ artifact: plan
53
60
  local_role: produces_and_consumes
54
61
  description: >-
55
62
  Build consumes selected task, acceptance criteria, dependencies,
@@ -57,24 +64,40 @@ ARTIFACTS:
57
64
  direct plan reads, then updates task status and surprises during execution.
58
65
  8:
59
66
  id: A8
60
- artifact_id: profile
67
+ artifact: profile
61
68
  local_role: consumes
62
69
  description: >-
63
- Build consumes status profile summary first. Missing or stale profile state
64
- is a caveat and does not authorize profile refresh or direct profile reads
65
- during normal startup.
70
+ Build consumes status profile summary first and reads profile grounding
71
+ only from `npx -y agentera@next report profile-grounding --format json` when shared
72
+ validity is `valid`. Absent or repair-needed state preserves exact
73
+ recovery and does not authorize refresh or direct profile reads.
66
74
  9:
67
75
  id: A9
68
- artifact_id: docs
76
+ artifact: docs
69
77
  local_role: consumes
70
78
  description: >-
71
79
  Build consumes artifact mappings and docs caveats from execution_context
72
80
  and included status docs state before direct docs reads.
73
81
  10:
74
82
  id: A10
75
- artifact_id: design
83
+ artifact: design
76
84
  local_role: consumes
77
85
  description: >-
78
86
  Build treats design state missing from execution_context as a caveat or
79
87
  fallback-only need, and reads it only when building user-facing features
80
88
  after listed CLI fallbacks are exhausted.
89
+ 11:
90
+ id: A11
91
+ artifact: glossary
92
+ local_role: produces_and_consumes
93
+ description: >-
94
+ Build alone publishes one explicitly user-confirmed terminology proposal
95
+ through `npx -y agentera@next state glossary publish --input REQUEST`. The typed writer
96
+ revalidates audit source evidence and atomically records the immutable
97
+ approval beside the shared-only project entry. Build does not consume the
98
+ glossary only to validate replay and preserve unrelated publication state.
99
+ Separately, at governed meaning-sensitive Build events it requests bounded
100
+ read-only advice through `npx -y agentera@next report glossary-advice --input REQUEST
101
+ --format json`. Advice and progress caveats never publish terminology,
102
+ approve a proposal, reuse confirmation, mutate personal profiles or docs
103
+ mappings, or grant publication authority to another capability.
@@ -3,9 +3,11 @@ EXIT_CONDITIONS:
3
3
  id: E1
4
4
  condition: complete
5
5
  description: >-
6
- One full cycle completed. Work was selected, implemented, verified
7
- against the project's test/build suite, committed with a conventional
8
- message, and PROGRESS.md and TODO.md were updated.
6
+ One full cycle completed. Work was selected, implemented, and verified
7
+ against the project's test/build suite. Required artifact updates
8
+ preceded the cycle's single conventional commit. They include TODO,
9
+ changelog, and plan updates. Progress is present for policy-required
10
+ cases and optional for allowed durable outcomes.
9
11
  exit_signal: complete
10
12
  2:
11
13
  id: E2
@@ -13,15 +15,15 @@ EXIT_CONDITIONS:
13
15
  description: >-
14
16
  The cycle completed but with notable issues. Possible causes:
15
17
  verification passed but with warnings, the committed work is narrower
16
- than intended due to scope reduction, or discoveries logged in
17
- PROGRESS.md suggest the next cycle may face blockers.
18
+ than intended due to scope reduction, or durable discoveries recorded in
19
+ progress state suggest the next cycle may face blockers.
18
20
  exit_signal: flagged
19
21
  3:
20
22
  id: E3
21
23
  condition: stuck
22
24
  description: >-
23
25
  Cannot complete a cycle because VISION.md does not exist and the
24
- brainstorm cannot proceed without the user, every available work item
26
+ vision bootstrap cannot proceed without the user, every available work item
25
27
  is blocked, or the verification suite is broken and cannot be fixed
26
28
  within the cycle's scope.
27
29
  exit_signal: stuck
@@ -1,49 +1,27 @@
1
1
  TRIGGERS:
2
2
  1:
3
3
  id: T1
4
- description: >-
5
- Direct invocation by name or slash command. Matches when the user
6
- explicitly requests build for autonomous development.
4
+ description: A scoped implementation task or one verified development cycle.
7
5
  priority: high
8
- patterns:
9
- - "build"
10
- - "/build"
11
- confidence_threshold: 60
12
- borderline_band: 10
13
6
  2:
14
7
  id: T2
15
- description: >-
16
- Development cycle requests. Matches when the user wants to run an
17
- autonomous development cycle or evolve the project.
18
- priority: medium
19
- patterns:
20
- - "run a dev cycle"
21
- - "evolve the project"
22
- - "develop autonomously"
23
- - "build the next feature"
24
- confidence_threshold: 50
8
+ description: Implement one requested feature, fix, or bounded development task.
9
+ priority: high
10
+ disambiguates_against:
11
+ - capability: vision
12
+ hint: "build implements code; vision defines or refines project direction"
13
+ - capability: profile
14
+ hint: "build implements a software task; profile builds a reusable decision profile"
15
+ - capability: orchestrate
16
+ hint: "build completes one task or cycle; orchestrate runs an entire plan or multiple tasks"
25
17
  3:
26
18
  id: T3
27
- description: >-
28
- Continuous development signals. Matches when the user wants ongoing
29
- building or to start working on the project.
19
+ description: Start or continue a single concrete implementation task.
30
20
  priority: medium
31
- patterns:
32
- - "keep building"
33
- - "start building"
34
- - "work on the project"
35
- confidence_threshold: 50
36
21
  4:
37
22
  id: T4
38
- description: >-
39
- Vision refinement within a development context. Matches when the user
40
- wants to refine the project vision as part of a development session.
23
+ description: Implement a scoped task after its plan or requirements are established.
41
24
  priority: medium
42
- patterns:
43
- - "refine the vision"
44
- confidence_threshold: 50
45
25
  disambiguates_against:
46
- - capability: vision
47
- hint: "build implements code after vision work; vision defines direction"
48
- patterns_regex:
49
- - "\\brefine\\s+the\\s+vision\\b"
26
+ - capability: plan
27
+ hint: "build implements an established task; plan structures work before implementation"
@@ -3,9 +3,10 @@ VALIDATION:
3
3
  id: V1
4
4
  rule: verified_field_mandatory
5
5
  description: >-
6
- Every PROGRESS.md cycle entry MUST have a verified field. The field
7
- carries either observed output from the primary entrypoint, an allowlisted
8
- N/A tag, or a free-form rationale of at least 8 words.
6
+ Every progress entity record appended by Build MUST have a non-empty
7
+ verified field. The field carries either observed output from the primary
8
+ entrypoint, an allowlisted N/A tag, or a free-form rationale of at least 8
9
+ words.
9
10
  severity: critical
10
11
  checks:
11
12
  - "Every cycle entry has a verified field"
@@ -14,17 +15,22 @@ VALIDATION:
14
15
  id: V2
15
16
  rule: one_cycle_per_invocation
16
17
  description: >-
17
- Build executes exactly one cycle per invocation. After logging (Step 9),
18
- the capability MUST stop. Multiple cycles require separate invocations or
19
- /loop.
18
+ Build executes exactly one cycle per invocation. After logging required
19
+ artifacts (Step 7) and committing once (Step 8), the capability MUST stop.
20
+ The typed progress_write_policy determines whether the cycle appends zero
21
+ or one progress record. Multiple cycles require separate invocations or an
22
+ explicit user request.
20
23
  severity: critical
21
24
  checks:
22
- - "Only one cycle entry appended to PROGRESS.md per invocation"
25
+ - "At most one progress entity is appended per invocation"
26
+ - "Durable outcomes needed by future work may append one verified record"
27
+ - "Required glossary caveats and plan-completion sweeps append one verified record"
28
+ - "Attempt-only cycles with no durable project truth append no record"
23
29
  3:
24
30
  id: V3
25
31
  rule: no_remote_push
26
32
  description: >-
27
- Build MUST NEVER push to any remote repository. All commits are local
33
+ Build MUST NOT push to any remote repository. All commits are local
28
34
  only. Remote operations require explicit user instruction outside this
29
35
  capability.
30
36
  severity: critical
@@ -35,36 +41,38 @@ VALIDATION:
35
41
  rule: vision_readonly_during_cycle
36
42
  description: >-
37
43
  The canonical vision artifact MUST NOT be modified during a cycle. It may only be written
38
- during a brainstorm session (bootstrap or user-requested refinement).
44
+ during a vision bootstrap.
39
45
  severity: critical
40
46
  checks:
41
47
  - "Vision artifact not modified outside brainstorm"
42
48
  5:
43
49
  id: V5
44
- rule: consecutive_failure_guard
50
+ rule: attempt_history_authority
45
51
  description: >-
46
- If the last 3 PROGRESS.md entries all record failed cycles, build
47
- MUST stop and surface the pattern to the user. Do not attempt a 4th
48
- consecutive cycle on the same failing problem.
52
+ Build MUST NOT reconstruct task or release attempt history from progress.
53
+ Plan evaluations own task attempts, while qualification and publication
54
+ receipts own release attempts and retry state. Missing retry state does
55
+ not authorize an attempt-only progress record.
49
56
  severity: critical
50
57
  checks:
51
- - "Failure pattern checked before cycle start"
58
+ - "Progress is not used as task or release attempt history"
59
+ - "Retry state comes only from its owning plan or receipt authority"
52
60
  6:
53
61
  id: V6
54
62
  rule: artifact_path_resolution
55
63
  description: >-
56
- Before reading or writing any artifact, check .agentera/docs.yaml for path
57
- overrides. If absent, use the default layout (TODO.md, CHANGELOG.md,
58
- and DESIGN.md at root; canonical VISION.md at .agentera/vision.yaml;
59
- other agent-facing artifacts as YAML in .agentera/).
64
+ Entity state MUST use exact/list CLI reads and typed writers discovered by
65
+ `npx -y agentera@next state <artifact> explain`. Check .agentera/docs.yaml only for
66
+ intentional singleton path overrides.
60
67
  severity: warning
61
68
  checks:
62
- - "DOCS.md checked before artifact access"
69
+ - "Entity files are not read or edited directly"
70
+ - "docs.yaml checked before singleton artifact access"
63
71
  7:
64
72
  id: V7
65
73
  rule: execution_context_first
66
74
  description: >-
67
- Build startup SHOULD begin from `agentera prime --context build
75
+ Build startup SHOULD begin from `npx -y agentera@next prime --context build
68
76
  --format json` and consume complete execution_context
69
77
  state before direct reads of plan, progress, TODO, docs, health,
70
78
  decisions, changelog, vision, profile, or design artifacts.
@@ -93,7 +101,7 @@ VALIDATION:
93
101
  severity: critical
94
102
  checks:
95
103
  - "No protected state mutation during context generation"
96
- - "No unsupported `agentera build` or `agentera build` command introduced"
104
+ - "No unsupported `agentera build` command introduced"
97
105
  10:
98
106
  id: V10
99
107
  rule: satisfaction_authority_boundary
@@ -108,3 +116,69 @@ VALIDATION:
108
116
  - "Provisional satisfaction requires evidence"
109
117
  - "Only the user confirms final satisfaction"
110
118
  - "Missing or compacted satisfaction caveats are preserved"
119
+ 11:
120
+ id: V11
121
+ rule: sanitized_profile_grounding
122
+ description: >-
123
+ Build MUST ground only from the `content` returned by `npx -y agentera@next report
124
+ profile-grounding --format json` when shared validity is valid; it MUST
125
+ preserve absent/repair-needed recovery and MUST NOT direct-read PROFILE.md.
126
+ severity: critical
127
+ checks:
128
+ - "Sanitized grounding command used after prime startup"
129
+ - "Prime and report validity objects agree before content use"
130
+ - "Raw profile path not read"
131
+ 12:
132
+ id: V12
133
+ rule: governed_glossary_advice
134
+ description: >-
135
+ At initial meaning-sensitive cycle intent and later user-authored changes
136
+ or clarification answers that can alter intent, Build MUST request bounded
137
+ advice through `npx -y agentera@next report glossary-advice --input REQUEST --format
138
+ json`. Unchanged replay, unrelated turns, rendering, and tool output MUST
139
+ NOT refresh advice.
140
+ severity: critical
141
+ checks:
142
+ - "Exact project authority or proven-gap personal fallback grounds intent"
143
+ - "Governed changes refresh only the affected meaning"
144
+ - "Incidental turns and unchanged replay do not refresh"
145
+ 13:
146
+ id: V13
147
+ rule: glossary_review_and_autonomy
148
+ description: >-
149
+ Interactive Build MUST ask one focused clarification before disputed
150
+ meaning-sensitive reliance whenever review is required. If autonomous Build
151
+ cannot pause, it MUST avoid the disputed meaning, proceed conservatively
152
+ only where safe, and append one idempotent privacy-safe glossary_caveat
153
+ lifecycle envelope through the typed progress writer.
154
+ severity: critical
155
+ checks:
156
+ - "Clarification precedes meaning-sensitive execution and re-evaluates only the affected meaning"
157
+ - "Autonomous work does not assume disputed meaning"
158
+ - "Current, resolved, and superseded caveat events obey opaque identity lifecycle"
159
+ 14:
160
+ id: V14
161
+ rule: glossary_publication_isolation
162
+ description: >-
163
+ Advice, tension, clarification, and progress caveat lifecycle MUST NOT call
164
+ `npx -y agentera@next state glossary publish`, create or reuse approval, substitute for
165
+ digest-bound user confirmation, satisfy decisions or plan state, or grant
166
+ Discuss or Audit publication authority.
167
+ severity: critical
168
+ checks:
169
+ - "Advice and caveat paths perform zero glossary publication writes"
170
+ - "Only separately supplied digest-confirmed publication retains Build authority"
171
+ 15:
172
+ id: V15
173
+ rule: transient_no_plan_execution_input
174
+ description: >-
175
+ When no current executable plan owns startup, Build MAY accept one bounded
176
+ `agentera.buildExecutionRequest.v1` through `prime --context build --input
177
+ <file|-> --format json`. The request supplies explicit scope and acceptance
178
+ transiently; it MUST NOT persist, create, or mutate plan state. Current
179
+ plan-owned execution conflicts instead of silently ignoring the request.
180
+ severity: critical
181
+ checks:
182
+ - "Transient input is used only when no current executable plan owns startup"
183
+ - "No request content is placed in argv or persisted"
184
+ - "No-plan execution requires explicit scope and acceptance"
@@ -1,7 +1,7 @@
1
1
  ARTIFACTS:
2
2
  1:
3
3
  id: A1
4
- artifact_id: design
4
+ artifact: design
5
5
  local_role: produces_and_consumes
6
6
  description: >-
7
7
  Visual identity system with design tokens, typography, colors,
@@ -9,35 +9,35 @@ ARTIFACTS:
9
9
  reads agent-readable YAML token blocks with HTML comment markers.
10
10
  2:
11
11
  id: A2
12
- artifact_id: vision
12
+ artifact: vision
13
13
  local_role: consumes
14
14
  description: >-
15
15
  Design reads the Identity section to propose visual tokens
16
16
  coherent with the declared verbal personality.
17
17
  3:
18
18
  id: A3
19
- artifact_id: progress
19
+ artifact: progress
20
20
  local_role: consumes
21
21
  description: >-
22
22
  Design reads this during refine mode to identify UI work and
23
23
  inline design decisions since the design system was written.
24
24
  4:
25
25
  id: A4
26
- artifact_id: todo
26
+ artifact: todo
27
27
  local_role: produces_and_consumes
28
28
  description: >-
29
29
  Design reads this to check for design-related issues and files
30
30
  code drift findings here during audit mode.
31
31
  5:
32
32
  id: A5
33
- artifact_id: docs
33
+ artifact: docs
34
34
  local_role: consumes
35
35
  description: >-
36
36
  Design reads this first to resolve project-local artifact mappings
37
37
  before accessing other artifacts.
38
38
  6:
39
39
  id: A6
40
- artifact_id: profile
40
+ artifact: profile
41
41
  local_role: consumes
42
42
  description: >-
43
43
  Design reads aesthetic preferences from the profile as defaults
@@ -4,16 +4,16 @@ EXIT_CONDITIONS:
4
4
  condition: complete
5
5
  description: >-
6
6
  DESIGN.md was written (Create/Replace mode), updated (Refine mode),
7
- or audited with findings reported (Audit mode). Validation script
8
- ran without errors, and all changes had explicit user approval.
7
+ or audited with findings reported (Audit mode). npx -y agentera@next check lint
8
+ --artifact design passed, and all changes had explicit user approval.
9
9
  exit_signal: complete
10
10
  2:
11
11
  id: E2
12
12
  condition: flagged
13
13
  description: >-
14
14
  The design system was produced or audited but with issues worth
15
- surfacing. Possible causes: validation passed with advisory warnings,
16
- the design drifts from VISION.md Identity, or audit findings were
15
+ surfacing. Possible causes: lint passed with advisory warnings,
16
+ the design drifts from vision Identity, or audit findings were
17
17
  neither fixed nor filed.
18
18
  exit_signal: flagged
19
19
  3:
@@ -21,7 +21,7 @@ EXIT_CONDITIONS:
21
21
  condition: stuck
22
22
  description: >-
23
23
  Cannot write DESIGN.md because the user declined to approve the
24
- draft, the validation script reports unresolvable errors, or the
24
+ draft, npx -y agentera@next check lint reports unresolvable errors, or the
25
25
  project's UI stack is inaccessible.
26
26
  exit_signal: stuck
27
27
  4:
@@ -1,45 +1,16 @@
1
1
  TRIGGERS:
2
2
  1:
3
3
  id: T1
4
- description: >-
5
- Direct invocation by name or slash command. Matches when the user
6
- explicitly requests design.
4
+ description: Define, maintain, or assess visual identity and a design system.
7
5
  priority: high
8
- patterns:
9
- - "design"
10
- - "/design"
11
- confidence_threshold: 60
12
- borderline_band: 10
13
- patterns_regex:
14
- - "\\b/design\\b"
15
6
  2:
16
7
  id: T2
17
- description: >-
18
- Design system creation requests. Matches when the user wants to
19
- create or set up a visual identity system or design tokens.
20
- priority: medium
21
- patterns:
22
- - "create design system"
23
- - "write DESIGN.md"
24
- - "design tokens"
25
- - "visual identity"
26
- - "define the aesthetic"
27
- - "set up design system"
28
- confidence_threshold: 50
8
+ description: Create a visual identity, design system, design tokens, or aesthetic direction.
9
+ priority: high
29
10
  3:
30
11
  id: T3
31
- description: >-
32
- Design system refinement and audit requests. Matches when the user
33
- wants to evolve, check, or update an existing design system.
34
- priority: medium
35
- patterns:
36
- - "audit design"
37
- - "refine design system"
38
- - "update DESIGN.md"
39
- confidence_threshold: 50
12
+ description: Refine, update, or audit a visual design system, including “audit the design system”.
13
+ priority: high
40
14
  disambiguates_against:
41
15
  - capability: audit
42
16
  hint: "design here is about visual identity, not codebase auditing"
43
- patterns_regex:
44
- - "\\baudit\\s+design\\b"
45
- - "update\\s+DESIGN\\.md"