@tacuchi/agent-workflow-cli 20.26.0 → 21.1.0

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

@@ -0,0 +1,232 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workline.dev/schemas/design/design-rendition.v1.schema.json",
+  "title": "Workline UI Design Package v1 — Design Rendition",
+  "description": "What a picture of a design knows about itself. Three separations never collapse here: fidelity is a property of the picture and never moves the screen's maturity; staleness against the source is DERIVED (`source_digest` is recomputable from the sources' bytes) while sync with the provider is a claim and lives inside `provider`; and a locator locates without ever identifying — it never replaces the Workline id, revision or digest, and never carries a credential.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "revision",
+    "supersedes",
+    "purpose",
+    "medium",
+    "fidelity",
+    "tool",
+    "format",
+    "context",
+    "sources",
+    "source_digest",
+    "coverage",
+    "files",
+    "provider",
+    "access",
+    "interaction_evidence",
+    "data_classification"
+  ],
+  "properties": {
+    "schema": {
+      "const": "workline.design-rendition/v1"
+    },
+    "id": {
+      "description": "Qualified identity WITHOUT the revision — the revision is its own field.",
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/VIS-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "supersedes": {
+      "description": "An EARLIER revision of this same rendition, or null.",
+      "type": ["string", "null"],
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/VIS-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+    },
+    "purpose": {
+      "type": "string",
+      "minLength": 1
+    },
+    "medium": {
+      "description": "What kind of artifact it is. Only `prototype` and `storyboard` can sustain interaction evidence — a still frame cannot show a transition.",
+      "enum": ["static_image", "document", "interactive_html", "prototype", "storyboard"]
+    },
+    "fidelity": {
+      "description": "How polished the PICTURE is. Deliberately not sharing vocabulary with maturity: raising fidelity never promotes a screen.",
+      "enum": ["low", "medium", "high"]
+    },
+    "tool": {
+      "description": "The tool that produced it, as a human would name it.",
+      "type": "string",
+      "minLength": 1
+    },
+    "format": {
+      "description": "Closed so it can be cross-checked against the file actually on disk.",
+      "enum": ["svg", "png", "jpeg", "webp", "pdf", "html"]
+    },
+    "context": {
+      "description": "The same design looks different depending on where it was rendered.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["platform", "viewport", "theme", "locale", "variants"],
+      "properties": {
+        "platform": {
+          "type": "string",
+          "minLength": 1
+        },
+        "viewport": {
+          "description": "`1280x800`, `390x844`, or a named breakpoint.",
+          "type": "string",
+          "minLength": 1
+        },
+        "theme": {
+          "type": "string",
+          "minLength": 1
+        },
+        "locale": {
+          "type": "string",
+          "minLength": 1
+        },
+        "variants": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "sources": {
+      "description": "The exact revisions this rendition was produced from, with the bytes it saw. An anchor is meaningful here: a preview of one state is a preview of one state.",
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["ref", "sha256"],
+        "properties": {
+          "ref": {
+            "type": "string",
+            "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/(?:FLW|SCR|RUL|TOK)-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}(?:#[A-Za-z0-9][A-Za-z0-9_-]*)?$"
+          },
+          "sha256": {
+            "$ref": "#/$defs/digest"
+          }
+        }
+      }
+    },
+    "source_digest": {
+      "description": "One digest over the canonical list of `sources`. Recomputable from the package as it stands right now — that is what makes obsolescence detectable instead of asserted.",
+      "$ref": "#/$defs/digest"
+    },
+    "coverage": {
+      "description": "What this rendition demonstrates, in the screen's own vocabulary. The reverse direction of the screen's classification matrix; the handoff gate crosses the two.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["criteria", "states"],
+      "properties": {
+        "criteria": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^S\\d{3}/AC-(?:[A-Z]+-)?\\d+$"
+          }
+        },
+        "states": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
+          }
+        }
+      }
+    },
+    "files": {
+      "description": "The local evidence, relative to the rendition's OWN directory. Never empty: a rendition with no local file is exactly the evidence that disappears when the provider does.",
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "sha256"],
+        "properties": {
+          "path": {
+            "description": "`preview.svg` — relative to this rendition's folder, never escaping it.",
+            "type": "string",
+            "minLength": 1
+          },
+          "sha256": {
+            "$ref": "#/$defs/digest"
+          }
+        }
+      }
+    },
+    "provider": {
+      "description": "The external object, when there is one. `sync` lives in here because it only means something once a provider copy exists.",
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["name", "locator", "version", "sync"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "locator": {
+          "description": "Provider-shaped keys (`file_key`, `node_id`, `project_id`, `artifact`, …). The key set is the adapter profile's business, not this schema's. Never a credential.",
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "version": {
+          "description": "The provider's own version identity, or null when it has no stable one.",
+          "type": ["string", "null"],
+          "minLength": 1
+        },
+        "sync": {
+          "description": "A CLAIM about the provider's copy, not a derivation. `unknown` is the honest answer without consulting it.",
+          "enum": ["in_sync", "diverged", "unknown"]
+        }
+      }
+    },
+    "access": {
+      "description": "Who can reach the editable original, as a class. `local_only` is what keeps working when the provider does not.",
+      "enum": ["local_only", "public", "link_shared", "team", "private"]
+    },
+    "interaction_evidence": {
+      "description": "A trigger, a transition and an outcome — what a still frame cannot show. Null for a static rendition.",
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["trigger", "transition", "outcome"],
+      "properties": {
+        "trigger": {
+          "type": "string",
+          "minLength": 1
+        },
+        "transition": {
+          "type": "string",
+          "minLength": 1
+        },
+        "outcome": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "data_classification": {
+      "description": "How the material shown was prepared. `synthetic` is the default; `real` is an authorization somebody had to give.",
+      "enum": ["synthetic", "redacted", "real"]
+    }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    }
+  }
+}

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}$"
+    }
+  }
+}

