@knowzai/cli 0.1.0 → 0.2.0

package/assets/portable/.env.example

@@ -63,6 +63,9 @@ ADMIN_USERNAME=admin@knowz.local
 ADMIN_PASSWORD=<CHANGE_ME_at_least_12_chars_mixed>
 # SuperAdmin console passphrase. Generate with `openssl rand -base64 32` (or equivalent).
 # SUPERADMIN_PASSPHRASE=
+# Optional override for privileged diagnostics (X-Super-User-Key). When unset, compose
+# reuses SUPERADMIN_PASSPHRASE. Empty/whitespace values are rejected by the API (503).
+# SUPERUSER_KEY=
 # Manual Compose bootstrap (run once after the API is healthy):
 # curl -X POST http://localhost:${API_PORT:-5000}/api/v1/bootstrap/admin \
 #   -H "X-Super-User-Key: $SUPERADMIN_PASSPHRASE" -H "Content-Type: application/json" \

package/assets/portable/docker-compose.yml

@@ -104,6 +104,10 @@ services:
   api:
     # Prebuilt portable image. ""=azure/stub/BYO-OpenAI-compat build; KNOWZ_FLAVOR=-gcp => Vertex build.
     image: "${KNOWZ_REGISTRY:-ghcr.io/knowz-io}/knowz-api:${KNOWZ_VERSION:?KNOWZ_VERSION must be set in .env (the platform release, e.g. 0.2.0)}-portable${KNOWZ_FLAVOR:-}"
+    # Knowz portable images publish linux/amd64 ONLY — pin so arm64 hosts (Apple Silicon)
+    # pull and run under emulation instead of failing with "no matching manifest".
+    # No-op on amd64 hosts. Remove when OPS_PortableMultiArchImages ships arm64 manifests.
+    platform: linux/amd64
     ports:
       - "${BIND_ADDRESS:-127.0.0.1}:${API_PORT:-5000}:8080"
     depends_on:
@@ -122,6 +126,7 @@ services:
     environment:
       ASPNETCORE_ENVIRONMENT: Staging
       ASPNETCORE_URLS: http://+:8080
+      FeatureFlags__registration__requireEmailVerification: "false"
 
       # ── Portable substrate provider switches (the three subsystem axes) ──────────────────────────
       Knowz__Database__Provider: Postgres
@@ -168,6 +173,11 @@ services:
       JwtSettings__Secret: "${JWT_SECRET}"
       Authentication__Jwt__Secret: "${JWT_SECRET}"
       SuperAdmin__Passphrase: "${SUPERADMIN_PASSPHRASE:?SUPERADMIN_PASSPHRASE must be set in .env}"
+      # SEC-2026-08-16-3 / #509: privileged diagnostics use Security:SuperUserKey.
+      # Application code fail-closes empty/whitespace keys (503). Compose still injects a
+      # non-empty value so portable kits that already mint SUPERADMIN_PASSPHRASE keep a
+      # working gate; SUPERUSER_KEY overrides when set.
+      Security__SuperUserKey: "${SUPERUSER_KEY:-${SUPERADMIN_PASSPHRASE}}"
 
       # ── MCP service-to-service key (must match the mcp container) ────────────────────────────────
       MCP__ServiceKey: "${MCP_SERVICE_KEY:?MCP_SERVICE_KEY must be set in .env}"
@@ -260,6 +270,8 @@ services:
   # ── Worker: Knowz.Worker BackgroundService — drains PortableQueueJobs + enrichment auto-driver ─────
   worker:
     image: "${KNOWZ_REGISTRY:-ghcr.io/knowz-io}/knowz-worker:${KNOWZ_VERSION:?KNOWZ_VERSION must be set in .env (the platform release, e.g. 0.2.0)}-portable${KNOWZ_FLAVOR:-}"
+    # amd64-only image — see the `api` service note (OPS_PortableMultiArchImages).
+    platform: linux/amd64
     depends_on:
       postgres:
         condition: service_healthy
@@ -371,6 +383,8 @@ services:
   web:
     # Cloud-neutral SPA — plain versioned image (no portable/gcp flavor).
     image: "${KNOWZ_REGISTRY:-ghcr.io/knowz-io}/knowz-web:${KNOWZ_VERSION:?KNOWZ_VERSION must be set in .env (the platform release, e.g. 0.2.0)}"
+    # amd64-only image — see the `api` service note (OPS_PortableMultiArchImages).
+    platform: linux/amd64
     ports:
       - "${BIND_ADDRESS:-127.0.0.1}:${WEB_PORT:-3000}:8080"
     depends_on:
@@ -393,6 +407,8 @@ services:
     profiles: ["mcp"]
     # Cloud-neutral MCP server — plain versioned image (no portable/gcp flavor).
     image: "${KNOWZ_REGISTRY:-ghcr.io/knowz-io}/knowz-mcp:${KNOWZ_VERSION:?KNOWZ_VERSION must be set in .env (the platform release, e.g. 0.2.0)}"
+    # amd64-only image — see the `api` service note (OPS_PortableMultiArchImages).
+    platform: linux/amd64
     ports:
       - "${BIND_ADDRESS:-127.0.0.1}:${MCP_PORT:-3001}:8080"
     depends_on:
@@ -418,6 +434,8 @@ services:
 
   public-site:
     image: "${KNOWZ_REGISTRY:-ghcr.io/knowz-io}/knowz-public-site:${KNOWZ_VERSION:?KNOWZ_VERSION must be set in .env}"
+    # amd64-only image — see the `api` service note (OPS_PortableMultiArchImages).
+    platform: linux/amd64
     profiles: ["public-site"]
     ports:
       - "${BIND_ADDRESS:-127.0.0.1}:${PUBLIC_SITE_PORT:-3002}:8080"

package/assets/portable/releases.json

@@ -1,5 +1,27 @@
 {
   "releases": [
+    {
+      "version": "0.41.0",
+      "flavors": [
+        "portable",
+        "portable-gcp"
+      ],
+      "releasedAt": "2026-08-31T00:00:00Z",
+      "minCliVersion": null,
+      "notes": null,
+      "digests": null
+    },
+    {
+      "version": "0.40.2",
+      "flavors": [
+        "portable",
+        "portable-gcp"
+      ],
+      "releasedAt": "2026-08-30T00:00:00Z",
+      "minCliVersion": null,
+      "notes": null,
+      "digests": null
+    },
     {
       "version": "0.35.2",
       "flavors": [