trueppm-api 0.4.0__py3-none-any.whl

trueppm_api/apps/projects/schemas/seed_v2.json

@@ -0,0 +1,891 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trueppm.com/schemas/seed/v2.json",
+  "title": "TruePPM seed data v2",
+  "description": "Canonical JSON seed format, v2 (ADR-0114). Additive superset of v1: dates may be authored as offsets from a top-level `anchor` resolved at import day, and an ordered `events` timeline is replayed chronologically with backdated history so the demo tells a life, not a snapshot. v1 documents remain valid under the v1 validator; v2 adds `anchor`, the relative-date grammar, and `events`.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "program", "projects"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "description": "Schema major.minor. validate_seed() rejects unsupported majors. 2.1 is an additive minor (#3603): program backlog_items / ceremonies / agent_actions, project share_links, task acceptance_criteria, and the task.note / task.react / task.ack / time.log events. A 2.0 document is valid unchanged.",
+      "enum": ["2.0", "2.1"]
+    },
+    "anchor": {
+      "type": "string",
+      "format": "date",
+      "description": "Optional explicit reference date for relative offsets (\"A\"). When omitted, the anchor resolves to the import day, so the demo always looks current. Authoring an explicit anchor pins a fixed-date demo (discouraged)."
+    },
+    "program": { "$ref": "#/$defs/program" },
+    "accounts": {
+      "type": "array",
+      "maxItems": 2000,
+      "description": "User logins referenced by the seed. Created only when import runs with --create-users; on the sample path they resolve to namespaced unusable-password persona rows.",
+      "items": { "$ref": "#/$defs/account" }
+    },
+    "calendars": {
+      "type": "array",
+      "maxItems": 200,
+      "items": { "$ref": "#/$defs/calendar" }
+    },
+    "resources": {
+      "type": "array",
+      "maxItems": 5000,
+      "items": { "$ref": "#/$defs/resource" }
+    },
+    "risks": {
+      "type": "array",
+      "maxItems": 5000,
+      "description": "Program-scoped risks. Project-scoped risks live under each project.",
+      "items": { "$ref": "#/$defs/risk" }
+    },
+    "projects": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 200,
+      "items": { "$ref": "#/$defs/project" }
+    },
+    "events": {
+      "type": "array",
+      "description": "Ordered timeline (ADR-0114). Each event mutates a target through a real write path and writes a history row dated to `at`. Events are applied in `at` order (ties broken by array index). The synthesizer fills unauthored status moves; authored events always win.",
+      "maxItems": 100000,
+      "items": { "$ref": "#/$defs/event" }
+    }
+  },
+  "$defs": {
+    "slug": {
+      "type": "string",
+      "description": "File-local stable identifier, kebab-case. Capped at 40 so the program slug fits Program.code.",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "maxLength": 40
+    },
+    "wbsPath": {
+      "type": "string",
+      "description": "ltree path, e.g. \"1.2.3\". Per-project task identity.",
+      "pattern": "^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*$",
+      "maxLength": 255
+    },
+    "taskRef": {
+      "type": "string",
+      "description": "A task by wbs path. Bare for the enclosing project, or \"<project-slug>:<wbs-path>\" for a sibling project.",
+      "pattern": "^([a-z0-9]+(-[a-z0-9]+)*:)?[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*$"
+    },
+    "sprintRef": {
+      "type": "string",
+      "description": "A sprint as \"<project-slug>:<sprint-slug>\".",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*:[a-z0-9]+(-[a-z0-9]+)*$"
+    },
+    "color": {
+      "type": "string",
+      "pattern": "^#[0-9A-Fa-f]{6}$"
+    },
+    "seedDate": {
+      "type": "string",
+      "description": "Either an ISO date (\"2026-01-05\") or an anchor-relative offset (\"A-120\", \"A+15\"). The offset is capped at 4 digits (~27 years) so a crafted seed can't drive an unbounded replay span. A trailing \"!\" opts out of weekend-snapping so the date lands exactly. Relative dates that fall on a non-working day snap forward to the next working day via the project calendar.",
+      "pattern": "^(\\d{4}-\\d{2}-\\d{2}|A[+-]\\d{1,4}!?)$"
+    },
+    "seedTimestamp": {
+      "type": "string",
+      "description": "An event time: ISO datetime (\"2026-01-05T14:10\"), or anchor-relative \"A-87T14:10\" / \"A-87\" (midnight). The offset is capped at 4 digits (~27 years). Timestamps are never weekend-snapped — an event occurs when it occurs.",
+      "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2})?|A[+-]\\d{1,4}(T\\d{2}:\\d{2})?)$"
+    },
+    "program": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "name", "methodology"],
+      "properties": {
+        "slug": {
+          "$ref": "#/$defs/slug",
+          "description": "Program natural key. Persisted into Program.code; re-import upserts on (workspace, code)."
+        },
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "description": { "type": "string", "maxLength": 100000 },
+        "methodology": { "enum": ["WATERFALL", "AGILE", "HYBRID"] },
+        "color": { "$ref": "#/$defs/color" },
+        "lead": {
+          "$ref": "#/$defs/slug",
+          "description": "Account slug of the program lead."
+        },
+        "backlog_items": {
+          "type": "array",
+          "maxItems": 5000,
+          "description": "v2.1. Program backlog (BacklogItem, ADR-0069) — the intake pool work is proposed into before any project commits to it.",
+          "items": { "$ref": "#/$defs/backlogItem" }
+        },
+        "ceremonies": {
+          "type": "array",
+          "maxItems": 100,
+          "description": "v2.1. Recurring program ceremonies (CeremonyTemplate, ADR-0079). Sprint events — standup, sprint review, retrospective — are team-level and rejected here, exactly as the API rejects them.",
+          "items": { "$ref": "#/$defs/ceremony" }
+        },
+        "agent_actions": {
+          "type": "array",
+          "maxItems": 1000,
+          "description": "v2.1, BUNDLED SAMPLES ONLY. An audited agent trail for the agent-oversight panel. Audit evidence must not be authorable by a file a user controls, so every non-sample import rejects this key. Rows are written through the real hash chain and marked as sample data in hashed fields.",
+          "items": { "$ref": "#/$defs/agentAction" }
+        },
+        "mc_history_enabled": {
+          "type": "boolean",
+          "description": "Program-level override of the Monte Carlo run-history feature (ADR-0144). Omit to inherit the workspace default; set true on a program whose projects author `forecast_history` so the MC history panel/tornado are populated on load (#3494)."
+        },
+        "mc_history_attribution_audience": {
+          "enum": ["admin_owner", "scheduler_plus", "none"],
+          "description": "Program-level override of who may see the run-author name on Monte Carlo history (ADR-0144). Omit to inherit the workspace default."
+        }
+      }
+    },
+    "backlogItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "title"],
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "description": { "type": "string", "maxLength": 100000 },
+        "item_type": { "enum": ["epic", "feature", "story", "task", "bug", "spike", "chore"] },
+        "status": {
+          "enum": ["proposed", "pulled", "archived"],
+          "description": "Default proposed. pulled requires pulled_to."
+        },
+        "tags": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "type": "string", "minLength": 1, "maxLength": 64 }
+        },
+        "priority_rank": { "type": "integer", "minimum": 0 },
+        "story_points": { "type": "integer", "minimum": 0, "maximum": 32767 },
+        "pulled_to": {
+          "type": "string",
+          "description": "The task this item became, as \"<project-slug>:<wbs-path>\". Only valid with status pulled.",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*:[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*$"
+        },
+        "pulled_by": { "$ref": "#/$defs/slug" },
+        "pulled_at": { "$ref": "#/$defs/seedTimestamp" },
+        "created_by": { "$ref": "#/$defs/slug" },
+        "created_at": { "$ref": "#/$defs/seedTimestamp" }
+      }
+    },
+    "ceremony": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "cadence_type"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "cadence_type": { "enum": ["weekly", "biweekly", "monthly", "on_milestone"] },
+        "cadence_day": {
+          "type": "string",
+          "maxLength": 32,
+          "description": "weekly/biweekly: a weekday (\"tuesday\"); monthly: ordinal-weekday (\"1st-thursday\"); omit for on_milestone."
+        },
+        "cadence_time": {
+          "type": "string",
+          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
+          "description": "HH:MM. Required for weekly/biweekly/monthly."
+        },
+        "duration_minutes": { "type": "integer", "minimum": 5, "maximum": 1440 },
+        "owner_role": { "type": "string", "maxLength": 64 },
+        "enabled": { "type": "boolean" }
+      }
+    },
+    "agentAction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["at", "action", "verdict"],
+      "description": "One audited agent decision (AgentAction, ADR-0112). Sample-only — see program.agent_actions.",
+      "properties": {
+        "at": { "$ref": "#/$defs/seedTimestamp" },
+        "principal": {
+          "$ref": "#/$defs/slug",
+          "description": "Account on whose behalf the agent acted."
+        },
+        "action": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "method": { "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+        "capability": { "type": "string", "maxLength": 64 },
+        "project": { "$ref": "#/$defs/slug" },
+        "object_type": { "type": "string", "maxLength": 64 },
+        "object": {
+          "type": "string",
+          "description": "Task the action addressed, as \"<project-slug>:<wbs-path>\".",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*:[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*$"
+        },
+        "verdict": { "enum": ["allowed", "refused", "requires_approval"] },
+        "refusal_reason": { "enum": ["identity", "policy"] },
+        "refusal_constraint": {
+          "enum": [
+            "capability_scope",
+            "token_identity",
+            "graph_validation",
+            "sprint_sovereignty",
+            "rollup_lock",
+            "engine_referee"
+          ]
+        },
+        "projected_impact": { "type": "object", "maxProperties": 20 },
+        "summary": { "type": "string", "maxLength": 2000 }
+      }
+    },
+    "shareLink": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "v2.1, BUNDLED SAMPLES ONLY. A public read-only link (ShareLink, ADR-0245). The token is always minted at load and never read from the file; every non-sample import rejects this key.",
+      "properties": {
+        "content_kind": { "enum": ["board", "schedule"] },
+        "label": { "type": "string", "maxLength": 120 },
+        "show_assignees": { "type": "boolean" },
+        "show_milestone_dates": { "type": "boolean" },
+        "created_by": { "$ref": "#/$defs/slug" },
+        "expires_in_days": { "type": "integer", "minimum": 1, "maximum": 365 }
+      }
+    },
+    "recurrence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["frequency"],
+      "description": "v2.1. Makes this task a recurrence template (TaskRecurrenceRule, ADR-0090). Only the rule is seeded; occurrences spawn lazily on the generator's horizon, and the template leaves the CPM graph. end_date or end_count bounds the series; neither means it never ends.",
+      "properties": {
+        "frequency": { "enum": ["DAILY", "WEEKLY", "MONTHLY"] },
+        "interval": { "type": "integer", "minimum": 1, "maximum": 365 },
+        "weekdays": {
+          "type": "array",
+          "uniqueItems": true,
+          "maxItems": 7,
+          "description": "WEEKLY only; required for it.",
+          "items": { "enum": ["mon", "tue", "wed", "thu", "fri", "sat", "sun"] }
+        },
+        "day_of_month": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 31,
+          "description": "MONTHLY only; required for it."
+        },
+        "time_of_day": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" },
+        "end_date": { "$ref": "#/$defs/seedDate" },
+        "end_count": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "proficiency": { "enum": ["beginner", "intermediate", "expert"] },
+    "resourceSkill": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "proficiency": { "$ref": "#/$defs/proficiency" },
+        "category": { "type": "string", "maxLength": 60 }
+      }
+    },
+    "skillRequirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["skill"],
+      "properties": {
+        "skill": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "min_proficiency": { "$ref": "#/$defs/proficiency" }
+      }
+    },
+    "team": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["members"],
+      "description": "v2.1. The project's default team (ADR-0078): its name and the Scrum Master / Product Owner facets. Membership itself mirrors the project's members; list here only the people whose facets or presence you want to state.",
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "members": {
+          "type": "array",
+          "maxItems": 2000,
+          "items": { "$ref": "#/$defs/teamMember" }
+        }
+      }
+    },
+    "teamMember": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["account"],
+      "properties": {
+        "account": { "$ref": "#/$defs/slug" },
+        "scrum_master": { "type": "boolean" },
+        "product_owner": { "type": "boolean" }
+      }
+    },
+    "acceptanceCriterion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["text"],
+      "properties": {
+        "text": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "given": { "type": "string", "maxLength": 1000 },
+        "when": { "type": "string", "maxLength": 1000 },
+        "then": { "type": "string", "maxLength": 1000 },
+        "met": { "type": "boolean" },
+        "met_by": { "$ref": "#/$defs/slug" },
+        "met_at": { "$ref": "#/$defs/seedTimestamp" }
+      }
+    },
+    "account": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "username"],
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "username": { "type": "string", "minLength": 1, "maxLength": 150 },
+        "email": { "type": "string", "format": "email" },
+        "display_name": { "type": "string", "maxLength": 255 },
+        "role": {
+          "enum": ["VIEWER", "MEMBER", "SCHEDULER", "ADMIN", "OWNER"],
+          "description": "Program membership role granted on import."
+        }
+      }
+    },
+    "projectMember": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["account", "role"],
+      "description": "One project-level membership. See project.members.",
+      "properties": {
+        "account": { "$ref": "#/$defs/slug" },
+        "role": {
+          "enum": ["VIEWER", "MEMBER", "SCHEDULER", "ADMIN", "OWNER"],
+          "description": "Project membership role granted on import."
+        }
+      }
+    },
+    "boardLane": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "label"],
+      "description": "A named lane WITHIN a board column (#2967). Keys are unique project-wide.",
+      "properties": {
+        "key": { "$ref": "#/$defs/slug" },
+        "label": { "type": "string", "minLength": 1, "maxLength": 32 },
+        "wip_limit": { "type": ["integer", "null"], "minimum": 1 }
+      }
+    },
+    "boardColumn": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "label"],
+      "description": "One Kanban column. Mirrors BoardColumnConfig.columns; the seed cannot express a shape the board API would reject.",
+      "properties": {
+        "status": {
+          "enum": ["BACKLOG", "NOT_STARTED", "IN_PROGRESS", "REVIEW", "COMPLETE"]
+        },
+        "label": { "type": "string", "minLength": 1, "maxLength": 32 },
+        "visible": { "type": "boolean" },
+        "color": { "type": ["string", "null"], "pattern": "^#[0-9A-Fa-f]{6}$" },
+        "wip_limit": { "type": ["integer", "null"], "minimum": 1 },
+        "age_threshold_days": { "type": ["integer", "null"], "minimum": 1 },
+        "lanes": {
+          "type": "array",
+          "maxItems": 6,
+          "items": { "$ref": "#/$defs/boardLane" }
+        }
+      }
+    },
+    "taskAttachment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["external_url"],
+      "description": "An external reference on a task. URL-only: TaskAttachment stores a file XOR an external_url, and a seed is a text document, so the file half is deliberately not expressible.",
+      "properties": {
+        "external_url": { "type": "string", "format": "uri", "maxLength": 2048 },
+        "external_title": { "type": "string", "maxLength": 255 },
+        "is_pinned": { "type": "boolean" },
+        "uploaded_by": { "$ref": "#/$defs/slug" }
+      }
+    },
+    "taskBlocker": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "The explicit human blocker flag (#1135, ADR-0124). A present cluster means blocked. `reason` is optional: an export withholds the private reason text from anyone but the task's assignee or an @-mentioned user (#4082), and the importer stamps a placeholder so the task still imports as blocked. NOT the derived has-incomplete-predecessors signal, and `blocking_task` is a soft 'waiting on' link that never enters CPM.",
+      "properties": {
+        "reason": { "type": "string", "minLength": 1, "maxLength": 100000 },
+        "since": { "$ref": "#/$defs/seedDate" },
+        "type": { "enum": ["dependency", "resource", "vendor", "decision", "other"] },
+        "blocking_task": { "type": "string", "maxLength": 512 },
+        "by": { "$ref": "#/$defs/slug" }
+      }
+    },
+    "calendar": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "name"],
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "working_days": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 127,
+          "description": "Bitmask Mon=1..Sun=64. Default 31 (Mon-Fri)."
+        },
+        "hours_per_day": { "type": "number", "exclusiveMinimum": 0, "maximum": 24 },
+        "timezone": { "type": "string", "maxLength": 64 },
+        "exceptions": {
+          "type": "array",
+          "description": "Non-working date ranges (holidays, shutdowns, PTO). Materialized as CalendarException rows and also treated as non-working days by the relative-date resolver (a date snapped forward will skip these).",
+          "maxItems": 500,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["exc_start", "exc_end"],
+            "properties": {
+              "exc_start": { "$ref": "#/$defs/seedDate" },
+              "exc_end": { "$ref": "#/$defs/seedDate" },
+              "description": { "type": "string", "maxLength": 255 }
+            }
+          }
+        }
+      }
+    },
+    "forecastHistory": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Backfill parameters for ProjectForecastSnapshot history (#376, ADR-0211). Synthesizes one snapshot per day across `days`, drifting the CPM finish and each Monte Carlo percentile from its `*_start` to its `*_end` date while `commitment_finish` stays fixed — so the forecast-trend chart shows a real slip and total-float pressure turning negative. Deterministic (seeded on program + project). MC percentiles are all-or-none: provide the full p50/p80/p95 start+end set, or omit them for a CPM-only history (MC lines stay null until someone runs Monte Carlo).",
+      "required": ["days", "commitment_finish", "cpm_start", "cpm_end"],
+      "properties": {
+        "days": { "type": "integer", "minimum": 1, "maximum": 365 },
+        "commitment_finish": {
+          "$ref": "#/$defs/seedDate",
+          "description": "The promised finish date that does NOT move over the window; total_float_days is derived as (commitment_finish - cpm_finish) each day."
+        },
+        "cpm_start": { "$ref": "#/$defs/seedDate" },
+        "cpm_end": { "$ref": "#/$defs/seedDate" },
+        "p50_start": { "$ref": "#/$defs/seedDate" },
+        "p50_end": { "$ref": "#/$defs/seedDate" },
+        "p80_start": { "$ref": "#/$defs/seedDate" },
+        "p80_end": { "$ref": "#/$defs/seedDate" },
+        "p95_start": { "$ref": "#/$defs/seedDate" },
+        "p95_end": { "$ref": "#/$defs/seedDate" },
+        "mc_iterations": { "type": "integer", "minimum": 1 },
+        "completion_ratio": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Fraction of tasks complete by the newest snapshot; completed_task_count ramps 0 -> round(completion_ratio * task_count) across the window. Default 0.5."
+        }
+      }
+    },
+    "resource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "name"],
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "email": { "type": "string", "format": "email" },
+        "job_role": { "type": "string", "maxLength": 120 },
+        "max_units": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 99.99,
+          "description": "Availability fraction. 1.0 = full-time. 0.1 = 10% advisor."
+        },
+        "calendar": { "$ref": "#/$defs/slug" },
+        "account": {
+          "$ref": "#/$defs/slug",
+          "description": "Optional account slug linking this resource to a user login (Resource.user)."
+        },
+        "skills": {
+          "type": "array",
+          "maxItems": 50,
+          "description": "v2.1. Skills on the workspace catalog (Skill, de-duplicated case-insensitively) with this resource's proficiency.",
+          "items": { "$ref": "#/$defs/resourceSkill" }
+        }
+      }
+    },
+    "estimate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["optimistic", "most_likely", "pessimistic"],
+      "description": "Three-point PERT estimate in working days. All-or-none: present means all three; omit entirely for unestimated tasks. Never set on summary or milestone tasks.",
+      "properties": {
+        "optimistic": { "type": "integer", "minimum": 0 },
+        "most_likely": { "type": "integer", "minimum": 0 },
+        "pessimistic": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "task": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["wbs_path", "name"],
+      "properties": {
+        "wbs_path": { "$ref": "#/$defs/wbsPath" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "type": {
+          "enum": ["epic", "story", "task", "bug", "spike", "tech_debt"],
+          "description": "TaskType. tech_debt (2.1) is schedulable work that counts toward velocity like a story."
+        },
+        "is_subtask": {
+          "type": "boolean",
+          "description": "v2.1. A drawer subtask (ADR-0060): its wbs_path is one level under a leaf task that has no structural children, and it cannot itself have children."
+        },
+        "recurrence": { "$ref": "#/$defs/recurrence" },
+        "skill_requirements": {
+          "type": "array",
+          "maxItems": 20,
+          "description": "v2.1. Skills this task needs (TaskSkillRequirement), matched against resources[].skills by name, case-insensitively.",
+          "items": { "$ref": "#/$defs/skillRequirement" }
+        },
+        "status": {
+          "enum": ["BACKLOG", "NOT_STARTED", "IN_PROGRESS", "REVIEW", "ON_HOLD", "COMPLETE"],
+          "description": "Final state at import. The events timeline + synthesizer reconstruct how the task reached it."
+        },
+        "is_milestone": { "type": "boolean" },
+        "duration": { "type": "integer", "minimum": 0 },
+        "planned_start": { "$ref": "#/$defs/seedDate" },
+        "percent_complete": { "type": "number", "minimum": 0, "maximum": 100 },
+        "notes": { "type": "string", "maxLength": 10000 },
+        "estimate": { "$ref": "#/$defs/estimate" },
+        "story_points": { "type": "integer", "minimum": 0 },
+        "remaining_points": { "type": "integer", "minimum": 0 },
+        "assignee": { "$ref": "#/$defs/slug" },
+        "sprint": { "$ref": "#/$defs/slug" },
+        "parent_epic": {
+          "$ref": "#/$defs/wbsPath",
+          "description": "wbs_path of the epic task grouping this story (Task.parent_epic)."
+        },
+        "dor": { "enum": ["idea", "refine", "ready"] },
+        "sprint_rank": { "type": "integer", "minimum": 0 },
+        "governance_class": { "enum": ["gated", "flow", "hybrid"] },
+        "delivery_mode": { "enum": ["waterfall", "scrum", "kanban", "milestone"] },
+        "color": { "$ref": "#/$defs/color" },
+        "labels": {
+          "type": "array",
+          "description": "Slugs of project labels (ADR-0400) attached to this task, referencing project.labels.",
+          "items": { "$ref": "#/$defs/slug" }
+        },
+        "links": {
+          "type": "array",
+          "default": [],
+          "description": "Informational task-to-task relations (ADR-0455) authored on this task as the source, e.g. \"relates to\" / \"blocks\" / \"duplicates\". A relation is a non-scheduling cross-reference — distinct from a CPM `dependency` — so it carries no lag, dep_type, or schedule effect.",
+          "items": { "$ref": "#/$defs/taskRelation" }
+        },
+        "board_lane": {
+          "$ref": "#/$defs/slug",
+          "description": "Named lane WITHIN this task's status column (#2967); must match a lane key on the project's board_columns entry for that status."
+        },
+        "blocked": { "$ref": "#/$defs/taskBlocker" },
+        "acceptance_criteria": {
+          "type": "array",
+          "maxItems": 50,
+          "description": "v2.1. Tickable acceptance criteria (AcceptanceCriterion, ADR-0105), in display order. A task.ac_met beat carrying `criterion` ticks one by index on a dated beat.",
+          "items": { "$ref": "#/$defs/acceptanceCriterion" }
+        },
+        "attachments": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/taskAttachment" }
+        },
+        "assignments": {
+          "type": "array",
+          "description": "Resource allocations on this task. assignee is the responsible user; assignments are capacity (Resource + units fraction of max_units).",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["resource"],
+            "properties": {
+              "resource": { "$ref": "#/$defs/slug" },
+              "units": { "type": "number", "exclusiveMinimum": 0, "maximum": 99.99 }
+            }
+          }
+        }
+      }
+    },
+    "dependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["predecessor", "successor", "dep_type"],
+      "properties": {
+        "predecessor": { "$ref": "#/$defs/taskRef" },
+        "successor": { "$ref": "#/$defs/taskRef" },
+        "dep_type": { "enum": ["FS", "SS", "FF", "SF"] },
+        "lag": {
+          "type": "integer",
+          "description": "Calendar days. Positive = delay, negative = lead."
+        }
+      }
+    },
+    "taskRelation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["target", "link_type"],
+      "description": "An informational task-to-task cross-reference (ADR-0455), authored on a task's `links` array with that task as the source. `target` is a task ref (bare wbs path for the enclosing project, or \"<project-slug>:<wbs-path>\" for a sibling project in the same program). Distinct from a scheduling `dependency`: inert, no CPM edge, no lag.",
+      "properties": {
+        "target": { "$ref": "#/$defs/taskRef" },
+        "link_type": {
+          "enum": ["relates_to", "blocks", "duplicates"],
+          "description": "RELATES_TO is symmetric; BLOCKS and DUPLICATES are directional (source → target)."
+        },
+        "note": { "type": "string", "maxLength": 280 }
+      }
+    },
+    "sprint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "name", "state", "start_date", "finish_date"],
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "goal": { "type": "string", "maxLength": 10000 },
+        "notes": { "type": "string", "maxLength": 10000 },
+        "start_date": { "$ref": "#/$defs/seedDate" },
+        "finish_date": { "$ref": "#/$defs/seedDate" },
+        "state": { "enum": ["PLANNED", "ACTIVE", "COMPLETED", "CANCELLED"] },
+        "committed_points": { "type": "integer", "minimum": 0 },
+        "completed_points": { "type": "integer", "minimum": 0 },
+        "capacity_points": { "type": "integer", "minimum": 0 },
+        "target_milestone": {
+          "$ref": "#/$defs/wbsPath",
+          "description": "wbs_path of a milestone task in the same project."
+        }
+      }
+    },
+    "baselineTask": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["task"],
+      "properties": {
+        "task": { "$ref": "#/$defs/wbsPath" },
+        "start": { "$ref": "#/$defs/seedDate" },
+        "finish": { "$ref": "#/$defs/seedDate" },
+        "duration": { "type": "integer", "minimum": 0 },
+        "story_points": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "baseline": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "tasks"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "is_active": { "type": "boolean" },
+        "captured_at": {
+          "$ref": "#/$defs/seedDate",
+          "description": "When the baseline was captured (drives backdated Baseline history). Defaults to the project start."
+        },
+        "tasks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/baselineTask" }
+        }
+      }
+    },
+    "risk": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "title", "status", "probability", "impact"],
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "description": { "type": "string", "maxLength": 100000 },
+        "status": { "enum": ["OPEN", "MITIGATING", "RESOLVED", "ACCEPTED", "CLOSED"] },
+        "probability": { "type": "integer", "minimum": 1, "maximum": 5 },
+        "impact": { "type": "integer", "minimum": 1, "maximum": 5 },
+        "category": { "enum": ["TECHNICAL", "EXTERNAL", "ORGANIZATIONAL", "PROJECT_MANAGEMENT"] },
+        "response": { "enum": ["AVOID", "MITIGATE", "TRANSFER", "ACCEPT"] },
+        "mitigation_due_date": { "$ref": "#/$defs/seedDate" },
+        "trigger": { "type": "string", "maxLength": 10000 },
+        "contingency": { "type": "string", "maxLength": 10000 },
+        "notes": { "type": "string", "maxLength": 10000 },
+        "owner": { "$ref": "#/$defs/slug" },
+        "tasks": {
+          "type": "array",
+          "description": "Task refs this risk is linked to. Bare wbs path = enclosing project; \"<slug>:<wbs>\" = sibling project (program-scoped risks only).",
+          "items": { "$ref": "#/$defs/taskRef" }
+        }
+      }
+    },
+    "event": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["at", "action"],
+      "description": "One timeline beat. `target` identifies what is mutated (\"task:<taskRef>\", \"sprint:<sprintRef>\", \"risk:<slug>\"). `actor` is an account slug; the row's history_user is attributed to it.",
+      "properties": {
+        "at": { "$ref": "#/$defs/seedTimestamp" },
+        "actor": { "$ref": "#/$defs/slug" },
+        "action": {
+          "enum": [
+            "task.status",
+            "task.assign",
+            "task.estimate",
+            "task.points",
+            "task.comment",
+            "task.ac_met",
+            "task.block",
+            "task.unblock",
+            "sprint.activate",
+            "sprint.close",
+            "sprint.scope_inject",
+            "sprint.scope_resolve",
+            "baseline.capture",
+            "risk.status",
+            "risk.note",
+            "retro.action",
+            "retro.promote",
+            "task.note",
+            "task.react",
+            "task.ack",
+            "time.log"
+          ],
+          "description": "Replayed actions. retro.action creates a RetroActionItem on the target sprint's retro, lazily creating the parent SprintRetro on first use; an optional `notes` on any retro.action beat sets/updates that SprintRetro's meeting-summary notes (typically authored once, on the retro's last action-item beat). retro.promote promotes an existing action item (matched by `body`) into a project-backlog task (ADR-0114 §7 / #1109). task.block/task.unblock raise and clear the explicit blocker flag, so a blocked span has a real duration on the timeline rather than a field that reads \"blocked 0 days\". risk.note appends a RiskComment, giving a risk.status flip its reason. v2.1 (#3603): task.note appends a dated TaskNote (`decision`/`pinned` optional); task.react / task.ack add a reaction or an acknowledgement to a comment declared with a `slug`; time.log writes a TimeEntry dated to the beat and is never forward-dated."
+        },
+        "target": {
+          "type": "string",
+          "description": "What the event mutates: \"task:<project-slug>:<wbs-path>\" (task.*, scope_inject/resolve, time.log), \"sprint:<project-slug>:<sprint-slug>\" (sprint.activate/close, retro.action/promote), \"project:<project-slug>\" (baseline.capture), \"risk:<slug>\" (risk.status, risk.note), or \"comment:<slug>\" (task.react, task.ack).",
+          "maxLength": 320
+        },
+        "slug": {
+          "$ref": "#/$defs/slug",
+          "description": "On task.comment: a document-unique comment id that reply_to, task.react and task.ack can refer to."
+        },
+        "reply_to": {
+          "$ref": "#/$defs/slug",
+          "description": "On task.comment: the slug of the top-level comment this one replies to. Replies are one level deep."
+        },
+        "criterion": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "On task.ac_met: zero-based index into the target task's acceptance_criteria to tick. Omit to mark the story ready instead."
+        },
+        "emoji": {
+          "enum": ["👍"],
+          "description": "On task.react. Mirrors the API's reaction allow-list."
+        },
+        "minutes": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1440,
+          "description": "On time.log: logged effort."
+        },
+        "note": { "type": "string", "maxLength": 500 },
+        "source": { "enum": ["manual", "timer"] },
+        "pinned": { "type": "boolean" },
+        "decision": {
+          "type": "boolean",
+          "description": "On task.note: mark the note as a decision so it appears in the Decisions view."
+        },
+        "from": { "type": "string", "maxLength": 64 },
+        "to": { "type": "string", "maxLength": 64 },
+        "goal_impact": {
+          "type": "boolean",
+          "description": "On sprint.scope_inject: whether the injection threatens the sprint goal."
+        },
+        "points": { "type": "integer", "minimum": 0 },
+        "remaining_points": { "type": "integer", "minimum": 0 },
+        "estimate": { "$ref": "#/$defs/estimate" },
+        "assignee": { "$ref": "#/$defs/slug" },
+        "body": { "type": "string", "maxLength": 10000 },
+        "notes": {
+          "type": "string",
+          "maxLength": 10000,
+          "description": "On retro.action: sets the target sprint's SprintRetro.notes (the meeting-summary text) rather than the RetroActionItem itself. Optional and typically authored once per retro."
+        },
+        "is_active": {
+          "type": "boolean",
+          "description": "On baseline.capture: whether this capture supersedes the project's current active baseline (deactivating it), collapsing the real app's separate capture + activate steps into one beat. Defaults to false — a captured baseline stays superseded unless authored active."
+        },
+        "goal_outcome": { "enum": ["MET", "PARTIAL", "MISSED"] },
+        "blocker_type": {
+          "enum": ["dependency", "resource", "vendor", "decision", "other"],
+          "description": "On task.block: the structured triage classification."
+        },
+        "blocking_task": {
+          "type": "string",
+          "maxLength": 512,
+          "description": "On task.block: a soft \"waiting on\" task ref. Never enters CPM."
+        }
+      }
+    },
+    "label": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "name"],
+      "description": "A project-scoped, colored task label (ADR-0400). Referenced by task.labels via slug.",
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 50 },
+        "color": {
+          "enum": ["slate", "teal", "purple", "blue", "rose", "amber", "green", "cyan"],
+          "description": "Stable categorical palette key (LabelColor), never a raw hex."
+        },
+        "position": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "name", "methodology", "start_date"],
+      "properties": {
+        "slug": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "description": { "type": "string", "maxLength": 100000 },
+        "methodology": { "enum": ["WATERFALL", "AGILE", "HYBRID"] },
+        "start_date": { "$ref": "#/$defs/seedDate" },
+        "calendar": { "$ref": "#/$defs/slug" },
+        "code": { "type": "string", "maxLength": 12 },
+        "lead": {
+          "$ref": "#/$defs/slug",
+          "description": "Account slug of this project's lead. Distinct from the program lead and from the OWNER membership: a workstream lead is who a program manager asks about this project, and is what the project header and program roll-up display."
+        },
+        "default_view": { "enum": ["SCHEDULE", "BOARD", "TABLE", "OVERVIEW"] },
+        "health": {
+          "enum": ["AUTO", "ON_TRACK", "AT_RISK", "CRITICAL"],
+          "description": "PM override for the project health chip (#520). Omit or AUTO to defer to the rollup; the explicit values are a manual judgment that surfaces immediately in lists and on the program overview."
+        },
+        "estimation_mode": { "enum": ["open", "suggest_approve", "pm_only"] },
+        "members": {
+          "type": "array",
+          "maxItems": 2000,
+          "description": "Per-project memberships. Omit to grant every account its program-level accounts[].role on this project; declare it to give one person different roles on different projects.",
+          "items": { "$ref": "#/$defs/projectMember" }
+        },
+        "agile_features": {
+          "type": "boolean",
+          "deprecated": true,
+          "description": "Accepted and ignored. The model field was removed in migration 0123 and the value is now derived from the project's own sprints; a document carrying this key still imports so an existing hand-authored seed does not break on upgrade."
+        },
+        "forecast_history": { "$ref": "#/$defs/forecastHistory" },
+        "team": { "$ref": "#/$defs/team" },
+        "share_links": {
+          "type": "array",
+          "maxItems": 20,
+          "description": "v2.1, BUNDLED SAMPLES ONLY. Public read-only links on this project; see $defs/shareLink.",
+          "items": { "$ref": "#/$defs/shareLink" }
+        },
+        "board_columns": {
+          "type": "array",
+          "maxItems": 5,
+          "description": "Kanban board configuration (BoardColumnConfig). All five canonical statuses must appear exactly once. Omit to leave the project on the API's hardcoded defaults.",
+          "items": { "$ref": "#/$defs/boardColumn" }
+        },
+        "labels": {
+          "type": "array",
+          "description": "Project label catalog (ADR-0400). Tasks reference these by slug via task.labels.",
+          "items": { "$ref": "#/$defs/label" }
+        },
+        "tasks": {
+          "type": "array",
+          "maxItems": 20000,
+          "items": { "$ref": "#/$defs/task" }
+        },
+        "dependencies": {
+          "type": "array",
+          "maxItems": 50000,
+          "items": { "$ref": "#/$defs/dependency" }
+        },
+        "sprints": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/sprint" }
+        },
+        "baselines": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/baseline" }
+        },
+        "risks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/risk" }
+        }
+      }
+    }
+  }
+}