agentera 3.0.0-dev.7 → 3.0.0-dev.72

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 (723) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +118 -22
  3. package/bundle/CHANGELOG.md +1361 -0
  4. package/bundle/DESIGN.md +229 -0
  5. package/bundle/LICENSE +201 -0
  6. package/bundle/README.md +143 -0
  7. package/bundle/UPGRADE.md +252 -0
  8. package/bundle/extract-corpus-parity.json +2 -4
  9. package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
  10. package/bundle/references/adapters/package-publication.json +488 -0
  11. package/bundle/references/adapters/package-registry.yaml +435 -188
  12. package/bundle/references/adapters/package-surface-characterization.md +66 -34
  13. package/bundle/references/adapters/runtime-lifecycle-adapters.yaml +74 -0
  14. package/bundle/references/adapters/runtime-lifecycle-authority.yaml +62 -0
  15. package/bundle/references/adapters/runtime-lifecycle-operation-contract.yaml +84 -0
  16. package/bundle/references/adapters/runtime-retired-resources.yaml +333 -0
  17. package/bundle/references/analysis/evidence-tier-authority.yaml +518 -0
  18. package/bundle/references/analysis/verification-policy.yaml +266 -0
  19. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +17 -8
  20. package/bundle/references/artifacts/glossary-entry-contract.yaml +1254 -0
  21. package/bundle/references/artifacts/state-storage-authority.yaml +3061 -0
  22. package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
  23. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +3 -4
  24. package/bundle/references/cli/capability-instruction-contract.yaml +11 -14
  25. package/bundle/references/cli/hybrid-route-contract.yaml +438 -0
  26. package/bundle/references/cli/routing-model.md +152 -93
  27. package/bundle/references/cli/trigger-schema-enrichment.md +57 -46
  28. package/bundle/references/cli/update-channels.yaml +4 -2
  29. package/bundle/references/cli/vocabulary-index.yaml +5 -7
  30. package/bundle/references/cli/vocabulary.md +51 -93
  31. package/bundle/references/meta/retained-reference-authority.yaml +151 -0
  32. package/bundle/skills/agentera/SKILL.md +183 -63
  33. package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +27 -19
  34. package/bundle/skills/agentera/capabilities/audit/schemas/exit.yaml +2 -2
  35. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +13 -35
  36. package/bundle/skills/agentera/capabilities/audit/schemas/validation.yaml +30 -11
  37. package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +44 -21
  38. package/bundle/skills/agentera/capabilities/build/schemas/exit.yaml +8 -6
  39. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +14 -36
  40. package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +95 -21
  41. package/bundle/skills/agentera/capabilities/design/schemas/artifacts.yaml +6 -6
  42. package/bundle/skills/agentera/capabilities/design/schemas/exit.yaml +5 -5
  43. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +5 -34
  44. package/bundle/skills/agentera/capabilities/design/schemas/validation.yaml +2 -2
  45. package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +17 -13
  46. package/bundle/skills/agentera/capabilities/discuss/schemas/exit.yaml +2 -2
  47. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +6 -40
  48. package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +72 -5
  49. package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +24 -17
  50. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +5 -35
  51. package/bundle/skills/agentera/capabilities/document/schemas/validation.yaml +13 -13
  52. package/bundle/skills/agentera/capabilities/optimize/schemas/artifacts.yaml +10 -10
  53. package/bundle/skills/agentera/capabilities/optimize/schemas/exit.yaml +2 -2
  54. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +4 -35
  55. package/bundle/skills/agentera/capabilities/optimize/schemas/validation.yaml +3 -3
  56. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +34 -22
  57. package/bundle/skills/agentera/capabilities/orchestrate/schemas/exit.yaml +9 -7
  58. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +5 -37
  59. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +38 -37
  60. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +20 -16
  61. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +8 -31
  62. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +66 -6
  63. package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +9 -4
  64. package/bundle/skills/agentera/capabilities/profile/schemas/exit.yaml +4 -4
  65. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +8 -37
  66. package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +61 -3
  67. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +6 -6
  68. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +5 -29
  69. package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +13 -12
  70. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +7 -49
  71. package/bundle/skills/agentera/capabilities/vision/schemas/artifacts.yaml +8 -8
  72. package/bundle/skills/agentera/capabilities/vision/schemas/exit.yaml +7 -6
  73. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +7 -39
  74. package/bundle/skills/agentera/capabilities/vision/schemas/validation.yaml +14 -16
  75. package/bundle/skills/agentera/capability_schema_contract.yaml +32 -32
  76. package/bundle/skills/agentera/protocol.yaml +4 -4
  77. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  78. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +1 -0
  79. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +30 -12
  80. package/bundle/skills/agentera/schemas/artifacts/design.yaml +1 -0
  81. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +7 -12
  82. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +140 -9
  83. package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +82 -0
  84. package/bundle/skills/agentera/schemas/artifacts/health.yaml +56 -19
  85. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +18 -4
  86. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +457 -32
  87. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +131 -18
  88. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +302 -7
  89. package/dist/analytics/extractCorpus/cli.js +52 -11
  90. package/dist/analytics/extractCorpus/copilotSessions.js +6 -4
  91. package/dist/analytics/extractCorpus/core.js +40 -12
  92. package/dist/analytics/extractCorpus/corpus.js +39 -17
  93. package/dist/analytics/extractCorpus/coverageAudit.js +44 -45
  94. package/dist/analytics/extractCorpus/cursorSessions.js +6 -4
  95. package/dist/analytics/extractCorpus/evidenceTiers.js +603 -0
  96. package/dist/analytics/extractCorpus/extractCorpusParity.js +4 -4
  97. package/dist/analytics/extractCorpus/filesystemSources.js +1 -5
  98. package/dist/analytics/extractCorpus/index.js +3 -1
  99. package/dist/analytics/extractCorpus/jsonlSessions.js +24 -5
  100. package/dist/analytics/extractCorpus/sqliteCaps.js +0 -1
  101. package/dist/analytics/extractCorpus/sqliteSessions.js +0 -1
  102. package/dist/analytics/extractCorpus/tierReader.js +108 -0
  103. package/dist/analytics/extractCorpus.js +0 -1
  104. package/dist/analytics/glossaryAdviceResolution.js +166 -0
  105. package/dist/analytics/glossaryInputAcquisition.js +319 -0
  106. package/dist/analytics/personalGlossaryAdmission.js +133 -0
  107. package/dist/analytics/personalGlossaryProfile.js +219 -0
  108. package/dist/analytics/profileSignals.js +211 -0
  109. package/dist/analytics/usageStats.js +150 -23
  110. package/dist/audit/terminologyDrift.js +281 -0
  111. package/dist/bin/agentera.js +3 -2
  112. package/dist/capabilities/audit/instructions.js +16 -6
  113. package/dist/capabilities/build/instructions.js +59 -6
  114. package/dist/capabilities/design/instructions.js +3 -4
  115. package/dist/capabilities/discuss/instructions.js +29 -6
  116. package/dist/capabilities/document/instructions.js +11 -6
  117. package/dist/capabilities/index.js +16 -14
  118. package/dist/capabilities/optimize/instructions.js +14 -6
  119. package/dist/capabilities/orchestrate/instructions.js +42 -6
  120. package/dist/capabilities/plan/instructions.js +30 -3
  121. package/dist/capabilities/profile/instructions.js +70 -6
  122. package/dist/capabilities/research/instructions.js +4 -5
  123. package/dist/capabilities/status/instructions.js +15 -6
  124. package/dist/capabilities/status/startupInstructions.js +34 -0
  125. package/dist/capabilities/vision/instructions.js +3 -5
  126. package/dist/cli/appContext.js +14 -7
  127. package/dist/cli/argvalidate.js +0 -1
  128. package/dist/cli/capabilityContext/benchmark.js +5 -4
  129. package/dist/cli/capabilityContext/bespoke.js +14 -6
  130. package/dist/cli/capabilityContext/build.js +116 -42
  131. package/dist/cli/capabilityContext/closeout.js +30 -27
  132. package/dist/cli/capabilityContext/contract.js +18 -27
  133. package/dist/cli/capabilityContext/evidence.js +84 -77
  134. package/dist/cli/capabilityContext/index.js +0 -1
  135. package/dist/cli/capabilityContext/orchestration.js +42 -18
  136. package/dist/cli/capabilityContext/planState.js +89 -96
  137. package/dist/cli/capabilityContext/progress.js +51 -12
  138. package/dist/cli/capabilityContext/projectVerification.js +409 -0
  139. package/dist/cli/capabilityContext/shared.js +9 -20
  140. package/dist/cli/capabilityContext/slim.js +52 -8
  141. package/dist/cli/capabilityContext/startup.js +51 -114
  142. package/dist/cli/capabilityContext/startupAggregation.js +68 -0
  143. package/dist/cli/capabilityContext/types.js +26 -10
  144. package/dist/cli/capabilityContext.js +0 -1
  145. package/dist/cli/commands/appHome.js +0 -1
  146. package/dist/cli/commands/capability.js +2 -2
  147. package/dist/cli/commands/compact.js +163 -13
  148. package/dist/cli/commands/doctor.js +117 -11
  149. package/dist/cli/commands/durability.js +81 -0
  150. package/dist/cli/commands/glossaryAdvice.js +138 -0
  151. package/dist/cli/commands/lint.js +22 -8
  152. package/dist/cli/commands/personalGlossary.js +176 -0
  153. package/dist/cli/commands/prime/briefOrientation.js +746 -0
  154. package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
  155. package/dist/cli/commands/prime/bundleStatus.js +54 -4
  156. package/dist/cli/commands/prime/collectEntityOrientation.js +326 -0
  157. package/dist/cli/commands/prime/collectOrientationState.js +126 -63
  158. package/dist/cli/commands/prime/orientationOutput.js +267 -56
  159. package/dist/cli/commands/prime/types.js +0 -1
  160. package/dist/cli/commands/prime/v1Migration.js +0 -1
  161. package/dist/cli/commands/prime.js +76 -11
  162. package/dist/cli/commands/profileGrounding.js +55 -0
  163. package/dist/cli/commands/query.js +74 -52
  164. package/dist/cli/commands/report.js +73 -19
  165. package/dist/cli/commands/route.js +142 -0
  166. package/dist/cli/commands/schema.js +257 -138
  167. package/dist/cli/commands/state/decisions.js +40 -56
  168. package/dist/cli/commands/state/docs.js +58 -85
  169. package/dist/cli/commands/state/experimentRecords.js +151 -0
  170. package/dist/cli/commands/state/experiments.js +11 -65
  171. package/dist/cli/commands/state/get.js +129 -0
  172. package/dist/cli/commands/state/health.js +11 -113
  173. package/dist/cli/commands/state/index.js +6 -41
  174. package/dist/cli/commands/state/list.js +194 -0
  175. package/dist/cli/commands/state/objective.js +21 -65
  176. package/dist/cli/commands/state/plan.js +11 -170
  177. package/dist/cli/commands/state/planTasks.js +154 -0
  178. package/dist/cli/commands/state/plans.js +154 -0
  179. package/dist/cli/commands/state/progress.js +11 -45
  180. package/dist/cli/commands/state/shared.js +0 -1
  181. package/dist/cli/commands/state/todo.js +28 -107
  182. package/dist/cli/commands/state/write.js +433 -0
  183. package/dist/cli/commands/upgrade.js +146 -5
  184. package/dist/cli/commands/upgradeVerify.js +118 -0
  185. package/dist/cli/commands/validate.js +235 -136
  186. package/dist/cli/commands/verify.js +23 -8
  187. package/dist/cli/contracts/bundleStatus.js +0 -1
  188. package/dist/cli/contracts/orientationState.js +0 -1
  189. package/dist/cli/dispatch/argvParser.js +0 -1
  190. package/dist/cli/dispatch/check.js +84 -40
  191. package/dist/cli/dispatch/commands.js +3 -3
  192. package/dist/cli/dispatch/index.js +77 -52
  193. package/dist/cli/dispatch/lifecycle.js +117 -62
  194. package/dist/cli/dispatch/prime.js +37 -2
  195. package/dist/cli/dispatch/projections.js +17 -0
  196. package/dist/cli/dispatch/shared.js +1 -2
  197. package/dist/cli/dispatch/state.js +62 -66
  198. package/dist/cli/dispatch.js +0 -1
  199. package/dist/cli/errors.js +16 -17
  200. package/dist/cli/help.js +358 -39
  201. package/dist/cli/migrationRequired.js +122 -0
  202. package/dist/cli/orientation/attention.js +19 -19
  203. package/dist/cli/orientation/corpusCoverage.js +32 -1
  204. package/dist/cli/orientation.js +346 -129
  205. package/dist/cli/planArtifacts.js +350 -0
  206. package/dist/cli/planEvidence.js +157 -0
  207. package/dist/cli/planLifecycleState.js +36 -0
  208. package/dist/cli/planTaskIndex.js +11 -0
  209. package/dist/cli/preCutoverCommand.js +32 -0
  210. package/dist/cli/prime-blob.js +71 -3
  211. package/dist/cli/profileAcquisition.js +167 -0
  212. package/dist/cli/startupCompletenessContract.js +11 -8
  213. package/dist/cli/stateQuery.js +47 -12
  214. package/dist/cli/structured.js +0 -1
  215. package/dist/cli/todoMarkdown.js +25 -12
  216. package/dist/cli/todoReadinessSelection.js +192 -0
  217. package/dist/cli/todoSeverity.js +0 -1
  218. package/dist/core/atomicWriter.js +20 -0
  219. package/dist/core/developmentChannel.js +1 -0
  220. package/dist/core/developmentInvocation.js +374 -0
  221. package/dist/core/difflib.js +0 -1
  222. package/dist/core/envPaths.js +0 -1
  223. package/dist/core/jsonValue.js +0 -1
  224. package/dist/core/paths.js +0 -1
  225. package/dist/core/pyjson.js +0 -1
  226. package/dist/core/shell.js +4 -0
  227. package/dist/core/skillIdentity.js +23 -0
  228. package/dist/core/sourceRoot.js +9 -12
  229. package/dist/core/text.js +10 -0
  230. package/dist/core/toml.js +0 -1
  231. package/dist/core/yaml.js +8 -1
  232. package/dist/eval/evalSkills.js +13 -14
  233. package/dist/eval/hybridRouteEvaluation.js +155 -0
  234. package/dist/eval/semanticEval.js +0 -1
  235. package/dist/eval/semanticFixtures.js +0 -1
  236. package/dist/hooks/common.js +3 -56
  237. package/dist/hooks/compaction/apply.js +224 -47
  238. package/dist/hooks/compaction/dryRun.js +2 -1
  239. package/dist/hooks/compaction/index.js +5 -6
  240. package/dist/hooks/compaction/parse.js +73 -6
  241. package/dist/hooks/compaction/retention.js +28 -25
  242. package/dist/hooks/compaction/status.js +145 -26
  243. package/dist/hooks/compaction/types.js +0 -1
  244. package/dist/hooks/validateArtifact/agentFacing.js +0 -1
  245. package/dist/hooks/validateArtifact/index.js +6 -65
  246. package/dist/hooks/validateArtifact/markdown.js +9 -10
  247. package/dist/hooks/validateArtifact/schema.js +96 -9
  248. package/dist/hooks/validateArtifact/traversal.js +12 -11
  249. package/dist/hooks/validateArtifact/violations.js +5 -3
  250. package/dist/migrate/v2HandoffManifest.js +8 -3
  251. package/dist/registries/activationContract.js +2 -0
  252. package/dist/registries/activationTuples.js +108 -0
  253. package/dist/registries/artifactProtocolIds.js +2 -1
  254. package/dist/registries/artifactRegistry.js +207 -60
  255. package/dist/registries/artifactSchemaProjection.js +45 -0
  256. package/dist/registries/capabilityContract.js +5 -21
  257. package/dist/registries/evaluatorHandoffContract.js +0 -1
  258. package/dist/registries/evidenceTierContract.js +371 -0
  259. package/dist/registries/glossaryAdviceContract.js +79 -0
  260. package/dist/registries/glossaryCaveatContract.js +67 -0
  261. package/dist/registries/glossaryConsumerContractValidation.js +787 -0
  262. package/dist/registries/glossaryEntryContract.js +757 -0
  263. package/dist/registries/glossaryTermIdentity.js +17 -0
  264. package/dist/registries/glossaryTermOccurrence.js +20 -0
  265. package/dist/registries/hybridRoute.js +274 -0
  266. package/dist/registries/hybridRouteReceipt.js +221 -0
  267. package/dist/registries/packagePublication.js +273 -0
  268. package/dist/registries/packageRegistry.js +184 -209
  269. package/dist/registries/todoReadinessContract.js +448 -0
  270. package/dist/registries/triggerLoader.js +7 -44
  271. package/dist/registries/verbosityBudgetContract.js +205 -0
  272. package/dist/release/releaseMetadata.js +155 -5
  273. package/dist/runtime/lifecycleAdapterContract.js +457 -0
  274. package/dist/runtime/lifecycleAdapters.js +777 -0
  275. package/dist/runtime/lifecycleAuthority.js +453 -0
  276. package/dist/runtime/lifecycleOperationContract.js +123 -0
  277. package/dist/runtime/lifecycleOperations.js +634 -0
  278. package/dist/runtime/lifecycleOwnershipJournal.js +622 -0
  279. package/dist/runtime/lifecyclePublication.js +415 -0
  280. package/dist/runtime/lifecycleSnapshot.js +438 -0
  281. package/dist/runtime/nativeResourceCleanup.js +502 -0
  282. package/dist/setup/opencode.js +20 -13
  283. package/dist/setup/opencodeConstants.js +1 -0
  284. package/dist/setup/sharedSkill.js +45 -0
  285. package/dist/setup/smokeChecks.js +14 -75
  286. package/dist/state/archiveDiscovery.js +580 -0
  287. package/dist/state/archivePublication.js +225 -0
  288. package/dist/state/archiveRecovery.js +237 -0
  289. package/dist/state/archiveReplay.js +53 -0
  290. package/dist/state/canonicalMigrationRecord.js +36 -0
  291. package/dist/state/changelog.js +221 -0
  292. package/dist/state/decisionEntities.js +367 -0
  293. package/dist/state/decisionLegacyValidation.js +215 -0
  294. package/dist/state/decisionMigrationProvenance.js +199 -0
  295. package/dist/state/decisionOverlay.js +254 -0
  296. package/dist/state/decisionRevision.js +256 -0
  297. package/dist/state/decisionRevisionMigration.js +89 -0
  298. package/dist/state/directRetrieval.js +323 -0
  299. package/dist/state/durability.js +324 -0
  300. package/dist/state/entityCutover.js +459 -0
  301. package/dist/state/entityCutoverGit.js +127 -0
  302. package/dist/state/entityGlossaryAuthority.js +13 -0
  303. package/dist/state/entityListProjection.js +187 -0
  304. package/dist/state/entityListRuntimeRegistry.js +85 -0
  305. package/dist/state/entityMigrationCausality.js +97 -0
  306. package/dist/state/entityMigrationIdentity.js +5 -0
  307. package/dist/state/entityMigrationPreview.js +840 -0
  308. package/dist/state/entityMigrationTodo.js +133 -0
  309. package/dist/state/entityPublicationContext.js +859 -0
  310. package/dist/state/entityRetrievalHelp.js +506 -0
  311. package/dist/state/entityStorage.js +899 -0
  312. package/dist/state/exactReplacementRecovery.js +18 -0
  313. package/dist/state/experimentArchive.js +63 -0
  314. package/dist/state/experimentIdentity.js +202 -0
  315. package/dist/state/healthEntities.js +262 -0
  316. package/dist/state/healthEntityValidation.js +18 -0
  317. package/dist/state/healthRepair.js +69 -0
  318. package/dist/state/installRoot.js +15 -7
  319. package/dist/state/legacyEntityCutoverEvidence.js +65 -0
  320. package/dist/state/legacyIdentity.js +47 -0
  321. package/dist/state/legacySummaryRecord.js +6 -0
  322. package/dist/state/listAccounting.js +54 -0
  323. package/dist/state/listClassification.js +17 -0
  324. package/dist/state/listCursor.js +42 -0
  325. package/dist/state/listRetrieval.js +781 -0
  326. package/dist/state/migrationSourceBinding.js +30 -0
  327. package/dist/state/objectiveExperimentEntities.js +322 -0
  328. package/dist/state/planEntities.js +1027 -0
  329. package/dist/state/planIdentity.js +47 -0
  330. package/dist/state/planLineageValidation.js +52 -0
  331. package/dist/state/planReplacementTransaction.js +475 -0
  332. package/dist/state/planRetrieval.js +313 -0
  333. package/dist/state/planTaskRetrieval.js +294 -0
  334. package/dist/state/progressEntities.js +512 -0
  335. package/dist/state/progressGlossaryCaveat.js +168 -0
  336. package/dist/state/progressPublicationOrder.js +19 -0
  337. package/dist/state/progressWritePolicy.js +33 -0
  338. package/dist/state/projectRoot.js +62 -0
  339. package/dist/state/projectionPolicy.js +190 -0
  340. package/dist/state/retrievalAuthority.js +156 -0
  341. package/dist/state/safeProjectFile.js +155 -0
  342. package/dist/state/startupAnalysis/benchmark.js +70 -9
  343. package/dist/state/startupAnalysis/contract.js +44 -10
  344. package/dist/state/startupAnalysis/helpers.js +1 -2
  345. package/dist/state/startupAnalysis/index.js +0 -1
  346. package/dist/state/startupAnalysis/metrics.js +0 -1
  347. package/dist/state/startupAnalysis/records.js +0 -1
  348. package/dist/state/startupAnalysis/report.js +0 -1
  349. package/dist/state/startupAnalysis/threshold.js +13 -1
  350. package/dist/state/startupAnalysis.js +0 -1
  351. package/dist/state/startupProjection.js +499 -0
  352. package/dist/state/stateMode.js +222 -0
  353. package/dist/state/stateStorageAuthority.js +47 -0
  354. package/dist/state/summaryEntityRead.js +25 -0
  355. package/dist/state/summaryMigrationProvenance.js +66 -0
  356. package/dist/state/summarySourceRowAuthority.js +36 -0
  357. package/dist/state/todoActivationSafety.js +58 -0
  358. package/dist/state/todoDocsEntities.js +1124 -0
  359. package/dist/state/todoDocsEntityValidation.js +158 -0
  360. package/dist/state/todoMarkdownProjection.js +51 -0
  361. package/dist/state/todoReconciliationActivation.js +182 -0
  362. package/dist/state/todoReconciliationInspection.js +171 -0
  363. package/dist/state/todoReconciliationRepair.js +318 -0
  364. package/dist/state/todoReconciliationTransaction.js +595 -0
  365. package/dist/state/write/assign.js +20 -0
  366. package/dist/state/write/candidateMutation.js +269 -0
  367. package/dist/state/write/errors.js +11 -0
  368. package/dist/state/write/experimentPublication.js +192 -0
  369. package/dist/state/write/explain.js +377 -0
  370. package/dist/state/write/fields.js +61 -0
  371. package/dist/state/write/glossaryPublication.js +263 -0
  372. package/dist/state/write/grammar.js +285 -0
  373. package/dist/state/write/helpers.js +29 -0
  374. package/dist/state/write/index.js +12 -0
  375. package/dist/state/write/input.js +391 -0
  376. package/dist/state/write/lock.js +837 -0
  377. package/dist/state/write/mutation.js +234 -0
  378. package/dist/state/write/operations.js +170 -0
  379. package/dist/state/write/planEvaluation.js +128 -0
  380. package/dist/state/write/planPublication.js +179 -0
  381. package/dist/state/write/runtimeOperations.js +146 -0
  382. package/dist/state/write/serialize.js +1 -0
  383. package/dist/state/write/transaction.js +57 -0
  384. package/dist/state/write/validate.js +7 -0
  385. package/dist/upgrade/appContentRefresh.js +77 -36
  386. package/dist/upgrade/appModel.js +0 -1
  387. package/dist/upgrade/atomicWriter.js +1 -0
  388. package/dist/upgrade/bundleEvidence.js +0 -1
  389. package/dist/upgrade/channels.js +6 -9
  390. package/dist/upgrade/compatibility.js +43 -17
  391. package/dist/upgrade/doctor.js +55 -32
  392. package/dist/upgrade/doctorClassifier.js +11 -1
  393. package/dist/upgrade/installedHooksRetirement.js +46 -40
  394. package/dist/upgrade/legacyAgentCleanup.js +187 -21
  395. package/dist/upgrade/lifecycleUpgrade.js +113 -0
  396. package/dist/upgrade/migrateArtifactsV2ToV3.js +334 -64
  397. package/dist/upgrade/migrationPublication.js +122 -0
  398. package/dist/upgrade/nextMajorDoctor.js +0 -1
  399. package/dist/upgrade/npxPlatformStatus.js +0 -1
  400. package/dist/upgrade/projectIntegration.js +121 -159
  401. package/dist/upgrade/projectIntegrationDecision.js +42 -85
  402. package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
  403. package/dist/upgrade/runtimeMigration.js +262 -453
  404. package/dist/upgrade/upgradeCommands.js +14 -1
  405. package/dist/upgrade/upgradeLock.js +85 -0
  406. package/dist/upgrade/upgradeOrchestrator.js +263 -59
  407. package/dist/upgrade/v3CapabilitySurface.js +2 -3
  408. package/dist/upgrade/versionResolution.js +0 -1
  409. package/dist/validate/activationArtifactEvidence.js +852 -0
  410. package/dist/validate/activationArtifactEvidenceTypes.js +12 -0
  411. package/dist/validate/activationConjunction.js +816 -0
  412. package/dist/validate/activationEvidenceManifest.js +531 -0
  413. package/dist/validate/activationPackageSemantics.js +29 -0
  414. package/dist/validate/appHomeContract.js +1 -7
  415. package/dist/validate/bootstrapAuthority.js +44 -0
  416. package/dist/validate/capability.js +11 -3
  417. package/dist/validate/crossCapability.js +14 -9
  418. package/dist/validate/retainedReferenceAuthority.js +879 -0
  419. package/dist/validate/selfAudit.js +39 -45
  420. package/dist/validate/v1LegacyCruft.js +131 -0
  421. package/dist/validate/vocabularyAuthority.js +8 -8
  422. package/package.json +41 -13
  423. package/bundle/references/adapters/cursor.md +0 -214
  424. package/bundle/references/adapters/opencode.md +0 -530
  425. package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
  426. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  427. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  428. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -554
  429. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  430. package/bundle/references/analysis/benchmark.md +0 -267
  431. package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
  432. package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
  433. package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -369
  434. package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -250
  435. package/bundle/references/cli/capability-tool-classification.yaml +0 -53
  436. package/bundle/references/cli/coexistence-probe.yaml +0 -13
  437. package/bundle/references/cli/parity-expected-actual-template.md +0 -30
  438. package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
  439. package/bundle/references/cli/single-name-protocol.yaml +0 -42
  440. package/bundle/references/cli/upgrade-repair-wording.md +0 -45
  441. package/bundle/references/cli/v3-handoff-manifest.schema.yaml +0 -98
  442. package/bundle/references/meta/documentation-inventory.md +0 -49
  443. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  444. package/bundle/skills/agentera/agents/audit.toml +0 -6
  445. package/bundle/skills/agentera/agents/build.toml +0 -6
  446. package/bundle/skills/agentera/agents/design.toml +0 -6
  447. package/bundle/skills/agentera/agents/discuss.toml +0 -6
  448. package/bundle/skills/agentera/agents/document.toml +0 -6
  449. package/bundle/skills/agentera/agents/optimize.toml +0 -6
  450. package/bundle/skills/agentera/agents/orchestrate.toml +0 -6
  451. package/bundle/skills/agentera/agents/plan.toml +0 -6
  452. package/bundle/skills/agentera/agents/profile.toml +0 -6
  453. package/bundle/skills/agentera/agents/research.toml +0 -6
  454. package/bundle/skills/agentera/agents/status.toml +0 -6
  455. package/bundle/skills/agentera/agents/vision.toml +0 -6
  456. package/bundle/skills/agentera/references/contract.md +0 -1048
  457. package/dist/analytics/extractCorpus/cli.js.map +0 -1
  458. package/dist/analytics/extractCorpus/copilotSessions.js.map +0 -1
  459. package/dist/analytics/extractCorpus/core.js.map +0 -1
  460. package/dist/analytics/extractCorpus/corpus.js.map +0 -1
  461. package/dist/analytics/extractCorpus/coverageAudit.js.map +0 -1
  462. package/dist/analytics/extractCorpus/cursorSessions.js.map +0 -1
  463. package/dist/analytics/extractCorpus/extractCorpusParity.js.map +0 -1
  464. package/dist/analytics/extractCorpus/filesystemSources.js.map +0 -1
  465. package/dist/analytics/extractCorpus/index.js.map +0 -1
  466. package/dist/analytics/extractCorpus/jsonlSessions.js.map +0 -1
  467. package/dist/analytics/extractCorpus/sqliteCaps.js.map +0 -1
  468. package/dist/analytics/extractCorpus/sqliteSessions.js.map +0 -1
  469. package/dist/analytics/extractCorpus.js.map +0 -1
  470. package/dist/analytics/usageStats.js.map +0 -1
  471. package/dist/bin/agentera.js.map +0 -1
  472. package/dist/capabilities/audit/instructions.js.map +0 -1
  473. package/dist/capabilities/build/instructions.js.map +0 -1
  474. package/dist/capabilities/design/instructions.js.map +0 -1
  475. package/dist/capabilities/discuss/instructions.js.map +0 -1
  476. package/dist/capabilities/document/instructions.js.map +0 -1
  477. package/dist/capabilities/dokumentera/instructions.js +0 -6
  478. package/dist/capabilities/dokumentera/instructions.js.map +0 -1
  479. package/dist/capabilities/hej/instructions.js +0 -6
  480. package/dist/capabilities/hej/instructions.js.map +0 -1
  481. package/dist/capabilities/index.js.map +0 -1
  482. package/dist/capabilities/inspektera/instructions.js +0 -6
  483. package/dist/capabilities/inspektera/instructions.js.map +0 -1
  484. package/dist/capabilities/inspirera/instructions.js +0 -6
  485. package/dist/capabilities/inspirera/instructions.js.map +0 -1
  486. package/dist/capabilities/optimera/instructions.js +0 -6
  487. package/dist/capabilities/optimera/instructions.js.map +0 -1
  488. package/dist/capabilities/optimize/instructions.js.map +0 -1
  489. package/dist/capabilities/orchestrate/instructions.js.map +0 -1
  490. package/dist/capabilities/orkestrera/instructions.js +0 -6
  491. package/dist/capabilities/orkestrera/instructions.js.map +0 -1
  492. package/dist/capabilities/plan/instructions.js.map +0 -1
  493. package/dist/capabilities/planera/instructions.js +0 -6
  494. package/dist/capabilities/planera/instructions.js.map +0 -1
  495. package/dist/capabilities/profile/instructions.js.map +0 -1
  496. package/dist/capabilities/profilera/instructions.js +0 -6
  497. package/dist/capabilities/profilera/instructions.js.map +0 -1
  498. package/dist/capabilities/realisera/instructions.js +0 -6
  499. package/dist/capabilities/realisera/instructions.js.map +0 -1
  500. package/dist/capabilities/research/instructions.js.map +0 -1
  501. package/dist/capabilities/resonera/instructions.js +0 -6
  502. package/dist/capabilities/resonera/instructions.js.map +0 -1
  503. package/dist/capabilities/status/instructions.js.map +0 -1
  504. package/dist/capabilities/vision/instructions.js.map +0 -1
  505. package/dist/capabilities/visionera/instructions.js +0 -6
  506. package/dist/capabilities/visionera/instructions.js.map +0 -1
  507. package/dist/capabilities/visualisera/instructions.js +0 -5
  508. package/dist/capabilities/visualisera/instructions.js.map +0 -1
  509. package/dist/cli/appContext.js.map +0 -1
  510. package/dist/cli/argvalidate.js.map +0 -1
  511. package/dist/cli/capabilityContext/benchmark.js.map +0 -1
  512. package/dist/cli/capabilityContext/bespoke.js.map +0 -1
  513. package/dist/cli/capabilityContext/build.js.map +0 -1
  514. package/dist/cli/capabilityContext/closeout.js.map +0 -1
  515. package/dist/cli/capabilityContext/contract.js.map +0 -1
  516. package/dist/cli/capabilityContext/evidence.js.map +0 -1
  517. package/dist/cli/capabilityContext/index.js.map +0 -1
  518. package/dist/cli/capabilityContext/orchestration.js.map +0 -1
  519. package/dist/cli/capabilityContext/planState.js.map +0 -1
  520. package/dist/cli/capabilityContext/progress.js.map +0 -1
  521. package/dist/cli/capabilityContext/realisera.js +0 -174
  522. package/dist/cli/capabilityContext/realisera.js.map +0 -1
  523. package/dist/cli/capabilityContext/shared.js.map +0 -1
  524. package/dist/cli/capabilityContext/slim.js.map +0 -1
  525. package/dist/cli/capabilityContext/startup.js.map +0 -1
  526. package/dist/cli/capabilityContext/types.js.map +0 -1
  527. package/dist/cli/capabilityContext.js.map +0 -1
  528. package/dist/cli/commands/appHome.js.map +0 -1
  529. package/dist/cli/commands/backfill.js +0 -84
  530. package/dist/cli/commands/backfill.js.map +0 -1
  531. package/dist/cli/commands/capability.js.map +0 -1
  532. package/dist/cli/commands/compact.js.map +0 -1
  533. package/dist/cli/commands/doctor.js.map +0 -1
  534. package/dist/cli/commands/lint.js.map +0 -1
  535. package/dist/cli/commands/prime/bundleStatus.js.map +0 -1
  536. package/dist/cli/commands/prime/collectOrientationState.js.map +0 -1
  537. package/dist/cli/commands/prime/orientationOutput.js.map +0 -1
  538. package/dist/cli/commands/prime/routeOutput.js +0 -50
  539. package/dist/cli/commands/prime/routeOutput.js.map +0 -1
  540. package/dist/cli/commands/prime/types.js.map +0 -1
  541. package/dist/cli/commands/prime/v1Migration.js.map +0 -1
  542. package/dist/cli/commands/prime.js.map +0 -1
  543. package/dist/cli/commands/query.js.map +0 -1
  544. package/dist/cli/commands/report.js.map +0 -1
  545. package/dist/cli/commands/schema.js.map +0 -1
  546. package/dist/cli/commands/state/decisions.js.map +0 -1
  547. package/dist/cli/commands/state/docs.js.map +0 -1
  548. package/dist/cli/commands/state/experiments.js.map +0 -1
  549. package/dist/cli/commands/state/health.js.map +0 -1
  550. package/dist/cli/commands/state/index.js.map +0 -1
  551. package/dist/cli/commands/state/objective.js.map +0 -1
  552. package/dist/cli/commands/state/plan.js.map +0 -1
  553. package/dist/cli/commands/state/progress.js.map +0 -1
  554. package/dist/cli/commands/state/shared.js.map +0 -1
  555. package/dist/cli/commands/state/todo.js.map +0 -1
  556. package/dist/cli/commands/state.js +0 -1023
  557. package/dist/cli/commands/state.js.map +0 -1
  558. package/dist/cli/commands/upgrade.js.map +0 -1
  559. package/dist/cli/commands/validate.js.map +0 -1
  560. package/dist/cli/commands/verify.js.map +0 -1
  561. package/dist/cli/contracts/bundleStatus.js.map +0 -1
  562. package/dist/cli/contracts/orientationState.js.map +0 -1
  563. package/dist/cli/dispatch/argvParser.js.map +0 -1
  564. package/dist/cli/dispatch/check.js.map +0 -1
  565. package/dist/cli/dispatch/commands.js.map +0 -1
  566. package/dist/cli/dispatch/index.js.map +0 -1
  567. package/dist/cli/dispatch/lifecycle.js.map +0 -1
  568. package/dist/cli/dispatch/prime.js.map +0 -1
  569. package/dist/cli/dispatch/shared.js.map +0 -1
  570. package/dist/cli/dispatch/state.js.map +0 -1
  571. package/dist/cli/dispatch.js.map +0 -1
  572. package/dist/cli/errors.js.map +0 -1
  573. package/dist/cli/help.js.map +0 -1
  574. package/dist/cli/orientation/attention.js.map +0 -1
  575. package/dist/cli/orientation/corpusCoverage.js.map +0 -1
  576. package/dist/cli/orientation.js.map +0 -1
  577. package/dist/cli/prime-blob.js.map +0 -1
  578. package/dist/cli/startupCompletenessContract.js.map +0 -1
  579. package/dist/cli/stateQuery.js.map +0 -1
  580. package/dist/cli/structured.js.map +0 -1
  581. package/dist/cli/todoMarkdown.js.map +0 -1
  582. package/dist/cli/todoSeverity.js.map +0 -1
  583. package/dist/core/difflib.js.map +0 -1
  584. package/dist/core/envPaths.js.map +0 -1
  585. package/dist/core/git.js +0 -43
  586. package/dist/core/git.js.map +0 -1
  587. package/dist/core/jsonValue.js.map +0 -1
  588. package/dist/core/paths.js.map +0 -1
  589. package/dist/core/pyjson.js.map +0 -1
  590. package/dist/core/sourceRoot.js.map +0 -1
  591. package/dist/core/toml.js.map +0 -1
  592. package/dist/core/yaml.js.map +0 -1
  593. package/dist/eval/evalSkills.js.map +0 -1
  594. package/dist/eval/semanticEval.js.map +0 -1
  595. package/dist/eval/semanticFixtures.js.map +0 -1
  596. package/dist/hooks/common.js.map +0 -1
  597. package/dist/hooks/compaction/apply.js.map +0 -1
  598. package/dist/hooks/compaction/dryRun.js.map +0 -1
  599. package/dist/hooks/compaction/index.js.map +0 -1
  600. package/dist/hooks/compaction/parse.js.map +0 -1
  601. package/dist/hooks/compaction/retention.js.map +0 -1
  602. package/dist/hooks/compaction/status.js.map +0 -1
  603. package/dist/hooks/compaction/todoResolved.js +0 -137
  604. package/dist/hooks/compaction/todoResolved.js.map +0 -1
  605. package/dist/hooks/compaction/types.js.map +0 -1
  606. package/dist/hooks/compaction.js +0 -935
  607. package/dist/hooks/compaction.js.map +0 -1
  608. package/dist/hooks/cursorPreToolUse.js +0 -19
  609. package/dist/hooks/cursorPreToolUse.js.map +0 -1
  610. package/dist/hooks/cursorSessionStart.js +0 -79
  611. package/dist/hooks/cursorSessionStart.js.map +0 -1
  612. package/dist/hooks/sessionStart.js +0 -216
  613. package/dist/hooks/sessionStart.js.map +0 -1
  614. package/dist/hooks/sessionStop.js +0 -206
  615. package/dist/hooks/sessionStop.js.map +0 -1
  616. package/dist/hooks/todoLayout.js +0 -177
  617. package/dist/hooks/todoLayout.js.map +0 -1
  618. package/dist/hooks/validateArtifact/agentFacing.js.map +0 -1
  619. package/dist/hooks/validateArtifact/index.js.map +0 -1
  620. package/dist/hooks/validateArtifact/markdown.js.map +0 -1
  621. package/dist/hooks/validateArtifact/runtime.js +0 -86
  622. package/dist/hooks/validateArtifact/runtime.js.map +0 -1
  623. package/dist/hooks/validateArtifact/schema.js.map +0 -1
  624. package/dist/hooks/validateArtifact/traversal.js.map +0 -1
  625. package/dist/hooks/validateArtifact/violations.js.map +0 -1
  626. package/dist/hooks/validateArtifact.js +0 -924
  627. package/dist/hooks/validateArtifact.js.map +0 -1
  628. package/dist/migrate/v2HandoffManifest.js.map +0 -1
  629. package/dist/registries/artifactProtocolIds.js.map +0 -1
  630. package/dist/registries/artifactRegistry.js.map +0 -1
  631. package/dist/registries/capabilityContract.js.map +0 -1
  632. package/dist/registries/evaluatorHandoffContract.js.map +0 -1
  633. package/dist/registries/packageRegistry.js.map +0 -1
  634. package/dist/registries/runtimeAdapterRegistry.js +0 -316
  635. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  636. package/dist/registries/triggerLoader.js.map +0 -1
  637. package/dist/release/releaseMetadata.js.map +0 -1
  638. package/dist/routing/index.js +0 -2
  639. package/dist/routing/index.js.map +0 -1
  640. package/dist/routing/routeEngine.js +0 -189
  641. package/dist/routing/routeEngine.js.map +0 -1
  642. package/dist/setup/codex/agents.js +0 -96
  643. package/dist/setup/codex/agents.js.map +0 -1
  644. package/dist/setup/codex/cli.js +0 -161
  645. package/dist/setup/codex/cli.js.map +0 -1
  646. package/dist/setup/codex/configToml.js +0 -639
  647. package/dist/setup/codex/configToml.js.map +0 -1
  648. package/dist/setup/codex/constants.js +0 -29
  649. package/dist/setup/codex/constants.js.map +0 -1
  650. package/dist/setup/codex/installRoot.js +0 -64
  651. package/dist/setup/codex/installRoot.js.map +0 -1
  652. package/dist/setup/codex/state.js +0 -270
  653. package/dist/setup/codex/state.js.map +0 -1
  654. package/dist/setup/codex.js +0 -12
  655. package/dist/setup/codex.js.map +0 -1
  656. package/dist/setup/copilot.js +0 -227
  657. package/dist/setup/copilot.js.map +0 -1
  658. package/dist/setup/cursor.js +0 -129
  659. package/dist/setup/cursor.js.map +0 -1
  660. package/dist/setup/cursorSurfaces.js +0 -67
  661. package/dist/setup/cursorSurfaces.js.map +0 -1
  662. package/dist/setup/doctor/core.js +0 -300
  663. package/dist/setup/doctor/core.js.map +0 -1
  664. package/dist/setup/doctor/diagnostics.js +0 -240
  665. package/dist/setup/doctor/diagnostics.js.map +0 -1
  666. package/dist/setup/doctor/opencode.js +0 -313
  667. package/dist/setup/doctor/opencode.js.map +0 -1
  668. package/dist/setup/doctor/report.js +0 -425
  669. package/dist/setup/doctor/report.js.map +0 -1
  670. package/dist/setup/doctor.js +0 -10
  671. package/dist/setup/doctor.js.map +0 -1
  672. package/dist/setup/opencode.js.map +0 -1
  673. package/dist/setup/smokeChecks.js.map +0 -1
  674. package/dist/state/installRoot.js.map +0 -1
  675. package/dist/state/progressCommit.js +0 -289
  676. package/dist/state/progressCommit.js.map +0 -1
  677. package/dist/state/startupAnalysis/benchmark.js.map +0 -1
  678. package/dist/state/startupAnalysis/contract.js.map +0 -1
  679. package/dist/state/startupAnalysis/helpers.js.map +0 -1
  680. package/dist/state/startupAnalysis/index.js.map +0 -1
  681. package/dist/state/startupAnalysis/metrics.js.map +0 -1
  682. package/dist/state/startupAnalysis/records.js.map +0 -1
  683. package/dist/state/startupAnalysis/report.js.map +0 -1
  684. package/dist/state/startupAnalysis/threshold.js.map +0 -1
  685. package/dist/state/startupAnalysis.js.map +0 -1
  686. package/dist/upgrade/appContentRefresh.js.map +0 -1
  687. package/dist/upgrade/appModel.js.map +0 -1
  688. package/dist/upgrade/bundleEvidence.js.map +0 -1
  689. package/dist/upgrade/channels.js.map +0 -1
  690. package/dist/upgrade/cliProbe.js +0 -22
  691. package/dist/upgrade/cliProbe.js.map +0 -1
  692. package/dist/upgrade/coexistenceProbe.js +0 -107
  693. package/dist/upgrade/coexistenceProbe.js.map +0 -1
  694. package/dist/upgrade/compatibility.js.map +0 -1
  695. package/dist/upgrade/doctor.js.map +0 -1
  696. package/dist/upgrade/doctorClassifier.js.map +0 -1
  697. package/dist/upgrade/installedHooksRetirement.js.map +0 -1
  698. package/dist/upgrade/legacyAgentCleanup.js.map +0 -1
  699. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
  700. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  701. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
  702. package/dist/upgrade/nextMajorDoctor.js.map +0 -1
  703. package/dist/upgrade/npxPlatformStatus.js.map +0 -1
  704. package/dist/upgrade/projectIntegration.js.map +0 -1
  705. package/dist/upgrade/projectIntegrationDecision.js.map +0 -1
  706. package/dist/upgrade/runtimeMigration.js.map +0 -1
  707. package/dist/upgrade/upgradeCommands.js.map +0 -1
  708. package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
  709. package/dist/upgrade/v3CapabilitySurface.js.map +0 -1
  710. package/dist/upgrade/versionResolution.js.map +0 -1
  711. package/dist/validate/appHomeContract.js.map +0 -1
  712. package/dist/validate/capability.js.map +0 -1
  713. package/dist/validate/crossCapability.js.map +0 -1
  714. package/dist/validate/lifecycleAdapters/legacyPythonParity.js +0 -93
  715. package/dist/validate/lifecycleAdapters/legacyPythonParity.js.map +0 -1
  716. package/dist/validate/lifecycleAdapters/nodeFormChecks.js +0 -488
  717. package/dist/validate/lifecycleAdapters/nodeFormChecks.js.map +0 -1
  718. package/dist/validate/lifecycleAdapters/shared.js +0 -198
  719. package/dist/validate/lifecycleAdapters/shared.js.map +0 -1
  720. package/dist/validate/lifecycleAdapters.js +0 -62
  721. package/dist/validate/lifecycleAdapters.js.map +0 -1
  722. package/dist/validate/selfAudit.js.map +0 -1
  723. package/dist/validate/vocabularyAuthority.js.map +0 -1
