Skip to content

Navigation Menu

Sign in
Sign up

docs(trustguard): make the collector list match the console catalog 1:1 - #218

Merged
NTSergiVidal merged 2 commits into
develop from
sergividal/run-1283-collector-catalog-drift
Sep 8, 2026
Merged

docs(trustguard): make the collector list match the console catalog 1:1 #218
NTSergiVidal merged 2 commits into
develop from
sergividal/run-1283-collector-catalog-drift

Conversation

@NTSergiVidal

@NTSergiVidal NTSergiVidal commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Reported: the docs list collectors that are not in the platform. Verified — and it drifts in both directions. Goal for this PR: what the docs say the catalog contains is exactly what Agent Runtime → Collectors → Catalog offers.

Ground truth is COLLECTOR_PROVIDER_GROUPS in the app's collectorProviders.ts, confirmed identical to origin/develop with no local edits, and rendered unfiltered by CollectorsCatalogTab. 19 collector types in 4 groups — the 3 browser entries sit in HIDDEN_COLLECTOR_PROVIDERS and are not rendered.

Drift A — docs sent readers to catalog paths that do not exist

Seven broken breadcrumbs, all verified against the real group and entry names:

Page Said Reality
github-copilot Catalog → IDE & coding agents → GitHub Copilot No Copilot entry exists. The group has 4: Inference Hooks, Claude Code, Cursor, Codex
claude-enterprise ... → Claude Enterprise The entry is named Inference Hooks
python-sdk Application → Python SDK The entry is named Python
claude-code, cursor, codex IDE & coding agents The group is AI assistants & coding agents
langchain, n8n "Create one under TrustGuardCollectors" Wrong product name, and never said which type to pick

Drift B — the platform offers four collectors with no docs at all

The navigation reorganization deleted integrations/{cloudflare,aws-cloudfront,fastly,akamai}.mdx, but all four are live in the catalog's WAF group. Clicking WAF → Cloudflare in the console led to nothing.

Recovered from main and brought up to current conventions, which they predate: {TRUSTGUARD_BASE_URL}, Agent Runtime breadcrumbs, Transform instead of Redact, and the real catalog names — the group is WAF, not "Edge / WAF", and the entries are AWS CloudFront, Fastly Compute, Akamai EdgeWorkers. Re-registered in docs.json and relinked from the integrations index.

Worth knowing: because this release has not shipped, main was better than develop on this point. Merging #212 as it stood would have published four invented collectors and deleted the docs for four real ones.

Integrations that are not collector types

Three guides describe real integrations that have no catalog entry, which is fine — but they now say so and name the collector you actually create:

  • LangChainApplication → Python (it ships a Python middleware)
  • n8nApplication → REST API (the node posts to the REST endpoint)
  • Copilot Studio → not a TrustGuard collector at all; it connects through TrustGate MCP
  • GitHub Copilot → no catalog entry yet; the page now says so and points at NeuralTrust instead of a path that does not exist

Verification

A script compares the catalog extracted from collectorProviders.ts against the overview table, entry by entry:

catalogo (consola): 19 entradas
docu (overview): 19 entradas
>>> COINCIDENCIA 100%

Zero entries on either side without a counterpart. Also: 0 broken catalog breadcrumbs across the whole repo (was 7), check-navigation.py passes with 169 entries, and every internal link in the 16 changed files resolves.

Needs a product answer, not a docs fix

Is GitHub Copilot supported? There is no Copilot collector type in the catalog, and no mention of copilot anywhere in the app's catalog or its i18n. Either the collector type is missing from the platform, or the page documents something not yet shipped. The docs no longer lie about it, but someone should decide which of the two it is.

The navigation reorganization deleted integrations/{cloudflare,aws-cloudfront,
fastly,akamai}.mdx, but the console catalog still offers all four under its WAF
group. Anyone clicking WAF → Cloudflare had no documentation at all.
Recovered from main and brought up to current conventions, which they predate:
the {TRUSTGUARD_BASE_URL} placeholder, "Agent Runtime" breadcrumbs, Transform
instead of Redact, and catalog paths using the console's real group and entry
names — the group is "WAF", not "Edge / WAF", and the entries are AWS
CloudFront, Fastly Compute and Akamai EdgeWorkers.
Re-registered in docs.json and relinked from the integrations index.
The docs listed collector types the catalog does not have, and named catalog
groups and entries that do not exist, so readers were sent to console paths
they could never find.
Every catalog breadcrumb now uses the console's own names, verified against
COLLECTOR_PROVIDER_GROUPS:
- the group is "AI assistants & coding agents", not "IDE & coding agents"
- Claude Enterprise is listed as "Inference Hooks", its actual entry name
- Application holds "Python", not "Python SDK"
- GitHub Copilot has no entry at all, so the page no longer sends anyone to one
The overview table and the Collectors concept page now mirror the catalog:
four groups, nineteen types, console naming, one doc page each.
Integrations that are not collector types say so and name the collector you
actually create — LangChain and n8n use an Application collector (Python and
REST API respectively), Copilot Studio goes through TrustGate MCP, and GitHub
Copilot needs a collector NeuralTrust enables for the workspace.

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown

Trivy code scan — HIGH/CRITICAL

No HIGH or CRITICAL vulnerabilities found. (run)

NTSergiVidal merged commit 05a7157 into develop Sep 8, 2026
9 checks passed
NTSergiVidal deleted the sergividal/run-1283-collector-catalog-drift branch September 8, 2026 09:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

AltStyle によって変換されたページ (->オリジナル) /