@lushly-dev/violet-afd 0.0.0-stage → 0.3.0-preview.1

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 (335) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +29 -2
  3. package/dist/commands/analyze/compare.d.ts +36 -0
  4. package/dist/commands/analyze/compare.d.ts.map +1 -0
  5. package/dist/commands/analyze/compare.js +196 -0
  6. package/dist/commands/analyze/compare.js.map +1 -0
  7. package/dist/commands/analyze/compliance.d.ts +41 -0
  8. package/dist/commands/analyze/compliance.d.ts.map +1 -0
  9. package/dist/commands/analyze/compliance.js +166 -0
  10. package/dist/commands/analyze/compliance.js.map +1 -0
  11. package/dist/commands/analyze/deviations.d.ts +30 -0
  12. package/dist/commands/analyze/deviations.d.ts.map +1 -0
  13. package/dist/commands/analyze/deviations.js +201 -0
  14. package/dist/commands/analyze/deviations.js.map +1 -0
  15. package/dist/commands/analyze/health.d.ts +211 -0
  16. package/dist/commands/analyze/health.d.ts.map +1 -0
  17. package/dist/commands/analyze/health.js +697 -0
  18. package/dist/commands/analyze/health.js.map +1 -0
  19. package/dist/commands/analyze/index.d.ts +15 -0
  20. package/dist/commands/analyze/index.d.ts.map +1 -0
  21. package/dist/commands/analyze/index.js +31 -0
  22. package/dist/commands/analyze/index.js.map +1 -0
  23. package/dist/commands/analyze/snapshot.d.ts +64 -0
  24. package/dist/commands/analyze/snapshot.d.ts.map +1 -0
  25. package/dist/commands/analyze/snapshot.js +126 -0
  26. package/dist/commands/analyze/snapshot.js.map +1 -0
  27. package/dist/commands/analyze/trends.d.ts +82 -0
  28. package/dist/commands/analyze/trends.d.ts.map +1 -0
  29. package/dist/commands/analyze/trends.js +312 -0
  30. package/dist/commands/analyze/trends.js.map +1 -0
  31. package/dist/commands/analyze/violations.d.ts +84 -0
  32. package/dist/commands/analyze/violations.d.ts.map +1 -0
  33. package/dist/commands/analyze/violations.js +158 -0
  34. package/dist/commands/analyze/violations.js.map +1 -0
  35. package/dist/commands/apikeys/check.d.ts +39 -0
  36. package/dist/commands/apikeys/check.d.ts.map +1 -0
  37. package/dist/commands/apikeys/check.js +61 -0
  38. package/dist/commands/apikeys/check.js.map +1 -0
  39. package/dist/commands/apikeys/create.d.ts +36 -0
  40. package/dist/commands/apikeys/create.d.ts.map +1 -0
  41. package/dist/commands/apikeys/create.js +116 -0
  42. package/dist/commands/apikeys/create.js.map +1 -0
  43. package/dist/commands/apikeys/index.d.ts +15 -0
  44. package/dist/commands/apikeys/index.d.ts.map +1 -0
  45. package/dist/commands/apikeys/index.js +21 -0
  46. package/dist/commands/apikeys/index.js.map +1 -0
  47. package/dist/commands/apikeys/keys.d.ts +79 -0
  48. package/dist/commands/apikeys/keys.d.ts.map +1 -0
  49. package/dist/commands/apikeys/keys.js +239 -0
  50. package/dist/commands/apikeys/keys.js.map +1 -0
  51. package/dist/commands/audit/index.d.ts +11 -0
  52. package/dist/commands/audit/index.d.ts.map +1 -0
  53. package/dist/commands/audit/index.js +15 -0
  54. package/dist/commands/audit/index.js.map +1 -0
  55. package/dist/commands/audit/list.d.ts +101 -0
  56. package/dist/commands/audit/list.d.ts.map +1 -0
  57. package/dist/commands/audit/list.js +230 -0
  58. package/dist/commands/audit/list.js.map +1 -0
  59. package/dist/commands/changes/impact.d.ts +477 -0
  60. package/dist/commands/changes/impact.d.ts.map +1 -0
  61. package/dist/commands/changes/impact.js +541 -0
  62. package/dist/commands/changes/impact.js.map +1 -0
  63. package/dist/commands/changes/index.d.ts +11 -0
  64. package/dist/commands/changes/index.d.ts.map +1 -0
  65. package/dist/commands/changes/index.js +15 -0
  66. package/dist/commands/changes/index.js.map +1 -0
  67. package/dist/commands/constraints/index.d.ts +11 -0
  68. package/dist/commands/constraints/index.d.ts.map +1 -0
  69. package/dist/commands/constraints/index.js +19 -0
  70. package/dist/commands/constraints/index.js.map +1 -0
  71. package/dist/commands/constraints/list.d.ts +52 -0
  72. package/dist/commands/constraints/list.d.ts.map +1 -0
  73. package/dist/commands/constraints/list.js +103 -0
  74. package/dist/commands/constraints/list.js.map +1 -0
  75. package/dist/commands/constraints/set.d.ts +50 -0
  76. package/dist/commands/constraints/set.d.ts.map +1 -0
  77. package/dist/commands/constraints/set.js +137 -0
  78. package/dist/commands/constraints/set.js.map +1 -0
  79. package/dist/commands/constraints/validate.d.ts +38 -0
  80. package/dist/commands/constraints/validate.d.ts.map +1 -0
  81. package/dist/commands/constraints/validate.js +164 -0
  82. package/dist/commands/constraints/validate.js.map +1 -0
  83. package/dist/commands/docs/generator.d.ts +77 -0
  84. package/dist/commands/docs/generator.d.ts.map +1 -0
  85. package/dist/commands/docs/generator.js +256 -0
  86. package/dist/commands/docs/generator.js.map +1 -0
  87. package/dist/commands/docs/index.d.ts +6 -0
  88. package/dist/commands/docs/index.d.ts.map +1 -0
  89. package/dist/commands/docs/index.js +6 -0
  90. package/dist/commands/docs/index.js.map +1 -0
  91. package/dist/commands/export/export.d.ts +64 -0
  92. package/dist/commands/export/export.d.ts.map +1 -0
  93. package/dist/commands/export/export.js +193 -0
  94. package/dist/commands/export/export.js.map +1 -0
  95. package/dist/commands/export/index.d.ts +9 -0
  96. package/dist/commands/export/index.d.ts.map +1 -0
  97. package/dist/commands/export/index.js +13 -0
  98. package/dist/commands/export/index.js.map +1 -0
  99. package/dist/commands/import/flatten.d.ts +30 -0
  100. package/dist/commands/import/flatten.d.ts.map +1 -0
  101. package/dist/commands/import/flatten.js +121 -0
  102. package/dist/commands/import/flatten.js.map +1 -0
  103. package/dist/commands/import/index.d.ts +11 -0
  104. package/dist/commands/import/index.d.ts.map +1 -0
  105. package/dist/commands/import/index.js +19 -0
  106. package/dist/commands/import/index.js.map +1 -0
  107. package/dist/commands/import/json.d.ts +40 -0
  108. package/dist/commands/import/json.d.ts.map +1 -0
  109. package/dist/commands/import/json.js +209 -0
  110. package/dist/commands/import/json.js.map +1 -0
  111. package/dist/commands/import/tree.d.ts +39 -0
  112. package/dist/commands/import/tree.d.ts.map +1 -0
  113. package/dist/commands/import/tree.js +247 -0
  114. package/dist/commands/import/tree.js.map +1 -0
  115. package/dist/commands/import/validate.d.ts +53 -0
  116. package/dist/commands/import/validate.d.ts.map +1 -0
  117. package/dist/commands/import/validate.js +201 -0
  118. package/dist/commands/import/validate.js.map +1 -0
  119. package/dist/commands/index.d.ts +21 -0
  120. package/dist/commands/index.d.ts.map +1 -0
  121. package/dist/commands/index.js +21 -0
  122. package/dist/commands/index.js.map +1 -0
  123. package/dist/commands/json-schema.d.ts +21 -0
  124. package/dist/commands/json-schema.d.ts.map +1 -0
  125. package/dist/commands/json-schema.js +41 -0
  126. package/dist/commands/json-schema.js.map +1 -0
  127. package/dist/commands/node/create.d.ts +80 -0
  128. package/dist/commands/node/create.d.ts.map +1 -0
  129. package/dist/commands/node/create.js +174 -0
  130. package/dist/commands/node/create.js.map +1 -0
  131. package/dist/commands/node/delete.d.ts +28 -0
  132. package/dist/commands/node/delete.d.ts.map +1 -0
  133. package/dist/commands/node/delete.js +134 -0
  134. package/dist/commands/node/delete.js.map +1 -0
  135. package/dist/commands/node/deprecation.d.ts +23 -0
  136. package/dist/commands/node/deprecation.d.ts.map +1 -0
  137. package/dist/commands/node/deprecation.js +59 -0
  138. package/dist/commands/node/deprecation.js.map +1 -0
  139. package/dist/commands/node/get.d.ts +79 -0
  140. package/dist/commands/node/get.d.ts.map +1 -0
  141. package/dist/commands/node/get.js +106 -0
  142. package/dist/commands/node/get.js.map +1 -0
  143. package/dist/commands/node/graph.d.ts +138 -0
  144. package/dist/commands/node/graph.d.ts.map +1 -0
  145. package/dist/commands/node/graph.js +285 -0
  146. package/dist/commands/node/graph.js.map +1 -0
  147. package/dist/commands/node/index.d.ts +17 -0
  148. package/dist/commands/node/index.d.ts.map +1 -0
  149. package/dist/commands/node/index.js +31 -0
  150. package/dist/commands/node/index.js.map +1 -0
  151. package/dist/commands/node/list.d.ts +74 -0
  152. package/dist/commands/node/list.d.ts.map +1 -0
  153. package/dist/commands/node/list.js +130 -0
  154. package/dist/commands/node/list.js.map +1 -0
  155. package/dist/commands/node/operations.d.ts +35 -0
  156. package/dist/commands/node/operations.d.ts.map +1 -0
  157. package/dist/commands/node/operations.js +66 -0
  158. package/dist/commands/node/operations.js.map +1 -0
  159. package/dist/commands/node/scope.d.ts +14 -0
  160. package/dist/commands/node/scope.d.ts.map +1 -0
  161. package/dist/commands/node/scope.js +49 -0
  162. package/dist/commands/node/scope.js.map +1 -0
  163. package/dist/commands/node/update.d.ts +84 -0
  164. package/dist/commands/node/update.d.ts.map +1 -0
  165. package/dist/commands/node/update.js +229 -0
  166. package/dist/commands/node/update.js.map +1 -0
  167. package/dist/commands/registry.d.ts +126 -0
  168. package/dist/commands/registry.d.ts.map +1 -0
  169. package/dist/commands/registry.js +141 -0
  170. package/dist/commands/registry.js.map +1 -0
  171. package/dist/commands/specimen/get.d.ts +47 -0
  172. package/dist/commands/specimen/get.d.ts.map +1 -0
  173. package/dist/commands/specimen/get.js +124 -0
  174. package/dist/commands/specimen/get.js.map +1 -0
  175. package/dist/commands/specimen/index.d.ts +10 -0
  176. package/dist/commands/specimen/index.d.ts.map +1 -0
  177. package/dist/commands/specimen/index.js +16 -0
  178. package/dist/commands/specimen/index.js.map +1 -0
  179. package/dist/commands/specimen/set.d.ts +31 -0
  180. package/dist/commands/specimen/set.d.ts.map +1 -0
  181. package/dist/commands/specimen/set.js +198 -0
  182. package/dist/commands/specimen/set.js.map +1 -0
  183. package/dist/commands/specimen/shared.d.ts +15 -0
  184. package/dist/commands/specimen/shared.d.ts.map +1 -0
  185. package/dist/commands/specimen/shared.js +26 -0
  186. package/dist/commands/specimen/shared.js.map +1 -0
  187. package/dist/commands/system/doctor.d.ts +48 -0
  188. package/dist/commands/system/doctor.d.ts.map +1 -0
  189. package/dist/commands/system/doctor.js +224 -0
  190. package/dist/commands/system/doctor.js.map +1 -0
  191. package/dist/commands/system/index.d.ts +12 -0
  192. package/dist/commands/system/index.d.ts.map +1 -0
  193. package/dist/commands/system/index.js +17 -0
  194. package/dist/commands/system/index.js.map +1 -0
  195. package/dist/commands/system/validate.d.ts +47 -0
  196. package/dist/commands/system/validate.d.ts.map +1 -0
  197. package/dist/commands/system/validate.js +245 -0
  198. package/dist/commands/system/validate.js.map +1 -0
  199. package/dist/commands/token/add.d.ts +94 -0
  200. package/dist/commands/token/add.d.ts.map +1 -0
  201. package/dist/commands/token/add.js +162 -0
  202. package/dist/commands/token/add.js.map +1 -0
  203. package/dist/commands/token/catalog.d.ts +69 -0
  204. package/dist/commands/token/catalog.d.ts.map +1 -0
  205. package/dist/commands/token/catalog.js +175 -0
  206. package/dist/commands/token/catalog.js.map +1 -0
  207. package/dist/commands/token/compare.d.ts +140 -0
  208. package/dist/commands/token/compare.d.ts.map +1 -0
  209. package/dist/commands/token/compare.js +207 -0
  210. package/dist/commands/token/compare.js.map +1 -0
  211. package/dist/commands/token/copy.d.ts +31 -0
  212. package/dist/commands/token/copy.d.ts.map +1 -0
  213. package/dist/commands/token/copy.js +179 -0
  214. package/dist/commands/token/copy.js.map +1 -0
  215. package/dist/commands/token/definitions.d.ts +29 -0
  216. package/dist/commands/token/definitions.d.ts.map +1 -0
  217. package/dist/commands/token/definitions.js +63 -0
  218. package/dist/commands/token/definitions.js.map +1 -0
  219. package/dist/commands/token/index.d.ts +22 -0
  220. package/dist/commands/token/index.d.ts.map +1 -0
  221. package/dist/commands/token/index.js +44 -0
  222. package/dist/commands/token/index.js.map +1 -0
  223. package/dist/commands/token/lineage.d.ts +43 -0
  224. package/dist/commands/token/lineage.d.ts.map +1 -0
  225. package/dist/commands/token/lineage.js +187 -0
  226. package/dist/commands/token/lineage.js.map +1 -0
  227. package/dist/commands/token/matrix.d.ts +249 -0
  228. package/dist/commands/token/matrix.d.ts.map +1 -0
  229. package/dist/commands/token/matrix.js +658 -0
  230. package/dist/commands/token/matrix.js.map +1 -0
  231. package/dist/commands/token/override.d.ts +51 -0
  232. package/dist/commands/token/override.d.ts.map +1 -0
  233. package/dist/commands/token/override.js +158 -0
  234. package/dist/commands/token/override.js.map +1 -0
  235. package/dist/commands/token/previous-value.d.ts +23 -0
  236. package/dist/commands/token/previous-value.d.ts.map +1 -0
  237. package/dist/commands/token/previous-value.js +26 -0
  238. package/dist/commands/token/previous-value.js.map +1 -0
  239. package/dist/commands/token/reset.d.ts +29 -0
  240. package/dist/commands/token/reset.d.ts.map +1 -0
  241. package/dist/commands/token/reset.js +143 -0
  242. package/dist/commands/token/reset.js.map +1 -0
  243. package/dist/commands/token/resolve.d.ts +43 -0
  244. package/dist/commands/token/resolve.d.ts.map +1 -0
  245. package/dist/commands/token/resolve.js +136 -0
  246. package/dist/commands/token/resolve.js.map +1 -0
  247. package/dist/commands/token/subtract.d.ts +27 -0
  248. package/dist/commands/token/subtract.d.ts.map +1 -0
  249. package/dist/commands/token/subtract.js +129 -0
  250. package/dist/commands/token/subtract.js.map +1 -0
  251. package/dist/commands/webhooks/delete.d.ts +31 -0
  252. package/dist/commands/webhooks/delete.d.ts.map +1 -0
  253. package/dist/commands/webhooks/delete.js +94 -0
  254. package/dist/commands/webhooks/delete.js.map +1 -0
  255. package/dist/commands/webhooks/get.d.ts +50 -0
  256. package/dist/commands/webhooks/get.d.ts.map +1 -0
  257. package/dist/commands/webhooks/get.js +122 -0
  258. package/dist/commands/webhooks/get.js.map +1 -0
  259. package/dist/commands/webhooks/index.d.ts +24 -0
  260. package/dist/commands/webhooks/index.d.ts.map +1 -0
  261. package/dist/commands/webhooks/index.js +41 -0
  262. package/dist/commands/webhooks/index.js.map +1 -0
  263. package/dist/commands/webhooks/list.d.ts +72 -0
  264. package/dist/commands/webhooks/list.d.ts.map +1 -0
  265. package/dist/commands/webhooks/list.js +116 -0
  266. package/dist/commands/webhooks/list.js.map +1 -0
  267. package/dist/commands/webhooks/logs.d.ts +65 -0
  268. package/dist/commands/webhooks/logs.d.ts.map +1 -0
  269. package/dist/commands/webhooks/logs.js +138 -0
  270. package/dist/commands/webhooks/logs.js.map +1 -0
  271. package/dist/commands/webhooks/redact.d.ts +18 -0
  272. package/dist/commands/webhooks/redact.d.ts.map +1 -0
  273. package/dist/commands/webhooks/redact.js +24 -0
  274. package/dist/commands/webhooks/redact.js.map +1 -0
  275. package/dist/commands/webhooks/register.d.ts +78 -0
  276. package/dist/commands/webhooks/register.d.ts.map +1 -0
  277. package/dist/commands/webhooks/register.js +175 -0
  278. package/dist/commands/webhooks/register.js.map +1 -0
  279. package/dist/commands/webhooks/test.d.ts +32 -0
  280. package/dist/commands/webhooks/test.d.ts.map +1 -0
  281. package/dist/commands/webhooks/test.js +101 -0
  282. package/dist/commands/webhooks/test.js.map +1 -0
  283. package/dist/commands/webhooks/update.d.ts +77 -0
  284. package/dist/commands/webhooks/update.d.ts.map +1 -0
  285. package/dist/commands/webhooks/update.js +198 -0
  286. package/dist/commands/webhooks/update.js.map +1 -0
  287. package/dist/css.d.ts +3 -0
  288. package/dist/css.d.ts.map +1 -0
  289. package/dist/css.js +3 -0
  290. package/dist/css.js.map +1 -0
  291. package/dist/demo/index.d.ts +8 -0
  292. package/dist/demo/index.d.ts.map +1 -0
  293. package/dist/demo/index.js +8 -0
  294. package/dist/demo/index.js.map +1 -0
  295. package/dist/demo/realistic-system.d.ts +54 -0
  296. package/dist/demo/realistic-system.d.ts.map +1 -0
  297. package/dist/demo/realistic-system.js +919 -0
  298. package/dist/demo/realistic-system.js.map +1 -0
  299. package/dist/index.d.ts +21 -0
  300. package/dist/index.d.ts.map +1 -0
  301. package/dist/index.js +60 -0
  302. package/dist/index.js.map +1 -0
  303. package/dist/types/command-result.d.ts +10 -0
  304. package/dist/types/command-result.d.ts.map +1 -0
  305. package/dist/types/command-result.js +11 -0
  306. package/dist/types/command-result.js.map +1 -0
  307. package/dist/types/index.d.ts +8 -0
  308. package/dist/types/index.d.ts.map +1 -0
  309. package/dist/types/index.js +10 -0
  310. package/dist/types/index.js.map +1 -0
  311. package/dist/version.d.ts +3 -0
  312. package/dist/version.d.ts.map +1 -0
  313. package/dist/version.js +4 -0
  314. package/dist/version.js.map +1 -0
  315. package/dist/webhooks/dispatcher.d.ts +147 -0
  316. package/dist/webhooks/dispatcher.d.ts.map +1 -0
  317. package/dist/webhooks/dispatcher.js +420 -0
  318. package/dist/webhooks/dispatcher.js.map +1 -0
  319. package/dist/webhooks/index.d.ts +9 -0
  320. package/dist/webhooks/index.d.ts.map +1 -0
  321. package/dist/webhooks/index.js +9 -0
  322. package/dist/webhooks/index.js.map +1 -0
  323. package/dist/webhooks/signer.d.ts +119 -0
  324. package/dist/webhooks/signer.d.ts.map +1 -0
  325. package/dist/webhooks/signer.js +149 -0
  326. package/dist/webhooks/signer.js.map +1 -0
  327. package/dist/webhooks/url-policy.d.ts +73 -0
  328. package/dist/webhooks/url-policy.d.ts.map +1 -0
  329. package/dist/webhooks/url-policy.js +250 -0
  330. package/dist/webhooks/url-policy.js.map +1 -0
  331. package/dist/worker.d.ts +11 -0
  332. package/dist/worker.d.ts.map +1 -0
  333. package/dist/worker.js +31 -0
  334. package/dist/worker.js.map +1 -0
  335. package/package.json +84 -3
