@knolo/cli 5.2.3 → 5.5.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.
- package/README.md +24 -2
- package/bin/knolo.mjs +804 -157
- package/package.json +2 -2
- package/templates/icp-knowledge-canister/canisters/knolo-core-rust/Cargo.toml +1 -1
- package/templates/icp-knowledge-canister/canisters/knolo-core-rust/src/lib.rs +294 -3
- package/templates/icp-knowledge-canister/canisters/knolo-icp-canister/Cargo.lock +2 -2
- package/templates/icp-knowledge-canister/canisters/knolo-icp-canister/Cargo.toml +2 -2
package/README.md
CHANGED
|
@@ -1,10 +1,16 @@
|
|
|
1
1
|
# @knolo/cli
|
|
2
2
|
|
|
3
|
-
The CLI preserves the Knolo V4 pack workflow and adds
|
|
4
|
-
Image inspection. Normal builds emit V4; the ICP legacy build path explicitly
|
|
3
|
+
The CLI preserves the Knolo V4 pack workflow and adds explicit V5 Knowledge
|
|
4
|
+
Image inspection and querying. Normal builds emit V4; the ICP legacy build path explicitly
|
|
5
5
|
emits V3 until the canister gains a V4 profile. V5 Studio output is a verified
|
|
6
6
|
management snapshot, not a mutation interface.
|
|
7
7
|
|
|
8
|
+
The CLI also exposes opt-in VQF-1 physical transcodes for V5 images. `v5
|
|
9
|
+
compress` supports the `fast`, `balanced`, and `max` profiles, while `v5
|
|
10
|
+
decompress` restores ordinary required segments. VQF preserves logical roots;
|
|
11
|
+
the format is still draft and compressed object/event images require a VQF-aware
|
|
12
|
+
reader.
|
|
13
|
+
|
|
8
14
|
The official CLI for building `.knolo` knowledge packs.
|
|
9
15
|
|
|
10
16
|
It indexes structured content and produces a deterministic, local-first knowledge bundle for use with `@knolo/core`.
|
|
@@ -128,6 +134,22 @@ knolo explain receipt.json --pack dist/knowledge.knolo
|
|
|
128
134
|
knolo diff old.knolo new.knolo
|
|
129
135
|
```
|
|
130
136
|
|
|
137
|
+
`knolo build` produces a V4 pack, so its natural-language query and receipt
|
|
138
|
+
contract applies to that artifact. V5 images are verified Knowledge Images and
|
|
139
|
+
use bounded EQL with roots-bound query results:
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
knolo query 'FROM chunk SEARCH "billing" LIMIT 5' \
|
|
143
|
+
--pack ./dist/knowledge.v5 --json --receipt ./query-result.json
|
|
144
|
+
knolo v5 query ./dist/knowledge.v5 \
|
|
145
|
+
'FROM chunk SEARCH "billing" LIMIT 5' --json
|
|
146
|
+
knolo explain ./query-result.json --pack ./dist/knowledge.v5
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
V5 images are never mounted through the V4 pack query API. Semantic sidecars
|
|
150
|
+
currently target V4 packs and are rejected for V5 images with a contract-specific
|
|
151
|
+
message.
|
|
152
|
+
|
|
131
153
|
V5 runtime diagnostics:
|
|
132
154
|
|
|
133
155
|
```bash
|