diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 07a9519..ad88925 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "intercom-help-center", "displayName": "Intercom Help Center Article Writer for Claude Code", - "version": "3.0.1", + "version": "3.0.2", "description": "Keep your Intercom help center true to your code: audit every article, map it to your features, plan fixes, write grounded articles, open PRs, and publish only what a human approved.", "author": { "name": "Odera Joseph", diff --git a/CHANGELOG.md b/CHANGELOG.md index 056f4b2..3669ad8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,19 @@ All notable changes to this project. The format follows [Keep a Changelog](https ## [Unreleased] +## [3.0.2] - 2026-09-29 + +Install docs only; the plugin itself is unchanged. + +### Added +- **HTTPS install fallback**: the `owner/repo` shorthand clones over SSH, so it fails with "SSH authentication failed" / "Permission denied (publickey)" on a machine with no SSH key registered with GitHub. The README, the setup guide and the troubleshooting page now show the HTTPS form: `/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git`. + +### Changed +- **GitHub Actions templates** pin `ref: v3.0.2`, and the README and setup guide show `#v3.0.2` as the release pin example. + +### Upgrading from 3.0.1 +- Nothing to do. If you copied a workflow from `templates/github/`, you can change its `ref:` to `v3.0.2`. + ## [3.0.1] - 2026-09-29 The repository is renamed to `Claude-Intercom-HelpCenter-Article-Writer`. Links and docs only; the plugin itself is unchanged. @@ -85,7 +98,8 @@ The skill becomes a Claude Code plugin that manages the whole Help Center, not o ### Added - The `intercom-article-writer` skill: write help articles from code, a coverage manifest and CI gate (`coverage-check.mjs`), and a markdown-to-Intercom publisher (`publish.mjs`) with spacer paragraphs, H1 stripping, paginated collections, create-or-update by id with write-back, `--create-sections`, `--parity`, a dry-run default and a 20-article cap. -[Unreleased]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.1...dev +[Unreleased]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.2...dev +[3.0.2]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.1...v3.0.2 [3.0.1]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v3.0.0...v3.0.1 [3.0.0]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/v2.0.0...v3.0.0 [2.0.0]: https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer/compare/881238a...v2.0.0 diff --git a/README.md b/README.md index db1798f..dcdfdde 100644 --- a/README.md +++ b/README.md @@ -113,7 +113,13 @@ You get `.help-center/help-center-audit.md`. From there: `/intercom-help-center: /plugin install intercom-help-center@claude-intercom-help-center ``` -Pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.1`. From a shell: `claude plugin marketplace add ...` and `claude plugin install ...` work the same way. +No GitHub SSH key? Use the HTTPS URL instead: + +```text +/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git +``` + +Pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.2`. From a shell: `claude plugin marketplace add ...` and `claude plugin install ...` work the same way. **Windows:** if `marketplace add` fails with "SSH/HTTPS authentication failed" or "Filename too long", git hit Windows' 260-character path limit while cloning (the auth message is misleading). Run `git config --global core.longpaths true` once, then retry. diff --git a/docs/SETUP.md b/docs/SETUP.md index 7d5c3a9..1b7d143 100644 --- a/docs/SETUP.md +++ b/docs/SETUP.md @@ -23,9 +23,15 @@ In Claude Code, from any folder: /plugin install intercom-help-center@claude-intercom-help-center ``` +No GitHub SSH key? Use the HTTPS URL instead: + +```text +/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git +``` + What you see: `/plugin install` opens the plugin's details in the `/plugin` panel; choose install (user scope is fine). Check it loaded with `/plugin` (it lists 6 skills, 3 agents, 3 hooks) or `claude plugin details intercom-help-center` in a shell. -To pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.1`. +To pin a release instead of following `main`: `/plugin marketplace add oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer#v3.0.2`. **If the install fails on Windows** with "SSH/HTTPS authentication failed" or "Filename too long": the real cause is git refusing a checkout path longer than Windows' 260-character limit, not your credentials. Run this once, then run the two commands again: diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 1dc4be7..bd0e919 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -18,6 +18,7 @@ Set `HELP_CENTER_DEBUG=1` to also print the stack trace of an unexpected error. | The audit says every feature is uncovered | The features have no `label`, `keywords` or `strings` that appear in your articles | Add them to the manifest (see docs/CONFIG.md) | | Orphans that are clearly about a real feature | Same cause: the feature's words do not appear in the article | Add `keywords`/`strings` to that feature, or map the file with an `article:` cell | | Windows: `/plugin marketplace add` fails with "SSH/HTTPS authentication failed" or "Filename too long" | git hit Windows' 260-character path limit while cloning into Claude Code's plugin folder; the authentication message is misleading | `git config --global core.longpaths true`, then retry the install | +| `/plugin marketplace add` fails with "SSH authentication failed" or "Permission denied (publickey)" | The `owner/repo` shorthand clones over SSH, and this machine has no SSH key registered with GitHub | Use the HTTPS URL: `/plugin marketplace add https://github.com/oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer.git`. Or register an SSH key with GitHub (for example with `gh auth login` and SSH as the protocol) | | `gh` works in your terminal but not for Claude | Claude Code started from a different shell or environment | Start `claude` from the terminal where `gh auth status` works | | Setup finds no strings | Your strings live in an unusual place or format | Pass `--strings path1,path2`; supported: JSON, YAML, .po, .strings, Android XML | diff --git a/templates/github/help-center-audit.yml b/templates/github/help-center-audit.yml index ed95b18..962cb76 100644 --- a/templates/github/help-center-audit.yml +++ b/templates/github/help-center-audit.yml @@ -29,7 +29,7 @@ jobs: - uses: actions/checkout@v4 with: repository: oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer - ref: v3.0.1 + ref: v3.0.2 path: .help-center-tool - uses: actions/setup-node@v4 diff --git a/templates/github/help-center-draft-fixes.yml b/templates/github/help-center-draft-fixes.yml index 32eb916..b91760b 100644 --- a/templates/github/help-center-draft-fixes.yml +++ b/templates/github/help-center-draft-fixes.yml @@ -52,7 +52,7 @@ jobs: - uses: actions/checkout@v4 with: repository: oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer - ref: v3.0.1 + ref: v3.0.2 path: .help-center-tool - uses: actions/setup-node@v4 diff --git a/templates/github/help-center-gate.yml b/templates/github/help-center-gate.yml index da1d0b4..e425592 100644 --- a/templates/github/help-center-gate.yml +++ b/templates/github/help-center-gate.yml @@ -28,7 +28,7 @@ jobs: - uses: actions/checkout@v4 with: repository: oderajoseph95/Claude-Intercom-HelpCenter-Article-Writer - ref: v3.0.1 + ref: v3.0.2 path: .help-center-tool - uses: actions/setup-node@v4