/sync-status - Unified Sync Status

Unified view of all synchronization states including git, cloud, context, and submodules.

System Prompt

EXECUTION DIRECTIVE: When /sync-status is invoked, IMMEDIATELY check all sync states.

Usage

/sync-status            # All sync status
/sync-status --git      # Git only
/sync-status --cloud    # Cloud sync only
/sync-status --context  # Context DB only
/sync-status --subs     # Submodules only
/sync-status --json     # JSON output
/sync-status --project PILOT  # Filter to specific project (ADR-159)

Execution

~/.coditect/scripts/sync-status.sh
~/.coditect/scripts/sync-status.sh --git
~/.coditect/scripts/sync-status.sh --cloud
~/.coditect/scripts/sync-status.sh --context

Sync Categories

1. Git Repository

• Branch status
• Ahead/behind remote
• Uncommitted changes
• Stash count

2. Cloud Sync (ADR-053)

• Connection status
• Last sync time
• Pending queue size
• Sync errors

3. Context Database

• Database size
• Message count
• Last export time
• Watcher status

4. Submodules

• Submodule count
• Out-of-sync count
• Dirty submodules

Output Format

======================================================================
  Sync Status Overview
======================================================================

  Git Repository
  --------------
  Branch:       main
  Status:       CLEAN
  Remote:       UP TO DATE
  Stashes:      2

  Cloud Sync
  ----------
  Status:       CONNECTED
  Last Sync:    2026-01-15T04:55:00Z (8 min ago)
  Pending:      0 items
  Errors:       None

  Context Database
  ----------------
  Database:     sessions.db (ADR-118 Tier 3) (2.3 MB)
  Messages:     15,432
  Sessions:     127
  Last Export:  2026-01-15T04:30:00Z
  Watcher:      RUNNING

  Submodules (74 total)
  ---------------------
  In Sync:      71
  Behind:       2
  Dirty:        1
  Detached:     0

  Overall Status: HEALTHY (minor issues)

======================================================================

Issues Detected

  Issues Detected
  ---------------
  [WARN] Submodule 'coditect-cloud-frontend' is 3 commits behind
  [WARN] Submodule 'coditect-task-orchestrator' has uncommitted changes
  [INFO] 2 git stashes present

  Suggested Actions:
  - cd submodules/cloud/coditect-cloud-frontend && git pull
  - cd submodules/core/coditect-task-orchestrator && git status

Implementation

#!/bin/bash
echo "=== Git Status ==="
git status -sb
git stash list | wc -l | xargs echo "Stashes:"

echo "=== Cloud Sync ==="
cat ~/.coditect/config/config.json | python3 -c "
import json, sys
data = json.load(sys.stdin)
print(f\"Enabled: {data.get('cloud_sync', {}).get('enabled', False)}\")"

echo "=== Context DB ==="
ls -lh ~/PROJECTS/.coditect-data/context-storage/sessions.db (ADR-118 Tier 3)

echo "=== Submodules ==="
git submodule status | wc -l | xargs echo "Total:"
git submodule status | grep '^+' | wc -l | xargs echo "Behind:"

Related Commands

Command	Purpose
/git-sync	Git operations
/submodule-status	Submodule details
/context-health	Context health

---

Version: 1.0.0 Created: 2026-01-15 Author: CODITECT Team