package/skills/w/schemas/design/ui-flow.v1.schema.json

@@ -0,0 +1,211 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workline.dev/schemas/design/ui-flow.v1.schema.json",
+  "title": "Workline UI Design Package v1 — Flow Specification frontmatter",
+  "description": "Machine-readable half of a User Flow / Task Flow. Identity, graph, dependencies and traceability resolve from here alone: nothing normative may require reading the Markdown body.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "revision",
+    "maturity",
+    "supersedes",
+    "purpose",
+    "platform",
+    "actors",
+    "entry",
+    "nodes",
+    "edges",
+    "dependencies",
+    "trace",
+    "unknowns",
+    "not_applicable",
+    "external"
+  ],
+  "properties": {
+    "schema": {
+      "const": "workline.ui-flow/v1"
+    },
+    "id": {
+      "description": "Qualified identity WITHOUT the revision — the revision is its own field.",
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/FLW-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+    },
+    "revision": {
+      "$ref": "#/$defs/revision"
+    },
+    "maturity": {
+      "$ref": "#/$defs/maturity"
+    },
+    "supersedes": {
+      "description": "An EARLIER revision of this same flow, or null. Currentness is derived from it.",
+      "type": ["string", "null"],
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/FLW-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+    },
+    "purpose": {
+      "type": "string",
+      "minLength": 1
+    },
+    "platform": {
+      "type": "string",
+      "minLength": 1
+    },
+    "actors": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    },
+    "entry": {
+      "description": "The screen STATE the flow starts at. Must also appear in `nodes`.",
+      "$ref": "#/$defs/stateRef"
+    },
+    "nodes": {
+      "description": "Every screen state the flow visits, by exact reference.",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/stateRef"
+      },
+      "uniqueItems": true
+    },
+    "edges": {
+      "description": "Transitions. Both endpoints must be declared nodes, so the graph closes on itself.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["from", "trigger", "action", "condition", "to"],
+        "properties": {
+          "from": {
+            "$ref": "#/$defs/stateRef"
+          },
+          "trigger": {
+            "type": "string",
+            "minLength": 1
+          },
+          "action": {
+            "type": ["string", "null"],
+            "minLength": 1
+          },
+          "condition": {
+            "type": ["string", "null"],
+            "minLength": 1
+          },
+          "to": {
+            "$ref": "#/$defs/stateRef"
+          }
+        }
+      }
+    },
+    "dependencies": {
+      "description": "Rules and tokens the flow itself depends on, by exact reference.",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/artifactRef"
+      },
+      "uniqueItems": true
+    },
+    "trace": {
+      "$ref": "#/$defs/trace"
+    },
+    "unknowns": {
+      "$ref": "#/$defs/unknowns"
+    },
+    "not_applicable": {
+      "$ref": "#/$defs/notApplicable"
+    },
+    "external": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/externalDesignSystem"
+      }
+    }
+  },
+  "$defs": {
+    "revision": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "maturity": {
+      "enum": ["outline", "handoff"]
+    },
+    "artifactRef": {
+      "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_-]*)?$"
+    },
+    "stateRef": {
+      "description": "A screen state: `DES-001/SCR-002@r2#empty`. The anchor is required.",
+      "type": "string",
+      "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/SCR-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}#[A-Za-z0-9][A-Za-z0-9_-]*$"
+    },
+    "trace": {
+      "description": "Acceptance criteria this artifact answers to. Emptiness is the maturity profile's business, not this schema's.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["criterion", "source"],
+        "properties": {
+          "criterion": {
+            "type": "string",
+            "minLength": 1
+          },
+          "source": {
+            "type": ["string", "null"],
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "unknowns": {
+      "description": "Open questions, explicit. `blocking: true` is what a handoff gate refuses.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["question", "blocking"],
+        "properties": {
+          "question": {
+            "type": "string",
+            "minLength": 1
+          },
+          "blocking": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    "notApplicable": {
+      "description": "Conditional section → reason. Only conditional sections may appear, and a reason is never empty. Essential sections cannot be waived at all.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "externalDesignSystem": {
+      "description": "Where foreign rules, tokens or assets came from. A `handoff` that depends on someone else's design system pins it and keeps the subset locally (AC-PKG-09).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider", "revision", "digest"],
+      "properties": {
+        "provider": {
+          "type": "string",
+          "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})$"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        }
+      }
+    }
+  }
+}