chameleon status

Synopsis

chameleon status

Display current status of schema, vault, and configuration.

Description

The status command provides a quick overview of:

Schema status - Current version, last modified, pending changes
Vault status - Registered versions, integrity, paranoid mode
Configuration - Debug settings and project config

Use this command to check project health and vault state.

Examples

Fresh Project (No Migrations)

chameleon status

Output:

🗂️  ChameleonDB Status
────────────────────────────────────────────

Schema:
  Status:          ⚠️  No vault initialized
  Action:          Run 'chameleon migrate' to start

Vault:
  Status:          Not initialized

Configuration:
  Debug Level:     off

After First Migration

chameleon migrate --apply
chameleon status

Output:

🗂️  ChameleonDB Status
────────────────────────────────────────────

Schema:
  Current version:  v001
  Hash:            3f2a8b9c...
  Last modified:   2 hours ago
  Status:          ✓ Up to date

Vault:
  Versions:        1 registered
  Integrity:       ✓ OK
  Mode:            🛡️ readonly

Configuration:
  Debug Level:     off

Schema Modified (Pending Migration)

# Edit schema
vim schemas/users.cham

# Check status
chameleon status

Output:

🗂️  ChameleonDB Status
────────────────────────────────────────────

Schema:
  Current version:  v001
  Hash:            3f2a8b9c...
  Last modified:   just now
  Status:          ⚠️  Schema modified (not registered)

Vault:
  Versions:        1 registered
  Integrity:       ✓ OK
  Mode:            ⚙️ standard

Configuration:
  Debug Level:     off

Multiple Versions

chameleon status

Output:

🗂️  ChameleonDB Status
────────────────────────────────────────────

Schema:
  Current version:  v003
  Hash:            9e2f5a1b...
  Last modified:   5 minutes ago
  Status:          ✓ Up to date

Vault:
  Versions:        3 registered
  Integrity:       ✓ OK
  Mode:            ⚙️ standard

Configuration:
  Debug Level:     off

Integrity Issues

chameleon status

Output:

🗂️  ChameleonDB Status
────────────────────────────────────────────

Schema:
  Current version:  v002
  Hash:            7d4e1c2a...
  Last modified:   1 day ago
  Status:          ✓ Up to date

Vault:
  Versions:        2 registered
  Integrity:       ❌ 1 issues
  Mode:            🛡️ readonly

Configuration:
  Debug Level:     off

Status Fields

Schema Section

string

Latest registered schema version (e.g., v001, v002)

string

SHA256 hash of current version (first 12 characters)Example: 3f2a8b9c...

string

Time since last schema changeExamples:

just now
5 minutes ago
2 hours ago
3 days ago

string

Current schema state:

✓ Up to date - No pending changes
⚠️ Schema modified - Changes not yet migrated
⚠️ No vault initialized - First-time setup needed

Vault Section

number

Total number of registered schema versionsExample: 3 registered

string

Cryptographic verification result:

✓ OK - All hashes verified
❌ N issues - Tampering detected

string

Current paranoid mode:

🛡️ readonly - Schema locked (default)
⚙️ standard - Controlled changes allowed
👑 privileged - DBA access
🚨 emergency - Incident recovery

Paranoid Mode Icons

Icon	Mode	Description
🛡️	`readonly`	Schema modifications blocked (default)
⚙️	`standard`	Controlled schema changes allowed
👑	`privileged`	DBA-level access with logging
🚨	`emergency`	Emergency recovery mode

Time Formatting

“Last modified” displays:

< 1 minute: just now
< 1 hour: N minutes ago
< 24 hours: N hours ago
≥ 24 hours: N days ago

Common Status Patterns

Ready to Migrate

Schema:
  Status:          ⚠️  Schema modified (not registered)
  
Vault:
  Integrity:       ✓ OK
  Mode:            ⚙️ standard

Action:

chameleon migrate --apply

Locked in Readonly Mode

Vault:
  Mode:            🛡️ readonly

Action:

# Upgrade mode to allow changes
chameleon config set mode=standard

Integrity Violation

Vault:
  Integrity:       ❌ 2 issues

Action:

# Get detailed report
chameleon verify

First-Time Setup

Schema:
  Status:          ⚠️  No vault initialized

Action:

chameleon migrate --apply

Troubleshooting

No Vault Initialized

Schema:
  Status:          ⚠️  No vault initialized
  Action:          Run 'chameleon migrate' to start

Solution: Run first migration:

chameleon migrate --apply

Cannot Read Vault

❌ Failed to load vault: permission denied

Solution: Ensure permissions:

chmod -R u+r .chameleon/vault/

Schema File Missing

Schema Files:
  ⚠️  schema *.cham not found

Solution: Regenerate merged schema:

chameleon migrate --check

Quick Status Check Script

#!/bin/bash
# Quick status check for CI/CD

OUTPUT=$(chameleon status)

if echo "$OUTPUT" | grep -q "✓ OK"; then
  echo "✅ Vault integrity OK"
  exit 0
else
  echo "❌ Vault has issues"
  exit 1
fi

Integration Examples

Pre-Commit Hook

#!/bin/bash
# .git/hooks/pre-commit

if ! chameleon status | grep -q "✓ Up to date"; then
  echo "⚠️  Warning: Schema has uncommitted changes"
  chameleon status
fi

Monitoring Script

#!/bin/bash
# /usr/local/bin/check-chameleon-vault

OUTPUT=$(chameleon status)

if echo "$OUTPUT" | grep -q "❌"; then
  echo "CRITICAL: Vault integrity violation"
  echo "$OUTPUT"
  exit 2
fi

echo "OK: Vault healthy"
exit 0

Commands

Synopsis

Description

Examples

Fresh Project (No Migrations)

After First Migration

Schema Modified (Pending Migration)

Multiple Versions

Integrity Issues

Status Fields

Schema Section

Vault Section

Paranoid Mode Icons

Time Formatting

Common Status Patterns

Ready to Migrate

Locked in Readonly Mode

Integrity Violation

First-Time Setup

Troubleshooting

No Vault Initialized

Cannot Read Vault

Schema File Missing

Quick Status Check Script

Integration Examples

Pre-Commit Hook

Monitoring Script

See Also

​Synopsis

​Description

​Examples

​Fresh Project (No Migrations)

​After First Migration

​Schema Modified (Pending Migration)

​Multiple Versions

​Integrity Issues

​Status Fields

​Schema Section

​Vault Section

​Paranoid Mode Icons

​Time Formatting

​Common Status Patterns

​Ready to Migrate

​Locked in Readonly Mode

​Integrity Violation

​First-Time Setup

​Troubleshooting

​No Vault Initialized

​Cannot Read Vault

​Schema File Missing

​Quick Status Check Script

​Integration Examples

​Pre-Commit Hook

​Monitoring Script

​See Also

Synopsis

Description

Examples

Fresh Project (No Migrations)

After First Migration

Schema Modified (Pending Migration)

Multiple Versions

Integrity Issues

Status Fields

Schema Section

Vault Section

Paranoid Mode Icons

Time Formatting

Common Status Patterns

Ready to Migrate

Locked in Readonly Mode

Integrity Violation

First-Time Setup

Troubleshooting

No Vault Initialized

Cannot Read Vault

Schema File Missing

Quick Status Check Script

Integration Examples

Pre-Commit Hook

Monitoring Script

See Also