@ivannikov-pro/ai-context-surgeon 1.0.0 → 1.0.2

package/README.md

@@ -271,7 +271,8 @@ npx @ivannikov-pro/ai-context-surgeon@latest # → interactive menu
 
 Or use pre-built agent workflows (defined in `.agents/workflows/`):
 - `/analyze-repo` — Quick analysis using Scout + tools
-- `/full-pipeline` — Complete 5-phase cascade
+- `/apply-surgeon` — Step-by-step execution pipeline to overhaul the current codebase
+- `/full-pipeline` — Complete 5-phase cascade guide
 - `/self-check` — Validate ai-context-surgeon's own integrity
 
 ---

package/bin/cli.js

@@ -202,38 +202,40 @@ program
 // ─── Tier 3: Tool Execution ────────────────────────────────────────
 
 program
-  .command("radar")
+  .command("radar [targetDir]")
   .description("Run Radar Scan — generate semantic FNH map of the repository")
-  .option("-d, --depth <level>", "Limit scan depth (e.g. 1, 2, all)")
+  .option("-d, --depth <level>", "Limit scan depth (e.g. 1, 2, all)", "all")
   .option("--no-legend", "Output pure text map without format legend")
-  .action(async (options) => {
-    const args = ["."];
+  .action(async (targetDir, options) => {
+    const dir = targetDir || ".";
+    const args = [dir];
     if (options.depth) args.push(`--depth=${options.depth}`);
     if (!options.legend) args.push("--no-legend");
     await runScript("tools/scan-fnh.sh", args);
   });
 
 program
-  .command("godfiles")
+  .command("godfiles [targetDir]")
   .description("Find excessively large files (detect-god-files.sh)")
-  .action(async () => await runScript("tools/detect-god-files.sh", ["."]));
+  .action(async (targetDir) => await runScript("tools/detect-god-files.sh", [targetDir || "."]));
 
 program
-  .command("circular")
+  .command("circular [targetDir]")
   .description("Detect circular dependencies")
-  .action(async () => await runScript("tools/detect-circular-deps.sh", ["."]));
+  .action(async (targetDir) => await runScript("tools/detect-circular-deps.sh", [targetDir || "."]));
 
 program
-  .command("sourcemaps")
+  .command("sourcemaps [targetDir]")
   .description("Generate AI-friendly source maps")
-  .action(async () => await runScript("tools/generate-source-map.sh", ["."]));
+  .action(async (targetDir) => await runScript("tools/generate-source-map.sh", [targetDir || "."]));
 
 program
-  .command("context-weight")
+  .command("context-weight [targetDir]")
   .description("Identify files with high Context Weight (LOC + import penalties)")
   .option("--internal-scope <scopes>", "Treat these scopes as local imports (comma-separated)")
-  .action(async (options) => {
-    const args = ["."];
+  .action(async (targetDir, options) => {
+    const dir = targetDir || ".";
+    const args = [dir];
     if (options.internalScope) args.push(`--internal-scope=${options.internalScope}`);
     await runScript("tools/validate-context-weight.sh", args);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ivannikov-pro/ai-context-surgeon",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "AI-native Knowledge API for surgical monorepo restructuring — roles, strategies, prompts, and analysis tools accessible on-demand",
   "files": [
     "bin",

package/templates/AGENTS.md.template

@@ -103,6 +103,10 @@ MANDATORY RULE: Agents MUST respect and maintain the `.antigravityignore` file t
 This repository is optimized with [ai-context-surgeon](https://github.com/ivannikov-pro/ai-context-surgeon).
 All tools, roles, strategies, and prompts are available on-demand — no file install needed.
 
+**MANDATORY TOOL DIRECTIVES FOR AI AGENTS:**
+1. **First step:** ALWAYS run `npx -y @ivannikov-pro/ai-context-surgeon@latest radar` to get a semantic map of the repo before any action.
+2. **Before architectural changes:** Run `npx @ivannikov-pro/ai-context-surgeon@latest godfiles` and `circular` checks.
+
 ### Quick Reference for AI Agents
 
 ```bash

package/tools/check-fnh-freshness.sh

@@ -8,6 +8,11 @@ set -euo pipefail
 
 source "$(dirname "$0")/shared/config.sh"
 
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  echo "⚠️  Warning: Not a Git repository. FNH freshness checks require Git history. Skipping."
+  exit 0
+fi
+
 BASE_REF="${1:-HEAD~1}"
 WARN_COUNT=0
 CHECKED=0

package/tools/scan-fnh.sh

@@ -98,7 +98,7 @@ else
   if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
     FILES=$(git ls-files | grep -E "$EXT_REGEX" | grep -vE '(package-lock\.json|yarn\.lock|pnpm-lock\.yaml)' || true)
   else
-    FILES=$(find . -type f | sed 's|^\./||' | grep -E "$EXT_REGEX" | grep -v 'node_modules/' | grep -v 'dist/' | grep -v '\.git/' | grep -vE '(package-lock\.json|yarn\.lock|pnpm-lock\.yaml)' || true)
+    FILES=$(find . -type d \( -name node_modules -o -name dist -o -name .git -o -name coverage \) -prune -o -type f -print 2>/dev/null | sed 's|^\./||' | grep -E "$EXT_REGEX" | grep -vE '(package-lock\.json|yarn\.lock|pnpm-lock\.yaml)' || true)
   fi
 
   if [[ "$DEPTH" != "all" && "$DEPTH" =~ ^[0-9]+$ ]]; then