# oracle-jump-query Skill Release Standard

Release 1.5.48: 补充 BOS 新建表最小结构，保留八个基础字段、类型、可空性、`ISACTIVE DEFAULT 'Y' NOT NULL` 和 `ID` 主键；DDL 仅生成供人工确认执行。本次仅更新 Skill 文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

Release 1.5.47: 补充用户提供表名称时的 BOS 表解析规则：未明确要求绕过 BOS 元数据直接查询物理数据库对象时，先查 `AD_TABLE.NAME`、`DESCRIPTION` 和 `REALTABLE_ID`；虚拟表沿 `REALTABLE_ID` 定位实际表，未注册对象再按数据库表、视图、物化视图顺序查找。本次仅更新 Skill 文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

Release 1.5.46: 明确 `PUSH_LOG.HEAD_DATA` 由 BOS 后台 API 合并，Oracle 数据库侧可能看不到该动作；排查时不得因 `H_INTERFACE_DATA_TASK` 未读取该字段就判断请求头缺失，也不得据此修改全局封装任务。本次仅更新 Skill 文档，不修改 Agent、transit-server、接口、配置或审计 action；命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。

Release 1.5.45: 以只读生产样本核验并完善 BOS 通用接口知识，覆盖核心四表、`AD_PROCESS` 三段任务、F/D/J 调度、请求封装、后台推送、两级回执处理、入站路由和客户差异核验边界。本次仅更新 Skill 文档，不修改 Agent、transit-server、接口、配置或审计 action；命令数保持 32。

## Git 提交说明

- 提交信息和发布记录使用简洁、准确的中文。
- 按可独立验证的小功能节点分别提交，不混入无关修改。
- Bug 修复通常只说明修复的功能点和结果，不展开代码缺陷细节；排障或防复发所必需的信息除外。
- 每次将 Skill 推送到私有 Git 后，必须同步更新公共镜像，不再另行等待确认。公共镜像只导入当前私有 `main` 的无历史快照；同步前检查敏感文件、管理员令牌回退和测试结果，不得推送私有提交历史。

Release 1.5.44: 将公共镜像同步纳入每次 Skill Git 发布的必做步骤，同时保留无历史快照和敏感信息检查要求。

Release 1.5.43: 统一 Git 提交与发布记录规范，明确使用简洁中文、按小功能节点提交，并精简 Bug 修复说明。提交 `176bd4594779a8489ad25ab828380b2b7ab3354b` 已于 2026-08-27 10:18 +08:00 推送到私有 Gitea，并同步安装目录；`capabilities --json` 验证版本为 `1.5.43`。

Release 1.5.42: added `log_info`, `log_tail`, `log_search`, `log_enable`, and `log_disable`; uses authenticated dedicated transit endpoints and preserves structured log errors. Commit `e90cbc9ce3525970b2f07885d52c4f0172bf9d2f` was pushed to private Gitea at 2026-08-27 09:51 +08:00, pulled into the installed Skill, and verified by `capabilities --json` as 1.5.42. Log content is not stored in Skill config, output archives, or release history.

A published `VERSION` is frozen. Increment it for every later change, update `CHANGELOG.md`, commit and push to Gitea. Skill updates use Git only: pull the commit into the Codex Skill directory with `git pull --ff-only origin main`, then run `capabilities --json`. Do not publish or update this Skill through OSS.

`inspection_report` and `inspection_latest --refresh` must run `sys_function_check` before Agent collection. Missing SYS/current-schema functions stop generation and return the complete SQL bundle. Historical report reads do not run this preflight.

Record version, commit, push time and verification result for every release.

Release 1.5.32: added authenticated `awr_status`, `awr_list`, and byte-for-byte `awr_download` commands. AWR remains disabled until the customer DBA confirms Diagnostics Pack authorization and Agent configuration explicitly enables it. The release commit, push time, and installed-skill verification are recorded in the project release log.

Release 1.5.33: when AWR readiness reports missing function or view permission, resolve the target Agent schema and return the archived DBA SQL with the real account substituted. Never execute the SQL and never emit an unresolved `<AGENT_SCHEMA>` placeholder.

Release 1.5.34: update archived `HENLO_AWR_EXPORT` to v1.1 so null rows do not reach `DBMS_LOB.WRITEAPPEND`, preserve report row boundaries with newlines, and keep deployment strictly manual through the DBA SQL output.

Release 1.5.35: change the Skill default transit endpoint to `https://ts.henlo.net`, update configuration and documentation examples, preserve existing login/session fields while migrating only `transit_url`, validate, commit and push to Gitea, then pull and verify the installed Skill.

Release 1.5.36: remove the hard-coded Agent-update administrator token fallback. `agent_update` must require `ORACLE_JUMP_UPGRADE_ADMIN_TOKEN` or `upgrade_admin_token` and fail locally without issuing a request when neither is configured. This rule is mandatory before publishing the manually approved, no-history public mirror snapshot.

Release 1.5.37: update the Skill and README maintenance instructions to document both the private repository and the public no-history mirror, so a fresh public download points to the correct Git addresses.