@softspark/ai-toolkit 2.0.2 → 2.1.1

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 (42) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/README.md +143 -774
  3. package/app/ARCHITECTURE.md +1 -1
  4. package/app/plugins/README.md +6 -2
  5. package/app/skills/plugin-creator/SKILL.md +3 -4
  6. package/bin/ai-toolkit.js +34 -10
  7. package/kb/procedures/maintenance-sop.md +64 -16
  8. package/kb/procedures/release-preparation-sop.md +4 -2
  9. package/kb/procedures/release-verification-sop.md +15 -13
  10. package/kb/reference/architecture-overview.md +44 -5
  11. package/kb/reference/claude-ecosystem-expansion-foundations.md +4 -4
  12. package/kb/reference/cli-reference.md +135 -0
  13. package/kb/reference/codex-cli-compatibility.md +136 -0
  14. package/kb/reference/comparison.md +29 -0
  15. package/kb/reference/extension-api.md +23 -6
  16. package/kb/reference/global-install-model.md +62 -5
  17. package/kb/reference/mcp-editor-compatibility.md +62 -0
  18. package/kb/reference/mcp-templates.md +32 -6
  19. package/kb/reference/plugin-pack-conventions.md +22 -21
  20. package/kb/reference/skills-catalog.md +27 -5
  21. package/kb/reference/unique-features.md +213 -0
  22. package/llms-full.txt +903 -84
  23. package/llms.txt +5 -0
  24. package/package.json +6 -5
  25. package/scripts/codex_skill_adapter.py +295 -0
  26. package/scripts/dir_rules_shared.py +46 -7
  27. package/scripts/generate_agents_md.py +13 -0
  28. package/scripts/generate_antigravity.py +2 -1
  29. package/scripts/generate_augment_rules.py +2 -1
  30. package/scripts/generate_cline_rules.py +13 -3
  31. package/scripts/generate_codex.py +105 -0
  32. package/scripts/generate_codex_hooks.py +78 -0
  33. package/scripts/generate_codex_rules.py +52 -0
  34. package/scripts/generate_cursor_mdc.py +2 -1
  35. package/scripts/generate_roo_rules.py +2 -1
  36. package/scripts/generate_windsurf_rules.py +2 -1
  37. package/scripts/generator_base.py +15 -0
  38. package/scripts/install_steps/ai_tools.py +83 -4
  39. package/scripts/mcp_editors.py +340 -0
  40. package/scripts/mcp_manager.py +125 -13
  41. package/scripts/plugin.py +745 -301
  42. package/scripts/plugin_schema.py +16 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,55 @@ Versioning follows [Semantic Versioning](https://semver.org/).
7
7
 
8
8
  ---
9
9
 
10
+ ## v2.1.1 — Custom Rules in Generators & README Restructure (2026-04-13)
11
+
12
+ ### Fixed
13
+ - **Custom rules in generators** — `generate:all` now includes registered custom rules (from `ai-toolkit add-rule`) in all single-file generators (Cursor, Windsurf, Copilot, Gemini, AGENTS.md) and directory-based generators (Cline, Roo, Codex, Augment, Antigravity, Cursor MDC). Previously custom rules were lost on regeneration.
14
+ - **AGENTS.md double generation** — `generate-all` CLI no longer generates AGENTS.md twice; uses `codex-md` (superset) only
15
+ - **CLI help completeness** — added missing `--persona` option and `codex` to `--editors` list in `ai-toolkit help`
16
+
17
+ ### Changed
18
+ - **README restructured** — reduced from 951 to 292 lines with Table of Contents, "What's New" section, and links to KB docs. Detailed content moved to dedicated KB documents.
19
+ - **npm `generate:agents`** — now uses `generate_codex.py` (consistent with CLI `generate-all`)
20
+ - **Test assertions** — generator file count tests use `>= 6` to accommodate registered custom rules
21
+
22
+ ### New Files
23
+ - `kb/reference/cli-reference.md` — complete CLI command reference (moved from README)
24
+ - `kb/reference/unique-features.md` — detailed differentiators documentation (moved from README)
25
+ - `kb/reference/comparison.md` — ecosystem comparison table (moved from README)
26
+
27
+ ---
28
+
29
+ ## v2.1.0 — Codex CLI Support & Native Editor MCP Install (2026-04-13)
30
+
31
+ ### Added
32
+ - **Codex CLI as 10th editor** — full support via `--editors codex`: `AGENTS.md`, `.agents/rules/*.md`, `.agents/skills/*`, `.codex/hooks.json`
33
+ - **Codex skill translation layer** — Claude-only orchestration skills (orchestrate, workflow, swarm, teams, subagent-development) are automatically translated to Codex-native `spawn_agent`/`update_plan` wrappers; native skills are symlinked directly
34
+ - **Native editor MCP install** — `ai-toolkit mcp install --editor <name> --scope project|global` renders canonical `.mcp.json` templates into 8 editor-native config formats (Claude, Cursor, Copilot, Gemini, Windsurf, Cline, Augment, Codex)
35
+ - **MCP auto-sync on local install** — `install --local` mirrors `.mcp.json` into `.claude/settings.local.json` plus selected project editors (Cursor, Copilot)
36
+ - **`mcp editors` subcommand** — lists all supported native MCP adapters with scope/path info
37
+ - **Cross-editor verification SOP** — mandatory check against official docs before adding any component
38
+ - **Runtime-aware plugin installs** — `ai-toolkit plugin install|update|remove|status --editor claude|codex|all` now targets Claude and a global Codex plugin layer consistently
39
+ - **Global Codex plugin layer** — plugin packs can bootstrap `~/AGENTS.md`, `~/.agents/`, and `~/.codex/hooks.json` without changing the default project-local Codex core install model
40
+ - **Plugin lifecycle tests** — coverage for install/update/remove behavior across Claude and Codex runtimes, including shared asset retention
41
+ - **Safe Codex and Cline rule regeneration** — `generate_codex_rules.py` and `generate_cline_rules.py` now support `--skip-cleanup` to refresh standard generated rules without deleting custom overlays
42
+
43
+ ### New Files
44
+ - `scripts/mcp_editors.py` — 8 native MCP config adapters
45
+ - `scripts/codex_skill_adapter.py` — skill translation layer for Codex
46
+ - `scripts/generate_codex.py` — AGENTS.md generator with Codex orchestration guidance
47
+ - `scripts/generate_codex_hooks.py` — `.codex/hooks.json` generator
48
+ - `scripts/generate_codex_rules.py` — `.agents/rules/*.md` generator
49
+ - `kb/reference/codex-cli-compatibility.md` — Codex mapping reference
50
+ - `kb/reference/mcp-editor-compatibility.md` — native MCP support matrix
51
+ - `tests/test_plugin.bats` — runtime-aware plugin install/remove coverage
52
+
53
+ ### Changed
54
+ - **Release workflow** — `generate:all` now refreshes tracked Codex rules and uses the directory-based Cline generator that matches the current repository layout
55
+ - **Documentation** — README, KB references, maintenance SOPs, and generated artifacts now consistently describe the Claude + global Codex plugin model
56
+
57
+ ---
58
+
10
59
  ## v2.0.2 — Clean Legacy Directory Removal (2026-04-12)
11
60
 
12
61
  ### Fixed