@antprofuse/saddle-skill 0.3.2 → 0.3.4

package/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: saddle-service-0-3
-description: 使用 Saddle 0.3.2 Skill 开发或审查带 profusegw 固定入口和 profusecontract 强类型外部函数调用的 Rust 业务应用。用于定义 protobuf 契约、声明强类型业务配置、编写固定 ProfuseGwContext 四参数 handler、以框架响应映射业务拒绝和技术失败，或运行正式业务门禁。
+description: 使用 Saddle 0.3.4 Skill 开发或审查带 profusegw 固定入口和 profusecontract 强类型外部函数调用的 Rust 业务应用。用于定义 protobuf 契约、声明强类型业务配置、编写固定 ProfuseGwContext 四参数 handler、以框架响应映射业务拒绝和技术失败，或运行正式业务门禁。
 ---
 
-# Saddle 0.3.2 业务研发契约
+# Saddle 0.3.4 业务研发契约
 
 业务 Agent 的直接输入只有业务 spec 与本 Skill。不要要求用户阅读 Saddle 仓库、审计报告、组件提交或内部实现。
 
@@ -29,7 +29,7 @@ description: 使用 Saddle 0.3.2 Skill 开发或审查带 profusegw 固定入口
 
 ```toml
 [dependencies]
-saddle-framework = "=0.3.2"
+saddle-framework = "=0.3.4"
 ```
 
 `saddle-framework` 是唯一业务 facade。业务不得直接依赖 `saddle-core`、`saddle-admission`、`saddle-boundary`、`saddle-db`、`saddle-macros`、`saddle-observability`、`saddle-runtime` 或 `saddle-service`。
@@ -40,7 +40,7 @@ saddle-framework = "=0.3.2"
 - profusegw 唯一入口是 `POST /saddle/v1/ingress/profusegw/invoke`；不得手写 listener、HTTP handler 或第二路由。
 - 应用声明唯一字面量 `deployment_app`；请求 `target.app` 必须逐字匹配。每个字面量 `target.interfaceId` 只由静态 `operation_type` 分派，业务 handler 不读取或自行路由它。
 - profusegw body 固定且只含 `target`、`profuseGwContext`、`requestData`；`profuseGwContext.userInfo.userId` 由框架形成 `ProfuseGwContext { user_id }`，业务 payload 不得覆盖。
-- 每个应用必须声明 `business_config Type;`，每个 handler 的第四参数必须是同一 `BusinessConfig<Type>`。有配置应用从 [完整配置样例](assets/saddle-configured.toml) 起步；没有业务配置时唯一写法是 `business_config ();`，使用 [无业务配置样例](assets/saddle-unit.toml)，`saddle.toml` 省略 `[business]`，测试只使用受控 `BusinessConfig::unit()`。
+- 每个应用必须声明 `business_config Type;`，每个 handler 的第四参数必须是同一 `saddle::BusinessConfig<Type>`。有配置应用从 [完整配置样例](assets/saddle-configured.toml) 起步；没有业务配置时唯一写法是 `business_config ();`，使用 [无业务配置样例](assets/saddle-unit.toml)，`saddle.toml` 省略 `[business]`，测试只使用受控 `saddle::BusinessConfig::unit()`。禁止旧模块路径。
 - 所有 handler 使用 `saddle::ingress::ProfuseGwContext`；只读取正式 API 提供的只读、有界字段，不得读取 Header、Cookie、原始 JSON 或任意上下文 Map。有效 ingress traceId 原样继承，每次外部调用派生 child rpcId；业务不得解析或重写 opaque trace/rpc identity。
 - 固定调用上下文协议见 [trace/LDC 模板](assets/saddle_call_context.proto)：trace 只有 `trace_id/rpc_id`，LDC 只有 `zone/idc/env`。业务请求和结果不得重复这些上下文字段。
 - 所有 handler 直接返回 `saddle::ingress::ProfuseGwResponse<Data, Code>`。成功只形成 `Success { data }`；失败只形成 `Failure { failure: { code, message } }`。
