Certifier · Tools

Operations Toolkit

The Operations Toolkit is a repository-based command-line support system for generating, validating, and organizing Satoshium Certifier certification artifacts from a canonical Certification Package.

It supports Certifier operations, repeatability, and release readiness. It does not define standards, replace methodology, or certify anything by itself.

Open README Workflow Guide Artifact Reference Example Certification
Legacy protocol contract: the current command-line toolkit generates historical SCHR and SATR request stubs and uses a 13-file placeholder-based release check. These are not canonical Chronicle CHR entries or Attestor ATT/TRST objects. Registry and Anchor stubs are likewise not institution-issued records. The checker does not establish certification, conformance, other institutions’ decisions, or permission to publish; downstream participation is conditional, not a mandatory Suite-wide pipeline. A migration of the runnable formats requires separate implementation tests.

Execution note: this page does not run Python in the browser. The toolkit runs locally from the command line or through GitHub Actions. This page serves as the operating console, documentation index, and quick-start guide.
Certification Package
↓
SCPR
↓
SCR
↓
SCRD HTML / SCRD JSON
↓
Legacy request stubs: SREG / SCHR / ANCH / SATR Illustrative local generator outputs, not a mandatory Suite pipeline or institution-issued downstream records.

Operational Role

The toolkit helps turn one canonical Certification Package into structured reports, receipts, certified records, evidence references, and integration stubs. It is an operational helper for Certifier, not an independent authority.

v0.1.0Initial toolkit version
CLINo hosted service required
PythonStandard library only
Repo-BasedStored and run from GitHub

Local Execution

Run these commands from the toolkit folder:

cd certifier/tools/ops-toolkit

python scripts/new_certification.py SC-CERT-2026-0002
python scripts/validate_certification.py output/SC-CERT-2026-0002
python scripts/generate_artifacts.py output/SC-CERT-2026-0002
python scripts/check_release.py output/SC-CERT-2026-0002
Generated certification folders should remain under output/ unless a completed record is intentionally preserved elsewhere.

GitHub Actions

The validation workflow should live at the repository root so GitHub can run it after each push. 

.github/workflows/certifier-ops-toolkit.yml

The workflow is intended to confirm syntax, imports, unit tests, fixture behavior, smoke checks, and release-readiness logic before the toolkit is relied upon operationally.

Recommended

Canonical Source

The Certification Package remains the authoritative source object.

certification_package.json certification_package.md

Generated Outputs

Reports, receipts, and certified records are generated from the package.

SCPR SCR SCRD HTML SCRD JSON

Suite References

Stub records prepare the certification for Suite integration.

SREG SCHR ANCH SATR

Artifact Set

The toolkit organizes the full operational artifact set used by Certifier.

  • Certification Package JSON
  • Certification Package Markdown
  • Satoshium Certification Process Report — SCPR
  • Satoshium Certification Receipt — SCR
  • Satoshium Certified Record — SCRD HTML
  • Satoshium Certified Record — SCRD JSON
  • Evidence Inventory JSON
  • Evidence Map Markdown
  • SREG Registry Entry JSON stub
  • SCHR Chronicle Record JSON stub
  • ANCH Anchor Reference JSON stub
  • SATR Attestation Record JSON stub
  • Release Checklist Markdown

Recommended Use

  • Use the toolkit to harden SC-CERT-2026-0000.
  • Use generated outputs to test repeatability.
  • Use the legacy release check for local completeness only; publication requires separate Certifier-governed authorization.
  • Use GitHub Actions as the final sanity check before relying on generated artifacts.
Operational Support

Important Boundaries

  • The toolkit does not certify by itself.
  • The toolkit does not define Suite Standards.
  • The toolkit does not replace Suite Methodology.
  • The toolkit does not host a public service.
  • The toolkit does not require Replit after export.
Bounded

Toolkit Role

Certifier remains the reference implementation for certification across the Satoshium Suite. The Operations Toolkit provides repeatable mechanical support for generating, validating, organizing, and checking the artifacts produced through that implementation.

A trustworthy certification process should not depend on memory, improvisation, or manual formatting. The toolkit preserves repeatability while leaving certification judgment where it belongs: in the Suite Standards, Suite Methodology, and Certifier workflow.
Repeatable tooling strengthens repeatable trust.