From f1799f75c77000af73c3175efe8f9072f8177c27 Mon Sep 17 00:00:00 2001 From: Midia Kiasat Date: Mon, 2 Mar 2026 20:21:12 +0100 Subject: [PATCH] docs: standardize readme baseline --- README.md | 217 +++++++----------------------------------------------- 1 file changed, 28 insertions(+), 189 deletions(-) diff --git a/README.md b/README.md index 9808ce9..7a1610e 100644 --- a/README.md +++ b/README.md @@ -1,207 +1,46 @@ -``` -PRIM-008 -KAIROCLASP -Temporal finality - -STATUS: REGISTERED -REGISTRY: https://speedkit.eu -SNAPSHOT: https://speedkit.eu/REGISTRY_SNAPSHOT.json -``` - -Registered artifact. Identity governed by SPEEDKIT registry. - -STATUS: FINAL - ---- - -**KAIROCLASP v0.0.0** is a temporal finality primitive. - -It does not decide. -It does not verify. -It does not witness. -It does not execute. -It does not judge. -It does not enforce custody. - -It **locks time**. - -KAIROCLASP exists to bind an action, claim, or state to a moment that cannot be replayed, deferred, or reinterpreted later. - ---- - -## Philosophy - -Many failures are not about *what* happened. -They are about *when* it is claimed to have happened. - -Deadlines slip. -Timelines are rewritten. -Moments are retroactively reframed. - -KAIROCLASP exists to answer one question only: - -> **Is this moment still valid, or has it expired?** - -Once time is clasped, the window closes. - ---- - -## What KAIROCLASP Is - -KAIROCLASP is a **temporal boundary primitive**. - -It binds: - -* Declared UTC time (via `stdin`) -* Repository identity -* Commit context -* Evaluation timestamp - -Into a single, irreversible temporal record. - -The result is **temporal finality**. - ---- - -## What It Is Not - -* Not a scheduler -* Not a cron system -* Not a deadline manager -* Not a clock source -* Not a validator -* Not a judge - -KAIROCLASP does not manage time. -It **eliminates ambiguity about time**. - ---- - -## Behavior - -* Consumes temporal declarations exclusively via `stdin` -* Refuses silent invocation -* Requires an explicit ISO‑8601 UTC timestamp -* Allows sealing exactly once per repository -* Appends a single irreversible record to a temporal ledger -* Emits exactly one verdict -* Exits immediately after evaluation - -No retries. -No flags. -No configuration. +# kairoclasp ---- +## Purpose -## Verdicts +Atomic primitive: time-clasp / temporal binding. -KAIROCLASP emits exactly one of the following: +## Status -* `CLASPED` — the declared moment is valid and has been irreversibly locked -* `EXPIRED` — a temporal clasp already exists and cannot be repeated -* `DENIED` — the time declaration is missing, malformed, ambiguous, or refers to a future moment +- **Stability**: Experimental +- **SemVer**: Not guaranteed until v1.0.0 +- **Security**: See **Security** section below -The verdict concerns **temporal validity**, not correctness. +## Scope ---- +- What this repo is responsible for +- What it explicitly does **not** do -## Usage +## Quickstart -KAIROCLASP is never run casually. -It is invoked only when timing matters irreversibly. +```bash +# clone +git clone https://github.com/Verifrax/kairoclasp.git +cd kairoclasp -```sh - | ./kairoclasp.sh +# install (adjust if needed) +# (placeholder) npm install / pnpm install / go test ./... / etc. ``` -### Example - -```sh -echo "2026-01-18T11:30:00Z" | ./kairoclasp.sh -``` - -If the moment is valid and unclasped: - -```text -CLASPED -``` - -If a clasp already exists: - -```text -EXPIRED -``` - -If the timestamp is invalid or in the future: - -```text -DENIED -``` - ---- - -## Contract - -Once time is clasped: - -* The moment cannot be reused -* Later reinterpretation is invalid -* Deadlines become enforceable facts -* Disputes shift from timing to responsibility - -KAIROCLASP guarantees **no temporal ambiguity**. - ---- - -## Relationship to Other Artifacts - -* **GUILLOTINE** — executes -* **IRREVOCULL** — judges -* **ATTESTORIUM** — witnesses -* **VALIDEXOR** — verifies -* **LIMENWARD** — guards transitions -* **ORIGINSEAL** — seals origin -* **ARCHICUSTOS** — guards custody -* **KAIROCLASP** — locks time - -Each artifact covers exactly one irreversible dimension. -None overlap. - ---- - -## Warning - -Time creates accountability. - -Invoking KAIROCLASP declares: - -* "This moment matters" -* "Delay is no longer acceptable" -* "I accept the consequences of now" - -There is no appeal after time. - ---- - -## About - -KAIROCLASP is a minimal, deterministic temporal finality primitive for irreversible systems. - -If timing does not matter, do not use it. -If it does, nothing else is sufficient. - ---- +## Repository layout -## Responsibility Boundary +- `/` Root sources +- `/.github/` Issue + PR templates +- `/docs/` Documentation (if present) -This software is provided under the MIT License. +## Security -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. +- Report vulnerabilities privately: **security@verifrax.org** +- Do **not** open public issues for sensitive findings -Use of this software in environments where failure, compliance, legal exposure, or irreversible decisions matter requires an accountable party. +## Contributing -The original maintainer is available for assurance, adaptation, and responsibility when such accountability is required. +See `CONTRIBUTING.md`. -Contact: contact@speedkit.eu +## License -Authoritative signed records are issued separately and are not produced by the software. +MIT. See `LICENSE`.