clawvault 3.1.0 → 3.2.1

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 (273) hide show
  1. package/README.md +422 -141
  2. package/bin/clawvault.js +10 -2
  3. package/bin/command-registration.test.js +3 -1
  4. package/bin/command-runtime.js +9 -1
  5. package/bin/register-core-commands.js +23 -28
  6. package/bin/register-maintenance-commands.js +39 -3
  7. package/bin/register-query-commands.js +58 -29
  8. package/bin/register-tailscale-commands.js +106 -0
  9. package/bin/register-task-commands.js +18 -1
  10. package/bin/register-task-commands.test.js +16 -0
  11. package/bin/register-vault-operations-commands.js +29 -1
  12. package/bin/register-workgraph-commands.js +451 -0
  13. package/dashboard/lib/graph-diff.js +104 -0
  14. package/dashboard/lib/graph-diff.test.js +75 -0
  15. package/dashboard/lib/vault-parser.js +556 -0
  16. package/dashboard/lib/vault-parser.test.js +254 -0
  17. package/dashboard/public/app.js +796 -0
  18. package/dashboard/public/index.html +52 -0
  19. package/dashboard/public/styles.css +221 -0
  20. package/dashboard/server.js +374 -0
  21. package/dist/{chunk-C7OK5WKP.js → chunk-2JQ3O2YL.js} +4 -4
  22. package/dist/{chunk-VR5NE7PZ.js → chunk-2RAZ4ZFE.js} +1 -1
  23. package/dist/{chunk-F2JEUD4J.js → chunk-4ITRXIVT.js} +5 -7
  24. package/dist/{chunk-GUKMRGM7.js → chunk-4OXMU5S2.js} +1 -1
  25. package/dist/chunk-5PJ4STIC.js +465 -0
  26. package/dist/{chunk-62YTUT6J.js → chunk-AZYOKJYC.js} +2 -2
  27. package/dist/chunk-BSJ6RIT7.js +447 -0
  28. package/dist/chunk-ECRZL5XR.js +50 -0
  29. package/dist/chunk-ERNE2FZ5.js +189 -0
  30. package/dist/{chunk-WAZ3NLWL.js → chunk-F55HGNU4.js} +0 -47
  31. package/dist/{chunk-VGLOTGAS.js → chunk-FAKNOB7Y.js} +2 -2
  32. package/dist/{chunk-QK3UCXWL.js → chunk-FHFUXL6G.js} +2 -2
  33. package/dist/chunk-GNJL4YGR.js +79 -0
  34. package/dist/chunk-HR4KN6S2.js +152 -0
  35. package/dist/{chunk-OZ7RIXTO.js → chunk-IIOU45CK.js} +1 -1
  36. package/dist/chunk-IJBFGPCS.js +33 -0
  37. package/dist/chunk-IVRIKYFE.js +520 -0
  38. package/dist/chunk-K7PNYS45.js +93 -0
  39. package/dist/chunk-MDIH26GC.js +183 -0
  40. package/dist/{chunk-LYHGEHXG.js → chunk-MFAWT5O5.js} +0 -1
  41. package/dist/{chunk-H34S76MB.js → chunk-MNPUYCHQ.js} +6 -6
  42. package/dist/chunk-NTOPJI7W.js +207 -0
  43. package/dist/{chunk-QBLMXKF2.js → chunk-OIWVQYQF.js} +1 -1
  44. package/dist/chunk-PG56HX5T.js +154 -0
  45. package/dist/{chunk-LNJA2UGL.js → chunk-PI4WMLMG.js} +7 -84
  46. package/dist/chunk-QMHPQYUV.js +363 -0
  47. package/dist/{chunk-H62BP7RI.js → chunk-QPDDIHXE.js} +209 -43
  48. package/dist/{chunk-N2AXRYLC.js → chunk-QWQ3TIKS.js} +1 -1
  49. package/dist/{chunk-3DHXQHYG.js → chunk-R2MIW5G7.js} +1 -1
  50. package/dist/{chunk-SJSFRIYS.js → chunk-S5OJEGFG.js} +2 -2
  51. package/dist/chunk-SS4B7P7V.js +99 -0
  52. package/dist/chunk-TIGW564L.js +628 -0
  53. package/dist/chunk-U67V476Y.js +35 -0
  54. package/dist/{chunk-JY6FYXIT.js → chunk-UCQAOZHW.js} +6 -11
  55. package/dist/{chunk-ITPEXLHA.js → chunk-URXDAUVH.js} +24 -5
  56. package/dist/chunk-WIOLLGAD.js +190 -0
  57. package/dist/{chunk-3WRJEKN4.js → chunk-WJVWINEM.js} +72 -8
  58. package/dist/chunk-WMGIIABP.js +15 -0
  59. package/dist/{chunk-33UGEQRT.js → chunk-X3SPPUFG.js} +151 -64
  60. package/dist/{chunk-3NSBOUT3.js → chunk-Y3TIJEBP.js} +314 -79
  61. package/dist/chunk-Y6VJKXGL.js +373 -0
  62. package/dist/{chunk-LI4O6NVK.js → chunk-YDWHS4LJ.js} +49 -9
  63. package/dist/{chunk-U55BGUAU.js → chunk-YNIPYN4F.js} +5 -5
  64. package/dist/chunk-YXQCA6B7.js +226 -0
  65. package/dist/cli/index.js +26 -22
  66. package/dist/commands/archive.js +3 -3
  67. package/dist/commands/backlog.js +3 -3
  68. package/dist/commands/blocked.js +3 -3
  69. package/dist/commands/canvas.d.ts +15 -0
  70. package/dist/commands/canvas.js +200 -0
  71. package/dist/commands/checkpoint.js +2 -2
  72. package/dist/commands/compat.js +2 -2
  73. package/dist/commands/context.js +7 -5
  74. package/dist/commands/doctor.d.ts +11 -7
  75. package/dist/commands/doctor.js +16 -14
  76. package/dist/commands/embed.js +5 -6
  77. package/dist/commands/entities.js +2 -2
  78. package/dist/commands/graph.js +3 -3
  79. package/dist/commands/inject.d.ts +1 -1
  80. package/dist/commands/inject.js +4 -5
  81. package/dist/commands/kanban.js +4 -4
  82. package/dist/commands/link.js +2 -2
  83. package/dist/commands/migrate-observations.js +4 -4
  84. package/dist/commands/observe.d.ts +0 -1
  85. package/dist/commands/observe.js +13 -12
  86. package/dist/commands/project.js +5 -5
  87. package/dist/commands/rebuild-embeddings.d.ts +21 -0
  88. package/dist/commands/rebuild-embeddings.js +91 -0
  89. package/dist/commands/rebuild.js +12 -11
  90. package/dist/commands/recover.js +3 -3
  91. package/dist/commands/reflect.js +6 -7
  92. package/dist/commands/repair-session.js +1 -1
  93. package/dist/commands/replay.js +14 -14
  94. package/dist/commands/session-recap.js +1 -1
  95. package/dist/commands/setup.d.ts +2 -89
  96. package/dist/commands/setup.js +3 -21
  97. package/dist/commands/shell-init.js +1 -1
  98. package/dist/commands/sleep.d.ts +1 -1
  99. package/dist/commands/sleep.js +18 -17
  100. package/dist/commands/status.d.ts +2 -0
  101. package/dist/commands/status.js +40 -30
  102. package/dist/commands/sync-bd.d.ts +10 -0
  103. package/dist/commands/sync-bd.js +10 -0
  104. package/dist/commands/tailscale.d.ts +52 -0
  105. package/dist/commands/tailscale.js +26 -0
  106. package/dist/commands/task.js +4 -4
  107. package/dist/commands/template.js +2 -2
  108. package/dist/commands/wake.d.ts +1 -1
  109. package/dist/commands/wake.js +11 -10
  110. package/dist/index.d.ts +334 -191
  111. package/dist/index.js +432 -108
  112. package/dist/{inject-Bzi5E-By.d.ts → inject-DYUrDqQO.d.ts} +3 -3
  113. package/dist/ledger-B7g7jhqG.d.ts +44 -0
  114. package/dist/lib/auto-linker.js +1 -1
  115. package/dist/lib/canvas-layout.d.ts +115 -0
  116. package/dist/lib/canvas-layout.js +35 -0
  117. package/dist/lib/config.d.ts +27 -3
  118. package/dist/lib/config.js +4 -2
  119. package/dist/lib/entity-index.js +1 -1
  120. package/dist/lib/project-utils.js +4 -4
  121. package/dist/lib/session-repair.js +1 -1
  122. package/dist/lib/session-utils.js +1 -1
  123. package/dist/lib/tailscale.d.ts +225 -0
  124. package/dist/lib/tailscale.js +50 -0
  125. package/dist/lib/task-utils.js +3 -3
  126. package/dist/lib/template-engine.js +1 -1
  127. package/dist/lib/webdav.d.ts +109 -0
  128. package/dist/lib/webdav.js +35 -0
  129. package/dist/plugin/index.d.ts +344 -28
  130. package/dist/plugin/index.js +3919 -227
  131. package/dist/registry-BR4326o0.d.ts +30 -0
  132. package/dist/store-CA-6sKCJ.d.ts +34 -0
  133. package/dist/thread-B9LhXNU0.d.ts +41 -0
  134. package/dist/{types-Y2_Um2Ls.d.ts → types-BbWJoC1c.d.ts} +1 -44
  135. package/dist/workgraph/index.d.ts +5 -0
  136. package/dist/workgraph/index.js +23 -0
  137. package/dist/workgraph/ledger.d.ts +2 -0
  138. package/dist/workgraph/ledger.js +25 -0
  139. package/dist/workgraph/registry.d.ts +2 -0
  140. package/dist/workgraph/registry.js +19 -0
  141. package/dist/workgraph/store.d.ts +2 -0
  142. package/dist/workgraph/store.js +25 -0
  143. package/dist/workgraph/thread.d.ts +2 -0
  144. package/dist/workgraph/thread.js +25 -0
  145. package/dist/workgraph/types.d.ts +54 -0
  146. package/dist/workgraph/types.js +7 -0
  147. package/hooks/clawvault/HOOK.md +113 -0
  148. package/hooks/clawvault/handler.js +1559 -0
  149. package/hooks/clawvault/handler.test.js +510 -0
  150. package/hooks/clawvault/openclaw.plugin.json +72 -0
  151. package/openclaw.plugin.json +235 -30
  152. package/package.json +20 -20
  153. package/dist/chunk-3RG5ZIWI.js +0 -10
  154. package/dist/chunk-3ZIH425O.js +0 -871
  155. package/dist/chunk-6U6MK36V.js +0 -205
  156. package/dist/chunk-CMB7UL7C.js +0 -327
  157. package/dist/chunk-D2H45LON.js +0 -1074
  158. package/dist/chunk-E7MFQB6D.js +0 -163
  159. package/dist/chunk-GQSLDZTS.js +0 -560
  160. package/dist/chunk-MFM6K7PU.js +0 -374
  161. package/dist/chunk-MXSSG3QU.js +0 -42
  162. package/dist/chunk-OCGVIN3L.js +0 -88
  163. package/dist/chunk-PAH27GSN.js +0 -108
  164. package/dist/chunk-YCUNCH2I.js +0 -78
  165. package/dist/cli/index.cjs +0 -8584
  166. package/dist/cli/index.d.cts +0 -5
  167. package/dist/commands/archive.cjs +0 -287
  168. package/dist/commands/archive.d.cts +0 -11
  169. package/dist/commands/backlog.cjs +0 -721
  170. package/dist/commands/backlog.d.cts +0 -53
  171. package/dist/commands/blocked.cjs +0 -204
  172. package/dist/commands/blocked.d.cts +0 -26
  173. package/dist/commands/checkpoint.cjs +0 -244
  174. package/dist/commands/checkpoint.d.cts +0 -41
  175. package/dist/commands/compat.cjs +0 -294
  176. package/dist/commands/compat.d.cts +0 -28
  177. package/dist/commands/context.cjs +0 -2990
  178. package/dist/commands/context.d.cts +0 -2
  179. package/dist/commands/doctor.cjs +0 -2986
  180. package/dist/commands/doctor.d.cts +0 -21
  181. package/dist/commands/embed.cjs +0 -232
  182. package/dist/commands/embed.d.cts +0 -17
  183. package/dist/commands/entities.cjs +0 -141
  184. package/dist/commands/entities.d.cts +0 -7
  185. package/dist/commands/graph.cjs +0 -501
  186. package/dist/commands/graph.d.cts +0 -21
  187. package/dist/commands/inject.cjs +0 -1636
  188. package/dist/commands/inject.d.cts +0 -2
  189. package/dist/commands/kanban.cjs +0 -884
  190. package/dist/commands/kanban.d.cts +0 -63
  191. package/dist/commands/link.cjs +0 -965
  192. package/dist/commands/link.d.cts +0 -11
  193. package/dist/commands/migrate-observations.cjs +0 -362
  194. package/dist/commands/migrate-observations.d.cts +0 -19
  195. package/dist/commands/observe.cjs +0 -4099
  196. package/dist/commands/observe.d.cts +0 -23
  197. package/dist/commands/project.cjs +0 -1341
  198. package/dist/commands/project.d.cts +0 -85
  199. package/dist/commands/rebuild.cjs +0 -3136
  200. package/dist/commands/rebuild.d.cts +0 -11
  201. package/dist/commands/recover.cjs +0 -361
  202. package/dist/commands/recover.d.cts +0 -38
  203. package/dist/commands/reflect.cjs +0 -1008
  204. package/dist/commands/reflect.d.cts +0 -11
  205. package/dist/commands/repair-session.cjs +0 -457
  206. package/dist/commands/repair-session.d.cts +0 -38
  207. package/dist/commands/replay.cjs +0 -4103
  208. package/dist/commands/replay.d.cts +0 -16
  209. package/dist/commands/session-recap.cjs +0 -353
  210. package/dist/commands/session-recap.d.cts +0 -27
  211. package/dist/commands/setup.cjs +0 -1278
  212. package/dist/commands/setup.d.cts +0 -99
  213. package/dist/commands/shell-init.cjs +0 -75
  214. package/dist/commands/shell-init.d.cts +0 -7
  215. package/dist/commands/sleep.cjs +0 -6029
  216. package/dist/commands/sleep.d.cts +0 -36
  217. package/dist/commands/status.cjs +0 -2737
  218. package/dist/commands/status.d.cts +0 -52
  219. package/dist/commands/task.cjs +0 -1236
  220. package/dist/commands/task.d.cts +0 -97
  221. package/dist/commands/template.cjs +0 -457
  222. package/dist/commands/template.d.cts +0 -36
  223. package/dist/commands/wake.cjs +0 -2627
  224. package/dist/commands/wake.d.cts +0 -22
  225. package/dist/context-BUGaWpyL.d.cts +0 -46
  226. package/dist/index.cjs +0 -12373
  227. package/dist/index.d.cts +0 -854
  228. package/dist/inject-Bzi5E-By.d.cts +0 -137
  229. package/dist/lib/auto-linker.cjs +0 -176
  230. package/dist/lib/auto-linker.d.cts +0 -26
  231. package/dist/lib/config.cjs +0 -78
  232. package/dist/lib/config.d.cts +0 -11
  233. package/dist/lib/entity-index.cjs +0 -84
  234. package/dist/lib/entity-index.d.cts +0 -26
  235. package/dist/lib/project-utils.cjs +0 -864
  236. package/dist/lib/project-utils.d.cts +0 -97
  237. package/dist/lib/session-repair.cjs +0 -239
  238. package/dist/lib/session-repair.d.cts +0 -110
  239. package/dist/lib/session-utils.cjs +0 -209
  240. package/dist/lib/session-utils.d.cts +0 -63
  241. package/dist/lib/task-utils.cjs +0 -1137
  242. package/dist/lib/task-utils.d.cts +0 -208
  243. package/dist/lib/template-engine.cjs +0 -47
  244. package/dist/lib/template-engine.d.cts +0 -11
  245. package/dist/plugin/index.cjs +0 -1907
  246. package/dist/plugin/index.d.cts +0 -36
  247. package/dist/plugin/inject.cjs +0 -356
  248. package/dist/plugin/inject.d.cts +0 -54
  249. package/dist/plugin/inject.d.ts +0 -54
  250. package/dist/plugin/inject.js +0 -17
  251. package/dist/plugin/observe.cjs +0 -631
  252. package/dist/plugin/observe.d.cts +0 -39
  253. package/dist/plugin/observe.d.ts +0 -39
  254. package/dist/plugin/observe.js +0 -18
  255. package/dist/plugin/templates.cjs +0 -593
  256. package/dist/plugin/templates.d.cts +0 -52
  257. package/dist/plugin/templates.d.ts +0 -52
  258. package/dist/plugin/templates.js +0 -25
  259. package/dist/plugin/types.cjs +0 -18
  260. package/dist/plugin/types.d.cts +0 -209
  261. package/dist/plugin/types.d.ts +0 -209
  262. package/dist/plugin/types.js +0 -0
  263. package/dist/plugin/vault.cjs +0 -927
  264. package/dist/plugin/vault.d.cts +0 -68
  265. package/dist/plugin/vault.d.ts +0 -68
  266. package/dist/plugin/vault.js +0 -22
  267. package/dist/types-Y2_Um2Ls.d.cts +0 -205
  268. package/templates/memory-event.md +0 -67
  269. package/templates/party.md +0 -63
  270. package/templates/primitive-registry.yaml +0 -551
  271. package/templates/run.md +0 -68
  272. package/templates/trigger.md +0 -68
  273. package/templates/workspace.md +0 -50
