@softspark/ai-toolkit 1.3.0 → 1.3.2

package/CHANGELOG.md

@@ -7,6 +7,17 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v1.3.2 — Patch (2026-04-07)
+
+### Fixed
+- **Orphaned symlinks**: `install` and `update` now auto-clean broken agent/skill symlinks when components are removed or merged. Previously required manual `doctor --fix`.
+- **`--auto-detect` without `--local`**: Now auto-adds `--local` with warning instead of scanning `$HOME` for language markers.
+- **Session hooks concurrency**: `session-context.sh` writes per-session file (`${SESSION_ID}.json`) instead of single `current-context.json`. `pre-compact-save.sh` includes session ID in filename to avoid collisions.
+- **Language rules injection**: `install --local` now actually injects detected language rules into project `.claude/CLAUDE.md` via `<!-- TOOLKIT:language-rules -->` markers.
+- **`--local` implies `--auto-detect`**: No need to pass both flags — `install --local` automatically detects project language and installs matching rules.
+
+---
+
 ## v1.3.0 — Competitive Features Release (2026-04-07)
 
 ### Added

package/README.md

@@ -474,12 +474,12 @@ Templates include: GitHub, PostgreSQL, Slack, Sentry, Context7, Brave Search, Su
 70 language-specific coding rules across 13 languages: TypeScript, Python, Go, Rust, Java, Kotlin, Swift, Dart, C#, PHP, C++, Ruby, plus 5 common rules. Each language has 5 rule categories: coding-style, testing, patterns, frameworks, security.
 
 ```bash
-ai-toolkit install --local --auto-detect  # detect project language, install matching rules
+ai-toolkit install --local                   # auto-detects project language, installs matching rules
 ai-toolkit install --local --lang typescript  # explicit language selection
 ai-toolkit install --local --lang go,python   # multiple languages
 ```
 
-Rules are injected into `CLAUDE.md` and auto-updated on `ai-toolkit update`.
+`--local` automatically detects languages (via package.json, go.mod, Cargo.toml, etc.) — no need for `--auto-detect`. Rules are injected into `CLAUDE.md` and auto-updated on `ai-toolkit update --local`.
 
 ---
 
@@ -507,7 +507,7 @@ Module-level install granularity. Install only what you need:
 
 ```bash
 ai-toolkit install --modules core,agents,rules-typescript
-ai-toolkit install --auto-detect          # detect project language and pick modules
+ai-toolkit install --local                # auto-detects language, installs matching rules
 ai-toolkit status                         # show installed modules and versions
 ai-toolkit update                         # incremental re-install (only changed modules)
 ```
@@ -732,7 +732,7 @@ ai-toolkit install --local               # also set up project-local configs (CL
 ai-toolkit update --local                # re-apply + refresh project-local configs
 ai-toolkit install --list                # dry-run: show what would be applied
 ai-toolkit install --modules core,agents,rules-typescript  # selective module install
-ai-toolkit install --auto-detect         # detect project language and install matching rules
+ai-toolkit install --local               # auto-detects language, installs matching rules
 ai-toolkit install --lang typescript     # explicit language for rules install
 ```
 

package/kb/reference/language-rules.md

@@ -85,10 +85,10 @@ The `common/` directory uses the same structure except `frameworks.md` is replac
 
 ## Auto-Detection
 
-When `--auto-detect` is passed, `scripts/install_steps/detect_language.py` scans the current directory for known marker files and selects the matching language module:
+`--local` automatically enables language auto-detection. `scripts/install_steps/detect_language.py` scans the current directory for known marker files and selects matching language modules:
 
 ```bash
-ai-toolkit install --local --auto-detect
+ai-toolkit install --local     # auto-detects language (--auto-detect is implied)
 ```
 
 Detection logic (first match wins when multiple markers are present):
@@ -110,14 +110,14 @@ Common rules are always injected regardless of detected language.
 ## Installation
 
 ```bash
-# Auto-detect language from project files
-ai-toolkit install --local --auto-detect
+# Auto-detect language from project files (default with --local)
+ai-toolkit install --local
 
 # Explicitly select a language
 ai-toolkit install --local --lang typescript
 
-# Install without language rules
-ai-toolkit install --local
+# Skip auto-detect, install specific modules only
+ai-toolkit install --local --modules core,agents
 ```
 
 Language rules are injected into the project `CLAUDE.md` between named markers:

package/kb/reference/manifest-install.md

@@ -61,8 +61,8 @@ ai-toolkit install --profile standard
 # Module-based install (new)
 ai-toolkit install --modules core,agents,rules-typescript
 
-# Auto-detect project language and install matching rules
-ai-toolkit install --local --auto-detect
+# --local implies --auto-detect (language rules auto-detected)
+ai-toolkit install --local
 
 # Show currently installed modules and their state
 ai-toolkit status

package/package.json

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

package/scripts/install.py

@@ -409,11 +409,15 @@ def main() -> None:
     rules_dir = Path.home() / ".ai-toolkit" / "rules"
     hooks_scripts_dir = Path.home() / ".ai-toolkit" / "hooks"
 
-    # Resolve modules if module-level flags are present
+    # --local always implies --auto-detect (why install locally without language rules?)
+    if local and not auto_detect and not modules_arg:
+        auto_detect = True
+
     # --auto-detect only makes sense with --local (language rules are project-specific)
     if auto_detect and not local:
         print("Warning: --auto-detect requires --local (language rules are project-specific). Adding --local.")
         local = True
+
     project_dir = Path.cwd() if local else target_dir
     resolved_modules = resolve_requested_modules(
         modules_arg, profile, auto_detect, project_dir,

package/scripts/install_steps/symlinks.py

@@ -36,7 +36,17 @@ def install_agents(claude_dir: Path, only: str, skip: str, dry_run: bool) -> Non
             continue
         target.symlink_to(agent_file)
         linked += 1
+
+    # Clean orphaned symlinks (agents removed from toolkit)
+    orphaned = 0
+    for target in sorted(agents_dst.glob("*.md")):
+        if target.is_symlink() and not target.resolve().exists():
+            target.unlink()
+            orphaned += 1
+
     print(f"  Linked: .claude/agents/ ({linked} files)")
+    if orphaned > 0:
+        print(f"  Cleaned: {orphaned} orphaned agent symlink(s)")
     if skipped > 0:
         print(f"  Kept: {skipped} user agent(s) (name conflict)")
 
@@ -73,7 +83,17 @@ def install_skills(claude_dir: Path, only: str, skip: str, dry_run: bool) -> Non
             continue
         target.symlink_to(skill_dir)
         linked += 1
+
+    # Clean orphaned symlinks (skills removed from toolkit)
+    orphaned = 0
+    for target in sorted(skills_dst.iterdir()):
+        if target.is_symlink() and not target.resolve().exists():
+            target.unlink()
+            orphaned += 1
+
     print(f"  Linked: .claude/skills/ ({linked} directories)")
+    if orphaned > 0:
+        print(f"  Cleaned: {orphaned} orphaned skill symlink(s)")
     if skipped > 0:
         print(f"  Kept: {skipped} user skill(s) (name conflict)")