Files
bot-hub/docs/manual-testing.md
zeekay 214621b6ca Serve the hub at api.hanzo.ai/v1/skills
Every route mounts under /v1/skills, the address api.hanzo.ai routes to
this API; auth, personas, users, tokens, upload, integrations, search and
whoami are sub-resources and RESERVED keeps them from being slugs. The
web, the OG renderers, the CLI's default registry, /.well-known/bothub.json
and openapi.json name api.hanzo.ai. Sign-in calls back to
api.hanzo.ai/v1/skills/auth/callback and hands the token over in the
fragment.

The store starts again. docker-entrypoint.sh read Base's port from
BASE_PORT, which Kubernetes sets to tcp://<ip>:<port> in a namespace
holding a Service named base; Base now listens on 127.0.0.1:8090, fixed.
The collections migration is rewritten for the Base the Dockerfile pins
(1.5.91): flat field options, declared created/updated, and the users
collection every Base already has, extended rather than created twice.

Reads are anonymous against public rules, since Base takes IAM
credentials only and no longer serves password sign-in; writes answer
503 saying so. The catalogue migration, generated by scripts/catalog.mjs,
publishes the 83 skills in hanzoai/bot@8be8f1dc7b. /health reports the
store, so the probes restart a pod whose Base is gone.

cache.ts decides caching once: an anonymous 2xx GET is public for a
minute (five at the edge) with a weak ETag and 304s; a credential, a
write or an error is private, no-store. Filter values go through lit().
Embeddings go through api.hanzo.ai and are skipped without a key.

k8s/ was a second declaration of the deployment; universe is the one.
2026-09-30 01:10:48 -07:00

1.6 KiB

summary, read_when
summary read_when
Copy/paste CLI smoke checklist for local verification.
Pre-merge validation
Reproducing a reported CLI bug

Manual testing (CLI)

Setup

  • Ensure logged in: bun bothub whoami (or bun bothub login).
  • Optional: set env
    • BOTHUB_SITE=https://hub.hanzo.bot
    • BOTHUB_REGISTRY=https://api.hanzo.ai

Smoke

  • bun bothub --help
  • bun bothub --cli-version
  • bun bothub whoami
  • bun bothub search gif --limit 5

Install / list / update

  • mkdir -p /tmp/bothub-manual && cd /tmp/bothub-manual
  • bunx bothub@beta install gifgrep --force
  • bunx bothub@beta list
  • bunx bothub@beta update gifgrep --force

Publish (changelog optional)

  • mkdir -p /tmp/bothub-skill-demo/SKILL && cd /tmp/bothub-skill-demo
  • Create files:
    • SKILL.md
    • notes.md
  • Publish:
    • bun bothub publish . --slug bothub-manual-<ts> --name "Manual <ts>" --version 1.0.0 --tags latest
  • Publish update with empty changelog:
    • bun bothub publish . --slug bothub-manual-<ts> --name "Manual <ts>" --version 1.0.1 --tags latest

Delete / undelete (owner/admin)

  • bun bothub delete bothub-manual-<ts> --yes
  • Verify hidden:
  • curl -i "https://api.hanzo.ai/v1/skills/bothub-manual-<ts>"
  • Restore:
    • bun bothub undelete bothub-manual-<ts> --yes
  • Cleanup:
    • bun bothub delete bothub-manual-<ts> --yes

Sync

  • bun bothub sync --dry-run --all

Playwright (menu smoke)

Run against prod:

PLAYWRIGHT_BASE_URL=https://hub.hanzo.bot bun run test:pw

Run against a local preview server:

bun run test:e2e:local