@@ -1,5 +0,0 @@
1
- import { Command } from 'commander';
2
-
3
- declare function registerCliCommands(program: Command): Command;
4
-
5
- export { registerCliCommands };
@@ -1,287 +0,0 @@
1
- "use strict";
2
- var __create = Object.create;
3
- var __defProp = Object.defineProperty;
4
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
- var __getOwnPropNames = Object.getOwnPropertyNames;
6
- var __getProtoOf = Object.getPrototypeOf;
7
- var __hasOwnProp = Object.prototype.hasOwnProperty;
8
- var __export = (target, all) => {
9
- for (var name in all)
10
- __defProp(target, name, { get: all[name], enumerable: true });
11
- };
12
- var __copyProps = (to, from, except, desc) => {
13
- if (from && typeof from === "object" || typeof from === "function") {
14
- for (let key of __getOwnPropNames(from))
15
- if (!__hasOwnProp.call(to, key) && key !== except)
16
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
17
- }
18
- return to;
19
- };
20
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
- // If the importer is in node compatibility mode or this is not an ESM
22
- // file that has been converted to a CommonJS file using a Babel-
23
- // compatible transform (i.e. "__esModule" has not been set), then set
24
- // "default" to the CommonJS "module.exports" for node compatibility.
25
- isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
- mod
27
- ));
28
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
-
30
- // src/commands/archive.ts
31
- var archive_exports = {};
32
- __export(archive_exports, {
33
- archiveCommand: () => archiveCommand,
34
- registerArchiveCommand: () => registerArchiveCommand
35
- });
36
- module.exports = __toCommonJS(archive_exports);
37
-
38
- // src/lib/config.ts
39
- var fs = __toESM(require("fs"), 1);
40
- var path = __toESM(require("path"), 1);
41
- function findNearestVaultPath(startPath = process.cwd()) {
42
- let current = path.resolve(startPath);
43
- while (true) {
44
- if (fs.existsSync(path.join(current, ".clawvault.json"))) {
45
- return current;
46
- }
47
- const parent = path.dirname(current);
48
- if (parent === current) {
49
- return null;
50
- }
51
- current = parent;
52
- }
53
- }
54
- function resolveVaultPath(options = {}) {
55
- if (options.explicitPath) {
56
- return path.resolve(options.explicitPath);
57
- }
58
- if (process.env.CLAWVAULT_PATH) {
59
- return path.resolve(process.env.CLAWVAULT_PATH);
60
- }
61
- const discovered = findNearestVaultPath(options.cwd ?? process.cwd());
62
- if (discovered) {
63
- return discovered;
64
- }
65
- throw new Error("No vault path found. Set CLAWVAULT_PATH, use --vault, or run inside a vault.");
66
- }
67
-
68
- // src/observer/archive.ts
69
- var fs3 = __toESM(require("fs"), 1);
70
-
71
- // src/lib/ledger.ts
72
- var fs2 = __toESM(require("fs"), 1);
73
- var path2 = __toESM(require("path"), 1);
74
- var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
75
- var YEAR_RE = /^\d{4}$/;
76
- var MONTH_RE = /^(0[1-9]|1[0-2])$/;
77
- var DAY_FILE_RE = /^(0[1-9]|[12]\d|3[01])\.md$/;
78
- var RAW_DAY_FILE_RE = /^(0[1-9]|[12]\d|3[01])\.jsonl$/;
79
- function normalizeDateKey(date) {
80
- if (typeof date === "string") {
81
- if (!DATE_RE.test(date)) {
82
- throw new Error(`Invalid date key: ${date}`);
83
- }
84
- return date;
85
- }
86
- return date.toISOString().slice(0, 10);
87
- }
88
- function ensureDir(dirPath) {
89
- fs2.mkdirSync(dirPath, { recursive: true });
90
- }
91
- function walkThreeLevelDateTree(rootPath, extension) {
92
- if (!fs2.existsSync(rootPath)) {
93
- return [];
94
- }
95
- const results = [];
96
- for (const yearEntry of fs2.readdirSync(rootPath, { withFileTypes: true })) {
97
- if (!yearEntry.isDirectory() || !YEAR_RE.test(yearEntry.name)) continue;
98
- const yearDir = path2.join(rootPath, yearEntry.name);
99
- for (const monthEntry of fs2.readdirSync(yearDir, { withFileTypes: true })) {
100
- if (!monthEntry.isDirectory() || !MONTH_RE.test(monthEntry.name)) continue;
101
- const monthDir = path2.join(yearDir, monthEntry.name);
102
- for (const dayEntry of fs2.readdirSync(monthDir, { withFileTypes: true })) {
103
- if (!dayEntry.isFile()) continue;
104
- const matches = extension === ".md" ? DAY_FILE_RE.test(dayEntry.name) : RAW_DAY_FILE_RE.test(dayEntry.name);
105
- if (!matches) continue;
106
- const day = dayEntry.name.slice(0, extension.length * -1);
107
- const date = `${yearEntry.name}-${monthEntry.name}-${day}`;
108
- if (!DATE_RE.test(date)) continue;
109
- results.push({
110
- date,
111
- absolutePath: path2.join(monthDir, dayEntry.name)
112
- });
113
- }
114
- }
115
- }
116
- return results;
117
- }
118
- function inDateRange(date, fromDate, toDate) {
119
- if (fromDate && date < fromDate) {
120
- return false;
121
- }
122
- if (toDate && date > toDate) {
123
- return false;
124
- }
125
- return true;
126
- }
127
- function getLedgerRoot(vaultPath) {
128
- return path2.join(path2.resolve(vaultPath), "ledger");
129
- }
130
- function getObservationsRoot(vaultPath) {
131
- return path2.join(getLedgerRoot(vaultPath), "observations");
132
- }
133
- function getArchiveObservationsRoot(vaultPath) {
134
- return path2.join(getLedgerRoot(vaultPath), "archive", "observations");
135
- }
136
- function getLegacyObservationsRoot(vaultPath) {
137
- return path2.join(path2.resolve(vaultPath), "observations");
138
- }
139
- function getArchiveObservationPath(vaultPath, date) {
140
- const dateKey = normalizeDateKey(date);
141
- const [year, month, day] = dateKey.split("-");
142
- return path2.join(getArchiveObservationsRoot(vaultPath), year, month, `${day}.md`);
143
- }
144
- function listLedgerObservationFiles(vaultPath, options = {}) {
145
- return walkThreeLevelDateTree(getObservationsRoot(vaultPath), ".md").filter((entry) => inDateRange(entry.date, options.fromDate, options.toDate)).map((entry) => ({
146
- date: entry.date,
147
- path: entry.absolutePath,
148
- location: "ledger"
149
- })).sort((left, right) => left.date.localeCompare(right.date));
150
- }
151
- function listArchiveObservationFiles(vaultPath, options = {}) {
152
- return walkThreeLevelDateTree(getArchiveObservationsRoot(vaultPath), ".md").filter((entry) => inDateRange(entry.date, options.fromDate, options.toDate)).map((entry) => ({
153
- date: entry.date,
154
- path: entry.absolutePath,
155
- location: "archive"
156
- })).sort((left, right) => left.date.localeCompare(right.date));
157
- }
158
- function listLegacyObservationFiles(vaultPath, options = {}) {
159
- const legacyRoot = getLegacyObservationsRoot(vaultPath);
160
- if (!fs2.existsSync(legacyRoot)) {
161
- return [];
162
- }
163
- return fs2.readdirSync(legacyRoot, { withFileTypes: true }).filter((entry) => entry.isFile() && DATE_RE.test(entry.name.replace(/\.md$/, "")) && entry.name.endsWith(".md")).map((entry) => {
164
- const date = entry.name.replace(/\.md$/, "");
165
- return {
166
- date,
167
- path: path2.join(legacyRoot, entry.name),
168
- location: "legacy"
169
- };
170
- }).filter((entry) => inDateRange(entry.date, options.fromDate, options.toDate)).sort((left, right) => left.date.localeCompare(right.date));
171
- }
172
- function listObservationFiles(vaultPath, options = {}) {
173
- const includeLegacy = options.includeLegacy ?? true;
174
- const includeArchive = options.includeArchive ?? false;
175
- const dedupeByDate = options.dedupeByDate ?? true;
176
- const files = [
177
- ...listLedgerObservationFiles(vaultPath, options),
178
- ...includeLegacy ? listLegacyObservationFiles(vaultPath, options) : [],
179
- ...includeArchive ? listArchiveObservationFiles(vaultPath, options) : []
180
- ];
181
- if (!dedupeByDate) {
182
- return files.sort((left, right) => left.date.localeCompare(right.date));
183
- }
184
- const byDate = /* @__PURE__ */ new Map();
185
- const locationRank = {
186
- ledger: 3,
187
- legacy: 2,
188
- archive: 1
189
- };
190
- for (const file of files) {
191
- const existing = byDate.get(file.date);
192
- if (!existing || locationRank[file.location] > locationRank[existing.location]) {
193
- byDate.set(file.date, file);
194
- }
195
- }
196
- return [...byDate.values()].sort((left, right) => left.date.localeCompare(right.date));
197
- }
198
- function ensureParentDir(filePath) {
199
- ensureDir(path2.dirname(filePath));
200
- }
201
-
202
- // src/observer/archive.ts
203
- function archiveObservations(vaultPath, options = {}) {
204
- const olderThanDays = Number.isFinite(options.olderThanDays) ? Math.max(1, Math.floor(options.olderThanDays)) : 14;
205
- const dryRun = options.dryRun ?? false;
206
- const now = options.now ?? (() => /* @__PURE__ */ new Date());
207
- const today = new Date(now());
208
- today.setUTCHours(0, 0, 0, 0);
209
- const cutoff = new Date(today);
210
- cutoff.setUTCDate(today.getUTCDate() - olderThanDays);
211
- const cutoffKey = cutoff.toISOString().slice(0, 10);
212
- const files = listObservationFiles(vaultPath, {
213
- includeLegacy: true,
214
- includeArchive: false,
215
- dedupeByDate: true
216
- });
217
- let archived = 0;
218
- let skipped = 0;
219
- const archivedDates = [];
220
- for (const file of files) {
221
- if (file.date >= cutoffKey) {
222
- continue;
223
- }
224
- const archivePath = getArchiveObservationPath(vaultPath, file.date);
225
- if (dryRun) {
226
- archived += 1;
227
- archivedDates.push(file.date);
228
- continue;
229
- }
230
- ensureParentDir(archivePath);
231
- fs3.copyFileSync(file.path, archivePath);
232
- if (file.path !== archivePath) {
233
- fs3.rmSync(file.path, { force: true });
234
- } else {
235
- skipped += 1;
236
- continue;
237
- }
238
- archived += 1;
239
- archivedDates.push(file.date);
240
- }
241
- return {
242
- scanned: files.length,
243
- archived,
244
- skipped,
245
- dryRun,
246
- archivedDates
247
- };
248
- }
249
-
250
- // src/commands/archive.ts
251
- function parsePositiveInteger(raw, label) {
252
- const parsed = Number.parseInt(raw, 10);
253
- if (!Number.isFinite(parsed) || parsed <= 0) {
254
- throw new Error(`Invalid ${label}: ${raw}`);
255
- }
256
- return parsed;
257
- }
258
- async function archiveCommand(options) {
259
- const vaultPath = resolveVaultPath({ explicitPath: options.vaultPath });
260
- const result = archiveObservations(vaultPath, {
261
- olderThanDays: options.olderThan,
262
- dryRun: options.dryRun
263
- });
264
- if (result.archived === 0) {
265
- console.log("No observations matched archive criteria.");
266
- return;
267
- }
268
- if (result.dryRun) {
269
- console.log(`Dry run: ${result.archived} observation file(s) would be archived.`);
270
- return;
271
- }
272
- console.log(`Archived ${result.archived} observation file(s).`);
273
- }
274
- function registerArchiveCommand(program) {
275
- program.command("archive").description("Archive old observations into ledger/archive").option("--older-than <days>", "Archive observations older than this many days", "14").option("--dry-run", "Show archive candidates without moving files").option("-v, --vault <path>", "Vault path").action(async (rawOptions) => {
276
- await archiveCommand({
277
- vaultPath: rawOptions.vault,
278
- olderThan: parsePositiveInteger(rawOptions.olderThan, "older-than"),
279
- dryRun: rawOptions.dryRun
280
- });
281
- });
282
- }
283
- // Annotate the CommonJS export names for ESM import in node:
284
- 0 && (module.exports = {
285
- archiveCommand,
286
- registerArchiveCommand
287
- });
@@ -1,11 +0,0 @@
1
- import { Command } from 'commander';
2
-
3
- interface ArchiveCommandOptions {
4
- vaultPath?: string;
5
- olderThan?: number;
6
- dryRun?: boolean;
7
- }
8
- declare function archiveCommand(options: ArchiveCommandOptions): Promise<void>;
9
- declare function registerArchiveCommand(program: Command): void;
10
-
11
- export { type ArchiveCommandOptions, archiveCommand, registerArchiveCommand };