最终结构迁移说明¶

本文说明如何把 0.93a6 及更早版本里基于混合布局的代码迁移到当前 pre 分支采用的最终语义结构。

发生了什么变化¶

Cullinan 不再保留以下历史根层 wrapper：

当前维护中的正式结构收敛为：

此前的新语义包与历史 wrapper 长期并存，导致：

现在 Cullinan 直接把这些语义包视为真实结构，而不是覆盖在旧文件之上的 facade。

旧路径	新路径
`cullinan.app`	顶层 `cullinan` 启动 API（`configure`、`run`、`get_asgi_app`）
`cullinan.application_model`	`cullinan.application`
`cullinan.public_api`	`cullinan.application.public`
`cullinan.module_scanner`	`cullinan.runtime.module_scanner`
`cullinan.scan_stats`	`cullinan.runtime.scan_stats`
`cullinan.scanner`	`cullinan.runtime.scanner`
`cullinan.controller`	`cullinan.web.controller`
`cullinan.middleware`	`cullinan.web.middleware`
`cullinan.params`	`cullinan.web.params`
`cullinan.gateway`	`cullinan.web.gateway`
`cullinan.handler`	`cullinan.web.handler`
`cullinan.adapter`	`cullinan.transport.adapter`
`cullinan.service`	`cullinan.core`（`@service`）/ `cullinan.core.services`（`Service`、registry helper）
`cullinan.config`	`cullinan.support.config`
`cullinan.exceptions`	`cullinan.support.exceptions`
`cullinan.path_utils`	`cullinan.support.path_utils`

# Before
from cullinan.public_api import run

# After
from cullinan import run

# Before
from cullinan.application_model import Application

# After
from cullinan.application import Application

# Before
from cullinan.controller import controller
from cullinan.params import Body

# After
from cullinan.web import controller, Body

# Before
from cullinan.adapter import ASGIAdapter

# After
from cullinan.transport.adapter import ASGIAdapter

不要把这次迁移理解成“再找一个还能继续兼容的旧入口”。

新的规则是：

如果已有代码依赖被移除的根层 wrapper，应直接迁移 import，而不是重新把 wrapper 加回来。