Skip to content

[Contracts] Release procedural graph, guidance context and evaluation receipt contracts #28

Description

@seonghobae

Parent: ContextualWisdomLab/.github#2067. First local implementation: ContextualWisdomLab/noema#585, authored head 5813ee1cb8958aa25e622fe31adfa8dc229f2e3c. This issue requests owner-led contract work; it does not publish a contract or authorize consumers to import that mutable feature branch.

Required deliverables

Publish language-neutral versioned schemas for procedural graph artifacts, advisory execution contexts, evaluation receipts and candidate-screening decisions. Preserve the Noema-local versus released-wire distinction: noema.procedural-graph/v1 and its ordered JSON hashing are local implementation choices, NOT an existing interoperable release.

Graph identity needs tenant/task/graph ID, schema revision, content digest, parent/version lineage, nodes, directed relations and bounded condition/guidance/pitfalls data. Execution context needs exact graph digest, execution/scope identity, localized versus abstained state and advisory_only semantics. Separate graph identity, structure identity, evidence identity, approval and deployment authority.

Define digest/canonicalization rules and equivalent TypeScript/Python/Rust fixtures; reject inconsistent Unicode, number, array ordering or unknown authority-field encodings instead of letting language coercions change identity. Explicitly define relation direction and product-specific terminal/cycle validation profiles. Do not turn advice into executable dependencies.

Evaluation receipts must bind authenticated producer/schema/version, exact candidate/base digests, pre-registered dataset/model/tool/rubric/environment protocol, complete paired held-out case-set identity, evidence timestamps/revocation and score/safety observations. Include strict missing/NaN/infinite/duplicate/mismatched-case rejection fixtures. Authenticated receipt verification and privacy controls are separate from equality of digest strings.

Candidate screening remains non-authoritative: even arithmetic non-regression cannot activate, grant tools, approve a PR or relax policy. Reject-memory identity must include exact base, candidate structure, evaluation protocol and actual case partition/minimum count; don't leak validation examples into refiner prompts or global negative memory.

Acceptance

  • Read live open contracts/EAC lanes; extend the canonical owner lane rather than cloning its source.
  • Add schemas, positive/hostile conformance fixtures, compatibility policy and immutable artifact/provenance evidence.
  • Establish a released version before any cross-repository production consumer is enabled.
  • Have Noema and at least one independent consumer prove the same canonical digests and fail-closed conformance.
  • Link exact release and consumer evidence to the parent adoption matrix.

No cross-service SQL, copied provider routing, raw credential/PII/hidden-reasoning storage, or sibling PR-head runtime dependency. Existing policy/approval and Keyverse ownership remain unchanged.

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

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions