v1.3.3 Release Notes¶

Release Date: February 2, 2026

Highlights¶

📦 Project Structure Migration - Scattered cache directories consolidated into .code-scalpel/cache/
📄 CI/CD Pipeline Docs - New docs/PIPELINE.md covering all three validation tiers
🔧 verify.sh Overhaul - Consistent step numbering, header docs, version-sync pre-check, and --skip-build flag
🔨 Version Sync Enforcement - Automatic mismatch detection between pyproject.toml and __init__.py

New Features¶

Version Sync Check¶

verify.sh now runs a version-consistency pre-check before any other step. If pyproject.toml and src/code_scalpel/__init__.py disagree on the version string, the script exits immediately with a clear error message.

A standalone helper is also available:

./scripts/verify_version_sync.sh

`--skip-build` Flag¶

During iterative development the package-build step (Step 8) can be expensive. verify.sh now accepts --skip-build to skip it:

./scripts/verify.sh --skip-build

Pipeline Documentation (`docs/PIPELINE.md`)¶

A new top-level document maps the entire CI/CD strategy across three tiers:

Tier	When	Tool	Checks
1	On commit	`verify_local.sh` + detect-secrets	Auto-fix lint, secrets scan
2	On push	`verify.sh`	11 comprehensive checks
3	On PR / tag	GitHub Actions	Full matrix (Python 3.10–3.13)

Test Suite Organization Guide (`tests/README.md`)¶

A new README documents the intended test-directory layout and migration status, so contributors know where to place new tests without guessing.

Troubleshooting Additions¶

docs/DEVELOPMENT.md gained three new troubleshooting sections:

detect-secrets hook failing — how to audit and update the baseline
Missing .secrets.baseline — one-liner to regenerate
Version mismatch — how to keep both version sources in sync

Changes¶

Project Structure Migration¶

Cache directories that were previously scattered across the repository root have been consolidated:

Before	After
`.scalpel_cache/`	`.code-scalpel/cache/`
`.code_scalpel_cache/`	`.code-scalpel/cache/`
`.scalpel_ast_cache/`	`.code-scalpel/cache/ast/`
`.code-scalpel/license/`	`.code-scalpel/licenses/`
`.tmp_tier_comm/`	(removed)
`.tmp_tier_fallback/`	(removed)

All runtime cache-path references in source code have been updated accordingly. A one-time migration script is provided at scripts/migrate_project_structure.sh for existing installations.

verify.sh Step Numbering¶

Step numbers were inconsistent (jumping from ¼ to ⅜ to ⅝). They are now numbered sequentially 1/11 through 11/11 with a descriptive header block at the top of the script.

Bug Fixes¶

Version mismatch resolved — pyproject.toml was at 1.3.2 while src/code_scalpel/__init__.py was still at 1.3.0. Both now report 1.3.3.

Breaking Changes¶

None. v1.3.3 is fully backward compatible with v1.3.2.

Note for existing installations: If you have cached analysis data in the old scattered directories, run scripts/migrate_project_structure.sh once to move them to the new location. The tool will continue to work without migration; it will simply regenerate caches on first use.

Upgrade Guide¶

From v1.3.2¶

pip install --upgrade codescalpel

Optionally migrate your local caches:

./scripts/migrate_project_structure.sh

Known Issues¶

Inherited from v1.3.0: path suggestions may be slow on very large workspaces (>10,000 files)

Full Changelog¶

See the detailed changelog for all changes.