@@ -0,0 +1,312 @@
1
+ import { z } from 'zod';
2
+ import { ErrorCodes, failure, success } from '../../types/command-result.js';
3
+ import { parseAuditTime } from '../audit/list.js';
4
+ import { selectSubtree } from '../node/scope.js';
5
+ import { compareIssues } from './snapshot.js';
6
+ import { analyzeViolationsCommand } from './violations.js';
7
+ /** Longest range `analyze.trends` reports, in days */
8
+ export const MAX_TREND_DAYS = 366;
9
+ const DAY_MS = 24 * 60 * 60 * 1000;
10
+ /** Events that change a token on a node: add, override, copy, subtract, reset */
11
+ const TOKEN_EVENTS = new Set(['token_created', 'token_updated', 'token_deleted']);
12
+ /** Events that set a value, so a failing value dates from the latest one */
13
+ const VALUE_EVENTS = ['token_created', 'token_updated'];
14
+ /**
15
+ * Input schema for analyze.trends command
16
+ */
17
+ const InputSchema = z.object({
18
+ rootId: z.string().min(1).optional(), // The node and its descendants; defaults to every tree
19
+ since: z.string().min(1).optional().default('90d'), // ISO date or time, or a span back from now
20
+ until: z.string().min(1).optional(), // Same forms; defaults to now
21
+ includeViolations: z.boolean().optional().default(true), // Date the open rule issues too
22
+ includeHistory: z.boolean().optional().default(true), // Recorded rule checks (analyze.snapshot)
23
+ });
24
+ const SeverityCountsSchema = z.object({
25
+ total: z.number(),
26
+ error: z.number(),
27
+ warning: z.number(),
28
+ info: z.number(),
29
+ });
30
+ const TrendDaySchema = z.object({
31
+ /** UTC day, `YYYY-MM-DD` */
32
+ date: z.string(),
33
+ /** Every audit event on the nodes that day */
34
+ changes: z.number(),
35
+ /** Token adds, overrides, copies, subtractions and resets */
36
+ tokenChanges: z.number(),
37
+ /** Open rule issues whose failing value was last set that day */
38
+ introduced: SeverityCountsSchema.optional(),
39
+ /** Open rule issues whose failing value was set by the end of that day */
40
+ open: z.number().optional(),
41
+ /** The rule check recorded that day (the day's last snapshot), when there is one */
42
+ recorded: SeverityCountsSchema.extend({ takenAt: z.string() }).optional(),
43
+ });
44
+ /**
45
+ * Output schema for analyze.trends command
46
+ */
47
+ const OutputSchema = z.object({
48
+ since: z.string(),
49
+ until: z.string(),
50
+ /** Every UTC day in the range, oldest first, including quiet days */
51
+ days: z.array(TrendDaySchema),
52
+ summary: z.object({
53
+ /** Nodes counted: the root and its descendants, or every node */
54
+ nodes: z.number(),
55
+ changes: z.number(),
56
+ tokenChanges: z.number(),
57
+ byType: z.record(z.string(), z.number()),
58
+ /** Rule issues open now; omitted when not checked */
59
+ violations: z
60
+ .object({
61
+ open: SeverityCountsSchema,
62
+ /** Failing value set before the range */
63
+ before: z.number(),
64
+ /** Failing value set within the range */
65
+ during: z.number(),
66
+ /** No audit event sets the failing value (e.g. data imported before auditing) */
67
+ undated: z.number(),
68
+ })
69
+ .optional(),
70
+ /**
71
+ * Recorded rule checks in the range (analyze.snapshot): true history, issues
72
+ * fixed since included. Snapshots of the subtree, an ancestor or every tree
73
+ * count, cut to the subtree's nodes. Omitted when not read.
74
+ */
75
+ history: z
76
+ .object({
77
+ /** Days with a recorded check */
78
+ days: z.number(),
79
+ first: z.string().nullable(),
80
+ last: z.string().nullable(),
81
+ /** Issues open at the first and last recorded check */
82
+ firstOpen: z.number(),
83
+ lastOpen: z.number(),
84
+ /** Issues that appeared, and that were fixed, from one recorded check to the next, summed */
85
+ introduced: z.number(),
86
+ fixed: z.number(),
87
+ })
88
+ .optional(),
89
+ }),
90
+ });
91
+ function counts() {
92
+ return { total: 0, error: 0, warning: 0, info: 0 };
93
+ }
94
+ /** Every UTC date from `since` up to (not including) `until` */
95
+ export function daysBetween(since, until) {
96
+ const dates = [];
97
+ const end = Date.parse(until);
98
+ for (let day = Date.parse(since.slice(0, 10)); day < end; day += DAY_MS) {
99
+ dates.push(new Date(day).toISOString().slice(0, 10));
100
+ }
101
+ return dates;
102
+ }
103
+ /** When each open violation's failing value was last set, from the audit log */
104
+ async function dateViolations(context, violations) {
105
+ const setAt = new Map();
106
+ const dated = new Map();
107
+ for (const violation of violations) {
108
+ const key = `${violation.source}\u0000${violation.tokenId}`;
109
+ if (!setAt.has(key)) {
110
+ const page = await context.db.queryAuditEvents({
111
+ nodeIds: [violation.source],
112
+ tokenId: violation.tokenId,
113
+ eventTypes: VALUE_EVENTS,
114
+ limit: 1,
115
+ offset: 0,
116
+ });
117
+ setAt.set(key, page.events[0]?.timestamp ?? null);
118
+ }
119
+ dated.set(violation, setAt.get(key) ?? null);
120
+ }
121
+ return dated;
122
+ }
123
+ /** Spread the open violations over the days their failing values were set */
124
+ function addViolations(days, dated, since) {
125
+ const open = counts();
126
+ const byDate = new Map(days.map((day) => [day.date, day]));
127
+ let before = 0;
128
+ let undated = 0;
129
+ for (const day of days)
130
+ day.introduced = counts();
131
+ for (const [violation, timestamp] of dated) {
132
+ open.total += 1;
133
+ open[violation.severity] += 1;
134
+ if (!timestamp)
135
+ undated += 1;
136
+ else if (timestamp < since)
137
+ before += 1;
138
+ else {
139
+ const introduced = byDate.get(timestamp.slice(0, 10))?.introduced;
140
+ if (introduced) {
141
+ introduced.total += 1;
142
+ introduced[violation.severity] += 1;
143
+ }
144
+ }
145
+ }
146
+ let running = before;
147
+ for (const day of days) {
148
+ running += day.introduced?.total ?? 0;
149
+ day.open = running;
150
+ }
151
+ return { open, before, during: running - before, undated };
152
+ }
153
+ /** A snapshot's issues on the scoped nodes only */
154
+ function scopedIssues(snapshot, nodeIds) {
155
+ return nodeIds ? snapshot.issues.filter((issue) => nodeIds.has(issue.nodeId)) : snapshot.issues;
156
+ }
157
+ /**
158
+ * Put each day's last recorded check on the day, cut to the scoped nodes, and
159
+ * count the issues that appeared and were fixed from one check to the next.
160
+ */
161
+ function addHistory(days, snapshots, nodeIds) {
162
+ const byDate = new Map(days.map((day) => [day.date, day]));
163
+ const lastOfDay = new Map();
164
+ for (const snapshot of snapshots)
165
+ lastOfDay.set(snapshot.takenAt.slice(0, 10), snapshot);
166
+ const recorded = [];
167
+ for (const [date, snapshot] of [...lastOfDay].sort(([a], [b]) => a.localeCompare(b))) {
168
+ const day = byDate.get(date);
169
+ if (!day)
170
+ continue;
171
+ const issues = scopedIssues(snapshot, nodeIds);
172
+ recorded.push(issues);
173
+ const tally = { ...counts(), takenAt: snapshot.takenAt };
174
+ for (const issue of issues) {
175
+ tally.total += 1;
176
+ tally[issue.severity] += 1;
177
+ }
178
+ day.recorded = tally;
179
+ }
180
+ const firstDay = days.find((day) => day.recorded);
181
+ const lastDay = [...days].reverse().find((day) => day.recorded);
182
+ let introduced = 0;
183
+ let fixed = 0;
184
+ for (let i = 1; i < recorded.length; i++) {
185
+ const step = compareIssues(recorded[i - 1], recorded[i]);
186
+ introduced += step.introduced;
187
+ fixed += step.fixed;
188
+ }
189
+ return {
190
+ days: recorded.length,
191
+ first: firstDay?.recorded?.takenAt ?? null,
192
+ last: lastDay?.recorded?.takenAt ?? null,
193
+ firstOpen: firstDay?.recorded?.total ?? 0,
194
+ lastOpen: lastDay?.recorded?.total ?? 0,
195
+ introduced,
196
+ fixed,
197
+ };
198
+ }
199
+ /**
200
+ * analyze.trends command
201
+ *
202
+ * "Is it getting better or worse?" for a node and its descendants: changes per
203
+ * day from the audit log, and the rule issues open now spread over the days
204
+ * their failing values were last set. The audit log records changes, not past
205
+ * check results, so an issue fixed since then is not counted on earlier days;
206
+ * rule checks recorded with `analyze.snapshot` add that true history.
207
+ */
208
+ export const analyzeTrendsCommand = {
209
+ name: 'analyze.trends',
210
+ description: 'Changes per day, open rule issues by the day their value was set, and recorded rule checks, for a node and its descendants',
211
+ category: 'analyze',
212
+ inputSchema: InputSchema,
213
+ outputSchema: OutputSchema,
214
+ async handler(rawInput, context) {
215
+ const { db } = context;
216
+ // Parse input to apply defaults
217
+ const input = InputSchema.parse(rawInput);
218
+ const now = Date.now();
219
+ const since = parseAuditTime(input.since, now);
220
+ const until = input.until ? parseAuditTime(input.until, now) : new Date(now).toISOString();
221
+ if (!since || !until) {
222
+ const bound = since ? 'until' : 'since';
223
+ return failure({
224
+ code: ErrorCodes.VALIDATION_ERROR,
225
+ message: `Invalid ${bound} '${input[bound]}'`,
226
+ suggestion: 'Use an ISO date or time (2026-10-01) or a span back from now (30d, 12h, 2w)',
227
+ });
228
+ }
229
+ const dates = daysBetween(since, until);
230
+ if (dates.length === 0 || dates.length > MAX_TREND_DAYS) {
231
+ return failure({
232
+ code: ErrorCodes.VALIDATION_ERROR,
233
+ message: `The range covers ${dates.length} day(s); trends take 1 to ${MAX_TREND_DAYS}`,
234
+ suggestion: "Make 'since' earlier than 'until', and keep the range within a year",
235
+ });
236
+ }
237
+ const scope = await selectSubtree(db, input.rootId);
238
+ if (!scope) {
239
+ return failure({
240
+ code: ErrorCodes.NODE_NOT_FOUND,
241
+ message: `Node '${input.rootId}' not found`,
242
+ suggestion: `Use 'node.list' to see available nodes`,
243
+ });
244
+ }
245
+ // Day counts cover every match, so one event is enough to page
246
+ const audit = await db.queryAuditEvents({
247
+ nodeIds: input.rootId ? scope.map((node) => node.id) : undefined,
248
+ since,
249
+ until,
250
+ limit: 1,
251
+ offset: 0,
252
+ });
253
+ const days = dates.map((date) => ({ date, changes: 0, tokenChanges: 0 }));
254
+ const byDate = new Map(days.map((day) => [day.date, day]));
255
+ const byType = {};
256
+ for (const count of audit.days) {
257
+ byType[count.eventType] = (byType[count.eventType] ?? 0) + count.count;
258
+ const day = byDate.get(count.date);
259
+ if (!day)
260
+ continue;
261
+ day.changes += count.count;
262
+ if (TOKEN_EVENTS.has(count.eventType))
263
+ day.tokenChanges += count.count;
264
+ }
265
+ const summary = {
266
+ nodes: scope.length,
267
+ changes: audit.total,
268
+ tokenChanges: days.reduce((sum, day) => sum + day.tokenChanges, 0),
269
+ byType,
270
+ };
271
+ if (input.includeViolations) {
272
+ const checked = await analyzeViolationsCommand.handler({ rootId: input.rootId }, context);
273
+ if (!checked.success || !checked.data) {
274
+ return failure(checked.error ?? {
275
+ code: ErrorCodes.INTERNAL_ERROR,
276
+ message: 'Could not check the rules',
277
+ });
278
+ }
279
+ const dated = await dateViolations(context, checked.data.violations);
280
+ summary.violations = addViolations(days, dated, since);
281
+ }
282
+ if (input.includeHistory) {
283
+ const covering = [null];
284
+ if (input.rootId) {
285
+ covering.push(...(await db.getAncestryChain(input.rootId)), input.rootId);
286
+ }
287
+ const snapshots = await db.listCheckSnapshots({ rootIds: covering, since, until });
288
+ const nodeIds = input.rootId ? new Set(scope.map((node) => node.id)) : null;
289
+ summary.history = addHistory(days, snapshots, nodeIds);
290
+ }
291
+ const recordedText = summary.history && summary.history.days > 0
292
+ ? `; ${summary.history.days} day(s) of recorded checks, ${summary.history.firstOpen} → ${summary.history.lastOpen} open`
293
+ : '';
294
+ const issues = summary.violations
295
+ ? `; ${summary.violations.open.total} open issue(s), ${summary.violations.during} set in the range`
296
+ : '';
297
+ return success({ since, until, days, summary }, {
298
+ reasoning: `${summary.changes} change(s) on ${scope.length} node(s) over ${days.length} day(s)${issues}${recordedText}`,
299
+ });
300
+ },
301
+ examples: [
302
+ {
303
+ description: 'The last 90 days across the system',
304
+ input: {},
305
+ },
306
+ {
307
+ description: 'The xbox subtree over the last 4 weeks',
308
+ input: { rootId: 'xbox', since: '4w' },
309
+ },
310
+ ],
311
+ };
312
+ //# sourceMappingURL=trends.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trends.js","sourceRoot":"","sources":["../../../src/commands/analyze/trends.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,84 @@
1
+ import { z } from 'zod';
2
+ import type { CommandContext, CommandDefinition } from '../registry.js';
3
+ /**
4
+ * Input schema for analyze.violations command
5
+ */
6
+ declare const InputSchema: z.ZodObject<{
7
+ rootId: z.ZodOptional<z.ZodString>;
8
+ severity: z.ZodOptional<z.ZodEnum<{
9
+ error: "error";
10
+ info: "info";
11
+ warning: "warning";
12
+ }>>;
13
+ }, z.core.$strip>;
14
+ export declare const NodeViolationSchema: z.ZodObject<{
15
+ nodeId: z.ZodString;
16
+ owner: z.ZodOptional<z.ZodString>;
17
+ tokenId: z.ZodString;
18
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
19
+ source: z.ZodString;
20
+ inherited: z.ZodBoolean;
21
+ constraintId: z.ZodString;
22
+ constraintName: z.ZodString;
23
+ severity: z.ZodEnum<{
24
+ error: "error";
25
+ info: "info";
26
+ warning: "warning";
27
+ }>;
28
+ message: z.ZodString;
29
+ expected: z.ZodOptional<z.ZodString>;
30
+ actual: z.ZodOptional<z.ZodString>;
31
+ }, z.core.$strip>;
32
+ /**
33
+ * Output schema for analyze.violations command
34
+ */
35
+ declare const OutputSchema: z.ZodObject<{
36
+ violations: z.ZodArray<z.ZodObject<{
37
+ nodeId: z.ZodString;
38
+ owner: z.ZodOptional<z.ZodString>;
39
+ tokenId: z.ZodString;
40
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
41
+ source: z.ZodString;
42
+ inherited: z.ZodBoolean;
43
+ constraintId: z.ZodString;
44
+ constraintName: z.ZodString;
45
+ severity: z.ZodEnum<{
46
+ error: "error";
47
+ info: "info";
48
+ warning: "warning";
49
+ }>;
50
+ message: z.ZodString;
51
+ expected: z.ZodOptional<z.ZodString>;
52
+ actual: z.ZodOptional<z.ZodString>;
53
+ }, z.core.$strip>>;
54
+ summary: z.ZodObject<{
55
+ total: z.ZodNumber;
56
+ errors: z.ZodNumber;
57
+ warnings: z.ZodNumber;
58
+ infos: z.ZodNumber;
59
+ nodes: z.ZodNumber;
60
+ byNode: z.ZodRecord<z.ZodString, z.ZodNumber>;
61
+ unresolved: z.ZodArray<z.ZodString>;
62
+ }, z.core.$strip>;
63
+ }, z.core.$strip>;
64
+ type Output = z.infer<typeof OutputSchema>;
65
+ export type NodeViolation = Output['violations'][number];
66
+ /**
67
+ * Violations on one node, each with where its failing value is set; null when
68
+ * the node can't be resolved or validated (e.g. a copy/include cycle).
69
+ */
70
+ export declare function nodeViolations(context: CommandContext, node: {
71
+ id: string;
72
+ owner?: string | null;
73
+ }, severity: NodeViolation['severity'] | undefined): Promise<NodeViolation[] | null>;
74
+ /**
75
+ * analyze.violations command
76
+ *
77
+ * Every constraint violation across a subtree in one list: which node, which
78
+ * token and rule, the measured vs. required value, where the failing value is
79
+ * set, and who owns the node. Answers "where are the problems?" without
80
+ * checking nodes one at a time.
81
+ */
82
+ export declare const analyzeViolationsCommand: CommandDefinition<typeof InputSchema, Output>;
83
+ export {};
84
+ //# sourceMappingURL=violations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"violations.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze/violations.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;GAEG;AACH,QAAA,MAAM,WAAW;;;;;;;iBAGf,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;iBAe9B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAahB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC3C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD;;;GAGG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC3C,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CA8BjC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAAiB,CAAC,OAAO,WAAW,EAAE,MAAM,CA+ElF,CAAC"}
@@ -0,0 +1,158 @@
1
+ import { InheritanceResolutionError, resolutionCacheFor, resolveNodeTokenMap, withResolutionCache, } from '@lushly-dev/violet-core/engine';
2
+ import { ConstraintSeveritySchema } from '@lushly-dev/violet-core/types';
3
+ import { z } from 'zod';
4
+ import { ErrorCodes, failure, success } from '../../types/command-result.js';
5
+ import { validateCommand } from '../constraints/validate.js';
6
+ import { selectSubtree } from '../node/scope.js';
7
+ /**
8
+ * Input schema for analyze.violations command
9
+ */
10
+ const InputSchema = z.object({
11
+ rootId: z.string().min(1).optional(), // Subtree to check; defaults to every tree
12
+ severity: ConstraintSeveritySchema.optional(), // Only this severity
13
+ });
14
+ export const NodeViolationSchema = z.object({
15
+ nodeId: z.string(),
16
+ owner: z.string().optional(),
17
+ tokenId: z.string(),
18
+ value: z.union([z.string(), z.number()]),
19
+ /** Node where the failing value is set */
20
+ source: z.string(),
21
+ /** True when the node inherits the failing value rather than setting it */
22
+ inherited: z.boolean(),
23
+ constraintId: z.string(),
24
+ constraintName: z.string(),
25
+ severity: ConstraintSeveritySchema,
26
+ message: z.string(),
27
+ expected: z.string().optional(),
28
+ actual: z.string().optional(),
29
+ });
30
+ /**
31
+ * Output schema for analyze.violations command
32
+ */
33
+ const OutputSchema = z.object({
34
+ violations: z.array(NodeViolationSchema),
35
+ summary: z.object({
36
+ total: z.number(),
37
+ errors: z.number(),
38
+ warnings: z.number(),
39
+ infos: z.number(),
40
+ /** Nodes with at least one violation */
41
+ nodes: z.number(),
42
+ byNode: z.record(z.string(), z.number()),
43
+ /** Nodes that could not be checked (e.g. a copy/include cycle) */
44
+ unresolved: z.array(z.string()),
45
+ }),
46
+ });
47
+ const SEVERITY_ORDER = { error: 0, warning: 1, info: 2 };
48
+ /**
49
+ * Violations on one node, each with where its failing value is set; null when
50
+ * the node can't be resolved or validated (e.g. a copy/include cycle).
51
+ */
52
+ export async function nodeViolations(context, node, severity) {
53
+ let resolved;
54
+ try {
55
+ resolved = await resolveNodeTokenMap(context.db, node.id, resolutionCacheFor(context));
56
+ }
57
+ catch (error) {
58
+ if (!(error instanceof InheritanceResolutionError))
59
+ throw error;
60
+ return null;
61
+ }
62
+ const result = await validateCommand.handler({ nodeId: node.id }, context);
63
+ if (!result.success || !result.data)
64
+ return null;
65
+ return result.data.results.flatMap((tokenResult) => {
66
+ const source = resolved.get(tokenResult.tokenId)?.resolvedAt ?? node.id;
67
+ return tokenResult.violations
68
+ .filter((violation) => !severity || violation.severity === severity)
69
+ .map((violation) => ({
70
+ nodeId: node.id,
71
+ ...(node.owner ? { owner: node.owner } : {}),
72
+ tokenId: tokenResult.tokenId,
73
+ value: tokenResult.value,
74
+ source,
75
+ inherited: source !== node.id,
76
+ constraintId: violation.constraintId,
77
+ constraintName: violation.constraintName,
78
+ severity: violation.severity,
79
+ message: violation.message,
80
+ ...(violation.expected ? { expected: violation.expected } : {}),
81
+ ...(violation.actual ? { actual: violation.actual } : {}),
82
+ }));
83
+ });
84
+ }
85
+ /**
86
+ * analyze.violations command
87
+ *
88
+ * Every constraint violation across a subtree in one list: which node, which
89
+ * token and rule, the measured vs. required value, where the failing value is
90
+ * set, and who owns the node. Answers "where are the problems?" without
91
+ * checking nodes one at a time.
92
+ */
93
+ export const analyzeViolationsCommand = {
94
+ name: 'analyze.violations',
95
+ description: 'List every constraint violation across a subtree, with the node, rule, values and owner',
96
+ category: 'analyze',
97
+ inputSchema: InputSchema,
98
+ outputSchema: OutputSchema,
99
+ async handler(rawInput, context) {
100
+ const { db } = context;
101
+ // Parse input to apply defaults
102
+ const input = InputSchema.parse(rawInput);
103
+ const scope = await selectSubtree(db, input.rootId);
104
+ if (!scope) {
105
+ return failure({
106
+ code: ErrorCodes.NODE_NOT_FOUND,
107
+ message: `Node '${input.rootId}' not found`,
108
+ suggestion: `Use 'node.list' to see available nodes`,
109
+ });
110
+ }
111
+ const violations = [];
112
+ const unresolved = [];
113
+ const order = new Map(scope.map((node, index) => [node.id, index]));
114
+ // Read-only from here: share resolved chains between the nodes
115
+ const scoped = withResolutionCache(context);
116
+ for (const node of scope) {
117
+ const found = await nodeViolations(scoped, node, input.severity);
118
+ if (found)
119
+ violations.push(...found);
120
+ else
121
+ unresolved.push(node.id);
122
+ }
123
+ violations.sort((a, b) => SEVERITY_ORDER[a.severity] - SEVERITY_ORDER[b.severity] ||
124
+ (order.get(a.nodeId) ?? 0) - (order.get(b.nodeId) ?? 0) ||
125
+ a.tokenId.localeCompare(b.tokenId));
126
+ const byNode = {};
127
+ for (const violation of violations) {
128
+ byNode[violation.nodeId] = (byNode[violation.nodeId] ?? 0) + 1;
129
+ }
130
+ const count = (severity) => violations.filter((violation) => violation.severity === severity).length;
131
+ const nodes = Object.keys(byNode).length;
132
+ return success({
133
+ violations,
134
+ summary: {
135
+ total: violations.length,
136
+ errors: count('error'),
137
+ warnings: count('warning'),
138
+ infos: count('info'),
139
+ nodes,
140
+ byNode,
141
+ unresolved,
142
+ },
143
+ }, {
144
+ reasoning: `${violations.length} violation(s) on ${nodes} of ${scope.length} node(s)${unresolved.length > 0 ? `; ${unresolved.length} node(s) could not be checked` : ''}`,
145
+ });
146
+ },
147
+ examples: [
148
+ {
149
+ description: 'Every violation in the system',
150
+ input: {},
151
+ },
152
+ {
153
+ description: 'Errors only, within the office subtree',
154
+ input: { rootId: 'office', severity: 'error' },
155
+ },
156
+ ],
157
+ };
158
+ //# sourceMappingURL=violations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"violations.js","sourceRoot":"","sources":["../../../src/commands/analyze/violations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import { z } from 'zod';
2
+ import type { CommandDefinition } from '../registry.js';
3
+ declare const ApiKeysCheckInputSchema: z.ZodObject<{
4
+ seeds: z.ZodString;
5
+ }, z.core.$strip>;
6
+ declare const ApiKeysCheckOutputSchema: z.ZodObject<{
7
+ valid: z.ZodBoolean;
8
+ keys: z.ZodArray<z.ZodObject<{
9
+ entry: z.ZodNumber;
10
+ id: z.ZodOptional<z.ZodString>;
11
+ name: z.ZodOptional<z.ZodString>;
12
+ scopes: z.ZodArray<z.ZodString>;
13
+ rateLimit: z.ZodOptional<z.ZodNumber>;
14
+ revokedAt: z.ZodOptional<z.ZodString>;
15
+ }, z.core.$strip>>;
16
+ issues: z.ZodArray<z.ZodObject<{
17
+ severity: z.ZodEnum<{
18
+ error: "error";
19
+ warning: "warning";
20
+ }>;
21
+ code: z.ZodString;
22
+ message: z.ZodString;
23
+ entry: z.ZodOptional<z.ZodNumber>;
24
+ keyId: z.ZodOptional<z.ZodString>;
25
+ }, z.core.$strip>>;
26
+ summary: z.ZodObject<{
27
+ keys: z.ZodNumber;
28
+ errors: z.ZodNumber;
29
+ warnings: z.ZodNumber;
30
+ }, z.core.$strip>;
31
+ }, z.core.$strip>;
32
+ type ApiKeysCheckOutput = z.infer<typeof ApiKeysCheckOutputSchema>;
33
+ /**
34
+ * Check a VIOLET_API_KEYS_JSON value before it is saved to an environment.
35
+ * Reports problems by entry and key id; never echoes tokens.
36
+ */
37
+ export declare const apiKeysCheckCommand: CommandDefinition<typeof ApiKeysCheckInputSchema, ApiKeysCheckOutput>;
38
+ export {};
39
+ //# sourceMappingURL=check.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/commands/apikeys/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,QAAA,MAAM,uBAAuB;;iBAE3B,CAAC;AAIH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;iBAsB5B,CAAC;AAEH,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,CAClD,OAAO,uBAAuB,EAC9B,kBAAkB,CAwClB,CAAC"}