nandi.uk
This repository has no description
6.3 kB
187 lines
1{
2 "lexicon": 1,
3 "id": "org.latha.island",
4 "description": "A structured synthesis of an external source, cross-referenced with local knowledge (carry + vault). The stigmergic signal — a pheromone trail others can discover and build on.",
5 "defs": {
6 "main": {
7 "type": "record",
8 "description": "A Strata synthesis record. Produced when a user runs Strata analysis on a Semble card (or any AT Protocol record). Cross-references the source with the user's vault and carry data, producing themes, connections, tensions, and a prose synthesis.",
9 "key": "tid",
10 "record": {
11 "type": "object",
12 "required": ["source", "analysis", "createdAt"],
13 "properties": {
14 "source": {
15 "type": "ref",
16 "ref": "#sourceRef",
17 "description": "The source record that triggered this analysis. For islands, this is the lexmin vertex."
18 },
19 "connections": {
20 "type": "array",
21 "maxLength": 500,
22 "items": {
23 "type": "ref",
24 "ref": "#edge"
25 },
26 "description": "The island's edges — connection records with their graph structure embedded. No lookups needed to render."
27 },
28 "analysis": {
29 "type": "ref",
30 "ref": "#structuredAnalysis",
31 "description": "The structured analysis output."
32 },
33 "carryRefs": {
34 "type": "array",
35 "maxLength": 20,
36 "items": {
37 "type": "ref",
38 "ref": "#carryCrossRef"
39 },
40 "description": "Carry entities cross-referenced in this analysis. Carry stays local-first — only summaries are included unless explicitly published as companion records."
41 },
42 "createdAt": {
43 "type": "string",
44 "format": "datetime",
45 "description": "When this synthesis was created."
46 },
47 "updatedAt": {
48 "type": "string",
49 "format": "datetime",
50 "description": "When this synthesis was last updated."
51 }
52 }
53 }
54 },
55 "edge": {
56 "type": "object",
57 "description": "A connection edge within the island.",
58 "required": ["uri", "source", "target"],
59 "properties": {
60 "uri": {
61 "type": "string",
62 "format": "at-uri",
63 "description": "AT URI of the connection record"
64 },
65 "source": {
66 "type": "string",
67 "description": "Source vertex URI"
68 },
69 "target": {
70 "type": "string",
71 "description": "Target vertex URI"
72 },
73 "connectionType": {
74 "type": "string",
75 "description": "Type of connection (relates, supports, contradicts, etc.)"
76 },
77 "note": {
78 "type": "string",
79 "maxGraphemes": 500,
80 "description": "Optional note about the connection"
81 }
82 }
83 },
84 "sourceRef": {
85 "type": "object",
86 "description": "Reference to the source record that triggered the analysis.",
87 "required": ["uri"],
88 "properties": {
89 "uri": {
90 "type": "string",
91 "description": "URI of the source. For island-level analysis, this is the lexmin vertex (canonical component reference) — can be an HTTP URL or AT URI."
92 },
93 "cid": {
94 "type": "string",
95 "description": "CID of the source record at time of analysis."
96 },
97 "collection": {
98 "type": "string",
99 "description": "NSID of the source collection (e.g. network.cosmik.card)."
100 }
101 }
102 },
103 "structuredAnalysis": {
104 "type": "object",
105 "description": "The structured output of a Strata analysis run.",
106 "required": ["themes"],
107 "properties": {
108 "title": {
109 "type": "string",
110 "maxGraphemes": 300,
111 "description": "A concise sentence capturing the core argument or narrative arc of this analysis."
112 },
113 "themes": {
114 "type": "array",
115 "maxLength": 20,
116 "items": {
117 "type": "string",
118 "maxGraphemes": 100
119 },
120 "description": "Key themes identified in the source."
121 },
122 "highlights": {
123 "type": "array",
124 "maxLength": 20,
125 "items": {
126 "type": "string",
127 "format": "at-uri"
128 },
129 "description": "AT URIs of network.cosmik.connection records flagged as semantically significant by the analysis. Hot edges."
130 },
131 "tensions": {
132 "type": "array",
133 "maxLength": 10,
134 "items": {
135 "type": "string",
136 "maxGraphemes": 500
137 },
138 "description": "Tensions or contradictions with existing claims."
139 },
140 "openQuestions": {
141 "type": "array",
142 "maxLength": 10,
143 "items": {
144 "type": "string",
145 "maxGraphemes": 500
146 },
147 "description": "Questions raised by the analysis."
148 },
149 "synthesis": {
150 "type": "string",
151 "maxGraphemes": 2000,
152 "maxLength": 20000,
153 "description": "Prose synthesis connecting the source to existing knowledge."
154 }
155 }
156 },
157 "carryCrossRef": {
158 "type": "object",
159 "description": "Cross-reference to a carry entity, translated to AT Protocol addressable format.",
160 "required": ["entityType", "atUri"],
161 "properties": {
162 "entityType": {
163 "type": "string",
164 "knownValues": [
165 "org.latha.island.defs#claimRef",
166 "org.latha.island.defs#sourceRef"
167 ],
168 "description": "Type of carry entity."
169 },
170 "carryId": {
171 "type": "string",
172 "description": "Original carry entity ID for local correlation."
173 },
174 "atUri": {
175 "type": "string",
176 "format": "at-uri",
177 "description": "AT Protocol URI for this carry entity (if published as companion record)."
178 },
179 "summary": {
180 "type": "string",
181 "maxGraphemes": 500,
182 "description": "Summary of the carry entity."
183 }
184 }
185 }
186 }
187}