pocket-enterprise
Pocket Enterprise
Pocket Enterprise is an optional, additive adapter for teams that explicitly choose remote lifecycle synchronization. Install the Enterprise role beside its matching Core role; it does not bundle or copy Core skills.
Core principle: Core commits local state and neutral lifecycle events first. Core does not call gh, does not merge pull requests, and does not close issues. The adapter validates compatibility before any external operation, reconciles events deterministically, and leaves ambiguous ownership for a human.
Release and compatibility
The surfaces.json manifest has schema 1 and defines exactly pi/core, pi/enterprise, claude/core, and claude/enterprise. Enterprise roles are deltas requiring their matching Core role. Release versions are package 4.2.1, CLI CONTRACT=3, PIPELINE=5, lifecycle schema 2, adapter contract 2, and surface manifest 1; these are independent version boundaries.
| Core | Enterprise | Result |
|---|---|---|
| v3 | v3 | Legacy installation remains operational with a v4 warning. |
| v4 | v4 | Supported. |
| v4 | absent | Core remains local-first; pending events are retained without GitHub calls. |
| v3 | v4 | Enterprise fails closed with Core upgrade guidance; v3 Core remains usable. |
| v4 | v3 | The adapter fails closed with Enterprise upgrade guidance; pending v4 events are retained. |
The v4 preflight warns about legacy v3 installations; an unchanged v3 binary cannot warn about a future release. Never infer consent from a remote or credentials. A registration must declare adapter contract 2; reinstall the adapter after upgrading, because a contract 1 registration fails preflight with ENTERPRISE_ADAPTER_CONTRACT_MISMATCH. Follow references/onboarding.md for setup, phase-branch options, and registration.