@otea/cli 0.0.1 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (243) hide show
  1. package/LICENSE +661 -0
  2. package/README.es.md +151 -0
  3. package/README.md +251 -3
  4. package/THIRD_PARTY_NOTICES.md +114 -0
  5. package/bin/otea.mjs +28 -0
  6. package/dist/app/agent-detail.js +26 -0
  7. package/dist/app/agent-draft.js +429 -0
  8. package/dist/app/agent-prompts.js +52 -0
  9. package/dist/app/agents.js +77 -0
  10. package/dist/app/asking.js +43 -0
  11. package/dist/app/board-archive.js +243 -0
  12. package/dist/app/board-migration.js +272 -0
  13. package/dist/app/boards.js +870 -0
  14. package/dist/app/branch-owner.js +48 -0
  15. package/dist/app/brief.js +53 -0
  16. package/dist/app/choices.js +61 -0
  17. package/dist/app/collections.js +101 -0
  18. package/dist/app/context.js +1 -0
  19. package/dist/app/crop.js +56 -0
  20. package/dist/app/devices.js +62 -0
  21. package/dist/app/draft-request.js +82 -0
  22. package/dist/app/events.js +12 -0
  23. package/dist/app/evidence.js +287 -0
  24. package/dist/app/gates.js +610 -0
  25. package/dist/app/guide.js +37 -0
  26. package/dist/app/home.js +145 -0
  27. package/dist/app/init-boards.js +36 -0
  28. package/dist/app/intake.js +25 -0
  29. package/dist/app/item-search.js +141 -0
  30. package/dist/app/items.js +318 -0
  31. package/dist/app/keep-waiting.js +44 -0
  32. package/dist/app/land-order.js +107 -0
  33. package/dist/app/language.js +52 -0
  34. package/dist/app/launcher.js +56 -0
  35. package/dist/app/lease-take.js +54 -0
  36. package/dist/app/leases.js +86 -0
  37. package/dist/app/machine.js +39 -0
  38. package/dist/app/merged.js +89 -0
  39. package/dist/app/migrate.js +171 -0
  40. package/dist/app/next.js +1637 -0
  41. package/dist/app/notes.js +319 -0
  42. package/dist/app/notify-targets.js +113 -0
  43. package/dist/app/opened.js +25 -0
  44. package/dist/app/owner-only.js +34 -0
  45. package/dist/app/performance.js +28 -0
  46. package/dist/app/phone.js +97 -0
  47. package/dist/app/presence.js +596 -0
  48. package/dist/app/preset-views.js +25 -0
  49. package/dist/app/presets.js +129 -0
  50. package/dist/app/priority.js +156 -0
  51. package/dist/app/profile.js +86 -0
  52. package/dist/app/project.js +247 -0
  53. package/dist/app/proofs.js +179 -0
  54. package/dist/app/questions.js +215 -0
  55. package/dist/app/reader-filter.js +58 -0
  56. package/dist/app/relations.js +164 -0
  57. package/dist/app/relay.js +98 -0
  58. package/dist/app/repos.js +176 -0
  59. package/dist/app/restart.js +92 -0
  60. package/dist/app/set-aside.js +64 -0
  61. package/dist/app/system-locale.js +6 -0
  62. package/dist/app/tailscale-cli.js +77 -0
  63. package/dist/app/tailscale-testing.js +41 -0
  64. package/dist/app/tailscale.js +177 -0
  65. package/dist/app/tips.js +30 -0
  66. package/dist/app/topics-everywhere.js +53 -0
  67. package/dist/app/topics.js +453 -0
  68. package/dist/app/undo.js +52 -0
  69. package/dist/app/validate.js +131 -0
  70. package/dist/app/watch.js +48 -0
  71. package/dist/cli/command.js +44 -0
  72. package/dist/cli/commands.js +3303 -0
  73. package/dist/cli/exit-codes.js +70 -0
  74. package/dist/cli/forge.js +176 -0
  75. package/dist/cli/format.js +340 -0
  76. package/dist/cli/gh.js +17 -0
  77. package/dist/cli/gitrepo.js +489 -0
  78. package/dist/cli/help.js +101 -0
  79. package/dist/cli/hooks.js +232 -0
  80. package/dist/cli/main.js +37 -0
  81. package/dist/cli/merged-outside.js +58 -0
  82. package/dist/cli/names.js +154 -0
  83. package/dist/cli/opener.js +21 -0
  84. package/dist/cli/owner.js +154 -0
  85. package/dist/cli/phone.js +221 -0
  86. package/dist/cli/ports.js +24 -0
  87. package/dist/cli/probe.js +18 -0
  88. package/dist/cli/run.js +246 -0
  89. package/dist/cli/serve-file.js +21 -0
  90. package/dist/cli/stats.js +55 -0
  91. package/dist/cli/version.js +3 -0
  92. package/dist/core/agent-guide.js +31 -0
  93. package/dist/core/agent-prompts.js +139 -0
  94. package/dist/core/authority.js +94 -0
  95. package/dist/core/board/analysis.js +86 -0
  96. package/dist/core/board/choices.js +100 -0
  97. package/dist/core/board/compile.js +362 -0
  98. package/dist/core/board/engine.js +523 -0
  99. package/dist/core/board/hints.js +46 -0
  100. package/dist/core/board/history.js +146 -0
  101. package/dist/core/board/ids.js +87 -0
  102. package/dist/core/board/joins.js +30 -0
  103. package/dist/core/board/mentions.js +68 -0
  104. package/dist/core/board/merged.js +18 -0
  105. package/dist/core/board/model.js +135 -0
  106. package/dist/core/board/next.js +1116 -0
  107. package/dist/core/board/notes.js +298 -0
  108. package/dist/core/board/performance.js +218 -0
  109. package/dist/core/board/plan.js +299 -0
  110. package/dist/core/board/problems.js +232 -0
  111. package/dist/core/board/proofs.js +84 -0
  112. package/dist/core/board/questions.js +114 -0
  113. package/dist/core/board/reading.js +220 -0
  114. package/dist/core/board/readings.js +534 -0
  115. package/dist/core/board/schema.js +335 -0
  116. package/dist/core/board/shape-words.js +179 -0
  117. package/dist/core/board/template-words.js +23 -0
  118. package/dist/core/board/templates-catalogue.js +965 -0
  119. package/dist/core/board/templates-coverage.js +261 -0
  120. package/dist/core/board/templates-flows.js +779 -0
  121. package/dist/core/board/templates.js +586 -0
  122. package/dist/core/brief.js +93 -0
  123. package/dist/core/diagram.js +80 -0
  124. package/dist/core/errors.js +12 -0
  125. package/dist/core/evidence.js +33 -0
  126. package/dist/core/fields.js +129 -0
  127. package/dist/core/hierarchy.js +30 -0
  128. package/dist/core/icons.js +181 -0
  129. package/dist/core/image-crop.js +166 -0
  130. package/dist/core/item.js +49 -0
  131. package/dist/core/lease.js +31 -0
  132. package/dist/core/modules.js +318 -0
  133. package/dist/core/notify/planner.js +117 -0
  134. package/dist/core/notify/signals.js +66 -0
  135. package/dist/core/notify/text.js +60 -0
  136. package/dist/core/path-key.js +22 -0
  137. package/dist/core/placement.js +161 -0
  138. package/dist/core/preset-labels.js +66 -0
  139. package/dist/core/preset-notes.js +109 -0
  140. package/dist/core/preset.js +541 -0
  141. package/dist/core/profile.js +55 -0
  142. package/dist/core/project-id.js +20 -0
  143. package/dist/core/refusal.js +1 -0
  144. package/dist/core/relations.js +208 -0
  145. package/dist/core/repo.js +54 -0
  146. package/dist/core/samples.js +161 -0
  147. package/dist/core/search-words.js +68 -0
  148. package/dist/core/test-report.js +120 -0
  149. package/dist/core/time.js +8 -0
  150. package/dist/core/validation.js +60 -0
  151. package/dist/core/views.js +171 -0
  152. package/dist/core/workflow.js +51 -0
  153. package/dist/mcp/commands.js +101 -0
  154. package/dist/mcp/server.js +239 -0
  155. package/dist/mcp/words.js +95 -0
  156. package/dist/server/boards.js +232 -0
  157. package/dist/server/changes.js +42 -0
  158. package/dist/server/diff-tip.js +83 -0
  159. package/dist/server/drift.js +87 -0
  160. package/dist/server/errors.js +87 -0
  161. package/dist/server/evidence.js +82 -0
  162. package/dist/server/hosts.js +6 -0
  163. package/dist/server/hub.js +98 -0
  164. package/dist/server/lan-access.js +62 -0
  165. package/dist/server/lan.js +164 -0
  166. package/dist/server/listen.js +70 -0
  167. package/dist/server/notifier.js +156 -0
  168. package/dist/server/notify-api.js +151 -0
  169. package/dist/server/pairing.js +124 -0
  170. package/dist/server/projects.js +191 -0
  171. package/dist/server/push.js +199 -0
  172. package/dist/server/server.js +960 -0
  173. package/dist/server/session.js +43 -0
  174. package/dist/server/stream.js +36 -0
  175. package/dist/server/test-push.js +38 -0
  176. package/dist/server/token.js +37 -0
  177. package/dist/server/transports.js +54 -0
  178. package/dist/server/ui.js +44 -0
  179. package/dist/server/writes.js +361 -0
  180. package/dist/server/wrong-address.js +36 -0
  181. package/dist/store/boards.js +111 -0
  182. package/dist/store/database.js +45 -0
  183. package/dist/store/machine.js +77 -0
  184. package/dist/store/migrations.js +493 -0
  185. package/dist/store/queries.js +585 -0
  186. package/dist/store/registry.js +72 -0
  187. package/package.json +72 -4
  188. package/presets/architecture/playbook.md +69 -0
  189. package/presets/architecture/preset.yaml +80 -0
  190. package/presets/architecture/samples.yaml +23 -0
  191. package/presets/bug-triage/playbook.md +129 -0
  192. package/presets/bug-triage/preset.yaml +127 -0
  193. package/presets/bug-triage/samples/wall-slide-after.png +0 -0
  194. package/presets/bug-triage/samples/wall-slide-before.png +0 -0
  195. package/presets/bug-triage/samples.yaml +72 -0
  196. package/presets/change/playbook.md +115 -0
  197. package/presets/change/preset.yaml +141 -0
  198. package/presets/change/samples.yaml +62 -0
  199. package/presets/review/playbook.md +51 -0
  200. package/presets/review/preset.yaml +62 -0
  201. package/presets/review/samples.yaml +27 -0
  202. package/presets/tasks/playbook.md +78 -0
  203. package/presets/tasks/preset.yaml +61 -0
  204. package/presets/tasks/samples.yaml +46 -0
  205. package/schemas/board.schema.json +764 -0
  206. package/ui/dist/THIRD_PARTY_NOTICES.md +114 -0
  207. package/ui/dist/assets/dm-mono-latin-400-normal--0xN8mdc.woff +0 -0
  208. package/ui/dist/assets/dm-mono-latin-400-normal-4GdczIuU.woff2 +0 -0
  209. package/ui/dist/assets/dm-mono-latin-500-normal-CN8Miw6E.woff +0 -0
  210. package/ui/dist/assets/dm-mono-latin-500-normal-DRMDZjhP.woff2 +0 -0
  211. package/ui/dist/assets/dm-mono-latin-ext-400-normal-1aZr6b2b.woff +0 -0
  212. package/ui/dist/assets/dm-mono-latin-ext-400-normal-C2zvOubV.woff2 +0 -0
  213. package/ui/dist/assets/dm-mono-latin-ext-500-normal-BtRyHRi6.woff2 +0 -0
  214. package/ui/dist/assets/dm-mono-latin-ext-500-normal-Dw3M13d8.woff +0 -0
  215. package/ui/dist/assets/index-C3OzJope.js +103 -0
  216. package/ui/dist/assets/index-COdEjckQ.css +1 -0
  217. package/ui/dist/assets/newsreader-latin-ext-opsz-italic-CSPGnFdO.woff2 +0 -0
  218. package/ui/dist/assets/newsreader-latin-ext-opsz-normal-BQn1nviT.woff2 +0 -0
  219. package/ui/dist/assets/newsreader-latin-opsz-italic-kJKFiXvB.woff2 +0 -0
  220. package/ui/dist/assets/newsreader-latin-opsz-normal-s-izfB6B.woff2 +0 -0
  221. package/ui/dist/assets/newsreader-vietnamese-opsz-italic-DTr-ymY4.woff2 +0 -0
  222. package/ui/dist/assets/newsreader-vietnamese-opsz-normal-BjhtXyW2.woff2 +0 -0
  223. package/ui/dist/assets/pdf-YwugTw7Y.js +54 -0
  224. package/ui/dist/assets/pdf-engine-CkBopwck.js +1 -0
  225. package/ui/dist/assets/pdf-rELvHkft.js +56 -0
  226. package/ui/dist/assets/pdf.worker.min-B5Yc7dP4.mjs +27 -0
  227. package/ui/dist/assets/pdf.worker.min-B7U8ptvh.js +1 -0
  228. package/ui/dist/assets/pdf.worker.min-CIqJB0yW.mjs +28 -0
  229. package/ui/dist/assets/pdf.worker.min-UqOn5EDC.js +1 -0
  230. package/ui/dist/assets/schibsted-grotesk-latin-ext-wght-normal-hsMS0n0O.woff2 +0 -0
  231. package/ui/dist/assets/schibsted-grotesk-latin-wght-normal-Bb8VGrTG.woff2 +0 -0
  232. package/ui/dist/icons/apple-touch-icon.png +0 -0
  233. package/ui/dist/icons/otea-192.png +0 -0
  234. package/ui/dist/icons/otea-512.png +0 -0
  235. package/ui/dist/icons/otea-badge.png +0 -0
  236. package/ui/dist/icons/otea-maskable-512.png +0 -0
  237. package/ui/dist/index.html +25 -0
  238. package/ui/dist/manifest.webmanifest +24 -0
  239. package/ui/dist/otea-idle.svg +5 -0
  240. package/ui/dist/otea-working.svg +5 -0
  241. package/ui/dist/otea-yours-working.svg +5 -0
  242. package/ui/dist/otea-yours.svg +5 -0
  243. package/ui/dist/sw.js +1 -0
@@ -0,0 +1,493 @@
1
+ import { transaction } from './database.js';
2
+ export const MIGRATIONS = [
3
+ `
4
+ CREATE TABLE collections (
5
+ name TEXT PRIMARY KEY,
6
+ prefix TEXT NOT NULL UNIQUE,
7
+ workflow TEXT NOT NULL,
8
+ next_seq INTEGER NOT NULL
9
+ );
10
+
11
+ CREATE TABLE items (
12
+ id TEXT PRIMARY KEY,
13
+ collection TEXT NOT NULL REFERENCES collections (name),
14
+ seq INTEGER NOT NULL,
15
+ title TEXT NOT NULL,
16
+ body TEXT NOT NULL,
17
+ state TEXT NOT NULL,
18
+ created_at TEXT NOT NULL,
19
+ updated_at TEXT NOT NULL,
20
+ created_by_kind TEXT NOT NULL,
21
+ created_by_name TEXT NOT NULL,
22
+ UNIQUE (collection, seq)
23
+ );
24
+
25
+ CREATE TABLE events (
26
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
27
+ item_id TEXT NOT NULL REFERENCES items (id),
28
+ type TEXT NOT NULL,
29
+ actor_kind TEXT NOT NULL,
30
+ actor_name TEXT NOT NULL,
31
+ at TEXT NOT NULL,
32
+ data TEXT NOT NULL
33
+ );
34
+
35
+ CREATE INDEX events_item_id ON events (item_id);
36
+
37
+ CREATE TRIGGER events_no_update BEFORE UPDATE ON events
38
+ BEGIN SELECT RAISE(ABORT, 'events are append-only'); END;
39
+
40
+ CREATE TRIGGER events_no_delete BEFORE DELETE ON events
41
+ BEGIN SELECT RAISE(ABORT, 'events are append-only'); END;
42
+ `,
43
+ `
44
+ ALTER TABLE collections ADD COLUMN preset TEXT NOT NULL DEFAULT 'tasks';
45
+ ALTER TABLE collections ADD COLUMN preset_version INTEGER NOT NULL DEFAULT 1;
46
+ ALTER TABLE collections DROP COLUMN workflow;
47
+
48
+ ALTER TABLE items ADD COLUMN fields TEXT NOT NULL DEFAULT '{}';
49
+ ALTER TABLE items ADD COLUMN preset_version INTEGER NOT NULL DEFAULT 1;
50
+ UPDATE items SET fields = json_object('description', body) WHERE body <> '';
51
+ ALTER TABLE items DROP COLUMN body;
52
+ `,
53
+ `
54
+ ALTER TABLE items ADD COLUMN lease_holder TEXT;
55
+ ALTER TABLE items ADD COLUMN lease_expires_at TEXT;
56
+ `,
57
+ `
58
+ CREATE TABLE evidence (
59
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
60
+ item_id TEXT NOT NULL REFERENCES items (id),
61
+ role TEXT NOT NULL,
62
+ kind TEXT NOT NULL,
63
+ filename TEXT NOT NULL,
64
+ content_type TEXT NOT NULL,
65
+ size INTEGER NOT NULL,
66
+ sha256 TEXT NOT NULL,
67
+ caption TEXT,
68
+ created_at TEXT NOT NULL,
69
+ actor_kind TEXT NOT NULL,
70
+ actor_name TEXT NOT NULL,
71
+ channel TEXT NOT NULL
72
+ );
73
+
74
+ CREATE INDEX evidence_item_id ON evidence (item_id);
75
+
76
+ CREATE TRIGGER evidence_no_update BEFORE UPDATE ON evidence
77
+ BEGIN SELECT RAISE(ABORT, 'evidence is append-only'); END;
78
+
79
+ CREATE TRIGGER evidence_no_delete BEFORE DELETE ON evidence
80
+ BEGIN SELECT RAISE(ABORT, 'evidence is append-only'); END;
81
+ `,
82
+ // 'item' is the type of every item of a preset that declares no types (DEFAULT_TYPE in core).
83
+ `
84
+ ALTER TABLE items ADD COLUMN type TEXT NOT NULL DEFAULT 'item';
85
+ `,
86
+ // The id of the layout module evidence was attached to; NULL for evidence attached before modules.
87
+ `
88
+ ALTER TABLE evidence ADD COLUMN module TEXT;
89
+ `,
90
+ // Typed links between items: the current ones, one per kind and pair (a symmetric kind stores its
91
+ // ids in order). Their history is the relation_added and relation_removed events.
92
+ `
93
+ CREATE TABLE relations (
94
+ kind TEXT NOT NULL,
95
+ from_id TEXT NOT NULL REFERENCES items (id),
96
+ to_id TEXT NOT NULL REFERENCES items (id),
97
+ created_at TEXT NOT NULL,
98
+ actor_kind TEXT NOT NULL,
99
+ actor_name TEXT NOT NULL,
100
+ channel TEXT NOT NULL,
101
+ PRIMARY KEY (kind, from_id, to_id)
102
+ );
103
+
104
+ CREATE INDEX relations_to_id ON relations (to_id);
105
+
106
+ CREATE UNIQUE INDEX relations_one_parent ON relations (from_id) WHERE kind = 'parent';
107
+ `,
108
+ // The project's own identity, one row, so a registry of projects can be rebuilt from their
109
+ // databases. The row is written when the project is opened (it needs a random id).
110
+ `
111
+ CREATE TABLE project (
112
+ id TEXT PRIMARY KEY,
113
+ name TEXT NOT NULL
114
+ );
115
+ `,
116
+ // The agents seen at work: the harness they last came through (an MCP client's clientInfo, or
117
+ // `cli`) and when. Agents that wrote before presence was kept start from their last event.
118
+ `
119
+ CREATE TABLE agents (
120
+ name TEXT PRIMARY KEY,
121
+ harness TEXT,
122
+ harness_version TEXT,
123
+ last_seen TEXT NOT NULL
124
+ );
125
+
126
+ INSERT INTO agents (name, last_seen)
127
+ SELECT actor_name, max(at) FROM events WHERE actor_kind = 'agent' GROUP BY actor_name;
128
+ `,
129
+ // The icons given to a collection (over its preset's) and to the project; NULL when none was.
130
+ `
131
+ ALTER TABLE collections ADD COLUMN icon TEXT;
132
+ ALTER TABLE project ADD COLUMN icon TEXT;
133
+ `,
134
+ // Devices paired over the LAN (otea serve --lan). Only the SHA-256 of each device token is kept,
135
+ // so the database never holds a token that opens the UI.
136
+ `
137
+ CREATE TABLE devices (
138
+ id TEXT PRIMARY KEY,
139
+ name TEXT NOT NULL,
140
+ token_hash TEXT NOT NULL UNIQUE,
141
+ paired_at TEXT NOT NULL,
142
+ last_seen_at TEXT
143
+ );
144
+ `,
145
+ // Boards with versions (Studio): a hidden id under each board, its published versions as whole
146
+ // JSON definitions (append-only), the live one and at most one draft. A board's items live in
147
+ // `collection` once it is first published; a rename renames the collection and cascades here.
148
+ `
149
+ CREATE TABLE boards (
150
+ id TEXT PRIMARY KEY,
151
+ collection TEXT UNIQUE REFERENCES collections (name) ON UPDATE CASCADE,
152
+ live_version INTEGER,
153
+ builtin INTEGER NOT NULL DEFAULT 0,
154
+ created_at TEXT NOT NULL,
155
+ -- Set when a board that is not live is discarded but keeps versions it cannot lose.
156
+ retired_at TEXT
157
+ );
158
+
159
+ CREATE TABLE board_versions (
160
+ board_id TEXT NOT NULL REFERENCES boards (id),
161
+ version INTEGER NOT NULL,
162
+ definition TEXT NOT NULL,
163
+ published_at TEXT NOT NULL,
164
+ published_by TEXT NOT NULL,
165
+ PRIMARY KEY (board_id, version)
166
+ );
167
+
168
+ CREATE TRIGGER board_versions_no_update BEFORE UPDATE ON board_versions
169
+ BEGIN SELECT RAISE(ABORT, 'board versions are append-only'); END;
170
+
171
+ CREATE TRIGGER board_versions_no_delete BEFORE DELETE ON board_versions
172
+ BEGIN SELECT RAISE(ABORT, 'board versions are append-only'); END;
173
+
174
+ CREATE TABLE board_drafts (
175
+ board_id TEXT PRIMARY KEY REFERENCES boards (id) ON DELETE CASCADE,
176
+ definition TEXT NOT NULL,
177
+ base_version INTEGER,
178
+ updated_at TEXT NOT NULL,
179
+ request_item TEXT REFERENCES items (id),
180
+ agent_note TEXT
181
+ );
182
+ `,
183
+ // The project's repos: the name its items give each one (a repo task's `repo` field) and what
184
+ // identifies it wherever it is cloned (its origin URL, or its root commit; core/repo.ts). The
185
+ // repos already at a project's folders are read in once, the first time they are needed, since
186
+ // that takes git (`repos_read`).
187
+ `
188
+ CREATE TABLE repos (
189
+ name TEXT PRIMARY KEY,
190
+ identity TEXT NOT NULL UNIQUE
191
+ );
192
+
193
+ ALTER TABLE project ADD COLUMN repos_read INTEGER NOT NULL DEFAULT 0;
194
+ `,
195
+ // The item `otea next` last offered each agent, in the state it was offered in and when: for a
196
+ // while no other agent is offered it, so two agents asking at once never get the same item.
197
+ `
198
+ CREATE TABLE offers (
199
+ agent TEXT PRIMARY KEY,
200
+ item TEXT NOT NULL REFERENCES items (id) ON DELETE CASCADE,
201
+ state TEXT NOT NULL,
202
+ at TEXT NOT NULL
203
+ );
204
+ `,
205
+ // The profile each agent declares (otea profile): its harness, model and effort as JSON, and
206
+ // whether it was declared in the agent's current session. Every event an agent writes keeps the
207
+ // profile it had then; every change is kept in agent_profiles, append-only.
208
+ `
209
+ ALTER TABLE agents ADD COLUMN profile TEXT;
210
+ ALTER TABLE agents ADD COLUMN profile_confirmed INTEGER NOT NULL DEFAULT 0;
211
+ ALTER TABLE events ADD COLUMN profile TEXT;
212
+
213
+ CREATE TABLE agent_profiles (
214
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
215
+ agent TEXT NOT NULL,
216
+ profile TEXT NOT NULL,
217
+ at TEXT NOT NULL,
218
+ channel TEXT NOT NULL
219
+ );
220
+
221
+ CREATE INDEX agent_profiles_agent ON agent_profiles (agent);
222
+
223
+ CREATE TRIGGER agent_profiles_no_update BEFORE UPDATE ON agent_profiles
224
+ BEGIN SELECT RAISE(ABORT, 'profile changes are append-only'); END;
225
+
226
+ CREATE TRIGGER agent_profiles_no_delete BEFORE DELETE ON agent_profiles
227
+ BEGIN SELECT RAISE(ABORT, 'profile changes are append-only'); END;
228
+ `,
229
+ // A step names no agent any more: any agent does it, and any agent but the one that did it
230
+ // reviews it. The person's review a board kept apart when its named reviewer had done the work
231
+ // itself (`<step>__yours`) is the step's review now (`<step>__review`).
232
+ `
233
+ UPDATE items SET state = substr(state, 1, length(state) - length('__yours')) || '__review'
234
+ WHERE substr(state, -length('__yours')) = '__yours';
235
+ `,
236
+ // How a phone reaches the desk (see app/phone.ts): one row once a transport is chosen; none means
237
+ // the local network. Tailscale keeps the name a phone opens, `<machine>.<tailnet>.ts.net`.
238
+ `
239
+ CREATE TABLE phone (
240
+ id INTEGER PRIMARY KEY CHECK (id = 1),
241
+ transport TEXT NOT NULL,
242
+ tailscale_host TEXT
243
+ );
244
+ `,
245
+ // When an agent connected: its first sighting, a new session, or a sighting after it was away.
246
+ `
247
+ ALTER TABLE agents ADD COLUMN connected_at TEXT;
248
+ `,
249
+ // The key a client sends with a create (Idempotency-Key): a phone that captured offline sends it
250
+ // again until it hears back, and the same key answers with the item it made instead of a second.
251
+ `
252
+ CREATE TABLE client_keys (
253
+ key TEXT PRIMARY KEY,
254
+ item TEXT NOT NULL REFERENCES items (id) ON DELETE CASCADE,
255
+ at TEXT NOT NULL
256
+ );
257
+ `,
258
+ // Who is told when something becomes yours (app/notify-targets.ts): a paired device's Web Push
259
+ // subscription, dropped with the device, or the desktop app (id 'desktop', no subscription). Each
260
+ // keeps the kinds it wants, its quiet hours and the language its notices are written in.
261
+ `
262
+ CREATE TABLE notify_targets (
263
+ id TEXT PRIMARY KEY,
264
+ device TEXT UNIQUE REFERENCES devices (id) ON DELETE CASCADE,
265
+ endpoint TEXT UNIQUE,
266
+ p256dh TEXT,
267
+ auth TEXT,
268
+ lang TEXT NOT NULL,
269
+ prefs TEXT NOT NULL,
270
+ created_at TEXT NOT NULL
271
+ );
272
+ `,
273
+ // Whether the local network is open to phones (Settings › Phone, otea phone lan --open): every
274
+ // otea serve starts with it open until it is closed again.
275
+ `
276
+ ALTER TABLE phone ADD COLUMN lan_open INTEGER NOT NULL DEFAULT 0;
277
+ `,
278
+ // A board the person archived (app/board-archive.ts): gone from every list, its items kept to
279
+ // read. Its rows stay append-only while it stands; once archived, deleting the board may take its
280
+ // items' events and evidence and its versions with it, and nothing else may delete them.
281
+ `
282
+ ALTER TABLE boards ADD COLUMN archived_at TEXT;
283
+
284
+ DROP TRIGGER events_no_delete;
285
+ CREATE TRIGGER events_no_delete BEFORE DELETE ON events
286
+ WHEN NOT EXISTS (
287
+ SELECT 1 FROM items i JOIN boards b ON b.collection = i.collection
288
+ WHERE i.id = OLD.item_id AND b.archived_at IS NOT NULL
289
+ )
290
+ BEGIN SELECT RAISE(ABORT, 'events are append-only'); END;
291
+
292
+ DROP TRIGGER evidence_no_delete;
293
+ CREATE TRIGGER evidence_no_delete BEFORE DELETE ON evidence
294
+ WHEN NOT EXISTS (
295
+ SELECT 1 FROM items i JOIN boards b ON b.collection = i.collection
296
+ WHERE i.id = OLD.item_id AND b.archived_at IS NOT NULL
297
+ )
298
+ BEGIN SELECT RAISE(ABORT, 'evidence is append-only'); END;
299
+
300
+ DROP TRIGGER board_versions_no_delete;
301
+ CREATE TRIGGER board_versions_no_delete BEFORE DELETE ON board_versions
302
+ WHEN NOT EXISTS (SELECT 1 FROM boards WHERE id = OLD.board_id AND archived_at IS NOT NULL)
303
+ BEGIN SELECT RAISE(ABORT, 'board versions are append-only'); END;
304
+ `,
305
+ // When an agent was last heard listening (app/presence.ts): an open MCP server or a running
306
+ // otea wait beats it. Only a listening agent, or one holding a lease, counts as connected.
307
+ `
308
+ ALTER TABLE agents ADD COLUMN listening_at TEXT;
309
+ `,
310
+ // The MCP server (its process id) an agent's name was last heard listening from: a second open
311
+ // session may not work under the same name (app/presence.ts claimName).
312
+ `
313
+ ALTER TABLE agents ADD COLUMN listening_session INTEGER;
314
+ `,
315
+ // Side topics (app/topics.ts): questions the person asked an agent off the work, kept as a short
316
+ // conversation each, so none is left hanging. Off until the person turns them on for the project.
317
+ // A topic's turns are the person's question and notes and the agent's answers, a summary with the
318
+ // full answer; topic_links ties a topic to the items it led to or that a person confirmed.
319
+ `
320
+ CREATE TABLE topics_switch (
321
+ id INTEGER PRIMARY KEY CHECK (id = 1),
322
+ enabled INTEGER NOT NULL
323
+ );
324
+
325
+ CREATE TABLE topics (
326
+ id TEXT PRIMARY KEY,
327
+ seq INTEGER NOT NULL UNIQUE,
328
+ title TEXT NOT NULL,
329
+ state TEXT NOT NULL,
330
+ agent TEXT,
331
+ session TEXT,
332
+ resume TEXT,
333
+ task TEXT REFERENCES items (id),
334
+ created_at TEXT NOT NULL,
335
+ updated_at TEXT NOT NULL,
336
+ created_by_kind TEXT NOT NULL,
337
+ created_by_name TEXT NOT NULL
338
+ );
339
+
340
+ CREATE TABLE topic_turns (
341
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
342
+ topic_id TEXT NOT NULL REFERENCES topics (id),
343
+ kind TEXT NOT NULL,
344
+ text TEXT NOT NULL,
345
+ full TEXT,
346
+ source TEXT,
347
+ actor_kind TEXT NOT NULL,
348
+ actor_name TEXT NOT NULL,
349
+ at TEXT NOT NULL,
350
+ seen_at TEXT
351
+ );
352
+
353
+ CREATE INDEX topic_turns_topic ON topic_turns (topic_id);
354
+
355
+ CREATE TABLE topic_links (
356
+ topic_id TEXT NOT NULL REFERENCES topics (id),
357
+ item_id TEXT NOT NULL REFERENCES items (id),
358
+ via TEXT NOT NULL,
359
+ at TEXT NOT NULL,
360
+ PRIMARY KEY (topic_id, item_id)
361
+ );
362
+
363
+ CREATE INDEX topic_links_item ON topic_links (item_id);
364
+ `,
365
+ // The person's priority on a board's items (app/priority.ts): `pin` puts an item on top (pins in
366
+ // the order they were set), `rank` is the order the person fixed from the matrix. otea next
367
+ // reads them after what the agent holds and what was sent back to it.
368
+ `
369
+ CREATE TABLE item_priority (
370
+ item_id TEXT PRIMARY KEY REFERENCES items (id) ON DELETE CASCADE,
371
+ pin INTEGER,
372
+ rank INTEGER,
373
+ set_at TEXT NOT NULL
374
+ );
375
+ `,
376
+ // The harness process that started the MCP server an agent was last heard from: a new server the
377
+ // same harness started (it restarted its server) takes the agent's name back (claimName).
378
+ `
379
+ ALTER TABLE agents ADD COLUMN listening_harness INTEGER;
380
+ `,
381
+ // The files the person opened in the reader (app/opened.ts), on the desk or the phone: what
382
+ // Aprobar counts as left unopened, the same on every device and after a reload.
383
+ `
384
+ CREATE TABLE evidence_opened (
385
+ evidence_id INTEGER PRIMARY KEY REFERENCES evidence (id) ON DELETE CASCADE,
386
+ item_id TEXT NOT NULL REFERENCES items (id) ON DELETE CASCADE,
387
+ opened_at TEXT NOT NULL
388
+ );
389
+
390
+ CREATE INDEX evidence_opened_item ON evidence_opened (item_id);
391
+ `,
392
+ // When an agent was last heard waiting in otea wait (app/presence.ts): only a waiting agent hears
393
+ // the desk. An open MCP server listens, but its agent idle in its chat does not wake for a move.
394
+ `
395
+ ALTER TABLE agents ADD COLUMN waiting_at TEXT;
396
+ `,
397
+ // When an agent was last heard through Otea's MCP server, and when it asked for that connection
398
+ // (otea connect): asked and never heard, its harness never loaded the server (declined, or never
399
+ // added), and the desk says so.
400
+ `
401
+ ALTER TABLE agents ADD COLUMN mcp_at TEXT;
402
+ ALTER TABLE agents ADD COLUMN mcp_asked_at TEXT;
403
+ `,
404
+ // The folder an agent was last seen working from: a new session there, of the same harness, is
405
+ // told the name it worked under (otea whoami), so it keeps one name across sessions.
406
+ `
407
+ ALTER TABLE agents ADD COLUMN folder TEXT;
408
+ `,
409
+ // The names otea whoami (and a refused MCP session) handed out lately, and to which MCP server if
410
+ // one asked: a name handed to one session is not handed to another one asking at the same time,
411
+ // so two sessions started together never work under one name.
412
+ `
413
+ CREATE TABLE name_offers (
414
+ name TEXT PRIMARY KEY,
415
+ offered_at TEXT NOT NULL,
416
+ session INTEGER
417
+ );
418
+ `,
419
+ // The process of the command-line wait an agent was last heard through, while it runs: a wait
420
+ // killed with its session (no cleanup ran) leaves it, and its agent counts as gone at once.
421
+ `
422
+ ALTER TABLE agents ADD COLUMN listening_waiter INTEGER;
423
+ `,
424
+ // When each harness last loaded Otea's MCP server (its client's initialize), keyed by the
425
+ // harness: the desk says MCP is missing or unused for every agent of that harness, whatever name
426
+ // it took, and otea connect --check goes green on the load alone.
427
+ `
428
+ CREATE TABLE mcp_loads (
429
+ harness TEXT PRIMARY KEY,
430
+ name TEXT NOT NULL,
431
+ at TEXT NOT NULL
432
+ );
433
+ `,
434
+ // The process of the MCP server that loaded last for each harness: MCP is at hand (the desk says
435
+ // «MCP sin usar», not «sin conectar») only while it runs, never on a load an ended session left.
436
+ `
437
+ ALTER TABLE mcp_loads ADD COLUMN session INTEGER;
438
+ `,
439
+ // When each Otea process of this computer that others watch (an MCP server, a command-line wait)
440
+ // last said it still runs, by its process id: an id alone is no proof, since the system gives an
441
+ // ended process's id to another one (P3C-R3-12). A process that ends on its own leaves no row.
442
+ `
443
+ CREATE TABLE process_beats (
444
+ pid INTEGER PRIMARY KEY,
445
+ at TEXT NOT NULL
446
+ );
447
+ `,
448
+ // When each agent last ran a command, apart from the beats of its listeners (a wait it left
449
+ // running beats on): a subagent that released what it held and ran nothing since has finished
450
+ // (P1-R3-8).
451
+ `
452
+ ALTER TABLE agents ADD COLUMN acted_at TEXT;
453
+ `,
454
+ // When each MCP server started, when it last served a tool call, and how many long calls (a
455
+ // wait) it holds open: a newer server of the same harness takes an agent's name from an older
456
+ // one that has been quiet since the newer one started (P8-R3-1, app/presence.ts claimName).
457
+ `
458
+ ALTER TABLE process_beats ADD COLUMN started_at TEXT;
459
+ ALTER TABLE process_beats ADD COLUMN called_at TEXT;
460
+ ALTER TABLE process_beats ADD COLUMN calling INTEGER NOT NULL DEFAULT 0;
461
+ `,
462
+ // How a paired device last reached Otea (tailscale over HTTPS, or lan), as on the machine's
463
+ // devices table (store/machine.ts): the devices' use cases read both the same way.
464
+ `
465
+ ALTER TABLE devices ADD COLUMN via TEXT;
466
+ `,
467
+ // The language the project's own words are made in (its template boards, its Pedidos board, the
468
+ // boards agents draft for it), per project; dropped by the migration after it.
469
+ `
470
+ ALTER TABLE project ADD COLUMN lang TEXT NOT NULL DEFAULT 'es';
471
+ `,
472
+ // That language is not the project's: what Otea makes with no desk to ask takes the language the
473
+ // person uses (app/language.ts, kept in the machine store), so the column goes.
474
+ `
475
+ ALTER TABLE project DROP COLUMN lang;
476
+ `,
477
+ ];
478
+ function userVersion(db) {
479
+ return Number(db.prepare('PRAGMA user_version').get()?.user_version ?? 0);
480
+ }
481
+ // Runs the migrations a database has not run yet, up to `target`; user_version counts the ones done.
482
+ export function applyMigrations(db, migrations, target = migrations.length) {
483
+ const current = userVersion(db);
484
+ for (const [offset, sql] of migrations.slice(current, target).entries()) {
485
+ transaction(db, () => {
486
+ db.exec(sql);
487
+ db.exec(`PRAGMA user_version = ${current + offset + 1}`);
488
+ });
489
+ }
490
+ }
491
+ export function migrate(db, target = MIGRATIONS.length) {
492
+ applyMigrations(db, MIGRATIONS, target);
493
+ }