Repository navigation
hmharness is an open-source agent framework for HarmonyOS/OpenHarmony development workflows, providing the hmh CLI, interactive TUI, web frontend, lifecycle tooling, sandboxed execution, audit trails, MCP client support, and guarded self-evolution.
Verified checkpoint
- npm package: @hmharness/cli@0.23.26
- Public source: commit
31affe478ff0f7b413ecd6bd638a01ce2b599c00(exact npmgitHead) - CI: unit suite green on this commit in run 37405562530
- Website: https://swsgbl.github.io/hmharness/
Known pipeline issue, disclosed: the publish workflow's ordered-set preflight currently aborts (run 37406948306); the npm publish itself completed out-of-band and the package is live on the registry. GitHub Pages last rebuilt on 2026-09-28 (e69283e) and is pending a fix of the same pipeline. Main has advanced 13 commits past this checkpoint (P1 program completion, docs-led); those changes are NOT in the npm 0.23.26 artifact.
Highlights since v0.18.12
The 0.19 → 0.23 series covers the 12-week engineering program and the agent-quality loop. Full per-version detail: CHANGELOG.md and docs/DEVLOG.md.
- Multi-session parallel runtime (W15): true per-session subprocess, queue, approval, and interrupt; port recovery only evicts same-family keepers.
- Board-level installer: KaihongOS board package installer with automatic board update channel; no-shim update chain; in-TUI update briefing.
- Browser surface: extension conversation panel; verified installs across Chrome/Edge/Brave/Opera/Quark/Firefox/BrowserOS; BrowserOS AI-browser pack plus an ACP server so the panel can drive
hmhdirectly. - LSP foundation: DevEco local clangd discovery end-to-end, LSP source trust with sha256 pinning.
- Publish chain three defenses: private-package detection, dependency-coverage preflight, board-level fallback pins riding the release.
- Agent-quality loop: benchmark assertion modes (
expect-exact/-regex/-none/-any) plus the cost gatecand > max(1.3 × base, base + 8); cognitive ablation 3-arm ladder; scored memory retrieval (confidence*0.4 + recency*0.2 + lexical*0.4); budgeted cognitive exploration with a real refuted-hypothesis report. - Research infrastructure pool: COG-MEA long-task loop, versioned evaluation task sets (dataset fingerprint + seed + holdout), sandbox red-team hardening, WM-2 observational causal mining, Code World Model three-sensor family.
- P0/P1 program stones: registry, metrics, broker, transfer-os, evidence-ledger all landed on main (post-checkpoint, docs-led commits).
Install
npm install -g @hmharness/cliNode.js >= 22. hmharness is MIT-licensed and is not affiliated with Huawei or OpenAtom.