Skip to content

feat: declare weaver-spec v0.1.0 compatibility + add conformance CI stub#65

Merged
dgenio merged 6 commits intomainfrom
copilot/declare-weaver-spec-v0-1-0-compatibility
Apr 12, 2026
Merged

feat: declare weaver-spec v0.1.0 compatibility + add conformance CI stub#65
dgenio merged 6 commits intomainfrom
copilot/declare-weaver-spec-v0-1-0-compatibility

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 11, 2026

agent-kernel already satisfies weaver-spec invariants I-01/I-02/I-06 but had no formal declaration or automated validation. This PR makes the alignment explicit and hooks CI to run the conformance suite once it ships.

Changes

README.md

  • New "Weaver Spec Compatibility: v0.1.0" section with an invariant table mapping each requirement to its implementation:
Invariant Satisfied by
I-01 Firewall always transforms RawResult → Frame
I-02 PolicyEngine + HMACTokenProvider + TraceStore on every invocation
I-06 Tokens bind principal_id + capability_id + constraints + TTL + revocation

.github/workflows/ci.yml

  • Added conformance job (gated on test) with a stub step and inline comment showing the exact replacement once dgenio/weaver-spec#4 ships:
    # Replace with:
    #   pip install weaver-contracts
    #   python -m weaver_contracts.conformance --target agent_kernel

CHANGELOG.md

  • [Unreleased] entry for the compatibility declaration and conformance stub.

Copilot AI linked an issue Apr 11, 2026 that may be closed by this pull request
3 tasks
Copilot AI changed the title [WIP] Add weaver-spec v0.1.0 compatibility declaration and CI job feat: declare weaver-spec v0.1.0 compatibility + add conformance CI stub Apr 11, 2026
Copilot AI requested a review from dgenio April 11, 2026 10:56
@dgenio dgenio requested a review from Copilot April 11, 2026 11:04
@dgenio dgenio marked this pull request as ready for review April 11, 2026 11:04
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR makes agent-kernel’s alignment with weaver-spec v0.1.0 explicit in documentation and adds a CI job scaffold intended to run the upstream conformance suite once it becomes available.

Changes:

  • Documented weaver-spec v0.1.0 compatibility in README.md with an invariant-to-implementation mapping (I-01/I-02/I-06).
  • Added a new conformance GitHub Actions job (currently a stub) gated on the existing test job.
  • Added a changelog entry describing the compatibility declaration and CI stub.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File Description
README.md Adds a weaver-spec compatibility section and invariant mapping table.
.github/workflows/ci.yml Introduces a conformance job scaffold intended to run the future weaver-spec suite.
CHANGELOG.md Records the README compatibility declaration and the new CI stub job.

dgenio added 4 commits April 11, 2026 19:29
- README I-01: correct claim that raw output is 'never returned';
  raw mode exists but is restricted to admin principals only
- README I-06: fix revoke_token() → revoke(token_id) and
  revoke_all() → revoke_all(principal_id) to match actual API
- ci.yml: rename job conformance → conformance_stub and display
  name to make stub status unambiguous in PR check summaries
- ci.yml: add comment clarifying weaver-contracts (pip) vs
  weaver_contracts (Python module) naming difference

Addresses copilot-pull-request-reviewer comments on PR #65.
…state

weaver-spec is published (v0.2.0) but weaver_contracts.conformance
does not yet exist (dgenio/weaver-spec#4 still open). Update:
- Echo messages: spec IS published; runner specifically is not yet available
- pip install comment: use git+https install path (not bare package name;
  not on PyPI) and correct distribution name weaver_contracts (underscore)
- Remove now-redundant hyphen/underscore clarifying comment (replaced
  by the git+https install path which sidesteps the naming ambiguity)
weaver-contracts 0.2.0 is on PyPI. Replace git+https install path
with bare pip install weaver-contracts. Add inline comment clarifying
that PyPI dist name uses a hyphen while the Python module uses an
underscore (weaver_contracts).
The internal invariants.md and AGENTS.md had I-02 mapped to budget
enforcement (size/depth/field count). The weaver-spec defines I-02 as
'Every Execution Is Authorized and Auditable'. Fix all affected files
to use the correct weaver-spec definition:

- AGENTS.md: I-02 → authorization + auditability; add note that budget
  enforcement is an agent-kernel implementation constraint (not a
  separate weaver-spec invariant number)
- docs/agent-context/invariants.md: same correction; add blockquote
  clarifying budget enforcement's relationship to I-01
- README.md I-02 'How satisfied' cell: replace claim that
  PolicyEngine evaluates every invocation (incorrect — it runs at
  grant time only) with accurate two-phase description:
  PolicyEngine at grant time, verify() at invoke(), TraceStore always
- ci.yml: drop version numbers from stub comment to avoid v0.1.0/v0.2.0
  mismatch (whoever activates the stub will pin the right version)
- CHANGELOG: fix job name reference conformance → conformance_stub
@dgenio dgenio merged commit e2ff8a7 into main Apr 12, 2026
8 checks passed
@dgenio dgenio deleted the copilot/declare-weaver-spec-v0-1-0-compatibility branch April 12, 2026 10:47
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.

Declare weaver-spec v0.1.0 compatibility + run conformance in CI

3 participants