Commands
migrate-observations
Convert legacy emoji-format observations to the scored format
The migrate-observations command converts observation files from the legacy emoji-based format to the scored format introduced in v2.2.0. A backup of each original file is created before conversion.
Added in v2.2.0
Usage
clawvault migrate-observations [options]Options
| Flag | Description | Default |
|---|---|---|
--dry-run | Preview migration without writing files | false |
-v, --vault <path> | Vault path | Nearest vault |
Background
Prior to v2.2.0, observations used an emoji-based format for type and importance classification. The scored format replaces emojis with explicit [type|c=confidence|i=importance] tags, enabling more precise filtering and retention policies.
How It Works
- Scans all observation files in the vault (including legacy paths)
- Parses each line for emoji-format observations
- Converts matched lines to the equivalent scored format
- Creates a
.emoji-backup.mdcopy of each modified file - Writes the converted content back to the original path
Files that are already in scored format are skipped. Running migrate-observations multiple times is safe.
Examples
# Preview what would be migrated
clawvault migrate-observations --dry-run
# Run the migration
clawvault migrate-observations
# Migrate a specific vault
clawvault migrate-observations -v ~/my-vault