spec-driven-docs 0.8.1

Spec-driven documentation: current specs, immutable decision records, and executable gates kept coherent for people and coding agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:spec-driven-docs:tracking.schema.json",
  "title": "Tracking registry",
  "description": "Structural shape of <root>/reference/tracking.yaml. The Rust validator enforces the cross-field, filesystem, and uniqueness rules this schema cannot.",
  "type": "object",
  "required": ["schema_version", "tracked"],
  "additionalProperties": false,
  "properties": {
    "schema_version": { "const": 1 },
    "tracked": {
      "type": "array",
      "uniqueItems": true,
      "items": { "$ref": "#/$defs/entry" }
    }
  },
  "$defs": {
    "entry": {
      "type": "object",
      "required": ["id", "path", "last_checked", "cadence_days", "why", "revalidate", "dependents"],
      "additionalProperties": false,
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
        "path": { "$ref": "#/$defs/relpath" },
        "last_checked": { "type": "string", "format": "date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
        "cadence_days": { "type": "integer", "minimum": 1 },
        "why": { "type": "string", "minLength": 1 },
        "revalidate": {
          "type": "array",
          "minItems": 1,
          "items": { "type": "string", "minLength": 1 }
        },
        "dependents": {
          "type": "array",
          "items": { "$ref": "#/$defs/relpath" }
        },
        "source": { "$ref": "#/$defs/source" }
      }
    },
    "source": {
      "type": "object",
      "required": ["kind", "repository", "reference", "revision", "license"],
      "additionalProperties": false,
      "properties": {
        "kind": { "const": "git" },
        "repository": { "type": "string", "pattern": "^https://[^\\s]+$" },
        "reference": { "type": "string", "pattern": "^refs/[^\\s]+$" },
        "revision": { "type": "string", "pattern": "^[0-9a-f]{40}([0-9a-f]{24})?$" },
        "license": { "type": "string", "minLength": 1 }
      }
    },
    "relpath": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[^/][^\\s]*$"
    }
  }
}