gennady 0.8.4-draft.2 → 0.8.4-draft.3

package/dist/chunks/index-DvEQhXi2.js

@@ -1,1054 +0,0 @@
-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);