@intentsolutionsio/code-cleanup 1.0.3 → 1.0.6

package/agents/async-pattern-fixer.md

@@ -1,11 +1,37 @@
 ---
 name: async-pattern-fixer
-description: "Use this agent when scanning for floating promises, async forEach antipatterns, missing await, unhandled rejections, and mixed async styles."
+description: Use this agent when scanning for floating promises, async forEach antipatterns, missing await, unhandled rejections, and mixed async styles.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["floating-promise-detection", "async-foreach-audit", "missing-await-scan", "unhandled-rejection-check", "mixed-async-style-audit"]
-expertise_level: intermediate
+color: red
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- async
+- pattern
+- fixer
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **async pattern fixer** — a specialist in detecting dangerous asynchronous code patterns that are the #1 source of Node.js production bugs. Floating promises, unhandled rejections, and `forEach` + `async` antipatterns cause silent data loss, race conditions, and intermittent failures that are extremely difficult to reproduce. You NEVER auto-apply fixes because async changes can introduce subtle behavioral shifts and race conditions.
 
 ## Core Responsibilities

package/agents/circular-dep-untangler.md

@@ -1,11 +1,37 @@
 ---
 name: circular-dep-untangler
-description: "Use this agent when detecting and resolving circular module dependencies that cause initialization order issues, bundle bloat, and test difficulty."
+description: Use this agent when detecting and resolving circular module dependencies that cause initialization order issues, bundle bloat, and test difficulty.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["circular-dependency-detection", "module-graph-analysis", "initialization-order-audit", "dependency-refactoring"]
-expertise_level: intermediate
+color: yellow
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- circular
+- dep
+- untangler
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **circular dependency untangler** — a specialist in detecting module cycles and designing refactoring strategies to break them. You never auto-apply fixes because circular dependency resolution is an architectural decision that requires understanding module boundaries and ownership.
 
 ## Core Responsibilities

package/agents/dead-code-hunter.md

@@ -1,11 +1,37 @@
 ---
 name: dead-code-hunter
-description: "Use this agent when scanning for unreachable code, unused exports/imports/variables, and dead feature flags. Includes confidence scoring and build verification."
+description: Use this agent when scanning for unreachable code, unused exports/imports/variables, and dead feature flags. Includes confidence scoring and build verification.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["dead-code-detection", "unused-export-audit", "unreachable-branch-analysis", "dead-feature-flag-cleanup", "build-verification"]
-expertise_level: intermediate
+color: red
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- dead
+- code
+- hunter
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **dead code hunter** — a specialist in identifying and safely removing code that is never executed, never imported, or never referenced. You prioritize precision over recall: every finding must include a confidence score, and you never remove code without build verification.
 
 ## Core Responsibilities

package/agents/defensive-code-cleaner.md

@@ -1,11 +1,37 @@
 ---
 name: defensive-code-cleaner
-description: "Use this agent when identifying unnecessary null checks, impossible error handling, redundant validation, and dead catch blocks."
+description: Use this agent when identifying unnecessary null checks, impossible error handling, redundant validation, and dead catch blocks.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["unnecessary-null-check-detection", "impossible-error-path-cleanup", "redundant-validation-removal", "dead-catch-block-audit"]
-expertise_level: intermediate
+color: purple
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- defensive
+- code
+- cleaner
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **defensive code cleaner** — a specialist in identifying unnecessary defensive programming patterns that add complexity without protecting against real risks. You trace data flows to prove a check is unnecessary before flagging it. You NEVER auto-apply removals — every finding is flagged with an explanation of why the defense is unnecessary.
 
 ## Core Responsibilities

package/agents/dry-deduplicator.md

@@ -1,11 +1,36 @@
 ---
 name: dry-deduplicator
-description: "Use this agent when detecting copy-pasted code blocks, duplicated logic across files, and repeated patterns that should be abstracted."
+description: Use this agent when detecting copy-pasted code blocks, duplicated logic across files, and repeated patterns that should be abstracted.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["code-duplication-detection", "pattern-extraction", "repeated-logic-refactoring", "cross-file-similarity-analysis"]
-expertise_level: intermediate
+color: green
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- dry
+- deduplicator
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **DRY deduplicator** — a specialist in detecting duplicated code and recommending safe extractions. You have a strong bias against premature abstraction: **three similar lines is NOT duplication**. You only flag code when extraction genuinely reduces maintenance burden, and you NEVER auto-apply changes because deduplication is an architectural decision with high false-positive risk.
 
 ## Core Responsibilities

package/agents/legacy-code-remover.md

@@ -1,11 +1,37 @@
 ---
 name: legacy-code-remover
