@deksden-com/dd-flow-cli 0.2.0 → 0.3.0

package/dist/schemas/global-dashboard-data.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/global-dashboard-data@1",
+  "title": "dd-flow global dashboard data",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_id", "generated_at", "target_language", "page", "metrics", "project_cards", "warnings"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/global-dashboard-data@1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "target_language": { "type": "string", "minLength": 2 },
+    "page": { "$ref": "#/definitions/page" },
+    "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
+    "metrics": { "type": "array", "items": { "$ref": "#/definitions/metric" } },
+    "project_cards": { "type": "array", "items": { "$ref": "#/definitions/card" } },
+    "warnings": { "type": "array" }
+  },
+  "definitions": {
+    "page": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["kind", "screen_id", "title", "html_path", "json_path"],
+      "properties": {
+        "kind": { "const": "global" },
+        "screen_id": { "const": "SCR-DD-FLOW-GLOBAL-DASHBOARD" },
+        "title": { "type": "string", "minLength": 1 },
+        "html_path": { "type": "string", "minLength": 1 },
+        "json_path": { "type": "string", "minLength": 1 }
+      }
+    },
+    "metric": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "label", "value", "status", "source"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "value": { "type": ["number", "null"] },
+        "status": { "type": "string", "enum": ["known", "unknown", "degraded", "not_applicable"] },
+        "source": { "type": "string", "minLength": 1 }
+      }
+    },
+    "link": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["label", "href", "path_kind", "status"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1 },
+        "href": { "type": "string" },
+        "path_kind": { "type": "string", "enum": ["absolute", "relative"] },
+        "status": { "type": "string", "enum": ["available", "pending", "missing", "not_applicable"] },
+        "degraded_reason": { "type": "string" }
+      }
+    },
+    "card": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "display_status", "action_level", "metrics"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "action_level": { "type": "string", "enum": ["none", "watch", "actionable", "blocked"] },
+        "metrics": { "type": "object" }
+      }
+    }
+  }
+}

package/dist/schemas/mb-sdlc-review-report.schema.json

