# `smart-commit-host-agent` 0.1.0 Release Notes

## Summary

`smart-commit-host-agent` 0.1.0 is the first public release.

It is a shell-first CLI for AI-assisted commit review, commit-message generation, Git workflow automation, and PR/MR flows. When the CLI needs model text, it pauses with a turn request on disk; a Host Agent (Cursor, Codex, …) writes the response and the CLI resumes the same session. This package never calls LLM HTTP APIs and does not use `connection` / `SMART_COMMIT_API_KEY`.

## Highlights

- npm package: `smart-commit-host-agent` / binary: `smart-commit-host-agent`
- canonical config root: `smartCommitHostAgent`
- `config resolve` without LLM connection fields
- Host-Agent turn sessions (`needs_host_agent` / exit `10`)
- `host-agent probe` for the request → response → resume loop
- `bridge --review-only` and full `bridge` (commit-message → review → commit/push → platform create)
- `commit-message generate`, `pull-request create` / `review`, `my-pull-request list` / `batch-review`
- `report generate` (local render; optional AI via turns) and `schema print`
- `pull-request review` publish path: summary/inline comments, approve, merge (honors dry-run)

## Why This Release Matters

Host Agents already have model access. Putting LLM API keys into skill config is unnecessary and error-prone.

With 0.1.0, agents can:

1. validate config without LLM connection fields
2. run review / commit / PR-MR / report flows through a stable CLI contract
3. pause on `needs_host_agent`, write turn responses, and resume with `--session`

## Available Commands

| Command | Status |
| --- | --- |
| `config resolve` | Available |
| `help` / `version` | Available |
| `host-agent probe` | Available (internal turn diagnostic) |
| `bridge --review-only` | Available |
| `bridge` (full) | Available |
| `commit-message generate` | Available |
| `pull-request create` | Available |
| `pull-request review` | Available (fetch + comment/approve/merge) |
| `my-pull-request list` | Available |
| `my-pull-request batch-review` | Available |
| `report generate` | Available |
| `schema print` | Available |

## Stability Notes

- no LLM HTTP transport; rejected LLM flags fail fast
- exit `10` means pause for Host-Agent turn response, then resume with `--session`
- file-backed config requires explicit `--config <path>` (no silent default discovery)
- additive command surface growth is preferred during `0.1.x`

## Suggested First-Use Path

1. install `smart-commit-host-agent@0.1.0`
2. create a config without `connection` (see `examples/config.host-agent.json`)
3. run `smart-commit-host-agent config resolve --config ./examples/config.host-agent.json`
4. run `smart-commit-host-agent host-agent probe --session-base /tmp/scha --output json`
5. write the turn response file, then resume with `--session`
6. try `bridge --review-only` or `pull-request review` with a Host Agent skill loop

## Verification

Before publish:

1. run `npm test`
2. run `npm run pack:dry-run`
3. review [`CHANGELOG.md`](../../CHANGELOG.md)
4. review this note against the intended release scope
5. confirm `node out/cli.js --version` prints `0.1.0`

## Known Follow-Up Areas

- no chunked / hybrid review; no correction repair turns
- optional smoke-test script for common skill loops
- keep `package.json` free of private Git remote URLs (npm consumers use the published package / jsDelivr docs)