wurangyu/sap-cli-skill
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
29 Commits 1 Branch 0 Tags
d0d65db137b1c3707a87fe09fd30db0cd28ba1ed
Commit Graph
13 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
吴让宇 d0d65db137 feat(info): DDIC 类型补全描述与开发包（NW 7.40 ADT 不返回） 
NW 7.40 的 */* 响应不含 description/packageRef，info 对 structure/table/tabletype/dataelement/domain 在 ADT 返回值为空时回退查文本表补描述（DD02T/DD40T/DD04T/DD01T）、查 TADIR 补开发包。语言按「登录语言 -> E -> 1 -> 首行」回退；补查异常静默降级不打断输出；TADIR 无行时保持 (未指定)。
 2026-09-11 01:39:05 +08:00
吴让宇 a58275aa51 docs(rules): 补 ADT Data Preview SQL 方言实测约束 
真机侦察（S4T / NW 7.40）确认 data preview freestyle 解析器只接受窄 SQL 子集：
- 选择列必须逗号分隔；WHERE 不支持 =，只支持 IN / LIKE
- 现状 --where 'F=X' 会 400 并抛未捕获堆栈（非友好报错）

新增：错误速查 3 行 + 方言/元数据表对照小节（DD02T/DD40T/DD04T/DD01T + TADIR）；
sap-tool-constraints 规则 9 + 自检项 10。references/ 与 .claude/rules/ 已同步。

顺带记录：info 的传输请求恒为 (无法获取)——E071 查询用的 = 在该方言必 400，异常被吞。
 2026-09-11 01:17:21 +08:00
吴让宇 d84099d5b3 docs: 406 真因入库 + 标注过时的差距分析报告 
- references/error-handling.md：新增「HTTP 406 (info 查 DDIC)」行——NW 7.40 不支持 DDIC
  专属媒体类型，且 application/xml 同样 406，只有 */* 可用（工具已内置回退，无需手工处理）。
  同步 .claude/rules/error-handling.md 副本（守卫测试强制两份一致）。
- docs/差距分析报告.md：加历史快照声明。原文（2026-06-17 / v2.1.0）的 P1 #3「info 的 Accept
  头映射缺 7 种类型」已不成立（现覆盖 18 种），且真因是回退值本身无效——留着会把人引向错方向。
  同时标注命令数 25 → 31。

699 tests OK。
 2026-09-11 00:59:39 +08:00
