@joe-broadhead/opencode-mem 0.9.5 → 0.9.14

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 (63) hide show
  1. package/CHANGELOG.md +1408 -0
  2. package/README.md +120 -41
  3. package/docs/agent-instructions.md +17 -0
  4. package/docs/agent-protocol.md +28 -27
  5. package/docs/permissions.md +150 -0
  6. package/package.json +386 -17
  7. package/skills/mem.pages/SKILL.md +40 -16
  8. package/skills/mem.sharing/SKILL.md +39 -6
  9. package/skills/mem.sources/SKILL.md +41 -10
  10. package/skills/mem.usage/SKILL.md +37 -16
  11. package/src/backend/records.js +8 -0
  12. package/src/backend/v3.js +15 -10
  13. package/src/call-shapes.js +18 -25
  14. package/src/capture-pause.js +136 -0
  15. package/src/capture.js +7 -5
  16. package/src/collector-service.js +212 -35
  17. package/src/collector.js +187 -47
  18. package/src/commands.js +37 -0
  19. package/src/compaction.js +4 -2
  20. package/src/config.js +151 -1
  21. package/src/curation.js +6 -10
  22. package/src/events.js +144 -36
  23. package/src/forget-purge.js +377 -0
  24. package/src/forgotten.js +152 -0
  25. package/src/hooks.js +9 -4
  26. package/src/index.js +5 -3
  27. package/src/permissions.js +116 -38
  28. package/src/protocol.js +32 -11
  29. package/src/recall.js +13 -1
  30. package/src/records.js +4 -1
  31. package/src/runtime.js +202 -15
  32. package/src/shapes.js +63 -0
  33. package/src/sources.js +205 -12
  34. package/src/spaces.js +58 -1
  35. package/src/spool.js +442 -64
  36. package/src/stated.js +334 -0
  37. package/src/storable.js +477 -0
  38. package/src/tools/aliases.js +36 -147
  39. package/src/tools/commitments.js +79 -13
  40. package/src/tools/held-write.js +5 -1
  41. package/src/tools/index.js +25 -43
  42. package/src/tools/ingest.js +33 -128
  43. package/src/tools/memory.js +525 -911
  44. package/src/tools/page-sections.js +147 -0
  45. package/src/tools/page.js +314 -82
  46. package/src/tools/recall-browse.js +173 -0
  47. package/src/tools/recall.js +36 -8
  48. package/src/tools/records-kit.js +2 -1
  49. package/src/tools/share.js +494 -131
  50. package/src/tools/shared.js +97 -19
  51. package/src/tools/spaces.js +194 -101
  52. package/src/tools/status.js +31 -3
  53. package/src/tools/wiki.js +5 -13
  54. package/src/util.js +10 -59
  55. package/src/views/contracts.js +258 -20
  56. package/src/views/overdue.js +1 -1
  57. package/src/views/profile.js +2 -3
  58. package/src/views/receipt.js +81 -0
  59. package/src/views/records-reads.js +545 -25
  60. package/src/views/rpc.js +41 -3
  61. package/views/memory.html +16 -3
  62. package/views/remembered.html +130 -0
  63. package/src/erase.js +0 -36
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@joe-broadhead/opencode-mem",
3
- "version": "0.9.5",
3
+ "version": "0.9.14",
4
4
  "type": "module",
5
5
  "description": "Durable private and shared-space memory for OpenCode agents",
6
6
  "license": "MIT",
@@ -15,6 +15,7 @@
15
15
  "title": "Memory",
16
16
  "summary": "Your decisions, preferences and notes, across conversations and agents.",
17
17
  "icon": "assets/icon.svg",
18
+ "instructions": "docs/agent-instructions.md",
18
19
  "tools": [
19
20
  {
20
21
  "name": "mem.recall",
@@ -85,14 +86,14 @@
85
86
  {
86
87
  "name": "mem.forget",
87
88
  "permission": "mem_forget",
88
- "effect": "ask",
89
- "readOnly": false
89
+ "effect": "allow",
90
+ "readOnly": true
90
91
  },
91
92
  {
92
93
  "name": "mem.promote",
93
94
  "permission": "mem_promote",
94
95
  "effect": "allow",
95
- "readOnly": false
96
+ "readOnly": true
96
97
  },
97
98
  {
98
99
  "name": "mem.status",
@@ -207,6 +208,23 @@
207
208
  "unavailable"
208
209
  ]
209
210
  },
211
+ "spool": {
212
+ "type": "object",
213
+ "additionalProperties": false,
214
+ "required": [
215
+ "depth"
216
+ ],
217
+ "properties": {
218
+ "depth": {
219
+ "type": "integer",
220
+ "minimum": 0
221
+ },
222
+ "oldest": {
223
+ "type": "string",
224
+ "maxLength": 40
225
+ }
226
+ }
227
+ },
210
228
  "space": {
211
229
  "type": "object",
212
230
  "additionalProperties": false,
@@ -343,6 +361,14 @@
343
361
  "type": "string",
344
362
  "maxLength": 200
345
363
  },
364
+ "agent": {
365
+ "type": "string",
366
+ "maxLength": 200
367
+ },
368
+ "task": {
369
+ "type": "string",
370
+ "maxLength": 200
371
+ },
346
372
  "jellySpeaker": {
347
373
  "type": "string"
348
374
  }
@@ -456,7 +482,9 @@
456
482
  "type",
457
483
  "at",
458
484
  "space",
459
- "status"
485
+ "status",
486
+ "version",
487
+ "copies"
460
488
  ],
461
489
  "properties": {
462
490
  "id": {
@@ -509,6 +537,36 @@
509
537
  "source": {
510
538
  "type": "string",
511
539
  "maxLength": 200
540
+ },
541
+ "agent": {
542
+ "type": "string",
543
+ "maxLength": 80
544
+ },
545
+ "task": {
546
+ "type": "string",
547
+ "maxLength": 200
548
+ },
549
+ "version": {
550
+ "type": "integer",
551
+ "minimum": 0
552
+ },
553
+ "copies": {
554
+ "type": "object",
555
+ "additionalProperties": false,
556
+ "properties": {
557
+ "supersedes": {
558
+ "type": "array",
559
+ "maxItems": 20,
560
+ "items": {
561
+ "type": "string",
562
+ "maxLength": 200
563
+ }
564
+ },
565
+ "supersededBy": {
566
+ "type": "string",
567
+ "maxLength": 200
568
+ }
569
+ }
512
570
  }
513
571
  }
514
572
  }
@@ -1158,7 +1216,8 @@
1158
1216
  "evidence",
1159
1217
  "proposed",
1160
1218
  "expires",
1161
- "created"
1219
+ "created",
1220
+ "held"
1162
1221
  ],
1163
1222
  "properties": {
1164
1223
  "id": {
@@ -1199,6 +1258,35 @@
1199
1258
  "type": "string",
1200
1259
  "maxLength": 200
1201
1260
  },
1261
+ "session": {
1262
+ "type": "string",
1263
+ "maxLength": 200
1264
+ },
1265
+ "turn": {
1266
+ "type": "string",
1267
+ "maxLength": 200
1268
+ },
1269
+ "held": {
1270
+ "type": "boolean"
1271
+ },
1272
+ "space": {
1273
+ "type": "object",
1274
+ "additionalProperties": false,
1275
+ "required": [
1276
+ "id",
1277
+ "name"
1278
+ ],
1279
+ "properties": {
1280
+ "id": {
1281
+ "type": "string",
1282
+ "maxLength": 200
1283
+ },
1284
+ "name": {
1285
+ "type": "string",
1286
+ "maxLength": 200
1287
+ }
1288
+ }
1289
+ },
1202
1290
  "external": {
1203
1291
  "type": "boolean"
1204
1292
  },
@@ -1244,6 +1332,27 @@
1244
1332
  "created": {
1245
1333
  "type": "string",
1246
1334
  "maxLength": 40
1335
+ },
1336
+ "payload": {
1337
+ "type": "object",
1338
+ "additionalProperties": false,
1339
+ "required": [
1340
+ "kind"
1341
+ ],
1342
+ "properties": {
1343
+ "kind": {
1344
+ "type": "string",
1345
+ "enum": [
1346
+ "memory",
1347
+ "page",
1348
+ "commitment"
1349
+ ]
1350
+ },
1351
+ "type": {
1352
+ "type": "string",
1353
+ "maxLength": 40
1354
+ }
1355
+ }
1247
1356
  }
1248
1357
  }
