slopbrick 0.18.5 → 0.18.7

package/dist/engine/worker.cjs

@@ -34757,6 +34757,9 @@ var expiredCodeExampleRule = createRule({
     const issues = [];
     const source = facts.v2?._source;
     if (!source) return issues;
+    const packages = declaredPackages(context.cwd);
+    const packageName = context.packageName;
+    if (packageName) packages.add(packageName);
     const blocks = extractFencedCodeBlocks(source);
     for (const block of blocks) {
       if (!CODE_LANGS.has(block.lang)) continue;
@@ -34764,7 +34767,7 @@ var expiredCodeExampleRule = createRule({
       const imports = extractImports(block.body);
       for (const imp of imports) {
         const pkgName = stripSubpath(imp);
-        if (context.packages.has(pkgName)) continue;
+        if (packages.has(pkgName)) continue;
         issues.push({
           ruleId: "docs/expired-code-example",
           category: "docs",
@@ -34785,6 +34788,7 @@ var expiredCodeExampleRule = createRule({
 var import_node_fs4 = require("fs");
 var import_node_path4 = require("path");
 var RESERVED = /* @__PURE__ */ new Set([
+  // JS reserved words
   "true",
   "false",
   "null",
@@ -34884,7 +34888,472 @@ var RESERVED = /* @__PURE__ */ new Set([
   "next",
   "vue",
   "angular",
-  "svelte"
+  "svelte",
+  // Framework / runtime names
+  "html",
+  "astro",
+  "python",
+  "jvm",
+  "kotlin",
+  "swift",
+  "dart",
+  "ruby",
+  "rust",
+  "cpp",
+  "go",
+  "java",
+  "php",
+  "php-html",
+  "csharp",
+  "typescript",
+  "javascript",
+  "jsx",
+  "tsx",
+  "mjs",
+  "cjs",
+  "esnext",
+  "es6",
+  "es2022",
+  "es2023",
+  "esm",
+  "cjs",
+  "umd",
+  "amd",
+  "commonjs",
+  "require",
+  "module",
+  "exports",
+  "define",
+  "global",
+  "window",
+  "document",
+  "process",
+  "console",
+  "buffer",
+  "stream",
+  "fetch",
+  "axios",
+  "express",
+  "fastify",
+  "koa",
+  "hapi",
+  "nextjs",
+  "nuxt",
+  "remix",
+  "gatsby",
+  "sveltekit",
+  "solid",
+  "preact",
+  "qwik",
+  "lit",
+  "stencil",
+  "marko",
+  "alpine",
+  "stimulus",
+  "turbo",
+  "hotwire",
+  // Models / providers
+  "gpt",
+  "claude",
+  "gpt-3",
+  "gpt-3.5",
+  "gpt-4",
+  "gpt-oss",
+  "haiku",
+  "sonnet",
+  "opus",
+  "aider",
+  "tabby",
+  "copilot",
+  "cursor",
+  "windsurf",
+  "devin",
+  "claude-code",
+  // LLM-detection lingo
+  "heuristic",
+  "heuristics",
+  "calibrate",
+  "calibration",
+  "calibrator",
+  "corpus",
+  "baseline",
+  "baselines",
+  "corpus-baselines",
+  "lift",
+  "recall",
+  "precision",
+  "fpRate",
+  "ratio",
+  "verdict",
+  "USEFUL",
+  "NOISY",
+  "INVERTED",
+  "HYGIENE",
+  "DORMANT",
+  "OK",
+  "aiSpecific",
+  "defaultOff",
+  // Common slop-audit verbs/nouns
+  "commit",
+  "push",
+  "reset",
+  "rebase",
+  "merge",
+  "cherry-pick",
+  "revert",
+  "scan",
+  "parse",
+  "build",
+  "test",
+  "lint",
+  "format",
+  "check",
+  "audit",
+  "fix",
+  "patch",
+  "diff",
+  "pr",
+  "ci",
+  "cd",
+  "gh",
+  "npm",
+  "npx",
+  "pnpm",
+  "yaml",
+  "json",
+  "toml",
+  "csv",
+  "md",
+  "mdx",
+  "sh",
+  "bash",
+  "zsh",
+  "fish",
+  "ascii",
+  "utf8",
+  "utf-8",
+  "base64",
+  "hex",
+  "binary",
+  "text",
+  // Common design / ui terms
+  "flex",
+  "grid",
+  "auto",
+  "min",
+  "max",
+  "fill",
+  "stretch",
+  "wrap",
+  "nowrap",
+  "inline",
+  "block",
+  "hidden",
+  "visible",
+  "static",
+  "fixed",
+  "absolute",
+  "relative",
+  "sticky",
+  "pointer",
+  "cursor",
+  "focus",
+  "hover",
+  "active",
+  "disabled",
+  "readonly",
+  "primary",
+  "secondary",
+  "tertiary",
+  "success",
+  "warning",
+  "danger",
+  "info",
+  "muted",
+  "sm",
+  "md",
+  "lg",
+  "xl",
+  "xxl",
+  "xs",
+  "2xl",
+  "3xl",
+  "4xl",
+  // Math / types
+  "array",
+  "map",
+  "set",
+  "weakmap",
+  "weakset",
+  "object",
+  "string",
+  "number",
+  "boolean",
+  "bigint",
+  "symbol",
+  "null",
+  "undefined",
+  "any",
+  "unknown",
+  "never",
+  "void",
+  "readonly",
+  "private",
+  "public",
+  "protected",
+  "static",
+  "abstract",
+  "async",
+  "generator",
+  "iterator",
+  "iterable",
+  "promise",
+  "observable",
+  // Auth / domain
+  "admin",
+  "user",
+  "guest",
+  "anonymous",
+  "authenticated",
+  "unauthenticated",
+  "jwt",
+  "oauth",
+  "oidc",
+  "saml",
+  "csrf",
+  "xss",
+  "sql",
+  "nosql",
+  "orm",
+  "prisma",
+  "drizzle",
+  "sequelize",
+  "mongoose",
+  "redis",
+  "postgres",
+  "mysql",
+  "sqlite",
+  "kafka",
+  "rabbitmq",
+  "graphql",
+  "rest",
+  "grpc",
+  "websocket",
+  // slop-audit specific
+  "slopbrick",
+  "usebrick",
+  "deadcode",
+  "unused",
+  "orphan",
+  "zombie",
+  "blocker",
+  "warning",
+  "info",
+  "error",
+  "verbose",
+  "debug",
+  "silly",
+  "p50",
+  "p90",
+  "p95",
+  "p99",
+  "min",
+  "max",
+  "avg",
+  "mean",
+  "median",
+  "ratchet",
+  "tier",
+  "composite",
+  "fitness",
+  "fpr",
+  "tpr",
+  "roc",
+  "should",
+  "could",
+  "would",
+  "might",
+  "must",
+  "shall",
+  "may",
+  "can",
+  "todo",
+  "fixme",
+  "xxx",
+  "hack",
+  "note",
+  "warning",
+  "attention",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "strong",
+  "em",
+  "b",
+  "i",
+  "u",
+  "true",
+  "false",
+  "yes",
+  "no",
+  "on",
+  "off",
+  "enable",
+  "disable",
+  "ltr",
+  "rtl",
+  "auto",
+  "start",
+  "end",
+  "center",
+  "baseline",
+  "stretch",
+  "rounded",
+  "sharp",
+  "outline",
+  "ghost",
+  "link",
+  "filled",
+  "row",
+  "col",
+  "gap",
+  "pad",
+  "margin",
+  "padding",
+  "border",
+  "shadow",
+  "transparent",
+  "currentcolor",
+  "inherit",
+  "initial",
+  "unset",
+  "revert",
+  "hover",
+  "focus",
+  "active",
+  "disabled",
+  "checked",
+  "indeterminate",
+  "open",
+  "close",
+  "expanded",
+  "collapsed",
+  "selected",
+  "pressed",
+  // Web/CSS
+  "div",
+  "span",
+  "p",
+  "a",
+  "img",
+  "ul",
+  "ol",
+  "li",
+  "table",
+  "tr",
+  "td",
+  "th",
+  "thead",
+  "tbody",
+  "tfoot",
+  "caption",
+  "figure",
+  "figcaption",
+  "main",
+  "section",
+  "article",
+  "aside",
+  "header",
+  "footer",
+  "nav",
+  "form",
+  "input",
+  "button",
+  "select",
+  "option",
+  "textarea",
+  "label",
+  "fieldset",
+  "legend",
+  "details",
+  "summary",
+  "dialog",
+  "menu",
+  "menuitem",
+  "template",
+  "slot",
+  "picture",
+  "source",
+  "track",
+  "video",
+  "audio",
+  "canvas",
+  "svg",
+  "iframe",
+  "embed",
+  "object",
+  "portal",
+  // Common business terms
+  "api",
+  "cli",
+  "ui",
+  "ux",
+  "sdk",
+  "ide",
+  "cli",
+  "docs",
+  "doc",
+  "blog",
+  "post",
+  "page",
+  "view",
+  "tab",
+  "panel",
+  "card",
+  "list",
+  "grid",
+  "form",
+  "modal",
+  "menu",
+  "button",
+  "icon",
+  "avatar",
+  "badge",
+  "chip",
+  "tooltip",
+  "popover",
+  "dropdown",
+  "banner",
+  "alert",
+  "toast",
+  "notification",
+  "drawer",
+  "sidebar",
+  "navbar",
+  "header",
+  "footer",
+  "hero",
+  "cta",
+  "cta-primary",
+  "cta-secondary",
+  "pricing",
+  "price",
+  "cost",
+  "rate",
+  "percent",
+  "pct",
+  "count",
+  "total",
+  "small",
+  "medium",
+  "large",
+  "xl",
+  "xxl",
+  "tiny",
+  "huge"
 ]);
 var SOURCE_EXTS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
 var SOURCE_ROOTS = ["src", "lib", "app", "components"];
@@ -34922,7 +35391,12 @@ function collectExports(cwd) {
       /\bexport\s+class\s+([A-Za-z_$][\w$]*)/g,
       /\bexport\s+interface\s+([A-Za-z_$][\w$]*)/g,
       /\bexport\s+type\s+([A-Za-z_$][\w$]*)/g,
-      /\bexport\s+default\s+(?:function\s+|class\s+)?([A-Za-z_$][\w$]*)/g
+      /\bexport\s+default\s+(?:function\s+|class\s+)?([A-Za-z_$][\w$]*)/g,
+      // v0.18.6: also collect field names from `export interface` and
+      // `export type` declarations. Without this, fields like
+      // `crossFileDrift`, `aiQuality`, `engineeringHygiene` are
+      // flagged as stale even though they're valid type fields.
+      /^\s*(?:readonly\s+)?([A-Za-z_$][\w$]*)\s*[?:]/gm
     ]) {
       let m;
       while ((m = re.exec(source)) !== null) {
@@ -34933,6 +35407,21 @@ function collectExports(cwd) {
   }
   return out;
 }
+function looksLikeProseLabel(inside) {
+  const trimmed = inside.trim();
+  if (trimmed.length === 0) return false;
+  if (trimmed.startsWith("`") || trimmed.startsWith("/")) return true;
+  if (trimmed.includes("`")) return true;
+  if (/\d+\s+[a-z]/i.test(trimmed)) return true;
+  const parts = trimmed.split(",").map((s) => s.trim());
+  if (parts.length >= 3) {
+    const allNumeric = parts.every((p) => /^\d+\.?\d*$/.test(p));
+    if (!allNumeric) return true;
+  }
+  if (trimmed.length > 40 && !trimmed.includes(",")) return true;
+  if (trimmed.includes("\u2014") || trimmed.includes("\u2013")) return true;
+  return false;
+}
 var staleFunctionReferenceRule = createRule({
   id: "docs/stale-function-reference",
   category: "docs",
@@ -34952,8 +35441,39 @@ var staleFunctionReferenceRule = createRule({
       if (text.length < 3) continue;
       if (RESERVED.has(text.toLowerCase())) continue;
       if (context.exports.has(text)) continue;
-      const end = Math.min(source.length, span.index + text.length + 50);
-      if (!/\(/.test(source.slice(span.index, end))) continue;
+      const lineEnd = source.indexOf("\n", span.index);
+      const restOfLine = source.slice(
+        span.index,
+        lineEnd === -1 ? source.length : lineEnd
+      );
+      const closeTick = restOfLine.indexOf("`", 1);
+      if (closeTick === -1) continue;
+      const afterTick = restOfLine.slice(closeTick + 1);
+      const directCall = /^\s*\(/.test(afterTick);
+      let identifierRepeats = false;
+      if (!directCall) {
+        const afterSpan = restOfLine.slice(closeTick + 1);
+        const needle = text + "(";
+        identifierRepeats = afterSpan.indexOf(needle) !== -1;
+      }
+      if (!directCall && !identifierRepeats) continue;
+      const beforeTickIdx = span.index - 1;
+      const beforeChar = beforeTickIdx >= 0 ? source[beforeTickIdx] : "";
+      if (beforeChar === "." || beforeChar === "|") continue;
+      const parenStart = restOfLine.indexOf("(", closeTick);
+      const parenEnd = restOfLine.indexOf(")", parenStart);
+      if (parenStart !== -1 && parenEnd !== -1) {
+        const inside = restOfLine.slice(parenStart + 1, parenEnd);
+        const trimmed = inside.trim();
+        if (looksLikeProseLabel(inside)) continue;
+        const looksLikeTypeAnnotation = !inside.includes(":") && (/\b(string|number|boolean|null|undefined|object|array|required|optional|categorical|direct|n\/a|\bmapped\b|0[\-–][0-9]+|v[0-9]|higher is better|lower is better|added in|deprecated|pr-[0-9])\b/i.test(
+          inside
+        ) || // Short single-word label (≤ 24 chars, no `,`,
+        // doesn't look like a function arg). Real function
+        // calls are usually longer or contain commas.
+        trimmed.length > 0 && trimmed.length <= 24 && !trimmed.includes(",") && /[a-zA-Z]/.test(trimmed));
+        if (looksLikeTypeAnnotation) continue;
+      }
       issues.push({
         ruleId: "docs/stale-function-reference",
         category: "docs",
@@ -35025,7 +35545,33 @@ var ENGLISH_WORD_DENYLIST = /* @__PURE__ */ new Set([
   "jsx",
   "ok",
   "no",
-  "yes"
+  "yes",
+  // v0.18.6: common English adjectives / adverbs that frequently
+  // appear in backticked prose but are not package names.
+  "aspirational",
+  "concrete",
+  "abstract",
+  "inline",
+  "exposed",
+  "deprecated",
+  "experimental",
+  "stable",
+  "beta",
+  "alpha",
+  "wip",
+  "draft",
+  "final",
+  "shim",
+  "polyfill",
+  "stub",
+  "mock",
+  "fake",
+  "real",
+  "false",
+  "true",
+  "optional",
+  "required",
+  "default"
 ]);
 var stalePackageReferenceRule = createRule({
   id: "docs/stale-package-reference",
@@ -35187,7 +35733,9 @@ var brokenLinkRule = createRule({
       if (target.startsWith("#")) continue;
       if (target.startsWith("//")) continue;
       if (target.startsWith("/")) continue;
-      const resolved = (0, import_node_path6.join)(docDir, target);
+      const filePart = target.split("#")[0] ?? target;
+      if (filePart === "") continue;
+      const resolved = (0, import_node_path6.join)(docDir, filePart);
       if ((0, import_node_fs6.existsSync)(resolved)) continue;
       issues.push({
         ruleId: "docs/broken-link",