@softspark/ai-toolkit 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -7,6 +7,25 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v1.4.2 — --local Scoping Fix, Leading Blank Lines Fix (2026-04-09)
+
+### Fixed
+- `--local` now runs only project-local install (no global re-install). Global install runs separately without `--local`.
+- Fixed leading blank lines in generated files (copilot-instructions.md, etc.) caused by `inject_section` and `inject_with_rules`.
+- Context-aware "Next steps" message (local vs global).
+
+### Changed
+- Updated KB docs: global-install-model.md, maintenance-sop.md to reflect `--local` scoping change.
+
+---
+
+## v1.4.1 — Documentation Fix: --local Behavior (2026-04-09)
+
+### Fixed
+- README Per-Project Setup, Quick Start, and CLI table now correctly state that `--local` installs Claude Code only by default, with `--editors` flag for other tools.
+
+---
+
 ## v1.4.0 — Full Platform Parity: 11 Editors, Directory-Based Rules, --editors Flag (2026-04-09)
 
 ### Added

package/README.md

@@ -31,12 +31,14 @@ npm install -g @softspark/ai-toolkit@latest && ai-toolkit update
 
 ### Per-Project Setup
 
-After global install, run `--local` in each project to generate project-specific configs (CLAUDE.md, Copilot, Cline, Roo Code, Aider, git hooks):
+After global install, run `--local` in each project. By default, only Claude Code configs are installed (CLAUDE.md, settings, constitution, language rules). Add `--editors` for other tools:
 
 ```bash
 cd your-project/
-ai-toolkit install --local         # first time
-ai-toolkit update --local          # after toolkit updates
+ai-toolkit install --local                     # Claude Code only
+ai-toolkit install --local --editors all       # + all editors (Cursor, Windsurf, Cline, Roo, Aider, Augment, Copilot, Antigravity)
+ai-toolkit install --local --editors cursor,aider  # + specific editors
+ai-toolkit update --local                      # auto-detects editors from existing project files
 ```
 
 ### Plugin Management
@@ -642,10 +644,13 @@ ai-toolkit install
 # After npm update — re-apply updated components
 ai-toolkit update
 
-# Init project (CLAUDE.md + settings + constitution + Copilot + Cline + Roo + Aider + Git Hooks + MCP Default)
+# Init project (Claude Code configs only: CLAUDE.md, settings, constitution, language rules)
 ai-toolkit install --local
 
-# Update project-local configs after toolkit update
+# Init with all editors (Cursor, Windsurf, Cline, Roo, Aider, Augment, Copilot, Antigravity)
+ai-toolkit install --local --editors all
+
+# Update project — auto-detects editors from existing config files
 ai-toolkit update --local
 ```
 
@@ -720,9 +725,9 @@ Usage: ai-toolkit <command> [options]
 | Command | Description |
 |---------|-------------|
 | `install` | First-time global install into `~/.claude/` + Cursor, Windsurf, Gemini |
-| `install --local` | Also set up project-local configs (CLAUDE.md, settings, constitution, Copilot, Cline, Roo, Aider, Git Hooks, MCP Defaults) |
+| `install --local` | Claude Code configs only; add `--editors all` or `--editors cursor,aider` for other tools |
 | `update` | Re-apply toolkit after `npm install -g @softspark/ai-toolkit@latest` |
-| `update --local` | Re-apply + refresh project-local configs in current dir |
+| `update --local` | Re-apply + auto-detect editors from existing project files |
 | `reset --local` | Wipe all project-local configs and recreate from scratch (clean slate) |
 | `add-rule <rule.md> [name]` | Register rule in `~/.ai-toolkit/rules/` — auto-applied on every `update` |
 | `remove-rule <name> [dir]` | Unregister rule from `~/.ai-toolkit/rules/` and remove its block from `CLAUDE.md` |

package/kb/procedures/maintenance-sop.md

@@ -91,7 +91,7 @@ ai-toolkit update
 
 ```bash
 ai-toolkit update --only agents,hooks   # re-apply only specific components
