@knolo/cli 5.2.2 → 5.5.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.
package/README.md CHANGED
@@ -5,6 +5,12 @@ Image inspection. 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`.
@@ -57,28 +63,23 @@ knolo login --token kno_…
57
63
  # write requests use: Authorization: Bearer kno_…
58
64
  ```
59
65
 
60
- `knolo publish` uploads bytes with `@vercel/blob` to the public store, waits
61
- for verification, creates an attested draft, and releases it. Set
62
- `PACKS_READ_WRITE_TOKEN` from the production `knolo-hub` Vercel environment
63
- before publishing; do not substitute `BLOB_READ_WRITE_TOKEN`:
66
+ `knolo publish` asks Hub for a Blob PUT grant with the dashboard token, PUTs
67
+ bytes to that grant URL, then completes with the public pack URL from the PUT
68
+ response. A `kno_…` token is the only credential. Do not set
69
+ `PACKS_READ_WRITE_TOKEN` — that is Hub’s store secret, not a publisher token.
64
70
 
65
71
  ```bash
66
- cd /path/to/knolo-hub
67
- npx vercel env pull /tmp/knolo-env-prod --environment=production --yes
68
- export PACKS_READ_WRITE_TOKEN="$(awk -F= '$1 == "PACKS_READ_WRITE_TOKEN" {sub(/^[^=]*=/, ""); gsub(/^\"|\"$/, ""); print; exit}' /tmp/knolo-env-prod)"
69
-
72
+ knolo login --token kno_…
70
73
  knolo publish ./dist/knowledge.knolo \
71
74
  --slug refund-policy --version 1.2.0 --license Apache-2.0
72
75
  knolo yank acme/refund-policy@1.2.0
73
76
  ```
74
77
 
75
- The upload uses pathname `sha256/<64-lowercase-hex>.knolo`, public access,
76
- `addRandomSuffix: false`, `application/octet-stream`, and a one-year cache.
77
- Only public Blob URLs are accepted because Hub verification fetches the
78
- artifact itself. The CLI never sends the `kno_…` token to Blob, in a query
79
- string, cookie, or pack bytes. A 401 usually means the `Bearer` word is
80
- missing or the token was revoked; it does not mean the Hub write API requires
81
- a GitHub browser session.
78
+ The grant pathname is `sha256/<64-lowercase-hex>.knolo`. Only public Blob URLs
79
+ (`*.public.blob.vercel-storage.com`) are sent to `/api/upload/complete`. The
80
+ CLI never sends the `kno_…` token to Blob, in a query string, cookie, or pack
81
+ bytes. A 401 usually means the `Bearer` word is missing or the token was
82
+ revoked; it does not mean the Hub write API requires a GitHub browser session.
82
83
 
83
84
  The older `@knolo/cli@5.2.0` publish/yank command was an unimplemented stub;
84
85
  current versions use the live Hub HTTP sequence. For a direct smoke test of a