refactor: rename project from mcp-slack-blockkit to mcp-slack-block-kit

Renames "Block Kit" everywhere to match Slack's own product name (two
words):

- GitHub repo: hishamkaram/mcp-slack-blockkit -> hishamkaram/mcp-slack-block-kit
- Go module path: github.com/hishamkaram/mcp-slack-block-kit
- Binary: mcp-slack-block-kit (cmd/mcp-slack-block-kit/)
- Public Go package: package block_kit (block_kit/)
- MCP tool names: convert_markdown_to_block_kit, validate_block_kit,
  preview_block_kit, lint_block_kit (split_blocks unchanged)
- Cosign release-signature identity regex updated to new repo URL
- Homebrew formula name (next release will publish mcp-slack-block-kit)

Adds a path-scoped revive exclusion in .golangci.yml so the underscore
in package block_kit doesn't trip var-naming.

GitHub auto-redirects the old repo URL for ~12 months. External MCP
client configs with "command": "mcp-slack-blockkit" need to update.

CHANGELOG [Unreleased] / Changed documents the breaking surface.

Author: hishamkaram

.claude/rules/security.md

@@ -3,7 +3,7 @@ description: Security-critical mention sanitization rule for the converter and M
 paths:
   - "internal/converter/**"
   - "internal/server/**"
-  - "blockkit/**"
+  - "block_kit/**"
 ---
 
 # Mention sanitization is mandatory

.claude/settings.json

@@ -9,7 +9,7 @@
       "Bash(govulncheck:*)",
       "Bash(goreleaser:*)",
       "Bash(lefthook:*)",
-      "Bash(./bin/mcp-slack-blockkit:*)"
+      "Bash(./bin/mcp-slack-block-kit:*)"
     ]
   }
 }

.claude/skills/release/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: release
-description: Cut a new release of mcp-slack-blockkit. Bump the version, move CHANGELOG `[Unreleased]` to a new version section, create a signed tag, push it, and confirm GoReleaser publishes successfully. Use when the maintainer asks for a release, a tag, or a version bump.
+description: Cut a new release of mcp-slack-block-kit. Bump the version, move CHANGELOG `[Unreleased]` to a new version section, create a signed tag, push it, and confirm GoReleaser publishes successfully. Use when the maintainer asks for a release, a tag, or a version bump.
 allowed-tools: Read, Edit, Bash, Grep
 ---
 
@@ -85,8 +85,8 @@ the release.
 
 ## 6. Post-release
 
-- Verify `brew upgrade mcp-slack-blockkit` (or first-time install) works.
-- Verify `go install github.com/hishamkaram/mcp-slack-blockkit/cmd/mcp-slack-blockkit@vX.Y.Z` works.
+- Verify `brew upgrade mcp-slack-block-kit` (or first-time install) works.
+- Verify `go install github.com/hishamkaram/mcp-slack-block-kit/cmd/mcp-slack-block-kit@vX.Y.Z` works.
 - Update the MCP Registry / Smithery / Glama listings with the new tag.
 
 ## Don't

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -17,7 +17,7 @@ body:
     id: version
     attributes:
       label: Version
-      description: Output of `mcp-slack-blockkit --version`.
+      description: Output of `mcp-slack-block-kit --version`.
       placeholder: "v0.1.0 (commit abc1234, built 2026-05-09)"
     validations:
       required: true
@@ -47,7 +47,7 @@ body:
         - Continue.dev
         - Zed
         - Cline
-        - CLI (`mcp-slack-blockkit convert`)
+        - CLI (`mcp-slack-block-kit convert`)
         - Other / library import
     validations:
       required: true
@@ -74,7 +74,7 @@ body:
       label: Reproduction steps
       description: Minimal steps to reproduce. Include the exact markdown input if possible.
       placeholder: |
-        1. Run `echo '...' | mcp-slack-blockkit convert --mode rich_text`
+        1. Run `echo '...' | mcp-slack-block-kit convert --mode rich_text`
         2. Observe ...
     validations:
       required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,8 @@
 blank_issues_enabled: false
 contact_links:
   - name: Security vulnerability
