@unified-product-graph/core 0.25.1 → 0.26.1

package/dist/index.cjs

@@ -135,6 +135,8 @@ __export(index_exports, {
   backfillSlug: () => backfillSlug,
   buildTypeAliases: () => buildTypeAliases,
   canBeChildOf: () => canBeChildOf,
+  checkHeaderSeal: () => checkHeaderSeal,
+  checkHeaderSealText: () => checkHeaderSealText,
   coerceProductStage: () => coerceProductStage,
   collectSlugsForType: () => collectSlugsForType,
   compareVersions: () => compareVersions,
@@ -143,6 +145,9 @@ __export(index_exports, {
   concernFor: () => concernFor,
   concernGatesFor: () => concernGatesFor,
   crossProductScope: () => crossProductScope,
+  deriveCounts: () => deriveCounts,
+  derivePortfolioCounts: () => derivePortfolioCounts,
+  deriveSingleCounts: () => deriveSingleCounts,
   describeTreePattern: () => describeTreePattern,
   edgeCarriesProperties: () => edgeCarriesProperties,
   evaluateAntiPatterns: () => evaluateAntiPatterns,
@@ -1164,7 +1169,12 @@ var UPG_ENTITY_META = [
   // ── Program Management ──
   { name: "program", type_id: "ent_262", maturity: "stable", since: "0.1.0" },
   { name: "project", type_id: "ent_263", maturity: "stable", since: "0.1.0" },
-  { name: "milestone", type_id: "ent_264", maturity: "stable", since: "0.1.0" },
+  // `portfolio_shared` (0.25.1 feedback): a milestone is often a cross-team gate,
+  // not one project's checkpoint — an org-wide "Open Beta" that several products'
+  // projects must all satisfy. Shared tier lets `project_targets_milestone` (and
+  // the other milestone edges) pass the cross-scope gate as `provisional`, same
+  // as `project_implements_initiative`. Precedent: `planning_cycle` (0.20.0).
+  { name: "milestone", type_id: "ent_264", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "risk_register", type_id: "ent_265", maturity: "stable", since: "0.1.0" },
   { name: "risk_item", type_id: "ent_266", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "risk" },
   { name: "change_request", type_id: "ent_267", maturity: "stable", since: "0.1.0" },
@@ -4457,54 +4467,63 @@ var PRODUCT_LIFECYCLE = {
   phases: [
     {
       id: "concept",
+      status_category: "triage",
       label: "Concept",
       description: "Napkin idea. Problem shape and solution sketch, pre-validation.",
       transitions_to: ["validation", "build", "beta", "launch", "growth", "mature", "sunset"]
     },
     {
       id: "validation",
+      status_category: "started",
       label: "Validation",
       description: "Testing demand. User conversations and experiments pressure-test assumptions before build commits.",
       transitions_to: ["build", "beta", "launch", "growth", "mature", "sunset"]
     },
     {
       id: "build",
+      status_category: "started",
       label: "Build",
       description: "Actively developing v1. Core functionality is being authored, pre-user.",
       transitions_to: ["beta", "launch", "growth", "mature", "sunset"]
     },
     {
       id: "beta",
+      status_category: "started",
       label: "Beta",
       description: "Early users, iterating. Feature-complete enough to learn from, still changing weekly.",
       transitions_to: ["launch", "growth", "mature", "maintenance", "sunset"]
     },
     {
       id: "launch",
+      status_category: "started",
       label: "Launch",
       description: "Generally available. Announced to the target audience, open past beta access.",
       transitions_to: ["growth", "mature", "maintenance", "sunset"]
     },
     {
       id: "growth",
+      status_category: "started",
       label: "Growth",
       description: "Scaling users and revenue. Product fit validated; focus is acquisition, retention, expansion.",
       transitions_to: ["mature", "maintenance", "sunset"]
     },
     {
       id: "mature",
+      status_category: "started",
       label: "Mature",
       description: "Stable. Growth levelled; investment weights toward optimisation, efficiency, and durability.",
       transitions_to: ["maintenance", "sunset"]
     },
     {
       id: "maintenance",
+      status_category: "started",
       label: "Maintenance",
       description: "Sustaining. Minimal investment keeps the product running for existing users. Can transition back to `mature` on a strategic revival.",
       transitions_to: ["mature", "sunset"]
     },
     {
       id: "sunset",
+      status_category: "completed",
       label: "Sunset",
       description: "Winding down or retired. Existing users are being migrated or offboarded.",
       transitions_to: []
@@ -4518,18 +4537,21 @@ var NEED_LIFECYCLE = {
   phases: [
     {
       id: "raw",
+      status_category: "triage",
       label: "Raw",
       description: "Captured from an interview, observation, or support ticket. Articulation may be rough; may duplicate an existing need.",
       transitions_to: ["validated"]
     },
     {
       id: "validated",
+      status_category: "started",
       label: "Validated",
       description: "Corroborated by multiple data points or targeted research. The team agrees it is a real, recurring need.",
       transitions_to: ["prioritized"]
     },
     {
       id: "prioritized",
+      status_category: "completed",
       label: "Prioritized",
       description: "Ranked against other needs. Ready to inform opportunity definition and solution exploration.",
       transitions_to: []
@@ -4543,18 +4565,21 @@ var OPPORTUNITY_LIFECYCLE = {
   phases: [
     {
       id: "identified",
+      status_category: "triage",
       label: "Identified",
       description: "A problem worth solving has been named. Sources include needs, insights, market trends, or competitive signals. Sizing and validation come next.",
       transitions_to: ["validated", "deferred"]
     },
     {
       id: "validated",
+      status_category: "started",
       label: "Validated",
       description: "Research and evidence support pursuit. The problem is real, frequent, and painful enough to justify investment.",
       transitions_to: ["deferred"]
     },
     {
       id: "deferred",
+      status_category: "backlog",
       label: "Deferred",
       description: "Acknowledged but parked. Capacity, priority, or strategic timing reasons. Can be reopened.",
       transitions_to: ["identified"]
@@ -4568,24 +4593,28 @@ var SOLUTION_LIFECYCLE = {
   phases: [
     {
       id: "proposed",
+      status_category: "triage",
       label: "Proposed",
       description: "Identified as a possible response to an opportunity. Pre-commitment, pre-feasibility.",
       transitions_to: ["in_progress", "deferred"]
     },
     {
       id: "in_progress",
+      status_category: "started",
       label: "In Progress",
       description: "A team is actively building, testing, or refining the solution.",
       transitions_to: ["shipped", "deferred"]
     },
     {
       id: "shipped",
+      status_category: "completed",
       label: "Shipped",
       description: "Delivered to users. Live in the product.",
       transitions_to: ["deferred"]
     },
     {
       id: "deferred",
+      status_category: "backlog",
       label: "Deferred",
       description: "Acknowledged but parked. Capacity, priority, or a change in direction. Can be reopened.",
       transitions_to: ["proposed"]
@@ -4599,24 +4628,28 @@ var EXPERIMENT_PLAN_LIFECYCLE = {
   phases: [
     {
       id: "drafted",
+      status_category: "unstarted",
       label: "Drafted",
       description: "The plan is being written. Method, success criteria, target metric, projected reach/impact, ownership, and planned dates are being defined. Not yet approved.",
       transitions_to: ["scheduled", "cancelled"]
     },
     {
       id: "scheduled",
+      status_category: "unstarted",
       label: "Scheduled",
       description: "The plan is approved and slotted for execution. Resources committed; awaiting start date.",
       transitions_to: ["approved", "cancelled"]
     },
     {
       id: "approved",
+      status_category: "completed",
       label: "Approved",
       description: "Past scheduling: at least one run has started or completed against this plan. The plan is now a stable design artefact; future updates create a new plan.",
       transitions_to: []
     },
     {
       id: "cancelled",
+      status_category: "cancelled",
       label: "Cancelled",
       description: "The plan was abandoned before any run started. Reason should be documented in description or via an attached decision.",
       transitions_to: []
@@ -4630,24 +4663,28 @@ var RESEARCH_PLAN_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "The plan is being written. Research question, suggested methods, and evidence threshold are being defined. Not yet approved for execution.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The plan has been approved and is being executed. Research sessions are underway or scheduled.",
       transitions_to: ["completed", "abandoned"]
     },
     {
       id: "completed",
+      status_category: "completed",
       label: "Completed",
       description: "The planned research has been carried out and learnings have been captured. The plan is a historical record.",
       transitions_to: []
     },
     {
       id: "abandoned",
+      status_category: "cancelled",
       label: "Abandoned",
       description: "Not executed: changing priorities, a decision no longer needing validation, or resource constraints.",
       transitions_to: []
@@ -4661,24 +4698,28 @@ var FEEDBACK_PROGRAM_LIFECYCLE = {
   phases: [
     {
       id: "planning",
+      status_category: "unstarted",
       label: "Planning",
       description: "The program is being designed. Goals, audience, collection method, and cadence are being defined. No feedback is being collected yet.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The program is running. Feedback is being collected and processed on the defined cadence.",
       transitions_to: ["paused", "retired"]
     },
     {
       id: "paused",
+      status_category: "backlog",
       label: "Paused",
       description: "Collection has been temporarily suspended. The program will resume.",
       transitions_to: ["active", "retired"]
     },
     {
       id: "retired",
+      status_category: "completed",
       label: "Retired",
       description: "The program has ended. It is no longer collecting feedback. Historical data is preserved.",
       transitions_to: []
@@ -4692,36 +4733,42 @@ var FEATURE_REQUEST_LIFECYCLE = {
   phases: [
     {
       id: "new",
+      status_category: "triage",
       label: "New",
       description: "The request has been submitted. It has not yet been reviewed by the product team.",
       transitions_to: ["under_review"]
     },
     {
       id: "under_review",
+      status_category: "triage",
       label: "Under Review",
       description: "The request is being triaged. The product team is assessing feasibility, demand, and strategic fit.",
       transitions_to: ["planned", "wont_do"]
     },
     {
       id: "planned",
+      status_category: "unstarted",
       label: "Planned",
       description: "The request has been accepted and is on the roadmap. It is scheduled for a future release cycle.",
       transitions_to: ["in_progress", "wont_do"]
     },
     {
       id: "in_progress",
+      status_category: "started",
       label: "In Progress",
       description: "Work on fulfilling the request is actively underway.",
       transitions_to: ["shipped"]
     },
     {
       id: "shipped",
+      status_category: "completed",
       label: "Shipped",
       description: "The requested capability has been delivered to users.",
       transitions_to: []
     },
     {
       id: "wont_do",
+      status_category: "cancelled",
       label: "Won't Do",
       description: "Declined: strategic misalignment, infeasibility, or insufficient demand.",
       transitions_to: []
@@ -4735,24 +4782,28 @@ var BETA_PROGRAM_LIFECYCLE = {
   phases: [
     {
       id: "recruiting",
+      status_category: "started",
       label: "Recruiting",
       description: "The program is accepting applications. Beta participants are being identified and onboarded.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "Beta participants have access and are using the feature. Feedback is being collected.",
       transitions_to: ["graduated", "closed"]
     },
     {
       id: "graduated",
+      status_category: "completed",
       label: "Graduated",
       description: "The beta was successful and the feature has progressed to general availability.",
       transitions_to: []
     },
     {
       id: "closed",
+      status_category: "completed",
       label: "Closed",
       description: "The beta ended without graduating to GA. The feature was deprioritised, pivoted, or missed exit criteria.",
       transitions_to: []
@@ -4766,24 +4817,28 @@ var USER_ADVISORY_BOARD_LIFECYCLE = {
   phases: [
     {
       id: "recruiting",
+      status_category: "started",
       label: "Recruiting",
       description: "Members are being identified and invited. The board is not yet convened.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The board is convened and meeting regularly. Members are providing strategic input.",
       transitions_to: ["paused", "retired"]
     },
     {
       id: "paused",
+      status_category: "backlog",
       label: "Paused",
       description: "Board activities are temporarily suspended. Membership is retained and sessions will resume.",
       transitions_to: ["active", "retired"]
     },
     {
       id: "retired",
+      status_category: "completed",
       label: "Retired",
       description: "The board has been disbanded. Members are no longer engaged in an advisory capacity.",
       transitions_to: []
@@ -4797,30 +4852,35 @@ var OBJECTIVE_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "The objective is being written. Key results have not yet been attached or approved.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The objective is in the current planning period. Key results are being measured and progress is tracked.",
       transitions_to: ["achieved", "missed", "deferred"]
     },
     {
       id: "achieved",
+      status_category: "completed",
       label: "Achieved",
       description: "The objective was met or exceeded within the planning period.",
       transitions_to: []
     },
     {
       id: "missed",
+      status_category: "completed",
       label: "Missed",
       description: "The planning period ended without achieving the objective. Learnings inform the next cycle.",
       transitions_to: []
     },
     {
       id: "deferred",
+      status_category: "backlog",
       label: "Deferred",
       description: "The objective was not completed this period and is being carried forward. Can be reopened as active.",
       transitions_to: ["active"]
@@ -4834,24 +4894,28 @@ var KEY_RESULT_LIFECYCLE = {
   phases: [
     {
       id: "on_track",
+      status_category: "started",
       label: "On Track",
       description: "Current measured value is progressing at a rate that should reach the target by the deadline.",
       transitions_to: ["at_risk", "behind", "achieved"]
     },
     {
       id: "at_risk",
+      status_category: "started",
       label: "At Risk",
       description: "Progress is slowing. Without intervention, the target may not be reached by the deadline.",
       transitions_to: ["on_track", "behind", "achieved"]
     },
     {
       id: "behind",
+      status_category: "started",
       label: "Behind",
       description: "Unlikely to reach the target at the current rate. The team needs to reassess strategy or accept a miss.",
       transitions_to: ["on_track", "at_risk", "achieved"]
     },
     {
       id: "achieved",
+      status_category: "completed",
       label: "Achieved",
       description: "The target value has been reached or exceeded.",
       transitions_to: []
@@ -4865,18 +4929,21 @@ var STRATEGIC_THEME_LIFECYCLE = {
   phases: [
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The theme is a current organisational focus. Initiatives and objectives are being run under it.",
       transitions_to: ["completed", "paused"]
     },
     {
       id: "paused",
+      status_category: "backlog",
       label: "Paused",
       description: "The theme is deprioritised for this period but is not being retired. It will resume.",
       transitions_to: ["active", "completed"]
     },
     {
       id: "completed",
+      status_category: "completed",
       label: "Completed",
       description: "The theme has run its course. The focus area has been addressed or superseded by a new theme.",
       transitions_to: []
@@ -4890,24 +4957,28 @@ var INITIATIVE_LIFECYCLE = {
   phases: [
     {
       id: "proposed",
+      status_category: "triage",
       label: "Proposed",
       description: "The initiative has been put forward but not yet approved for resourcing. Business case is being evaluated.",
       transitions_to: ["in_progress", "abandoned"]
     },
     {
       id: "in_progress",
+      status_category: "started",
       label: "In Progress",
       description: "The initiative has been approved and work is underway. Teams are executing against it.",
       transitions_to: ["completed", "abandoned"]
     },
     {
       id: "completed",
+      status_category: "completed",
       label: "Completed",
       description: "The initiative has achieved its goals and been formally closed.",
       transitions_to: []
     },
     {
       id: "abandoned",
+      status_category: "cancelled",
       label: "Abandoned",
       description: "Stopped before completion: changing strategy, resource constraints, or learning that the goal is no longer relevant.",
       transitions_to: []
@@ -4921,18 +4992,21 @@ var STRATEGIC_PILLAR_LIFECYCLE = {
   phases: [
     {
       id: "proposed",
+      status_category: "triage",
       label: "Proposed",
       description: "The pillar has been articulated but not yet ratified by leadership as a strategic commitment.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The pillar is a live strategic commitment. Decisions, themes, and initiatives are aligned to it.",
       transitions_to: ["sunset"]
     },
     {
       id: "sunset",
+      status_category: "completed",
       label: "Sunset",
       description: "Retired: achieved, superseded by a new direction, or no longer reflects strategic reality.",
       transitions_to: []
@@ -4944,8 +5018,8 @@ var STRATEGIC_QUESTION_LIFECYCLE = {
   initial_phase: "open",
   terminal_phases: ["resolved"],
   phases: [
-    { id: "open", label: "Open", description: "The question has been raised but not yet answered. The plan is exposed to it.", transitions_to: ["resolved"] },
-    { id: "resolved", label: "Resolved", description: "The question has been answered; the resolution is captured. The plan is no longer exposed to it. May reopen if the answer unravels.", transitions_to: ["open"] }
+    { id: "open", status_category: "triage", label: "Open", description: "The question has been raised but not yet answered. The plan is exposed to it.", transitions_to: ["resolved"] },
+    { id: "resolved", status_category: "completed", label: "Resolved", description: "The question has been answered; the resolution is captured. The plan is no longer exposed to it. May reopen if the answer unravels.", transitions_to: ["open"] }
   ]
 };
 var OUTCOME_LIFECYCLE = {
@@ -4953,10 +5027,10 @@ var OUTCOME_LIFECYCLE = {
   initial_phase: "identified",
   terminal_phases: ["achieved", "abandoned"],
   phases: [
-    { id: "identified", label: "Identified", description: "The outcome has been named: the team agrees on what success looks like, but is not yet measuring it.", transitions_to: ["measuring", "abandoned"] },
-    { id: "measuring", label: "Measuring", description: "Instrumentation is live. Progress is being tracked against the outcome.", transitions_to: ["achieved", "abandoned"] },
-    { id: "achieved", label: "Achieved", description: "The outcome was reached. Captured for the record; no further pursuit required.", transitions_to: [] },
-    { id: "abandoned", label: "Abandoned", description: "Pursuit was stopped. Strategy shifted, the outcome lost relevance, or the cost outweighed value. May resume to `measuring` if the team revisits it.", transitions_to: ["measuring"] }
+    { id: "identified", status_category: "triage", label: "Identified", description: "The outcome has been named: the team agrees on what success looks like, but is not yet measuring it.", transitions_to: ["measuring", "abandoned"] },
+    { id: "measuring", status_category: "started", label: "Measuring", description: "Instrumentation is live. Progress is being tracked against the outcome.", transitions_to: ["achieved", "abandoned"] },
+    { id: "achieved", status_category: "completed", label: "Achieved", description: "The outcome was reached. Captured for the record; no further pursuit required.", transitions_to: [] },
+    { id: "abandoned", status_category: "cancelled", label: "Abandoned", description: "Pursuit was stopped. Strategy shifted, the outcome lost relevance, or the cost outweighed value. May resume to `measuring` if the team revisits it.", transitions_to: ["measuring"] }
   ]
 };
 var VISION_LIFECYCLE = {
@@ -4964,10 +5038,10 @@ var VISION_LIFECYCLE = {
   initial_phase: "drafting",
   terminal_phases: ["ratified", "revised", "archived"],
   phases: [
-    { id: "drafting", label: "Drafting", description: "Vision is being authored or rewritten. Not yet adopted.", transitions_to: ["ratified", "archived"] },
-    { id: "ratified", label: "Ratified", description: "The current, in-force vision. The team has aligned around it.", transitions_to: ["revised", "archived"] },
-    { id: "revised", label: "Revised", description: "Superseded by a newer vision but kept as a recorded milestone. May reopen to drafting if revisited.", transitions_to: ["drafting"] },
-    { id: "archived", label: "Archived", description: "No longer in force. Retained for historical reference.", transitions_to: ["drafting"] }
+    { id: "drafting", status_category: "started", label: "Drafting", description: "Vision is being authored or rewritten. Not yet adopted.", transitions_to: ["ratified", "archived"] },
+    { id: "ratified", status_category: "completed", label: "Ratified", description: "The current, in-force vision. The team has aligned around it.", transitions_to: ["revised", "archived"] },
+    { id: "revised", status_category: "completed", label: "Revised", description: "Superseded by a newer vision but kept as a recorded milestone. May reopen to drafting if revisited.", transitions_to: ["drafting"] },
+    { id: "archived", status_category: "completed", label: "Archived", description: "No longer in force. Retained for historical reference.", transitions_to: ["drafting"] }
   ]
 };
 var MISSION_LIFECYCLE = {
@@ -4975,9 +5049,9 @@ var MISSION_LIFECYCLE = {
   initial_phase: "drafting",
   terminal_phases: ["active", "archived"],
   phases: [
-    { id: "drafting", label: "Drafting", description: "Mission is being authored or rewritten. Not yet adopted.", transitions_to: ["active", "archived"] },
-    { id: "active", label: "Active", description: "The current, in-force mission. Guides product and organisational decisions.", transitions_to: ["archived"] },
-    { id: "archived", label: "Archived", description: "No longer in force. May reopen to drafting if the team revisits.", transitions_to: ["drafting"] }
+    { id: "drafting", status_category: "started", label: "Drafting", description: "Mission is being authored or rewritten. Not yet adopted.", transitions_to: ["active", "archived"] },
+    { id: "active", status_category: "started", label: "Active", description: "The current, in-force mission. Guides product and organisational decisions.", transitions_to: ["archived"] },
+    { id: "archived", status_category: "completed", label: "Archived", description: "No longer in force. May reopen to drafting if the team revisits.", transitions_to: ["drafting"] }
   ]
 };
 var CAPABILITY_LIFECYCLE = {
@@ -4985,10 +5059,10 @@ var CAPABILITY_LIFECYCLE = {
   initial_phase: "planned",
   terminal_phases: ["operational", "retired"],
   phases: [
-    { id: "planned", label: "Planned", description: "Capability has been identified as needed but development has not started.", transitions_to: ["building", "retired"] },
-    { id: "building", label: "Building", description: "Active development: people, processes, or systems are being put in place.", transitions_to: ["operational", "retired"] },
-    { id: "operational", label: "Operational", description: "Capability is in place and functioning. The organisation can rely on it.", transitions_to: ["retired"] },
-    { id: "retired", label: "Retired", description: "No longer maintained. May reopen to building if the capability is reinvested in.", transitions_to: ["building"] }
+    { id: "planned", status_category: "unstarted", label: "Planned", description: "Capability has been identified as needed but development has not started.", transitions_to: ["building", "retired"] },
+    { id: "building", status_category: "started", label: "Building", description: "Active development: people, processes, or systems are being put in place.", transitions_to: ["operational", "retired"] },
+    { id: "operational", status_category: "started", label: "Operational", description: "Capability is in place and functioning. The organisation can rely on it.", transitions_to: ["retired"] },
+    { id: "retired", status_category: "completed", label: "Retired", description: "No longer maintained. May reopen to building if the capability is reinvested in.", transitions_to: ["building"] }
   ]
 };
 var FEATURE_AREA_LIFECYCLE = {
@@ -4998,18 +5072,21 @@ var FEATURE_AREA_LIFECYCLE = {
   phases: [
     {
       id: "planned",
+      status_category: "unstarted",
       label: "Planned",
       description: "The feature area has been defined as an organising concept but no features have been built under it yet.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The feature area contains live features and is actively being developed.",
       transitions_to: ["deprecated"]
     },
     {
       id: "deprecated",
+      status_category: "completed",
       label: "Deprecated",
       description: "The feature area is no longer being developed. It may still exist in the product but no new features are being added.",
       transitions_to: []
@@ -5023,24 +5100,28 @@ var FEATURE_LIFECYCLE = {
   phases: [
     {
       id: "proposed",
+      status_category: "triage",
       label: "Proposed",
       description: "The feature has been suggested and is under consideration. It is not yet on the roadmap.",
       transitions_to: ["in_progress", "archived"]
     },
     {
       id: "in_progress",
+      status_category: "started",
       label: "In Progress",
       description: "The feature is actively being designed and built.",
       transitions_to: ["shipped"]
     },
     {
       id: "shipped",
+      status_category: "completed",
       label: "Shipped",
       description: "The feature is live in the product and available to users.",
       transitions_to: ["archived"]
     },
     {
       id: "archived",
+      status_category: "completed",
       label: "Archived",
       description: "The feature has been removed from the product or superseded. It is retained as a historical record.",
       transitions_to: []
@@ -5054,18 +5135,21 @@ var RELEASE_LIFECYCLE = {
   phases: [
     {
       id: "planned",
+      status_category: "unstarted",
       label: "Planned",
       description: "The release is defined and scheduled. Features are scoped but not all completed.",
       transitions_to: ["in_progress"]
     },
     {
       id: "in_progress",
+      status_category: "started",
       label: "In Progress",
       description: "Features are being built. The release is open for development.",
       transitions_to: ["shipped"]
     },
     {
       id: "shipped",
+      status_category: "completed",
       label: "Shipped",
       description: "The release has been deployed to production and is available to users.",
       transitions_to: []
@@ -5079,24 +5163,28 @@ var ROADMAP_ITEM_LIFECYCLE = {
   phases: [
     {
       id: "planned",
+      status_category: "unstarted",
       label: "Planned",
       description: "The item is on the roadmap and scheduled for a future period.",
       transitions_to: ["in_progress", "deferred"]
     },
     {
       id: "in_progress",
+      status_category: "started",
       label: "In Progress",
       description: "Work on this roadmap item is underway.",
       transitions_to: ["shipped", "deferred"]
     },
     {
       id: "shipped",
+      status_category: "completed",
       label: "Shipped",
       description: "The roadmap item has been delivered.",
       transitions_to: []
     },
     {
       id: "deferred",
+      status_category: "backlog",
       label: "Deferred",
       description: "The item has been pushed to a later period. It remains on the roadmap.",
       transitions_to: ["planned"]
@@ -5110,30 +5198,35 @@ var IP_ASSET_LIFECYCLE = {
   phases: [
     {
       id: "filed",
+      status_category: "started",
       label: "Filed",
       description: "The IP application has been submitted to the relevant authority. Acknowledgement of filing is pending.",
       transitions_to: ["pending", "abandoned"]
     },
     {
       id: "pending",
+      status_category: "started",
       label: "Pending",
       description: "The application has been acknowledged and is under examination by the relevant authority.",
       transitions_to: ["granted", "abandoned"]
     },
     {
       id: "granted",
+      status_category: "completed",
       label: "Granted",
       description: "The IP right has been formally granted. Protection is in force.",
       transitions_to: ["expired", "abandoned"]
     },
     {
       id: "expired",
+      status_category: "completed",
       label: "Expired",
       description: "The IP protection period has ended naturally.",
       transitions_to: []
     },
     {
       id: "abandoned",
+      status_category: "cancelled",
       label: "Abandoned",
       description: "Abandoned: non-payment of renewal fees, withdrawal of the application, or a decision to stop defending it.",
       transitions_to: []
@@ -5147,36 +5240,42 @@ var CONTRACT_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "The contract is being written. Terms are not yet agreed by all parties.",
       transitions_to: ["in_review"]
     },
     {
       id: "in_review",
+      status_category: "started",
       label: "In Review",
       description: "The draft is under review by legal counsel or the counterparty. Negotiations may be ongoing.",
       transitions_to: ["signed", "draft"]
     },
     {
       id: "signed",
+      status_category: "completed",
       label: "Signed",
       description: "All parties have signed. The contract is executed and legally binding, but the effective period may not have started yet.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The contract is in its effective period. Obligations are in force.",
       transitions_to: ["expired", "terminated"]
     },
     {
       id: "expired",
+      status_category: "completed",
       label: "Expired",
       description: "The contract has reached its end date naturally.",
       transitions_to: []
     },
     {
       id: "terminated",
+      status_category: "cancelled",
       label: "Terminated",
       description: "Ended before natural expiry: mutual agreement, breach, or exercise of a termination clause.",
       transitions_to: []
@@ -5190,24 +5289,28 @@ var DESIGN_CONCEPT_LIFECYCLE = {
   phases: [
     {
       id: "sketched",
+      status_category: "started",
       label: "Sketched",
       description: "The concept has been captured in early, rough form. It is an idea worth exploring but has not been refined or evaluated.",
       transitions_to: ["refined", "selected", "rejected"]
     },
     {
       id: "refined",
+      status_category: "started",
       label: "Refined",
       description: "The concept has been developed with more detail. It is being compared to other concepts in the selection process.",
       transitions_to: ["selected", "rejected"]
     },
     {
       id: "selected",
+      status_category: "completed",
       label: "Selected",
       description: "This concept has been chosen to move forward into prototyping or implementation.",
       transitions_to: []
     },
     {
       id: "rejected",
+      status_category: "cancelled",
       label: "Rejected",
       description: "This concept was evaluated and not selected. It is retained as a record of design exploration.",
       transitions_to: []
@@ -5221,18 +5324,21 @@ var BRAND_IDENTITY_LIFECYCLE = {
   phases: [
     {
       id: "exploratory",
+      status_category: "started",
       label: "Exploratory",
       description: "The brand is in early formation. Names, values, visual directions, and positioning are being explored without commitment.",
       transitions_to: ["defined"]
     },
     {
       id: "defined",
+      status_category: "started",
       label: "Defined",
       description: "Core brand elements have been decided. Name, values, visual identity, and voice are articulated. The brand is being applied but may still be evolving.",
       transitions_to: ["mature"]
     },
     {
       id: "mature",
+      status_category: "completed",
       label: "Mature",
       description: "The brand identity is fully articulated and consistently applied. Guidelines are documented and followed across all touchpoints.",
       transitions_to: []
@@ -5246,30 +5352,35 @@ var SCREEN_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "The screen is a rough idea: named and scoped, but not yet worked in a design tool.",
       transitions_to: ["in_design"]
     },
     {
       id: "in_design",
+      status_category: "started",
       label: "In Design",
       description: "The screen is being designed: wireframes, mockups, or prototypes are in progress. May fall back to `draft` if the approach is rethought from scratch.",
       transitions_to: ["built", "draft"]
     },
     {
       id: "built",
+      status_category: "started",
       label: "Built",
       description: "The screen has been implemented in code. It exists in a build but is not yet live for users. May return to `in_design` if implementation surfaces a design gap.",
       transitions_to: ["shipped", "in_design"]
     },
     {
       id: "shipped",
+      status_category: "completed",
       label: "Shipped",
       description: "The screen is live in production and reachable by users.",
       transitions_to: ["deprecated"]
     },
     {
       id: "deprecated",
+      status_category: "completed",
       label: "Deprecated",
       description: "The screen has been retired. It is no longer reachable, or is being phased out in favour of a replacement.",
       transitions_to: []
@@ -5283,24 +5394,28 @@ var SERVICE_LIFECYCLE = {
   phases: [
     {
       id: "development",
+      status_category: "started",
       label: "Development",
       description: "The service is being built. It is not available in any shared environment.",
       transitions_to: ["staging"]
     },
     {
       id: "staging",
+      status_category: "started",
       label: "Staging",
       description: "The service is deployed to a staging environment for integration testing and pre-release validation.",
       transitions_to: ["production", "development"]
     },
     {
       id: "production",
+      status_category: "started",
       label: "Production",
       description: "The service is live and serving real users.",
       transitions_to: ["deprecated"]
     },
     {
       id: "deprecated",
+      status_category: "completed",
       label: "Deprecated",
       description: "The service is being phased out. A successor service is in place or the capability is no longer needed.",
       transitions_to: []
@@ -5314,18 +5429,21 @@ var DEPLOYMENT_LIFECYCLE = {
   phases: [
     {
       id: "rolling",
+      status_category: "started",
       label: "Rolling",
       description: "The deployment is in progress. Instances are being updated. Not all traffic has shifted yet.",
       transitions_to: ["success", "failure"]
     },
     {
       id: "success",
+      status_category: "completed",
       label: "Success",
       description: "The deployment completed successfully. All instances are running the new version.",
       transitions_to: []
     },
     {
       id: "failure",
+      status_category: "completed",
       label: "Failure",
       description: "The deployment failed or was rolled back. The previous version is restored.",
       transitions_to: []
@@ -5339,18 +5457,21 @@ var FEATURE_FLAG_LIFECYCLE = {
   phases: [
     {
       id: "off",
+      status_category: "backlog",
       label: "Off",
       description: "The flag is disabled. The associated feature or code path is not active for any users.",
       transitions_to: ["rollout", "on"]
     },
     {
       id: "rollout",
+      status_category: "started",
       label: "Rollout",
       description: "The flag is partially enabled. A percentage of users or a target segment has access.",
       transitions_to: ["on", "off"]
     },
     {
       id: "on",
+      status_category: "completed",
       label: "On",
       description: "The flag is fully enabled for all users. The feature is live. The flag can be cleaned up.",
       transitions_to: []
@@ -5364,30 +5485,35 @@ var INVESTIGATION_LIFECYCLE = {
   phases: [
     {
       id: "open",
+      status_category: "triage",
       label: "Open",
       description: "The investigation has been opened. A problem has been identified but not yet actively worked.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The investigation is being actively worked. Evidence is being gathered and hypotheses are being tested.",
       transitions_to: ["paused", "resolved", "abandoned"]
     },
     {
       id: "paused",
+      status_category: "backlog",
       label: "Paused",
       description: "On hold: awaiting additional data, unblocking conditions, or reprioritisation.",
       transitions_to: ["active", "abandoned"]
     },
     {
       id: "resolved",
+      status_category: "completed",
       label: "Resolved",
       description: "Root cause has been identified and documented. The investigation is closed.",
       transitions_to: []
     },
     {
       id: "abandoned",
+      status_category: "cancelled",
       label: "Abandoned",
       description: "Closed without resolution: the problem could not be reproduced, was deemed not worth pursuing, or became moot.",
       transitions_to: []
@@ -5401,24 +5527,28 @@ var EXTERNAL_API_LIFECYCLE = {
   phases: [
     {
       id: "beta",
+      status_category: "started",
       label: "Beta",
       description: "The API is available for early access or testing. It may be unstable and subject to breaking changes.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The API is stable and in production use. The provider guarantees availability per their SLA.",
       transitions_to: ["deprecated", "unavailable"]
     },
     {
       id: "deprecated",
+      status_category: "started",
       label: "Deprecated",
       description: "The provider has announced end-of-life. The API still works but a migration to a successor is required.",
       transitions_to: ["unavailable"]
     },
     {
       id: "unavailable",
+      status_category: "completed",
       label: "Unavailable",
       description: "The API is no longer accessible. Any dependent service is broken until migrated.",
       transitions_to: []
@@ -5432,18 +5562,21 @@ var DATABASE_SCHEMA_LIFECYCLE = {
   phases: [
     {
       id: "current",
+      status_category: "started",
       label: "Current",
       description: "The schema is up to date with the applied migrations. No pending changes.",
       transitions_to: ["pending"]
     },
     {
       id: "pending",
+      status_category: "unstarted",
       label: "Pending",
       description: "A migration is queued and ready to run. The schema will change when it is applied.",
       transitions_to: ["current", "failed"]
     },
     {
       id: "failed",
+      status_category: "completed",
       label: "Failed",
       description: "A migration failed during application. The schema is in an inconsistent state and requires remediation before further changes can be applied.",
       transitions_to: ["pending"]
@@ -5457,30 +5590,35 @@ var INCIDENT_LIFECYCLE = {
   phases: [
     {
       id: "detected",
+      status_category: "triage",
       label: "Detected",
       description: "Identified by an alert, a user report, or direct observation. Response has not yet started.",
       transitions_to: ["triaged"]
     },
     {
       id: "triaged",
+      status_category: "triage",
       label: "Triaged",
       description: "The incident has been assessed for severity and impact. An on-call responder is assigned and is actively working it.",
       transitions_to: ["contained"]
     },
     {
       id: "contained",
+      status_category: "started",
       label: "Contained",
       description: "Immediate user impact stopped via rollback, circuit breaker, or another emergency measure. Root cause fix is still pending.",
       transitions_to: ["resolved", "mitigated"]
     },
     {
       id: "resolved",
+      status_category: "completed",
       label: "Resolved",
       description: "Root cause has been identified and fixed. The system is back to normal. A postmortem is recommended.",
       transitions_to: []
     },
     {
       id: "mitigated",
+      status_category: "completed",
       label: "Mitigated",
       description: "A compensating control is in place and user impact is stopped, but the root cause remains unfixed. A follow-up investigation or fix is required.",
       transitions_to: []
@@ -5494,24 +5632,28 @@ var SECURITY_CONTROL_LIFECYCLE = {
   phases: [
     {
       id: "planned",
+      status_category: "unstarted",
       label: "Planned",
       description: "The control has been identified as required but implementation has not started.",
       transitions_to: ["in_progress"]
     },
     {
       id: "in_progress",
+      status_category: "started",
       label: "In Progress",
       description: "The control is being implemented.",
       transitions_to: ["implemented"]
     },
     {
       id: "implemented",
+      status_category: "started",
       label: "Implemented",
       description: "The control is in place. It has not yet been independently tested or verified.",
       transitions_to: ["verified", "in_progress"]
     },
     {
       id: "verified",
+      status_category: "completed",
       label: "Verified",
       description: "The control has been tested and confirmed effective. It provides the intended security assurance.",
       transitions_to: []
@@ -5525,30 +5667,35 @@ var DATA_PIPELINE_LIFECYCLE = {
   phases: [
     {
       id: "building",
+      status_category: "started",
       label: "Building",
       description: "The pipeline is under construction. It is not yet processing real data.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The pipeline is running and processing data on its defined schedule.",
       transitions_to: ["paused", "failed", "deprecated"]
     },
     {
       id: "paused",
+      status_category: "backlog",
       label: "Paused",
       description: "Deliberately suspended: maintenance, cost control, or upstream data unavailability.",
       transitions_to: ["active", "deprecated"]
     },
     {
       id: "failed",
+      status_category: "started",
       label: "Failed",
       description: "The pipeline has errored and is not processing data. Intervention is required to restore it.",
       transitions_to: ["active"]
     },
     {
       id: "deprecated",
+      status_category: "completed",
       label: "Deprecated",
       description: "The pipeline is being retired. It is no longer maintained and will be shut down.",
       transitions_to: []
@@ -5562,30 +5709,35 @@ var AI_MODEL_LIFECYCLE = {
   phases: [
     {
       id: "evaluating",
+      status_category: "started",
       label: "Evaluating",
       description: "The model is being assessed for quality, cost, safety, and fit. Eval runs are being analysed. No production traffic.",
       transitions_to: ["staging", "retired"]
     },
     {
       id: "staging",
+      status_category: "started",
       label: "Staging",
       description: "The model has passed evaluation and is deployed to a staging environment for integration testing.",
       transitions_to: ["production", "evaluating", "retired"]
     },
     {
       id: "production",
+      status_category: "started",
       label: "Production",
       description: "The model is serving live product traffic.",
       transitions_to: ["deprecated", "retired"]
     },
     {
       id: "deprecated",
+      status_category: "started",
       label: "Deprecated",
       description: "A successor model is in production. This model is being phased out. Traffic is being migrated.",
       transitions_to: ["retired"]
     },
     {
       id: "retired",
+      status_category: "completed",
       label: "Retired",
       description: "The model is fully decommissioned. No traffic. Historical records are preserved.",
       transitions_to: []
@@ -5599,36 +5751,42 @@ var WORKFLOW_RUN_LIFECYCLE = {
   phases: [
     {
       id: "pending",
+      status_category: "unstarted",
       label: "Pending",
       description: "The run has been queued and is awaiting execution. Resources or dependencies are being provisioned.",
       transitions_to: ["running", "cancelled"]
     },
     {
       id: "running",
+      status_category: "started",
       label: "Running",
       description: "The workflow is actively executing its steps.",
       transitions_to: ["blocked", "completed", "failed", "cancelled"]
     },
     {
       id: "blocked",
+      status_category: "started",
       label: "Blocked",
       description: "Execution is paused at a review_gate awaiting human or automated approval before proceeding.",
       transitions_to: ["running", "cancelled"]
     },
     {
       id: "completed",
+      status_category: "completed",
       label: "Completed",
       description: "All steps executed successfully. Outputs are available.",
       transitions_to: []
     },
     {
       id: "failed",
+      status_category: "completed",
       label: "Failed",
       description: "The run encountered an unrecoverable error and stopped. Partial outputs may be available.",
       transitions_to: []
     },
     {
       id: "cancelled",
+      status_category: "cancelled",
       label: "Cancelled",
       description: "The run was deliberately stopped before completion.",
       transitions_to: []
@@ -5642,30 +5800,35 @@ var AGENT_DEFINITION_LIFECYCLE = {
   phases: [
     {
       id: "testing",
+      status_category: "started",
       label: "Testing",
       description: "The agent is being validated in a controlled environment. Sessions are not running against real product data.",
       transitions_to: ["active", "disabled"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The agent is operational and creating sessions on demand.",
       transitions_to: ["paused", "disabled", "retired"]
     },
     {
       id: "paused",
+      status_category: "backlog",
       label: "Paused",
       description: "The agent is temporarily suspended. It is not creating new sessions but its configuration is preserved.",
       transitions_to: ["active", "retired"]
     },
     {
       id: "disabled",
+      status_category: "backlog",
       label: "Disabled",
       description: "Turned off: bug, policy change, or safety concern. Can be re-enabled after remediation.",
       transitions_to: ["testing", "active", "retired"]
     },
     {
       id: "retired",
+      status_category: "completed",
       label: "Retired",
       description: "The agent has been permanently decommissioned. Sessions are no longer created from this definition.",
       transitions_to: []
@@ -5679,24 +5842,28 @@ var AGENT_SESSION_LIFECYCLE = {
   phases: [
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The session is running. The agent is processing input and producing output.",
       transitions_to: ["completed", "crashed", "timed_out"]
     },
     {
       id: "completed",
+      status_category: "completed",
       label: "Completed",
       description: "The session ended normally. The task was completed or the conversation was concluded.",
       transitions_to: []
     },
     {
       id: "crashed",
+      status_category: "completed",
       label: "Crashed",
       description: "The session terminated unexpectedly due to an unhandled error or infrastructure failure.",
       transitions_to: []
     },
     {
       id: "timed_out",
+      status_category: "completed",
       label: "Timed Out",
       description: "The session exceeded its maximum allowed duration and was automatically terminated.",
       transitions_to: []
@@ -5710,24 +5877,28 @@ var REVIEW_GATE_LIFECYCLE = {
   phases: [
     {
       id: "pending",
+      status_category: "unstarted",
       label: "Pending",
       description: "The gate is awaiting review. The workflow is blocked until a decision is made.",
       transitions_to: ["approved", "rejected", "bypassed"]
     },
     {
       id: "approved",
+      status_category: "completed",
       label: "Approved",
       description: "The gate has been passed. The workflow continues.",
       transitions_to: []
     },
     {
       id: "rejected",
+      status_category: "cancelled",
       label: "Rejected",
       description: "The gate was not passed. The workflow is blocked and the submitter must address the feedback before re-submitting.",
       transitions_to: ["pending"]
     },
     {
       id: "bypassed",
+      status_category: "cancelled",
       label: "Bypassed",
       description: "Deliberately overridden without normal review by an authorised person in an emergency. Create an audit trail entry.",
       transitions_to: []
@@ -5741,18 +5912,21 @@ var TEST_SUITE_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "The test suite is being authored. It is not yet part of any CI or QA process.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The suite is running in CI or scheduled QA processes.",
       transitions_to: ["deprecated"]
     },
     {
       id: "deprecated",
+      status_category: "completed",
       label: "Deprecated",
       description: "The suite is no longer being run. It may be superseded by a newer suite or the tested functionality may have been removed.",
       transitions_to: []
@@ -5766,18 +5940,21 @@ var TEST_CASE_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "The test case is being written. Preconditions, steps, and expected results are being defined.",
       transitions_to: ["active"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The test case is included in one or more test suites and is being executed.",
       transitions_to: ["deprecated"]
     },
     {
       id: "deprecated",
+      status_category: "completed",
       label: "Deprecated",
       description: "The test case is no longer executed. The feature it covered may have changed or been removed.",
       transitions_to: []
@@ -5789,10 +5966,10 @@ var INSIGHT_LIFECYCLE = {
   initial_phase: "proposed",
   terminal_phases: ["applied", "retired"],
   phases: [
-    { id: "proposed", label: "Proposed", description: "A pattern has been synthesised from observations. Not yet cross-checked.", transitions_to: ["validated", "retired"] },
-    { id: "validated", label: "Validated", description: "The insight has been cross-checked against additional evidence. Believed reliable.", transitions_to: ["applied", "retired"] },
-    { id: "applied", label: "Applied", description: "The insight drove a product decision. Captured for the record.", transitions_to: ["retired"] },
-    { id: "retired", label: "Retired", description: "Superseded by newer insight, or no longer relevant. May reopen to proposed if revisited.", transitions_to: ["proposed"] }
+    { id: "proposed", status_category: "triage", label: "Proposed", description: "A pattern has been synthesised from observations. Not yet cross-checked.", transitions_to: ["validated", "retired"] },
+    { id: "validated", status_category: "started", label: "Validated", description: "The insight has been cross-checked against additional evidence. Believed reliable.", transitions_to: ["applied", "retired"] },
+    { id: "applied", status_category: "completed", label: "Applied", description: "The insight drove a product decision. Captured for the record.", transitions_to: ["retired"] },
+    { id: "retired", status_category: "completed", label: "Retired", description: "Superseded by newer insight, or no longer relevant. May reopen to proposed if revisited.", transitions_to: ["proposed"] }
   ]
 };
 var RESEARCH_QUESTION_LIFECYCLE = {
@@ -5800,10 +5977,10 @@ var RESEARCH_QUESTION_LIFECYCLE = {
   initial_phase: "open",
   terminal_phases: ["answered", "parked"],
   phases: [
-    { id: "open", label: "Open", description: "Question has been articulated. Research has not started.", transitions_to: ["researching", "parked"] },
-    { id: "researching", label: "Researching", description: "Active investigation. Methods are being run, evidence is being gathered.", transitions_to: ["answered", "parked"] },
-    { id: "answered", label: "Answered", description: "Question has been resolved. Findings captured in linked insights.", transitions_to: [] },
-    { id: "parked", label: "Parked", description: "Set aside due to capacity, priority, or dependency. May reopen to researching.", transitions_to: ["researching"] }
+    { id: "open", status_category: "triage", label: "Open", description: "Question has been articulated. Research has not started.", transitions_to: ["researching", "parked"] },
+    { id: "researching", status_category: "started", label: "Researching", description: "Active investigation. Methods are being run, evidence is being gathered.", transitions_to: ["answered", "parked"] },
+    { id: "answered", status_category: "completed", label: "Answered", description: "Question has been resolved. Findings captured in linked insights.", transitions_to: [] },
+    { id: "parked", status_category: "backlog", label: "Parked", description: "Set aside due to capacity, priority, or dependency. May reopen to researching.", transitions_to: ["researching"] }
   ]
 };
 var INTERVIEW_GUIDE_LIFECYCLE = {
@@ -5811,10 +5988,10 @@ var INTERVIEW_GUIDE_LIFECYCLE = {
   initial_phase: "drafting",
   terminal_phases: ["archived"],
   phases: [
-    { id: "drafting", label: "Drafting", description: "Guide is being authored or revised. Not yet ready for use.", transitions_to: ["ready"] },
-    { id: "ready", label: "Ready", description: "Guide is approved for use. May be picked up by a study.", transitions_to: ["in_use", "drafting"] },
-    { id: "in_use", label: "In Use", description: "Currently being run in one or more research_study entities.", transitions_to: ["ready", "archived"] },
-    { id: "archived", label: "Archived", description: "Retired from active use. May reopen to drafting if revived.", transitions_to: ["drafting"] }
+    { id: "drafting", status_category: "started", label: "Drafting", description: "Guide is being authored or revised. Not yet ready for use.", transitions_to: ["ready"] },
+    { id: "ready", status_category: "unstarted", label: "Ready", description: "Guide is approved for use. May be picked up by a study.", transitions_to: ["in_use", "drafting"] },
+    { id: "in_use", status_category: "started", label: "In Use", description: "Currently being run in one or more research_study entities.", transitions_to: ["ready", "archived"] },
+    { id: "archived", status_category: "completed", label: "Archived", description: "Retired from active use. May reopen to drafting if revived.", transitions_to: ["drafting"] }
   ]
 };
 var TEST_PLAN_LIFECYCLE = {
@@ -5822,10 +5999,10 @@ var TEST_PLAN_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["completed", "cancelled"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "Plan has been authored. Not yet started.", transitions_to: ["executing", "cancelled"] },
-    { id: "executing", label: "Executing", description: "Tests are running according to the plan.", transitions_to: ["completed", "cancelled"] },
-    { id: "completed", label: "Completed", description: "All tests in the plan have run. Outcomes captured in linked test_result entities.", transitions_to: ["executing"] },
-    { id: "cancelled", label: "Cancelled", description: "Plan was abandoned mid-flight: assumption changed, priorities shifted, or the underlying code went away.", transitions_to: [] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "Plan has been authored. Not yet started.", transitions_to: ["executing", "cancelled"] },
+    { id: "executing", status_category: "started", label: "Executing", description: "Tests are running according to the plan.", transitions_to: ["completed", "cancelled"] },
+    { id: "completed", status_category: "completed", label: "Completed", description: "All tests in the plan have run. Outcomes captured in linked test_result entities.", transitions_to: ["executing"] },
+    { id: "cancelled", status_category: "cancelled", label: "Cancelled", description: "Plan was abandoned mid-flight: assumption changed, priorities shifted, or the underlying code went away.", transitions_to: [] }
   ]
 };
 var AI_DATASET_LIFECYCLE = {
@@ -5833,10 +6010,10 @@ var AI_DATASET_LIFECYCLE = {
   initial_phase: "collecting",
   terminal_phases: ["versioned", "archived"],
   phases: [
-    { id: "collecting", label: "Collecting", description: "Examples are being gathered. Schema and labelling rules may still be in flux.", transitions_to: ["curated", "archived"] },
-    { id: "curated", label: "Curated", description: "Examples have been cleaned, deduped, and labelled. Ready for versioning.", transitions_to: ["versioned", "collecting"] },
-    { id: "versioned", label: "Versioned", description: "A specific cut has been pinned and is citable. New collection continues in a successor version.", transitions_to: ["archived"] },
-    { id: "archived", label: "Archived", description: "No longer in active use. May reopen to collecting if revived.", transitions_to: ["collecting"] }
+    { id: "collecting", status_category: "started", label: "Collecting", description: "Examples are being gathered. Schema and labelling rules may still be in flux.", transitions_to: ["curated", "archived"] },
+    { id: "curated", status_category: "started", label: "Curated", description: "Examples have been cleaned, deduped, and labelled. Ready for versioning.", transitions_to: ["versioned", "collecting"] },
+    { id: "versioned", status_category: "completed", label: "Versioned", description: "A specific cut has been pinned and is citable. New collection continues in a successor version.", transitions_to: ["archived"] },
+    { id: "archived", status_category: "completed", label: "Archived", description: "No longer in active use. May reopen to collecting if revived.", transitions_to: ["collecting"] }
   ]
 };
 var AI_GUARDRAIL_LIFECYCLE = {
@@ -5844,10 +6021,10 @@ var AI_GUARDRAIL_LIFECYCLE = {
   initial_phase: "proposed",
   terminal_phases: ["active", "relaxed", "removed"],
   phases: [
-    { id: "proposed", label: "Proposed", description: "Guardrail has been suggested. Not yet enforced.", transitions_to: ["active", "removed"] },
-    { id: "active", label: "Active", description: "Guardrail is enforced as designed. Currently the steady state.", transitions_to: ["relaxed", "removed"] },
-    { id: "relaxed", label: "Relaxed", description: "Guardrail is enforced more loosely than originally specified. Captured separately because the looser form has different implications.", transitions_to: ["active", "removed"] },
-    { id: "removed", label: "Removed", description: "Guardrail is no longer enforced. May reopen to active if reinstated.", transitions_to: ["active"] }
+    { id: "proposed", status_category: "triage", label: "Proposed", description: "Guardrail has been suggested. Not yet enforced.", transitions_to: ["active", "removed"] },
+    { id: "active", status_category: "started", label: "Active", description: "Guardrail is enforced as designed. Currently the steady state.", transitions_to: ["relaxed", "removed"] },
+    { id: "relaxed", status_category: "started", label: "Relaxed", description: "Guardrail is enforced more loosely than originally specified. Captured separately because the looser form has different implications.", transitions_to: ["active", "removed"] },
+    { id: "removed", status_category: "cancelled", label: "Removed", description: "Guardrail is no longer enforced. May reopen to active if reinstated.", transitions_to: ["active"] }
   ]
 };
 var MODEL_COMPARISON_LIFECYCLE = {
@@ -5855,10 +6032,10 @@ var MODEL_COMPARISON_LIFECYCLE = {
   initial_phase: "planned",
   terminal_phases: ["published", "archived"],
   phases: [
-    { id: "planned", label: "Planned", description: "Comparison has been scoped: models, criteria, and methodology are agreed.", transitions_to: ["running", "archived"] },
-    { id: "running", label: "Running", description: "Models are being evaluated against the chosen criteria.", transitions_to: ["published", "archived"] },
-    { id: "published", label: "Published", description: "Results are written up and citable. Drives downstream model selection.", transitions_to: ["archived", "planned"] },
-    { id: "archived", label: "Archived", description: "Superseded by newer comparison. May reopen to planned if re-run.", transitions_to: ["planned"] }
+    { id: "planned", status_category: "unstarted", label: "Planned", description: "Comparison has been scoped: models, criteria, and methodology are agreed.", transitions_to: ["running", "archived"] },
+    { id: "running", status_category: "started", label: "Running", description: "Models are being evaluated against the chosen criteria.", transitions_to: ["published", "archived"] },
+    { id: "published", status_category: "completed", label: "Published", description: "Results are written up and citable. Drives downstream model selection.", transitions_to: ["archived", "planned"] },
+    { id: "archived", status_category: "completed", label: "Archived", description: "Superseded by newer comparison. May reopen to planned if re-run.", transitions_to: ["planned"] }
   ]
 };
 var PROMPT_VERSION_LIFECYCLE = {
@@ -5866,10 +6043,10 @@ var PROMPT_VERSION_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["active", "deprecated"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "Prompt has been authored. Not yet evaluated.", transitions_to: ["testing", "deprecated"] },
-    { id: "testing", label: "Testing", description: "Running through eval benchmarks. Results inform whether to promote.", transitions_to: ["active", "drafted", "deprecated"] },
-    { id: "active", label: "Active", description: "In production use.", transitions_to: ["deprecated"] },
-    { id: "deprecated", label: "Deprecated", description: "Superseded by a successor version. Still available for backwards-compat. May reopen to testing if reinstated.", transitions_to: ["testing"] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "Prompt has been authored. Not yet evaluated.", transitions_to: ["testing", "deprecated"] },
+    { id: "testing", status_category: "started", label: "Testing", description: "Running through eval benchmarks. Results inform whether to promote.", transitions_to: ["active", "drafted", "deprecated"] },
+    { id: "active", status_category: "started", label: "Active", description: "In production use.", transitions_to: ["deprecated"] },
+    { id: "deprecated", status_category: "completed", label: "Deprecated", description: "Superseded by a successor version. Still available for backwards-compat. May reopen to testing if reinstated.", transitions_to: ["testing"] }
   ]
 };
 var EVAL_BENCHMARK_LIFECYCLE = {
@@ -5877,10 +6054,10 @@ var EVAL_BENCHMARK_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["published", "deprecated"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "Benchmark questions and scoring rubric are being designed.", transitions_to: ["running", "deprecated"] },
-    { id: "running", label: "Running", description: "Benchmark is being executed against models or prompt versions.", transitions_to: ["published", "deprecated"] },
-    { id: "published", label: "Published", description: "Results are citable. Benchmark is part of the standard eval rotation.", transitions_to: ["deprecated", "running"] },
-    { id: "deprecated", label: "Deprecated", description: "Benchmark no longer reflects what the team measures. May reopen to drafted if revisited.", transitions_to: ["drafted"] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "Benchmark questions and scoring rubric are being designed.", transitions_to: ["running", "deprecated"] },
+    { id: "running", status_category: "started", label: "Running", description: "Benchmark is being executed against models or prompt versions.", transitions_to: ["published", "deprecated"] },
+    { id: "published", status_category: "completed", label: "Published", description: "Results are citable. Benchmark is part of the standard eval rotation.", transitions_to: ["deprecated", "running"] },
+    { id: "deprecated", status_category: "completed", label: "Deprecated", description: "Benchmark no longer reflects what the team measures. May reopen to drafted if revisited.", transitions_to: ["drafted"] }
   ]
 };
 var BUSINESS_MODEL_LIFECYCLE = {
@@ -5888,11 +6065,11 @@ var BUSINESS_MODEL_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["validated", "invalidated", "pivoted"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "Model has been articulated. Not yet tested in market.", transitions_to: ["testing", "invalidated"] },
-    { id: "testing", label: "Testing", description: "Model is being tested against real customers and revenue. Evidence is accumulating.", transitions_to: ["validated", "invalidated", "pivoted"] },
-    { id: "validated", label: "Validated", description: "Model holds up under real customer behaviour. Forms the operating basis.", transitions_to: ["testing", "pivoted"] },
-    { id: "invalidated", label: "Invalidated", description: "Model failed to hold up. May reopen to drafted for a new attempt.", transitions_to: ["drafted"] },
-    { id: "pivoted", label: "Pivoted", description: "Model became something structurally different. Captured as a milestone before the new model takes over.", transitions_to: [] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "Model has been articulated. Not yet tested in market.", transitions_to: ["testing", "invalidated"] },
+    { id: "testing", status_category: "started", label: "Testing", description: "Model is being tested against real customers and revenue. Evidence is accumulating.", transitions_to: ["validated", "invalidated", "pivoted"] },
+    { id: "validated", status_category: "completed", label: "Validated", description: "Model holds up under real customer behaviour. Forms the operating basis.", transitions_to: ["testing", "pivoted"] },
+    { id: "invalidated", status_category: "completed", label: "Invalidated", description: "Model failed to hold up. May reopen to drafted for a new attempt.", transitions_to: ["drafted"] },
+    { id: "pivoted", status_category: "cancelled", label: "Pivoted", description: "Model became something structurally different. Captured as a milestone before the new model takes over.", transitions_to: [] }
   ]
 };
 var REVENUE_STREAM_LIFECYCLE = {
@@ -5900,10 +6077,10 @@ var REVENUE_STREAM_LIFECYCLE = {
   initial_phase: "proposed",
   terminal_phases: ["live", "sunset"],
   phases: [
-    { id: "proposed", label: "Proposed", description: "Stream has been hypothesised. Not yet built or sold.", transitions_to: ["piloting", "sunset"] },
-    { id: "piloting", label: "Piloting", description: "Stream is being trialled with a limited audience. Pricing and packaging may still be in flux.", transitions_to: ["live", "sunset"] },
-    { id: "live", label: "Live", description: "Stream is generally available and generating revenue.", transitions_to: ["sunset"] },
-    { id: "sunset", label: "Sunset", description: "Stream is being wound down. May reopen to piloting if revived.", transitions_to: ["piloting"] }
+    { id: "proposed", status_category: "triage", label: "Proposed", description: "Stream has been hypothesised. Not yet built or sold.", transitions_to: ["piloting", "sunset"] },
+    { id: "piloting", status_category: "started", label: "Piloting", description: "Stream is being trialled with a limited audience. Pricing and packaging may still be in flux.", transitions_to: ["live", "sunset"] },
+    { id: "live", status_category: "started", label: "Live", description: "Stream is generally available and generating revenue.", transitions_to: ["sunset"] },
+    { id: "sunset", status_category: "completed", label: "Sunset", description: "Stream is being wound down. May reopen to piloting if revived.", transitions_to: ["piloting"] }
   ]
 };
 var CUSTOMER_HEALTH_SCORE_LIFECYCLE = {
@@ -5911,11 +6088,11 @@ var CUSTOMER_HEALTH_SCORE_LIFECYCLE = {
   initial_phase: "monitoring",
   terminal_phases: ["recovered", "churned"],
   phases: [
-    { id: "monitoring", label: "Monitoring", description: "Customer is healthy. Score is being tracked passively.", transitions_to: ["at_risk", "churned", "recovered"] },
-    { id: "at_risk", label: "At Risk", description: "Signals indicate trouble. Customer Success has flagged the account for attention.", transitions_to: ["monitoring", "critical", "churned", "recovered"] },
-    { id: "critical", label: "Critical", description: "Customer is on the verge of churning. Active intervention is underway.", transitions_to: ["at_risk", "recovered", "churned"] },
-    { id: "recovered", label: "Recovered", description: "Customer health has returned to monitoring. Captured as a milestone. May reopen to monitoring naturally.", transitions_to: ["monitoring"] },
-    { id: "churned", label: "Churned", description: "Customer left. Captured for analysis; reopen would mean a new customer relationship.", transitions_to: [] }
+    { id: "monitoring", status_category: "started", label: "Monitoring", description: "Customer is healthy. Score is being tracked passively.", transitions_to: ["at_risk", "churned", "recovered"] },
+    { id: "at_risk", status_category: "started", label: "At Risk", description: "Signals indicate trouble. Customer Success has flagged the account for attention.", transitions_to: ["monitoring", "critical", "churned", "recovered"] },
+    { id: "critical", status_category: "started", label: "Critical", description: "Customer is on the verge of churning. Active intervention is underway.", transitions_to: ["at_risk", "recovered", "churned"] },
+    { id: "recovered", status_category: "completed", label: "Recovered", description: "Customer health has returned to monitoring. Captured as a milestone. May reopen to monitoring naturally.", transitions_to: ["monitoring"] },
+    { id: "churned", status_category: "cancelled", label: "Churned", description: "Customer left. Captured for analysis; reopen would mean a new customer relationship.", transitions_to: [] }
   ]
 };
 var PLAYBOOK_LIFECYCLE = {
@@ -5923,10 +6100,10 @@ var PLAYBOOK_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["live", "retired"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "Playbook is being authored. Not yet tested with customers.", transitions_to: ["tested", "retired"] },
-    { id: "tested", label: "Tested", description: "Playbook has been run through pilot customers. Adjustments may follow.", transitions_to: ["live", "drafted"] },
-    { id: "live", label: "Live", description: "Playbook is in active use across the customer success team.", transitions_to: ["retired", "tested"] },
-    { id: "retired", label: "Retired", description: "Playbook no longer in use. May reopen to drafted if revived.", transitions_to: ["drafted"] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "Playbook is being authored. Not yet tested with customers.", transitions_to: ["tested", "retired"] },
+    { id: "tested", status_category: "started", label: "Tested", description: "Playbook has been run through pilot customers. Adjustments may follow.", transitions_to: ["live", "drafted"] },
+    { id: "live", status_category: "started", label: "Live", description: "Playbook is in active use across the customer success team.", transitions_to: ["retired", "tested"] },
+    { id: "retired", status_category: "completed", label: "Retired", description: "Playbook no longer in use. May reopen to drafted if revived.", transitions_to: ["drafted"] }
   ]
 };
 var TEAM_OKR_LIFECYCLE = {
@@ -5934,11 +6111,11 @@ var TEAM_OKR_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["completed", "missed"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "OKR is being authored. Not yet committed to.", transitions_to: ["committed"] },
-    { id: "committed", label: "Committed", description: "Team has agreed to pursue the OKR. Cycle has not yet started.", transitions_to: ["in_progress", "drafted"] },
-    { id: "in_progress", label: "In Progress", description: "Cycle is underway. Progress is being tracked.", transitions_to: ["completed", "missed"] },
-    { id: "completed", label: "Completed", description: "OKR was achieved within the cycle.", transitions_to: [] },
-    { id: "missed", label: "Missed", description: "OKR was not achieved. May reopen to in_progress if carried forward.", transitions_to: ["in_progress"] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "OKR is being authored. Not yet committed to.", transitions_to: ["committed"] },
+    { id: "committed", status_category: "unstarted", label: "Committed", description: "Team has agreed to pursue the OKR. Cycle has not yet started.", transitions_to: ["in_progress", "drafted"] },
+    { id: "in_progress", status_category: "started", label: "In Progress", description: "Cycle is underway. Progress is being tracked.", transitions_to: ["completed", "missed"] },
+    { id: "completed", status_category: "completed", label: "Completed", description: "OKR was achieved within the cycle.", transitions_to: [] },
+    { id: "missed", status_category: "completed", label: "Missed", description: "OKR was not achieved. May reopen to in_progress if carried forward.", transitions_to: ["in_progress"] }
   ]
 };
 var RETROSPECTIVE_LIFECYCLE = {
@@ -5946,10 +6123,10 @@ var RETROSPECTIVE_LIFECYCLE = {
   initial_phase: "scheduled",
   terminal_phases: ["completed", "actions_tracked"],
   phases: [
-    { id: "scheduled", label: "Scheduled", description: "Retro is on the calendar. Not yet held.", transitions_to: ["in_progress", "completed"] },
-    { id: "in_progress", label: "In Progress", description: "Retro is being held.", transitions_to: ["completed"] },
-    { id: "completed", label: "Completed", description: "Meeting is done. Action items captured but not yet tracked to closure.", transitions_to: ["actions_tracked"] },
-    { id: "actions_tracked", label: "Actions Tracked", description: "Retro action items have been completed or explicitly dropped. Full loop closed.", transitions_to: [] }
+    { id: "scheduled", status_category: "unstarted", label: "Scheduled", description: "Retro is on the calendar. Not yet held.", transitions_to: ["in_progress", "completed"] },
+    { id: "in_progress", status_category: "started", label: "In Progress", description: "Retro is being held.", transitions_to: ["completed"] },
+    { id: "completed", status_category: "completed", label: "Completed", description: "Meeting is done. Action items captured but not yet tracked to closure.", transitions_to: ["actions_tracked"] },
+    { id: "actions_tracked", status_category: "completed", label: "Actions Tracked", description: "Retro action items have been completed or explicitly dropped. Full loop closed.", transitions_to: [] }
   ]
 };
 var DEPENDENCY_LIFECYCLE = {
@@ -5957,10 +6134,10 @@ var DEPENDENCY_LIFECYCLE = {
   initial_phase: "identified",
   terminal_phases: ["resolved"],
   phases: [
-    { id: "identified", label: "Identified", description: "Dependency has been named. Not yet evaluated for impact.", transitions_to: ["blocked", "in_progress", "resolved"] },
-    { id: "blocked", label: "Blocked", description: "Dependency is currently blocking work. Awaiting upstream action.", transitions_to: ["in_progress", "resolved"] },
-    { id: "in_progress", label: "In Progress", description: "Active work is happening to resolve the dependency.", transitions_to: ["blocked", "resolved"] },
-    { id: "resolved", label: "Resolved", description: "Dependency is no longer blocking. May reopen to blocked if regression.", transitions_to: ["blocked"] }
+    { id: "identified", status_category: "triage", label: "Identified", description: "Dependency has been named. Not yet evaluated for impact.", transitions_to: ["blocked", "in_progress", "resolved"] },
+    { id: "blocked", status_category: "started", label: "Blocked", description: "Dependency is currently blocking work. Awaiting upstream action.", transitions_to: ["in_progress", "resolved"] },
+    { id: "in_progress", status_category: "started", label: "In Progress", description: "Active work is happening to resolve the dependency.", transitions_to: ["blocked", "resolved"] },
+    { id: "resolved", status_category: "completed", label: "Resolved", description: "Dependency is no longer blocking. May reopen to blocked if regression.", transitions_to: ["blocked"] }
   ]
 };
 var ROLE_LIFECYCLE = {
@@ -5968,10 +6145,10 @@ var ROLE_LIFECYCLE = {
   initial_phase: "proposed",
   terminal_phases: ["filled", "vacant"],
   phases: [
-    { id: "proposed", label: "Proposed", description: "Role has been described but not yet posted or staffed.", transitions_to: ["open", "vacant"] },
-    { id: "open", label: "Open", description: "Role is actively being recruited for.", transitions_to: ["filled", "vacant"] },
-    { id: "filled", label: "Filled", description: "Role is staffed. May reopen to open if the position becomes vacant again.", transitions_to: ["vacant"] },
-    { id: "vacant", label: "Vacant", description: "Role exists but is unfilled. May reopen to open to start recruiting.", transitions_to: ["open"] }
+    { id: "proposed", status_category: "triage", label: "Proposed", description: "Role has been described but not yet posted or staffed.", transitions_to: ["open", "vacant"] },
+    { id: "open", status_category: "started", label: "Open", description: "Role is actively being recruited for.", transitions_to: ["filled", "vacant"] },
+    { id: "filled", status_category: "completed", label: "Filled", description: "Role is staffed. May reopen to open if the position becomes vacant again.", transitions_to: ["vacant"] },
+    { id: "vacant", status_category: "backlog", label: "Vacant", description: "Role exists but is unfilled. May reopen to open to start recruiting.", transitions_to: ["open"] }
   ]
 };
 var CAPACITY_PLAN_LIFECYCLE = {
@@ -5979,11 +6156,11 @@ var CAPACITY_PLAN_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["completed", "revised"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "Plan is being authored. Not yet agreed.", transitions_to: ["committed", "revised"] },
-    { id: "committed", label: "Committed", description: "Plan has been agreed by stakeholders. Cycle has not yet started.", transitions_to: ["in_flight", "revised"] },
-    { id: "in_flight", label: "In Flight", description: "Cycle is underway. Capacity is being consumed.", transitions_to: ["completed", "revised"] },
-    { id: "completed", label: "Completed", description: "Cycle is done. Plan executed as agreed.", transitions_to: [] },
-    { id: "revised", label: "Revised", description: "Plan was changed mid-flight. May reopen to drafted for the next iteration.", transitions_to: ["drafted"] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "Plan is being authored. Not yet agreed.", transitions_to: ["committed", "revised"] },
+    { id: "committed", status_category: "unstarted", label: "Committed", description: "Plan has been agreed by stakeholders. Cycle has not yet started.", transitions_to: ["in_flight", "revised"] },
+    { id: "in_flight", status_category: "started", label: "In Flight", description: "Cycle is underway. Capacity is being consumed.", transitions_to: ["completed", "revised"] },
+    { id: "completed", status_category: "completed", label: "Completed", description: "Cycle is done. Plan executed as agreed.", transitions_to: [] },
+    { id: "revised", status_category: "completed", label: "Revised", description: "Plan was changed mid-flight. May reopen to drafted for the next iteration.", transitions_to: ["drafted"] }
   ]
 };
 var VARIANT_LIFECYCLE = {
@@ -5991,11 +6168,11 @@ var VARIANT_LIFECYCLE = {
   initial_phase: "proposed",
   terminal_phases: ["winning", "losing", "retired"],
   phases: [
-    { id: "proposed", label: "Proposed", description: "Variant has been designed. Not yet running.", transitions_to: ["live", "retired"] },
-    { id: "live", label: "Live", description: "Variant is being shown to users as part of an active test.", transitions_to: ["winning", "losing", "retired"] },
-    { id: "winning", label: "Winning", description: "Variant beat the control. Captured for the record before rollout.", transitions_to: ["retired"] },
-    { id: "losing", label: "Losing", description: "Variant did not beat the control. Captured for the record.", transitions_to: ["retired"] },
-    { id: "retired", label: "Retired", description: "Variant is no longer running. May reopen to proposed if revisited in a future test.", transitions_to: ["proposed"] }
+    { id: "proposed", status_category: "triage", label: "Proposed", description: "Variant has been designed. Not yet running.", transitions_to: ["live", "retired"] },
+    { id: "live", status_category: "started", label: "Live", description: "Variant is being shown to users as part of an active test.", transitions_to: ["winning", "losing", "retired"] },
+    { id: "winning", status_category: "completed", label: "Winning", description: "Variant beat the control. Captured for the record before rollout.", transitions_to: ["retired"] },
+    { id: "losing", status_category: "completed", label: "Losing", description: "Variant did not beat the control. Captured for the record.", transitions_to: ["retired"] },
+    { id: "retired", status_category: "completed", label: "Retired", description: "Variant is no longer running. May reopen to proposed if revisited in a future test.", transitions_to: ["proposed"] }
   ]
 };
 var GROWTH_CAMPAIGN_LIFECYCLE = {
@@ -6003,11 +6180,11 @@ var GROWTH_CAMPAIGN_LIFECYCLE = {
   initial_phase: "drafted",
   terminal_phases: ["completed", "paused"],
   phases: [
-    { id: "drafted", label: "Drafted", description: "Campaign concept exists. Not yet planned for launch.", transitions_to: ["planning", "paused"] },
-    { id: "planning", label: "Planning", description: "Campaign creative, channels, and timing are being finalised.", transitions_to: ["live", "paused"] },
-    { id: "live", label: "Live", description: "Campaign is running across channels.", transitions_to: ["completed", "paused"] },
-    { id: "completed", label: "Completed", description: "Campaign ran to completion. Outcomes captured.", transitions_to: [] },
-    { id: "paused", label: "Paused", description: "Campaign was halted before completion. May reopen to live if resumed.", transitions_to: ["live"] }
+    { id: "drafted", status_category: "unstarted", label: "Drafted", description: "Campaign concept exists. Not yet planned for launch.", transitions_to: ["planning", "paused"] },
+    { id: "planning", status_category: "unstarted", label: "Planning", description: "Campaign creative, channels, and timing are being finalised.", transitions_to: ["live", "paused"] },
+    { id: "live", status_category: "started", label: "Live", description: "Campaign is running across channels.", transitions_to: ["completed", "paused"] },
+    { id: "completed", status_category: "completed", label: "Completed", description: "Campaign ran to completion. Outcomes captured.", transitions_to: [] },
+    { id: "paused", status_category: "backlog", label: "Paused", description: "Campaign was halted before completion. May reopen to live if resumed.", transitions_to: ["live"] }
   ]
 };
 function fromTemplate(entityType, template) {
@@ -6018,10 +6195,10 @@ var PUBLISHING_TEMPLATE = {
   initial_phase: "draft",
   terminal_phases: ["archived"],
   phases: [
-    { id: "draft", label: "Draft", description: "Being authored or revised. Not visible externally.", transitions_to: ["review"] },
-    { id: "review", label: "In Review", description: "Under editorial or stakeholder review before publishing.", transitions_to: ["draft", "published"] },
-    { id: "published", label: "Published", description: "Live and visible to the intended audience.", transitions_to: ["archived", "draft"] },
-    { id: "archived", label: "Archived", description: "No longer current. Retained for historical reference.", transitions_to: ["draft"] }
+    { id: "draft", status_category: "started", label: "Draft", description: "Being authored or revised. Not visible externally.", transitions_to: ["review"] },
+    { id: "review", status_category: "started", label: "In Review", description: "Under editorial or stakeholder review before publishing.", transitions_to: ["draft", "published"] },
+    { id: "published", status_category: "completed", label: "Published", description: "Live and visible to the intended audience.", transitions_to: ["archived", "draft"] },
+    { id: "archived", status_category: "completed", label: "Archived", description: "No longer current. Retained for historical reference.", transitions_to: ["draft"] }
   ]
 };
 var OPERATIONAL_TEMPLATE = {
@@ -6029,11 +6206,11 @@ var OPERATIONAL_TEMPLATE = {
   initial_phase: "planning",
   terminal_phases: ["completed", "sunset"],
   phases: [
-    { id: "planning", label: "Planning", description: "Being designed or scoped. Not yet started.", transitions_to: ["active"] },
-    { id: "active", label: "Active", description: "Currently running or in operation.", transitions_to: ["paused", "completed", "sunset"] },
-    { id: "paused", label: "Paused", description: "Temporarily halted. Can be resumed.", transitions_to: ["active", "sunset"] },
-    { id: "completed", label: "Completed", description: "Finished successfully. Outcomes captured.", transitions_to: [] },
-    { id: "sunset", label: "Sunset", description: "Winding down or discontinued.", transitions_to: [] }
+    { id: "planning", status_category: "unstarted", label: "Planning", description: "Being designed or scoped. Not yet started.", transitions_to: ["active"] },
+    { id: "active", status_category: "started", label: "Active", description: "Currently running or in operation.", transitions_to: ["paused", "completed", "sunset"] },
+    { id: "paused", status_category: "backlog", label: "Paused", description: "Temporarily halted. Can be resumed.", transitions_to: ["active", "sunset"] },
+    { id: "completed", status_category: "completed", label: "Completed", description: "Finished successfully. Outcomes captured.", transitions_to: [] },
+    { id: "sunset", status_category: "completed", label: "Sunset", description: "Winding down or discontinued.", transitions_to: [] }
   ]
 };
 var APPROVAL_TEMPLATE = {
@@ -6045,22 +6222,23 @@ var APPROVAL_TEMPLATE = {
   // UPGLifecycle.terminal_phases contract.
   terminal_phases: ["approved", "rejected", "deprecated"],
   phases: [
-    { id: "proposed", label: "Proposed", description: "Submitted for consideration. Awaiting review.", transitions_to: ["reviewing"] },
-    { id: "reviewing", label: "Reviewing", description: "Under active review by approvers.", transitions_to: ["approved", "rejected", "proposed"] },
-    { id: "approved", label: "Approved", description: "Accepted and ready for implementation.", transitions_to: ["deprecated"] },
-    { id: "rejected", label: "Rejected", description: "Not accepted. Reasons should be documented.", transitions_to: ["proposed"] },
-    { id: "deprecated", label: "Deprecated", description: "Previously approved but no longer current.", transitions_to: [] }
+    { id: "proposed", status_category: "triage", label: "Proposed", description: "Submitted for consideration. Awaiting review.", transitions_to: ["reviewing"] },
+    { id: "reviewing", status_category: "started", label: "Reviewing", description: "Under active review by approvers.", transitions_to: ["approved", "rejected", "proposed"] },
+    { id: "approved", status_category: "completed", label: "Approved", description: "Accepted and ready for implementation.", transitions_to: ["deprecated"] },
+    { id: "rejected", status_category: "cancelled", label: "Rejected", description: "Not accepted. Reasons should be documented.", transitions_to: ["proposed"] },
+    { id: "deprecated", status_category: "completed", label: "Deprecated", description: "Previously approved but no longer current.", transitions_to: [] }
   ]
 };
 var WORK_ITEM_TEMPLATE = {
   template_id: "WORK_ITEM",
   initial_phase: "todo",
-  terminal_phases: ["done"],
+  terminal_phases: ["done", "cancelled"],
   phases: [
-    { id: "todo", label: "To Do", description: "Identified but not yet started.", transitions_to: ["in_progress"] },
-    { id: "in_progress", label: "In Progress", description: "Actively being worked on.", transitions_to: ["in_review", "todo"] },
-    { id: "in_review", label: "In Review", description: "Work completed, awaiting review or acceptance.", transitions_to: ["done", "in_progress"] },
-    { id: "done", label: "Done", description: "Completed and accepted.", transitions_to: [] }
+    { id: "todo", status_category: "unstarted", label: "To Do", description: "Identified but not yet started.", transitions_to: ["in_progress", "cancelled"] },
+    { id: "in_progress", status_category: "started", label: "In Progress", description: "Actively being worked on.", transitions_to: ["in_review", "todo", "cancelled"] },
+    { id: "in_review", status_category: "started", label: "In Review", description: "Work completed, awaiting review or acceptance.", transitions_to: ["done", "in_progress", "cancelled"] },
+    { id: "done", status_category: "completed", label: "Done", description: "Completed and accepted.", transitions_to: [] },
+    { id: "cancelled", status_category: "cancelled", label: "Cancelled", description: "Deliberately closed without completion: won't-do, duplicate, or obsolete. May reopen to `todo` if circumstances change.", transitions_to: ["todo"] }
   ]
 };
 var DISCOVERY_TEMPLATE = {
@@ -6068,10 +6246,10 @@ var DISCOVERY_TEMPLATE = {
   initial_phase: "open",
   terminal_phases: ["resolved", "parked"],
   phases: [
-    { id: "open", label: "Open", description: "Identified as worth exploring. No work started yet.", transitions_to: ["exploring"] },
-    { id: "exploring", label: "Exploring", description: "Actively being investigated or researched.", transitions_to: ["resolved", "parked", "open"] },
-    { id: "resolved", label: "Resolved", description: "Answered or addressed. Findings captured.", transitions_to: [] },
-    { id: "parked", label: "Parked", description: "Set aside for now. May revisit later.", transitions_to: ["open"] }
+    { id: "open", status_category: "triage", label: "Open", description: "Identified as worth exploring. No work started yet.", transitions_to: ["exploring"] },
+    { id: "exploring", status_category: "started", label: "Exploring", description: "Actively being investigated or researched.", transitions_to: ["resolved", "parked", "open"] },
+    { id: "resolved", status_category: "completed", label: "Resolved", description: "Answered or addressed. Findings captured.", transitions_to: [] },
+    { id: "parked", status_category: "backlog", label: "Parked", description: "Set aside for now. May revisit later.", transitions_to: ["open"] }
   ]
 };
 var MATURITY_TEMPLATE = {
@@ -6079,10 +6257,10 @@ var MATURITY_TEMPLATE = {
   initial_phase: "alpha",
   terminal_phases: ["deprecated"],
   phases: [
-    { id: "alpha", label: "Alpha", description: "Early stage, internal use only. Expect breaking changes.", transitions_to: ["beta"] },
-    { id: "beta", label: "Beta", description: "Feature complete but may have rough edges. Limited external use.", transitions_to: ["ga", "alpha"] },
-    { id: "ga", label: "Generally Available", description: "Stable, production-ready. Widely available.", transitions_to: ["deprecated"] },
-    { id: "deprecated", label: "Deprecated", description: "Scheduled for removal. Migration path should be documented.", transitions_to: [] }
+    { id: "alpha", status_category: "started", label: "Alpha", description: "Early stage, internal use only. Expect breaking changes.", transitions_to: ["beta"] },
+    { id: "beta", status_category: "started", label: "Beta", description: "Feature complete but may have rough edges. Limited external use.", transitions_to: ["ga", "alpha"] },
+    { id: "ga", status_category: "completed", label: "Generally Available", description: "Stable, production-ready. Widely available.", transitions_to: ["deprecated"] },
+    { id: "deprecated", status_category: "completed", label: "Deprecated", description: "Scheduled for removal. Migration path should be documented.", transitions_to: [] }
   ]
 };
 var RISK_ITEM_TEMPLATE = {
@@ -6090,11 +6268,11 @@ var RISK_ITEM_TEMPLATE = {
   initial_phase: "identified",
   terminal_phases: ["mitigated", "accepted", "closed"],
   phases: [
-    { id: "identified", label: "Identified", description: "Risk has been recognised and named. Not yet assessed for likelihood or impact.", transitions_to: ["assessed"] },
-    { id: "assessed", label: "Assessed", description: "Likelihood and impact have been evaluated. Outcome is one of mitigated, accepted, or closed.", transitions_to: ["mitigated", "accepted", "closed"] },
-    { id: "mitigated", label: "Mitigated", description: "Action has been taken to reduce likelihood or impact. The risk is no longer active.", transitions_to: [] },
-    { id: "accepted", label: "Accepted", description: "Risk is acknowledged. Cost of mitigation outweighs exposure; the team chooses to live with it.", transitions_to: [] },
-    { id: "closed", label: "Closed", description: "Risk became irrelevant without action; underlying conditions changed. May reopen to `assessed` if conditions change again.", transitions_to: ["assessed"] }
+    { id: "identified", status_category: "triage", label: "Identified", description: "Risk has been recognised and named. Not yet assessed for likelihood or impact.", transitions_to: ["assessed"] },
+    { id: "assessed", status_category: "started", label: "Assessed", description: "Likelihood and impact have been evaluated. Outcome is one of mitigated, accepted, or closed.", transitions_to: ["mitigated", "accepted", "closed"] },
+    { id: "mitigated", status_category: "completed", label: "Mitigated", description: "Action has been taken to reduce likelihood or impact. The risk is no longer active.", transitions_to: [] },
+    { id: "accepted", status_category: "completed", label: "Accepted", description: "Risk is acknowledged. Cost of mitigation outweighs exposure; the team chooses to live with it.", transitions_to: [] },
+    { id: "closed", status_category: "completed", label: "Closed", description: "Risk became irrelevant without action; underlying conditions changed. May reopen to `assessed` if conditions change again.", transitions_to: ["assessed"] }
   ]
 };
 var SALES_DEAL_TEMPLATE = {
@@ -6102,11 +6280,11 @@ var SALES_DEAL_TEMPLATE = {
   initial_phase: "qualified",
   terminal_phases: ["closed_won", "closed_lost"],
   phases: [
-    { id: "qualified", label: "Qualified", description: "Lead has been qualified: there's a real budget, need, and decision-maker. Not yet pitched.", transitions_to: ["proposal"] },
-    { id: "proposal", label: "Proposal", description: "A proposal has been delivered. Pricing and scope are on the table.", transitions_to: ["negotiation", "closed_lost"] },
-    { id: "negotiation", label: "Negotiation", description: "Terms are being finalised. Both sides are working toward agreement.", transitions_to: ["closed_won", "closed_lost"] },
-    { id: "closed_won", label: "Closed Won", description: "Deal signed. Customer is now active.", transitions_to: [] },
-    { id: "closed_lost", label: "Closed Lost", description: "Deal did not close. A re-engaged prospect becomes a new `deal` rather than reviving this one.", transitions_to: [] }
+    { id: "qualified", status_category: "triage", label: "Qualified", description: "Lead has been qualified: there's a real budget, need, and decision-maker. Not yet pitched.", transitions_to: ["proposal"] },
+    { id: "proposal", status_category: "started", label: "Proposal", description: "A proposal has been delivered. Pricing and scope are on the table.", transitions_to: ["negotiation", "closed_lost"] },
+    { id: "negotiation", status_category: "started", label: "Negotiation", description: "Terms are being finalised. Both sides are working toward agreement.", transitions_to: ["closed_won", "closed_lost"] },
+    { id: "closed_won", status_category: "completed", label: "Closed Won", description: "Deal signed. Customer is now active.", transitions_to: [] },
+    { id: "closed_lost", status_category: "completed", label: "Closed Lost", description: "Deal did not close. A re-engaged prospect becomes a new `deal` rather than reviving this one.", transitions_to: [] }
   ]
 };
 var VALIDATION_TEMPLATE = {
@@ -6114,11 +6292,11 @@ var VALIDATION_TEMPLATE = {
   initial_phase: "untested",
   terminal_phases: ["validated", "invalidated", "archived"],
   phases: [
-    { id: "untested", label: "Untested", description: "Articulated but not yet examined against evidence.", transitions_to: ["testing"] },
-    { id: "testing", label: "Testing", description: "Actively gathering evidence for or against the claim.", transitions_to: ["validated", "invalidated"] },
-    { id: "validated", label: "Validated", description: "Evidence supports the claim. Treated as true until contradicted.", transitions_to: ["archived"] },
-    { id: "invalidated", label: "Invalidated", description: "Evidence contradicts the claim. May re-test if new evidence appears.", transitions_to: ["archived", "testing"] },
-    { id: "archived", label: "Archived", description: "Settled and retained for provenance. No longer active.", transitions_to: [] }
+    { id: "untested", status_category: "triage", label: "Untested", description: "Articulated but not yet examined against evidence.", transitions_to: ["testing"] },
+    { id: "testing", status_category: "started", label: "Testing", description: "Actively gathering evidence for or against the claim.", transitions_to: ["validated", "invalidated"] },
+    { id: "validated", status_category: "completed", label: "Validated", description: "Evidence supports the claim. Treated as true until contradicted.", transitions_to: ["archived"] },
+    { id: "invalidated", status_category: "completed", label: "Invalidated", description: "Evidence contradicts the claim. May re-test if new evidence appears.", transitions_to: ["archived", "testing"] },
+    { id: "archived", status_category: "completed", label: "Archived", description: "Settled and retained for provenance. No longer active.", transitions_to: [] }
   ]
 };
 var INCIDENT_TEMPLATE = {
@@ -6126,12 +6304,12 @@ var INCIDENT_TEMPLATE = {
   initial_phase: "open",
   terminal_phases: ["resolved", "closed", "wont_fix"],
   phases: [
-    { id: "open", label: "Open", description: "Surfaced and logged. Not yet triaged.", transitions_to: ["triaged"] },
-    { id: "triaged", label: "Triaged", description: "Assessed for severity and ownership. Routed for work or dispositioned.", transitions_to: ["in_progress", "resolved", "wont_fix"] },
-    { id: "in_progress", label: "In Progress", description: "Actively being worked toward a fix.", transitions_to: ["resolved", "wont_fix"] },
-    { id: "resolved", label: "Resolved", description: "Addressed and verified. May reopen to `triaged` on regression.", transitions_to: ["closed", "triaged"] },
-    { id: "closed", label: "Closed", description: "Administratively closed (duplicate, withdrawn, or no longer relevant).", transitions_to: [] },
-    { id: "wont_fix", label: "Won't Fix", description: "Triaged as not to be actioned. Reason should be documented.", transitions_to: [] }
+    { id: "open", status_category: "triage", label: "Open", description: "Surfaced and logged. Not yet triaged.", transitions_to: ["triaged"] },
+    { id: "triaged", status_category: "triage", label: "Triaged", description: "Assessed for severity and ownership. Routed for work or dispositioned.", transitions_to: ["in_progress", "resolved", "wont_fix"] },
+    { id: "in_progress", status_category: "started", label: "In Progress", description: "Actively being worked toward a fix.", transitions_to: ["resolved", "wont_fix"] },
+    { id: "resolved", status_category: "completed", label: "Resolved", description: "Addressed and verified. May reopen to `triaged` on regression.", transitions_to: ["closed", "triaged"] },
+    { id: "closed", status_category: "cancelled", label: "Closed", description: "Administratively closed (duplicate, withdrawn, or no longer relevant).", transitions_to: [] },
+    { id: "wont_fix", status_category: "cancelled", label: "Won't Fix", description: "Triaged as not to be actioned. Reason should be documented.", transitions_to: [] }
   ]
 };
 var STUDY_TEMPLATE = {
@@ -6139,11 +6317,11 @@ var STUDY_TEMPLATE = {
   initial_phase: "planned",
   terminal_phases: ["complete", "abandoned"],
   phases: [
-    { id: "planned", label: "Planned", description: "Scoped and scheduled. Not yet started.", transitions_to: ["running"] },
-    { id: "running", label: "Running", description: "Actively executing: collecting data or running the protocol.", transitions_to: ["analysing", "abandoned"] },
-    { id: "analysing", label: "Analysing", description: "Execution done; results are being analysed and written up.", transitions_to: ["complete", "abandoned"] },
-    { id: "complete", label: "Complete", description: "Analysed and concluded. Findings captured.", transitions_to: [] },
-    { id: "abandoned", label: "Abandoned", description: "Stopped before completion (killed, timed out, or superseded).", transitions_to: [] }
+    { id: "planned", status_category: "unstarted", label: "Planned", description: "Scoped and scheduled. Not yet started.", transitions_to: ["running"] },
+    { id: "running", status_category: "started", label: "Running", description: "Actively executing: collecting data or running the protocol.", transitions_to: ["analysing", "abandoned"] },
+    { id: "analysing", status_category: "started", label: "Analysing", description: "Execution done; results are being analysed and written up.", transitions_to: ["complete", "abandoned"] },
+    { id: "complete", status_category: "completed", label: "Complete", description: "Analysed and concluded. Findings captured.", transitions_to: [] },
+    { id: "abandoned", status_category: "cancelled", label: "Abandoned", description: "Stopped before completion (killed, timed out, or superseded).", transitions_to: [] }
   ]
 };
 var TEMPLATE_LIFECYCLES = [
@@ -6305,18 +6483,21 @@ var FRAMEWORK_EXERCISE_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "The exercise has been created and entities pulled into scope, but the framework's inputs have not all been filled in yet.",
       transitions_to: ["active", "archived"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "The current, authoritative run of its framework. Its include edges carry the live results consumers read, rank, and render by.",
       transitions_to: ["archived"]
     },
     {
       id: "archived",
+      status_category: "completed",
       label: "Archived",
       description: "A past run, retained for provenance. Still queryable but superseded by a newer exercise and hidden from default views. Can be revived to active.",
       transitions_to: ["active"]
@@ -6330,24 +6511,28 @@ var SPECIFICATION_LIFECYCLE = {
   phases: [
     {
       id: "draft",
+      status_category: "started",
       label: "Draft",
       description: "Being authored. Not yet adopted as the canonical specification.",
       transitions_to: ["active", "superseded"]
     },
     {
       id: "active",
+      status_category: "started",
       label: "Active",
       description: "In force. The current authoritative version products implement and conform to.",
       transitions_to: ["deprecated", "superseded"]
     },
     {
       id: "deprecated",
+      status_category: "started",
       label: "Deprecated",
       description: "Still valid but no longer recommended; a successor exists or is imminent.",
       transitions_to: ["superseded"]
     },
     {
       id: "superseded",
+      status_category: "completed",
       label: "Superseded",
       description: "Replaced by a newer specification. Retained for historical reference.",
       transitions_to: []
@@ -6359,9 +6544,9 @@ var PLANNING_CYCLE_LIFECYCLE = {
   initial_phase: "planned",
   terminal_phases: ["closed"],
   phases: [
-    { id: "planned", label: "Planned", description: "The cycle is being shaped: dates set, goal written, work scheduled into it. It has not started yet.", transitions_to: ["active"] },
-    { id: "active", label: "Active", description: "The team is inside the interval; work is flowing through it.", transitions_to: ["closed"] },
-    { id: "closed", label: "Closed", description: "The interval has ended. Scheduled work has shipped, carried over, or been dropped. May reopen if the team extends or reruns it.", transitions_to: ["active"] }
+    { id: "planned", status_category: "unstarted", label: "Planned", description: "The cycle is being shaped: dates set, goal written, work scheduled into it. It has not started yet.", transitions_to: ["active"] },
+    { id: "active", status_category: "started", label: "Active", description: "The team is inside the interval; work is flowing through it.", transitions_to: ["closed"] },
+    { id: "closed", status_category: "completed", label: "Closed", description: "The interval has ended. Scheduled work has shipped, carried over, or been dropped. May reopen if the team extends or reruns it.", transitions_to: ["active"] }
   ]
 };
 var UPG_LIFECYCLES = [
@@ -29980,6 +30165,28 @@ function portfolioBody(doc) {
     ...doc.signals && doc.signals.length > 0 ? { signals: sortNodes(doc.signals).map(canonicalNode) } : {}
   };
 }
+function deriveSingleCounts(doc) {
+  return { nodes: doc.nodes?.length ?? 0, edges: doc.edges?.length ?? 0 };
+}
+function derivePortfolioCounts(doc) {
+  const members = doc.products ?? [];
+  const memberKindOf = (p) => p.member_kind ?? "product";
+  const watchedCount = members.filter((p) => memberKindOf(p) === "watched").length;
+  const rollupCount = members.filter((p) => memberKindOf(p) === "org_rollup").length;
+  const operatingFunctionCount = members.filter((p) => memberKindOf(p) === "operating_function").length;
+  return {
+    products: members.filter((p) => memberKindOf(p) === "product").length,
+    ...watchedCount > 0 ? { watched_products: watchedCount } : {},
+    ...rollupCount > 0 ? { org_rollups: rollupCount } : {},
+    ...operatingFunctionCount > 0 ? { operating_functions: operatingFunctionCount } : {},
+    product_areas: doc.product_areas?.length ?? 0,
+    portfolios: doc.portfolios?.length ?? 0,
+    cross_edges: doc.cross_edges?.length ?? 0
+  };
+}
+function deriveCounts(doc) {
+  return isPortfolio(doc) ? derivePortfolioCounts(doc) : deriveSingleCounts(doc);
+}
 function computeBodyChecksum(doc) {
   const body = isPortfolio(doc) ? portfolioBody(doc) : singleBody(doc);
   const content = JSON.stringify(body);
@@ -30019,7 +30226,7 @@ function serializeSingleWithHeader(doc, opts) {
   };
   const summary = deriveSummary(product.description);
   if (summary) header.summary = summary;
-  header.counts = { nodes: doc.nodes?.length ?? 0, edges: doc.edges?.length ?? 0 };
+  header.counts = deriveSingleCounts(doc);
   if (doc.member_kind === "org_rollup" || doc.member_kind === "watched" || doc.member_kind === "operating_function") {
     header.member_kind = doc.member_kind;
   }
@@ -30042,20 +30249,7 @@ function serializePortfolioWithHeader(doc, opts) {
   };
   const summary = deriveSummary(org.description);
   if (summary) header.summary = summary;
-  const members = doc.products ?? [];
-  const memberKindOf = (p) => p.member_kind ?? "product";
-  const watchedCount = members.filter((p) => memberKindOf(p) === "watched").length;
-  const rollupCount = members.filter((p) => memberKindOf(p) === "org_rollup").length;
-  const operatingFunctionCount = members.filter((p) => memberKindOf(p) === "operating_function").length;
-  header.counts = {
-    products: members.filter((p) => memberKindOf(p) === "product").length,
-    ...watchedCount > 0 ? { watched_products: watchedCount } : {},
-    ...rollupCount > 0 ? { org_rollups: rollupCount } : {},
-    ...operatingFunctionCount > 0 ? { operating_functions: operatingFunctionCount } : {},
-    product_areas: doc.product_areas?.length ?? 0,
-    portfolios: doc.portfolios?.length ?? 0,
-    cross_edges: doc.cross_edges?.length ?? 0
-  };
+  header.counts = derivePortfolioCounts(doc);
   header.provenance = buildProvenance(doc, opts);
   header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
   return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
@@ -30123,9 +30317,61 @@ function isCanonical(text) {
   const parsed = parseUpg(text);
   return text === serializeCanonical(parsed);
 }
+function checkHeaderSeal(obj) {
+  const raw = obj;
+  const header = raw?.$upg;
+  const report = {
+    header_present: !!header,
+    counts_checked: false,
+    integrity_checked: false,
+    counts_drift: [],
+    integrity_drift: []
+  };
+  if (!header) return report;
+  if (header.format_version !== UPG_CANONICAL_FORMAT_VERSION) {
+    report.skipped_reason = `format_version "${header.format_version}" is not this serialiser's "${UPG_CANONICAL_FORMAT_VERSION}"; counts keys and body layout are format-version contracts, so neither seal can be judged here.`;
+    return report;
+  }
+  const doc = normalizeDocument(raw);
+  const declaredCounts = header.counts ?? {};
+  const actualCounts = deriveCounts(doc);
+  if (header.counts === void 0) {
+    report.skipped_reason = "header has no `counts` block to compare.";
+  } else {
+    report.counts_checked = true;
+    const fields = /* @__PURE__ */ new Set([...Object.keys(declaredCounts), ...Object.keys(actualCounts)]);
+    for (const field of [...fields].sort()) {
+      const declaredRaw = declaredCounts[field];
+      const declared = typeof declaredRaw === "number" ? declaredRaw : 0;
+      const actual = actualCounts[field] ?? 0;
+      if (declared !== actual) report.counts_drift.push({ field, declared, actual });
+    }
+  }
+  const integrity = header.integrity;
+  if (!integrity || typeof integrity.body !== "string") {
+    report.skipped_reason = report.skipped_reason ?? "header has no `integrity.body` seal to compare.";
+  } else if (integrity.algorithm !== INTEGRITY_ALGORITHM) {
+    report.skipped_reason = report.skipped_reason ?? `integrity.algorithm "${integrity.algorithm}" is not "${INTEGRITY_ALGORITHM}"; the declared digest cannot be recomputed here.`;
+  } else {
+    report.integrity_checked = true;
+    const computed = computeBodyChecksum(doc);
+    if (computed !== integrity.body) {
+      report.integrity_drift.push({
+        algorithm: integrity.algorithm,
+        declared: integrity.body,
+        computed
+      });
+    }
+  }
+  return report;
+}
+function checkHeaderSealText(text) {
+  const noBom = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
+  return checkHeaderSeal(JSON.parse(noBom));
+}
 
 // src/index.ts
-var UPG_VERSION = "0.25.1";
+var UPG_VERSION = "0.26.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -30295,6 +30541,8 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   backfillSlug,
   buildTypeAliases,
   canBeChildOf,
+  checkHeaderSeal,
+  checkHeaderSealText,
   coerceProductStage,
   collectSlugsForType,
   compareVersions,
@@ -30303,6 +30551,9 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   concernFor,
   concernGatesFor,
   crossProductScope,
+  deriveCounts,
+  derivePortfolioCounts,
+  deriveSingleCounts,
   describeTreePattern,
   edgeCarriesProperties,
   evaluateAntiPatterns,