1249
1358
  }
@@ -1316,6 +1425,10 @@
1316
1425
  "at": {
1317
1426
  "type": "string",
1318
1427
  "maxLength": 40
1428
+ },
1429
+ "kind": {
1430
+ "type": "string",
1431
+ "maxLength": 40
1319
1432
  }
1320
1433
  }
1321
1434
  }
@@ -1340,6 +1453,10 @@
1340
1453
  "type": "string",
1341
1454
  "maxLength": 64
1342
1455
  },
1456
+ "cursor": {
1457
+ "type": "string",
1458
+ "maxLength": 600
1459
+ },
1343
1460
  "jellySpeaker": {
1344
1461
  "type": "string"
1345
1462
  }
@@ -1437,12 +1554,41 @@
1437
1554
  "updated": {
1438
1555
  "type": "string",
1439
1556
  "maxLength": 40
1557
+ },
1558
+ "owner": {
1559
+ "type": "object",
1560
+ "additionalProperties": false,
1561
+ "required": [
1562
+ "id",
1563
+ "name"
1564
+ ],
1565
+ "properties": {
1566
+ "id": {
1567
+ "type": "string",
1568
+ "maxLength": 200
1569
+ },
1570
+ "name": {
1571
+ "type": "string",
1572
+ "maxLength": 120
1573
+ }
1574
+ }
1575
+ },
1576
+ "backlinks": {
1577
+ "type": "integer",
1578
+ "minimum": 0
1579
+ },
1580
+ "backlinksMore": {
1581
+ "type": "boolean"
1440
1582
  }
1441
1583
  }
1442
1584
  }
1443
1585
  },
1444
1586
  "more": {
1445
1587
  "type": "boolean"
1588
+ },
1589
+ "cursor": {
1590
+ "type": "string",
1591
+ "maxLength": 600
1446
1592
  }
1447
1593
  }
1448
1594
  }
@@ -1558,6 +1704,31 @@
1558
1704
  "type": "integer",
1559
1705
  "minimum": 0
1560
1706
  },
1707
+ "owner": {
1708
+ "type": "object",
1709
+ "additionalProperties": false,
1710
+ "required": [
1711
+ "id",
1712
+ "name"
1713
+ ],
1714
+ "properties": {
1715
+ "id": {
1716
+ "type": "string",
1717
+ "maxLength": 200
1718
+ },
1719
+ "name": {
1720
+ "type": "string",
1721
+ "maxLength": 120
1722
+ }
1723
+ }
1724
+ },
1725
+ "reviewed": {
1726
+ "type": "string",
1727
+ "maxLength": 40
1728
+ },
1729
+ "reviewDue": {
1730
+ "type": "boolean"
1731
+ },
1561
1732
  "fields": {
1562
1733
  "type": "array",
1563
1734
  "maxItems": 24,
@@ -1805,6 +1976,10 @@
1805
1976
  "type": "string",
1806
1977
  "maxLength": 200
1807
1978
  },
1979
+ "folder": {
1980
+ "type": "string",
1981
+ "maxLength": 64
1982
+ },
1808
1983
  "depth": {
1809
1984
  "type": "integer",
1810
1985
  "minimum": 1,
@@ -2075,6 +2250,129 @@
2075
2250
  }
2076
2251
  }
2077
2252
  }
