@tacuchi/agent-workflow-cli 20.26.0 → 21.1.0

package/skills/w/schemas/design/design-manifest.v1.schema.json

@@ -0,0 +1,322 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workline.dev/schemas/design/design-manifest.v1.schema.json",
+  "title": "Workline UI Design Package v1 — design manifest",
+  "description": "Mutable discovery index of a UI Design Package. Owns nothing normative: it declares identity, where the artifacts live, which baseline is current and who consumes the package. A baseline digest excludes this file, so re-indexing never rewrites a published revision.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "title",
+    "created",
+    "derived_from",
+    "current_baseline",
+    "baselines",
+    "catalog",
+    "currentness",
+    "governance",
+    "relations"
+  ],
+  "properties": {
+    "schema": {
+      "description": "Format version. An unknown value stops validation before any field is read.",
+      "const": "workline.design-manifest/v1"
+    },
+    "id": {
+      "description": "Package identity. Derives from nothing — not a spec, plan, session, slug, path or provider — and survives every rename or move.",
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+    },
+    "title": {
+      "description": "Human name of the package.",
+      "type": "string",
+      "minLength": 1
+    },
+    "created": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "derived_from": {
+      "description": "Baseline of the package this one forked from. An intentional divergence creates another package instead of a second live baseline line.",
+      "type": ["string", "null"],
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+    },
+    "current_baseline": {
+      "description": "The published baseline in force. Null until the first publication. Must match its entry in `baselines`.",
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["revision", "path", "digest"],
+      "properties": {
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "path": {
+          "$ref": "#/$defs/packagePath"
+        },
+        "digest": {
+          "$ref": "#/$defs/digest"
+        }
+      }
+    },
+    "baselines": {
+      "description": "The package's baseline line, chained by `parent_baseline`.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["revision", "path", "digest", "parent_baseline", "published"],
+        "properties": {
+          "revision": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "path": {
+            "$ref": "#/$defs/packagePath"
+          },
+          "digest": {
+            "$ref": "#/$defs/digest"
+          },
+          "parent_baseline": {
+            "type": ["string", "null"],
+            "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+          },
+          "published": {
+            "type": "string",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+          }
+        }
+      }
+    },
+    "catalog": {
+      "description": "Every revision the package holds. Flows and screens carry maturity; rules, tokens and renditions do not; assets are content-addressed and have no ID.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["flows", "screens", "rules", "tokens", "renditions", "assets"],
+      "properties": {
+        "flows": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/maturedArtifact"
+          }
+        },
+        "screens": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/screenArtifact"
+          }
+        },
+        "rules": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/revisionedArtifact"
+          }
+        },
+        "tokens": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/revisionedArtifact"
+          }
+        },
+        "renditions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/revisionedArtifact"
+          }
+        },
+        "assets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["digest", "path"],
+            "properties": {
+              "digest": {
+                "$ref": "#/$defs/digest"
+              },
+              "path": {
+                "description": "`assets/<sha256>-<safe-name>.<ext>` — the digest is in the file name, so different bytes can never occupy the same path.",
+                "$ref": "#/$defs/packagePath"
+              }
+            }
+          }
+        }
+      }
+    },
+    "currentness": {
+      "description": "Derived from `supersedes`, cached here for discovery. Superseded warns; it never blocks — only an explicit revocation does.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["ref", "state"],
+        "properties": {
+          "ref": {
+            "$ref": "#/$defs/artifactRef"
+          },
+          "state": {
+            "enum": ["current", "superseded"]
+          }
+        }
+      }
+    },
+    "governance": {
+      "description": "Index of review and revocation records. The records themselves live outside the baseline they decide on, so no digest is self-referential.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reviews", "revocations"],
+      "properties": {
+        "reviews": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/governanceEntry"
+          }
+        },
+        "revocations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/governanceEntry"
+          }
+        }
+      }
+    },
+    "relations": {
+      "description": "Many-to-many links to the documents that consume this package — the backreference direction, so a consumer is found without scanning docs/.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["specs", "plans"],
+      "properties": {
+        "specs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "plans": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "packagePath": {
+      "description": "Package-relative path. Never absolute, never Windows-separated, never carrying `.` or `..`.",
+      "type": "string",
+      "pattern": "^[^/\\\\][^\\\\]*$"
+    },
+    "artifactRef": {
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR|RUL|TOK|VIS|REV|RVK)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}(#[A-Za-z0-9][A-Za-z0-9_-]*)?$"
+    },
+    "revisionedArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "revision", "path", "supersedes"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^(?:FLW|SCR|RUL|TOK|VIS)-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "path": {
+          "$ref": "#/$defs/packagePath"
+        },
+        "supersedes": {
+          "type": ["string", "null"],
+          "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR|RUL|TOK|VIS)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+        }
+      }
+    },
+    "maturedArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "revision", "path", "supersedes", "maturity"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^(?:FLW|SCR)-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "path": {
+          "$ref": "#/$defs/packagePath"
+        },
+        "supersedes": {
+          "type": ["string", "null"],
+          "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+        },
+        "maturity": {
+          "enum": ["outline", "handoff"]
+        }
+      }
+    },
+    "governanceEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "digest", "target"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^(?:REV|RVK)-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+        },
+        "path": {
+          "$ref": "#/$defs/packagePath"
+        },
+        "digest": {
+          "$ref": "#/$defs/digest"
+        },
+        "target": {
+          "type": "string",
+          "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+        }
+      }
+    },
+    "screenArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "revision", "path", "supersedes", "maturity", "states"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^(?:FLW|SCR)-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "path": {
+          "$ref": "#/$defs/packagePath"
+        },
+        "supersedes": {
+          "type": ["string", "null"],
+          "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+        },
+        "maturity": {
+          "enum": ["outline", "handoff"]
+        },
+        "states": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
+          }
+        }
+      }
+    }
+  }
+}

