feat(tools): add loop-sync CLI for drift detection and configuration …

[hsms4710-pixel]

Summary

This PR introduces loop-sync, a new CLI tool that detects drift between STATE.md and LOOP.md files. This addresses a common pain point in Loop Engineering workflows where state and loop definitions can become out of sync over time.

Problem

When maintaining Loop Engineering projects, developers often find:

• STATE.md and LOOP.md diverge as project evolves
• Manual sync is error-prone and time-consuming
• No automated way to validate consistency

Solution

loop-sync provides:

• Drift Detection: Identifies missing patterns, outdated goals, and inconsistent configurations
• Consistency Scoring: Quantifies sync health (0-100 scale)
• Actionable Suggestions: Specific commands to run for each issue
• Multiple Output Formats: Human-readable text and machine-readable JSON

Files Added

• tools/loop-sync/src/sync.ts - Core sync logic (drift detection, scoring, suggestions)
• tools/loop-sync/src/cli.ts - CLI interface
• tools/loop-sync/test/sync.test.mjs - Comprehensive test suite
• tools/loop-sync/package.json - Package configuration
• tools/loop-sync/README.md - Usage documentation

Features:

• Drift detection with severity levels (error/warning/info)
• Consistency scoring system
• Comprehensive sync suggestions
• JSON and text output formats
• Integration with existing loop-cli

Usage:
npx @loop-engineering/cli loop-sync --state STATE.md --loop LOOP.md
npx @loop-engineering/cli loop-sync --state STATE.md --loop LOOP.md --json

Example Output

Analyzing sync status... State: STATE.md Loop: LOOP.md

📊 Consistency Score: 75/100

⚠️ Issues Found: [WARNING] Pattern 'refactor-auth' in STATE.md not found in LOOP.md Suggestion: Add pattern to LOOP.md or remove from STATE.md

[INFO] Goal section in STATE.md differs from LOOP.md Suggestion: Run 'loop-sync --fix' to synchronize

✅ Suggestions: 3 actionable items

Testing

cd tools/loop-sync
npm test
All tests pass. The tool integrates seamlessly with the existing loop-cli package.