Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,10 @@ the upstream did not design for:
bridge output coalescing, GSD. OpenCode is the default agent.
- **Every phone event is signed by the identity key** (commands, grants,
NIP-42 AUTH, Blossom auth). Session keys only key NIP-44 payloads; they
never sign.
never sign. The one other signer is a browser on the web page: its
commands are signed by a key of its own, which an identity-signed
`web-sign-in` let in, and it may send only what
`bridge_core::browser_may_send` names (`docs/WEB-CLIENT.md`).
- **No migrations.** A breaking change to persisted or wire data is reshaped
directly, old data skipped tolerantly on load, and the PR says so.

Expand Down Expand Up @@ -111,7 +114,8 @@ crates kept apart).
./codedeck typecheck # typecheck / clippy only
./codedeck test # tests only
./codedeck e2e # the ignored tests that drive a built agent host
# from Rust: driver protocol, bridge end to end
# from Rust: driver protocol, bridge end to end,
# a browser on the web page
./codedeck ci [PR] # the pull request's checks, and the end of the log
# of each failed one (--watch waits for them)

Expand Down Expand Up @@ -150,8 +154,8 @@ Narrower loops run in the dev container, which keeps its node_modules and the
caches between commands: `./codedeck dev cargo test -p <crate>`,
`./codedeck dev vitest run <file>` (the agent host's own tests). Tests marked
`#[ignore]` need Node and a built agent host; `./codedeck e2e` builds the
bundle and runs the two CI runs (the driver-protocol spawn test and the
bridge end-to-end test). Before a release, the acceptance test runs the real
bundle and runs the two CI runs (the driver-protocol spawn test, and the
bridge end-to-end tests: a phone, and a browser on the web page). Before a release, the acceptance test runs the real
phone core against a throwaway bridge with the real OpenCode (MCP changes
across restarts, a free model's session resumed across a restart):
`./codedeck dev sh -c 'CODEDECK_AGENT_CACHE=/agents cargo test -p bridge-runtime --test acceptance -- --ignored --test-threads 1'`.
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -207,7 +207,7 @@ jobs:
pnpm install --frozen-lockfile
pnpm --filter @codedeck/agent-host run build
cargo test --locked -p agent-protocol --test agent_host -- --ignored
cargo test --locked -p bridge-runtime --test e2e -- --ignored
cargo test --locked -p bridge-runtime --test e2e --test web_page -- --ignored

# The bridge on Windows — what the Windows release archive ships: the crates
# the binary is built from, the agent host's tests and bundle, and the same
Expand Down Expand Up @@ -257,7 +257,7 @@ jobs:
run: |
cargo test --locked -p protocol -p agent-protocol -p nostr-transport -p bridge-core -p bridge-runtime
cargo test --locked -p agent-protocol --test agent_host -- --ignored
cargo test --locked -p bridge-runtime --test e2e -- --ignored
cargo test --locked -p bridge-runtime --test e2e --test web_page -- --ignored

# apps/android: Gradle unit tests + Paparazzi screenshot verification
# + the UniFFI Kotlin bindings drift check. The crates it watches are
Expand Down
168 changes: 168 additions & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,8 +54,9 @@ Pairing is a one-time QR scan; it survives restarts on both ends.
- NIP-42 `AUTH` relays, and Tor on both ends (see below)
- A direct link on your LAN or VPN: the phone talks to the bridge over its
own WebSocket, with the relays as the fallback
- A web page on the same port: the bridge's dashboard in a browser, signed in
from a paired phone instead of a password
- A web page on the same port: drive the sessions from a browser, signed in
from a paired phone instead of a password, every command signed by a key
the browser cannot hand out
([`docs/BRIDGE.md`](docs/BRIDGE.md#web-page))

## About this fork
Expand Down Expand Up @@ -249,6 +250,7 @@ the full runbook.
- [`docs/DEEPSEEK.md`](docs/DEEPSEEK.md) — the DeepSeek Harness: API key, models and reasoning, gateways, MCP servers and plugins
- [`docs/QWEN.md`](docs/QWEN.md) — Qwen Code: install, OpenAI-compatible providers, its home, modes, MCP servers and extensions
- [`docs/PI.md`](docs/PI.md) — Pi: install, accounts and providers, its home, the permission gate and its tiers, MCP servers and packages
- [`docs/WEB-CLIENT.md`](docs/WEB-CLIENT.md) — the bridge's web page as a client: the browser's signing key, its stream, what it may send, the threat model
- [`docs/AGENT-CANDIDATES.md`](docs/AGENT-CANDIDATES.md) — which agents to add next and how
- [`.claude/skills/cut-release/SKILL.md`](.claude/skills/cut-release/SKILL.md) — the release runbook

Expand Down
Loading
Loading