@@ -0,0 +1,242 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/mb-sdlc-review-report@1",
+  "title": "mb-sdlc-review report",
+  "description": "Canonical data contract for project-level mb-sdlc-review stage-report.json.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "schema_id",
+    "run",
+    "review_focus",
+    "source_map",
+    "aspect_coverage",
+    "critic_pass",
+    "findings_register",
+    "conformance_summary",
+    "review_fix_recommendation",
+    "deferrals",
+    "dashboard_links"
+  ],
+  "properties": {
+    "schema_version": { "const": "1.0.0" },
+    "schema_id": { "const": "dd-flow/mb-sdlc-review-report@1" },
+    "run": { "$ref": "#/definitions/run" },
+    "review_focus": { "$ref": "#/definitions/reviewFocus" },
+    "source_map": { "$ref": "#/definitions/sourceMap" },
+    "aspect_coverage": {
+      "type": "array",
+      "minItems": 12,
+      "items": { "$ref": "#/definitions/aspectCoverage" }
+    },
+    "critic_pass": { "$ref": "#/definitions/criticPass" },
+    "findings_register": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/finding" }
+    },
+    "conformance_summary": { "$ref": "#/definitions/conformanceSummary" },
+    "review_fix_recommendation": { "$ref": "#/definitions/reviewFixRecommendation" },
+    "deferrals": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/deferral" }
+    },
+    "dashboard_links": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/link" }
+    }
+  },
+  "definitions": {
+    "nonEmptyString": { "type": "string", "minLength": 1 },
+    "run": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["run_id", "project_id", "project_root", "generated_at", "report_dir", "stage_report_path", "html_report_path", "final_report_path"],
+      "properties": {
+        "run_id": { "$ref": "#/definitions/nonEmptyString" },
+        "project_id": { "$ref": "#/definitions/nonEmptyString" },
+        "project_root": { "$ref": "#/definitions/nonEmptyString" },
+        "generated_at": { "type": "string", "format": "date-time" },
+        "report_dir": { "$ref": "#/definitions/nonEmptyString" },
+        "stage_report_path": { "$ref": "#/definitions/nonEmptyString" },
+        "html_report_path": { "$ref": "#/definitions/nonEmptyString" },
+        "final_report_path": { "$ref": "#/definitions/nonEmptyString" },
+        "target_language": { "type": "string" }
+      }
+    },
+    "reviewFocus": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "target", "title", "summary"],
+      "properties": {
+        "mode": {
+          "enum": ["whole_project", "latest_protocol", "specific_protocol", "protocol_set", "subsystem_or_spec_area", "feature_or_epic", "diff_or_commit_range"]
+        },
+        "target": { "$ref": "#/definitions/nonEmptyString" },
+        "title": { "$ref": "#/definitions/nonEmptyString" },
+        "summary": { "$ref": "#/definitions/nonEmptyString" },
+        "related_protocol_id": { "type": "string" },
+        "related_protocol_set": { "type": "string" }
+      }
+    },
+    "sourceMap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sources", "missing_expected_sources", "notes"],
+      "properties": {
+        "sources": { "type": "array", "items": { "$ref": "#/definitions/source" } },
+        "missing_expected_sources": { "type": "array", "items": { "$ref": "#/definitions/source" } },
+        "notes": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "path", "status"],
+      "properties": {
+        "kind": { "enum": ["spec", "feature", "epic", "adr", "scenario", "protocol", "protocol_set", "evidence", "code", "test", "policy", "def", "dashboard", "run", "other"] },
+        "path": { "$ref": "#/definitions/nonEmptyString" },
+        "status": { "enum": ["available", "missing", "not_applicable", "degraded"] },
+        "summary": { "type": "string" }
+      }
+    },
+    "aspectCoverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["aspect_id", "applicability", "coverage_mode", "status", "verdict", "reason", "task_packet_path", "report_path", "findings"],
+      "properties": {
+        "aspect_id": { "$ref": "#/definitions/aspectId" },
+        "applicability": { "enum": ["applicable", "not_applicable", "blocked"] },
+        "coverage_mode": { "enum": ["self_review", "focused_subagent", "multi_subagent", "external_tool", "degraded"] },
+        "status": { "enum": ["selected", "reviewed", "not_applicable", "blocked", "degraded"] },
+        "verdict": { "enum": ["pass", "watch", "fail", "blocked", "not_applicable", "degraded"] },
+        "reason": { "$ref": "#/definitions/nonEmptyString" },
+        "task_packet_path": { "type": "string" },
+        "report_path": { "type": "string" },
+        "findings": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "aspectId": {
+      "enum": [
+        "structure_navigation_review",
+        "feature_epic_layer_review",
+        "spec_conformance_review",
+        "architecture_harmonization_review",
+        "adr_decision_review",
+        "scenario_evidence_review",
+        "contract_traceability_review",
+        "frontmatter_crosslink_review",
+        "engineering_standards_review",
+        "operations_policy_review",
+        "protocol_delivery_trace_review",
+        "def_followup_review"
+      ]
+    },
+    "criticPass": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["candidate_count", "accepted_count", "rejected_count", "critics", "decisions"],
+      "properties": {
+        "candidate_count": { "type": "integer", "minimum": 0 },
+        "accepted_count": { "type": "integer", "minimum": 0 },
+        "rejected_count": { "type": "integer", "minimum": 0 },
+        "critics": { "type": "array", "items": { "$ref": "#/definitions/critic" } },
+        "decisions": { "type": "array", "items": { "$ref": "#/definitions/criticDecision" } }
+      }
+    },
+    "critic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "mode", "verdict", "summary"],
+      "properties": {
+        "id": { "$ref": "#/definitions/nonEmptyString" },
+        "mode": { "enum": ["universal", "architectural_harmonization", "focused"] },
+        "verdict": { "enum": ["accepted", "accepted_with_downgrades", "degraded", "blocked"] },
+        "summary": { "$ref": "#/definitions/nonEmptyString" }
+      }
+    },
+    "criticDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["candidate_id", "disposition", "rationale"],
+      "properties": {
+        "candidate_id": { "$ref": "#/definitions/nonEmptyString" },
+        "finding_id": { "type": "string" },
+        "disposition": { "enum": ["accepted", "downgraded", "rejected", "duplicate", "def_candidate", "review_fix_candidate"] },
+        "rationale": { "$ref": "#/definitions/nonEmptyString" }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "severity", "confidence", "title", "problem", "impact", "recommended_action", "affected_objects", "evidence"],
+      "properties": {
+        "id": { "pattern": "^FIND-SDLC-REVIEW-[0-9]{3}$" },
+        "type": { "enum": ["project_defect", "spec_drift", "code_drift", "memory_bank_gap", "frontmatter_crosslink_gap", "coding_standards_gap", "policy_process_gap", "evidence_gap", "observation", "rejected_noise"] },
+        "severity": { "enum": ["blocking", "major", "minor", "informational"] },
+        "confidence": { "enum": ["high", "medium", "low"] },
+        "title": { "$ref": "#/definitions/nonEmptyString" },
+        "problem": { "$ref": "#/definitions/nonEmptyString" },
+        "impact": { "$ref": "#/definitions/nonEmptyString" },
+        "recommended_action": { "$ref": "#/definitions/nonEmptyString" },
+        "disposition": { "enum": ["fix_now", "create_protocol", "create_protocol_set", "create_DEF", "report_only", "reject"] },
+        "affected_objects": { "type": "array", "items": { "$ref": "#/definitions/source" } },
+        "evidence": { "type": "array", "items": { "$ref": "#/definitions/source" } }
+      }
+    },
+    "conformanceSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["overall_verdict", "summary", "items"],
+      "properties": {
+        "overall_verdict": { "enum": ["accepted", "accepted_with_findings", "failed", "blocked", "degraded"] },
+        "summary": { "$ref": "#/definitions/nonEmptyString" },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "label", "status", "summary"],
+            "properties": {
+              "id": { "$ref": "#/definitions/nonEmptyString" },
+              "label": { "$ref": "#/definitions/nonEmptyString" },
+              "status": { "enum": ["pass", "watch", "fail", "blocked", "not_applicable", "degraded"] },
+              "summary": { "$ref": "#/definitions/nonEmptyString" }
+            }
+          }
+        }
+      }
+    },
+    "reviewFixRecommendation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["required", "strategy", "next_action", "candidate_protocols"],
+      "properties": {
+        "required": { "type": "boolean" },
+        "strategy": { "enum": ["none", "single_protocol", "protocol_set", "DEF", "user_decision_required"] },
+        "next_action": { "$ref": "#/definitions/nonEmptyString" },
+        "candidate_protocols": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "deferral": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "reason", "next_gate"],
+      "properties": {
+        "id": { "$ref": "#/definitions/nonEmptyString" },
+        "reason": { "$ref": "#/definitions/nonEmptyString" },
+        "next_gate": { "$ref": "#/definitions/nonEmptyString" }
+      }
+    },
+    "link": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "href", "status"],
+      "properties": {
+        "label": { "$ref": "#/definitions/nonEmptyString" },
+        "href": { "type": "string" },
+        "status": { "enum": ["available", "pending", "missing", "not_applicable"] }
+      }
+    }
+  }
+}

package/dist/schemas/plan-stage-report.schema.json

@@ -65,6 +65,29 @@
         }
       }
     },
+    "task_profile": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "size": {"type": "string"},
+        "risk": {"type": "string"},
+        "planning_route_hint": {"type": "string"},
+        "execution_mode_hint": {"type": "string"},
+        "verification_mode": {"type": "string"}
+      }
+    },
+    "route_decision": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "selected_planning_route": {"type": "string"},
+        "selected_execution_mode": {"type": "string"},
+        "selected_git_route": {"type": "string"},
+        "selected_verification_depth": {"type": "string"},
+        "selected_evidence_level": {"type": "string"},
+        "reason": {"type": "string"}
+      }
+    },
     "graph": {
       "type": "object",
       "additionalProperties": false,
@@ -130,6 +153,51 @@
         }
       }
     },
+    "sdlc_contours": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "summary": {"type": "string"},
+        "contours": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["name", "applicability_status", "gate_status", "summary"],
+            "properties": {
+              "name": {"type": "string", "minLength": 1},
+              "applicability_status": {"type": "string", "minLength": 1},
+              "verification_state": {"type": "string"},
+              "closure_state": {"type": "string"},
+              "gate_status": {"type": "string", "minLength": 1},
+              "target_stage": {"type": "string"},
+              "delivery_target": {"type": "string"},
+              "summary": {"type": "string", "minLength": 1},
+              "reason": {"type": "string"},
+              "evidence": {"type": "string"},
+              "next_action": {"type": "string"}
+            }
+          }
+        },
+        "policy_migration": {"type": "string"},
+        "next_delivery_action": {"type": "string"}
+      }
+    },
+    "links": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/link" },
+      "properties": {
+        "global_dashboard": { "$ref": "#/definitions/link" },
+        "project_dashboard": { "$ref": "#/definitions/link" },
+        "protocol_page": { "$ref": "#/definitions/link" },
+        "run_index": { "$ref": "#/definitions/link" },
+        "run_summary": { "$ref": "#/definitions/link" },
+        "protocol_source": { "$ref": "#/definitions/link" },
+        "protocol_summary": { "$ref": "#/definitions/link" },
+        "previous_stage_report": { "$ref": "#/definitions/link" },
+        "next_stage_report": { "$ref": "#/definitions/link" }
+      }
+    },
     "plan_items": {
       "type": "array",
       "minItems": 1,
@@ -168,5 +236,20 @@
         "next_gate": {"type": "string", "minLength": 1}
       }
     }
