Skip to content

feat(plugins): add read-only lifecycle control plane - #44

Draft
phodal wants to merge 1 commit into
mainfrom
feat/plugin-lifecycle-control-plane
Draft

feat(plugins): add read-only lifecycle control plane#44
phodal wants to merge 1 commit into
mainfrom
feat/plugin-lifecycle-control-plane

Conversation

@phodal

@phodal phodal commented Aug 1, 2026

Copy link
Copy Markdown
Member

Summary

  • add typed, read-only plugin status, plugin plan, plugin verify, and doctor flows across eight supported hosts and eleven host surfaces
  • centralize validated host profiles, scope/provenance observations, fail-closed planning, native home bindings, and shell-neutral human output
  • keep Pi persistent and session-only loading distinct, isolate Codex CLI/Desktop evidence, and harden Qwen project-scope provenance
  • document the portable lifecycle contract in English and Chinese and add the implementation spec at docs/specs/2026-07-31-better-harness-plugin-lifecycle.md

Why

Lifecycle evidence and mutation planning previously depended on provider-specific assumptions that could borrow discovery, scope, or installation state across surfaces. This change introduces a shared read-only control plane so callers can inspect and plan against explicit evidence without executing host mutations.

Impact

Users and automation can query normalized status, verification, doctor, and deterministic plan envelopes. Unknown, mixed, foreign, or unbound host state fails closed. plugin apply remains intentionally unregistered, so Better Harness does not execute lifecycle mutations.

Validation

  • npm test — 1163/1163 passed
  • node --test test/doc-link-graph.test.mjs — 6/6 passed
  • npm run pack:verify — 401 npm entries and 424 runtime zip entries
  • isolated public CLI smoke — eight doctor targets, eleven lifecycle rows, ready Qwen project install plan, and no real HOME leakage
  • git diff origin/main...HEAD --check

Risk and follow-up

The native help fixture is contract evidence rather than live cross-platform acceptance. Real Codex Desktop, Pi same-session, and Windows host smoke remain follow-up validation boundaries.

Add typed status, plan, verify, and doctor flows across supported host surfaces, with scope-safe observations, fail-closed plans, and isolated home bindings. Split Pi persistent and session-only behavior and document the portable host contracts.

Implements docs/specs/2026-07-31-better-harness-plugin-lifecycle.md. Validation covers npm test (1163/1163), the documentation link graph (6/6), pack verification (401 npm entries and 424 runtime zip entries), and isolated public CLI smoke checks.

Co-authored-by: Codex (GPT 5.6 Sol) <codex@openai.com>
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.

1 participant