gennady 0.8.3 → 0.8.4-draft.2

package/dist/chunks/index-DvEQhXi2.js

@@ -0,0 +1,1054 @@
+import { execSync as pe } from "node:child_process";
+import { existsSync as ie, readFileSync as H, readdirSync as B, statSync as re, lstatSync as Re } from "node:fs";
+import { resolve as A, relative as Y, extname as G, join as Ne } from "node:path";
+import { l as E, ap as Ee, aq as Ie, ar as j, as as Te } from "./services-CwvXl2MB.js";
+import { p as Ce, aF as Le } from "./shared-DSZTUx5b.js";
+class O {
+  /** @purpose Collected lint errors — empty array when clean. */
+  errors;
+  /** @purpose Count of errors auto-fixed by DbcContractCheck. */
+  autoFixed;
+  /** @purpose Deduplicated task file paths resolved from @tasks annotations in linted files. */
+  taskPaths;
+  /** @purpose Deduplicated spec file paths resolved from task files. */
+  specPaths;
+  /** @purpose Agent guidance hint shown at the end of the report when relevant error families are present. */
+  guidance;
+  /**
+   * @purpose Creates a LintReport with collected errors, autoFixed count, resolved references, and optional guidance.
+   * @param errors Collected lint errors.
+   * @param [autoFixed] Count of auto-fixed errors, defaults to 0.
+   * @param [taskPaths] Resolved task file paths (deduplicated).
+   * @param [specPaths] Resolved spec file paths (deduplicated).
+   * @param [guidance] Agent guidance hint, defaults to undefined.
+   */
+  constructor(t, e = 0, s = [], o = [], i) {
+    this.errors = t, this.autoFixed = e, this.taskPaths = s, this.specPaths = o, this.guidance = i;
+  }
+  /** @purpose Returns 0 when no errors, 1 otherwise — ESLint convention. | @returns 0 for clean, 1 for errors. */
+  get exitCode() {
+    return this.errors.length > 0 ? 1 : 0;
+  }
+  /**
+   * @purpose Formats errors in ESLint-compatible output with resolved task/spec references.
+   * @returns ESLint-compatible formatted string with References block.
+   */
+  format() {
+    const t = [];
+    if (this.autoFixed > 0 && t.push(`Auto-fixed: ${this.autoFixed} error(s)`), this.errors.length > 0 && t.push(
+      ...this.errors.map(
+        (e) => `${e.file}:${e.line}:${e.col}: ${e.severity}: ${e.code}: ${e.message}`
+      )
+    ), this.errors.length > 0 && (this.specPaths.length > 0 || this.taskPaths.length > 0)) {
+      t.push(""), t.push("---"), t.push("Relevant specs & tasks for errors above:");
+      for (const e of this.specPaths)
+        t.push(`  ${e}`);
+      for (const e of this.taskPaths)
+        t.push(`  ${e}`);
+    }
+    return this.guidance && (t.push(""), t.push("---"), t.push(this.guidance)), t.join(`
+`);
+  }
+}
+const Z = "ERR_CLI_LINT_MISSING_FILE", q = "ERR_CLI_LINT_MISSING_CONSUMERS", ye = "ERR_CLI_LINT_ANCHOR_UNPAIRED_START", Se = "ERR_CLI_LINT_ANCHOR_UNPAIRED_END", ve = "ERR_CLI_LINT_ANCHOR_NESTING", P = "ERR_CLI_LINT_ANCHOR_MALFORMED", z = "ERR_CLI_LINT_NON_ENGLISH", Ae = "ERR_CLI_LINT_RESOLVE_FAILED", xe = "ERR_CLI_LINT_STAGED_CONFLICT", Oe = "ERR_CLI_LINT_UNAUTHORIZED_DISABLE", ke = "ERR_CLI_LINT_DISABLE_MISSING_PURPOSE", w = "ERR_CLI_LINT_TOO_MANY_INVARIANTS", De = "ERR_CLI_LINT_ANCHOR_AT_CLASS_BODY", $e = "ERR_CLI_LINT_ANCHOR_CONSECUTIVE_START", we = "ERR_CLI_LINT_ANCHOR_TOO_THIN", J = "ERR_CLI_LINT_TAG_TOO_MANY_WORDS", ce = "ERR_CLI_LINT_REGION_TOO_MANY_COMMENTS", ae = "ERR_CLI_LINT_REGION_START_ANNOTATION_TOO_LONG", be = "ERR_CLI_LINT_INVENTORY_UNDECLARED", Me = "ERR_CLI_LINT_INVENTORY_UNIMPLEMENTED", Fe = "ERR_CLI_LINT_UNKNOWN_FLAG", We = "ERR_CLI_LINT_SPEC_NOT_FOUND", Ue = "ERR_CLI_LINT_INVENTORY_REVERSE_NEEDS_SPEC";
+function Pe(n, t) {
+  const e = [];
+  if (n.length === 0)
+    return e.push({
+      file: t,
+      line: 1,
+      col: 1,
+      severity: "error",
+      code: Z,
+      message: "[FileHeaderCheck#check] Missing // @file: directive"
+    }), e.push({
+      file: t,
+      line: 1,
+      col: 1,
+      severity: "error",
+      code: q,
+      message: "[FileHeaderCheck#check] Missing // @consumers: directive"
+    }), e;
+  const s = n.split(`
+`);
+  let o = !1, i = !1;
+  for (const r of s) {
+    const c = r.trim();
+    if (c.startsWith("import ") || (c.startsWith("// @file:") && (o = !0), c.startsWith("// @consumers:") && (i = !0), o && i))
+      break;
+  }
+  return o || e.push({
+    file: t,
+    line: 1,
+    col: 1,
+    severity: "error",
+    code: Z,
+    message: "[FileHeaderCheck#check] Missing // @file: directive"
+  }), i || e.push({
+    file: t,
+    line: 1,
+    col: 1,
+    severity: "error",
+    code: q,
+    message: "[FileHeaderCheck#check] Missing // @consumers: directive"
+  }), e;
+}
+function F(n) {
+  let t = "", e = 0, s = !1, o = !1, i = !1;
+  for (; e < n.length; ) {
+    const r = n[e], c = n[e + 1] ?? "";
+    if (!s && !o && !i) {
+      if (r === "/" && c === "/") break;
+      if (r === "/" && c === "*") {
+        for (e += 2; e < n.length - 1 && !(n[e] === "*" && n[e + 1] === "/"); ) e++;
+        e += 2;
+        continue;
+      }
+    }
+    if (r === "\\") {
+      e += 2;
+      continue;
+    }
+    if (!o && !i && r === "'") {
+      s = !s, e++;
+      continue;
+    }
+    if (!s && !i && r === '"') {
+      o = !o, e++;
+      continue;
+    }
+    if (!s && !o && r === "`") {
+      i = !i, e++;
+      continue;
+    }
+    !s && !o && !i && (t += r), e++;
+  }
+  return t;
+}
+const He = /\/\/ #(region|endregion)\s+(START|END)_([A-Z0-9_]+)/, Ge = /\/\/ #(region|endregion)\s*$/;
+function Ve(n, t) {
+  const e = n.split(`
+`), s = [], o = [];
+  let i = 0;
+  const r = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map();
+  for (let a = 0; a < e.length; a++) {
+    const l = e[a], u = l.match(He);
+    if (i = Ye(l, i), u) {
+      const g = u[2], m = u[3], d = a + 1, p = u.index ?? 0, C = l.indexOf(g, p), N = (C >= 0 ? C : p) + 1;
+      if (g === "START") {
+        const _ = r.get(i), S = c.get(i) ?? !1;
+        _ && je(o, _) && !S && s.push({
+          file: t,
+          line: d,
+          col: N,
+          severity: "error",
+          code: $e,
+          message: `START_${m} immediately follows START_${_.name} at the same level — merge regions or close START_${_.name} first`
+        }), o.push({ name: m, line: d, col: N }), r.set(i, { name: m, line: d, col: N }), c.set(i, !1);
+        continue;
+      }
+      const L = Be(o, (_) => _.name === m);
+      if (L === -1)
+        s.push({
+          file: t,
+          line: d,
+          col: N,
+          severity: "error",
+          code: Se,
+          message: `END_${m} without matching START_${m} — add the missing opening anchor or remove this closing one`
+        });
+      else {
+        for (let _ = o.length - 1; _ > L; _--) {
+          const S = o[_];
+          s.push({
+            file: t,
+            line: d,
+            col: N,
+            severity: "error",
+            code: ve,
+            message: `END_${m} closes parent while START_${S.name} at line ${S.line} is still open — close inner block first`
+          });
+        }
+        o.length = L, r.delete(i), c.set(i, !1);
+      }
+      continue;
+    }
+    Je(l) && c.set(i, !0);
+    const f = l.match(Ge);
+    if (f) {
+      const g = a + 1, m = (f.index ?? 0) + 1;
+      if (f[1] === "endregion")
+        if (o.length > 0) {
+          const d = o[o.length - 1];
+          s.push({
+            file: t,
+            line: g,
+            col: m,
+            severity: "error",
+            code: P,
+            message: `#endregion without END_<NAME> — expected END_${d.name} (auto-closed by stack top START_${d.name} at line ${d.line})`
+          }), o.pop(), r.delete(i), c.set(i, !1);
+        } else
+          s.push({
+            file: t,
+            line: g,
+            col: m,
+            severity: "error",
+            code: P,
+            message: "#endregion without END_<NAME> — no open block to close"
+          });
+      else
+        s.push({
+          file: t,
+          line: g,
+          col: m,
+          severity: "error",
+          code: P,
+          message: "#region without START_<NAME> — add START_ prefix with a block name"
+        });
+    }
+  }
+  for (const a of o)
+    s.push({
+      file: t,
+      line: a.line,
+      col: a.col,
+      severity: "error",
+      code: ye,
+      message: `START_${a.name} without matching END_${a.name} — add the missing closing anchor`
+    });
+  return s.sort((a, l) => a.line - l.line || a.col - l.col), s;
+}
+function Be(n, t) {
+  for (let e = n.length - 1; e >= 0; e--)
+    if (t(n[e])) return e;
+  return -1;
+}
+function Ye(n, t) {
+  let e = t;
+  const s = F(n);
+  for (const o of s)
+    o === "{" ? e++ : o === "}" && e--;
+  return e;
+}
+function je(n, t) {
+  return n.some(
+    (e) => e.name === t.name && e.line === t.line && e.col === t.col
+  );
+}
+function Je(n) {
+  const t = n.trim();
+  return !(t === "" || t.startsWith("//") || t.startsWith("/*") && t.endsWith("*/"));
+}
+async function Xe(n, t, e) {
+  E.debug(`[DbcContractCheck#check] [idle → creating] ${t}`);
+  const s = new Ie(), o = new j(), i = new Ee(s, o);
+  try {
+    if (!e) {
+      const c = await i.lint(t, { content: n });
+      return E.info(
+        `[DbcContractCheck#check] [creating → linted] ${t} (${c.errors.length} errors)`
+      ), { errors: c.errors.map(Q), autoFixed: 0 };
+    }
+    const r = await i.lintAndFix(t, { content: n });
+    return E.info(
+      `[DbcContractCheck#check] [creating → fixed] ${t} (autoFixed=${r.autoFixed}, remaining=${r.errors.length})`
+    ), {
+      errors: r.errors.map(Q),
+      autoFixed: r.autoFixed
+    };
+  } catch (r) {
+    const c = new Error(`[DbcContractCheck#check] Lint failed for ${t}`, { cause: r });
+    throw E.error(`[DbcContractCheck#check] [creating → failed] ${t}`, { error: c }), c;
+  }
+}
+function Q(n) {
+  return {
+    file: n.file,
+    line: n.line,
+    col: n.col,
+    severity: "error",
+    code: n.code,
+    message: n.message
+  };
+}
+const ee = 8, Ke = /@ts-ignore|@ts-nocheck|@ts-expect-error|eslint-disable(?:-next-line|-line)?(?:-[a-z-]+)?\b/, Ze = /\bd-\d+\b/i;
+function qe(n) {
+  let t = !1, e = !1, s = !1;
+  for (let o = 0; o < n.length - 1; o++) {
+    const i = n[o], r = o > 0 ? n[o - 1] : "";
+    if (!t && !e && !s) {
+      if (i === "/" && (n[o + 1] === "/" || n[o + 1] === "*")) return o;
+      i === "'" ? t = !0 : i === '"' ? e = !0 : i === "`" && (s = !0);
+    } else r !== "\\" && (t && i === "'" ? t = !1 : e && i === '"' ? e = !1 : s && i === "`" && (s = !1));
+  }
+  return -1;
+}
+function ze(n, t) {
+  const e = n.split(`
+`), s = [];
+  for (let o = 0; o < e.length; o++) {
+    const i = e[o], r = qe(i);
+    if (r < 0) continue;
+    const c = i.slice(r), a = Ke.exec(c);
+    if (!a) continue;
+    const l = a[0], u = r + a.index + 1, f = Ze.exec(i);
+    if (!f) {
+      s.push({
+        file: t,
+        line: o + 1,
+        col: u,
+        severity: "error",
+        code: Oe,
+        message: `Unauthorized disable: \`${l}\` has no Decision Log reference. Add \`D-NNN\` (e.g., \`D-042\`) in the same comment line pointing to a Decision Log entry that authorizes this disable. Policy: see specs/cli/cli.spec.md#d-007.`
+      });
+      continue;
+    }
+    const g = Qe(c, l, f[0]);
+    g < ee && s.push({
+      file: t,
+      line: o + 1,
+      col: u,
+      severity: "error",
+      code: ke,
+      message: `Disable lacks purpose: \`${l}\` cites \`${f[0]}\` but the explanation is too short (${g} non-whitespace chars; need ≥ ${ee}). Add a purpose after the D-NNN reference, e.g., \`${l}: ${f[0]} — <why this disable is necessary>\`. Policy: see specs/cli/cli.spec.md#d-007.`
+    });
+  }
+  return s;
+}
+function Qe(n, t, e) {
+  let s = n.replace(t, "");
+  return s = s.replace(e, ""), s = s.replace(/\*\//g, ""), s = s.replace(/^\/\/|^\/\*/g, ""), s.replace(/\s/g, "").length;
+}
+const te = new RegExp("\\p{Script=Cyrillic}", "u");
+function et(n, t) {
+  const e = [], s = n.split(`
+`), o = tt(s);
+  for (let i = 0; i < s.length; i++) {
+    const r = s[i], c = i + 1, a = r.trim();
+    if (a.startsWith("// @file:") || a.startsWith("// @consumers:")) {
+      const l = [...r];
+      for (let u = 0; u < l.length; u++)
+        te.test(l[u]) && e.push({
+          file: t,
+          line: c,
+          col: u + 1,
+          severity: "error",
+          code: z,
+          message: `[LanguageCheck#check] Cyrillic character '${l[u]}' in file header — use English only`
+        });
+    }
+    if (o.has(i)) {
+      const l = [...r];
+      for (let u = 0; u < l.length; u++)
+        if (te.test(l[u])) {
+          e.push({
+            file: t,
+            line: c,
+            col: u + 1,
+            severity: "error",
+            code: z,
+            message: `[LanguageCheck#check] Cyrillic character '${l[u]}' in JSDoc contract — use English only`
+          });
+          break;
+        }
+    }
+  }
+  return e;
+}
+function tt(n) {
+  const t = /* @__PURE__ */ new Set();
+  let e = !1;
+  for (let s = 0; s < n.length; s++) {
+    const o = n[s].trim();
+    if (o.startsWith("/**")) {
+      e = !0, t.add(s), o.endsWith("*/") && (e = !1);
+      continue;
+    }
+    e && (t.add(s), o.includes("*/") && (e = !1));
+  }
+  return t;
+}
+const nt = /^\s*export\s+(?:(?:default\s+)?(?:function|class|abstract\s+class|interface))\s+(\w+)/, st = /^\s*(?:function|class|abstract\s+class|interface)\s+(\w+)/, ot = /\/\/\s*#region\s+START_\w+.*\binvariant\s*:/;
+function it(n, t, e) {
+  const s = n.split(`
+`), o = [];
+  let i = 0;
+  const r = [];
+  let c = null, a = !1, l = "", u = 0, f = 0, g = !1, m = [];
+  for (let d = 0; d < s.length; d++) {
+    const p = s[d], C = d + 1, N = p.trim();
+    if (N.startsWith("/**"))
+      if (N.includes("*/") && N.length > 3) {
+        const v = ne(N);
+        m = [];
+        for (let y = 0; y < v; y++) m.push(C);
+      } else {
+        g = !0, m = [];
+        continue;
+      }
+    if (g) {
+      if (N.includes("*/")) {
+        g = !1;
+        continue;
+      }
+      const v = ne(N);
+      for (let y = 0; y < v; y++) m.push(C);
+      continue;
+    }
+    const L = p.match(nt), _ = N.includes("*/") ? N.slice(N.lastIndexOf("*/") + 2) : null, S = _ ? _.match(
+      /^\s*export\s+(?:(?:default\s+)?(?:function|class|abstract\s+class|interface))\s+(\w+)/
+    ) : null, R = L || S, k = S ? N.lastIndexOf("*/") + 2 : 0;
+    if (R) {
+      a = !0, l = R[1], u = C;
+      const v = (R.index ?? 0) + k, y = p.indexOf(l, v);
+      f = (y >= 0 ? y : v) + 1;
+    } else m.length > 0 && st.test(p) && (m = []);
+    const D = F(p);
+    for (const v of D)
+      if (v === "{") {
+        if (i++, a) {
+          const y = {
+            name: l,
+            nameLine: u,
+            nameCol: f,
+            bodyDepth: i,
+            jsdocCount: m.length,
+            regionCount: 0
+          };
+          r.push(y), c = y, a = !1, m = [];
+        }
+      } else v === "}" && (c && i === c.bodyDepth && (c.jsdocCount > e && o.push({
+        file: t,
+        line: c.nameLine,
+        col: c.nameCol,
+        severity: "error",
+        code: w,
+        message: `Entity "${c.name}" has ${c.jsdocCount} JSDoc @invariant tags (max ${e}) — consider reviewing the contract; too many invariants suggest the entity is overloaded`
+      }), c.regionCount > e && o.push({
+        file: t,
+        line: c.nameLine,
+        col: c.nameCol,
+        severity: "error",
+        code: w,
+        message: `Entity "${c.name}" has ${c.regionCount} region invariants (max ${e}) — consider reviewing the contract; too many region invariants suggest the entity is overloaded`
+      }), r.pop(), c = r.length > 0 ? r[r.length - 1] : null), i--);
+    c && ot.test(p) && c.regionCount++;
+  }
+  for (const d of r)
+    d.jsdocCount > e && o.push({
+      file: t,
+      line: d.nameLine,
+      col: d.nameCol,
+      severity: "error",
+      code: w,
+      message: `Entity "${d.name}" has ${d.jsdocCount} JSDoc @invariant tags (max ${e}) — consider reviewing the contract; too many invariants suggest the entity is overloaded`
+    }), d.regionCount > e && o.push({
+      file: t,
+      line: d.nameLine,
+      col: d.nameCol,
+      severity: "error",
+      code: w,
+      message: `Entity "${d.name}" has ${d.regionCount} region invariants (max ${e}) — consider reviewing the contract; too many region invariants suggest the entity is overloaded`
+    });
+  return o.sort((d, p) => d.line - p.line || d.col - p.col), o;
+}
+function ne(n) {
+  const t = n.match(/@invariant\b/g);
+  return t ? t.length : 0;
+}
+const rt = /\/\/ #(region|endregion)\s+(START|END)_([A-Z0-9_]+)/;
+function ct(n, t) {
+  const e = n.split(`
+`), s = [];
+  let o = 0;
+  const i = [];
+  let r = !1;
+  for (let c = 0; c < e.length; c++) {
+    const a = e[c], l = c + 1;
+    /\b(?:class|namespace)\s+\w/.test(F(a)) && (r = !0);
+    const u = F(a);
+    for (const g of u)
+      g === "{" ? (o++, r && (i.push(o), r = !1)) : g === "}" && (i.length > 0 && o === i[i.length - 1] && i.pop(), o--);
+    const f = a.match(rt);
+    if (f && i.length > 0 && o === i[i.length - 1]) {
+      const g = f[3], d = f[2] === "START" ? "START" : "END", C = (f.index ?? 0) + 1;
+      s.push({
+        file: t,
+        line: l,
+        col: C,
+        severity: "error",
+        code: De,
+        message: `#region ${d}_${g} at class body level — regions must not separate class members; move inside a method body or remove`
+      });
+    }
+  }
+  return s.sort((c, a) => c.line - a.line || c.col - a.col), s;
+}
+const le = /\/\/ #(region|endregion)\s+(START|END)_([A-Z0-9_]+)/, ue = 2;
+function at(n, t) {
+  const e = n.split(`
+`), s = [], o = [];
+  for (let i = 0; i < e.length; i++) {
+    const r = e[i], c = r.match(le);
+    if (c && c[2] === "START") {
+      const a = c[3], l = c.index ?? 0, u = r.indexOf("START", l), f = (u >= 0 ? u : l) + 1, m = r.slice(l + c[0].length).trim().length > 0;
+      o.push({
+        name: a,
+        startLine: i + 1,
+        col: f,
+        meaningfulCount: 0,
+        hasStartAnnotation: m,
+        hasBodyComment: !1
+      });
+      continue;
+    }
+    if (c && c[2] === "END") {
+      const a = c[3], l = ut(o, (u) => u.name === a);
+      if (l !== -1) {
+        const u = o[l];
+        u.meaningfulCount < ue && s.push(lt(t, u)), o.length = l;
+      }
+      continue;
+    }
+    if (o.length !== 0)
+      if (ft(r))
+        for (const a of o)
+          a.meaningfulCount++;
+      else dt(r) && (o[o.length - 1].hasBodyComment = !0);
+  }
+  return s.sort((i, r) => i.line - r.line || i.col - r.col), s;
+}
+function lt(n, t) {
+  const { name: e, startLine: s, col: o, meaningfulCount: i, hasStartAnnotation: r, hasBodyComment: c } = t;
+  let a;
+  return i === 0 && (r || c) ? a = `START_${e} wraps only comments — keep the comment(s) and remove the region wrapper` : i === 0 ? a = `START_${e} is empty (0 meaningful lines) — remove the empty region` : r ? a = `START_${e} has only ${i} meaningful line(s) + annotation — keep the annotation as a plain comment and remove the region wrapper` : a = `START_${e} has only ${i} meaningful line(s) — regions need at least ${ue} lines of code; consider removing the region`, {
+    file: n,
+    line: s,
+    col: o,
+    severity: "error",
+    code: we,
+    message: a
+  };
+}
+function ut(n, t) {
+  for (let e = n.length - 1; e >= 0; e--)
+    if (t(n[e])) return e;
+  return -1;
+}
+function ft(n) {
+  const t = n.trim();
+  return !(t === "" || t.startsWith("//") || t.startsWith("/*") && t.endsWith("*/"));
+}
+function dt(n) {
+  const t = n.trim();
+  return t.startsWith("//") ? !le.test(t) : !1;
+}
+const b = /@(?:param|returns|purpose|implements|invariant|sideEffect|consumer|see|post|throws|pre|tasks)\b/, ht = /^\/\/\s*@(?:file|consumers):/;
+function fe(n) {
+  return n.trim().split(/\s+/).filter(Boolean).length;
+}
+function mt(n, t, e) {
+  const s = n.split(`
+`), o = [];
+  let i = !1, r = [];
+  for (let c = 0; c < s.length; c++) {
+    const a = s[c], l = a.trim();
+    if (l.startsWith("/**")) {
+      i = !0, r = [a], l.endsWith("*/") && (i = !1, o.push(...se(r, t, c + 1, c + 1, e)));
+      continue;
+    }
+    if (i && (r.push(a), l.includes("*/"))) {
+      i = !1;
+      const u = c + 1 - r.length + 1, f = c + 1;
+      o.push(...se(r, t, u, f, e));
+    }
+  }
+  for (let c = 0; c < s.length; c++) {
+    const a = s[c], l = c + 1, u = a.trim();
+    if (u.startsWith("import "))
+      break;
+    if (u.match(ht)) {
+      const g = u.slice(u.indexOf(":") + 1).trim(), m = fe(g);
+      if (m > e) {
+        const d = u.startsWith("// @file:") ? "@file" : "@consumers", p = u.indexOf(":") + 2;
+        o.push({
+          file: t,
+          line: l,
+          col: p,
+          severity: "error",
+          code: J,
+          message: `[WordCountCheck#check] ${d} has ${m} words (max ${e}) — shorten the description`
+        });
+      }
+    }
+  }
+  return o.sort((c, a) => c.line - a.line || c.col - a.col), o;
+}
+function gt(n, t) {
+  const s = n.map((i) => {
+    let r = i.trim();
+    return r.startsWith("/**") && (r = r.slice(3)), r.endsWith("*/") && (r = r.slice(0, r.length - 2).trim()), r.startsWith("*") && (r = r.slice(1)), r;
+  }).join(`
+`).slice(t), o = s.slice(1).search(b);
+  return o === -1 ? s.slice(1) : s.slice(1, o + 1);
+}
+function se(n, t, e, s, o) {
+  const i = [], c = n.map((l) => {
+    let u = l.trim();
+    return u.startsWith("/**") && (u = u.slice(3)), u.endsWith("*/") && (u = u.slice(0, u.length - 2).trim()), u.startsWith("*") && (u = u.slice(1)), u;
+  }).join(`
+`);
+  let a = 0;
+  for (; a < c.length; ) {
+    b.lastIndex = 0;
+    const l = b.exec(c.slice(a));
+    if (!l) break;
+    const u = l[0], f = a + (l.index ?? 0), g = gt(n, f), m = fe(g);
+    if (m > o) {
+      let p = 0, C = e, N = 1;
+      for (let L = 0; L < n.length; L++) {
+        const _ = n[L].length + 1;
+        if (p + _ > f) {
+          C = e + L, N = f - p + 1;
+          break;
+        }
+        p += _;
+      }
+      i.push({
+        file: t,
+        line: C,
+        col: N,
+        severity: "error",
+        code: J,
+        message: `[WordCountCheck#check] ${u} has ${m} words (max ${o}) — shorten the description`
+      });
+    }
+    if (a = f + u.length, a >= c.length) break;
+    const d = c.slice(a).search(b);
+    if (d === -1) break;
+    a += d;
+  }
+  return i;
+}
+const de = /\/\/ #(region|endregion)\s+(START|END)_([A-Z0-9_]+)/, oe = 30;
+function _t(n) {
+  return n.trim().split(/\s+/).filter(Boolean).length;
+}
+function pt(n) {
+  const t = n.trim();
+  return t.startsWith("//") ? !de.test(t) : !1;
+}
+function Rt(n, t, e) {
+  const s = n.split(`
+`), o = [], i = [];
+  for (let r = 0; r < s.length; r++) {
+    const c = s[r], a = c.match(de);
+    if (a && a[2] === "START") {
+      const l = a[3], u = a.index ?? 0, f = c.indexOf("START", u), g = (f >= 0 ? f : u) + 1, m = c.slice(u + a[0].length).trim(), d = m.length > 0 ? _t(m) : 0;
+      d > oe && o.push({
+        file: t,
+        line: r + 1,
+        col: g,
+        severity: "error",
+        code: ae,
+        message: `START_${l} annotation has ${d} words (max ${oe}) — shorten the annotation`
+      }), i.push({
+        name: l,
+        startLine: r + 1,
+        col: g,
+        commentCount: 0,
+        startAnnotationWords: d
+      });
+      continue;
+    }
+    if (a && a[2] === "END") {
+      const l = a[3], u = Nt(i, (f) => f.name === l);
+      if (u !== -1) {
+        const f = i[u];
+        f.commentCount > e && o.push({
+          file: t,
+          line: f.startLine,
+          col: f.col,
+          severity: "error",
+          code: ce,
+          message: `START_${l} has ${f.commentCount} comment lines (max ${e}) — reduce comments or extract them outside the region`
+        }), i.length = u;
+      }
+      continue;
+    }
+    if (i.length !== 0 && pt(c))
+      for (const l of i)
+        l.commentCount++;
+  }
+  return o.sort((r, c) => r.line - c.line || r.col - c.col), o;
+}
+function Nt(n, t) {
+  for (let e = n.length - 1; e >= 0; e--)
+    if (t(n[e])) return e;
+  return -1;
+}
+async function Et(n, t, e) {
+  const s = await new j().parseFile(t, n);
+  if (!s.ok) return [];
+  const o = new Set(e);
+  return s.exported.filter((i) => !o.has(i.name)).map((i) => ({
+    file: t,
+    line: 1,
+    col: 1,
+    severity: "error",
+    code: be,
+    message: `Exported \`${i.name}\` is not in the module's closed-world Entity Inventory (AX_CLOSED_WORLD_INVENTORY). Fix: remove it, or — if genuinely needed — log an \`intro <name> ← <reason>\` line (AX_INTRODUCED_DISCIPLINE) and backflow it into the spec inventory; never silently keep an undeclared export. If you added it under drift / context loss, re-read the module spec ## 3 Entity Inventory and AX_INTRODUCED_DISCIPLINE.`
+  }));
+}
+async function It(n, t) {
+  const e = await new j().parseFile(t, n);
+  return e.ok ? e.exported.map((s) => s.name) : [];
+}
+function Tt(n, t, e) {
+  return n.filter((s) => !t.has(s)).map((s) => ({
+    file: e,
+    line: 1,
+    col: 1,
+    severity: "error",
+    code: Me,
+    message: `Inventory entity \`${s}\` is declared in the spec but exported by no scanned file — planned-but-unbuilt or renamed-away. Fix: implement it, or remove the stale inventory row (and supersede the decision that introduced it). If the sweep did not cover the whole module, re-run \`lint --spec=<spec> --inventory-reverse <module-dir>\` over the full code root before trusting this.`
+  }));
+}
+function Ct(n, t = "tasks") {
+  const e = /* @__PURE__ */ new Map(), s = A(n, t);
+  if (!ie(s))
+    return e;
+  const o = St(s);
+  for (const i of o) {
+    let r;
+    try {
+      r = H(i, "utf-8");
+    } catch {
+      continue;
+    }
+    const c = r.match(/-\s+\*\*Task-ID:\*\*\s+(TSK-\d+)/);
+    if (!c) continue;
+    const a = c[1], l = Y(n, i), u = Lt(r, n);
+    e.set(a, { taskPath: l, specPaths: u });
+  }
+  return e;
+}
+function Lt(n, t) {
+  const e = /* @__PURE__ */ new Set(), s = n.match(/\*\*Spec References:\*\*[\s\S]*?(?=\n- \*\*|$)/);
+  if (!s) return [];
+  const o = s[0], i = /\[([^\]]*)\]\(([^)]+\.md)[^)]*\)/g;
+  let r;
+  for (; (r = i.exec(o)) !== null; ) {
+    const c = r[2].split("/").pop();
+    if (!c) continue;
+    const a = yt(A(t, "specs"), c);
+    if (a) {
+      const l = Y(t, a);
+      l.startsWith("..") || e.add(l);
+    }
+  }
+  return [...e].sort();
+}
+function yt(n, t) {
+  if (!ie(n)) return null;
+  const e = [n];
+  for (; e.length > 0; ) {
+    const s = e.pop();
+    let o;
+    try {
+      o = B(s);
+    } catch {
+      continue;
+    }
+    for (const i of o) {
+      const r = A(s, i);
+      try {
+        const c = re(r);
+        if (c.isDirectory())
+          e.push(r);
+        else if (c.isFile() && i === t)
+          return r;
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+function St(n) {
+  const t = [], e = [n];
+  for (; e.length > 0; ) {
+    const s = e.pop();
+    let o;
+    try {
+      o = B(s);
+    } catch {
+      continue;
+    }
+    for (const i of o) {
+      const r = A(s, i);
+      try {
+        const c = re(r);
+        c.isDirectory() ? e.push(r) : c.isFile() && i.endsWith(".md") && t.push(r);
+      } catch {
+      }
+    }
+  }
+  return t;
+}
+function vt(n) {
+  const t = n.match(/@tasks:\s*(.+)/m);
+  return t ? t[1].split(/[,;\s]+/).map((e) => e.trim()).filter((e) => /^TSK-\d+$/.test(e)) : [];
+}
+function At(n, t) {
+  const e = /* @__PURE__ */ new Set(), s = /* @__PURE__ */ new Set();
+  for (const o of n) {
+    const i = t.get(o);
+    if (i) {
+      e.add(i.taskPath);
+      for (const r of i.specPaths)
+        s.add(r);
+    }
+  }
+  return {
+    taskPaths: [...e].sort(),
+    specPaths: [...s].sort()
+  };
+}
+function xt(n) {
+  let t = "", e = 0;
+  for (; e < n.length; ) {
+    const s = n[e], o = n[e + 1];
+    if (s === "*" && o === "*")
+      n[e + 2] === "/" ? (t += "(?:.*\\/)?", e += 3) : (e + 2 >= n.length, t += ".*", e += 2);
+    else if (s === "*")
+      t += "[^/]*", e++;
+    else if (s === "?")
+      t += "[^/]", e++;
+    else if (s === ".")
+      t += "\\.", e++;
+    else if (s === "[") {
+      const i = n.indexOf("]", e);
+      i !== -1 ? (t += n.slice(e, i + 1), e = i + 1) : (t += "\\[", e++);
+    } else
+      t += Ot(s), e++;
+  }
+  return new RegExp("^" + t + "$");
+}
+function Ot(n) {
+  return "^$\\+*.?{}[]()|/".includes(n) ? "\\" + n : n;
+}
+async function kt(n) {
+  let t;
+  try {
+    t = Ce(
+      n,
+      {
+        autofix: ["autofix"],
+        staged: ["staged"],
+        verbose: ["verbose", "v"],
+        maxInvariants: { aliases: ["max-invariants"], takesValue: !0 },
+        exclude: { aliases: ["exclude"], takesValue: !0 },
+        maxWords: { aliases: ["max-words"], takesValue: !0 },
+        maxRegionComments: { aliases: ["max-region-comments"], takesValue: !0 },
+        spec: { aliases: ["spec"], takesValue: !0 },
+        inventoryReverse: { aliases: ["inventory-reverse"], takesValue: !0 }
+      },
+      { strict: !0 }
+    );
+  } catch (h) {
+    const T = h instanceof Error ? h.message : String(h);
+    return E.warn(`[LintCommand#run] [idle → failed] ${T}`), new O([
+      {
+        file: "",
+        line: 0,
+        col: 0,
+        severity: "error",
+        code: Fe,
+        message: T
+      }
+    ]);
+  }
+  const e = t._.filter(
+    (h) => typeof h == "string" && h !== "lint"
+  ), s = t.autofix === !0 || t.autofix === "true", o = t.staged === !0 || t.staged === "true", i = t.verbose === !0 || t.verbose === "true", r = typeof t.maxInvariants == "string" ? parseInt(t.maxInvariants, 10) : 3, c = typeof t.maxWords == "string" ? parseInt(t.maxWords, 10) : 25, a = typeof t.maxRegionComments == "string" ? parseInt(t.maxRegionComments, 10) : 3, l = typeof t.spec == "string" ? t.spec : null, u = typeof t.inventoryReverse == "string" ? t.inventoryReverse : null;
+  if (u && !l) {
+    const h = {
+      file: "",
+      line: 0,
+      col: 0,
+      severity: "error",
+      code: Ue,
+      message: "--inventory-reverse requires --spec=<module-spec> — the reverse sweep checks that spec’s Entity Inventory against the code."
+    };
+    return E.warn("[LintCommand#run] --inventory-reverse given without --spec"), new O([h]);
+  }
+  let f = null;
+  const g = [];
+  if (l)
+    try {
+      f = Le(H(A(l), "utf-8"));
+    } catch (h) {
+      const T = h instanceof Error ? h.message : String(h);
+      g.push({
+        file: l,
+        line: 0,
+        col: 0,
+        severity: "error",
+        code: We,
+        message: `Cannot read --spec target: ${T}`
+      }), E.warn(`[LintCommand#run] --spec unreadable: ${l}`);
+    }
+  const m = f !== null && f.length === 0;
+  m && console.log(
+    `ℹ️  [LintCommand#run] ${l} has no Entity Inventory section — nothing to verify`
+  ), u && e.length === 0 && !o && e.push(u);
+  const d = [
+    "**/node_modules/**",
+    "**/__tests__/**",
+    "**/fixtures/**",
+    "**/__tests__/fixtures/**",
+    "**/dist/**",
+    "**/coverage/**",
+    "**/build/**",
+    "**/out/**"
+  ], p = t.exclude, C = Array.isArray(p) ? p : typeof p == "string" ? [p] : [], L = [...d, ...C].map(xt);
+  i && Te("debug");
+  let _;
+  const S = [];
+  if (o) {
+    if (e.length > 0) {
+      const h = {
+        file: "",
+        line: 0,
+        col: 0,
+        severity: "error",
+        code: xe,
+        message: "--staged and positional targets are mutually exclusive. Use either --staged or provide file/directory paths, not both."
+      };
+      return E.warn("[LintCommand#run] --staged and positional targets are mutually exclusive"), new O([h]);
+    }
+    E.debug("[LintCommand#run] [idle → collecting] staged mode");
+    try {
+      _ = pe("git diff --staged --name-only", { encoding: "utf-8" }).trim().split(`
+`).filter(Boolean).filter((T) => T.endsWith(".ts")), _ = [...new Set(_)];
+    } catch (h) {
+      const T = new Error("[LintCommand#run] Git scan failed — not a git repository?", {
+        cause: h
+      });
+      throw E.error("[LintCommand#run] [collecting → failed]", { error: T }), T;
+    }
+  } else if (e.length > 0) {
+    E.debug(`[LintCommand#run] [idle → resolving] ${e.length} target(s)`);
+    const h = $t(e);
+    _ = h.files, S.push(...h.errors);
+    for (const T of h.errors)
+      E.warn(`[LintCommand#run] [resolving → failed] ${T.file}: ${T.message}`);
+  } else
+    _ = [];
+  if (_.length > 0 && L.length > 0) {
+    const h = _.length, T = A(".");
+    _ = _.filter((I) => {
+      const W = I.startsWith("/") ? Y(T, I) : I;
+      return !L.some(($) => $.test(W));
+    }), E.debug(`[LintCommand#run] [filtering → filtered] ${h} → ${_.length} file(s)`);
+  }
+  if (_.length === 0)
+    return E.debug("[LintCommand#run] [collecting → done] no files to lint"), new O([...S, ...g]);
+  E.debug(`[LintCommand#run] [collecting → linting] ${_.length} file(s)`);
+  const R = [...S, ...g];
+  let k = 0;
+  const D = /* @__PURE__ */ new Set(), v = A("."), y = Ct(v), X = /* @__PURE__ */ new Set();
+  for (const h of _) {
+    const T = A(h);
+    let I;
+    try {
+      E.debug(`[LintCommand#run] [linting → reading] ${h}`), I = H(T, "utf-8");
+    } catch (x) {
+      const U = new Error(`[LintCommand#run] Cannot read file: ${h}`, { cause: x });
+      E.error(`[LintCommand#run] [reading → failed] ${h}`, { error: U });
+      continue;
+    }
+    const W = R.length;
+    R.push(...Pe(I, h)), R.push(...Ve(I, h)), R.push(...et(I, h)), R.push(...ze(I, h)), R.push(...ct(I, h)), R.push(...at(I, h)), R.push(...it(I, h, r)), R.push(...mt(I, h, c)), R.push(...Rt(I, h, a));
+    const $ = await Xe(I, h, s);
+    if (R.push(...$.errors), k += $.autoFixed, f !== null && !m && (R.push(...await Et(I, h, f)), u))
+      for (const x of await It(I, h)) D.add(x);
+    if (R.length > W) {
+      const x = vt(I);
+      for (const U of x)
+        X.add(U);
+    }
+  }
+  u && f !== null && l && !m && R.push(...Tt(f, D, l));
+  const { taskPaths: me, specPaths: ge } = At([...X], y), _e = Mt(R), K = new O(R, k, me, ge, _e);
+  return K.exitCode === 1 ? console.log(`❌ [LintCommand#run] [linting → failed] ${R.length} error(s)`) : console.log("✅ [LintCommand#run] [linting → clean] no errors"), K;
+}
+const V = [".ts", ".tsx"], Dt = /* @__PURE__ */ new Set(["node_modules", "dist", "coverage", "build", "out", "__tests__"]);
+function $t(n) {
+  E.debug(`[resolveTargets] [idle → resolving] ${n.length} target(s)`);
+  const t = /* @__PURE__ */ new Set(), e = [];
+  for (const o of n) {
+    const i = G(o).toLowerCase();
+    if (i && !V.includes(i) && !o.endsWith("/"))
+      continue;
+    let r;
+    try {
+      r = Re(o);
+    } catch (a) {
+      const l = a;
+      e.push({
+        file: o,
+        line: 0,
+        col: 0,
+        severity: "error",
+        code: Ae,
+        message: `${o}: ${l.code ?? "UNKNOWN"}: ${l.message}`
+      });
+      continue;
+    }
+    if (r.isSymbolicLink())
+      continue;
+    const c = A(o);
+    if (r.isDirectory())
+      he(c, t);
+    else if (r.isFile()) {
+      const a = G(o).toLowerCase();
+      V.includes(a) && t.add(c);
+    }
+  }
+  const s = [...t].sort();
+  return E.debug(
+    `[resolveTargets] [resolving → resolved] ${s.length} file(s), ${e.length} error(s)`
+  ), { files: s, errors: e };
+}
+function he(n, t) {
+  let e;
+  try {
+    e = B(n, { withFileTypes: !0 });
+  } catch {
+    return;
+  }
+  for (const s of e) {
+    const o = Ne(n, s.name);
+    if (!s.name.startsWith(".") && !Dt.has(s.name) && !s.isSymbolicLink()) {
+      if (s.isDirectory())
+        he(o, t);
+      else if (s.isFile()) {
+        const i = G(s.name).toLowerCase();
+        V.includes(i) && t.add(o);
+      }
+    }
+  }
+}
+const wt = "WORD_COUNT errors found — consider reviewing each affected contract as a whole. Tag-by-tag truncation risks breaking cross-tag consistency. Technique: (1) remove filler words, (2) compress overlapping @purpose/@param/@returns, (3) keep entity names and spec refs.", bt = "REGION_COMMENT errors found — reduce comment density inside #region blocks. Merge adjacent comment lines, move descriptive text outside the region, or split the region. Verify the region still has ≥2 meaningful code lines after cleanup (see AnchorThinCheck).";
+function Mt(n) {
+  const t = new Set(n.map((s) => s.code)), e = [];
+  if ((t.has(J) || t.has(ae)) && e.push(wt), t.has(ce) && e.push(bt), e.length !== 0)
+    return e.join(`
+
+`);
+}
+const M = await kt(process.argv);
+(M.exitCode === 1 || M.autoFixed > 0) && console.log(M.format());
+process.exit(M.exitCode);