Files

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 - versioned history and cache admission building archive.py, hunter.yaml, results.py, 0031_archive_result_admission.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 fetchinio.yaml, fetchinio.svg, fetchinio.linkedin.user.profile.json, fetchinio.linkedin.company.profile.json, …
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 0042_pinned_read_scope.py, alembic.ini, env.py, 0001_baseline_current_schema.py, …
Feedback - private intake for problems and suggestions shipped feedback_contract.py, __init__.py, reports.py, reviews.py, …
Find tools for a job - /catalog/find, recall by job and one judge request building catalog_find.py, find_recall.py, find_index.py, embed.py, …
The tool hub — tools a maker publishes, made of other tools built (phases 1–10, 2026-09-09/14; pricing flexibility 9.1–9.5 (docs/hub-pricing-decisions.md), listing + public run log 10.1–10.5 (docs/hub-listing-decisions.md)); behind hub_enabled (TREG_HUB_ENABLED), off in production until the final merge __init__.py, manifest.py, refs.py, graph.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, …
Media hosting - reference files a vendor can fetch (treg host) shipped media.py, media.py, models.py, 0037_media_hosting.py, …
Money — prepaid balance, the ledger, Stripe, and the reports that check it shipped tavily.yaml, tinyfish.yaml, test_tinyfish.py, __init__.py, …
Multi-tenancy — orgs, memberships, invites, per-org scoping shipped access.py, 0042_pinned_read_scope.py, test_pinned_read_scope.py, models.py, …
The proxy — faithful credential-injecting relay + tool resolution shipped relay.py, ssrf.py, api.py, authorize.py, …
Discovery experiment — a relevance judge behind catalog search, measured on what the caller does next building search_experiment.py, interleave.py, judge.py, 0041_searchlog.py, …
Super-admin — cross-tenant read + control shipped api.py, admin.py, evidence_retention.py, access.py, …
The table layer — one call, answered as rows and columns (/table/) built, behind table_enabled (TREG_TABLE_ENABLED), off by default __init__.py, table.py, table.py, call.py, …

Interfaces (API · CLI · skill)

Fragment Status Covers
The API — the only brain (FastAPI) shipped media.py, sitetrack.js, api.py, bootstrap_handlers.py, …
Catalog browse taxonomy — open placement and naming decisions backlog —
The CLI (treg) + skill scaffolding shipped cli.py, test_released_cli_compat.py, test_cli_key_compatibility.py, auth_helpers.py, …
The web dashboard (served from FastAPI) shipped App.vue, views.ts, controller.js, base.css, …
Enrich Arena — paid comparisons, one-click feedback, and visible waterfalls shipped arena.py, arena.py, arena.py, models.py, …
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
Test cases for the ChatGPT plugin submission reference —
Tool justifications for the ChatGPT plugin submission reference —
The shippable tools-registry skill (3 personas) shipped skill.md, SKILL.md, SKILL.md, web.py, …

Ops (deploy, scale)

Fragment Status Covers
Provider capacity — knowing what treg's own vendor accounts have left shipped __init__.py, collectors.py, policy.py, sweep.py, …
Running & deploying the server shipped pyproject.toml, hatch_build.py, build-dashboard.sh, build-web.sh, …

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, …