2253
+ },
2254
+ {
2255
+ "name": "terms.list",
2256
+ "label": "list the people and names Memory knows",
2257
+ "permission": "mem_page",
2258
+ "readOnly": true,
2259
+ "input": {
2260
+ "type": "object",
2261
+ "additionalProperties": false,
2262
+ "properties": {
2263
+ "space": {
2264
+ "type": "string",
2265
+ "maxLength": 200
2266
+ },
2267
+ "types": {
2268
+ "type": "array",
2269
+ "maxItems": 4,
2270
+ "items": {
2271
+ "type": "string",
2272
+ "enum": [
2273
+ "person",
2274
+ "project",
2275
+ "team",
2276
+ "glossary"
2277
+ ]
2278
+ }
2279
+ },
2280
+ "max": {
2281
+ "type": "integer",
2282
+ "minimum": 10,
2283
+ "maximum": 500
2284
+ },
2285
+ "jellySpeaker": {
2286
+ "type": "string"
2287
+ }
2288
+ }
2289
+ },
2290
+ "output": {
2291
+ "type": "object",
2292
+ "additionalProperties": false,
2293
+ "required": [
2294
+ "terms",
2295
+ "more",
2296
+ "incomplete"
2297
+ ],
2298
+ "properties": {
2299
+ "terms": {
2300
+ "type": "array",
2301
+ "maxItems": 500,
2302
+ "items": {
2303
+ "type": "object",
2304
+ "additionalProperties": false,
2305
+ "required": [
2306
+ "text",
2307
+ "kind",
2308
+ "space"
2309
+ ],
2310
+ "properties": {
2311
+ "text": {
2312
+ "type": "string",
2313
+ "maxLength": 80
2314
+ },
2315
+ "kind": {
2316
+ "type": "string",
2317
+ "maxLength": 40
2318
+ },
2319
+ "space": {
2320
+ "type": "object",
2321
+ "additionalProperties": false,
2322
+ "required": [
2323
+ "id",
2324
+ "name"
2325
+ ],
2326
+ "properties": {
2327
+ "id": {
2328
+ "type": "string",
2329
+ "maxLength": 200
2330
+ },
2331
+ "name": {
2332
+ "type": "string",
2333
+ "maxLength": 200
2334
+ }
2335
+ }
2336
+ },
2337
+ "path": {
2338
+ "type": "string",
2339
+ "maxLength": 200
2340
+ }
2341
+ }
2342
+ }
2343
+ },
2344
+ "more": {
2345
+ "type": "boolean"
2346
+ },
2347
+ "incomplete": {
2348
+ "type": "array",
2349
+ "maxItems": 100,
2350
+ "items": {
2351
+ "type": "object",
2352
+ "additionalProperties": false,
2353
+ "required": [
2354
+ "id",
2355
+ "name",
2356
+ "reason"
2357
+ ],
2358
+ "properties": {
2359
+ "id": {
2360
+ "type": "string",
2361
+ "maxLength": 200
2362
+ },
2363
+ "name": {
2364
+ "type": "string",
2365
+ "maxLength": 200
2366
+ },
2367
+ "reason": {
2368
+ "type": "string",
2369
+ "maxLength": 200
2370
+ }
2371
+ }
2372
+ }
2373
+ }
2374
+ }
2375
+ }
2078
2376
  }
2079
2377
  ],
2080
2378
  "views": [
@@ -2128,7 +2426,8 @@
2128
2426
  "wiki.pages",
2129
2427
  "wiki.read",
2130
2428
  "commitments.list",
2131
- "profile.read"
2429
+ "profile.read",
2430
+ "terms.list"
2132
2431
  ]
2133
2432
  },
2134
2433
  {
@@ -2227,13 +2526,67 @@
2227
2526
  "data"
2228
2527
  ],
2229
2528
  "rpc": []
2529
+ },
2530
+ {
2531
+ "v": 1,
2532
+ "id": "remembered",
2533
+ "place": "tool-result",
2534
+ "title": "Saved to memory",
2535
+ "tools": [
2536
+ "mem.remember",
2537
+ "mem.revise",
2538
+ "mem.commitments"
2539
+ ],
2540
+ "page": "views/remembered.html",
2541
+ "grants": [
2542
+ "data"
2543
+ ],
2544
+ "rpc": []
2230
2545
  }
2231
2546
  ],
2232
2547
  "signIns": [],