@@ -55,7 +55,10 @@ saddle-framework = "=0.3.2"
 - 业务只使用生成的应用级强类型 capability，不接触 channel、stub、裸 protobuf bytes、动态函数名或通用依赖容器。
 - 不支持 contract 多版本路由、`Any`、开放 Map、任意 JSON、streaming、cancel 或框架自动业务重试。
 - 不创建线程、第二 Runtime、后台 task、裸 DB/网络 I/O、日志 subscriber 或第二执行面。
-- profusecontract 部署只接受 `[framework].profusecontractAuthorityTemplate`：值为一个 `http://host:port` plaintext authority，可含唯一 `{zone}` 占位；不得携带 URL path、凭据、TLS、服务发现或 per-call endpoint。业务 handler 不读取该配置。
+- 唯一配置入口是一个 `saddle.toml`，进程唯一参数为 `--config <path>`。生产启动使用绝对路径，例如 `target/release/my-app --config /etc/my-app/saddle.toml`；`--config saddle.toml` 与 `--config ./saddle.toml` 也合法，均相对当前工作目录定位文件，文件内相对路径则相对该配置文件所在目录解析。
+- profusecontract 部署只接受 `[framework.profusecontract].authority`：值为一个固定 `http://host:port` plaintext authority，或含唯一 `{zone}` 占位的模板；不得携带 URL path、凭据、TLS、服务发现或 per-call endpoint。业务 handler 不读取该配置。
+- 配置在 listener 建立前一次解析、校验、解析 secret 环境引用并冻结。普通配置不接受环境变量覆盖；secret 只能通过 `[secrets]` 明确声明的环境变量名注入。未知字段、缺失必填字段、类型错误、secret 缺失、数据库 secret/mapping 配置不成对或相对路径非法均须 fail-fast。
+- 文件日志只由 `[framework.observability.logging]` 配置；默认目录 `./logs`、默认 `daily`。活动文件固定为 `saddle.log`；daily 归档为 `saddle.log.YYYY-MM-DD`，hourly 归档为 `saddle.log.YYYY-MM-DD-HH`。应用不得安装第二 subscriber，也不得把 stdout/stderr 混入该文件。大小轮转、压缩和清理策略不属于 Saddle 0.3.4，由运维侧管理归档目录容量与采集。
 
 ## 立即停止
 
@@ -68,6 +71,7 @@ saddle-framework = "=0.3.2"
 - handler 返回 Rust `Result`/`Err`、空成功、任意 JSON，或业务自建第二响应结构；
 - 业务拒绝或任一技术失败组合没有显式映射，机器码不稳定，或 `FailureMessage` 超过 256 bytes；
 - 出现旧响应字段、顶层 code/message 或任何旧协议兼容叙述；
-- Cargo 不是精确 `=0.3.2` Rust facade、缺 lock，或正式 Gate 不通过。
+- Cargo 不是精确 `=0.3.4` Rust facade、缺 lock，或正式 Gate 不通过。
+- 出现旧扁平 authority 长键或旧配置类型模块路径。
 
 停止时只交最小复现和期望业务表达，由 Saddle 修复公共能力缺口。

package/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Saddle 0.3 业务应用"
   short_description: "使用 Saddle 0.3 开发受控边界的 Rust 业务应用"
-  default_prompt: "请安装 Saddle 0.3.2 Skill（npm install --save-exact --ignore-scripts --no-audit --no-fund @antprofuse/saddle-skill@0.3.2），结合业务 spec 开始研发。"
+  default_prompt: "请安装 Saddle 0.3.4 Skill（npm install --save-exact --ignore-scripts --no-audit --no-fund @antprofuse/saddle-skill@0.3.4），结合业务 spec 开始研发。"

package/assets/saddle-configured.toml

