Files
Shade/packages/shade-cli/src/commands/peer.ts
Sterister 518dc68c4f
Some checks failed
Test / test (push) Has been cancelled
feat(cli): M-Tool 1-3 — CLI, templates, Gitea publishing pipeline
Phase B complete: Shade now has a full developer tooling story.

@shade/cli
- shade init with project scaffolding from templates
- shade fingerprint (own or peer)
- shade publish (re-upload bundle)
- shade rotate (--identity for full rotation, otherwise signed prekey)
- shade peer add/list/verify/remove
- shade dashboard (opens observer in browser)
- shade doctor (diagnose config, storage, prekey server reachability)
- Config from .shaderc.json or SHADE_* env vars

Templates (in packages/shade-cli/templates/)
- bun-server — Bun + Hono backend with /send + /receive endpoints
- chat-demo — Two-process Alice/Bob chat over HTTP

Publishing pipeline (Gitea npm registry)
- .gitea/workflows/test.yml — CI on push/PR with PostgreSQL service
- .gitea/workflows/publish.yml — publish on git tag v*
- scripts/publish-all.ts — local publish helper with DRY_RUN support
- scripts/bump-version.ts — lockstep version bump across all packages
- Root package.json scripts: version, publish:dry, publish:all

Also: /health endpoint now lives in createPrekeyRoutes so doctor can
probe it without needing the full standalone setup.

Dry-run verified: all 11 packages pack cleanly.
246 tests passing, 0 failures.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 00:38:00 +02:00

80 lines
2.6 KiB
TypeScript

import { createShade } from '@shade/sdk';
import { loadConfig } from '../config.js';
export async function peerAddCommand(address: string): Promise<void> {
const config = loadConfig();
const shade = await createShade({
prekeyServer: config.prekeyServer,
storage: config.storage,
address: config.address,
autoReplenish: false,
});
try {
// Fetching and establishing happens on first send; we fake-send by
// calling the manager directly.
const transport = shade.getTransport();
const bundle = await transport.fetchBundle(address);
await shade.getManager().initSessionFromBundle(address, bundle);
const fp = await shade.getFingerprintFor(address);
console.log(`\x1b[32m✓\x1b[0m Session established with ${address}`);
console.log(` Fingerprint: ${fp}`);
console.log();
console.log('Verify this fingerprint with the peer out-of-band before exchanging sensitive messages.');
} finally {
await shade.shutdown();
}
}
export async function peerListCommand(): Promise<void> {
const config = loadConfig();
// For list, we need to enumerate sessions from storage. The StorageProvider
// doesn't currently expose a "list all sessions" method. For v1, we show
// a message and suggest the dashboard.
console.log('\x1b[33mNote:\x1b[0m CLI session enumeration not yet implemented.');
console.log('Run `shade dashboard` for a live session list.');
}
export async function peerVerifyCommand(address: string, fingerprint: string): Promise<void> {
const config = loadConfig();
const shade = await createShade({
prekeyServer: config.prekeyServer,
storage: config.storage,
address: config.address,
autoReplenish: false,
});
try {
const match = await shade.verify(address, fingerprint);
if (match) {
console.log(`\x1b[32m✓\x1b[0m Fingerprint matches session with ${address}`);
} else {
const actual = await shade.getFingerprintFor(address);
console.log(`\x1b[31m✗\x1b[0m Fingerprint does NOT match`);
console.log(` Expected: ${fingerprint}`);
console.log(` Actual: ${actual}`);
process.exitCode = 1;
}
} finally {
await shade.shutdown();
}
}
export async function peerRemoveCommand(address: string): Promise<void> {
const config = loadConfig();
const shade = await createShade({
prekeyServer: config.prekeyServer,
storage: config.storage,
address: config.address,
autoReplenish: false,
});
try {
await shade.getManager().resetSession(address);
console.log(`\x1b[32m✓\x1b[0m Session with ${address} removed`);
} finally {
await shade.shutdown();
}
}