-ai-toolkit update --local               # also refresh project-local Copilot + Cline + Roo + Aider
+ai-toolkit update --local               # refresh project-local configs (auto-detects editors from existing files)
 ai-toolkit update --list                # dry-run: show what would change
 ```
 

package/kb/reference/global-install-model.md

@@ -23,8 +23,8 @@ That means one machine-level install provides agents, skills, hooks, and rules t
 |---------|--------|---------|
 | `ai-toolkit install` | `~/.claude/` | first-time machine setup |
 | `ai-toolkit update` | `~/.claude/` | re-apply after package or rule changes |
-| `ai-toolkit install --local` | current project | create local `CLAUDE.md`, `.claude/settings.local.json`, and inject constitution + Copilot + Cline + Roo Code + Aider configs. Installs git hooks fallback. |
-| `ai-toolkit update --local` | current project | refresh those local project files |
+| `ai-toolkit install --local` | current project | Claude Code configs only (CLAUDE.md, settings, constitution, language rules). Add `--editors all` for other tools. |
+| `ai-toolkit update --local` | current project | refresh project configs; auto-detects editors from existing files |
 | `ai-toolkit add-rule` | `~/.ai-toolkit/rules/` | register a global rule |
 | `ai-toolkit remove-rule` | `~/.ai-toolkit/rules/` | unregister a global rule |
 

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.0",
+  "version": "1.4.2",
   "components": {
     "agents": {
       "description": "44 specialized agents (orchestrator, backend, frontend, security, devops, etc.)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softspark/ai-toolkit",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Professional-grade AI coding toolkit: 91 skills, 44 agents, multi-platform support (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Google Antigravity), machine-enforced safety constitution, persona presets, skill security auditor, expanded lifecycle hooks, 11 plugin packs, and benchmark tooling.",
   "keywords": [
     "claude",

package/scripts/injection.py

@@ -134,6 +134,7 @@ def inject_section(
 
     output = "\n".join(parts) + "\n"
     output = collapse_blank_runs(output)
+    output = output.lstrip("\n")  # no leading blank lines
 
     target_file.write_text(output, encoding="utf-8")
     return action

package/scripts/install.py

@@ -312,16 +312,23 @@ def print_banner(target_dir: Path, rules_dir: Path, profile: str,
     print()
 
 
-def print_summary() -> None:
+def print_summary(local: bool = False) -> None:
     print()
     print("Done.")
-    print()
-    print("Next steps:")
-    print("  1. Edit ~/.claude/CLAUDE.md -- add your global rules above the toolkit sections")
-    print("  2. Per project: ai-toolkit install --local (or: ai-toolkit update --local)")
-    print("  3. To update: npm install -g @softspark/ai-toolkit@latest && ai-toolkit update")
-    print("  4. To register rules from other tools: ai-toolkit add-rule <rule.md>")
-    print("  5. Check install state: ai-toolkit status")
+    if local:
+        print()
+        print("Next steps:")
+        print("  1. Edit CLAUDE.md -- add your project-specific rules")
+        print("  2. Add more editors: ai-toolkit install --local --editors cursor,aider")
+        print("  3. Update project configs: ai-toolkit update --local")
+    else:
+        print()
+        print("Next steps:")
+        print("  1. Edit ~/.claude/CLAUDE.md -- add your global rules above the toolkit sections")
+        print("  2. Per project: ai-toolkit install --local --editors all")
+        print("  3. To update: npm install -g @softspark/ai-toolkit@latest && ai-toolkit update")
+        print("  4. To register rules from other tools: ai-toolkit add-rule <rule.md>")
+        print("  5. Check install state: ai-toolkit status")
 
 
 # ---------------------------------------------------------------------------
@@ -457,25 +464,26 @@ def main() -> None:
         only = resolve_profile(profile, only)
 
     check_dependencies()
-    print_banner(target_dir, rules_dir, profile, only, skip, dry_run,
-                 modules=resolved_modules)
 
     if not dry_run:
         rules_dir.mkdir(parents=True, exist_ok=True)
         hooks_scripts_dir.mkdir(parents=True, exist_ok=True)
 
-    install_claude_code(target_dir, hooks_scripts_dir, rules_dir, only, skip, dry_run)
-    install_ai_tools(target_dir, rules_dir, only, skip, dry_run)
-
     if local:
-        # Pass language modules for --auto-detect / --modules rules-*
+        # --local: project-local only, no global install
         lang_modules = [m for m in (resolved_modules or []) if m.startswith("rules-")]
         editors_arg: str = cfg["editors"]
         install_local_project(rules_dir, dry_run, reset, lang_modules or None,
                               editors=editors_arg)
-
-    install_persona(target_dir, persona, dry_run)
-    install_strict_git_hooks(profile, local, dry_run)
+        install_strict_git_hooks(profile, local, dry_run)
+    else:
+        # Global install
+        print_banner(target_dir, rules_dir, profile, only, skip, dry_run,
+                     modules=resolved_modules)
+        install_claude_code(target_dir, hooks_scripts_dir, rules_dir, only, skip, dry_run)
+        install_ai_tools(target_dir, rules_dir, only, skip, dry_run)
+        install_persona(target_dir, persona, dry_run)
+        install_strict_git_hooks(profile, local, dry_run)
 
     # Record install state (skip for dry-run)
     if not dry_run:
@@ -497,7 +505,7 @@ def main() -> None:
             auto_detected=auto_detected,
         )
 
-    print_summary()
+    print_summary(local=local)
 
 
 def _infer_modules_from_legacy(profile: str, only: str) -> list[str]:

package/scripts/install_steps/ai_tools.py

@@ -90,6 +90,7 @@ def inject_with_rules(
     if start_marker in existing:
         existing = _strip_section(existing, "ai-toolkit")
     existing = _trim_trailing_blanks(existing)
+    existing = existing.lstrip("\n")  # no leading blank lines
 
     parts: list[str] = []
     if existing.strip():
@@ -99,6 +100,7 @@ def inject_with_rules(
 
     output = "\n".join(parts) + "\n"
     output = _collapse_blank_runs(output)
+    output = output.lstrip("\n")  # no leading blank lines
     target_file.write_text(output, encoding="utf-8")
 
     if rules_dir.is_dir():