@@ -1,6 +1,12 @@
 [framework]
 listen = "127.0.0.1:39101"
-profusecontractAuthorityTemplate = "http://127.0.0.{zone}:39102"
+
+[framework.profusecontract]
+authority = "http://127.0.0.{zone}:39102"
+
+[framework.observability.logging]
+directory = "./logs"
+rotation = "daily"
 
 [secrets]
 

package/assets/saddle-database.toml

@@ -0,0 +1,19 @@
+[framework]
+listen = "0.0.0.0:8080"
+
+[framework.profusecontract]
+authority = "http://profusecontract-{zone}.internal:50051"
+
+[framework.observability.logging]
+directory = "/var/log/my-saddle-app"
+rotation = "daily"
+
+[secrets]
+databaseUrlEnv = "SADDLE_DATABASE_URL"
+
+[database]
+mappingDir = "mappings"
+
+[business]
+region = "cn-prod"
+dataPath = "data"

package/assets/saddle-unit.toml

@@ -1,5 +1,11 @@
 [framework]
 listen = "127.0.0.1:39101"
-profusecontractAuthorityTemplate = "http://127.0.0.{zone}:39102"
+
+[framework.profusecontract]
+authority = "http://127.0.0.{zone}:39102"
+
+[framework.observability.logging]
+directory = "./logs"
+rotation = "daily"
 
 [secrets]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@antprofuse/saddle-skill",
-  "version": "0.3.2",
-  "description": "Saddle 0.3.2 中文 AI Coding 研发契约与业务门禁。",
+  "version": "0.3.4",
+  "description": "Saddle 0.3.4 中文 AI Coding 研发契约与业务门禁。",
   "license": "MIT OR Apache-2.0",
   "files": ["SKILL.md", "agents", "references", "scripts", "assets"],
   "bin": {"saddle-03-gate": "scripts/saddle-03-gate.js"},

package/references/consumer-start.md

@@ -46,7 +46,7 @@ Saddle 在编译期从 `contract_dir` 确定性递归收集 `.proto`，闭合 im
 
 ## 阶段 3：Rust 实现
 
-业务 crate 精确使用 `saddle-framework = "=0.3.2"`，然后按 [最小编程模型](programming-model.md) 编写固定 `deployment_app`、显式 `business_config`、静态 operation 声明和四参数 handler。不得直接依赖任何 Saddle 中间件 crate。
+业务 crate 精确使用 `saddle-framework = "=0.3.4"`，然后按 [最小编程模型](programming-model.md) 编写固定 `deployment_app`、显式 `business_config`、静态 operation 声明和四参数 handler。不得直接依赖任何 Saddle 中间件 crate。
 
 实现通过 Gate 后，按 [本地联调](local-integration.md) 由外部 harness 注入唯一 plaintext profusecontract authority，并以固定 profusegw body 验证真实 typed call。endpoint、request/call identity 和 deadline 都是框架或部署输入，不写入业务 spec。
 
@@ -63,6 +63,6 @@ Saddle 在编译期从 `contract_dir` 确定性递归收集 `.proto`，闭合 im
 - 缺少固定 `deployment_app`，或 app/interfaceId/endpoint 被做成动态业务输入；
 - 技术失败码或执行确定性存在 catch-all/default；
 - 需要裸 gRPC/channel/bytes、第二入口、动态 descriptor 或未声明外部 I/O；
-- `saddle-framework` 不是精确 `=0.3.2`，或 [正式 Gate](validation.md) 失败。
+- `saddle-framework` 不是精确 `=0.3.4`，或 [正式 Gate](validation.md) 失败。
 
 停止产物只包含最小复现、缺失身份和期望业务表达，不包含中间件替代实现。

package/references/external-function-contracts.md

