@softspark/ai-toolkit 3.0.1 → 3.1.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.
Files changed (53) hide show
  1. package/AGENTS.md +13 -0
  2. package/CHANGELOG.md +46 -0
  3. package/README.md +34 -20
  4. package/app/.claude-plugin/plugin.json +1 -1
  5. package/app/skills/cpp-rules/SKILL.md +275 -0
  6. package/app/skills/csharp-rules/SKILL.md +282 -0
  7. package/app/skills/dart-rules/SKILL.md +299 -0
  8. package/app/skills/golang-rules/SKILL.md +262 -0
  9. package/app/skills/hook-creator/SKILL.md +7 -3
  10. package/app/skills/introspect/SKILL.md +1 -1
  11. package/app/skills/java-rules/SKILL.md +273 -0
  12. package/app/skills/kotlin-rules/SKILL.md +271 -0
  13. package/app/skills/medplum-rules/SKILL.md +271 -0
  14. package/app/skills/php-rules/SKILL.md +292 -0
  15. package/app/skills/python-rules/SKILL.md +257 -0
  16. package/app/skills/ruby-rules/SKILL.md +286 -0
  17. package/app/skills/rust-rules/SKILL.md +276 -0
  18. package/app/skills/swift-rules/SKILL.md +293 -0
  19. package/app/skills/typescript-rules/SKILL.md +249 -0
  20. package/benchmarks/ecosystem-doctor-snapshot.json +14 -14
  21. package/bin/ai-toolkit.js +5 -1
  22. package/kb/history/completed/deep-coverage-v3-20260423.md +3 -3
  23. package/kb/history/completed/ecosystem-deep-sweep-20260423.md +1 -1
  24. package/kb/procedures/release-preparation-sop.md +4 -4
  25. package/kb/procedures/release-verification-sop.md +11 -12
  26. package/kb/reference/architecture-overview.md +1 -1
  27. package/kb/reference/cli-reference.md +14 -3
  28. package/kb/reference/competitive-features-implementation.md +9 -9
  29. package/kb/reference/global-install-model.md +29 -6
  30. package/kb/reference/hooks-catalog.md +8 -2
  31. package/kb/reference/language-rules.md +54 -18
  32. package/kb/reference/mcp-editor-compatibility.md +4 -3
  33. package/kb/reference/mcp-templates.md +3 -2
  34. package/kb/reference/supported-tools-registry.md +10 -8
  35. package/kb/reference/windows-support.md +50 -0
  36. package/llms-full.txt +220 -72
  37. package/llms.txt +1 -0
  38. package/manifest.json +3 -3
  39. package/package.json +14 -3
  40. package/scripts/_common.py +21 -0
  41. package/scripts/check_deps.py +14 -0
  42. package/scripts/codex_skill_adapter.py +19 -3
  43. package/scripts/ecosystem_tools.json +7 -7
  44. package/scripts/generate_cline_rules.py +17 -8
  45. package/scripts/generate_codex_skills.py +33 -96
  46. package/scripts/generate_language_rules_skills.py +232 -0
  47. package/scripts/generate_roo_rules.py +11 -3
  48. package/scripts/install.py +6 -1
  49. package/scripts/install_steps/ai_tools.py +154 -51
  50. package/scripts/install_steps/install_state.py +14 -2
  51. package/scripts/mcp_editors.py +7 -0
  52. package/scripts/stats.py +126 -39
  53. package/scripts/validate.py +160 -4
package/kb/reference/windows-support.md ADDED
@@ -0,0 +1,50 @@
1
+ ---
2
+ title: "Windows Support"
3
+ category: reference
4
+ service: ai-toolkit
5
+ tags: [windows, wsl, install, dependencies, hooks]
6
+ created: "2026-04-24"
7
+ last_updated: "2026-04-24"
8
+ description: "Windows support model for ai-toolkit: WSL, Git Bash, dependency detection, and hook runtime constraints."
9
+ ---
10
+
11
+ # Windows Support
12
+
13
+ ai-toolkit supports Windows through two practical modes:
14
+
15
+ 1. **WSL recommended** — best compatibility for Bash hooks, POSIX paths, symlinks, and editor configs.
16
+ 2. **Native Windows with Git Bash** — supported for CLI usage when Bash is available on `PATH`.
17
+
18
+ ## Dependency Detection
19
+
20
+ `scripts/check_deps.py` now emits install hints for Windows package managers:
21
+
22
+ | Manager | Command Prefix |
23
+ |---------|----------------|
24
+ | winget | `winget install` |
25
+ | Chocolatey | `choco install -y` |
26
+ | Scoop | `scoop install` |
27
+
28
+ Required dependency package IDs:
29
+
30
+ | Dependency | winget | Chocolatey | Scoop |
31
+ |------------|--------|------------|-------|
32
+ | Python 3 | `Python.Python.3` | `python` | `python` |
33
+ | Git | `Git.Git` | `git` | `git` |
34
+ | Node.js | `OpenJS.NodeJS` | `nodejs` | `nodejs` |
35
+
36
+ ## Hook Runtime
37
+
38
+ ai-toolkit hooks are Bash scripts. On Windows, use WSL or Git Bash so Claude Code can execute `~/.softspark/ai-toolkit/hooks/*.sh`.
39
+
40
+ Cross-platform hooks should keep the Bash entrypoint small and delegate complex work to Python or Node when Windows behavior diverges.
41
+
42
+ ## Verification
43
+
44
+ ```bash
45
+ ai-toolkit doctor
46
+ python3 scripts/check_deps.py
47
+ python3 scripts/validate.py
48
+ ```
49
+
50
+ The Windows support contract is covered by `tests/test_windows_support.bats`.