agentera 3.0.0-dev.7 → 3.0.0-dev.74

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 (763) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +229 -22
  3. package/bundle/.agentera-build-source.json +8 -0
  4. package/bundle/CHANGELOG.md +1361 -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 +252 -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 +439 -188
  13. package/bundle/references/adapters/package-surface-characterization.md +68 -34
  14. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
  15. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
  16. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
  17. package/bundle/references/adapters/runtime-retired-resources.yaml +333 -0
  18. package/bundle/references/analysis/evidence-tier-authority.yaml +559 -0
  19. package/bundle/references/analysis/personal-glossary-evaluation-authority.yaml +175 -0
  20. package/bundle/references/analysis/personal-glossary-evaluation-corpus.yaml +291 -0
  21. package/bundle/references/analysis/personal-glossary-holdout.yaml +192 -0
  22. package/bundle/references/analysis/verification-policy.yaml +266 -0
  23. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +17 -8
  24. package/bundle/references/artifacts/glossary-entry-contract.yaml +2752 -0
  25. package/bundle/references/artifacts/state-storage-authority.yaml +3061 -0
  26. package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
  27. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +3 -4
  28. package/bundle/references/cli/capability-instruction-contract.yaml +11 -14
  29. package/bundle/references/cli/hybrid-route-contract.yaml +438 -0
  30. package/bundle/references/cli/routing-model.md +152 -93
  31. package/bundle/references/cli/trigger-schema-enrichment.md +57 -46
  32. package/bundle/references/cli/update-channels.yaml +6 -4
  33. package/bundle/references/cli/vocabulary-index.yaml +5 -7
  34. package/bundle/references/cli/vocabulary.md +52 -94
  35. package/bundle/references/meta/retained-reference-authority.yaml +166 -0
  36. package/bundle/skills/agentera/SKILL.md +183 -63
  37. package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +27 -19
  38. package/bundle/skills/agentera/capabilities/audit/schemas/exit.yaml +2 -2
  39. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +13 -35
  40. package/bundle/skills/agentera/capabilities/audit/schemas/validation.yaml +30 -11
  41. package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +44 -21
  42. package/bundle/skills/agentera/capabilities/build/schemas/exit.yaml +8 -6
  43. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +14 -36
  44. package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +95 -21
  45. package/bundle/skills/agentera/capabilities/design/schemas/artifacts.yaml +6 -6
  46. package/bundle/skills/agentera/capabilities/design/schemas/exit.yaml +5 -5
  47. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +5 -34
  48. package/bundle/skills/agentera/capabilities/design/schemas/validation.yaml +2 -2
  49. package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +17 -13
  50. package/bundle/skills/agentera/capabilities/discuss/schemas/exit.yaml +2 -2
  51. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +6 -40
  52. package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +72 -5
  53. package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +24 -17
  54. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +5 -35
  55. package/bundle/skills/agentera/capabilities/document/schemas/validation.yaml +13 -13
  56. package/bundle/skills/agentera/capabilities/optimize/schemas/artifacts.yaml +10 -10
  57. package/bundle/skills/agentera/capabilities/optimize/schemas/exit.yaml +2 -2
  58. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +4 -35
  59. package/bundle/skills/agentera/capabilities/optimize/schemas/validation.yaml +3 -3
  60. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +34 -22
  61. package/bundle/skills/agentera/capabilities/orchestrate/schemas/exit.yaml +9 -7
  62. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +5 -37
  63. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +38 -37
  64. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +20 -16
  65. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +8 -31
  66. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +66 -6
  67. package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +13 -4
  68. package/bundle/skills/agentera/capabilities/profile/schemas/exit.yaml +8 -5
  69. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +8 -37
  70. package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +67 -3
  71. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +6 -6
  72. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +5 -29
  73. package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +13 -12
  74. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +7 -49
  75. package/bundle/skills/agentera/capabilities/vision/schemas/artifacts.yaml +8 -8
  76. package/bundle/skills/agentera/capabilities/vision/schemas/exit.yaml +7 -6
  77. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +7 -39
  78. package/bundle/skills/agentera/capabilities/vision/schemas/validation.yaml +14 -16
  79. package/bundle/skills/agentera/capability_schema_contract.yaml +32 -32
  80. package/bundle/skills/agentera/protocol.yaml +4 -4
  81. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  82. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +1 -0
  83. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +30 -12
  84. package/bundle/skills/agentera/schemas/artifacts/design.yaml +1 -0
  85. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +7 -12
  86. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +140 -9
  87. package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +87 -0
  88. package/bundle/skills/agentera/schemas/artifacts/health.yaml +56 -19
  89. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +18 -4
  90. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +464 -32
  91. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +131 -18
  92. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +302 -7
  93. package/dist/.agentera-build-source.json +8 -0
  94. package/dist/analytics/extractCorpus/cli.js +52 -11
  95. package/dist/analytics/extractCorpus/copilotSessions.js +19 -8
  96. package/dist/analytics/extractCorpus/core.js +262 -14
  97. package/dist/analytics/extractCorpus/corpus.js +57 -18
  98. package/dist/analytics/extractCorpus/coverageAudit.js +44 -45
  99. package/dist/analytics/extractCorpus/cursorSessions.js +28 -8
  100. package/dist/analytics/extractCorpus/evidenceTiers.js +709 -0
  101. package/dist/analytics/extractCorpus/extractCorpusParity.js +4 -4
  102. package/dist/analytics/extractCorpus/filesystemSources.js +5 -5
  103. package/dist/analytics/extractCorpus/index.js +4 -2
  104. package/dist/analytics/extractCorpus/jsonlSessions.js +76 -8
  105. package/dist/analytics/extractCorpus/sqliteCaps.js +0 -1
  106. package/dist/analytics/extractCorpus/sqliteSessions.js +12 -4
  107. package/dist/analytics/extractCorpus/tierReader.js +108 -0
  108. package/dist/analytics/extractCorpus.js +0 -1
  109. package/dist/analytics/glossaryAdviceResolution.js +166 -0
  110. package/dist/analytics/glossaryInputAcquisition.js +319 -0
  111. package/dist/analytics/personalGlossaryAdmission.js +113 -0
  112. package/dist/analytics/personalGlossaryCandidateProjection.js +692 -0
  113. package/dist/analytics/personalGlossaryCandidateProjectionExcerpts.js +144 -0
  114. package/dist/analytics/personalGlossaryCandidateReadView.js +23 -0
  115. package/dist/analytics/personalGlossaryCurrentGeneration.js +25 -0
  116. package/dist/analytics/personalGlossaryDecision.js +203 -0
  117. package/dist/analytics/personalGlossaryExplicit.js +788 -0
  118. package/dist/analytics/personalGlossaryExplicitMining.js +285 -0
  119. package/dist/analytics/personalGlossaryExplicitScope.js +41 -0
  120. package/dist/analytics/personalGlossaryExplicitSegments.js +418 -0
  121. package/dist/analytics/personalGlossaryExplicitTypes.js +26 -0
  122. package/dist/analytics/personalGlossaryLexicalClassifier.js +175 -0
  123. package/dist/analytics/personalGlossaryProfile.js +229 -0
  124. package/dist/analytics/personalGlossaryRecurrence.js +618 -0
  125. package/dist/analytics/personalGlossaryReviewRecordStorage.js +428 -0
  126. package/dist/analytics/personalGlossaryReviewRecords.js +332 -0
  127. package/dist/analytics/profileSignals.js +211 -0
  128. package/dist/analytics/usageStats.js +150 -23
  129. package/dist/audit/terminologyDrift.js +281 -0
  130. package/dist/bin/agentera.js +3 -2
  131. package/dist/capabilities/audit/instructions.js +16 -6
  132. package/dist/capabilities/build/instructions.js +59 -6
  133. package/dist/capabilities/design/instructions.js +3 -4
  134. package/dist/capabilities/discuss/instructions.js +29 -6
  135. package/dist/capabilities/document/instructions.js +11 -6
  136. package/dist/capabilities/index.js +20 -14
  137. package/dist/capabilities/optimize/instructions.js +14 -6
  138. package/dist/capabilities/orchestrate/instructions.js +42 -6
  139. package/dist/capabilities/plan/instructions.js +30 -3
  140. package/dist/capabilities/profile/instructions.js +104 -5
  141. package/dist/capabilities/research/instructions.js +4 -5
  142. package/dist/capabilities/status/instructions.js +15 -6
  143. package/dist/capabilities/status/startupInstructions.js +34 -0
  144. package/dist/capabilities/vision/instructions.js +3 -5
  145. package/dist/cli/appContext.js +14 -7
  146. package/dist/cli/argvalidate.js +0 -1
  147. package/dist/cli/capabilityContext/benchmark.js +5 -4
  148. package/dist/cli/capabilityContext/bespoke.js +14 -6
  149. package/dist/cli/capabilityContext/build.js +116 -42
  150. package/dist/cli/capabilityContext/closeout.js +30 -27
  151. package/dist/cli/capabilityContext/contract.js +18 -27
  152. package/dist/cli/capabilityContext/evidence.js +84 -77
  153. package/dist/cli/capabilityContext/index.js +0 -1
  154. package/dist/cli/capabilityContext/orchestration.js +42 -18
  155. package/dist/cli/capabilityContext/planState.js +89 -96
  156. package/dist/cli/capabilityContext/progress.js +51 -12
  157. package/dist/cli/capabilityContext/projectVerification.js +409 -0
  158. package/dist/cli/capabilityContext/shared.js +9 -20
  159. package/dist/cli/capabilityContext/slim.js +52 -8
  160. package/dist/cli/capabilityContext/startup.js +51 -114
  161. package/dist/cli/capabilityContext/startupAggregation.js +68 -0
  162. package/dist/cli/capabilityContext/types.js +26 -10
  163. package/dist/cli/capabilityContext.js +0 -1
  164. package/dist/cli/commands/appHome.js +0 -1
  165. package/dist/cli/commands/capability.js +2 -2
  166. package/dist/cli/commands/compact.js +163 -13
  167. package/dist/cli/commands/doctor.js +117 -11
  168. package/dist/cli/commands/durability.js +81 -0
  169. package/dist/cli/commands/glossaryAdvice.js +138 -0
  170. package/dist/cli/commands/lint.js +22 -8
  171. package/dist/cli/commands/personalGlossaryCandidateReads.js +744 -0
  172. package/dist/cli/commands/personalGlossaryDecision.js +349 -0
  173. package/dist/cli/commands/personalGlossaryPublish.js +484 -0
  174. package/dist/cli/commands/personalGlossaryReviewRecordReads.js +209 -0
  175. package/dist/cli/commands/personalGlossaryReviewRecords.js +623 -0
  176. package/dist/cli/commands/prime/briefOrientation.js +845 -0
  177. package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
  178. package/dist/cli/commands/prime/bundleStatus.js +54 -4
  179. package/dist/cli/commands/prime/collectEntityOrientation.js +326 -0
  180. package/dist/cli/commands/prime/collectOrientationState.js +126 -63
  181. package/dist/cli/commands/prime/orientationOutput.js +267 -56
  182. package/dist/cli/commands/prime/types.js +0 -1
  183. package/dist/cli/commands/prime/v1Migration.js +0 -1
  184. package/dist/cli/commands/prime.js +76 -11
  185. package/dist/cli/commands/profileGrounding.js +55 -0
  186. package/dist/cli/commands/query.js +74 -52
  187. package/dist/cli/commands/report.js +91 -21
  188. package/dist/cli/commands/route.js +142 -0
  189. package/dist/cli/commands/schema.js +436 -138
  190. package/dist/cli/commands/state/decisions.js +40 -56
  191. package/dist/cli/commands/state/docs.js +58 -85
  192. package/dist/cli/commands/state/experimentRecords.js +151 -0
  193. package/dist/cli/commands/state/experiments.js +11 -65
  194. package/dist/cli/commands/state/get.js +129 -0
  195. package/dist/cli/commands/state/health.js +11 -113
  196. package/dist/cli/commands/state/index.js +6 -41
  197. package/dist/cli/commands/state/list.js +194 -0
  198. package/dist/cli/commands/state/objective.js +21 -65
  199. package/dist/cli/commands/state/plan.js +11 -170
  200. package/dist/cli/commands/state/planTasks.js +154 -0
  201. package/dist/cli/commands/state/plans.js +154 -0
  202. package/dist/cli/commands/state/progress.js +11 -45
  203. package/dist/cli/commands/state/shared.js +0 -1
  204. package/dist/cli/commands/state/todo.js +28 -107
  205. package/dist/cli/commands/state/write.js +433 -0
  206. package/dist/cli/commands/upgrade.js +146 -5
  207. package/dist/cli/commands/upgradeVerify.js +118 -0
  208. package/dist/cli/commands/validate.js +235 -136
  209. package/dist/cli/commands/verify.js +73 -16
  210. package/dist/cli/contracts/bundleStatus.js +0 -1
  211. package/dist/cli/contracts/orientationState.js +0 -1
  212. package/dist/cli/dispatch/argvParser.js +0 -1
  213. package/dist/cli/dispatch/check.js +84 -40
  214. package/dist/cli/dispatch/commands.js +3 -3
  215. package/dist/cli/dispatch/index.js +77 -52
  216. package/dist/cli/dispatch/lifecycle.js +162 -62
  217. package/dist/cli/dispatch/prime.js +37 -2
  218. package/dist/cli/dispatch/projections.js +17 -0
  219. package/dist/cli/dispatch/shared.js +1 -2
  220. package/dist/cli/dispatch/state.js +62 -66
  221. package/dist/cli/dispatch.js +0 -1
  222. package/dist/cli/errors.js +16 -17
  223. package/dist/cli/help.js +404 -39
  224. package/dist/cli/migrationRequired.js +125 -0
  225. package/dist/cli/orientation/attention.js +19 -19
  226. package/dist/cli/orientation/corpusCoverage.js +32 -1
  227. package/dist/cli/orientation.js +346 -129
  228. package/dist/cli/planArtifacts.js +350 -0
  229. package/dist/cli/planEvidence.js +157 -0
  230. package/dist/cli/planLifecycleState.js +36 -0
  231. package/dist/cli/planTaskIndex.js +11 -0
  232. package/dist/cli/preCutoverCommand.js +32 -0
  233. package/dist/cli/prime-blob.js +71 -3
  234. package/dist/cli/profileAcquisition.js +167 -0
  235. package/dist/cli/startupCompletenessContract.js +11 -8
  236. package/dist/cli/stateQuery.js +47 -12
  237. package/dist/cli/structured.js +0 -1
  238. package/dist/cli/todoMarkdown.js +25 -12
  239. package/dist/cli/todoReadinessSelection.js +192 -0
  240. package/dist/cli/todoSeverity.js +0 -1
  241. package/dist/core/atomicWriter.js +23 -0
  242. package/dist/core/developmentChannel.js +1 -0
  243. package/dist/core/developmentInvocation.js +377 -0
  244. package/dist/core/difflib.js +0 -1
  245. package/dist/core/envPaths.js +0 -1
  246. package/dist/core/jsonValue.js +0 -1
  247. package/dist/core/paths.js +0 -1
  248. package/dist/core/pyjson.js +0 -1
  249. package/dist/core/shell.js +4 -0
  250. package/dist/core/skillIdentity.js +23 -0
  251. package/dist/core/sourceRoot.js +9 -12
  252. package/dist/core/text.js +10 -0
  253. package/dist/core/toml.js +0 -1
  254. package/dist/core/yaml.js +61 -2
  255. package/dist/eval/evalSkills.js +13 -14
  256. package/dist/eval/glossaryEvaluation.js +751 -0
  257. package/dist/eval/glossaryEvaluationProcess.js +29 -0
  258. package/dist/eval/glossaryEvaluationRunner.js +571 -0
  259. package/dist/eval/glossaryEvaluationSuccessReport.js +297 -0
  260. package/dist/eval/hybridRouteEvaluation.js +155 -0
  261. package/dist/eval/semanticEval.js +0 -1
  262. package/dist/eval/semanticFixtures.js +0 -1
  263. package/dist/hooks/common.js +3 -56
  264. package/dist/hooks/compaction/apply.js +224 -47
  265. package/dist/hooks/compaction/dryRun.js +2 -1
  266. package/dist/hooks/compaction/index.js +5 -6
  267. package/dist/hooks/compaction/parse.js +73 -6
  268. package/dist/hooks/compaction/retention.js +28 -25
  269. package/dist/hooks/compaction/status.js +145 -26
  270. package/dist/hooks/compaction/types.js +0 -1
  271. package/dist/hooks/validateArtifact/agentFacing.js +0 -1
  272. package/dist/hooks/validateArtifact/index.js +6 -65
  273. package/dist/hooks/validateArtifact/markdown.js +9 -10
  274. package/dist/hooks/validateArtifact/schema.js +96 -9
  275. package/dist/hooks/validateArtifact/traversal.js +12 -11
  276. package/dist/hooks/validateArtifact/violations.js +5 -3
  277. package/dist/migrate/v2HandoffManifest.js +8 -3
  278. package/dist/registries/activationContract.js +2 -0
  279. package/dist/registries/activationTuples.js +136 -0
  280. package/dist/registries/artifactProtocolIds.js +2 -1
  281. package/dist/registries/artifactRegistry.js +207 -60
  282. package/dist/registries/artifactSchemaProjection.js +45 -0
  283. package/dist/registries/capabilityContract.js +5 -21
  284. package/dist/registries/evaluatorHandoffContract.js +0 -1
  285. package/dist/registries/evidenceTierContract.js +375 -0
  286. package/dist/registries/explicitSegmentGrammarContract.js +619 -0
  287. package/dist/registries/glossaryAdviceContract.js +79 -0
  288. package/dist/registries/glossaryCandidateContractPaths.js +6 -0
  289. package/dist/registries/glossaryCandidateContracts.js +820 -0
  290. package/dist/registries/glossaryCandidateDecisionAuthority.js +119 -0
  291. package/dist/registries/glossaryCandidateDecisionContract.js +62 -0
  292. package/dist/registries/glossaryCandidateProjectionAuthority.js +197 -0
  293. package/dist/registries/glossaryCandidateProjectionContract.js +104 -0
  294. package/dist/registries/glossaryCaveatContract.js +67 -0
  295. package/dist/registries/glossaryConsumerContractValidation.js +787 -0
  296. package/dist/registries/glossaryEntryContract.js +759 -0
  297. package/dist/registries/glossaryEntryTemporal.js +12 -0
  298. package/dist/registries/glossaryMiningAuthority.js +764 -0
  299. package/dist/registries/glossaryProfileFullContract.js +24 -0
  300. package/dist/registries/glossaryReviewRecordsAuthority.js +426 -0
  301. package/dist/registries/glossaryReviewRecordsContract.js +129 -0
  302. package/dist/registries/glossaryTermIdentity.js +139 -0
  303. package/dist/registries/glossaryTermOccurrence.js +20 -0
  304. package/dist/registries/hybridRoute.js +274 -0
  305. package/dist/registries/hybridRouteReceipt.js +221 -0
  306. package/dist/registries/packagePublication.js +273 -0
  307. package/dist/registries/packageRegistry.js +184 -209
  308. package/dist/registries/personalGlossaryContracts.js +1 -0
  309. package/dist/registries/todoReadinessContract.js +448 -0
  310. package/dist/registries/triggerLoader.js +7 -44
  311. package/dist/registries/verbosityBudgetContract.js +205 -0
  312. package/dist/release/releaseMetadata.js +167 -10
  313. package/dist/runtime/lifecycleAdapterContract.js +457 -0
  314. package/dist/runtime/lifecycleAdapters.js +777 -0
  315. package/dist/runtime/lifecycleAuthority.js +453 -0
  316. package/dist/runtime/lifecycleOperationContract.js +123 -0
  317. package/dist/runtime/lifecycleOperations.js +634 -0
  318. package/dist/runtime/lifecycleOwnershipJournal.js +622 -0
  319. package/dist/runtime/lifecyclePublication.js +415 -0
  320. package/dist/runtime/lifecycleSnapshot.js +438 -0
  321. package/dist/runtime/nativeResourceCleanup.js +502 -0
  322. package/dist/setup/opencode.js +20 -13
  323. package/dist/setup/opencodeConstants.js +1 -0
  324. package/dist/setup/sharedSkill.js +45 -0
  325. package/dist/setup/smokeChecks.js +14 -75
  326. package/dist/state/archiveDiscovery.js +580 -0
  327. package/dist/state/archivePublication.js +225 -0
  328. package/dist/state/archiveRecovery.js +237 -0
  329. package/dist/state/archiveReplay.js +53 -0
  330. package/dist/state/canonicalMigrationRecord.js +36 -0
  331. package/dist/state/changelog.js +221 -0
  332. package/dist/state/decisionEntities.js +367 -0
  333. package/dist/state/decisionLegacyValidation.js +215 -0
  334. package/dist/state/decisionMigrationProvenance.js +199 -0
  335. package/dist/state/decisionOverlay.js +254 -0
  336. package/dist/state/decisionRevision.js +256 -0
  337. package/dist/state/decisionRevisionMigration.js +89 -0
  338. package/dist/state/directRetrieval.js +323 -0
  339. package/dist/state/durability.js +324 -0
  340. package/dist/state/entityCutover.js +459 -0
  341. package/dist/state/entityCutoverGit.js +127 -0
  342. package/dist/state/entityGlossaryAuthority.js +13 -0
  343. package/dist/state/entityListProjection.js +187 -0
  344. package/dist/state/entityListRuntimeRegistry.js +85 -0
  345. package/dist/state/entityMigrationCausality.js +97 -0
  346. package/dist/state/entityMigrationIdentity.js +5 -0
  347. package/dist/state/entityMigrationPreview.js +840 -0
  348. package/dist/state/entityMigrationTodo.js +133 -0
  349. package/dist/state/entityPublicationContext.js +859 -0
  350. package/dist/state/entityRetrievalHelp.js +506 -0
  351. package/dist/state/entityStorage.js +899 -0
  352. package/dist/state/exactReplacementRecovery.js +18 -0
  353. package/dist/state/experimentArchive.js +63 -0
  354. package/dist/state/experimentIdentity.js +202 -0
  355. package/dist/state/healthEntities.js +262 -0
  356. package/dist/state/healthEntityValidation.js +18 -0
  357. package/dist/state/healthRepair.js +69 -0
  358. package/dist/state/installRoot.js +15 -7
  359. package/dist/state/legacyEntityCutoverEvidence.js +65 -0
  360. package/dist/state/legacyIdentity.js +47 -0
  361. package/dist/state/legacySummaryRecord.js +6 -0
  362. package/dist/state/listAccounting.js +54 -0
  363. package/dist/state/listClassification.js +17 -0
  364. package/dist/state/listCursor.js +42 -0
  365. package/dist/state/listRetrieval.js +781 -0
  366. package/dist/state/migrationSourceBinding.js +30 -0
  367. package/dist/state/objectiveExperimentEntities.js +322 -0
  368. package/dist/state/planEntities.js +1027 -0
  369. package/dist/state/planIdentity.js +47 -0
  370. package/dist/state/planLineageValidation.js +52 -0
  371. package/dist/state/planReplacementTransaction.js +475 -0
  372. package/dist/state/planRetrieval.js +313 -0
  373. package/dist/state/planTaskRetrieval.js +294 -0
  374. package/dist/state/progressEntities.js +512 -0
  375. package/dist/state/progressGlossaryCaveat.js +168 -0
  376. package/dist/state/progressPublicationOrder.js +19 -0
  377. package/dist/state/progressWritePolicy.js +33 -0
  378. package/dist/state/projectRoot.js +62 -0
  379. package/dist/state/projectionPolicy.js +190 -0
  380. package/dist/state/retrievalAuthority.js +156 -0
  381. package/dist/state/safeProjectFile.js +155 -0
  382. package/dist/state/startupAnalysis/benchmark.js +70 -9
  383. package/dist/state/startupAnalysis/contract.js +44 -10
  384. package/dist/state/startupAnalysis/helpers.js +1 -2
  385. package/dist/state/startupAnalysis/index.js +0 -1
  386. package/dist/state/startupAnalysis/metrics.js +0 -1
  387. package/dist/state/startupAnalysis/records.js +0 -1
  388. package/dist/state/startupAnalysis/report.js +0 -1
  389. package/dist/state/startupAnalysis/threshold.js +13 -1
  390. package/dist/state/startupAnalysis.js +0 -1
  391. package/dist/state/startupProjection.js +499 -0
  392. package/dist/state/stateMode.js +222 -0
  393. package/dist/state/stateStorageAuthority.js +47 -0
  394. package/dist/state/summaryEntityRead.js +25 -0
  395. package/dist/state/summaryMigrationProvenance.js +66 -0
  396. package/dist/state/summarySourceRowAuthority.js +36 -0
  397. package/dist/state/todoActivationSafety.js +58 -0
  398. package/dist/state/todoDocsEntities.js +1124 -0
  399. package/dist/state/todoDocsEntityValidation.js +158 -0
  400. package/dist/state/todoMarkdownProjection.js +51 -0
  401. package/dist/state/todoReconciliationActivation.js +182 -0
  402. package/dist/state/todoReconciliationInspection.js +171 -0
  403. package/dist/state/todoReconciliationRepair.js +318 -0
  404. package/dist/state/todoReconciliationTransaction.js +595 -0
  405. package/dist/state/write/assign.js +20 -0
  406. package/dist/state/write/candidateMutation.js +269 -0
  407. package/dist/state/write/errors.js +11 -0
  408. package/dist/state/write/experimentPublication.js +192 -0
  409. package/dist/state/write/explain.js +377 -0
  410. package/dist/state/write/fields.js +61 -0
  411. package/dist/state/write/glossaryPublication.js +263 -0
  412. package/dist/state/write/grammar.js +285 -0
  413. package/dist/state/write/helpers.js +29 -0
  414. package/dist/state/write/index.js +12 -0
  415. package/dist/state/write/input.js +391 -0
  416. package/dist/state/write/lock.js +837 -0
  417. package/dist/state/write/mutation.js +234 -0
  418. package/dist/state/write/operations.js +170 -0
  419. package/dist/state/write/planEvaluation.js +128 -0
  420. package/dist/state/write/planPublication.js +179 -0
  421. package/dist/state/write/runtimeOperations.js +146 -0
  422. package/dist/state/write/serialize.js +1 -0
  423. package/dist/state/write/transaction.js +57 -0
  424. package/dist/state/write/validate.js +7 -0
  425. package/dist/upgrade/appContentRefresh.js +77 -36
  426. package/dist/upgrade/appModel.js +0 -1
  427. package/dist/upgrade/atomicWriter.js +1 -0
  428. package/dist/upgrade/bundleEvidence.js +0 -1
  429. package/dist/upgrade/channels.js +6 -9
  430. package/dist/upgrade/compatibility.js +43 -17
  431. package/dist/upgrade/doctor.js +55 -32
  432. package/dist/upgrade/doctorClassifier.js +11 -1
  433. package/dist/upgrade/installedHooksRetirement.js +46 -40
  434. package/dist/upgrade/legacyAgentCleanup.js +187 -21
  435. package/dist/upgrade/lifecycleUpgrade.js +113 -0
  436. package/dist/upgrade/migrateArtifactsV2ToV3.js +334 -64
  437. package/dist/upgrade/migrationPublication.js +122 -0
  438. package/dist/upgrade/nextMajorDoctor.js +0 -1
  439. package/dist/upgrade/npxPlatformStatus.js +2 -2
  440. package/dist/upgrade/projectIntegration.js +128 -160
  441. package/dist/upgrade/projectIntegrationDecision.js +42 -85
  442. package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
  443. package/dist/upgrade/runtimeMigration.js +262 -453
  444. package/dist/upgrade/upgradeCommands.js +14 -1
  445. package/dist/upgrade/upgradeLock.js +85 -0
  446. package/dist/upgrade/upgradeOrchestrator.js +263 -59
  447. package/dist/upgrade/v3CapabilitySurface.js +2 -3
  448. package/dist/upgrade/versionResolution.js +0 -1
  449. package/dist/validate/activationArtifactEvidence.js +866 -0
  450. package/dist/validate/activationArtifactEvidenceTypes.js +12 -0
  451. package/dist/validate/activationConjunction.js +816 -0
  452. package/dist/validate/activationEvidenceManifest.js +610 -0
  453. package/dist/validate/activationPackageSemantics.js +29 -0
  454. package/dist/validate/appHomeContract.js +1 -7
  455. package/dist/validate/bootstrapAuthority.js +44 -0
  456. package/dist/validate/capability.js +11 -3
  457. package/dist/validate/crossCapability.js +14 -9
  458. package/dist/validate/retainedReferenceAuthority.js +879 -0
  459. package/dist/validate/selfAudit.js +39 -45
  460. package/dist/validate/v1LegacyCruft.js +131 -0
  461. package/dist/validate/vocabularyAuthority.js +8 -8
  462. package/package.json +39 -13
  463. package/bundle/references/adapters/cursor.md +0 -214
  464. package/bundle/references/adapters/opencode.md +0 -530
  465. package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
  466. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  467. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  468. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -554
  469. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  470. package/bundle/references/analysis/benchmark.md +0 -267
  471. package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
  472. package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
  473. package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -369
  474. package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -250
  475. package/bundle/references/cli/capability-tool-classification.yaml +0 -53
  476. package/bundle/references/cli/coexistence-probe.yaml +0 -13
  477. package/bundle/references/cli/parity-expected-actual-template.md +0 -30
  478. package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
  479. package/bundle/references/cli/single-name-protocol.yaml +0 -42
  480. package/bundle/references/cli/upgrade-repair-wording.md +0 -45
  481. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +0 -98
  482. package/bundle/references/meta/documentation-inventory.md +0 -49
  483. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  484. package/bundle/skills/agentera/agents/audit.toml +0 -6
  485. package/bundle/skills/agentera/agents/build.toml +0 -6
  486. package/bundle/skills/agentera/agents/design.toml +0 -6
  487. package/bundle/skills/agentera/agents/discuss.toml +0 -6
  488. package/bundle/skills/agentera/agents/document.toml +0 -6
  489. package/bundle/skills/agentera/agents/optimize.toml +0 -6
  490. package/bundle/skills/agentera/agents/orchestrate.toml +0 -6
  491. package/bundle/skills/agentera/agents/plan.toml +0 -6
  492. package/bundle/skills/agentera/agents/profile.toml +0 -6
  493. package/bundle/skills/agentera/agents/research.toml +0 -6
  494. package/bundle/skills/agentera/agents/status.toml +0 -6
  495. package/bundle/skills/agentera/agents/vision.toml +0 -6
  496. package/bundle/skills/agentera/references/contract.md +0 -1048
  497. package/dist/analytics/extractCorpus/cli.js.map +0 -1
  498. package/dist/analytics/extractCorpus/copilotSessions.js.map +0 -1
  499. package/dist/analytics/extractCorpus/core.js.map +0 -1
  500. package/dist/analytics/extractCorpus/corpus.js.map +0 -1
  501. package/dist/analytics/extractCorpus/coverageAudit.js.map +0 -1
  502. package/dist/analytics/extractCorpus/cursorSessions.js.map +0 -1
  503. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +0 -1
  504. package/dist/analytics/extractCorpus/filesystemSources.js.map +0 -1
  505. package/dist/analytics/extractCorpus/index.js.map +0 -1
  506. package/dist/analytics/extractCorpus/jsonlSessions.js.map +0 -1
  507. package/dist/analytics/extractCorpus/sqliteCaps.js.map +0 -1
  508. package/dist/analytics/extractCorpus/sqliteSessions.js.map +0 -1
  509. package/dist/analytics/extractCorpus.js.map +0 -1
  510. package/dist/analytics/usageStats.js.map +0 -1
  511. package/dist/bin/agentera.js.map +0 -1
  512. package/dist/capabilities/audit/instructions.js.map +0 -1
  513. package/dist/capabilities/build/instructions.js.map +0 -1
  514. package/dist/capabilities/design/instructions.js.map +0 -1
  515. package/dist/capabilities/discuss/instructions.js.map +0 -1
  516. package/dist/capabilities/document/instructions.js.map +0 -1
  517. package/dist/capabilities/dokumentera/instructions.js +0 -6
  518. package/dist/capabilities/dokumentera/instructions.js.map +0 -1
  519. package/dist/capabilities/hej/instructions.js +0 -6
  520. package/dist/capabilities/hej/instructions.js.map +0 -1
  521. package/dist/capabilities/index.js.map +0 -1
  522. package/dist/capabilities/inspektera/instructions.js +0 -6
  523. package/dist/capabilities/inspektera/instructions.js.map +0 -1
  524. package/dist/capabilities/inspirera/instructions.js +0 -6
  525. package/dist/capabilities/inspirera/instructions.js.map +0 -1
  526. package/dist/capabilities/optimera/instructions.js +0 -6
  527. package/dist/capabilities/optimera/instructions.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/orkestrera/instructions.js +0 -6
  531. package/dist/capabilities/orkestrera/instructions.js.map +0 -1
  532. package/dist/capabilities/plan/instructions.js.map +0 -1
  533. package/dist/capabilities/planera/instructions.js +0 -6
  534. package/dist/capabilities/planera/instructions.js.map +0 -1
  535. package/dist/capabilities/profile/instructions.js.map +0 -1
  536. package/dist/capabilities/profilera/instructions.js +0 -6
  537. package/dist/capabilities/profilera/instructions.js.map +0 -1
  538. package/dist/capabilities/realisera/instructions.js +0 -6
  539. package/dist/capabilities/realisera/instructions.js.map +0 -1
  540. package/dist/capabilities/research/instructions.js.map +0 -1
  541. package/dist/capabilities/resonera/instructions.js +0 -6
  542. package/dist/capabilities/resonera/instructions.js.map +0 -1
  543. package/dist/capabilities/status/instructions.js.map +0 -1
  544. package/dist/capabilities/vision/instructions.js.map +0 -1
  545. package/dist/capabilities/visionera/instructions.js +0 -6
  546. package/dist/capabilities/visionera/instructions.js.map +0 -1
  547. package/dist/capabilities/visualisera/instructions.js +0 -5
  548. package/dist/capabilities/visualisera/instructions.js.map +0 -1
  549. package/dist/cli/appContext.js.map +0 -1
  550. package/dist/cli/argvalidate.js.map +0 -1
  551. package/dist/cli/capabilityContext/benchmark.js.map +0 -1
  552. package/dist/cli/capabilityContext/bespoke.js.map +0 -1
  553. package/dist/cli/capabilityContext/build.js.map +0 -1
  554. package/dist/cli/capabilityContext/closeout.js.map +0 -1
  555. package/dist/cli/capabilityContext/contract.js.map +0 -1
  556. package/dist/cli/capabilityContext/evidence.js.map +0 -1
  557. package/dist/cli/capabilityContext/index.js.map +0 -1
  558. package/dist/cli/capabilityContext/orchestration.js.map +0 -1
  559. package/dist/cli/capabilityContext/planState.js.map +0 -1
  560. package/dist/cli/capabilityContext/progress.js.map +0 -1
  561. package/dist/cli/capabilityContext/realisera.js +0 -174
  562. package/dist/cli/capabilityContext/realisera.js.map +0 -1
  563. package/dist/cli/capabilityContext/shared.js.map +0 -1
  564. package/dist/cli/capabilityContext/slim.js.map +0 -1
  565. package/dist/cli/capabilityContext/startup.js.map +0 -1
  566. package/dist/cli/capabilityContext/types.js.map +0 -1
  567. package/dist/cli/capabilityContext.js.map +0 -1
  568. package/dist/cli/commands/appHome.js.map +0 -1
  569. package/dist/cli/commands/backfill.js +0 -84
  570. package/dist/cli/commands/backfill.js.map +0 -1
  571. package/dist/cli/commands/capability.js.map +0 -1
  572. package/dist/cli/commands/compact.js.map +0 -1
  573. package/dist/cli/commands/doctor.js.map +0 -1
  574. package/dist/cli/commands/lint.js.map +0 -1
  575. package/dist/cli/commands/prime/bundleStatus.js.map +0 -1
  576. package/dist/cli/commands/prime/collectOrientationState.js.map +0 -1
  577. package/dist/cli/commands/prime/orientationOutput.js.map +0 -1
  578. package/dist/cli/commands/prime/routeOutput.js +0 -50
  579. package/dist/cli/commands/prime/routeOutput.js.map +0 -1
  580. package/dist/cli/commands/prime/types.js.map +0 -1
  581. package/dist/cli/commands/prime/v1Migration.js.map +0 -1
  582. package/dist/cli/commands/prime.js.map +0 -1
  583. package/dist/cli/commands/query.js.map +0 -1
  584. package/dist/cli/commands/report.js.map +0 -1
  585. package/dist/cli/commands/schema.js.map +0 -1
  586. package/dist/cli/commands/state/decisions.js.map +0 -1
  587. package/dist/cli/commands/state/docs.js.map +0 -1
  588. package/dist/cli/commands/state/experiments.js.map +0 -1
  589. package/dist/cli/commands/state/health.js.map +0 -1
  590. package/dist/cli/commands/state/index.js.map +0 -1
  591. package/dist/cli/commands/state/objective.js.map +0 -1
  592. package/dist/cli/commands/state/plan.js.map +0 -1
  593. package/dist/cli/commands/state/progress.js.map +0 -1
  594. package/dist/cli/commands/state/shared.js.map +0 -1
  595. package/dist/cli/commands/state/todo.js.map +0 -1
  596. package/dist/cli/commands/state.js +0 -1023
  597. package/dist/cli/commands/state.js.map +0 -1
  598. package/dist/cli/commands/upgrade.js.map +0 -1
  599. package/dist/cli/commands/validate.js.map +0 -1
  600. package/dist/cli/commands/verify.js.map +0 -1
  601. package/dist/cli/contracts/bundleStatus.js.map +0 -1
  602. package/dist/cli/contracts/orientationState.js.map +0 -1
  603. package/dist/cli/dispatch/argvParser.js.map +0 -1
  604. package/dist/cli/dispatch/check.js.map +0 -1
  605. package/dist/cli/dispatch/commands.js.map +0 -1
  606. package/dist/cli/dispatch/index.js.map +0 -1
  607. package/dist/cli/dispatch/lifecycle.js.map +0 -1
  608. package/dist/cli/dispatch/prime.js.map +0 -1
  609. package/dist/cli/dispatch/shared.js.map +0 -1
  610. package/dist/cli/dispatch/state.js.map +0 -1
  611. package/dist/cli/dispatch.js.map +0 -1
  612. package/dist/cli/errors.js.map +0 -1
  613. package/dist/cli/help.js.map +0 -1
  614. package/dist/cli/orientation/attention.js.map +0 -1
  615. package/dist/cli/orientation/corpusCoverage.js.map +0 -1
  616. package/dist/cli/orientation.js.map +0 -1
  617. package/dist/cli/prime-blob.js.map +0 -1
  618. package/dist/cli/startupCompletenessContract.js.map +0 -1
  619. package/dist/cli/stateQuery.js.map +0 -1
  620. package/dist/cli/structured.js.map +0 -1
  621. package/dist/cli/todoMarkdown.js.map +0 -1
  622. package/dist/cli/todoSeverity.js.map +0 -1
  623. package/dist/core/difflib.js.map +0 -1
  624. package/dist/core/envPaths.js.map +0 -1
  625. package/dist/core/git.js +0 -43
  626. package/dist/core/git.js.map +0 -1
  627. package/dist/core/jsonValue.js.map +0 -1
  628. package/dist/core/paths.js.map +0 -1
  629. package/dist/core/pyjson.js.map +0 -1
  630. package/dist/core/sourceRoot.js.map +0 -1
  631. package/dist/core/toml.js.map +0 -1
  632. package/dist/core/yaml.js.map +0 -1
  633. package/dist/eval/evalSkills.js.map +0 -1
  634. package/dist/eval/semanticEval.js.map +0 -1
  635. package/dist/eval/semanticFixtures.js.map +0 -1
  636. package/dist/hooks/common.js.map +0 -1
  637. package/dist/hooks/compaction/apply.js.map +0 -1
  638. package/dist/hooks/compaction/dryRun.js.map +0 -1
  639. package/dist/hooks/compaction/index.js.map +0 -1
  640. package/dist/hooks/compaction/parse.js.map +0 -1
  641. package/dist/hooks/compaction/retention.js.map +0 -1
  642. package/dist/hooks/compaction/status.js.map +0 -1
  643. package/dist/hooks/compaction/todoResolved.js +0 -137
  644. package/dist/hooks/compaction/todoResolved.js.map +0 -1
  645. package/dist/hooks/compaction/types.js.map +0 -1
  646. package/dist/hooks/compaction.js +0 -935
  647. package/dist/hooks/compaction.js.map +0 -1
  648. package/dist/hooks/cursorPreToolUse.js +0 -19
  649. package/dist/hooks/cursorPreToolUse.js.map +0 -1
  650. package/dist/hooks/cursorSessionStart.js +0 -79
  651. package/dist/hooks/cursorSessionStart.js.map +0 -1
  652. package/dist/hooks/sessionStart.js +0 -216
  653. package/dist/hooks/sessionStart.js.map +0 -1
  654. package/dist/hooks/sessionStop.js +0 -206
  655. package/dist/hooks/sessionStop.js.map +0 -1
  656. package/dist/hooks/todoLayout.js +0 -177
  657. package/dist/hooks/todoLayout.js.map +0 -1
  658. package/dist/hooks/validateArtifact/agentFacing.js.map +0 -1
  659. package/dist/hooks/validateArtifact/index.js.map +0 -1
  660. package/dist/hooks/validateArtifact/markdown.js.map +0 -1
  661. package/dist/hooks/validateArtifact/runtime.js +0 -86
  662. package/dist/hooks/validateArtifact/runtime.js.map +0 -1
  663. package/dist/hooks/validateArtifact/schema.js.map +0 -1
  664. package/dist/hooks/validateArtifact/traversal.js.map +0 -1
  665. package/dist/hooks/validateArtifact/violations.js.map +0 -1
  666. package/dist/hooks/validateArtifact.js +0 -924
  667. package/dist/hooks/validateArtifact.js.map +0 -1
  668. package/dist/migrate/v2HandoffManifest.js.map +0 -1
  669. package/dist/registries/artifactProtocolIds.js.map +0 -1
  670. package/dist/registries/artifactRegistry.js.map +0 -1
  671. package/dist/registries/capabilityContract.js.map +0 -1
  672. package/dist/registries/evaluatorHandoffContract.js.map +0 -1
  673. package/dist/registries/packageRegistry.js.map +0 -1
  674. package/dist/registries/runtimeAdapterRegistry.js +0 -316
  675. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  676. package/dist/registries/triggerLoader.js.map +0 -1
  677. package/dist/release/releaseMetadata.js.map +0 -1
  678. package/dist/routing/index.js +0 -2
  679. package/dist/routing/index.js.map +0 -1
  680. package/dist/routing/routeEngine.js +0 -189
  681. package/dist/routing/routeEngine.js.map +0 -1
  682. package/dist/setup/codex/agents.js +0 -96
  683. package/dist/setup/codex/agents.js.map +0 -1
  684. package/dist/setup/codex/cli.js +0 -161
  685. package/dist/setup/codex/cli.js.map +0 -1
  686. package/dist/setup/codex/configToml.js +0 -639
  687. package/dist/setup/codex/configToml.js.map +0 -1
  688. package/dist/setup/codex/constants.js +0 -29
  689. package/dist/setup/codex/constants.js.map +0 -1
  690. package/dist/setup/codex/installRoot.js +0 -64
  691. package/dist/setup/codex/installRoot.js.map +0 -1
  692. package/dist/setup/codex/state.js +0 -270
  693. package/dist/setup/codex/state.js.map +0 -1
  694. package/dist/setup/codex.js +0 -12
  695. package/dist/setup/codex.js.map +0 -1
  696. package/dist/setup/copilot.js +0 -227
  697. package/dist/setup/copilot.js.map +0 -1
  698. package/dist/setup/cursor.js +0 -129
  699. package/dist/setup/cursor.js.map +0 -1
  700. package/dist/setup/cursorSurfaces.js +0 -67
  701. package/dist/setup/cursorSurfaces.js.map +0 -1
  702. package/dist/setup/doctor/core.js +0 -300
  703. package/dist/setup/doctor/core.js.map +0 -1
  704. package/dist/setup/doctor/diagnostics.js +0 -240
  705. package/dist/setup/doctor/diagnostics.js.map +0 -1
  706. package/dist/setup/doctor/opencode.js +0 -313
  707. package/dist/setup/doctor/opencode.js.map +0 -1
  708. package/dist/setup/doctor/report.js +0 -425
  709. package/dist/setup/doctor/report.js.map +0 -1
  710. package/dist/setup/doctor.js +0 -10
  711. package/dist/setup/doctor.js.map +0 -1
  712. package/dist/setup/opencode.js.map +0 -1
  713. package/dist/setup/smokeChecks.js.map +0 -1
  714. package/dist/state/installRoot.js.map +0 -1
  715. package/dist/state/progressCommit.js +0 -289
  716. package/dist/state/progressCommit.js.map +0 -1
  717. package/dist/state/startupAnalysis/benchmark.js.map +0 -1
  718. package/dist/state/startupAnalysis/contract.js.map +0 -1
  719. package/dist/state/startupAnalysis/helpers.js.map +0 -1
  720. package/dist/state/startupAnalysis/index.js.map +0 -1
  721. package/dist/state/startupAnalysis/metrics.js.map +0 -1
  722. package/dist/state/startupAnalysis/records.js.map +0 -1
  723. package/dist/state/startupAnalysis/report.js.map +0 -1
  724. package/dist/state/startupAnalysis/threshold.js.map +0 -1
  725. package/dist/state/startupAnalysis.js.map +0 -1
  726. package/dist/upgrade/appContentRefresh.js.map +0 -1
  727. package/dist/upgrade/appModel.js.map +0 -1
  728. package/dist/upgrade/bundleEvidence.js.map +0 -1
  729. package/dist/upgrade/channels.js.map +0 -1
  730. package/dist/upgrade/cliProbe.js +0 -22
  731. package/dist/upgrade/cliProbe.js.map +0 -1
  732. package/dist/upgrade/coexistenceProbe.js +0 -107
  733. package/dist/upgrade/coexistenceProbe.js.map +0 -1
  734. package/dist/upgrade/compatibility.js.map +0 -1
  735. package/dist/upgrade/doctor.js.map +0 -1
  736. package/dist/upgrade/doctorClassifier.js.map +0 -1
  737. package/dist/upgrade/installedHooksRetirement.js.map +0 -1
  738. package/dist/upgrade/legacyAgentCleanup.js.map +0 -1
  739. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
  740. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  741. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
  742. package/dist/upgrade/nextMajorDoctor.js.map +0 -1
  743. package/dist/upgrade/npxPlatformStatus.js.map +0 -1
  744. package/dist/upgrade/projectIntegration.js.map +0 -1
  745. package/dist/upgrade/projectIntegrationDecision.js.map +0 -1
  746. package/dist/upgrade/runtimeMigration.js.map +0 -1
  747. package/dist/upgrade/upgradeCommands.js.map +0 -1
  748. package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
  749. package/dist/upgrade/v3CapabilitySurface.js.map +0 -1
  750. package/dist/upgrade/versionResolution.js.map +0 -1
  751. package/dist/validate/appHomeContract.js.map +0 -1
  752. package/dist/validate/capability.js.map +0 -1
  753. package/dist/validate/crossCapability.js.map +0 -1
  754. package/dist/validate/lifecycleAdapters/legacyPythonParity.js +0 -93
  755. package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +0 -1
  756. package/dist/validate/lifecycleAdapters/nodeFormChecks.js +0 -488
  757. package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +0 -1
  758. package/dist/validate/lifecycleAdapters/shared.js +0 -198
  759. package/dist/validate/lifecycleAdapters/shared.js.map +0 -1
  760. package/dist/validate/lifecycleAdapters.js +0 -62
  761. package/dist/validate/lifecycleAdapters.js.map +0 -1
  762. package/dist/validate/selfAudit.js.map +0 -1
  763. package/dist/validate/vocabularyAuthority.js.map +0 -1
