eidetic-engine 0.15.2

Durable, local-first, explainable memory for coding agents.
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://eidetic-engine/schemas/ee.memory_drift.queue.v1.json",
  "title": "ee.memory_drift.queue.v1",
  "description": "Deterministic, read-only queue of memories whose source provenance snapshots need explicit revalidation.",
  "type": "object",
  "required": ["schema", "generatedAt", "queueTruncated", "items", "degraded"],
  "additionalProperties": false,
  "properties": {
    "schema": {
      "type": "string",
      "const": "ee.memory_drift.queue.v1"
    },
    "generatedAt": {
      "type": ["string", "null"],
      "description": "RFC 3339 generation time when available. Determinism tests may scrub this volatile field."
    },
    "queueTruncated": {
      "type": "boolean"
    },
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/item"
      }
    },
    "degraded": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/degradation"
      }
    }
  },
  "$defs": {
    "driftStatus": {
      "type": "string",
      "enum": [
        "current",
        "changed",
        "missing_source",
        "stale_anchor",
        "unverifiable",
        "suppressed"
      ]
    },
    "anchorKind": {
      "type": "string",
      "enum": [
        "file_path",
        "symbol",
        "line_span_hash",
        "command_hash",
        "schema_id",
        "bead_id",
        "commit_hash",
        "session_fragment_hash"
      ]
    },
    "factors": {
      "type": "object",
      "required": [
        "memoryId",
        "importance",
        "trustClass",
        "trustScore",
        "recentPackInclusions",
        "downstreamGraphRefs",
        "daysSinceValidation",
        "suppressed"
      ],
      "additionalProperties": false,
      "properties": {
        "memoryId": { "type": "string" },
        "importance": { "type": "number", "minimum": 0, "maximum": 1 },
        "trustClass": { "type": "string" },
        "trustScore": { "type": "number", "minimum": 0, "maximum": 1 },
        "recentPackInclusions": { "type": "integer", "minimum": 0 },
        "downstreamGraphRefs": { "type": "integer", "minimum": 0 },
        "daysSinceValidation": { "type": "integer", "minimum": 0 },
        "suppressed": { "type": "boolean" }
      }
    },
    "comparison": {
      "type": "object",
      "required": [
        "anchorLabel",
        "anchorKind",
        "driftStatus",
        "previousContentHash",
        "currentContentHash",
        "previousMetadataHash",
        "currentMetadataHash",
        "reasonCodes"
      ],
      "additionalProperties": false,
      "properties": {
        "anchorLabel": { "type": "string" },
        "anchorKind": { "$ref": "#/$defs/anchorKind" },
        "driftStatus": { "$ref": "#/$defs/driftStatus" },
        "previousContentHash": { "type": ["string", "null"], "pattern": "^blake3:[0-9a-f]+$" },
        "currentContentHash": { "type": ["string", "null"], "pattern": "^blake3:[0-9a-f]+$" },
        "previousMetadataHash": { "type": "string", "pattern": "^blake3:[0-9a-f]+$" },
        "currentMetadataHash": { "type": ["string", "null"], "pattern": "^blake3:[0-9a-f]+$" },
        "reasonCodes": {
          "type": "array",
          "items": { "type": "string" }
        }
      }
    },
    "item": {
      "type": "object",
      "required": [
        "memoryId",
        "driftStatus",
        "priorityScore",
        "priorityScoreMicros",
        "affectedAnchorCount",
        "totalAnchorCount",
        "changeMagnitude",
        "factors",
        "reasonCodes",
        "comparisons"
      ],
      "additionalProperties": false,
      "properties": {
        "memoryId": { "type": "string" },
        "driftStatus": { "$ref": "#/$defs/driftStatus" },
        "priorityScore": { "type": "number", "minimum": 0, "maximum": 1 },
        "priorityScoreMicros": { "type": "integer", "minimum": 0, "maximum": 1000000 },
        "affectedAnchorCount": { "type": "integer", "minimum": 0 },
        "totalAnchorCount": { "type": "integer", "minimum": 0 },
        "changeMagnitude": { "type": "number", "minimum": 0, "maximum": 1 },
        "factors": { "$ref": "#/$defs/factors" },
        "reasonCodes": {
          "type": "array",
          "items": { "type": "string" }
        },
        "comparisons": {
          "type": "array",
          "items": { "$ref": "#/$defs/comparison" }
        }
      }
    },
    "degradation": {
      "type": "object",
      "required": ["code", "severity", "message"],
      "additionalProperties": false,
      "properties": {
        "code": { "type": "string" },
        "severity": {
          "type": "string",
          "enum": ["info", "low", "warning", "medium", "high", "critical"]
        },
        "message": { "type": "string" }
      }
    }
  }
}