refactor(imports): #1438 burn-down wave — hoist 20 deferred dazzle.core.* imports

Hoisted function-level dazzle.core.* imports to module top across 8 non-core
files (worker, agent_commands/renderer, fuzzer/oracle, template_compiler,
integration_manager, subsystems/channels, investigator/tools_read,
cli/ux_interactions). dazzle.core is the bottom layer (import-linter-enforced
core ↛ http/page), so these can't cycle, and none of the hoisted names are
source-patched in tests (the #1438 test-coupling trap) — verified by the full
non-e2e suite (18773 passed; the 4 failures are pre-existing test-order
pollution: alembic_env_url + fuzzer_oracle, both pass isolated). Dead
try/except ImportError guards around always-present core modules dropped.

Ratchet baseline lowered 1699 → 1679.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: claude

.claude/CLAUDE.md

@@ -374,4 +374,4 @@ Example: `examples/ops_dashboard` has working `bar_chart` (FK `group_by: system`
 - **KG re-seeding**: `ensure_seeded()` checks a version key; bump it in `seed.py` when TOML data changes.
 
 ---
-**Version**: 0.86.1 | **Python**: 3.12+ | **Status**: Production Ready
+**Version**: 0.86.2 | **Python**: 3.12+ | **Status**: Production Ready

CHANGELOG.md

@@ -9,7 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.86.1] - 2026-06-24
+## [0.86.2] - 2026-06-24
+
+### Changed
+- **#1438 deferred-import burn-down (wave): hoisted 20 function-level `dazzle.core.*` imports to module top across 8 non-core files** (`process/worker`, `services/agent_commands/renderer`, `testing/fuzzer/oracle`, `page/converters/template_compiler`, `http/runtime/integration_manager`, `http/runtime/subsystems/channels`, `fitness/investigator/tools_read`, `cli/ux_interactions`). `dazzle.core` is the bottom layer (import-linter-enforced `core ↛ http/page`), so these can't cause an import cycle, and none of the hoisted names are source-patched in tests (the #1438 test-coupling trap) — verified by the full suite. Dead `try/except ImportError` guards around always-present core modules were dropped. Ratchet baseline lowered 1699 → 1679 (`deferred_imports_baseline.json`).
 
 ### Fixed
 - **#1464 (follow-up) engine baseline emitted composite FKs BEFORE the UNIQUE constraints they reference → `db upgrade` failed.** The v0.86.0 composite-constraint fix emitted ops in sorted-table order, so a composite FK `(tenant_id, fk) → Parent(tenant_id, id)` on a child that sorts *before* its parent was created before the parent's `UNIQUE(tenant_id, id)` existed — `psycopg.errors.InvalidForeignKey: there is no unique constraint matching given keys`. `schema_diff.diff` now orders all additions so **every `AddUnique`/`AddIndex` precedes every `AddForeignKey`** (and drops mirror it: FKs before the uniques they depend on), via a stable type-priority sort — independent of table name order. Guarded by a fast unit test (`diff` op ordering) and a real-PG fixture whose child (`Booking`) deliberately sorts before its parent (`Room`), which reproduced the exact `InvalidForeignKey` before the fix. The v0.86.0 fixture passed only because its parent happened to sort first. (Adopters who hand-reordered the generated baseline no longer need to.)

ROADMAP.md

@@ -1,7 +1,7 @@
 # DAZZLE Development Roadmap
 
 **Last Updated**: 2026-06-16
-**Current Version**: v0.86.1
+**Current Version**: v0.86.2
 
 For past releases, see [CHANGELOG.md](CHANGELOG.md).
 

homebrew/dazzle.rb

@@ -10,10 +10,10 @@ class Dazzle < Formula
 
   desc "DSL-first application framework with LLM-assisted development"
   homepage "https://github.com/manwithacat/dazzle"
-  version "0.86.1"
+  version "0.86.2"
   license "MIT"
 
-  url "https://github.com/manwithacat/dazzle/archive/refs/tags/v0.86.1.tar.gz"
+  url "https://github.com/manwithacat/dazzle/archive/refs/tags/v0.86.2.tar.gz"
   sha256 "PLACEHOLDER_SOURCE_SHA256"
 
   # pydantic-core requires Rust to build from source, so use pre-built wheels

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dazzle-dsl"
-version = "0.86.1"
+version = "0.86.2"
 description = "DAZZLE — declarative SaaS framework with built-in compliance (SOC 2, ISO 27001), provable RBAC, and graph features"
 readme = "README.md"
 requires-python = ">=3.12"

src/dazzle/cli/ux_interactions.py

@@ -27,6 +27,7 @@
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
+from dazzle.core.appspec_loader import load_project_appspec
 from dazzle.testing.ux.interactions import (
     CardAddInteraction,
     CardDragInteraction,
@@ -177,8 +178,6 @@ def _build_context_selector_walk(project_root: Path) -> list[Interaction]:
     be a real, surprising failure worth surfacing — not silently swallowing
     into "no gestures".
     """
-    from dazzle.core.appspec_loader import load_project_appspec
-
     appspec = load_project_appspec(project_root)
     return [
         ContextSelectInteraction(workspace=ws.name)
@@ -290,7 +289,6 @@ def run_guide_walk(project_root: Path, *, json_output: bool = False, persona: st
     Returns an exit code (0/1/2).
     """
     from dazzle.cli.runtime_impl.ports import read_runtime_test_secret
-    from dazzle.core.appspec_loader import load_project_appspec
 
     appspec = load_project_appspec(project_root)
     if not (getattr(appspec, "guides", None) or []):

src/dazzle/fitness/investigator/tools_read.py

@@ -13,6 +13,7 @@
 from typing import Any
 
 from dazzle.agent.core import AgentTool
+from dazzle.core.appspec_loader import load_project_appspec
 from dazzle.core.ir.identity import spec_display_id
 from dazzle.fitness.investigator.case_file import CaseFile
 from dazzle.fitness.investigator.tools import (
@@ -128,14 +129,6 @@ def handler(name: str) -> dict[str, Any]:
         state.tool_calls_summary.append(f"query_dsl({name})")
         scope_root = case_file.example_root or dazzle_root
 
-        try:
-            from dazzle.core.appspec_loader import load_project_appspec
-        except ImportError:
-            return {
-                "error": "DSL parser unavailable",
-                "hint": "install dazzle[dev]",
-            }
-
         try:
             appspec = load_project_appspec(scope_root)
         except Exception as e:

src/dazzle/http/runtime/integration_manager.py

@@ -7,7 +7,8 @@
 import logging
 from typing import TYPE_CHECKING, Any
 
-from dazzle.core.ir import AppSpec
+from dazzle.core.ir import AppSpec, ChannelKind
+from dazzle.core.ir import ChannelSpec as IRChannelSpec
 
 if TYPE_CHECKING:
     from fastapi import FastAPI
@@ -105,8 +106,6 @@ def __init__(
     def init_channel_manager(self) -> None:
         """Initialize the channel manager for messaging."""
         try:
-            from dazzle.core.ir import ChannelKind
-            from dazzle.core.ir import ChannelSpec as IRChannelSpec
             from dazzle.http.channels import create_channel_manager
 
             ir_channels = []

src/dazzle/http/runtime/subsystems/channels.py

@@ -8,6 +8,8 @@
 import logging
 from typing import Any
 
+from dazzle.core.ir import ChannelKind
+from dazzle.core.ir import ChannelSpec as IRChannelSpec
 from dazzle.http.runtime.subsystems import SubsystemContext
 
 logger = logging.getLogger(__name__)
@@ -33,8 +35,6 @@ def startup(self, ctx: SubsystemContext) -> None:
 
     def _init_channel_manager(self, ctx: SubsystemContext) -> None:
         try:
-            from dazzle.core.ir import ChannelKind
-            from dazzle.core.ir import ChannelSpec as IRChannelSpec
             from dazzle.http.channels import create_channel_manager
 
             kind_map = {

src/dazzle/mcp/semantics_kb/core.toml

@@ -3,7 +3,7 @@
 
 [meta]
 category = "Core Constructs"
-version = "0.86.1"
+version = "0.86.2"
 
 [concepts.entity]
 category = "Core Construct"