mirror of
https://github.com/superdesigndev/treg.git
synced 2026-10-02 03:24:35 +08:00
SToneX
2ef37b7636
The platform page read every endpoint the same way, one ledger with a provider
cloud, domain chips and two levels of expansion, so the few jobs several
providers do were buried among the long tail and could not be compared.
- A shelf now leads with job cards (a capability two or more providers serve)
and lists every other tool as a card; plumbing sits last, nothing is hidden.
- Each job has its own page, /catalog/<slug>/<job> (server route, sitemap) and
/app#platform/<slug>/<job>: an Autopilot card when a routed tool exists, then
one comparison of provider, inputs taken, price, measured success and agent
verdicts, with column tips and banded counts.
- A tool opens in a non-modal drawer over any list, walked with up and down;
Try it stacks on top of it. Parameters are a list, not a table.
- The shelf's search box is the Catalog page's, scoped: /catalog/find takes
?platform= so the judge reads that shelf only.
- A provider's page lists its tools by platform (GET /catalog/providers/{service})
and links each to the job it competes in.
- Routed tools can be tried by hand; their access line no longer lists every
provider the example cannot use.
- Review quotes drop anything that could name another team's lookup (any
domain, handles, phone numbers, names) and carry only their month.
The old ledger's state, methods and styles are removed.
Fragments: interface/dashboard.md, interface/api.md, architecture/feedback.md.
6.7 KiB
6.7 KiB
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, … |
Interfaces (API · CLI · skill)
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, … |