Skip to content
Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

JEP GitHub Action v0.6

GitHub Action seed for generating JEP v0.6 event artifacts from GitHub workflow activity.

This repository replaces the earlier JEP-04 / accountability-receipt demo language with a JEP v0.6 workflow integration seed.

Positioning

This action generates JEP-style event artifacts for GitHub workflows.

It is intended for:

  • pull request review traces;
  • issue triage events;
  • workflow approval events;
  • release or deployment decision records;
  • CI/CD audit artifacts.

It does not determine:

  • legal liability;
  • factual truth;
  • regulatory compliance;
  • authorization validity;
  • complete-log availability;
  • moral responsibility.

A generated event artifact is a structured protocol object. It is not a legal conclusion.

Alignment

Aligned with:

  • JEP-Core: draft-wang-jep-judgment-event-protocol-06
  • JEP-Profiles: draft-wang-jep-profiles-00
  • JEP-Conformance: draft-wang-jep-conformance-00

Public draft:

https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol/

What this Action emits

The action emits:

  • a JEP v0.6-style event JSON object;
  • an algorithm-tagged event hash;
  • a JEP-style validation result;
  • optional artifact upload.

The action can run in two modes:

ModeMeaning
artifactGenerate unsigned local JEP event artifacts
apiSend the event draft to a JEP API signer/verifier

In artifact mode, the action intentionally uses:

sig: "UNSIGNED-WORKFLOW-ARTIFACT"

It does not pretend that a local hash is a signature.

For signed events, configure mode: api and provide a JEP API endpoint.

Usage

name: JEP Event Artifacton:
pull_request:
workflow_dispatch:
jobs:
jep:
runs-on: ubuntu-lateststeps:
- uses: actions/checkout@v4
- uses: hjs-spec/jep-github-action@v0.6.0id: jepwith:
mode: artifactverb: Jactor: ${{ github.actor }}subject: ${{ github.event_name }}relation: workflow-eventupload_artifact: true
- run: echo "${{ steps.jep.outputs.jep_event_hash }}"

Inputs

InputDefaultDescription
modeartifactartifact or api
verbJJEP verb: J, D, T, or V
actor${{ github.actor }}Actor identifier
subject${{ github.event_name }}Event subject
relationworkflow-eventWorkflow relation note
audience${{ github.repository }}Intended audience/context
jep_api_urlemptyOptional JEP API endpoint for api mode
upload_artifacttrueUpload generated JSON artifact

Outputs

OutputDescription
jep_event_hashAlgorithm-tagged event hash
jep_event_jsonGenerated JEP event JSON
validation_result_jsonJEP-style validation result
artifact_pathLocal artifact path

Boundary

This action does not define a new JEP protocol.

It does not replace:

  • JEP-Core;
  • JEP-Profiles;
  • JEP-Conformance;
  • HJS;
  • JAC;
  • legal or regulatory systems.

Related resources

About

GitHub Action seed for generating JEP v0.6 event artifacts from pull requests, issues, and workflow events.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages