@kudusov.takhir/ba-toolkit 3.8.1 → 3.10.0

package/CHANGELOG.md

@@ -11,6 +11,29 @@ Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [3.10.0] — 2026-04-10
+
+### Added
+
+- **Documentation website powered by Astro Starlight** at [`https://takhirkudusov.github.io/ba-toolkit/`](https://takhirkudusov.github.io/ba-toolkit/). Responsive, dark mode, client-side search — all out of the box. Content is sync'd from the repo root (`README.md`, `COMMANDS.md`, `CHANGELOG.md`, `ROADMAP.md`, `docs/*.md`) at build time via `website/scripts/sync-content.mjs` — the repo root stays the single source of truth and the website is a zero-drift derived view. One hand-written page (`getting-started.md`) provides a 5-step quickstart optimised for the website landing experience. The build deploys automatically via `.github/workflows/website.yml` (GitHub Actions → GitHub Pages) on every push to `main` that touches any of the synced content files. Social links in the header point to GitHub, npm, and LinkedIn. Search index built by Pagefind (10 pages indexed). Sitemap auto-generated.
+- **`.npmignore` created.** Excludes `website/`, `.github/`, `.claude/`, `.idea/`, `test/`, `example/`, and several meta-files from the published npm tarball so that Astro and its transitive dependencies never bloat the downstream package. Verified with `npm pack --dry-run`.
+- **`.github/workflows/website.yml`** — GitHub Actions workflow that: installs website deps (`npm ci`), runs the content sync script, builds with Astro, and deploys to GitHub Pages via `actions/deploy-pages@v4`. Triggers on push to `main` that touches `README.md`, `COMMANDS.md`, `CHANGELOG.md`, `ROADMAP.md`, `docs/**`, `website/**`, or the workflow file itself. Single concurrency group; newer pushes cancel in-flight builds. Manual dispatch supported for ad-hoc re-deploys.
+
+### Note for deployers
+
+The first push that includes this workflow will **not** auto-deploy unless GitHub Pages is enabled in the repo's Settings → Pages → Build and deployment → Source → **GitHub Actions**. This is a one-time manual step — after it is set, all future deployments happen automatically.
+
+---
+
+## [3.9.0] — 2026-04-10
+
+### Added
+
+- **`ROADMAP.md` — single source of truth for the next-shipping list, known limitations, and explicitly-rejected ideas with rationale.** New top-level document at the repo root, linked from the README. Sections: Mission (polished from `CLAUDE.md` §1), Now (currently empty after the v3.8.1 release), Next (the upcoming items grouped by Documentation and reach / Quality and maintenance / New skills), Known limitations (eight explicit scope boundaries — does not generate code, does not validate code, does not handle secrets, does not collect telemetry, does not support agents without native skills, does not enforce a testing methodology, does not auto-translate, does not maintain a project after handoff), Removed from the backlog (full inline rationale for the four ideas considered and rejected: MCP server, slash command rename, use-case-compliance validator, dedicated TDD-test-generation skill), Recently shipped (table of the last eight releases), Versioning policy (a paraphrase of the SemVer rules from `CLAUDE.md` §6), and Contributing to the roadmap (concrete pathways for proposing new items, contesting "Removed" decisions, contributing domain references). The roadmap is intentionally **commitment-only** — no Wishlist section, no Later-aspirational, no speculation. Items move from Next into Now as they enter active work and into Recently shipped once they ship. Replaces scattered backlog mentions in `todo.md` for the public-facing audience.
+- **README gains a new "Roadmap" section** linking to `ROADMAP.md`. Slotted between FAQ and Contributing so a first-time reader can find the project's plans without leaving the README.
+
+---
+
 ## [3.8.1] — 2026-04-10
 
 ### Fixed
@@ -706,7 +729,9 @@ CI scripts that relied on the old behaviour (`init` creates files only, `install
 
 ---
 
-[Unreleased]: https://github.com/TakhirKudusov/ba-toolkit/compare/v3.8.1...HEAD
+[Unreleased]: https://github.com/TakhirKudusov/ba-toolkit/compare/v3.10.0...HEAD
+[3.10.0]: https://github.com/TakhirKudusov/ba-toolkit/compare/v3.9.0...v3.10.0
+[3.9.0]: https://github.com/TakhirKudusov/ba-toolkit/compare/v3.8.1...v3.9.0
 [3.8.1]: https://github.com/TakhirKudusov/ba-toolkit/compare/v3.8.0...v3.8.1
 [3.8.0]: https://github.com/TakhirKudusov/ba-toolkit/compare/v3.7.0...v3.8.0
 [3.7.0]: https://github.com/TakhirKudusov/ba-toolkit/compare/v3.6.0...v3.7.0

package/README.md

@@ -312,6 +312,12 @@ Answers to common questions — language support, offline use, custom domains, e
 
 ---
 
+## Roadmap
+
+What is currently in flight, what is planned next, what is explicitly out of scope, and the rationale for ideas that were considered and rejected — all in [ROADMAP.md](ROADMAP.md). The roadmap is the single source of truth for the next-shipping list and the project's known limitations.
+
+---
+
 ## Contributing
 
 New domains and skill improvements are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for the PR workflow, and [docs/DOMAINS.md](docs/DOMAINS.md) for the domain file template.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudusov.takhir/ba-toolkit",
-  "version": "3.8.1",
+  "version": "3.10.0",
   "description": "AI-powered Business Analyst pipeline — 24 skills from concept discovery to a sequenced implementation plan an AI coding agent can execute, with one-command Notion + Confluence publish. Works with Claude Code, Codex CLI, Gemini CLI, Cursor, and Windsurf.",
   "keywords": [
     "business-analyst",