Triage provider-guide drift found by static checker

[caiopizzol]

The static drift checker in #608 found provider-guide drift across docs, sample links, and connector metadata.

This issue tracks the findings and follow-up work. Not every finding is a docs bug: some need connector/catalog changes, product decisions, or validated sample creation.

Current status

• scripts(drift-check): add v1 static detector for provider guides #608 adds the drift-check detector.
• fix(zendeskSupport): correct sample manifest URL #610 fixed the zendeskSupport sample-link case mismatch.
• fix(flatfile): rename filatfile/amp.yml to flatfile/amp.yaml to match docs link samples#132 fixed the Flatfile sample path typo (filatfile/amp.yml -> flatfile/amp.yaml), so the existing flatfile.mdx link now resolves.
• docs(flatfile): add 'Create a secret key' section with API-key creation GIF #614 adds a Before you get started section to flatfile.mdx with a Secret-key creation GIF; flatfile.mdx previously had no credential-creation walkthrough.
• fix(monday): document API key auth setup (not OAuth) #612 fixed a Monday auth setup mismatch: Monday uses API-key auth, not OAuth Client ID/Secret.
• fix(proxy-actions): clarify x-amp-project-id header requires UUID #613 clarifies that proxy requests require the project UUID in x-amp-project-id.
• Monday: catalog support.write is false but Write API succeeds end-to-end for boards connectors#3003 tracks Monday support.write: runtime testing confirmed boards create works even though live metadata says write: false.
• fix(monday): mark write support enabled connectors#3036 updates Monday catalog metadata to mark Write support enabled.

Latest sweep

Re-run on 2026-05-28 against current amp-labs/docs@main with the #608 checker overlaid.

Area	Count	Status
Doc/catalog action mismatches	3	Monday has amp-labs/connectors#3036; AWS and Greenhouse remain open
Broken sample links	5	Zendesk Support and Flatfile are fixed; 5 genuinely missing samples remain
Undocumented providers	29	Needs provider-by-provider triage
Total	37	Down from the first 40-finding sweep

Remaining high-signal items

Action mismatches

• aws.mdx claims Write Actions, but live metadata reports support.write: false. Runtime not tested.
• greenhouseJobBoard.mdx claims Proxy Actions, but metadata reports proxy: false; the guide is already excluded from nav, and connector source says it is not shipping yet.

Broken sample links still unresolved

These guides still point to missing samples. No typo or near-match sample paths were found.

• drift
• fourFour
• outplay
• paddle
• seismic

Preferred fix: create validated samples in amp-labs/samples. If that is not practical yet, remove the dead links as a temporary docs cleanup.

Undocumented providers

29 catalog providers have no guide and no allowance. Highest priority (expose full read/write/proxy):

• fastSpring
• microsoftClientCredentials
• zendeskChat