@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,229 @@
1
+ import { findDependencyPath } from '@lushly-dev/violet-core/engine';
2
+ import { NodeSchema, UpdateNodeInputSchema } from '@lushly-dev/violet-core/types';
3
+ import { nanoid } from 'nanoid';
4
+ import { z } from 'zod';
5
+ import { ErrorCodes, failure, success } from '../../types/command-result.js';
6
+ import { checkDeprecationPlan } from './deprecation.js';
7
+ /**
8
+ * Input schema for node.update command
9
+ */
10
+ const InputSchema = z.object({
11
+ id: z.string().min(1),
12
+ updates: UpdateNodeInputSchema,
13
+ });
14
+ /**
15
+ * Output schema for node.update command
16
+ */
17
+ const OutputSchema = z.object({
18
+ node: NodeSchema,
19
+ changedFields: z.array(z.string()),
20
+ });
21
+ /**
22
+ * node.update command
23
+ *
24
+ * Update a node's properties.
25
+ */
26
+ export const nodeUpdateCommand = {
27
+ name: 'node.update',
28
+ description: 'Update a node in the design system tree',
29
+ category: 'node',
30
+ inputSchema: InputSchema,
31
+ outputSchema: OutputSchema,
32
+ async handler(rawInput, context) {
33
+ const { db, actor } = context;
34
+ // Parse input to apply defaults
35
+ const input = InputSchema.parse(rawInput);
36
+ const node = await db.getNode(input.id);
37
+ if (!node) {
38
+ return failure({
39
+ code: ErrorCodes.NODE_NOT_FOUND,
40
+ message: `Node '${input.id}' not found`,
41
+ suggestion: `Use 'node.list' to see available nodes`,
42
+ });
43
+ }
44
+ if (node.deletedAt) {
45
+ return failure({
46
+ code: ErrorCodes.NODE_NOT_FOUND,
47
+ message: `Node '${input.id}' has been deleted`,
48
+ suggestion: 'Deleted nodes cannot be updated. Contact an admin to restore.',
49
+ });
50
+ }
51
+ // Validate includes if being updated
52
+ if (input.updates.includes) {
53
+ for (const includeId of input.updates.includes) {
54
+ // Prevent self-reference
55
+ if (includeId === input.id) {
56
+ return failure({
57
+ code: ErrorCodes.CIRCULAR_REFERENCE,
58
+ message: 'Node cannot include itself',
59
+ suggestion: `Remove '${input.id}' from the includes list`,
60
+ });
61
+ }
62
+ const includeNode = await db.getNode(includeId);
63
+ if (!includeNode) {
64
+ return failure({
65
+ code: ErrorCodes.NODE_NOT_FOUND,
66
+ message: `Include node '${includeId}' not found`,
67
+ suggestion: 'Make sure all include nodes exist',
68
+ });
69
+ }
70
+ // Check for circular reference. Resolving a node depends on its parent
71
+ // chain, its includes, and its copy sources, so the include would be
72
+ // circular if input.id is reachable from includeId through ANY of those
73
+ // edges (e.g. a parent including its own descendant).
74
+ const cyclePath = await findDependencyPath(db, includeId, input.id);
75
+ if (cyclePath) {
76
+ return failure({
77
+ code: ErrorCodes.CIRCULAR_REFERENCE,
78
+ message: `Including '${includeId}' would create a circular reference`,
79
+ suggestion: `'${includeId}' already depends on '${input.id}' (${cyclePath.join(' -> ')}) through parent, include, or copy relationships`,
80
+ });
81
+ }
82
+ }
83
+ }
84
+ // The plan the node will have, so a write that leaves it alone still warns about it
85
+ const plan = await checkDeprecationPlan(db, input.id, {
86
+ sunsetAt: input.updates.sunsetAt === undefined ? node.sunsetAt : input.updates.sunsetAt,
87
+ replacedBy: input.updates.replacedBy === undefined ? node.replacedBy : input.updates.replacedBy,
88
+ });
89
+ if ('error' in plan)
90
+ return failure(plan.error);
91
+ const warnings = [...plan.warnings];
92
+ // Track what changed
93
+ const changedFields = [];
94
+ const oldNode = { ...node };
95
+ // Apply updates
96
+ const now = new Date().toISOString();
97
+ const updates = {
98
+ updatedAt: now,
99
+ };
100
+ if (input.updates.name !== undefined && input.updates.name !== node.name) {
101
+ updates.name = input.updates.name;
102
+ changedFields.push('name');
103
+ }
104
+ if (input.updates.type !== undefined && input.updates.type !== node.type) {
105
+ updates.type = input.updates.type;
106
+ changedFields.push('type');
107
+ }
108
+ if (input.updates.owner !== undefined && input.updates.owner !== node.owner) {
109
+ updates.owner = input.updates.owner;
110
+ changedFields.push('owner');
111
+ }
112
+ if (input.updates.status !== undefined && input.updates.status !== node.status) {
113
+ updates.status = input.updates.status;
114
+ changedFields.push('status');
115
+ }
116
+ if (input.updates.sunsetAt !== undefined &&
117
+ input.updates.sunsetAt !== (node.sunsetAt ?? null)) {
118
+ updates.sunsetAt = input.updates.sunsetAt;
119
+ changedFields.push('sunsetAt');
120
+ }
121
+ if (input.updates.replacedBy !== undefined &&
122
+ input.updates.replacedBy !== (node.replacedBy ?? null)) {
123
+ updates.replacedBy = input.updates.replacedBy;
124
+ changedFields.push('replacedBy');
125
+ }
126
+ if (input.updates.includes !== undefined &&
127
+ JSON.stringify(input.updates.includes) !== JSON.stringify(node.includes)) {
128
+ updates.includes = input.updates.includes;
129
+ changedFields.push('includes');
130
+ }
131
+ if (input.updates.includePolicy !== undefined &&
132
+ input.updates.includePolicy !== node.includePolicy) {
133
+ updates.includePolicy = input.updates.includePolicy;
134
+ changedFields.push('includePolicy');
135
+ }
136
+ if (input.updates.tags !== undefined &&
137
+ JSON.stringify(input.updates.tags) !== JSON.stringify(node.tags)) {
138
+ updates.tags = input.updates.tags;
139
+ changedFields.push('tags');
140
+ }
141
+ if (changedFields.length === 0) {
142
+ return success({ node, changedFields: [] }, {
143
+ reasoning: 'No changes detected',
144
+ ...(warnings.length > 0 ? { warnings } : {}),
145
+ });
146
+ }
147
+ // Deprecating a node other nodes name as their replacement leaves them pointing at it
148
+ if (updates.status === 'deprecated') {
149
+ const replaced = (await db.listNodes())
150
+ .filter((other) => other.replacedBy === input.id && !other.deletedAt)
151
+ .map((other) => other.id);
152
+ if (replaced.length > 0) {
153
+ warnings.push({
154
+ code: 'REPLACEMENT_DEPRECATED',
155
+ message: `'${input.id}' is the replacement for ${replaced.join(', ')}, and is now deprecated itself`,
156
+ severity: 'warning',
157
+ details: { replaces: replaced },
158
+ });
159
+ }
160
+ }
161
+ await db.updateNode(input.id, updates);
162
+ // Get updated node
163
+ const updatedNode = await db.getNode(input.id);
164
+ if (!updatedNode) {
165
+ return failure({
166
+ code: ErrorCodes.INTERNAL_ERROR,
167
+ message: 'Failed to retrieve updated node',
168
+ });
169
+ }
170
+ // Log audit event
171
+ await db.addAuditEvent({
172
+ id: nanoid(),
173
+ timestamp: now,
174
+ eventType: 'node_updated',
175
+ actor: actor || 'system',
176
+ targetNode: input.id,
177
+ targetToken: null,
178
+ oldValue: JSON.stringify(oldNode),
179
+ newValue: JSON.stringify(updatedNode),
180
+ metadata: JSON.stringify({ changedFields }),
181
+ });
182
+ return success({ node: updatedNode, changedFields }, {
183
+ reasoning: `Updated ${changedFields.length} field(s): ${changedFields.join(', ')}`,
184
+ sources: [{ type: 'node', id: updatedNode.id, title: updatedNode.name }],
185
+ ...(warnings.length > 0 ? { warnings } : {}),
186
+ });
187
+ },
188
+ examples: [
189
+ {
190
+ description: 'Update node name',
191
+ input: {
192
+ id: 'xbox',
193
+ updates: {
194
+ name: 'Xbox Gaming',
195
+ },
196
+ },
197
+ },
198
+ {
199
+ description: 'Update node status',
200
+ input: {
201
+ id: 'old-product',
202
+ updates: {
203
+ status: 'deprecated',
204
+ },
205
+ },
206
+ },
207
+ {
208
+ description: 'Plan a deprecated node: the day it goes away and what replaces it',
209
+ input: {
210
+ id: 'old-product',
211
+ updates: {
212
+ status: 'deprecated',
213
+ sunsetAt: '2027-03-31',
214
+ replacedBy: 'new-product',
215
+ },
216
+ },
217
+ },
218
+ {
219
+ description: 'Add includes to a node',
220
+ input: {
221
+ id: 'my-app',
222
+ updates: {
223
+ includes: ['accessibility-enhanced', 'motion-reduced'],
224
+ },
225
+ },
226
+ },
227
+ ],
228
+ };
229
+ //# sourceMappingURL=update.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/node/update.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ import type { Database, ResolutionCache } from '@lushly-dev/violet-core';
2
+ import type { z } from 'zod';
3
+ import type { CommandResult } from '../types/command-result.js';
4
+ import { type JsonSchema } from './json-schema.js';
5
+ /**
6
+ * Command definition with typed input/output schemas
7
+ *
8
+ * TSchema: The Zod schema type
9
+ * TOutput: The output type returned by the handler
10
+ *
11
+ * This uses Zod's built-in type inference to properly handle input vs output types:
12
+ * - z.input<TSchema>: What callers provide (with optional fields)
13
+ * - z.output<TSchema>: What handlers receive (after defaults applied)
14
+ */
15
+ export interface CommandDefinition<TSchema extends z.ZodType, TOutput> {
16
+ /** Unique command name (e.g., 'node.create') */
17
+ name: string;
18
+ /** Human-readable description */
19
+ description: string;
20
+ /** Category for grouping commands */
21
+ category: 'node' | 'token' | 'export' | 'import' | 'analyze' | 'constraint' | 'system' | 'webhook' | 'audit' | 'specimen';
22
+ /** Zod schema for input validation */
23
+ inputSchema: TSchema;
24
+ /** Zod schema for output type (for documentation) */
25
+ outputSchema: z.ZodType<TOutput, unknown>;
26
+ /**
27
+ * The command handler
28
+ * - Accepts z.input<TSchema> (what callers provide - optional fields allowed)
29
+ * - Internally parses to z.output<TSchema> (with defaults applied)
30
+ */
31
+ handler: (input: z.input<TSchema>, context: CommandContext) => Promise<CommandResult<TOutput>>;
32
+ /** Examples for documentation - uses input type (optional fields allowed) */
33
+ examples?: Array<{
34
+ description: string;
35
+ input: z.input<TSchema>;
36
+ }>;
37
+ }
38
+ /**
39
+ * Context passed to command handlers
40
+ */
41
+ export interface CommandContext {
42
+ /** Database instance */
43
+ db: Database;
44
+ /** Current actor (user/system) */
45
+ actor?: string;
46
+ /** Trace ID for logging */
47
+ traceId?: string;
48
+ /**
49
+ * Store reads and resolved chains shared by the resolutions of one read-only
50
+ * command execution. Set by withResolutionCache on a context made for that
51
+ * execution; never set it on a context that outlives it or sees writes.
52
+ */
53
+ resolutionCache?: ResolutionCache;
54
+ }
55
+ /**
56
+ * Database interface (implemented by storage layer). Native: @lushly-dev/violet-core.
57
+ */
58
+ export type { Database } from '@lushly-dev/violet-core';
59
+ /**
60
+ * Command Registry
61
+ *
62
+ * Central registry for all Violet commands. Supports:
63
+ * - Auto-discovery of commands
64
+ * - Schema-based validation
65
+ * - Help/documentation generation
66
+ */
67
+ export declare class CommandRegistry {
68
+ private commands;
69
+ /**
70
+ * Register a command
71
+ */
72
+ register<TSchema extends z.ZodType, TOutput>(command: CommandDefinition<TSchema, TOutput>): void;
73
+ /**
74
+ * Get a command by name
75
+ */
76
+ get<TSchema extends z.ZodType, TOutput>(name: string): CommandDefinition<TSchema, TOutput> | undefined;
77
+ /**
78
+ * List all registered commands
79
+ */
80
+ list(): Array<{
81
+ name: string;
82
+ description: string;
83
+ category: string;
84
+ }>;
85
+ /**
86
+ * List commands by category
87
+ */
88
+ listByCategory(category: string): Array<{
89
+ name: string;
90
+ description: string;
91
+ }>;
92
+ /**
93
+ * Get input schema for a command (for documentation/validation)
94
+ */
95
+ getInputSchema(name: string): z.ZodType | undefined;
96
+ /**
97
+ * Get a command's input schema as JSON Schema (the form MCP, the CLI and
98
+ * the generated docs show), or undefined for an unknown command
99
+ */
100
+ getInputJsonSchema(name: string): JsonSchema | undefined;
101
+ /**
102
+ * Execute a command with validation
103
+ */
104
+ execute<TInput, TOutput>(name: string, input: TInput, context: CommandContext): Promise<CommandResult<TOutput>>;
105
+ /**
106
+ * Generate documentation for all commands
107
+ */
108
+ generateDocs(): string;
109
+ }
110
+ /**
111
+ * Global command registry instance
112
+ */
113
+ export declare const registry: CommandRegistry;
114
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,141 @@
1
+ import { toJsonSchema } from './json-schema.js';
2
+ /**
3
+ * Command Registry
4
+ *
5
+ * Central registry for all Violet commands. Supports:
6
+ * - Auto-discovery of commands
7
+ * - Schema-based validation
8
+ * - Help/documentation generation
9
+ */
10
+ export class CommandRegistry {
11
+ commands = new Map();
12
+ /**
13
+ * Register a command
14
+ */
15
+ register(command) {
16
+ if (this.commands.has(command.name)) {
17
+ throw new Error(`Command '${command.name}' is already registered`);
18
+ }
19
+ this.commands.set(command.name, command);
20
+ }
21
+ /**
22
+ * Get a command by name
23
+ */
24
+ get(name) {
25
+ return this.commands.get(name);
26
+ }
27
+ /**
28
+ * List all registered commands
29
+ */
30
+ list() {
31
+ return Array.from(this.commands.values()).map((cmd) => ({
32
+ name: cmd.name,
33
+ description: cmd.description,
34
+ category: cmd.category,
35
+ }));
36
+ }
37
+ /**
38
+ * List commands by category
39
+ */
40
+ listByCategory(category) {
41
+ return Array.from(this.commands.values())
42
+ .filter((cmd) => cmd.category === category)
43
+ .map((cmd) => ({
44
+ name: cmd.name,
45
+ description: cmd.description,
46
+ }));
47
+ }
48
+ /**
49
+ * Get input schema for a command (for documentation/validation)
50
+ */
51
+ getInputSchema(name) {
52
+ return this.commands.get(name)?.inputSchema;
53
+ }
54
+ /**
55
+ * Get a command's input schema as JSON Schema (the form MCP, the CLI and
56
+ * the generated docs show), or undefined for an unknown command
57
+ */
58
+ getInputJsonSchema(name) {
59
+ const schema = this.commands.get(name)?.inputSchema;
60
+ return schema ? toJsonSchema(schema) : undefined;
61
+ }
62
+ /**
63
+ * Execute a command with validation
64
+ */
65
+ async execute(name, input, context) {
66
+ const command = this.commands.get(name);
67
+ if (!command) {
68
+ return {
69
+ success: false,
70
+ error: {
71
+ code: 'COMMAND_NOT_FOUND',
72
+ message: `Command '${name}' not found`,
73
+ suggestion: `Use 'violet --help' to see available commands`,
74
+ },
75
+ };
76
+ }
77
+ // Validate input
78
+ const validation = command.inputSchema.safeParse(input);
79
+ if (!validation.success) {
80
+ return {
81
+ success: false,
82
+ error: {
83
+ code: 'VALIDATION_ERROR',
84
+ message: `Invalid input: ${validation.error.message}`,
85
+ suggestion: `Check the command schema with 'violet call ${name} --schema'`,
86
+ },
87
+ };
88
+ }
89
+ // Execute handler
90
+ const startTime = Date.now();
91
+ try {
92
+ const result = await command.handler(validation.data, context);
93
+ return {
94
+ ...result,
95
+ metadata: {
96
+ ...result.metadata,
97
+ executionTimeMs: Date.now() - startTime,
98
+ traceId: context.traceId,
99
+ },
100
+ };
101
+ }
102
+ catch (error) {
103
+ return {
104
+ success: false,
105
+ error: {
106
+ code: 'INTERNAL_ERROR',
107
+ message: error instanceof Error ? error.message : 'Unknown error',
108
+ retryable: false,
109
+ },
110
+ metadata: {
111
+ executionTimeMs: Date.now() - startTime,
112
+ traceId: context.traceId,
113
+ },
114
+ };
115
+ }
116
+ }
117
+ /**
118
+ * Generate documentation for all commands
119
+ */
120
+ generateDocs() {
121
+ const categories = new Map();
122
+ for (const cmd of this.commands.values()) {
123
+ const category = categories.get(cmd.category) || [];
124
+ category.push({ name: cmd.name, description: cmd.description });
125
+ categories.set(cmd.category, category);
126
+ }
127
+ let docs = '# Violet Design Commands\n\n';
128
+ for (const [category, commands] of categories) {
129
+ docs += `## ${category}\n\n`;
130
+ for (const cmd of commands) {
131
+ docs += `### \`${cmd.name}\`\n\n${cmd.description}\n\n`;
132
+ }
133
+ }
134
+ return docs;
135
+ }
136
+ }
137
+ /**
138
+ * Global command registry instance
139
+ */
140
+ export const registry = new CommandRegistry();
141
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,46 @@
1
+ import { z } from 'zod';
2
+ import type { CommandDefinition } from '../registry.js';
3
+ /**
4
+ * Input schema for specimen.get command
5
+ */
6
+ declare const InputSchema: z.ZodObject<{
7
+ nodeId: z.ZodString;
8
+ }, z.core.$strip>;
9
+ /**
10
+ * Output schema for specimen.get command
11
+ */
12
+ declare const OutputSchema: z.ZodObject<{
13
+ nodeId: z.ZodString;
14
+ rootId: z.ZodString;
15
+ map: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
16
+ stored: z.ZodBoolean;
17
+ updatedAt: z.ZodNullable<z.ZodString>;
18
+ updatedBy: z.ZodNullable<z.ZodString>;
19
+ components: z.ZodArray<z.ZodObject<{
20
+ component: z.ZodString;
21
+ label: z.ZodString;
22
+ drawn: z.ZodBoolean;
23
+ roles: z.ZodArray<z.ZodObject<{
24
+ role: z.ZodString;
25
+ tokenId: z.ZodString;
26
+ source: z.ZodEnum<{
27
+ convention: "convention";
28
+ map: "map";
29
+ }>;
30
+ resolves: z.ZodBoolean;
31
+ valid: z.ZodBoolean;
32
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
33
+ }, z.core.$strip>>;
34
+ }, z.core.$strip>>;
35
+ }, z.core.$strip>;
36
+ type Output = z.infer<typeof OutputSchema>;
37
+ /**
38
+ * specimen.get command
39
+ *
40
+ * The specimen role map of a node's tree (#118) and, for each component the
41
+ * Specimens view draws, which token draws each role on the node, whether it
42
+ * resolves there, and whether its value passes the role's CSS validator.
43
+ */
44
+ export declare const specimenGetCommand: CommandDefinition<typeof InputSchema, Output>;
45
+ export {};
46
+ //# sourceMappingURL=get.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/specimen/get.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxE;;GAEG;AACH,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAgBH;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;iBAmBhB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,CAAC,OAAO,WAAW,EAAE,MAAM,CA4E5E,CAAC"}