@@ -1,55 +1,23 @@
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 orchestrate.
4
+ description: Execute an entire plan or coordinate multiple tasks and capabilities.
7
5
  priority: high
8
- patterns:
9
- - "orchestrate"
10
- - "/orchestrate"
11
- confidence_threshold: 60
12
- borderline_band: 10
13
- patterns_regex:
14
- - "\\b/orchestrate\\b"
15
6
  2:
16
7
  id: T2
17
- description: >-
18
- Multi-cycle execution signals. Matches when the user wants to execute
19
- an entire plan autonomously or run tasks through evaluation gating.
20
- priority: medium
21
- patterns:
22
- - "run the plan"
23
- - "execute the plan"
24
- - "run all tasks"
25
- - "keep going until done"
26
- - "run through the plan"
27
- - "build everything"
28
- confidence_threshold: 55
8
+ description: Run every task in a plan or execute a full plan autonomously.
9
+ priority: high
29
10
  disambiguates_against:
30
11
  - capability: build
31
12
  hint: "orchestrate runs the whole plan autonomously; build executes one development cycle"
32
13
  3:
33
14
  id: T3
34
- description: >-
35
- Orchestration and delegation signals. Matches when the user wants to
36
- chain multiple capabilities, delegate work, or coordinate multi-step
37
- execution.
15
+ description: Coordinate multiple tasks or capability handoffs through completion.
38
16
  priority: medium
