magic-spec 1.5.71 → 1.5.159

package/CHANGELOG.md

@@ -5,259 +5,298 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.5.70] - 2026-03-30
-
-### Changed
-
-- **Documentation**: Updated `README.md` and `docs/README.md` to include a mandatory recommendation to run `/magic.analyze` after updating the Magic Spec engine. This ensures that specifications and engine metadata remain synchronized after a core logic update.
+## [1.5.159] - 2026-04-10
 
 ### Meta
 
-- **Automated Update**: Engine version bumped to `1.5.70`, history updated, and checksums regenerated (C14).
+- **Engine Sync**: Performed project hygiene sync, updated documentation, and validated engine metadata (C14 parity).
+
+## [1.5.159] - 2026-04-09
 
-## [1.5.71] - 2026-03-26
 
 ### Added
 
-- **Gitignore Safety (Invariant 8)** in `analyze.md`: The agent now MUST scan and apply `.gitignore` patterns before any project scan or architecture inference. This prevents `node_modules`, `dist`, `.venv`, and other build artifacts from leaking into the analysis reports or coverage checks.
+- **Agent Memory (STATE.md)**: New live memory system — a ≤100-line project state digest read first in every workflow session. Tracks current position, recent decisions, blockers, and blocking constraints. Template: `.magic/templates/state.md`. Utility: `.magic/scripts/update-state.js`.
+- **Session Continuity (HANDOFF.json)**: Structured cross-session handoff mechanism. Template: `.magic/templates/handoff.json`. Enables zero-prompt resume from exact position with required reading lists and constraint acknowledgment.
+- **Pause Workflow (`pause.md`)**: New `/magic.pause` workflow that snapshots session state into `HANDOFF.json` and sets `STATE.md` status to `Paused`. Supports automatic trigger at POOR context tier.
+- **Phase Frontmatter**: YAML dependency metadata block in `phase.md` template (`requires`, `provides`, `key_files`, `patterns_established`, `subsystem`, `duration_minutes`). Enables machine-readable inter-phase dependency tracking.
+- **Canonical References**: New mandatory `## Canonical References` section in `spec.md` template. Forces downstream agents to bind to specific stable file paths instead of relying on memory. Audit checks added to `analyze.md` and `spec.md` checklists.
+- **Context Quality Tiers**: Adaptive agent behaviour guidance (PEAK/GOOD/DEGRADING/POOR) based on context window utilization. Added to `task.md` workflow header.
+- **Resume Detection**: Integrated into `context-resolution.md` Post-Resolution chain (Priority 3-4). Automatically detects paused sessions and resumes from recorded position.
+- **Pause Propagation**: `run.md` Logic Guard that auto-saves state when all phase tasks are blocked.
 
 ### Changed
 
-- **Stack & Structure**: Refined the initial scan step to build the high-level project map only *after* applying gitignore filters.
+- **`context-resolution.md`**: Extended Post-Resolution chain with STATE.md loading (Priority 3) and Resume Detection (Priority 4).
+- **`init.md`**: STATE.md creation added to init steps, structure map, and completion checklist.
+- **`run.md`**: Added Live Memory invariant (2.5), STATE Sync in Update step, Frontmatter Update in Phase Completion, and Pause Propagation guard.
+- **`task.md`**: Added Context Quality Guidance, Phase Frontmatter generation instructions, State Init/Update step, and Dependency Read from frontmatter.
+- **`analyze.md`**: Added `CANONICAL_MISSING` audit check for Stable specs without Canonical References section.
+- **`spec.md`**: Added Canonical References validation to Task Completion Checklist — blocks Stable promotion if section is empty.
 
-### Meta
+## [1.5.142] - 2026-04-09
 
-- **Automated Update**: Engine version bumped to `1.5.71`, history updated, and checksums regenerated (C14).
+### Changed
 
-## [1.5.50] - 2026-03-26
+- **License**: Changed project license from MIT to Apache License 2.0.
 
-### Added
+## [1.5.141] - 2026-04-08
 
-- **Anti-Stall Mechanism (Invariant 12)**: Solved the "AI holds specs in mind" issue (reported by user). The agent is now forced to write a `Draft` spec if it asks more than one clarifying question without file creation. Added `<!-- TBD -->` inline markers for ambiguous sections.
-- **Mode Transition Protocol**: Defined explicit triggers to exit `Explore Mode` and enter `Dispatch Mode` automatically (3+ topics, confirmation words, or 2nd idea exchange in Trust Mode).
-- **Non-Blocking Dispatch Notice**: Reframed "Notice of Intent" as a statement of action rather than a question to prevent infinite loops.
+### Removed
 
-### Changed
+- **CODEX.toml**: Completely removed `CODEX.toml` from the engine initialization scripts and placeholders as it is not required by any supported agent.
 
-- **Analysis Mode Scope**: Strictly limited the "do not modify specs/registry" prohibition to `Project Analysis Delegation` mode, allowing normal `Dispatch` to proceed without friction.
-- **Workflow Wrapper**: Updated `.agents/workflows/magic.spec.md` to align with the new non-blocking exploration logic.
+## [1.5.140] - 2026-04-08
 
-### Meta
+### Fixed
 
-- **Automated Update**: Engine version bumped to `1.5.50`, history updated, and checksums regenerated (C14).
+- **Engine Init Portability**: Refactored `setup_unix.sh` to use relative symlinks and removed `realpath -m` dependency, improving compatibility with macOS and older Linux/Unix systems.
+- **Git Index Integrity**: Fixed a bug in `magic.dev:init` where development workflows (`magic.dev.*`) were incorrectly removed from the git index during setup.
 
-## [1.5.49] - 2026-03-25
+## [1.5.139] - 2026-04-07
 
 ### Added
 
-- **Config Drift Guard**: `check-prerequisites` now detects uncommitted manual changes to `RULES.md` via `git diff` and emits a non-blocking `CONFIG_DRIFT` advisory warning. Supports workspace-specific `RULES.md` per C22. Gracefully skips when git is unavailable.
-- **Init Workflow**: Added Config Drift Advisory sub-step to pre-flight check (show diff / proceed / restore options).
-- **Test Suite**: Added cognitive tests T168-T170 for config drift detection (drift present, no git, workspace C22). Suite version bumped to 1.9.51.
-- **Engine Spec**: New `config-drift-guard.md` specification (Stable, L1) in engine workspace.
+- **Universal Skill Wrappers**: Implemented `sync-skills.js` to automatically project workflows into universal agent skills (`SKILL.md`).
+- **Engine Integration**: Integrated skill synchronization into `init.js` and `update-engine-meta.js` (C14). All workflow changes now automatically update the agent's tool surface.
+- **Regression Testing**: Added `T190 — Skill Projection Parity` to the test suite.
 
-## [1.5.48] - 2026-03-24
+## [1.5.136] - 2026-04-07
 
 ### Added
 
-- **Publish Workflow**: Restored `.agents/workflows/publish.md` for engine maintenance and registry publishing.
-- **History Tracking**: Initialized history for `magic.analyze` and `magic.dev.simulate` wrappers to ensure full auditability.
+- **Documentation Hygiene Pass**: Added a project-wide hygiene pass to `update-project-meta.js` that automatically fixes MD012 (multiple consecutive blank lines) in all core documentation files.
+- **Robust Registry Logic**: Fixed a bug in `sync-docs.js` where the workspace registry extraction would grab trailing content (Document History) if the `## Meta` section was missing.
 
-### Changed
+## [1.5.135] - 2026-04-07
 
-- **Version Synchronization**: Unified project version to `1.5.71` across all manifests (`package.json`, `pyproject.toml`, `__init__.py`) and the `.magic/.version` engine core.
-- **Instruction Density**: Refined `.magic/simulate.md` (Context Bleed Warning) to remove vague qualifiers ("high-confidence" -> "strictly unbiased"), reaching a density score of 10/10.
-- **Engine Integrity**: Optimized `generate-checksums.js` to exclude the `.checksums` file from its own mapping, preventing confusion and unstable hash values.
+### Meta
 
-### Fixed
+- **Engine Sync**: Performed project hygiene sync, updated documentation, and validated hardlink integrity (C14).
 
-- **Testing Logic**: Corrected `run_tests.py` to properly set `PYTHONPATH` for Python installer subprocesses and fixed an `os.environ` access bug.
-- **Sandbox Cleanup**: Removed dev-only `simulate.md` from installer test sandbox.
-- **RULES Template**: Added missing conventions C18-C23 to `init.js` RULES.md generator.
-- **Python Installer**: Fixed `_resolve_package_version()` to read actual package version.
-- **Engine Scripts**: Deduplicated `workspace.json` reads in `executor.js`.
-- **History Cleanup**: Removed legacy `audit.md` and `docs.md` files from `.magic/history/`.
+## [1.5.134] - 2026-04-07
 
-## [1.5.30] - 2026-03-24
+### Added
 