@@ -0,0 +1,457 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { resolveSourceRoot } from "../core/sourceRoot.js";
4
+ import { loadYamlMapping } from "../core/yaml.js";
5
+ import { LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH, LIFECYCLE_AUTHORITY_RELATIVE_PATH, loadLifecycleAuthority, } from "./lifecycleAuthority.js";
6
+ import { LIFECYCLE_OPERATION_CONTRACT_RELATIVE_PATH } from "./lifecycleOperations.js";
7
+ export const RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH = LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH;
8
+ export const RUNTIME_ADAPTER_CATEGORIES = [
9
+ "skills",
10
+ "plugins",
11
+ "hooks",
12
+ "agents",
13
+ "configuration",
14
+ "enablement",
15
+ "trust",
16
+ "native_actions",
17
+ ];
18
+ export const RUNTIME_ADAPTER_CAPABILITIES = [
19
+ "repairable",
20
+ "observable",
21
+ "action_required",
22
+ "unsupported",
23
+ "unverified",
24
+ "not_applicable",
25
+ ];
26
+ export const RUNTIME_ADAPTER_EVIDENCE_STATES = [
27
+ "confirmed",
28
+ "absent",
29
+ "drifted",
30
+ "shadowed",
31
+ "denied",
32
+ "unknown",
33
+ "blocked_unowned",
34
+ "unsupported",
35
+ "not_applicable",
36
+ "action_required",
37
+ ];
38
+ export const RUNTIME_ADAPTER_REMEDIATION_KINDS = [
39
+ "none",
40
+ "repair",
41
+ "action_required",
42
+ "unavailable",
43
+ ];
44
+ function isMapping(value) {
45
+ return value !== null && typeof value === "object" && !Array.isArray(value);
46
+ }
47
+ function sameList(value, expected) {
48
+ return Array.isArray(value) && JSON.stringify(value) === JSON.stringify(expected);
49
+ }
50
+ function sourceError(sourcePath, location, message) {
51
+ return `${sourcePath}:${location}: ${message}`;
52
+ }
53
+ function stringField(value, field) {
54
+ return typeof value[field] === "string" ? value[field] : "";
55
+ }
56
+ function stringList(value) {
57
+ return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : [];
58
+ }
59
+ function forbiddenDestinationSegment(destination, forbidden) {
60
+ const segments = destination
61
+ .toLowerCase()
62
+ .split(/[\\/]+/)
63
+ .filter(Boolean);
64
+ return forbidden.find((candidate) => segments.includes(candidate.toLowerCase())) ?? null;
65
+ }
66
+ function validateResource(resource, location, sourcePath, forbidden, runtimeIds, errors) {
67
+ if (!isMapping(resource)) {
68
+ errors.push(sourceError(sourcePath, location, "must be an object"));
69
+ return;
70
+ }
71
+ const id = stringField(resource, "id");
72
+ if (!id)
73
+ errors.push(sourceError(sourcePath, `${location}.id`, "must be a non-empty string"));
74
+ if (!RUNTIME_ADAPTER_CATEGORIES.includes(resource.category)) {
75
+ errors.push(sourceError(sourcePath, `${location}.category`, "must name a common adapter category"));
76
+ }
77
+ if (!["file", "symlink", "directory_files"].includes(String(resource.kind))) {
78
+ errors.push(sourceError(sourcePath, `${location}.kind`, "must be file, symlink, or directory_files"));
79
+ }
80
+ for (const field of ["source", "destination"]) {
81
+ if (typeof resource[field] !== "string" || !resource[field].startsWith("{")) {
82
+ errors.push(sourceError(sourcePath, `${location}.${field}`, "must be an explicit rooted template"));
83
+ }
84
+ }
85
+ const destination = stringField(resource, "destination");
86
+ const forbiddenSegment = forbiddenDestinationSegment(destination, forbidden);
87
+ if (forbiddenSegment) {
88
+ errors.push(sourceError(sourcePath, `${location}.destination`, `must not target runtime or package cache segment ${forbiddenSegment}`));
89
+ }
90
+ if (resource.kind === "directory_files" && typeof resource.extension !== "string") {
91
+ errors.push(sourceError(sourcePath, `${location}.extension`, "is required for directory_files"));
92
+ }
93
+ if (resource.required !== true && resource.required !== false) {
94
+ errors.push(sourceError(sourcePath, `${location}.required`, "must be explicit true or false"));
95
+ }
96
+ if (resource.runtime_id !== undefined && !runtimeIds.has(String(resource.runtime_id))) {
97
+ errors.push(sourceError(sourcePath, `${location}.runtime_id`, "must name an active authority runtime"));
98
+ }
99
+ }
100
+ export function validateRuntimeLifecycleAdapterContractData(data, authority, sourcePath = RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH) {
101
+ if (!isMapping(data))
102
+ return [sourceError(sourcePath, "1", "adapter contract must be a YAML object")];
103
+ const errors = [];
104
+ if (data.schema_version !== "agentera.runtimeLifecycleAdapters.v1") {
105
+ errors.push(sourceError(sourcePath, "schema_version", "must be agentera.runtimeLifecycleAdapters.v1"));
106
+ }
107
+ if (data.status !== "migration_only_contract") {
108
+ errors.push(sourceError(sourcePath, "status", "must be migration_only_contract"));
109
+ }
110
+ if (data.decision !== 92)
111
+ errors.push(sourceError(sourcePath, "decision", "must cite Decision 92"));
112
+ if (data.authority !== LIFECYCLE_AUTHORITY_RELATIVE_PATH) {
113
+ errors.push(sourceError(sourcePath, "authority", `must point to ${LIFECYCLE_AUTHORITY_RELATIVE_PATH}`));
114
+ }
115
+ if (data.operation_contract !== LIFECYCLE_OPERATION_CONTRACT_RELATIVE_PATH) {
116
+ errors.push(sourceError(sourcePath, "operation_contract", `must point to ${LIFECYCLE_OPERATION_CONTRACT_RELATIVE_PATH}`));
117
+ }
118
+ if (!sameList(data.categories, RUNTIME_ADAPTER_CATEGORIES)) {
119
+ errors.push(sourceError(sourcePath, "categories", `must be exactly ${RUNTIME_ADAPTER_CATEGORIES.join(", ")}`));
120
+ }
121
+ const categoryContract = isMapping(data.category_contract) ? data.category_contract : {};
122
+ if (!sameList(categoryContract.required_fields, ["capability", "evidence", "remediation"])) {
123
+ errors.push(sourceError(sourcePath, "category_contract.required_fields", "must require capability, evidence, remediation"));
124
+ }
125
+ if (!sameList(categoryContract.capabilities, RUNTIME_ADAPTER_CAPABILITIES)) {
126
+ errors.push(sourceError(sourcePath, "category_contract.capabilities", "does not match runtime capability vocabulary"));
127
+ }
128
+ if (!sameList(categoryContract.evidence_states, RUNTIME_ADAPTER_EVIDENCE_STATES)) {
129
+ errors.push(sourceError(sourcePath, "category_contract.evidence_states", "does not match runtime evidence vocabulary"));
130
+ }
131
+ if (!sameList(categoryContract.remediation_kinds, RUNTIME_ADAPTER_REMEDIATION_KINDS)) {
132
+ errors.push(sourceError(sourcePath, "category_contract.remediation_kinds", "does not match remediation vocabulary"));
133
+ }
134
+ const supportFloor = isMapping(data.support_floor) ? data.support_floor : {};
135
+ if (supportFloor.authority !== `${LIFECYCLE_AUTHORITY_RELATIVE_PATH}#support_floor` ||
136
+ supportFloor.required_category !== "skills" ||
137
+ supportFloor.required_capability !== "repairable" ||
138
+ supportFloor.unknown_or_unverified_required_detection_blocks !== true ||
139
+ supportFloor.incomplete_required_diagnosis_blocks !== true ||
140
+ supportFloor.unknown_or_missing_mandatory_evidence_blocks !== true ||
141
+ supportFloor.denied_required_trust_blocks !== true ||
142
+ supportFloor.known_false_presence_install_enable_is_diagnosed_degraded !== true ||
143
+ supportFloor.not_applicable_only_for_unobserved_conditional_surface !== true) {
144
+ errors.push(sourceError(sourcePath, "support_floor", "must delegate exact fail-closed evidence semantics to lifecycle authority"));
145
+ }
146
+ const nativePolicy = isMapping(data.native_policy) ? data.native_policy : {};
147
+ if (nativePolicy.execution !== "forbidden" ||
148
+ nativePolicy.exact_action_required_only !== true ||
149
+ nativePolicy.install_update_enable_auth_trust_are_user_owned !== true) {
150
+ errors.push(sourceError(sourcePath, "native_policy", "must keep every native mutation user-owned and non-executing"));
151
+ }
152
+ const pathPolicy = isMapping(data.path_policy) ? data.path_policy : {};
153
+ const forbidden = stringList(pathPolicy.forbidden_destination_segments);
154
+ if (pathPolicy.destination_templates_are_declarations !== true ||
155
+ pathPolicy.matching_ledger_required_for_existing_resources !== true ||
156
+ pathPolicy.equality_or_name_never_establishes_ownership !== true ||
157
+ forbidden.length === 0) {
158
+ errors.push(sourceError(sourcePath, "path_policy", "must declare ledger-only ownership and cache exclusions"));
159
+ }
160
+ const caveats = stringList(data.known_caveats);
161
+ if (caveats.length === 0 ||
162
+ !caveats.some((caveat) => caveat.includes("Append-only ownership journal recovery") &&
163
+ caveat.includes("strict contiguous hash chain") &&
164
+ caveat.includes("blocks malformed or disconnected final events") &&
165
+ caveat.includes("re-observes every resource"))) {
166
+ errors.push(sourceError(sourcePath, "known_caveats", "must declare strict append-only chain validation, atomic-tail recovery, and per-resource re-observation"));
167
+ }
168
+ const runtimeIds = new Set(authority.runtimes.map((runtime) => runtime.id));
169
+ const sharedResources = Array.isArray(data.shared_resources) ? data.shared_resources : [];
170
+ const managedResources = Array.isArray(data.managed_resources) ? data.managed_resources : [];
171
+ sharedResources.forEach((resource, index) => validateResource(resource, `shared_resources[${index}]`, sourcePath, forbidden, runtimeIds, errors));
172
+ managedResources.forEach((resource, index) => validateResource(resource, `managed_resources[${index}]`, sourcePath, forbidden, runtimeIds, errors));
173
+ const allResources = [...sharedResources, ...managedResources];
174
+ const resourceIds = allResources.map((resource) => isMapping(resource) ? stringField(resource, "id") : "");
175
+ const duplicateResource = resourceIds.find((id, index) => id && resourceIds.indexOf(id) !== index);
176
+ if (duplicateResource) {
177
+ errors.push(sourceError(sourcePath, "managed_resources", `duplicate resource id ${duplicateResource}`));
178
+ }
179
+ const canonical = sharedResources.find((resource) => isMapping(resource) && resource.id === "canonical_skill");
180
+ if (authority.runtimes.length > 0 && (!isMapping(canonical) ||
181
+ canonical.destination !== "{home}/.agents/skills/agentera" ||
182
+ canonical.source !== "{source_root}/skills/agentera" ||
183
+ canonical.kind !== "symlink" ||
184
+ canonical.required !== true)) {
185
+ errors.push(sourceError(sourcePath, "shared_resources.canonical_skill", "must declare the canonical shared skill symlink"));
186
+ }
187
+ const adapters = Array.isArray(data.adapters) ? data.adapters : [];
188
+ const adapterIds = adapters.map((adapter) => isMapping(adapter) ? stringField(adapter, "runtime_id") : "");
189
+ const expectedIds = authority.runtimes.map((runtime) => runtime.id);
190
+ if (JSON.stringify(adapterIds) !== JSON.stringify(expectedIds)) {
191
+ errors.push(sourceError(sourcePath, "adapters", `runtime IDs must follow authority exactly: ${expectedIds.join(", ")}`));
192
+ }
193
+ adapters.forEach((adapter, adapterIndex) => {
194
+ const location = `adapters[${adapterIndex}]`;
195
+ if (!isMapping(adapter)) {
196
+ errors.push(sourceError(sourcePath, location, "must be an object"));
197
+ return;
198
+ }
199
+ const runtimeId = stringField(adapter, "runtime_id");
200
+ if (runtimeId === "claude" || runtimeId === "cursor-agent") {
201
+ errors.push(sourceError(sourcePath, `${location}.runtime_id`, `${runtimeId} cannot be an active adapter`));
202
+ }
203
+ const runtime = authority.runtimes.find((candidate) => candidate.id === runtimeId);
204
+ const expectedSurfaces = runtime?.surfaces.map((surface) => surface.id) ?? [];
205
+ const binaries = isMapping(adapter.binaries) ? adapter.binaries : {};
206
+ if (JSON.stringify(Object.keys(binaries)) !== JSON.stringify(expectedSurfaces)) {
207
+ errors.push(sourceError(sourcePath, `${location}.binaries`, `must declare surfaces ${expectedSurfaces.join(", ")}`));
208
+ }
209
+ for (const surface of expectedSurfaces) {
210
+ if (stringList(binaries[surface]).length === 0) {
211
+ errors.push(sourceError(sourcePath, `${location}.binaries.${surface}`, "must list at least one bounded binary probe"));
212
+ }
213
+ }
214
+ const refs = stringList(adapter.resource_refs);
215
+ if (!refs.includes("canonical_skill")) {
216
+ errors.push(sourceError(sourcePath, `${location}.resource_refs`, "must include canonical_skill"));
217
+ }
218
+ for (const ref of refs) {
219
+ const resource = allResources.find((candidate) => isMapping(candidate) && candidate.id === ref);
220
+ if (!resource)
221
+ errors.push(sourceError(sourcePath, `${location}.resource_refs`, `unknown resource ${ref}`));
222
+ else if (isMapping(resource) &&
223
+ resource.runtime_id !== undefined &&
224
+ resource.runtime_id !== runtimeId) {
225
+ errors.push(sourceError(sourcePath, `${location}.resource_refs`, `${ref} belongs to ${String(resource.runtime_id)}`));
226
+ }
227
+ }
228
+ const skillLocations = Array.isArray(adapter.skill_locations) ? adapter.skill_locations : [];
229
+ const canonicalLocations = skillLocations.filter((item) => isMapping(item) && item.canonical === true);
230
+ if (canonicalLocations.length !== 1 ||
231
+ !isMapping(canonicalLocations[0]) ||
232
+ canonicalLocations[0].path !== "{home}/.agents/skills/agentera") {
233
+ errors.push(sourceError(sourcePath, `${location}.skill_locations`, "must identify exactly one canonical shared skill path"));
234
+ }
235
+ const categories = isMapping(adapter.categories) ? adapter.categories : {};
236
+ for (const category of RUNTIME_ADAPTER_CATEGORIES) {
237
+ const claims = isMapping(categories[category]) ? categories[category] : null;
238
+ if (!claims) {
239
+ errors.push(sourceError(sourcePath, `${location}.categories.${category}`, "missing common category claims"));
240
+ continue;
241
+ }
242
+ if (JSON.stringify(Object.keys(claims)) !== JSON.stringify(expectedSurfaces)) {
243
+ errors.push(sourceError(sourcePath, `${location}.categories.${category}`, `must report surfaces ${expectedSurfaces.join(", ")}`));
244
+ }
245
+ for (const surface of expectedSurfaces) {
246
+ const claim = claims[surface];
247
+ const claimLocation = `${location}.categories.${category}.${surface}`;
248
+ if (!isMapping(claim)) {
249
+ errors.push(sourceError(sourcePath, claimLocation, "must be an object"));
250
+ continue;
251
+ }
252
+ if (!RUNTIME_ADAPTER_CAPABILITIES.includes(claim.capability)) {
253
+ errors.push(sourceError(sourcePath, `${claimLocation}.capability`, "is invalid"));
254
+ }
255
+ if (typeof claim.evidence !== "string" || !claim.evidence) {
256
+ errors.push(sourceError(sourcePath, `${claimLocation}.evidence`, "must be explicit"));
257
+ }
258
+ if (typeof claim.remediation !== "string" || !claim.remediation) {
259
+ errors.push(sourceError(sourcePath, `${claimLocation}.remediation`, "must be explicit"));
260
+ }
261
+ if (category === "skills" &&
262
+ runtime?.surfaces.find((item) => item.id === surface)?.presence === "required") {
263
+ if (claim.required !== true || claim.capability !== "repairable") {
264
+ errors.push(sourceError(sourcePath, claimLocation, "required surfaces need repairable required skill detection"));
265
+ }
266
+ }
267
+ else if (claim.required === true) {
268
+ errors.push(sourceError(sourcePath, `${claimLocation}.required`, "only required skill surfaces may be mandatory"));
269
+ }
270
+ }
271
+ }
272
+ const nativeActions = Array.isArray(adapter.native_actions) ? adapter.native_actions : [];
273
+ const nativeActionIds = new Set();
274
+ for (const [actionIndex, action] of nativeActions.entries()) {
275
+ const actionLocation = `${location}.native_actions[${actionIndex}]`;
276
+ if (!isMapping(action)) {
277
+ errors.push(sourceError(sourcePath, actionLocation, "must be an object"));
278
+ continue;
279
+ }
280
+ if (!expectedSurfaces.includes(String(action.surface_id))) {
281
+ errors.push(sourceError(sourcePath, `${actionLocation}.surface_id`, "must name an adapter surface"));
282
+ }
283
+ const actionId = stringField(action, "id");
284
+ if (!actionId || nativeActionIds.has(actionId)) {
285
+ errors.push(sourceError(sourcePath, `${actionLocation}.id`, "must be non-empty and unique within the adapter"));
286
+ }
287
+ nativeActionIds.add(actionId);
288
+ if (!["slash_action", "argv", "instruction"].includes(String(action.action_kind))) {
289
+ errors.push(sourceError(sourcePath, `${actionLocation}.action_kind`, "must be slash_action, argv, or instruction"));
290
+ }
291
+ const commandValid = typeof action.command === "string"
292
+ ? action.command.length > 0
293
+ : stringList(action.command).length > 0;
294
+ if (!commandValid || typeof action.instruction !== "string" || !action.instruction) {
295
+ errors.push(sourceError(sourcePath, actionLocation, "must provide an exact command and instruction"));
296
+ }
297
+ }
298
+ const nativeClaims = isMapping(categories.native_actions) ? categories.native_actions : {};
299
+ for (const surface of expectedSurfaces) {
300
+ const claim = nativeClaims[surface];
301
+ if (!isMapping(claim))
302
+ continue;
303
+ const surfaceActions = nativeActions.filter((action) => isMapping(action) && action.surface_id === surface);
304
+ const exactNativeClaim = claim.capability === "action_required" &&
305
+ claim.evidence === "verified_host_actions" &&
306
+ claim.remediation === "action_required";
307
+ if (surfaceActions.length > 0 && !exactNativeClaim) {
308
+ errors.push(sourceError(sourcePath, `${location}.categories.native_actions.${surface}`, "declared native actions require action_required, verified_host_actions, action_required semantics"));
309
+ }
310
+ if (surfaceActions.length === 0 && exactNativeClaim) {
311
+ errors.push(sourceError(sourcePath, `${location}.categories.native_actions.${surface}`, "verified native-action claims require at least one exact action for the same surface"));
312
+ }
313
+ }
314
+ });
315
+ sharedResources.forEach((resource, resourceIndex) => {
316
+ if (!isMapping(resource))
317
+ return;
318
+ const resourceId = stringField(resource, "id");
319
+ const references = adapters.filter((adapter) => isMapping(adapter) && stringList(adapter.resource_refs).includes(resourceId));
320
+ if (references.length === 0) {
321
+ errors.push(sourceError(sourcePath, `shared_resources[${resourceIndex}].id`, `${resourceId} must be required by at least one active runtime adapter`));
322
+ }
323
+ if (resource.runtime_id !== undefined || resource.surface_id !== undefined) {
324
+ errors.push(sourceError(sourcePath, `shared_resources[${resourceIndex}]`, "shared resources cannot declare a runtime or surface applicability"));
325
+ }
326
+ });
327
+ managedResources.forEach((resource, resourceIndex) => {
328
+ if (!isMapping(resource))
329
+ return;
330
+ const resourceId = stringField(resource, "id");
331
+ const runtimeId = stringField(resource, "runtime_id");
332
+ const surfaceId = stringField(resource, "surface_id");
333
+ const category = stringField(resource, "category");
334
+ const references = adapters.flatMap((adapter, adapterIndex) => {
335
+ if (!isMapping(adapter) || !stringList(adapter.resource_refs).includes(resourceId))
336
+ return [];
337
+ return [{ adapter, adapterIndex }];
338
+ });
339
+ if (references.length !== 1 ||
340
+ stringField(references[0]?.adapter ?? {}, "runtime_id") !== runtimeId) {
341
+ errors.push(sourceError(sourcePath, `managed_resources[${resourceIndex}].id`, `${resourceId} must be referenced exactly once by adapter ${runtimeId}`));
342
+ return;
343
+ }
344
+ const adapter = references[0].adapter;
345
+ const categories = isMapping(adapter.categories) ? adapter.categories : {};
346
+ const claims = isMapping(categories[category]) ? categories[category] : {};
347
+ const claim = claims[surfaceId];
348
+ if (!isMapping(claim) ||
349
+ (claim.capability !== "repairable" && claim.evidence !== `managed_resource:${resourceId}`)) {
350
+ errors.push(sourceError(sourcePath, `managed_resources[${resourceIndex}]`, `${resourceId} must have a repairable or managed-resource claim at adapters[${references[0].adapterIndex}].categories.${category}.${surfaceId}`));
351
+ }
352
+ });
353
+ return errors;
354
+ }
355
+ function parseResource(resource) {
356
+ return {
357
+ id: resource.id,
358
+ runtimeId: resource.runtime_id,
359
+ surfaceId: resource.surface_id,
360
+ category: resource.category,
361
+ kind: resource.kind,
362
+ source: resource.source,
363
+ destination: resource.destination,
364
+ extension: resource.extension,
365
+ required: resource.required,
366
+ };
367
+ }
368
+ export function loadRuntimeLifecycleAdapterContract(contractPath = path.join(resolveSourceRoot(), RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH), authority = loadLifecycleAuthority()) {
369
+ const data = loadYamlMapping(fs.readFileSync(contractPath, "utf8"));
370
+ const errors = validateRuntimeLifecycleAdapterContractData(data, authority, contractPath);
371
+ if (errors.length > 0)
372
+ throw new Error(`Runtime lifecycle adapter contract validation failed: ${errors.join("; ")}`);
373
+ const shared = data.shared_resources.map(parseResource);
374
+ const managed = data.managed_resources.map(parseResource);
375
+ const adapters = data.adapters.map((adapter) => {
376
+ const categories = {};
377
+ for (const category of RUNTIME_ADAPTER_CATEGORIES) {
378
+ categories[category] = {};
379
+ const claims = adapter.categories[category];
380
+ for (const [surface, rawClaim] of Object.entries(claims)) {
381
+ const claim = rawClaim;
382
+ categories[category][surface] = {
383
+ capability: claim.capability,
384
+ evidence: claim.evidence,
385
+ remediation: claim.remediation,
386
+ required: claim.required === true,
387
+ };
388
+ }
389
+ }
390
+ return {
391
+ runtimeId: adapter.runtime_id,
392
+ binaries: adapter.binaries,
393
+ resourceRefs: adapter.resource_refs,
394
+ skillLocations: adapter.skill_locations.map((location) => ({
395
+ path: location.path,
396
+ scope: location.scope,
397
+ canonical: location.canonical === true,
398
+ surfaces: Array.isArray(location.surfaces)
399
+ ? location.surfaces
400
+ : (authority.runtimes
401
+ .find((runtime) => runtime.id === adapter.runtime_id)
402
+ ?.surfaces.map((surface) => surface.id) ?? []),
403
+ })),
404
+ categories,
405
+ nativeActions: adapter.native_actions.map((action) => ({
406
+ id: action.id,
407
+ surfaceId: action.surface_id,
408
+ actionKind: action.action_kind,
409
+ command: action.command,
410
+ instruction: action.instruction,
411
+ })),
412
+ };
413
+ });
414
+ return {
415
+ sourcePath: contractPath,
416
+ forbiddenDestinationSegments: stringList(data.path_policy.forbidden_destination_segments),
417
+ caveats: stringList(data.known_caveats),
418
+ resources: [...shared, ...managed],
419
+ adapters,
420
+ };
421
+ }
422
+ function resolveSourceTemplate(template, root) {
423
+ if (!template.startsWith("{source_root}/"))
424
+ return null;
425
+ return path.resolve(root, template.slice("{source_root}/".length));
426
+ }
427
+ export function validateRuntimeLifecycleAdapterContractRoot(root = resolveSourceRoot()) {
428
+ const contractPath = path.join(root, RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH);
429
+ if (!fs.existsSync(contractPath)) {
430
+ return [
431
+ `${RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH}:1: missing runtime lifecycle adapter contract`,
432
+ ];
433
+ }
434
+ try {
435
+ const authority = loadLifecycleAuthority(path.join(root, LIFECYCLE_AUTHORITY_RELATIVE_PATH));
436
+ const data = loadYamlMapping(fs.readFileSync(contractPath, "utf8"));
437
+ const errors = validateRuntimeLifecycleAdapterContractData(data, authority, RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH);
438
+ const resources = [
439
+ ...(Array.isArray(data.shared_resources) ? data.shared_resources : []),
440
+ ...(Array.isArray(data.managed_resources) ? data.managed_resources : []),
441
+ ];
442
+ resources.forEach((resource, index) => {
443
+ if (!isMapping(resource))
444
+ return;
445
+ const source = resolveSourceTemplate(stringField(resource, "source"), root);
446
+ if (!source || !fs.existsSync(source)) {
447
+ errors.push(sourceError(RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH, `resources[${index}].source`, `declared source is missing: ${source ?? String(resource.source)}`));
448
+ }
449
+ });
450
+ return errors;
451
+ }
452
+ catch (error) {
453
+ return [
454
+ `${RUNTIME_LIFECYCLE_ADAPTER_CONTRACT_RELATIVE_PATH}:1: could not validate contract: ${error.message}`,
455
+ ];
456
+ }
457
+ }