2233
2548
  "contributes": {
2234
2549
  "homeFeeds": [],
2235
2550
  "homeWidgets": [],
2236
- "workKinds": [],
2551
+ "workKinds": [
2552
+ {
2553
+ "id": "recall",
2554
+ "label": "Searching memory",
2555
+ "icon": "file-text",
2556
+ "tools": [
2557
+ "mem.recall",
2558
+ "mem.status",
2559
+ "mem.cursor",
2560
+ "mem.wiki",
2561
+ "mem.members",
2562
+ "mem.grants"
2563
+ ]
2564
+ },
2565
+ {
2566
+ "id": "remember",
2567
+ "label": "Saving to memory",
2568
+ "icon": "work",
2569
+ "tools": [
2570
+ "mem.remember",
2571
+ "mem.commitments",
2572
+ "mem.revise",
2573
+ "mem.page"
2574
+ ]
2575
+ },
2576
+ {
2577
+ "id": "organise",
2578
+ "label": "Organising memory",
2579
+ "icon": "wrench",
2580
+ "tools": [
2581
+ "mem.spaces",
2582
+ "mem.share",
2583
+ "mem.promote",
2584
+ "mem.forget",
2585
+ "mem.collect",
2586
+ "mem.ingest"
2587
+ ]
2588
+ }
2589
+ ],
2237
2590
  "settings": [
2238
2591
  {
2239
2592
  "key": "controlURL",
@@ -2245,8 +2598,15 @@
2245
2598
  "key": "capture",
2246
2599
  "label": "Remember conversations",
2247
2600
  "type": "boolean",
2601
+ "default": true,
2248
2602
  "description": "On by default: finished turns are saved to your private memory. Off: the memory tools still work, and nothing is saved unless the agent is asked to remember it."
2249
2603
  },
2604
+ {
2605
+ "key": "skipAsks",
2606
+ "label": "Run without asking",
2607
+ "type": "string",
2608
+ "description": "Empty by default. Memory's asks to turn off, separated by commas, such as memory.forget, page.delete; a deny still stands. The full list is in Memory's docs/permissions.md. A team write held in your Inbox still waits there."
2609
+ },
2250
2610
  {
2251
2611
  "key": "token",
2252
2612
  "label": "Memory key",
@@ -2259,10 +2619,8 @@
2259
2619
  "memory"
2260
2620
  ],
2261
2621
  "asks": [
2262
- "memory.remember",
2263
2622
  "memory.forget",
2264
2623
  "memory.promote",
2265
- "memory.promote.revoke",
2266
2624
  "wiki.write",
2267
2625
  "wiki.delete",
2268
2626
  "memory.revise",
@@ -2271,7 +2629,9 @@
2271
2629
  "share.grant",
2272
2630
  "share.revoke",
2273
2631
  "share.transfer",
2274
- "sources.bind"
2632
+ "share.move",
2633
+ "session.bind",
2634
+ "sources.unbind"
2275
2635
  ],
2276
2636
  "routines": [
2277
2637
  {
@@ -2302,23 +2662,26 @@
2302
2662
  "views/pages.html",
2303
2663
  "views/graph.html",
2304
2664
  "docs/agent-protocol.md",
2665
+ "docs/agent-instructions.md",
2666
+ "docs/permissions.md",
2305
2667
  "!docs/README.md",
2306
2668
  "README.md",
2307
2669
  "LICENSE",
2308
2670
  "SECURITY.md",
2309
2671
  "CHANGELOG.md",
2310
- "views/recall.html"
2672
+ "views/recall.html",
2673
+ "views/remembered.html"
2311
2674
  ],
2312
2675
  "publishConfig": {
2313
2676
  "access": "public"
2314
2677
  },
2315
2678
  "scripts": {
2316
- "test": "node --experimental-strip-types --test test/*.test.js",
2317
- "test:load": "node --test test/load-harness.test.js test/load-gateway.test.js",
2318
- "test:ops": "node --test test/ops-control.test.js",
2319
- "test:eval": "node --test test/agent-eval.test.js",
2679
+ "test": "node --experimental-strip-types --import ./test/support/tmp-isolation.js --test test/*.test.js",
2680
+ "test:load": "node --import ./test/support/tmp-isolation.js --test test/load-harness.test.js test/load-gateway.test.js",
2681
+ "test:ops": "node --import ./test/support/tmp-isolation.js --test test/ops-control.test.js",
2682
+ "test:eval": "node --import ./test/support/tmp-isolation.js --test test/agent-eval.test.js",
2320
2683
  "test:pack": "node --test test/package-contents.test.js",
2321
- "test:records": "node --disable-warning=ExperimentalWarning --test records/test/*.test.js",
2684
+ "test:records": "node --disable-warning=ExperimentalWarning --import ./test/support/tmp-isolation.js --test records/test/*.test.js",
2322
2685
  "eval:agent": "node scripts/eval/agent-eval.mjs",
2323
2686
  "eval:core": "node scripts/eval/agent-eval.mjs --suite core --runs 1 --timeout 120",
2324
2687
  "eval:core:release": "node scripts/eval/agent-eval.mjs --suite core --runs 3 --timeout 120",
@@ -2331,6 +2694,11 @@
2331
2694
  "eval:closed-book": "node scripts/eval/agent-eval.mjs --suite core --closed-book --runs 1 --timeout 120 --scenario core-recall-model --scenario core-recall-orb --scenario core-recall-port --scenario core-recall-region --scenario core-prior-db --scenario core-prior-version --scenario core-source-attribution --scenario core-preference --scenario core-update-owner --scenario core-update-region",
2332
2695
  "eval:agent:list": "node scripts/eval/agent-eval.mjs --list",
2333
2696
  "eval:controls": "node scripts/eval/controls.mjs",
2697
+ "eval:regrade": "node scripts/eval/regrade.mjs",
2698
+ "eval:c1": "node scripts/eval/c1.mjs",
2699
+ "eval:gate-v2": "node scripts/eval/gate-v2.mjs",
2700
+ "eval:writes": "node scripts/eval/write-allowlist.mjs",
2701
+ "eval:asks": "node scripts/eval/ask-policy.mjs",
2334
2702
  "load:spaces": "node scripts/loadtest-spaces.mjs",
2335
2703
  "load:gateway": "node scripts/loadtest-gateway.mjs",
2336
2704
  "load:cell": "node scripts/loadtest-cell.mjs",
@@ -2363,6 +2731,7 @@
2363
2731
  "check:copies": "node scripts/check-copies.mjs",
2364
2732
  "check": "npm test && npm run check:syntax && npm run check:docs && npm run check:protocol && npm run check:copies",
2365
2733
  "check:jelly": "bun scripts/check-jelly-declaration.mjs",
2734
+ "check:jelly:master": "scripts/check-jelly-master.sh",
2366
2735
  "shots:views": "node scripts/view-shots.mjs"
2367
2736
  },
2368
2737
  "keywords": [
@@ -26,28 +26,45 @@ await tools.mem.page({ action: "list", prefix: "projects/" }) // mem_page({ ac
26
26
  await tools.mem.page({ action: "read", path: "people/ama" }) // mem_page({ action: "read", path: "people/ama" })
27
27
  ```
28
28
 
29
- `read` shows the fields, the body, what the page links to and what links to it
30
- (backlinks), with its version. Before creating a page at an unknown path, check
31
- for an existing one rather than making a near-duplicate.
29
+ `read` shows the metadata first (fields, sections, links, backlinks, version),
30
+ then the body alone inside `<page_body>`. Only the text inside it is the page:
31
+ never copy the metadata or the markers into a write, which refuses them. Before
32
+ creating a page at an unknown path, check for an existing one rather than
33
+ making a near-duplicate.
32
34
 
33
- ## Write and append
35
+ ## Replace, append and write
34
36
 
35
37
  ```js
36
- await tools.mem.page({ action: "append", path: "projects/checkout-v3", section: "Log", content: "2026-11-05: launch moved to 18 Nov after the legal review." })
37
- await tools.mem.page({ action: "write", path: "projects/checkout-v3", title: "Checkout v3", content: "# Checkout v3\n\n## Status (as of 2026-11-05)\nLaunch moved to 18 Nov after the legal review.\n" })
38
+ await tools.mem.page({ action: "replace", path: "projects/checkout-v3", section: "Status", content: "- Launch 18 Nov, after the legal review (2026-11-05)." })
39
+ await tools.mem.page({ action: "append", path: "projects/checkout-v3", section: "Log", content: "- 2026-11-05: launch moved to 18 Nov after the legal review." })
38
40
  ```
39
41
 
42
+ - `replace` sets one `## section`'s text and keeps every other line: Status,
43
+ Purpose, People. "Status" also finds "Status (as of …)", for append too. A
44
+ name that fits two headings is refused, with their lines: rename or merge
45
+ one with `write`. Close any code fence you open. If someone changed that
46
+ section since this session's read, it is a conflict: read, merge, replace again.
40
47
  - `append` adds one line under a `## section`, creating it when missing: Log,
41
- Timeline, Decisions. Append once per change; don't re-read a successful write
42
- unless the answer depends on the updated page.
43
- - `write` replaces the whole body. Read an existing page before writing; merge
44
- your changes and write again. A missing or stale version conflicts; read the
45
- latest page and merge again rather than overwriting it.
46
- - One write per page per session, at a phase boundary. **Replace** Status,
47
- Purpose and People; **append** to Log and Timeline. Date every "now" claim.
48
+ Timeline, Decisions. On the person's own pages, one Log line per change,
49
+ starting with "- ". Don't re-read a successful write unless the answer
50
+ depends on the updated page.
51
+ - `write` replaces the whole body: for a new page or a restructure. Read the
52
+ page first, send only the body; a missing or stale version conflicts, so
53
+ read the latest and merge rather than overwrite.
54
+ - Date every "now" claim.
48
55
  - A shared write follows host permission settings: it defaults to ask, but an
49
56
  allow or remembered always may proceed without a prompt. Jelly with
50
- `heldTeamWrites` holds it in the Inbox. A private write never asks.
57
+ `heldTeamWrites` holds it in the Inbox. A private write never asks
58
+ (docs/permissions.md says how to change any ask).
59
+ - Where a page lands: `journal/` always in the personal space; a page that
60
+ exists in the session's shared space stays there; a new page is personal
61
+ unless the call passes the shared `space`, only when the person asked.
62
+ - On a team page (one that exists in a shared space) an agent only adds
63
+ lines, and only what the person asked for: `append` it, such as a dated
64
+ "Status:" line. No Log line, timeline entry or "noted that…" about your own
65
+ change; that bookkeeping is for the person's own pages. `write`,
66
+ `replace`, `move` and `delete` are refused there, and a journal page is
67
+ never written there. The person edits or removes lines in Memory's console.
51
68
 
52
69
  ## Links and timelines
53
70
 
@@ -63,7 +80,8 @@ await tools.mem.page({ action: "move", path: "topics/pricing", to: "projects/pri
63
80
 
64
81
  A **Timeline** section is a dated list of what happened with a person or a
65
82
  project. The daily routine appends to it, each line citing its source; append to
66
- it yourself with the date first.
83
+ it yourself with the date first, on the person's own pages (a team page gets
84
+ only what the person asked for).
67
85
 
68
86
  ## Page templates
69
87
 
@@ -96,6 +114,11 @@ items.
96
114
  memory: Context, Decision, Alternatives, Consequences, Status.
97
115
  - **Runbook** (`runbooks/<slug>`): When to use, Steps, Checks, Rollback, "Last
98
116
  verified <date> by <who>".
117
+ - **Meeting** (`meetings/<date>-<slug>`, type `meeting`): Date, Attendees (as
118
+ `[[people/<slug>]]` links, never names as text), Decisions, and what was
119
+ agreed. A meeting page in a shared space takes append or a proposal, like any
120
+ team page; nothing writes one on its own yet, so a person or an agent asked
121
+ to keep a meeting's notes writes it by hand.
99
122
 
100
123
  ## The journal
101
124
 
@@ -112,7 +135,8 @@ with `revise`.
112
135
  ## The dashboard
113
136
 
114
137
  `index` is the dashboard, pinned at the start of every session (at most 60
115
- lines). The routine owns only the block between `<!-- routine:dashboard -->` and
138
+ lines). Writing, appending to or moving it asks the person, in every space:
139
+ it changes what every later session starts with. The routine owns only the block between `<!-- routine:dashboard -->` and
116
140
  `<!-- /routine -->` (goals, active projects, due items, recent decisions, what
117
141
  needs review) and keeps everything the person writes outside it. To set goals,
118
142
  write them above the block: