@playola-radio/slipstream 0.1.0

package/schemas/projections/clip.v3.json

@@ -0,0 +1,212 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/projections/clip.v3.json",
+  "title": "clip.v3",
+  "$comment": "Reader-derived projection over immutable blobs and a closed language token. No log event, seq or policy_seq is appended. Spans cover raw UTF-8 bytes on whole-line boundaries. Pairing follows LCS diff correspondence, not semantic identity or move detection. Successful results are deterministic for pinned grammar versions; transient timing/availability outcomes are never cached.",
+  "type": "object",
+  "required": [
+    "change_seq",
+    "projection_version",
+    "status",
+    "clips"
+  ],
+  "properties": {
+    "change_seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$",
+      "$comment": "The `seq` of the file.changed event this projection is derived from. Stamped on the response; never part of the cache key."
+    },
+    "projection_version": {
+      "const": "clip.v3",
+      "$comment": "Names the complete extraction algorithm and is the cache key. A dropped cache recomputes an identical result under the same version."
+    },
+    "status": {
+      "enum": [
+        "ready",
+        "fallback",
+        "skipped",
+        "unavailable"
+      ],
+      "$comment": "ready: every changed segment is function-derived or a corresponding null side; fallback: at least one segment is not reliably enclosed by a function, parsing failed, or a soft timeout retained bounded ranges. Inspect per-side methods/reasons and truncated independently."
+    },
+    "fallback_reason": {
+      "type": "string",
+      "$comment": "Required unless ready: unsupported-language, no-enclosing-function, parse-error-in-enclosing-scope, extraction-budget-exhausted, timeout, and B1 availability/budget reasons. timeout is transient even with fallback clips."
+    },
+    "clips": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/clip"
+      }
+    }
+  },
+  "if": {
+    "properties": {
+      "status": {
+        "const": "ready"
+      }
+    }
+  },
+  "then": {},
+  "else": {
+    "required": [
+      "fallback_reason"
+    ]
+  },
+  "$defs": {
+    "clip": {
+      "type": "object",
+      "required": [
+        "before",
+        "after"
+      ],
+      "properties": {
+        "before": {
+          "$ref": "#/$defs/side"
+        },
+        "after": {
+          "$ref": "#/$defs/side"
+        }
+      }
+    },
+    "side": {
+      "type": "object",
+      "required": [
+        "span",
+        "method"
+      ],
+      "properties": {
+        "span": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/span"
+            }
+          ],
+          "$comment": "null means NO corresponding span on this side (created/deleted content), never unreadable content."
+        },
+        "method": {
+          "enum": [
+            "function",
+            "changed-range",
+            "whole-file",
+            "absent",
+            "unavailable"
+          ],
+          "$comment": "function: enclosing function rounded out to whole lines; changed-range: bounded diff range (null for no corresponding range); whole-file: no bounded diff; absent/unavailable: B1 dispositions."
+        },
+        "reason": {
+          "type": "string",
+          "$comment": "Present when the method needs one (e.g. `unavailable` carries the blob/snapshot reason)."
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "method": {
+                "const": "unavailable"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "span": {
+                "type": "null"
+              }
+            },
+            "required": [
+              "reason"
+            ]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "method": {
+                "const": "absent"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "span": {
+                "type": "null"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "method": {
+                "const": "whole-file"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "span": {
+                "$ref": "#/$defs/span"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "method": {
+                "const": "function"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "span": {
+                "$ref": "#/$defs/span"
+              }
+            }
+          }
+        }
+      ]
+    },
+    "span": {
+      "type": "object",
+      "required": [
+        "byte_start",
+        "byte_end",
+        "line_start",
+        "line_end",
+        "truncated"
+      ],
+      "properties": {
+        "byte_start": {
+          "type": "integer",
+          "minimum": 0,
+          "$comment": "Zero-based inclusive start byte offset into the raw blob."
+        },
+        "byte_end": {
+          "type": "integer",
+          "minimum": 0,
+          "$comment": "Zero-based exclusive end byte offset; the span is [byte_start, byte_end). Always lands on a UTF-8 boundary."
+        },
+        "line_start": {
+          "type": "integer",
+          "minimum": 1,
+          "$comment": "1-based inclusive first line covered."
+        },
+        "line_end": {
+          "type": "integer",
+          "minimum": 1,
+          "$comment": "1-based inclusive last line covered. Lines split on \\n (0x0a); a preceding \\r stays in the line (CRLF preserved); a trailing newline does not create a phantom last line."
+        },
+        "truncated": {
+          "type": "boolean",
+          "$comment": "True when the per-side line/byte budget clipped this span short of the full changed range."
+        }
+      }
+    }
+  }
+}

package/schemas/slipstream.capture.baseline.completed.v1.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.capture.baseline.completed.v1.json",
+  "title": "slipstream.capture.baseline.completed.v1",
+  "$comment": "Marks the initial baseline enumeration as finished. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.capture.baseline.completed.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "unknown_scopes"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "unknown_scopes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/slipstream.capture.gap.v1.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.capture.gap.v1.json",
+  "title": "slipstream.capture.gap.v1",
+  "$comment": "An explicit coverage gap: a scope over which observed states may be incomplete. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.capture.gap.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "scope",
+        "reason",
+        "observed_at_ms"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "scope": {
+          "$ref": "#/$defs/scope"
+        },
+        "reason": {
+          "enum": [
+            "coalesced",
+            "baseline-unreadable",
+            "watcher-error",
+            "restart",
+            "storage"
+          ]
+        },
+        "episode_id": {
+          "type": "string"
+        },
+        "observed_at_ms": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    }
+  },
+  "$defs": {
+    "scope": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "const": "session"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "kind",
+            "path"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "directory",
+                "path"
+              ]
+            },
+            "path": {
+              "type": "string"
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/slipstream.change.attribution.v1.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.change.attribution.v1.json",
+  "title": "slipstream.change.attribution.v1",
+  "$comment": "A full-replacement attribution result for one file.changed change, targeted by change_seq within this event's own source. Revisable inference, never verified authorship: the highest-seq attribution for a change_seq wins. policy_seq binds the result to the effective policy that preceded the change, so revisions score under the change's original policy. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.change.attribution.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "change_seq",
+        "policy_seq",
+        "status",
+        "reason",
+        "evidence_seqs"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "change_seq": {
+          "type": "string",
+          "pattern": "^[1-9][0-9]*$"
+        },
+        "policy_seq": {
+          "type": "string",
+          "pattern": "^[1-9][0-9]*$"
+        },
+        "status": {
+          "enum": [
+            "heuristic",
+            "ambiguous",
+            "unknown"
+          ]
+        },
+        "reason": {
+          "enum": [
+            "single-candidate",
+            "multiple-candidates",
+            "no-matching-evidence",
+            "observation-interval-unavailable"
+          ]
+        },
+        "evidence_seqs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[1-9][0-9]*$"
+          }
+        },
+        "excluded_conflicts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "harness",
+              "harness_session_id",
+              "record_id"
+            ],
+            "properties": {
+              "harness": {
+                "enum": [
+                  "claude-code",
+                  "codex"
+                ]
+              },
+              "harness_session_id": {
+                "type": "string"
+              },
+              "record_id": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/slipstream.enrichment.configured.v1.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.enrichment.configured.v1.json",
+  "title": "slipstream.enrichment.configured.v1",
+  "$comment": "The resolved effective attribution policy. Committed before the changes it governs and bound to each change by sequence, so a later revision scores under the policy in force when the change occurred. sources declares per-harness coverage; A1 wires no real adapters, so real sources are 'unconfigured'. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.enrichment.configured.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "policy"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "policy": {
+          "type": "object",
+          "required": [
+            "window_ms",
+            "grace_ms",
+            "sources"
+          ],
+          "properties": {
+            "window_ms": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "grace_ms": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "sources": {
+              "type": "object"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/slipstream.enrichment.coverage.v1.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.enrichment.coverage.v1.json",
+  "title": "slipstream.enrichment.coverage.v1",
+  "$comment": "Observed transcript-reading health for one harness source, so a client can distinguish 'read the scope and matched nothing' from 'could not read the scope'. Runtime health, NOT policy: folded highest-seq-wins per harness, independent of policy_seq. Absence of any coverage event means health is unknown, never a successful read. Never authorship, never a change. Unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.enrichment.coverage.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "harness",
+        "state"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "harness": {
+          "enum": [
+            "claude-code",
+            "codex"
+          ]
+        },
+        "state": {
+          "enum": [
+            "pending",
+            "readable",
+            "degraded",
+            "unavailable"
+          ]
+        },
+        "issues": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "kind",
+              "detail"
+            ],
+            "properties": {
+              "kind": {
+                "enum": [
+                  "missing",
+                  "inaccessible",
+                  "malformed",
+                  "unsupported",
+                  "discovery-limited"
+                ]
+              },
+              "detail": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}