@softspark/ai-toolkit 4.19.1 → 4.21.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 (217) hide show
  1. package/CHANGELOG.md +121 -0
  2. package/LICENSE +201 -21
  3. package/NOTICE +55 -0
  4. package/README.md +35 -21
  5. package/app/.claude-plugin/plugin.json +2 -2
  6. package/app/hooks/_hook-io.sh +4 -0
  7. package/app/hooks/_locate-toolkit.sh +4 -0
  8. package/app/hooks/_profile-check.sh +4 -0
  9. package/app/hooks/_search-capability.sh +4 -0
  10. package/app/hooks/_session-paths.sh +4 -0
  11. package/app/hooks/ai-toolkit-statusline.sh +4 -0
  12. package/app/hooks/commit-quality.sh +4 -0
  13. package/app/hooks/config-desync-guard.sh +4 -0
  14. package/app/hooks/governance-capture.sh +4 -0
  15. package/app/hooks/guard-config.sh +4 -0
  16. package/app/hooks/guard-destructive.sh +4 -0
  17. package/app/hooks/guard-path.sh +4 -0
  18. package/app/hooks/instructions-audit.sh +4 -0
  19. package/app/hooks/loop-guard.sh +4 -0
  20. package/app/hooks/mcp-health.sh +4 -0
  21. package/app/hooks/notify-waiting.sh +4 -0
  22. package/app/hooks/post-tool-use.sh +4 -0
  23. package/app/hooks/pre-compact-save.sh +4 -0
  24. package/app/hooks/pre-compact.sh +4 -0
  25. package/app/hooks/quality-check.sh +4 -0
  26. package/app/hooks/quality-gate.sh +4 -0
  27. package/app/hooks/revert-guard.sh +4 -0
  28. package/app/hooks/save-session.sh +4 -0
  29. package/app/hooks/search-tracker.sh +4 -0
  30. package/app/hooks/session-end.sh +4 -0
  31. package/app/hooks/session-start.sh +4 -0
  32. package/app/hooks/stop-search-check.sh +4 -0
  33. package/app/hooks/subagent-start.sh +4 -0
  34. package/app/hooks/subagent-stop.sh +4 -0
  35. package/app/hooks/test-cohesion.sh +4 -0
  36. package/app/hooks/track-usage.sh +4 -0
  37. package/app/hooks/user-prompt-submit.sh +4 -0
  38. package/app/plugins/README.md +15 -15
  39. package/app/plugins/enterprise-pack/hooks/output-style.sh +4 -0
  40. package/app/plugins/enterprise-pack/hooks/status-line.sh +4 -0
  41. package/app/plugins/memory-pack/hooks/observation-capture.sh +4 -0
  42. package/app/plugins/memory-pack/hooks/session-summary.sh +4 -0
  43. package/app/plugins/memory-pack/scripts/init_db.py +4 -0
  44. package/app/plugins/memory-pack/scripts/strip_private.py +4 -0
  45. package/app/skills/_lib/__init__.py +4 -0
  46. package/app/skills/_lib/detect_utils.py +4 -0
  47. package/app/skills/a11y-validate/scripts/a11y-scanner.py +4 -0
  48. package/app/skills/analyze/scripts/complexity.py +4 -0
  49. package/app/skills/brand-voice/scripts/measure.py +4 -0
  50. package/app/skills/build/scripts/detect-build.py +4 -0
  51. package/app/skills/ci/scripts/ci-detect.py +4 -0
  52. package/app/skills/commit/scripts/pre-commit-check.py +4 -0
  53. package/app/skills/cve-scan/scripts/cve_scan.py +4 -0
  54. package/app/skills/debug/scripts/error-parser.py +4 -0
  55. package/app/skills/deploy/scripts/pre_deploy_check.py +4 -0
  56. package/app/skills/docs/scripts/doc-inventory.py +4 -0
  57. package/app/skills/documentation-standards/SKILL.md +25 -5
  58. package/app/skills/explain/scripts/dependency-graph.py +4 -0
  59. package/app/skills/explore/scripts/visualize.py +4 -0
  60. package/app/skills/fix/scripts/error-classifier.py +4 -0
  61. package/app/skills/health/scripts/health_check.py +4 -0
  62. package/app/skills/hipaa-validate/scripts/hipaa_scan.py +4 -0
  63. package/app/skills/lint/scripts/detect-linters.py +4 -0
  64. package/app/skills/migrate/scripts/migration-status.py +4 -0
  65. package/app/skills/plugin-creator/SKILL.md +18 -8
  66. package/app/skills/pr/scripts/pr-summary.py +4 -0
  67. package/app/skills/refactor/scripts/refactor-scan.py +4 -0
  68. package/app/skills/review/scripts/diff-analyzer.py +4 -0
  69. package/app/skills/rollback/scripts/rollback_info.py +4 -0
  70. package/app/skills/seo-validate/scripts/seo-scanner.py +4 -0
  71. package/app/skills/skill-creator/templates/reasoning-engine/search.py +4 -0
  72. package/app/skills/test/scripts/detect-runner.py +4 -0
  73. package/app/skills/write-a-prd/scripts/poll.js +4 -0
  74. package/benchmarks/ecosystem-doctor-snapshot.json +3 -3
  75. package/benchmarks/run.py +4 -0
  76. package/bin/ai-toolkit.js +4 -0
  77. package/kb/{planning/drop-cascade-hooks-after-sunset.md → history/completed/drop-cascade-hooks-after-sunset-20260710.md} +24 -0
  78. package/kb/{reference/language-packs.md → history/completed/language-packs-removed-20260727.md} +32 -7
  79. package/kb/{planning/mcp-context-trim-v4-prd.md → history/completed/mcp-context-trim-v4-prd-obsoleted-20260727.md} +43 -9
  80. package/kb/history/completed/no-op-plugin-packs-removed-20260727.md +127 -0
  81. package/kb/history/completed/tool-output-token-reduction-closed-20260727.md +190 -0
  82. package/kb/procedures/release-preparation-sop.md +83 -5
  83. package/kb/reference/comparison.md +1 -1
  84. package/kb/reference/enterprise-config-guide.md +1 -1
  85. package/kb/reference/licensing.md +148 -0
  86. package/kb/reference/plugin-pack-conventions.md +24 -16
  87. package/llms-full.txt +1182 -530
  88. package/llms.txt +6 -3
  89. package/manifest.json +1 -1
  90. package/package.json +3 -2
  91. package/scripts/_common.py +4 -0
  92. package/scripts/add_rule.py +4 -0
  93. package/scripts/audit_skills.py +4 -0
  94. package/scripts/benchmark_config.py +4 -0
  95. package/scripts/benchmark_ecosystem.py +4 -0
  96. package/scripts/check_deps.py +4 -0
  97. package/scripts/claude_app.py +4 -0
  98. package/scripts/codex_skill_adapter.py +4 -0
  99. package/scripts/compile_slm.py +4 -0
  100. package/scripts/config_cli.py +4 -0
  101. package/scripts/config_lock.py +4 -0
  102. package/scripts/config_merger.py +4 -0
  103. package/scripts/config_resolver.py +4 -0
  104. package/scripts/config_scaffold.py +5 -1
  105. package/scripts/config_validator.py +4 -0
  106. package/scripts/create_skill.py +4 -0
  107. package/scripts/dir_rules_shared.py +4 -0
  108. package/scripts/doctor.py +4 -0
  109. package/scripts/ecosystem_doctor.py +4 -0
  110. package/scripts/eject.py +4 -0
  111. package/scripts/emission.py +4 -0
  112. package/scripts/evaluate_skills.py +4 -0
  113. package/scripts/frontmatter.py +4 -0
  114. package/scripts/generate_agents_md.py +4 -0
  115. package/scripts/generate_aider_conf.py +4 -0
  116. package/scripts/generate_antigravity.py +4 -0
  117. package/scripts/generate_augment.py +4 -0
  118. package/scripts/generate_augment_agents.py +4 -0
  119. package/scripts/generate_augment_commands.py +4 -0
  120. package/scripts/generate_augment_hooks.py +4 -0
  121. package/scripts/generate_augment_rules.py +4 -0
  122. package/scripts/generate_augment_skills.py +4 -0
  123. package/scripts/generate_cline.py +4 -0
  124. package/scripts/generate_cline_rules.py +4 -0
  125. package/scripts/generate_cline_skills.py +4 -0
  126. package/scripts/generate_codex.py +4 -0
  127. package/scripts/generate_codex_agents.py +4 -0
  128. package/scripts/generate_codex_hooks.py +4 -0
  129. package/scripts/generate_codex_skills.py +4 -0
  130. package/scripts/generate_conventions.py +4 -0
  131. package/scripts/generate_copilot.py +4 -0
  132. package/scripts/generate_copilot_hooks.py +4 -0
  133. package/scripts/generate_cursor_agents.py +4 -0
  134. package/scripts/generate_cursor_hooks.py +4 -0
  135. package/scripts/generate_cursor_mdc.py +4 -0
  136. package/scripts/generate_cursor_rules.py +4 -0
  137. package/scripts/generate_cursor_skills.py +4 -0
  138. package/scripts/generate_devin_hooks.py +4 -0
  139. package/scripts/generate_gemini.py +4 -0
  140. package/scripts/generate_gemini_commands.py +4 -0
  141. package/scripts/generate_gemini_hooks.py +4 -0
  142. package/scripts/generate_gemini_skills.py +4 -0
  143. package/scripts/generate_language_rules_skills.py +4 -0
  144. package/scripts/generate_llms_txt.py +4 -0
  145. package/scripts/generate_opencode.py +4 -0
  146. package/scripts/generate_opencode_agents.py +4 -0
  147. package/scripts/generate_opencode_commands.py +4 -0
  148. package/scripts/generate_opencode_json.py +4 -0
  149. package/scripts/generate_opencode_plugin.py +4 -0
  150. package/scripts/generate_roo_modes.py +4 -0
  151. package/scripts/generate_roo_rules.py +4 -0
  152. package/scripts/generate_windsurf.py +4 -0
  153. package/scripts/generate_windsurf_rules.py +4 -0
  154. package/scripts/generate_windsurf_skills.py +4 -0
  155. package/scripts/generator_base.py +4 -0
  156. package/scripts/harvest_ecosystem.py +4 -0
  157. package/scripts/hook_sources.py +4 -0
  158. package/scripts/inject_hook_cli.py +4 -0
  159. package/scripts/inject_mcp_cli.py +4 -0
  160. package/scripts/inject_rule_cli.py +4 -0
  161. package/scripts/inject_section_cli.py +4 -0
  162. package/scripts/injection.py +4 -0
  163. package/scripts/install.py +4 -0
  164. package/scripts/install_git_hooks.py +4 -0
  165. package/scripts/install_steps/__init__.py +4 -0
  166. package/scripts/install_steps/ai_tools.py +4 -0
  167. package/scripts/install_steps/detect_language.py +4 -0
  168. package/scripts/install_steps/hooks.py +4 -0
  169. package/scripts/install_steps/install_state.py +4 -0
  170. package/scripts/install_steps/markers.py +4 -0
  171. package/scripts/install_steps/project_registry.py +4 -0
  172. package/scripts/install_steps/symlinks.py +4 -0
  173. package/scripts/instruction_core.py +4 -0
  174. package/scripts/mcp_editors.py +4 -0
  175. package/scripts/mcp_manager.py +4 -0
  176. package/scripts/mcp_sources.py +4 -0
  177. package/scripts/merge-hooks.py +4 -0
  178. package/scripts/migrate.py +4 -0
  179. package/scripts/output_filter_retirement.py +4 -0
  180. package/scripts/pack_codebase.py +4 -0
  181. package/scripts/paths.py +4 -0
  182. package/scripts/plugin.py +4 -0
  183. package/scripts/plugin_schema.py +4 -0
  184. package/scripts/projects_cli.py +4 -0
  185. package/scripts/propagate_global.py +4 -0
  186. package/scripts/remove_rule.py +4 -0
  187. package/scripts/rule_sources.py +4 -0
  188. package/scripts/secure_fs.py +4 -0
  189. package/scripts/session_state.py +4 -0
  190. package/scripts/session_token_stats.py +4 -0
  191. package/scripts/skill_pointer.py +4 -0
  192. package/scripts/stats.py +4 -0
  193. package/scripts/sync.py +4 -0
  194. package/scripts/test_cohesion.py +4 -0
  195. package/scripts/uninstall.py +4 -0
  196. package/scripts/update_projects.py +4 -0
  197. package/scripts/url_fetch.py +4 -0
  198. package/scripts/validate.py +37 -1
  199. package/scripts/version_check.py +4 -0
  200. package/app/plugins/csharp-pack/README.md +0 -11
  201. package/app/plugins/csharp-pack/plugin.json +0 -18
  202. package/app/plugins/frontend-pack/README.md +0 -14
  203. package/app/plugins/frontend-pack/plugin.json +0 -22
  204. package/app/plugins/java-pack/README.md +0 -11
  205. package/app/plugins/java-pack/plugin.json +0 -18
  206. package/app/plugins/kotlin-pack/README.md +0 -11
  207. package/app/plugins/kotlin-pack/plugin.json +0 -18
  208. package/app/plugins/research-pack/README.md +0 -14
  209. package/app/plugins/research-pack/plugin.json +0 -22
  210. package/app/plugins/ruby-pack/README.md +0 -11
  211. package/app/plugins/ruby-pack/plugin.json +0 -18
  212. package/app/plugins/rust-pack/README.md +0 -11
  213. package/app/plugins/rust-pack/plugin.json +0 -18
  214. package/app/plugins/security-pack/README.md +0 -15
  215. package/app/plugins/security-pack/plugin.json +0 -23
  216. package/app/plugins/swift-pack/README.md +0 -11
  217. package/app/plugins/swift-pack/plugin.json +0 -18
