# Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project follows Semantic Versioning once public releases begin.

## [Unreleased]

## [0.1.4] - 2026-08-23

Patch release aligning commit-message scope control with `smart-commit-cli` 0.1.22.

### Added

- `commitMessage.scope` with `auto`, `required`, and `forbidden` so Conventional / Semantic subjects can require or strip `(scope)`
- generation prompt overlay, hybrid draft prefix rules, and final validation that fails immediately on `required` and strips on `forbidden`

### Changed

- README and configuration guide now document `commitMessage.scope`
- `peerReference.cliVersion` is `0.1.22`
- publish guidance now points to the `0.1.4` release draft during pre-publish review

## [0.1.3] - 2026-08-15

Patch release aligning commit-message, review skill, and PR/MR creation with `smart-commit-cli` 0.1.21.

### Added

- `commitMessage.structure`, `skill`, `hybridGenerate`, and `maxDiffChars`, plus bundled `git-commit-message-skills` (`conventional`, `semantic`, `gitmoji`)
- `commitMessage.validation.protocol` values `semantic` and `gitmoji`
- `review.skill` (`id` / `path` / `promptTuning`) and bundled `code-review-skills` (generic plus C/C++/C#/frontend/Go/Java/mobile/PHP/Python/Rust)
- diff domain classifier for review prompts; PR/MR review inline line anchoring and `detailLocator` alignment
- `pullRequestReview.skillPromptTuning` and `pullRequestReview.configFilePath` overlay loading
- `pullRequestCreation.configFilePath`, `titlePrompt`, `descriptionPrompt`, `reviewers`, `milestone`, `draft`

### Changed

- `commitMessage.validation.protocol` is `none | conventional | semantic | gitmoji` (default `none`)
- config files and overlays use root key `smartCommitHostAgent`
- `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 PR/MR creation error after commit/push succeed; `pull-request create` fails. Neither command guesses a default branch

## [0.1.2] - 2026-08-13

Patch release for PR/MR content parity, optional empty `pullRequest.authToken` on local-only paths, and first-use documentation.

### Fixed

- `bridge` now generates PR/MR title and description via a Host-Agent `pr-content` turn (same path as `pull-request create`), instead of reusing the git commit message as the description
- PR/MR title now reuses the single commit subject when the branch range has exactly one commit (parity with `smart-commit-cli`); multiple commits still use the Host-Agent generated title. Explicit `--title` / `--description` are not overwritten.

### Changed

- `bridge` pull-request creation payload includes `description` when an MR/PR is created
- branch diff for PR content falls back to `origin/<targetBranch>` when the local target ref is missing
- `pullRequest.authToken` `env:` references no longer fail config load when the variable is missing or empty; they resolve to `""`. Platform commands still require a non-empty token (`pull-request create` / `review`, `my-pull-request list` / `batch-review`). Local-only paths (`config resolve`, `bridge --review-only`, `commit-message generate`) proceed without it. Full `bridge` still skips PR/MR creation when the token is empty.
- README now leads with product features (review, commit message, Git, PR/MR, reports), matching `smart-commit-cli`
- "Where To Go Deeper" now points to getting started, configuration, integrations, and contracts instead of publish / release / parity docs
- publish guide and release checklist now name the four shipped user docs as README jsDelivr deep-link targets

### Added

- `docs/getting-started.md`, `docs/configuration.md`, `docs/integrations.md`, and `docs/contracts.md` for first-use and skill integration

## [0.1.1] - 2026-08-12

Patch release focused on npm package metadata and published-doc links. No CLI behavior changes.

### Changed

- README deep links to shipped docs now use jsDelivr (`cdn.jsdelivr.net/npm/...`) instead of unpkg, so browsers receive `charset=utf-8` for Markdown
- expanded `package.json` `keywords` for npm discoverability (PR/MR, review, GitHub/GitLab, host-agent flows)
- publish guide and release checklist updated to match the jsDelivr link convention

## [0.1.0] - 2026-08-12

First public release of `smart-commit-host-agent`: a shell-first CLI for AI-assisted commit review, commit-message generation, Git automation, and PR/MR flows. Model text comes from Host-Agent turns (Cursor, Codex, …) — this package never calls LLM HTTP APIs and does not use `connection` config.

### Added

- standalone `smart-commit-host-agent` package with TypeScript build/test setup
- Host-Agent turn session store (`session.json` + `turns/NNNN.request.json` / `NNNN.response.json`)
- `needs_host_agent` status and exit code `10` for skill resume loops
- `config resolve` without LLM `connection` validation (rejects `--api-key` / `--base-url` / `--model` / `--llm-provider`)
- preferred config root `smartCommitHostAgent`, with optional `smartCommitCli` migration that strips `connection`
- `host-agent probe` for turn-protocol diagnostics
- `help` / `version` commands
- `bridge --review-only` local code review via host-agent turns (no commit/push)
- full `bridge`: commit-message + review turns, commit/push, and GitHub/GitLab PR/MR create
- `commit-message generate` via host-agent turns (or `--commit-message` to skip)
- `pull-request create` (local branch diff + pr-content turn + platform create)
- `pull-request review` (platform fetch; summary/inline comments; approve/merge; optional `--fixture-pr`)
- `my-pull-request list` (account/workspace scopes; requires `authToken`)
- `my-pull-request batch-review` (list + serial review with write actions; turn/`needs_host_agent` resume)
- `report generate` (local Markdown render; optional AI segment via host-agent turns)
- `schema print` for selected targets without LLM `connection` fields
- release docs under `docs/` and example config at `examples/config.host-agent.json`

### Changed

- README documents the Host-Agent command surface, turn protocol, exit codes, and skill loop (product-first; related CLI notes at the end)
- publish guidance targets the `0.1.0` release; private Git remote is not exposed via `package.json` repository metadata

### Known limitations

- no chunked / hybrid review and no correction repair turns
- AI always goes through host-agent turns (never external LLM HTTP)

### Tested

- unit and command coverage for CLI dispatch, config, session store, Host-Agent client, bridge, commit-message, PR/MR create/review/list/batch-review, report generate, schema print, and platform write actions (mocked `fetch`)