anti-slop-engineering 1.4.0 → 1.5.0

package/.skills.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://skills.sh/schema.json",
   "name": "anti-slop-engineering",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "An Engineering Discipline Playbook & Guard System for AI Coding Agents. Enforces Google SRE, Clean-Room Senior Dev Ladders, and Rust/Go Microservices.",
   "repository": "https://github.com/imMamdouhaboammar/anti-slop-engineering",
   "author": "Mamdouh Aboammar",

package/README.md

@@ -12,7 +12,7 @@
 [![Skills.sh](https://img.shields.io/badge/Skills.sh-Compatible-000000?style=flat-square&logo=vercel&logoColor=white)](https://skills.sh)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-Certified%20Skill-D97706?style=flat-square&logo=anthropic&logoColor=white)](https://claude.ai)
 
-[Install](#install) · [What it catches](#what-it-catches) · [Engines](#engines) · [Decision Guard](#decision-guard) · [Root-Fix Gate](#root-fix-gate) · [Future-Scale Gate](#future-scale-gate) · [Paranoid Architect](#the-paranoid-principal-architect) · [Install Anti-Slop](#install-anti-slop-oxlint) · [Agent skill](#agent-skill) · [Anti-pattern catalog](#anti-pattern-catalog-217-patterns)
+[Install](#install) · [What it catches](#what-it-catches) · [Engines](#engines) · [Decision Guard](#decision-guard) · [Root-Fix Gate](#root-fix-gate) · [Future-Scale Gate](#future-scale-gate) · [Paranoid Architect](#the-paranoid-principal-architect) · [Forensic Bug Hunter](#forensic-bug-hunter-scanner) · [Install Anti-Slop](#install-anti-slop-oxlint) · [Agent skill](#agent-skill) · [Anti-pattern catalog](#anti-pattern-catalog-217-patterns)
 
 </div>
 
@@ -285,16 +285,68 @@ bunx anti-slop-engineering paranoid audit skills/paranoid-principal-architect/ex
 
 ---
 
+## Forensic Bug Hunter Scanner
+
+Zero-trust static analysis scanner across 9 application stacks detecting booby traps, concurrency leaks, race conditions, memory leaks, and EDoS vulnerabilities:
+
+```bash
+# Scan git diff against base:
+bunx anti-slop-engineering hunter --base HEAD
+# Scan specific file or directory:
+bunx anti-slop-engineering hunter --path src/
+# Output machine-readable JSON:
+bunx anti-slop-engineering hunter --json
+```
+
+Modular playbooks and architectural checklists are located in [`skills/paranoid-principal-architect/playbooks/`](skills/paranoid-principal-architect/playbooks/).
+
+---
+
 ## Install Anti-Slop (Oxlint)
 
-For TypeScript and JavaScript projects, install the opinionated anti-slop Oxlint lint rules to catch runtime type assertion risks, unconstrained object parameters, and module mocking leaks at lint-time:
+Opinionated anti-slop Oxlint lint rules for TypeScript and JavaScript codebases. Catches runtime type assertion risks, unconstrained object parameters, type widening, and module mocking leaks at lint-time:
 
 ```bash
-# In your target repository:
-npx skills add imMamdouhaboammar/anti-slop-engineering
+# 1. Install Oxlint plugin directly into your target repository (creates tools/oxlint/anti-slop/):
+bunx anti-slop-engineering install-oxlint
+# Or via npx:
+npx anti-slop-engineering install-oxlint
 ```
 
-Follow the procedure in [install-anti-slop](skills/install-anti-slop/SKILL.md) to register the bundled plugins (`anti-slop` and optional `anti-slop-effect`) directly into `oxlint.config.ts` or `.oxlintrc.json`.
+Follow the procedure in [install-anti-slop](skills/install-anti-slop/SKILL.md) to register the bundled plugins (`anti-slop` and optional `anti-slop-effect`) directly into `oxlint.config.ts` or `.oxlintrc.json`:
+
+```ts
+// oxlint.config.ts or .oxlintrc.json
+export default {
+  ignorePatterns: [
+    ".agent/**",
+    ".agents/**",
+    ".claude/**",
+    ".gemini/**",
+    "tools/oxlint/anti-slop/**"
+  ],
+  jsPlugins: [
+    { name: "anti-slop", specifier: "./tools/oxlint/anti-slop/index.ts" }
+  ],
+  rules: {
+    "anti-slop/no-chained-type-assertions": "error",
+    "anti-slop/no-conditional-empty-object-spread": "error",
+    "anti-slop/no-known-value-widening": "error",
+    "anti-slop/no-module-mocking": "error",
+    "anti-slop/no-object-parameters": "error",
+    "anti-slop/no-reflect-apply": "error",
+    "anti-slop/no-reflect-get": "error",
+    "anti-slop/no-runtime-typeof": "error",
+    "anti-slop/no-shape-in-symbol-names": "error",
+    "anti-slop/no-unknown-parameters": "error",
+    "anti-slop/no-unknown-returns": "error",
+    "anti-slop/no-unknown-type-aliases": "error",
+    "anti-slop/no-unsafe-dictionary-type": "error",
+    "anti-slop/no-widen-then-assert": "error",
+    "anti-slop/require-safety-comment-for-type-assertion": "error"
+  }
+};
+```
 
 ---
 

package/SKILL.md

@@ -4,7 +4,7 @@ description: Prevent, detect, and repair AI coding slop and dirty engineering in
 author: Mamdouh Aboammar <mamdouhfces1997@gmail.com>
 license: MIT
 metadata:
-  version: "1.4.0"
+  version: "1.5.0"
   focus: "engineering-discipline"
   repository: "https://github.com/imMamdouhaboammar/anti-slop-engineering"
 ---

package/bin/cli.js

@@ -17,7 +17,9 @@ const decisionGuardScript = resolve(rootDir, "scripts", "decision_guard.py");
 const rootFixGuardScript = resolve(rootDir, "scripts", "root_fix_guard.py");
 const futureScaleGuardScript = resolve(rootDir, "scripts", "future_scale_guard.py");
 const paranoidGuardScript = resolve(rootDir, "scripts", "paranoid_guard.py");
+const forensicHunterScript = resolve(rootDir, "scripts", "forensic_hunter.py");
 const bumpVersionScript = resolve(rootDir, "scripts", "bump_version.py");
+const installOxlintScript = resolve(rootDir, "skills", "install-anti-slop", "scripts", "install.mjs");
 const nativeSuffix = process.platform === "win32" ? ".exe" : "";
 const rustExecutable = "anti-slop-rust" + nativeSuffix;
 const goExecutable = "toil-guard" + nativeSuffix;
@@ -30,13 +32,19 @@ const goBinPath = !disableNative && existsSync(resolve(rootDir, "dist", "bin", g
   : (!disableNative ? resolve(rootDir, "services", "toil-guard-go", "bin", goExecutable) : "");
 
 const invokedAs = basename(process.argv[1] ?? "").replace(/\.(?:js|cmd|exe)$/i, "");
-const executableAliases = { "sre-guard": "sre", "rust-guard": "rust", "toil-guard": "toil" };
+const executableAliases = {
+  "sre-guard": "sre",
+  "rust-guard": "rust",
+  "toil-guard": "toil",
+  "forensic-hunter": "hunter",
+  "forensic": "hunter",
+};
 const args = process.argv.slice(2);
 if (executableAliases[invokedAs]) args.unshift(executableAliases[invokedAs]);
 
 function printBanner() {
   console.log(`
-🛡️  Anti-Slop Engineering CLI (v1.4.0)
+🛡️  Anti-Slop Engineering CLI (v1.5.0)
    Clean-Room AI Coding Guard & High-Performance Polyglot Architecture
    Engines: Standard Library Python Guard | Rust Microservice | Go Toil Guard
    Author: Mamdouh Aboammar <mamdouhfces1997@gmail.com>
@@ -57,6 +65,8 @@ Commands:
   root-fix audit <file>  Check root-cause ownership, change plan and optional Git diff
   future-scale audit <file>  Check future operating envelope, reversibility and evolution proof
   paranoid audit <file>  Check a Paranoid Architect record for zero-trust and 10M scale compliance
+  hunter, forensic       Run Zero-Trust Forensic Bug Hunter static scanner across 9 stacks
+  install-oxlint         Install bundled Oxlint anti-slop plugin into target repo
   bump [part]            Bump version across all 10 manifests (patch, minor, major, or explicit)
   test                   Run unit test suite
   contribute             Print guidelines on reporting noted slop or opening PRs
@@ -219,6 +229,14 @@ if (cmd === "build") {
   runPythonScript(futureScaleGuardScript, args.slice(1), "future_scale_guard");
 } else if (cmd === "paranoid") {
   runPythonScript(paranoidGuardScript, args.slice(1), "paranoid_guard");
+} else if (cmd === "hunter" || cmd === "forensic" || cmd === "forensic-hunter") {
+  runPythonScript(forensicHunterScript, args.slice(1), "forensic_hunter");
+} else if (cmd === "install-oxlint" || cmd === "install-anti-slop") {
+  if (!existsSync(installOxlintScript)) {
+    console.error(`Error: install script not found at ${installOxlintScript}`);
+    process.exit(1);
+  }
+  spawnProcess("node", [installOxlintScript, ...args.slice(1)], "install_oxlint");
 } else if (cmd === "bump") {
   runPythonScript(bumpVersionScript, args.slice(1), "bump_version");
 } else if (args.includes("--help") || args.includes("-h")) {

package/install.sh

@@ -48,11 +48,14 @@ install_to() {
   chmod +x "$dest/scripts/decision_guard.py" 2>/dev/null || true
   chmod +x "$dest/scripts/root_fix_guard.py" 2>/dev/null || true
   chmod +x "$dest/scripts/future_scale_guard.py" 2>/dev/null || true
+  chmod +x "$dest/scripts/paranoid_guard.py" 2>/dev/null || true
+  chmod +x "$dest/scripts/forensic_hunter.py" 2>/dev/null || true
+  chmod +x "$dest/skills/install-anti-slop/scripts/install.mjs" 2>/dev/null || true
   chmod +x "$dest/install.sh" 2>/dev/null || true
   echo "  ✅ Installed anti-slop-engineering for ${label} -> ${dest}"
 
   # Install each bundled module as a discoverable top-level skill.
-  for module in decision-guard root-fix-gate future-scale-gate; do
+  for module in decision-guard root-fix-gate future-scale-gate paranoid-principal-architect install-anti-slop; do
     if [ -d "$SOURCE_DIR/skills/$module" ]; then
       local module_dest="$(dirname "$dest")/$module"
       rm -rf "$module_dest"

package/marketplace.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-plugin-manifest.json",
   "name": "anti-slop-engineering",
   "displayName": "Anti-Slop Engineering",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "An Engineering Discipline Playbook, Agent Skill & Triage Guard for AI Coding Agents. Enforces behavioral contracts, focused diffs, test integrity, Google SRE principles, and native Rust/Go clean-room microservices.",
   "author": {
     "name": "Mamdouh Aboammar",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anti-slop-engineering",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "An Engineering Discipline Playbook, Agent Skill & Triage Guard for AI Coding Agents",
   "type": "module",
   "main": "bin/cli.js",