@softspark/ai-toolkit 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v1.9.0 — Project Registry & Doc Sync (2026-04-12)
+
+### Added
+- **Project registry** — `install --local` automatically registers project path in `~/.ai-toolkit/projects.json`. `ai-toolkit update` propagates updates to all registered projects in parallel via `ThreadPoolExecutor`
+- **`ai-toolkit projects`** — list registered projects, `--prune` to remove stale (deleted directories), `remove <path>` to unregister specific project
+- **Parallel update propagation** — `ai-toolkit update` (global) now auto-updates all registered local projects concurrently (max 8 workers)
+
+### Fixed
+- **README.md** — skill count 91→92 in comparison table, added Augment/Antigravity to cross-tool tables, fixed Notification hook description (inline→`notify-waiting.sh`)
+- **README.md** — added Config Inheritance section, Project Registry section, 6 new CLI commands to reference table
+- **ARCHITECTURE.md** — added Config Inheritance and Project Registry to Extension Points
+- **CLAUDE.md** — added `config` and `projects` commands
+
+---
+
 ## v1.8.0 — Enterprise Config Inheritance (2026-04-12)
 
 ### Added

package/README.md

@@ -6,7 +6,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Skills](https://img.shields.io/badge/skills-92-brightgreen)](app/skills/)
 [![Agents](https://img.shields.io/badge/agents-44-blue)](app/agents/)
-[![Tests](https://img.shields.io/badge/tests-564%20passing-success)](tests/)
+[![Tests](https://img.shields.io/badge/tests-575%20passing-success)](tests/)
 
 ---
 
@@ -318,7 +318,7 @@ Hook logic lives in `app/hooks/*.sh` — not inline JSON one-liners. Scripts are
 | SessionStart | `session-start.sh` | MANDATORY rules reminder + session context + instincts |
 | SessionStart | `mcp-health.sh` | Check MCP server command availability (non-blocking warning) |
 | SessionStart | `session-context.sh` | Capture environment snapshot (pwd, git branch, versions) to `~/.ai-toolkit/sessions/current-context.json` |
-| Notification | *(inline)* | macOS desktop notification |
+| Notification | `notify-waiting.sh` | Cross-platform desktop notification |
 | PreToolUse | `guard-destructive.sh` | Block `rm -rf`, `DROP TABLE`, etc. |
 | PreToolUse | `guard-path.sh` | Block wrong-user path hallucination |
 | PreToolUse | `guard-config.sh` | Block edits to linter/formatter config files unless explicitly requested |
@@ -612,18 +612,62 @@ All packs have `status: experimental`. Each has a `plugin.json` manifest and `RE
 
 ---
 
+## Config Inheritance (`extends`)
+
+Enterprise-grade configuration inheritance for multi-repo AI governance. Organizations define a shared base config published as an npm package, Git URL, or local path. Projects inherit via `.ai-toolkit.json`:
+
+```json
+{
+  "extends": "@mycompany/ai-toolkit-config",
+  "profile": "standard"
+}
+```
+
+**Key capabilities:**
+- **Layered merge** — base config + project overrides, with deep merge for dicts, union for lists, project-wins for scalars
+- **Constitution immutability** — Articles I-V and base articles cannot be modified; projects can only ADD new articles (6+)
+- **Enforce constraints** — `requiredAgents`, `forbidOverride`, `minHookProfile`, `requiredPlugins`
+- **Override validation** — requires explicit `override: true` + justification (min 20 chars)
+- **Lock file** — `.ai-toolkit.lock.json` pins resolved versions for reproducible installs
+- **Offline fallback** — uses cached configs from `~/.ai-toolkit/config-cache/` when registry unavailable
+
+```bash
+ai-toolkit config create-base @mycompany/ai-toolkit-config  # scaffold base package
+ai-toolkit config init --extends @mycompany/ai-toolkit-config # setup project
+ai-toolkit config validate    # schema + extends + enforcement
+ai-toolkit config diff        # project vs base differences
+ai-toolkit config check       # CI enforcement gate (exit 0/1/2, --json)
+```
+
+See [Enterprise Config Guide](kb/reference/enterprise-config-guide.md) for full documentation.
+
+---
+
+## Project Registry
+
+All projects installed with `--local` are automatically registered in `~/.ai-toolkit/projects.json`. Running `ai-toolkit update` propagates updates to all registered projects in parallel.
+
+```bash
+ai-toolkit projects              # list registered projects
+ai-toolkit projects --prune      # remove stale (deleted) entries
+ai-toolkit projects remove /path # unregister specific project
+ai-toolkit update                # global update + parallel update ALL projects
+```
+
+---
+
 ## Comparison
 
 | Feature | ai-toolkit | everything-claude-code | wshobson/agents | ruflo |
 |---------|---------------|----------------------|-----------------|-------|
-| Skills | 91 | 100+ | 146 | 20+ |
+| Skills | 92 | 100+ | 146 | 20+ |
 | Agents | 44 | 30+ | 112 | 20+ |
 | Machine-enforced constitution | **Yes** | No (docs only) | No | No |
 | Skill-scoped lifecycle hooks | **Yes** | No | No | No |
 | Effort-based model budgeting | **Yes** | No | No | No |
 | Test suite | Yes (bats) | Yes (997 tests) | No | Yes |
 | npm/npx install | Yes | Yes | Yes | Yes |
-| Cross-tool support | **Cursor, Windsurf, Copilot, Gemini, Cline, Roo, Aider, Codex** | 5+ tools | Smithery | Limited |
+| Cross-tool support | **Cursor, Windsurf, Copilot, Gemini, Cline, Roo, Aider, Augment, Antigravity** | 5+ tools | Smithery | Limited |
 | Selective install | Yes | Yes | Yes (72 plugins) | No |
 | Session persistence | Yes | Yes | No | No |
 | Architecture notes | **Yes** | No | No | No |
@@ -662,6 +706,8 @@ Pre-configured team presets via `/teams`:
 | Cline | `.clinerules` | project |
 | Roo Code | `.roomodes` | project |
 | Aider | `.aider.conf.yml` | project |
+| Augment | `.augment/rules/ai-toolkit-*.md` | project |
+| Google Antigravity | `.agent/rules/` + `.agent/workflows/` | project |
 | Codex / OpenCode | `AGENTS.md` | project |
 
 ```bash
@@ -764,8 +810,14 @@ Usage: ai-toolkit <command> [options]
 | `mcp add <name> [names...]` | Add MCP server template(s) to `.mcp.json` |
 | `mcp show <name>` | Show MCP template config details |
 | `mcp remove <name>` | Remove MCP server from `.mcp.json` |
+| `config validate [path]` | Validate `.ai-toolkit.json` schema + extends + enforcement |
+| `config diff [path]` | Show project vs base config differences |
+| `config init [flags]` | Create `.ai-toolkit.json` (`--extends`, `--profile`, `--no-extends`) |
+| `config create-base <name>` | Scaffold base config npm package |
+| `config check [path]` | CI enforcement gate (exit 0=pass, 1=fail, 2=no config; `--json`) |
+| `projects` | List registered projects (`--prune` to clean stale, `remove <path>`) |
 | `status` | Show installed modules and version |
-| `update` | Re-install with saved modules (incremental) |
+| `update` | Re-install with saved modules + update all registered projects |
 | `validate` | Verify toolkit integrity (`--strict` for CI-grade, warnings = errors) |
 | `doctor` | Diagnose install health, hooks, quick-win assets, and artifact drift |
 | `doctor --fix` | Auto-repair broken symlinks, missing hooks, stale artifacts |

package/app/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-toolkit",
   "description": "Professional-grade Claude Code toolkit with persona presets, skill security auditor, expanded lifecycle hooks, experimental opt-in plugin packs, benchmark harvesting, and multi-tool support.",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "author": {
     "name": "SoftSpark",
     "url": "https://github.com/softspark"

package/app/ARCHITECTURE.md

@@ -315,6 +315,12 @@ The `inject_section_cli.py` script provides a stable marker-based injection API.
 ### SLM Compilation (`compile-slm`)
 `scripts/compile_slm.py` compiles the full toolkit (20K+ tokens) into a minimal system prompt for Small Language Models (2K-16K tokens). Pipeline: Parse → Score → Compress → Pack → Emit. Supports 4 compression levels (ultra-light, light, standard, extended), 4 output formats (raw, ollama, json-string, aider), persona-aware scoring, and language-aware rule filtering. Profile `offline-slm` in `manifest.json`. Constitution is always included (non-negotiable).
 
+### Config Inheritance (`extends`)
+`scripts/config_resolver.py`, `config_merger.py`, `config_validator.py`, `config_cli.py`, `config_scaffold.py`, `config_lock.py`. Enterprise configuration inheritance via `.ai-toolkit.json` `extends` field. Resolves base configs from npm packages, Git URLs, or local paths. Layered deep merge with constitution immutability (Articles I-V absolute), enforce constraints (`requiredAgents`, `forbidOverride`, `minHookProfile`), override validation (`override: true` + justification), and lock file (`.ai-toolkit.lock.json`). CLI: `config validate`, `config diff`, `config init`, `config create-base`, `config check`. Integrated into `install --local` and `update --local` flows.
+
+### Project Registry
+`scripts/install_steps/project_registry.py`, `scripts/update_projects.py`, `scripts/projects_cli.py`. Tracks all `--local` installed projects in `~/.ai-toolkit/projects.json`. `ai-toolkit update` propagates to all registered projects in parallel via `ThreadPoolExecutor`. CLI: `ai-toolkit projects`, `--prune`, `remove <path>`.
+
 ### Manifest Install (`--modules`, `--auto-detect`)
 `manifest.json` defines all installable components as named modules. Install individual modules with `ai-toolkit install --modules <name>` or let the installer detect which language rules to add based on project files (e.g. `package.json` → `rules-typescript`, `go.mod` → `rules-golang`).
 

package/bin/ai-toolkit.js

@@ -76,6 +76,7 @@ const COMMANDS = {
   create: 'Scaffold new skill from template (e.g. create skill my-lint --template=linter)',
   mcp: 'Manage MCP server templates (list, show, add, remove)',
   config: 'Manage config inheritance (validate, diff, init, create-base, check)',
+  projects: 'List and manage registered projects (--prune, remove <path>)',
   plugin: 'Manage plugin packs (install, remove, update, clean, list, status)',
   sync: 'Sync config to/from GitHub Gist (--export, --push, --pull, --import)',
   'cursor-rules': 'Generate .cursorrules for Cursor IDE (legacy)',
@@ -425,6 +426,7 @@ function handleStatus(_args) {
  * @param {string[]} args
  */
 function handleUpdate(args) {
+  const isLocal = args.includes('--local');
   const statePath = path.join(process.env.HOME, '.ai-toolkit', 'state.json');
   let stateArgs = [];
 
@@ -447,6 +449,27 @@ function handleUpdate(args) {
 
   // User-provided args override state-derived args
   run(scriptPath('install.py'), [...stateArgs, ...args]);
+
+  // After global update (not --local), propagate to all registered projects
+  if (!isLocal) {
+    const registryPath = path.join(process.env.HOME, '.ai-toolkit', 'projects.json');
+    if (fs.existsSync(registryPath)) {
+      try {
+        const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
+        const projects = registry.projects || [];
+        if (projects.length > 0) {
+          console.log('');
+          console.log('## Updating registered projects');
+          console.log('');
+          // Pass through --skip, --refresh-base flags to project updates
+          const passthrough = args.filter(a => a.startsWith('--skip') || a === '--refresh-base');
+          run(scriptPath('update_projects.py'), passthrough);
+        }
+      } catch (_err) {
+        // Registry corrupt -- skip project updates
+      }
+    }
+  }
 }
 
 /** @type {Record<string, (args: string[]) => void>} */
@@ -459,6 +482,7 @@ const SPECIAL_HANDLERS = {
   'sync':         handleSync,
   'mcp':          handleMcp,
   'config':       handleConfig,
+  'projects':     (args) => run(scriptPath('projects_cli.py'), args),
   'plugin':       (args) => run(scriptPath('plugin.py'), args),
   'remove-rule':  handleRemoveRule,
   'add-rule':     handleAddRule,

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.0",
+  "version": "1.9.0",
   "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.8.0",
+  "version": "1.9.0",
   "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/install.py

@@ -57,6 +57,7 @@ from install_steps.install_state import (
     print_status,
 )
 from install_steps.detect_language import detect_languages
+from install_steps.project_registry import register_project
 
 # Config inheritance (extends system)
 from config_resolver import (
@@ -704,6 +705,19 @@ def main() -> None:
             extends_info=extends_info,
         )
 
+        # Register project in global registry (for `ai-toolkit update` propagation)
+        if local:
+            extends_source = ""
+            if extends_info:
+                extends_source = extends_info.get("source", "")
+            is_new = register_project(
+                project_dir,
+                profile=profile or "standard",
+                extends=extends_source,
+            )
+            if is_new:
+                print(f"  Registered project in ~/.ai-toolkit/projects.json")
+
     print_summary(local=local)
 
 

package/scripts/install_steps/project_registry.py

@@ -0,0 +1,142 @@
+"""Project registry — tracks which directories have ai-toolkit installed locally.
+
+Stores registry in ~/.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.
+
+Stdlib-only — no external dependencies.
+"""
+from __future__ import annotations
+
+import json
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+
+REGISTRY_FILENAME = "projects.json"
+
+
+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
+
+
+def _now_iso() -> str:
+    return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+# ---------------------------------------------------------------------------
+# Load / Save
+# ---------------------------------------------------------------------------
+
+def load_registry() -> list[dict[str, Any]]:
+    """Load project registry. Returns empty list if missing/corrupt."""
+    path = _registry_path()
+    if not path.is_file():
+        return []
+    try:
+        with open(path, encoding="utf-8") as f:
+            data = json.load(f)
+        if isinstance(data, dict):
+            projects = data.get("projects", [])
+            return projects if isinstance(projects, list) else []
+        return []
+    except (json.JSONDecodeError, OSError):
+        return []
+
+
+def save_registry(projects: list[dict[str, Any]]) -> None:
+    """Save project registry."""
+    path = _registry_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    with open(path, "w", encoding="utf-8") as f:
+        json.dump({"projects": projects}, f, indent=2)
+        f.write("\n")
+
+
+# ---------------------------------------------------------------------------
+# CRUD
+# ---------------------------------------------------------------------------
+
+def register_project(
+    project_path: str | Path,
+    profile: str = "",
+    extends: str = "",
+) -> bool:
+    """Register a project directory. Returns True if newly added, False if updated.
+
+    Idempotent — updates existing entry if path already registered.
+    """
+    project_path = str(Path(project_path).resolve())
+    projects = load_registry()
+    now = _now_iso()
+
+    for p in projects:
+        if p.get("path") == project_path:
+            # Update existing
+            p["last_updated"] = now
+            if profile:
+                p["profile"] = profile
+            if extends:
+                p["extends"] = extends
+            elif "extends" in p and not extends:
+                # Clear extends if project no longer uses it
+                pass
+            save_registry(projects)
+            return False
+
+    # New registration
+    projects.append({
+        "path": project_path,
+        "registered_at": now,
+        "last_updated": now,
+        "profile": profile or "standard",
+        "extends": extends or "",
+    })
+    save_registry(projects)
+    return True
+
+
+def unregister_project(project_path: str | Path) -> bool:
+    """Unregister a project. Returns True if found and removed."""
+    project_path = str(Path(project_path).resolve())
+    projects = load_registry()
+    original_len = len(projects)
+    projects = [p for p in projects if p.get("path") != project_path]
+    if len(projects) < original_len:
+        save_registry(projects)
+        return True
+    return False
+
+
+def list_projects() -> list[dict[str, Any]]:
+    """List all registered projects with existence status."""
+    projects = load_registry()
+    for p in projects:
+        p["exists"] = Path(p["path"]).is_dir()
+    return projects
+
+
+def prune_stale() -> list[str]:
+    """Remove projects whose directories no longer exist. Returns pruned paths."""
+    projects = load_registry()
+    pruned: list[str] = []
+    kept: list[dict[str, Any]] = []
+
+    for p in projects:
+        if Path(p["path"]).is_dir():
+            kept.append(p)
+        else:
+            pruned.append(p["path"])
+
+    if pruned:
+        save_registry(kept)
+
+    return pruned
+
+
+def get_active_projects() -> list[dict[str, Any]]:
+    """Get registered projects that still exist on disk."""
+    return [p for p in load_registry() if Path(p["path"]).is_dir()]

package/scripts/projects_cli.py

@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""CLI for managing the ai-toolkit project registry.
+
+Usage:
+    ai-toolkit projects                — List all registered projects
+    ai-toolkit projects --prune        — Remove stale (deleted) projects
+    ai-toolkit projects remove <path>  — Unregister a specific project
+
+Stdlib-only — no external dependencies.
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+from install_steps.project_registry import (
+    list_projects,
+    prune_stale,
+    unregister_project,
+)
+
+
+def main() -> None:
+    args = sys.argv[1:]
+
+    if not args or args == []:
+        cmd_list()
+    elif args[0] == "--prune":
+        cmd_prune()
+    elif args[0] == "remove" and len(args) >= 2:
+        cmd_remove(args[1])
+    elif args[0] in ("--help", "-h", "help"):
+        cmd_help()
+    else:
+        print(f"Unknown: {' '.join(args)}", file=sys.stderr)
+        cmd_help()
+        sys.exit(1)
+
+
+def cmd_list() -> None:
+    """List all registered projects."""
+    projects = list_projects()
+
+    if not projects:
+        print("  No registered projects.")
+        print("  Run 'ai-toolkit install --local' in a project to register it.")
+        return
+
+    print(f"  Registered projects ({len(projects)}):")
+    print()
+
+    for p in projects:
+        path_short = p["path"].replace(str(Path.home()), "~")
+        status = "✓" if p["exists"] else "✗ MISSING"
+        profile = p.get("profile", "")
+        extends = p.get("extends", "")
+        updated = p.get("last_updated", "")
+
+        print(f"  {status}  {path_short}")
+        details = []
+        if profile:
+            details.append(f"profile: {profile}")
+        if extends:
+            details.append(f"extends: {extends}")
+        if updated:
+            details.append(f"updated: {updated}")
+        if details:
+            print(f"        {' | '.join(details)}")
+
+    stale = [p for p in projects if not p["exists"]]
+    if stale:
+        print()
+        print(f"  {len(stale)} stale project(s). Run 'ai-toolkit projects --prune' to clean up.")
+
+
+def cmd_prune() -> None:
+    """Remove stale projects."""
+    pruned = prune_stale()
+    if pruned:
+        for p in pruned:
+            path_short = p.replace(str(Path.home()), "~")
+            print(f"  Pruned: {path_short}")
+        print(f"  Removed {len(pruned)} stale project(s).")
+    else:
+        print("  No stale projects found.")
+
+
+def cmd_remove(project_path: str) -> None:
+    """Unregister a specific project."""
+    resolved = Path(project_path).resolve()
+    if unregister_project(resolved):
+        path_short = str(resolved).replace(str(Path.home()), "~")
+        print(f"  Removed: {path_short}")
+    else:
+        print(f"  Not found in registry: {project_path}")
+        sys.exit(1)
+
+
+def cmd_help() -> None:
+    print("Usage: ai-toolkit projects [command]")
+    print()
+    print("Commands:")
+    print("  (none)          List all registered projects")
+    print("  --prune         Remove projects whose directories no longer exist")
+    print("  remove <path>   Unregister a specific project")
+
+
+if __name__ == "__main__":
+    main()

package/scripts/update_projects.py

@@ -0,0 +1,141 @@
+#!/usr/bin/env python3
+"""Update all registered projects in parallel.
+
+Reads ~/.ai-toolkit/projects.json and runs install.py --local in each
+project directory concurrently using a thread pool.
+
+Stdlib-only — no external dependencies.
+"""
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from pathlib import Path
+from typing import Any
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+from install_steps.project_registry import get_active_projects, prune_stale
+
+
+def _update_project(project: dict[str, Any], install_script: str, extra_args: list[str]) -> dict:
+    """Run install --local in a single project. Returns result dict."""
+    project_path = project["path"]
+    start = time.monotonic()
+
+    try:
+        proc = subprocess.run(
+            ["python3", install_script, "--local"] + extra_args,
+            cwd=project_path,
+            capture_output=True,
+            text=True,
+            timeout=120,
+        )
+        elapsed = time.monotonic() - start
+        return {
+            "path": project_path,
+            "profile": project.get("profile", ""),
+            "extends": project.get("extends", ""),
+            "success": proc.returncode == 0,
+            "elapsed": round(elapsed, 1),
+            "output": proc.stdout,
+            "error": proc.stderr if proc.returncode != 0 else "",
+        }
+    except subprocess.TimeoutExpired:
+        return {
+            "path": project_path,
+            "success": False,
+            "elapsed": 120.0,
+            "output": "",
+            "error": "Timed out after 120s",
+        }
+    except OSError as e:
+        return {
+            "path": project_path,
+            "success": False,
+            "elapsed": 0,
+            "output": "",
+            "error": str(e),
+        }
+
+
+def main() -> None:
+    """Update all registered projects."""
+    # Parse args
+    verbose = "--verbose" in sys.argv or "-v" in sys.argv
+    json_output = "--json" in sys.argv
+    extra_args = [a for a in sys.argv[1:] if a not in ("--verbose", "-v", "--json")]
+
+    # Prune stale projects first
+    pruned = prune_stale()
+    if pruned and not json_output:
+        for p in pruned:
+            print(f"  Pruned stale project: {p}")
+
+    # Get active projects
+    projects = get_active_projects()
+
+    if not projects:
+        if json_output:
+            print(json.dumps({"projects": [], "summary": "No registered projects"}))
+        else:
+            print("  No registered projects.")
+            print("  Run 'ai-toolkit install --local' in a project to register it.")
+        sys.exit(0)
+
+    install_script = str(Path(__file__).resolve().parent / "install.py")
+
+    if not json_output:
+        print(f"  Updating {len(projects)} registered project(s)...")
+        print()
+
+    # Run in parallel (max 8 workers — don't overwhelm the system)
+    max_workers = min(len(projects), 8)
+    results: list[dict] = []
+
+    with ThreadPoolExecutor(max_workers=max_workers) as pool:
+        futures = {
+            pool.submit(_update_project, p, install_script, extra_args): p
+            for p in projects
+        }
+        for future in as_completed(futures):
+            result = future.result()
+            results.append(result)
+
+            if not json_output:
+                status = "✓" if result["success"] else "✗"
+                path_short = result["path"].replace(str(Path.home()), "~")
+                extends_info = f" (extends: {result.get('extends', '')})" if result.get("extends") else ""
+                print(f"  {status} {path_short}{extends_info} ({result['elapsed']}s)")
+
+                if verbose and result["output"]:
+                    for line in result["output"].strip().split("\n"):
+                        print(f"      {line}")
+
+                if result.get("error"):
+                    for line in result["error"].strip().split("\n"):
+                        print(f"      ERROR: {line}")
+
+    # Summary
+    passed = sum(1 for r in results if r["success"])
+    failed = len(results) - passed
+
+    if json_output:
+        print(json.dumps({
+            "projects": results,
+            "total": len(results),
+            "passed": passed,
+            "failed": failed,
+        }, indent=2))
+    else:
+        print()
+        print(f"  Updated: {passed}/{len(results)} projects" +
+              (f" ({failed} failed)" if failed else ""))
+
+    sys.exit(1 if failed else 0)
+
+
+if __name__ == "__main__":
+    main()