Skip to content

feat: HQ World Protocol — inter-HQ federation layer#5

Open
johnsonfamily1234 wants to merge 11 commits intomainfrom
feature/hq-world
Open

feat: HQ World Protocol — inter-HQ federation layer#5
johnsonfamily1234 wants to merge 11 commits intomainfrom
feature/hq-world

Conversation

@johnsonfamily1234
Copy link

Summary

  • World Protocol — P2P federation layer for HQ instances to discover, connect, and trade knowledge/worker patterns
  • Human-gated peering — no auto-discovery, every connection requires explicit operator approval on both sides
  • Transport-agnostic transfers — file-based MVP with SHA-256 integrity verification, designed for future git/HTTP/HIAMP transports
  • TypeScript implementation at packages/hq-world/ with 50 passing tests
  • Protocol specs (~5k lines) at knowledge/hq-world/ covering identity, manifests, peering ceremony, transfer protocol, configuration, and central directory design
  • World skill at workers/shared/skills/world.md — peers, capabilities, export, import, connect

Test plan

  • 50 unit + E2E tests passing (cd packages/hq-world && npx vitest run)
  • TypeScript compiles clean (tsc --noEmit)
  • E2E validates full lifecycle: peering ceremony → capability discovery → knowledge transfer → worker pattern sharing
  • Manual review of protocol spec documents

🤖 Generated with Claude Code

johnsonfamily1234 and others added 11 commits February 16, 2026 12:39
…fetch

- deps.ts: detect OS (macOS/Windows/Linux), check for brew/winget/choco,
  offer to install missing deps instead of just showing hints
- scaffold.ts: fetch latest template from GitHub, fall back to bundled
- Correct npm scope to @indigoai-us/hq-cli
- Full cloud setup flow (Clerk auth, upload, Claude token)
- Bump to 5.1.0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
`import * as fs` doesn't work with fs-extra in ESM — existsSync
and other methods are on the default export.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
No argument → asks "Where do you want to install HQ?" with
C:\hq on Windows, ~/hq on macOS/Linux. Explicit arg skips prompt.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
HQ Cloud API doesn't exist yet — replace interactive auth/upload
flow with a "coming soon" notice. Cloud setup code preserved in
git history for when the API is deployed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
git init is fine but committing fails when git user isn't configured.
The user can commit when they're ready.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The installed HQ is the user's personal directory, not a repo.
Updates come through hq modules sync or /migrate, not git.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
qmd is essential for HQ search. Install via npm install -g @tobilu/qmd
on all platforms. Fixed detection (qmd has no --version flag, use
which/where instead).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
… and worker exchange

P2P registry, human-gated peering ceremony, transport-agnostic transfer protocol
with SHA-256 integrity verification. Includes TypeScript implementation (50 tests),
protocol specs, and world skill for workers.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Added new dependencies for @indigoai/hq-world and @types/chai.
- Updated devOptional flags to dev for several packages.
- Included multiple @vitest packages for testing utilities.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant