Aron PrinsandClaude Opus 5.5
a3368fb06b
Release docs for paperclip **v2026.916.1**, a patch on top of v2026.916.0. ## What's in the release One upstream commit, [#13562](https://github.com/paperclipai/paperclip/pull/13562): the task conversation's send button no longer starts out disabled while the pause check loads. The same commit repairs how the server classifies duplicate document inserts. No doc page described the broken behavior, so no content needed editing. ## Changes - `docs/reference/changelog.md`: a v2026.916.1 entry. It also lists the pages published on `main` since v2026.916.0: Set Up HTTPS, Understanding GitHub PR review bots, and Set up a GitHub review bot, plus updates to Trust & Low-Trust Review and the GitHub connector pages. - `SCREENSHOTS_PENDING.md`: 24 task-detail screenshots whose dependencies changed. These are file-change flags, not confirmed visual changes, so recapturing is optional. - `.sync-state.json`: base moved to `v2026.916.1`. This branch was cut from `main`, not `nightly`. Everything on `nightly` was drafted from parent `master` after the tag, so none of it is included. ### ⚠ Post-tag leaks removed The following nightly drafts are absent at `v2026.916.1` and were deliberately left out: - `docs/reference/adapters/sandbox-providers.md`: the CreateOS provider. The tag-accuracy gate flagged it as a leak. - `docs/guides/projects-workflow/routines.md` and `docs/reference/api/routines.md`: webhook setup-pending and test deliveries. `routines.ts` at the tag has no webhook handling. ### ⚠ Verification Failures For review: the tag-accuracy gate could not confirm the surface of `docs/connectors/github-review-bot-setup.md` or `docs/connectors/understanding-github-review-bots.md` at the tag. Both are marked experimental and already live. ### ⚠ Drift These items predate this patch; they shipped with v2026.916.0. - env-var-missing (high): `PAPERCLIP_WORKSPACE_GIT_SCAN_{CONCURRENCY,QUEUE_CAPACITY,TIMEOUT_MS,CACHE_TTL_MS}` and `PAPERCLIP_ID_CONNECTOR_{BASE_URL,ENVIRONMENT,INSTANCE_ID,SIGN_PRIVATE_KEY,SEAL_PRIVATE_KEY}` in `environment-variables.md`. These may be runtime-injected false positives. - Verify: rest-route-missing (medium): the five `/api/companies/import/transfers*` routes in `api/companies.md:426-430`. ## Checks `docs:build`, `sync:check`, and `docs:test` all pass locally. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 5.5 (1M context) <[email protected]>
Paperclip Docs
Source for the Paperclip documentation site — user guides, API and CLI reference, adapter docs, and deployment notes.
Read the docs: https://docs.paperclip.ing/
What's inside
- Guides — Getting started, core concepts, and day-to-day usage.
- API reference — Control-plane endpoints and payload schemas.
- CLI reference —
paperclipcommand surface. - Adapters — Plugin authoring and the integrations catalogue.
- Deploy — Self-hosting, upgrades, and operational guidance.
The site is a single static shell that renders the Markdown files in docs/ directly — no framework, no build step required to read the raw pages.
Build and deployment
Build a release bundle locally with:
npm run docs:build
Cloudflare Pages is connected directly to paperclipai/paperclip-docs through GitHub. There is no normal Wrangler publish step for this repo:
- Pushes to
maindeploy production athttps://docs.paperclip.ing/. - Pushes to other branches create Cloudflare Pages preview/canary deployments.
- Canary URLs are created by Cloudflare for each deployment, for example
https://92b9a99c.paperclip-docs-74t.pages.dev. Use the URL shown in the Cloudflare Pages deployment row or GitHub deployment/check for the pushed branch and commit.
That auto-deploy is not guaranteed — it has silently failed to fire on a push to main before. After anything reader-facing lands, check the live site rather than the merge, and republish by hand if it's stale:
npm run docs:build
npx wrangler pages deploy .site --project-name paperclip-docs --branch main
Contributing
Spotted a typo, a broken link, or something that could be clearer? There are two easy paths, both linked from the footer of every docs page:
- Suggest an edit — opens the underlying Markdown file in GitHub's web editor. Make the change and submit a PR without leaving the browser.
- Report an issue — opens a prefilled Docs feedback issue with the page URL already attached.
For larger changes, fork the repo and open a PR against main. Screenshots live under docs/user-guides/screenshots/{light,dark}/ and should be provided in both themes when replacing UI captures.
Community
License
Copyright (c) 2026 Paperclip Community.
The Paperclip software is open source — see the main paperclip repository for its license.
The documentation in this repository is licensed under Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0). You may read and share it for non-commercial purposes with attribution. Commercial use of any kind requires prior written permission from the copyright holders. See LICENSE for the full text.
Unlisted hosted beta guide
docs/hosted-beta.md is built at /hosted-beta/ by site/build-release.mjs.
It reuses the full docs shell and initializes page tools without adding the page to the navigation/search manifest.
Keep it out of site/content.json: it is deliberately absent from navigation,
search, homepage listings, previous/next links, and the sitemap. It has a
noindex meta tag; this is a public page, not an access-controlled document.
Run node scripts/verify-unlisted-beta.mjs to verify root/subpath builds and
exclusion from discovery. Preview with npm run docs:build and npm run docs:serve.