-    url: https://github.com/hishamkaram/mcp-slack-blockkit/security/advisories/new
+    url: https://github.com/hishamkaram/mcp-slack-block-kit/security/advisories/new
     about: Report security issues privately via GitHub's Private Vulnerability Reporting — please do not open public issues for security concerns.
   - name: Question or discussion
-    url: https://github.com/hishamkaram/mcp-slack-blockkit/discussions
+    url: https://github.com/hishamkaram/mcp-slack-block-kit/discussions
     about: Ask a question, share an idea, or discuss design.

.github/workflows/ci.yml

@@ -32,17 +32,17 @@ jobs:
         run: go tool cover -func=cover.out
 
       - name: Coverage gate (≥80% on listed packages)
-        # Per research.md §8 mandate: blockkit + the four conversion-engine
+        # Per research.md §8 mandate: block_kit + the four conversion-engine
         # packages must hit at least 80% statement coverage. Other packages
         # are advisory.
         run: |
           set -euo pipefail
           for pkg in \
-            github.com/hishamkaram/mcp-slack-blockkit/blockkit \
-            github.com/hishamkaram/mcp-slack-blockkit/internal/converter \
-            github.com/hishamkaram/mcp-slack-blockkit/internal/validator \
-            github.com/hishamkaram/mcp-slack-blockkit/internal/splitter \
-            github.com/hishamkaram/mcp-slack-blockkit/internal/preview \
+            github.com/hishamkaram/mcp-slack-block-kit/blockkit \
+            github.com/hishamkaram/mcp-slack-block-kit/internal/converter \
+            github.com/hishamkaram/mcp-slack-block-kit/internal/validator \
+            github.com/hishamkaram/mcp-slack-block-kit/internal/splitter \
+            github.com/hishamkaram/mcp-slack-block-kit/internal/preview \
           ; do
             line=$(go tool cover -func=cover.out | awk -v p="$pkg/" '$1 ~ p && $1 ~ /total:|\.go/' | grep -E "^${pkg}/[a-z_]+\.go" | awk '{ sum += $NF; n++ } END { if (n) printf "%.1f", sum/n; else print "0" }') || line=0
             # Fallback: use the per-file coverage average. This is approximate;

.golangci.yml

@@ -35,6 +35,12 @@ linters:
       # repeated string literals, etc. are conventional in Go test code.
       - path: _test\.go
         linters: [errcheck, gosec, gocritic]
+      # The public Go package is named `block_kit` to mirror Slack's "Block Kit"
+      # product name; the underscore trips revive's var-naming rule. Scoped
+      # exclusion so other underscore violations elsewhere are still caught.
+      - path: ^block_kit/
+        linters: [revive]
+        text: "should not use underscores in Go names"
 
 formatters:
   enable:

.goreleaser.yaml

@@ -1,4 +1,4 @@
-# GoReleaser config for mcp-slack-blockkit.
+# GoReleaser config for mcp-slack-block-kit.
 # https://goreleaser.com/customization/
 #
 # Locally:   goreleaser build --snapshot --clean
@@ -10,16 +10,16 @@
 #                              <user>/homebrew-tap repo; required for tap push.
 version: 2
 
-project_name: mcp-slack-blockkit
+project_name: mcp-slack-block-kit
 
 before:
   hooks:
     - go mod tidy
 
 builds:
-  - id: mcp-slack-blockkit
-    main: ./cmd/mcp-slack-blockkit
-    binary: mcp-slack-blockkit
+  - id: mcp-slack-block-kit
+    main: ./cmd/mcp-slack-block-kit
+    binary: mcp-slack-block-kit
     env:
       - CGO_ENABLED=0
     goos:
@@ -30,7 +30,7 @@ builds:
       - amd64
       - arm64
     # ldflags inject build-time metadata into main.{version,commit,date}.
-    # See cmd/mcp-slack-blockkit/main.go for the matching package vars.
+    # See cmd/mcp-slack-block-kit/main.go for the matching package vars.
     ldflags:
       - -s -w
       - -X main.version={{.Version}}