-### Fixed
+- **Skill Projection Automation**: Integrated `sync-skills.js` directly into `update-engine-meta.js`. Engine core changes now automatically regenerate Skill wrappers for Claude and Gemini (C14).
+- **Distribution Guide**: Created `docs/distribution.md` documenting the separation between User Bundle, Dev Instruments, and Internal Engine files.
 
-- **Version Synchronization**: Unified project version across `package.json` (was 1.5.0), `pyproject.toml` (was 1.4.162), and `__init__.py` (was 1.4.162) to a single `1.5.30`. Previously 5 different versions existed across 5 sources.
-- **CONTEXT.md**: Regenerated stale context file (was 9 days old).
+### Changed
 
-## [1.5.29] - 2026-03-16
+- **History Reorganization**: Cleaned up and organized the `history/` directory. History files now follow a standardized naming convention and are updated with a smart condensing logic for version ranges.
+- **Agent Rules (AGENTS.md)**: Updated Project Anatomy to include the `skills/` compatibility layer and corrected the hardlink integrity check (now 5 files).
 
-### Added
+## [1.5.132] - 2026-04-04
 
-- **Argument Routing (A–D)** for `task.md` and `run.md`: Both workflows now accept optional arguments — workspace name, directive text, or both. Consistent with `analyze.md` pattern. Includes Workspace Fallback, Disambiguation, and Handoff Propagation rules.
-- **T4 Inline Guards** in `spec.md`: When spec workflow captures a standing rule via T4 trigger ("remember that..."), it now applies Tier Routing (global vs workspace RULES.md), Duplication Check (across both tiers), and Constitutional Guard (§1–6 protection) — matching `rule.md` safety guarantees without breaking T4's "Apply Immediately" semantics.
-- **Regression Tests (T153–T161)**: 9 new scenarios covering argument routing (scoped planning, workspace fallback, disambiguation, targeted task/phase execution, cross-workflow handoff propagation) and T4 inline guards (tier routing, duplication detection, constitutional block).
+### Changed
+
+- **Internationalization (En-En)**: Translated remaining Russian instructions in `docs/checksums.md` to English.
+- **Engine Versioning**: Synchronized all manifest files with the base version `1.5.132` (C14).
+
+## [1.5.131] - 2026-04-04
 
 ### Changed
 
-- **AGENTS.md**: Clarified C14 Enforcement scope — explicitly covers all `.magic/` content (workflows, scripts, templates, tests, config), not just workflow files. Added description of what `update-engine-meta` does (bumps `.version`, regenerates `.checksums`).
-- **`run.md` Argument Routing**: Detection column harmonized with `analyze.md` — accepts both quoted text and non-workspace tokens (e.g., unquoted `T-1A01` or `phase-2`).
+- **Internationalization (En-En)**: Fixed remaining Russian examples in `.magic/analyze.md` that were missed in the previous version sync.
+- **Engine Versioning**: Synchronized all manifest files with the base version `1.5.131` (C14).
 
-## [1.4.162] - 2026-03-12
+## [1.5.130] - 2026-04-04
 
-### Added
+### Changed
+
+- **Internationalization (En-En)**: Translated all remaining Russian examples and rule titles to English across the engine core (`.magic/`) to ensure a consistent, professional English-only codebase (Rule 3.1).
+  - Translated constitutional rule titles in `RULES.md` (e.g., `C12 — Quarantine Cascade`).
+  - Updated simulation test suite (`suite.md`) to reflect translated inputs and expected output strings.
+
+### Meta
+
+- **Automated Update**: Engine version bumped to `1.5.130`, history updated, and checksums regenerated (C14).
 
-- **Session Isolation Rule (C17)**: Formalized the requirement for "New Chat" sessions between major workflow transitions (Spec → Task → Run) to prevent context bleed-over and hallucinations.
-- **Multi-Workspace Support (C22)**: Enhanced `check-prerequisites.js` and `init.js` to support nested workspaces with inherited root rules.
-- **Model-Aware History**: Updated engine history schema to include AI Model information, improving auditability of generated code.
+## [1.5.129] - 2026-04-03
 
 ### Changed
 
