⌘Ctrlk

_mod_CROSSWATCH

Local file-backed tracker(watchlist/history/ratings).

Provider ID: CROSSWATCH Version (module): 1.0.0

CrossWatch can act as its own local tracker.

It stores watchlist, history, and ratings as JSON on disk.

Use it for:

local backups before risky runs
staging and testing
seeding other providers from a clean dataset

Related docs:

Entry point: sync/_mod_CROSSWATCH.py

Provider surface

health()
build_index(feature)
add(feature, items)
remove(feature, items)

Features

watchlist → providers/crosswatch/_watchlist.py
history → providers/crosswatch/_history.py
ratings → providers/crosswatch/_ratings.py

Capabilities

bidirectional: true
provides_ids: true
index_semantics: "present"
observed_deletes: true

Config

Config block name:

CrossWatch or crosswatch

Common keys:

root_dir (default /config/.cw_provider)
auto_snapshot (default true)
retention_days (default 30)
max_snapshots (default 64)
restore_watchlist, restore_history, restore_ratings

Pair scoping (optional)

Enable:

CW_CROSSWATCH_PAIR_SCOPED=1

Scope key reads from:

CW_PAIR_KEY, CW_PAIR_SCOPE, CW_SYNC_PAIR, CW_PAIR

Effects:

state files become watchlist.<scope>.json, etc.
snapshots go under snapshots/<scope>/

Gotchas

Timestamp comparisons can be string-based.

Use ISO8601 UTC ...Z timestamps.

Capabilities (raw)

{
  "bidirectional": true,
  "index_semantics": "present",
  "observed_deletes": true,
  "provides_ids": true,
  "ratings": {
    "from_date": false,
    "types": {
      "episodes": true,
      "movies": true,
      "seasons": true,
      "shows": true
    },
    "unrate": true,
    "upsert": true
  }
}

OPS contract

name()
label()
features()
capabilities()
is_configured(cfg)
build_index(cfg, feature=...)
add(cfg, items, feature=..., dry_run=False)
remove(cfg, items, feature=..., dry_run=False)
health(cfg)

Common state files

watchlist.json, watchlist.restore_state.json, watchlist.unresolved.json
history.json, history.restore_state.json, history.unresolved.json
ratings.json, ratings.restore_state.json, ratings.unresolved.json

Previoushistory Nextoverview

Last updated 11 hours ago

Was this helpful?

Good afternoon

hashtagProvider surface

hashtagFeatures

hashtagCapabilities

hashtagConfig

hashtagPair scoping (optional)

hashtagGotchas