@lacneu/openclaw-knowledge 3.1.0 → 3.1.2

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.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ### TODO — full migration to `kind: "context-engine"` (deferred)
11
+
12
+ The OpenClaw doctor classifies the current `before_prompt_build`-only
13
+ mode as `INFO — supported compatibility path, but has not migrated
14
+ to explicit capability registration yet`. A proper migration would
15
+ declare `kind: "context-engine"` in the manifest and use
16
+ `api.registerContextEngine("openclaw-knowledge", (ctx) => ({ info,
17
+ ingest, assemble, compact, ...optional }))` instead of the
18
+ `before_prompt_build` hook.
19
+
20
+ That migration is **deferred** until:
21
+
22
+ 1. A reference plugin with `kind: "context-engine"` becomes
23
+ available in the OpenClaw upstream `extensions/` folder (none as
24
+ of 2026-05-03 — only the in-process `legacy` engine exists).
25
+ 2. The `concepts/context-engine` page documents a complete migration
26
+ guide for hook-only plugins.
27
+
28
+ Until then, the hook approach is officially supported and works. We
29
+ take this 3.1.1 release to align activation/compat with 2026.5.0
30
+ without disturbing the working RAG path.
31
+
32
+ ## [3.1.2] - 2026-05-03
33
+
34
+ ### Added — `activation.onStartup: true`
35
+
36
+ Per the OpenClaw 2026.5.x manifest spec, plugins should declare an
37
+ explicit activation policy. `onStartup: true` ensures the plugin is
38
+ loaded at gateway boot so the `before_prompt_build` hook is wired
39
+ in time for the first turn after restart.
40
+
41
+ ### Changed — compat aligned to 2026.5.0
42
+
43
+ - `package.json#openclaw.compat`:
44
+ `pluginApi: ">=2026.3.7"` → `">=2026.5.0"`,
45
+ `minGatewayVersion: "2026.3.7"` → `"2026.5.0"`.
46
+ - `peerDependencies.openclaw` and `devDependencies.openclaw`:
47
+ `">=2026.3.7"` → `">=2026.5.0"`.
48
+
49
+ ### Migration
50
+
51
+ For instance owners on `@lacneu/openclaw-knowledge@3.1.0` or `3.1.1`:
52
+
53
+ 1. `openclaw plugins install @lacneu/openclaw-knowledge@3.1.2 --force`
54
+ 2. Restart the gateway container.
55
+ 3. Verify in the boot log:
56
+ `openclaw-knowledge: ready — sources: pgvector + LightRAG`.
57
+ 4. Verify with `openclaw plugins doctor` — the INFO note about
58
+ "hook-only" remains (expected; full `kind: "context-engine"`
59
+ migration is deferred).
60
+
61
+ ### Notes
62
+
63
+ - No code change in `src/`. No config schema change.
64
+ - 5/5 tests still pass.
65
+ - Operators on OpenClaw < 2026.5.0 must keep
66
+ `@lacneu/openclaw-knowledge@3.1.0`.
67
+
10
68
  ## [3.1.0] - 2026-04-10
11
69
 
12
70
  ### Changed
@@ -2,7 +2,10 @@
2
2
  "id": "openclaw-knowledge",
3
3
  "name": "Knowledge Base",
4
4
  "description": "Multi-source knowledge search (pgvector + LightRAG) — injects relevant documents and knowledge graph context before each turn via the before_prompt_build hook",
5
- "version": "3.1.0",
5
+ "version": "3.1.2",
6
+ "activation": {
7
+ "onStartup": true
8
+ },
6
9
  "configSchema": {
7
10
  "type": "object",
8
11
  "additionalProperties": false,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lacneu/openclaw-knowledge",
3
- "version": "3.1.0",
3
+ "version": "3.1.2",
4
4
  "type": "module",
5
5
  "description": "Multi-source knowledge plugin for OpenClaw — pgvector + LightRAG injection via before_prompt_build hook",
6
6
  "license": "MIT",
@@ -46,8 +46,8 @@
46
46
  "openclaw": {
47
47
  "extensions": ["./dist/index.js"],
48
48
  "compat": {
49
- "pluginApi": ">=2026.3.7",
50
- "minGatewayVersion": "2026.3.7"
49
+ "pluginApi": ">=2026.5.0",
50
+ "minGatewayVersion": "2026.5.0"
51
51
  }
52
52
  },
53
53
  "dependencies": {
@@ -56,11 +56,11 @@
56
56
  "devDependencies": {
57
57
  "@types/node": "^22.0.0",
58
58
  "@types/pg": "^8.11.0",
59
- "openclaw": ">=2026.3.7",
59
+ "openclaw": ">=2026.5.0",
60
60
  "typescript": "^5.6.0"
61
61
  },
62
62
  "peerDependencies": {
63
- "openclaw": ">=2026.3.7"
63
+ "openclaw": ">=2026.5.0"
64
64
  },
65
65
  "peerDependenciesMeta": {
66
66
  "openclaw": {