-- **Task Checklist Logic**: Consolidated implementation checklists into `TASKS.md` for better execution tracking and status reporting.
-- **Gitignore Resilience**: Improved installers to automatically manage `.gitignore` entries for `.magic/` and `.agents/` directories with idempotent updates.
-- **Onboarding Safety**: Added production data collision guards to `onboard.md` to prevent accidental overwrites of existing project plans.
+- **Structural Harmonization**: Refactored `retrospective.md` to use header-based logic. This resolves `MD029` (ordered list prefix) and `MD007` (list indentation) warnings caused by complex content and personification blocks (C24) breaking list continuity. Fixed sequential numbering (1, 2, 3, 4, 5, 2 -> 1, 2, 3, 4, 5, 6, 7).
+- **C24 Independent Analyst**: Upgraded the persona block in `retrospective.md` to a dedicated sub-heading for better visibility and structural compliance.
+
+### Meta
+
+- **Automated Update**: Engine version bumped to `1.5.129`, history updated, and checksums regenerated (C14).
+
+## [1.5.128] - 2026-04-03
 
 ### Fixed
 
-- **Error Reporting**: Enhanced `check-prerequisites.js` with structured, actionable JSON error suggestions.
-- **Path Handling**: Fixed Windows-specific path issues in installer scripts.
+- **Markdown Lint (MD012)**: Fixed a recurring issue where `CONTRIBUTING.md` would be regenerated with multiple consecutive blank lines. Added `.trim()` to `{{workflows_table}}` placeholder in `sync-docs.js` to ensure proper spacing between the table and the following section.
+- **Engine Versioning**: Synchronized engine version across all manifests and documentation (C14).
 
-## [1.4.162] - 2026-03-03
+## [1.5.126] - 2026-04-03
 
 ### Added
 
-- **Regression Test T85**: Verifies mandatory engine integrity HALT when `.magic/` files are tampered (C1 enforcement).
+- **C24 — Unified Role-Switching Gate**: Expanded the mandatory internal review system into a unified constitutional rule across all key SDD workflows (Spec, Task, Run, Retro, Analyze, Rule, Simulate).
+- **Workflow Personas**: Integrated 7 specialized personas (Critic, Skeptic, QA, Analyst, Auditor, Reviewer) to eliminate cognitive bias and ensure rigorous evidence-based verification before any artifact is finalized.
+- **Structural Harmonization**: Refactored workflow steps in `analyze.md`, `rule.md`, and `simulate.md` to use header-based logic, resolving deep-seated markdown lint errors caused by intervening non-list elements.
 
-### Changed
+## [1.5.120] - 2026-04-03
 
-- **Engine Integrity Halt**: Upgraded `check-prerequisites.js` to set `ok: false` on checksum mismatches, ensuring a hard HALT during pre-flight checks.
-- **History Auto-Heal**: Enhanced `executor.js` to automatically recreate the `.magic/history/` directory and missing history files if deleted.
+### Added
 
-### Fixed
+- **C24 — Unified Role-Switching Gate**: Expanded the mandatory internal review system into a unified constitutional rule across all key SDD workflows. This forces the agent to adopt specialized personas to eliminate cognitive bias before artifacts are finalized:
+  - **Spec Workflow**: Persona **Project Critic** (L1 tech-neutrality, invariant completeness).
+  - **Task Workflow**: Persona **Planning Skeptic** (Optimism bias detection, dependency risk analysis).
+  - **Run Workflow**: Persona **QA Tester** (Invariant verification, boundary condition audit).
+- **Workflow Integration**: Hardened `.magic/spec.md`, `.magic/task.md`, and `.magic/run.md` with explicit role-based checkpoints and updated completion checklists.
+- **Rules Versioning**: Updated `RULES.md` to version 1.5.126 with the expanded C24 definition.
+
+## [1.5.115] - 2026-04-02
+
+### Added
 
-- **Resilient Logic**: Improved `check-prerequisites.js` to distinguish between critical engine integrity (HALT) and project data drift (WARNING), preserving self-healing capabilities.
+- **Installer `--dev` Flag**: Implemented a comprehensive development mode across Node.js and Python installers.
+  - Enabled installation/synchronization of development-specific instruments (simulation workflows, testing suites, engine scripts).
+  - Added `devSkills` registry to `installers/config.json` for canonical tracking of dev agent skills.
+  - Hardened update logic to ensure dev instruments are correctly synchronized when `--dev` is provided during an update.
 
-## [1.4.162] - 2026-03-02
+## [1.5.114] - 2026-04-02
 
 ### Changed
 
-- **Executor Refactor**: Improved `executor.js` structure by replacing global `return` with an `else` block for better readability and standard Node.js practices.
-- **Test Suite Cleanup**: Removed duplicate T54 "Spec Rename History Immutability" scenario from `suite.md`.
+- **Core Invariant #2 (Prohibitions)** in `spec.md`: Refined the "No code in specs" rule to explicitly permit **Technical Contracts** (interfaces, types, API schemas) and **Reference Snippets** (marked as `[REFERENCE]`). This ensures architectural precision while maintaining the prohibition on functional implementation code before the `run` phase.
+- **Task Completion Checklist**: Updated to reflect the permission of contracts and references in specifications.
 
 ### Meta
 
