loom-spec 0.4.0 → 0.5.0

package/schema/timeline.schema.json

@@ -1,135 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://loom-spec.dev/schema/timeline-v1.json",
-  "title": "Loom Timeline",
-  "description": "A time-axis overlay describing when events happen on the nodes of a diagram. Same node universe, different render.",
-  "type": "object",
-  "required": ["version", "id", "title", "diagram", "events"],
-  "additionalProperties": false,
-  "properties": {
-    "$schema": { "type": "string" },
-    "version": { "const": "1" },
-    "id": {
-      "type": "string",
-      "pattern": "^[a-z0-9-]+$",
-      "description": "Timeline identifier. Should match the filename without extension."
-    },
-    "title": { "type": "string", "minLength": 1 },
-    "description": { "type": "string" },
-    "diagram": {
-      "type": "string",
-      "pattern": "^[a-z0-9-]+$",
-      "description": "Id of the diagram whose nodes this timeline overlays."
-    },
-    "events": {
-      "type": "array",
-      "items": { "$ref": "#/$defs/TimelineEvent" }
-    },
-    "tracks": {
-      "type": "array",
-      "items": { "$ref": "#/$defs/TimelineTrack" },
-      "description": "Optional explicit track definitions (label, color). If omitted, tracks are inferred from events[].track values."
-    }
-  },
-
-  "$defs": {
-    "TimelineEvent": {
-      "type": "object",
-      "required": ["id", "node", "start_ms", "duration_ms"],
-      "additionalProperties": false,
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^[a-z0-9-]+$",
-          "description": "Unique within this timeline."
-        },
-        "node": {
-          "type": "string",
-          "pattern": "^[a-z0-9-]+$",
-          "description": "Node id from the referenced diagram."
-        },
-        "track": {
-          "type": "string",
-          "description": "Track label. Events on the same track are interpreted as sequential; events on different tracks at overlapping times are concurrent. If omitted, the renderer auto-assigns one track per node."
-        },
-        "start_ms": {
-          "type": "number",
-          "minimum": 0,
-          "description": "Start time in milliseconds from t=0."
-        },
-        "duration_ms": {
-          "type": "number",
-          "minimum": 0,
-          "description": "Duration in milliseconds. May be 0 for instantaneous events."
-        },
-        "label": {
-          "type": "string",
-          "maxLength": 60,
-          "description": "Short text rendered inside the clip."
-        },
-        "description": { "type": "string" },
-        "kind": {
-          "type": "string",
-          "enum": ["compute", "io", "wait", "error"],
-          "description": "Optional category for clip styling. Distinct from edge.kind in the diagram — this describes what the node is doing during this clip, not what flows between nodes."
-        },
-        "code_refs": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/CodeRef" },
-          "description": "Optional anchors to the specific function(s) running during this clip. Like node-level code_refs but scoped to a moment in time. Drift detection checks these too. Use for function-level granularity inside a node (e.g. 'validate' vs. 'issue jwt' both happen on the auth-service node)."
-        },
-        "triggered_by": {
-          "type": "string",
-          "pattern": "^[a-z0-9-]+$",
-          "description": "Optional id of another event that caused this one. Used for explicit causation chains and to preserve OTel span.parent_id when importing traces. The renderer can draw a connecting arrow between the two clips."
-        },
-        "tags": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Free-form labels for filtering or grouping clips. Examples: 'critical-path', 'billable-time', 'background'."
-        }
-      }
-    },
-
-    "CodeRef": {
-      "type": "object",
-      "required": ["path"],
-      "additionalProperties": false,
-      "description": "Same shape as the CodeRef in diagram.schema.json. Inlined here to keep the schema self-contained — no cross-file $ref required to validate.",
-      "properties": {
-        "path": {
-          "type": "string",
-          "description": "Repo-relative file path."
-        },
-        "symbol": {
-          "type": "string",
-          "description": "Function, class, or component name. Preferred over lines because it survives refactors."
-        },
-        "lines": {
-          "type": "string",
-          "pattern": "^[0-9]+(-[0-9]+)?(,[0-9]+(-[0-9]+)?)*$",
-          "description": "Line range(s) like '1-80' or '12,45-50'. Use only when no symbol applies."
-        }
-      }
-    },
-
-    "TimelineTrack": {
-      "type": "object",
-      "required": ["id", "label"],
-      "additionalProperties": false,
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^[a-z0-9-]+$",
-          "description": "Track id, matches event.track values."
-        },
-        "label": { "type": "string", "minLength": 1 },
-        "color": {
-          "type": "string",
-          "pattern": "^#[0-9a-fA-F]{6}$",
-          "description": "Optional background tint for the track lane."
-        }
-      }
-    }
-  }
-}