From 768dd5d52f1464e4108e66fdb21ff8ad7d896c2f Mon Sep 17 00:00:00 2001 From: Midia Kiasat Date: Sun, 8 Mar 2026 12:40:02 +0100 Subject: [PATCH] Unify guillotine public package surface and release contract --- .npmignore | 6 ++ README.md | 159 +++++++++++++++++++++++++++++++-------------------- package.json | 26 +++++++++ 3 files changed, 130 insertions(+), 61 deletions(-) create mode 100644 .npmignore create mode 100644 package.json diff --git a/.npmignore b/.npmignore new file mode 100644 index 0000000..52a5670 --- /dev/null +++ b/.npmignore @@ -0,0 +1,6 @@ +* +!guillotine.sh +!README.md +!LICENSE +!VERSION +!package.json diff --git a/README.md b/README.md index ef299b3..15d928b 100644 --- a/README.md +++ b/README.md @@ -1,111 +1,148 @@ -``` -PRIM-001 -GUILLOTINE -Irreversible execution +# GUILLOTINE -STATUS: REGISTERED -REGISTRY: https://speedkit.eu -SNAPSHOT: https://speedkit.eu/REGISTRY_SNAPSHOT.json -``` +Primitive ID: PRIM-008 +Package: @verifrax/guillotine +Binary: guillotine -Registered artifact. Identity governed by SPEEDKIT registry. +Verifrax primitive — termination primitive for deterministic irreversible systems. -STATUS: FINAL +--- + +## Status + +Current release status: pre-stable primitive release line. + +Canonical release target: + +package version: 0.1.0 +tag: v0.1.0 + +GUILLOTINE is part of the Verifrax primitive layer and follows the canonical primitive governance, naming, version, and packaging rules. --- -Guillotine enforces decisions you already made and failed to execute. +## Purpose -It is a **Claude Code–native execution utility**. -It is not configurable. -It does not ask questions. -It does not wait for certainty. +GUILLOTINE terminates lifecycle state after origin, custody, time, boundary, verification, attestation, and judgment have already been completed. -If output is incomplete, speculative, misaligned, or weak, -**Guillotine deletes it. Immediately. Permanently.** +Once a system has established origin, preserved custody, fixed temporal order, enforced operational boundaries, completed verification, produced attestation, and rendered judgment, it still needs a final primitive that can irreversibly terminate the lifecycle under deterministic rules. GUILLOTINE exists to perform that role. + +It does not establish origin. It does not preserve custody. It does not set time boundaries. It does not enforce boundaries. It does not perform verification. It does not attest. It does not judge. Its role is narrower: final irreversible termination. --- -## Philosophy +## What This Primitive Does -Guillotine exists to **force execution where intent already exists**. +- terminates lifecycle state after deterministic judgment +- produces final irreversible termination output +- closes the primitive chain with a deterministic final state -It is designed for moments where: +--- -* A decision has been made -* Delay has become avoidance -* Reversibility is the enemy +## What This Primitive Does Not Do -Guillotine does not help you decide. -It ends the opportunity to hesitate. +- does not establish first origin +- does not preserve custody continuity +- does not fix temporal ordering +- does not enforce operational boundaries +- does not perform primary verification itself +- does not create attestation witness state +- does not render judgment --- -## Behavior +## Behavioral Contract -* Detects any uncommitted or unresolved state -* Deletes it without inspection -* Leaves the repository intentionally scarred -* Exits non-zero with intent +Invocation model: -No retries. -No previews. -No recovery. +executable: guillotine +package: @verifrax/guillotine +runtime: CLI-first ---- +The primitive operates only after origin, custody, time, boundary, verification, attestation, and judgment are already complete. -## Non-Features +If no stable judgment state exists, GUILLOTINE must not fabricate termination. -* No flags -* No modes -* No configuration -* No safety -* No discussion +Exit codes: -Anything reversible is rejected by design. +0 — termination completed successfully +non-zero — invocation failed or contract violated --- ## Usage -Drop `guillotine.sh` into a git repository. +Install: + +npm install -g @verifrax/guillotine + +Execute: -Run it. +guillotine artifact.json -```sh -./guillotine.sh -``` +stdin example: -If you pause, abort. +cat artifact.json | guillotine --- -## Contract +## Determinism Guarantees -You run Guillotine knowing: +For identical canonical input, GUILLOTINE must produce identical termination output. -* loss is expected -* responsibility is yours -* blame is invalid +No hidden environmental state may influence the result. -Discomfort is confirmation. +GUILLOTINE assumes all prior primitives have already constrained origin, custody, time, boundary, verification, attestation, and judgment. It is the final primitive in the chain and must not re-open prior state. --- -Guillotine is working if you feel resistance. +## Security Model + +GUILLOTINE protects against ambiguity in final lifecycle termination. + +Its security value is to ensure that final closure is rendered from already-determined upstream state under deterministic rules. It does not replace earlier primitives and must not mutate prior evidentiary meaning. + +--- + +## Relationship to Other Primitives + +Canonical primitive order: + +1 originseal +2 archicustos +3 kairoclasp +4 limenward +5 validexor +6 attestorium +7 irrevocull +8 guillotine + +Repositories: + +https://github.com/Verifrax/originseal +https://github.com/Verifrax/archicustos +https://github.com/Verifrax/kairoclasp +https://github.com/Verifrax/limenward +https://github.com/Verifrax/validexor +https://github.com/Verifrax/attestorium +https://github.com/Verifrax/irrevocull +https://github.com/Verifrax/guillotine --- -## Responsibility Boundary +## Installation -This software is provided under the MIT License. +npm install -g @verifrax/guillotine -The MIT License permits use, copying, modification, and redistribution of the code, but it does not provide assurance, certification, audit defense, operational guarantees, or liability coverage. +command -v guillotine -Use of this software in environments where failure, compliance, legal exposure, or irreversible decisions matter requires an accountable party. +Repository: +- GitHub: https://github.com/Verifrax/guillotine +- Package: @verifrax/guillotine +- Binary: guillotine -The original maintainer is available for assurance, adaptation, and responsibility when such accountability is required. +--- -Contact: contact@speedkit.eu +## License -Authoritative signed records are issued separately and are not produced by the software. +MIT diff --git a/package.json b/package.json new file mode 100644 index 0000000..8637665 --- /dev/null +++ b/package.json @@ -0,0 +1,26 @@ +{ + "name": "@verifrax/guillotine", + "version": "0.1.0", + "description": "Verifrax primitive — termination primitive for deterministic irreversible systems.", + "license": "MIT", + "repository": { + "type": "git", + "url": "git+https://github.com/Verifrax/guillotine.git" + }, + "homepage": "https://github.com/Verifrax/guillotine#readme", + "bugs": { + "url": "https://github.com/Verifrax/guillotine/issues" + }, + "bin": { + "guillotine": "guillotine.sh" + }, + "files": [ + "guillotine.sh", + "README.md", + "LICENSE", + "VERSION" + ], + "publishConfig": { + "access": "public" + } +}