hmos-precheck 0.1.2

LLM-first low-noise Build@1 guard for HarmonyOS and ArkTS repos.

hmos-precheck

Agent-first diff checks for HarmonyOS / ArkTS repositories.

This Python package is the primary published implementation of hmos-precheck. It is designed for LLM or CI gate usage where stdout must stay compact and self-explanatory.

Install

pip install hmos-precheck

Agent Protocol

Run:

hmos-precheck run --project-root <repo> --output-dir <out>

Interpret stdout JSON only:

• {"ok":true}: stop.
• {"ok":false,"read_file":"..."}: read only read_file, fix only its issues, then re-run once.
• If the second run still fails, stop and report the latest read_file.

warn findings do not block pass and are hidden from compact stdout.

Config Resolution

Resolution order:

1. --commandline-tools
2. DEVECO_SDK_HOME
3. project config
4. user config
5. auto-detect

Commands

• hmos-precheck run
• hmos-precheck doctor
• hmos-precheck init

Validation

python3 -m pytest -q