@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,201 @@
1
+ import { InheritanceResolutionError, matchesGlob, resolveInheritance, resolveValue, } from '@lushly-dev/violet-core/engine';
2
+ import { z } from 'zod';
3
+ // =============================================================================
4
+ // Input/Output Schemas
5
+ // =============================================================================
6
+ const InputSchema = z.object({
7
+ nodeId: z.string().min(1),
8
+ filter: z.string().optional(), // Token pattern filter
9
+ fromAncestor: z.string().optional(), // Compare against specific ancestor
10
+ });
11
+ const DeviationSchema = z.object({
12
+ tokenId: z.string(),
13
+ ancestorValue: z.union([z.string(), z.number()]),
14
+ localValue: z.union([z.string(), z.number()]),
15
+ operation: z.enum(['override', 'subtract']),
16
+ deviatedAt: z.string(), // Node where deviation occurred
17
+ });
18
+ const OutputSchema = z.object({
19
+ nodeId: z.string(),
20
+ comparedTo: z.string(),
21
+ deviations: z.array(DeviationSchema),
22
+ totalDeviations: z.number(),
23
+ breakdown: z.object({
24
+ overrides: z.number(),
25
+ subtractions: z.number(),
26
+ }),
27
+ });
28
+ // =============================================================================
29
+ // Handler
30
+ // =============================================================================
31
+ async function handler(rawInput, context) {
32
+ const input = InputSchema.parse(rawInput);
33
+ const { db } = context;
34
+ // Validate node exists
35
+ const node = await db.getNode(input.nodeId);
36
+ if (!node) {
37
+ return {
38
+ success: false,
39
+ error: {
40
+ code: 'NODE_NOT_FOUND',
41
+ message: `Node '${input.nodeId}' not found`,
42
+ suggestion: "Use 'violet node list' to see available nodes",
43
+ },
44
+ };
45
+ }
46
+ // Get ancestry chain
47
+ const ancestryChain = await db.getAncestryChain(input.nodeId);
48
+ if (ancestryChain.length === 0 && !node.parentId) {
49
+ // This is a root node with no ancestors to compare against
50
+ return {
51
+ success: true,
52
+ data: {
53
+ nodeId: input.nodeId,
54
+ comparedTo: input.nodeId,
55
+ deviations: [],
56
+ totalDeviations: 0,
57
+ breakdown: { overrides: 0, subtractions: 0 },
58
+ },
59
+ reasoning: 'Root node has no ancestors to deviate from',
60
+ };
61
+ }
62
+ // Determine which ancestor to compare against
63
+ const comparedTo = input.fromAncestor || ancestryChain[0] || node.parentId || input.nodeId;
64
+ // Validate the ancestor if specified
65
+ if (input.fromAncestor) {
66
+ const ancestor = await db.getNode(input.fromAncestor);
67
+ if (!ancestor) {
68
+ return {
69
+ success: false,
70
+ error: {
71
+ code: 'NODE_NOT_FOUND',
72
+ message: `Ancestor node '${input.fromAncestor}' not found`,
73
+ },
74
+ };
75
+ }
76
+ // Verify it's actually an ancestor
77
+ const fullAncestry = [...ancestryChain, node.parentId].filter(Boolean);
78
+ if (!fullAncestry.includes(input.fromAncestor)) {
79
+ return {
80
+ success: false,
81
+ error: {
82
+ code: 'INVALID_ANCESTOR',
83
+ message: `'${input.fromAncestor}' is not an ancestor of '${input.nodeId}'`,
84
+ suggestion: `Ancestors are: ${fullAncestry.join(', ')}`,
85
+ },
86
+ };
87
+ }
88
+ }
89
+ // Collect deviations by walking from ancestor to target node
90
+ const deviations = [];
91
+ // Get nodes in path from ancestor to target
92
+ const nodesToCheck = [];
93
+ let currentNodeId = input.nodeId;
94
+ // Walk up from target to comparedTo, collecting node IDs
95
+ while (currentNodeId && currentNodeId !== comparedTo) {
96
+ nodesToCheck.unshift(currentNodeId);
97
+ const currentNode = await db.getNode(currentNodeId);
98
+ currentNodeId = currentNode?.parentId || null;
99
+ }
100
+ // Build the baseline: the fully resolved tokens of the ancestor we compare against
101
+ // (its own ancestors first, then its own operations, includes, copies and resets).
102
+ // Using the shared resolver keeps the baseline identical to tokens.resolve(comparedTo)
103
+ // and guarantees closer ancestors win over farther ones.
104
+ const baselineTokens = new Map();
105
+ try {
106
+ const comparedAncestry = await db.getAncestryChain(comparedTo);
107
+ const baseline = await resolveInheritance(db, comparedTo, comparedAncestry, false);
108
+ for (const token of baseline) {
109
+ baselineTokens.set(token.id, token.resolvedValue);
110
+ }
111
+ }
112
+ catch (error) {
113
+ if (error instanceof InheritanceResolutionError) {
114
+ return {
115
+ success: false,
116
+ error: {
117
+ code: 'CIRCULAR_REFERENCE',
118
+ message: error.message,
119
+ suggestion: 'Remove the copy or include that creates the loop and analyze again',
120
+ },
121
+ };
122
+ }
123
+ throw error;
124
+ }
125
+ // Check each node in the path for deviations
126
+ for (const checkNodeId of nodesToCheck) {
127
+ const operations = await db.getOperations(checkNodeId);
128
+ for (const op of operations) {
129
+ // Apply filter if provided
130
+ if (input.filter && !matchesGlob(op.tokenId, input.filter)) {
131
+ continue;
132
+ }
133
+ if (op.type === 'override') {
134
+ const ancestorValue = baselineTokens.get(op.tokenId);
135
+ if (ancestorValue !== undefined) {
136
+ // op.value is a JSON string; parse it before computing the display value
137
+ const localValue = resolveValue(op.value ? JSON.parse(op.value) : null);
138
+ deviations.push({
139
+ tokenId: op.tokenId,
140
+ ancestorValue,
141
+ localValue,
142
+ operation: 'override',
143
+ deviatedAt: checkNodeId,
144
+ });
145
+ // Update baseline for subsequent checks
146
+ baselineTokens.set(op.tokenId, localValue);
147
+ }
148
+ }
149
+ else if (op.type === 'subtract') {
150
+ const ancestorValue = baselineTokens.get(op.tokenId);
151
+ if (ancestorValue !== undefined) {
152
+ deviations.push({
153
+ tokenId: op.tokenId,
154
+ ancestorValue,
155
+ localValue: '[subtracted]', // Mark as subtracted
156
+ operation: 'subtract',
157
+ deviatedAt: checkNodeId,
158
+ });
159
+ baselineTokens.delete(op.tokenId);
160
+ }
161
+ }
162
+ }
163
+ }
164
+ const overrides = deviations.filter((d) => d.operation === 'override').length;
165
+ const subtractions = deviations.filter((d) => d.operation === 'subtract').length;
166
+ return {
167
+ success: true,
168
+ data: {
169
+ nodeId: input.nodeId,
170
+ comparedTo,
171
+ deviations,
172
+ totalDeviations: deviations.length,
173
+ breakdown: { overrides, subtractions },
174
+ },
175
+ reasoning: deviations.length === 0
176
+ ? `No deviations from '${comparedTo}'`
177
+ : `Found ${deviations.length} deviations: ${overrides} overrides, ${subtractions} subtractions`,
178
+ };
179
+ }
180
+ // =============================================================================
181
+ // Command Definition
182
+ // =============================================================================
183
+ export const analyzeDeviationsCommand = {
184
+ name: 'analyze.deviations',
185
+ description: 'List tokens that deviate from ancestor values',
186
+ category: 'analyze',
187
+ inputSchema: InputSchema,
188
+ outputSchema: OutputSchema,
189
+ handler,
190
+ examples: [
191
+ {
192
+ description: 'Find all deviations',
193
+ input: { nodeId: 'xbox-ios' },
194
+ },
195
+ {
196
+ description: 'Find color deviations from specific ancestor',
197
+ input: { nodeId: 'xbox-ios', filter: 'color.*', fromAncestor: 'xbox' },
198
+ },
199
+ ],
200
+ };
201
+ //# sourceMappingURL=deviations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deviations.js","sourceRoot":"","sources":["../../../src/commands/analyze/deviations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,211 @@
1
+ import type { ResolvedToken } from '@lushly-dev/violet-core/types';
2
+ import { z } from 'zod';
3
+ import type { CommandDefinition } from '../registry.js';
4
+ /**
5
+ * Input schema for analyze.health command
6
+ */
7
+ declare const InputSchema: z.ZodObject<{
8
+ rootId: z.ZodOptional<z.ZodString>;
9
+ baseline: z.ZodDefault<z.ZodOptional<z.ZodString>>;
10
+ sort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
11
+ customizations: "customizations";
12
+ drift: "drift";
13
+ tree: "tree";
14
+ violations: "violations";
15
+ }>>>;
16
+ includeViolations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
17
+ }, z.core.$strip>;
18
+ /**
19
+ * A risk worth a look:
20
+ * - redundant-override: an override equal to the value the node already inherits
21
+ * - sibling-borrow: a copy from a node outside this node's own line (not an
22
+ * ancestor or descendant), so a change there silently changes this node
23
+ * - deprecated-with-children: a deprecated node that still has children
24
+ * - inert-reset: a stored reset that does nothing, because it is on a root or
25
+ * its target is not an ancestor of the node (see resetTarget)
26
+ * - sunset-without-replacement: a node with a sunset date but no replacement
27
+ * - replacement-deprecated: a node whose replacement is itself deprecated, or
28
+ * no longer exists
29
+ * - past-sunset: a node still in the tree after its sunset date
30
+ */
31
+ declare const HealthFlagSchema: z.ZodObject<{
32
+ kind: z.ZodEnum<{
33
+ "deprecated-with-children": "deprecated-with-children";
34
+ "inert-reset": "inert-reset";
35
+ "past-sunset": "past-sunset";
36
+ "redundant-override": "redundant-override";
37
+ "replacement-deprecated": "replacement-deprecated";
38
+ "sibling-borrow": "sibling-borrow";
39
+ "sunset-without-replacement": "sunset-without-replacement";
40
+ }>;
41
+ message: z.ZodString;
42
+ tokenId: z.ZodOptional<z.ZodString>;
43
+ value: z.ZodOptional<z.ZodAny>;
44
+ inheritedFrom: z.ZodOptional<z.ZodString>;
45
+ fromNode: z.ZodOptional<z.ZodString>;
46
+ toAncestor: z.ZodOptional<z.ZodString>;
47
+ children: z.ZodOptional<z.ZodArray<z.ZodString>>;
48
+ replacedBy: z.ZodOptional<z.ZodString>;
49
+ sunsetAt: z.ZodOptional<z.ZodString>;
50
+ }, z.core.$strip>;
51
+ /**
52
+ * A deprecated node's plan and what still depends on it: when it goes away,
53
+ * what replaces it, and its usage (descendants and borrowers in the report)
54
+ */
55
+ declare const DeprecationSchema: z.ZodObject<{
56
+ sunsetAt: z.ZodNullable<z.ZodString>;
57
+ daysLeft: z.ZodNullable<z.ZodNumber>;
58
+ replacedBy: z.ZodNullable<z.ZodString>;
59
+ replacementStatus: z.ZodNullable<z.ZodString>;
60
+ usage: z.ZodObject<{
61
+ descendants: z.ZodNumber;
62
+ borrowers: z.ZodNumber;
63
+ }, z.core.$strip>;
64
+ }, z.core.$strip>;
65
+ /**
66
+ * Output schema for analyze.health command
67
+ */
68
+ declare const OutputSchema: z.ZodObject<{
69
+ baseline: z.ZodString;
70
+ sort: z.ZodString;
71
+ nodes: z.ZodArray<z.ZodObject<{
72
+ id: z.ZodString;
73
+ name: z.ZodString;
74
+ type: z.ZodString;
75
+ status: z.ZodString;
76
+ parentId: z.ZodNullable<z.ZodString>;
77
+ depth: z.ZodNumber;
78
+ owner: z.ZodOptional<z.ZodString>;
79
+ deprecation: z.ZodOptional<z.ZodObject<{
80
+ sunsetAt: z.ZodNullable<z.ZodString>;
81
+ daysLeft: z.ZodNullable<z.ZodNumber>;
82
+ replacedBy: z.ZodNullable<z.ZodString>;
83
+ replacementStatus: z.ZodNullable<z.ZodString>;
84
+ usage: z.ZodObject<{
85
+ descendants: z.ZodNumber;
86
+ borrowers: z.ZodNumber;
87
+ }, z.core.$strip>;
88
+ }, z.core.$strip>>;
89
+ tokens: z.ZodNumber;
90
+ customizations: z.ZodObject<{
91
+ total: z.ZodNumber;
92
+ add: z.ZodNumber;
93
+ override: z.ZodNumber;
94
+ subtract: z.ZodNumber;
95
+ reset: z.ZodNumber;
96
+ copy: z.ZodNumber;
97
+ byCategory: z.ZodRecord<z.ZodString, z.ZodNumber>;
98
+ }, z.core.$strip>;
99
+ drift: z.ZodObject<{
100
+ baseline: z.ZodNullable<z.ZodString>;
101
+ compared: z.ZodNumber;
102
+ changed: z.ZodNumber;
103
+ added: z.ZodNumber;
104
+ removed: z.ZodNumber;
105
+ ratio: z.ZodNumber;
106
+ }, z.core.$strip>;
107
+ violations: z.ZodOptional<z.ZodObject<{
108
+ total: z.ZodNumber;
109
+ error: z.ZodNumber;
110
+ warning: z.ZodNumber;
111
+ info: z.ZodNumber;
112
+ }, z.core.$strip>>;
113
+ coupling: z.ZodObject<{
114
+ includes: z.ZodArray<z.ZodString>;
115
+ borrows: z.ZodArray<z.ZodObject<{
116
+ fromNode: z.ZodString;
117
+ relation: z.ZodEnum<{
118
+ ancestor: "ancestor";
119
+ descendant: "descendant";
120
+ sibling: "sibling";
121
+ }>;
122
+ tokens: z.ZodArray<z.ZodString>;
123
+ }, z.core.$strip>>;
124
+ borrowedBy: z.ZodArray<z.ZodString>;
125
+ }, z.core.$strip>;
126
+ flags: z.ZodArray<z.ZodObject<{
127
+ kind: z.ZodEnum<{
128
+ "deprecated-with-children": "deprecated-with-children";
129
+ "inert-reset": "inert-reset";
130
+ "past-sunset": "past-sunset";
131
+ "redundant-override": "redundant-override";
132
+ "replacement-deprecated": "replacement-deprecated";
133
+ "sibling-borrow": "sibling-borrow";
134
+ "sunset-without-replacement": "sunset-without-replacement";
135
+ }>;
136
+ message: z.ZodString;
137
+ tokenId: z.ZodOptional<z.ZodString>;
138
+ value: z.ZodOptional<z.ZodAny>;
139
+ inheritedFrom: z.ZodOptional<z.ZodString>;
140
+ fromNode: z.ZodOptional<z.ZodString>;
141
+ toAncestor: z.ZodOptional<z.ZodString>;
142
+ children: z.ZodOptional<z.ZodArray<z.ZodString>>;
143
+ replacedBy: z.ZodOptional<z.ZodString>;
144
+ sunsetAt: z.ZodOptional<z.ZodString>;
145
+ }, z.core.$strip>>;
146
+ subtree: z.ZodObject<{
147
+ nodes: z.ZodNumber;
148
+ customizations: z.ZodNumber;
149
+ violations: z.ZodNumber;
150
+ maxDrift: z.ZodNumber;
151
+ }, z.core.$strip>;
152
+ error: z.ZodOptional<z.ZodString>;
153
+ }, z.core.$strip>>;
154
+ summary: z.ZodObject<{
155
+ nodes: z.ZodNumber;
156
+ customizations: z.ZodNumber;
157
+ violations: z.ZodOptional<z.ZodObject<{
158
+ total: z.ZodNumber;
159
+ error: z.ZodNumber;
160
+ warning: z.ZodNumber;
161
+ info: z.ZodNumber;
162
+ }, z.core.$strip>>;
163
+ flags: z.ZodObject<{
164
+ redundantOverrides: z.ZodNumber;
165
+ siblingBorrows: z.ZodNumber;
166
+ deprecatedWithChildren: z.ZodNumber;
167
+ inertResets: z.ZodNumber;
168
+ sunsetWithoutReplacement: z.ZodNumber;
169
+ replacementDeprecated: z.ZodNumber;
170
+ pastSunset: z.ZodNumber;
171
+ }, z.core.$strip>;
172
+ sunsets: z.ZodArray<z.ZodObject<{
173
+ id: z.ZodString;
174
+ sunsetAt: z.ZodString;
175
+ daysLeft: z.ZodNumber;
176
+ replacedBy: z.ZodNullable<z.ZodString>;
177
+ descendants: z.ZodNumber;
178
+ borrowers: z.ZodNumber;
179
+ }, z.core.$strip>>;
180
+ flagged: z.ZodNumber;
181
+ owners: z.ZodArray<z.ZodObject<{
182
+ owner: z.ZodNullable<z.ZodString>;
183
+ nodes: z.ZodNumber;
184
+ customizations: z.ZodNumber;
185
+ violations: z.ZodNumber;
186
+ }, z.core.$strip>>;
187
+ unresolved: z.ZodArray<z.ZodString>;
188
+ }, z.core.$strip>;
189
+ }, z.core.$strip>;
190
+ type Output = z.infer<typeof OutputSchema>;
191
+ export type HealthNode = Output['nodes'][number];
192
+ export type HealthFlag = z.infer<typeof HealthFlagSchema>;
193
+ export type HealthDeprecation = z.infer<typeof DeprecationSchema>;
194
+ type TokenMap = Map<string, ResolvedToken>;
195
+ /** Tokens that differ between a node and its baseline */
196
+ export declare function compareTokenMaps(tokens: TokenMap, baseline: TokenMap): Omit<HealthNode['drift'], 'baseline'>;
197
+ /**
198
+ * analyze.health command
199
+ *
200
+ * One report for "which products drift most, where do violations cluster, who
201
+ * owns what, and which links are risky": per node, its own customizations by
202
+ * category, drift against a baseline, violations by severity, owner, status and
203
+ * coupling (mix-ins and copies), with flags for redundant overrides, sibling
204
+ * borrows and deprecated nodes that still have children, and totals for each
205
+ * node's subtree. Deprecated nodes also report their plan (sunset date and
206
+ * replacement) and usage, with flags for a date without a replacement, a
207
+ * replacement that is deprecated or gone, and a node kept past its sunset.
208
+ */
209
+ export declare const analyzeHealthCommand: CommandDefinition<typeof InputSchema, Output>;
210
+ export {};
211
+ //# sourceMappingURL=health.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze/health.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAyB,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxE;;GAEG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;iBAWf,CAAC;AASH;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;iBAwBpB,CAAC;AAEH;;;GAGG;AACH,QAAA,MAAM,iBAAiB;;;;;;;;;iBAcrB,CAAC;AAmEH;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0ChB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC3C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,KAAK,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAW3C,yDAAyD;AACzD,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,QAAQ,GAChB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAqBvC;AAkbD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,CAAC,OAAO,WAAW,EAAE,MAAM,CA2F9E,CAAC"}