@cleocode/core 2026.4.9 → 2026.4.11

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 (903) hide show
  1. package/dist/adapters/adapter-registry.js +64 -0
  2. package/dist/adapters/adapter-registry.js.map +1 -0
  3. package/dist/adapters/discovery.js +83 -0
  4. package/dist/adapters/discovery.js.map +1 -0
  5. package/dist/adapters/index.js +9 -0
  6. package/dist/adapters/index.js.map +1 -0
  7. package/dist/adapters/manager.js +260 -0
  8. package/dist/adapters/manager.js.map +1 -0
  9. package/dist/admin/export-tasks.js +171 -0
  10. package/dist/admin/export-tasks.js.map +1 -0
  11. package/dist/admin/export.js +103 -0
  12. package/dist/admin/export.js.map +1 -0
  13. package/dist/admin/help.js +106 -0
  14. package/dist/admin/help.js.map +1 -0
  15. package/dist/admin/import-tasks.js +182 -0
  16. package/dist/admin/import-tasks.js.map +1 -0
  17. package/dist/admin/import.js +129 -0
  18. package/dist/admin/import.js.map +1 -0
  19. package/dist/admin/index.js +13 -0
  20. package/dist/admin/index.js.map +1 -0
  21. package/dist/adrs/find.js +134 -0
  22. package/dist/adrs/find.js.map +1 -0
  23. package/dist/adrs/index.js +15 -0
  24. package/dist/adrs/index.js.map +1 -0
  25. package/dist/adrs/link-pipeline.js +160 -0
  26. package/dist/adrs/link-pipeline.js.map +1 -0
  27. package/dist/adrs/list.js +43 -0
  28. package/dist/adrs/list.js.map +1 -0
  29. package/dist/adrs/parse.js +51 -0
  30. package/dist/adrs/parse.js.map +1 -0
  31. package/dist/adrs/show.js +22 -0
  32. package/dist/adrs/show.js.map +1 -0
  33. package/dist/adrs/sync.js +188 -0
  34. package/dist/adrs/sync.js.map +1 -0
  35. package/dist/adrs/types.js +9 -0
  36. package/dist/adrs/types.js.map +1 -0
  37. package/dist/adrs/validate.js +57 -0
  38. package/dist/adrs/validate.js.map +1 -0
  39. package/dist/agents/agent-registry.js +288 -0
  40. package/dist/agents/agent-registry.js.map +1 -0
  41. package/dist/agents/agent-schema.d.ts +2 -2
  42. package/dist/agents/agent-schema.js +82 -0
  43. package/dist/agents/agent-schema.js.map +1 -0
  44. package/dist/agents/capacity.js +116 -0
  45. package/dist/agents/capacity.js.map +1 -0
  46. package/dist/agents/execution-learning.js +474 -0
  47. package/dist/agents/execution-learning.js.map +1 -0
  48. package/dist/agents/health-monitor.js +217 -0
  49. package/dist/agents/health-monitor.js.map +1 -0
  50. package/dist/agents/index.js +29 -0
  51. package/dist/agents/index.js.map +1 -0
  52. package/dist/agents/registry.js +314 -0
  53. package/dist/agents/registry.js.map +1 -0
  54. package/dist/agents/retry.js +215 -0
  55. package/dist/agents/retry.js.map +1 -0
  56. package/dist/audit-prune.js +94 -0
  57. package/dist/audit-prune.js.map +1 -0
  58. package/dist/audit.js +68 -0
  59. package/dist/audit.js.map +1 -0
  60. package/dist/backfill/index.js +229 -0
  61. package/dist/backfill/index.js.map +1 -0
  62. package/dist/bootstrap.js +344 -0
  63. package/dist/bootstrap.js.map +1 -0
  64. package/dist/caamp/adapter.js +259 -0
  65. package/dist/caamp/adapter.js.map +1 -0
  66. package/dist/caamp/capability-check.js +38 -0
  67. package/dist/caamp/capability-check.js.map +1 -0
  68. package/dist/caamp/index.js +21 -0
  69. package/dist/caamp/index.js.map +1 -0
  70. package/dist/caamp-init.js +16 -0
  71. package/dist/caamp-init.js.map +1 -0
  72. package/dist/cleo.js +322 -0
  73. package/dist/cleo.js.map +1 -0
  74. package/dist/code/index.js +10 -0
  75. package/dist/code/index.js.map +1 -0
  76. package/dist/code/outline.js +165 -0
  77. package/dist/code/outline.js.map +1 -0
  78. package/dist/code/parser.js +295 -0
  79. package/dist/code/parser.js.map +1 -0
  80. package/dist/code/search.js +135 -0
  81. package/dist/code/search.js.map +1 -0
  82. package/dist/code/unfold.js +155 -0
  83. package/dist/code/unfold.js.map +1 -0
  84. package/dist/codebase-map/analyzers/architecture.js +130 -0
  85. package/dist/codebase-map/analyzers/architecture.js.map +1 -0
  86. package/dist/codebase-map/analyzers/concerns.js +122 -0
  87. package/dist/codebase-map/analyzers/concerns.js.map +1 -0
  88. package/dist/codebase-map/analyzers/conventions.js +149 -0
  89. package/dist/codebase-map/analyzers/conventions.js.map +1 -0
  90. package/dist/codebase-map/analyzers/integrations.js +108 -0
  91. package/dist/codebase-map/analyzers/integrations.js.map +1 -0
  92. package/dist/codebase-map/analyzers/stack.js +117 -0
  93. package/dist/codebase-map/analyzers/stack.js.map +1 -0
  94. package/dist/codebase-map/analyzers/structure.js +137 -0
  95. package/dist/codebase-map/analyzers/structure.js.map +1 -0
  96. package/dist/codebase-map/analyzers/testing.js +118 -0
  97. package/dist/codebase-map/analyzers/testing.js.map +1 -0
  98. package/dist/codebase-map/index.js +57 -0
  99. package/dist/codebase-map/index.js.map +1 -0
  100. package/dist/codebase-map/store.js +122 -0
  101. package/dist/codebase-map/store.js.map +1 -0
  102. package/dist/codebase-map/summary.js +152 -0
  103. package/dist/codebase-map/summary.js.map +1 -0
  104. package/dist/compliance/index.js +288 -0
  105. package/dist/compliance/index.js.map +1 -0
  106. package/dist/compliance/protocol-enforcement.js +332 -0
  107. package/dist/compliance/protocol-enforcement.js.map +1 -0
  108. package/dist/compliance/protocol-rules.js +786 -0
  109. package/dist/compliance/protocol-rules.js.map +1 -0
  110. package/dist/compliance/protocol-types.js +79 -0
  111. package/dist/compliance/protocol-types.js.map +1 -0
  112. package/dist/compliance/store.js +53 -0
  113. package/dist/compliance/store.js.map +1 -0
  114. package/dist/conduit/conduit-client.js +107 -0
  115. package/dist/conduit/conduit-client.js.map +1 -0
  116. package/dist/conduit/factory.js +52 -0
  117. package/dist/conduit/factory.js.map +1 -0
  118. package/dist/conduit/http-transport.js +155 -0
  119. package/dist/conduit/http-transport.js.map +1 -0
  120. package/dist/conduit/index.js +15 -0
  121. package/dist/conduit/index.js.map +1 -0
  122. package/dist/conduit/local-transport.js +245 -0
  123. package/dist/conduit/local-transport.js.map +1 -0
  124. package/dist/conduit/sse-transport.js +299 -0
  125. package/dist/conduit/sse-transport.js.map +1 -0
  126. package/dist/config/build-config.js +29 -0
  127. package/dist/config/build-config.js.map +1 -0
  128. package/dist/config.js +401 -0
  129. package/dist/config.js.map +1 -0
  130. package/dist/constants.js +18 -0
  131. package/dist/constants.js.map +1 -0
  132. package/dist/context/index.js +137 -0
  133. package/dist/context/index.js.map +1 -0
  134. package/dist/crypto/credentials.js +191 -0
  135. package/dist/crypto/credentials.js.map +1 -0
  136. package/dist/discovery.js +182 -0
  137. package/dist/discovery.js.map +1 -0
  138. package/dist/engine-result.js +12 -0
  139. package/dist/engine-result.js.map +1 -0
  140. package/dist/error-catalog.js +404 -0
  141. package/dist/error-catalog.js.map +1 -0
  142. package/dist/error-registry.js +393 -0
  143. package/dist/error-registry.js.map +1 -0
  144. package/dist/errors.js +167 -0
  145. package/dist/errors.js.map +1 -0
  146. package/dist/hooks/handlers/agent-hooks.js +106 -0
  147. package/dist/hooks/handlers/agent-hooks.js.map +1 -0
  148. package/dist/hooks/handlers/context-hooks.js +111 -0
  149. package/dist/hooks/handlers/context-hooks.js.map +1 -0
  150. package/dist/hooks/handlers/error-hooks.js +52 -0
  151. package/dist/hooks/handlers/error-hooks.js.map +1 -0
  152. package/dist/hooks/handlers/file-hooks.js +104 -0
  153. package/dist/hooks/handlers/file-hooks.js.map +1 -0
  154. package/dist/hooks/handlers/handler-helpers.js +61 -0
  155. package/dist/hooks/handlers/handler-helpers.js.map +1 -0
  156. package/dist/hooks/handlers/index.js +28 -0
  157. package/dist/hooks/handlers/index.js.map +1 -0
  158. package/dist/hooks/handlers/memory-bridge-refresh.js +42 -0
  159. package/dist/hooks/handlers/memory-bridge-refresh.js.map +1 -0
  160. package/dist/hooks/handlers/notification-hooks.js +62 -0
  161. package/dist/hooks/handlers/notification-hooks.js.map +1 -0
  162. package/dist/hooks/handlers/session-hooks.d.ts +21 -0
  163. package/dist/hooks/handlers/session-hooks.d.ts.map +1 -1
  164. package/dist/hooks/handlers/session-hooks.js +142 -0
  165. package/dist/hooks/handlers/session-hooks.js.map +1 -0
  166. package/dist/hooks/handlers/task-hooks.js +65 -0
  167. package/dist/hooks/handlers/task-hooks.js.map +1 -0
  168. package/dist/hooks/handlers/work-capture-hooks.js +165 -0
  169. package/dist/hooks/handlers/work-capture-hooks.js.map +1 -0
  170. package/dist/hooks/index.js +13 -0
  171. package/dist/hooks/index.js.map +1 -0
  172. package/dist/hooks/payload-schemas.d.ts +2 -2
  173. package/dist/hooks/payload-schemas.js +220 -0
  174. package/dist/hooks/payload-schemas.js.map +1 -0
  175. package/dist/hooks/provider-hooks.js +66 -0
  176. package/dist/hooks/provider-hooks.js.map +1 -0
  177. package/dist/hooks/registry.js +229 -0
  178. package/dist/hooks/registry.js.map +1 -0
  179. package/dist/hooks/types.js +66 -0
  180. package/dist/hooks/types.js.map +1 -0
  181. package/dist/hooks.js +136 -0
  182. package/dist/hooks.js.map +1 -0
  183. package/dist/index.js +3361 -3095
  184. package/dist/index.js.map +4 -4
  185. package/dist/init.js +852 -0
  186. package/dist/init.js.map +1 -0
  187. package/dist/inject/index.js +82 -0
  188. package/dist/inject/index.js.map +1 -0
  189. package/dist/injection.js +343 -0
  190. package/dist/injection.js.map +1 -0
  191. package/dist/intelligence/adaptive-validation.js +497 -0
  192. package/dist/intelligence/adaptive-validation.js.map +1 -0
  193. package/dist/intelligence/impact.js +675 -0
  194. package/dist/intelligence/impact.js.map +1 -0
  195. package/dist/intelligence/index.js +22 -0
  196. package/dist/intelligence/index.js.map +1 -0
  197. package/dist/intelligence/patterns.js +492 -0
  198. package/dist/intelligence/patterns.js.map +1 -0
  199. package/dist/intelligence/prediction.js +499 -0
  200. package/dist/intelligence/prediction.js.map +1 -0
  201. package/dist/intelligence/types.js +13 -0
  202. package/dist/intelligence/types.js.map +1 -0
  203. package/dist/internal.d.ts +7 -2
  204. package/dist/internal.d.ts.map +1 -1
  205. package/dist/internal.js +299 -0
  206. package/dist/internal.js.map +1 -0
  207. package/dist/issue/create.js +121 -0
  208. package/dist/issue/create.js.map +1 -0
  209. package/dist/issue/diagnostics.js +59 -0
  210. package/dist/issue/diagnostics.js.map +1 -0
  211. package/dist/issue/index.js +10 -0
  212. package/dist/issue/index.js.map +1 -0
  213. package/dist/issue/template-parser.js +267 -0
  214. package/dist/issue/template-parser.js.map +1 -0
  215. package/dist/json-schema-validator.js +76 -0
  216. package/dist/json-schema-validator.js.map +1 -0
  217. package/dist/lib/index.js +11 -0
  218. package/dist/lib/index.js.map +1 -0
  219. package/dist/lib/retry.js +152 -0
  220. package/dist/lib/retry.js.map +1 -0
  221. package/dist/lib/tree-sitter-languages.js +71 -0
  222. package/dist/lib/tree-sitter-languages.js.map +1 -0
  223. package/dist/lifecycle/chain-composition.js +152 -0
  224. package/dist/lifecycle/chain-composition.js.map +1 -0
  225. package/dist/lifecycle/chain-store.js +246 -0
  226. package/dist/lifecycle/chain-store.js.map +1 -0
  227. package/dist/lifecycle/consolidate-rcasd.js +352 -0
  228. package/dist/lifecycle/consolidate-rcasd.js.map +1 -0
  229. package/dist/lifecycle/default-chain.js +176 -0
  230. package/dist/lifecycle/default-chain.js.map +1 -0
  231. package/dist/lifecycle/evidence.js +180 -0
  232. package/dist/lifecycle/evidence.js.map +1 -0
  233. package/dist/lifecycle/frontmatter.js +363 -0
  234. package/dist/lifecycle/frontmatter.js.map +1 -0
  235. package/dist/lifecycle/index.js +756 -0
  236. package/dist/lifecycle/index.js.map +1 -0
  237. package/dist/lifecycle/pipeline.js +656 -0
  238. package/dist/lifecycle/pipeline.js.map +1 -0
  239. package/dist/lifecycle/rcasd-index.js +326 -0
  240. package/dist/lifecycle/rcasd-index.js.map +1 -0
  241. package/dist/lifecycle/rcasd-paths.js +220 -0
  242. package/dist/lifecycle/rcasd-paths.js.map +1 -0
  243. package/dist/lifecycle/resume.js +864 -0
  244. package/dist/lifecycle/resume.js.map +1 -0
  245. package/dist/lifecycle/stage-artifacts.js +94 -0
  246. package/dist/lifecycle/stage-artifacts.js.map +1 -0
  247. package/dist/lifecycle/stage-guidance.js +234 -0
  248. package/dist/lifecycle/stage-guidance.js.map +1 -0
  249. package/dist/lifecycle/stages.js +534 -0
  250. package/dist/lifecycle/stages.js.map +1 -0
  251. package/dist/lifecycle/state-machine.js +516 -0
  252. package/dist/lifecycle/state-machine.js.map +1 -0
  253. package/dist/lifecycle/tessera-engine.js +249 -0
  254. package/dist/lifecycle/tessera-engine.js.map +1 -0
  255. package/dist/logger.js +140 -0
  256. package/dist/logger.js.map +1 -0
  257. package/dist/memory/auto-extract.js +177 -0
  258. package/dist/memory/auto-extract.js.map +1 -0
  259. package/dist/memory/brain-embedding.js +66 -0
  260. package/dist/memory/brain-embedding.js.map +1 -0
  261. package/dist/memory/brain-lifecycle.js +298 -0
  262. package/dist/memory/brain-lifecycle.js.map +1 -0
  263. package/dist/memory/brain-links.js +161 -0
  264. package/dist/memory/brain-links.js.map +1 -0
  265. package/dist/memory/brain-maintenance.js +114 -0
  266. package/dist/memory/brain-maintenance.js.map +1 -0
  267. package/dist/memory/brain-migration.js +149 -0
  268. package/dist/memory/brain-migration.js.map +1 -0
  269. package/dist/memory/brain-reasoning.js +215 -0
  270. package/dist/memory/brain-reasoning.js.map +1 -0
  271. package/dist/memory/brain-retrieval.js +542 -0
  272. package/dist/memory/brain-retrieval.js.map +1 -0
  273. package/dist/memory/brain-row-types.js +10 -0
  274. package/dist/memory/brain-row-types.js.map +1 -0
  275. package/dist/memory/brain-search.js +519 -0
  276. package/dist/memory/brain-search.js.map +1 -0
  277. package/dist/memory/brain-similarity.js +145 -0
  278. package/dist/memory/brain-similarity.js.map +1 -0
  279. package/dist/memory/claude-mem-migration.js +277 -0
  280. package/dist/memory/claude-mem-migration.js.map +1 -0
  281. package/dist/memory/decisions.js +162 -0
  282. package/dist/memory/decisions.js.map +1 -0
  283. package/dist/memory/embedding-local.js +97 -0
  284. package/dist/memory/embedding-local.js.map +1 -0
  285. package/dist/memory/embedding-queue.js +271 -0
  286. package/dist/memory/embedding-queue.js.map +1 -0
  287. package/dist/memory/embedding-worker.js +58 -0
  288. package/dist/memory/embedding-worker.js.map +1 -0
  289. package/dist/memory/engine-compat.js +1397 -0
  290. package/dist/memory/engine-compat.js.map +1 -0
  291. package/dist/memory/index.js +1140 -0
  292. package/dist/memory/index.js.map +1 -0
  293. package/dist/memory/learnings.d.ts +4 -4
  294. package/dist/memory/learnings.js +121 -0
  295. package/dist/memory/learnings.js.map +1 -0
  296. package/dist/memory/memory-bridge.js +370 -0
  297. package/dist/memory/memory-bridge.js.map +1 -0
  298. package/dist/memory/patterns.d.ts +6 -6
  299. package/dist/memory/patterns.js +122 -0
  300. package/dist/memory/patterns.js.map +1 -0
  301. package/dist/memory/pipeline-manifest-sqlite.js +975 -0
  302. package/dist/memory/pipeline-manifest-sqlite.js.map +1 -0
  303. package/dist/memory/session-memory.js +331 -0
  304. package/dist/memory/session-memory.js.map +1 -0
  305. package/dist/metrics/ab-test.js +260 -0
  306. package/dist/metrics/ab-test.js.map +1 -0
  307. package/dist/metrics/aggregation.js +363 -0
  308. package/dist/metrics/aggregation.js.map +1 -0
  309. package/dist/metrics/common.js +64 -0
  310. package/dist/metrics/common.js.map +1 -0
  311. package/dist/metrics/enums.js +78 -0
  312. package/dist/metrics/enums.js.map +1 -0
  313. package/dist/metrics/index.js +19 -0
  314. package/dist/metrics/index.js.map +1 -0
  315. package/dist/metrics/model-provider-registry.js +88 -0
  316. package/dist/metrics/model-provider-registry.js.map +1 -0
  317. package/dist/metrics/otel-integration.js +263 -0
  318. package/dist/metrics/otel-integration.js.map +1 -0
  319. package/dist/metrics/provider-detection.js +103 -0
  320. package/dist/metrics/provider-detection.js.map +1 -0
  321. package/dist/metrics/token-estimation.js +253 -0
  322. package/dist/metrics/token-estimation.js.map +1 -0
  323. package/dist/metrics/token-service.js +450 -0
  324. package/dist/metrics/token-service.js.map +1 -0
  325. package/dist/migration/agent-outputs.js +316 -0
  326. package/dist/migration/agent-outputs.js.map +1 -0
  327. package/dist/migration/checksum.js +92 -0
  328. package/dist/migration/checksum.js.map +1 -0
  329. package/dist/migration/index.js +282 -0
  330. package/dist/migration/index.js.map +1 -0
  331. package/dist/migration/logger.js +360 -0
  332. package/dist/migration/logger.js.map +1 -0
  333. package/dist/migration/preflight.js +9 -0
  334. package/dist/migration/preflight.js.map +1 -0
  335. package/dist/migration/state.js +421 -0
  336. package/dist/migration/state.js.map +1 -0
  337. package/dist/migration/validate.js +241 -0
  338. package/dist/migration/validate.js.map +1 -0
  339. package/dist/mvi-helpers.js +74 -0
  340. package/dist/mvi-helpers.js.map +1 -0
  341. package/dist/nexus/deps.js +375 -0
  342. package/dist/nexus/deps.js.map +1 -0
  343. package/dist/nexus/discover.js +288 -0
  344. package/dist/nexus/discover.js.map +1 -0
  345. package/dist/nexus/hash.js +10 -0
  346. package/dist/nexus/hash.js.map +1 -0
  347. package/dist/nexus/index.js +40 -0
  348. package/dist/nexus/index.js.map +1 -0
  349. package/dist/nexus/migrate-json-to-sqlite.js +115 -0
  350. package/dist/nexus/migrate-json-to-sqlite.js.map +1 -0
  351. package/dist/nexus/permissions.js +105 -0
  352. package/dist/nexus/permissions.js.map +1 -0
  353. package/dist/nexus/query.js +175 -0
  354. package/dist/nexus/query.js.map +1 -0
  355. package/dist/nexus/registry.js +584 -0
  356. package/dist/nexus/registry.js.map +1 -0
  357. package/dist/nexus/sharing/index.js +288 -0
  358. package/dist/nexus/sharing/index.js.map +1 -0
  359. package/dist/nexus/transfer-types.js +8 -0
  360. package/dist/nexus/transfer-types.js.map +1 -0
  361. package/dist/nexus/transfer.js +263 -0
  362. package/dist/nexus/transfer.js.map +1 -0
  363. package/dist/nexus/workspace.js +355 -0
  364. package/dist/nexus/workspace.js.map +1 -0
  365. package/dist/observability/index.js +103 -0
  366. package/dist/observability/index.js.map +1 -0
  367. package/dist/observability/log-filter.js +63 -0
  368. package/dist/observability/log-filter.js.map +1 -0
  369. package/dist/observability/log-parser.js +99 -0
  370. package/dist/observability/log-parser.js.map +1 -0
  371. package/dist/observability/log-reader.js +139 -0
  372. package/dist/observability/log-reader.js.map +1 -0
  373. package/dist/observability/types.js +19 -0
  374. package/dist/observability/types.js.map +1 -0
  375. package/dist/orchestration/analyze.js +107 -0
  376. package/dist/orchestration/analyze.js.map +1 -0
  377. package/dist/orchestration/bootstrap.js +132 -0
  378. package/dist/orchestration/bootstrap.js.map +1 -0
  379. package/dist/orchestration/context.js +56 -0
  380. package/dist/orchestration/context.js.map +1 -0
  381. package/dist/orchestration/critical-path.js +100 -0
  382. package/dist/orchestration/critical-path.js.map +1 -0
  383. package/dist/orchestration/hierarchy.js +183 -0
  384. package/dist/orchestration/hierarchy.js.map +1 -0
  385. package/dist/orchestration/index.js +287 -0
  386. package/dist/orchestration/index.js.map +1 -0
  387. package/dist/orchestration/parallel.js +89 -0
  388. package/dist/orchestration/parallel.js.map +1 -0
  389. package/dist/orchestration/protocol-validators.js +815 -0
  390. package/dist/orchestration/protocol-validators.js.map +1 -0
  391. package/dist/orchestration/skill-ops.js +98 -0
  392. package/dist/orchestration/skill-ops.js.map +1 -0
  393. package/dist/orchestration/status.js +107 -0
  394. package/dist/orchestration/status.js.map +1 -0
  395. package/dist/orchestration/unblock.js +103 -0
  396. package/dist/orchestration/unblock.js.map +1 -0
  397. package/dist/orchestration/validate-spawn.js +67 -0
  398. package/dist/orchestration/validate-spawn.js.map +1 -0
  399. package/dist/orchestration/waves.js +86 -0
  400. package/dist/orchestration/waves.js.map +1 -0
  401. package/dist/otel/index.js +163 -0
  402. package/dist/otel/index.js.map +1 -0
  403. package/dist/output.js +164 -0
  404. package/dist/output.js.map +1 -0
  405. package/dist/pagination.js +64 -0
  406. package/dist/pagination.js.map +1 -0
  407. package/dist/paths.d.ts +39 -9
  408. package/dist/paths.d.ts.map +1 -1
  409. package/dist/paths.js +776 -0
  410. package/dist/paths.js.map +1 -0
  411. package/dist/phases/deps.js +372 -0
  412. package/dist/phases/deps.js.map +1 -0
  413. package/dist/phases/index.js +349 -0
  414. package/dist/phases/index.js.map +1 -0
  415. package/dist/pipeline/index.js +10 -0
  416. package/dist/pipeline/index.js.map +1 -0
  417. package/dist/pipeline/phase.js +45 -0
  418. package/dist/pipeline/phase.js.map +1 -0
  419. package/dist/platform.js +211 -0
  420. package/dist/platform.js.map +1 -0
  421. package/dist/project-info.js +84 -0
  422. package/dist/project-info.js.map +1 -0
  423. package/dist/reconciliation/index.js +10 -0
  424. package/dist/reconciliation/index.js.map +1 -0
  425. package/dist/reconciliation/link-store.js +129 -0
  426. package/dist/reconciliation/link-store.js.map +1 -0
  427. package/dist/reconciliation/reconciliation-engine.js +298 -0
  428. package/dist/reconciliation/reconciliation-engine.js.map +1 -0
  429. package/dist/release/artifacts.js +427 -0
  430. package/dist/release/artifacts.js.map +1 -0
  431. package/dist/release/changelog-writer.js +151 -0
  432. package/dist/release/changelog-writer.js.map +1 -0
  433. package/dist/release/channel.js +144 -0
  434. package/dist/release/channel.js.map +1 -0
  435. package/dist/release/ci.js +166 -0
  436. package/dist/release/ci.js.map +1 -0
  437. package/dist/release/github-pr.js +225 -0
  438. package/dist/release/github-pr.js.map +1 -0
  439. package/dist/release/guards.js +116 -0
  440. package/dist/release/guards.js.map +1 -0
  441. package/dist/release/index.js +22 -0
  442. package/dist/release/index.js.map +1 -0
  443. package/dist/release/release-config.js +158 -0
  444. package/dist/release/release-config.js.map +1 -0
  445. package/dist/release/release-manifest.js +1019 -0
  446. package/dist/release/release-manifest.js.map +1 -0
  447. package/dist/release/version-bump.js +255 -0
  448. package/dist/release/version-bump.js.map +1 -0
  449. package/dist/remote/index.js +257 -0
  450. package/dist/remote/index.js.map +1 -0
  451. package/dist/repair.js +130 -0
  452. package/dist/repair.js.map +1 -0
  453. package/dist/research/index.js +2 -0
  454. package/dist/research/index.js.map +1 -0
  455. package/dist/roadmap/index.js +59 -0
  456. package/dist/roadmap/index.js.map +1 -0
  457. package/dist/routing/capability-matrix.js +1556 -0
  458. package/dist/routing/capability-matrix.js.map +1 -0
  459. package/dist/routing/index.js +9 -0
  460. package/dist/routing/index.js.map +1 -0
  461. package/dist/scaffold.d.ts +15 -2
  462. package/dist/scaffold.d.ts.map +1 -1
  463. package/dist/scaffold.js +1759 -0
  464. package/dist/scaffold.js.map +1 -0
  465. package/dist/schema-management.js +295 -0
  466. package/dist/schema-management.js.map +1 -0
  467. package/dist/security/index.js +9 -0
  468. package/dist/security/index.js.map +1 -0
  469. package/dist/security/input-sanitization.js +321 -0
  470. package/dist/security/input-sanitization.js.map +1 -0
  471. package/dist/sequence/index.js +295 -0
  472. package/dist/sequence/index.js.map +1 -0
  473. package/dist/sessions/assumptions.js +54 -0
  474. package/dist/sessions/assumptions.js.map +1 -0
  475. package/dist/sessions/briefing.js +377 -0
  476. package/dist/sessions/briefing.js.map +1 -0
  477. package/dist/sessions/context-alert.js +222 -0
  478. package/dist/sessions/context-alert.js.map +1 -0
  479. package/dist/sessions/context-inject.js +61 -0
  480. package/dist/sessions/context-inject.js.map +1 -0
  481. package/dist/sessions/context-monitor.js +98 -0
  482. package/dist/sessions/context-monitor.js.map +1 -0
  483. package/dist/sessions/decisions.js +65 -0
  484. package/dist/sessions/decisions.js.map +1 -0
  485. package/dist/sessions/find.js +65 -0
  486. package/dist/sessions/find.js.map +1 -0
  487. package/dist/sessions/handoff.js +328 -0
  488. package/dist/sessions/handoff.js.map +1 -0
  489. package/dist/sessions/hitl-warnings.js +254 -0
  490. package/dist/sessions/hitl-warnings.js.map +1 -0
  491. package/dist/sessions/index.js +327 -0
  492. package/dist/sessions/index.js.map +1 -0
  493. package/dist/sessions/session-archive.js +40 -0
  494. package/dist/sessions/session-archive.js.map +1 -0
  495. package/dist/sessions/session-cleanup.js +59 -0
  496. package/dist/sessions/session-cleanup.js.map +1 -0
  497. package/dist/sessions/session-drift.js +134 -0
  498. package/dist/sessions/session-drift.js.map +1 -0
  499. package/dist/sessions/session-enforcement.js +144 -0
  500. package/dist/sessions/session-enforcement.js.map +1 -0
  501. package/dist/sessions/session-grade.js +253 -0
  502. package/dist/sessions/session-grade.js.map +1 -0
  503. package/dist/sessions/session-history.js +42 -0
  504. package/dist/sessions/session-history.js.map +1 -0
  505. package/dist/sessions/session-id.js +81 -0
  506. package/dist/sessions/session-id.js.map +1 -0
  507. package/dist/sessions/session-memory-bridge.js +52 -0
  508. package/dist/sessions/session-memory-bridge.js.map +1 -0
  509. package/dist/sessions/session-show.js +24 -0
  510. package/dist/sessions/session-show.js.map +1 -0
  511. package/dist/sessions/session-stats.js +69 -0
  512. package/dist/sessions/session-stats.js.map +1 -0
  513. package/dist/sessions/session-suspend.js +39 -0
  514. package/dist/sessions/session-suspend.js.map +1 -0
  515. package/dist/sessions/session-switch.js +51 -0
  516. package/dist/sessions/session-switch.js.map +1 -0
  517. package/dist/sessions/session-view.js +76 -0
  518. package/dist/sessions/session-view.js.map +1 -0
  519. package/dist/sessions/snapshot.js +213 -0
  520. package/dist/sessions/snapshot.js.map +1 -0
  521. package/dist/sessions/statusline-setup.js +85 -0
  522. package/dist/sessions/statusline-setup.js.map +1 -0
  523. package/dist/sessions/types.js +8 -0
  524. package/dist/sessions/types.js.map +1 -0
  525. package/dist/skills/agents/config.js +94 -0
  526. package/dist/skills/agents/config.js.map +1 -0
  527. package/dist/skills/agents/install.js +116 -0
  528. package/dist/skills/agents/install.js.map +1 -0
  529. package/dist/skills/agents/registry.js +161 -0
  530. package/dist/skills/agents/registry.js.map +1 -0
  531. package/dist/skills/discovery.js +333 -0
  532. package/dist/skills/discovery.js.map +1 -0
  533. package/dist/skills/dispatch.js +347 -0
  534. package/dist/skills/dispatch.js.map +1 -0
  535. package/dist/skills/dynamic-skill-generator.js +87 -0
  536. package/dist/skills/dynamic-skill-generator.js.map +1 -0
  537. package/dist/skills/index.js +44 -0
  538. package/dist/skills/index.js.map +1 -0
  539. package/dist/skills/injection/subagent.js +195 -0
  540. package/dist/skills/injection/subagent.js.map +1 -0
  541. package/dist/skills/injection/token.js +260 -0
  542. package/dist/skills/injection/token.js.map +1 -0
  543. package/dist/skills/install.js +40 -0
  544. package/dist/skills/install.js.map +1 -0
  545. package/dist/skills/manifests/contribution.js +175 -0
  546. package/dist/skills/manifests/contribution.js.map +1 -0
  547. package/dist/skills/manifests/research.js +281 -0
  548. package/dist/skills/manifests/research.js.map +1 -0
  549. package/dist/skills/manifests/resolver.js +146 -0
  550. package/dist/skills/manifests/resolver.js.map +1 -0
  551. package/dist/skills/marketplace.js +90 -0
  552. package/dist/skills/marketplace.js.map +1 -0
  553. package/dist/skills/orchestrator/spawn.js +178 -0
  554. package/dist/skills/orchestrator/spawn.js.map +1 -0
  555. package/dist/skills/orchestrator/startup.js +451 -0
  556. package/dist/skills/orchestrator/startup.js.map +1 -0
  557. package/dist/skills/orchestrator/validator.js +301 -0
  558. package/dist/skills/orchestrator/validator.js.map +1 -0
  559. package/dist/skills/precedence-integration.js +73 -0
  560. package/dist/skills/precedence-integration.js.map +1 -0
  561. package/dist/skills/precedence-types.js +16 -0
  562. package/dist/skills/precedence-types.js.map +1 -0
  563. package/dist/skills/routing-table.js +63 -0
  564. package/dist/skills/routing-table.js.map +1 -0
  565. package/dist/skills/skill-paths.js +217 -0
  566. package/dist/skills/skill-paths.js.map +1 -0
  567. package/dist/skills/test-utility.js +55 -0
  568. package/dist/skills/test-utility.js.map +1 -0
  569. package/dist/skills/types.js +118 -0
  570. package/dist/skills/types.js.map +1 -0
  571. package/dist/skills/validation.js +183 -0
  572. package/dist/skills/validation.js.map +1 -0
  573. package/dist/skills/version.js +57 -0
  574. package/dist/skills/version.js.map +1 -0
  575. package/dist/snapshot/index.js +188 -0
  576. package/dist/snapshot/index.js.map +1 -0
  577. package/dist/spawn/adapter-registry.js +246 -0
  578. package/dist/spawn/adapter-registry.js.map +1 -0
  579. package/dist/spawn/index.js +10 -0
  580. package/dist/spawn/index.js.map +1 -0
  581. package/dist/stats/index.js +343 -0
  582. package/dist/stats/index.js.map +1 -0
  583. package/dist/stats/workflow-telemetry.js +400 -0
  584. package/dist/stats/workflow-telemetry.js.map +1 -0
  585. package/dist/sticky/archive.js +47 -0
  586. package/dist/sticky/archive.js.map +1 -0
  587. package/dist/sticky/convert.js +235 -0
  588. package/dist/sticky/convert.js.map +1 -0
  589. package/dist/sticky/create.js +48 -0
  590. package/dist/sticky/create.js.map +1 -0
  591. package/dist/sticky/id.js +35 -0
  592. package/dist/sticky/id.js.map +1 -0
  593. package/dist/sticky/index.js +16 -0
  594. package/dist/sticky/index.js.map +1 -0
  595. package/dist/sticky/list.js +44 -0
  596. package/dist/sticky/list.js.map +1 -0
  597. package/dist/sticky/purge.js +45 -0
  598. package/dist/sticky/purge.js.map +1 -0
  599. package/dist/sticky/show.js +42 -0
  600. package/dist/sticky/show.js.map +1 -0
  601. package/dist/sticky/types.js +10 -0
  602. package/dist/sticky/types.js.map +1 -0
  603. package/dist/store/agent-registry-accessor.js +265 -0
  604. package/dist/store/agent-registry-accessor.js.map +1 -0
  605. package/dist/store/atomic.js +167 -0
  606. package/dist/store/atomic.js.map +1 -0
  607. package/dist/store/backup.js +94 -0
  608. package/dist/store/backup.js.map +1 -0
  609. package/dist/store/brain-accessor.js +397 -0
  610. package/dist/store/brain-accessor.js.map +1 -0
  611. package/dist/store/brain-schema.d.ts +8 -8
  612. package/dist/store/brain-schema.js +215 -0
  613. package/dist/store/brain-schema.js.map +1 -0
  614. package/dist/store/brain-sqlite.js +222 -0
  615. package/dist/store/brain-sqlite.js.map +1 -0
  616. package/dist/store/cache.js +168 -0
  617. package/dist/store/cache.js.map +1 -0
  618. package/dist/store/chain-schema.js +51 -0
  619. package/dist/store/chain-schema.js.map +1 -0
  620. package/dist/store/cleanup-legacy.d.ts +128 -0
  621. package/dist/store/cleanup-legacy.d.ts.map +1 -0
  622. package/dist/store/converters.js +124 -0
  623. package/dist/store/converters.js.map +1 -0
  624. package/dist/store/cross-db-cleanup.js +319 -0
  625. package/dist/store/cross-db-cleanup.js.map +1 -0
  626. package/dist/store/data-accessor.js +26 -0
  627. package/dist/store/data-accessor.js.map +1 -0
  628. package/dist/store/data-safety-central.js +269 -0
  629. package/dist/store/data-safety-central.js.map +1 -0
  630. package/dist/store/data-safety.js +274 -0
  631. package/dist/store/data-safety.js.map +1 -0
  632. package/dist/store/db-helpers.js +224 -0
  633. package/dist/store/db-helpers.js.map +1 -0
  634. package/dist/store/export.js +155 -0
  635. package/dist/store/export.js.map +1 -0
  636. package/dist/store/file-utils.js +270 -0
  637. package/dist/store/file-utils.js.map +1 -0
  638. package/dist/store/git-checkpoint.js +365 -0
  639. package/dist/store/git-checkpoint.js.map +1 -0
  640. package/dist/store/import-logging.js +139 -0
  641. package/dist/store/import-logging.js.map +1 -0
  642. package/dist/store/import-remap.js +145 -0
  643. package/dist/store/import-remap.js.map +1 -0
  644. package/dist/store/import-sort.js +121 -0
  645. package/dist/store/import-sort.js.map +1 -0
  646. package/dist/store/index.d.ts +1 -0
  647. package/dist/store/index.d.ts.map +1 -1
  648. package/dist/store/index.js +29 -0
  649. package/dist/store/index.js.map +1 -0
  650. package/dist/store/json.js +208 -0
  651. package/dist/store/json.js.map +1 -0
  652. package/dist/store/lifecycle-store.js +249 -0
  653. package/dist/store/lifecycle-store.js.map +1 -0
  654. package/dist/store/lock.js +70 -0
  655. package/dist/store/lock.js.map +1 -0
  656. package/dist/store/migration-manager.js +151 -0
  657. package/dist/store/migration-manager.js.map +1 -0
  658. package/dist/store/migration-sqlite.js +676 -0
  659. package/dist/store/migration-sqlite.js.map +1 -0
  660. package/dist/store/nexus-schema.js +62 -0
  661. package/dist/store/nexus-schema.js.map +1 -0
  662. package/dist/store/nexus-sqlite.d.ts +14 -2
  663. package/dist/store/nexus-sqlite.d.ts.map +1 -1
  664. package/dist/store/nexus-sqlite.js +217 -0
  665. package/dist/store/nexus-sqlite.js.map +1 -0
  666. package/dist/store/nexus-validation-schemas.js +40 -0
  667. package/dist/store/nexus-validation-schemas.js.map +1 -0
  668. package/dist/store/parsers.js +37 -0
  669. package/dist/store/parsers.js.map +1 -0
  670. package/dist/store/project-detect.js +457 -0
  671. package/dist/store/project-detect.js.map +1 -0
  672. package/dist/store/provider.js +101 -0
  673. package/dist/store/provider.js.map +1 -0
  674. package/dist/store/safety-data-accessor.js +257 -0
  675. package/dist/store/safety-data-accessor.js.map +1 -0
  676. package/dist/store/schema.js +7 -0
  677. package/dist/store/schema.js.map +1 -0
  678. package/dist/store/session-store.js +219 -0
  679. package/dist/store/session-store.js.map +1 -0
  680. package/dist/store/signaldock-sqlite.js +400 -0
  681. package/dist/store/signaldock-sqlite.js.map +1 -0
  682. package/dist/store/sqlite-backup.d.ts +121 -10
  683. package/dist/store/sqlite-backup.d.ts.map +1 -1
  684. package/dist/store/sqlite-backup.js +241 -0
  685. package/dist/store/sqlite-backup.js.map +1 -0
  686. package/dist/store/sqlite-data-accessor.js +787 -0
  687. package/dist/store/sqlite-data-accessor.js.map +1 -0
  688. package/dist/store/sqlite.d.ts.map +1 -1
  689. package/dist/store/sqlite.js +481 -0
  690. package/dist/store/sqlite.js.map +1 -0
  691. package/dist/store/status-registry.js +8 -0
  692. package/dist/store/status-registry.js.map +1 -0
  693. package/dist/store/task-store.js +358 -0
  694. package/dist/store/task-store.js.map +1 -0
  695. package/dist/store/tasks-schema.d.ts +8 -8
  696. package/dist/store/tasks-schema.js +610 -0
  697. package/dist/store/tasks-schema.js.map +1 -0
  698. package/dist/store/typed-query.js +15 -0
  699. package/dist/store/typed-query.js.map +1 -0
  700. package/dist/store/validation-schemas.d.ts +37 -37
  701. package/dist/store/validation-schemas.js +278 -0
  702. package/dist/store/validation-schemas.js.map +1 -0
  703. package/dist/system/archive-analytics.js +277 -0
  704. package/dist/system/archive-analytics.js.map +1 -0
  705. package/dist/system/archive-stats.js +64 -0
  706. package/dist/system/archive-stats.js.map +1 -0
  707. package/dist/system/audit.js +145 -0
  708. package/dist/system/audit.js.map +1 -0
  709. package/dist/system/backup.d.ts +91 -3
  710. package/dist/system/backup.d.ts.map +1 -1
  711. package/dist/system/backup.js +280 -0
  712. package/dist/system/backup.js.map +1 -0
  713. package/dist/system/cleanup.js +134 -0
  714. package/dist/system/cleanup.js.map +1 -0
  715. package/dist/system/health.js +1100 -0
  716. package/dist/system/health.js.map +1 -0
  717. package/dist/system/index.js +18 -0
  718. package/dist/system/index.js.map +1 -0
  719. package/dist/system/inject-generate.js +122 -0
  720. package/dist/system/inject-generate.js.map +1 -0
  721. package/dist/system/labels.js +38 -0
  722. package/dist/system/labels.js.map +1 -0
  723. package/dist/system/metrics.js +61 -0
  724. package/dist/system/metrics.js.map +1 -0
  725. package/dist/system/migrate.js +43 -0
  726. package/dist/system/migrate.js.map +1 -0
  727. package/dist/system/platform-paths.js +80 -0
  728. package/dist/system/platform-paths.js.map +1 -0
  729. package/dist/system/runtime.js +161 -0
  730. package/dist/system/runtime.js.map +1 -0
  731. package/dist/system/safestop.js +99 -0
  732. package/dist/system/safestop.js.map +1 -0
  733. package/dist/system/storage-preflight.js +123 -0
  734. package/dist/system/storage-preflight.js.map +1 -0
  735. package/dist/task-work/index.js +159 -0
  736. package/dist/task-work/index.js.map +1 -0
  737. package/dist/tasks/add.js +661 -0
  738. package/dist/tasks/add.js.map +1 -0
  739. package/dist/tasks/analyze.js +85 -0
  740. package/dist/tasks/analyze.js.map +1 -0
  741. package/dist/tasks/archive.js +90 -0
  742. package/dist/tasks/archive.js.map +1 -0
  743. package/dist/tasks/atomicity.js +83 -0
  744. package/dist/tasks/atomicity.js.map +1 -0
  745. package/dist/tasks/cancel-ops.js +83 -0
  746. package/dist/tasks/cancel-ops.js.map +1 -0
  747. package/dist/tasks/complete.js +211 -0
  748. package/dist/tasks/complete.js.map +1 -0
  749. package/dist/tasks/crossref-extract.js +73 -0
  750. package/dist/tasks/crossref-extract.js.map +1 -0
  751. package/dist/tasks/delete-preview.js +192 -0
  752. package/dist/tasks/delete-preview.js.map +1 -0
  753. package/dist/tasks/delete.js +120 -0
  754. package/dist/tasks/delete.js.map +1 -0
  755. package/dist/tasks/deletion-strategy.js +200 -0
  756. package/dist/tasks/deletion-strategy.js.map +1 -0
  757. package/dist/tasks/dependency-check.js +278 -0
  758. package/dist/tasks/dependency-check.js.map +1 -0
  759. package/dist/tasks/deps-ready.js +32 -0
  760. package/dist/tasks/deps-ready.js.map +1 -0
  761. package/dist/tasks/enforcement.js +86 -0
  762. package/dist/tasks/enforcement.js.map +1 -0
  763. package/dist/tasks/epic-enforcement.js +294 -0
  764. package/dist/tasks/epic-enforcement.js.map +1 -0
  765. package/dist/tasks/find.js +154 -0
  766. package/dist/tasks/find.js.map +1 -0
  767. package/dist/tasks/graph-cache.js +127 -0
  768. package/dist/tasks/graph-cache.js.map +1 -0
  769. package/dist/tasks/graph-ops.js +171 -0
  770. package/dist/tasks/graph-ops.js.map +1 -0
  771. package/dist/tasks/graph-rag.js +328 -0
  772. package/dist/tasks/graph-rag.js.map +1 -0
  773. package/dist/tasks/hierarchy-policy.js +149 -0
  774. package/dist/tasks/hierarchy-policy.js.map +1 -0
  775. package/dist/tasks/hierarchy.js +185 -0
  776. package/dist/tasks/hierarchy.js.map +1 -0
  777. package/dist/tasks/id-generator.js +65 -0
  778. package/dist/tasks/id-generator.js.map +1 -0
  779. package/dist/tasks/index.js +14 -0
  780. package/dist/tasks/index.js.map +1 -0
  781. package/dist/tasks/labels.js +52 -0
  782. package/dist/tasks/labels.js.map +1 -0
  783. package/dist/tasks/list.js +75 -0
  784. package/dist/tasks/list.js.map +1 -0
  785. package/dist/tasks/phase-tracking.js +133 -0
  786. package/dist/tasks/phase-tracking.js.map +1 -0
  787. package/dist/tasks/pipeline-stage.js +248 -0
  788. package/dist/tasks/pipeline-stage.js.map +1 -0
  789. package/dist/tasks/plan.js +268 -0
  790. package/dist/tasks/plan.js.map +1 -0
  791. package/dist/tasks/relates.js +89 -0
  792. package/dist/tasks/relates.js.map +1 -0
  793. package/dist/tasks/show.js +80 -0
  794. package/dist/tasks/show.js.map +1 -0
  795. package/dist/tasks/size-weighting.js +86 -0
  796. package/dist/tasks/size-weighting.js.map +1 -0
  797. package/dist/tasks/staleness.js +86 -0
  798. package/dist/tasks/staleness.js.map +1 -0
  799. package/dist/tasks/task-ops.js +1741 -0
  800. package/dist/tasks/task-ops.js.map +1 -0
  801. package/dist/tasks/update.js +277 -0
  802. package/dist/tasks/update.js.map +1 -0
  803. package/dist/templates/index.js +10 -0
  804. package/dist/templates/index.js.map +1 -0
  805. package/dist/templates/parser.js +254 -0
  806. package/dist/templates/parser.js.map +1 -0
  807. package/dist/ui/aliases.js +153 -0
  808. package/dist/ui/aliases.js.map +1 -0
  809. package/dist/ui/changelog.js +184 -0
  810. package/dist/ui/changelog.js.map +1 -0
  811. package/dist/ui/command-registry.js +168 -0
  812. package/dist/ui/command-registry.js.map +1 -0
  813. package/dist/ui/flags.js +94 -0
  814. package/dist/ui/flags.js.map +1 -0
  815. package/dist/ui/index.js +24 -0
  816. package/dist/ui/index.js.map +1 -0
  817. package/dist/upgrade.js +1148 -0
  818. package/dist/upgrade.js.map +1 -0
  819. package/dist/validation/chain-validation.js +146 -0
  820. package/dist/validation/chain-validation.js.map +1 -0
  821. package/dist/validation/compliance.js +155 -0
  822. package/dist/validation/compliance.js.map +1 -0
  823. package/dist/validation/docs-sync.js +212 -0
  824. package/dist/validation/docs-sync.js.map +1 -0
  825. package/dist/validation/doctor/checks.js +1069 -0
  826. package/dist/validation/doctor/checks.js.map +1 -0
  827. package/dist/validation/doctor/index.js +9 -0
  828. package/dist/validation/doctor/index.js.map +1 -0
  829. package/dist/validation/doctor/project-cache.js +160 -0
  830. package/dist/validation/doctor/project-cache.js.map +1 -0
  831. package/dist/validation/doctor/utils.js +155 -0
  832. package/dist/validation/doctor/utils.js.map +1 -0
  833. package/dist/validation/engine.js +902 -0
  834. package/dist/validation/engine.js.map +1 -0
  835. package/dist/validation/gap-check.js +175 -0
  836. package/dist/validation/gap-check.js.map +1 -0
  837. package/dist/validation/index.js +40 -0
  838. package/dist/validation/index.js.map +1 -0
  839. package/dist/validation/manifest.js +237 -0
  840. package/dist/validation/manifest.js.map +1 -0
  841. package/dist/validation/operation-gate-validators.js +724 -0
  842. package/dist/validation/operation-gate-validators.js.map +1 -0
  843. package/dist/validation/operation-verification-gates.js +532 -0
  844. package/dist/validation/operation-verification-gates.js.map +1 -0
  845. package/dist/validation/param-utils.js +139 -0
  846. package/dist/validation/param-utils.js.map +1 -0
  847. package/dist/validation/protocol-common.js +300 -0
  848. package/dist/validation/protocol-common.js.map +1 -0
  849. package/dist/validation/protocols/_shared.js +75 -0
  850. package/dist/validation/protocols/_shared.js.map +1 -0
  851. package/dist/validation/protocols/architecture-decision.js +31 -0
  852. package/dist/validation/protocols/architecture-decision.js.map +1 -0
  853. package/dist/validation/protocols/artifact-publish.js +28 -0
  854. package/dist/validation/protocols/artifact-publish.js.map +1 -0
  855. package/dist/validation/protocols/consensus.js +41 -0
  856. package/dist/validation/protocols/consensus.js.map +1 -0
  857. package/dist/validation/protocols/contribution.js +27 -0
  858. package/dist/validation/protocols/contribution.js.map +1 -0
  859. package/dist/validation/protocols/decomposition.js +28 -0
  860. package/dist/validation/protocols/decomposition.js.map +1 -0
  861. package/dist/validation/protocols/implementation.js +24 -0
  862. package/dist/validation/protocols/implementation.js.map +1 -0
  863. package/dist/validation/protocols/provenance.js +29 -0
  864. package/dist/validation/protocols/provenance.js.map +1 -0
  865. package/dist/validation/protocols/release.js +29 -0
  866. package/dist/validation/protocols/release.js.map +1 -0
  867. package/dist/validation/protocols/research.js +24 -0
  868. package/dist/validation/protocols/research.js.map +1 -0
  869. package/dist/validation/protocols/specification.js +27 -0
  870. package/dist/validation/protocols/specification.js.map +1 -0
  871. package/dist/validation/protocols/testing.js +30 -0
  872. package/dist/validation/protocols/testing.js.map +1 -0
  873. package/dist/validation/protocols/validation.js +30 -0
  874. package/dist/validation/protocols/validation.js.map +1 -0
  875. package/dist/validation/schema-integrity.js +170 -0
  876. package/dist/validation/schema-integrity.js.map +1 -0
  877. package/dist/validation/schema-validator.js +176 -0
  878. package/dist/validation/schema-validator.js.map +1 -0
  879. package/dist/validation/validate-ops.js +937 -0
  880. package/dist/validation/validate-ops.js.map +1 -0
  881. package/dist/validation/validation-rules.js +226 -0
  882. package/dist/validation/validation-rules.js.map +1 -0
  883. package/dist/validation/verification.js +321 -0
  884. package/dist/validation/verification.js.map +1 -0
  885. package/package.json +10 -8
  886. package/src/__tests__/paths-walkup.test.ts +305 -0
  887. package/src/__tests__/paths.test.ts +61 -17
  888. package/src/hooks/handlers/session-hooks.ts +42 -0
  889. package/src/internal.ts +19 -2
  890. package/src/paths.ts +91 -14
  891. package/src/scaffold.ts +22 -3
  892. package/src/store/__tests__/cleanup-legacy.test.ts +268 -0
  893. package/src/store/__tests__/database-topology-integration.test.ts +504 -0
  894. package/src/store/__tests__/sqlite-backup-global.test.ts +281 -0
  895. package/src/store/__tests__/sqlite-backup.test.ts +118 -10
  896. package/src/store/cleanup-legacy.ts +208 -0
  897. package/src/store/index.ts +7 -0
  898. package/src/store/nexus-sqlite.ts +32 -3
  899. package/src/store/sqlite-backup.ts +368 -37
  900. package/src/store/sqlite.ts +19 -3
  901. package/src/system/__tests__/backup.test.ts +237 -0
  902. package/src/system/backup.ts +248 -28
  903. package/templates/cleo-gitignore +19 -3
@@ -0,0 +1,661 @@
1
+ /**
2
+ * Task creation logic.
3
+ * @task T4460
4
+ * @epic T4454
5
+ */
6
+ import { randomBytes } from 'node:crypto';
7
+ // setMetaValue now called via tx.setMetaValue inside transaction (T023)
8
+ import { ExitCode, TASK_STATUSES } from '@cleocode/contracts';
9
+ import { loadConfig } from '../config.js';
10
+ import { CleoError } from '../errors.js';
11
+ import { allocateNextTaskId } from '../sequence/index.js';
12
+ import { requireActiveSession } from '../sessions/session-enforcement.js';
13
+ import { createAcceptanceEnforcement } from './enforcement.js';
14
+ import { findEpicAncestor, getLifecycleMode, validateChildStageCeiling, validateEpicCreation, } from './epic-enforcement.js';
15
+ import { resolveHierarchyPolicy } from './hierarchy-policy.js';
16
+ import { resolveDefaultPipelineStage, validatePipelineStage } from './pipeline-stage.js';
17
+ /**
18
+ * Build the default verification metadata applied to every new task.
19
+ * Gates are initialized to false (not yet passed). `passed` starts false
20
+ * because no gates have been verified yet.
21
+ * @task T061
22
+ */
23
+ export function buildDefaultVerification(initializedAt) {
24
+ return {
25
+ passed: false,
26
+ round: 1,
27
+ gates: {
28
+ implemented: false,
29
+ testsPassed: false,
30
+ qaPassed: false,
31
+ },
32
+ lastAgent: null,
33
+ lastUpdated: null,
34
+ failureLog: [],
35
+ initializedAt,
36
+ };
37
+ }
38
+ /**
39
+ * Validate a task title.
40
+ * @task T4460
41
+ */
42
+ export function validateTitle(title) {
43
+ if (!title || title.trim().length === 0) {
44
+ throw new CleoError(ExitCode.INVALID_INPUT, 'Task title is required');
45
+ }
46
+ if (title.length > 200) {
47
+ throw new CleoError(ExitCode.VALIDATION_ERROR, 'Task title must be 200 characters or less');
48
+ }
49
+ }
50
+ /**
51
+ * Validate task status.
52
+ * @task T4460
53
+ */
54
+ export function validateStatus(status) {
55
+ if (!TASK_STATUSES.includes(status)) {
56
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid status: ${status} (must be ${TASK_STATUSES.join('|')})`);
57
+ }
58
+ }
59
+ /**
60
+ * Mapping from numeric priority (1-9) to string priority names.
61
+ * 1-2 = critical, 3-4 = high, 5-6 = medium, 7-9 = low.
62
+ * @task T4572
63
+ */
64
+ const NUMERIC_PRIORITY_MAP = {
65
+ 1: 'critical',
66
+ 2: 'critical',
67
+ 3: 'high',
68
+ 4: 'high',
69
+ 5: 'medium',
70
+ 6: 'medium',
71
+ 7: 'low',
72
+ 8: 'low',
73
+ 9: 'low',
74
+ };
75
+ /** Valid string priority values. */
76
+ export const VALID_PRIORITIES = [
77
+ 'critical',
78
+ 'high',
79
+ 'medium',
80
+ 'low',
81
+ ];
82
+ /**
83
+ * Normalize priority to canonical string format.
84
+ * Accepts both string names ("critical","high","medium","low") and numeric (1-9).
85
+ * Returns the canonical string format per todo.schema.json.
86
+ * @task T4572
87
+ */
88
+ export function normalizePriority(priority) {
89
+ // Handle numeric input
90
+ if (typeof priority === 'number') {
91
+ const mapped = NUMERIC_PRIORITY_MAP[priority];
92
+ if (!mapped) {
93
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid numeric priority: ${priority} (must be 1-9)`);
94
+ }
95
+ return mapped;
96
+ }
97
+ // Handle string input - check for numeric string first
98
+ const asNumber = Number(priority);
99
+ if (!Number.isNaN(asNumber) && Number.isInteger(asNumber) && asNumber >= 1 && asNumber <= 9) {
100
+ return NUMERIC_PRIORITY_MAP[asNumber];
101
+ }
102
+ // Canonical string validation
103
+ const lower = priority.toLowerCase().trim();
104
+ if (VALID_PRIORITIES.includes(lower)) {
105
+ return lower;
106
+ }
107
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid priority: ${priority} (must be ${VALID_PRIORITIES.join('|')} or numeric 1-9)`);
108
+ }
109
+ /**
110
+ * Validate task priority.
111
+ * @task T4460
112
+ * @task T4572
113
+ */
114
+ export function validatePriority(priority) {
115
+ normalizePriority(priority);
116
+ }
117
+ /**
118
+ * Validate task type.
119
+ * @task T4460
120
+ */
121
+ export function validateTaskType(type) {
122
+ const valid = ['epic', 'task', 'subtask'];
123
+ if (!valid.includes(type)) {
124
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid task type: ${type} (must be ${valid.join('|')})`);
125
+ }
126
+ }
127
+ /**
128
+ * Validate task size.
129
+ * @task T4460
130
+ */
131
+ export function validateSize(size) {
132
+ const valid = ['small', 'medium', 'large'];
133
+ if (!valid.includes(size)) {
134
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid size: ${size} (must be ${valid.join('|')})`);
135
+ }
136
+ }
137
+ /**
138
+ * Validate label format.
139
+ * @task T4460
140
+ */
141
+ export function validateLabels(labels) {
142
+ for (const label of labels) {
143
+ const trimmed = label.trim();
144
+ if (!/^[a-z][a-z0-9.-]*$/.test(trimmed)) {
145
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid label format: '${trimmed}' (must be lowercase alphanumeric with hyphens/periods)`);
146
+ }
147
+ }
148
+ }
149
+ /**
150
+ * Validate phase slug format.
151
+ * @task T4460
152
+ */
153
+ export function validatePhaseFormat(phase) {
154
+ if (!/^[a-z][a-z0-9-]*$/.test(phase)) {
155
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid phase format: ${phase} (must be lowercase alphanumeric with hyphens)`);
156
+ }
157
+ }
158
+ /**
159
+ * Validate dependency IDs exist.
160
+ * @task T4460
161
+ */
162
+ export function validateDepends(depends, tasks) {
163
+ const existingIds = new Set(tasks.map((t) => t.id));
164
+ for (const depId of depends) {
165
+ const trimmed = depId.trim();
166
+ if (!/^T\d{3,}$/.test(trimmed)) {
167
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid dependency ID format: '${trimmed}' (must be T### format)`);
168
+ }
169
+ if (!existingIds.has(trimmed)) {
170
+ throw new CleoError(ExitCode.NOT_FOUND, `Dependency task not found: ${trimmed}`);
171
+ }
172
+ }
173
+ }
174
+ /**
175
+ * Validate parent hierarchy constraints.
176
+ * @task T4460
177
+ */
178
+ export function validateParent(parentId, tasks, maxDepth = 3, maxSiblings = 0) {
179
+ // Check parent exists
180
+ const parent = tasks.find((t) => t.id === parentId);
181
+ if (!parent) {
182
+ throw new CleoError(ExitCode.PARENT_NOT_FOUND, `Parent task not found: ${parentId}`, {
183
+ fix: `Use 'cleo show ${parentId}' to check or create as standalone task`,
184
+ });
185
+ }
186
+ // Check parent type allows children
187
+ if (parent.type === 'subtask') {
188
+ throw new CleoError(ExitCode.INVALID_PARENT_TYPE, `Cannot add child to ${parentId}: subtasks cannot have children`, { fix: `Create as standalone task or add to parent's parent instead` });
189
+ }
190
+ // Check depth
191
+ const depth = getTaskDepth(parentId, tasks);
192
+ if (depth >= maxDepth) {
193
+ throw new CleoError(ExitCode.DEPTH_EXCEEDED, `Cannot add child to ${parentId}: max hierarchy depth (${maxDepth}) would be exceeded`);
194
+ }
195
+ // Check sibling count
196
+ if (maxSiblings > 0) {
197
+ const siblingCount = tasks.filter((t) => t.parentId === parentId).length;
198
+ if (siblingCount >= maxSiblings) {
199
+ throw new CleoError(ExitCode.SIBLING_LIMIT, `Cannot add child to ${parentId}: max siblings (${maxSiblings}) exceeded`, { fix: `Create as standalone task or increase hierarchy.maxSiblings in config` });
200
+ }
201
+ }
202
+ }
203
+ /**
204
+ * Get the depth of a task in the hierarchy.
205
+ * @task T4460
206
+ */
207
+ export function getTaskDepth(taskId, tasks) {
208
+ let depth = 0;
209
+ let currentId = taskId;
210
+ const visited = new Set();
211
+ while (currentId) {
212
+ if (visited.has(currentId))
213
+ break; // circular reference guard
214
+ visited.add(currentId);
215
+ const task = tasks.find((t) => t.id === currentId);
216
+ if (!task?.parentId)
217
+ break;
218
+ depth++;
219
+ currentId = task.parentId;
220
+ }
221
+ return depth;
222
+ }
223
+ /**
224
+ * Infer task type from parent context.
225
+ * @task T4460
226
+ */
227
+ export function inferTaskType(parentId, tasks) {
228
+ if (!parentId)
229
+ return 'task';
230
+ const parent = tasks.find((t) => t.id === parentId);
231
+ if (!parent)
232
+ return 'task';
233
+ if (parent.type === 'epic')
234
+ return 'task';
235
+ return 'subtask';
236
+ }
237
+ /**
238
+ * Get the next position for a task within a parent scope.
239
+ * @task T4460
240
+ */
241
+ export function getNextPosition(parentId, tasks) {
242
+ const siblings = tasks.filter((t) => parentId ? t.parentId === parentId : !t.parentId || t.parentId === null);
243
+ let maxPos = 0;
244
+ for (const s of siblings) {
245
+ if (s.position !== undefined && s.position !== null && s.position > maxPos) {
246
+ maxPos = s.position;
247
+ }
248
+ }
249
+ return maxPos + 1;
250
+ }
251
+ /**
252
+ * Log an operation to the audit log.
253
+ * @task T4460
254
+ */
255
+ export async function logOperation(operation, taskId, details, accessor) {
256
+ const logId = `log-${Math.floor(Date.now() / 1000)}-${randomBytes(3).toString('hex')}`;
257
+ const entry = {
258
+ id: logId,
259
+ timestamp: new Date().toISOString(),
260
+ action: operation,
261
+ taskId,
262
+ actor: 'system',
263
+ details,
264
+ before: null,
265
+ after: details,
266
+ };
267
+ try {
268
+ if (accessor) {
269
+ await accessor.appendLog(entry);
270
+ }
271
+ }
272
+ catch {
273
+ // Log failure is non-fatal
274
+ }
275
+ }
276
+ /**
277
+ * Check for recent duplicate task.
278
+ * @task T4460
279
+ */
280
+ export function findRecentDuplicate(title, phase, tasks, windowSeconds = 60) {
281
+ const now = Date.now();
282
+ const cutoff = now - windowSeconds * 1000;
283
+ for (const task of tasks) {
284
+ if (task.title !== title)
285
+ continue;
286
+ if (phase) {
287
+ if (task.phase !== phase)
288
+ continue;
289
+ }
290
+ else {
291
+ if (task.phase && task.phase !== '')
292
+ continue;
293
+ }
294
+ const created = new Date(task.createdAt).getTime();
295
+ if (created > cutoff)
296
+ return task;
297
+ }
298
+ return null;
299
+ }
300
+ /**
301
+ * Add a new task to the todo file.
302
+ * @task T4460
303
+ */
304
+ export async function addTask(options, cwd, accessor) {
305
+ // Validate title
306
+ validateTitle(options.title);
307
+ // Anti-hallucination: title and description must be different (T5698)
308
+ if (options.description &&
309
+ options.title.trim().toLowerCase() === options.description.trim().toLowerCase()) {
310
+ throw new CleoError(ExitCode.VALIDATION_ERROR, 'Title and description must be different (anti-hallucination rule)');
311
+ }
312
+ // Skip session enforcement for dry-run — no data is written
313
+ if (!options.dryRun) {
314
+ await requireActiveSession('tasks.add', cwd);
315
+ }
316
+ // Orphan prevention (T101): non-epic tasks must have a parent in strict mode.
317
+ // Epics are root containers and are exempt. Only enforced in strict lifecycle mode.
318
+ // Skip for dry-run — no data is written.
319
+ const parentId = options.parentId ?? null;
320
+ if (!options.dryRun && !parentId && options.type !== 'epic') {
321
+ const lifecycleMode = await getLifecycleMode(cwd);
322
+ if (lifecycleMode === 'strict') {
323
+ throw new CleoError(ExitCode.VALIDATION_ERROR, 'Tasks must have a parent (epic or task) in strict mode. Use --parent <epicId> or set lifecycle.mode to "advisory".', {
324
+ fix: 'cleo add "Task title" --parent T### --acceptance "AC1|AC2|AC3"',
325
+ });
326
+ }
327
+ }
328
+ // Always use accessor (SQLite canonical storage per ADR-006)
329
+ const dataAccessor = accessor ?? (await (await import('../store/data-accessor.js')).getAccessor(cwd));
330
+ // Resolve defaults
331
+ const status = options.status ?? 'pending';
332
+ const priority = normalizePriority(options.priority ?? 'medium');
333
+ const size = options.size ?? 'medium';
334
+ let taskType = options.type;
335
+ // Validate inputs
336
+ validateStatus(status);
337
+ // priority is already normalized above
338
+ validateSize(size);
339
+ if (options.labels?.length)
340
+ validateLabels(options.labels);
341
+ // Skip enforcement checks for dry-run — no data is written
342
+ if (!options.dryRun) {
343
+ // Enforce Acceptance Criteria (general rule: min 3 for all task types)
344
+ const enforcement = await createAcceptanceEnforcement(cwd);
345
+ const acValidation = enforcement.validateCreation({
346
+ acceptance: options.acceptance,
347
+ priority: priority,
348
+ });
349
+ if (!acValidation.valid) {
350
+ throw new CleoError(acValidation.exitCode ?? ExitCode.VALIDATION_ERROR, acValidation.error, {
351
+ fix: acValidation.fix,
352
+ });
353
+ }
354
+ // Epic-specific creation enforcement (T062): min 5 AC + non-empty description.
355
+ if (options.type === 'epic') {
356
+ await validateEpicCreation({ acceptance: options.acceptance, description: options.description }, cwd);
357
+ }
358
+ }
359
+ // Validate dependency IDs exist using targeted queries
360
+ if (options.depends?.length) {
361
+ for (const depId of options.depends) {
362
+ const trimmed = depId.trim();
363
+ if (!/^T\d{3,}$/.test(trimmed)) {
364
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid dependency ID format: '${trimmed}' (must be T### format)`);
365
+ }
366
+ const exists = await dataAccessor.taskExists(trimmed);
367
+ if (!exists) {
368
+ throw new CleoError(ExitCode.NOT_FOUND, `Dependency task not found: ${trimmed}`);
369
+ }
370
+ }
371
+ }
372
+ // Phase validation using targeted metadata queries
373
+ let phase = options.phase;
374
+ const projectMeta = await dataAccessor.getMetaValue('project_meta');
375
+ let updatedProjectMeta = null;
376
+ if (phase) {
377
+ validatePhaseFormat(phase);
378
+ // Check if phase exists in project
379
+ const phases = projectMeta?.phases ?? {};
380
+ if (!phases[phase]) {
381
+ if (!options.addPhase) {
382
+ const validPhases = Object.keys(phases).join(', ');
383
+ throw new CleoError(ExitCode.NOT_FOUND, `Phase '${phase}' not found. Valid phases: ${validPhases || 'none'}. Use --add-phase to create new.`);
384
+ }
385
+ // Create phase
386
+ const order = Object.keys(phases).length + 1;
387
+ const name = phase
388
+ .split('-')
389
+ .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
390
+ .join(' ');
391
+ updatedProjectMeta = projectMeta ?? { name: '', phases: {} };
392
+ if (!updatedProjectMeta.phases)
393
+ updatedProjectMeta.phases = {};
394
+ updatedProjectMeta.phases[phase] = { order, name, status: 'pending' };
395
+ }
396
+ }
397
+ else {
398
+ // Inherit from project.currentPhase
399
+ if (projectMeta?.currentPhase) {
400
+ phase = projectMeta.currentPhase;
401
+ }
402
+ }
403
+ // Parent hierarchy validation using targeted queries
404
+ if (parentId) {
405
+ if (!/^T\d{3,}$/.test(parentId)) {
406
+ throw new CleoError(ExitCode.INVALID_INPUT, `Invalid parent ID format: ${parentId}`);
407
+ }
408
+ // Validate parent exists
409
+ const parentTask = await dataAccessor.loadSingleTask(parentId);
410
+ if (!parentTask) {
411
+ throw new CleoError(ExitCode.PARENT_NOT_FOUND, `Parent task ${parentId} not found`);
412
+ }
413
+ // Read hierarchy limits from config via policy module
414
+ const config = await loadConfig(cwd);
415
+ const policy = resolveHierarchyPolicy(config);
416
+ // Depth check using ancestor chain
417
+ const ancestors = await dataAccessor.getAncestorChain(parentId);
418
+ const parentDepth = ancestors.length;
419
+ if (parentDepth + 1 >= policy.maxDepth) {
420
+ throw new CleoError(ExitCode.DEPTH_EXCEEDED, `Maximum nesting depth ${policy.maxDepth} would be exceeded`);
421
+ }
422
+ // Sibling limit (0 = unlimited)
423
+ if (policy.maxSiblings > 0) {
424
+ const children = await dataAccessor.getChildren(parentId);
425
+ const counted = policy.countDoneInLimit
426
+ ? children.length
427
+ : children.filter((t) => t.status !== 'done').length;
428
+ if (counted >= policy.maxSiblings) {
429
+ throw new CleoError(ExitCode.SIBLING_LIMIT, `Parent ${parentId} already has ${counted} children (limit: ${policy.maxSiblings})`);
430
+ }
431
+ }
432
+ // Active siblings cap
433
+ const activeCount = await dataAccessor.countActiveChildren(parentId);
434
+ if (policy.maxActiveSiblings > 0 && activeCount >= policy.maxActiveSiblings) {
435
+ throw new CleoError(ExitCode.SIBLING_LIMIT, `Parent ${parentId} already has ${activeCount} active children (maxActiveSiblings=${policy.maxActiveSiblings})`);
436
+ }
437
+ // Validate type constraints
438
+ if (taskType === 'epic') {
439
+ throw new CleoError(ExitCode.VALIDATION_ERROR, 'Epic tasks cannot have a parent - they must be root-level', { fix: 'Remove --parent flag or change --type to task|subtask' });
440
+ }
441
+ }
442
+ if (taskType === 'subtask' && !parentId) {
443
+ throw new CleoError(ExitCode.VALIDATION_ERROR, 'Subtask tasks require a parent - specify with --parent', { fix: 'Add --parent T### flag or change --type to task|epic' });
444
+ }
445
+ if (taskType) {
446
+ validateTaskType(taskType);
447
+ }
448
+ else {
449
+ // Infer type from parent using targeted query
450
+ if (!parentId) {
451
+ taskType = 'task';
452
+ }
453
+ else {
454
+ const parent = await dataAccessor.loadSingleTask(parentId);
455
+ if (!parent) {
456
+ taskType = 'task';
457
+ }
458
+ else if (parent.type === 'epic') {
459
+ taskType = 'task';
460
+ }
461
+ else {
462
+ taskType = 'subtask';
463
+ }
464
+ }
465
+ }
466
+ // Validate explicit pipelineStage if provided (T060)
467
+ if (options.pipelineStage) {
468
+ validatePipelineStage(options.pipelineStage);
469
+ }
470
+ // Duplicate detection using targeted query
471
+ const { tasks: candidateDupes } = await dataAccessor.queryTasks({
472
+ search: options.title,
473
+ limit: 50,
474
+ });
475
+ const duplicate = findRecentDuplicate(options.title, phase, candidateDupes);
476
+ if (duplicate) {
477
+ return { task: duplicate, duplicate: true };
478
+ }
479
+ // Dry run: build a preview task without allocating a sequence ID or writing to the DB.
480
+ // Must be checked before allocateNextTaskId to avoid advancing the counter on no-op runs.
481
+ if (options.dryRun) {
482
+ const previewNow = new Date().toISOString();
483
+ // Resolve pipeline stage for the preview without any DB writes
484
+ let previewParentForStage = null;
485
+ if (parentId) {
486
+ const previewParentTask = await dataAccessor.loadSingleTask(parentId);
487
+ previewParentForStage = previewParentTask
488
+ ? { pipelineStage: previewParentTask.pipelineStage, type: previewParentTask.type }
489
+ : null;
490
+ }
491
+ const previewPipelineStage = resolveDefaultPipelineStage({
492
+ explicitStage: options.pipelineStage,
493
+ taskType: taskType ?? null,
494
+ parentTask: previewParentForStage,
495
+ });
496
+ const previewPosition = options.position !== undefined
497
+ ? options.position
498
+ : await dataAccessor.getNextPosition(parentId);
499
+ const previewTask = {
500
+ id: 'T???',
501
+ title: options.title,
502
+ description: options.description,
503
+ status,
504
+ priority,
505
+ type: taskType,
506
+ parentId: parentId || null,
507
+ position: previewPosition,
508
+ positionVersion: 0,
509
+ size,
510
+ pipelineStage: previewPipelineStage,
511
+ createdAt: previewNow,
512
+ updatedAt: previewNow,
513
+ };
514
+ if (phase)
515
+ previewTask.phase = phase;
516
+ if (options.labels?.length)
517
+ previewTask.labels = options.labels.map((l) => l.trim());
518
+ if (options.files?.length)
519
+ previewTask.files = options.files.map((f) => f.trim());
520
+ if (options.acceptance?.length)
521
+ previewTask.acceptance = options.acceptance.map((a) => a.trim());
522
+ if (options.depends?.length)
523
+ previewTask.depends = options.depends.map((d) => d.trim());
524
+ if (options.notes) {
525
+ const previewNote = `${new Date()
526
+ .toISOString()
527
+ .replace('T', ' ')
528
+ .replace(/\.\d+Z$/, ' UTC')}: ${options.notes}`;
529
+ previewTask.notes = [previewNote];
530
+ }
531
+ if (status === 'blocked' && options.description) {
532
+ previewTask.blockedBy = options.description;
533
+ }
534
+ if (status === 'done') {
535
+ previewTask.completedAt = previewNow;
536
+ }
537
+ if (taskType !== 'epic') {
538
+ const pCfg = await loadConfig(cwd);
539
+ if (pCfg.verification?.enabled) {
540
+ previewTask.verification = buildDefaultVerification(previewNow);
541
+ }
542
+ }
543
+ return { task: previewTask, dryRun: true };
544
+ }
545
+ const taskId = await allocateNextTaskId(cwd);
546
+ const now = new Date().toISOString();
547
+ // Resolve pipeline stage: explicit > parent inheritance > type default (T060)
548
+ let resolvedParentForStage = null;
549
+ if (parentId) {
550
+ // Re-use the already-validated parent task (loaded above)
551
+ const parentForStage = await dataAccessor.loadSingleTask(parentId);
552
+ resolvedParentForStage = parentForStage
553
+ ? { pipelineStage: parentForStage.pipelineStage, type: parentForStage.type }
554
+ : null;
555
+ }
556
+ const resolvedPipelineStage = resolveDefaultPipelineStage({
557
+ explicitStage: options.pipelineStage,
558
+ taskType: taskType ?? null,
559
+ parentTask: resolvedParentForStage,
560
+ });
561
+ // Child stage ceiling check (T062): child stage must not exceed parent epic's stage.
562
+ // If the direct parent is an epic, check against it; otherwise walk ancestors.
563
+ if (parentId && taskType !== 'epic') {
564
+ let epicToCheck = null;
565
+ if (resolvedParentForStage?.type === 'epic') {
566
+ // Direct parent is an epic — load its full record to pass to validateChildStageCeiling
567
+ epicToCheck = await dataAccessor.loadSingleTask(parentId);
568
+ }
569
+ else {
570
+ // Walk up from the parent to find the nearest epic ancestor
571
+ epicToCheck = await findEpicAncestor(parentId, dataAccessor);
572
+ }
573
+ if (epicToCheck) {
574
+ await validateChildStageCeiling({ childStage: resolvedPipelineStage, epicId: epicToCheck.id }, dataAccessor, cwd);
575
+ }
576
+ }
577
+ // Compute next position using SQL-level allocation (race-safe, T024)
578
+ let position;
579
+ if (options.position !== undefined) {
580
+ position = options.position;
581
+ }
582
+ else {
583
+ position = await dataAccessor.getNextPosition(parentId);
584
+ }
585
+ // Build task object
586
+ const task = {
587
+ id: taskId,
588
+ title: options.title,
589
+ description: options.description,
590
+ status,
591
+ priority,
592
+ type: taskType,
593
+ parentId: parentId || null,
594
+ position,
595
+ positionVersion: 0,
596
+ size,
597
+ createdAt: now,
598
+ updatedAt: now,
599
+ };
600
+ // Assign pipeline stage (always set — auto-assigned if not explicit) (T060)
601
+ task.pipelineStage = resolvedPipelineStage;
602
+ // Add optional fields
603
+ if (phase)
604
+ task.phase = phase;
605
+ if (options.labels?.length)
606
+ task.labels = options.labels.map((l) => l.trim());
607
+ if (options.files?.length)
608
+ task.files = options.files.map((f) => f.trim());
609
+ if (options.acceptance?.length)
610
+ task.acceptance = options.acceptance.map((a) => a.trim());
611
+ if (options.depends?.length)
612
+ task.depends = options.depends.map((d) => d.trim());
613
+ if (options.notes) {
614
+ const timestampedNote = `${new Date()
615
+ .toISOString()
616
+ .replace('T', ' ')
617
+ .replace(/\.\d+Z$/, ' UTC')}: ${options.notes}`;
618
+ task.notes = [timestampedNote];
619
+ }
620
+ if (status === 'blocked' && options.description) {
621
+ task.blockedBy = options.description;
622
+ }
623
+ if (status === 'done') {
624
+ task.completedAt = now;
625
+ }
626
+ // Auto-initialize verification metadata on task creation (T061).
627
+ // Only for non-epic tasks when verification is enabled in config.
628
+ // Epics are containers and do not go through verification gates themselves.
629
+ if (taskType !== 'epic') {
630
+ const aCfg = await loadConfig(cwd);
631
+ if (aCfg.verification?.enabled) {
632
+ task.verification = buildDefaultVerification(now);
633
+ }
634
+ }
635
+ // Wrap all writes in a transaction for TOCTOU safety (T023)
636
+ await dataAccessor.transaction(async (tx) => {
637
+ // Position shuffling via bulk SQL update (T025)
638
+ if (options.position !== undefined) {
639
+ await dataAccessor.shiftPositions(parentId, options.position, 1);
640
+ }
641
+ // Insert the new task
642
+ await tx.upsertSingleTask(task);
643
+ // Update project metadata if a new phase was created
644
+ if (options.addPhase && phase && updatedProjectMeta?.phases?.[phase]) {
645
+ await tx.setMetaValue('project_meta', updatedProjectMeta);
646
+ }
647
+ // Audit log
648
+ await tx.appendLog({
649
+ id: `log-${Math.floor(Date.now() / 1000)}-${randomBytes(3).toString('hex')}`,
650
+ timestamp: new Date().toISOString(),
651
+ action: 'task_created',
652
+ taskId,
653
+ actor: 'system',
654
+ details: { title: options.title, status, priority },
655
+ before: null,
656
+ after: { title: options.title, status, priority },
657
+ });
658
+ });
659
+ return { task };
660
+ }
661
+ //# sourceMappingURL=add.js.map