Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as opaque submodule gitlinks on GitHub) into fully-tracked first-party content. AITM now merges its 7 vendored repos as first-party engines: - memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts - git: vendored C git (bundled binary) + gitnexus (in-process code intelligence) - agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess) Includes the full session's product build: Gitgram web/mobile/backend features, AITM website/CLI/MCP, the unified memory layer, engine build tooling (scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md), and extensive test suites. Build artifacts, node_modules, external/, and gemini-cli are gitignored. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.4 KiB
4.4 KiB
AI Time Machine - Implementation Complete ✅
🎯 Vision Achieved
Just like macOS Time Machine lets you restore your computer to before a virus infection, AI Time Machine now lets you restore your code AND chat context to any previous "safe" point.
✅ What's Implemented
1. MCP Tools (for AI to use directly)
| Tool | Description | Status |
|---|---|---|
tm_undo_last |
One-click undo last AI action | ✅ |
tm_go_back |
Go back by time, search, or checkpoint ID | ✅ |
tm_diff_file |
Line-by-line diff for single file | ✅ |
tm_diff_summary |
Quick summary of all changes | ✅ |
tm_before_action |
Find state before specific action | ✅ |
tm_restore_files |
Pattern-based multi-file restore | ✅ |
tm_find_error_point |
Smart error detection | ✅ |
tm_show_timeline |
Visual timeline of checkpoints | ✅ |
tm_what_changed |
File-level diff | ✅ |
tm_restore_file |
Single file restore | ✅ |
tm_browse_checkpoint |
Browse files at checkpoint | ✅ |
2. CLI Commands
# One-click undo (like Mac's Restore button)
aitm undo # Undo last action
aitm undo -n 3 # Undo last 3 actions
# Go back in time
aitm back # Previous checkpoint
aitm before "docker" # Before docker changes
aitm before "api" --restore # Find and restore
# See what changed
aitm changes # Summary since last checkpoint
aitm quick-diff <file> # Quick file diff
# Selective restore
aitm restore-files "*.ts" # Restore all .ts files
aitm restore-files "src/**" # Restore src folder
aitm browse <checkpoint> # Browse checkpoint files
# Smart error detection
aitm find-error # Find when things broke
aitm find-error --restore # Auto-restore to last good state
3. API Endpoints
POST /api/restore/undo # Quick undo
POST /api/restore/to-time # Restore by time/search
GET /api/before/action/:query # State before action
GET /api/diff/summary # Change summary
GET /api/browse/:checkpoint # Browse files
POST /api/restore/file # Single file restore
POST /api/restore/files # Pattern restore
4. Core Engine Methods
engine.undoLast(steps) // Undo N actions
engine.findBeforeAction(query) // Find state before action
engine.findErrorPoint(options) // Smart error detection
engine.getChangeSummary(from, to) // Change summary
📖 Usage Examples
Example 1: AI Made a Mistake
User: "AI kodumu bozdu, geri al"
AI: tm_undo_last kullanıyorum...
⏪ UNDO: Reverted 1 action
Now at: "API refactoring started"
Files restored: 15
Backup saved: .aitimemachine/backups/...
Example 2: Go Back to Before Docker Changes
User: "Docker değişikliklerinden öncesine dön"
AI: tm_before_action ile arıyorum...
⏮️ BEFORE ACTION: Added Docker configuration
Found checkpoint before this action:
Name: "API design discussion"
Time: 2 hours ago
Restoring...
✅ 32 files restored
Example 3: Just Restore Some Files
User: "Sadece src/*.ts dosyalarını geri yükle"
AI: tm_restore_files ile geri yüklüyorum...
📂 RESTORE FILES
Pattern: src/*.ts
Matched: 12 files
✅ Restored: 12
Example 4: Find When Things Broke
User: "Ne zaman bozuldu bul"
AI: tm_find_error_point kullanıyorum...
🔍 ERROR POINT FOUND
Found error indicator in: "Fix failing tests"
Suggested restore point:
"All tests passing" (30 minutes ago)
🏗️ Files Modified
src/mcp/server.ts- MCP tool handlerssrc/core/engine.ts- Core Time Machine methodssrc/cli-v2.ts- CLI command registrationsrc/cli/time-machine-commands.ts- NEW: Time Machine CLI commandssrc/api-server.ts- API endpointsdocs/TIME_MACHINE_EXPERIENCE_PLAN.md- Updated plan
🎉 Result
AI Time Machine now provides a true macOS Time Machine-like experience:
- ✅ One-click undo - Just like pressing "Restore" in Time Machine
- ✅ Go back to any time - "5 minutes ago", "before docker changes"
- ✅ See what changed - Visual diff with context
- ✅ Selective restore - Restore specific files or patterns
- ✅ Smart error detection - Automatically find when things went wrong
- ✅ Chat context preserved - AI remembers conversation state
The AI can now truly "restore to before the virus" - undoing mistakes instantly! 🚀