-- **Automated Update**: Sequential patch bump, history update, and checksum regeneration via `update-engine-meta`.
+- **Automated Update**: Engine version bumped to `1.5.114`, history updated, and checksums regenerated (C14).
 
-## [1.4.5] - 2026-03-01
+## [1.5.112] - 2026-04-02
 
 ### Added
 
-- **Engine Versioning Protocol (C14)**: Established a mandatory convention requiring a patch version bump in `.magic/.version` whenever core engine files are modified. Integrated checkpoints into all primary workflows (`run.md`, `spec.md`, `rule.md`).
-- **History Refactoring**: Extracted "Document History" from core workflow markdown files into a dedicated `.magic/history/` directory. This significantly reduces token consumption during agentic operations while preserving audit trials.
-- **Node.js Script Transition**: Fully replaced legacy `.sh` and `.ps1` initialization and utility scripts with cross-platform Node.js implementations (`init.js`, `generate-context.js`, etc.).
-
-### Changed
-
-- **Installer Configuration**: Optimized `installers/config.json` to exclude history files from distribution and prioritize Node.js scripts.
-- **Engine Security**: `generate-checksums.js` and `executor.js` now explicitly skip history files to prevent non-functional changes from triggering integrity warnings.
-- **Template System**: `init.js` now automatically injects the new C14 protocol into target project constitution files (`RULES.md`).
+- **Anti-Fabrication Rule (Invariant 6)** in `simulate.md`: New Core Invariant that legitimizes `0 rough edges` as a valid outcome and mandates evidence-linked claims (file, line, verbatim quote, verification command) for every finding. Findings without evidence are automatically INVALID.
+- **Pre-flight Hard Gate** in `simulate.md`: Upgraded Pre-flight from "recommended" to a non-negotiable blocking HALT. Simulations without recorded `check-prerequisites` output are INVALID.
+- **Read-Before-Claim Gate** in `simulate.md`: New mandatory Grounding Phase requiring all target workflow files to be read (with line counts recorded) before any analysis begins. Claims about unread files are automatically INVALID.
+- **Regression Tests (T185–T189)**: 5 new scenarios covering Explore Mode write isolation (T185), Pre-flight Hard Gate enforcement (T186), Evidence-Linked Claims validation (T187), Null-Result Acceptance (T188), and Read-Before-Claim Gate (T189).
 
 ### Fixed
 
-- **Syntax Hygiene**: Cleaned up redundant markdown artifacts (terminal backticks) in core workflow files.
-- **Workflow Integrity**: Fixed accidental history duplication in `spec.md`.
+- **Zero-Prompt Parity**: Aligned `init.md` and `analyze.md` Core Invariant #1 with the canonical cascade formula used by all other workflow files, eliminating sync risk from divergent wording.
+- **Script History Leak**: Fixed `executor.js` Auto-Detect creating spurious history files for scripts in `scripts/` directory (e.g., `sync-skills.md`). Scripts are now tracked via checksums but inherit the `--workflow` flag instead of getting standalone history entries.
+- **Orphan Cleanup**: Removed `history/sync-skills.md` — a phantom artifact created by the above bug.
 
-## [1.4.3] - 2026-03-01
+### Meta
 
-### Added
+- **Automated Update**: Engine version bumped to `1.5.112`, history updated, and checksums regenerated (C14).
 
-- **Smart Adapter Updates**: Both Python and Node.js installers now seamlessly verify and update adapter `.mdc`/`.toml` wrapper files during `--update`.
-- **Smart Update Conflict Resolution**: When users manually modify `.cursor/rules/*` wrapper files in their project, the `--update` command now detects the modifications. Users can intelligently choose to skip updates for specific conflicting adapter files, preserving their changes while updating the core `.magic` engine logic.
+## [1.5.105] - 2026-03-31
 
 ### Fixed
 
-- **Updater Integrity**: Modified files that are bypassed during an update via `[s] Skip modified files` now persist their original hashes so they don't get silently overwritten in subsequent updates.
-- **Testing Logic**: Fixed an issue in the `run_tests.py` exhaustive test suite section where failures during adapter testing cycles were mistakenly swallowed, reporting a false "All tests completed successfully".
+- **Engine History**: Resolved a ReferenceError in `executor.js` where `automatedMsg` was used before being defined.
+- **Collapsing Logic**: Improved the history collapsing mechanism to correctly merge both automated and custom messages into compact version ranges.
+
+### Meta
+
+- **Automated Update**: Engine version bumped to `1.5.104`, history entries consolidated, and checksums regenerated.
 
