Skip to content

0.10.0-S03: Plugin SDK: versioned capability contract and example plugin #470

Description

@mberrys

Session 0.10.0-S03 · type contract · milestone 0.10.0 — Platform Hardening, Extension Ecosystem & 1.0 Readiness

GA preparation. All graduated-automation stages hardened.

Delivers

Plugin SDK: capability contract docs plus example plugin.

Scope and ownership boundary

  • This session owns: One schema/identity/state-machine contract plus fixtures.
  • This session may not: Persistence, UI, surfaces.
  • The milestone must not create: new product-scope features hiding as "hardening", a web shell, or a second language runtime.
  • Out of scope for the milestone: New capability families; anything that widens authority boundaries.

Tasks

  • Turn the 0.1.1/0.2.0 capability and ABI boundaries into documented, versioned contracts.
  • Write the SDK documentation for those contracts.
  • Build an example plugin that depends only on the documented contract.
  • Prove no plugin truth paths exist: plugins cannot become a source of verdict truth.
  • Prove the example plugin builds and runs against the documented contract alone.
  • Produce the session handoff packet (exact SHA, changed files, tests run, deviations, remaining risks) — the only valid inter-session interface.

Dependencies

Parallel lanes

Sanctioned parallelism for 0.10.0: S02/S03 after S01; S05/S07/S08 as independent lanes; S09 after S03 and S07.

Lanes run concurrently only where the session map marks them; concurrency outside the sanctioned lanes is not permitted.

Exit evidence

Example plugin builds against the documented contract only.

PR titles, commit messages, and document headlines are never acceptance evidence. Only this session's exit evidence, on an exact SHA, closes this gate.

Milestone context

Objective. Declare and freeze the 1.0 public contract surface (CLI envelopes, persisted schema kinds, plugin capability ABI, documented behaviour) with a deprecation policy; ship the versioned plugin SDK with admission policy and threat review; run the performance/scale program on named benchmark identities; harden distribution (signing procurement decision, update channel, SmartScreen exit); decide macOS explicitly; refresh the security/privacy audit; complete operator documentation; and assemble the 1.0 readiness dossier with release-candidate criteria demonstrated on an exact SHA.

Stop rules. A contract that cannot be fixture-frozen is redesigned or labelled experimental - never silently promised. Scale/performance failures block the release candidate; missing platform evidence is unavailable, not PASS.

Authoring note

Per the rolling-wave rule in section 7 of the roadmap, the fully executable specification for this session (exact starting SHA, allowed layers and files, components to reuse, named tests, escalation conditions) is authored when the milestone activates, after its S00 reconcile. This issue carries the fixed frame — objective, boundary, dependencies, and exit evidence — and is refined, not replaced, at activation.


Full context: docs/ROADMAP_0.5.0-0.10.0.md section 4.6 and docs/github-milestones/0.10.0.md.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions