Files
treg/docs/context
SToneX a8800fcad9 fix(find): a job missing from a platform the catalog has is a gap
decide's last rule read "nothing kept" as "not a task". Most such queries are
tasks on a platform the catalog lists, for a job it does not: posting to
Threads where only reading it is listed, a Telegram bot, an options quote,
a sound effect from text. The judge names the platform with confidence and
keeps nothing, and the answer was "try describing the data you want" (a
person) or the lexical page (an agent): for "publish post to Threads" the
Threads search endpoints, which the agent then re-queried past, and the miss
list never saw the gap.

A confident platform Choice with nothing kept is now a gap (rule 8; "not a
task" is rule 9), so the empty page says so, the agent's hint names the
platform ("the catalog has Threads but no tool for ..."), and the search is
recorded as a gap to add. On the agent eval set: 29 of 33 "not a task"
answers become gaps, job-hit unchanged, false-none 6% -> 7% (one of them a
lexical page that did carry the endpoint called).

Fragments: find.md (the rules), search-experiment.md.
2026-10-01 21:48:11 +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, …
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; the job-first answer served to agents building catalog_search.py, search_experiment.py, interleave.py, judge.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, …