package/app/plugins/frontend-pack/plugin.json DELETED
@@ -1,22 +0,0 @@
1
- {
2
- "name": "frontend-pack",
3
- "description": "Domain plugin pack for UI architecture, design quality, accessibility, and frontend delivery workflows.",
4
- "version": "1.0.0",
5
- "domain": "frontend",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": ["frontend-specialist", "seo-specialist", "code-reviewer"],
14
- "skills": ["design-engineering", "typescript-patterns", "docs"],
15
- "rules": [],
16
- "hooks": ["post-tool-use.sh"]
17
- },
18
- "hook_events": {
19
- "post-tool-use.sh": "PostToolUse"
20
- }
21
- }
22
-
package/app/plugins/java-pack/README.md DELETED
@@ -1,11 +0,0 @@
1
- # java-pack
2
-
3
- Curated Java development patterns pack.
4
-
5
- ## Includes
6
- - Skills: `java-patterns`
7
-
8
- ## Use When
9
- - writing Java code and need modern idioms (records, sealed classes, virtual threads),
10
- - setting up new Maven or Gradle projects,
11
- - reviewing Java code for Spring Boot and JUnit 5 best practices.
package/app/plugins/java-pack/plugin.json DELETED
@@ -1,18 +0,0 @@
1
- {
2
- "name": "java-pack",
3
- "description": "Domain plugin pack for Java development patterns and idiomatic conventions.",
4
- "version": "1.0.0",
5
- "domain": "java",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": [],
14
- "skills": ["java-patterns"],
15
- "rules": [],
16
- "hooks": []
17
- }
18
- }
package/app/plugins/kotlin-pack/README.md DELETED
@@ -1,11 +0,0 @@
1
- # kotlin-pack
2
-
3
- Curated Kotlin development patterns pack.
4
-
5
- ## Includes
6
- - Skills: `kotlin-patterns`
7
-
8
- ## Use When
9
- - writing Kotlin code and need idiomatic patterns (coroutines, sealed classes, DSLs),
10
- - setting up new Kotlin projects with Gradle KTS,
11
- - reviewing Kotlin code for null safety and concurrency best practices.
package/app/plugins/kotlin-pack/plugin.json DELETED
@@ -1,18 +0,0 @@
1
- {
2
- "name": "kotlin-pack",
3
- "description": "Domain plugin pack for Kotlin development patterns and idiomatic conventions.",
4
- "version": "1.0.0",
5
- "domain": "kotlin",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": [],
14
- "skills": ["kotlin-patterns"],
15
- "rules": [],
16
- "hooks": []
17
- }
18
- }
package/app/plugins/research-pack/README.md DELETED
@@ -1,14 +0,0 @@
1
- # research-pack
2
-
3
- Curated research and synthesis pack.
4
-
5
- ## Includes
6
- - Agents: `technical-researcher`, `fact-checker`, `search-specialist`
7
- - Skills: `/search`, `/docs`, `research-mastery`, `plan-writing`
8
- - Hooks: `user-prompt-submit.sh`
9
-
10
- ## Use When
11
- - validating claims before implementation,
12
- - benchmarking external ecosystems,
13
- - writing architecture notes, audits, and synthesis reports.
14
-
package/app/plugins/research-pack/plugin.json DELETED
@@ -1,22 +0,0 @@
1
- {
2
- "name": "research-pack",
3
- "description": "Domain plugin pack for research, synthesis, source validation, and benchmark-backed discovery.",
4
- "version": "1.0.0",
5
- "domain": "research",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": ["technical-researcher", "fact-checker", "search-specialist"],
14
- "skills": ["docs", "research-mastery", "plan"],
15
- "rules": [],
16
- "hooks": ["user-prompt-submit.sh"]
17
- },
18
- "hook_events": {
19
- "user-prompt-submit.sh": "UserPromptSubmit"
20
- }
21
- }
22
-
package/app/plugins/ruby-pack/README.md DELETED
@@ -1,11 +0,0 @@
1
- # ruby-pack
2
-
3
- Curated Ruby development patterns pack.
4
-
5
- ## Includes
6
- - Skills: `ruby-patterns`
7
-
8
- ## Use When
9
- - writing Ruby code and need idiomatic patterns (blocks, modules, metaprogramming),
10
- - setting up new Rails or Sinatra projects,
11
- - reviewing Ruby code for RSpec, ActiveRecord, and performance best practices.
package/app/plugins/ruby-pack/plugin.json DELETED
@@ -1,18 +0,0 @@
1
- {
2
- "name": "ruby-pack",
3
- "description": "Domain plugin pack for Ruby development patterns and Rails conventions.",
4
- "version": "1.0.0",
5
- "domain": "ruby",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": [],
14
- "skills": ["ruby-patterns"],
15
- "rules": [],
16
- "hooks": []
17
- }
18
- }
package/app/plugins/rust-pack/README.md DELETED
@@ -1,11 +0,0 @@
1
- # rust-pack
2
-
3
- Curated Rust development patterns pack.
4
-
5
- ## Includes
6
- - Skills: `rust-patterns`
7
-
8
- ## Use When
9
- - writing Rust code and need idiomatic patterns,
10
- - setting up new Rust projects with Cargo,
11
- - reviewing Rust code for ownership, borrowing, and lifetime best practices.
package/app/plugins/rust-pack/plugin.json DELETED
@@ -1,18 +0,0 @@
1
- {
2
- "name": "rust-pack",
3
- "description": "Domain plugin pack for Rust development patterns and idiomatic conventions.",
4
- "version": "1.0.0",
5
- "domain": "rust",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": [],
14
- "skills": ["rust-patterns"],
15
- "rules": [],
16
- "hooks": []
17
- }
18
- }
package/app/plugins/security-pack/README.md DELETED
@@ -1,15 +0,0 @@
1
- # security-pack
2
-
3
- Curated security-focused plugin pack.
4
-
5
- ## Includes
6
- - Agents: `security-auditor`, `security-architect`, `code-reviewer`
7
- - Skills: `/review`, `security-patterns`, `/panic`
8
- - Rules: `quality-gates`
9
- - Hooks: `guard-destructive.sh`, `guard-path.sh`, `quality-gate.sh`
10
-
11
- ## Use When
12
- - running security audits,
13
- - reviewing authentication / authorization changes,
14
- - hardening deployments and operational workflows.
15
-
package/app/plugins/security-pack/plugin.json DELETED
@@ -1,23 +0,0 @@
1
- {
2
- "name": "security-pack",
3
- "description": "Domain plugin pack for secure coding, architecture review, and hardening workflows.",
4
- "version": "1.0.0",
5
- "domain": "security",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": ["security-auditor", "security-architect", "code-reviewer"],
14
- "skills": ["review", "security-patterns", "panic"],
15
- "rules": ["quality-gates"],
16
- "hooks": ["guard-destructive.sh", "quality-gate.sh"]
17
- },
18
- "hook_events": {
19
- "guard-destructive.sh": "PreToolUse",
20
- "quality-gate.sh": "TaskCompleted"
21
- }
22
- }
23
-
package/app/plugins/swift-pack/README.md DELETED
@@ -1,11 +0,0 @@
1
- # swift-pack
2
-
3
- Curated Swift and iOS development patterns pack.
4
-
5
- ## Includes
6
- - Skills: `swift-patterns`
7
-
8
- ## Use When
9
- - writing Swift code and need idiomatic patterns (protocol-oriented, optionals, concurrency),
10
- - setting up new Swift Package Manager or Xcode projects,
11
- - reviewing Swift code for SwiftUI, async/await, and actor isolation best practices.
package/app/plugins/swift-pack/plugin.json DELETED
@@ -1,18 +0,0 @@
1
- {
2
- "name": "swift-pack",
3
- "description": "Domain plugin pack for Swift and iOS development patterns.",
4
- "version": "1.0.0",
5
- "domain": "swift",
6
- "type": "plugin-pack",
7
- "status": "experimental",
8
- "requires": {
9
- "ai-toolkit": ">=1.0.0",
10
- "claude-code": ">=1.0.33"
11
- },
12
- "includes": {
13
- "agents": [],
14
- "skills": ["swift-patterns"],
15
- "rules": [],
16
- "hooks": []
17
- }
18
- }