docs: architecture guide, shared security page, footer links - #41
Merged
Merged
Conversation
leemour
force-pushed
the
docs/architecture
branch
from
October 4, 2026 11:32
b474357 to
b6a3568
Compare
Plan for review: a shared architecture guide with per-language diagrams, a shared security page that the tg and max pages point to, and footer links to the support chat and that page. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…red page "Report a problem" pointed at tg-cli's GitHub issues and "Security" at tg's own page. Both now lead to the support chat and the shared security page, in the landing prototypes, the export and the About page. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
What both tools share: the local store, the send guard, permissions and MCP confirmations, other people's text, the network, and how to report a vulnerability privately (email or GitHub private reporting). Messenger details stay on each tool's page. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Packages, the path of one command, the five layers, the adapter contract, the local store, the patterns, the MAX side, testing and the limits, in English, Russian and Spanish, with source links pinned to commits. Diagrams are drawn from data, so labels follow the page language and colours the theme. Tool pages that link a site page by its full URL now open it in the reader's language after sync. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…curity table Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
leemour
force-pushed
the
docs/architecture
branch
from
October 4, 2026 11:44
3b66452 to
7ab8e7b
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Task
The owner asked for a public architecture guide (packages, layers, adapters, key patterns, diagrams — showing how it works, not selling), a footer that sends problem reports to the support chat and security to a shared page, and a shared security page that the tg and max pages point to.
Why
Architecture material existed only in developer files in three repositories. The footer sent "Report a problem" to tg-cli's GitHub issues and "Security" to tg's own page. No repository had a private way to report a vulnerability.
What
/{lang}/docs/architecture(en, ru, es): packages, one command from start to finish, five layers, the adapter contract, the local store, patterns, the MAX side, testing, limits and trade-offs, where to start contributing. Source links pinned to commits (cli-messagingc7cd479, cli-core8648e39, tg-cli4a36e85, max-clifff19ff).components/architecture-diagram.tsx: box diagrams drawn from data, so labels follow the page language and colours the theme; stacks at phone width. Prose under each diagram says the same thing for the Markdown copies agents read./{lang}/docs/security(en, ru, es): what both tools share — the local store, the send guard, permissions and MCP confirmations, other people's text, the network, and private vulnerability reporting (hello@wirecat.dev or GitHub private reporting, now enabled on tg-cli, max-cli, cli-messaging, cli-core and cli-docs)./{lang}/docs/security. Changed in the prototypes and export script, re-exported; the JSON diff touches only those two links.scripts/localize.tssiteLinks: a tool page that linkshttps://wirecat.dev/<lang>/docs/...opens it in the reader's language after sync. Tested.docs/plans/2026-10-04-architecture-and-security.md.Related tool PRs: leemour/tg-cli#257, leemour/max-cli#387, leemour/cli-messaging#492. The trimmed tool security pages reach the site with each tool's next release; their translations then need a review.
Testing
pnpm lint && pnpm typecheck && pnpm test— 148 tests pass.pnpm sync && pnpm exec next build && pnpm check:links— links ok./en|ru|es/docs/architectureand/ru/docs/securityin light, dark and at 390 px: no horizontal scroll; footer links verified in the built page.🤖 Generated with Claude Code