mirror of
https://github.com/paperclipai/paperclip-docs.git
synced 2026-11-07 06:16:07 -10:00
39633c2217
Connector catalog, setup guides, and shared access documentation, followed by a final code-accuracy repair pass. This PR does not change application behavior. ## Final accuracy pass Checked against shipped Paperclip `v2026.916.0`, commit `dffc2b3ca1b9e88fa21cb17493083e682dffd1ca`, rather than the dirty local checkout or the earlier canary baseline. - Corrects connector/method-specific identity choices, human audiences, and managed GitHub versus PAT scope and verification. - Explains that **Always allow** covers different arguments for the same agent/action/connection, with project scope when present; uses actual button labels and removes the test-panel control from review instructions. - Qualifies new-action quarantine, including safe-default read exceptions. Removes unconditional approval guarantees. - Separates provider channel/repository reach from Paperclip sender authorization. - Completes sandbox sign-in and model credential-selection instructions from the current UI implementation. - Repairs Notion's hub summary, removes incomplete optional Notion/Sentry client-registration procedures, and corrects Linear's provider-versus-Paperclip attribution. - Removes unsupported Postman tier claims, contradictory Cloudinary/Mem0 verification assertions, API-equivalence claims, and overbroad successful-test assurances. - Retains Supabase's required project reference: both released method definitions explicitly require it. An earlier review suggested otherwise; release code is authoritative here. - Updates the release baseline and removes draft commit chronology from the public introduction. ## Availability and remaining runtime gates - **Google:** Verification is pending. Per the product-owner clarification, authorization can continue where Google offers an Advanced option; this is not available for every account and does not override Workspace policy or other Google prerequisites. Notices on the hub and all Google guides now distinguish an unverified-app warning from blocked authorization. - **Slack is available but not yet fully functional; follow-up fixes are planned.** For agent tools, the released OAuth endpoint/scope defaults differ from Slack's documented MCP contract. The page now warns against treating that route as production-ready and removes the misleading bot-scope walkthrough. Chat-channel bot setup remains separate. Engineering must reconcile the integration and run OAuth plus one read before removing this warning. Source: https://docs.slack.dev/ai/slack-mcp-server/ - No credentialed connector run was performed in this pass. Code consistency, provider documentation, UI rendering, and successful live execution are separate evidence levels. No claim of runtime certification for all connectors. ## Validation - Root build: 253 crawlable documentation pages. - Full `docs:test`: all eight suites passed locally, including root/subpath routes, sitemap history, fingerprints, navigation, skill source blocks, crawlable links, doc-link resolution, and SEO metadata. - Internal-link lint: 258 Markdown files; no broken internal links. - Latest cleanup: full build, all eight docs:test suites, internal-link lint and diff whitespace checks passed; 1,878 link-resolution checks. - Fixed the Calendar MCP reference URL; browser-checked the five inconclusive external destinations (Miro article loads; Asana, Google Cloud, OpenAI and xAI reach sign-in/console screens). Authenticated destinations were not tested beyond those screens. - Replaced the Sandbox providers editorial TODO with a scope note and removed the CLI overview's unfinished-guide announcement. - Browser client navigation: 687 checks passed using installed Chrome. Initial launch lacked the downloaded Playwright browser; rerun used `DOCS_CHROMIUM_PATH` without changing the tests. - Nine representative connector/shared pages at 1440px and 390px: HTTP 200, one article H1, no page-level horizontal overflow. Mobile screenshot inspected; approval page opened in the Codex browser. - Navigation audit reports three existing non-connector orphan files; this patch does not alter those files or their navigation. The previous revision's provider-page expansion, Google shared setup guide, navigation additions, and accidental node_modules-symlink cleanup remain in this PR. Internal review ledgers remain outside the publication branch. No merge or production deployment authorized. --------- Co-authored-by: DevRel Gemini <[email protected]> Co-authored-by: Paperclip <[email protected]> Co-authored-by: Claude Opus 5 (1M context) <[email protected]> Co-authored-by: Michael Nguyen <[email protected]>
45 lines
2.7 KiB
JSON
45 lines
2.7 KiB
JSON
{
|
|
"name": "paperclip-docs",
|
|
"private": true,
|
|
"type": "module",
|
|
"scripts": {
|
|
"docs:build": "node site/build-release.mjs --base-path / --out-dir .site",
|
|
"docs:build:github-subpath": "node site/build-release.mjs --base-path /paperclip-docs/ --out-dir .site",
|
|
"docs:build:auto": "node site/build-release.mjs --base-path auto --out-dir .site",
|
|
"docs:test:static-routes": "node scripts/verify-static-routes.mjs",
|
|
"docs:test:sitemap-lastmod-history": "node scripts/verify-sitemap-lastmod-history.mjs",
|
|
"docs:test:asset-fingerprints": "node scripts/verify-asset-fingerprints.mjs",
|
|
"docs:test:hierarchical-skills-nav": "node scripts/verify-hierarchical-skills-nav.mjs",
|
|
"docs:test:skill-source-blocks": "node scripts/verify-skill-source-blocks.mjs",
|
|
"docs:test:crawlable-links": "node scripts/verify-crawlable-links.mjs",
|
|
"docs:test:doc-link-resolution": "node scripts/verify-doc-link-resolution.mjs",
|
|
"docs:test:seo-metadata": "node scripts/verify-seo-metadata.mjs",
|
|
"docs:test": "npm run docs:test:static-routes && npm run docs:test:sitemap-lastmod-history && npm run docs:test:asset-fingerprints && npm run docs:test:hierarchical-skills-nav && npm run docs:test:skill-source-blocks && npm run docs:test:crawlable-links && npm run docs:test:doc-link-resolution && npm run docs:test:seo-metadata",
|
|
"docs:test:client-nav": "node scripts/verify-client-navigation.mjs",
|
|
"docs:serve": "python3 -m http.server 4321 --directory .site",
|
|
"sync:lint-links": "node scripts/sync/lint-links.mjs",
|
|
"sync:verify-nav": "node scripts/sync/verify-nav.mjs",
|
|
"sync:backfill-screenshots": "node scripts/sync/backfill-screenshots.mjs",
|
|
"sync:compare-window": "node scripts/sync/compare-window.mjs",
|
|
"sync:check-drift": "node scripts/sync/check-drift.mjs",
|
|
"sync:detect-renames": "node scripts/sync/detect-renames.mjs",
|
|
"sync:verify-edit": "node scripts/sync/verify-edit.mjs",
|
|
"sync:verify-screenshots": "node scripts/sync/verify-screenshots.mjs",
|
|
"sync:check": "npm run sync:lint-links && npm run sync:verify-nav && npm run sync:verify-screenshots && npm run sync:check-drift",
|
|
"sync:test": "node scripts/sync/test.mjs",
|
|
"screenshots:seed": "node scripts/screenshots/seed.mjs",
|
|
"screenshots:capture": "node scripts/screenshots/capture.mjs",
|
|
"screenshots:sync-registry": "node scripts/screenshots/sync-registry.mjs",
|
|
"screenshots:refresh": "node scripts/screenshots/run.mjs",
|
|
"screenshots:serve": "node scripts/screenshots/run.mjs --serve",
|
|
"screenshots:refresh:all": "node scripts/screenshots/run.mjs --all"
|
|
},
|
|
"devDependencies": {
|
|
"@playwright/test": "^1.58.2",
|
|
"esbuild": "^0.25.12"
|
|
},
|
|
"dependencies": {
|
|
"marked": "^12.0.2"
|
|
}
|
|
}
|