@softspark/ai-toolkit 1.4.1 → 1.4.2

package/CHANGELOG.md

@@ -7,6 +7,18 @@ 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

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.1",
+  "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.1",
+  "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():