Skip to content

Docs: choosing a plugin placement, and the gates for public endpoints (#133) - #140

Merged
michielbdejong merged 1 commit into
mainfrom
claude/issue-133-placement-docs
Sep 24, 2026
Merged

michielbdejong merged 1 commit into
mainfrom
claude/issue-133-placement-docs

Conversation

@michielbdejong

Copy link
Copy Markdown
Contributor

Closes #133.

  • integrations/README.md, new section "Choosing a placement":
    • the placements A–E and decision rules 1–6 from the approved design port opening functionality #88 design (docs/design/server-plugin-routes.md), with its examples;
    • the derived requires list;
    • a subsection, "Public endpoints need a gated server": the Cargo feature plugin-routes, --plugin-routes/ATOMIC_PLUGIN_ROUTES (off / read-only / read-write), and install consent. atomic.place builds without the feature.
  • Planned vs. available: everything not yet built is marked planned, with its atomic-server issue (#1711–#1723; #1711 is in Gate plugin public surfaces at build time and at runtime (AS-01) atomic-server#1726). A file importer that runs from its plugin page is documented as available (atomic-server#1653, as money/ does it).
  • AGENTS.md "Plugin runtimes" gets a short paragraph linking both sections.

🤖 Generated with Claude Code

Add "Choosing a placement" and "Public endpoints need a gated server" to
integrations/README.md, summarising sections 0 and 1 of the accepted #88
design (docs/design/server-plugin-routes.md): placements A-E with their
decision rules, and the three gates (Cargo feature `plugin-routes`,
`--plugin-routes`/`ATOMIC_PLUGIN_ROUTES`, install consent). Everything not
built yet is marked planned with its ontola/atomic-server issue
(#1711-#1723); atomic.place builds without the feature. Link it from
AGENTS.md's "Plugin runtimes".

Closes #133

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@michielbdejong
michielbdejong merged commit a3204d0 into main Sep 24, 2026
23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document plugin placement rules and public-surface gates

1 participant