Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
220 changes: 73 additions & 147 deletions README.md

Large diffs are not rendered by default.

38 changes: 38 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# A field guide to KairoTensor

[Project overview](../README.md) · [Paper](submission/kairotensor-report.pdf) · [Evidence index](submission/EVIDENCE.md)

The project studies a practical epistemic boundary: when a stored conclusion may still be used after its declared evidence changes. Read the paper for the measured research question; use the contract pages to understand the current implementation.

## Follow the evidence

| Stage | Question | Read |
| --- | --- | --- |
| **01 · Capture** | Which occurrences and exact bytes did this attempt receive? | [Store and execution guide](store-guide.md) · [Corrected handoff](corrected-handoff.md) |
| **02 · Qualify** | Is the head eligible now, and why? | [Current eligibility](current-eligibility.md) · [Atomic correction](atomic-correction.md) |
| **03 · Execute** | Can this request be sent within the declared resource and timing contract? | [Token preflight](token-cap-protocol.md) · [Budgeted recovery](budgeted-recovery.md) · [Runtime boundary](recovery-runtime.md) |
| **04 · Reuse or replay** | Can a prior result be reused, or a recorded request reconstructed? | [Scoped reuse](scoped-model-reuse.md) · [Decision replay](decision-replay.md) |
| **05 · Evaluate** | What changed in the decision, cost and failure behavior? | [Revision benchmark](revision-benchmark.md) · [Controlled correction pilot](controlled-correction-results.md) · [Policy promotion](policy-promotion.md) |

## Three kinds of evidence

**Measured research.** The sprint paper freezes source `20fab84`. Its [evidence index](submission/EVIDENCE.md) maps every principal result to samples, prompts or archived responses. The [later correction pilot](controlled-correction-pilot.md) has a separate source/model identity and is not silently added to the paper.

**Implemented contracts.** Rust tests and offline fixtures cover eligibility, atomic correction, the [Store-backed incident bridge](incident-store-bridge.md), replay and policy activation. A passing contract test establishes the tested behavior, not semantic model accuracy.

**Prepared experiments.** The [incident workload](incident-routing-workload.md), [Transformers backend](incident-transformers-backend.md), [Adaption contract](incident-adaption-backend.md) and [hosted runner](incident-hosted-runner.md) specify execution boundaries. Their offline tests do not establish live provider compatibility, billing reconciliation or comparative performance. Read each page's execution limits before running it.

## For reviewers

1. Read the [submission guide](submission/README.md) and the paper's contribution and limitations sections.
2. Follow a claim through the [evidence index](submission/EVIDENCE.md) to the pinned raw artifact.
3. Recompute archived summaries with the documented commands. Keep this distinct from re-executing or independently authenticating a model run.
4. Review [later reliability changes](reliability-review-guide.md) separately from the measured snapshot.

## For implementers

The [Store guide](store-guide.md) retains the detailed API and accounting contracts. [Deadline-aware recovery](deadline-aware-recovery.md), the [timed runner](timed-recovery-runner.md), [decision bundles](decision-replay.md), [policy transitions](policy-promotion.md) and [offline ablations](decision-ablation.md) describe distinct boundaries. None replaces current admission or grants an independent send permission.

The [original v0 design](memory-v0.md) records research direction. Its historical implementation-status passages are not an inventory of today's code. The Python reference covers additional proposed semantics; do not assume every reference behavior exists in the Rust Store.

For this workstation, consult the [runtime launcher](runtime-adoption.md) and [runtime qualification](runtime-adoption.md). For hosted checks, use the exact commit's [Actions results](https://github.com/k2jac9/kairotensor/actions), including integration stages and any reported skips.
27 changes: 27 additions & 0 deletions docs/assets/public-presentation/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Public presentation assets

Original vector artwork for KairoTensor's repository landing page. The diagrams
are conceptual illustrations, not measurements, causal proofs, or evidence of
model execution. The lifecycle is deliberately simplified; linked contract pages
remain the authority for reserve/claim/settlement and reuse behavior.

| Token | Color | Use |
| --- | --- | --- |
| Midnight | `#0B1023` | Diagram background |
| Paper | `#F4F6FC` | Main lettering |
| Mist | `#C1CBE0` | Supporting lettering |
| Cyan | `#66E4EA` | Evidence and eligibility |
| Violet | `#C4AFFB` | Captured attempts and change |
| Amber | `#F5CE7A` | Accounting |
| Print teal | `#12566A` | Paper heading accent on white |

`hero.svg` and `evidence-lifecycle.svg` are editable sources with embedded titles
and descriptions, explicit view boxes, no scripts, no remote assets and no font
fetches. Labels accompany all color distinctions. README alternative text and
surrounding prose carry the same information for readers who cannot see the art.
GitHub embeds the SVGs as images; both include their own dark background for
consistent contrast in light and dark themes. DejaVu Sans/Arial are fallback fonts,
not bundled dependencies. No photographic or generated-image source is used.

The report retains its academic template. Its restrained teal headings and pale
blue table headers share this palette without importing the dark cover artwork.
18 changes: 18 additions & 0 deletions docs/assets/public-presentation/evidence-lifecycle.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 35 additions & 0 deletions docs/assets/public-presentation/hero.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading