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,374 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { CANONICAL_DEVELOPMENT_CLI } from "./developmentChannel.js";
4
+ import { ENTITY_LIST_RUNTIME_FAMILIES, } from "../state/entityListRuntimeRegistry.js";
5
+ import { runtimeOperationSpec, runtimeOperationSpecs, } from "../state/write/runtimeOperations.js";
6
+ export const CANONICAL_DEVELOPMENT_INVOCATION = CANONICAL_DEVELOPMENT_CLI;
7
+ const LOCAL_RUNTIME_INVOCATION = "agentera";
8
+ export class DevelopmentInvocationError extends Error {
9
+ classification;
10
+ constructor(classification, reason) {
11
+ super(`development invocation rejected [${classification}]: ${reason}`);
12
+ this.name = "DevelopmentInvocationError";
13
+ this.classification = classification;
14
+ }
15
+ }
16
+ export const DEVELOPMENT_RUNTIME_REQUIRED_FILES = Object.freeze([
17
+ "package.json",
18
+ "README.md",
19
+ "LICENSE",
20
+ "dist/bin/agentera.js",
21
+ "bundle/.agentera-npx-bundle.json",
22
+ "bundle/registry.json",
23
+ "bundle/skills/agentera/SKILL.md",
24
+ "bundle/references/adapters/package-registry.yaml",
25
+ ]);
26
+ export const DEVELOPMENT_CHILD_ENV_ALLOWLIST = Object.freeze([
27
+ "AGENTERA_BOOTSTRAP_SOURCE_ROOT",
28
+ "AGENTERA_HOME",
29
+ "AGENTERA_UPDATE_CHANNEL",
30
+ "DO_NOT_TRACK",
31
+ "HOME",
32
+ "LANG",
33
+ "LC_ALL",
34
+ "PATH",
35
+ "TMPDIR",
36
+ "XDG_CACHE_HOME",
37
+ "XDG_CONFIG_HOME",
38
+ "XDG_DATA_HOME",
39
+ "XDG_STATE_HOME",
40
+ ]);
41
+ export const DEVELOPMENT_CHILD_PATH = process.platform === "win32"
42
+ ? path.dirname(process.execPath)
43
+ : "/usr/bin:/bin";
44
+ function developmentCommand(argumentsText) {
45
+ return `${CANONICAL_DEVELOPMENT_INVOCATION} ${argumentsText}`;
46
+ }
47
+ const profileGroundingCommand = developmentCommand("report profile-grounding --format json");
48
+ const GLOSSARY_PROJECTIONS = {
49
+ "profile_output.command": developmentCommand("report profile-glossary"),
50
+ "profile_grounding.command": profileGroundingCommand,
51
+ "profile_grounding.repair": `Use the Profile capability to repair or regenerate PROFILE.md, then retry \`${profileGroundingCommand}\`; no profile bytes were changed.`,
52
+ "profile_grounding.absent": `Use the Profile capability to generate PROFILE.md, then retry ${profileGroundingCommand}.`,
53
+ "advice.command": developmentCommand("report glossary-advice --input REQUEST --format json"),
54
+ };
55
+ function invalid(reason) {
56
+ throw new Error(`invalid development command projection: ${reason}`);
57
+ }
58
+ function runtimeValue(source) {
59
+ return source.split(CANONICAL_DEVELOPMENT_INVOCATION).join(LOCAL_RUNTIME_INVOCATION);
60
+ }
61
+ function assertExact(value, owner, source) {
62
+ if (typeof value !== "string" || value !== source)
63
+ invalid(`'${owner}' does not match its code-owned exact source value`);
64
+ return runtimeValue(source);
65
+ }
66
+ function commandWords(command) {
67
+ const words = [];
68
+ let value = "";
69
+ let started = false;
70
+ let quote = null;
71
+ for (let index = 0; index < command.length; index += 1) {
72
+ const character = command[index];
73
+ if (quote) {
74
+ if (character === quote) {
75
+ quote = null;
76
+ started = true;
77
+ continue;
78
+ }
79
+ if (quote === '"' && character === "\\") {
80
+ const escaped = command[++index];
81
+ if (escaped === undefined)
82
+ invalid("trailing escape");
83
+ if (escaped === "\n" || escaped === "\r")
84
+ invalid("shell continuation is not allowed");
85
+ value += escaped;
86
+ started = true;
87
+ continue;
88
+ }
89
+ if (quote === '"' && (character === "`" || (character === "$" && command[index + 1] === "(")))
90
+ invalid("command substitution is not allowed");
91
+ value += character;
92
+ started = true;
93
+ continue;
94
+ }
95
+ if (character === "\n" || character === "\r")
96
+ invalid("line separators are allowed only inside one quoted argument");
97
+ if (/\s/u.test(character)) {
98
+ if (started) {
99
+ words.push({ value });
100
+ value = "";
101
+ started = false;
102
+ }
103
+ continue;
104
+ }
105
+ if (character === "'" || character === '"') {
106
+ quote = character;
107
+ started = true;
108
+ continue;
109
+ }
110
+ if (character === "\\") {
111
+ const escaped = command[++index];
112
+ if (escaped === undefined)
113
+ invalid("trailing escape");
114
+ if (escaped === "\n" || escaped === "\r")
115
+ invalid("shell continuation is not allowed");
116
+ value += escaped;
117
+ started = true;
118
+ continue;
119
+ }
120
+ if (";&|<>()`".includes(character) || (character === "$" && command[index + 1] === "("))
121
+ invalid("composition, redirection, substitution, and grouping are not allowed");
122
+ value += character;
123
+ started = true;
124
+ }
125
+ if (quote)
126
+ invalid("unclosed quote");
127
+ if (started)
128
+ words.push({ value });
129
+ return words;
130
+ }
131
+ function parsedDevelopmentWords(command, classification) {
132
+ try {
133
+ return commandWords(command).map(({ value }) => value);
134
+ }
135
+ catch (error) {
136
+ throw new DevelopmentInvocationError(classification, error instanceof Error ? error.message : String(error));
137
+ }
138
+ }
139
+ function hasDevelopmentPrefix(words) {
140
+ return words[0] === "npx" && words[1] === "-y" && words[2] === "agentera@next";
141
+ }
142
+ /**
143
+ * Bind an untrusted command specification to one exact code-owned development
144
+ * command before a caller crosses a process boundary. The returned argv omits
145
+ * npx and the package selector because callers execute a verified local bin.
146
+ */
147
+ export function bindDevelopmentInvocation(identity, candidate) {
148
+ if (!/^[a-z0-9][a-z0-9_.:-]*$/u.test(identity.owner)) {
149
+ throw new DevelopmentInvocationError("invalid_authority", "owner is not a canonical identity");
150
+ }
151
+ const authorityWords = parsedDevelopmentWords(identity.source, "invalid_authority");
152
+ if (!hasDevelopmentPrefix(authorityWords) || authorityWords.length === 3) {
153
+ throw new DevelopmentInvocationError("invalid_authority", `authority must be one complete ${CANONICAL_DEVELOPMENT_INVOCATION} command`);
154
+ }
155
+ const candidateWords = parsedDevelopmentWords(candidate, "malformed");
156
+ if (!hasDevelopmentPrefix(candidateWords)) {
157
+ throw new DevelopmentInvocationError("wrong_channel", `command must begin with the exact ${CANONICAL_DEVELOPMENT_INVOCATION} argv`);
158
+ }
159
+ if (candidate !== identity.source) {
160
+ throw new DevelopmentInvocationError("not_exact", `command does not match code-owned identity '${identity.owner}'`);
161
+ }
162
+ return Object.freeze({
163
+ owner: identity.owner,
164
+ source: identity.source,
165
+ argv: Object.freeze(candidateWords.slice(3)),
166
+ });
167
+ }
168
+ /** Fail closed before process start when a constructed runtime is incomplete. */
169
+ export function assertDevelopmentRuntimeSurface(root) {
170
+ for (const relative of DEVELOPMENT_RUNTIME_REQUIRED_FILES) {
171
+ const target = path.join(root, relative);
172
+ let stat;
173
+ try {
174
+ stat = fs.lstatSync(target);
175
+ }
176
+ catch {
177
+ throw new DevelopmentInvocationError("invalid_authority", `runtime is missing required file '${relative}'`);
178
+ }
179
+ if (!stat.isFile()) {
180
+ throw new DevelopmentInvocationError("invalid_authority", `runtime required file '${relative}' is not a regular file`);
181
+ }
182
+ }
183
+ let manifest;
184
+ try {
185
+ manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
186
+ }
187
+ catch {
188
+ throw new DevelopmentInvocationError("invalid_authority", "package manifest is not valid JSON");
189
+ }
190
+ if (manifest.bin?.agentera !== "dist/bin/agentera.js") {
191
+ throw new DevelopmentInvocationError("invalid_authority", "package bin declaration is not canonical");
192
+ }
193
+ const files = manifest.files;
194
+ if (!Array.isArray(files) || !["dist", "bundle"].every((entry) => files.includes(entry))) {
195
+ throw new DevelopmentInvocationError("invalid_authority", "package files declaration omits dist or bundle");
196
+ }
197
+ const bin = path.join(root, "dist/bin/agentera.js");
198
+ if ((fs.statSync(bin).mode & 0o111) === 0) {
199
+ throw new DevelopmentInvocationError("invalid_authority", "package bin is not executable");
200
+ }
201
+ return bin;
202
+ }
203
+ /** Keep only reviewed process inputs; PATH is always code-owned. */
204
+ export function scrubDevelopmentChildEnvironment(inherited, explicit) {
205
+ const result = {};
206
+ for (const key of DEVELOPMENT_CHILD_ENV_ALLOWLIST) {
207
+ if (key === "PATH")
208
+ continue;
209
+ const value = explicit[key] ?? inherited[key];
210
+ if (value !== undefined)
211
+ result[key] = value;
212
+ }
213
+ result.PATH = DEVELOPMENT_CHILD_PATH;
214
+ return result;
215
+ }
216
+ function fieldValueIssue(field, value) {
217
+ if (field.validValues && !field.validValues.includes(value))
218
+ return "invalid value domain";
219
+ if (field.kind === "boolean" && value !== "true" && value !== "false")
220
+ return "invalid boolean";
221
+ if (field.kind === "integer" && !/^-?(?:0|[1-9][0-9]*)$/u.test(value))
222
+ return "invalid integer";
223
+ if (field.kind === "date" && !/^\d{4}-\d{2}-\d{2}$/u.test(value))
224
+ return "invalid date";
225
+ if (field.kind === "datetime" && !/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/u.test(value))
226
+ return "invalid datetime";
227
+ return undefined;
228
+ }
229
+ function validateOperationExample(spec, template) {
230
+ if (template.runtime !== runtimeValue(template.source))
231
+ invalid(`${spec.artifact}.${spec.verb} has a non-canonical runtime example`);
232
+ if (!template.source.startsWith(`${CANONICAL_DEVELOPMENT_INVOCATION} `))
233
+ invalid(`${spec.artifact}.${spec.verb} example has no canonical prefix`);
234
+ const words = commandWords(template.source).map(({ value }) => value);
235
+ const prefix = ["npx", "-y", "agentera@next", "state", spec.artifact, spec.verb];
236
+ if (!prefix.every((word, index) => words[index] === word))
237
+ invalid(`${spec.artifact}.${spec.verb} example has the wrong operation family`);
238
+ const fields = new Map(spec.fields.map((field) => [field.flag, field]));
239
+ const seen = new Map();
240
+ let input = false;
241
+ let format = false;
242
+ for (let index = prefix.length; index < words.length;) {
243
+ const flag = words[index++];
244
+ if (!flag.startsWith("--") || flag === "--")
245
+ invalid(`${spec.artifact}.${spec.verb} example has an extra positional argument`);
246
+ const count = (seen.get(flag) ?? 0) + 1;
247
+ seen.set(flag, count);
248
+ if (flag === "--dry-run" || flag === "--force") {
249
+ if (count > 1)
250
+ invalid(`${spec.artifact}.${spec.verb} example repeats ${flag}`);
251
+ if (flag === "--force" && !spec.allowForce)
252
+ invalid(`${spec.artifact}.${spec.verb} example uses unauthorized --force`);
253
+ continue;
254
+ }
255
+ const bareBoolean = fields.get(flag);
256
+ if (bareBoolean?.kind === "boolean" && (words[index] === undefined || words[index].startsWith("--"))) {
257
+ if (!bareBoolean.repeatable && count > 1)
258
+ invalid(`${spec.artifact}.${spec.verb} example repeats ${flag}`);
259
+ continue;
260
+ }
261
+ const argument = words[index++];
262
+ if (argument === undefined || argument.startsWith("--"))
263
+ invalid(`${spec.artifact}.${spec.verb} ${flag} needs one non-option value`);
264
+ if (flag === "--format") {
265
+ if (count > 1 || !spec.projection.formatValues.includes(argument))
266
+ invalid(`${spec.artifact}.${spec.verb} example has an invalid format`);
267
+ format = true;
268
+ continue;
269
+ }
270
+ if (flag === "--input") {
271
+ if (count > 1 || spec.inputMode !== "structured")
272
+ invalid(`${spec.artifact}.${spec.verb} example has an unauthorized input`);
273
+ input = true;
274
+ continue;
275
+ }
276
+ const field = fields.get(flag);
277
+ if (!field)
278
+ invalid(`${spec.artifact}.${spec.verb} example has unauthorized flag ${flag}`);
279
+ if (!field.repeatable && count > 1)
280
+ invalid(`${spec.artifact}.${spec.verb} example repeats ${flag}`);
281
+ const issue = fieldValueIssue(field, argument);
282
+ if (issue)
283
+ invalid(`${spec.artifact}.${spec.verb} example has ${issue} for ${flag}`);
284
+ }
285
+ if (!format)
286
+ invalid(`${spec.artifact}.${spec.verb} example omits --format`);
287
+ if (spec.inputMode === "structured" && !spec.inputOptional && !input)
288
+ invalid(`${spec.artifact}.${spec.verb} example omits --input`);
289
+ for (const field of spec.fields) {
290
+ if (field.required && !seen.has(field.flag))
291
+ invalid(`${spec.artifact}.${spec.verb} example omits ${field.flag}`);
292
+ }
293
+ }
294
+ const validatedOperations = new Set();
295
+ function exactOperation(artifact, verb) {
296
+ const spec = runtimeOperationSpec(artifact, verb);
297
+ if (!spec)
298
+ invalid(`operation '${artifact}.${verb}' is not code-owned`);
299
+ const key = `${artifact}.${verb}`;
300
+ if (!validatedOperations.has(key)) {
301
+ if (spec.projection.recovery.runtime !== runtimeValue(spec.projection.recovery.source))
302
+ invalid(`${key} has a non-canonical runtime recovery`);
303
+ if (spec.projection.examples.length === 0)
304
+ invalid(`${key} has no code-owned example`);
305
+ for (const example of spec.projection.examples)
306
+ validateOperationExample(spec, example);
307
+ validatedOperations.add(key);
308
+ }
309
+ return spec;
310
+ }
311
+ export function projectRuntimeOperationRecovery(value, artifact, verb) {
312
+ const spec = exactOperation(artifact, verb);
313
+ return assertExact(value, `mutation.${artifact}.${verb}.recovery`, spec.projection.recovery.source);
314
+ }
315
+ export function projectRuntimeOperationExamples(value, artifact, verb) {
316
+ const spec = exactOperation(artifact, verb);
317
+ if (!Array.isArray(value) || value.length !== spec.projection.examples.length)
318
+ invalid(`'mutation.${artifact}.${verb}.examples' does not match its code-owned exact source list`);
319
+ return spec.projection.examples.map((template, index) => assertExact(value[index], `mutation.${artifact}.${verb}.examples[${index}]`, template.source));
320
+ }
321
+ export function projectEntityDevelopmentValue(value, familyKey, field) {
322
+ const family = ENTITY_LIST_RUNTIME_FAMILIES.find(({ key }) => key === familyKey);
323
+ const source = family?.projection[field];
324
+ if (!family || typeof source !== "string")
325
+ invalid(`retrieval.${familyKey}.${field} is not a code-owned projection`);
326
+ return assertExact(value, `retrieval.${familyKey}.${field}`, source);
327
+ }
328
+ export function projectGlossaryDevelopmentValue(value, owner) {
329
+ return assertExact(value, `glossary.${owner}`, GLOSSARY_PROJECTIONS[owner]);
330
+ }
331
+ export function developmentProjectionOwners() {
332
+ const owners = [];
333
+ for (const spec of runtimeOperationSpecs()) {
334
+ exactOperation(spec.artifact, spec.verb);
335
+ owners.push({
336
+ owner: `mutation.${spec.artifact}.${spec.verb}.recovery`,
337
+ family: "mutation",
338
+ ...spec.projection.recovery,
339
+ consumers: ["schema", "help", "explain"],
340
+ });
341
+ spec.projection.examples.forEach((example, index) => owners.push({
342
+ owner: `mutation.${spec.artifact}.${spec.verb}.examples[${index}]`,
343
+ family: "mutation",
344
+ ...example,
345
+ consumers: ["schema", "help", "explain", "parity"],
346
+ }));
347
+ }
348
+ for (const family of ENTITY_LIST_RUNTIME_FAMILIES) {
349
+ for (const field of ["list", "get", "example", "bareRecovery"]) {
350
+ const source = family.projection[field];
351
+ if (typeof source !== "string")
352
+ continue;
353
+ owners.push({
354
+ owner: `retrieval.${family.key}.${field}`,
355
+ family: "retrieval",
356
+ source,
357
+ runtime: runtimeValue(source),
358
+ consumers: ["schema", "help", "runtime_failure"],
359
+ });
360
+ }
361
+ }
362
+ for (const [owner, source] of Object.entries(GLOSSARY_PROJECTIONS)) {
363
+ owners.push({
364
+ owner: `glossary.${owner}`,
365
+ family: "glossary",
366
+ source,
367
+ runtime: runtimeValue(source),
368
+ consumers: ["schema", "help", "runtime_contract"],
369
+ });
370
+ }
371
+ if (new Set(owners.map(({ owner }) => owner)).size !== owners.length)
372
+ invalid("code-owned projection owner identities are not unique");
373
+ return owners;
374
+ }
@@ -271,4 +271,3 @@ export function unifiedDiff(a, b, fromfile = "", tofile = "", fromfiledate = "",
271
271
  export function splitLinesKeepEnds(text) {
272
272
  return text.match(/[^\n]*\n|[^\n]+/g) ?? [];
273
273
  }
274
- //# sourceMappingURL=difflib.js.map
@@ -18,4 +18,3 @@ export function resolveXdgDataHome(env, home = os.homedir()) {
18
18
  const xdg = env.XDG_DATA_HOME;
19
19
  return xdg ? expanduser(xdg) : path.join(expanduser(home), ".local", "share");
20
20
  }
21
- //# sourceMappingURL=envPaths.js.map
@@ -3,4 +3,3 @@
3
3
  * Prefer these types at module export boundaries; narrow with casts only at IO edges.
4
4
  */
5
5
  export {};
6
- //# sourceMappingURL=jsonValue.js.map
@@ -47,4 +47,3 @@ export function isFile(p) {
47
47
  return false;
48
48
  }
49
49
  }
