chronos

Files (1)

• SKILL.md

SKILL.md (first lines)

# Chronos System - Temporal Coherence Tracking

**Greek:** χρόνος (chronos) — "time"

**Purpose:** Track epistemic claims across sessions and detect **epistemic drift** — when claims shift, contradict prior claims, or are revised without explicit flagging.

---

## Overview

Chronos maintains a temporal ledger of all epistemic claims, enabling:
- Detection of contradictions between session-N and session-N+k
- Tracking of confidence drift over time
- Identification of unflagged belief revisions
- Visualization of epistemic timelines

---

## Architecture (L1-L4 Pattern)

### L1: Temporal Index Engine
**File:** `temporal_index.py`

Indexes claims by session timestamp for efficient temporal queries.

**Features:**
- Claim indexing with session metadata
- Time-range queries
- Session-based retrieval
- Claim versioning support
- Persistent storage (~/.abraxas/chronos/)

**Key Classes:**
- `ClaimRecord` — Data structure for indexed claims
- `TemporalIndex` — Main indexing engine

---

### L2: Drift Detection Engine
**File:** `drift_detection.py`

Detects epistemic drift patterns across claims.

**Drift Types:**
| Type | Description | Severity |
|------|-------------|----------|
| `CONTRADICTION` | Direct logical conflict | Critical |
| `LABEL_CHANGE` | Janus label changed | High |
| `CONFIDENCE_SHIFT` | Significant confidence change (>0.3) | Medium |
| `REFINEMENT` | Claim refined/clarified | Low |

**Detection Methods:**
- Semantic similarity comparison (lexical overlap)
- Contradiction pattern matching (negation, contrast markers)
- Confidence delta tracking
- Label change detection

**Key Classes:**
- `DriftReport` — Detected drift between claims
- `DriftDetector` — Main detection engine

---

### L3: Contradiction Resolution Engine
**File:** `contradiction_resolution.py`

Provides strategies for resolving temporal conflicts.

**Resolution Strategies:**
| Strategy | Behavior | Use Case |
|----------|----------|----------|
| `RECENCY` | Prefer newer claim | Default, most common |
| `CONFIDENCE` | Prefer higher confidence | When confidence is reliable |
| `SOURCE_STRENGTH` | Prefer better sourced | Research/academic contexts |
| `MANUAL` | Require user decision | High-stakes conflicts |
| `MERGE` | Combine both claims | Complementary information |
| `FLAG` | Flag both as contested | Irreconcilable differences |

**Key Classes:**
- `ResolutionResult` — Outcome of resolution
- `ResolutionEngine` — Strategy application engine

---

### L4: Timeline Visualization Engine
**File:** `timeline_viz.py`

Generates epistemic timeline visualizations.

**Output Formats:**
- ASCII text timeline (CLI)
- HTML timeline (web view)
- JSON export (data interchange)
- Claim evolution traces

**Features:**
- Event timeline (claims, drifts, resolutions)
- Severity color coding
- Export to multiple formats
- Statistical summaries

**Key Classes:**
- `TimelineEvent` — Single timeline event
- `TimelineVisualizer` — Visualization engine

---

## Commands

```
/chronos index {text} [--session {id}] [--label {label}] [--confidence {0-1}]
    Index a new claim with temporal metadata

/chronos drift {claim_id} [--against {claim_id|all}]
    Detect drift for a specific claim

/chronos session-drift {session_id}
    Detect all drift within a session

/chronos resolve {drift_id} [--strategy {recency|confidence|source|manual|merge|flag}]

From TylerGarlick/abraxas, MIT.

More from TylerGarlick/abraxas