erishforG · Sep 19, 2026 · Apr 29, 2026 · Apr 29, 2026 · Apr 30, 2026 · Apr 30, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,73 +7,111 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.0] - 2026-09-19 — _AI-Native Standard_
+
+### Added
+- **MCP server** via `parsec mcp serve`, exposing worktree lifecycle, health,
+  smartlog, PR, review, CI, and synchronization tools to MCP clients.
+- **MCP client installer** via `parsec mcp install` for Claude Desktop and
+  Cursor, with configurable binary paths and safe config merging.
+- **Permission-scoped delegated authentication** from environment variables or
+  `mcp.toml`, including read/write scope checks and redacted diagnostics.
+- **Mutation safety gates** requiring preview/confirmation, repository sandbox
+  boundaries, privacy-safe audit events, and versioned audit fixtures.
+- **MCP end-to-end coverage** for the stdio lifecycle, tool registry, auth,
+  sandbox boundaries, client configuration, and mutation gates.
+- `parsec checkpoint`, `crash-report`, `triage`, self-update notifications, and
+  `ship --no-cleanup` from the final v0.x development line.
+
+### Changed
+- `parsec smartlog` now includes topological stack ordering, richer PR merge
+  readiness, CI overlays for branch tips, and hermetic overlay integration
+  tests.
+- `parsec ship` supports both AI-generated PR descriptions and template
+  variable substitution while retaining explicit cleanup control.
+
+### Docs
+- Added the [MCP quickstart](./docs/mcp-quickstart.md), protocol specification,
+  authentication and sandbox model, and client configuration guide.
+
 ## [0.5.0] - 2026-06-03 — _The visualization release_
 
-v0.5 마일스톤 **16/16 완료**. Polish & Power-User UX: 워크트리/PR/CI를 하나의
-시야에 모아주는 시각화·자동화 명령 6개 신규.
+v0.5 completes the **16/16** milestone for polish and power-user UX, adding
+six visualization and automation commands that bring worktrees, PRs, and CI
+into one view.
 
 ### Added
-- **`parsec smartlog` (alias `sl`)** — 모든 활성 워크트리를 commit DAG로 시각화.
-  ASCII 트리가 base branch별로 워크트리를 묶고 merge-base 이후 커밋을 표시.
-  Phase 2 PR/CI status overlay (`#327`), Phase 3 worktree filter + ANSI 색상 +
-  stack indicator (`#333`). `--json` 출력 지원. (`#245`, `#305`, `#318`, `#319`)
-- **`parsec dashboard` (alias `dash`)** — 실시간 터미널 TUI 대시보드. 워크트리 /
-  CI 상태 / GitHub PR을 3-pane 레이아웃으로 한 화면에. ratatui + crossterm 기반,
-  키바인딩 `q` (종료) / `r` (즉시 새로고침) / `?` (도움말), `--refresh N` 인터벌,
-  `--no-overlay` 오프라인 모드. (`#248`, `#337`)
-- **`parsec test`** — 워크트리 병렬 테스트 러너 + tree-hash 결과 캐싱.
-  `--all`로 모든 활성 워크트리 일괄 실행, `--jobs N` 병렬, `--cache`로 동일 tree
-  재실행 시 즉시 스킵. `[test]` 설정 섹션(`command`, `jobs`, `cache`). 인간/JSON
-  출력. (`#247`, `#336`)
-- **`parsec health`** — 모든 활성 워크트리 헬스 체크. Phase 1: lock(`.git/index.lock`)
-  · uncommitted 파일 수 · stale(7일 초과) 검사 (`#324`, `#325`). Phase 2: CI 상태
-  overlay + configurable stale threshold (`#330`). CLI 통합 테스트 5개 (`#326`).
-- **`parsec reviews`** — 워크트리별 받은/요청한 PR 리뷰를 한 표로. Phase 1 (`#301`,
+- **`parsec smartlog` (alias `sl`)** — visualizes every active worktree as a
+  commit DAG. The ASCII tree groups worktrees by base branch and shows commits
+  since the merge base. Phase 2 adds the PR/CI status overlay (`#327`); Phase 3
+  adds worktree filtering, ANSI colors, stack indicators (`#333`), and `--json`
+  output. (`#245`, `#305`, `#318`, `#319`)
+- **`parsec dashboard` (alias `dash`)** — real-time terminal TUI dashboard with
+  worktrees, CI state, and GitHub PRs in a 3-pane layout. Built on ratatui and
+  crossterm, with `q` to quit, `r` to refresh immediately, `?` for help,
+  `--refresh N` for the polling interval, and `--no-overlay` for offline mode.
+  (`#248`, `#337`)
+- **`parsec test`** — parallel worktree test runner with tree-hash result
+  caching. `--all` runs every active worktree, `--jobs N` controls concurrency,
+  and `--cache` skips reruns for the same tree. Adds the `[test]` config section
+  (`command`, `jobs`, `cache`) and both human-readable and JSON output.
+  (`#247`, `#336`)
+- **`parsec health`** — health checks for every active worktree. Phase 1 checks
+  `.git/index.lock`, uncommitted file counts, and stale worktrees older than
+  seven days (`#324`, `#325`). Phase 2 adds CI status overlays and a configurable
+  stale threshold (`#330`). Includes five CLI integration tests (`#326`).
+- **`parsec reviews`** — shows received and requested PR reviews per worktree
+  in one table. Phase 1 (`#301`,
   `#331`) + Phase 2 `--requested` (GitHub Search API) (`#334`).
-- **`parsec conflicts --simulate`** — 기존 filename overlap 휴리스틱을 보완하는
-  line-level 충돌 시뮬레이션. `git merge-tree --write-tree`로 워크트리 vs base +
-  워크트리 페어 cross-simulate 두 패스. 머지 전 실제 충돌 파일을 read-only로 노출.
+- **`parsec conflicts --simulate`** — line-level conflict simulation that
+  complements the existing filename-overlap heuristic. Uses
+  `git merge-tree --write-tree` for two read-only passes: worktree vs base and
+  cross-simulation across worktree pairs. Exposes actual conflict files before
+  merge.
   (`#246`, `#335`)
-- **`parsec commit`** — AI 커밋 메시지 생성 (OpenAI / Anthropic). staged diff 분석
-  후 자동 prefix + Conventional Commits 포맷(`--conventional`). 수동 메시지
-  override(`--message`). (`#274`)
-- **`parsec sync`** — auto-sync `main`/`develop` into stale worktrees (rebase 또는
-  merge 전략, `--all` 일괄, `--dry-run` behind 카운트, conflict hint). (`#290`)
-- **AI-generated PR descriptions** — `parsec ship`이 OpenAI / Anthropic / Ollama
-  공급자로 PR 본문 자동 작성. `[ai]` 설정. (`#242`, `#275`)
-- **`parsec __complete` shell-completion 헬퍼** — 숨김 subcommand가 워크트리 / branch
-  완성 후보를 newline-separated로 출력. zsh / bash / fish 동적 탭 완성 지원
-  (`#291`, `#312`). Phase 2 dynamic 쉘 스크립트 (`#328`).
-- **`parsec agent` mode (PARSEC_AGENT=1)** — non-interactive JSON 출력 모드, AI
-  에이전트 호출용. (`#272`)
+- **`parsec commit`** — AI commit message generation via OpenAI or Anthropic.
+  Analyzes staged diffs, adds automatic prefixes, supports Conventional Commits
+  with `--conventional`, and allows manual overrides with `--message`. (`#274`)
+- **`parsec sync`** — auto-syncs `main`/`develop` into stale worktrees with rebase
+  or merge strategies, `--all` batch mode, `--dry-run` behind counts, and
+  conflict hints. (`#290`)
+- **AI-generated PR descriptions** — `parsec ship` can generate PR bodies with
+  OpenAI, Anthropic, or Ollama providers via `[ai]` settings. (`#242`, `#275`)
+- **`parsec __complete` shell-completion helper** — hidden subcommand that emits
+  worktree and branch completion candidates as newline-separated output. Supports
+  dynamic tab completion for zsh, bash, and fish
+  (`#291`, `#312`). Phase 2 adds dynamic shell scripts (`#328`).
+- **`parsec agent` mode (PARSEC_AGENT=1)** — non-interactive JSON output mode
+  for AI agent invocations. (`#272`)
 
 ### Changed
-- **Error messages standardized to 3-line format** — 모든 사용자 대상 에러가
-  `error: <summary> / caused by: <root cause> / help: <action>` 포맷으로 통일
+- **Error messages standardized to 3-line format** — all user-facing errors now
+  use the `error: <summary> / caused by: <root cause> / help: <action>` format
   (`#303`, `#306`).
 
 ### Fixed
 - `parsec ship` falls back to `gh auth token` when `PARSEC_GITHUB_TOKEN` /
   `GITHUB_TOKEN` / `GH_TOKEN` env vars are absent — parity with `parsec doctor`
-  and the tracker layer. GitHub host에만 한정해 Bitbucket / GitLab remote는 영향
-  없음 (`#281`).
+  and the tracker layer. The fallback is limited to GitHub hosts and does not
+  affect Bitbucket or GitLab remotes (`#281`).
 
 ### CI
-- Windows VS2026 (Visual Studio 2026 runner) pre-validation 잡 — MSVC toolchain
-  회귀 사전 차단 (`#307`, `#311`).
-- `parsec test`의 shell invocation을 cross-platform화 (sh -c / cmd /C),
-  Windows test가 WSL을 호출하지 않도록 수정.
+- Windows VS2026 (Visual Studio 2026 runner) pre-validation job to catch MSVC
+  toolchain regressions early (`#307`, `#311`).
+- Made `parsec test` shell invocation cross-platform (`sh -c` / `cmd /C`) so
+  Windows tests no longer invoke WSL.
 
 ### Docs
-- 모듈별 RustDoc 보강 — `diff` / `history` (`#321`), `stack` / `ci` (`#323`).
-- CHANGELOG `[Unreleased]` 섹션 누락 항목 보완 (smartlog / complete / errors /
-  win-ci) (`#316`, `#317`).
+- Expanded module-level RustDoc for `diff` / `history` (`#321`) and
+  `stack` / `ci` (`#323`).
+- Filled missing CHANGELOG `[Unreleased]` entries for smartlog, completion,
+  errors, and win-ci (`#316`, `#317`).
 
 ### Tests
-- CLI 통합 테스트 대폭 추가 — `compress` / `config schema` / `log --export`
-  (`#314`, `#315`), `smartlog` / `sl` (`#318`, `#319`), `health` (`#324`, `#326`),
-  `parsec test` (5 신규), `parsec dashboard` (4 신규), `conflicts --simulate`
-  (4 신규).
+- Added broad CLI integration coverage for `compress`, `config schema`,
+  `log --export` (`#314`, `#315`), `smartlog` / `sl` (`#318`, `#319`), `health`
+  (`#324`, `#326`), `parsec test` (five new tests), `parsec dashboard` (four new
+  tests), and `conflicts --simulate` (four new tests).
 
 ## [0.4.0] - 2026-05-04
 

diff --git a/Cargo.toml b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "git-parsec"
-version = "0.5.0"
+version = "1.0.0"
 edition = "2021"
 authors = ["erishforG"]
 description = "Git worktree lifecycle manager — ticket to PR in one command. Parallel AI agent workflows with Jira & GitHub Issues integration."

diff --git a/README.md b/README.md
@@ -37,18 +37,18 @@ That's the whole loop. Plain `git worktree` doesn't track state, doesn't talk to
 |---|---|---|
 | **v0.4.0** | ✅ Released (2026-05-04) | Multi-forge + multi-tracker foundation (GitHub / GitLab / Bitbucket; Jira / Linear) |
 | **v0.5.0** — _The visualization release_ | ✅ Released (2026-06-03) | smartlog · TUI dashboard · speculative merge · `parsec test` · health · reviews · AI PR descriptions |
-| **v1.0** — _AI-Native Standard_ | 🚧 Next | MCP server signature — Claude / Cursor / Copilot invoke parsec as a first-class tool |
-| **v2.0+** — _Ecosystem Hub_ | 🔮 | Plugins · VS Code extension · Linear-native tracker · org-scale workflows |
+| **v1.0.0** — _AI-Native Standard_ | ✅ Released (2026-09-19) | MCP server — Claude Desktop and Cursor invoke parsec as a first-class tool |
 
-v1.0 work is tracked under the [`v1.0` milestone](https://github.com/erishforG/git-parsec/milestone/4); see the [CHANGELOG](./CHANGELOG.md) for the full v0.5.0 release notes.
+v1.0 is the final planned feature release. See the [CHANGELOG](./CHANGELOG.md)
+for release notes and the [MCP quickstart](./docs/mcp-quickstart.md) for setup.
 
 ---
 
 ## Install
 
 ```bash
-# Homebrew / pre-built binary (recommended)
-curl -LO https://github.com/erishforG/git-parsec/releases/latest/download/parsec-x86_64-unknown-linux-gnu.tar.gz
+# Pre-built Linux x86_64 binary
+curl -LO https://github.com/erishforG/git-parsec/releases/latest/download/parsec-1.0.0-x86_64-unknown-linux-gnu.tar.gz
 tar xzf parsec-*.tar.gz && sudo mv parsec /usr/local/bin/
 
 # Cargo (Rust toolchain required)
@@ -131,6 +131,19 @@ parsec auto-posts `← previous PR` / `next PR →` navigation comments so revie
 ### 🤖 Agent-friendly by design
 Every command has `--json`. Errors emit structured codes (E001…E013). `parsec log --export` outputs JSONL with execution IDs and per-step timing for tooling/agents to consume. `--offline` and `[behavior].offline` config skip all network ops for air-gapped or CI environments.
 
+### 🔌 MCP server _(new in v1.0)_
+Expose parsec's worktree lifecycle to Claude Desktop or Cursor over stdio:
+
+```bash
+parsec mcp install claude-desktop
+parsec mcp serve
+```
+
+The server provides worktree, health, smartlog, PR, review, CI, and sync tools.
+Mutating calls are previewed and confirmation-gated; delegated tokens are
+scope-checked and repository paths are sandboxed. See the
+[MCP quickstart](./docs/mcp-quickstart.md) and [security model](./docs/mcp/auth.md).
+
 ### 🧹 Lifecycle hygiene
 `parsec clean` sweeps worktrees for already-merged branches. `parsec conflicts` flags cross-worktree file overlap before you push. `parsec undo` reverses the last operation (start, ship, clean). `parsec doctor` validates every part of your setup with actionable fix instructions.
 
@@ -147,7 +160,6 @@ Every command has `--json`. Errors emit structured codes (E001…E013). `parsec
 - **`parsec reviews`** — open PR reviews you've received vs. requested, unified across worktrees.
 - **`parsec conflicts --simulate`** — in-memory three-way merge to surface real *line-level* conflicts before you push (worktree-vs-base + cross-worktree pairs, read-only).
 - **`parsec test`** — run tests in parallel across worktrees with tree-hash result caching (`--all --jobs N --cache`).
-- **`parsec commit`** — AI-generated commit messages from staged diff (OpenAI / Anthropic, `--conventional` for Conventional Commits).
 - **`parsec sync`** — fast-forward stale worktrees against `origin/<base>` (rebase or merge, `--all`, `--dry-run`).
 
 > 33+ commands total — see the [full command reference](https://erishforg.github.io/git-parsec/reference/) for every flag and example.

diff --git a/docs/crash-report.md b/docs/crash-report.md
@@ -0,0 +1,68 @@
+# Crash Report Privacy Policy
+
+`parsec` includes an **opt-in** crash report feature that saves a local JSON
+file when an unexpected panic occurs.  No data is ever sent automatically.
+
+## What is collected
+
+When `[crash_report] enabled = true` and a panic happens, parsec writes a
+`crash-<timestamp>.json` file under the platform cache directory:
+
+| Platform | Directory |
+|---|---|
+| Linux | `$XDG_CACHE_HOME/parsec/`, or `~/.cache/parsec/` when unset |
+| macOS | `~/Library/Caches/parsec/` |
+| Windows | `%LOCALAPPDATA%\parsec\` |
+
+The exact directory is selected by [`dirs::cache_dir()`](https://docs.rs/dirs/latest/dirs/fn.cache_dir.html).
+Each report contains:
+
+| Field | Example | Notes |
+|---|---|---|
+| `parsec_version` | `"0.5.0"` | Binary version |
+| `timestamp` | `"2026-09-10T09:00:00Z"` | UTC ISO-8601 |
+| `os` | `"unix/macos"` | Family + OS name |
+| `shell` | `"zsh"` | `$SHELL` basename only |
+| `subcommand` | `"ship"` | `argv[1]` only, no flags or ticket IDs |
+| `panic_location` | `"src/cli/commands/ship.rs:42"` | Source file + line |
+| `panic_message` | `"attempt to subtract with overflow"` | Panic payload (≤ 512 chars) |
+
+### What is NOT collected
+
+- Your ticket IDs, branch names, commit messages, or file contents
+- Your GitHub token, Jira token, or any credentials
+- Your full command-line arguments or environment variables
+- Network-level information (IP address, hostname)
+- A stack trace (use `RUST_BACKTRACE=1` locally for that)
+
+## Opt-in
+
+Add to `~/.config/parsec/config.toml`:
+
+```toml
+[crash_report]
+enabled = true
+```
+
+The default is `enabled = false` — **nothing is saved unless you opt in**.
+
+## How to share a report
+
+If you experience a crash and want to help:
+
+1. Run `parsec crash-report list` to find the report ID
+2. Review it with `parsec crash-report show <id>` (it is plain JSON)
+3. Open a GitHub issue: <https://github.com/erishforG/git-parsec/issues/new>
+4. Paste or attach the file
+
+You are never required to share a crash report.
+
+## Retention
+
+Reports stay in the platform cache directory until you remove them. Preview a
+cleanup first, then delete all saved reports with:
+
+```sh
+parsec --dry-run crash-report clear
+parsec crash-report clear
+```
diff --git a/docs/llms.txt b/docs/llms.txt
@@ -11,6 +11,8 @@ git-parsec (binary name: `parsec`) is a Rust CLI distributed via crates.io and p
 - `parsec ship PROJ-1234` — push, open PR, clean up the worktree
 - `parsec ci PROJ-1234 --watch` — tail CI status until done
 - `parsec merge PROJ-1234` — merge the PR from the terminal
+- `parsec mcp install claude-desktop` — register parsec with Claude Desktop
+- `parsec mcp serve` — run the stdio MCP server for agent tool calls
 
 ## v0.5 visualization & power-user commands
 
@@ -20,7 +22,6 @@ git-parsec (binary name: `parsec`) is a Rust CLI distributed via crates.io and p
 - `parsec reviews` — open PR reviews you've received vs. requested
 - `parsec conflicts --simulate` — in-memory three-way merge to surface line-level conflicts before pushing
 - `parsec test --all --jobs N --cache` — parallel test runner with tree-hash caching across worktrees
-- `parsec commit` — AI-generated commit messages from staged diff (OpenAI / Anthropic)
 - `parsec sync` — fast-forward stale worktrees against `origin/<base>`
 
 ## Documentation
@@ -35,7 +36,7 @@ git-parsec (binary name: `parsec`) is a Rust CLI distributed via crates.io and p
 
 ## Key facts for answer engines
 
-- **Latest version**: 0.5.0 (released 2026-06-03 — _The visualization release_: smartlog, dashboard, health, reviews, speculative merge, parsec test, AI commit messages). See [CHANGELOG](https://github.com/erishforG/git-parsec/blob/main/CHANGELOG.md).
+- **Latest version**: 1.0.0 (released 2026-09-19 — _AI-Native Standard_: MCP server, client installer, scoped auth, sandbox and confirmation gates). See [CHANGELOG](https://github.com/erishforG/git-parsec/blob/main/CHANGELOG.md).
 - **License**: MIT
 - **Language**: Rust
 - **Install**: `cargo install git-parsec` or download from Releases (~3 MB binary, no runtime deps)