@@ -15,7 +15,7 @@
 - `puc` 是业务单元，例如 `puc`。
 - `function` 是契约原始函数名，允许中文，例如 `查询用户绑定户号`。
 - protobuf method、Rust 方法和 Java 方法使用各语言合法的本地标识符；它们不是跨系统身份。
-- 0.3.2 不定义 contract version、多版本路由、翻译表、alias 或 fallback。
+- 0.3.4 不定义 contract version、多版本路由、翻译表、alias 或 fallback。
 
 ## 定义步骤
 
@@ -82,4 +82,4 @@ message BoundAccount {
 
 ## 变更规则
 
-先修改共同契约目录并重新通过双方 conformance，再修改两侧实现。禁止两侧各自维护近似定义后人工对齐；0.3.2 遇到不兼容变化时停止并共同升级，不在运行时并存或猜测版本。
+先修改共同契约目录并重新通过双方 conformance，再修改两侧实现。禁止两侧各自维护近似定义后人工对齐；0.3.4 遇到不兼容变化时停止并共同升级，不在运行时并存或猜测版本。

package/references/local-integration.md

@@ -27,14 +27,29 @@ profusegw 只向固定路径发送通用 JSON body；业务接口不新增 URL
 
 固定 HTTP profile 是 `POST /saddle/v1/ingress/profusegw/invoke` 与 `application/json`。本地 harness 必须给出受控 request identity、call identity 和绝对 deadline；不要在业务 handler 中构造它们。
 
-## 唯一 plaintext endpoint
+## 正式启动与唯一配置
 
-0.3.2 部署配置只接受 `saddle.toml` 的正式键 `[framework].profusecontractAuthorityTemplate`。有业务配置的完整最小文件是 [saddle-configured.toml](../assets/saddle-configured.toml)，`business_config ();` 应用使用不含 `[business]` 的 [saddle-unit.toml](../assets/saddle-unit.toml)。例如：
+先构建 release 制品，再以前台进程启动：
+
+```bash
+cargo +1.95.0 build --release --locked
+target/release/my-saddle-app --config /etc/my-saddle-app/saddle.toml
+```
+
+生产推荐传绝对配置路径。`--config saddle.toml` 与 `--config ./saddle.toml` 也合法，它们都相对进程当前工作目录定位配置文件；配置中的 `mappingDir` 和业务 `resolve_path()` 则相对 `saddle.toml` 所在目录解析。进程只接受这一对参数，不从默认位置搜索、不合并多文件、不热更新。
+
+0.3.4 部署配置只接受 `[framework.profusecontract].authority`。有业务配置的完整最小文件是 [saddle-configured.toml](../assets/saddle-configured.toml)，`business_config ();` 应用使用不含 `[business]` 的 [saddle-unit.toml](../assets/saddle-unit.toml)：
 
 ```toml
 [framework]
 listen = "127.0.0.1:39101"
-profusecontractAuthorityTemplate = "http://127.0.0.{zone}:39102"
+
+[framework.profusecontract]
+authority = "http://127.0.0.{zone}:39102"
+
+[framework.observability.logging]
+directory = "./logs"
+rotation = "daily"
 
 [secrets]
 
@@ -43,9 +58,19 @@ region = "cn-test"
 dataPath = "fixtures/data"
 ```
 
-键值必须是 `http` plaintext 的 `host:port`，可选且只能出现受控 `{zone}` 模板；模板用同一请求的 LDC zone 在连接前解析。不得包含其他模板、path、query、fragment、userinfo、凭据或动态函数信息。键缺失、近似键、缺失或非法 zone 都必须 fail-fast，禁止普通环境变量 fallback。所有强类型函数共享这一部署级连接目标；线上 gRPC method 固定为 `ProfuseContractBoundary/Invoke`，应用不得按函数配置 endpoint。
+字段合同：
+
+- `[framework].listen`：必填字符串、无默认值，格式为可解析的 `IP:port`，决定实际 ProfuseGW bind 地址。
+- `[framework.profusecontract].authority`：必填字符串、无默认值；必须是 plaintext `http://host:port` 固定地址，或只含一个 `{zone}` 的模板。模板由同一请求的 LDC zone 在调用前解析；禁止 path、query、fragment、userinfo、凭据和其他模板。
+- `[framework.observability.logging].directory`：可选路径，默认 `./logs`；相对路径按进程当前工作目录解析。目录必须可创建并可写，否则 listener 建立前 fail-fast。
+- `[framework.observability.logging].rotation`：可选枚举，默认 `daily`，也可显式设为 `hourly`。活动文件永远是 `saddle.log`；daily 归档名为 `saddle.log.YYYY-MM-DD`，hourly 归档名为 `saddle.log.YYYY-MM-DD-HH`。
+- `[secrets].databaseUrlEnv`：仅数据库应用使用；值是必填环境变量的名称，不是连接串本身。启动时该环境变量必须存在且有效。
+- `[database].mappingDir`：仅数据库应用使用；必须和 `databaseUrlEnv` 同时出现，指向相对配置文件目录的映射目录。数据库模板见 [saddle-database.toml](../assets/saddle-database.toml)。
+- `[business]`：仅 `business_config Type;` 应用使用；字段由该强类型 `Type` 决定，没有框架默认值。字段缺失、额外或类型错误均拒绝。`business_config ();` 必须省略整节。
+
+所有配置在 listener 建立前一次解析和冻结。普通字段不能由环境变量覆盖；secret 只能通过 `[secrets]` 中明确声明的环境变量引用注入。文件不可读、未知/旧键、缺失字段、类型错误、非法 bind/authority、secret 缺失、数据库配置不完整或映射目录非法都必须 fail-fast，并返回稳定的 `saddle.process.*` 错误码。
 
-此 endpoint 是部署输入，不进入业务 spec、request 或 handler。TLS、鉴权、服务发现、负载均衡和生产凭据不属于 0.3.2；需要其中任一能力时立即停止，不得在业务 crate 自建 client。
+该 authority 是部署输入，不进入业务 spec、request 或 handler。TLS、鉴权、服务发现、负载均衡和生产凭据不属于 0.3.4；需要其中任一能力时立即停止，不得在业务 crate 自建 client。
 
 ## 联调完成条件
 
@@ -57,6 +82,6 @@ dataPath = "fixtures/data"
 4. 返回 `Completed` 或八类 `TechnicalFailure × ExecutionCertainty` 之一；业务代码显式处理，不自动重试。
 5. 受管请求只形成一个 terminal，并在写 HTTP response 前完成资源归还。
 
-结构化日志至少按正式 API 暴露的字段记录 trace/rpc、span/parent、request/call、app/interface、zone、outcome 与 duration；不得记录 payload、Cookie、session、原始 context、PII、secret 或数据库值。业务不得安装第二日志 subscriber。
+结构化日志至少按正式 API 暴露的字段记录 trace/rpc、span/parent、request/call、app/interface、zone、outcome 与 duration；不得记录 payload、Cookie、session、原始 context、PII、secret 或数据库值。业务不得安装第二日志 subscriber。`saddle.log` 是框架结构化日志；stdout/stderr 是独立进程流，运维采集时不得与文件日志拼接成同一记录源。Saddle 0.3.4 不提供按大小轮转、归档压缩或历史清理；目录容量、外部采集、压缩与保留期由业务运维环境负责。
 
 联调 harness 可托管 listener 与受控 profusecontract server；业务源码不得复制 harness、直接依赖中间件 crate或注册第二入口。

package/references/programming-model.md

@@ -2,7 +2,7 @@
 
 ## 应用显式声明
 
-业务应用使用 `saddle-framework = "=0.3.2"` 的公开编程面：
+业务应用使用 `saddle-framework = "=0.3.4"` 的公开编程面：
 
 ```rust
 saddle::application! {
@@ -53,7 +53,7 @@ async fn query_my_bound_accounts(
     request: QueryMyBoundAccountsRequest,
     context: saddle::ingress::ProfuseGwContext,
     contract: PucProfuseContract,
-    config: saddle::config::BusinessConfig<BusinessSettings>,
+    config: saddle::BusinessConfig<BusinessSettings>,
 ) -> saddle::ingress::ProfuseGwResponse<QueryMyBoundAccountsResult, BusinessCode>;
 ```
 
@@ -73,7 +73,7 @@ business_config ();
 
 此时 `saddle.toml` 省略 `[business]`，测试 harness 传入 `BusinessConfig::unit()`。有配置时使用 `business_types!` 声明封闭类型，并在 `saddle.toml` 的单一 `[business]` 表中提供值；不得使用动态 Map、普通环境变量覆盖或多文件 merge。
 
-完整配置从 [有配置模板](../assets/saddle-configured.toml) 复制；无业务配置从 [unit 模板](../assets/saddle-unit.toml) 复制。两者都必须在 `[framework]` 中显式写 `profusecontractAuthorityTemplate`，不能改成 `profusecontractAuthority`、endpoint 环境变量或其他近似键。有配置模板的 `region/dataPath` 对应示例 `BusinessSettings`；实际字段必须与应用声明的强类型配置逐字一致。
+完整配置从 [有配置模板](../assets/saddle-configured.toml) 复制；无业务配置从 [unit 模板](../assets/saddle-unit.toml) 复制；使用数据库时从 [数据库模板](../assets/saddle-database.toml) 复制相关两节。三者都只在 `[framework.profusecontract]` 中写 `authority`。禁止旧长键、近似键或 endpoint 环境变量。有配置模板的 `region/dataPath` 对应示例 `BusinessSettings`；实际字段必须与应用声明的强类型配置逐字一致。公开配置类型路径只有 `saddle::BusinessConfig`，禁止旧模块路径。
 
 生成的强类型 async 调用必须等待结果，并分别处理完成结果与技术失败：
 

package/references/validation.md

@@ -1,4 +1,4 @@
-# Saddle 0.3.2 Skill 正式业务 Gate
+# Saddle 0.3.4 Skill 正式业务 Gate
 
 ## 依赖与锁
 
@@ -12,7 +12,7 @@ edition = "2024"
 rust-version = "1.95"
 
 [dependencies]
-saddle-framework = "=0.3.2"
+saddle-framework = "=0.3.4"
 ```
 
 在允许访问正式 registry 的依赖准备阶段生成并提交 `Cargo.lock`。禁止 `path`、`git`、`[patch]`、source replacement 或宽松 Saddle 版本。
@@ -25,16 +25,16 @@ saddle-framework = "=0.3.2"
 npx --no-install saddle-03-gate --manifest-path Cargo.toml
 ```
 
-命令由已安装的 `@antprofuse/saddle-skill@0.3.2` 提供，不需要 Saddle 源码仓库。它会检查：
+命令由已安装的 `@antprofuse/saddle-skill@0.3.4` 提供，不需要 Saddle 源码仓库。它会检查：
 
 - facade 精确版本、禁止直接中间件依赖和 Cargo source 旁路；
-- `Cargo.lock` 中 boundary、db、framework、macros、observability、runtime、service 七包统一精确映射 `0.3.2`；
+- `Cargo.lock` 中 admission、boundary、core、db、framework、macros、observability、runtime、service 九包统一精确映射 `0.3.4`；
 - 唯一 `contract_dir`、目录存在、禁止旧单文件 contract 声明；
 - 目录根部 `saddle_external_function.proto` 与 Skill 权威模板逐字一致且仅出现一次，使用 option 的业务 proto 必须 direct import 根文件；
 - 编译期递归扫描/import 闭包、option-only 索引、身份唯一、请求结果类型匹配，以及所有 function 均有实际 `uses`；
 - 固定 `ProfuseGwContext`、应用声明、八类技术失败与三种 certainty 均被显式引用；
 - `application/2` 显式 `business_config Type`（无配置为 `()`），handler 四参数接收同型冻结 `BusinessConfig<Type>`；
-- 部署配置使用唯一正式键 `[framework].profusecontractAuthorityTemplate`；有配置与 unit 应用分别使用 Skill 的完整样例，unit 文件不得出现 `[business]`；
+- 部署配置使用唯一正式键 `[framework.profusecontract].authority`；有配置与 unit 应用分别使用 Skill 的完整样例，unit 文件不得出现 `[business]`；旧长键与旧配置类型模块路径均拒绝；
 - handler 直接返回框架 `ProfuseGwResponse`，应用声明封闭 `response_code`，业务码实现 `ProfuseGwCode` 并注册无碰撞稳定机器码；
 - 失败只使用 `ProfuseGwFailure { code, FailureMessage }`，拒绝旧字段、重复分类、顶层 code/message、Rust `Result`/`Err`、第二响应外壳、任意 JSON、无界展示文案、空成功及技术失败 wildcard/default；
 - 唯一字面量 `deployment_app`、静态 `operation_type`，并拒绝业务代码读取或动态路由 `target.app/interfaceId`；

package/scripts/saddle-03-gate.js

@@ -30,8 +30,8 @@ if (/^\s*\[(patch|replace)\b/m.test(cargo) || /\b(path|git|branch|tag)\s*=/.test
   stop("DEPENDENCY_SOURCE", "禁止 path/git/patch/replace 依赖旁路");
 }
 const facade = cargo.match(/^\s*saddle-framework\s*=\s*(.+)$/m);
-if (!facade || !/^"=0\.3\.2"\s*(?:#.*)?$/.test(facade[1].trim())) {
-  stop("SADDLE_VERSION", '必须直接且精确依赖 saddle-framework = "=0.3.2"');
+if (!facade || !/^"=0\.3\.4"\s*(?:#.*)?$/.test(facade[1].trim())) {
+  stop("SADDLE_VERSION", '必须直接且精确依赖 saddle-framework = "=0.3.4"');
 }
 const internals = ["saddle-core","saddle-admission","saddle-boundary","saddle-db","saddle-macros","saddle-observability","saddle-runtime","saddle-service"];
 for (const name of internals) {
@@ -44,8 +44,8 @@ if (!fs.existsSync(lockPath)) {
   const publicClosure = ["saddle-admission", "saddle-boundary", "saddle-core", "saddle-db", "saddle-framework", "saddle-macros", "saddle-observability", "saddle-runtime", "saddle-service"];
   for (const name of publicClosure) {
     const escaped = name.replaceAll("-", "\\-");
-    if (!new RegExp(`name = "${escaped}"\\nversion = "0\\.3\\.2"`).test(lock)) {
-      stop("LOCK", `Cargo.lock 未绑定 ${name} 0.3.2`);
+    if (!new RegExp(`name = "${escaped}"\\nversion = "0\\.3\\.4"`).test(lock)) {
+      stop("LOCK", `Cargo.lock 未绑定 ${name} 0.3.4`);
     }
   }
 }
@@ -67,18 +67,25 @@ if (!fs.existsSync(configPath)) {
 } else {
   const config = fs.readFileSync(configPath, "utf8");
   let section = "";
-  const authorityTemplates = [];
+  const authorities = [];
   for (const line of config.split(/\r?\n/)) {
     const header = line.match(/^\s*\[([^\]]+)\]\s*(?:#.*)?$/);
     if (header) { section = header[1]; continue; }
-    const authority = line.match(/^\s*profusecontractAuthorityTemplate\s*=\s*"([^"]+)"\s*(?:#.*)?$/);
-    if (authority && section === "framework") authorityTemplates.push(authority[1]);
+    const authority = line.match(/^\s*authority\s*=\s*"([^"]+)"\s*(?:#.*)?$/);
+    if (authority && section === "framework.profusecontract") authorities.push(authority[1]);
   }
-  if (authorityTemplates.length !== 1 || !/^http:\/\/[^"/]+:\d+$/.test(authorityTemplates[0])) {
-    stop("AUTHORITY_TEMPLATE", "[framework] 必须显式配置合法 profusecontractAuthorityTemplate");
+  if (authorities.length !== 1 || !/^http:\/\/[^"/]+:\d+$/.test(authorities[0])) {
+    stop("AUTHORITY_TEMPLATE", "[framework.profusecontract] 必须显式配置合法 authority");
   }
-  if (/^\s*(?:profusecontractEndpointEnv|profusecontractAuthority)\s*=/m.test(config)) {
-    stop("AUTHORITY_TEMPLATE", "禁止旧 endpoint/近似 authority 配置键");
+  if (/^\s*(?:profusecontractAuthorityTemplate|profusecontractEndpointEnv|profusecontractAuthority)\s*=/m.test(config)) {
+    stop("AUTHORITY_TEMPLATE", "禁止旧长键或近似 authority 配置键");
+  }
+  const logging = config.match(/^\s*\[framework\.observability\.logging\]\s*$([\s\S]*?)(?=^\s*\[|\s*$)/m);
+  if (logging) {
+    const directory = logging[1].match(/^\s*directory\s*=\s*"([^"]+)"\s*$/m);
+    const rotation = logging[1].match(/^\s*rotation\s*=\s*"([^"]+)"\s*$/m);
+    if (directory && directory[1].trim() === "") stop("LOGGING", "logging.directory 不得为空");
+    if (rotation && !/^(daily|hourly)$/.test(rotation[1])) stop("LOGGING", "logging.rotation 只允许 daily/hourly");
   }
   const unitConfig = /\bbusiness_config\s+\(\)\s*;/.test(source);
   const hasBusinessTable = /^\s*\[business\]\s*$/m.test(config);
@@ -89,6 +96,7 @@ if (!fs.existsSync(configPath)) {
 if (!source.includes("application!")) stop("APPLICATION", "缺少 Saddle application! 声明");
 if (!/\bbusiness_config\s+(?:\(\)|[A-Za-z_][A-Za-z0-9_:<>]*)\s*;/.test(source)) stop("BUSINESS_CONFIG", "application/2 必须显式声明 business_config 类型或 ()");
 if (!source.includes("BusinessConfig")) stop("BUSINESS_CONFIG", "handler 必须接收冻结 BusinessConfig");
+if (source.includes("saddle::config::BusinessConfig")) stop("BUSINESS_CONFIG", "公开类型路径必须是 saddle::BusinessConfig");
 if (!source.includes("ProfuseGwContext")) stop("CONTEXT", "handler 必须使用固定 ProfuseGwContext");
 if (!source.includes("ProfuseGwResponse")) stop("RESPONSE", "handler 必须直接返回框架 ProfuseGwResponse");
 if (!source.includes("ProfuseGwCode")) stop("RESPONSE_CODE", "业务码必须实现 ProfuseGwCode");
@@ -174,4 +182,4 @@ try {
   fs.rmSync(target, {recursive: true, force: true});
 }
 if (process.exitCode) process.exit(process.exitCode);
-process.stdout.write("SADDLE_03_GATE PASS; SKILL=0.3.2; RUST=0.3.2; CLOSED_RESPONSE; CLOSED_CODES; FAILURE_MESSAGE_256; FAILURE_8X3; LOCKED_OFFLINE\n");
+process.stdout.write("SADDLE_03_GATE PASS; SKILL=0.3.4; RUST=0.3.4; CLOSED_RESPONSE; CLOSED_CODES; FAILURE_MESSAGE_256; FAILURE_8X3; LOCKED_OFFLINE\n");