fixmyslop 0.0.0-stage → 0.3.1

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# fixmyslop (npm launcher)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+```bash
+npx fixmyslop scan            # find AI slop in your UI and code
+npx fixmyslop scan --open     # interactive report with copy-to-agent fix prompts
+npx fixmyslop init --claude   # make Claude Code check its own work
+```
+
+This package runs the [FixMySlop](https://github.com/MrSpideyNihal/FixMySlop) CLI through `uvx` or `pipx`
+(or a local `pip install fixmyslop`). See the main README for everything it catches.
+
+MCP config for Cursor / Claude Code / Windsurf:
+
+```json
+{ "mcpServers": { "fixmyslop": { "command": "npx", "args": ["-y", "fixmyslop", "mcp"] } } }
+```

package/bin/fixmyslop.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+// Thin launcher: runs the FixMySlop Python CLI of the SAME version as this npm package —
+// a matching local install if there is one, otherwise via uvx or pipx.
+"use strict";
+const { spawnSync } = require("node:child_process");
+const { version } = require("../package.json");
+
+const args = process.argv.slice(2);
+const VERSION_PROBE =
+  "import importlib.metadata as m, sys; print(m.version('fixmyslop'))";
+
+function ok(cmd, probe) {
+  const r = spawnSync(cmd, probe, { encoding: "utf8" });
+  return r.status === 0 ? (r.stdout || "").trim() || "ok" : null;
+}
+
+function run(cmd, cmdArgs) {
+  const r = spawnSync(cmd, cmdArgs, { stdio: "inherit" });
+  if (r.error) return;
+  process.exit(r.status ?? 1);
+}
+
+let outdated = null;
+for (const python of ["python3", "python", "py"]) {
+  const installed = ok(python, ["-c", VERSION_PROBE]);
+  if (installed === version) run(python, ["-m", "fixmyslop", ...args]);
+  if (installed && !outdated) outdated = { python, installed };
+}
+if (ok("uvx", ["--version"])) run("uvx", [`fixmyslop@${version}`, ...args]);
+if (ok("pipx", ["--version"])) run("pipx", ["run", "--spec", `fixmyslop==${version}`, "fixmyslop", ...args]);
+
+if (outdated) {
+  console.error(
+    `Found fixmyslop ${outdated.installed}, but this launcher runs ${version}. Upgrade with:\n` +
+    `  ${outdated.python} -m pip install -U "fixmyslop==${version}"\n` +
+    "or install uv (https://docs.astral.sh/uv/) so npx can fetch the right version automatically."
+  );
+} else {
+  console.error(
+    "FixMySlop needs Python 3.10+ and one of these:\n" +
+    "  uv     https://docs.astral.sh/uv/   (then `npx fixmyslop` just works)\n" +
+    "  pipx   https://pipx.pypa.io/\n" +
+    `  or:    pip install "fixmyslop==${version}"`
+  );
+}
+process.exit(127);

package/package.json

@@ -1,6 +1,12 @@
 {
   "name": "fixmyslop",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.1",
+  "description": "The slop linter for the AI-agent era: catch AI slop in UI and code in milliseconds, then let your agent fix it.",
+  "bin": { "fixmyslop": "bin/fixmyslop.js" },
+  "files": ["bin/", "README.md"],
+  "engines": { "node": ">=18" },
+  "keywords": ["ai-slop", "linter", "tailwind", "react", "accessibility", "claude-code", "mcp", "cursor", "lovable", "v0"],
+  "repository": { "type": "git", "url": "git+https://github.com/MrSpideyNihal/FixMySlop.git" },
+  "homepage": "https://github.com/MrSpideyNihal/FixMySlop#readme",
+  "license": "MIT"
+}