README.md

tools-registry — design fragments

Small, focused fragments that mirror the codebase. Each declares the source files it covers (frontmatter sources:). Regenerate this index with python3 .claude/skills/tools-registry-context/scripts/build-map.py.

Foundation

Fragment	Status	Covers
Tools Registry — charter (what it is, why, the proxy model)	foundational	2026-06-30-jason-tools-registry.md, README.md

Architecture (proxy, auth, data model)

Fragment	Status	Covers
Google Ads conversion tracking — capture, outbox, upload	shipped	adsconv.py, signup.py, adtrack.js, gtag.js
Archive - every platform answer, kept and versioned (cache = the newest layer)	building	archive.py, 0002_archive_tables.py, 0003_callrecord_cached.py, 0004_archivekey_request_shape.py, …
Auth & secrets — injectors, encryption, OAuth freshness, health	shipped	injectors.py, ssrf.py, crypto.py, oauth.py, …
Endpoint catalog — what you can DO with a connected key, and which provider should do it	shipped	contracts.yaml, adapters.yaml, findymail.search.business-profile.json, init.py, …
Application composition and deployment roles	shipped	bootstrap.py, bootstrap_handlers.py, bootstrap_http.py, call_surface.py, …
Data model — the registry tables, async DB, audit writer	shipped	alembic.ini, env.py, 0001_baseline_current_schema.py, 0002_archive_tables.py, …
Enforced import boundaries	shipped	pyproject.toml, ci.yml, init.py, init.py, …
Instagram OAuth — direct Login and optional Facebook Page tools	built; Meta configuration and live verification pending	catalog_ingest.py, access.py, resolve.py, service.py, …
Local proxy — catch a program's own outgoing calls (treg <command>)	shipped	localproxy.py, server.js
Local CLI runs — run a vendor CLI as a dedicated user with a server-held credential (treg run)	shipped	localrun.py, egress.py, fsjail.py
MCP — the front door for assistants, and treg as an OAuth authorization server	shipped	auth.py, mcp.py, health.py, mcp_oauth.py, …
Money — prepaid balance, the ledger, Stripe, and the reports that check it	shipped	init.py, settlement.py, init.py, models.py, …
Multi-tenancy — orgs, memberships, invites, per-org scoping	shipped	models.py, api.py, caller_metadata.py, auth.py, …
The proxy — faithful credential-injecting relay + tool resolution	shipped	relay.py, ssrf.py, api.py, authorize.py, …
Super-admin — cross-tenant read + control	shipped	api.py, admin.py, access.py, config.py

Interfaces (API · CLI · skill)

Fragment	Status	Covers
The API — the only brain (FastAPI)	shipped	sitetrack.js, api.py, bootstrap_handlers.py, bootstrap_http.py, …
Catalog browse review — categories, platform placement, and domain sections	reference	store.py, capabilities.yaml
The CLI (treg) + skill scaffolding	shipped	cli.py, convert.py, agents.py
The web dashboard (Ledger, served from FastAPI)	shipped	sitetrack.js, index.html, README.md, vue-3.5.41.global.prod.js, …
Import — scan a .env AND/OR a skills dir, auto-register as tools + bundles	in-progress	providers.py, skills.py
Landing sandbox backend - front-end entry removed	shipped	sandbox.py, sandbox_identity.py, pubfeed.py, sandbox.py, …
Onboarding — the first-run demo team (dashboard + CLI)	shipped	auth.py, init.py, demo.py, cli.py, …
Search surfaces — robots, sitemap, the crawlable catalog, and the social card	shipped	api.py, web.py, agent_pages.py, robots.txt, …
Shell mode (treg shell) — transparent CLI interception	shipped	shell.py, cli.py
The shippable tools-registry skill (3 personas)	shipped	skill.md, web.py, mcp_install.py, build_plugin.py, …

Ops (deploy, scale)

Fragment	Status	Covers
Provider capacity — knowing what treg's own vendor accounts have left	shipped (steps B–F built; production rollout = the shadow week, then TREG_OVERFLOW_MODE=on)	init.py, collectors.py, policy.py, sweep.py, …
Running & deploying the server	shipped	pyproject.toml, main.py, maintenance.py, env.py, …

Reference

Fragment	Status	Covers
Glossary	reference	2026-06-30-jason-tools-registry.md

guides

Fragment	Status	Covers
Expanding a catalog category — the add-a-provider playbook	guide	oauth_providers.py, authorization.py, oauth_flow.py, oauth_exchange.py, …