Metadata-Version: 2.2
Name: hmos-precheck
Version: 0.1.2
Summary: LLM-first low-noise Build@1 guard for HarmonyOS and ArkTS repos.
License: MIT
Keywords: harmonyos,arkts,precheck,cli,llm
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE

# 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

```bash
pip install hmos-precheck
```

## Agent Protocol

Run:

```bash
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

```bash
python3 -m pytest -q
```
