@gregiteen/ssss-cli 0.14.1 → 0.14.3

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 (33) hide show
  1. package/CHANGELOG.md +43 -0
  2. package/README.md +19 -11
  3. package/VERSION +1 -1
  4. package/conformance/reference-bundle.ucw.json +19 -32
  5. package/docs/help/bundle.md +1 -1
  6. package/docs/help/overview.md +5 -8
  7. package/docs/help/schema.md +40 -0
  8. package/docs/ssss-spec.md +6 -3
  9. package/package.json +8 -1
  10. package/registry/core.json +2 -2
  11. package/schemas/bundle.schema.json +300 -0
  12. package/schemas/core-registry.schema.json +553 -0
  13. package/scripts/build-reference-bundle.mjs +9 -10
  14. package/scripts/check-commit-durability.mjs +1 -0
  15. package/scripts/check-docs-parity.mjs +38 -0
  16. package/scripts/cmd-new.mjs +79 -18
  17. package/scripts/cmd-schema.mjs +152 -0
  18. package/scripts/conformance-09.mjs +41 -0
  19. package/scripts/conformance.mjs +40 -2
  20. package/scripts/ssss.mjs +2 -0
  21. package/scripts/sync-docs.mjs +56 -0
  22. package/skills/ssss/SKILL.md +1 -1
  23. package/skills/ssss/core/SKILL.md +2 -2
  24. package/skills/ssss/core/references/core-registry.json +2 -2
  25. package/skills/ssss/core/references/ssss-spec.md +6 -3
  26. package/src/bundle.mjs +1 -0
  27. package/src/registry.mjs +9 -2
  28. package/src/schema-validator.mjs +315 -0
  29. package/types/kernel.d.ts +1 -0
  30. package/types/schema-validator.d.ts +24 -0
  31. package/registry/extensions/defaults.json +0 -5
  32. package/registry/extensions/festech.json +0 -1115
  33. package/registry/extensions/field-crm.json +0 -1018
package/schemas/bundle.schema.json ADDED
@@ -0,0 +1,300 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://ssss.dev/schemas/bundle.schema.json",
4
+ "title": "SSSS Universal Cloud Workspace (.ucw) Bundle Schema",
5
+ "description": "JSON Schema for SSSS transport bundles and manifests (spec §16).",
6
+ "type": "object",
7
+ "required": [
8
+ "manifest",
9
+ "files"
10
+ ],
11
+ "additionalProperties": false,
12
+ "properties": {
13
+ "$schema": {
14
+ "type": "string",
15
+ "minLength": 1
16
+ },
17
+ "manifest": {
18
+ "$ref": "#/$defs/bundleManifest"
19
+ },
20
+ "files": {
21
+ "type": "array",
22
+ "items": {
23
+ "$ref": "#/$defs/bundleFile"
24
+ }
25
+ },
26
+ "branding": {
27
+ "type": "object"
28
+ }
29
+ },
30
+ "$defs": {
31
+ "bundleFile": {
32
+ "type": "object",
33
+ "required": [
34
+ "path",
35
+ "content"
36
+ ],
37
+ "additionalProperties": false,
38
+ "properties": {
39
+ "path": {
40
+ "type": "string",
41
+ "minLength": 1
42
+ },
43
+ "content": {
44
+ "type": "string"
45
+ }
46
+ }
47
+ },
48
+ "bundleManifest": {
49
+ "type": "object",
50
+ "required": [
51
+ "name",
52
+ "description",
53
+ "version",
54
+ "exported_at",
55
+ "ssss_core_version",
56
+ "required_extensions",
57
+ "export_profile",
58
+ "primitive_inventory",
59
+ "provisioning",
60
+ "file_count",
61
+ "provenance"
62
+ ],
63
+ "additionalProperties": false,
64
+ "properties": {
65
+ "name": {
66
+ "type": "string",
67
+ "minLength": 1
68
+ },
69
+ "description": {
70
+ "type": "string"
71
+ },
72
+ "version": {
73
+ "type": "string",
74
+ "minLength": 1
75
+ },
76
+ "exported_at": {
77
+ "type": "string",
78
+ "minLength": 1
79
+ },
80
+ "ssss_core_version": {
81
+ "type": "string",
82
+ "minLength": 1
83
+ },
84
+ "required_extensions": {
85
+ "type": "array",
86
+ "items": {
87
+ "type": "string",
88
+ "minLength": 1
89
+ },
90
+ "uniqueItems": true
91
+ },
92
+ "export_profile": {
93
+ "type": "string",
94
+ "enum": ["backup", "template", "sale"]
95
+ },
96
+ "primitive_inventory": {
97
+ "type": "object",
98
+ "additionalProperties": {
99
+ "type": "integer",
100
+ "minimum": 0
101
+ }
102
+ },
103
+ "dependencies": {
104
+ "type": "object",
105
+ "additionalProperties": false,
106
+ "properties": {
107
+ "primitives": {
108
+ "type": "array",
109
+ "items": { "type": "string", "minLength": 1 },
110
+ "uniqueItems": true
111
+ },
112
+ "extensions": {
113
+ "type": "array",
114
+ "items": { "type": "string", "minLength": 1 },
115
+ "uniqueItems": true
116
+ },
117
+ "migrations": {
118
+ "type": "array",
119
+ "items": { "type": "string", "minLength": 1 },
120
+ "uniqueItems": true
121
+ },
122
+ "integrity": {
123
+ "type": "object",
124
+ "additionalProperties": false,
125
+ "properties": {
126
+ "content_hash": {
127
+ "type": "string",
128
+ "pattern": "^sha256:[a-f0-9]{64}$"
129
+ },
130
+ "ssss_core_version": {
131
+ "type": "string",
132
+ "minLength": 1
133
+ }
134
+ }
135
+ },
136
+ "bundles": {
137
+ "type": "array",
138
+ "items": {
139
+ "type": "object",
140
+ "additionalProperties": false,
141
+ "properties": {
142
+ "id": { "type": "string", "minLength": 1 },
143
+ "name": { "type": "string", "minLength": 1 },
144
+ "version": { "type": "string" },
145
+ "installMode": {
146
+ "type": "string",
147
+ "enum": ["optional", "recommended", "required"]
148
+ }
149
+ }
150
+ }
151
+ }
152
+ }
153
+ },
154
+ "provisioning": {
155
+ "type": "array",
156
+ "items": {
157
+ "$ref": "#/$defs/provisioningStep"
158
+ }
159
+ },
160
+ "parameters": {
161
+ "type": "array",
162
+ "items": {
163
+ "$ref": "#/$defs/provisioningParameter"
164
+ }
165
+ },
166
+ "file_count": {
167
+ "type": "integer",
168
+ "minimum": 0
169
+ },
170
+ "provenance": {
171
+ "type": "object",
172
+ "required": [
173
+ "content_hash",
174
+ "exporter"
175
+ ],
176
+ "additionalProperties": false,
177
+ "properties": {
178
+ "content_hash": {
179
+ "type": "string",
180
+ "pattern": "^sha256:[a-f0-9]{64}$"
181
+ },
182
+ "exporter": {
183
+ "type": "string",
184
+ "minLength": 1
185
+ },
186
+ "signature": {
187
+ "type": "string",
188
+ "minLength": 1
189
+ }
190
+ }
191
+ },
192
+ "source_workspace_id": {
193
+ "type": "string",
194
+ "minLength": 1
195
+ },
196
+ "branding": {
197
+ "type": "object"
198
+ }
199
+ }
200
+ },
201
+ "provisioningStep": {
202
+ "type": "object",
203
+ "required": [
204
+ "id",
205
+ "label",
206
+ "system",
207
+ "mode",
208
+ "required"
209
+ ],
210
+ "additionalProperties": false,
211
+ "properties": {
212
+ "id": {
213
+ "type": "string",
214
+ "minLength": 1
215
+ },
216
+ "label": {
217
+ "type": "string",
218
+ "minLength": 1
219
+ },
220
+ "system": {
221
+ "type": "string",
222
+ "enum": [
223
+ "workspace",
224
+ "branding",
225
+ "email",
226
+ "phone",
227
+ "domains",
228
+ "accounts",
229
+ "deployments",
230
+ "marketplace",
231
+ "tabs",
232
+ "automation"
233
+ ]
234
+ },
235
+ "mode": {
236
+ "type": "string",
237
+ "enum": [
238
+ "existing",
239
+ "provision",
240
+ "install",
241
+ "generate",
242
+ "configure"
243
+ ]
244
+ },
245
+ "required": {
246
+ "type": "boolean"
247
+ },
248
+ "notes": {
249
+ "type": "string"
250
+ }
251
+ }
252
+ },
253
+ "provisioningParameter": {
254
+ "type": "object",
255
+ "required": [
256
+ "key",
257
+ "label",
258
+ "type",
259
+ "scope",
260
+ "source"
261
+ ],
262
+ "additionalProperties": false,
263
+ "properties": {
264
+ "key": {
265
+ "type": "string",
266
+ "minLength": 1
267
+ },
268
+ "label": {
269
+ "type": "string",
270
+ "minLength": 1
271
+ },
272
+ "type": {
273
+ "type": "string",
274
+ "minLength": 1
275
+ },
276
+ "scope": {
277
+ "type": "string",
278
+ "minLength": 1
279
+ },
280
+ "source": {
281
+ "type": "string",
282
+ "enum": ["user", "llm", "graph", "system"]
283
+ },
284
+ "required": {
285
+ "type": "boolean"
286
+ },
287
+ "description": {
288
+ "type": "string"
289
+ },
290
+ "defaultValue": {},
291
+ "options": {
292
+ "type": "array"
293
+ },
294
+ "dependsOn": {
295
+ "type": "string"
296
+ }
297
+ }
298
+ }
299
+ }
300
+ }