Skip to content

feat: clas 10/10 audit — proof field alignment, validator rename, CI, schema mirror, stub cleanup#25

Merged
GsCommand merged 21 commits into
mainfrom
claude/review-commandlayer-audit-4uawt
May 12, 2026
Merged

feat: clas 10/10 audit — proof field alignment, validator rename, CI, schema mirror, stub cleanup#25
GsCommand merged 21 commits into
mainfrom
claude/review-commandlayer-audit-4uawt

Conversation

@GsCommand
Copy link
Copy Markdown
Contributor

Summary

  • Proof field alignment (breaking): Renamed signature_algalg, key_idkid, signersigner_id in schemas/trust-verification/_shared/proof.schema.json and all 10 verb example receipt files (valid.receipt.json, tampered.receipt.json). Matches runtime-core's canonical proof types.
  • Validator package rename: @clas/clas-validator@commandlayer/clas-validator at v1.0.0; added bin.clas-validate CLI entrypoint (packages/clas-validator/bin/validate.js) with auto-detection of verb/kind; added publishConfig: {access: "public"}.
  • CI workflow: Added .github/workflows/ci.yml with two jobs — validate-schemas (runs npm test / validate-trust-verification-examples.mjs) and build-validator (builds the validator package).
  • Schema v1.0.0 mirror: Added schemas/v1.0.0/trust-verification/verify/v1/request.schema.json and receipt.schema.json matching the URL path that runtime-core's schema-client and commandlayer-org expect to fetch over HTTP.
  • Stub family cleanup: Removed all 9 planned-but-empty stub family directories (commerce-payments, communication-outreach, content-creation, data-analytics, identity-compliance, lifecycle-management, logistics-fulfillment, training-optimization, workflow-approval). Plans moved to docs/ROADMAP.md. Root manifest.json updated to list only trust-verification.
  • Root package.json: Added name, version, and test/validate scripts.
  • Housekeeping: Added .gitignore, CHANGELOG.md, SECURITY.md, RELEASING.md.

Test plan

  • CI validate-schemas job passes — all 10 verb valid.receipt.json files validate against updated proof schema; invalid.receipt.json files correctly fail
  • CI build-validator job passes — packages/clas-validator builds without errors
  • schemas/v1.0.0/trust-verification/verify/v1/request.schema.json is reachable at the URL runtime-core expects
  • clas-validate CLI entrypoint auto-detects verb and kind from JSON input
  • No stub family directories remain under schemas/ (only trust-verification and v1.0.0)
  • manifest.json at root lists only trust-verification

Generated by Claude Code

GsCommand added 21 commits May 12, 2026 16:54
…s and examples

BREAKING CHANGE: proof object field names updated to match runtime-core types:
  signature_alg -> alg
  key_id -> kid
  signer -> signer_id

Also: alg is now enum ["ed25519"] not just minLength:1, enforcing
algorithm validation at the schema level rather than trusting the field.

Updated files:
- schemas/trust-verification/_shared/proof.schema.json (field rename + alg enum)
- All 10 verb valid.receipt.json examples
- All 10 verb tampered.receipt.json examples
…ts fetch path

runtime-core/schema-client.ts fetches schemas at:
  /schemas/${lineVersion}/${contract}/${verb}/${version}/request.schema.json

The clas canonical layout (schemas/trust-verification/verify/) serves tooling
and local validation. This v1.0.0 mirror serves the URL structure that
runtime-core and commandlayer-org expect over HTTP.

Added:
  schemas/v1.0.0/trust-verification/verify/v1/request.schema.json
  schemas/v1.0.0/trust-verification/verify/v1/receipt.schema.json

Both use absolute $ref URIs so the mirror is self-contained without
requiring relative path traversal.
@GsCommand GsCommand merged commit dc49fbd into main May 12, 2026
2 of 4 checks passed
@GsCommand GsCommand deleted the claude/review-commandlayer-audit-4uawt branch May 13, 2026 01:45
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