@gregiteen/ssss-cli 0.14.1 → 0.14.3

package/schemas/core-registry.schema.json

@@ -0,0 +1,553 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ssss.dev/schemas/core-registry.schema.json",
+  "title": "SSSS Core and Extension Registry Schema",
+  "description": "JSON Schema for SSSS core and extension registries (spec §5).",
+  "type": "object",
+  "required": [
+    "registry",
+    "document_primitives"
+  ],
+  "if": {
+    "properties": { "registry": { "const": "core" } },
+    "required": ["registry"]
+  },
+  "then": {
+    "required": ["spec_version", "description"]
+  },
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "minLength": 1
+    },
+    "registry": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+    },
+    "extends": {
+      "type": "string",
+      "enum": ["core", "ssss"]
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$"
+    },
+    "requires": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+      },
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "spec_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "conformance": {
+      "type": "string"
+    },
+    "document_primitives": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^(?:[a-z][a-z0-9_-]{0,63}:)?[a-z][a-z0-9_-]{0,127}$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/primitiveDefinition"
+      }
+    },
+    "contract_primitives": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/contractPrimitive"
+      }
+    },
+    "universal_frontmatter": {
+      "type": "object",
+      "required": ["required"],
+      "additionalProperties": false,
+      "properties": {
+        "required": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "recommended_okf": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "recommended_semantic": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "spec_ref": {
+          "type": "string"
+        }
+      }
+    },
+    "portability": {
+      "type": "object",
+      "required": ["classes", "export_profiles"],
+      "additionalProperties": false,
+      "properties": {
+        "description": { "type": "string" },
+        "classes": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "export_profiles": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "required": ["includes"],
+            "additionalProperties": false,
+            "properties": {
+              "includes": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "excludes": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "resource_bound": { "type": "string" },
+              "note": { "type": "string" }
+            }
+          }
+        },
+        "conformance": { "type": "string" },
+        "spec_ref": { "type": "string" }
+      }
+    },
+    "bundle": {
+      "type": "object",
+      "required": [
+        "container",
+        "structure",
+        "manifest_required_fields",
+        "provenance_required_fields"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "description": { "type": "string" },
+        "container": { "type": "string" },
+        "structure": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "file_sort": { "type": "string" },
+        "manifest_required_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "manifest_optional_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "provenance_required_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "provenance_optional_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "content_hash": { "type": "string" },
+        "parameter_fields": {
+          "type": "object",
+          "required": ["required"],
+          "additionalProperties": false,
+          "properties": {
+            "required": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "uniqueItems": true
+            },
+            "optional": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "uniqueItems": true
+            },
+            "source_enum": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "uniqueItems": true
+            },
+            "note": { "type": "string" }
+          }
+        },
+        "conformance": { "type": "string" },
+        "spec_ref": { "type": "string" }
+      }
+    },
+    "provisioning": {
+      "type": "object",
+      "required": [
+        "verbs",
+        "step_required_fields",
+        "system_enum",
+        "mode_enum"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "description": { "type": "string" },
+        "verbs": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "step_required_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "step_optional_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "system_enum": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "mode_enum": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "edge_relations": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "install_modes": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "id_remap": { "type": "string" },
+        "upgrade": { "type": "string" },
+        "conformance": { "type": "string" },
+        "spec_ref": { "type": "string" }
+      }
+    },
+    "runtime": {
+      "type": "object",
+      "required": [
+        "trigger_types",
+        "misfire_policies",
+        "concurrency_policies",
+        "task_instantiation_fields",
+        "run_statuses",
+        "idempotency_basis"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "description": { "type": "string" },
+        "trigger_types": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "misfire_policies": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "concurrency_policies": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "task_instantiation_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "run_statuses": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "idempotency_basis": { "type": "string" },
+        "spec_ref": { "type": "string" }
+      }
+    },
+    "semantic": {
+      "type": "object",
+      "required": [
+        "version",
+        "identity_fields",
+        "surface_fields",
+        "relation_fields",
+        "renderable_fields",
+        "language_pattern",
+        "safe_default"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "version": { "type": "integer", "minimum": 1 },
+        "identity_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "surface_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "relation_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "renderable_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "language_pattern": { "type": "string", "minLength": 1 },
+        "safe_default": { "type": "string", "minLength": 1 },
+        "spec_ref": { "type": "string" }
+      }
+    },
+    "reserved_keys": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "host_field_prefix": { "type": "string", "minLength": 1 },
+    "spec_ref_reserved": { "type": "string" }
+  },
+  "$defs": {
+    "primitiveDefinition": {
+      "type": "object",
+      "required": [
+        "family",
+        "append_only",
+        "portability",
+        "required_fields"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "family": {
+          "type": "string",
+          "minLength": 1
+        },
+        "canonical_filename": {
+          "type": ["string", "null"]
+        },
+        "canonical_path": {
+          "type": ["string", "null"]
+        },
+        "filename_convention": {
+          "type": "string"
+        },
+        "append_only": {
+          "type": "boolean"
+        },
+        "portability": {
+          "type": "string",
+          "enum": ["structural", "tenant_private", "resource_bound"]
+        },
+        "required_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "optional_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "required_when": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_-]*==.+$"
+          },
+          "additionalProperties": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+          }
+        },
+        "enums": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+          },
+          "additionalProperties": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+          }
+        },
+        "patterns": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "immutable_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "references": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "allowed_types": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "disallowed_types": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 },
+                "uniqueItems": true
+              },
+              "allowed_portability": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": ["structural", "tenant_private", "resource_bound"]
+                },
+                "uniqueItems": true
+              },
+              "must_exist": {
+                "type": "boolean"
+              },
+              "hash_field": {
+                "type": "string",
+                "pattern": "^[A-Za-z_][A-Za-z0-9_-]*$"
+              }
+            }
+          }
+        },
+        "aliases": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^(?:[a-z][a-z0-9_-]{0,63}:)?[a-z][a-z0-9_-]{0,127}$"
+          },
+          "uniqueItems": true
+        },
+        "deprecated": {
+          "type": "boolean"
+        },
+        "deprecation_notice": {
+          "type": "string"
+        },
+        "resource": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "kind": { "type": "string" },
+            "binds": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "uniqueItems": true
+            },
+            "provision_relation": { "type": "string" }
+          }
+        },
+        "notes": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "projection_strategy": {
+          "type": "string"
+        },
+        "scopes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["system", "account", "workspace", "user"]
+          },
+          "uniqueItems": true
+        },
+        "capabilities": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+          }
+        },
+        "events": {
+          "type": "array"
+        },
+        "projections": {
+          "type": "array"
+        },
+        "ui": {
+          "type": "object"
+        },
+        "migrations": {
+          "type": "array"
+        },
+        "primitive_version": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "primitive_revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "authored_language": {
+          "type": ["string", "null"]
+        },
+        "spec_ref": {
+          "type": "string"
+        }
+      }
+    },
+    "contractPrimitive": {
+      "type": "object",
+      "required": ["purpose", "spec_ref"],
+      "additionalProperties": false,
+      "properties": {
+        "purpose": { "type": "string", "minLength": 1 },
+        "spec_ref": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/scripts/build-reference-bundle.mjs

@@ -84,20 +84,19 @@ permissions:
   - "write:task"
 ---
 Full access to all festival operations.`,
-  // resource_bound — declares "this business needs a domain"; the SELLER's domain never ships
-  'domains/festival.md':
+  // resource_bound — declares "this business needs an external domain resource"; the SELLER's bound value never ships
+  'resources/domain.md':
 `---
-type: domain
+type: resource
 title: Festival Domain Requirement
 description: Domain resource requirement that the buyer binds during provisioning.
 timestamp: 2026-07-02T00:00:00Z
-domain_name: REQUIREMENT
-registrar: REQUIREMENT
-status: required
-payment_status: unbound
-x_portability: resource_bound
+name: Festival Domain
+kind: domain
+status: pending
+binds: festival.example
 ---
-This festival needs a domain. The buyer binds their own at provision (owns_domain).`,
+This festival needs a domain. The buyer binds their own at provision.`,
   // tenant_private — operator's ticket record; MUST be dropped from a sale bundle
   'tasks/ticket-4821.md':
 `---
@@ -138,7 +137,7 @@ try {
     description: 'A complete music-festival operation as a tradeable SSSS bundle.',
     version: '1.0.0',
     exporter: `${PACKAGE.name}@${PACKAGE.version}`,
-    requiredExtensions: ['festech'],
+    requiredExtensions: [],
     parameters: [
       { key: 'business_name', label: 'Festival name', type: 'string', scope: 'workspace', source: 'user', required: true },
       { key: 'domain', label: 'Domain to bind', type: 'string', scope: 'workspace', source: 'user', required: true, description: 'Satisfies the resource_bound domain requirement (owns_domain).' },

package/scripts/check-commit-durability.mjs

@@ -306,6 +306,7 @@ async function checkRecoveryTriggers(root) {
   const untouched = read(live, 'rules/live.md').includes('in flight');
   holder.child.kill('SIGKILL');
   const signal = await holder.exited;
+  await new Promise((resolve) => setTimeout(resolve, 50));
   const afterKill = await fileKernel(live).recover();
   check('recovery skips an intent whose writer is alive',
     whileAlive.length === 1 && whileAlive[0].outcome === 'in_flight' && untouched, JSON.stringify(whileAlive));

package/scripts/check-docs-parity.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * Fail-closed documentation parity gate.
+ * Verifies all CLI commands and topics are documented.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const SCRIPTS_DIR = path.join(ROOT, 'scripts');
+const OVERVIEW_FILE = path.join(ROOT, 'docs', 'help', 'overview.md');
+
+const commands = fs.readdirSync(SCRIPTS_DIR)
+  .filter((f) => f.startsWith('cmd-') && f.endsWith('.mjs'))
+  .map((f) => f.replace(/^cmd-/, '').replace(/\.mjs$/, ''))
+  .sort();
+
+if (!fs.existsSync(OVERVIEW_FILE)) {
+  console.error('docs/help/overview.md missing!');
+  process.exit(1);
+}
+
+const overview = fs.readFileSync(OVERVIEW_FILE, 'utf8');
+const missing = [];
+
+for (const cmd of commands) {
+  if (!overview.includes(`\`${cmd}\``)) {
+    missing.push(cmd);
+  }
+}
+
+if (missing.length > 0) {
+  console.error(`Documentation parity failure: commands missing from docs/help/overview.md: ${missing.join(', ')}`);
+  process.exit(1);
+}
+
+console.log(`ok: documentation parity verified for all ${commands.length} commands.`);