-## [1.4.1] - 2026-03-01
+## [1.5.72] - 2026-03-30
 
 ### Fixed
 
-- **Localization**: Translated remaining Russian text in `README.md` Mermaid diagrams to English.
+- **AI Hallucinations**: Rephrased the directive `auto-run .magic/init.md` to `silently execute .magic/init.md (do not prompt user)` across all engine workflows. This prevents intelligent agents from incorrectly proposing the internal `.magic/init.md` script as a user-facing `/magic.init` slash command.
 
-## [1.4.0] - 2026-03-01
+### Meta
 
-### Added
+- **Automated Update**: Engine version bumped to `1.5.72`, history updated, and checksums regenerated (C14).
 
-- **Smart Sync Optimization (AOP)** in `analyze.md`: Automated detection of manual renames during project re-analysis. If an orphaned specification matches a new uncovered directory (>80% similarity or title match), it triggers a `[RESCUE]` action instead of delete/create cycle.
-- **Manual Rename Rescue** in `spec.md`: Protocol to globally update references (INDEX, PLAN, TASKS) when a specification file is moved/renamed, preserving task progress.
-- **Regression Tests (T48–T51)**: Added coverage for Engine Integrity guards, Analysis Depth Control, and Smart Sync mechanisms.
+## [1.5.70] - 2026-03-30
 
 ### Changed
 
-- **Test Suite Synchronization**: The `suite.md` version is now synchronized with the core engine version to prevent metadata confusion.
+- **Documentation**: Updated `README.md` and `docs/README.md` to include a mandatory recommendation to run `/magic.analyze` after updating the Magic Spec engine. This ensures that specifications and engine metadata remain synchronized after a core logic update.
 
-## [1.3.2] - 2026-02-28
+### Meta
+
+- **Automated Update**: Engine version bumped to `1.5.70`, history updated, and checksums regenerated (C14).
+
+## [1.5.132] - 2026-03-26
 
 ### Added
 
-- **Project Analysis Workflow** (`.magic/analyze.md`): Powerful reverse-engineering tool. Delegated automatically from `spec.md` or directly via `/magic.analyze`. Supports scanning existing source code to generate structured proposals with paired Layer 1 (Concept) and Layer 2 (Implementation) specifications. Features Depth Control for massive codebases.
-- **Bootstrapping Exemption**: Special rules added to bypass standard Draft/RFC phases and create "Stable" specs directly when adopting existing working code into the SDD system.
-- **Improv Mode (Live Simulation)** in `simulate.md`: Added ability for the simulation workflow to synthesize "crisis scenarios" (e.g., INDEX.md desync) and perform full SDK lifecycle stress tests end-to-end on its own, functioning as a fallback if the static test suite is missing.
+- **Gitignore Safety (Invariant 8)** in `analyze.md`: The agent now MUST scan and apply `.gitignore` patterns before any project scan or architecture inference. This prevents `node_modules`, `dist`, `.venv`, and other build artifacts from leaking into the analysis reports or coverage checks.
 
 ### Changed
 
-- Expanded Test Suite (`.magic/tests/suite.md`) from 28 to 34 scenarios (+6), fully covering Analyze gap detection, L1/L2 generation asserts, depth control limits, and the missing test suite fallback.
+- **Stack & Structure**: Refined the initial scan step to build the high-level project map only *after* applying gitignore filters.
+
+### Meta
 
-## [1.3.1] - 2026-02-27### Added
+- **Automated Update**: Engine version bumped to `1.5.132`, history updated, and checksums regenerated (C14).
+
+## [1.5.50] - 2026-03-26
 
-- **Workflow Test Suite** (`.magic/tests/suite.md`): 16 predefined regression test scenarios covering all 8 engine workflows. Run via `/magic.dev.simulate test`.
-- **Test Suite mode** in `simulate.md`: reads `suite.md` and reports PASS/FAIL for each scenario.
-- **Template directory** (`.magic/templates/`): extracted inline templates from core workflow files:
-  - `specification.md` — Specification Template (from `spec.md`)
-  - `plan.md` — PLAN.md Template (from `task.md`)
-  - `tasks.md` — TASKS.md + phase-{n}.md Templates (from `task.md`)
-  - `retrospective.md` — RETROSPECTIVE.md Template (from `retrospective.md`)
+### Added
+
+- **Anti-Stall Mechanism (Invariant 12)**: Solved the "AI holds specs in mind" issue (reported by user). The agent is now forced to write a `Draft` spec if it asks more than one clarifying question without file creation. Added `<!-- TBD -->` inline markers for ambiguous sections.
+- **Mode Transition Protocol**: Defined explicit triggers to exit `Explore Mode` and enter `Dispatch Mode` automatically (3+ topics, confirmation words, or 2nd idea exchange in Trust Mode).
+- **Non-Blocking Dispatch Notice**: Reframed "Notice of Intent" as a statement of action rather than a question to prevent infinite loops.
 
 ### Changed
 