+  },
+  "definitions": {
+    "link": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["href", "label", "path_kind", "status"],
+      "properties": {
+        "href": { "type": "string" },
+        "label": { "type": "string", "minLength": 1 },
+        "path_kind": { "type": "string", "enum": ["relative", "absolute"] },
+        "status": { "type": "string", "enum": ["available", "pending", "missing", "not_applicable"] },
+        "degraded_reason": { "type": "string" },
+        "source": { "type": "string" }
+      }
+    }
   }
 }

package/dist/schemas/project-dashboard-data.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/project-dashboard-data@1",
+  "title": "dd-flow project dashboard data",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_id", "generated_at", "target_language", "page", "project", "metrics", "protocol_cards", "warnings"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/project-dashboard-data@1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "target_language": { "type": "string", "minLength": 2 },
+    "page": { "$ref": "#/definitions/page" },
+    "project": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "root", "status", "updated_at"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "root": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "updated_at": { "type": "string", "minLength": 1 }
+      }
+    },
+    "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
+    "metrics": { "type": "array", "items": { "$ref": "#/definitions/metric" } },
+    "protocol_cards": { "type": "array", "items": { "$ref": "#/definitions/protocolCard" } },
+    "review_runs": { "type": "array", "items": { "$ref": "#/definitions/reviewRun" } },
+    "merge_queue": { "type": "array" },
+    "sessions": { "type": "array" },
+    "locks": { "type": "array" },
+    "warnings": { "type": "array" }
+  },
+  "definitions": {
+    "page": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["kind", "screen_id", "title", "html_path", "json_path"],
+      "properties": {
+        "kind": { "const": "project" },
+        "screen_id": { "const": "SCR-DD-FLOW-PROJECT-DASHBOARD" },
+        "title": { "type": "string", "minLength": 1 },
+        "html_path": { "type": "string", "minLength": 1 },
+        "json_path": { "type": "string", "minLength": 1 }
+      }
+    },
+    "metric": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "label", "value", "status", "source"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "value": { "type": ["number", "null"] },
+        "status": { "type": "string", "enum": ["known", "unknown", "degraded", "not_applicable"] },
+        "source": { "type": "string", "minLength": 1 }
+      }
+    },
+    "link": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["label", "href", "path_kind", "status"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1 },
+        "href": { "type": "string" },
+        "path_kind": { "type": "string", "enum": ["absolute", "relative"] },
+        "status": { "type": "string", "enum": ["available", "pending", "missing", "not_applicable"] },
+        "degraded_reason": { "type": "string" }
+      }
+    },
+    "protocolCard": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "display_status", "action_level", "current_stage", "href"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "action_level": { "type": "string", "enum": ["none", "watch", "actionable", "blocked"] },
+        "current_stage": { "type": "string", "minLength": 1 },
+        "href": { "type": "string", "minLength": 1 }
+      }
+    },
+    "reviewRun": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "flow_kind", "status", "display_status"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "flow_kind": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "subject_id": { "type": "string" }
+      }
+    }
+  }
+}

