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
@@ -0,0 +1,24 @@
1
+ import { loadYamlMappingFile } from "../core/yaml.js";
2
+ import { glossaryEntryAuthorityPath } from "./glossaryEntryContract.js";
3
+ function mapping(value) {
4
+ return value !== null && typeof value === "object" && !Array.isArray(value)
5
+ ? value
6
+ : null;
7
+ }
8
+ function exactPositiveLimit(value, expected) {
9
+ if (!Number.isSafeInteger(value) || value !== expected) {
10
+ throw new TypeError("personal glossary Profile Full contract is unavailable");
11
+ }
12
+ return value;
13
+ }
14
+ /** Load the bounded Profile Full integration settings from the glossary authority. */
15
+ export function personalGlossaryProfileFullContract(pathname = glossaryEntryAuthorityPath()) {
16
+ const authority = loadYamlMappingFile(pathname);
17
+ const profileFull = mapping(mapping(authority.personal_mining_authority)?.profile_full);
18
+ const existingGeneration = mapping(profileFull?.existing_generation);
19
+ const review = mapping(profileFull?.review);
20
+ return {
21
+ candidateListLimit: exactPositiveLimit(existingGeneration?.list_limit, 20),
22
+ questionReviewMaximum: exactPositiveLimit(review?.question_channel_maximum, 3),
23
+ };
24
+ }
@@ -0,0 +1,426 @@
1
+ import { createHash, verify as verifySignature } from "node:crypto";
2
+ function mapping(value) {
3
+ return value !== null && typeof value === "object" && !Array.isArray(value)
4
+ ? value
5
+ : null;
6
+ }
7
+ function strings(value) {
8
+ return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : [];
9
+ }
10
+ function sameStrings(actual, expected) {
11
+ return JSON.stringify(strings(actual)) === JSON.stringify(expected);
12
+ }
13
+ function nonEmpty(value) {
14
+ return typeof value === "string" && value.trim().length > 0;
15
+ }
16
+ function sha256Utf8(value) {
17
+ return createHash("sha256").update(value, "utf8").digest("hex");
18
+ }
19
+ const REVIEW_RECEIPT_FIELDS = [
20
+ "schema_version",
21
+ "issuer",
22
+ "subject",
23
+ "trusted_channel",
24
+ "review_id",
25
+ "candidate_id",
26
+ "candidate_revision",
27
+ "candidate_projection_sha256",
28
+ "semantic_fingerprint",
29
+ "generation",
30
+ "policy_version",
31
+ "disposition",
32
+ "corrected_meaning",
33
+ "corrected_scope",
34
+ "disposed_at",
35
+ "expires_at",
36
+ "nonce",
37
+ "signature",
38
+ ];
39
+ const REVIEW_RECEIPT_SIGNED_FIELDS = REVIEW_RECEIPT_FIELDS.filter((field) => field !== "signature");
40
+ export const PERSONAL_REVIEW_DISPOSITIONS = ["accept", "correct", "reject", "defer"];
41
+ function receiptField(receipt, field) {
42
+ const value = receipt[field];
43
+ if (typeof value !== "string" || value.length === 0) {
44
+ throw new TypeError(`review approval receipt field ${field} must be a non-empty string`);
45
+ }
46
+ return value;
47
+ }
48
+ function nullableReceiptField(receipt, field) {
49
+ const value = receipt[field];
50
+ if (value !== null && typeof value !== "string") {
51
+ throw new TypeError(`review approval receipt field ${field} must be a string or null`);
52
+ }
53
+ return value;
54
+ }
55
+ function signedReviewReceiptPayload(receipt) {
56
+ return JSON.stringify(Object.fromEntries(REVIEW_RECEIPT_SIGNED_FIELDS.map((field) => [
57
+ field,
58
+ ["corrected_meaning", "corrected_scope"].includes(field)
59
+ ? nullableReceiptField(receipt, field)
60
+ : receiptField(receipt, field),
61
+ ])));
62
+ }
63
+ export function personalReviewApprovalReceiptDigest(receipt) {
64
+ const payload = signedReviewReceiptPayload(receipt);
65
+ return sha256Utf8(JSON.stringify({
66
+ signed: JSON.parse(payload),
67
+ signature: receiptField(receipt, "signature"),
68
+ }));
69
+ }
70
+ export function personalReviewApprovalReplayStatus(receipt, consumedReceiptDigests = new Map(), replayNonceKey) {
71
+ const nonce = receiptField(receipt, "nonce");
72
+ const key = replayNonceKey ?? nonce;
73
+ if (typeof key !== "string" || key.length === 0) {
74
+ throw new TypeError("review approval replay nonce key must be a non-empty string");
75
+ }
76
+ const consumedDigest = consumedReceiptDigests.get(key);
77
+ if (!consumedDigest)
78
+ return "new";
79
+ return consumedDigest === personalReviewApprovalReceiptDigest(receipt)
80
+ ? "exact_replay"
81
+ : "conflicting_replay";
82
+ }
83
+ export function validatePersonalReviewApprovalReceipt(receipt, expected) {
84
+ const errors = [];
85
+ const extraFields = Object.keys(receipt).filter((field) => !REVIEW_RECEIPT_FIELDS.includes(field));
86
+ if (extraFields.length > 0)
87
+ errors.push(`review approval receipt has forbidden fields: ${extraFields.join(", ")}`);
88
+ let payload = "";
89
+ let signature = "";
90
+ try {
91
+ payload = signedReviewReceiptPayload(receipt);
92
+ signature = receiptField(receipt, "signature");
93
+ }
94
+ catch (error) {
95
+ errors.push(error.message);
96
+ }
97
+ if (receipt.schema_version !== "agentera.personalGlossaryReviewApproval.v1") {
98
+ errors.push("review approval receipt schema_version is invalid");
99
+ }
100
+ if (receipt.issuer !== "agentera-local-host") {
101
+ errors.push("review approval receipt issuer is not trusted");
102
+ }
103
+ if (receipt.subject !== expected.currentUserSubject ||
104
+ ["agent", "model", "imported_record", "generic_consent"].includes(String(receipt.subject))) {
105
+ errors.push("review approval receipt subject is not the trusted current user");
106
+ }
107
+ if (receipt.trusted_channel !== "agentera-local-host-ipc") {
108
+ errors.push("review approval receipt trusted channel is invalid");
109
+ }
110
+ if (receipt.review_id !== expected.reviewId) {
111
+ errors.push("review approval receipt review binding is invalid");
112
+ }
113
+ if (receipt.candidate_id !== expected.candidateId) {
114
+ errors.push("review approval receipt candidate binding is invalid");
115
+ }
116
+ if (receipt.candidate_revision !== expected.candidateRevision) {
117
+ errors.push("review approval receipt revision binding is invalid");
118
+ }
119
+ if (receipt.candidate_projection_sha256 !== expected.candidateProjectionSha256) {
120
+ errors.push("review approval receipt projection binding is invalid");
121
+ }
122
+ if (receipt.semantic_fingerprint !== expected.semanticFingerprint) {
123
+ errors.push("review approval receipt semantic fingerprint binding is invalid");
124
+ }
125
+ if (receipt.generation !== expected.generation) {
126
+ errors.push("review approval receipt generation binding is invalid");
127
+ }
128
+ if (receipt.policy_version !== expected.policyVersion) {
129
+ errors.push("review approval receipt policy binding is invalid");
130
+ }
131
+ if (!PERSONAL_REVIEW_DISPOSITIONS.includes(receipt.disposition)) {
132
+ errors.push("review approval receipt disposition is invalid");
133
+ }
134
+ if (receipt.disposition === "correct") {
135
+ if (typeof receipt.corrected_meaning !== "string" ||
136
+ receipt.corrected_meaning.trim().length === 0 ||
137
+ Buffer.byteLength(receipt.corrected_meaning, "utf8") > 4_096) {
138
+ errors.push("review approval receipt corrected_meaning is invalid");
139
+ }
140
+ if (receipt.corrected_scope !== "personal") {
141
+ errors.push("review approval receipt corrected_scope is invalid");
142
+ }
143
+ }
144
+ else if (receipt.corrected_meaning !== null || receipt.corrected_scope !== null) {
145
+ errors.push("review approval receipt correction fields are invalid");
146
+ }
147
+ const disposedAt = Date.parse(String(receipt.disposed_at));
148
+ const expiresAt = Date.parse(String(receipt.expires_at));
149
+ const now = expected.now.getTime();
150
+ if (!Number.isFinite(disposedAt) || !Number.isFinite(expiresAt)) {
151
+ errors.push("review approval receipt freshness timestamps are invalid");
152
+ }
153
+ else {
154
+ if (disposedAt > now)
155
+ errors.push("review approval receipt disposed_at is in the future");
156
+ if (now - disposedAt > 300_000)
157
+ errors.push("review approval receipt is stale");
158
+ if (expiresAt <= now || expiresAt <= disposedAt) {
159
+ errors.push("review approval receipt expires_at is not current");
160
+ }
161
+ if (expiresAt - disposedAt > 300_000) {
162
+ errors.push("review approval receipt freshness window is too long");
163
+ }
164
+ }
165
+ if (!/^[A-Za-z0-9_-]+$/.test(signature)) {
166
+ errors.push("review approval receipt signature encoding is invalid");
167
+ }
168
+ else if (payload) {
169
+ try {
170
+ if (!verifySignature(null, Buffer.from(payload, "utf8"), expected.trustedHostPublicKey, Buffer.from(signature, "base64url"))) {
171
+ errors.push("review approval receipt signature is not from the trusted host");
172
+ }
173
+ }
174
+ catch {
175
+ errors.push("review approval receipt signature verification failed");
176
+ }
177
+ }
178
+ try {
179
+ if (personalReviewApprovalReplayStatus(receipt, expected.consumedReceiptDigests, expected.replayNonceKey) === "conflicting_replay") {
180
+ errors.push("review approval receipt nonce was replayed with changed content");
181
+ }
182
+ }
183
+ catch (error) {
184
+ errors.push(error.message);
185
+ }
186
+ return errors;
187
+ }
188
+ export function personalReviewDispositionLifecycle(disposition) {
189
+ if (["accept", "correct", "reject"].includes(disposition))
190
+ return "terminal";
191
+ if (disposition === "defer")
192
+ return "pending";
193
+ throw new TypeError("review disposition is invalid");
194
+ }
195
+ export function projectPersonalReviewRetention(disposition, ageDays, purgeRequested = false) {
196
+ if (!Number.isFinite(ageDays) || ageDays < 0)
197
+ throw new TypeError("review age must be non-negative");
198
+ if (purgeRequested)
199
+ return { excerpt: "purged", metadata: "purged" };
200
+ if (personalReviewDispositionLifecycle(disposition) === "pending") {
201
+ return {
202
+ excerpt: ageDays >= 30 ? "expired" : "retained",
203
+ metadata: "retained",
204
+ };
205
+ }
206
+ return {
207
+ excerpt: "purged",
208
+ metadata: ageDays >= 90 ? "expired" : "retained",
209
+ };
210
+ }
211
+ /** Validate the authority-owned private review-record persistence and read contract. */
212
+ export function validatePersonalGlossaryReviewRecordsAuthority(authority) {
213
+ const mining = mapping(authority.personal_mining_authority);
214
+ const records = mapping(mining?.review_records);
215
+ const persistence = mapping(records?.persistence);
216
+ const compatibility = mapping(persistence?.compatibility);
217
+ const queue = mapping(records?.queue);
218
+ const queueCommand = mapping(queue?.command);
219
+ const request = mapping(queue?.request);
220
+ const queueResult = mapping(queue?.result);
221
+ const disposition = mapping(records?.disposition);
222
+ const dispositionCommand = mapping(disposition?.command);
223
+ const dispositionRequest = mapping(disposition?.request);
224
+ const dispositionResult = mapping(disposition?.result);
225
+ const publicationAuthorization = mapping(disposition?.publication_authorization);
226
+ const trustedHostKey = mapping(records?.trusted_host_key);
227
+ const retrieval = mapping(records?.retrieval);
228
+ const retrievalCommand = mapping(retrieval?.command);
229
+ const list = mapping(retrieval?.list);
230
+ const filters = mapping(list?.filters);
231
+ const cursor = mapping(list?.cursor);
232
+ const exact = mapping(retrieval?.exact);
233
+ const maintenance = mapping(records?.maintenance);
234
+ if (records?.status !== "active" ||
235
+ records?.owner !== "user_local_review_lifecycle" ||
236
+ records?.runtime !==
237
+ "packages/cli/src/analytics/personalGlossaryReviewRecords.ts#queuePersonalGlossaryReviewRecord" ||
238
+ records?.input !== "current_validated_review_required_cli_decision_and_host_receipt" ||
239
+ persistence?.root !== "$AGENTERA_PROFILE_DIR/intermediate/personal-glossary" ||
240
+ persistence?.file !== "review-records.json" ||
241
+ persistence?.schema_version !== "agentera.personalGlossaryReviewStore.v2" ||
242
+ persistence?.record_schema_version !== "agentera.personalGlossaryReviewRecord.v2" ||
243
+ persistence?.owner !== "current_user" ||
244
+ !sameStrings(persistence?.fields, ["schema_version", "owner", "records", "replay_index", "store_sha256"]) ||
245
+ !sameStrings(persistence?.record_fields, [
246
+ "schema_version",
247
+ "owner",
248
+ "review_id",
249
+ "candidate_id",
250
+ "candidate_revision",
251
+ "candidate_capsule_sha256",
252
+ "candidate_projection_sha256",
253
+ "host_receipt_sha256",
254
+ "cli_decision_sha256",
255
+ "semantic_fingerprint",
256
+ "generation",
257
+ "policy_version",
258
+ "scope",
259
+ "reason",
260
+ "status",
261
+ "disposition",
262
+ "review_record",
263
+ "reopen_reason",
264
+ "queued_at",
265
+ "terminal_at",
266
+ "expires_at",
267
+ "record_sha256",
268
+ ]) ||
269
+ persistence?.records_max !== 100 ||
270
+ !sameStrings(persistence?.replay_index_fields, ["nonce_sha256", "receipt_sha256", "expires_at"]) ||
271
+ persistence?.replay_entries_max !== 100 ||
272
+ persistence?.record_max_serialized_utf8_bytes !== 8_192 ||
273
+ persistence?.max_serialized_utf8_bytes !== 1_048_576 ||
274
+ persistence?.canonicalization !== "candidate_contracts.canonicalization" ||
275
+ persistence?.order !== "review_id_asc" ||
276
+ persistence?.replay !== "exact_current_binding_is_unchanged_replay_and_exact_receipt_is_idempotent" ||
277
+ persistence?.conflict !== "changed_receipt_nonce_binding_or_signature_fails_before_effects" ||
278
+ !sameStrings(compatibility?.accepted_store_schema_versions, [
279
+ "agentera.personalGlossaryReviewStore.v1",
280
+ "agentera.personalGlossaryReviewStore.v2",
281
+ ]) ||
282
+ !sameStrings(compatibility?.accepted_record_schema_versions, [
283
+ "agentera.personalGlossaryPendingReviewRecord.v1",
284
+ "agentera.personalGlossaryReviewRecord.v2",
285
+ ]) ||
286
+ compatibility?.read_mutation !== "forbidden" ||
287
+ compatibility?.migration_operation !== "disposition_only" ||
288
+ compatibility?.scope_derivation !== "current_validated_host_receipt_only" ||
289
+ compatibility?.invalid_behavior !== "fail_before_effects" ||
290
+ !sameStrings(compatibility?.preserved_bindings, [
291
+ "review_id",
292
+ "candidate_id",
293
+ "candidate_revision",
294
+ "candidate_capsule_sha256",
295
+ "candidate_projection_sha256",
296
+ "host_receipt_sha256",
297
+ "cli_decision_sha256",
298
+ "semantic_fingerprint",
299
+ "generation",
300
+ "policy_version",
301
+ "reason",
302
+ ]) ||
303
+ compatibility?.legacy_digest !== "validate_before_migration" ||
304
+ compatibility?.migrated_digest !== "reseal_v2_lifecycle_record" ||
305
+ !nonEmpty(compatibility?.rule) ||
306
+ !sameStrings(persistence?.suppression_binding, ["candidate_id", "semantic_fingerprint", "scope", "policy_version"]) ||
307
+ !sameStrings(persistence?.suppression_dispositions, ["reject", "defer"]) ||
308
+ !sameStrings(persistence?.reopen_reasons, ["policy_changed", "scope_changed", "meaning_changed"]) ||
309
+ persistence?.project_storage !== "forbidden" ||
310
+ !sameStrings(persistence?.forbidden_fields, [
311
+ "term",
312
+ "meaning",
313
+ "excerpt",
314
+ "raw_evidence",
315
+ "source_id",
316
+ "evidence_anchor",
317
+ "session_id",
318
+ "project_id",
319
+ "source_path",
320
+ "tool_content",
321
+ "review_approval",
322
+ "signature",
323
+ "nonce",
324
+ ]) ||
325
+ !nonEmpty(persistence?.rule) ||
326
+ trustedHostKey?.root !== "$AGENTERA_PROFILE_DIR/intermediate/personal-glossary" ||
327
+ trustedHostKey?.file !== "trusted-local-host.json" ||
328
+ trustedHostKey?.schema_version !== "agentera.personalGlossaryTrustedLocalHost.v1" ||
329
+ !sameStrings(trustedHostKey?.fields, ["schema_version", "owner", "subject", "public_key_spki_base64url"]) ||
330
+ trustedHostKey?.owner !== "current_user" ||
331
+ trustedHostKey?.public_key_algorithm !== "ed25519" ||
332
+ trustedHostKey?.max_serialized_utf8_bytes !== 4_096 ||
333
+ !nonEmpty(trustedHostKey?.rule) ||
334
+ queueCommand?.canonical !== "npx -y agentera@next report personal-glossary-reviews" ||
335
+ queueCommand?.namespace !== "report" ||
336
+ queueCommand?.input_flag !== "--input" ||
337
+ queueCommand?.stdin_value !== "-" ||
338
+ queueCommand?.format !== "json" ||
339
+ queueCommand?.project_checkout !== "not_required" ||
340
+ request?.schema_version !== "agentera.personalGlossaryReviewQueueRequest.v1" ||
341
+ !sameStrings(request?.required_fields, ["schema_version", "receipt"]) ||
342
+ request?.additional_fields !== "forbidden" ||
343
+ request?.max_utf8_bytes !== 16_384 ||
344
+ queue?.decision_outcome !== "review_required" ||
345
+ !sameStrings(queue?.current_bindings, [
346
+ "candidate_id",
347
+ "candidate_revision",
348
+ "candidate_capsule_sha256",
349
+ "candidate_projection_sha256",
350
+ "host_receipt_sha256",
351
+ "cli_decision_sha256",
352
+ "semantic_fingerprint",
353
+ "generation",
354
+ "policy_version",
355
+ "reason",
356
+ ]) ||
357
+ queueResult?.schema_version !== "agentera.personalGlossaryReviewQueueResult.v1" ||
358
+ !sameStrings(queueResult?.statuses, ["queued", "unchanged_replay", "suppressed", "reopened"]) ||
359
+ queueResult?.max_utf8_bytes !== 4_096 ||
360
+ queue?.no_question_channel !== "queue_without_prompt_or_disposition" ||
361
+ !nonEmpty(queue?.rule) ||
362
+ dispositionCommand?.canonical !== "npx -y agentera@next report personal-glossary-reviews" ||
363
+ dispositionCommand?.namespace !== "report" ||
364
+ dispositionCommand?.input_flag !== "--input" ||
365
+ dispositionCommand?.stdin_value !== "-" ||
366
+ dispositionCommand?.format !== "json" ||
367
+ dispositionCommand?.project_checkout !== "not_required" ||
368
+ dispositionRequest?.schema_version !== "agentera.personalGlossaryReviewDispositionRequest.v1" ||
369
+ !sameStrings(dispositionRequest?.required_fields, ["schema_version", "review_id", "receipt", "approval"]) ||
370
+ dispositionRequest?.additional_fields !== "forbidden" ||
371
+ dispositionRequest?.max_utf8_bytes !== 16_384 ||
372
+ dispositionResult?.schema_version !== "agentera.personalGlossaryReviewDispositionResult.v1" ||
373
+ !sameStrings(dispositionResult?.statuses, ["disposed", "unchanged_replay"]) ||
374
+ dispositionResult?.max_utf8_bytes !== 4_096 ||
375
+ !sameStrings(publicationAuthorization?.dispositions, ["accept", "correct"]) ||
376
+ !sameStrings(publicationAuthorization?.fields, ["review_id", "review_record_sha256"]) ||
377
+ !nonEmpty(disposition?.rule) ||
378
+ retrievalCommand?.canonical !== "npx -y agentera@next report personal-glossary-reviews" ||
379
+ retrievalCommand?.namespace !== "report" ||
380
+ retrievalCommand?.format !== "json" ||
381
+ retrievalCommand?.project_checkout !== "not_required" ||
382
+ retrieval?.owner !== "current_user" ||
383
+ retrieval?.schema_version !== "agentera.personalGlossaryReviewRetrieval.v1" ||
384
+ list?.default_limit !== 20 ||
385
+ list?.maximum_limit !== 50 ||
386
+ list?.max_serialized_utf8_bytes !== 32_768 ||
387
+ list?.order !== "queued_at_desc_then_review_id_asc" ||
388
+ !sameStrings(filters?.status, ["pending", "terminal"]) ||
389
+ cursor?.authority !==
390
+ "references/artifacts/state-storage-authority.yaml#entity_target.public_retrieval.policy.cursor" ||
391
+ cursor?.vocabulary !== "opaque_snapshot_cursor" ||
392
+ !sameStrings(cursor?.binding, ["collection", "owner", "filters", "limit", "order", "snapshot"]) ||
393
+ cursor?.invalid_behavior !== "cursor_invalid" ||
394
+ cursor?.unavailable_behavior !== "cursor_snapshot_unavailable" ||
395
+ !nonEmpty(list?.summaries) ||
396
+ !sameStrings(exact?.required_bindings, [
397
+ "review_id",
398
+ "candidate_id",
399
+ "candidate_revision",
400
+ "generation",
401
+ "policy_version",
402
+ ]) ||
403
+ exact?.current_binding_field !== "candidate_projection_sha256" ||
404
+ exact?.max_serialized_utf8_bytes !== 8_192 ||
405
+ !nonEmpty(exact?.rule) ||
406
+ !nonEmpty(retrieval?.rule) ||
407
+ maintenance?.entrypoint !==
408
+ "packages/cli/src/analytics/personalGlossaryReviewRecords.ts#maintainPersonalGlossaryReviewRecords" ||
409
+ maintenance?.exposure !== "authenticated_review_owner_only" ||
410
+ maintenance?.terminal_metadata_days !== 90 ||
411
+ maintenance?.pending_metadata !== "retained_until_terminal_or_purge" ||
412
+ maintenance?.cache !== "replay_index_until_receipt_expiry" ||
413
+ maintenance?.purge !== "current_user_authorized_review_records_only" ||
414
+ !sameStrings(maintenance?.forbidden_effects, [
415
+ "profile_entry",
416
+ "project_state",
417
+ "candidate_projection",
418
+ "publication",
419
+ ]) ||
420
+ !nonEmpty(maintenance?.rule)) {
421
+ return [
422
+ "personal_mining_authority review records must remain bounded, current-user local, privacy-safe, replay-safe, and independently retained",
423
+ ];
424
+ }
425
+ return [];
426
+ }
@@ -0,0 +1,129 @@
1
+ import { loadYamlMappingFile } from "../core/yaml.js";
2
+ import { projectGlossaryDevelopmentValue } from "../core/developmentInvocation.js";
3
+ import { glossaryEntryAuthorityPath } from "./glossaryEntryContract.js";
4
+ function mapping(value) {
5
+ return value !== null && typeof value === "object" && !Array.isArray(value)
6
+ ? value
7
+ : null;
8
+ }
9
+ function strings(value) {
10
+ return Array.isArray(value) && value.every((item) => typeof item === "string")
11
+ ? [...value]
12
+ : [];
13
+ }
14
+ /** Load the authority-owned private review persistence, retrieval, and maintenance settings. */
15
+ export function personalGlossaryReviewRecordsContract(pathname = glossaryEntryAuthorityPath()) {
16
+ const authority = loadYamlMappingFile(pathname);
17
+ const mining = mapping(authority.personal_mining_authority);
18
+ const records = mapping(mining?.review_records);
19
+ const persistence = mapping(records?.persistence);
20
+ const compatibility = mapping(persistence?.compatibility);
21
+ const queue = mapping(records?.queue);
22
+ const queueCommand = mapping(queue?.command);
23
+ const request = mapping(queue?.request);
24
+ const queueResult = mapping(queue?.result);
25
+ const disposition = mapping(records?.disposition);
26
+ const dispositionCommand = mapping(disposition?.command);
27
+ const dispositionRequest = mapping(disposition?.request);
28
+ const dispositionResult = mapping(disposition?.result);
29
+ const publicationAuthorization = mapping(disposition?.publication_authorization);
30
+ const trustedHostKey = mapping(records?.trusted_host_key);
31
+ const retrieval = mapping(records?.retrieval);
32
+ const retrievalCommand = mapping(retrieval?.command);
33
+ const list = mapping(retrieval?.list);
34
+ const filters = mapping(list?.filters);
35
+ const cursor = mapping(list?.cursor);
36
+ const exact = mapping(retrieval?.exact);
37
+ const maintenance = mapping(records?.maintenance);
38
+ const command = projectGlossaryDevelopmentValue(queueCommand?.canonical, "review_records.command");
39
+ const retrievalCommandValue = projectGlossaryDevelopmentValue(retrievalCommand?.canonical, "review_records.command");
40
+ if (command !== retrievalCommandValue) {
41
+ throw new TypeError("invalid development command projection: personal glossary review commands differ");
42
+ }
43
+ const dispositionCommandValue = projectGlossaryDevelopmentValue(dispositionCommand?.canonical, "review_records.command");
44
+ if (command !== dispositionCommandValue) {
45
+ throw new TypeError("invalid development command projection: personal glossary review disposition commands differ");
46
+ }
47
+ return {
48
+ command,
49
+ queueRequestSchemaVersion: typeof request?.schema_version === "string" ? request.schema_version : "",
50
+ queueRequestFields: strings(request?.required_fields),
51
+ queueMaxRequestUtf8Bytes: typeof request?.max_utf8_bytes === "number" ? request.max_utf8_bytes : 0,
52
+ queueDecisionOutcome: typeof queue?.decision_outcome === "string" ? queue.decision_outcome : "",
53
+ queueCurrentBindings: strings(queue?.current_bindings),
54
+ queueResultSchemaVersion: typeof queueResult?.schema_version === "string" ? queueResult.schema_version : "",
55
+ queueResultStatuses: strings(queueResult?.statuses),
56
+ queueMaxResultUtf8Bytes: typeof queueResult?.max_utf8_bytes === "number" ? queueResult.max_utf8_bytes : 0,
57
+ queueNoQuestionChannel: typeof queue?.no_question_channel === "string" ? queue.no_question_channel : "",
58
+ dispositionRequestSchemaVersion: typeof dispositionRequest?.schema_version === "string" ? dispositionRequest.schema_version : "",
59
+ dispositionRequestFields: strings(dispositionRequest?.required_fields),
60
+ dispositionMaxRequestUtf8Bytes: typeof dispositionRequest?.max_utf8_bytes === "number" ? dispositionRequest.max_utf8_bytes : 0,
61
+ dispositionResultSchemaVersion: typeof dispositionResult?.schema_version === "string" ? dispositionResult.schema_version : "",
62
+ dispositionResultStatuses: strings(dispositionResult?.statuses),
63
+ dispositionMaxResultUtf8Bytes: typeof dispositionResult?.max_utf8_bytes === "number" ? dispositionResult.max_utf8_bytes : 0,
64
+ dispositionPublicationAuthorizationDispositions: strings(publicationAuthorization?.dispositions),
65
+ dispositionPublicationAuthorizationFields: strings(publicationAuthorization?.fields),
66
+ trustedHostKeyFile: typeof trustedHostKey?.file === "string" ? trustedHostKey.file : "",
67
+ trustedHostKeySchemaVersion: typeof trustedHostKey?.schema_version === "string" ? trustedHostKey.schema_version : "",
68
+ trustedHostKeyFields: strings(trustedHostKey?.fields),
69
+ trustedHostKeyOwner: typeof trustedHostKey?.owner === "string" ? trustedHostKey.owner : "",
70
+ trustedHostKeyAlgorithm: typeof trustedHostKey?.public_key_algorithm === "string" ? trustedHostKey.public_key_algorithm : "",
71
+ trustedHostKeyMaxSerializedUtf8Bytes: typeof trustedHostKey?.max_serialized_utf8_bytes === "number"
72
+ ? trustedHostKey.max_serialized_utf8_bytes
73
+ : 0,
74
+ storeSchemaVersion: typeof persistence?.schema_version === "string" ? persistence.schema_version : "",
75
+ recordSchemaVersion: typeof persistence?.record_schema_version === "string" ? persistence.record_schema_version : "",
76
+ storeOwner: typeof persistence?.owner === "string" ? persistence.owner : "",
77
+ storeFile: typeof persistence?.file === "string" ? persistence.file : "",
78
+ storeFields: strings(persistence?.fields),
79
+ recordFields: strings(persistence?.record_fields),
80
+ recordsMax: typeof persistence?.records_max === "number" ? persistence.records_max : 0,
81
+ replayIndexFields: strings(persistence?.replay_index_fields),
82
+ replayEntriesMax: typeof persistence?.replay_entries_max === "number" ? persistence.replay_entries_max : 0,
83
+ recordMaxSerializedUtf8Bytes: typeof persistence?.record_max_serialized_utf8_bytes === "number"
84
+ ? persistence.record_max_serialized_utf8_bytes
85
+ : 0,
86
+ storeMaxSerializedUtf8Bytes: typeof persistence?.max_serialized_utf8_bytes === "number"
87
+ ? persistence.max_serialized_utf8_bytes
88
+ : 0,
89
+ storeOrder: typeof persistence?.order === "string" ? persistence.order : "",
90
+ replay: typeof persistence?.replay === "string" ? persistence.replay : "",
91
+ conflict: typeof persistence?.conflict === "string" ? persistence.conflict : "",
92
+ compatibilityStoreSchemaVersions: strings(compatibility?.accepted_store_schema_versions),
93
+ compatibilityRecordSchemaVersions: strings(compatibility?.accepted_record_schema_versions),
94
+ compatibilityReadMutation: typeof compatibility?.read_mutation === "string" ? compatibility.read_mutation : "",
95
+ compatibilityMigrationOperation: typeof compatibility?.migration_operation === "string" ? compatibility.migration_operation : "",
96
+ compatibilityScopeDerivation: typeof compatibility?.scope_derivation === "string" ? compatibility.scope_derivation : "",
97
+ compatibilityInvalidBehavior: typeof compatibility?.invalid_behavior === "string" ? compatibility.invalid_behavior : "",
98
+ compatibilityPreservedBindings: strings(compatibility?.preserved_bindings),
99
+ compatibilityLegacyDigest: typeof compatibility?.legacy_digest === "string" ? compatibility.legacy_digest : "",
100
+ compatibilityMigratedDigest: typeof compatibility?.migrated_digest === "string" ? compatibility.migrated_digest : "",
101
+ suppressionBinding: strings(persistence?.suppression_binding),
102
+ suppressionDispositions: strings(persistence?.suppression_dispositions),
103
+ reopenReasons: strings(persistence?.reopen_reasons),
104
+ forbiddenFields: strings(persistence?.forbidden_fields),
105
+ retrievalSchemaVersion: typeof retrieval?.schema_version === "string" ? retrieval.schema_version : "",
106
+ retrievalOwner: typeof retrieval?.owner === "string" ? retrieval.owner : "",
107
+ listDefaultLimit: typeof list?.default_limit === "number" ? list.default_limit : 0,
108
+ listMaximumLimit: typeof list?.maximum_limit === "number" ? list.maximum_limit : 0,
109
+ listMaxSerializedUtf8Bytes: typeof list?.max_serialized_utf8_bytes === "number" ? list.max_serialized_utf8_bytes : 0,
110
+ listOrder: typeof list?.order === "string" ? list.order : "",
111
+ listStatuses: strings(filters?.status),
112
+ cursorAuthority: typeof cursor?.authority === "string" ? cursor.authority : "",
113
+ cursorVocabulary: typeof cursor?.vocabulary === "string" ? cursor.vocabulary : "",
114
+ cursorBinding: strings(cursor?.binding),
115
+ cursorInvalidBehavior: typeof cursor?.invalid_behavior === "string" ? cursor.invalid_behavior : "",
116
+ cursorUnavailableBehavior: typeof cursor?.unavailable_behavior === "string" ? cursor.unavailable_behavior : "",
117
+ exactRequiredBindings: strings(exact?.required_bindings),
118
+ exactCurrentBindingField: typeof exact?.current_binding_field === "string" ? exact.current_binding_field : "",
119
+ exactMaxSerializedUtf8Bytes: typeof exact?.max_serialized_utf8_bytes === "number"
120
+ ? exact.max_serialized_utf8_bytes
121
+ : 0,
122
+ terminalMetadataDays: typeof maintenance?.terminal_metadata_days === "number"
123
+ ? maintenance.terminal_metadata_days
124
+ : 0,
125
+ maintenanceExposure: typeof maintenance?.exposure === "string" ? maintenance.exposure : "",
126
+ maintenancePurge: typeof maintenance?.purge === "string" ? maintenance.purge : "",
127
+ maintenanceForbiddenEffects: strings(maintenance?.forbidden_effects),
128
+ };
129
+ }