@open-agent-toolkit/cli 0.2.26 → 0.2.28

package/assets/skills/explainer-kit/schemas/build-record.schema.json

@@ -24,7 +24,13 @@
       "minItems": 1
     },
     "outcome": {
-      "enum": ["built-durable", "built-not-durable", "failed", "incomplete"]
+      "enum": [
+        "built-durable",
+        "built-not-durable",
+        "built-needs-review",
+        "failed",
+        "incomplete"
+      ]
     }
   },
   "$defs": {

package/assets/skills/explainer-kit/schemas/fact-base.schema.json

@@ -55,6 +55,15 @@
       "minItems": 1,
       "uniqueItems": true
     },
+    "lineRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["start", "end"],
+      "properties": {
+        "start": { "type": "integer", "minimum": 1 },
+        "end": { "type": "integer", "minimum": 1 }
+      }
+    },
     "source": {
       "type": "object",
       "additionalProperties": false,
@@ -67,7 +76,20 @@
         "locator": { "type": "string", "minLength": 1 },
         "role": { "type": "string", "minLength": 1 },
         "sourceSetId": { "type": "string", "minLength": 1 },
-        "revision": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "repository": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"
+        },
+        "path": {
+          "type": "string",
+          "pattern": "^(?!/)(?!.*//)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*\\\\).+$"
+        },
+        "lineRange": { "$ref": "#/$defs/lineRange" },
+        "url": {
+          "type": "string",
+          "pattern": "^https://github\\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+/blob/[a-f0-9]{40}/[^\\s?#]+#L[1-9][0-9]*(?:-L[1-9][0-9]*)?$"
+        },
         "hash": { "$ref": "#/$defs/hash" },
         "observedAt": { "type": "string", "format": "date-time" },
         "authoritativeFor": {
@@ -83,7 +105,21 @@
       "required": ["sourceId", "locator"],
       "properties": {
         "sourceId": { "type": "string", "minLength": 1 },
-        "locator": { "type": "string", "minLength": 1 }
+        "locator": { "type": "string", "minLength": 1 },
+        "repository": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"
+        },
+        "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "path": {
+          "type": "string",
+          "pattern": "^(?!/)(?!.*//)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*\\\\).+$"
+        },
+        "lineRange": { "$ref": "#/$defs/lineRange" },
+        "url": {
+          "type": "string",
+          "pattern": "^https://github\\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+/blob/[a-f0-9]{40}/[^\\s?#]+#L[1-9][0-9]*(?:-L[1-9][0-9]*)?$"
+        }
       }
     },
     "claim": {

package/assets/skills/explainer-kit/schemas/manifest.schema.json

@@ -49,6 +49,11 @@
           "items": { "$ref": "#/$defs/safeRelativePath" },
           "minItems": 1,
           "uniqueItems": true
+        },
+        "backlinks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/sourceBacklink" },
+          "uniqueItems": true
         }
       }
     },
@@ -69,7 +74,13 @@
     },
     "immutableHashes": { "$ref": "#/$defs/hashMap" },
     "outcome": {
-      "enum": ["built-durable", "built-not-durable", "failed", "incomplete"]
+      "enum": [
+        "built-durable",
+        "built-not-durable",
+        "built-needs-review",
+        "failed",
+        "incomplete"
+      ]
     },
     "buildRecord": {
       "type": "object",
@@ -106,9 +117,22 @@
     },
     "hashMap": {
       "type": "object",
+      "description": "Raw-byte SHA-256 coverage for the complete immutable package, including required browser, cohesion, visual-review attempt, and revision evidence.",
       "propertyNames": { "$ref": "#/$defs/safeRelativePath" },
       "additionalProperties": { "$ref": "#/$defs/hash" }
     },
+    "sourceBacklink": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sourceId", "url"],
+      "properties": {
+        "sourceId": { "type": "string", "minLength": 1 },
+        "url": {
+          "type": "string",
+          "pattern": "^https://github\\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+/blob/[a-f0-9]{40}/[^\\s?#]+#L[1-9][0-9]*(?:-L[1-9][0-9]*)?$"
+        }
+      }
+    },
     "failure": {
       "type": "object",
       "additionalProperties": false,

package/assets/skills/explainer-kit/schemas/run-request.schema.json

@@ -25,6 +25,10 @@
         "version": { "type": "string", "minLength": 1 }
       }
     },
