crush

Identity

Names: crush / sh.charm.crush.
Native format: crush-sqlite, sessions, messages, file versions and read-file state.
Session ID: sessions.id, no namespace.
File history: The pinned writer records full versions, including external changes and preimages. Each version is a checkpoint. Successive integer files.version values for one session_id and path support exact net changes between those checkpoint IDs. The first version alone is not an addition. No tool cause or actor is inferred. Absolute paths use checkpoint PathRef objects with root: null.
Notes: is_summary_message identifies compaction with unknown replaced extent. Message model, provider and finish fields do not independently prove inference. Read transcript by created_at,rowid, file history by path/version/id, then current state. Message created_at is milliseconds and is not copied to every embedded operation. Title, usage, cost and todos are snapshots.

Position basis

Record family	Position basis	Commit boundary
transcript	created_at-rowid	transaction
current-state	snapshot	transaction

Use only positions established by the stated format and mapping evidence. Current-state rows without transcript positions form the snapshot tail, after all records with transcript positions. A protocol commit boundary takes precedence over physical EOF; uncommitted bytes are not a gap.

Destinations

crush: native facts without a standard field

Fact	Native name	Destination
Complete SQL row	Native table columns	`native.record` on the record for this source value, or `native.blob` for an `application/json` BlobRef for the entire value. JSON text columns stay strings; binary cells retain the documented native encoding. ASR-035 covers numbers ASR cannot represent exactly.
SQL locator	Table name and SQLite rowid	nearest record `_meta` `sh.charm.crush/source`, `{table, rowid}`; `rowid` is decimal text and is provenance, not session identity
Embedded native part	Native content or usage part	`native.record` on the record for this source value, or `native.blob` for an `application/json` BlobRef for the entire value. JSON text columns stay strings; binary cells retain the documented native encoding. ASR-035 covers numbers ASR cannot represent exactly.
Unpaired result identity	Native result call ID	`tool_result.nativeCallId`, verbatim
Containing message	`messages.id`	tool record `_meta` `sh.charm.crush/messageId`
Rootless checkpoint file	`path`, `version`, retained file content	`checkpoint` `_meta` `sh.charm.crush/file`, `{path, version?, blob?}`; `path` is an ASR structured path and `blob` holds the recorded bytes
Read-file state	`read_files` row	vendor record `sh.charm.crush/read_file_state` with row metadata

Usage

Select one report per native accounting identity only when this entry establishes that identity. Keep reports that cannot be joined to an accounting identity, or that overlap, as native evidence. Declare any incomplete semantic coverage. Schema defaults and placeholder zeros are not reported usage. Backend inclusion rules require evidence; do not infer them from a model name.

Lane and unassigned facts

Facts without established session ownership use manifest _meta["sh.charm.crush/unassigned"] with the common shape. An export may retain these facts with any session subset, including an empty subset, but must not imply session ownership. State the selection policy in the export report.

Losses

Declare every applicable loss under ASR-157. Missing model rendering, accounting joins, lineage or exact context boundaries remain losses when this entry does not qualify them. Unknown ownership is not itself lost data. Use a documented vendor loss or report for omitted unassigned facts; do not create a new core category.

Evidence

Basis: source-verified at charmbracelet/crush commit ed15da4c46e0bdc3afae4842db54e7def7b9f15e (message, history/file.go, edit/write tools). Existing database and authored fixtures; no fresh native release capture. No package version is established. Evidence applies only to the named formats and explicit mappings above. A real capture covers only the behavior that was exercised. A writer probe run without a model covers persistence, not model or tool execution. Authored tests do not qualify an agent version. Unlisted formats and link mappings remain unqualified.

Observations from 2026-10-27

observed, version 0.98.2: Crush 0.98.2 retained edit, shell-test, resume, review and child sessions in SQLite. Preserve complete row and part JSON in native.record or native.blob, not rowJson or partJson metadata. Ambiguous invocation IDs stay in tool_result.nativeCallId. Serialization bookkeeping belongs to the converter. The ctx conversion produced 3 streams and 70 records, with 0 errors, 0 notices, 0 gaps and 0 unidentified inputs under validator-v0.1.2. These counts describe the selected output; an empty bundle qualifies no source format. No sanitized native fixture was retained for this observation. Whole native records use native.record or native.blob, with JSON text columns preserved as strings. The exporter’s own bookkeeping for serialization, partitioning and message keys belongs in the exporter namespace (rs.ctx for ctx), not in a provider metadata destination. These runs add no evidence for unexercised approvals, lineage links, compaction boundaries or exact request context.

{
  "name": "sh.charm.crush",
  "aliases": [
    "crush"
  ],
  "namespace": {
    "rule": "none"
  },
  "positions": [
    {
      "family": "transcript",
      "basis": "created_at-rowid",
      "boundary": "transaction"
    },
    {
      "family": "current-state",
      "basis": "snapshot",
      "boundary": "transaction"
    }
  ],
  "formats": [
    {
      "id": "crush-sqlite",
      "evidence": [
        0,
        2
      ]
    }
  ],
  "evidence": [
    {
      "label": "source",
      "revision": "ed15da4c46e0bdc3afae4842db54e7def7b9f15e",
      "scope": "format-and-explicit-mappings"
    },
    {
      "label": "authored",
      "scope": "converter-tests-only"
    },
    {
      "label": "observed",
      "version": "0.98.2",
      "date": "2026-10-27",
      "scope": "SQLite messages and parts in .crush/crush.db; Edit, shell test, resume, review and child; 3 streams.",
      "limitations": "Crush 0.98.2 retained edit, shell-test, resume, review and child sessions in SQLite. Preserve complete row and part JSON in native.record or native.blob, not rowJson or partJson metadata. Ambiguous invocation IDs stay in tool_result.nativeCallId. Serialization bookkeeping belongs to the converter.",
      "validation": {
        "streams": 3,
        "records": 70,
        "errors": 0,
        "notices": 0,
        "gaps": 0,
        "unidentifiedSources": 0
      },
      "validator": "validator-v0.1.2",
      "converter": "ctx-asr-authentic-captures-4"
    }
  ],
  "destinations": {
    "file": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    },
    "messageId": {
      "schema": {},
      "evidence": [
        0
      ]
    },
    "source": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    }
  },
  "mappings": [
    {
      "native": "complete native row or event",
      "destination": "native.record or native.blob",
      "scope": "SQLite messages and parts in .crush/crush.db",
      "evidence": [
        2
      ]
    }
  ]
}

Introduction

Format

Records

Trust

Extending and conforming

Agent registry

crush

crush

Identity

Position basis

Destinations

crush: native facts without a standard field

Links

Usage

Lane and unassigned facts

Losses

Evidence

Observations from 2026-10-27

​crush

​Identity

​Position basis

​Destinations

​crush: native facts without a standard field

​Links

​Usage

​Lane and unassigned facts

​Losses

​Evidence

​Observations from 2026-10-27

crush

Identity

Position basis

Destinations

crush: native facts without a standard field

Links

Usage

Lane and unassigned facts

Losses

Evidence

Observations from 2026-10-27