v1.3.0 Release Notes¶

Release Date: February 1, 2026

Highlights¶

• 🔮 Oracle Resilience Middleware - Automatic error recovery for AI agents
• ✏️ Symbol Fuzzy Matching - Typo correction via Levenshtein distance
• 📁 Path Resolution - Workspace-aware file path suggestions
• 🔧 Stage 2 Error Enhancement - Both envelope.error and data.error support
• ✅ 61 New Oracle Tests - 100% pass rate

New Features¶

Oracle Resilience Middleware¶

The Oracle middleware automatically helps AI agents recover from common mistakes:

{
  "error": {
    "code": "SYMBOL_NOT_FOUND",
    "message": "Function 'procss_order' not found"
  },
  "oracle": {
    "suggestions": [
      {"name": "process_order", "confidence": 0.95}
    ],
    "best_match": "process_order"
  }
}

Key capabilities: - Fuzzy symbol matching (typo correction) - Path resolution with suggestions - Syntax error hints - Auto-retry option (Pro/Enterprise)

Enhanced Error Messages¶

All 22 tools now return enhanced error responses with: - Actionable suggestions - Recovery options - Context information

Improvements¶

Test Coverage¶

• Total Tests: 4,100+
• Pass Rate: 100%
• Coverage: 94.86% combined (96.28% statement, 90.95% branch)

Performance¶

• Reduced response latency by 15%
• Improved caching for repeated operations
• Optimized graph traversal algorithms

Breaking Changes¶

None. v1.3.0 is fully backward compatible with v1.2.x.

Upgrade Guide¶

From v1.2.x¶

Simply update your installation:

pip install --upgrade codescalpel

Configuration Updates¶

No configuration changes required. Oracle is enabled by default.

To customize Oracle behavior:

// .code-scalpel/config.json
{
  "oracle": {
    "enabled": true,
    "fuzzy_threshold": 0.8,
    "auto_retry": false
  }
}

Known Issues¶

• Path suggestions may be slow on very large workspaces (>10,000 files)
• Fuzzy matching doesn't work for symbols with special characters

Contributors¶

Thanks to all contributors who made this release possible!

Full Changelog¶

See the detailed changelog for all changes.