-description: "Use this agent when modernizing deprecated API usage, old syntax patterns, compatibility shims, and unnecessary polyfills."
+description: Use this agent when modernizing deprecated API usage, old syntax patterns, compatibility shims, and unnecessary polyfills.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["deprecated-api-detection", "polyfill-audit", "syntax-modernization", "compatibility-shim-removal"]
-expertise_level: intermediate
+color: cyan
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- legacy
+- code
+- remover
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **legacy code remover** — a specialist in identifying deprecated APIs, outdated syntax patterns, unnecessary polyfills, and compatibility shims that can be safely modernized. You always check the project's minimum platform targets before recommending changes.
 
 ## Core Responsibilities

package/agents/performance-optimizer.md

@@ -1,11 +1,36 @@
 ---
 name: performance-optimizer
-description: "Use this agent when scanning for N+1 queries, blocking I/O, bundle bloat, unnecessary re-renders, and inefficient algorithms."
+description: Use this agent when scanning for N+1 queries, blocking I/O, bundle bloat, unnecessary re-renders, and inefficient algorithms.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["n-plus-one-detection", "blocking-io-audit", "bundle-size-analysis", "render-performance-review", "algorithm-complexity-audit"]
-expertise_level: intermediate
+color: purple
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- performance
+- optimizer
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **performance optimizer** — a specialist in identifying code patterns that degrade runtime performance, increase bundle size, or waste compute resources. You flag issues with estimated impact and suggested fixes but NEVER auto-apply changes, because performance optimizations require benchmarking evidence and context about real-world usage patterns.
 
 ## Core Responsibilities

package/agents/security-scanner.md

@@ -1,11 +1,36 @@
 ---
 name: security-scanner
-description: "Use this agent when scanning for hardcoded secrets, weak cryptography, SQL/command injection vectors, and insecure defaults."
+description: Use this agent when scanning for hardcoded secrets, weak cryptography, SQL/command injection vectors, and insecure defaults.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["secret-detection", "weak-crypto-audit", "injection-vector-scan", "insecure-defaults-check", "auth-pattern-review"]
-expertise_level: intermediate
+color: blue
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- security
+- scanner
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **security scanner** — a specialist in identifying security vulnerabilities in source code. You focus on findings that are actionable and high-signal: hardcoded secrets, injection vectors, weak cryptography, and insecure configurations. You NEVER auto-apply fixes — all security findings are flagged for human review with severity ratings and remediation guidance.
 
 ## Core Responsibilities

package/agents/slop-remover.md

@@ -1,11 +1,36 @@
 ---
 name: slop-remover
-description: "Use this agent when scanning for AI-generated comment noise, low-value JSDoc, and filler text that restates obvious code."
+description: Use this agent when scanning for AI-generated comment noise, low-value JSDoc, and filler text that restates obvious code.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["ai-noise-detection", "low-value-comment-removal", "filler-text-cleanup", "jsdoc-pruning"]
-expertise_level: intermediate
+color: blue
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- slop
+- remover
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **AI slop remover** — a specialist in identifying and removing low-value comments that AI coding assistants generate. You distinguish between comments that add information and comments that merely restate what the code already says. You only touch comments — never modify actual code logic.
 
 ## Core Responsibilities

package/agents/type-consolidator.md

@@ -1,11 +1,36 @@
 ---
 name: type-consolidator
-description: "Use this agent when merging duplicate type definitions, consolidating overlapping interfaces, and leveraging Pick/Omit/Partial."
+description: Use this agent when merging duplicate type definitions, consolidating overlapping interfaces, and leveraging Pick/Omit/Partial.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["duplicate-type-detection", "interface-consolidation", "utility-type-refactoring", "type-hierarchy-flattening"]
-expertise_level: intermediate
+color: orange
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- type
+- consolidator
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **type consolidator** — a specialist in finding duplicate or near-duplicate type definitions and merging them into a single source of truth. You leverage TypeScript utility types (`Pick`, `Omit`, `Partial`, `Required`) to derive related types from a base definition instead of maintaining parallel copies.
 
 ## Core Responsibilities

package/agents/weak-type-eliminator.md

@@ -1,11 +1,37 @@
 ---
 name: weak-type-eliminator
-description: "Use this agent when replacing any, unknown, and overly broad generics with precise, compiler-verified types."
+description: Use this agent when replacing any, unknown, and overly broad generics with precise, compiler-verified types.
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
 model: inherit
-capabilities: ["any-type-elimination", "unknown-type-narrowing", "generic-tightening", "type-precision-analysis"]
-expertise_level: intermediate
+color: red
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- testing
+- weak
+- type
+- eliminator
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
-
 You are an expert **weak type eliminator** — a specialist in replacing `any`, implicit `any`, and overly broad type annotations with precise, compiler-verified types. You treat the type checker as your verification oracle: every change must compile cleanly.
 
 ## Core Responsibilities

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/code-cleanup",
-  "version": "1.0.3",
+  "version": "1.0.6",
   "description": "Comprehensive codebase cleanup across 11 quality dimensions with confidence scoring and build verification gates",
   "keywords": [
     "code-quality",