-- **AOP Optimization**: Compressed verbose prose in `spec.md` (Post-Update Review, Audit/Consistency Reports). ~17% token reduction across core workflows.
-- **Stress-test hardening** across all workflows:
-  - `spec.md`: Intra-input self-contradiction guard, Deprecation Cascade (scan Related Specs for stale refs)
-  - `task.md`: Circular Dependency Guard, Phantom Done-task preservation (Archive not Cancel), Deprecated Done-task preservation, Convention Sync wording fix
-  - `run.md`: Mode Guard — HALT if execution mode not in RULES.md §7
-  - `rule.md`: Duplication Guard, convention-not-found handler, Workflow Dependency Check in Remove Impact Analysis
-  - `simulate.md`: Checksums mismatch upgraded to HALT, Checksum Rule (generate after approval only)
-  - `onboard.md`: Production collision HALT with backup/cancel, re-entry checks production PLAN.md
-  - `init.md`: Expanded post-init verification to all 5 artifacts, Maintainer Note for hardcoded RULES.md sync
+- **Analysis Mode Scope**: Strictly limited the "do not modify specs/registry" prohibition to `Project Analysis Delegation` mode, allowing normal `Dispatch` to proceed without friction.
+- **Workflow Wrapper**: Updated `.agents/workflows/magic.spec.md` to align with the new non-blocking exploration logic.
 
-### Fixed
+### Meta
+
+- **Automated Update**: Engine version bumped to `1.5.50`, history updated, and checksums regenerated (C14).
+
+## [1.5.49] - 2026-03-25
 
-- Template references now explicitly point to `.magic/templates/*.md` in creation steps of `spec.md`, `task.md`, `retrospective.md`, and `onboard.md`.
+### Added
 
-## [1.3.0] - 2026-02-25
+- **Config Drift Guard**: `check-prerequisites` now detects uncommitted manual changes to `RULES.md` via `git diff` and emits a non-blocking `CONFIG_DRIFT` advisory warning. Supports workspace-specific `RULES.md` per C22. Gracefully skips when git is unavailable.
+- **Init Workflow**: Added Config Drift Advisory sub-step to pre-flight check (show diff / proceed / restore options).
+- **Test Suite**: Added cognitive tests T168-T170 for config drift detection (drift present, no git, workspace C22). Suite version bumped to 1.9.51.
+- **Engine Spec**: New `config-drift-guard.md` specification (Stable, L1) in engine workspace.
+
+## [1.5.48] - 2026-03-24
 
 ### Added
 
-- **Full support for abstract environment templates** with automatic resolution (`{ARGUMENTS}`) across all CLIs.
-- **Introduced `.magicrc`** for persistence of selected environments and their auto-detection.
-- **Two-level automatic Changelog generation** (by accumulating `Changes` blocks within tasks).
-- **Added new CLI commands:** `info`, `--check`, `--list-envs`, and `--eject`.
-- **Introduced core version tracking** within the project via the `.magic/.version` file.
+- **Publish Workflow**: Restored `.agents/workflows/publish.md` for engine maintenance and registry publishing.
+- **History Tracking**: Initialized history for `magic.analyze` and `magic.dev.simulate` wrappers to ensure full auditability.
 
 ### Changed
 