+    "recapMode": {
+      "type": "string",
+      "enum": ["artistic", "deterministic-markdown"]
+    },
     "slug": {
       "type": "string",
       "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"

package/assets/skills/explainer-kit/schemas/set-plan.v1.schema.json

@@ -0,0 +1,149 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.set-plan/v1",
+  "title": "SetPlanV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "planId",
+    "recipe",
+    "sourceIds",
+    "ledger",
+    "portfolio"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "explainer-kit.set-plan/v1" },
+    "planId": { "$ref": "#/$defs/safeId" },
+    "recipe": { "$ref": "#/$defs/recipe" },
+    "sourceIds": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/safeId" },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "ledger": { "$ref": "#/$defs/ledger" },
+    "portfolio": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/portfolioEntry" },
+      "minItems": 1
+    }
+  },
+  "$defs": {
+    "safeId": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+    },
+    "recipe": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "$ref": "#/$defs/safeId" },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "ledger": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Shared cohesion claims. A fully empty ledger explicitly identifies a lower-tier plan without applicable shared claims; adaptive recap review requires every group to be non-empty and observed.",
+      "required": ["terminology", "statuses", "numbers"],
+      "properties": {
+        "terminology": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/termEntry" },
+          "uniqueItems": true
+        },
+        "statuses": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/statusEntry" },
+          "uniqueItems": true
+        },
+        "numbers": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/numberEntry" },
+          "uniqueItems": true
+        }
+      }
+    },
+    "termEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["term", "meaning"],
+      "properties": {
+        "term": { "type": "string", "minLength": 1 },
+        "meaning": { "type": "string", "minLength": 1 }
+      }
+    },
+    "statusEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["subject", "value"],
+      "properties": {
+        "subject": { "type": "string", "minLength": 1 },
+        "value": { "type": "string", "minLength": 1 }
+      }
+    },
+    "numberEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["subject", "value", "unit"],
+      "properties": {
+        "subject": { "type": "string", "minLength": 1 },
+        "value": { "type": "number" },
+        "unit": { "type": "string", "minLength": 1 }
+      }
+    },
+    "portfolioEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "artifactId",
+        "artifactType",
+        "profileId",
+        "required",
+        "sourceIds",
+        "draft",
+        "visualIntent"
+      ],
+      "properties": {
+        "artifactId": { "$ref": "#/$defs/safeId" },
+        "artifactType": {
+          "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
+        },
+        "profileId": { "$ref": "#/$defs/safeId" },
+        "required": { "type": "boolean" },
+        "sourceIds": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/safeId" },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "draft": { "type": "string", "minLength": 1 },
+        "visualIntent": { "type": "string", "minLength": 1 },
+        "justification": { "$ref": "#/$defs/justification" }
+      }
+    },
+    "justification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "sourceIds", "rationale"],
+      "properties": {
+        "kind": {
+          "enum": [
+            "status-change",
+            "rollout-complexity",
+            "source-backed-detail"
+          ]
+        },
+        "sourceIds": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/safeId" },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "rationale": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/assets/skills/explainer-kit/schemas/visual-review-request.v1.schema.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.visual-review-request/v1",
+  "title": "VisualReviewRequestV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "requestId",
+    "requestHash",
+    "browserRuntime",
+    "captureIdentity",
+    "plan",
+    "renderedArtifacts"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "explainer-kit.visual-review-request/v1"
+    },
+    "requestId": { "$ref": "#/$defs/safeId" },
+    "requestHash": { "$ref": "#/$defs/hash" },
+    "browserRuntime": { "$ref": "#/$defs/browserRuntime" },
+    "captureIdentity": { "$ref": "#/$defs/hash" },
+    "plan": { "$ref": "explainer-kit.set-plan/v1" },
+    "renderedArtifacts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/renderedArtifact" },
+      "minItems": 1,
+      "uniqueItems": true
+    }
+  },
+  "$defs": {
+    "safeRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\).+$"
+    },
+    "safeId": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "browserRuntime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "name", "version"],
+      "properties": {
+        "kind": { "enum": ["launched", "fixture"] },
+        "name": { "const": "chromium" },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "renderedArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["artifactId", "renderedPath", "renderedHash", "evidence"],
+      "properties": {
+        "artifactId": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+        },
+        "renderedPath": { "$ref": "#/$defs/safeRelativePath" },
+        "renderedHash": { "$ref": "#/$defs/hash" },
+        "cohesionObservations": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/cohesionObservation" },
+          "uniqueItems": true
+        },
+        "evidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/evidence" },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      }
+    },
+    "cohesionObservation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["artifactId", "contentHash", "group", "claim", "value"],
+      "properties": {
+        "artifactId": { "$ref": "#/$defs/safeId" },
+        "contentHash": { "$ref": "#/$defs/hash" },
+        "group": {
+          "enum": ["terminology", "statuses", "numericClaims"]
+        },
+        "claim": { "type": "string", "minLength": 1 },
+        "value": {
+          "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "number" }]
+        }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "viewport",
+        "screenshotPath",
+        "screenshotHash",
+        "metricsPath",
+        "metricsHash",
+        "captureIdentity"
+      ],
+      "properties": {
+        "viewport": { "enum": ["desktop", "tablet", "mobile"] },
+        "screenshotPath": { "$ref": "#/$defs/safeRelativePath" },
+        "screenshotHash": { "$ref": "#/$defs/hash" },
+        "metricsPath": { "$ref": "#/$defs/safeRelativePath" },
+        "metricsHash": { "$ref": "#/$defs/hash" },
+        "captureIdentity": { "$ref": "#/$defs/hash" }
+      }
+    }
+  }
+}

package/assets/skills/explainer-kit/schemas/visual-review-result.v1.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.visual-review-result/v1",
+  "title": "VisualReviewResultV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "reviewId",
+    "requestId",
+    "requestHash",
+    "reviewedAt",
+    "disposition",
+    "artifactIds",
+    "findings"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "explainer-kit.visual-review-result/v1"
+    },
+    "reviewId": { "$ref": "#/$defs/safeId" },
+    "requestId": { "$ref": "#/$defs/safeId" },
+    "requestHash": { "$ref": "#/$defs/hash" },
+    "reviewedAt": { "type": "string", "format": "date-time" },
+    "disposition": { "enum": ["pass", "correct", "fail"] },
+    "artifactIds": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/safeId" },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" },
+      "uniqueItems": true
+    }
+  },
+  "$defs": {
+    "safeId": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "artifactId",
+        "rubric",
+        "severity",
+        "evidence",
+        "correction"
+      ],
+      "properties": {
+        "artifactId": { "$ref": "#/$defs/safeId" },
+        "rubric": {
+          "enum": [
+            "first-viewport",
+            "hierarchy",
+            "representation",
+            "legibility",
+            "medium-fit",
+            "cohesion",
+            "coverage",
+            "redundancy",
+            "interaction"
+          ]
+        },
+        "severity": {
+          "enum": ["critical", "important", "medium", "minor"]
+        },
+        "evidence": { "type": "string", "minLength": 1 },
+        "correction": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}