Evidence-generated support

See exactly what Gratisfy can read, preserve, edit, and write.

This matrix is generated from the active capability registry and matching conformance receipts. A local codec pass never becomes a provider-acceptance claim.

17versioned capability rows

16accepted conformance receipts

2026-08-27.5published matrix version

How to read these claims

Verified binds a current code capability to a matching local test receipt. Provisional means behavior is tested but its external or owner-controlled contract is not authoritative. “Provider acceptance” is reported separately and remains not verified wherever no dated live receipt exists.

Current evidence

Format capability matrix

Capability registry a67d14adee00dabb…

Format	Read	Preserve	Edit	Write	Round trip	Provider acceptance
AI Dungeon Story Cards JSONunversioned current documentation · json	Verified	Verified	Verified	Verified	Verified	not verified
Backyard Archive Format (BYAF)pinned v1 RFC · schemaVersion 1 · zip	Verified	Verified	Not supported	Not supported	Not supported	not verified
Batch ZIP/catalog manifest1 · multiple	Verified	Verified	Not supported	Verified	Verified	not applicable
Character Card V1 PNGlegacy Tavern chara; omitted empty fields normalized · png	Verified	Verified	Verified	Not supported	Not supported	not applicable
Character Card V2 JSON2.0 · json	Verified	Verified	Verified	Verified	Verified	not applicable
Character Card V2 PNG2.0 chara · png	Verified	Verified	Verified	Verified	Verified	not applicable
Character Card V3 (future numeric)future numeric · json	Verified	Verified	Not supported	Not supported	Not supported	not applicable
Character Card V3 CHARX3.0 · zip	Verified	Verified	Verified	Verified	Verified	not applicable
Character Card V3 JSON3.0 · json	Verified	Verified	Verified	Verified	Verified	not applicable
Character Card V3 PNG/APNG3.0 ccv3 · reviewed V2 fallback · png or apng	Verified	Verified	Verified	Verified	Verified	not applicable
Character.AI account export (manual mapping)user-supplied generic JSON; no provider schema claim · json	Provisional	Not supported	Verified	Not supported	Not supported	not verified
CharacterBook V2V2 embedded object · json	Verified	Verified	Verified	Verified	Verified	not applicable
Gratisfy Card Project V3 JSON3.0 · json	Verified	Verified	Verified	Verified	Verified	not applicable
Gratisfy-marked Janitor JSONGratisfy-marked provisional · json	Provisional	Provisional	Provisional	Not supported	Not supported	not verified
Lorebook V33.0 standalone · 3.0 embedded · json	Verified	Verified	Verified	Verified	Verified	not applicable
Saucepan backup JSONreviewed backup shape · json	Verified	Provisional	Verified	Not supported	Not supported	not verified
Tavern Character Card V1 JSON1 · json	Verified	Verified	Verified	Verified	Verified	not applicable

lorebook

AI Dungeon Story Cards JSON

Local Lorebook Lab mapping and deterministic re-import are verified. No account connection or provider submission is performed.

Limits and evidence

Explicit provider label required; maximum 5,000 entries and 16 MiB; exact duplicates are removed; provider import replaces the full existing Story Card set.

Suites: lorebook-format-lab

provider file

Backyard Archive Format (BYAF)

Secure local inspection, hash inventory, opaque preservation receipts, and a reviewable Gratisfy Project V3 migration preview are verified against synthetic fixtures. Provider acceptance is not verified.

Limits and evidence

Experimental import only at ahoylabs/byaf@7ebf2fdbb06a36b4f900a8de45480c4a2965df03; strict ZIP and cross-reference validation; maximum 64 MiB archive and 128 MiB expanded; original archive remains unchanged; no BYAF export or connection.

Suites: backyard-byaf-container

batch

Batch ZIP/catalog manifest

The aggregate ZIP is deterministic and includes a machine-readable manifest; failed items do not erase successful outputs.

Limits and evidence

Maximum 100 sources and 128 MiB aggregate; per-item results; SHA-256 duplicates; hash-verified resume; nested ZIP outputs stay separate.

Suites: format-batch

character card

Character Card V1 PNG

Recovers legacy Tavern V1 image cards into a reviewable private project and supports conversion in Format Lab.

Limits and evidence

Import only; maximum 16 MiB (10 MB in Studio); exactly one recognizable Tavern V1 chara payload. Original file and safe unknown metadata are retained on private save. Conversion writes V2 or V3; there is no V1 PNG writer.

Suites: png-import-save-route

character card

Character Card V2 JSON

Exact Character Card V2 2.0 JSON. Safe unknown JSON is retained within the documented opaque-data budget.

Limits and evidence

JSON only; maximum input 16 MiB
Safe unknown JSON values inline up to 64 KiB each and 1 MiB total
Known V2 semantics edit through Canonical Project V3
Character Card V2 JSON; V3-only losses must be reviewed

Suites: character-card-v2-adapter

character card

Character Card V2 PNG

Portable V2 image metadata with bounded dimensions, chunks, text, and exact semantic re-import.

Limits and evidence