39
- patterns:
40
- - "orchestrate"
41
- - "orchestrate skills"
42
- - "multi-cycle"
43
- confidence_threshold: 50
44
17
  4:
45
18
  id: T4
46
- description: >-
47
- Autonomous plan execution signals. Matches when the user wants
48
- evaluated, plan-driven development without manual intervention.
19
+ description: Run evaluated, plan-driven development across multiple tasks without manual sequencing.
49
20
  priority: medium
50
- patterns:
51
- - "autonomous plan execution"
52
- confidence_threshold: 50
53
21
  disambiguates_against:
54
22
  - capability: build
55
23
  hint: "orchestrate chains multi-cycle execution; build runs a single cycle"
@@ -1,36 +1,36 @@
1
1
  VALIDATION:
2
2
  1:
3
3
  id: V1
4
- rule: never_read_source
4
+ rule: must_not_read_source
5
5
  description: >-
6
- Orchestrate 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.
6
+ Orchestrate MUST NOT read implementation source code. It dispatches
7
+ capabilities; it does not implement. Artifact files (`.agentera/*.yaml`,
8
+ `TODO.md`) are state records, not source code; raw reads are last-resort
9
+ after CLI context and listed fallback commands. This rule verifies the
10
+ instructions explicitly state the source-code read prohibition.
11
11
  severity: critical
12
12
  checks:
13
- - "orchestrate prose (packages/cli/src/capabilities/orchestrate/instructions.ts) contains NEVER read implementation source code"
13
+ - "orchestrate instructions (packages/cli/src/capabilities/orchestrate/instructions.ts) contains MUST NOT read implementation source code"
14
14
  2:
15
15
  id: V2
16
16
  rule: evaluation_gate_required
17
17
  description: >-
18
18
  Every completed task MUST be verified by audit before being marked
19
19
  complete. The orchestrator MUST NOT skip evaluation. This rule verifies
20
- the prose contains the never-skip-evaluation safety rail.
20
+ the instructions contain the must-not-skip-evaluation safety rail.
21
21
  severity: critical
22
22
  checks:
23
- - "orchestrate prose contains NEVER skip evaluation"
23
+ - "orchestrate instructions contains MUST NOT skip evaluation"
24
24
  3:
25
25
  id: V3
26
26
  rule: retry_budget_enforced
27
27
  description: >-
28
28
  No task may be retried more than 2 times. After the second failure,
29
29
  the task must be marked blocked. This rule verifies the retry budget
30
- is stated in the prose and safety rails.
30
+ is stated in the instructions and safety rails.
31
31
  severity: critical
32
32
  checks:
33
- - "orchestrate prose contains retry budget of 2"
33
+ - "orchestrate instructions contains retry a task more than 2 times"
34
34
  4:
35
35
  id: V4
36
36
  rule: exit_marker_required
@@ -40,45 +40,46 @@ VALIDATION:
40
40
  where status is one of EX1-EX4.
41
41
  severity: critical
42
42
  checks:
43
- - "orchestrate prose contains exit marker with glyph ⎈ (SG12)"
44
- - "orchestrate prose references exit signals EX1-EX4"
43
+ - "orchestrate instructions contains exit marker with glyph ⎈ (SG12)"
44
+ - "orchestrate instructions references exit signals EX1-EX4"
45
45
  5:
46
46
  id: V5
47
47
  rule: orchestrator_read_only_artifacts
48
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.
49
+ The orchestrator updates plan task statuses and TODO.md blocked entries.
50
+ During terminal-open closure only, it writes the typed limited-scope
51
+ health record before plan completion. It does NOT write progress or
52
+ changelog. This rule verifies the artifacts schema reflects this
53
+ constraint.
53
54
  severity: warning
54
55
  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)"
56
+ - "progress is consumes only (not produces)"
57
+ - "health is produces_and_consumes for terminal-open closure only"
58
+ - "decisions is consumes only (not produces)"
59
+ - "vision is consumes only (not produces)"
59
60
  6:
60
61
  id: V6
61
62
  rule: orchestration_context_first
