nandi.uk
This repository has no description
5.9 kB
170 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 reference to a connection record within the island. The AT URI is the source of truth — all edge data lives in the network.cosmik.connection record.",
58 "required": ["uri"],
59 "properties": {
60 "uri": {
61 "type": "string",
62 "format": "at-uri",
63 "description": "AT URI of the network.cosmik.connection record"
64 }
65 }
66 },
67 "sourceRef": {
68 "type": "object",
69 "description": "Reference to the source record that triggered the analysis.",
70 "required": ["uri"],
71 "properties": {
72 "uri": {
73 "type": "string",
74 "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."
75 },
76 "cid": {
77 "type": "string",
78 "description": "CID of the source record at time of analysis."
79 },
80 "collection": {
81 "type": "string",
82 "description": "NSID of the source collection (e.g. network.cosmik.card)."
83 }
84 }
85 },
86 "structuredAnalysis": {
87 "type": "object",
88 "description": "The structured output of a Strata analysis run.",
89 "required": ["themes"],
90 "properties": {
91 "title": {
92 "type": "string",
93 "maxGraphemes": 300,
94 "description": "A concise sentence capturing the core argument or narrative arc of this analysis."
95 },
96 "themes": {
97 "type": "array",
98 "maxLength": 20,
99 "items": {
100 "type": "string",
101 "maxGraphemes": 100
102 },
103 "description": "Key themes identified in the source."
104 },
105 "highlights": {
106 "type": "array",
107 "maxLength": 20,
108 "items": {
109 "type": "string",
110 "format": "at-uri"
111 },
112 "description": "AT URIs of network.cosmik.connection records flagged as semantically significant by the analysis. Hot edges."
113 },
114 "tensions": {
115 "type": "array",
116 "maxLength": 10,
117 "items": {
118 "type": "string",
119 "maxGraphemes": 500
120 },
121 "description": "Tensions or contradictions with existing claims."
122 },
123 "openQuestions": {
124 "type": "array",
125 "maxLength": 10,
126 "items": {
127 "type": "string",
128 "maxGraphemes": 500
129 },
130 "description": "Questions raised by the analysis."
131 },
132 "synthesis": {
133 "type": "string",
134 "maxGraphemes": 2000,
135 "maxLength": 20000,
136 "description": "Prose synthesis connecting the source to existing knowledge."
137 }
138 }
139 },
140 "carryCrossRef": {
141 "type": "object",
142 "description": "Cross-reference to a carry entity, translated to AT Protocol addressable format.",
143 "required": ["entityType", "atUri"],
144 "properties": {
145 "entityType": {
146 "type": "string",
147 "knownValues": [
148 "org.latha.island.defs#claimRef",
149 "org.latha.island.defs#sourceRef"
150 ],
151 "description": "Type of carry entity."
152 },
153 "carryId": {
154 "type": "string",
155 "description": "Original carry entity ID for local correlation."
156 },
157 "atUri": {
158 "type": "string",
159 "format": "at-uri",
160 "description": "AT Protocol URI for this carry entity (if published as companion record)."
161 },
162 "summary": {
163 "type": "string",
164 "maxGraphemes": 500,
165 "description": "Summary of the carry entity."
166 }
167 }
168 }
169 }
170}