drift/docs/schema/project.schema.json at main · snowtema/drift · GitHub

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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/drift-codes/drift/blob/main/docs/schema/project.schema.json",
  "title": "drift project.json",
  "description": "Metadata for a single drift-tracked project",
  "type": "object",
  "required": ["id", "name", "created"],
  "additionalProperties": true,
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier (UUID v4), immutable after creation"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Human-readable project name"
    },
    "description": {
      "type": ["string", "null"],
      "description": "Why this project exists, one sentence"
    },
    "status": {
      "type": "string",
      "enum": ["idea", "active", "paused", "done", "abandoned"],
      "default": "active",
      "description": "Current project lifecycle status"
    },
    "progress": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "default": 0,
      "description": "Completion percentage (0-100). Auto-calculated from goals if present."
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "default": [],
      "description": "Freeform tags (stack, categories, etc.)"
    },
    "created": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 creation timestamp, immutable"
    },
    "lastActivity": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of last modification"
    },
    "goals": {
      "type": "array",
      "default": [],
      "items": {
        "type": "object",
        "required": ["text", "done"],
        "properties": {
          "text": {
            "type": "string",
            "description": "Goal description"
          },
          "done": {
            "type": "boolean",
            "default": false,
            "description": "Whether this goal is completed"
          }
        },
        "additionalProperties": false
      },
      "description": "Ordered checklist of project goals"
    },
    "notes": {
      "type": "array",
      "default": [],
      "items": {
        "type": "object",
        "required": ["ts", "text"],
        "properties": {
          "ts": {
            "type": "string",
            "format": "date-time",
            "description": "ISO 8601 timestamp"
          },
          "text": {
            "type": "string",
            "description": "Note content"
          }
        },
        "additionalProperties": false
      },
      "description": "Append-only chronological log of notes"
    },
    "links": {
      "type": "object",
      "default": {},
      "properties": {
        "repo": {
          "type": ["string", "null"],
          "format": "uri",
          "description": "Source code repository URL"
        },
        "deploy": {
          "type": ["string", "null"],
          "format": "uri",
          "description": "Live deployment URL"
        },
        "design": {
          "type": ["string", "null"],
          "format": "uri",
          "description": "Design file URL (Figma, etc.)"
        }
      },
      "additionalProperties": {
        "type": ["string", "null"],
        "format": "uri"
      },
      "description": "External reference links"
    }
  }
}