anti-slop-engineering 0.4.0 → 1.0.0

package/.skills.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://skills.sh/schema.json",
   "name": "anti-slop-engineering",
-  "version": "0.4.0",
+  "version": "1.0.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

@@ -139,7 +139,7 @@ bunx anti-slop-engineering sre --max-nesting 4 --min-dup-lines 4 --max-function-
 
 ### Rust SHIT Interceptor (`services/anti-slop-rust`)
 
-A high-performance Axum HTTP microservice that audits diffs and source for four categories of agent failure — Scope creep (`S`), Hypothetical hardening (`H`), Intent violation (`I`), and Task thrashing (`T`) — plus the Senior Dev Ladder pattern: detecting custom implementations where platform primitives already exist (`crypto.randomUUID()`, `URLSearchParams`, `structuredClone()`).
+A high-performance Axum HTTP microservice that audits diffs and source for Scope creep (`S`), Hypothetical hardening (`H`), and Intent violation (`I`) in diffs, plus regex-based Senior Dev Ladder checks for hand-rolled alternatives to common platform primitives. Task-thrashing detection is not implemented.
 
 ```bash
 # Triage git changes through Rust engine:
@@ -158,9 +158,9 @@ A concurrent Go microservice for high-throughput SRE metric verification. Runs K
 
 ```bash
 # SRE audit across repository:
-bunx anti-slop-engineering toil audit
+bunx anti-slop-engineering toil audit .
 
-# Live git telemetry with error budget tracking:
+# Live git diff statistics (not a live error-budget calculation):
 bunx anti-slop-engineering toil stream
 
 # Start Go microservice daemon:

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: "0.4.0"
+  version: "1.0.0"
   focus: "engineering-discipline"
   repository: "https://github.com/imMamdouhaboammar/anti-slop-engineering"
 ---

package/bin/cli.js

@@ -3,8 +3,8 @@
 // Copyright (c) 2026 Mamdouh Aboammar <mamdouhfces1997@gmail.com> and contributors
 
 import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
 
@@ -13,18 +13,24 @@ const __dirname = dirname(__filename);
 const rootDir = resolve(__dirname, "..");
 const diffGuardScript = resolve(rootDir, "scripts", "diff_guard.py");
 const sreGuardScript = resolve(rootDir, "scripts", "sre_guard.py");
-const rustBinPath = existsSync(resolve(rootDir, "dist", "bin", "anti-slop-rust"))
-  ? resolve(rootDir, "dist", "bin", "anti-slop-rust")
-  : resolve(rootDir, "services", "anti-slop-rust", "target", "release", "anti-slop-rust");
-const goBinPath = existsSync(resolve(rootDir, "dist", "bin", "toil-guard"))
-  ? resolve(rootDir, "dist", "bin", "toil-guard")
-  : resolve(rootDir, "services", "toil-guard-go", "bin", "toil-guard");
-
+const nativeSuffix = process.platform === "win32" ? ".exe" : "";
+const rustExecutable = "anti-slop-rust" + nativeSuffix;
+const goExecutable = "toil-guard" + nativeSuffix;
+const rustBinPath = existsSync(resolve(rootDir, "dist", "bin", rustExecutable))
+  ? resolve(rootDir, "dist", "bin", rustExecutable)
+  : resolve(rootDir, "services", "anti-slop-rust", "target", "release", rustExecutable);
+const goBinPath = existsSync(resolve(rootDir, "dist", "bin", goExecutable))
+  ? resolve(rootDir, "dist", "bin", goExecutable)
+  : 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 args = process.argv.slice(2);
+if (executableAliases[invokedAs]) args.unshift(executableAliases[invokedAs]);
 
 function printBanner() {
   console.log(`
-🛡️  Anti-Slop Engineering CLI (v0.4.0)
+🛡️  Anti-Slop Engineering CLI (v1.0.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>
@@ -35,7 +41,7 @@ Usage:
   bunx anti-slop-engineering [command] [options]
 
 Commands:
-  rust, sts              Run native Rust Engine (Scope Creep, Hypothetical Hardening, Intent, Task Thrashing, Senior Dev Ladder)
+  rust, sts              Run native Rust Engine (Scope Creep, Hypothetical Hardening, Intent, Senior Dev Ladder)
   toil, go-guard         Run Go SRE Engine (KISS nesting, DRY token window, Toil & Error Budget)
   serve-rust             Start background Rust HTTP microservice daemon (default: :9091)
   serve-go               Start background Go HTTP SRE microservice daemon (default: :9092)
@@ -64,7 +70,7 @@ function spawnProcess(execPath, execArgs, label) {
     process.exit(1);
   });
   child.on("close", (code) => {
-    process.exit(code ?? 0);
+    process.exit(code ?? 1); // Signal termination must never be reported as success.
   });
 }
 
@@ -88,6 +94,54 @@ function runPythonScript(scriptPath, scriptArgs, scriptLabel) {
   spawnProcess("python3", [scriptPath, ...scriptArgs], scriptLabel);
 }
 
+function unsupportedFallback(engine, request) {
+  console.error(`Error: ${engine} native binary is required for ${request}. Run 'anti-slop-engineering build'.`);
+  process.exit(1);
+}
+
+function extractCommonFlags(flags, engine, onUnrecognized) {
+  const mapped = [];
+  for (let i = 0; i < flags.length; i++) {
+    const flag = flags[i];
+    if (flag === "--base" && flags[i + 1]) {
+      mapped.push("--base", flags[++i]);
+    } else if (flag === "--format" && flags[i + 1] === "json") {
+      mapped.push("--json");
+      i++;
+    } else if (flag === "--format" && flags[i + 1] === "text") {
+      i++;
+    } else if (onUnrecognized) {
+      onUnrecognized(flag);
+    } else {
+      unsupportedFallback(engine, `option ${flag}`);
+    }
+  }
+  return mapped;
+}
+
+function runRustFallback(request) {
+  const [command, ...flags] = request;
+  if (command !== "triage") unsupportedFallback("Rust", command);
+  const mapped = ["--fail-on-blocker", ...extractCommonFlags(flags, "Rust")];
+  runPythonScript(diffGuardScript, mapped, "diff_guard");
+}
+
+function runGoFallback(request) {
+  const [command, ...flags] = request;
+  if (command !== "audit") unsupportedFallback("Go", command);
+  const paths = [];
+  const mapped = extractCommonFlags(flags, "Go", (flag) => {
+    if (flag.startsWith("-")) unsupportedFallback("Go", `audit option ${flag}`);
+    else paths.push(flag);
+  });
+  if (paths.length > 0) {
+    if (mapped.includes("--base")) unsupportedFallback("Go", "audit with both --base and paths");
+    mapped.push("--files", ...paths);
+  } else if (!mapped.includes("--base")) mapped.push("--base", "HEAD");
+  mapped.push("--strict");
+  runPythonScript(sreGuardScript, mapped, "sre_guard");
+}
+
 function runBuild() {
   console.log("Compiling Rust microservice...");
   const cargo = spawn("cargo", ["build", "--release"], {
@@ -102,7 +156,8 @@ function runBuild() {
     }
 
     console.log("Compiling Go microservice...");
-    const goBuild = spawn("go", ["build", "-o", "bin/toil-guard", "./cmd/toil-guard"], {
+    mkdirSync(resolve(rootDir, "services", "toil-guard-go", "bin"), { recursive: true });
+    const goBuild = spawn("go", ["build", "-o", "bin/" + goExecutable, "./cmd/toil-guard"], {
       cwd: resolve(rootDir, "services", "toil-guard-go"),
       stdio: "inherit",
     });
@@ -125,15 +180,11 @@ if (cmd === "build") {
 } else if (cmd === "rust" || cmd === "rust-guard" || cmd === "sts") {
   const subArgs = args.slice(1);
   const forwardArgs = subArgs.length > 0 ? subArgs : ["triage"];
-  runBinary(rustBinPath, forwardArgs, "anti-slop-rust", () => {
-    runPythonScript(diffGuardScript, ["--base", "HEAD"], "diff_guard");
-  });
+  runBinary(rustBinPath, forwardArgs, "anti-slop-rust", () => runRustFallback(forwardArgs));
 } else if (cmd === "toil" || cmd === "toil-guard" || cmd === "go-guard") {
   const subArgs = args.slice(1);
   const forwardArgs = subArgs.length > 0 ? subArgs : ["audit"];
-  runBinary(goBinPath, forwardArgs, "toil-guard-go", () => {
-    runPythonScript(sreGuardScript, ["--base", "HEAD"], "sre_guard");
-  });
+  runBinary(goBinPath, forwardArgs, "toil-guard-go", () => runGoFallback(forwardArgs));
 } else if (cmd === "serve-rust") {
   runBinary(rustBinPath, ["serve", ...args.slice(1)], "anti-slop-rust daemon", null);
 } else if (cmd === "serve-go") {
@@ -164,7 +215,7 @@ Path B: Submit a PR (Problem + Solution Integrated)
     cwd: rootDir,
     stdio: "inherit",
   });
-  pyTest.on("close", (code) => process.exit(code ?? 0));
+  pyTest.on("close", (code) => process.exit(code ?? 1));
 } else if (cmd === "test-all") {
   spawnProcess("make", ["test-all"], "test-all");
 } else if (cmd === "check-all") {

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": "0.4.0",
+  "version": "1.0.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": "0.4.0",
+  "version": "1.0.0",
   "description": "An Engineering Discipline Playbook, Agent Skill & Triage Guard for AI Coding Agents",
   "type": "module",
   "main": "bin/cli.js",
@@ -22,6 +22,12 @@
   "files": [
     "bin",
     "scripts",
+    "services/anti-slop-rust/Cargo.toml",
+    "services/anti-slop-rust/Cargo.lock",
+    "services/anti-slop-rust/src",
+    "services/toil-guard-go/go.mod",
+    "services/toil-guard-go/cmd",
+    "services/toil-guard-go/pkg",
     "references",
     "assets",
     "SKILL.md",

package/references/clean-room-recon.md

@@ -59,7 +59,7 @@ No code from any reference repository is copied or decompiled. Only functional m
       |   - Scope Creep Detector     |                    | • Concurrency & Toil Guard   |
       |   - Hypothetical Hardening   |                    | • Sliding-Window DRY Scanner |
       |   - Intent Violation Gate    |                    | • SLI/SLO Error Budget Engine|
-      |   - Task Thrashing Watcher   |                    | • Prometheus /metrics Server |
+      |   - Rule-based diff checks   |                    | • Prometheus /metrics Server |
       | • Senior Dev Ladder Auditor  |                    | • HTTP REST Service (/v1/..) |
       | • Axum REST Server (/v1/..)  |                    +------------------------------+
       +------------------------------+                                   |
@@ -75,19 +75,19 @@ No code from any reference repository is copied or decompiled. Only functional m
 ```
 
 ### 2.1 Rust Microservice (`services/anti-slop-rust`)
-- **Focus:** Ultra-fast AST pattern triage, SHIT boundary violation interception, token waste analysis, and deterministic circuit-breaker protection.
+- **Focus:** Regex-based diff triage for scope, speculative hardening, and read-only intent, plus simple built-in replacement checks.
 - **Key Modules:**
   - `src/shit_interceptor.rs`: Scope creep detection, unread checksum/hash generation checks, speculative try-catch error swallowing, and file boundary guards.
-  - `src/ladder_auditor.rs`: Code reduction ratio auditing, stdlib built-in identification, and 3-point abstraction gate checks.
-  - `src/server.rs`: Lightweight HTTP microservice (`axum` + `tokio`) exposing `/health`, `/v1/triage`, `/v1/shit-check`, and `/v1/ladder`.
+  - `src/ladder_auditor.rs`: Regex-based built-in replacement suggestions and conjunction naming hints.
+  - `src/server.rs`: Lightweight HTTP microservice (`axum` + `tokio`) exposing `/health`, `/v1/triage`, `/v1/shit-check`, and `/v1/ladder-audit`.
   - `src/main.rs`: High-performance CLI interface powered by `clap`.
 
 ### 2.2 Go Microservice (`services/toil-guard-go`)
 - **Focus:** Concurrent repository-wide stream analysis, Google SRE metric verification (KISS, DRY, YAGNI, Scale), automated toil detection, and SLI/SLO budget verification.
 - **Key Modules:**
   - `pkg/sre/complexity.go`: Control flow nesting level (<=4) and function length (<=80 lines) verification.
-  - `pkg/sre/dry_window.go`: Sliding-window token hash scanner across files.
-  - `pkg/sre/toil.go`: SRE anti-pattern heuristics (unbounded concurrency, blind sleep synchronization, missing exponential backoff + jitter).
+  - `pkg/sre/dry.go`: Sliding-window token hash scanner across files.
+  - `pkg/sre/toil.go`: SRE anti-pattern heuristics (blind sleep synchronization, fixed retry loops, and silent error swallowing).
   - `pkg/sre/sli.go`: Error budget calculation and slop index scoring.
-  - `pkg/server/server.go`: Production Go HTTP microservice with graceful shutdown, `/healthz`, `/metrics`, and `/v1/toil-audit`.
+  - `pkg/server/server.go`: Production Go HTTP microservice with graceful shutdown, `/healthz`, `/metrics`, and `/v1/audit`.
   - `cmd/toil-guard/main.go`: Multi-subcommand CLI runner (`audit`, `stream`, `serve`).

package/scripts/sre_guard.py

@@ -130,7 +130,7 @@ def normalize_line(line):
     stripped = line.strip()
     if not stripped or stripped.startswith(('#', '//', '/*', '*', 'import ', 'from ', 'package ', 'use ')):
         return ''
-    if (stripped.startswith('"') and stripped.endswith('"')) or (stripped.startswith("'") and stripped.endswith("'")):
+    if re.fullmatch(r'''(?:"[^"]*"|'[^']*'),?''', stripped):
         return ''
     if stripped in ('{', '}', '(', ')', '};', '];', ');', 'return', ']', '['):
         return ''