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

## Summary

`smart-commit-host-agent` 0.1.3 aligns commit-message, review skill, and PR/MR creation with `smart-commit-cli` 0.1.21. Config files use the `smartCommitHostAgent` root key.

## Highlights

- `commitMessage` supports `structure`, `skill`, `hybridGenerate`, and `maxDiffChars`; bundled skills cover `conventional`, `semantic`, and `gitmoji`
- `commitMessage.validation.protocol` is `none | conventional | semantic | gitmoji` (default `none`)
- `review.skill` (`id` / `path` / `promptTuning`) plus bundled `code-review-skills` and a diff domain classifier
- PR/MR review annotates new-file line numbers and aligns inline findings with `detailLocator`; staged `bridge` / `--review-only` inject skill + classifier but do not annotate lines
- `pullRequestReview.skillPromptTuning` overrides `review.skill.promptTuning` for PR/MR review only
- `pullRequestCreation` overlay (`configFilePath`) plus `titlePrompt`, `descriptionPrompt`, `reviewers`, `milestone`, and `draft`; `pullRequestReview.configFilePath` uses the same overlay loader
- `bridge` / `pull-request create` send reviewers, milestone, and draft to GitHub/GitLab
- non-empty `titlePrompt` skips single-commit subject reuse for the PR title
- empty `pullRequestCreation.targetBranch` records a creation error after commit/push; `pull-request create` fails
- config files and overlays use root key `smartCommitHostAgent`

## Why This Release Matters

The same JSON config can drive commit messages, review skills, and PR/MR creation, aligned with `smart-commit-cli` 0.1.21.

Commit-message generation follows Conventional / Semantic / Gitmoji guidance, can refine a draft via `hybridGenerate`, and validates against the chosen protocol. Review turns load bundled (or custom-path) skill files and classify the diff domain. PR/MR create can attach reviewers, milestone, and draft, and can overlay local creation/review files.

## Available Commands

See [`docs/releases/0.1.0-draft.md`](./0.1.0-draft.md) for the command list. In 0.1.3:

- `commit-message generate` / `bridge` honor `structure`, `skill`, `hybridGenerate`, and `validation.protocol`
- `bridge --review-only` / `bridge` / `pull-request review` / `my-pull-request batch-review` inject review skill + classifier; PR/MR paths also annotate line numbers
- `bridge` / `pull-request create` honor creation overlay fields and send reviewers / milestone / draft

## Stability Notes

- no LLM HTTP transport; exit `10` means pause for Host-Agent turn response
- no chunked / hybrid review and no correction / PR content repair turns
- `autoCreateAfterPush` and `removeSourceBranch` default to `true`
- additive command surface growth remains preferred during `0.1.x`

## Suggested Upgrade Path

1. install or bump to `smart-commit-host-agent@0.1.3`
2. use root key `smartCommitHostAgent`
3. set `commitMessage.validation.protocol` when the team enforces a commit style (default is `none`)
4. set `review.skill` for bundled domain guidance or a custom skill file
5. set `pullRequestCreation.targetBranch` to the integration branch
6. optionally add `titlePrompt` / `descriptionPrompt` / `reviewers` / `milestone` / `draft`, or point `configFilePath` at a local overlay
7. skill loops: `needs_host_agent` → write response → `--session` resume. `hybridGenerate` uses a single `purpose: "commit-message"` turn

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

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