50
- //# sourceMappingURL=paths.js.map
@@ -163,4 +163,3 @@ export function pyJsonIndentSorted(value, indent = 2, level = 0, hook) {
163
163
  }
164
164
  return "null";
165
165
  }
166
- //# sourceMappingURL=pyjson.js.map
@@ -0,0 +1,4 @@
1
+ /** Quote one argument for a POSIX shell command without permitting expansion. */
2
+ export function shellQuoteArgument(value) {
3
+ return `'${String(value).replaceAll("'", "'\\''")}'`;
4
+ }
@@ -0,0 +1,23 @@
1
+ import YAML from "yaml";
2
+ export function declaresAgenteraSkill(text) {
3
+ const lines = text.split(/\r?\n/);
4
+ if (lines[0] !== "---")
5
+ return false;
6
+ const closing = lines.indexOf("---", 1);
7
+ if (closing === -1)
8
+ return false;
9
+ const metadataLines = lines.slice(1, closing);
10
+ try {
11
+ const document = YAML.parseDocument(metadataLines.join("\n"));
12
+ if (document.errors.length > 0)
13
+ return false;
14
+ const metadata = document.toJS();
15
+ if (metadata === null || typeof metadata !== "object" || Array.isArray(metadata))
16
+ return false;
17
+ }
18
+ catch {
19
+ return false;
20
+ }
21
+ const names = metadataLines.filter((line) => /^name\s*:/.test(line));
22
+ return names.length === 1 && names[0] === "name: agentera";
23
+ }
@@ -40,9 +40,9 @@ function walkUp(start) {
40
40
  }
41
41
  /**
42
42
  * Resolve the Agentera "app source root" that holds skills/, scripts/, schemas,
43
- * references/, etc. Mirrors the bootstrap precedence in src/agentera/__main__.py:
44
- * AGENTERA_BOOTSTRAP_SOURCE_ROOT wins, then a walk-up from the module location,
45
- * then a walk-up from the working directory.
43
+ * references/, etc. AGENTERA_BOOTSTRAP_SOURCE_ROOT wins, followed by a
44
+ * checkout containing the executing module, a self-contained package bundle,
45
+ * and finally a walk-up from the working directory.
46
46
  */
47
47
  export function resolveSourceRoot(env = process.env) {
48
48
  const configured = env[BOOTSTRAP_SOURCE_ROOT_ENV];
@@ -54,19 +54,16 @@ export function resolveSourceRoot(env = process.env) {
54
54
  if (fromModule) {
55
55
  return fromModule;
56
56
  }
57
+ // A packaged CLI must keep runtime code and app data on the same version.
58
+ // Otherwise an Agentera checkout used as cwd can override the package bundle.
59
+ const bundled = path.resolve(moduleDir, "..", "..", "bundle");
60
+ if (isNpxBundleRoot(bundled)) {
61
+ return bundled;
62
+ }
57
63
  const fromCwd = walkUp(process.cwd());
58
64
  if (fromCwd) {
59
65
  return fromCwd;
60
66
  }
61
- // Self-contained npm package: app data is staged under <packageRoot>/bundle
62
- // (see scripts/copy-bundle.mjs). This makes `npx agentera` work with no repo
63
- // checkout and no AGENTERA_HOME. Only reached when no checkout/app-home is
64
- // found, so it never overrides a real checkout, installed app, or cwd match.
65
- const bundled = path.resolve(moduleDir, "..", "..", "bundle");
66
- if (hasSourceMarker(bundled)) {
67
- return bundled;
68
- }
69
67
  // Last resort: package root two levels above dist/core.
70
68
  return path.resolve(moduleDir, "..", "..");
71
69
  }
72
- //# sourceMappingURL=sourceRoot.js.map
@@ -0,0 +1,10 @@
1
+ export function truncateCodePoints(value, maxChars, suffix = "", trimTrailingWhitespace = false) {
2
+ const characters = Array.from(value);
3
+ if (characters.length <= maxChars)
4
+ return value;
5
+ const suffixCharacters = Array.from(suffix).slice(0, maxChars);
6
+ const prefix = characters
7
+ .slice(0, Math.max(0, maxChars - suffixCharacters.length))
8
+ .join("");
9
+ return `${trimTrailingWhitespace ? prefix.replace(/\s+$/, "") : prefix}${suffixCharacters.join("")}`;
10
+ }
package/dist/core/toml.js CHANGED
@@ -8,4 +8,3 @@ export function parseToml(text) {
8
8
  export function loadTomlFile(path) {
9
9
  return parseToml(fs.readFileSync(path, "utf8"));
10
10
  }
11
- //# sourceMappingURL=toml.js.map
package/dist/core/yaml.js CHANGED
@@ -22,4 +22,11 @@ export function loadYamlMappingFile(path) {
22
22
  export function parseYaml(text) {
23
23
  return YAML.parse(text);
24
24
  }
25
- //# sourceMappingURL=yaml.js.map
25
+ /** Serialize a YAML mapping with stable block-style prose and insertion-order keys. */
26
+ export function dumpYamlMapping(doc) {
27
+ return YAML.stringify(doc, {
28
+ blockQuote: "literal",
29
+ collectionStyle: "block",
30
+ lineWidth: 0,
31
+ });
32
+ }
@@ -41,7 +41,11 @@ export function detectRuntime(explicit, opts = {}) {
41
41
  const which = opts.which ?? realWhich;
42
42
  const err = opts.err ?? ((line) => process.stderr.write(line + "\n"));
43
43
  if (explicit && explicit !== "auto") {
44
- if (explicit === "cursor-agent") {
44
+ if (explicit !== "opencode" && explicit !== "cursor") {
45
+ err(`ERROR: '${explicit}' is not an active eval runtime; choose opencode or cursor.`);
46
+ throw new ExitError(1);
47
+ }
48
+ if (explicit === "cursor") {
45
49
  if (which("cursor-agent") === null && which("agent") === null) {
46
50
  err("ERROR: 'cursor-agent' not found on PATH. Install Cursor Agent CLI " +
47
51
  "and ensure the binary is accessible.");
@@ -50,17 +54,14 @@ export function detectRuntime(explicit, opts = {}) {
50
54
  }
51
55
  return explicit;
52
56
  }
53
- const hasClaude = which("claude") !== null;
54
57
  const hasOpencode = which("opencode") !== null;
55
58
  const hasCursorAgent = which("cursor-agent") !== null || which("agent") !== null;
56
- if (hasClaude)
57
- return "claude";
58
59
  if (hasOpencode)
59
60
  return "opencode";
60
61
  if (hasCursorAgent)
61
- return "cursor-agent";
62
- err("ERROR: Neither 'claude', 'opencode', nor 'cursor-agent' found on PATH. " +
63
- "Install a supported runtime host and ensure the binary is accessible.");
62
+ return "cursor";
63
+ err("ERROR: Neither the OpenCode nor Cursor eval surface was found on PATH. " +
64
+ "Install an active eval runtime host and ensure the binary is accessible.");
64
65
  throw new ExitError(1);
65
66
  }
66
67
  export function parseFrontmatterName(text) {
@@ -108,7 +109,7 @@ const realRun = (cmd, opts) => {
108
109
  timedOut: result.signal === "SIGTERM" && result.error !== undefined,
109
110
  };
110
111
  };
111
- export function invokeSkill(name, prompt, timeout, runtime = "claude", opts = {}) {
112
+ export function invokeSkill(name, prompt, timeout, runtime = "opencode", opts = {}) {
112
113
  const which = opts.which ?? realWhich;
113
114
  const run = opts.run ?? realRun;
114
115
  const repoRoot = opts.repoRoot ?? resolveSourceRoot();
@@ -118,14 +119,13 @@ export function invokeSkill(name, prompt, timeout, runtime = "claude", opts = {}
118
119
  cmd = ["opencode", "run", "--prompt"];
119
120
  stdinPrompt = prompt;
120
121
  }
121
- else if (runtime === "cursor-agent") {
122
+ else if (runtime === "cursor") {
122
123
  const binary = which("cursor-agent") ? "cursor-agent" : "agent";
123
124
  cmd = [binary, "-p", "--output-format", "json", "--force", prompt];
124
125
  stdinPrompt = null;
125
126
  }
126
127
  else {
127
- cmd = ["claude", "-p", "--output-format", "json"];
128
- stdinPrompt = prompt;
128
+ throw new ExitError(1, `unsupported active eval runtime: ${runtime}`);
129
129
  }
130
130
  const start = Date.now();
131
131
  let error = null;
@@ -168,7 +168,7 @@ export function invokeSkill(name, prompt, timeout, runtime = "claude", opts = {}
168
168
  error,
169
169
  };
170
170
  }
171
- export function runSkills(skills, timeout, _parallel, runtime = "claude", opts = {}) {
171
+ export function runSkills(skills, timeout, _parallel, runtime = "opencode", opts = {}) {
172
172
  // Parallelism in the Python runner is a maintainer perf detail; the smoke
173
173
  // semantics (one result per skill, original order) are preserved sequentially.
174
174
  return skills.map((entry) => invokeSkill(entry.name, entry.prompt, timeout, runtime, opts));
@@ -184,7 +184,7 @@ export function buildReport(results) {
184
184
  results,
185
185
  };
186
186
  }
187
- export function buildDryRun(skills, runtime = "claude", runtimeSource = "auto-detected") {
187
+ export function buildDryRun(skills, runtime = "opencode", runtimeSource = "auto-detected") {
188
188
  return {
189
189
  mode: "dry-run",
190
190
  runtime: `${runtime} (${runtimeSource})`,
@@ -260,4 +260,3 @@ export function parseArgs(argv) {
260
260
  }
261
261
  return args;
262
262
  }
263
- //# sourceMappingURL=evalSkills.js.map