@softspark/ai-toolkit 1.9.0 → 2.0.1

package/llms.txt

@@ -17,7 +17,6 @@
 - [Plan: Offline-First SLM Profile — Lightweight Mode for Local Models](kb/history/completed/offline-slm-profile-plan-20260411.md)
 - [How-To Guides](kb/howto/README.md)
 - [Plan: Cloud Security Pack — Multi-Cloud Audit](kb/planning/cloud-security-pack-plan.md)
-- [Plan: Local Dashboard — `ai-toolkit ui`](kb/planning/local-dashboard-plan.md)
 - [SOP: Claude Toolkit Maintenance](kb/procedures/maintenance-sop.md)
 - [SOP: Release Preparation](kb/procedures/release-preparation-sop.md)
 - [SOP: Release Verification](kb/procedures/release-verification-sop.md)

package/manifest.json

@@ -18,7 +18,7 @@
     "hooks": {
       "description": "21 global hook entries across 12 lifecycle events + 5 skill-scoped lifecycle hooks",
       "path": "app/hooks.json + app/hooks/*.sh",
-      "target": "~/.claude/settings.json (merge) + ~/.ai-toolkit/hooks/ (copy)",
+      "target": "~/.claude/settings.json (merge) + ~/.softspark/ai-toolkit/hooks/ (copy)",
       "type": "merge+copy",
       "tags": ["core", "hooks", "quality"]
     },
@@ -159,9 +159,9 @@
   },
   "config_inheritance": {
     "schema": "scripts/schemas/ai-toolkit-config.schema.json",
-    "project_config": ".ai-toolkit.json",
+    "project_config": ".softspark-toolkit.json",
     "base_config": "ai-toolkit.config.json",
-    "lock_file": ".ai-toolkit.lock.json",
+    "lock_file": ".softspark-toolkit.lock.json",
     "v1_fields": ["extends", "profile", "agents", "rules", "constitution", "enforce"],
     "max_extends_depth": 5
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softspark/ai-toolkit",
-  "version": "1.9.0",
+  "version": "2.0.1",
   "description": "Professional-grade AI coding toolkit: 92 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/add_rule.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""add-rule -- Register a rule file in ~/.ai-toolkit/rules/.
+"""add-rule -- Register a rule file in ~/.softspark/ai-toolkit/rules/.
 
 Registered rules are automatically injected into all AI tool configs
 on next 'ai-toolkit install' or 'ai-toolkit update':
@@ -39,7 +39,8 @@ def main() -> None:
     if not rule_name:
         print("Error: rule name is empty after sanitization", file=sys.stderr)
         sys.exit(1)
-    rules_dir = Path.home() / ".ai-toolkit" / "rules"
+    from paths import RULES_DIR
+    rules_dir = RULES_DIR
     rules_dir.mkdir(parents=True, exist_ok=True)
 
     dest = rules_dir / f"{rule_name}.md"

package/scripts/benchmark_config.py

@@ -9,8 +9,10 @@ from pathlib import Path
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 from _common import toolkit_dir
 
+from paths import HOOKS_DIR as _HOOKS_DIR
+
 CLAUDE_DIR = Path.home() / ".claude"
-HOOKS_DIR = Path.home() / ".ai-toolkit" / "hooks"
+HOOKS_DIR = _HOOKS_DIR
 DASHBOARD = toolkit_dir / "benchmarks" / "ecosystem-dashboard.json"
 
 

package/scripts/compile_slm.py

@@ -14,7 +14,7 @@ Options:
     --model-size SIZE   Model size: 7b, 8b, 14b, 32b, 70b (default: auto-detect)
     --persona NAME      Persona preset to prioritize (e.g., backend-lead)
     --lang LANGS        Comma-separated languages to include (e.g., python,typescript)
-    --output PATH       Output file path (default: ~/.ai-toolkit/compiled/slm-system-prompt.md)
+    --output PATH       Output file path (default: ~/.softspark/ai-toolkit/compiled/slm-system-prompt.md)
     --format FORMAT     Output format: raw, ollama, json-string, aider (default: raw)
     --dry-run           Show what would be included without writing output
     --level LEVEL       Compression level: ultra-light, light, standard, extended (default: auto)
@@ -171,7 +171,8 @@ class Component:
 
 def _load_usage_stats() -> dict[str, int]:
     """Load skill invocation counts from stats.json."""
-    stats_path = Path.home() / ".ai-toolkit" / "stats.json"
+    from paths import STATS_FILE
+    stats_path = STATS_FILE
     if not stats_path.is_file():
         return {}
     try:
@@ -840,13 +841,13 @@ Note: Replace the FROM line in the Modelfile with your base model (e.g., FROM ll
 ## Aider Setup
 
 1. Compile system prompt:
-   ai-toolkit compile-slm --format aider --model-size {model_size} --output .ai-toolkit-system.md
+   ai-toolkit compile-slm --format aider --model-size {model_size} --output .softspark-toolkit-system.md
 
 2. Run Aider with custom system prompt:
-   aider --system-prompt-file .ai-toolkit-system.md
+   aider --system-prompt-file .softspark-toolkit-system.md
 
 3. Or add to .aider.conf.yml:
-   system-prompt-file: .ai-toolkit-system.md""",
+   system-prompt-file: .softspark-toolkit-system.md""",
 
     "continue-dev": """\
 ## Continue.dev Setup
@@ -949,7 +950,7 @@ def build_parser() -> argparse.ArgumentParser:
     )
     parser.add_argument(
         "--output", default="",
-        help="Output file path (default: ~/.ai-toolkit/compiled/slm-system-prompt.md)",
+        help="Output file path (default: ~/.softspark/ai-toolkit/compiled/slm-system-prompt.md)",
     )
     parser.add_argument(
         "--format",
@@ -1021,7 +1022,8 @@ def main(argv: list[str] | None = None) -> int:
     # Write output
     output_path = args.output
     if not output_path:
-        compiled_dir = Path.home() / ".ai-toolkit" / "compiled"
+        from paths import COMPILED_DIR
+        compiled_dir = COMPILED_DIR
         compiled_dir.mkdir(parents=True, exist_ok=True)
         output_path = str(compiled_dir / "slm-system-prompt.md")
 

package/scripts/config_cli.py

@@ -2,7 +2,7 @@
 """CLI dispatcher for ai-toolkit config subcommands.
 
 Usage:
-    ai-toolkit config validate [path]     — Validate .ai-toolkit.json
+    ai-toolkit config validate [path]     — Validate .softspark-toolkit.json
     ai-toolkit config diff [path]         — Show project vs base differences
     ai-toolkit config init                — Interactive config setup (MVP Phase 3)
     ai-toolkit config create-base <name>  — Scaffold base config package (MVP Phase 3)
@@ -33,7 +33,7 @@ from config_scaffold import create_base_package, create_project_config
 from config_lock import check_lock_staleness
 
 
-PROJECT_CONFIG_FILENAME = ".ai-toolkit.json"
+from paths import PROJECT_CONFIG_FILENAME
 
 
 # ---------------------------------------------------------------------------
@@ -41,7 +41,7 @@ PROJECT_CONFIG_FILENAME = ".ai-toolkit.json"
 # ---------------------------------------------------------------------------
 
 def cmd_validate(args: list[str]) -> int:
-    """Validate .ai-toolkit.json schema and extends resolution."""
+    """Validate .softspark-toolkit.json schema and extends resolution."""
     project_dir = Path(args[0]) if args else Path.cwd()
 
     try:
@@ -350,7 +350,7 @@ def cmd_check(args: list[str]) -> int:
     Exit codes:
       0 — project complies with base config
       1 — violations found
-      2 — .ai-toolkit.json not found
+      2 — .softspark-toolkit.json not found
     """
     project_dir = Path(args[0]) if args and not args[0].startswith("-") else Path.cwd()
     json_output = "--json" in args
@@ -365,7 +365,7 @@ def cmd_check(args: list[str]) -> int:
         return 1
     if config is None:
         if json_output:
-            print(json.dumps({"status": "error", "code": 2, "message": "No .ai-toolkit.json found"}))
+            print(json.dumps({"status": "error", "code": 2, "message": "No .softspark-toolkit.json found"}))
         else:
             print(f"  ✗ No {PROJECT_CONFIG_FILENAME} found in {project_dir}")
         return 2
@@ -513,9 +513,9 @@ def main() -> None:
         print("Usage: ai-toolkit config <subcommand> [args...]")
         print()
         print("Subcommands:")
-        print("  validate [path]      Validate .ai-toolkit.json schema + extends")
+        print("  validate [path]      Validate .softspark-toolkit.json schema + extends")
         print("  diff [path]          Show project vs base config differences")
-        print("  init [flags]         Create .ai-toolkit.json (--extends, --profile, --no-extends)")
+        print("  init [flags]         Create .softspark-toolkit.json (--extends, --profile, --no-extends)")
         print("  create-base <name>   Scaffold base config npm package")
         print("  check [path]         CI enforcement check (exit 0=pass, 1=fail, 2=no config)")
         sys.exit(0)

package/scripts/config_lock.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """Lock file management for ai-toolkit config inheritance.
 
-Generates and consumes .ai-toolkit.lock.json for reproducible
+Generates and consumes .softspark-toolkit.lock.json for reproducible
 extends resolution across team members and CI.
 
 Stdlib-only — no external dependencies.
@@ -15,7 +15,7 @@ from pathlib import Path
 from typing import Any
 
 
-LOCK_FILENAME = ".ai-toolkit.lock.json"
+LOCK_FILENAME = ".softspark-toolkit.lock.json"
 LOCK_VERSION = 1
 
 
@@ -23,14 +23,22 @@ LOCK_VERSION = 1
 # Public API
 # ---------------------------------------------------------------------------
 
+LEGACY_LOCK_FILENAME = ".ai-toolkit.lock.json"
+
+
 def load_lock_file(project_dir: Path) -> dict[str, Any] | None:
     """Load lock file from project directory.
 
-    Returns None if the file doesn't exist.
+    Falls back to legacy .ai-toolkit.lock.json if the new file doesn't exist.
+    Returns None if neither file exists.
     """
     lock_path = project_dir / LOCK_FILENAME
     if not lock_path.is_file():
-        return None
+        legacy_path = project_dir / LEGACY_LOCK_FILENAME
+        if legacy_path.is_file():
+            lock_path = legacy_path
+        else:
+            return None
     try:
         with open(lock_path, encoding="utf-8") as f:
             return json.load(f)

package/scripts/config_merger.py

@@ -66,7 +66,7 @@ def merge_config_chain(
 
     Args:
         base_configs: Ordered list of base config dicts (deepest ancestor first).
-        project_config: The project-level .ai-toolkit.json data.
+        project_config: The project-level .softspark-toolkit.json data.
 
     Returns:
         MergeResult with the final merged config.

package/scripts/config_resolver.py

@@ -2,7 +2,7 @@
 """Config resolver for ai-toolkit extends system.
 
 Resolves base configs from npm packages, git URLs, or local paths.
-Caches resolved configs in ~/.ai-toolkit/config-cache/.
+Caches resolved configs in ~/.softspark/ai-toolkit/config-cache/.
 
 Stdlib-only — no external dependencies.
 """
@@ -25,15 +25,23 @@ from typing import Any
 # Constants
 # ---------------------------------------------------------------------------
 
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+from paths import (
+    BASE_CONFIG_FILENAME,
+    CONFIG_CACHE_DIR,
+    LEGACY_PROJECT_CONFIG,
+    PROJECT_CONFIG_FILENAME as _PROJECT_CONFIG,
+)
+
 MAX_EXTENDS_DEPTH = 5
-CONFIG_FILENAME = "ai-toolkit.config.json"
-PROJECT_CONFIG_FILENAME = ".ai-toolkit.json"
+CONFIG_FILENAME = BASE_CONFIG_FILENAME
+PROJECT_CONFIG_FILENAME = _PROJECT_CONFIG
 CACHE_DIR_NAME = "config-cache"
 
 
 def _cache_root() -> Path:
     """Return the cache root directory."""
-    return Path(os.environ.get("AI_TOOLKIT_HOME", Path.home() / ".ai-toolkit")) / CACHE_DIR_NAME
+    return CONFIG_CACHE_DIR
 
 
 # ---------------------------------------------------------------------------
@@ -84,7 +92,7 @@ def resolve_extends(
     """Resolve an extends chain into an ordered list of base configs.
 
     Args:
-        extends_value: The extends string from .ai-toolkit.json.
+        extends_value: The extends string from .softspark-toolkit.json.
         project_root: The project directory (for resolving relative paths).
         refresh: Force re-fetch ignoring cache.
 
@@ -100,12 +108,17 @@ def resolve_extends(
 
 
 def load_project_config(project_root: str | Path) -> dict[str, Any] | None:
-    """Load .ai-toolkit.json from the project root.
+    """Load .softspark-toolkit.json from the project root.
 
-    Returns None if the file doesn't exist.
+    Falls back to legacy .ai-toolkit.json if the new file doesn't exist.
+    Returns None if neither file exists.
     """
     config_path = Path(project_root) / PROJECT_CONFIG_FILENAME
     if not config_path.is_file():
+        # Fallback to legacy filename
+        legacy_path = Path(project_root) / LEGACY_PROJECT_CONFIG
+        if legacy_path.is_file():
+            return _load_json(legacy_path)
         return None
     return _load_json(config_path)
 

package/scripts/config_scaffold.py

@@ -2,7 +2,7 @@
 """Scaffolding for ai-toolkit config inheritance.
 
 - create_base_package(): Scaffold an npm base config package
-- create_project_config(): Generate .ai-toolkit.json for a project
+- create_project_config(): Generate .softspark-toolkit.json for a project
 
 Stdlib-only — no external dependencies.
 """
@@ -118,7 +118,7 @@ Shared ai-toolkit configuration for {org}.
 
 ### In your project
 
-Create `.ai-toolkit.json` in your project root:
+Create `.softspark-toolkit.json` in your project root:
 
 ```json
 {{
@@ -201,7 +201,7 @@ def create_project_config(
     extends: str = "",
     profile: str = "standard",
 ) -> Path:
-    """Generate .ai-toolkit.json for a project.
+    """Generate .softspark-toolkit.json for a project.
 
     Args:
         project_dir: Project root directory.
@@ -218,7 +218,7 @@ def create_project_config(
 
     config["profile"] = profile
 
-    config_path = project_dir / ".ai-toolkit.json"
+    config_path = project_dir / ".softspark-toolkit.json"
     _write_json(config_path, config)
     return config_path
 

package/scripts/config_validator.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """Config validator for ai-toolkit extends system.
 
-Validates .ai-toolkit.json against schema, checks enforce constraints,
+Validates .softspark-toolkit.json against schema, checks enforce constraints,
 verifies constitution integrity, and validates referenced files exist.
 
 Stdlib-only — no external dependencies.
@@ -45,7 +45,7 @@ def validate_project_config(
     config: dict[str, Any],
     project_root: Path | None = None,
 ) -> list[str]:
-    """Validate a project-level .ai-toolkit.json.
+    """Validate a project-level .softspark-toolkit.json.
 
     Returns list of error strings (empty = valid).
     """
@@ -352,7 +352,7 @@ def _validate_file_references(
 # ---------------------------------------------------------------------------
 
 def main() -> None:
-    """CLI: validate .ai-toolkit.json and print results."""
+    """CLI: validate .softspark-toolkit.json and print results."""
     if len(sys.argv) < 2:
         print("Usage: config_validator.py <config.json> [--strict]", file=sys.stderr)
         sys.exit(1)

package/scripts/dir_rules_shared.py

@@ -521,7 +521,7 @@ def build_language_rules(
 def build_registered_rules(
     rules_dir: Path | None,
 ) -> dict[str, callable]:
-    """Build entries from user's registered rules (~/.ai-toolkit/rules/*.md).
+    """Build entries from user's registered rules (~/.softspark/ai-toolkit/rules/*.md).
 
     Returns dict of filename -> callable (same shape as STANDARD_RULES).
     """

package/scripts/doctor.py

@@ -27,6 +27,7 @@ from pathlib import Path
 
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 from _common import toolkit_dir
+from paths import HOOKS_DIR as _HOOKS_DIR, RULES_DIR as _RULES_DIR
 
 
 # ---------------------------------------------------------------------------
@@ -34,8 +35,8 @@ from _common import toolkit_dir
 # ---------------------------------------------------------------------------
 
 CLAUDE_DIR = Path.home() / ".claude"
-HOOKS_DIR = Path.home() / ".ai-toolkit" / "hooks"
-RULES_DIR = Path.home() / ".ai-toolkit" / "rules"
+HOOKS_DIR = _HOOKS_DIR
+RULES_DIR = _RULES_DIR
 BENCHMARK_DASHBOARD = toolkit_dir / "benchmarks" / "ecosystem-dashboard.json"
 
 VALID_EVENTS = frozenset({

package/scripts/install.py

@@ -16,7 +16,7 @@ Other tools (global config locations):
   - Windsurf: ~/.codeium/windsurf/memories/global_rules.md
   - Gemini:   ~/.gemini/GEMINI.md
 
-Registered rules (~/.ai-toolkit/rules/*.md) are also injected into
+Registered rules (~/.softspark/ai-toolkit/rules/*.md) are also injected into
 all of the above. Add rules with: ai-toolkit add-rule <rule.md>
 
 Usage:
@@ -467,9 +467,9 @@ def resolve_extends_config(
     config_path: str = "",
     refresh: bool = False,
 ) -> dict | None:
-    """Resolve .ai-toolkit.json extends and return merged config.
+    """Resolve .softspark-toolkit.json extends and return merged config.
 
-    Returns None if no .ai-toolkit.json or no extends field.
+    Returns None if no .softspark-toolkit.json or no extends field.
     Prints warnings/errors and exits on fatal errors.
     """
     if config_path:
@@ -596,6 +596,10 @@ def main() -> None:
         print_status()
         sys.exit(0)
 
+    # Auto-migrate from legacy ~/.ai-toolkit if needed
+    from migrate import run_full_migration
+    run_full_migration(dry_run=cfg.get("dry_run", False))
+
     target_dir: Path = cfg["target_dir"]
     only: str = cfg["only"]
     skip: str = cfg["skip"]
@@ -618,8 +622,9 @@ def main() -> None:
         if not local:
             local = True  # language rules are project-local
 
-    rules_dir = Path.home() / ".ai-toolkit" / "rules"
-    hooks_scripts_dir = Path.home() / ".ai-toolkit" / "hooks"
+    from paths import RULES_DIR, HOOKS_DIR, TOOLKIT_DATA_DIR
+    rules_dir = RULES_DIR
+    hooks_scripts_dir = HOOKS_DIR
 
     # --local always implies --auto-detect (why install locally without language rules?)
     if local and not auto_detect and not modules_arg:
@@ -653,7 +658,7 @@ def main() -> None:
 
     if local:
         # --local: project-local only, no global install
-        # Check for .ai-toolkit.json extends system
+        # Check for .softspark-toolkit.json extends system
         config_path_arg: str = cfg["config"]
         refresh_base: bool = cfg["refresh_base"]
         merged_config = resolve_extends_config(
@@ -716,7 +721,7 @@ def main() -> None:
                 extends=extends_source,
             )
             if is_new:
-                print(f"  Registered project in ~/.ai-toolkit/projects.json")
+                print(f"  Registered project in {TOOLKIT_DATA_DIR / 'projects.json'}")
 
     print_summary(local=local)
 

package/scripts/install_git_hooks.py

@@ -30,7 +30,7 @@ if git diff --cached -S'<<<<<<<' --name-only | grep -q '.*'; then
 fi
 
 # 2. Call the global quality-check if it exists
-QUALITY_CHECK="$HOME/.ai-toolkit/hooks/quality-check.sh"
+QUALITY_CHECK="$HOME/.softspark/ai-toolkit/hooks/quality-check.sh"
 if [ -x "$QUALITY_CHECK" ]; then
     if ! "$QUALITY_CHECK"; then
         echo "ERROR: Linter or type checks failed."

package/scripts/install_steps/ai_tools.py

@@ -182,7 +182,7 @@ def install_local_project(rules_dir: Path, dry_run: bool, reset: bool,
     - ``--editors cursor,aider``: install only these
     - (empty): auto-detect from existing project files, install only those
 
-    If ``merged_config`` is provided (from .ai-toolkit.json extends resolution),
+    If ``merged_config`` is provided (from .softspark-toolkit.json extends resolution),
     additional rules and constitution amendments from the base config are injected.
     """
     cwd = Path.cwd()
@@ -192,7 +192,7 @@ def install_local_project(rules_dir: Path, dry_run: bool, reset: bool,
     print(f"## Project-local ({cwd})")
     if merged_config and merged_config.get("_extends_meta"):
         meta = merged_config["_extends_meta"]
-        print(f"   Config: .ai-toolkit.json (extends: {meta['source']})")
+        print(f"   Config: .softspark-toolkit.json (extends: {meta['source']})")
     if reset:
         print("   Mode: RESET (all local configs will be wiped and recreated)")
     if resolved_editors:
@@ -326,9 +326,9 @@ def _apply_extends_config(cwd: Path, merged: dict) -> None:
     # Record merged config summary
     meta = merged.get("_extends_meta")
     if meta:
-        state_file = cwd / ".ai-toolkit-extends.json"
+        state_file = cwd / ".softspark-toolkit-extends.json"
         state_file.write_text(_json.dumps(meta, indent=2) + "\n", encoding="utf-8")
-        print(f"  Saved: .ai-toolkit-extends.json (resolution metadata)")
+        print(f"  Saved: .softspark-toolkit-extends.json (resolution metadata)")
 
 
 def _inject_language_rules(cwd: Path, language_modules: list[str] | None) -> None:

package/scripts/install_steps/hooks.py

@@ -55,7 +55,7 @@ def _copy_hook_scripts(claude_dir: Path, hooks_scripts_dir: Path) -> None:
         shutil.copy2(hook_file, dst)
         dst.chmod(dst.stat().st_mode | 0o111)
         copied += 1
-    print(f"  Copied: {copied} hook scripts to ~/.ai-toolkit/hooks/")
+    print(f"  Copied: {copied} hook scripts to ~/.softspark/ai-toolkit/hooks/")
     legacy_hooks = claude_dir / "hooks"
     if legacy_hooks.is_symlink():
         legacy_hooks.unlink()

package/scripts/install_steps/install_state.py

@@ -1,20 +1,22 @@
-"""Track installed modules and versions in ~/.ai-toolkit/state.json."""
+"""Track installed modules and versions in ~/.softspark/ai-toolkit/state.json."""
 from __future__ import annotations
 
 import json
+import sys
 from datetime import datetime, timezone
 from pathlib import Path
 
-STATE_FILENAME = "state.json"
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+from paths import TOOLKIT_DATA_DIR, STATE_FILE
 
 
 def _state_path() -> Path:
     """Return the canonical path to state.json."""
-    return Path.home() / ".ai-toolkit" / STATE_FILENAME
+    return STATE_FILE
 
 
 def load_state() -> dict:
-    """Load state from ~/.ai-toolkit/state.json.
+    """Load state from ~/.softspark/ai-toolkit/state.json.
 
     Returns an empty dict if the file does not exist or is malformed.
     """
@@ -32,7 +34,7 @@ def load_state() -> dict:
 
 
 def save_state(state: dict) -> None:
-    """Save state to ~/.ai-toolkit/state.json.
+    """Save state to ~/.softspark/ai-toolkit/state.json.
 
     Creates the parent directory if it does not exist.
     """
@@ -113,7 +115,7 @@ def print_status() -> None:
     """Print a human-readable summary of the install state."""
     state = load_state()
     if not state:
-        print("No install state found (~/.ai-toolkit/state.json missing).")
+        print(f"No install state found ({STATE_FILE} missing).")
         print("Run 'ai-toolkit install' to set up the toolkit.")
         return
 

package/scripts/install_steps/project_registry.py

@@ -1,6 +1,6 @@
 """Project registry — tracks which directories have ai-toolkit installed locally.
 
-Stores registry in ~/.ai-toolkit/projects.json.
+Stores registry in ~/.softspark/ai-toolkit/projects.json.
 Used by `ai-toolkit update` to propagate updates to all registered projects,
 and by `ai-toolkit projects` to list/manage them.
 
@@ -9,18 +9,18 @@ Stdlib-only — no external dependencies.
 from __future__ import annotations
 
 import json
-import os
+import sys
 from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
-
-REGISTRY_FILENAME = "projects.json"
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+from paths import PROJECTS_FILE
 
 
 def _registry_path() -> Path:
     """Return the canonical path to projects.json."""
-    return Path(os.environ.get("AI_TOOLKIT_HOME", Path.home() / ".ai-toolkit")) / REGISTRY_FILENAME
+    return PROJECTS_FILE
 
 
 def _now_iso() -> str: