Skip to content

docs: name all five providers, and the flagship we actually default to - #46

Merged
valentinozegna merged 1 commit into
mainfrom
docs/refresh-stale-copy
Aug 12, 2026
Merged

docs: name all five providers, and the flagship we actually default to#46
valentinozegna merged 1 commit into
mainfrom
docs/refresh-stale-copy

Conversation

@valentinozegna

Copy link
Copy Markdown
Contributor

Third repo in the same pass, after IntelligentElectron/universal-netlist#122 and IntelligentElectron/pcb-lens#59.

Two providers were missing from every description

src/providers/registry.ts exposes five providers. The README named three, and --help named four (it had Google's Vertex but not Anthropic's):

README --help Registry
google
anthropic
openai
google-vertex
anthropic-vertex

The advertised flagship was the previous one

src/providers/anthropic.ts sets DEFAULT_MODEL = "claude-opus-4-7" and labels claude-opus-4-6 as "Previous flagship". The setup table advertised 4.6 as the flagship, so the README recommended a model the tool itself has moved on from. 4.6 is still selectable, and is now described as such.

HTTP mode was undocumented on the front page

PORT starts Streamable HTTP instead of stdio, serving /mcp, POST /analyze, and GET /health, and deploy/ carries a full Cloud Run guide with a provider/auth matrix. None of it was reachable from the README, nor was docs/architecture.md. Both are linked now.

A leftover from #45

#45 removed VS Code (GitHub Copilot) from the supported clients, but the stdio diagram in docs/architecture.md still offered it as an example. The string survived because ASCII box art splits it across two lines (│ Code, VS │ / │ Code, etc) │), so a grep for "VS Code" does not match it.

Testing

npm test is green (98 passed, 2 skipped). Note that keychain.test.ts and transports/http.test.ts fail under a restrictive sandbox, since they need keychain access and a loopback socket; they pass normally and fail identically on an unmodified tree.

Changelog

The README, --help, and architecture doc describe all five providers, including Anthropic on Vertex AI, which no description mentioned. The Anthropic flagship is listed as Claude Opus 4.7, the model the server defaults to, rather than 4.6. The README now documents the PORT-triggered HTTP mode and links the Cloud Run deployment guide.

🤖 Generated with Claude Code

The front page described three providers and an Opus that is no longer
the flagship, and said nothing about the HTTP mode the server has shipped
since Cloud Run support landed.

- Both Vertex providers join the README, the --help text, and the
  architecture doc. registry.ts exposes five: google, anthropic, openai,
  google-vertex, and anthropic-vertex. The --help text listed Google
  Vertex but not Anthropic's, so it named four of the five
- The Anthropic flagship is Claude Opus 4.7, which is DEFAULT_MODEL in
  src/providers/anthropic.ts. The README still advertised Opus 4.6, which
  the same list carries as "Previous flagship"
- A "Running as a hosted server" section covers the PORT-triggered
  Streamable HTTP mode and its /mcp, /analyze, and /health routes, and
  links deploy/README.md. docs/architecture.md gets a link too; it was
  reachable from nothing
- The stdio diagram in docs/architecture.md no longer offers VS Code as
  an example client. #45 removed it from the supported list, but the
  words sat inside ASCII box art split across two lines, so a grep for
  "VS Code" never found them

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@valentinozegna
valentinozegna merged commit 487686f into main Aug 12, 2026
2 checks passed
@valentinozegna
valentinozegna deleted the docs/refresh-stale-copy branch August 12, 2026 23:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant