[lilyshen0722]

L0 of the v4 build (spec §2–§3, board TASK-633). Every lane builds against what this lands.

What changed

• schema/: seven JSON Schema files, drafted by the SWE session. They're the only definition of a wire shape: messages and receipts, socket events, the pod API, tokens and the six MCP tools.
• scripts/gen.mjs (Bun, no dependencies) generates:
  • gen/ts/protocol.ts: types, enum value lists, the typed event union, and ToolIO;
  • gen/ts/schemas.json: one bundle for ajv in the Worker;
  • gen/ts/tools.json: MCP tool definitions with refs inlined;
  • daemon/internal/protocol/gen.go: structs, enums, required-key checks, Registry and DecodeEventData.
  • It refuses oneOf/anyOf/allOf/if/not and inline objects, and fails if x-variants and EventType differ.
• schema/fixtures/: 71 fixtures. Each message kind has three agent posts and three stored messages, plus a human post. Every event type has an envelope. Invalid cases cover a missing summary, an over-long summary, a newline in the summary, a client-sent receipt, a bad option id, needs with both targets, an http link, a v2 envelope and missing required keys.
• Makefile: gen, check-gen, test, preflight. AGENTS.md is one page, with CLAUDE.md as a symlink to it.
• CI: gen-drift now runs make check-gen and make test-ts. The go job runs make test-go. Bun 1.4.4 and Go come from the setup actions. e2e-preview accepts wrangler.jsonc as well as wrangler.toml.

Done-test (spec §3 L0)

• make gen is idempotent: a second run leaves the tree clean.
• Drift: check-gen fails when schema/ changes without a regenerate, and when gen/ is edited by hand or has untracked files.
• Fixtures: ajv passes all 71. go test -race round-trips every valid fixture to identical JSON and rejects every invalid-required-* one.
• Mutation check: I deleted summary from one valid message, and both the ajv check and the Go test failed, naming that fixture.
• make preflight is green locally on Go 1.27.3 and Bun 1.4.4.

Protected paths (schema/**, .github/workflows/**): this needs one Opus GATE: PASS at the PR head.

Retro: main's husky pre-commit hook fires inside v4 worktrees, and with no lint-staged config on v4 it aborts the commit. Commit with git -c core.hooksPath=/dev/null until v4 has its own hook (§8.3 make setup).

🤖 Generated with Claude Code

https://claude.ai/code/session_01MDs9DS3E4dzoHKdxtgQqyz

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: 1ea8328b-9558-4655-a166-8f50c64177e4

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

_{Comment @coderabbitai help to get the list of available commands.}

[lilyshen0722]

Moved to Team-Commonly/jellymoon#1 (v4 now lives in its own private repo, D187). The v4 branch stays until the new repo's CI is green.