@kudusov.takhir/ba-toolkit 1.2.4 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -11,6 +11,54 @@ Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
11
11
 
12
12
  ---
13
13
 
14
+ ## [1.3.0] — 2026-04-08
15
+
16
+ ### Changed
17
+
18
+ - **`ba-toolkit init` is now a one-command setup.** It prompts for project name, slug (auto-derived from the name), domain, and AI agent, then creates `output/{slug}/`, writes `AGENTS.md`, and installs the skills into the chosen agent's directory — in a single interactive flow. Previously this required two commands: `ba-toolkit init` followed by `ba-toolkit install --for <agent>`. The old two-step flow is still available via `ba-toolkit init --no-install` + `ba-toolkit install --for <agent>`.
19
+ - **Domain and agent selection now use numbered menus** instead of free-text input. Domains are listed 1–10 with name and short description; agents are listed 1–5 with their registered id. Users can type either the menu number (`1`, `2`, …) or the id (`saas`, `claude-code`, …).
20
+ - **`DOMAINS` reordered** so general-purpose industries (SaaS, Fintech, E-commerce, Healthcare) appear first; iGaming moved to position 9. The toolkit is no longer iGaming-first in its defaults.
21
+ - **Setup placeholders no longer use "Dragon Fortune"** (the iGaming example project). The CLI, `init.sh`, `init.ps1`, `docs/USAGE.md` AGENTS.md example, and `skills/references/environment.md` file listings now use neutral placeholders (`My App` / `my-app` / `saas`). The actual example project in `example/dragon-fortune/` and the skill templates that reference it are unchanged — they remain a real iGaming walkthrough.
22
+
23
+ ### Added
24
+
25
+ - `ba-toolkit init --for <agent>` flag — skip the agent menu (e.g. `--for claude-code`). Accepts the same set as `ba-toolkit install --for`.
26
+ - `ba-toolkit init --no-install` flag — create the project structure only; don't install skills. Restores the pre-1.3.0 behavior for CI pipelines that run `init` and `install` as separate steps.
27
+ - `ba-toolkit init --global` / `--project` / `--dry-run` flags — forwarded to the embedded install step.
28
+ - `init.sh` and `init.ps1` shell fallbacks now use the same numbered domain menu and auto-derived slug UX as the CLI, with pointers to `npx @kudusov.takhir/ba-toolkit install --for <agent>` for the skill install step (they remain zero-dependency scripts and don't install skills themselves).
29
+
30
+ ### Migration note
31
+
32
+ CI scripts that relied on the old behaviour (`init` creates files only, `install` is a separate step) need one of:
33
+
34
+ - Pass all the new flags to get fully non-interactive behaviour:
35
+ ```bash
36
+ npx @kudusov.takhir/ba-toolkit init --name "My App" --domain saas --for claude-code
37
+ ```
38
+ - Or add `--no-install` to keep the two-step flow:
39
+ ```bash
40
+ npx @kudusov.takhir/ba-toolkit init --name "My App" --domain saas --no-install
41
+ npx @kudusov.takhir/ba-toolkit install --for claude-code
42
+ ```
43
+
44
+ ---
45
+
46
+ ## [1.2.5] — 2026-04-08
47
+
48
+ ### Changed
49
+
50
+ - **README refactor (3-step):** cut README from 843 to 288 lines (−66%) without losing any factual content.
51
+ - PR 1 — extracted Usage Guide, Troubleshooting, FAQ, Contributing, and "Adding a new domain" into `docs/USAGE.md`, `docs/TROUBLESHOOTING.md`, `docs/FAQ.md`, `CONTRIBUTING.md`, and `docs/DOMAINS.md`. README now links to each instead of duplicating the content.
52
+ - PR 2 — reordered sections to follow the reader funnel (what → install → see result → details → advanced). Collapsed manual install variants (Claude Code, Codex, Gemini, Cursor/Windsurf, init scripts, manual updates) under a single `<details>` block. Removed the `## Contents` TOC (GitHub auto-generates one), the ASCII Pipeline diagram (duplicated the table below it), the ASCII "How each skill works" block, the ~80-line `## Repository Structure` tree, and the `## Quick Start` section (duplicated `docs/USAGE.md` section 1). Moved `What the output looks like` up to sit right after Install. Moved the time-estimates table to `docs/USAGE.md` as an appendix.
53
+ - PR 3 — style pass: one-line hero, emoji removed from every H2 heading and from Pipeline/Platform/Domain table contents, "Who is this for?" bullets removed, the "Why not just prompt ChatGPT / Claude directly?" comparison table replaced with a single paragraph in the intro, callout blockquotes inlined, all headings switched to sentence case.
54
+ - `docs/*` follow-up style pass: sentence-case H1s in `docs/USAGE.md` and `docs/DOMAINS.md`. Fixed a stale anchor in `docs/FAQ.md` (pointed to `../README.md#-installation` from before the emoji-stripped H2 rename; now points to `#install`).
55
+
56
+ ### Removed
57
+
58
+ - `README.ru.md` and every remaining Russian-language reference across the repo (`README.md` language switcher, `package.json` files whitelist, the 1.2.0 CHANGELOG note about the Russian translation, and the planning item in `todo.md`). The toolkit is now single-language (English); localisation can be re-added later as a separate effort if needed.
59
+
60
+ ---
61
+
14
62
  ## [1.2.4] — 2026-04-08
15
63
 
16
64
  ### Fixed
@@ -53,7 +101,7 @@ Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
53
101
  ### Changed
54
102
 
55
103
  - npm package renamed from `ba-toolkit` to scoped `@kudusov.takhir/ba-toolkit` to avoid name collisions in the public registry. The CLI binary name (`ba-toolkit`) is unchanged. Install commands are now `npx @kudusov.takhir/ba-toolkit <command>` or `npm install -g @kudusov.takhir/ba-toolkit`.
56
- - `README.md` and `README.ru.md` updated to use the scoped package name in all `npx` and `npm install -g` examples.
104
+ - `README.md` updated to use the scoped package name in all `npx` and `npm install -g` examples.
57
105
 
58
106
  ---
59
107
 
@@ -64,7 +112,6 @@ Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
64
112
  - `/sprint` skill — sprint planning from estimated User Stories: groups stories into sprints by velocity and capacity, applies risk-weighted prioritisation, outputs sprint goals and Definition of Done per sprint (`00_sprint_{slug}.md`).
65
113
  - `skills/references/templates/sprint-template.md` — full example sprint plan for the Dragon Fortune project.
66
114
  - `example/dragon-fortune/` — complete example project with all 15 pipeline artifacts for an iGaming Telegram Mini App. Fully cross-referenced: FR → US → UC → AC → NFR → Entity → ADR → API → WF → Scenario + Risk Register + Sprint Plan.
67
- - `README.ru.md` — full Russian translation of `README.md`. Language switcher added to both versions (🇺🇸 English / 🇷🇺 Русский). EN remains the source of truth per sync rule.
68
115
  - **npm package** — BA Toolkit is now publishable to npm as `ba-toolkit`. Two commands supported:
69
116
  - `npx ba-toolkit init` — interactive project initialiser (creates `output/{slug}/` and `AGENTS.md`).
70
117
  - `npx ba-toolkit install --for <agent>` — copies skills to the correct path for Claude Code, Codex CLI, Gemini CLI, Cursor, or Windsurf. Supports `--global`, `--project`, and `--dry-run` flags.
@@ -165,7 +212,9 @@ Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
165
212
 
166
213
  ---
167
214
 
168
- [Unreleased]: https://github.com/TakhirKudusov/ba-toolkit/compare/v1.2.4...HEAD
215
+ [Unreleased]: https://github.com/TakhirKudusov/ba-toolkit/compare/v1.3.0...HEAD
216
+ [1.3.0]: https://github.com/TakhirKudusov/ba-toolkit/compare/v1.2.5...v1.3.0
217
+ [1.2.5]: https://github.com/TakhirKudusov/ba-toolkit/compare/v1.2.4...v1.2.5
169
218
  [1.2.4]: https://github.com/TakhirKudusov/ba-toolkit/compare/v1.2.3...v1.2.4
170
219
  [1.2.3]: https://github.com/TakhirKudusov/ba-toolkit/compare/v1.2.2...v1.2.3
171
220
  [1.2.2]: https://github.com/TakhirKudusov/ba-toolkit/compare/v1.2.1...v1.2.2