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

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 +34 -0
  4. package/dist/commands/analyze/compare.d.ts.map +1 -0
  5. package/dist/commands/analyze/compare.js +180 -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 +114 -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 +46 -0
  172. package/dist/commands/specimen/get.d.ts.map +1 -0
  173. package/dist/commands/specimen/get.js +121 -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 +188 -0
  182. package/dist/commands/specimen/set.js.map +1 -0
  183. package/dist/commands/specimen/shared.d.ts +16 -0
  184. package/dist/commands/specimen/shared.d.ts.map +1 -0
  185. package/dist/commands/specimen/shared.js +27 -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,43 @@
1
+ import { z } from 'zod';
2
+ import type { CommandDefinition } from '../registry.js';
3
+ /**
4
+ * Input schema for token.lineage command
5
+ */
6
+ declare const InputSchema: z.ZodObject<{
7
+ nodeId: z.ZodString;
8
+ tokenId: z.ZodString;
9
+ }, z.core.$strip>;
10
+ /**
11
+ * Output schema for token.lineage command
12
+ */
13
+ declare const OutputSchema: z.ZodObject<{
14
+ tokenId: z.ZodString;
15
+ currentValue: z.ZodAny;
16
+ resolvedAt: z.ZodString;
17
+ chain: z.ZodArray<z.ZodObject<{
18
+ nodeId: z.ZodString;
19
+ operation: z.ZodEnum<{
20
+ add: "add";
21
+ copy: "copy";
22
+ include: "include";
23
+ inherit: "inherit";
24
+ override: "override";
25
+ reset: "reset";
26
+ }>;
27
+ value: z.ZodOptional<z.ZodAny>;
28
+ fromNode: z.ZodOptional<z.ZodString>;
29
+ fromOwner: z.ZodOptional<z.ZodString>;
30
+ fromToken: z.ZodOptional<z.ZodString>;
31
+ tracksSource: z.ZodOptional<z.ZodBoolean>;
32
+ superseded: z.ZodOptional<z.ZodBoolean>;
33
+ }, z.core.$strip>>;
34
+ }, z.core.$strip>;
35
+ type Output = z.infer<typeof OutputSchema>;
36
+ /**
37
+ * token.lineage command
38
+ *
39
+ * Trace a token's value through the inheritance chain.
40
+ */
41
+ export declare const tokenLineageCommand: CommandDefinition<typeof InputSchema, Output>;
42
+ export {};
43
+ //# sourceMappingURL=lineage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../../src/commands/token/lineage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;GAEG;AACH,QAAA,MAAM,WAAW;;;iBAGf,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;iBAwBhB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,CAAC,OAAO,WAAW,EAAE,MAAM,CA0H7E,CAAC"}
@@ -0,0 +1,187 @@
1
+ import { InheritanceResolutionError, resolveInheritance } from '@lushly-dev/violet-core/engine';
2
+ import { z } from 'zod';
3
+ import { ErrorCodes, failure, success } from '../../types/command-result.js';
4
+ /**
5
+ * Input schema for token.lineage command
6
+ */
7
+ const InputSchema = z.object({
8
+ nodeId: z.string().min(1),
9
+ tokenId: z.string().min(1),
10
+ });
11
+ /**
12
+ * Output schema for token.lineage command
13
+ */
14
+ const OutputSchema = z.object({
15
+ tokenId: z.string(),
16
+ currentValue: z.any(),
17
+ resolvedAt: z.string(),
18
+ chain: z.array(z.object({
19
+ nodeId: z.string(),
20
+ operation: z.enum(['add', 'override', 'inherit', 'reset', 'copy', 'include']),
21
+ value: z.any().optional(),
22
+ /** Where the value came from: copy source, included node, or reset target */
23
+ fromNode: z.string().optional(),
24
+ /** Owner of `fromNode`, when it has one */
25
+ fromOwner: z.string().optional(),
26
+ /** Source token id, when a copy renamed it */
27
+ fromToken: z.string().optional(),
28
+ /**
29
+ * True when later changes at `fromNode` show up here. Copies, includes and
30
+ * resets are re-resolved from their source on every read, never snapshotted.
31
+ */
32
+ tracksSource: z.boolean().optional(),
33
+ /** True when a later step on the same node replaced this value */
34
+ superseded: z.boolean().optional(),
35
+ })),
36
+ });
37
+ /**
38
+ * token.lineage command
39
+ *
40
+ * Trace a token's value through the inheritance chain.
41
+ */
42
+ export const tokenLineageCommand = {
43
+ name: 'token.lineage',
44
+ description: "Trace a token's value through the inheritance chain",
45
+ category: 'token',
46
+ inputSchema: InputSchema,
47
+ outputSchema: OutputSchema,
48
+ async handler(rawInput, context) {
49
+ const { db } = context;
50
+ // Parse input to apply defaults
51
+ const input = InputSchema.parse(rawInput);
52
+ // Verify node exists
53
+ const node = await db.getNode(input.nodeId);
54
+ if (!node) {
55
+ return failure({
56
+ code: ErrorCodes.NODE_NOT_FOUND,
57
+ message: `Node '${input.nodeId}' not found`,
58
+ suggestion: `Use 'node.list' to see available nodes`,
59
+ });
60
+ }
61
+ if (node.deletedAt) {
62
+ return failure({
63
+ code: ErrorCodes.NODE_NOT_FOUND,
64
+ message: `Node '${input.nodeId}' has been deleted`,
65
+ });
66
+ }
67
+ // Build ancestry chain
68
+ const ancestryChain = await db.getAncestryChain(input.nodeId);
69
+ const fullChain = [...ancestryChain, input.nodeId];
70
+ // Resolve through the shared resolver (the same one tokens.resolve and export use)
71
+ // so lineage always agrees with them about overrides, resets, copies and includes.
72
+ let resolvedTokens;
73
+ try {
74
+ resolvedTokens = await resolveInheritance(db, input.nodeId, ancestryChain, true);
75
+ }
76
+ catch (error) {
77
+ if (error instanceof InheritanceResolutionError) {
78
+ return failure({
79
+ code: ErrorCodes.CIRCULAR_REFERENCE,
80
+ message: error.message,
81
+ suggestion: 'Remove the copy or include that creates the loop (see node.get) and trace again',
82
+ });
83
+ }
84
+ throw error;
85
+ }
86
+ const token = resolvedTokens.find((t) => t.id === input.tokenId);
87
+ if (!token) {
88
+ return failure({
89
+ code: ErrorCodes.TOKEN_NOT_FOUND,
90
+ message: `Token '${input.tokenId}' not found in node '${input.nodeId}' or its ancestors`,
91
+ suggestion: `Use 'tokens.resolve ${input.nodeId}' to see available tokens`,
92
+ }, {
93
+ sources: fullChain.map((id) => ({ type: 'node', id })),
94
+ });
95
+ }
96
+ // Walk the chain root -> target, listing what happened to the token at each node
97
+ const history = token.operationHistory ?? [];
98
+ const chain = [];
99
+ const owners = new Map();
100
+ const ownerOf = async (id) => {
101
+ if (!owners.has(id))
102
+ owners.set(id, (await db.getNode(id))?.owner);
103
+ return owners.get(id);
104
+ };
105
+ let seen = false;
106
+ for (const currentNodeId of fullChain) {
107
+ const entries = history.filter((h) => h.nodeId === currentNodeId);
108
+ if (entries.length === 0) {
109
+ if (seen) {
110
+ chain.push({ nodeId: currentNodeId, operation: 'inherit' });
111
+ }
112
+ continue;
113
+ }
114
+ seen = true;
115
+ for (const [index, entry] of entries.entries()) {
116
+ const link = await toLineageStep(entry, ownerOf);
117
+ // Only the last change on a node sticks; earlier ones are kept as history
118
+ if (index < entries.length - 1) {
119
+ link.superseded = true;
120
+ }
121
+ chain.push(link);
122
+ }
123
+ }
124
+ const currentValue = token.value;
125
+ const resolvedAt = token.resolvedAt;
126
+ return success({
127
+ tokenId: input.tokenId,
128
+ currentValue,
129
+ resolvedAt,
130
+ chain,
131
+ }, {
132
+ reasoning: `Token '${input.tokenId}' was set at '${resolvedAt}' and passed through ${chain.length} node(s)`,
133
+ sources: [
134
+ { type: 'node', id: input.nodeId, title: node.name },
135
+ { type: 'token', id: input.tokenId },
136
+ ],
137
+ });
138
+ },
139
+ examples: [
140
+ {
141
+ description: 'Trace accent color through Xbox hierarchy',
142
+ input: {
143
+ nodeId: 'xbox-ios-dark',
144
+ tokenId: 'color.accent.primary',
145
+ },
146
+ },
147
+ ],
148
+ };
149
+ /**
150
+ * One lineage step from a resolver history entry. Copies, includes and resets
151
+ * name the node their value comes from, and track it: the resolver reads that
152
+ * node's value again on every resolve rather than storing a snapshot.
153
+ */
154
+ async function toLineageStep(entry, ownerOf) {
155
+ const step = {
156
+ nodeId: entry.nodeId,
157
+ operation: toLineageOperation(entry.operation),
158
+ };
159
+ if (entry.value !== undefined) {
160
+ step.value = entry.value;
161
+ }
162
+ if (entry.fromNode) {
163
+ step.fromNode = entry.fromNode;
164
+ const owner = await ownerOf(entry.fromNode);
165
+ if (owner)
166
+ step.fromOwner = owner;
167
+ if (entry.fromToken)
168
+ step.fromToken = entry.fromToken;
169
+ step.tracksSource = true;
170
+ }
171
+ return step;
172
+ }
173
+ /** Map a resolver history operation to the lineage vocabulary. */
174
+ function toLineageOperation(operation) {
175
+ switch (operation) {
176
+ case 'add':
177
+ case 'override':
178
+ case 'reset':
179
+ case 'copy':
180
+ case 'include':
181
+ return operation;
182
+ default:
183
+ // 'subtract' and anything unknown: the token was inherited as-is at this node
184
+ return 'inherit';
185
+ }
186
+ }
187
+ //# sourceMappingURL=lineage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lineage.js","sourceRoot":"","sources":["../../../src/commands/token/lineage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,249 @@
1
+ import type { Node } from '@lushly-dev/violet-core/types';
2
+ import { z } from 'zod';
3
+ import type { CommandContext, CommandDefinition } from '../registry.js';
4
+ /**
5
+ * Upper bound on matrix columns. A matrix wider than this is not readable and
6
+ * the payload grows with nodes × tokens, so callers narrow with rootId/nodeIds.
7
+ */
8
+ export declare const MAX_MATRIX_NODES = 200;
9
+ /** Upper bound on rows per page (`limit`) */
10
+ export declare const MAX_MATRIX_PAGE_SIZE = 5000;
11
+ export declare const MatrixGroupBySchema: z.ZodEnum<{
12
+ category: "category";
13
+ tier: "tier";
14
+ }>;
15
+ export type MatrixGroupBy = z.infer<typeof MatrixGroupBySchema>;
16
+ /** Row order by token id; groups (with groupBy) always stay in ascending order */
17
+ export declare const MatrixSortSchema: z.ZodEnum<{
18
+ "token-asc": "token-asc";
19
+ "token-desc": "token-desc";
20
+ }>;
21
+ export type MatrixSort = z.infer<typeof MatrixSortSchema>;
22
+ /**
23
+ * How a token's value arrived at a node.
24
+ *
25
+ * - add / override / copy / reset / include: the last operation on this node that
26
+ * set the token
27
+ * - inherited: the value flows unchanged from an ancestor (or an ancestor's include)
28
+ * - subtracted: this node removed the token
29
+ * - absent: the token does not exist here (never defined in this chain, or removed
30
+ * by an ancestor, which is reported as `source`)
31
+ * - unresolved: the node could not be resolved (e.g. a copy/include cycle)
32
+ */
33
+ export declare const MatrixCellStateSchema: z.ZodEnum<{
34
+ absent: "absent";
35
+ add: "add";
36
+ copy: "copy";
37
+ include: "include";
38
+ inherited: "inherited";
39
+ override: "override";
40
+ reset: "reset";
41
+ subtracted: "subtracted";
42
+ unresolved: "unresolved";
43
+ }>;
44
+ export type MatrixCellState = z.infer<typeof MatrixCellStateSchema>;
45
+ /**
46
+ * Input schema for tokens.matrix command
47
+ */
48
+ declare const InputSchema: z.ZodObject<{
49
+ rootId: z.ZodOptional<z.ZodString>;
50
+ nodeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
51
+ filter: z.ZodOptional<z.ZodString>;
52
+ category: z.ZodOptional<z.ZodEnum<{
53
+ color: "color";
54
+ custom: "custom";
55
+ motion: "motion";
56
+ opacity: "opacity";
57
+ radius: "radius";
58
+ shadow: "shadow";
59
+ spacing: "spacing";
60
+ typography: "typography";
61
+ "z-index": "z-index";
62
+ }>>;
63
+ onlyVarying: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
64
+ onlyViolating: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
65
+ includeViolations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
66
+ groupBy: z.ZodOptional<z.ZodEnum<{
67
+ category: "category";
68
+ tier: "tier";
69
+ }>>;
70
+ sort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
71
+ "token-asc": "token-asc";
72
+ "token-desc": "token-desc";
73
+ }>>>;
74
+ summaryOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
75
+ limit: z.ZodOptional<z.ZodNumber>;
76
+ cursor: z.ZodOptional<z.ZodString>;
77
+ around: z.ZodOptional<z.ZodString>;
78
+ }, z.core.$strip>;
79
+ export declare const MatrixCellSchema: z.ZodObject<{
80
+ state: z.ZodEnum<{
81
+ absent: "absent";
82
+ add: "add";
83
+ copy: "copy";
84
+ include: "include";
85
+ inherited: "inherited";
86
+ override: "override";
87
+ reset: "reset";
88
+ subtracted: "subtracted";
89
+ unresolved: "unresolved";
90
+ }>;
91
+ value: z.ZodOptional<z.ZodAny>;
92
+ resolvedValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
93
+ aliasOf: z.ZodOptional<z.ZodString>;
94
+ referenceError: z.ZodOptional<z.ZodObject<{
95
+ code: z.ZodEnum<{
96
+ CIRCULAR_REFERENCE: "CIRCULAR_REFERENCE";
97
+ NOT_IMPLEMENTED: "NOT_IMPLEMENTED";
98
+ TOKEN_REFERENCE_NOT_FOUND: "TOKEN_REFERENCE_NOT_FOUND";
99
+ }>;
100
+ message: z.ZodString;
101
+ path: z.ZodArray<z.ZodString>;
102
+ }, z.core.$strip>>;
103
+ source: z.ZodNullable<z.ZodString>;
104
+ fromNode: z.ZodOptional<z.ZodString>;
105
+ violations: z.ZodOptional<z.ZodArray<z.ZodObject<{
106
+ constraintId: z.ZodString;
107
+ severity: z.ZodEnum<{
108
+ error: "error";
109
+ info: "info";
110
+ warning: "warning";
111
+ }>;
112
+ message: z.ZodString;
113
+ }, z.core.$strip>>>;
114
+ }, z.core.$strip>;
115
+ export type MatrixCell = z.infer<typeof MatrixCellSchema>;
116
+ /**
117
+ * Output schema for tokens.matrix command
118
+ */
119
+ declare const OutputSchema: z.ZodObject<{
120
+ nodes: z.ZodArray<z.ZodObject<{
121
+ id: z.ZodString;
122
+ name: z.ZodString;
123
+ type: z.ZodString;
124
+ status: z.ZodString;
125
+ parentId: z.ZodNullable<z.ZodString>;
126
+ depth: z.ZodNumber;
127
+ error: z.ZodOptional<z.ZodString>;
128
+ }, z.core.$strip>>;
129
+ tokens: z.ZodArray<z.ZodObject<{
130
+ id: z.ZodString;
131
+ category: z.ZodString;
132
+ tier: z.ZodString;
133
+ varies: z.ZodBoolean;
134
+ cells: z.ZodRecord<z.ZodString, z.ZodObject<{
135
+ state: z.ZodEnum<{
136
+ absent: "absent";
137
+ add: "add";
138
+ copy: "copy";
139
+ include: "include";
140
+ inherited: "inherited";
141
+ override: "override";
142
+ reset: "reset";
143
+ subtracted: "subtracted";
144
+ unresolved: "unresolved";
145
+ }>;
146
+ value: z.ZodOptional<z.ZodAny>;
147
+ resolvedValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
148
+ aliasOf: z.ZodOptional<z.ZodString>;
149
+ referenceError: z.ZodOptional<z.ZodObject<{
150
+ code: z.ZodEnum<{
151
+ CIRCULAR_REFERENCE: "CIRCULAR_REFERENCE";
152
+ NOT_IMPLEMENTED: "NOT_IMPLEMENTED";
153
+ TOKEN_REFERENCE_NOT_FOUND: "TOKEN_REFERENCE_NOT_FOUND";
154
+ }>;
155
+ message: z.ZodString;
156
+ path: z.ZodArray<z.ZodString>;
157
+ }, z.core.$strip>>;
158
+ source: z.ZodNullable<z.ZodString>;
159
+ fromNode: z.ZodOptional<z.ZodString>;
160
+ violations: z.ZodOptional<z.ZodArray<z.ZodObject<{
161
+ constraintId: z.ZodString;
162
+ severity: z.ZodEnum<{
163
+ error: "error";
164
+ info: "info";
165
+ warning: "warning";
166
+ }>;
167
+ message: z.ZodString;
168
+ }, z.core.$strip>>>;
169
+ }, z.core.$strip>>;
170
+ }, z.core.$strip>>;
171
+ summary: z.ZodObject<{
172
+ nodes: z.ZodNumber;
173
+ tokens: z.ZodNumber;
174
+ varyingTokens: z.ZodNumber;
175
+ states: z.ZodRecord<z.ZodString, z.ZodNumber>;
176
+ violations: z.ZodNumber;
177
+ }, z.core.$strip>;
178
+ groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
179
+ id: z.ZodString;
180
+ tokens: z.ZodNumber;
181
+ varyingTokens: z.ZodNumber;
182
+ violations: z.ZodNumber;
183
+ }, z.core.$strip>>>;
184
+ page: z.ZodOptional<z.ZodObject<{
185
+ limit: z.ZodNumber;
186
+ returned: z.ZodNumber;
187
+ offset: z.ZodNumber;
188
+ nextCursor: z.ZodNullable<z.ZodString>;
189
+ prevCursor: z.ZodNullable<z.ZodString>;
190
+ }, z.core.$strip>>;
191
+ }, z.core.$strip>;
192
+ type Output = z.infer<typeof OutputSchema>;
193
+ export type MatrixNode = Output['nodes'][number];
194
+ export type MatrixRow = Output['tokens'][number];
195
+ /**
196
+ * What every matching row needs for counting, filtering and ordering: one
197
+ * state per column (in `nodes` order), without values, so a page can be
198
+ * picked before any cell is described.
199
+ */
200
+ export interface MatrixRowCounts {
201
+ id: string;
202
+ category: string;
203
+ tier: string;
204
+ varies: boolean;
205
+ states: MatrixCellState[];
206
+ /** Violations across the row's cells */
207
+ violations: number;
208
+ }
209
+ /** A matrix whose rows are counted but not described; see countTokenMatrix */
210
+ export interface TokenMatrix {
211
+ nodes: MatrixNode[];
212
+ /** Every row, sorted by token id */
213
+ rows: MatrixRowCounts[];
214
+ /** Full rows for these token ids, in the given order; the same cells for any subset */
215
+ describe(tokenIds: readonly string[]): Promise<MatrixRow[]>;
216
+ }
217
+ /**
218
+ * Walk every column's chain and count each token × node cell. Shared by
219
+ * tokens.matrix and nodes.graph (token trace). Rows are sorted by token id;
220
+ * with `tokenIds`, exactly those tokens get a row.
221
+ *
222
+ * Counting a row needs only its states and whether its values differ, so
223
+ * references are followed per token and cells (values, sources, violations)
224
+ * are built by `describe`, for the rows a caller returns (#114).
225
+ */
226
+ export declare function countTokenMatrix(context: CommandContext, columns: Node[], options?: {
227
+ filter?: string;
228
+ category?: string;
229
+ tokenIds?: string[];
230
+ includeViolations?: boolean;
231
+ }): Promise<TokenMatrix>;
232
+ /**
233
+ * Every row of a matrix with its cells described, for callers that compare
234
+ * whole matrices (tokens.compare, changes.impact).
235
+ */
236
+ export declare function computeTokenMatrix(context: CommandContext, columns: Node[], options?: Parameters<typeof countTokenMatrix>[2]): Promise<{
237
+ nodes: MatrixNode[];
238
+ rows: MatrixRow[];
239
+ }>;
240
+ /**
241
+ * tokens.matrix command
242
+ *
243
+ * Resolve tokens across many nodes at once and report, for every token × node
244
+ * cell, the value and how it got there. Powers the Matrix view and answers
245
+ * "what is this token everywhere?" in one call.
246
+ */
247
+ export declare const tokensMatrixCommand: CommandDefinition<typeof InputSchema, Output>;
248
+ export {};
249
+ //# sourceMappingURL=matrix.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../../src/commands/token/matrix.ts"],"names":[],"mappings":"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"}