@@ -77,18 +77,18 @@ changelog:
 # Homebrew tap formula publishing. Requires a public repo named
 # `homebrew-tap` under the same owner; see docs.brew.sh/Taps.
 brews:
-  - name: mcp-slack-blockkit
+  - name: mcp-slack-block-kit
     repository:
       owner: hishamkaram
       name: homebrew-tap
       token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
-    homepage: https://github.com/hishamkaram/mcp-slack-blockkit
+    homepage: https://github.com/hishamkaram/mcp-slack-block-kit
     description: "MCP server that converts markdown into Slack Block Kit JSON"
     license: MIT
     test: |
-      system "#{bin}/mcp-slack-blockkit", "--version"
+      system "#{bin}/mcp-slack-block-kit", "--version"
     install: |
-      bin.install "mcp-slack-blockkit"
+      bin.install "mcp-slack-block-kit"
 
 # CycloneDX SBOM generated via syft (bundled with goreleaser).
 sboms:
@@ -112,33 +112,33 @@ signs:
 release:
   github:
     owner: hishamkaram
-    name: mcp-slack-blockkit
+    name: mcp-slack-block-kit
   draft: false
   prerelease: auto
   mode: replace
   header: |
-    ## mcp-slack-blockkit {{ .Version }}
+    ## mcp-slack-block-kit {{ .Version }}
 
     Single-binary MCP server that converts AI-generated markdown into Slack
-    Block Kit JSON. Five tools: `convert_markdown_to_blockkit`,
-    `validate_blockkit`, `preview_blockkit`, `lint_blockkit`, `split_blocks`.
+    Block Kit JSON. Five tools: `convert_markdown_to_block_kit`,
+    `validate_block_kit`, `preview_block_kit`, `lint_block_kit`, `split_blocks`.
 
     ### Install
 
     ```sh
-    brew install hishamkaram/tap/mcp-slack-blockkit
+    brew install hishamkaram/tap/mcp-slack-block-kit
     # or
-    go install github.com/hishamkaram/mcp-slack-blockkit/cmd/mcp-slack-blockkit@{{ .Tag }}
+    go install github.com/hishamkaram/mcp-slack-block-kit/cmd/mcp-slack-block-kit@{{ .Tag }}
     ```
 
     ### Verify (cosign)
 
     ```sh
     cosign verify-blob \
-      --certificate-identity-regexp 'https://github\.com/hishamkaram/mcp-slack-blockkit/.+' \
+      --certificate-identity-regexp 'https://github\.com/hishamkaram/mcp-slack-block-kit/.+' \
       --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
       --certificate checksums.txt.pem --signature checksums.txt.sig \
       checksums.txt
     ```
   footer: |
-    **Full changelog**: https://github.com/hishamkaram/mcp-slack-blockkit/compare/{{ .PreviousTag }}...{{ .Tag }}
+    **Full changelog**: https://github.com/hishamkaram/mcp-slack-block-kit/compare/{{ .PreviousTag }}...{{ .Tag }}

CHANGELOG.md

@@ -7,12 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+### Changed (BREAKING — pre-1.0; no installed binaries in the wild)
+- Project renamed from `mcp-slack-blockkit` to `mcp-slack-block-kit` to match
+  Slack's own product naming ("Block Kit" is two words). Affects the GitHub
+  repo URL, Go module path (`github.com/hishamkaram/mcp-slack-block-kit`),
+  binary name (`mcp-slack-block-kit`), public Go package
+  (`block_kit`, in `block_kit/`), four MCP tool names
+  (`convert_markdown_to_block_kit`, `validate_block_kit`,
+  `preview_block_kit`, `lint_block_kit`; `split_blocks` unchanged), and the
+  cosign release-signature identity regex. GitHub auto-redirects the old
+  repo URL for ~12 months. External MCP client configs with
+  `"command": "mcp-slack-blockkit"` need to update to the new binary name.
+
 ### Added
 - `Renderer.ConvertWithWarnings(input) ([]slack.Block, []string, error)` —
   the full converter API, returning fallback warnings alongside blocks.
   `Renderer.Convert(input)` is now a thin wrapper that drops warnings,
   preserving the v0.1 signature.