package/skills/w/schemas/design/design-render-bundle.v1.schema.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workline.dev/schemas/design/design-render-bundle.v1.schema.json",
+  "title": "Workline UI Design Package v1 — Render Context Bundle",
+  "description": "The single exchange payload every renderer and adapter receives. Deterministic for a baseline, a selection and an adapter profile: the digest is taken over canonical JSON without `digest` and without `generated`, so two equivalent runs seal the same bytes. It carries context, never authority — an integration transforms it over its own copy and the package stays untouched.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "package",
+    "baseline",
+    "baseline_digest",
+    "adapter",
+    "roots",
+    "closure",
+    "assets",
+    "data_classification",
+    "accessibility",
+    "losses",
+    "digest",
+    "generated"
+  ],
+  "properties": {
+    "schema": {
+      "const": "workline.design-render-bundle/v1"
+    },
+    "package": {
+      "description": "The package this bundle was cut from.",
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+    },
+    "baseline": {
+      "description": "The published revision the selection was read at.",
+      "$ref": "#/$defs/revision"
+    },
+    "baseline_digest": {
+      "$ref": "#/$defs/digest"
+    },
+    "adapter": {
+      "description": "Which profile, at which version, this bundle was cut for. Determinism is a promise PER profile version: a profile that changes what it needs produces a different bundle.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profile", "version"],
+      "properties": {
+        "profile": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "version": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "roots": {
+      "description": "The selection, sorted. A selection is a set, so the order it was typed in is not part of the bundle. An anchor is allowed here: a root may ask for one state.",
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR|RUL|TOK|VIS)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}(?:#[A-Za-z0-9][A-Za-z0-9_-]*)?$"
+      }
+    },
+    "closure": {
+      "description": "Every revision the selection reaches, ordered by reference, with the content type and the digest of the bytes found on disk.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["ref", "kind", "path", "content_type", "sha256", "states"],
+        "properties": {
+          "ref": {
+            "description": "The revision, never anchored: the states demanded travel in `states`.",
+            "type": "string",
+            "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR|RUL|TOK|VIS)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+          },
+          "kind": {
+            "enum": ["flow", "screen", "rule", "token", "rendition"]
+          },
+          "path": {
+            "description": "Package-relative path. Never absolute and never escaping the package.",
+            "type": "string",
+            "minLength": 1
+          },
+          "content_type": {
+            "description": "Declared, not sniffed: a renderer decides how to read a member from this field.",
+            "type": "string",
+            "minLength": 1
+          },
+          "sha256": {
+            "$ref": "#/$defs/digest"
+          },
+          "states": {
+            "description": "State anchors the selection asked for. Empty means the whole revision.",
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
+            }
+          }
+        }
+      }
+    },
+    "assets": {
+      "description": "The assets this bundle is allowed to hand over — only bytes the package custodies.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["digest", "path", "content_type"],
+        "properties": {
+          "digest": {
+            "$ref": "#/$defs/digest"
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^assets/"
+          },
+          "content_type": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "data_classification": {
+      "description": "How the material was prepared. `synthetic` is the default; `real` is an authorization somebody had to give.",
+      "enum": ["synthetic", "redacted", "real"]
+    },
+    "accessibility": {
+      "description": "The accessibility obligations the selected revisions state. A design states them; a rendition never discharges them.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["ref", "statement"],
+        "properties": {
+          "ref": {
+            "type": "string",
+            "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR|RUL|TOK|VIS)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}(?:#[A-Za-z0-9][A-Za-z0-9_-]*)?$"
+          },
+          "statement": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "losses": {
+      "description": "What this profile cannot represent, enumerated instead of omitted. A loss is part of the result, not a defect.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["subject", "why"],
+        "properties": {
+          "subject": {
+            "description": "What is lost: `capability:pull`, `section:localization`, `medium:motion`.",
+            "type": "string",
+            "minLength": 1
+          },
+          "why": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "digest": {
+      "description": "Over canonical JSON of this object WITHOUT `digest` and WITHOUT `generated`. That exclusion is the determinism boundary made checkable.",
+      "$ref": "#/$defs/digest"
+    },
+    "generated": {
+      "description": "YYYY-MM-DD. Outside the seal: a date is not part of what was selected.",
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    }
+  },
+  "$defs": {
+    "revision": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    }
+  }
+}