吴让宇 86519c51d6 fix(info): 406 回退值改为 */* —— 原值 application/xml 本身也返回 406 
`info` 在 NW 7.40 上对 DDIC 类型恒报「查询失败: HTTP 406」，实测根因：
回退分支把 Accept 从专属媒体类型换成 `application/xml`，而该值在本系统同样返回 406，
等于没回退。真实客户端 `_headers()` 的 Accept 默认值本就是 `*/*`，此处相当于
把可用默认值覆盖成了失效值。

实测（S4T / NW 7.40，structure ZMM_BIP_001_HEADER）：
  application/vnd.sap.adt.ddic.structures.v1|v2|v3+xml → 406
  application/xml                                      → 406
  */*                                                  → 200
修后真机验证：`info --name ZMM_BIP_001_HEADER --type structure` 查询成功。

已知限制（非本修复引入）：NW 7.40 的 DDIC 端点在 */* 下只返回 blueSource，
不含 description/packageRef，故 structure/tabletype 等类型的「描述/开发包/负责人」
为空。需这些字段时用 read-table 查 DD02T（描述）/ TADIR（开发包）。
（objectproperties 端点在本系统返回 422，不可用。）

测试：
- 新增 test_info_406_fallback_accept_is_wildcard —— 断言回退 Accept 必须为 */*，
  且明确排除 application/xml。**必须用 side_effect 在请求发生时快照 headers**：
  cmd_info 重试时复用同一个 hdrs dict，直接读 call_args_list[i].kwargs["headers"]
  会因别名而全部显示最后一次赋的值，令该断言永远无法成立。
- 三个测试文件的 _make_client() 由 `_headers.return_value={...}`（共享 dict）
  改为 side_effect 返回新 dict，与真实实现一致——原写法会让被记录的 headers
  全部指向同一对象，使 header 断言失真。
- 反向验证：把回退改回 application/xml → 测试报红 AssertionError('application/xml' != '*/*')。

699 tests OK。
 2026-09-11 00:53:02 +08:00
吴让宇 c5905a5b1e refactor: 本仓升为唯一源（原 sap-cli 源码仓归档） 
方向反转：此前 SKILL.md 是「模板渲染产物」、sap-cli 是源；现 sap-cli 归档，
sap-cli-skill 承接开发与分发，SKILL.md 回归手工维护的正本。

迁移（来自 sap-cli，共 104 文件）：
- tests/           692 例测试（15 个文件的内联 sys.path 改指 assets/）
- openspec/        SDD 规格与归档变更（42 文件）
- docs/            开发文档与 ADT 原理（含 dev/CLAUDE.md、AGENTS.md）
- .claude/         rules 副本 + settings.json（供 Claude Code）
- .github/ .hermes/ .pre-commit-config.yaml .editorconfig CLAUDE.md
- scripts/ 保持仅 setup.py（pack_skill.py 已随旧仓归档，不迁）

修复（迁移暴露的真实缺陷）：
- assets/pyproject.toml 的 build-backend 写作 `setuptools.backends._legacy:_Backend`，
  该模块在 setuptools 中不存在 → `pip install -e` 从来装不上。改为 build_meta。
  实测：临时 venv 安装成功，sap-cli --help 正常列出 31 个命令
- pyproject readme 指向不存在的 assets/README.md（editable 安装会失败）→ 改内联文本
- pyproject urls 改指 sap-cli-skill

机制调整：
- .github/workflows/ci.yml 适配 assets/ 布局；顶部注明该工作流仅 GitHub 执行，
  本仓在 Gitee 不会自动跑
- pre-commit 增本地测试门禁（Gitee 上真正生效的那道）
- .gitignore 合并旧仓完整规则（保留 log/ 下 md 知识库入库，只忽略运行日志）
- 大文件上限 100KB→1MB（架构图 512KB）

守卫测试 tests/unit/test_repo_guards.py（10 → 18 例）：
- SKILL.md 须记录 parser 全部 CLI 命令 / 铁律 1-5 须为真实小节标题 / 示例不得违反铁律 5
- references/ 规则齐备；.claude/rules 与 references 必须一致（实测抓到一次真实漂移）
- VERSION == sapcli.__version__ == README 版本
- 仓内不得再出现 pack_skill.py / skill-src（防废弃流程回潮）

698 tests OK；editable 安装与 CLI 入口经临时 venv 实测通过。
docs/RELEASING.md 重写为单源开发流程。
 2026-09-11 00:40:15 +08:00
吴让宇 e786742bcb chore: 同步至源码 2.5.1 — SKILL.md 改为构建产物 + 工具代码刷新 
SKILL.md（唯一来源 = sap-cli/skill-src/SKILL.md.tmpl）：
- 本仓 SKILL.md 自此为构建产物，勿手工编辑；手改后再构建会被漂移护栏拦下
- 并入模板独有内容：调用方式节 + 补齐 parser 真实命令（clone/enhancement/
  history/unit-test/unlock/transport create，原表只 9 个，实际 31 个）
- 版本号改为 {{VERSION}} 注入（原字面量停在 v2.2.1/v2.3.0，与工具实际版本脱节）
- 修 1 处违反铁律 5 的示例（--path ./src → ./src/TMP/class/）

assets/（工具代码，此前严重过时）：
- 9 个文件与源码不一致，scanner.py 尤甚：3818B → 6664B
- 修复前从本仓装出的工具**不支持三层 src 结构**，铁律 5 实际跑不通
- transport.py 反向漂移（分发版多 transport create，源码无）已随源码回迁对齐

VERSION 2.5.1；references/ 三份规则与源码一致（无差异）
 2026-09-11 00:22:05 +08:00
吴让宇 df1533e843 chore: VERSION 对齐 2.3.0 → 2.5.1（与 sapcli.__version__ 及 SKILL.md 一致） 2026-09-11 00:09:01 +08:00
吴让宇 09e032aa36 docs(铁律5): 工具已支持三层布局，更新扫描能力说明；version 2.5.0 → 2.5.1 
- 移除「已知工具缺口」表述，改为：init/sync --all 已支持 src/<包>/<类型>，单复数目录名与大小写均接受
- 补函数模块两种命名（子目录式 / ADT .fugr. 式）
 2026-09-10 23:51:42 +08:00
吴让宇 c0ec5c9c8c feat(铁律5): src 目录三层结构（TMP 开发包 → 对象类型 → 代码） 
- 第 1 层固定 TMP（对应 SAP $TMP 本地包，去 $ 防 shell 展开），归入传输包后改包名
- 第 2 层 = 对象类型目录（开发对象），第 3 层 = 代码文件
- download --path 必须指到对象类型目录，否则产出平铺结构
- Quick Start 示例同步修正；目录结构节标注为唯一合法层次
- 事故总结表补第 8 行（平铺下载导致结构返工）
- version 2.4.0 → 2.5.0
 2026-09-10 23:48:21 +08:00
吴让宇 86ca474413 fix(references): 修正 sap-cli 运行时路径 D:/Codespace/sap-cli → D:/Gitee/sap-cli 2026-09-10 23:48:20 +08:00
吴让宇 eae0b3547c feat(v2.4.0): 开发铁律——DDIC 先行(依赖顺序+实测判定) + 强制闭环(本地改→同步→语法检查→循环至0错→激活→测试)；补 2026-09-10 S4T 事故问题总结与自检清单 2026-09-10 23:14:43 +08:00
吴让宇 f4210b06db docs(sap-cli): 补 DDIC 结构/表类型落地路径（run-program + DDIF_*_PUT/ACTIVATE）与踩坑；脚手架清理用 delete 管道确认 2026-09-10 23:10:47 +08:00
吴让宇 fc90bc719c rules(E04/E05): CALL FUNCTION 强制核实被调对象存在性与签名一致（老板指令 09-10） 
- E04：调用 Z 对象/引用 Z 结构前，必须 sap-cli info/download/read-table DD02L 核实对象真实存在且名称逐字符一致
- E05：参数名/类型/顺序以核实到的函数签名为准（函数头 Local Interface 节），结构组件以 DD02L/DD03L 实查为准
- 根因：ADT syntax-check 只覆盖当前对象自身，不校验被调函数存在性与结构匹配——本地全绿≠运行期不转储
- SKILL.md 质检标准行同步（28→38 条口径修正 + E04/E05 强制标注）
 2026-09-10 22:38:09 +08:00