Files
treg/docs/context
SToneX fd4453ea17 chore: keep hosted operational material in the private workspace (#722)
Preserve public page sources and portable maintenance tools while moving hosted records and pricing evidence out of the public tree. Require explicit external pricing evidence and remove hosted database access helpers.

Update the catalog, ads conversion, archive, super-admin, data-model, MCP OAuth, API, SEO and skill context fragments. Merge the companion private import before this change.
2026-09-30 15:54:01 +08:00
..

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