package/dist/schemas/project-flow-pack-manifest.schema.json

@@ -32,6 +32,10 @@
       "type": "string",
       "minLength": 1
     },
+    "canon_memory_bank_root": {
+      "type": "string",
+      "minLength": 1
+    },
     "canon_flow_root": {
       "type": "string",
       "minLength": 1
@@ -101,7 +105,7 @@
         }
       },
       "then": {
-        "required": ["canon_version_at_source_commit", "flow_contract"]
+        "required": ["canon_memory_bank_root", "canon_flow_root", "canon_version_at_source_commit", "flow_contract"]
       }
     }
   ],

package/dist/schemas/protocol-dashboard-data.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/protocol-dashboard-data@1",
+  "title": "dd-flow protocol dashboard data",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_id", "generated_at", "target_language", "page", "project", "protocol", "primary_run_id", "run_history", "stage_pipeline", "metrics", "warnings"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/protocol-dashboard-data@1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "target_language": { "type": "string", "minLength": 2 },
+    "page": { "$ref": "#/definitions/page" },
+    "project": { "type": "object", "additionalProperties": true, "required": ["id", "title", "root"] },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "raw_status", "raw_stage", "display_status", "action_level", "updated_at"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "raw_status": { "type": "string", "minLength": 1 },
+        "raw_stage": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "action_level": { "type": "string", "enum": ["none", "watch", "actionable", "blocked"] },
+        "updated_at": { "type": "string", "minLength": 1 }
+      }
+    },
+    "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
+    "primary_run_id": { "type": ["string", "null"] },
+    "primary_run_reason": { "type": "string" },
+    "run_history": { "type": "array", "items": { "$ref": "#/definitions/run" } },
+    "review_runs": { "type": "array", "items": { "$ref": "#/definitions/run" } },
+    "stage_pipeline": { "type": "array" },
+    "metrics": { "type": "array", "items": { "$ref": "#/definitions/metric" } },
+    "warnings": { "type": "array" }
+  },
+  "definitions": {
+    "page": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["kind", "screen_id", "title", "html_path", "json_path"],
+      "properties": {
+        "kind": { "const": "protocol" },
+        "screen_id": { "const": "SCR-DD-FLOW-PROTOCOL-PAGE" },
+        "title": { "type": "string", "minLength": 1 },
+        "html_path": { "type": "string", "minLength": 1 },
+        "json_path": { "type": "string", "minLength": 1 }
+      }
+    },
+    "metric": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "label", "value", "status", "source"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "value": { "type": ["number", "null"] },
+        "status": { "type": "string", "enum": ["known", "unknown", "degraded", "not_applicable"] },
+        "source": { "type": "string", "minLength": 1 }
+      }
+    },
+    "link": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["label", "href", "path_kind", "status"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1 },
+        "href": { "type": "string" },
+        "path_kind": { "type": "string", "enum": ["absolute", "relative"] },
+        "status": { "type": "string", "enum": ["available", "pending", "missing", "not_applicable"] },
+        "degraded_reason": { "type": "string" }
+      }
+    },
+    "run": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "flow_kind", "display_flow_kind", "status", "display_status", "stages"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "flow_kind": { "type": "string", "minLength": 1 },
+        "display_flow_kind": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "stages": { "type": "array" }
+      }
+    }
+  }
+}