Validated PNG structure and CRCs; maximum 16 MiB (10 MB in Studio). Import normalizes known V2 version spellings; exports require exact V2 2.0. Safe unrelated chunks are retained.

Suites: character-card-v2-png

character card

Character Card V3 (future numeric)

Newer numeric V3 documents are accepted only for bounded inspection and opaque preservation. Editing and export require a pinned version-specific adapter.

Limits and evidence

Fatal UTF-8 JSON; maximum input 16 MiB
Exact 3.0 is editable; future numeric versions are preservation-only and block export
Canonical editable values must fit the bounded Gratisfy Card Project V3 schema
Safe unknown JSON values inline up to 64 KiB each and 1 MiB total
Future-version whole-document preservation is bounded to the 1 MiB project extension budget
Exact Character Card V3 3.0 standard fields only; future numeric versions are blocked
Deterministic exact Character Card V3 3.0 JSON with semantic re-import verification
Whole-document preservation is bounded to the project extension budget; no future-version semantics are inferred.

Suites: character-card-v3-adapter

character card

Character Card V3 CHARX

Exact card.json and embedded-asset hashes are verified; unsafe archives are rejected before card parsing.

Limits and evidence

Strict bounded ZIP; embedded and unreferenced entries remain inert; remote assets are not fetched; active content is never executed.

Suites: character-card-charx

character card

Character Card V3 JSON

Exact Character Card V3 3.0 is editable, writable, and covered by deterministic semantic re-import evidence.

Limits and evidence

Fatal UTF-8 JSON; maximum input 16 MiB
Exact 3.0 is editable; future numeric versions are preservation-only and block export
Canonical editable values must fit the bounded Gratisfy Card Project V3 schema
Safe unknown JSON values inline up to 64 KiB each and 1 MiB total
Future-version whole-document preservation is bounded to the 1 MiB project extension budget
Exact Character Card V3 3.0 standard fields only; future numeric versions are blocked
Deterministic exact Character Card V3 3.0 JSON with semantic re-import verification

Suites: character-card-v3-adapter

character card

Character Card V3 PNG/APNG

Animation and non-card chunks are retained while card metadata is replaced deterministically.

Limits and evidence

Validated PNG/APNG structure; maximum 64 MiB (10 MB in Studio); ccv3 takes precedence. Import also accepts V3 in chara and fills known lorebook defaults. V2 fallback is emitted only after reviewed down-conversion.

Suites: provider-foundation-character-card-v3-png

provider file

Character.AI account export (manual mapping)

The assistant validates generic JSON and a user-directed field worksheet. It does not recognize or claim a stable Character.AI portable-card schema.

Limits and evidence

Maximum 16 MiB local JSON; lists bounded text paths only; every destination mapping is user-selected; unselected source data is omitted from the preview; no scraper, connector, native card format, or provider write.

Suites: character-ai-migration

lorebook

CharacterBook V2

Reads raw, embedded-object, and Character Card V2 forms and writes the exact V2 CharacterBook object.

Limits and evidence

Standalone raw objects require an explicit V2 label; V2 has no standalone discriminator; maximum 16 MiB.

Suites: lorebook-format-lab

project

Gratisfy Card Project V3 JSON

Gratisfy canonical workspace snapshot; this is not presented as a third-party character-card standard.

Limits and evidence

Standalone JSON only; maximum input 32 MiB
Validated V3 opaque envelopes remain project-owned
All canonical V3 paths edit through the strict project schema
Deterministic standalone Gratisfy Card Project V3 JSON

Suites: card-project-v3-adapter

provider file

Gratisfy-marked Janitor JSON

Native Janitor format support remains disabled pending an inspectable owner contract, fixtures, policy, and live verification.

Limits and evidence

Requires an explicit Janitor, provider, format, or Gratisfy schema marker; this is not a verified native Janitor owner format.

Suites: wave0-shell-import

lorebook

Lorebook V3

Standalone and embedded V3 re-import exactly; local preview evaluates literal keys only.

Limits and evidence

Maximum 16 MiB; regex semantics block V2 down-conversion; imported regex runs only in the authenticated supervised RE2 boundary.

Suites: lorebook-format-lab

provider file

Saucepan backup JSON

File import support is separate from the permissioned Saucepan browser connector.

Limits and evidence

Reads the tested card plus starting_scenarios backup shape; original raw JSON is retained in the import session; no generic backup re-export claim.

Suites: wave0-shell-import

character card

Tavern Character Card V1 JSON

V1 has no discriminator. Read requires an explicit V1 label; upgrades disclose synthesized and omitted paths.

Limits and evidence

Flat JSON only; maximum input 16 MiB; creator confirmation required because V1 has no root discriminator
Safe unknown root JSON values inline up to 64 KiB each and 1 MiB total
Known V1 semantics edit through Canonical Project V3
Flat Tavern V1 JSON; V2/V3-only losses must be reviewed

Suites: character-card-v1-adapter

Claim definitions

Verified: The current capability contract and a matching local conformance receipt both pass.
Provisional: Local behavior is tested, but the source contract or external ownership remains provisional.
Not verified: The capability may exist in code, but no matching current conformance receipt elevates it.
Not supported: The current capability contract does not offer this operation.