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,721 +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/backlog.ts
31
- var backlog_exports = {};
32
- __export(backlog_exports, {
33
- backlogAdd: () => backlogAdd,
34
- backlogCommand: () => backlogCommand,
35
- backlogList: () => backlogList,
36
- backlogPromote: () => backlogPromote,
37
- formatBacklogDetails: () => formatBacklogDetails,
38
- formatBacklogList: () => formatBacklogList
39
- });
40
- module.exports = __toCommonJS(backlog_exports);
41
-
42
- // src/lib/task-utils.ts
43
- var fs2 = __toESM(require("fs"), 1);
44
- var path2 = __toESM(require("path"), 1);
45
- var import_gray_matter2 = __toESM(require("gray-matter"), 1);
46
-
47
- // src/lib/primitive-templates.ts
48
- var fs = __toESM(require("fs"), 1);
49
- var path = __toESM(require("path"), 1);
50
- var import_url = require("url");
51
- var import_gray_matter = __toESM(require("gray-matter"), 1);
52
-
53
- // src/lib/template-engine.ts
54
- function buildTemplateVariables(input = {}, now = /* @__PURE__ */ new Date()) {
55
- const datetime = input.datetime ?? now.toISOString();
56
- const date = input.date ?? datetime.split("T")[0];
57
- return {
58
- title: input.title ?? "",
59
- type: input.type ?? "",
60
- date,
61
- datetime
62
- };
63
- }
64
- function renderTemplate(template, variables) {
65
- return template.replace(/\{\{\s*([a-zA-Z0-9_-]+)\s*\}\}/g, (match, key) => {
66
- const value = variables[key];
67
- return value !== void 0 ? String(value) : match;
68
- });
69
- }
70
-
71
- // src/lib/primitive-templates.ts
72
- var import_meta = {};
73
- var TEMPLATE_EXTENSION = ".md";
74
- function isRecord(value) {
75
- return typeof value === "object" && value !== null && !Array.isArray(value);
76
- }
77
- function normalizeTemplateName(name) {
78
- const base = path.basename(name, path.extname(name));
79
- return base.trim();
80
- }
81
- function resolveBuiltinTemplatesDir(override) {
82
- if (override) {
83
- const resolved = path.resolve(override);
84
- return fs.existsSync(resolved) && fs.statSync(resolved).isDirectory() ? resolved : null;
85
- }
86
- const moduleDir = path.dirname((0, import_url.fileURLToPath)(import_meta.url));
87
- const candidates = [
88
- path.resolve(moduleDir, "../templates"),
89
- path.resolve(moduleDir, "../../templates")
90
- ];
91
- for (const candidate of candidates) {
92
- if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
93
- return candidate;
94
- }
95
- }
96
- return null;
97
- }
98
- function listTemplateFiles(dir, ignore) {
99
- const entries = /* @__PURE__ */ new Map();
100
- if (!fs.existsSync(dir)) return entries;
101
- for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
102
- if (!entry.isFile() || !entry.name.endsWith(TEMPLATE_EXTENSION)) continue;
103
- const name = normalizeTemplateName(entry.name);
104
- if (!name) continue;
105
- if (ignore?.has(name)) continue;
106
- entries.set(name, path.join(dir, entry.name));
107
- }
108
- return entries;
109
- }
110
- function buildTemplateIndex(options = {}) {
111
- const index = /* @__PURE__ */ new Map();
112
- const builtinDir = resolveBuiltinTemplatesDir(options.builtinDir);
113
- if (builtinDir) {
114
- for (const [name, filePath] of listTemplateFiles(builtinDir, options.ignoreBuiltinNames)) {
115
- index.set(name, filePath);
116
- }
117
- }
118
- if (options.vaultPath) {
119
- const vaultTemplatesDir = path.join(path.resolve(options.vaultPath), "templates");
120
- for (const [name, filePath] of listTemplateFiles(vaultTemplatesDir)) {
121
- index.set(name, filePath);
122
- }
123
- }
124
- return index;
125
- }
126
- function inferFieldType(defaultValue) {
127
- if (Array.isArray(defaultValue)) {
128
- const uniqueItemTypes = [...new Set(defaultValue.map((value) => typeof value))];
129
- if (uniqueItemTypes.length === 1 && uniqueItemTypes[0] === "string") {
130
- return "string[]";
131
- }
132
- return "array";
133
- }
134
- switch (typeof defaultValue) {
135
- case "string":
136
- return "string";
137
- case "number":
138
- return "number";
139
- case "boolean":
140
- return "boolean";
141
- case "object":
142
- if (defaultValue === null) return "string";
143
- return "object";
144
- default:
145
- return "string";
146
- }
147
- }
148
- function normalizeFieldDefinition(rawField) {
149
- if (!isRecord(rawField)) {
150
- return {
151
- type: inferFieldType(rawField),
152
- default: rawField
153
- };
154
- }
155
- const rawType = typeof rawField.type === "string" ? rawField.type.trim() : "";
156
- const normalized = {
157
- type: rawType || inferFieldType(rawField.default)
158
- };
159
- if (typeof rawField.description === "string" && rawField.description.trim()) {
160
- normalized.description = rawField.description.trim();
161
- }
162
- if (typeof rawField.required === "boolean") {
163
- normalized.required = rawField.required;
164
- }
165
- if (Object.prototype.hasOwnProperty.call(rawField, "default")) {
166
- normalized.default = rawField.default;
167
- }
168
- if (Array.isArray(rawField.enum)) {
169
- normalized.enum = rawField.enum;
170
- }
171
- return normalized;
172
- }
173
- function normalizeFieldDefinitions(rawFields) {
174
- const normalized = {};
175
- for (const [fieldName, rawField] of Object.entries(rawFields)) {
176
- const normalizedName = String(fieldName).trim();
177
- if (!normalizedName) continue;
178
- normalized[normalizedName] = normalizeFieldDefinition(rawField);
179
- }
180
- return normalized;
181
- }
182
- function extractSchemaDefinition(frontmatter) {
183
- const primitive = typeof frontmatter.primitive === "string" ? frontmatter.primitive.trim() : "";
184
- const description = typeof frontmatter.description === "string" ? frontmatter.description.trim() : void 0;
185
- if (primitive && isRecord(frontmatter.fields)) {
186
- return {
187
- primitive,
188
- description,
189
- fields: frontmatter.fields
190
- };
191
- }
192
- const containerCandidates = [frontmatter.schema, frontmatter.template];
193
- for (const candidate of containerCandidates) {
194
- if (!isRecord(candidate)) continue;
195
- const nestedPrimitive = typeof candidate.primitive === "string" ? candidate.primitive.trim() : primitive;
196
- if (!nestedPrimitive || !isRecord(candidate.fields)) continue;
197
- const nestedDescription = typeof candidate.description === "string" ? candidate.description.trim() : description;
198
- return {
199
- primitive: nestedPrimitive,
200
- description: nestedDescription,
201
- fields: candidate.fields
202
- };
203
- }
204
- return null;
205
- }
206
- function inferLegacyFieldDefinitions(frontmatter) {
207
- const normalized = {};
208
- const ignoredKeys = /* @__PURE__ */ new Set(["primitive", "fields", "schema", "template"]);
209
- for (const [key, value] of Object.entries(frontmatter)) {
210
- if (ignoredKeys.has(key)) continue;
211
- normalized[key] = {
212
- type: inferFieldType(value),
213
- default: value
214
- };
215
- }
216
- return normalized;
217
- }
218
- function parseTemplateDefinition(rawTemplate, templateName, sourcePath) {
219
- const normalizedName = normalizeTemplateName(templateName);
220
- const { data, content } = (0, import_gray_matter.default)(rawTemplate);
221
- const frontmatter = isRecord(data) ? data : {};
222
- const extractedSchema = extractSchemaDefinition(frontmatter);
223
- if (extractedSchema) {
224
- return {
225
- name: normalizedName,
226
- primitive: extractedSchema.primitive,
227
- description: extractedSchema.description,
228
- fields: normalizeFieldDefinitions(extractedSchema.fields),
229
- body: content,
230
- format: "schema",
231
- sourcePath
232
- };
233
- }
234
- return {
235
- name: normalizedName,
236
- primitive: normalizedName,
237
- description: typeof frontmatter.description === "string" ? frontmatter.description.trim() : void 0,
238
- fields: inferLegacyFieldDefinitions(frontmatter),
239
- body: content,
240
- format: "legacy",
241
- sourcePath
242
- };
243
- }
244
- function readTemplateDefinitionFromPath(filePath, templateName) {
245
- try {
246
- const raw = fs.readFileSync(filePath, "utf-8");
247
- return parseTemplateDefinition(raw, templateName, filePath);
248
- } catch {
249
- return null;
250
- }
251
- }
252
- function loadTemplateDefinition(templateName, options = {}) {
253
- const normalizedName = normalizeTemplateName(templateName);
254
- if (!normalizedName) return null;
255
- const index = buildTemplateIndex(options);
256
- const filePath = index.get(normalizedName);
257
- if (!filePath) return null;
258
- return readTemplateDefinitionFromPath(filePath, normalizedName);
259
- }
260
- function loadSchemaTemplateDefinition(templateName, options = {}) {
261
- const definition = loadTemplateDefinition(templateName, options);
262
- if (!definition || definition.format !== "schema") {
263
- return null;
264
- }
265
- return definition;
266
- }
267
- function resolveInterpolatedValue(value, variables) {
268
- if (typeof value === "string") {
269
- return renderTemplate(value, variables);
270
- }
271
- if (Array.isArray(value)) {
272
- return value.map((item) => resolveInterpolatedValue(item, variables));
273
- }
274
- if (isRecord(value)) {
275
- const resolved = {};
276
- for (const [key, nested] of Object.entries(value)) {
277
- resolved[key] = resolveInterpolatedValue(nested, variables);
278
- }
279
- return resolved;
280
- }
281
- return value;
282
- }
283
- function pruneFrontmatter(frontmatter, options) {
284
- const dropEmptyStrings = options.dropEmptyStrings ?? true;
285
- const dropEmptyArrays = options.dropEmptyArrays ?? true;
286
- const pruned = {};
287
- for (const [key, value] of Object.entries(frontmatter)) {
288
- if (value === void 0 || value === null) continue;
289
- if (dropEmptyStrings && typeof value === "string" && value.trim() === "") continue;
290
- if (dropEmptyArrays && Array.isArray(value) && value.length === 0) continue;
291
- pruned[key] = value;
292
- }
293
- return pruned;
294
- }
295
- function buildFrontmatterFromTemplate(definition, variables, overrides = {}, options = {}) {
296
- const frontmatter = {};
297
- for (const [fieldName, schema] of Object.entries(definition.fields)) {
298
- if (!Object.prototype.hasOwnProperty.call(schema, "default")) continue;
299
- frontmatter[fieldName] = resolveInterpolatedValue(schema.default, variables);
300
- }
301
- for (const [fieldName, value] of Object.entries(overrides)) {
302
- if (value === void 0) continue;
303
- if (value === null) {
304
- delete frontmatter[fieldName];
305
- continue;
306
- }
307
- frontmatter[fieldName] = value;
308
- }
309
- if (!options.pruneEmpty) {
310
- return frontmatter;
311
- }
312
- return pruneFrontmatter(frontmatter, options);
313
- }
314
- function renderDocumentFromTemplate(definition, options = {}) {
315
- const now = options.now ?? /* @__PURE__ */ new Date();
316
- const variables = {
317
- ...buildTemplateVariables(
318
- {
319
- title: options.title ?? "",
320
- type: options.type ?? definition.primitive
321
- },
322
- now
323
- ),
324
- ...options.variables ?? {}
325
- };
326
- const frontmatter = buildFrontmatterFromTemplate(
327
- definition,
328
- variables,
329
- options.overrides,
330
- options.frontmatter
331
- );
332
- const content = renderTemplate(definition.body, variables);
333
- const markdown = import_gray_matter.default.stringify(content, frontmatter);
334
- return {
335
- frontmatter,
336
- content,
337
- markdown,
338
- variables
339
- };
340
- }
341
-
342
- // src/lib/task-utils.ts
343
- function slugify(text) {
344
- return text.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").trim();
345
- }
346
- function getTasksDir(vaultPath) {
347
- return path2.join(path2.resolve(vaultPath), "tasks");
348
- }
349
- function getBacklogDir(vaultPath) {
350
- return path2.join(path2.resolve(vaultPath), "backlog");
351
- }
352
- function ensureTasksDir(vaultPath) {
353
- const tasksDir = getTasksDir(vaultPath);
354
- if (!fs2.existsSync(tasksDir)) {
355
- fs2.mkdirSync(tasksDir, { recursive: true });
356
- }
357
- }
358
- function ensureBacklogDir(vaultPath) {
359
- const backlogDir = getBacklogDir(vaultPath);
360
- if (!fs2.existsSync(backlogDir)) {
361
- fs2.mkdirSync(backlogDir, { recursive: true });
362
- }
363
- }
364
- function getTaskPath(vaultPath, slug) {
365
- return path2.join(getTasksDir(vaultPath), `${slug}.md`);
366
- }
367
- function getBacklogPath(vaultPath, slug) {
368
- return path2.join(getBacklogDir(vaultPath), `${slug}.md`);
369
- }
370
- function extractTitle(content) {
371
- const match = content.match(/^#\s+(.+)$/m);
372
- return match ? match[1].trim() : "";
373
- }
374
- function buildTaskFrontmatterFallback(now, options) {
375
- const frontmatter = {
376
- status: "open",
377
- created: now,
378
- updated: now
379
- };
380
- if (options.source) frontmatter.source = options.source;
381
- if (options.owner) frontmatter.owner = options.owner;
382
- if (options.project) frontmatter.project = options.project;
383
- if (options.priority) frontmatter.priority = options.priority;
384
- if (options.due) frontmatter.due = options.due;
385
- if (options.tags && options.tags.length > 0) frontmatter.tags = options.tags;
386
- if (options.description) frontmatter.description = options.description;
387
- if (options.estimate) frontmatter.estimate = options.estimate;
388
- if (options.parent) frontmatter.parent = options.parent;
389
- if (options.depends_on && options.depends_on.length > 0) frontmatter.depends_on = options.depends_on;
390
- return frontmatter;
391
- }
392
- function buildTaskContentFallback(title, options) {
393
- let content = `# ${title}
394
- `;
395
- const links = [];
396
- if (options.owner) links.push(`[[${options.owner}]]`);
397
- if (options.project) links.push(`[[${options.project}]]`);
398
- if (links.length > 0) {
399
- content += `
400
- ${links.join(" | ")}
401
- `;
402
- }
403
- if (options.content) {
404
- content += `
405
- ${options.content}
406
- `;
407
- }
408
- return content;
409
- }
410
- function buildTaskTemplateOverrides(options) {
411
- const overrides = {};
412
- if (options.source) overrides.source = options.source;
413
- if (options.owner) overrides.owner = options.owner;
414
- if (options.project) overrides.project = options.project;
415
- if (options.priority) overrides.priority = options.priority;
416
- if (options.due) overrides.due = options.due;
417
- if (options.tags && options.tags.length > 0) overrides.tags = options.tags;
418
- if (options.description) overrides.description = options.description;
419
- if (options.estimate) overrides.estimate = options.estimate;
420
- if (options.parent) overrides.parent = options.parent;
421
- if (options.depends_on && options.depends_on.length > 0) overrides.depends_on = options.depends_on;
422
- return overrides;
423
- }
424
- function buildTaskTemplateVariables(title, slug, options) {
425
- const ownerLink = options.owner ? `[[${options.owner}]]` : "";
426
- const projectLink = options.project ? `[[${options.project}]]` : "";
427
- const linksLine = [ownerLink, projectLink].filter(Boolean).join(" | ");
428
- return {
429
- title,
430
- slug,
431
- source: options.source ?? "",
432
- owner: options.owner ?? "",
433
- project: options.project ?? "",
434
- priority: options.priority ?? "",
435
- due: options.due ?? "",
436
- tags_csv: (options.tags || []).join(", "),
437
- description: options.description ?? "",
438
- estimate: options.estimate ?? "",
439
- parent: options.parent ?? "",
440
- depends_on_csv: (options.depends_on || []).join(", "),
441
- content: options.content ?? "",
442
- owner_link: ownerLink,
443
- project_link: projectLink,
444
- links_line: linksLine
445
- };
446
- }
447
- var VALID_TASK_STATUSES = /* @__PURE__ */ new Set([
448
- "open",
449
- "in-progress",
450
- "blocked",
451
- "done"
452
- ]);
453
- function isTaskStatus(value) {
454
- return typeof value === "string" && VALID_TASK_STATUSES.has(value);
455
- }
456
- function readBacklogItem(vaultPath, slug) {
457
- const backlogPath = getBacklogPath(vaultPath, slug);
458
- if (!fs2.existsSync(backlogPath)) {
459
- return null;
460
- }
461
- try {
462
- const raw = fs2.readFileSync(backlogPath, "utf-8");
463
- const { data, content } = (0, import_gray_matter2.default)(raw);
464
- const title = extractTitle(content) || slug;
465
- return {
466
- slug,
467
- title,
468
- content,
469
- frontmatter: data,
470
- path: backlogPath
471
- };
472
- } catch {
473
- return null;
474
- }
475
- }
476
- function listBacklogItems(vaultPath, filters) {
477
- const backlogDir = getBacklogDir(vaultPath);
478
- if (!fs2.existsSync(backlogDir)) {
479
- return [];
480
- }
481
- const items = [];
482
- const entries = fs2.readdirSync(backlogDir, { withFileTypes: true });
483
- for (const entry of entries) {
484
- if (!entry.isFile() || !entry.name.endsWith(".md")) {
485
- continue;
486
- }
487
- const slug = entry.name.replace(/\.md$/, "");
488
- const item = readBacklogItem(vaultPath, slug);
489
- if (!item) continue;
490
- if (filters) {
491
- if (filters.project && item.frontmatter.project !== filters.project) continue;
492
- if (filters.source && item.frontmatter.source !== filters.source) continue;
493
- }
494
- items.push(item);
495
- }
496
- return items.sort((a, b) => {
497
- return new Date(b.frontmatter.created).getTime() - new Date(a.frontmatter.created).getTime();
498
- });
499
- }
500
- function createTask(vaultPath, title, options = {}) {
501
- ensureTasksDir(vaultPath);
502
- const slug = slugify(title);
503
- const taskPath = getTaskPath(vaultPath, slug);
504
- if (fs2.existsSync(taskPath)) {
505
- throw new Error(`Task already exists: ${slug}`);
506
- }
507
- const now = (/* @__PURE__ */ new Date()).toISOString();
508
- const template = loadSchemaTemplateDefinition("task", {
509
- vaultPath: path2.resolve(vaultPath)
510
- });
511
- let frontmatter;
512
- let content;
513
- if (template) {
514
- const rendered = renderDocumentFromTemplate(template, {
515
- title,
516
- type: "task",
517
- now: new Date(now),
518
- variables: buildTaskTemplateVariables(title, slug, options),
519
- overrides: buildTaskTemplateOverrides(options),
520
- frontmatter: { pruneEmpty: true }
521
- });
522
- const templateFrontmatter = rendered.frontmatter;
523
- frontmatter = {
524
- ...templateFrontmatter,
525
- status: isTaskStatus(templateFrontmatter.status) ? templateFrontmatter.status : "open",
526
- created: typeof templateFrontmatter.created === "string" && templateFrontmatter.created ? templateFrontmatter.created : now,
527
- updated: typeof templateFrontmatter.updated === "string" && templateFrontmatter.updated ? templateFrontmatter.updated : now
528
- };
529
- content = rendered.content;
530
- } else {
531
- frontmatter = buildTaskFrontmatterFallback(now, options);
532
- content = buildTaskContentFallback(title, options);
533
- }
534
- const fileContent = import_gray_matter2.default.stringify(content, frontmatter);
535
- fs2.writeFileSync(taskPath, fileContent);
536
- return {
537
- slug,
538
- title,
539
- content,
540
- frontmatter,
541
- path: taskPath
542
- };
543
- }
544
- function createBacklogItem(vaultPath, title, options = {}) {
545
- ensureBacklogDir(vaultPath);
546
- const slug = slugify(title);
547
- const backlogPath = getBacklogPath(vaultPath, slug);
548
- if (fs2.existsSync(backlogPath)) {
549
- throw new Error(`Backlog item already exists: ${slug}`);
550
- }
551
- const now = (/* @__PURE__ */ new Date()).toISOString();
552
- const frontmatter = {
553
- created: now
554
- };
555
- if (options.source) frontmatter.source = options.source;
556
- if (options.project) frontmatter.project = options.project;
557
- if (options.tags && options.tags.length > 0) frontmatter.tags = options.tags;
558
- let content = `# ${title}
559
- `;
560
- const links = [];
561
- if (options.source) links.push(`[[${options.source}]]`);
562
- if (options.project) links.push(`[[${options.project}]]`);
563
- if (links.length > 0) {
564
- content += `
565
- ${links.join(" | ")}
566
- `;
567
- }
568
- if (options.content) {
569
- content += `
570
- ${options.content}
571
- `;
572
- }
573
- const fileContent = import_gray_matter2.default.stringify(content, frontmatter);
574
- fs2.writeFileSync(backlogPath, fileContent);
575
- return {
576
- slug,
577
- title,
578
- content,
579
- frontmatter,
580
- path: backlogPath
581
- };
582
- }
583
- function promoteBacklogItem(vaultPath, slug, options = {}) {
584
- const backlogItem = readBacklogItem(vaultPath, slug);
585
- if (!backlogItem) {
586
- throw new Error(`Backlog item not found: ${slug}`);
587
- }
588
- const task = createTask(vaultPath, backlogItem.title, {
589
- owner: options.owner,
590
- project: backlogItem.frontmatter.project,
591
- priority: options.priority,
592
- due: options.due,
593
- content: backlogItem.content.replace(/^#\s+.+\n/, "").trim(),
594
- // Remove title from content
595
- tags: backlogItem.frontmatter.tags
596
- });
597
- fs2.unlinkSync(backlogItem.path);
598
- return task;
599
- }
600
-
601
- // src/commands/backlog.ts
602
- function toDateStr(val) {
603
- if (!val) return "unknown";
604
- if (val instanceof Date) return val.toISOString().split("T")[0];
605
- const s = String(val);
606
- if (s.includes("T")) return s.split("T")[0];
607
- return s;
608
- }
609
- function backlogAdd(vaultPath, title, options = {}) {
610
- return createBacklogItem(vaultPath, title, {
611
- source: options.source,
612
- project: options.project,
613
- content: options.content,
614
- tags: options.tags
615
- });
616
- }
617
- function backlogList(vaultPath, options = {}) {
618
- const filters = {};
619
- if (options.project) filters.project = options.project;
620
- return listBacklogItems(vaultPath, filters);
621
- }
622
- function backlogPromote(vaultPath, slug, options = {}) {
623
- return promoteBacklogItem(vaultPath, slug, {
624
- owner: options.owner,
625
- priority: options.priority,
626
- due: options.due
627
- });
628
- }
629
- function formatBacklogList(items) {
630
- if (items.length === 0) {
631
- return "No backlog items found.\n";
632
- }
633
- const headers = ["SOURCE", "PROJECT", "CREATED", "TITLE"];
634
- const widths = [12, 16, 12, 40];
635
- let output = headers.map((h, i) => h.padEnd(widths[i])).join(" ") + "\n";
636
- for (const item of items) {
637
- const source = item.frontmatter.source || "-";
638
- const project = item.frontmatter.project || "-";
639
- const created = toDateStr(item.frontmatter.created);
640
- const title = item.title.length > widths[3] ? item.title.slice(0, widths[3] - 3) + "..." : item.title;
641
- const row = [
642
- source.padEnd(widths[0]),
643
- project.padEnd(widths[1]),
644
- created.padEnd(widths[2]),
645
- title
646
- ];
647
- output += row.join(" ") + "\n";
648
- }
649
- return output;
650
- }
651
- function formatBacklogDetails(item) {
652
- let output = "";
653
- output += `# ${item.title}
654
- `;
655
- output += "-".repeat(40) + "\n";
656
- if (item.frontmatter.source) {
657
- output += `Source: ${item.frontmatter.source}
658
- `;
659
- }
660
- if (item.frontmatter.project) {
661
- output += `Project: ${item.frontmatter.project}
662
- `;
663
- }
664
- if (item.frontmatter.tags && item.frontmatter.tags.length > 0) {
665
- output += `Tags: ${item.frontmatter.tags.join(", ")}
666
- `;
667
- }
668
- output += `Created: ${item.frontmatter.created}
669
- `;
670
- output += `File: ${item.path}
671
- `;
672
- output += "-".repeat(40) + "\n";
673
- const contentWithoutTitle = item.content.replace(/^#\s+.+\n/, "").trim();
674
- if (contentWithoutTitle) {
675
- output += "\n" + contentWithoutTitle + "\n";
676
- }
677
- return output;
678
- }
679
- async function backlogCommand(vaultPath, action, args) {
680
- const options = args.options || {};
681
- switch (action) {
682
- case "add": {
683
- if (!args.title) {
684
- throw new Error("Title is required for backlog add");
685
- }
686
- const item = backlogAdd(vaultPath, args.title, options);
687
- console.log(`\u2713 Added to backlog: ${item.slug}`);
688
- console.log(` Path: ${item.path}`);
689
- break;
690
- }
691
- case "list": {
692
- const items = backlogList(vaultPath, options);
693
- if (options.json) {
694
- console.log(JSON.stringify(items, null, 2));
695
- } else {
696
- console.log(formatBacklogList(items));
697
- }
698
- break;
699
- }
700
- case "promote": {
701
- if (!args.slug) {
702
- throw new Error("Backlog item slug is required for promote");
703
- }
704
- const task = backlogPromote(vaultPath, args.slug, options);
705
- console.log(`\u2713 Promoted to task: ${task.slug}`);
706
- console.log(` Path: ${task.path}`);
707
- break;
708
- }
709
- default:
710
- throw new Error(`Unknown backlog action: ${action}`);
711
- }
712
- }
713
- // Annotate the CommonJS export names for ESM import in node:
714
- 0 && (module.exports = {
715
- backlogAdd,
716
- backlogCommand,
717
- backlogList,
718
- backlogPromote,
719
- formatBacklogDetails,
720
- formatBacklogList
721
- });