anthropic + anthropic_admin StackQL providers (monorepo factory)

[jeffreyaven]

Masters TWO StackQL providers from one factory pipeline, per the work order and the binding rules in CLAUDE.md.

Surface

Provider	Services	Resources	Methods	Source
anthropic	12	26	104 (45 select-routed)	official Stainless OpenAPI spec (hash d272f069e15d096063103c857fb8e2a7, vendored + drift-guarded)
anthropic_admin	6	11	27 (16 select-routed)	hand-authored from the canonical platform docs .md reference pages

Spec coverage: 126 spec ops − 104 provider ops == exactly the documented 22-op exclusion list (2 SSE streams, 10 OAuth-only tunnels ops, 10 beta twins of GA ops) — mechanized as guard 1.

Guard results (all green, wired in CI)

1. Spec-coverage diff: spec ops 126 − provider ops 104 == exclusions 22 ✅
2. Select-shape consistency: all SELECT methods per resource project identical columns ✅
3. Signature uniqueness: no (resource, verb) required-params clashes ✅
4. No-polymorphism scan: zero anyOf/oneOf/allOf/additionalProperties in generated services ✅
5. .stats.yml drift check: factory/locate.mjs vs pinned snapshot ✅
6. Zero-column selects: every SELECT method projects ≥1 column ✅

Plus: regeneration is byte-idempotent from the committed CSVs + vendored spec (CI enforces with git diff --exit-code).

Test output

• Meta routes (harness from stackql-provider-aws): anthropic 12/26/104 zero errors, every resource selectable · anthropic_admin 6/11/27 zero errors
• Mock smoke (wire-contract-enforcing mock: 401 without x-api-key, 400 without anthropic-version, 400 on beta paths without the per-endpoint anthropic-beta flag; 2-page cursor lists): anthropic 13/13 (inference-as-SELECT with naive body fan-out, agents INSERT/RETURNING → SELECT → UPDATE → EXEC-archive lifecycle, pagination walk, after_id lists terminate) · anthropic_admin 20/20 (admin key-space rejection, invites + workspaces lifecycles, usage/cost/claude_code report pagination, "group_by[]" wire test, rate-limits model filter)
• Live subsets gated on ANTHROPIC_API_KEY / ANTHROPIC_ADMIN_KEY (admin live is READ-ONLY)
• All 23 anthropic EXEC methods + admin archive dispatch-verified on the wire

Empirical findings (pinned in CLAUDE.md)

• All four admin open questions resolved on the mock: (a) ship $.data bucket rows (deep $.data[*].results[*] objectKey works but drops bucket timestamps); (b) array query params take one scalar value, bracketed identifiers must be DOUBLE-quoted (backticks are a parser error — corrects few-shot 5); (c) ending_at optional; (d) fast-mode beta header optional with no default
• stackql v0.10.542 EXEC-prepare panic found + worked around: response schemas without an array-typed property SIGSEGV at prepare; bare-scalar responses fail to bind. factory/post-pass.mjs stamps a synthetic schema_override envelope on affected exec-only methods (19 total). Worth reporting upstream.
• beta-flags table corrected from PyPI anthropic 0.116.0: files/skills/user_profiles carry their own flags, not managed-agents
• provider-utils docgen Required-Params gap fixed: local postinstall patch + prepared upstream diff (factory/upstream/provider-utils-select-required-params.patch) — method tables now show model, messages, max_tokens etc. for SELECT-routed body methods

Microsites

Two Docusaurus 3.10 sites (anthropic-provider.stackql.io, anthropic-admin-provider.stackql.io), both yarn build clean, cross-linked auth docs, Netlify per-site base-directory config committed (no GitHub Pages). SQL samples scrubbed: auto-injected headers removed, bracketed/hyphenated identifiers double-quoted, samples are actually routable.

Note

A stray stackql-provider branch exists on the remote (created before the default-branch correction; the git proxy swallows branch deletions) — safe to delete in the UI.

🤖 Generated with Claude Code

https://claude.ai/code/session_01M5qQSBivc7W458yqJG9i5a

---

Generated by Claude Code