@tacuchi/agent-workflow-cli 20.26.0 → 21.0.0

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

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workline.dev/schemas/design/design-baseline.v1.schema.json",
+  "title": "Workline UI Design Package v1 — baseline",
+  "description": "Immutable authority of one published revision: the closed selection of normative files with their revision and the SHA-256 of their bytes, sealed by a digest over canonical JSON WITHOUT the digest field. The mutable manifest, the governance records and the regenerable projections are excluded by construction, so re-indexing or re-rendering can never alter a revision published months ago.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "package",
+    "revision",
+    "parent_baseline",
+    "published",
+    "digest",
+    "selection"
+  ],
+  "properties": {
+    "schema": {
+      "const": "workline.design-baseline/v1"
+    },
+    "package": {
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "parent_baseline": {
+      "description": "The previous revision of THIS package, or null for the first. A line never forks: an intentional divergence creates another package with `derived_from`.",
+      "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}$"
+    },
+    "digest": {
+      "description": "SHA-256 over canonical JSON of this document WITHOUT this field. No self-reference, so anyone can recompute and compare.",
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "selection": {
+      "description": "The closed set of normative files this revision publishes together. Never empty: a published revision publishes something.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "revision", "sha256"],
+        "properties": {
+          "path": {
+            "description": "Package-relative path under flows/, screens/, design-system/rules/, tokens/, renditions/ or assets/.",
+            "type": "string",
+            "minLength": 1
+          },
+          "revision": {
+            "description": "The revision the file's own name carries; null for a content-addressed asset.",
+            "type": ["integer", "null"],
+            "minimum": 1
+          },
+          "sha256": {
+            "description": "Digest of the file's BYTES, not of a projection of them.",
+            "type": "string",
+            "pattern": "^sha256:[0-9a-f]{64}$"
+          }
+        }
+      },
+      "minItems": 1
+    }
+  }
+}

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-review.v1.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workline.dev/schemas/design-review.v1.schema.json",
+  "title": "Workline design review record v1",
+  "description": "An external review of one exact baseline revision. It lives OUTSIDE the baseline it reviews, so no digest is self-referential, and it never grants anything to a later revision.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "target",
+    "target_digest",
+    "author",
+    "date",
+    "decision",
+    "evidence",
+    "digest"
+  ],
+  "properties": {
+    "schema": {
+      "const": "workline.design-review/v1"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^REV-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+    },
+    "target": {
+      "description": "The exact baseline this record decides on.",
+      "$ref": "#/$defs/baselineRef"
+    },
+    "target_digest": {
+      "description": "The digest that baseline had. A record decides on BYTES, not on a name.",
+      "$ref": "#/$defs/digest"
+    },
+    "author": {
+      "description": "Who decided, or the role that did.",
+      "type": "string",
+      "minLength": 1
+    },
+    "date": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "decision": {
+      "description": "`proposed` is the state a baseline is born in; only `approved` grants anything.",
+      "enum": ["proposed", "approved", "rejected"]
+    },
+    "evidence": {
+      "description": "Optional: where the decision was taken. Never a substitute for the decision.",
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "digest": {
+      "description": "SHA-256 of this record's canonical JSON WITHOUT this field.",
+      "$ref": "#/$defs/digest"
+    }
+  },
+  "$defs": {
+    "baselineRef": {
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    }
+  }
+}

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

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workline.dev/schemas/design-revocation.v1.schema.json",
+  "title": "Workline design revocation record v1",
+  "description": "An explicit, audited block on one exact baseline revision. The ONLY thing that forbids executing against a published revision.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "id", "target", "target_digest", "author", "date", "reason", "digest"],
+  "properties": {
+    "schema": {
+      "const": "workline.design-revocation/v1"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^RVK-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+    },
+    "target": {
+      "description": "The exact baseline this record decides on.",
+      "$ref": "#/$defs/baselineRef"
+    },
+    "target_digest": {
+      "description": "The digest that baseline had. A record decides on BYTES, not on a name.",
+      "$ref": "#/$defs/digest"
+    },
+    "author": {
+      "description": "Who decided, or the role that did.",
+      "type": "string",
+      "minLength": 1
+    },
+    "date": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "reason": {
+      "description": "Why this revision must not be executed. Not optional: a block without a reason is not auditable.",
+      "type": "string",
+      "minLength": 1
+    },
+    "digest": {
+      "description": "SHA-256 of this record's canonical JSON WITHOUT this field.",
+      "$ref": "#/$defs/digest"
+    }
+  },
+  "$defs": {
+    "baselineRef": {
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    }
+  }
+}