-- **Architecture:** Restructured the repository into a two-level model (root = source of truth + installers), and removed the `core/` folder to eliminate duplication.
-- **Node Installer:** Completely overhauled the installation mechanism (it now uses compiled files from NPM instead of downloading them from GitHub, eliminating Path Traversal vulnerabilities).
-- **Python Installer:** Implemented an isolated package based on `hatchling` (via shared-data) without external dependencies on GitHub.
-- **Documentation:** Separated `README.md` strategies (different focuses for GitHub, NPM package, and PyPI package).
-- **Update Logic:** Improved `.magic` update logic to be safer (old folders are now moved to `.magic/archives/` rather than simply deleted).
+- **Version Synchronization**: Unified project version to `1.5.132` across all manifests (`package.json`, `pyproject.toml`, and installer init files) and the `.magic/.version` engine core.
+- **Instruction Density**: Refined `.magic/simulate.md` (Context Bleed Warning) to remove vague qualifiers ("high-confidence" -> "strictly unbiased"), reaching a density score of 10/10.
+- **Engine Integrity**: Optimized `generate-checksums.js` to exclude the `.checksums` file from its own mapping, preventing confusion and unstable hash values.
+
+### Fixed
+
+- **Testing Logic**: Corrected `run_tests.py` to properly set `PYTHONPATH` for Python installer subprocesses and fixed an `os.environ` access bug.
+- **Sandbox Cleanup**: Removed dev-only `simulate.md` from installer test sandbox.
+- **RULES Template**: Added missing conventions C18-C23 to `init.js` RULES.md generator.
+- **Python Installer**: Fixed `_resolve_package_version()` to read actual package version.
+- **Engine Scripts**: Deduplicated `workspace.json` reads in `executor.js`.
+- **History Cleanup**: Removed legacy `audit.md` and `docs.md` files from `.magic/history/`.
+
+## [1.5.30] - 2026-03-24
+
+### Fixed
+
+- **Version Synchronization**: Unified project version across `package.json` (was 1.5.0), `pyproject.toml` (was 1.4.162), and `__init__.py` (was 1.4.162) to a single `1.5.30`. Previously 5 different versions existed across 5 sources.
+- **CONTEXT.md**: Regenerated stale context file (was 9 days old).
 
-## [1.3.0] - 2026-02-23
+## [1.5.29] - 2026-03-16
 
 ### Added
 
-- **Handoff integrations** (`magic.*.md`): Introduced explicit handoff blocks across all agent workflow wrappers to guide next-steps effortlessly.
-- **Task Engine Enhancement:** Integrated User Stories generation parsing into `.magic/task.md` and suppressed user priority prompts using `RULES.md C4`.
-- **System Automation Hooks:** Added `generate-context` script hooks into `task.md` and `run.md` post-write triggers.
-- **Context Automation Script:** Created `generate-context.sh` and `generate-context.ps1` to assemble `CONTEXT.md` from PLAN, workspace trees, and changelogs.
-- **Spec Engine Protections:** Added strict Explore Mode Safety rules and Delta Editing constraints for spec updates over 200 lines to `.magic/spec.md`.
-- **Explore Hints:** Updated `.agents/workflows/magic.spec.md` UI wrapper with tips to use Delta Constraints and strict read-only explore mode.
-- **CLI Doctor Command (Node/Python):** Implemented `--doctor` and `--check` parsing in installers, executing the prerequisite script and outputting a formatted terminal validation report.
-- **Interactive Onboarding Script:** Created `.magic/onboard.md` to guide new developers through building a toy "console logger" specification.
-- **Onboarding Wrapper:** Added `.agents/workflows/magic.onboard.md` to trigger the interactive onboarding tutorial seamlessly.
-- **Prerequisite Validation:** Created `check-prerequisites.sh` and `check-prerequisites.ps1` parsing `INDEX.md` and returning valid JSON results.
+- **Argument Routing (A–D)** for `task.md` and `run.md`: Both workflows now accept optional arguments — workspace name, directive text, or both. Consistent with `analyze.md` pattern. Includes Workspace Fallback, Disambiguation, and Handoff Propagation rules.
+- **T4 Inline Guards** in `spec.md`: When spec workflow captures a standing rule via T4 trigger ("remember that..."), it now applies Tier Routing (global vs workspace RULES.md), Duplication Check (across both tiers), and Constitutional Guard (§1–6 protection) — matching `rule.md` safety guarantees without breaking T4's "Apply Immediately" semantics.
+- **Regression Tests (T153–T161)**: 9 new scenarios covering argument routing (scoped planning, workspace fallback, disambiguation, targeted task/phase execution, cross-workflow handoff propagation) and T4 inline guards (tier routing, duplication detection, constitutional block).
+
+### Changed
+
+- **AGENTS.md**: Clarified C14 Enforcement scope — explicitly covers all `.magic/` content (workflows, scripts, templates, tests, config), not just workflow files. Added description of what `update-engine-meta` does (bumps `.version`, regenerates `.checksums`).
+- **`run.md` Argument Routing**: Detection column harmonized with `analyze.md` — accepts both quoted text and non-workspace tokens (e.g., unquoted `T-1A01` or `phase-2`).