Manage each recognized OpenCode integration from its Status → Plugins row.
Remove the separate per-integration sections and manual attachment picker;
integrations attach conversations through their native first-use contract.
Show catalogue names, package versions, integration-accent switches,
conversation binding and application warnings. The chain button attaches to a
compatible open document or detaches the captured conversation. Revoke pending
enumeration and choices on navigation, invalidation, reconnect and disposal.
Keep guarded application installation and one-shot native actions alongside
existing package controls.
Reads remain demand-driven and refresh on native events and reconnects.
Explicit refresh also retries demanded bindings for the exact displayed
conversation and Location. Preserve integration display and native actions
for inherited, virtual and runtime-only plugins through an unambiguous
runtime identity, separately from writable-source mutation authority.
Keep revision checks, consent revocation and uncertain-outcome handling;
never replay a mutation automatically.
Update help and UI strings in ten locales, documentation and captures.
Cover binding recovery, read-only origins, activation/removal scope and
native-action guards through unit and real-panel browser regressions. Qualify
the projected runtime identities with the isolated official daemon.
Ship native integration Status sections and catalogue installation by integration ID, including the complete change from #1280. Keep plugin package management in Plugins, per-conversation attachment authority in Status, guarded installation, shared controls, persistent section customization and all ten UI/help locales.
Merge current origin/dev into the feature branch with an ordinary merge, preserving file-reader lifetime and the latest native browser fixture contracts. Resolve conflicts in instance-shell2.tsx, right-panel/core-runtime.tsx, automation-forms.test.ts and session-child-activity.test.ts without weakening assertions or deadlines.
ADMIN-FORCED MERGE AT THE HUMAN'S EXPLICIT REQUEST. The human accepts exactly these two remaining Missions browser failures for this merge:
- mission-schedule-list: fresh-read Start scenario, 15-second SSE setup timeout; reproduced on dev cc5961a797 and established as pre-existing.
- mission-lifecycle-revision: 409 without certified code scenario, 30-second bootstrap timeout; not reproduced by the bounded diagnosis, attribution UNKNOWN, not claimed as pre-existing.
Diagnosis evidence: https://github.com/NeuralNomadsAI/CodeNomad/pull/1283#issuecomment-6617704358
Original full-suite record: https://github.com/NeuralNomadsAI/CodeNomad/pull/1283#issuecomment-6617213011 (1805 pass / 2 fail / 0 skip).
Post-synchronization validation on aba257802949123028741982ba64da988abcbb01: root/server/UI typechecks pass; relevant unit and route suites 142/142; help 31/31; integration browser plus conflicted Forms/session-child suites 144/144; additional file-preview browser regression 5/5. Zero skips or weakened assertions/deadlines.
Foreground gh pr checks --watch completed. Ready-for-review CI run 41737660774 succeeded on this exact head, including all four browser shards, unit tests, compatibility, runtime contracts, native pruning and desktop builds: https://github.com/NeuralNomadsAI/CodeNomad/actions/runs/41737660774 . The preceding run 41737659582 was cancelled; its four cancelled jobs have no steps and remain displayed as fail by gh. These are cancellation records, not executed test failures. The historical two-failure local full result and its limited acceptance remain recorded above.
This exception is limited to this administrative merge. Separate desktop/manual/privacy and publication gates remain scoped independently. No release, tag, npm publication or catalogue change.
## Summary
Slice C2 of the OpenCode integrations plan: CodeNomad recognises
configured OpenCode integrations from the reviewed catalog and reads
their state. This is the base for attaching an open application to a
conversation (C4) and for the Bundles extension (C3).
- **Catalog** (`opencode/integrations/catalog.ts`): newest
`catalog-v<n>` release of `NeuralNomadsAI/opencode-integrations` (GitHub
releases API, never "latest"), `catalog.json` asset through the API
origin, 256 KiB / 10 s bounds, zod validation, 30 s shared cache with
conditional list requests, last valid catalog persisted and served as
`stale`, `unavailable` with an empty list otherwise. No catalog release
exists yet: the real repository reads as `unavailable` today (no release
was created).
- **Recognition** (`recognition.ts`): registry package (aliases
resolved), plugin ID or exact `-<plugin>` rule (disabled plugins),
`sources.git` prefix; a source designating two integrations or loaded
under another plugin ID is non-conforming.
- **State route** `GET /api/workspaces/:id/integrations?directory=`
(`status.ts`, `integrations.ts`, `routes/integrations.ts`): absent /
inactive / failed / unsupported / non-conforming / unknown / ok; fixed
`status` method under the catalog's RPC ID only, 4 in flight, 8 s each;
full output validation, marker mismatch and path-like `appVersion`
refused; ownership rechecked with `assertCurrent` after the calls;
catalog internals never returned.
- **Plugin add** (AC-P7, D18): recognised `native` integrations are
Global-only (`global-only`, 10 locales); registry and Git specs of one
integration are duplicates.
- **UI store** `stores/integrations-store.ts`: demand reads, 300 ms
coalescing of `rpc.neuralnomads.<app>.*`, `plugin.updated`,
`config.updated`, no polling. Mounted by C4.
- Docs: `dev-docs/OPENCODE_INTEGRATIONS.md`, `PLUGIN_CONTROLS.md`; help
`integrations.md` in English and the nine translations.
## Validation
- `node --import tsx --test
packages/server/src/opencode/integrations/catalog.test.ts` (11 pass,
local release server)
- `node --import tsx --test
packages/server/src/opencode/integrations/recognition.test.ts` (8 pass)
- `node --import tsx --test
packages/server/src/server/routes/integrations.test.ts` (4 pass)
- `node --import tsx --test
packages/server/src/opencode/plugin-sources.test.ts` (11 pass)
- `node --import tsx --test
packages/ui/src/stores/integrations-store.test.ts` (4 pass)
- `node --import tsx scripts/test-integrations-recognition-native.mjs
<opencode 2.2.5 cli>`: PASS (added to the runtime matrix)
- Server and UI typecheck; `npm run test:help` pass.
File sizes: `http-server.ts` ~2500 lines (+7), `index.ts` ~790 (+2),
`pr-build.yml` ~770.