[leemour]

What

• docs/dev/ARCHITECTURE.md rewritten in whatsapp-cli's shape: what cli-core owns, the layers (with the biome.json rules that hold them, and the one direction no rule checks yet), history from Telegram's servers, the adapter (Feature, send/write, flood waits, proxy), connections, logging in, the test seams, what is on disk, what goes on the wire, and the standards it follows. Each fact was read from the code on origin/main (139062d). It no longer points at the untracked HANDOFF.md or at max-cli's architecture; the adapter-method path is written out on the page.
• No connection lock, by ruling. The page says every process opens its own main connection (owner's ruling NEED-600 A, docs/dev/session-sharing.md), that TELEGRAM does not set connection: "exclusive" and commands do not go through serve, that the only lock is cli-core's serve lock, and that AUTH_KEY_DUPLICATED is the signal that reopens the question. wa's device lock and serve relay are not copied.
• agent-os/standards/testing/adapter-fake-client.md cited adapter.ts:2027-2040 (the file has 625 lines) and gave no reason. It now describes the adapter tests as they are, by symbol: the real @mtcute/node with only TelegramClient replaced (FakeClient, SeededClient, StatsClient), the ./storage.js mock, cli-core's contractCases, plain-object fakes for feature functions, exported timing constants. Its Why says why tg fakes the client class while wa fakes its engine port: tg has no port below the adapter. agent-os/standards/index.yml carries the new title.

No CHANGELOG line: developer docs only.

Rules touched

WC-ARCH-3, WC-TOOL-15, WC-LIFE-1 (described, not changed). Implements items 14 and 15 of the tg/wa alignment audit (report: leemour/cli-private docs_ai/research/2026-10-20-whatsmeow-coverage-and-tg-alignment.md).

Findings while checking

• mtcute is pinned at 0.32.4 in package.json; HANDOFF.md and session-sharing.md still say 0.32.3. Not changed here.
• No lint rule stops src/telegram/ from importing commands or the program (wa has one); today it imports neither. Noted on the page.

How it was checked

• Every path, symbol, mode and constant on both pages grepped in the worktree; mtcute's initConnection defaults read in node_modules/@mtcute/core/network/network-manager.js.
• pnpm lint && pnpm typecheck && pnpm test: green, 73 files, 1567 passed, 6 skipped. markdownlint-cli2: 0 issues.

🤖 Generated with Claude Code