Unify irrevocull public package surface and release contract

.npmignore

@@ -0,0 +1,6 @@
+*
+!irrevocull.sh
+!README.md
+!LICENSE
+!VERSION
+!package.json

README.md

@@ -1,128 +1,148 @@
-```
-PRIM-002
-IRREVOCULL
-Irreversible judgment
+# IRREVOCULL
 
-STATUS: REGISTERED
-REGISTRY: https://speedkit.eu
-SNAPSHOT: https://speedkit.eu/REGISTRY_SNAPSHOT.json
-```
+Primitive ID: PRIM-007  
+Package: @verifrax/irrevocull  
+Binary: irrevocull
 
-Registered artifact. Identity governed by SPEEDKIT registry.
+Verifrax primitive — judgment 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
+
+IRREVOCULL is part of the Verifrax primitive layer and follows the canonical primitive governance, naming, version, and packaging rules.
 
 ---
 
-IRREVOCULL renders irreversible judgments.
+## Purpose
 
-It does not execute.
-It does not repair.
-It does not explain.
+IRREVOCULL renders judgment over an already-fixed verification and attestation state.
 
-It observes output and terminates evaluation.
+Once origin is established, custody is preserved, time is fixed, boundaries are enforced, verification is completed, and attestation has witnessed the result, the system still needs a judgment primitive that can issue a deterministic decision. IRREVOCULL 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 system boundaries. It does not perform primary verification. It does not create the witness layer. It does not terminate lifecycle. Its role is narrower: issue judgment from already-established prior state.
 
 ---
 
-## Philosophy
+## What This Primitive Does
 
-IRREVOCULL exists to **end deliberation**.
+- renders deterministic judgment from prior verified and attested state
+- transforms verified evidence into a judgment outcome
+- produces decision output suitable for final downstream termination or enforcement
 
-It is designed for moments where:
+---
 
-* Evaluation must conclude
-* Ambiguity is unacceptable
-* Responsibility cannot be deferred
+## What This Primitive Does Not Do
 
-Once invoked, the result is binding.
+- 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 terminate lifecycle
 
 ---
 
-## Behavior
+## Behavioral Contract
 
-* Consumes input **exclusively** via `stdin`
-* Emits **exactly one** verdict:
+Invocation model:
 
-  * `PASS` — complete, decisive output
-  * `FAIL` — detected incompleteness or contradiction
-  * `INVALID` — uncertainty, speculation, or misuse
-* Exits immediately after judgment
+executable: irrevocull  
+package: @verifrax/irrevocull  
+runtime: CLI-first
 
-The verdict is final.
+The primitive operates only after origin, custody, time, boundary, verification, and attestation have already been completed.
 
-No retries.
-No flags.
-No configuration.
-No mitigation.
+If no stable attested verification state exists, IRREVOCULL must not fabricate a judgment.
+
+Exit codes:
+
+0 — judgment completed successfully  
+non-zero — invocation failed or contract violated
 
 ---
 
 ## Usage
 
-IRREVOCULL is never run alone.
-It must receive output.
+Install:
+
+npm install -g @verifrax/irrevocull
+
+Execute:
 
-```sh
-<command-producing-output> | ./irrevocull.sh
-```
+irrevocull artifact.json
 
-### Example
+stdin example:
 
-```sh
-echo "final answer" | ./irrevocull.sh
-```
+cat artifact.json | irrevocull
 
-Output:
+---
 
-```text
-PASS
-```
+## Determinism Guarantees
 
-```sh
-echo "maybe later" | ./irrevocull.sh
-```
+For identical canonical input, IRREVOCULL must produce identical judgment output.
 
-Output:
+No hidden environmental state may influence the result.
 
-```text
-FAIL
-```
+IRREVOCULL assumes prior primitives have already constrained origin, custody, time, boundary, verification, and attestation. It does not substitute for any earlier primitive and does not replace final termination.
 
-Running without input:
+---
 
-```sh
-./irrevocull.sh
-```
+## Security Model
 
-Output:
+IRREVOCULL protects against ambiguity in final decision state.
 
-```text
-INVALID
-```
+Its security value is to ensure that a decision is rendered from already-determined evidence under deterministic judgment rules. It does not establish proof surfaces upstream and does not itself terminate lifecycle state.
 
 ---
 
-## Contract
+## Relationship to Other Primitives
 
-Once observed, the verdict stands.
+Canonical primitive order:
 
-Responsibility is absolute.
-Blame is void.
+1 originseal  
+2 archicustos  
+3 kairoclasp  
+4 limenward  
+5 validexor  
+6 attestorium  
+7 irrevocull  
+8 guillotine
 
-If you want nuance, do not run it.
+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/irrevocull
 
-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 irrevocull
 
-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/irrevocull
+- Package: @verifrax/irrevocull
+- Binary: irrevocull
 
-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

package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@verifrax/irrevocull",
+  "version": "0.1.0",
+  "description": "Verifrax primitive — judgment primitive for deterministic irreversible systems.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Verifrax/irrevocull.git"
+  },
+  "homepage": "https://github.com/Verifrax/irrevocull#readme",
+  "bugs": {
+    "url": "https://github.com/Verifrax/irrevocull/issues"
+  },
+  "bin": {
+    "irrevocull": "irrevocull.sh"
+  },
+  "files": [
+    "irrevocull.sh",
+    "README.md",
+    "LICENSE",
+    "VERSION"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}