Skip to content

Separate generic capability, selected proof, and portability evidence in the checked roadmap #134

Description

@George-RD

What to build

Design report: Can openspine-schemas and openspine-authority natively carry (tenant, principal, contact) as identity dimensions without violence to the current design? Separate generic capability, selected proof evidence, and portability evidence as distinct findings.

Acceptance criteria

  1. Analyze current schema and authority structure. 2. Propose native (tenant, principal, contact) dimensions. 3. Identify schema changes required. 4. Document design report with findings (no implementation).

Blocked by

None (assessment; findings feed T21)

Original report

Why

The current checked capability map names the missing capability as recurring Gmail drafts and then also selects recurring Gmail drafts as the starter proof. That conflates three different truths:

  1. generic capability — protocol-neutral progressive delegation / reviewed reusable responsibility;
  2. selected vertical proof — recurring Gmail draft creation for one reviewed scope;
  3. portability status — whether a second materially different protocol has demonstrated that the architecture is not secretly Gmail-specific.

This confusion propagates into the generated public roadmap and makes implementation details look like the product architecture. The capability map is intended to prevent documentation overclaiming, so its schema must be able to represent the corrected dependency/evidence model.

Scope

1. Capability-map schema

Extend capabilities/capability-map.json and its validator/renderer to represent, at minimum:

  • generic capability ID and owner outcome;
  • state: runtime substrate, product surface missing, proof in progress, wired into Lyra;
  • architecture/dependency issues or settled changes;
  • selected proof IDs as separate records;
  • proof scope and current limits;
  • named owner-path tests required to mark the generic capability wired;
  • portability/conformance evidence distinct from the first proof;
  • later maturity stage for whole-responsibility composition.

The schema should not treat issue numbers as runtime evidence. Issues explain blockers; archived changes, artifact paths, and named tests prove landed behavior.

2. Correct the current records

Represent:

Keep the existing selected Gmail workflow because it is still the best first proof; stop describing it as the capability itself.

3. CI truth rules

  • A generic capability cannot be wired_into_lyra without named owner-path tests for a real positive effect and required fallback/control cases.
  • A proposal renderer, standing-rule activation test, or runtime primitive alone cannot satisfy the owner-path requirement.
  • The selected proof may be marked complete independently of portability, but public copy must then say “first shipped proof,” not “works across protocols.”
  • Portability cannot be marked verified until the second-protocol conformance suite in Prove progressive delegation is portable across communication protocols #131 passes.
  • Whole-responsibility maturity cannot be inferred from one effect shortcut.
  • Every evidence path and test name remains checked, as today.
  • The generated roadmap remains deterministic and replaces only its generated block.

4. Public roadmap output

The generated section should show a dependency/maturity structure such as:

Progressive delegation — product surface missing
  Landed substrate: ...
  Architecture contract: #126
  Execution/review foundations: #127, #129
  Scoped evidence/matching: #128
  Proposal-specific evaluation: #133
  Selected proof: recurring Gmail drafts (#130)
  Portability proof: second communication shape (#131)
  Whole-responsibility progression: #132

Do not render open issues as if they were shipped features.

Tests

Use TDD on the Node capability-map tooling:

  • generic capability and proof are distinct schema objects;
  • exactly one selected next proof remains supported without requiring that proof to be the capability;
  • a completed proof without owner-path tests fails validation;
  • a generic wired claim based only on runtime changes fails;
  • a portability claim without second-protocol evidence fails;
  • issue dependencies render as blockers, not repository proof;
  • deterministic rendering and existing archived-change/path checks remain intact;
  • migration from the current JSON schema is explicit and validated.

Done when

Relationship

Parent: #123.

Depends on vocabulary from #126. It may land before the runtime foundations as a truthful roadmap/tooling slice, but it must not mark any missing capability complete.

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

    ready-for-agentFully specified, ready for an AFK agent

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions