mirror of https://github.com/hanzoai/bot-hub.git synced 2026-10-30 18:46:42 +00:00

Files

T

zeekay cacc1f4d92 rebrand clawhub → bothub + add self-hosted API backend

Migration from Convex/Vercel to self-hosted infrastructure:

API Backend (api/):
- Hono server with PostgreSQL (Drizzle ORM) + pgvector
- Skills CRUD, search (hybrid vector + lexical), auth (hanzo.id OAuth)
- Upload (MinIO S3), stars, comments, API tokens
- Rate limiting middleware, session management

Frontend Adapter (src/lib/):
- api.ts: REST API client replacing Convex SDK
- hooks.ts: React hooks replacing convex/react useQuery/useMutation
- AuthContext.tsx: Auth provider replacing ConvexAuthProvider

Deployment:
- Dockerfile (multi-stage: API build + web build + production)
- K8s manifests for hub.hanzo.bot on hanzo-k8s
- GitHub Actions CI/CD (build → GHCR → deploy)

Rebrand:
- clawhub/clawdhub/ClawHub → bothub/Bot Hub
- Domain: clawhub.ai → hub.hanzo.bot
- CLI: clawhub → bothub
- Package: @hanzo/bot-hub-api

2026-02-16 19:36:19 -08:00

2.8 KiB

Raw Permalink Blame History

summary, read_when

summary

read_when

Skill version diffing mode (Monaco-backed)

Implementing skill diff UI

Adding version comparisons

Diffing mode

Goals

Compare any file between two versions.
Default compare: latest vs previous (SemVer precedence).
UX feels native to Bot Hub (theme + typography + motion).
Inline or side-by-side toggle.
Public access.

UX

Diff card on skill detail page.
Two selectors: Left/Right.
- Items: version strings, plus tags (e.g. latest), plus previous.
- Default: Left = previous, Right = latest.
File list with status: added / removed / changed / same.
- Default file: SKILL.md if present; else first changed file.
Toggle: Inline vs Side-by-side.
Show size guard message when file > 200KB.

SemVer ordering

Use SemVer precedence to sort versions.
previous = immediate predecessor of latest by SemVer.
If latest missing or only one version:
- Disable previous and show empty-state copy.

Data sources

Versions: api.skills.listVersions (all, not just latest 10).
Tags: skill.tags map.
File list: version.files with path, sha256, size.

API

Add action:

skills.getFileText({ versionId, path }) -> { text, size, sha256 }
- Validate version exists + file path exists in version.
- Enforce size <= 200KB (both in action and client).
- Use fetchText from convex/lib/skillPublish.ts.

Optional helper action:

skills.getVersionFiles({ versionId }) -> files[]
- If we want lightweight fetch without full version object.

Client flow

Fetch versions + tags.
Resolve default compare pair:
- Right = tag latest if present else highest SemVer.
- Left = previous (SemVer predecessor).
Build file union by path.
For selected file:
- Fetch left/right text (guard by size).
- Feed into Monaco diff editor.

Monaco theming

Define bothub-light / bothub-dark via monaco.editor.defineTheme.
Derive colors from CSS variables on document.documentElement:
- --surface, --surface-muted, --ink, --ink-soft, --line, --accent.
Apply theme on load + when theme changes (data-theme).
Match font: var(--font-mono).
Set diff options:
- renderSideBySide toggle
- diffAlgorithm: 'advanced'
- renderSideBySideInlineBreakpoint for mobile
- wordWrap: 'on'

Edge cases

File removed/added: show empty buffer on missing side + label.
Non-text file should not exist (upload rejects), but still guard.
Large file: show size warning + disable fetch.
Missing version: show error state.

Perf

Cache file text per version+path in client state.
Debounce selector changes (100-200ms).
Limit concurrent fetches to 2.

Tests

Unit: SemVer ordering + previous selection.
Component: default selectors, tag inclusion, size guard.

2.8 KiB Raw Permalink Blame History