62
63
  description: >-
63
64
  Orchestrate startup and evaluation MUST use
64
- `agentera prime --context orchestrate --format json` and the
65
+ `npx -y agentera@next prime --context orchestrate --format json` and the
65
66
  returned orchestration context before raw plan, progress, health, TODO,
66
67
  or decisions artifact reads.
67
68
  severity: critical
68
69
  checks:
69
- - "orchestrate prose contains agentera prime --context orchestrate --format json"
70
- - "orchestrate prose contains Use the returned `orchestration_context` before raw plan, progress, health, TODO, or decisions artifacts"
71
- - "orchestrate prose contains If `source_contract.complete_for_orchestration_context` is true, do not read raw plan, progress, health, TODO, or decisions artifacts"
70
+ - "orchestrate instructions contains npx -y agentera@next prime --context orchestrate --format json"
71
+ - "orchestrate instructions contains complete_for_orchestration_context"
72
+ - "orchestrate instructions contains no raw plan, progress, health, TODO, or decisions reads"
72
73
  7:
73
74
  id: V7
74
75
  rule: cli_fallback_before_raw_read
75
76
  description: >-
76
77
  When orchestration context is incomplete, Orchestrate MUST run listed
77
- routine CLI fallback commands before any last-resort raw artifact read.
78
+ fallback commands before any raw artifact read.
78
79
  severity: critical
79
80
  checks:
80
- - "orchestrate prose contains run the listed routine CLI fallback commands"
81
- - "orchestrate prose contains Read a raw artifact only as a last-resort diagnostic"
81
+ - "orchestrate instructions contains run listed fallback commands"
82
+ - "orchestrate instructions contains last-resort diagnostics"
82
83
  8:
83
84
  id: V8
84
85
  rule: caveats_preserved_for_evaluation
@@ -88,9 +89,9 @@ VALIDATION:
88
89
  audit.
89
90
  severity: critical
90
91
  checks:
91
- - "orchestrate prose contains compacted decision caveats"
92
- - "orchestrate prose contains stale health/profile/app caveats"
93
- - "orchestrate prose contains retry-state provenance"
92
+ - "orchestrate instructions contains compacted decision caveats"
93
+ - "orchestrate instructions contains stale health/profile/app caveats"
94
+ - "orchestrate instructions contains retry-state provenance"
94
95
  9:
95
96
  id: V9
96
97
  rule: satisfaction_authority_boundary
@@ -107,14 +108,14 @@ VALIDATION:
107
108
  - "Missing or compacted satisfaction caveats are preserved"
108
109
  10:
109
110
  id: V10
110
- rule: inspektera_citation_required
111
+ rule: audit_citation_required
111
112
  description: >-
112
113
  Orchestrate Step 3 Surface 2 audit 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
114
+ citation: <file>:<line> (or not-applicable: <reason>) for every FAIL
115
+ finding, and require verify_command for FAIL rows with file:line
115
116
  citations. Authority: references/cli/capability-instruction-contract.yaml#evaluator_handoff.
116
117
  severity: critical
117
118
  checks:
118
- - "orchestrate prose contains citation: `<file>:<line>` OR `not-applicable: <reason>`"
119
- - "orchestrate prose contains verify_command"
120
- - "orchestrate prose contains evaluator_handoff.output_requirements"
119
+ - "orchestrate instructions contains citation: `<file>:<line>` OR `not-applicable: <reason>`"
120
+ - "orchestrate instructions contains verify_command"
121
+ - "orchestrate instructions contains evaluator_handoff.output_requirements"
@@ -1,61 +1,65 @@
1
1
  ARTIFACTS:
2
2
  1:
3
3
  id: A1
4
- artifact_id: plan
4
+ artifact: plan
5
5
  local_role: produces_and_consumes
6
6
  description: >-
7
- Active plan with tasks, dependencies, and behavioral acceptance criteria.
8
- Plan writes this during the planning session and may read existing
9
- plan context before replacing or refining it.
7
+ Current plan with tasks, dependencies, and behavioral acceptance criteria.
8
+ Its active position is derived from the docs-mapped current-plan path,
9
+ not persisted lifecycle status. Plan writes this during the planning
10
+ session and may read existing plan context before replacing or refining it.
10
11
  2:
11
12
  id: A2
12
- artifact_id: plan_archive
13
+ artifact: plan_archive
13
14
  local_role: produces
14
15
  description: >-
15
- Created when a plan is fully
16
- executed or explicitly discarded by the user. Preserved for historical
17
- reference.
16
+ Immutable, non-executable history created when a plan is complete or
17
+ explicitly force-archived. Forced archival preserves an unfinished
18
+ plan's open status rather than claiming completion.
18
19
  3:
19
20
  id: A3
20
- artifact_id: vision
21
+ artifact: vision
21
22
  local_role: consumes
22
23
  description: >-
23
24
  Plan reads this during Orient to understand project direction and
24
25
  align the plan with the vision.
25
26
  4:
26
27
  id: A4
27
- artifact_id: decisions
28
+ artifact: decisions
28
29
  local_role: consumes
29
30
  description: >-
30
31
  Plan reads firm (DL1) entries only as hard constraints for planning.
31
32
  5:
32
33
  id: A5
33
- artifact_id: todo
34
+ artifact: todo
34
35
  local_role: consumes
35
36
  description: >-
36
37
  Plan reads this to identify related known
37
38
  issues that the plan should address.
38
39
  6:
39
40
  id: A6
40
- artifact_id: health
41
+ artifact: health
41
42
  local_role: consumes
42
43
  description: >-
43
44
  Plan reads this to factor structural issues into the plan.
44
45
  7:
45
46
  id: A7
46
- artifact_id: progress
47
+ artifact: progress
47
48
  local_role: consumes
48
49
  description: >-
49
50
  Plan reads this to understand what was built recently.
50
51
  8:
51
52
  id: A8
52
- artifact_id: profile
53
+ artifact: profile
53
54
  local_role: consumes
54
55
  description: >-
55
- Plan reads this to calibrate planning depth and pattern preferences.
56
+ Plan reads only sanitized non-glossary content from `npx -y agentera@next report
57
+ profile-grounding --format json` to calibrate planning depth and pattern
58
+ preferences. It never direct-reads the profile path and uses content only
59
+ for shared validity `valid`; absent and repair-needed results fail closed.
56
60
  9:
57
61
  id: A9
58
- artifact_id: docs
62
+ artifact: docs
59
63
  local_role: consumes
60
64
  description: >-
61
65
  Plan reads this first to resolve project-local artifact mappings and
@@ -1,46 +1,23 @@
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 plan for structured planning.
4
+ description: Requests to structure work into a plan before implementation.
7
5
  priority: high
8
- patterns:
9
- - "plan"
10
- - "/plan"
11
- confidence_threshold: 60
12
- borderline_band: 10
13
- patterns_regex:
14
- - "\\b/plan\\b"
15
6
  2:
16
7
  id: T2
17
- description: >-
18
- Planning requests. Matches when the user wants to create a plan,
19
- break work down, or specify requirements before building.
20
- priority: medium
21
- patterns:
22
- - "plan this"
23
- - "write a plan"
24
- - "break this down"
25
- - "decompose this"
26
- - "spec this out"
27
- - "plan before building"
28
- confidence_threshold: 50
8
+ description: Create a plan, break work down, or specify requirements before building.
9
+ priority: high
29
10
  disambiguates_against:
30
11
  - capability: build
31
12
  hint: "plan structures work into tasks before coding; build implements the work"
13
+ - capability: discuss
14
+ hint: "plan structures committed work; discuss explores an undecided choice or tradeoff"
15
+ - capability: vision
16
+ hint: "plan structures work toward known direction; vision defines the direction itself"
32
17
  3:
33
18
  id: T3
34
- description: >-
35
- Architectural planning signals. Matches when the user is asking how
36
- to approach building something or when the work is too large for a
37
- single development cycle.
19
+ description: Plan a multi-step feature or approach too large for one development cycle.
38
20
  priority: medium
39
- patterns:
40
- - "how should we build this"
41
- - "multi-step feature"
42
- - "this is too big for one cycle"
43
- confidence_threshold: 50
44
21
  disambiguates_against:
45
22
  - capability: build
46
23
  hint: "plan sizes work before implementation; build runs the development cycle"
@@ -12,13 +12,14 @@ VALIDATION:
12
12
  - "No implementation details in acceptance criteria"
13
13
  2:
14
14
  id: V2
15
- rule: max_8_tasks
15
+ rule: coherent_lifecycle_scope
16
16
  description: >-
17
- Full plans MUST NOT exceed 8 tasks. If work requires more, it must
18
- be split into sequential plans.
17
+ Full plans MUST keep all tasks within a coherent lifecycle boundary.
18
+ Split plans only when work crosses a real lifecycle or coherence boundary.
19
19
  severity: critical
20
20
  checks:
21
- - "Task count 8 in full plans"
21
+ - "Tasks stay within one coherent lifecycle boundary"
22
+ - "Splits follow real lifecycle or coherence boundaries"
22
23
  3:
23
24
  id: V3
24
25
  rule: adversarial_review_required
@@ -54,8 +55,67 @@ VALIDATION:
54
55
  rule: skip_level_for_trivial_work
55
56
  description: >-
56
57
  Plan MUST detect skip level for trivial work (single-file change,
57
- bug fix, config tweak, < 50 lines) and route directly to /build
58
- without producing a PLAN.md.
58
+ localized defect fix, or config tweak that touches no shared
59
+ abstraction) and route directly to /build without producing a
60
+ PLAN.md. LOC count is not a skip signal because small changes to
61
+ shared exports can ripple across many consumers.
59
62
  severity: critical
60
63
  checks:
61
64
  - "Trivial work routed to /build without plan"
65
+ 7:
66
+ id: V7
67
+ rule: full_plan_unknowns_required
68
+ description: >-
69
+ Every full plan MUST surface at least one planning-time known-unknown
70
+ in the `unknowns:` field. Each entry MUST include question,
71
+ affects_task, and resolve_by. Skip level and light plans are exempt
72
+ because they do not decompose work into interdependent tasks.
73
+ severity: warning
74
+ checks:
75
+ - "Full plans have a non-empty `unknowns:` list"
76
+ - "Each unknown entry has question, affects_task, resolve_by fields"
77
+ 8:
78
+ id: V8
79
+ rule: adversarial_review_dismissals_persisted
80
+ description: >-
81
+ Full plans MUST persist dismissed adversarial-review findings in the
82
+ artifact's `rejected:` field, each with issue text and rationale, so
83
+ downstream consumers (build, orchestrate, audit) inherit the
84
+ adjudication rather than relitigating. V3 enforces the review ran;
85
+ V8 enforces the dismissal provenance persists.
86
+ severity: warning
87
+ checks:
88
+ - "Full plans with dismissed critic findings have `rejected:` entries"
89
+ - "Each rejection has issue and rationale fields"
90
+ 9:
91
+ id: V9
92
+ rule: sanitized_profile_grounding
93
+ description: >-
94
+ Plan MUST ground only from the `content` returned by `npx -y agentera@next report
95
+ profile-grounding --format json` when shared validity is valid; it MUST
96
+ preserve absent/repair-needed recovery and MUST NOT direct-read PROFILE.md.
97
+ severity: critical
98
+ checks:
99
+ - "Sanitized grounding command used during Orient"
100
+ - "Prime and report validity objects agree before content use"
101
+ - "Raw profile path not read"
102
+ 10:
103
+ id: V10
104
+ rule: governed_terminology_advice
105
+ description: >-
106
+ Plan MUST consume terminology advice through the shared glossary consumer
107
+ authority at governed meaning-sensitive user events. Interactive review
108
+ MUST precede fixing affected requirements. Autonomous unresolved review
109
+ MUST abstain, defer the affected requirements, and emit at most one bounded
110
+ current writer intent without delivering or storing it or writing plan
111
+ conflict or progress state.
112
+ severity: critical
113
+ checks:
114
+ - "Advice refreshes only for authority-declared Plan events"
115
+ - "Mode follows explicit authority precedence and unknown mode waits"
116
+ - "Interactive review precedes affected requirements and acceptance"
117
+ - "Autonomous unresolved meaning remains deferred without a Plan write"
118
+ - "Emitted-only handoff intent contains exactly event=current, reason, and ownership state"
119
+ - "Writer owns caveat identity, Build capability, and transition fields"
120
+ - "Exact project authority suppresses personal-unavailable durable handoff"
121
+ - "Plan artifacts exclude private glossary content"
@@ -1,15 +1,24 @@
1
1
  ARTIFACTS:
2
2
  1:
3
3
  id: A1
4
- artifact_id: profile
4
+ artifact: profile
5
5
  local_role: produces_and_consumes
6
6
  description: >-
7
7
  Decision profile with per-entry confidence scoring, permanence
8
- classification, and temporal metadata. Profile writes this in both Full
9
- and Validate modes, then reads it for validation and update context.
8
+ classification, and temporal metadata. After writing the base profile,
9
+ Profile Full consumes one existing consent-bound user-local personal
10
+ glossary generation. Only complete current coverage reaches bounded
11
+ classification and current explicit CLI decisions can replace its
12
+ deterministic owned Glossary section; inferred or ambiguous candidates
13
+ use the bounded review lifecycle. Unavailable, stale, or degraded coverage
14
+ preserves the base and owned section and requires explicit refresh. Lookup remains deferred. Profile writes
15
+ this in both Full and Validate modes, then reads it for validation and
16
+ update context. Prime exposes its canonical resolved path only inside
17
+ `prime --context profile`; no other Prime context or profile-grounding
18
+ failure may serialize that path.
10
19
  2:
11
20
  id: A2
12
- artifact_id: decisions
21
+ artifact: decisions
13
22
  local_role: consumes
14
23
  description: >-
15
24
  Profile treats this as a high-signal source for extraction scripts.
@@ -4,8 +4,11 @@ EXIT_CONDITIONS:
4
4
  condition: complete
5
5
  description: >-
6
6
  PROFILE.md was written (Full mode) or updated (Validate mode).
7
- Metadata changes were applied, prediction accuracy was assessed
8
- (Full mode), and changes were summarized.
7
+ In Full mode the base profile was written first, then any existing personal
8
+ glossary generation produced only current authorized explicit publication;
9
+ remaining review work was queued or bounded for a question channel.
10
+ Metadata changes were applied, prediction accuracy was assessed, and
11
+ changes were summarized.
9
12
  exit_signal: complete
10
13
  2:
11
14
  id: E2
@@ -15,15 +18,15 @@ EXIT_CONDITIONS:
15
18
  issues: available runtime history was skipped without explicit
16
19
  acceptance, extraction failed for one or more sources, prediction
17
20
  accuracy was below 3/5, or significant unresolved tensions were
18
- found.
21
+ found. Full mode is also flagged when its existing consent-bound personal
22
+ glossary generation is unavailable, stale, degraded, or review-only.
19
23
  exit_signal: flagged
20
24
  3:
21
25
  id: E3
22
26
  condition: stuck
23
27
  description: >-
24
28
  Cannot generate or validate a profile because extraction scripts
25
- failed entirely, Python is unavailable, or session data sources
26
- are unreadable.
29
+ failed entirely or session data sources are unreadable.
27
30
  exit_signal: stuck
28
31
  4:
29
32
  id: E4
@@ -1,49 +1,20 @@
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 profile.
4
+ description: Create, maintain, or analyze a reusable decision profile.
7
5
  priority: high
8
- patterns:
9
- - "profile"
10
- - "/profile"
11
- confidence_threshold: 55
12
6
  2:
13
7
  id: T2
14
- description: >-
15
- Profile generation requests. Matches when the user wants to build
16
- or regenerate their decision profile from scratch.
17
- priority: medium
18
- patterns:
19
- - "build decision profile"
20
- - "generate decision profile"
21
- - "rebuild my profile"
22
- - "regenerate profile"
23
- confidence_threshold: 45
8
+ description: Build, generate, or regenerate a decision profile.
9
+ priority: high
10
+ disambiguates_against:
11
+ - capability: build
12
+ hint: "profile builds a reusable decision profile; build implements a software task"
24
13
  3:
25
14
  id: T3
26
- description: >-
27
- Profile maintenance requests. Matches when the user wants to update,
28
- validate, or check their existing profile.
15
+ description: Update, validate, or refresh an existing decision profile.
29
16
  priority: medium
30
- patterns:
31
- - "update my profile"
32
- - "refresh my decision profile"
33
- - "validate my profile"
34
- - "check my profile"
35
- - "quick profile check"
36
- confidence_threshold: 45
37
17
  4:
38
18
  id: T4
39
- description: >-
40
- Decision analysis requests. Matches when the user wants to understand
41
- their own decision-making patterns or review past decisions.
19
+ description: Analyze personal decision patterns or review decision history.
42
20
  priority: medium
43
- patterns:
44
- - "what would I decide"
45
- - "analyze my decisions"
46
- - "mine my sessions"
47
- - "decision patterns"
48
- - "review my decision history"
49
- confidence_threshold: 45
@@ -5,11 +5,15 @@ VALIDATION:
5
5
  description: >-
6
6
  Every profile entry MUST be grounded in observed evidence from session
7
7
  history, memory files, configs, or conversation data. Fabricated
8
- decision patterns are never acceptable.
8
+ decision patterns are never acceptable. Synthesis reads the bounded
9
+ signal tier; a claim's source identity is verified by resolving its
10
+ evidence_anchor to a retained full-evidence shard rather than re-scanning
11
+ unbounded history.
9
12
  severity: critical
10
13
  checks:
11
14
  - "Each profile entry traces to a source record"
12
15
  - "No profile entry is fabricated without evidence"
16
+ - "Each claim's evidence_anchor resolves to a retained full-evidence shard"
13
17
  2:
14
18
  id: V2
15
19
  rule: confidence_calibration
@@ -17,11 +21,13 @@ VALIDATION:
17
21
  Confidence scores MUST match the evidence tier (protocol CS1-CS5).
18
22
  A single data point is 30-49 (CS4), not 70+. Bias check: confidence
19
23
  is earned through evidence, not assigned by how insightful the
20
- decision sounds.
24
+ decision sounds. When bounded_signals.sufficiency is insufficient,
25
+ affected categories are capped to CS4 (30-49) or below.
21
26
  severity: critical
22
27
  checks:
23
28
  - "Confidence values fall within protocol tier boundaries"
24
29
  - "Single-source entries are capped at CS4 (30-49)"
30
+ - "Insufficient families cap affected categories to CS4 or below"
25
31
  3:
26
32
  id: V3
27
33
  rule: tension_honesty
@@ -39,11 +45,17 @@ VALIDATION:
39
45
  description: >-
40
46
  Profile MUST NOT modify session history, memory files, or config
41
47
  files. It reads these sources for extraction but never writes to them.
42
- The only artifact profile produces is PROFILE.md.
48
+ The only artifact profile produces is PROFILE.md. Profile MUST NOT
49
+ load the monolithic corpus.json whole: synthesis reads the bounded
50
+ signal tier and retrieves full evidence one shard at a time via
51
+ evidence_anchor. Legacy/missing tiers require a refresh to publish
52
+ bounded tiers first, never a whole-corpus load.
43
53
  severity: critical
44
54
  checks:
45
55
  - "No writes to session history files"
46
56
  - "No writes to memory or config files"
57
+ - "Monolithic corpus.json is never loaded whole"
58
+ - "Full-evidence records are retrieved one shard at a time"
47
59
  5:
48
60
  id: V5
49
61
  rule: prediction_accuracy
@@ -55,3 +67,55 @@ VALIDATION:
55
67
  checks:
56
68
  - "5 predictions tested against held-out prompts"
57
69
  - "Accuracy below 3/5 is flagged in profile header"
70
+ 6:
71
+ id: V6
72
+ rule: bounded_signal_sufficiency
73
+ description: >-
74
+ Profile synthesis MUST consume the bounded signal tier published by
75
+ extraction, not all full evidence. The sufficiency gate reports
76
+ underrepresented source families with their retained and intended
77
+ counts and surfaces the limitation in the profile output and exit
78
+ signal rather than silently reducing confidence. Sufficiency is
79
+ assessed per family against the contract minimum_family_retention
80
+ threshold; a family with zero intended signals is not a violation.
81
+ severity: warning
82
+ checks:
83
+ - "Signal tier state, count, and sufficiency are read before synthesizing"
84
+ - "Underrepresented families are surfaced with retained and intended counts"
85
+ - "No high-confidence claims are fabricated from sparse or missing evidence"
86
+ 7:
87
+ id: V7
88
+ rule: personal_glossary_output
89
+ description: >-
90
+ After writing the base profile, Profile Full MUST consume only one existing
91
+ consent-bound user-local generation. The canonical publication operation
92
+ may render and persist exactly one owned Glossary section only after current
93
+ decision revalidation, and only for an explicit automatic admission.
94
+ Entries use only the shared primitive and personal provenance variants.
95
+ Replacement preserves every non-glossary byte, malformed or ambiguous
96
+ boundaries fail before effects, and personal production never reads a
97
+ project glossary.
98
+ severity: critical
99
+ checks:
100
+ - "Explicit publication retains exactly one current user-authored evidence anchor"
101
+ - "Inferred entries cannot receive automatic publication"
102
+ - "Non-glossary PROFILE.md bytes and decision-pattern confidence are unchanged"
103
+ - "No project glossary identity, path, parameter, import, or read is used"
104
+ - "Missing, failed, empty, degraded, or review-only mining preserves the base and owned section"
105
+ - "Degraded coverage performs no candidate classification, decision, review queue, or publication"
106
+ 8:
107
+ id: V8
108
+ rule: personal_glossary_lifecycle
109
+ description: >-
110
+ Established entries MUST survive regeneration without fresh evidence.
111
+ Confidence is deterministically derived from the retained confidence basis,
112
+ unchanged permanence class, injected date, existing Profile decay formula,
113
+ and floor; permanence and observed_at remain unchanged. Matching fresh
114
+ evidence follows the shared authority refresh rule. Lookup remains deferred.
115
+ severity: critical
116
+ checks:
117
+ - "Same-date replay is idempotent and decay never compounds from rendered confidence"
118
+ - "Stable, durable, and situational classes use their existing lambdas and floor"
119
+ - "Fresh evidence refreshes only matching meaning and provenance kind"
120
+ - "Glossary confidence never mutates decision-pattern confidence"
121
+ - "Question-capable hosts present only a bounded queued review set; other hosts use the durable queue"