Files
treg/docs/context/README.md
SToneX 7fc6ee3f83 feat(find): semantic channel
v2's recall gains its second channel. infra/embed.py is an
OpenAI-compatible /embeddings client that never raises and caches a
query's vector in-process by model and folded text. application/
find_index.py builds one card matrix per catalog in the background on
the first v2 find: vectors are read from the archive's object store
under find-vectors/<model>/<card sha256>, only missing cards are
embedded, and those are written back. Without a store they live in the
process; without the API the channel stays off and the build is retried
later. The judged event and the searchlog row record the query's
embedding time and error.

The object store gains named objects for these vectors only, each body
carrying its own card hash and size. numpy joins the server extra for the
matrix product. Settings find_embed_api_key (falls back to treg's
OpenRouter key on the OpenRouter URL), find_embed_model, find_embed_url,
find_embed_timeout_s.

The bench builds the vectors before scoring when a key is set, and its
judge cache key now includes the job question's wording.
2026-09-30 18:19:49 +08:00

7.1 KiB
Raw Permalink Blame History

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