-- `MCP convert_markdown_to_blockkit` tool: response `warnings` field now
+- `MCP convert_markdown_to_block_kit` tool: response `warnings` field now
   surfaces converter-side fallback notes (auto-mode routing decisions etc.),
   not just chunker/preview notes.
 - New nested-pattern detection in the auto-mode picker
@@ -52,17 +64,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 ### Added
 - Initial release.
 - Five MCP tools registered on top of `modelcontextprotocol/go-sdk` v1.6.0:
-  - `convert_markdown_to_blockkit` — markdown → Slack Block Kit, with
+  - `convert_markdown_to_block_kit` — markdown → Slack Block Kit, with
     auto-mode picker between the new `markdown` block (Feb 2025) and
     deterministic decomposition.
-  - `validate_blockkit` — full Slack constraint validation with
+  - `validate_block_kit` — full Slack constraint validation with
     structured violations.
-  - `preview_blockkit` — Block Kit Builder URL generation for one-click
+  - `preview_block_kit` — Block Kit Builder URL generation for one-click
     visual QA.
-  - `lint_blockkit` — near-limit and deprecated-pattern warnings.
+  - `lint_block_kit` — near-limit and deprecated-pattern warnings.
   - `split_blocks` — enforce 50-block-per-message + `only_one_table_allowed`.
 - `convert` CLI subcommand for offline testing.
-- `blockkit/` public Go library re-exports for embedded use.
+- `block_kit/` public Go library re-exports for embedded use.
 - Mention-sanitization layer that entity-escapes broadcast strings
   (`<!channel>`, `<@U…>`, etc.) by default — opt-in passthrough via
   `AllowBroadcasts`.
@@ -75,5 +87,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 - Mention sanitization is the documented security-critical path.
   See [SECURITY.md](SECURITY.md) and `.claude/rules/security.md`.
 
-[Unreleased]: https://github.com/hishamkaram/mcp-slack-blockkit/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/hishamkaram/mcp-slack-blockkit/releases/tag/v0.1.0
+[Unreleased]: https://github.com/hishamkaram/mcp-slack-block-kit/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/hishamkaram/mcp-slack-block-kit/releases/tag/v0.1.0

CLAUDE.md

@@ -1,4 +1,4 @@
-# mcp-slack-blockkit — Claude Code project notes
+# mcp-slack-block-kit — Claude Code project notes
 
 Single-binary MCP server + CLI that converts AI-generated markdown into
 Slack Block Kit JSON. Go 1.25+. Zero external runtime dependencies.
@@ -9,7 +9,7 @@ Slack Block Kit JSON. Go 1.25+. Zero external runtime dependencies.
 
 | Action | Command |
 |---|---|
-| Build local binary | `make build` (output: `bin/mcp-slack-blockkit`) |
+| Build local binary | `make build` (output: `bin/mcp-slack-block-kit`) |
 | Run all tests | `make test` |
 | Race tests + coverage | `make test-race` |
 | HTML coverage report | `make cover` |
@@ -61,13 +61,13 @@ CI mirrors all of the above. Coverage gate: **≥80% overall, enforced in
 ## Repository layout
 
 ```
-cmd/mcp-slack-blockkit/   cobra entry point (server default + convert subcommand)
+cmd/mcp-slack-block-kit/   cobra entry point (server default + convert subcommand)
 internal/converter/       goldmark renderer + emoji/mentions/markdown_block
 internal/validator/       slack constraint suite + structured Violations
 internal/splitter/        SplitText + ChunkBlocks (50-block + table-isolation)
 internal/preview/         Block Kit Builder URL encoder
 internal/server/          MCP wiring (5 tools on top of go-sdk v1.6.0)
-blockkit/                 Public Go library re-exports (semver-stable surface)
+block_kit/                 Public Go library re-exports (semver-stable surface)
 docs/                     Public docs (CLAUDE-architecture.md, etc.)
 docs/internal/            Gitignored design notes (research.md lives here)
 ```