# oracle-jump-query Skill Release Standard

## 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.