🐛 fix(mcp): 补齐 PostgreSQL 时间类型别名映射

[ZhaoXingPeng]

关联 Issue

Closes #169

背景（Situation）

db_table_describe(include_java_types=true) 使用 MCP 侧的 YAML 类型映射解析 PostgreSQL format_type() 返回的完整类型名。生成器方言已支持 TIME WITHOUT TIME ZONE、TIMESTAMP WITHOUT TIME ZONE 和 TIMESTAMPTZ，但 MCP 配置只覆盖短名称或带时区完整名称，导致同一数据库列在描述响应中返回 Object，并遗漏 java.time import。

任务（Task）

补齐 PostgreSQL 时间类型别名，使 MCP 描述结果与 PostgreSQL 类型语义一致，同时保持现有 UUID、JSONB 和完整时区名称的返回值不变。

行动（Action）

• 提交：369cf94
• 在 default_type_mapping.yaml 的 PostgreSQL datetime 节点增加：
  • TIME_WITHOUT_TIME_ZONE -> LocalTime
  • TIMESTAMP_WITHOUT_TIME_ZONE -> LocalDateTime
  • TIMESTAMPTZ -> OffsetDateTime
• 为三个实际 catalog 字符串新增回归断言，验证 Java 类型和标准库 import 同时完整。
• 不重写 MCP 映射架构，不调整 DialectAdapter 或 UUID 既有语义，不修改 SQL、输入 schema 和真实数据库连接逻辑。

验证（Verification）

环境：Windows，仓库 .venv，Python 3.10.1，pytest 9.0.3，Ruff 来自 .venv。

PYTHONPATH=src python -m pytest tests/unit/test_postgresql_mcp_tools.py -q
12 passed in 3.77s

PYTHONPATH=src python -m pytest tests/unit/ -q
689 passed in 5.59s

PYTHONPATH=src python -m ruff check src/ tests/ scripts/
All checks passed!

git diff --check
无输出

未运行真实 PostgreSQL/Testcontainers、Java/Maven 或 CI；这些不属于本次提交前的本地验证范围。

实验与证据（Evidence）

固定输入直接调用 _get_java_type_mapping(DatabaseType.POSTGRESQL, type_name)，覆盖 PostgreSQL catalog/format_type() 可能返回的三个别名：

time without time zone {'java_type': 'LocalTime', 'imports': ['java.time.LocalTime']}
timestamp without time zone {'java_type': 'LocalDateTime', 'imports': ['java.time.LocalDateTime']}
timestamptz {'java_type': 'OffsetDateTime', 'imports': ['java.time.OffsetDateTime']}

修复前这三项均会落到 Object/空 imports；当前结果与 PostgreSQLDialect 的类型语义一致。未据此宣称性能提升或生产数据库覆盖。

兼容性、风险与回滚

• MCP 返回字段结构不变，只把此前无法识别的合法 PostgreSQL 时间别名映射为已有 java.time 类型。
• 风险：配置文件仍由 Markdown fenced YAML 解析，后续新增别名需同时添加回归测试；其他数据库方言不受影响。
• 回滚：恢复单一提交 369cf94 即可，无数据库或配置迁移。
• 本 PR base 为 fix/167-codegen-imports，仅包含本主题一个新增提交；待前置代码生成 PR 按顺序合并后再回到 main。

[ZhaoXingPeng]

实现完成（2026-09-09）

当前结论

Issue #169 的配置缺口已修复。MCP 旧 YAML 映射现在覆盖 PostgreSQL format_type() 可能返回的无时区和缩写时间类型；此前会落到 Object 的三种输入均能返回对应 java.time 类型与 import。

变更与设计取舍

• 提交：46760b9
• 只修改 src/dbjavagenix/config/default_type_mapping.yaml 与 PostgreSQL MCP 回归测试，共 19 行新增。
• 选择补齐配置别名而不是重写 _get_java_type_mapping()，因为本主题只需恢复既有 YAML 契约，避免改变 UUID、JSONB 和未知类型语义。
• uv.lock 保持未跟踪、未提交；本 PR 只有一个新增提交。

验证与证据

• 固定输入：time without time zone、timestamp without time zone、timestamptz。
• 三项均返回预期 Java 类型和对应 java.time import；此前结果为 Object/空列表。
• 定向测试：python -m pytest tests/unit/test_postgresql_mcp_tools.py -q，12 passed。

兼容性与下一步

• 返回字段结构不变，不涉及 SQL、凭据或真实数据库。
• 待验证完成后保留当前分支，合并前按依赖链统一检查最终 required checks。

[ZhaoXingPeng]

验证完成（2026-09-09）

当前结论

完整单元测试和静态检查均通过。回归覆盖 MCP 类型映射函数的三个 PostgreSQL 别名，并保留既有完整时区名称、UUID、JSONB 断言；未运行真实 PostgreSQL 或 CI，因此不扩大验证结论。

变更与设计取舍

• 提交：46760b9
• 配置仍由现有 _load_default_type_mapping() 解析，排序、响应字段和异常语义不变。
• 没有做全仓库格式化；配置换行已恢复到基线，差异仅为三组别名及测试。

验证与证据

• PYTHONPATH=src python -m pytest tests/unit/test_postgresql_mcp_tools.py -q：12 passed in 3.77s。
• PYTHONPATH=src python -m pytest tests/unit/ -q：689 passed in 5.59s。
• PYTHONPATH=src python -m ruff check src/ tests/ scripts/：All checks passed!。
• git diff --check：无输出。
• 别名实验原始输出已记录在 PR 正文 Evidence 段落。

兼容性与下一步

• 未执行真实数据库/Testcontainers、Java/Maven 和 CI；没有生产方言或性能结论。
• 回滚点为 46760b9；待前置 PR 🐛 fix(mcp): 统一跨工具驱动值 JSON 序列化 #162、🐛 fix(mcp): 收口全部 MCP 响应 JSON 序列化 #164、🐛 fix(codegen): 规范无前缀模板输出路径 #166、🐛 fix(codegen): 统一分析结果与模板导入映射 #168 按顺序处理，合并前只检查一次最终 required checks。

[ZhaoXingPeng]

提交校正（2026-09-09）

为满足 changed-file Ruff format gate，新增断言的换行在未合并提交中完成一次 amend；当前唯一提交为 369cf94（此前回帖中的 46760b9 已被该未合并提交替代）。文件内容和验证结论不变，分支相对 base 仍只有 1 个提交；未查询 CI。