agentera 3.0.0-dev.5 → 3.0.0-dev.51

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 (598) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +119 -22
  3. package/bundle/CHANGELOG.md +1351 -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 +236 -0
  8. package/bundle/extract-corpus-parity.json +21 -0
  9. package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
  10. package/bundle/references/adapters/package-publication.json +437 -0
  11. package/bundle/references/adapters/package-registry.yaml +435 -189
  12. package/bundle/references/adapters/package-surface-characterization.md +66 -35
  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 +191 -0
  19. package/bundle/references/artifacts/artifact-registry-interface-model.yaml +20 -10
  20. package/bundle/references/artifacts/glossary-entry-contract.yaml +1254 -0
  21. package/bundle/references/artifacts/state-storage-authority.yaml +3022 -0
  22. package/bundle/references/artifacts/verbosity-budget-authority.yaml +42 -0
  23. package/bundle/references/cli/app-lifecycle-vocabulary.yaml +7 -8
  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 +155 -0
  27. package/bundle/references/cli/trigger-schema-enrichment.md +147 -0
  28. package/bundle/references/cli/update-channels.yaml +19 -1
  29. package/bundle/references/cli/vocabulary-index.yaml +20 -17
  30. package/bundle/references/cli/vocabulary.md +326 -361
  31. package/bundle/references/meta/retained-reference-authority.yaml +151 -0
  32. package/bundle/registry.json +13 -13
  33. package/bundle/skills/agentera/SKILL.md +224 -422
  34. package/bundle/skills/agentera/capabilities/audit/schemas/artifacts.yaml +84 -0
  35. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/exit.yaml +2 -2
  36. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +25 -0
  37. package/bundle/skills/agentera/capabilities/{inspektera → audit}/schemas/validation.yaml +37 -18
  38. package/bundle/skills/agentera/capabilities/build/schemas/artifacts.yaml +102 -0
  39. package/bundle/skills/agentera/capabilities/{realisera → build}/schemas/exit.yaml +6 -5
  40. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +27 -0
  41. package/bundle/skills/agentera/capabilities/build/schemas/validation.yaml +176 -0
  42. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/artifacts.yaml +12 -12
  43. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/exit.yaml +5 -5
  44. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +16 -0
  45. package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml +7 -7
  46. package/bundle/skills/agentera/capabilities/discuss/schemas/artifacts.yaml +51 -0
  47. package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml +2 -2
  48. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +20 -0
  49. package/bundle/skills/agentera/capabilities/discuss/schemas/validation.yaml +144 -0
  50. package/bundle/skills/agentera/capabilities/document/schemas/artifacts.yaml +80 -0
  51. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +16 -0
  52. package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml +18 -18
  53. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml +18 -18
  54. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml +2 -2
  55. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +16 -0
  56. package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml +9 -9
  57. package/bundle/skills/agentera/capabilities/orchestrate/schemas/artifacts.yaml +76 -0
  58. package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/exit.yaml +9 -7
  59. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +23 -0
  60. package/bundle/skills/agentera/capabilities/orchestrate/schemas/validation.yaml +121 -0
  61. package/bundle/skills/agentera/capabilities/plan/schemas/artifacts.yaml +66 -0
  62. package/bundle/skills/agentera/capabilities/{planera → plan}/schemas/exit.yaml +2 -2
  63. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +23 -0
  64. package/bundle/skills/agentera/capabilities/plan/schemas/validation.yaml +121 -0
  65. package/bundle/skills/agentera/capabilities/profile/schemas/artifacts.yaml +23 -0
  66. package/bundle/skills/agentera/capabilities/{profilera → profile}/schemas/exit.yaml +6 -5
  67. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +20 -0
  68. package/bundle/skills/agentera/capabilities/profile/schemas/validation.yaml +115 -0
  69. package/bundle/skills/agentera/capabilities/research/schemas/artifacts.yaml +24 -0
  70. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +16 -0
  71. package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/validation.yaml +2 -2
  72. package/bundle/skills/agentera/capabilities/status/schemas/artifacts.yaml +73 -0
  73. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +22 -0
  74. package/bundle/skills/agentera/capabilities/{hej → status}/schemas/validation.yaml +5 -5
  75. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/artifacts.yaml +16 -16
  76. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/exit.yaml +7 -6
  77. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +23 -0
  78. package/bundle/skills/agentera/capabilities/{visionera → vision}/schemas/validation.yaml +18 -20
  79. package/bundle/skills/agentera/capability_schema_contract.yaml +178 -34
  80. package/bundle/skills/agentera/protocol.yaml +31 -31
  81. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  82. package/bundle/skills/agentera/schemas/artifacts/changelog.yaml +5 -4
  83. package/bundle/skills/agentera/schemas/artifacts/decisions.yaml +39 -21
  84. package/bundle/skills/agentera/schemas/artifacts/design.yaml +5 -4
  85. package/bundle/skills/agentera/schemas/artifacts/docs.yaml +15 -19
  86. package/bundle/skills/agentera/schemas/artifacts/experiments.yaml +145 -14
  87. package/bundle/skills/agentera/schemas/artifacts/glossary.yaml +82 -0
  88. package/bundle/skills/agentera/schemas/artifacts/health.yaml +58 -21
  89. package/bundle/skills/agentera/schemas/artifacts/objective.yaml +22 -8
  90. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +458 -36
  91. package/bundle/skills/agentera/schemas/artifacts/progress.yaml +128 -17
  92. package/bundle/skills/agentera/schemas/artifacts/todo.yaml +342 -42
  93. package/bundle/skills/agentera/schemas/artifacts/vision.yaml +3 -3
  94. package/dist/analytics/extractCorpus/cli.js +190 -0
  95. package/dist/analytics/extractCorpus/copilotSessions.js +275 -0
  96. package/dist/analytics/extractCorpus/core.js +392 -0
  97. package/dist/analytics/extractCorpus/corpus.js +167 -0
  98. package/dist/analytics/extractCorpus/coverageAudit.js +260 -0
  99. package/dist/analytics/extractCorpus/cursorSessions.js +425 -0
  100. package/dist/analytics/extractCorpus/evidenceTiers.js +603 -0
  101. package/dist/analytics/extractCorpus/extractCorpusParity.js +105 -0
  102. package/dist/analytics/extractCorpus/filesystemSources.js +118 -0
  103. package/dist/analytics/extractCorpus/index.js +14 -0
  104. package/dist/analytics/extractCorpus/jsonlSessions.js +204 -0
  105. package/dist/analytics/extractCorpus/sqliteCaps.js +43 -0
  106. package/dist/analytics/extractCorpus/sqliteSessions.js +367 -0
  107. package/dist/analytics/extractCorpus/tierReader.js +108 -0
  108. package/dist/analytics/extractCorpus.js +2 -1791
  109. package/dist/analytics/glossaryAdviceResolution.js +166 -0
  110. package/dist/analytics/glossaryInputAcquisition.js +319 -0
  111. package/dist/analytics/personalGlossaryAdmission.js +133 -0
  112. package/dist/analytics/personalGlossaryProfile.js +219 -0
  113. package/dist/analytics/profileSignals.js +211 -0
  114. package/dist/analytics/usageStats.js +169 -42
  115. package/dist/audit/terminologyDrift.js +281 -0
  116. package/dist/bin/agentera.js +3 -2
  117. package/dist/capabilities/audit/instructions.js +16 -0
  118. package/dist/capabilities/build/instructions.js +56 -0
  119. package/dist/capabilities/design/instructions.js +4 -0
  120. package/dist/capabilities/discuss/instructions.js +29 -0
  121. package/dist/capabilities/document/instructions.js +11 -0
  122. package/dist/capabilities/index.js +29 -27
  123. package/dist/capabilities/optimize/instructions.js +14 -0
  124. package/dist/capabilities/orchestrate/instructions.js +42 -0
  125. package/dist/capabilities/plan/instructions.js +33 -0
  126. package/dist/capabilities/profile/instructions.js +70 -0
  127. package/dist/capabilities/research/instructions.js +5 -0
  128. package/dist/capabilities/status/instructions.js +15 -0
  129. package/dist/capabilities/status/startupInstructions.js +34 -0
  130. package/dist/capabilities/vision/instructions.js +4 -0
  131. package/dist/cli/appContext.js +30 -24
  132. package/dist/cli/argvalidate.js +0 -1
  133. package/dist/cli/capabilityContext/benchmark.js +565 -0
  134. package/dist/cli/capabilityContext/bespoke.js +44 -0
  135. package/dist/cli/capabilityContext/build.js +242 -0
  136. package/dist/cli/capabilityContext/closeout.js +233 -0
  137. package/dist/cli/capabilityContext/contract.js +179 -0
  138. package/dist/cli/capabilityContext/evidence.js +463 -0
  139. package/dist/cli/capabilityContext/index.js +3 -0
  140. package/dist/cli/capabilityContext/orchestration.js +131 -0
  141. package/dist/cli/capabilityContext/planState.js +260 -0
  142. package/dist/cli/capabilityContext/progress.js +142 -0
  143. package/dist/cli/capabilityContext/projectVerification.js +409 -0
  144. package/dist/cli/capabilityContext/shared.js +83 -0
  145. package/dist/cli/capabilityContext/slim.js +152 -0
  146. package/dist/cli/capabilityContext/startup.js +150 -0
  147. package/dist/cli/capabilityContext/startupAggregation.js +68 -0
  148. package/dist/cli/capabilityContext/types.js +56 -0
  149. package/dist/cli/capabilityContext.js +1 -2487
  150. package/dist/cli/commands/appHome.js +22 -0
  151. package/dist/cli/commands/capability.js +4 -4
  152. package/dist/cli/commands/compact.js +164 -14
  153. package/dist/cli/commands/doctor.js +122 -97
  154. package/dist/cli/commands/durability.js +81 -0
  155. package/dist/cli/commands/glossaryAdvice.js +138 -0
  156. package/dist/cli/commands/lint.js +26 -44
  157. package/dist/cli/commands/personalGlossary.js +176 -0
  158. package/dist/cli/commands/prime/briefOrientation.js +747 -0
  159. package/dist/cli/commands/prime/buildExecutionRequest.js +165 -0
  160. package/dist/cli/commands/prime/bundleStatus.js +190 -0
  161. package/dist/cli/commands/prime/collectEntityOrientation.js +326 -0
  162. package/dist/cli/commands/prime/collectOrientationState.js +212 -0
  163. package/dist/cli/commands/prime/orientationOutput.js +399 -0
  164. package/dist/cli/commands/prime/types.js +1 -0
  165. package/dist/cli/commands/prime/v1Migration.js +38 -0
  166. package/dist/cli/commands/prime.js +80 -558
  167. package/dist/cli/commands/profileGrounding.js +55 -0
  168. package/dist/cli/commands/query.js +78 -53
  169. package/dist/cli/commands/report.js +96 -25
  170. package/dist/cli/commands/route.js +142 -0
  171. package/dist/cli/commands/schema.js +266 -143
  172. package/dist/cli/commands/state/decisions.js +387 -0
  173. package/dist/cli/commands/state/docs.js +70 -0
  174. package/dist/cli/commands/state/experimentRecords.js +151 -0
  175. package/dist/cli/commands/state/experiments.js +14 -0
  176. package/dist/cli/commands/state/get.js +129 -0
  177. package/dist/cli/commands/state/health.js +14 -0
  178. package/dist/cli/commands/state/index.js +16 -0
  179. package/dist/cli/commands/state/list.js +194 -0
  180. package/dist/cli/commands/state/objective.js +25 -0
  181. package/dist/cli/commands/state/plan.js +14 -0
  182. package/dist/cli/commands/state/planTasks.js +154 -0
  183. package/dist/cli/commands/state/plans.js +154 -0
  184. package/dist/cli/commands/state/progress.js +13 -0
  185. package/dist/cli/commands/state/shared.js +14 -0
  186. package/dist/cli/commands/state/todo.js +42 -0
  187. package/dist/cli/commands/state/write.js +430 -0
  188. package/dist/cli/commands/upgrade.js +146 -5
  189. package/dist/cli/commands/upgradeVerify.js +118 -0
  190. package/dist/cli/commands/validate.js +272 -223
  191. package/dist/cli/commands/verify.js +24 -9
  192. package/dist/cli/contracts/bundleStatus.js +1 -0
  193. package/dist/cli/contracts/orientationState.js +1 -0
  194. package/dist/cli/dispatch/argvParser.js +32 -0
  195. package/dist/cli/dispatch/check.js +372 -0
  196. package/dist/cli/dispatch/commands.js +27 -0
  197. package/dist/cli/dispatch/index.js +207 -0
  198. package/dist/cli/dispatch/lifecycle.js +652 -0
  199. package/dist/cli/dispatch/prime.js +139 -0
  200. package/dist/cli/dispatch/projections.js +17 -0
  201. package/dist/cli/dispatch/shared.js +63 -0
  202. package/dist/cli/dispatch/state.js +140 -0
  203. package/dist/cli/dispatch.js +1 -1294
  204. package/dist/cli/errors.js +16 -17
  205. package/dist/cli/help.js +394 -43
  206. package/dist/cli/migrationRequired.js +87 -0
  207. package/dist/cli/orientation/attention.js +61 -0
  208. package/dist/cli/orientation/corpusCoverage.js +102 -0
  209. package/dist/cli/orientation.js +438 -170
  210. package/dist/cli/planArtifacts.js +350 -0
  211. package/dist/cli/planEvidence.js +157 -0
  212. package/dist/cli/planLifecycleState.js +36 -0
  213. package/dist/cli/planTaskIndex.js +11 -0
  214. package/dist/cli/preCutoverCommand.js +32 -0
  215. package/dist/cli/prime-blob.js +71 -3
  216. package/dist/cli/profileAcquisition.js +167 -0
  217. package/dist/cli/startupCompletenessContract.js +59 -0
  218. package/dist/cli/stateQuery.js +56 -14
  219. package/dist/cli/structured.js +0 -1
  220. package/dist/cli/todoMarkdown.js +25 -12
  221. package/dist/cli/todoReadinessSelection.js +192 -0
  222. package/dist/cli/todoSeverity.js +18 -0
  223. package/dist/core/atomicWriter.js +20 -0
  224. package/dist/core/developmentChannel.js +1 -0
  225. package/dist/core/developmentInvocation.js +374 -0
  226. package/dist/core/difflib.js +0 -1
  227. package/dist/core/envPaths.js +20 -0
  228. package/dist/core/jsonValue.js +5 -0
  229. package/dist/core/paths.js +0 -1
  230. package/dist/core/pyjson.js +67 -3
  231. package/dist/core/shell.js +4 -0
  232. package/dist/core/skillIdentity.js +23 -0
  233. package/dist/core/sourceRoot.js +9 -12
  234. package/dist/core/text.js +10 -0
  235. package/dist/core/toml.js +0 -1
  236. package/dist/core/yaml.js +8 -1
  237. package/dist/eval/evalSkills.js +30 -26
  238. package/dist/eval/hybridRouteEvaluation.js +155 -0
  239. package/dist/eval/semanticEval.js +43 -20
  240. package/dist/eval/semanticFixtures.js +16 -5
  241. package/dist/hooks/common.js +11 -79
  242. package/dist/hooks/compaction/apply.js +446 -0
  243. package/dist/hooks/compaction/dryRun.js +184 -0
  244. package/dist/hooks/compaction/index.js +22 -0
  245. package/dist/hooks/compaction/parse.js +325 -0
  246. package/dist/hooks/compaction/retention.js +202 -0
  247. package/dist/hooks/compaction/status.js +360 -0
  248. package/dist/hooks/compaction/types.js +5 -0
  249. package/dist/hooks/validateArtifact/agentFacing.js +9 -0
  250. package/dist/hooks/validateArtifact/index.js +92 -0
  251. package/dist/hooks/validateArtifact/markdown.js +145 -0
  252. package/dist/hooks/validateArtifact/schema.js +546 -0
  253. package/dist/hooks/validateArtifact/traversal.js +107 -0
  254. package/dist/hooks/validateArtifact/violations.js +107 -0
  255. package/dist/migrate/v2HandoffManifest.js +452 -0
  256. package/dist/registries/activationContract.js +2 -0
  257. package/dist/registries/activationTuples.js +107 -0
  258. package/dist/registries/artifactProtocolIds.js +78 -0
  259. package/dist/registries/artifactRegistry.js +224 -63
  260. package/dist/registries/artifactSchemaProjection.js +45 -0
  261. package/dist/registries/capabilityContract.js +129 -2
  262. package/dist/registries/evaluatorHandoffContract.js +2 -3
  263. package/dist/registries/evidenceTierContract.js +371 -0
  264. package/dist/registries/glossaryAdviceContract.js +79 -0
  265. package/dist/registries/glossaryCaveatContract.js +67 -0
  266. package/dist/registries/glossaryConsumerContractValidation.js +787 -0
  267. package/dist/registries/glossaryEntryContract.js +757 -0
  268. package/dist/registries/glossaryTermIdentity.js +17 -0
  269. package/dist/registries/glossaryTermOccurrence.js +20 -0
  270. package/dist/registries/hybridRoute.js +274 -0
  271. package/dist/registries/hybridRouteReceipt.js +221 -0
  272. package/dist/registries/packagePublication.js +229 -0
  273. package/dist/registries/packageRegistry.js +187 -211
  274. package/dist/registries/todoReadinessContract.js +448 -0
  275. package/dist/registries/triggerLoader.js +174 -0
  276. package/dist/registries/verbosityBudgetContract.js +205 -0
  277. package/dist/release/releaseMetadata.js +385 -0
  278. package/dist/runtime/lifecycleAdapterContract.js +457 -0
  279. package/dist/runtime/lifecycleAdapters.js +777 -0
  280. package/dist/runtime/lifecycleAuthority.js +453 -0
  281. package/dist/runtime/lifecycleOperationContract.js +123 -0
  282. package/dist/runtime/lifecycleOperations.js +634 -0
  283. package/dist/runtime/lifecycleOwnershipJournal.js +622 -0
  284. package/dist/runtime/lifecyclePublication.js +415 -0
  285. package/dist/runtime/lifecycleSnapshot.js +438 -0
  286. package/dist/runtime/nativeResourceCleanup.js +502 -0
  287. package/dist/setup/opencode.js +20 -0
  288. package/dist/setup/opencodeConstants.js +1 -0
  289. package/dist/setup/sharedSkill.js +45 -0
  290. package/dist/setup/smokeChecks.js +21 -82
  291. package/dist/state/archiveDiscovery.js +580 -0
  292. package/dist/state/archivePublication.js +225 -0
  293. package/dist/state/archiveRecovery.js +237 -0
  294. package/dist/state/archiveReplay.js +53 -0
  295. package/dist/state/canonicalMigrationRecord.js +36 -0
  296. package/dist/state/changelog.js +221 -0
  297. package/dist/state/decisionEntities.js +367 -0
  298. package/dist/state/decisionLegacyValidation.js +215 -0
  299. package/dist/state/decisionMigrationProvenance.js +199 -0
  300. package/dist/state/decisionOverlay.js +254 -0
  301. package/dist/state/decisionRevision.js +256 -0
  302. package/dist/state/decisionRevisionMigration.js +89 -0
  303. package/dist/state/directRetrieval.js +323 -0
  304. package/dist/state/durability.js +324 -0
  305. package/dist/state/entityCutover.js +459 -0
  306. package/dist/state/entityCutoverGit.js +127 -0
  307. package/dist/state/entityGlossaryAuthority.js +13 -0
  308. package/dist/state/entityListProjection.js +187 -0
  309. package/dist/state/entityListRuntimeRegistry.js +85 -0
  310. package/dist/state/entityMigrationCausality.js +97 -0
  311. package/dist/state/entityMigrationIdentity.js +5 -0
  312. package/dist/state/entityMigrationPreview.js +846 -0
  313. package/dist/state/entityMigrationTodo.js +133 -0
  314. package/dist/state/entityPublicationContext.js +806 -0
  315. package/dist/state/entityRetrievalHelp.js +506 -0
  316. package/dist/state/entityStorage.js +899 -0
  317. package/dist/state/exactReplacementRecovery.js +18 -0
  318. package/dist/state/experimentArchive.js +63 -0
  319. package/dist/state/experimentIdentity.js +202 -0
  320. package/dist/state/healthEntities.js +262 -0
  321. package/dist/state/healthEntityValidation.js +18 -0
  322. package/dist/state/healthRepair.js +69 -0
  323. package/dist/state/installRoot.js +64 -25
  324. package/dist/state/legacyEntityCutoverEvidence.js +65 -0
  325. package/dist/state/legacyIdentity.js +47 -0
  326. package/dist/state/legacySummaryRecord.js +6 -0
  327. package/dist/state/listAccounting.js +54 -0
  328. package/dist/state/listClassification.js +17 -0
  329. package/dist/state/listCursor.js +42 -0
  330. package/dist/state/listRetrieval.js +781 -0
  331. package/dist/state/migrationSourceBinding.js +30 -0
  332. package/dist/state/objectiveExperimentEntities.js +322 -0
  333. package/dist/state/planEntities.js +982 -0
  334. package/dist/state/planIdentity.js +47 -0
  335. package/dist/state/planLineageValidation.js +52 -0
  336. package/dist/state/planReplacementTransaction.js +475 -0
  337. package/dist/state/planRetrieval.js +313 -0
  338. package/dist/state/planTaskRetrieval.js +294 -0
  339. package/dist/state/progressEntities.js +512 -0
  340. package/dist/state/progressGlossaryCaveat.js +168 -0
  341. package/dist/state/progressPublicationOrder.js +19 -0
  342. package/dist/state/projectRoot.js +62 -0
  343. package/dist/state/projectionPolicy.js +190 -0
  344. package/dist/state/retrievalAuthority.js +156 -0
  345. package/dist/state/safeProjectFile.js +155 -0
  346. package/dist/state/startupAnalysis/benchmark.js +432 -0
  347. package/dist/state/startupAnalysis/contract.js +160 -0
  348. package/dist/state/startupAnalysis/helpers.js +286 -0
  349. package/dist/state/startupAnalysis/index.js +6 -0
  350. package/dist/state/startupAnalysis/metrics.js +340 -0
  351. package/dist/state/startupAnalysis/records.js +198 -0
  352. package/dist/state/startupAnalysis/report.js +111 -0
  353. package/dist/state/startupAnalysis/threshold.js +512 -0
  354. package/dist/state/startupAnalysis.js +2 -1953
  355. package/dist/state/startupProjection.js +499 -0
  356. package/dist/state/stateMode.js +85 -0
  357. package/dist/state/stateStorageAuthority.js +47 -0
  358. package/dist/state/summaryEntityRead.js +25 -0
  359. package/dist/state/summaryMigrationProvenance.js +66 -0
  360. package/dist/state/summarySourceRowAuthority.js +36 -0
  361. package/dist/state/todoActivationSafety.js +58 -0
  362. package/dist/state/todoDocsEntities.js +1069 -0
  363. package/dist/state/todoDocsEntityValidation.js +158 -0
  364. package/dist/state/todoMarkdownProjection.js +51 -0
  365. package/dist/state/todoReconciliationActivation.js +140 -0
  366. package/dist/state/todoReconciliationInspection.js +169 -0
  367. package/dist/state/todoReconciliationRepair.js +170 -0
  368. package/dist/state/todoReconciliationTransaction.js +582 -0
  369. package/dist/state/write/assign.js +20 -0
  370. package/dist/state/write/candidateMutation.js +269 -0
  371. package/dist/state/write/errors.js +11 -0
  372. package/dist/state/write/experimentPublication.js +192 -0
  373. package/dist/state/write/explain.js +363 -0
  374. package/dist/state/write/fields.js +61 -0
  375. package/dist/state/write/glossaryPublication.js +263 -0
  376. package/dist/state/write/grammar.js +285 -0
  377. package/dist/state/write/helpers.js +29 -0
  378. package/dist/state/write/index.js +12 -0
  379. package/dist/state/write/input.js +367 -0
  380. package/dist/state/write/lock.js +837 -0
  381. package/dist/state/write/mutation.js +234 -0
  382. package/dist/state/write/operations.js +170 -0
  383. package/dist/state/write/planEvaluation.js +128 -0
  384. package/dist/state/write/planPublication.js +179 -0
  385. package/dist/state/write/runtimeOperations.js +144 -0
  386. package/dist/state/write/serialize.js +1 -0
  387. package/dist/state/write/transaction.js +52 -0
  388. package/dist/state/write/validate.js +7 -0
  389. package/dist/upgrade/appContentRefresh.js +383 -0
  390. package/dist/upgrade/appModel.js +8 -7
  391. package/dist/upgrade/atomicWriter.js +1 -0
  392. package/dist/upgrade/bundleEvidence.js +33 -0
  393. package/dist/upgrade/channels.js +12 -8
  394. package/dist/upgrade/compatibility.js +56 -21
  395. package/dist/upgrade/doctor.js +197 -192
  396. package/dist/upgrade/doctorClassifier.js +187 -0
  397. package/dist/upgrade/installedHooksRetirement.js +196 -0
  398. package/dist/upgrade/legacyAgentCleanup.js +282 -0
  399. package/dist/upgrade/lifecycleUpgrade.js +113 -0
  400. package/dist/upgrade/migrateArtifactsV2ToV3.js +367 -149
  401. package/dist/upgrade/migrationPublication.js +122 -0
  402. package/dist/upgrade/nextMajorDoctor.js +42 -8
  403. package/dist/upgrade/npxPlatformStatus.js +22 -0
  404. package/dist/upgrade/projectIntegration.js +145 -187
  405. package/dist/upgrade/projectIntegrationDecision.js +50 -0
  406. package/dist/upgrade/retiredResourceDiagnostics.js +117 -0
  407. package/dist/upgrade/runtimeMigration.js +273 -363
  408. package/dist/upgrade/upgradeCommands.js +14 -1
  409. package/dist/upgrade/upgradeLock.js +85 -0
  410. package/dist/upgrade/upgradeOrchestrator.js +263 -59
  411. package/dist/upgrade/v3CapabilitySurface.js +14 -0
  412. package/dist/upgrade/versionResolution.js +8 -1
  413. package/dist/validate/activationArtifactEvidence.js +844 -0
  414. package/dist/validate/activationConjunction.js +816 -0
  415. package/dist/validate/activationEvidenceManifest.js +515 -0
  416. package/dist/validate/activationPackageSemantics.js +29 -0
  417. package/dist/validate/appHomeContract.js +5 -11
  418. package/dist/validate/bootstrapAuthority.js +44 -0
  419. package/dist/validate/capability.js +133 -12
  420. package/dist/validate/crossCapability.js +15 -10
  421. package/dist/validate/retainedReferenceAuthority.js +879 -0
  422. package/dist/validate/selfAudit.js +73 -37
  423. package/dist/validate/v1LegacyCruft.js +131 -0
  424. package/dist/validate/vocabularyAuthority.js +303 -0
  425. package/package.json +53 -27
  426. package/bundle/references/adapters/cursor.md +0 -213
  427. package/bundle/references/adapters/opencode.md +0 -530
  428. package/bundle/references/adapters/package-manifest-interface-model.yaml +0 -337
  429. package/bundle/references/adapters/runtime-adapter-characterization.md +0 -79
  430. package/bundle/references/adapters/runtime-adapter-interface-model.yaml +0 -200
  431. package/bundle/references/adapters/runtime-adapter-registry.yaml +0 -548
  432. package/bundle/references/adapters/runtime-feature-parity.md +0 -189
  433. package/bundle/references/analysis/benchmark.md +0 -267
  434. package/bundle/references/analysis/startup-measurement-contract.yaml +0 -424
  435. package/bundle/references/cli/agent-ready-state-contract.yaml +0 -953
  436. package/bundle/references/cli/audience-namespace-cli-migration.yaml +0 -355
  437. package/bundle/references/cli/bundle-skill-vocabulary.yaml +0 -278
  438. package/bundle/references/cli/capability-tool-classification.yaml +0 -53
  439. package/bundle/references/cli/routing-execution-vocabulary.yaml +0 -281
  440. package/bundle/references/meta/documentation-inventory.md +0 -43
  441. package/bundle/references/v1-section-mapping.md +0 -47
  442. package/bundle/skills/agentera/.claude-plugin/plugin.json +0 -27
  443. package/bundle/skills/agentera/agents/dokumentera.toml +0 -6
  444. package/bundle/skills/agentera/agents/hej.toml +0 -6
  445. package/bundle/skills/agentera/agents/inspektera.toml +0 -6
  446. package/bundle/skills/agentera/agents/inspirera.toml +0 -6
  447. package/bundle/skills/agentera/agents/optimera.toml +0 -6
  448. package/bundle/skills/agentera/agents/orkestrera.toml +0 -6
  449. package/bundle/skills/agentera/agents/planera.toml +0 -6
  450. package/bundle/skills/agentera/agents/profilera.toml +0 -6
  451. package/bundle/skills/agentera/agents/realisera.toml +0 -6
  452. package/bundle/skills/agentera/agents/resonera.toml +0 -6
  453. package/bundle/skills/agentera/agents/visionera.toml +0 -6
  454. package/bundle/skills/agentera/agents/visualisera.toml +0 -6
  455. package/bundle/skills/agentera/capabilities/dokumentera/schemas/artifacts.yaml +0 -73
  456. package/bundle/skills/agentera/capabilities/dokumentera/schemas/triggers.yaml +0 -35
  457. package/bundle/skills/agentera/capabilities/hej/schemas/artifacts.yaml +0 -69
  458. package/bundle/skills/agentera/capabilities/hej/schemas/triggers.yaml +0 -58
  459. package/bundle/skills/agentera/capabilities/inspektera/schemas/artifacts.yaml +0 -76
  460. package/bundle/skills/agentera/capabilities/inspektera/schemas/triggers.yaml +0 -38
  461. package/bundle/skills/agentera/capabilities/inspirera/schemas/artifacts.yaml +0 -24
  462. package/bundle/skills/agentera/capabilities/inspirera/schemas/triggers.yaml +0 -34
  463. package/bundle/skills/agentera/capabilities/optimera/schemas/triggers.yaml +0 -39
  464. package/bundle/skills/agentera/capabilities/orkestrera/schemas/artifacts.yaml +0 -64
  465. package/bundle/skills/agentera/capabilities/orkestrera/schemas/triggers.yaml +0 -42
  466. package/bundle/skills/agentera/capabilities/orkestrera/schemas/validation.yaml +0 -120
  467. package/bundle/skills/agentera/capabilities/planera/schemas/artifacts.yaml +0 -62
  468. package/bundle/skills/agentera/capabilities/planera/schemas/triggers.yaml +0 -34
  469. package/bundle/skills/agentera/capabilities/planera/schemas/validation.yaml +0 -61
  470. package/bundle/skills/agentera/capabilities/profilera/schemas/artifacts.yaml +0 -18
  471. package/bundle/skills/agentera/capabilities/profilera/schemas/triggers.yaml +0 -45
  472. package/bundle/skills/agentera/capabilities/profilera/schemas/validation.yaml +0 -57
  473. package/bundle/skills/agentera/capabilities/realisera/schemas/artifacts.yaml +0 -80
  474. package/bundle/skills/agentera/capabilities/realisera/schemas/triggers.yaml +0 -39
  475. package/bundle/skills/agentera/capabilities/realisera/schemas/validation.yaml +0 -110
  476. package/bundle/skills/agentera/capabilities/resonera/schemas/artifacts.yaml +0 -47
  477. package/bundle/skills/agentera/capabilities/resonera/schemas/triggers.yaml +0 -46
  478. package/bundle/skills/agentera/capabilities/resonera/schemas/validation.yaml +0 -77
  479. package/bundle/skills/agentera/capabilities/visionera/schemas/triggers.yaml +0 -41
  480. package/bundle/skills/agentera/capabilities/visualisera/schemas/triggers.yaml +0 -33
  481. package/bundle/skills/agentera/references/contract.md +0 -1039
  482. package/bundle/skills/hej/.claude-plugin/plugin.json +0 -6
  483. package/bundle/skills/hej/SKILL.md +0 -69
  484. package/bundle/skills/hej/agents/hej.toml +0 -11
  485. package/bundle/skills/hej/agents/openai.yaml +0 -8
  486. package/dist/analytics/extractCorpus.js.map +0 -1
  487. package/dist/analytics/usageStats.js.map +0 -1
  488. package/dist/bin/agentera.js.map +0 -1
  489. package/dist/capabilities/dokumentera/instructions.js +0 -6
  490. package/dist/capabilities/dokumentera/instructions.js.map +0 -1
  491. package/dist/capabilities/hej/instructions.js +0 -6
  492. package/dist/capabilities/hej/instructions.js.map +0 -1
  493. package/dist/capabilities/index.js.map +0 -1
  494. package/dist/capabilities/inspektera/instructions.js +0 -6
  495. package/dist/capabilities/inspektera/instructions.js.map +0 -1
  496. package/dist/capabilities/inspirera/instructions.js +0 -6
  497. package/dist/capabilities/inspirera/instructions.js.map +0 -1
  498. package/dist/capabilities/optimera/instructions.js +0 -6
  499. package/dist/capabilities/optimera/instructions.js.map +0 -1
  500. package/dist/capabilities/orkestrera/instructions.js +0 -6
  501. package/dist/capabilities/orkestrera/instructions.js.map +0 -1
  502. package/dist/capabilities/planera/instructions.js +0 -6
  503. package/dist/capabilities/planera/instructions.js.map +0 -1
  504. package/dist/capabilities/profilera/instructions.js +0 -6
  505. package/dist/capabilities/profilera/instructions.js.map +0 -1
  506. package/dist/capabilities/realisera/instructions.js +0 -6
  507. package/dist/capabilities/realisera/instructions.js.map +0 -1
  508. package/dist/capabilities/resonera/instructions.js +0 -6
  509. package/dist/capabilities/resonera/instructions.js.map +0 -1
  510. package/dist/capabilities/visionera/instructions.js +0 -6
  511. package/dist/capabilities/visionera/instructions.js.map +0 -1
  512. package/dist/capabilities/visualisera/instructions.js +0 -6
  513. package/dist/capabilities/visualisera/instructions.js.map +0 -1
  514. package/dist/cli/appContext.js.map +0 -1
  515. package/dist/cli/argvalidate.js.map +0 -1
  516. package/dist/cli/capabilityContext.js.map +0 -1
  517. package/dist/cli/commands/capability.js.map +0 -1
  518. package/dist/cli/commands/compact.js.map +0 -1
  519. package/dist/cli/commands/doctor.js.map +0 -1
  520. package/dist/cli/commands/lint.js.map +0 -1
  521. package/dist/cli/commands/prime.js.map +0 -1
  522. package/dist/cli/commands/query.js.map +0 -1
  523. package/dist/cli/commands/report.js.map +0 -1
  524. package/dist/cli/commands/schema.js.map +0 -1
  525. package/dist/cli/commands/state.js +0 -1023
  526. package/dist/cli/commands/state.js.map +0 -1
  527. package/dist/cli/commands/upgrade.js.map +0 -1
  528. package/dist/cli/commands/validate.js.map +0 -1
  529. package/dist/cli/commands/verify.js.map +0 -1
  530. package/dist/cli/dispatch.js.map +0 -1
  531. package/dist/cli/errors.js.map +0 -1
  532. package/dist/cli/help.js.map +0 -1
  533. package/dist/cli/orientation.js.map +0 -1
  534. package/dist/cli/prime-blob.js.map +0 -1
  535. package/dist/cli/stateQuery.js.map +0 -1
  536. package/dist/cli/structured.js.map +0 -1
  537. package/dist/cli/todoMarkdown.js.map +0 -1
  538. package/dist/core/difflib.js.map +0 -1
  539. package/dist/core/paths.js.map +0 -1
  540. package/dist/core/pyjson.js.map +0 -1
  541. package/dist/core/sourceRoot.js.map +0 -1
  542. package/dist/core/toml.js.map +0 -1
  543. package/dist/core/yaml.js.map +0 -1
  544. package/dist/eval/evalSkills.js.map +0 -1
  545. package/dist/eval/semanticEval.js.map +0 -1
  546. package/dist/eval/semanticFixtures.js.map +0 -1
  547. package/dist/hooks/common.js.map +0 -1
  548. package/dist/hooks/compaction.js +0 -935
  549. package/dist/hooks/compaction.js.map +0 -1
  550. package/dist/hooks/cursorPreToolUse.js +0 -19
  551. package/dist/hooks/cursorPreToolUse.js.map +0 -1
  552. package/dist/hooks/cursorSessionStart.js +0 -71
  553. package/dist/hooks/cursorSessionStart.js.map +0 -1
  554. package/dist/hooks/sessionStart.js +0 -209
  555. package/dist/hooks/sessionStart.js.map +0 -1
  556. package/dist/hooks/sessionStop.js +0 -212
  557. package/dist/hooks/sessionStop.js.map +0 -1
  558. package/dist/hooks/validateArtifact.js +0 -935
  559. package/dist/hooks/validateArtifact.js.map +0 -1
  560. package/dist/registries/artifactRegistry.js.map +0 -1
  561. package/dist/registries/capabilityContract.js.map +0 -1
  562. package/dist/registries/evaluatorHandoffContract.js.map +0 -1
  563. package/dist/registries/packageRegistry.js.map +0 -1
  564. package/dist/registries/runtimeAdapterRegistry.js +0 -315
  565. package/dist/registries/runtimeAdapterRegistry.js.map +0 -1
  566. package/dist/setup/codex.js +0 -1197
  567. package/dist/setup/codex.js.map +0 -1
  568. package/dist/setup/copilot.js +0 -227
  569. package/dist/setup/copilot.js.map +0 -1
  570. package/dist/setup/cursor.js +0 -127
  571. package/dist/setup/cursor.js.map +0 -1
  572. package/dist/setup/doctor.js +0 -1297
  573. package/dist/setup/doctor.js.map +0 -1
  574. package/dist/setup/smokeChecks.js.map +0 -1
  575. package/dist/state/installRoot.js.map +0 -1
  576. package/dist/state/startupAnalysis.js.map +0 -1
  577. package/dist/upgrade/appModel.js.map +0 -1
  578. package/dist/upgrade/channels.js.map +0 -1
  579. package/dist/upgrade/compatibility.js.map +0 -1
  580. package/dist/upgrade/doctor.js.map +0 -1
  581. package/dist/upgrade/migrateArtifactsV1ToV2.js +0 -570
  582. package/dist/upgrade/migrateArtifactsV1ToV2.js.map +0 -1
  583. package/dist/upgrade/migrateArtifactsV2ToV3.js.map +0 -1
  584. package/dist/upgrade/nextMajorDoctor.js.map +0 -1
  585. package/dist/upgrade/projectIntegration.js.map +0 -1
  586. package/dist/upgrade/runtimeMigration.js.map +0 -1
  587. package/dist/upgrade/upgradeCommands.js.map +0 -1
  588. package/dist/upgrade/upgradeOrchestrator.js.map +0 -1
  589. package/dist/upgrade/versionResolution.js.map +0 -1
  590. package/dist/validate/appHomeContract.js.map +0 -1
  591. package/dist/validate/capability.js.map +0 -1
  592. package/dist/validate/crossCapability.js.map +0 -1
  593. package/dist/validate/lifecycleAdapters.js +0 -772
  594. package/dist/validate/lifecycleAdapters.js.map +0 -1
  595. package/dist/validate/selfAudit.js.map +0 -1
  596. /package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/exit.yaml +0 -0
  597. /package/bundle/skills/agentera/capabilities/{inspirera → research}/schemas/exit.yaml +0 -0
  598. /package/bundle/skills/agentera/capabilities/{hej → status}/schemas/exit.yaml +0 -0
@@ -0,0 +1,260 @@
1
+ import { discoverRuntimeStore, eventTimestamp, isoFromMtime, iterJsonl, rglob, } from "./core.js";
2
+ import { isFilePath, isDir } from "./core.js";
3
+ import { resolveCopilotStorePath, resolveCursorChatsPath, resolveCursorProjectsPath, resolveOpencodeDbPath, } from "./cursorSessions.js";
4
+ import { openSqlite, PermissionDeniedError, sqliteTimestamp, tableColumns, firstColumn, } from "./sqliteSessions.js";
5
+ export const COVERAGE_EXIT_FLAGGED = 4;
6
+ export function corpusEnvelopeCoverage(audit) {
7
+ return {
8
+ available_runtimes: [...audit.available_runtimes],
9
+ selected_runtimes: [...audit.selected_runtimes],
10
+ available_but_not_selected: audit.skipped_available.map((item) => ({
11
+ runtime: item.runtime,
12
+ reason: item.reason,
13
+ store_path: item.store_path,
14
+ })),
15
+ };
16
+ }
17
+ export function resolveRuntimeStoreConfigs(args, env = process.env, _platform = process.platform) {
18
+ const configs = [
19
+ { runtime: "codex", sourceProduct: "codex", sourceClass: "active_runtime", activeRuntime: true, storePath: args.codexSessionsDir, selected: !args.noCodex, skipReason: args.noCodex ? "disabled_by_flag" : null },
20
+ { runtime: "cursor", sourceProduct: "cursor", sourceClass: "active_runtime", activeRuntime: true, storePath: args.cursorProjectsDir || resolveCursorProjectsPath(env), selected: !args.noCursor, skipReason: args.noCursor ? "disabled_by_flag" : null },
21
+ { runtime: "cursor", sourceProduct: "cursor-agent", sourceClass: "active_runtime", activeRuntime: true, pattern: "store.db", storePath: args.cursorChatsDir || resolveCursorChatsPath(env), selected: !args.noCursor, skipReason: args.noCursor ? "disabled_by_flag" : null },
22
+ { runtime: "opencode", sourceProduct: "opencode", sourceClass: "active_runtime", activeRuntime: true, storePath: args.opencodeConversationsDir || resolveOpencodeDbPath(env), selected: !args.noOpencode, skipReason: args.noOpencode ? "disabled_by_flag" : null },
23
+ { runtime: "copilot", sourceProduct: "github-copilot", sourceClass: "active_runtime", activeRuntime: true, storePath: args.copilotConversationsDir || resolveCopilotStorePath(env), selected: !args.noCopilot, skipReason: args.noCopilot ? "disabled_by_flag" : null },
24
+ ];
25
+ if ((args.importSources ?? []).includes("claude")) {
26
+ configs.push({
27
+ runtime: null,
28
+ sourceProduct: "claude-code",
29
+ sourceClass: "historical_import",
30
+ activeRuntime: false,
31
+ pattern: "*.jsonl",
32
+ storePath: args.claudeProjectsDir,
33
+ selected: true,
34
+ skipReason: null,
35
+ });
36
+ }
37
+ return configs.map((config) => ({ ...config, storePath: config.storePath ?? null }));
38
+ }
39
+ function trackEarliest(current, candidate) {
40
+ if (!candidate)
41
+ return current;
42
+ if (current === null)
43
+ return candidate;
44
+ return candidate < current ? candidate : current;
45
+ }
46
+ function trackLatest(current, candidate) {
47
+ if (!candidate)
48
+ return current;
49
+ if (current === null)
50
+ return candidate;
51
+ return candidate > current ? candidate : current;
52
+ }
53
+ function probeJsonlTimestamps(storePath) {
54
+ let earliest = null;
55
+ let latest = null;
56
+ for (const filePath of rglob(storePath, "*.jsonl")) {
57
+ const fallback = isoFromMtime(filePath);
58
+ let sawEvent = false;
59
+ for (const event of iterJsonl(filePath, [])) {
60
+ sawEvent = true;
61
+ const ts = eventTimestamp(event, fallback);
62
+ earliest = trackEarliest(earliest, ts);
63
+ latest = trackLatest(latest, ts);
64
+ }
65
+ if (!sawEvent) {
66
+ earliest = trackEarliest(earliest, fallback);
67
+ latest = trackLatest(latest, fallback);
68
+ }
69
+ }
70
+ return { earliest, latest };
71
+ }
72
+ function probeSqliteTimestamps(storePath, sourceProduct) {
73
+ const dbPaths = sourceProduct === "opencode"
74
+ ? [storePath]
75
+ : sourceProduct === "github-copilot"
76
+ ? isFilePath(storePath)
77
+ ? [storePath]
78
+ : rglob(storePath, "session-store.db")
79
+ : rglob(storePath, "store.db");
80
+ let earliest = null;
81
+ let latest = null;
82
+ for (const dbPath of dbPaths) {
83
+ if (!isFilePath(dbPath))
84
+ continue;
85
+ const fallback = isoFromMtime(dbPath);
86
+ let conn;
87
+ try {
88
+ conn = openSqlite(dbPath);
89
+ }
90
+ catch (exc) {
91
+ if (exc instanceof PermissionDeniedError)
92
+ continue;
93
+ continue;
94
+ }
95
+ try {
96
+ if (sourceProduct === "opencode") {
97
+ const cols = tableColumns(conn, "session");
98
+ const timeCol = firstColumn(cols, ["time_created", "time", "timestamp", "created_at", "createdAt"]);
99
+ if (timeCol) {
100
+ const row = conn
101
+ .prepare(`SELECT MIN("${timeCol.replace(/"/g, '""')}") AS min_ts, MAX("${timeCol.replace(/"/g, '""')}") AS max_ts FROM session`)
102
+ .get();
103
+ if (row) {
104
+ const minTs = sqliteTimestamp(row.min_ts, fallback);
105
+ const maxTs = sqliteTimestamp(row.max_ts, fallback);
106
+ earliest = trackEarliest(earliest, minTs);
107
+ latest = trackLatest(latest, maxTs);
108
+ }
109
+ }
110
+ }
111
+ else if (sourceProduct === "github-copilot") {
112
+ const sessionCols = tableColumns(conn, "sessions");
113
+ const turnCols = tableColumns(conn, "turns");
114
+ const sessionTime = firstColumn(sessionCols, ["time", "timestamp", "created_at", "createdAt"]);
115
+ const turnTime = firstColumn(turnCols, ["time", "timestamp", "created_at", "createdAt"]);
116
+ const timeCol = turnTime ?? sessionTime;
117
+ const table = turnTime ? "turns" : sessionTime ? "sessions" : null;
118
+ if (timeCol && table) {
119
+ const escaped = timeCol.replace(/"/g, '""');
120
+ const row = conn.prepare(`SELECT MIN("${escaped}") AS min_ts, MAX("${escaped}") AS max_ts FROM ${table}`).get();
121
+ if (row) {
122
+ const minTs = sqliteTimestamp(row.min_ts, fallback);
123
+ const maxTs = sqliteTimestamp(row.max_ts, fallback);
124
+ earliest = trackEarliest(earliest, minTs);
125
+ latest = trackLatest(latest, maxTs);
126
+ }
127
+ }
128
+ }
129
+ else if (sourceProduct === "cursor-agent") {
130
+ const rows = conn.prepare("SELECT data FROM blobs ORDER BY id").all();
131
+ for (const row of rows) {
132
+ const payload = row.data;
133
+ let raw = "";
134
+ if (payload instanceof Uint8Array)
135
+ raw = Buffer.from(payload).toString("utf-8");
136
+ else if (typeof payload === "string")
137
+ raw = payload;
138
+ if (!raw)
139
+ continue;
140
+ try {
141
+ const parsed = JSON.parse(raw); // cast: IO boundary — parsed subprocess stdout JSON
142
+ const ts = eventTimestamp(parsed, fallback);
143
+ earliest = trackEarliest(earliest, ts);
144
+ latest = trackLatest(latest, ts);
145
+ }
146
+ catch {
147
+ earliest = trackEarliest(earliest, fallback);
148
+ latest = trackLatest(latest, fallback);
149
+ }
150
+ }
151
+ if (rows.length === 0) {
152
+ earliest = trackEarliest(earliest, fallback);
153
+ latest = trackLatest(latest, fallback);
154
+ }
155
+ }
156
+ }
157
+ catch {
158
+ earliest = trackEarliest(earliest, fallback);
159
+ latest = trackLatest(latest, fallback);
160
+ }
161
+ finally {
162
+ conn.close();
163
+ }
164
+ }
165
+ return { earliest, latest };
166
+ }
167
+ function probeRuntimeTimestamps(sourceProduct, storePath) {
168
+ if (sourceProduct === "opencode" || sourceProduct === "github-copilot" || sourceProduct === "cursor-agent") {
169
+ return probeSqliteTimestamps(storePath, sourceProduct);
170
+ }
171
+ if (isDir(storePath))
172
+ return probeJsonlTimestamps(storePath);
173
+ if (isFilePath(storePath))
174
+ return probeSqliteTimestamps(storePath, sourceProduct);
175
+ return { earliest: null, latest: null };
176
+ }
177
+ export function runCoverageAudit(args, env = process.env, platform = process.platform, acceptCoverageGap = false) {
178
+ const runtimes = [];
179
+ const skippedAvailable = [];
180
+ for (const config of resolveRuntimeStoreConfigs(args, env, platform)) {
181
+ const discovery = discoverRuntimeStore(config.runtime, config.storePath, {
182
+ sourceProduct: config.sourceProduct,
183
+ sourceClass: config.sourceClass,
184
+ activeRuntime: config.activeRuntime,
185
+ pattern: config.pattern,
186
+ });
187
+ const available = discovery.status === "available";
188
+ let earliest = null;
189
+ let latest = null;
190
+ if (available && config.storePath) {
191
+ const bounds = probeRuntimeTimestamps(config.sourceProduct, config.storePath);
192
+ earliest = bounds.earliest;
193
+ latest = bounds.latest;
194
+ }
195
+ const skipReason = available && !config.selected ? (config.skipReason ?? "disabled_by_flag") : null;
196
+ if (skipReason && config.storePath) {
197
+ skippedAvailable.push({ runtime: config.runtime, reason: skipReason, store_path: config.storePath });
198
+ }
199
+ runtimes.push({
200
+ runtime: config.runtime,
201
+ source_product: config.sourceProduct,
202
+ source_class: config.sourceClass,
203
+ active_runtime: config.activeRuntime,
204
+ store_path: config.storePath,
205
+ selected: config.selected,
206
+ discovery_status: String(discovery.status),
207
+ discovery_reason: String(discovery.reason),
208
+ available,
209
+ earliest_session: earliest,
210
+ latest_session: latest,
211
+ skip_reason: skipReason,
212
+ });
213
+ }
214
+ const availableRuntimes = [...new Set(runtimes.filter((r) => r.active_runtime && r.available).map((r) => r.runtime))];
215
+ const selectedRuntimes = [...new Set(runtimes.filter((r) => r.active_runtime && r.selected).map((r) => r.runtime))];
216
+ const coverageGapFlagged = skippedAvailable.length > 0 && !acceptCoverageGap;
217
+ return {
218
+ runtimes,
219
+ available_runtimes: availableRuntimes,
220
+ selected_runtimes: selectedRuntimes,
221
+ skipped_available: skippedAvailable,
222
+ coverage_gap_flagged: coverageGapFlagged,
223
+ exit_signal: skippedAvailable.length > 0 ? (acceptCoverageGap ? "complete" : "flagged") : "complete",
224
+ };
225
+ }
226
+ export function formatCoverageSummaryText(audit) {
227
+ const lines = ["Coverage Audit (pre-extraction)"];
228
+ for (const entry of audit.runtimes) {
229
+ const store = entry.store_path ?? "(none)";
230
+ if (entry.available) {
231
+ const span = entry.earliest_session && entry.latest_session
232
+ ? `${entry.earliest_session} .. ${entry.latest_session}`
233
+ : "timestamps unavailable";
234
+ const label = entry.active_runtime ? entry.runtime : `${entry.source_product} [historical import]`;
235
+ lines.push(` ${label}: available store=${store} sessions=${span} selected=${entry.selected ? "yes" : "no"}`);
236
+ }
237
+ else {
238
+ lines.push(` ${entry.active_runtime ? entry.runtime : `${entry.source_product} [historical import]`}: ${entry.discovery_status} (${entry.discovery_reason}) store=${store} selected=${entry.selected ? "yes" : "no"}`);
239
+ }
240
+ }
241
+ if (audit.skipped_available.length > 0) {
242
+ lines.push("Skipped available runtimes:");
243
+ for (const item of audit.skipped_available) {
244
+ lines.push(` - ${item.runtime}: ${item.reason} (${item.store_path})`);
245
+ }
246
+ if (audit.coverage_gap_flagged) {
247
+ lines.push("Coverage gap flagged (EX2): pass --accept-coverage-gap to proceed with partial extraction.");
248
+ }
249
+ else {
250
+ lines.push("Coverage gap accepted: proceeding with selected runtimes only.");
251
+ }
252
+ }
253
+ else if (audit.available_runtimes.length > 0) {
254
+ lines.push("All available runtimes are selected; no coverage gap.");
255
+ }
256
+ else {
257
+ lines.push("No available runtime stores detected on this host.");
258
+ }
259
+ return lines.join("\n");
260
+ }
@@ -0,0 +1,425 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import crypto from "node:crypto";
5
+ import { execFileSync } from "node:child_process";
6
+ import { expanduser, resolvePath } from "../../core/paths.js";
7
+ import { MAX_TOOL_ARG_TEXT, eventTimestamp, isFilePath, isoFromMtime, iterJsonl, record, signalType, textFromContent, toolCallRecordFromItem, } from "./core.js";
8
+ import { isPlainObject, rglob, isDir } from "./core.js";
9
+ import { openSqlite, } from "./sqliteSessions.js";
10
+ function pathStem(p) {
11
+ const base = path.basename(p);
12
+ const ext = path.extname(base);
13
+ return ext ? base.slice(0, -ext.length) : base;
14
+ }
15
+ export function resolveOpencodeDbPath(env = process.env) {
16
+ let out;
17
+ try {
18
+ out = execFileSync("opencode", ["db", "path"], { encoding: "utf-8", timeout: 2000 });
19
+ }
20
+ catch {
21
+ return null;
22
+ }
23
+ const trimmed = out.trim();
24
+ if (!trimmed)
25
+ return null;
26
+ const candidate = trimmed.split(/\r\n|\r|\n/)[0];
27
+ return candidate ? expanduser(candidate) : null;
28
+ }
29
+ function homeDir(env = process.env) {
30
+ return env.HOME || os.homedir();
31
+ }
32
+ export function resolveCopilotStorePath(env = process.env) {
33
+ return expanduser(env.COPILOT_HOME || path.join(homeDir(env), ".copilot"));
34
+ }
35
+ export function resolveCursorProjectsPath(env = process.env) {
36
+ return path.join(expanduser(env.CURSOR_HOME || path.join(homeDir(env), ".cursor")), "projects");
37
+ }
38
+ export function resolveCursorChatsPath(env = process.env) {
39
+ const configHome = env.CURSOR_CONFIG_HOME;
40
+ if (configHome)
41
+ return path.join(expanduser(configHome), "chats");
42
+ return path.join(homeDir(env), ".config", "cursor", "chats");
43
+ }
44
+ // ── cursor helpers ──────────────────────────────────────────────────
45
+ function pathParents(p) {
46
+ const parents = [];
47
+ let cur = p;
48
+ for (;;) {
49
+ const parent = path.dirname(cur);
50
+ if (parent === cur)
51
+ break;
52
+ parents.push(parent);
53
+ cur = parent;
54
+ }
55
+ return parents;
56
+ }
57
+ export function cursorWorkspaceHash(projectRoot) {
58
+ return crypto.createHash("md5").update(resolvePath(projectRoot), "utf-8").digest("hex");
59
+ }
60
+ export function cursorProjectDirSlug(projectRoot) {
61
+ const resolved = resolvePath(projectRoot);
62
+ // Python Path.parts: ("/", "a", "b") for absolute; drop the leading "/" anchor.
63
+ let segs = resolved.split(path.sep).filter((s) => s !== "");
64
+ // (leading-"/" anchor already dropped by filtering empties)
65
+ const slug = segs.join("-").toLowerCase();
66
+ const cleaned = slug.replace(/[^a-z0-9._-]+/g, "-").replace(/^-+/, "").replace(/-+$/, "");
67
+ return cleaned || "global";
68
+ }
69
+ function cursorProjectPathFromDir(projectDir) {
70
+ const name = path.basename(projectDir);
71
+ if (!name || /^\d+$/.test(name) || name === "empty-window")
72
+ return null;
73
+ const parts = name.split("-");
74
+ if (parts.length > 1 && parts[0] === "home")
75
+ return "/" + parts.join("/");
76
+ return null;
77
+ }
78
+ function boundToolArguments(args) {
79
+ const bounded = {};
80
+ for (const [key, value] of Object.entries(args)) {
81
+ if (typeof value === "string" && value.length > MAX_TOOL_ARG_TEXT) {
82
+ bounded[key] = value.slice(0, MAX_TOOL_ARG_TEXT) + "…";
83
+ }
84
+ else if (isPlainObject(value)) {
85
+ bounded[key] = boundToolArguments(value);
86
+ }
87
+ else if (Array.isArray(value)) {
88
+ bounded[key] = value.map((it) => typeof it === "string" && it.length > MAX_TOOL_ARG_TEXT ? it.slice(0, MAX_TOOL_ARG_TEXT) + "…" : it);
89
+ }
90
+ else {
91
+ bounded[key] = value;
92
+ }
93
+ }
94
+ return bounded;
95
+ }
96
+ function cursorContentItems(event) {
97
+ const message = event.message;
98
+ if (!isPlainObject(message))
99
+ return [];
100
+ const content = message.content;
101
+ if (Array.isArray(content))
102
+ return content.filter((it) => isPlainObject(it));
103
+ if (isPlainObject(content))
104
+ return [content];
105
+ return [];
106
+ }
107
+ function iterCursorTranscriptPaths(projectsDir, projectRoots) {
108
+ if (!isDir(projectsDir))
109
+ return [];
110
+ let searchDirs;
111
+ if (projectRoots.length > 0) {
112
+ searchDirs = [];
113
+ for (const root of projectRoots) {
114
+ const candidate = path.join(projectsDir, cursorProjectDirSlug(root));
115
+ if (isDir(candidate))
116
+ searchDirs.push(candidate);
117
+ }
118
+ }
119
+ else {
120
+ searchDirs = fs
121
+ .readdirSync(projectsDir, { withFileTypes: true })
122
+ .filter((e) => e.isDirectory())
123
+ .map((e) => path.join(projectsDir, e.name));
124
+ }
125
+ const paths = [];
126
+ for (const projectDir of searchDirs) {
127
+ const transcriptsDir = path.join(projectDir, "agent-transcripts");
128
+ if (!isDir(transcriptsDir))
129
+ continue;
130
+ paths.push(...rglob(transcriptsDir, "*.jsonl"));
131
+ }
132
+ return paths;
133
+ }
134
+ export function extractCursorSessions(projectsDir, errors, projectRoots = null) {
135
+ if (projectsDir === null || !fs.existsSync(projectsDir))
136
+ return [];
137
+ const roots = projectRoots || [];
138
+ const slugToRoot = new Map();
139
+ for (const root of roots)
140
+ slugToRoot.set(cursorProjectDirSlug(root), root);
141
+ const records = [];
142
+ for (const p of iterCursorTranscriptPaths(projectsDir, roots)) {
143
+ const fallbackTimestamp = isoFromMtime(p);
144
+ const sessionId = path.basename(path.dirname(p)) || pathStem(p);
145
+ const parents = pathParents(p);
146
+ const projectDir = parents.length > 2 ? parents[2] : null;
147
+ let projectPath = null;
148
+ if (projectDir) {
149
+ projectPath = slugToRoot.get(path.basename(projectDir)) || cursorProjectPathFromDir(projectDir);
150
+ }
151
+ let previousAssistant = "";
152
+ let index = 0;
153
+ for (const event of iterJsonl(p, errors)) {
154
+ index += 1;
155
+ const role = event.role;
156
+ if (role !== "user" && role !== "assistant")
157
+ continue;
158
+ let contentIndex = 0;
159
+ for (const item of cursorContentItems(event)) {
160
+ contentIndex += 1;
161
+ const tr = toolCallRecordFromItem({
162
+ item,
163
+ event,
164
+ fallbackTimestamp,
165
+ projectPath,
166
+ runtime: "cursor",
167
+ sourcePath: p,
168
+ index: index * 1000 + contentIndex,
169
+ sessionId,
170
+ });
171
+ if (tr !== null) {
172
+ if (isPlainObject(tr.data) && isPlainObject(tr.data.arguments)) {
173
+ tr.data.arguments = boundToolArguments(tr.data.arguments);
174
+ }
175
+ records.push(tr);
176
+ }
177
+ }
178
+ const items = cursorContentItems(event);
179
+ const content = textFromContent(items.length > 0 ? items : event.message);
180
+ if (!content)
181
+ continue;
182
+ const timestamp = eventTimestamp(event, fallbackTimestamp);
183
+ const data = { actor: role, content };
184
+ if (role === "user") {
185
+ if (previousAssistant)
186
+ data.preceding_context = previousAssistant.slice(-2000);
187
+ const sig = signalType(content);
188
+ if (sig)
189
+ data.signal_type = sig;
190
+ }
191
+ else {
192
+ previousAssistant = content;
193
+ }
194
+ records.push(record({
195
+ sourceKind: "conversation_turn",
196
+ timestamp,
197
+ projectPath,
198
+ runtime: "cursor",
199
+ sourceParts: [resolvePath(p), index, role, content.slice(0, 80)],
200
+ sessionId,
201
+ data,
202
+ }));
203
+ if (role === "user") {
204
+ const sig = signalType(content);
205
+ if (sig) {
206
+ records.push(record({
207
+ sourceKind: "history_prompt",
208
+ timestamp,
209
+ projectPath,
210
+ runtime: "cursor",
211
+ sourceParts: [resolvePath(p), index, "history", content.slice(0, 120)],
212
+ sessionId,
213
+ data: { prompt: content, signal_type: sig },
214
+ }));
215
+ }
216
+ }
217
+ }
218
+ }
219
+ return records;
220
+ }
221
+ function cursorJsonlSessionIds(projectsDir, projectRoots) {
222
+ if (projectsDir === null)
223
+ return new Set();
224
+ const ids = new Set();
225
+ for (const p of iterCursorTranscriptPaths(projectsDir, projectRoots)) {
226
+ ids.add(path.basename(path.dirname(p)) || pathStem(p));
227
+ }
228
+ return ids;
229
+ }
230
+ function cursorAgentMessageText(message) {
231
+ const content = message.content;
232
+ if (typeof content === "string")
233
+ return content.trim();
234
+ if (Array.isArray(content)) {
235
+ const parts = [];
236
+ for (const item of content) {
237
+ if (!isPlainObject(item))
238
+ continue;
239
+ if (item.type === "text") {
240
+ const text = item.text;
241
+ if (typeof text === "string" && text.trim())
242
+ parts.push(text.trim());
243
+ }
244
+ }
245
+ return parts.join("\n");
246
+ }
247
+ return textFromContent(content);
248
+ }
249
+ function cursorAgentToolItems(message) {
250
+ const items = [];
251
+ const content = message.content;
252
+ if (!Array.isArray(content))
253
+ return items;
254
+ for (const item of content) {
255
+ if (!isPlainObject(item))
256
+ continue;
257
+ if (item.type !== "tool-call")
258
+ continue;
259
+ const toolName = item.toolName || item.tool_name || item.name;
260
+ if (typeof toolName !== "string" || !toolName)
261
+ continue;
262
+ const args = item.args || item.arguments || item.input || {};
263
+ items.push({ type: "tool_use", name: toolName, input: isPlainObject(args) ? args : { value: args } });
264
+ }
265
+ return items;
266
+ }
267
+ function iterCursorAgentStorePaths(chatsDir, projectRoots, jsonlSessionIds) {
268
+ if (!isDir(chatsDir))
269
+ return [];
270
+ const workspaceDirs = [];
271
+ if (projectRoots.length > 0) {
272
+ for (const root of projectRoots) {
273
+ const workspace = path.join(chatsDir, cursorWorkspaceHash(root));
274
+ if (isDir(workspace))
275
+ workspaceDirs.push([workspace, resolvePath(root)]);
276
+ }
277
+ }
278
+ else {
279
+ for (const name of fs.readdirSync(chatsDir).sort()) {
280
+ const workspace = path.join(chatsDir, name);
281
+ if (isDir(workspace))
282
+ workspaceDirs.push([workspace, null]);
283
+ }
284
+ }
285
+ const items = [];
286
+ for (const [workspace, projectPath] of workspaceDirs) {
287
+ for (const name of fs.readdirSync(workspace).sort()) {
288
+ const sessionDir = path.join(workspace, name);
289
+ if (!isDir(sessionDir))
290
+ continue;
291
+ const sessionId = name;
292
+ if (jsonlSessionIds.has(sessionId))
293
+ continue;
294
+ const storeDb = path.join(sessionDir, "store.db");
295
+ if (isFilePath(storeDb))
296
+ items.push([storeDb, projectPath, sessionId]);
297
+ }
298
+ }
299
+ return items;
300
+ }
301
+ function cursorAgentBlobMessages(storeDb, errors) {
302
+ const messages = [];
303
+ let conn = null;
304
+ let rows;
305
+ try {
306
+ conn = openSqlite(storeDb);
307
+ }
308
+ catch (exc) {
309
+ errors.push(`${storeDb}: cursor-agent sqlite open failed: ${exc.name || "Error"}`);
310
+ return messages;
311
+ }
312
+ try {
313
+ rows = conn.prepare("SELECT id, data FROM blobs ORDER BY id").all();
314
+ }
315
+ catch (exc) {
316
+ errors.push(`${storeDb}: cursor-agent sqlite read failed: ${exc.name || "Error"}`);
317
+ conn.close();
318
+ return messages;
319
+ }
320
+ conn.close();
321
+ for (const row of rows) {
322
+ const blobId = row.id;
323
+ const payload = row.data;
324
+ let raw;
325
+ if (payload instanceof Uint8Array)
326
+ raw = Buffer.from(payload);
327
+ else if (typeof payload === "string")
328
+ raw = Buffer.from(payload, "utf-8");
329
+ else {
330
+ errors.push(`${storeDb}: cursor-agent blob payload not bytes: ${blobId}`);
331
+ continue;
332
+ }
333
+ let parsed;
334
+ try {
335
+ parsed = JSON.parse(raw.toString("utf-8"));
336
+ }
337
+ catch {
338
+ errors.push(`${storeDb}: cursor-agent blob not json: ${blobId}`);
339
+ continue;
340
+ }
341
+ if (isPlainObject(parsed))
342
+ messages.push([String(blobId), parsed]);
343
+ }
344
+ return messages;
345
+ }
346
+ export function extractCursorAgentSessions(chatsDir, errors, projectRoots = null, cursorProjectsDir = null) {
347
+ if (chatsDir === null || !fs.existsSync(chatsDir))
348
+ return [];
349
+ const roots = projectRoots || [];
350
+ const jsonlSessionIds = cursorJsonlSessionIds(cursorProjectsDir, roots);
351
+ const records = [];
352
+ for (const [storeDb, projectPath, sessionId] of iterCursorAgentStorePaths(chatsDir, roots, jsonlSessionIds)) {
353
+ const fallbackTimestamp = isoFromMtime(storeDb);
354
+ let previousAssistant = "";
355
+ let index = 0;
356
+ for (const [blobId, message] of cursorAgentBlobMessages(storeDb, errors)) {
357
+ index += 1;
358
+ const role = message.role;
359
+ let toolIndex = 0;
360
+ for (const toolItem of cursorAgentToolItems(message)) {
361
+ toolIndex += 1;
362
+ const tr = toolCallRecordFromItem({
363
+ item: toolItem,
364
+ event: message,
365
+ fallbackTimestamp,
366
+ projectPath,
367
+ runtime: "cursor",
368
+ sourceProduct: "cursor-agent",
369
+ sourcePath: storeDb,
370
+ index: index * 1000 + toolIndex,
371
+ sessionId,
372
+ });
373
+ if (tr !== null) {
374
+ if (isPlainObject(tr.data) && isPlainObject(tr.data.arguments)) {
375
+ tr.data.arguments = boundToolArguments(tr.data.arguments);
376
+ }
377
+ records.push(tr);
378
+ }
379
+ }
380
+ if (role !== "user" && role !== "assistant")
381
+ continue;
382
+ const content = cursorAgentMessageText(message);
383
+ if (!content)
384
+ continue;
385
+ const timestamp = eventTimestamp(message, fallbackTimestamp);
386
+ const data = { actor: role, content };
387
+ if (role === "user") {
388
+ if (previousAssistant)
389
+ data.preceding_context = previousAssistant.slice(-2000);
390
+ const sig = signalType(content);
391
+ if (sig)
392
+ data.signal_type = sig;
393
+ }
394
+ else {
395
+ previousAssistant = content;
396
+ }
397
+ records.push(record({
398
+ sourceKind: "conversation_turn",
399
+ timestamp,
400
+ projectPath,
401
+ runtime: "cursor",
402
+ sourceProduct: "cursor-agent",
403
+ sourceParts: [resolvePath(storeDb), blobId, role, content.slice(0, 80)],
404
+ sessionId,
405
+ data,
406
+ }));
407
+ if (role === "user") {
408
+ const sig = signalType(content);
409
+ if (sig) {
410
+ records.push(record({
411
+ sourceKind: "history_prompt",
412
+ timestamp,
413
+ projectPath,
414
+ runtime: "cursor",
415
+ sourceProduct: "cursor-agent",
416
+ sourceParts: [resolvePath(storeDb), blobId, "history", content.slice(0, 120)],
417
+ sessionId,
418
+ data: { prompt: content, signal_type: sig },
419
+ }));
420
+ }
421
+ }
422
+ }
423
+ }
424
+ return records;
425
+ }