clawvault 3.1.0 → 3.2.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 (289) 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 +1368 -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-F2JEUD4J.js → chunk-23YDQ3QU.js} +6 -8
  22. package/dist/{chunk-C7OK5WKP.js → chunk-2JQ3O2YL.js} +4 -4
  23. package/dist/{chunk-VR5NE7PZ.js → chunk-2RAZ4ZFE.js} +1 -1
  24. package/dist/chunk-2ZDO52B4.js +52 -0
  25. package/dist/{chunk-ZZA73MFY.js → chunk-33DOSHTA.js} +176 -36
  26. package/dist/chunk-33VSQP4J.js +37 -0
  27. package/dist/chunk-4BQTQMJP.js +93 -0
  28. package/dist/{chunk-GUKMRGM7.js → chunk-4OXMU5S2.js} +1 -1
  29. package/dist/{chunk-62YTUT6J.js → chunk-4PY655YM.js} +15 -3
  30. package/dist/chunk-6FH3IULF.js +352 -0
  31. package/dist/{chunk-3NSBOUT3.js → chunk-77Q5CSPJ.js} +404 -80
  32. package/dist/{chunk-4VQTUVH7.js → chunk-7YZWHM36.js} +52 -26
  33. package/dist/chunk-BSJ6RIT7.js +447 -0
  34. package/dist/chunk-BUEW6IIK.js +364 -0
  35. package/dist/{chunk-LI4O6NVK.js → chunk-CLJTREDS.js} +74 -14
  36. package/dist/chunk-EK6S23ZB.js +469 -0
  37. package/dist/{chunk-LNJA2UGL.js → chunk-ESFLMDRB.js} +9 -86
  38. package/dist/{chunk-H34S76MB.js → chunk-ESVS6K2B.js} +6 -6
  39. package/dist/{chunk-WAZ3NLWL.js → chunk-F55HGNU4.js} +0 -47
  40. package/dist/{chunk-QK3UCXWL.js → chunk-FHFUXL6G.js} +2 -2
  41. package/dist/{chunk-H62BP7RI.js → chunk-GAOWA7GR.js} +212 -46
  42. package/dist/chunk-GGA32J2R.js +784 -0
  43. package/dist/chunk-GNJL4YGR.js +79 -0
  44. package/dist/chunk-IVRIKYFE.js +520 -0
  45. package/dist/chunk-MDIH26GC.js +183 -0
  46. package/dist/{chunk-LYHGEHXG.js → chunk-MFAWT5O5.js} +0 -1
  47. package/dist/chunk-MM6QGW3P.js +207 -0
  48. package/dist/{chunk-P5EPF6MB.js → chunk-MW5C6ZQA.js} +110 -13
  49. package/dist/chunk-NCKFNBHJ.js +257 -0
  50. package/dist/{chunk-QBLMXKF2.js → chunk-OIWVQYQF.js} +1 -1
  51. package/dist/{chunk-42MXU7A6.js → chunk-P62WHA27.js} +58 -47
  52. package/dist/chunk-PBACDKKP.js +66 -0
  53. package/dist/{chunk-VGLOTGAS.js → chunk-QSHD36LH.js} +2 -2
  54. package/dist/{chunk-OZ7RIXTO.js → chunk-QSRRMEYM.js} +2 -2
  55. package/dist/chunk-QVEERJSP.js +152 -0
  56. package/dist/{chunk-N2AXRYLC.js → chunk-QWQ3TIKS.js} +1 -1
  57. package/dist/{chunk-3DHXQHYG.js → chunk-R2MIW5G7.js} +1 -1
  58. package/dist/{chunk-SJSFRIYS.js → chunk-SLXOR3CC.js} +2 -2
  59. package/dist/chunk-SS4B7P7V.js +99 -0
  60. package/dist/{chunk-JY6FYXIT.js → chunk-STCQGCEQ.js} +6 -11
  61. package/dist/chunk-TIGW564L.js +628 -0
  62. package/dist/chunk-U4O6C46S.js +154 -0
  63. package/dist/{chunk-ITPEXLHA.js → chunk-URXDAUVH.js} +24 -5
  64. package/dist/chunk-VSL7KY3M.js +189 -0
  65. package/dist/{chunk-U55BGUAU.js → chunk-W4SPAEE7.js} +6 -6
  66. package/dist/chunk-WMGIIABP.js +15 -0
  67. package/dist/{chunk-33UGEQRT.js → chunk-X3SPPUFG.js} +151 -64
  68. package/dist/chunk-Y6VJKXGL.js +373 -0
  69. package/dist/{chunk-3WRJEKN4.js → chunk-ZN54U2OZ.js} +123 -10
  70. package/dist/cli/index.js +34 -24
  71. package/dist/commands/archive.js +3 -3
  72. package/dist/commands/backlog.js +3 -3
  73. package/dist/commands/blocked.js +3 -3
  74. package/dist/commands/canvas.d.ts +15 -0
  75. package/dist/commands/canvas.js +200 -0
  76. package/dist/commands/checkpoint.js +2 -2
  77. package/dist/commands/compat.js +2 -2
  78. package/dist/commands/context.js +8 -6
  79. package/dist/commands/doctor.d.ts +11 -7
  80. package/dist/commands/doctor.js +18 -16
  81. package/dist/commands/embed.js +5 -6
  82. package/dist/commands/entities.js +2 -2
  83. package/dist/commands/graph.js +4 -4
  84. package/dist/commands/inject.d.ts +1 -1
  85. package/dist/commands/inject.js +5 -6
  86. package/dist/commands/kanban.js +4 -4
  87. package/dist/commands/link.js +5 -5
  88. package/dist/commands/migrate-observations.js +4 -4
  89. package/dist/commands/observe.d.ts +0 -1
  90. package/dist/commands/observe.js +14 -13
  91. package/dist/commands/project.js +5 -5
  92. package/dist/commands/rebuild-embeddings.d.ts +21 -0
  93. package/dist/commands/rebuild-embeddings.js +91 -0
  94. package/dist/commands/rebuild.js +12 -11
  95. package/dist/commands/recover.js +3 -3
  96. package/dist/commands/reflect.js +6 -7
  97. package/dist/commands/repair-session.js +1 -1
  98. package/dist/commands/replay.js +14 -14
  99. package/dist/commands/session-recap.js +1 -1
  100. package/dist/commands/setup.d.ts +2 -89
  101. package/dist/commands/setup.js +3 -21
  102. package/dist/commands/shell-init.js +1 -1
  103. package/dist/commands/sleep.d.ts +1 -1
  104. package/dist/commands/sleep.js +20 -19
  105. package/dist/commands/status.d.ts +2 -0
  106. package/dist/commands/status.js +57 -35
  107. package/dist/commands/sync-bd.d.ts +10 -0
  108. package/dist/commands/sync-bd.js +10 -0
  109. package/dist/commands/tailscale.d.ts +52 -0
  110. package/dist/commands/tailscale.js +26 -0
  111. package/dist/commands/task.js +4 -4
  112. package/dist/commands/template.js +2 -2
  113. package/dist/commands/wake.d.ts +1 -1
  114. package/dist/commands/wake.js +11 -10
  115. package/dist/commands/workgraph.d.ts +124 -0
  116. package/dist/commands/workgraph.js +38 -0
  117. package/dist/index.d.ts +341 -191
  118. package/dist/index.js +446 -116
  119. package/dist/{inject-Bzi5E-By.d.ts → inject-DYUrDqQO.d.ts} +3 -3
  120. package/dist/ledger-B7g7jhqG.d.ts +44 -0
  121. package/dist/lib/auto-linker.js +2 -2
  122. package/dist/lib/canvas-layout.d.ts +115 -0
  123. package/dist/lib/canvas-layout.js +35 -0
  124. package/dist/lib/config.d.ts +27 -3
  125. package/dist/lib/config.js +4 -2
  126. package/dist/lib/entity-index.js +1 -1
  127. package/dist/lib/project-utils.js +4 -4
  128. package/dist/lib/session-repair.js +1 -1
  129. package/dist/lib/session-utils.js +1 -1
  130. package/dist/lib/tailscale.d.ts +225 -0
  131. package/dist/lib/tailscale.js +50 -0
  132. package/dist/lib/task-utils.js +3 -3
  133. package/dist/lib/template-engine.js +1 -1
  134. package/dist/lib/webdav.d.ts +109 -0
  135. package/dist/lib/webdav.js +35 -0
  136. package/dist/onnxruntime_binding-5QEF3SUC.node +0 -0
  137. package/dist/onnxruntime_binding-BKPKNEGC.node +0 -0
  138. package/dist/onnxruntime_binding-FMOXGIUT.node +0 -0
  139. package/dist/onnxruntime_binding-OI2KMXC5.node +0 -0
  140. package/dist/onnxruntime_binding-UX44MLAZ.node +0 -0
  141. package/dist/onnxruntime_binding-Y2W7N7WY.node +0 -0
  142. package/dist/openclaw-plugin.d.ts +8 -0
  143. package/dist/openclaw-plugin.js +14 -0
  144. package/dist/registry-BR4326o0.d.ts +30 -0
  145. package/dist/store-CA-6sKCJ.d.ts +34 -0
  146. package/dist/thread-B9LhXNU0.d.ts +41 -0
  147. package/dist/transformers.node-A2ZRORSQ.js +46775 -0
  148. package/dist/{types-Y2_Um2Ls.d.ts → types-BbWJoC1c.d.ts} +1 -44
  149. package/dist/workgraph/index.d.ts +5 -0
  150. package/dist/workgraph/index.js +23 -0
  151. package/dist/workgraph/ledger.d.ts +2 -0
  152. package/dist/workgraph/ledger.js +25 -0
  153. package/dist/workgraph/registry.d.ts +2 -0
  154. package/dist/workgraph/registry.js +19 -0
  155. package/dist/workgraph/store.d.ts +2 -0
  156. package/dist/workgraph/store.js +25 -0
  157. package/dist/workgraph/thread.d.ts +2 -0
  158. package/dist/workgraph/thread.js +25 -0
  159. package/dist/workgraph/types.d.ts +54 -0
  160. package/dist/workgraph/types.js +7 -0
  161. package/hooks/clawvault/HOOK.md +113 -0
  162. package/hooks/clawvault/handler.js +1561 -0
  163. package/hooks/clawvault/handler.test.js +510 -0
  164. package/hooks/clawvault/openclaw.plugin.json +72 -0
  165. package/openclaw.plugin.json +65 -38
  166. package/package.json +25 -22
  167. package/dist/chunk-3RG5ZIWI.js +0 -10
  168. package/dist/chunk-3ZIH425O.js +0 -871
  169. package/dist/chunk-6U6MK36V.js +0 -205
  170. package/dist/chunk-CMB7UL7C.js +0 -327
  171. package/dist/chunk-D2H45LON.js +0 -1074
  172. package/dist/chunk-E7MFQB6D.js +0 -163
  173. package/dist/chunk-GQSLDZTS.js +0 -560
  174. package/dist/chunk-MFM6K7PU.js +0 -374
  175. package/dist/chunk-MXSSG3QU.js +0 -42
  176. package/dist/chunk-OCGVIN3L.js +0 -88
  177. package/dist/chunk-PAH27GSN.js +0 -108
  178. package/dist/chunk-YCUNCH2I.js +0 -78
  179. package/dist/cli/index.cjs +0 -8584
  180. package/dist/cli/index.d.cts +0 -5
  181. package/dist/commands/archive.cjs +0 -287
  182. package/dist/commands/archive.d.cts +0 -11
  183. package/dist/commands/backlog.cjs +0 -721
  184. package/dist/commands/backlog.d.cts +0 -53
  185. package/dist/commands/blocked.cjs +0 -204
  186. package/dist/commands/blocked.d.cts +0 -26
  187. package/dist/commands/checkpoint.cjs +0 -244
  188. package/dist/commands/checkpoint.d.cts +0 -41
  189. package/dist/commands/compat.cjs +0 -294
  190. package/dist/commands/compat.d.cts +0 -28
  191. package/dist/commands/context.cjs +0 -2990
  192. package/dist/commands/context.d.cts +0 -2
  193. package/dist/commands/doctor.cjs +0 -2986
  194. package/dist/commands/doctor.d.cts +0 -21
  195. package/dist/commands/embed.cjs +0 -232
  196. package/dist/commands/embed.d.cts +0 -17
  197. package/dist/commands/entities.cjs +0 -141
  198. package/dist/commands/entities.d.cts +0 -7
  199. package/dist/commands/graph.cjs +0 -501
  200. package/dist/commands/graph.d.cts +0 -21
  201. package/dist/commands/inject.cjs +0 -1636
  202. package/dist/commands/inject.d.cts +0 -2
  203. package/dist/commands/kanban.cjs +0 -884
  204. package/dist/commands/kanban.d.cts +0 -63
  205. package/dist/commands/link.cjs +0 -965
  206. package/dist/commands/link.d.cts +0 -11
  207. package/dist/commands/migrate-observations.cjs +0 -362
  208. package/dist/commands/migrate-observations.d.cts +0 -19
  209. package/dist/commands/observe.cjs +0 -4099
  210. package/dist/commands/observe.d.cts +0 -23
  211. package/dist/commands/project.cjs +0 -1341
  212. package/dist/commands/project.d.cts +0 -85
  213. package/dist/commands/rebuild.cjs +0 -3136
  214. package/dist/commands/rebuild.d.cts +0 -11
  215. package/dist/commands/recover.cjs +0 -361
  216. package/dist/commands/recover.d.cts +0 -38
  217. package/dist/commands/reflect.cjs +0 -1008
  218. package/dist/commands/reflect.d.cts +0 -11
  219. package/dist/commands/repair-session.cjs +0 -457
  220. package/dist/commands/repair-session.d.cts +0 -38
  221. package/dist/commands/replay.cjs +0 -4103
  222. package/dist/commands/replay.d.cts +0 -16
  223. package/dist/commands/session-recap.cjs +0 -353
  224. package/dist/commands/session-recap.d.cts +0 -27
  225. package/dist/commands/setup.cjs +0 -1278
  226. package/dist/commands/setup.d.cts +0 -99
  227. package/dist/commands/shell-init.cjs +0 -75
  228. package/dist/commands/shell-init.d.cts +0 -7
  229. package/dist/commands/sleep.cjs +0 -6029
  230. package/dist/commands/sleep.d.cts +0 -36
  231. package/dist/commands/status.cjs +0 -2737
  232. package/dist/commands/status.d.cts +0 -52
  233. package/dist/commands/task.cjs +0 -1236
  234. package/dist/commands/task.d.cts +0 -97
  235. package/dist/commands/template.cjs +0 -457
  236. package/dist/commands/template.d.cts +0 -36
  237. package/dist/commands/wake.cjs +0 -2627
  238. package/dist/commands/wake.d.cts +0 -22
  239. package/dist/context-BUGaWpyL.d.cts +0 -46
  240. package/dist/index.cjs +0 -12373
  241. package/dist/index.d.cts +0 -854
  242. package/dist/inject-Bzi5E-By.d.cts +0 -137
  243. package/dist/lib/auto-linker.cjs +0 -176
  244. package/dist/lib/auto-linker.d.cts +0 -26
  245. package/dist/lib/config.cjs +0 -78
  246. package/dist/lib/config.d.cts +0 -11
  247. package/dist/lib/entity-index.cjs +0 -84
  248. package/dist/lib/entity-index.d.cts +0 -26
  249. package/dist/lib/project-utils.cjs +0 -864
  250. package/dist/lib/project-utils.d.cts +0 -97
  251. package/dist/lib/session-repair.cjs +0 -239
  252. package/dist/lib/session-repair.d.cts +0 -110
  253. package/dist/lib/session-utils.cjs +0 -209
  254. package/dist/lib/session-utils.d.cts +0 -63
  255. package/dist/lib/task-utils.cjs +0 -1137
  256. package/dist/lib/task-utils.d.cts +0 -208
  257. package/dist/lib/template-engine.cjs +0 -47
  258. package/dist/lib/template-engine.d.cts +0 -11
  259. package/dist/plugin/index.cjs +0 -1907
  260. package/dist/plugin/index.d.cts +0 -36
  261. package/dist/plugin/index.d.ts +0 -36
  262. package/dist/plugin/index.js +0 -572
  263. package/dist/plugin/inject.cjs +0 -356
  264. package/dist/plugin/inject.d.cts +0 -54
  265. package/dist/plugin/inject.d.ts +0 -54
  266. package/dist/plugin/inject.js +0 -17
  267. package/dist/plugin/observe.cjs +0 -631
  268. package/dist/plugin/observe.d.cts +0 -39
  269. package/dist/plugin/observe.d.ts +0 -39
  270. package/dist/plugin/observe.js +0 -18
  271. package/dist/plugin/templates.cjs +0 -593
  272. package/dist/plugin/templates.d.cts +0 -52
  273. package/dist/plugin/templates.d.ts +0 -52
  274. package/dist/plugin/templates.js +0 -25
  275. package/dist/plugin/types.cjs +0 -18
  276. package/dist/plugin/types.d.cts +0 -209
  277. package/dist/plugin/types.d.ts +0 -209
  278. package/dist/plugin/types.js +0 -0
  279. package/dist/plugin/vault.cjs +0 -927
  280. package/dist/plugin/vault.d.cts +0 -68
  281. package/dist/plugin/vault.d.ts +0 -68
  282. package/dist/plugin/vault.js +0 -22
  283. package/dist/types-Y2_Um2Ls.d.cts +0 -205
  284. package/templates/memory-event.md +0 -67
  285. package/templates/party.md +0 -63
  286. package/templates/primitive-registry.yaml +0 -551
  287. package/templates/run.md +0 -68
  288. package/templates/trigger.md +0 -68
  289. package/templates/workspace.md +0 -50
@@ -1,294 +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/compat.ts
31
- var compat_exports = {};
32
- __export(compat_exports, {
33
- checkOpenClawCompatibility: () => checkOpenClawCompatibility,
34
- compatCommand: () => compatCommand,
35
- compatibilityExitCode: () => compatibilityExitCode
36
- });
37
- module.exports = __toCommonJS(compat_exports);
38
- var fs = __toESM(require("fs"), 1);
39
- var path = __toESM(require("path"), 1);
40
- var import_gray_matter = __toESM(require("gray-matter"), 1);
41
- var import_child_process = require("child_process");
42
- var import_url = require("url");
43
- var import_meta = {};
44
- function readOptionalFile(filePath) {
45
- try {
46
- if (!fs.existsSync(filePath)) return null;
47
- return fs.readFileSync(filePath, "utf-8");
48
- } catch {
49
- return null;
50
- }
51
- }
52
- function findPackageRoot() {
53
- let dir = path.dirname((0, import_url.fileURLToPath)(import_meta.url));
54
- while (dir !== path.dirname(dir)) {
55
- if (fs.existsSync(path.join(dir, "package.json"))) {
56
- return dir;
57
- }
58
- dir = path.dirname(dir);
59
- }
60
- return path.dirname((0, import_url.fileURLToPath)(import_meta.url));
61
- }
62
- function resolveProjectFile(relativePath, baseDir) {
63
- if (baseDir) {
64
- return path.resolve(baseDir, relativePath);
65
- }
66
- const fromCwd = path.resolve(process.cwd(), relativePath);
67
- if (fs.existsSync(fromCwd)) {
68
- return fromCwd;
69
- }
70
- return path.resolve(findPackageRoot(), relativePath);
71
- }
72
- function checkOpenClawCli() {
73
- const result = (0, import_child_process.spawnSync)("openclaw", ["--version"], { stdio: "ignore" });
74
- if (result.error) {
75
- return {
76
- label: "openclaw CLI available",
77
- status: "warn",
78
- detail: "openclaw binary not found",
79
- hint: "Install OpenClaw CLI to enable plugin runtime validation."
80
- };
81
- }
82
- if (typeof result.status === "number" && result.status !== 0) {
83
- return {
84
- label: "openclaw CLI available",
85
- status: "warn",
86
- detail: `openclaw --version exited with code ${result.status}`,
87
- hint: "Ensure OpenClaw CLI is installed and runnable in PATH."
88
- };
89
- }
90
- if (typeof result.signal === "string" && result.signal.length > 0) {
91
- return {
92
- label: "openclaw CLI available",
93
- status: "warn",
94
- detail: `openclaw --version terminated by signal ${result.signal}`,
95
- hint: "Ensure OpenClaw CLI can execute normally in PATH."
96
- };
97
- }
98
- return { label: "openclaw CLI available", status: "ok" };
99
- }
100
- function checkPluginManifest(options) {
101
- const manifestRaw = readOptionalFile(
102
- resolveProjectFile("openclaw.plugin.json", options.baseDir)
103
- );
104
- if (!manifestRaw) {
105
- return {
106
- label: "plugin manifest",
107
- status: "error",
108
- detail: "openclaw.plugin.json not found",
109
- hint: "Create openclaw.plugin.json with id, kind, and configSchema fields."
110
- };
111
- }
112
- try {
113
- const manifest = JSON.parse(manifestRaw);
114
- const issues = [];
115
- if (!manifest.id) issues.push("missing id");
116
- if (!manifest.kind) issues.push("missing kind");
117
- if (!manifest.configSchema) issues.push("missing configSchema");
118
- if (issues.length > 0) {
119
- return {
120
- label: "plugin manifest",
121
- status: "error",
122
- detail: issues.join(", ")
123
- };
124
- }
125
- return {
126
- label: "plugin manifest",
127
- status: "ok",
128
- detail: `id=${manifest.id} kind=${manifest.kind}`
129
- };
130
- } catch (err) {
131
- return {
132
- label: "plugin manifest",
133
- status: "error",
134
- detail: err?.message || "Unable to parse openclaw.plugin.json"
135
- };
136
- }
137
- }
138
- function checkPluginExtensions(options) {
139
- let packageRaw = readOptionalFile(
140
- resolveProjectFile("package.json", options.baseDir)
141
- );
142
- if (packageRaw && !options.baseDir) {
143
- try {
144
- const parsed = JSON.parse(packageRaw);
145
- if (!parsed.openclaw?.extensions) {
146
- const fallbackPath = path.resolve(findPackageRoot(), "package.json");
147
- const fallbackRaw = readOptionalFile(fallbackPath);
148
- if (fallbackRaw) packageRaw = fallbackRaw;
149
- }
150
- } catch {
151
- }
152
- }
153
- if (!packageRaw) {
154
- return {
155
- label: "plugin extensions registration",
156
- status: "error",
157
- detail: "package.json not found"
158
- };
159
- }
160
- try {
161
- const parsed = JSON.parse(packageRaw);
162
- const extensions = parsed.openclaw?.extensions ?? [];
163
- if (extensions.length === 0) {
164
- return {
165
- label: "plugin extensions registration",
166
- status: "error",
167
- detail: "Missing openclaw.extensions in package.json",
168
- hint: 'Add openclaw.extensions: ["./dist/plugin/index.js"] to package.json.'
169
- };
170
- }
171
- const baseDir = options.baseDir || findPackageRoot();
172
- const missing = extensions.filter(
173
- (ext) => !fs.existsSync(path.resolve(baseDir, ext))
174
- );
175
- if (missing.length > 0) {
176
- return {
177
- label: "plugin extensions registration",
178
- status: "error",
179
- detail: `Entry file(s) not found: ${missing.join(", ")}`,
180
- hint: "Run npm run build to generate dist files."
181
- };
182
- }
183
- return {
184
- label: "plugin extensions registration",
185
- status: "ok",
186
- detail: extensions.join(", ")
187
- };
188
- } catch (err) {
189
- return {
190
- label: "plugin extensions registration",
191
- status: "error",
192
- detail: err?.message || "Unable to parse package.json"
193
- };
194
- }
195
- }
196
- function checkSkillMetadata(options) {
197
- const skillRaw = readOptionalFile(
198
- resolveProjectFile("SKILL.md", options.baseDir)
199
- );
200
- if (!skillRaw) {
201
- return {
202
- label: "skill metadata",
203
- status: "warn",
204
- detail: "SKILL.md not found",
205
- hint: "Ensure SKILL.md is present for OpenClaw skill distribution."
206
- };
207
- }
208
- let hasOpenClawMetadata = false;
209
- let parseError;
210
- try {
211
- const parsed = (0, import_gray_matter.default)(skillRaw);
212
- const frontmatter = parsed.data ?? {};
213
- const metadata = frontmatter.metadata && typeof frontmatter.metadata === "object" && !Array.isArray(frontmatter.metadata) ? frontmatter.metadata : void 0;
214
- hasOpenClawMetadata = Boolean(
215
- metadata && typeof metadata.openclaw === "object" && metadata.openclaw !== null || typeof frontmatter.openclaw === "object" && frontmatter.openclaw !== null
216
- );
217
- } catch {
218
- parseError = "Unable to parse SKILL.md frontmatter";
219
- hasOpenClawMetadata = false;
220
- }
221
- if (!hasOpenClawMetadata) {
222
- hasOpenClawMetadata = /"openclaw"\s*:/.test(skillRaw);
223
- }
224
- if (!hasOpenClawMetadata) {
225
- const detail = parseError ? `${parseError} (or missing metadata.openclaw)` : "Missing metadata.openclaw in SKILL.md";
226
- return {
227
- label: "skill metadata",
228
- status: "warn",
229
- detail,
230
- hint: "Add metadata.openclaw to SKILL.md frontmatter for OpenClaw compatibility."
231
- };
232
- }
233
- return { label: "skill metadata", status: "ok" };
234
- }
235
- function checkOpenClawCompatibility(options = {}) {
236
- const checks = [
237
- checkOpenClawCli(),
238
- checkPluginManifest(options),
239
- checkPluginExtensions(options),
240
- checkSkillMetadata(options)
241
- ];
242
- const warnings = checks.filter((check) => check.status === "warn").length;
243
- const errors = checks.filter((check) => check.status === "error").length;
244
- return {
245
- generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
246
- checks,
247
- warnings,
248
- errors
249
- };
250
- }
251
- function formatCompatibilityReport(report) {
252
- const lines = [];
253
- lines.push("OpenClaw Compatibility Report");
254
- lines.push("-".repeat(34));
255
- lines.push(`Generated: ${report.generatedAt}`);
256
- lines.push("");
257
- for (const check of report.checks) {
258
- const prefix = check.status === "ok" ? "\u2713" : check.status === "warn" ? "\u26A0" : "\u2717";
259
- lines.push(
260
- `${prefix} ${check.label}${check.detail ? ` \u2014 ${check.detail}` : ""}`
261
- );
262
- if (check.hint) {
263
- lines.push(` ${check.hint}`);
264
- }
265
- }
266
- lines.push("");
267
- lines.push(`Warnings: ${report.warnings}`);
268
- lines.push(`Errors: ${report.errors}`);
269
- return lines.join("\n");
270
- }
271
- function compatibilityExitCode(report, options = {}) {
272
- if (report.errors > 0) {
273
- return 1;
274
- }
275
- if (options.strict && report.warnings > 0) {
276
- return 1;
277
- }
278
- return 0;
279
- }
280
- async function compatCommand(options = {}) {
281
- const report = checkOpenClawCompatibility({ baseDir: options.baseDir });
282
- if (options.json) {
283
- console.log(JSON.stringify(report, null, 2));
284
- } else {
285
- console.log(formatCompatibilityReport(report));
286
- }
287
- return report;
288
- }
289
- // Annotate the CommonJS export names for ESM import in node:
290
- 0 && (module.exports = {
291
- checkOpenClawCompatibility,
292
- compatCommand,
293
- compatibilityExitCode
294
- });
@@ -1,28 +0,0 @@
1
- type CompatStatus = 'ok' | 'warn' | 'error';
2
- interface CompatCheck {
3
- label: string;
4
- status: CompatStatus;
5
- detail?: string;
6
- hint?: string;
7
- }
8
- interface CompatReport {
9
- generatedAt: string;
10
- checks: CompatCheck[];
11
- warnings: number;
12
- errors: number;
13
- }
14
- interface CompatOptions {
15
- baseDir?: string;
16
- }
17
- interface CompatCommandOptions {
18
- json?: boolean;
19
- strict?: boolean;
20
- baseDir?: string;
21
- }
22
- declare function checkOpenClawCompatibility(options?: CompatOptions): CompatReport;
23
- declare function compatibilityExitCode(report: CompatReport, options?: {
24
- strict?: boolean;
25
- }): number;
26
- declare function compatCommand(options?: CompatCommandOptions): Promise<CompatReport>;
27
-
28
- export { type CompatCheck, type CompatCommandOptions, type CompatReport, type CompatStatus, checkOpenClawCompatibility, compatCommand, compatibilityExitCode };