gennady 0.7.0 → 0.8.0

package/dist/chunks/index-BgKyH0dB.js

@@ -0,0 +1,658 @@
+import { readdirSync as T, lstatSync as P, existsSync as z, readFileSync as D, statSync as q } from "node:fs";
+import { resolve as w, join as R, extname as H, basename as N, relative as x, sep as E } from "node:path";
+import { l as S, a as G } from "./services-IgZptnTi.js";
+const U = [".ts", ".tsx"], J = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "coverage",
+  "build",
+  "out",
+  "__tests__"
+]), Q = /\.(test|spec)\.(ts|tsx)$/;
+function F(i) {
+  const e = /* @__PURE__ */ new Set(), n = w(i);
+  return _(n, e), [...e].sort();
+}
+function _(i, e) {
+  let n;
+  try {
+    n = T(i, { withFileTypes: !0 });
+  } catch {
+    return;
+  }
+  for (const t of n) {
+    if (t.name.startsWith(".") || J.has(t.name)) continue;
+    const o = R(i, t.name);
+    let s;
+    try {
+      s = P(o);
+    } catch {
+      continue;
+    }
+    if (!s.isSymbolicLink()) {
+      if (s.isDirectory())
+        _(o, e);
+      else if (s.isFile()) {
+        if (Q.test(t.name)) continue;
+        const r = H(t.name).toLowerCase();
+        U.includes(r) && e.add(o);
+      }
+    }
+  }
+}
+function V(i) {
+  const e = { file: "", tasks: [], consumers: [] };
+  if (i.length === 0) return e;
+  const n = i.split(`
+`);
+  for (const t of n) {
+    const o = t.trim();
+    if (o.startsWith("import ")) break;
+    if (o.startsWith("// @file:") && (e.file = o.slice(9).trim()), o.startsWith("// @tasks:")) {
+      const s = o.slice(10);
+      e.tasks = s.split(/[,;\s]+/).map((r) => r.trim()).filter((r) => /^TSK-\d+$/.test(r));
+    }
+    if (o.startsWith("// @consumers:")) {
+      const s = o.slice(14);
+      e.consumers = s.split(/[,;]+/).map((r) => r.trim()).filter(Boolean);
+    }
+  }
+  return e;
+}
+function Y(i) {
+  const e = /* @__PURE__ */ new Map();
+  for (const n of i) {
+    const t = I(n.header.file);
+    for (const o of t)
+      L(e, o, { file: n.absPath, source: "file" });
+    for (const o of n.exports) {
+      const s = o.contract.entries.find(
+        (c) => c.type === "purpose" || c.type === "description"
+      );
+      if (!s) continue;
+      const r = I(s.value);
+      for (const c of r)
+        L(e, c, { file: n.absPath, source: "entity", entity: o.name });
+    }
+  }
+  return e;
+}
+function I(i) {
+  return i.toLowerCase().split(/[^a-z0-9_]+/).filter((e) => e.length > 1);
+}
+function L(i, e, n) {
+  let t = i.get(e);
+  t || (t = /* @__PURE__ */ new Set(), i.set(e, t)), t.add(n);
+}
+function Z(i, e) {
+  if (e.length === 0) return [];
+  const n = [];
+  for (const t of e) {
+    const o = i.filter((s) => s.header.tasks.includes(t));
+    n.push({ taskId: t, files: o });
+  }
+  return n;
+}
+function W(i, e) {
+  const n = i.length, t = e.length, o = [];
+  for (let s = 0; s <= n; s++)
+    o[s] = [], o[s][0] = s;
+  for (let s = 0; s <= t; s++)
+    o[0][s] = s;
+  for (let s = 1; s <= n; s++)
+    for (let r = 1; r <= t; r++) {
+      const c = i[s - 1] === e[r - 1] ? 0 : 1;
+      o[s][r] = Math.min(
+        o[s - 1][r] + 1,
+        // deletion
+        o[s][r - 1] + 1,
+        // insertion
+        o[s - 1][r - 1] + c
+        // substitution
+      ), s > 1 && r > 1 && i[s - 1] === e[r - 2] && i[s - 2] === e[r - 1] && (o[s][r] = Math.min(o[s][r], o[s - 2][r - 2] + c));
+    }
+  return o[n][t];
+}
+function A(i, e, n) {
+  if (e.length === 0) return [];
+  const t = [];
+  for (const o of e) {
+    const s = i.filter((r) => n ? r.header.consumers.some((c) => {
+      const f = o.length <= 5 ? 2 : 3;
+      return W(o.toLowerCase(), c.toLowerCase()) <= f;
+    }) : r.header.consumers.some((c) => c.toLowerCase().includes(o.toLowerCase())));
+    t.push({ consumerName: o, files: s });
+  }
+  return t;
+}
+function ee(i, e, n) {
+  const t = n.trim();
+  if (t.length === 0) return [];
+  const o = t.toLowerCase().split(/\s+/).filter(Boolean), s = /* @__PURE__ */ new Map();
+  for (const l of i)
+    s.set(l.absPath, l);
+  const r = /* @__PURE__ */ new Map(), c = [];
+  for (const l of o) {
+    const p = /* @__PURE__ */ new Set(), m = e.get(l);
+    if (m)
+      for (const u of m) {
+        p.add(u.file);
+        const g = r.get(u.file) ?? { score: 0 };
+        g.score += 10, u.source === "entity" && u.entity && (g.entityName = u.entity), r.set(u.file, g);
+      }
+    for (const [u, g] of e)
+      if (u !== l && u.startsWith(l))
+        for (const d of g) {
+          p.add(d.file);
+          const h = r.get(d.file) ?? { score: 0 };
+          h.score += 5, d.source === "entity" && d.entity && !h.entityName && (h.entityName = d.entity), r.set(d.file, h);
+        }
+    for (const [u, g] of e) {
+      const d = l.length <= 5 ? 2 : 3;
+      if (W(l, u) <= d && u !== l && !u.startsWith(l))
+        for (const h of g) {
+          p.add(h.file);
+          const y = r.get(h.file) ?? { score: 0 };
+          y.score += 3, h.source === "entity" && h.entity && !y.entityName && (y.entityName = h.entity), r.set(h.file, y);
+        }
+    }
+    c.push(p);
+  }
+  let f = /* @__PURE__ */ new Set();
+  if (c.length > 0) {
+    f = c[0];
+    for (let l = 1; l < c.length; l++)
+      f = new Set([...f].filter((p) => c[l].has(p)));
+  }
+  const a = [];
+  for (const l of f) {
+    const p = s.get(l);
+    if (!p) continue;
+    const m = r.get(l);
+    a.push({
+      file: p,
+      score: m?.score ?? 0,
+      entityName: m?.entityName
+    });
+  }
+  return a.sort((l, p) => p.score - l.score), a;
+}
+function te(i, e, n) {
+  if (e.length === 0) return [];
+  const t = [];
+  for (const o of i)
+    for (const s of o.exports)
+      for (const r of e) {
+        if (!n && s.name === r) {
+          t.push({
+            name: s.name,
+            kind: s.kind,
+            filePath: o.absPath,
+            contract: s.contract,
+            fuzzy: !1
+          });
+          continue;
+        }
+        if (n) {
+          const c = r.length <= 5 ? 2 : 3, f = W(r.toLowerCase(), s.name.toLowerCase());
+          f <= c && t.push({
+            name: s.name,
+            kind: s.kind,
+            filePath: o.absPath,
+            contract: s.contract,
+            fuzzy: !0,
+            distance: f
+          });
+        }
+      }
+  return t;
+}
+function ne(i) {
+  const e = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map();
+  for (const t of i) {
+    const o = N(t.absPath, ".ts");
+    n.set(o, t.absPath);
+  }
+  for (const t of i)
+    for (const o of t.header.consumers) {
+      let s = e.get(o);
+      if (!s) {
+        const r = n.has(o);
+        s = {
+          consumer: o,
+          files: r ? [n.get(o)] : [],
+          consumedBy: [],
+          unresolved: !r
+        }, e.set(o, s);
+      }
+      s.files.push(t.absPath);
+    }
+  for (const t of i)
+    for (const o of t.header.consumers) {
+      const s = e.get(o);
+      if (!s) continue;
+      const r = N(t.absPath, ".ts");
+      s.consumer !== r && (s.consumedBy.includes(r) || s.consumedBy.push(r));
+    }
+  return e;
+}
+function se(i, e, n) {
+  const t = /* @__PURE__ */ new Set(), o = [];
+  function s(r, c, f) {
+    if (c > n) {
+      o.push(`${f}... more`);
+      return;
+    }
+    if (t.has(r)) {
+      o.push(`${f}${r} [circular]`);
+      return;
+    }
+    t.add(r);
+    const a = i.get(r);
+    if (!a) {
+      o.push(`${f}${r} (unresolved)`);
+      return;
+    }
+    o.push(`${f}${r}`);
+    for (const l of a.consumedBy)
+      s(l, c + 1, `${f}  `);
+  }
+  return s(e, 0, ""), o;
+}
+function M(i) {
+  const e = w(i, "specs");
+  if (!z(e)) return [];
+  const n = oe(e), t = [];
+  for (const o of n) {
+    const s = x(i, o);
+    let r;
+    try {
+      r = D(o, "utf-8");
+    } catch {
+      continue;
+    }
+    const c = ie(r), f = c.length === 0, a = {
+      specPath: s,
+      taskIds: c,
+      isLibraryLevel: f,
+      subSpecs: []
+    };
+    f && (a.subSpecs = re(o, e)), t.push(a);
+  }
+  return t;
+}
+function oe(i) {
+  const e = [], n = [i];
+  for (; n.length > 0; ) {
+    const t = n.pop();
+    let o;
+    try {
+      o = T(t);
+    } catch {
+      continue;
+    }
+    for (const s of o) {
+      if (s.startsWith(".")) continue;
+      const r = w(t, s);
+      let c;
+      try {
+        c = q(r);
+      } catch {
+        continue;
+      }
+      c.isDirectory() ? n.push(r) : s.endsWith(".spec.md") && e.push(r);
+    }
+  }
+  return e;
+}
+function ie(i) {
+  const e = /* @__PURE__ */ new Set(), n = /TSK-\d+/g;
+  let t;
+  for (; (t = n.exec(i)) !== null; )
+    e.add(t[0]);
+  return [...e].sort();
+}
+function re(i, e) {
+  const n = w(i, "..");
+  if (!n.startsWith(e)) return [];
+  let t;
+  try {
+    t = T(n);
+  } catch {
+    return [];
+  }
+  return t.filter((o) => o !== N(i) && o.endsWith(".spec.md")).map((o) => w(n, o)).filter((o) => o !== i).sort();
+}
+function ce(i, e) {
+  return M(i).find((t) => t.specPath.endsWith(e)) ?? null;
+}
+function le(i) {
+  const e = [];
+  return i.file.length > 0 ? [
+    "orient --detail                show DBC contracts for each entity in this file",
+    "orient --task=TSK-XX --detail   find files by task, then show their contracts"
+  ] : i.task.length > 0 ? (e.push("orient --task=<TID> --detail    show DBC contracts for matched files"), e.push("orient --consumer=<name>        find files by consumer name"), e.push("orient --entity=<name>          search for a specific exported entity"), e.push("orient --specs                  see all specs and their task files"), e.slice(0, 4)) : i.consumer.length > 0 ? (e.push("orient --consumer=<name> --detail  show contracts"), e.push("orient --graph                  show the full dependency graph"), e.push("orient --graph --recursive      show transitive dependencies"), e) : i.entity.length > 0 ? (e.push("orient --entity=<name> --fuzzy   fuzzy match entity names"), e.push("orient --file=<path>             inspect a specific file in detail"), e) : i.graph ? (e.push("orient --graph --recursive      expand transitive dependencies"), e.push("orient --graph --recursive --depth=<N>  limit recursion depth"), e.push("orient --consumer=<name>        find files by consumer"), e) : i.specs || i.spec ? (e.push("orient --task=TSK-XX             find files for a specific task"), e.push("orient --file=<path>             detailed view of a file"), e) : i._.length > 0 ? (e.push("orient --detail                 include DBC contract details"), e.push("orient --task=TSK-XX             find all files for a task"), e.push("orient --entity=<name>           search exported entities"), e.push("orient --file=<path>             detailed view of a single file"), e.slice(0, 4)) : (e.push("orient --depth=<N>              limit tree depth"), e.push("orient --detail                 show DBC contracts per file"), e.push("orient --task=TSK-XX             find files by task ID"), e.push("orient <keyword>                 search across all @file: and @purpose"), e.slice(0, 4));
+}
+function fe(i, e, n, t, o) {
+  const s = [], r = ae(i, e);
+  if (O(r, "", e, n, 0, t, s), o < i.length) {
+    const c = i.length - o;
+    s.push(`... ${c} more file${c === 1 ? "" : "s"}`);
+  }
+  return s;
+}
+function ae(i, e) {
+  const n = /* @__PURE__ */ new Map();
+  for (const t of i) {
+    const s = x(e, t.absPath).split(E);
+    let r = n;
+    for (let c = 0; c < s.length - 1; c++) {
+      const f = s[c];
+      let a = r.get(f);
+      (!a || !(a instanceof Map)) && (a = /* @__PURE__ */ new Map(), r.set(f, a)), r = a;
+    }
+    r.set(s[s.length - 1], t);
+  }
+  return n;
+}
+function O(i, e, n, t, o, s, r) {
+  if (i instanceof Map) {
+    const d = [...i.entries()].sort(([$], [k]) => $.localeCompare(k)), h = [], y = [];
+    for (const [$, k] of d)
+      k instanceof Map ? h.push([$, k]) : y.push([$, k]);
+    if (o >= t) {
+      const $ = h.length, k = y.length, j = $ === 1 ? "dir" : "dirs", K = k === 1 ? "file" : "files";
+      r.push(`${e}... ${$} more ${j}, ${k} ${K}`);
+      return;
+    }
+    for (const [$, k] of h)
+      r.push(`${e}${$}/`), O(k, `${e}  `, n, t, o + 1, s, r);
+    for (const [, $] of y)
+      O($, e, n, t, o, s, r);
+    return;
+  }
+  const c = i, f = c.header.file || "(missing)", a = c.header.tasks.length > 0 ? c.header.tasks.join(", ") : "", l = c.header.consumers.join(", "), p = c.exports.length.toString(), m = x(n, c.absPath), u = m.split(E).pop() ?? m;
+  let g = `${e}${u} — @file: ${f}`;
+  if (a && (g += ` | @tasks: ${a}`), l && (g += ` | @consumers: ${l}`), g += ` | @exports: ${p}`, r.push(g), s && c.exports.length > 0)
+    for (const d of c.exports) {
+      const h = d.contract.entries.find(
+        (y) => y.type === "purpose" || y.type === "description"
+      );
+      h && r.push(`${e}  - ${d.name}(${d.kind})  ${h.value}`);
+    }
+}
+function b(i, e) {
+  const n = [];
+  for (const t of i) {
+    const o = x(e, t.absPath);
+    if (n.push(o), n.push(`  @file: ${t.header.file || "(missing)"}`), t.header.tasks.length > 0 && n.push(`  @tasks: ${t.header.tasks.join(", ")}`), t.header.consumers.length > 0 && n.push(`  @consumers: ${t.header.consumers.join(", ")}`), n.push(`  @exports: ${t.exports.length}`), t.exports.length > 0) {
+      n.push("");
+      for (const s of t.exports) {
+        const r = ue(s.name, s.kind, s.contract);
+        n.push(`  ${r}`), he(s.contract.entries, n, "    "), n.push("");
+      }
+    }
+  }
+  return n;
+}
+function ue(i, e, n) {
+  if (e === "function") {
+    const t = n.entries.filter((r) => r.type === "param").map((r) => r.specifier ?? "?").join(", "), o = n.entries.find((r) => r.type === "returns"), s = o ? `: ${o.dataType ?? o.value}` : ": void";
+    return `${i}(${t})${s}`;
+  }
+  return `${i}: ${e}`;
+}
+function he(i, e, n) {
+  for (const t of i) {
+    if (t.type === "description") continue;
+    let o = `${n}@${t.type}`;
+    if (t.specifier && (o += ` {${t.specifier}}`), t.dataType && (o += ` {${t.dataType}}`), t.value && (o += ` ${t.value}`), e.push(o), t.inline)
+      for (const s of t.inline) {
+        let r = `${n}  @${s.type}`;
+        s.specifier && (r += ` {${s.specifier}}`), s.dataType && (r += ` {${s.dataType}}`), s.value && (r += ` ${s.value}`), e.push(r);
+      }
+  }
+}
+function pe(i, e) {
+  const n = x(e, i.absPath), t = i.header.file || "(missing)", o = i.header.tasks.length > 0 ? i.header.tasks.join(", ") : "", s = i.header.consumers.join(", "), r = i.exports.length.toString();
+  let c = `${n} — @file: ${t}`;
+  return o && (c += ` | @tasks: ${o}`), s && (c += ` | @consumers: ${s}`), c += ` | @exports: ${r}`, c;
+}
+function B(i, e) {
+  return i.map((n) => pe(n, e));
+}
+function de(i) {
+  const e = [];
+  if (i.size === 0)
+    return e.push("No consumer dependencies found"), e;
+  e.push("Project dependencies:");
+  for (const [n, t] of [...i.entries()].sort(([o], [s]) => o.localeCompare(s))) {
+    e.push(`  ${n} consumes:`);
+    const o = [...new Set(t.files)].sort();
+    for (const s of o)
+      e.push(`    ${s}`);
+    t.unresolved && e.push("    (unresolved — text-only reference)");
+  }
+  return e;
+}
+function me(i) {
+  const e = [];
+  if (i.length === 0)
+    return e.push("No specs found"), e;
+  for (const n of i)
+    if (n.isLibraryLevel) {
+      const t = n.subSpecs.length;
+      e.push(
+        `${n.specPath} (library-level spec — ${t} sub-spec${t === 1 ? "" : "s"} below)`
+      );
+    } else
+      e.push(`${n.specPath} → ${n.taskIds.join(", ")}`);
+  return e;
+}
+function ge(i) {
+  const e = [];
+  e.push(`${i.specPath}:`);
+  for (const n of i.taskIds)
+    e.push(`  ${n}`);
+  return e;
+}
+function ye(i, e) {
+  const n = [];
+  for (const t of i) {
+    let s = `${x(e, t.file.absPath)} — @file: ${t.file.header.file || "(missing)"}`;
+    t.entityName && (s += ` - ${t.entityName}()  @purpose: found via entity match`), n.push(s);
+  }
+  return n;
+}
+function $e(i) {
+  const e = {
+    _: [],
+    file: [],
+    dir: "",
+    task: [],
+    consumer: [],
+    entity: [],
+    graph: !1,
+    recursive: !1,
+    specs: !1,
+    spec: "",
+    detail: !1,
+    fuzzy: !1,
+    depth: 1 / 0,
+    maxResults: 1 / 0
+  };
+  for (let n = 2; n < i.length; n++) {
+    const t = i[n];
+    t === "--file" ? e.file.push(i[++n] ?? "") : t.startsWith("--file=") ? e.file.push(t.slice(7)) : t === "--dir" ? e.dir = i[++n] ?? "" : t.startsWith("--dir=") ? e.dir = t.slice(6) : t === "--task" ? e.task.push(i[++n] ?? "") : t.startsWith("--task=") ? e.task.push(t.slice(7)) : t === "--consumer" ? e.consumer.push(i[++n] ?? "") : t.startsWith("--consumer=") ? e.consumer.push(t.slice(11)) : t === "--entity" ? e.entity.push(i[++n] ?? "") : t.startsWith("--entity=") ? e.entity.push(t.slice(9)) : t === "--graph" ? e.graph = !0 : t === "--recursive" ? e.recursive = !0 : t === "--specs" ? e.specs = !0 : t === "--spec" ? e.spec = i[++n] ?? "" : t.startsWith("--spec=") ? e.spec = t.slice(7) : t === "--detail" ? e.detail = !0 : t === "--fuzzy" ? e.fuzzy = !0 : t === "--depth" ? e.depth = parseInt(i[++n] ?? "", 10) || 1 / 0 : t.startsWith("--depth=") ? e.depth = parseInt(t.slice(8), 10) || 1 / 0 : t === "--max-results" ? e.maxResults = parseInt(i[++n] ?? "", 10) || 1 / 0 : t.startsWith("--max-results=") ? e.maxResults = parseInt(t.slice(14), 10) || 1 / 0 : t && !t.startsWith("-") && t !== "orient" && e._.push(t);
+  }
+  return e;
+}
+async function Se(i) {
+  S.debug("[OrientCommand#run] [idle → parsing]");
+  const e = $e(i), n = w(".");
+  let t;
+  if (e.file.length > 0)
+    t = e.file.filter((o) => {
+      const s = w(o);
+      return !z(s) || !P(s).isFile() ? (console.error(`[OrientCommand#run] File not found: ${o}`), !1) : !0;
+    }).map((o) => C(w(o)));
+  else if (e.dir) {
+    const o = w(e.dir);
+    (!z(o) || !P(o).isDirectory()) && (console.error(`[OrientCommand#run] Directory not found: ${e.dir}`), process.exit(1)), t = F(o).map((r) => C(r));
+  } else
+    t = F(n).map((s) => C(s)).slice(0, e.maxResults);
+  if (t.length === 0) {
+    console.log("No .ts files found in the project.");
+    return;
+  }
+  S.debug(`[OrientCommand#run] [parsing → loaded] ${t.length} file(s)`), e.file.length > 0 && e.dir && (console.error("[OrientCommand#run] --file and --dir are mutually exclusive"), process.exit(1)), e.specs && e.file.length > 0 && (console.error("[OrientCommand#run] --specs and --file are mutually exclusive"), process.exit(1)), e.specs && (e.task.length > 0 || e.consumer.length > 0 || e.entity.length > 0 || e.graph) && (console.error(
+    "[OrientCommand#run] --specs is incompatible with --task/--consumer/--entity/--graph"
+  ), process.exit(1)), e.spec && (e.file.length > 0 || e.task.length > 0 || e.consumer.length > 0 || e.entity.length > 0 || e.graph) && (console.error(
+    "[OrientCommand#run] --spec is incompatible with --file/--task/--consumer/--entity/--graph"
+  ), process.exit(1)), e.graph && e._.length > 0 && (console.error("[OrientCommand#run] --graph and positional keyword are mutually exclusive"), process.exit(1)), e.file.length > 0 ? xe(t, e, n) : e.task.length > 0 ? ke(t, e, n) : e.consumer.length > 0 ? ve(t, e, n) : e.entity.length > 0 ? be(t, e, n) : e.graph ? Ce(t, e) : e.specs ? Pe(e, n) : e.spec ? ze(e, n) : e._.length > 0 ? we(t, e, n) : X(t, e, n);
+}
+function X(i, e, n) {
+  S.debug("[OrientCommand#run] [routing → S1] map");
+  const t = fe(i, n, e.depth, e.detail, e.maxResults);
+  for (const o of t) console.log(o);
+  v(e);
+}
+function ke(i, e, n) {
+  S.debug("[OrientCommand#run] [routing → S2] task");
+  const t = Z(i, e.task);
+  for (const o of t) {
+    if (o.files.length === 0) {
+      console.log(`No files found for ${o.taskId}`);
+      continue;
+    }
+    if (console.log(`${o.taskId} — ${o.files.length} file${o.files.length === 1 ? "" : "s"}:`), e.detail)
+      for (const s of b(o.files, n)) console.log(`  ${s}`);
+    else
+      for (const s of B(o.files, n)) console.log(`  ${s}`);
+  }
+  v(e);
+}
+function ve(i, e, n) {
+  S.debug("[OrientCommand#run] [routing → S3] consumer");
+  const t = A(i, e.consumer, e.fuzzy);
+  for (const o of t) {
+    if (o.files.length === 0) {
+      console.log(`"${o.consumerName}" not found as consumer`);
+      continue;
+    }
+    if (console.log(
+      `"${o.consumerName}" referenced as consumer by ${o.files.length} file${o.files.length === 1 ? "" : "s"}:`
+    ), e.detail)
+      for (const s of b(o.files, n)) console.log(`  ${s}`);
+    else
+      for (const s of B(o.files, n)) console.log(`  ${s}`);
+  }
+  v(e);
+}
+function we(i, e, n) {
+  const t = e._.join(" ").trim();
+  if (!t) {
+    X(i, e, n);
+    return;
+  }
+  S.debug(`[OrientCommand#run] [routing → S4] keyword "${t}"`);
+  const o = Y(i), s = ee(i, o, t);
+  if (s.length === 0) {
+    console.log(`"${t}" not found`), v(e);
+    return;
+  }
+  if (console.log(`"${t}" found in ${s.length} file${s.length === 1 ? "" : "s"}:`), e.detail) {
+    const r = s.map((c) => c.file);
+    for (const c of b(r, n)) console.log(`  ${c}`);
+  } else
+    for (const r of ye(s, n)) console.log(`  ${r}`);
+  v(e);
+}
+function xe(i, e, n) {
+  S.debug("[OrientCommand#run] [routing → S5] detail"), i.length === 0 && (console.error("[OrientCommand#run] No valid files to display"), process.exit(1));
+  for (const t of b(i, n)) console.log(t);
+  v(e);
+}
+function be(i, e, n) {
+  S.debug("[OrientCommand#run] [routing → S6] entity");
+  const t = te(i, e.entity, e.fuzzy);
+  for (const o of e.entity) {
+    const s = t.filter((c) => c.name === o || e.fuzzy && c.fuzzy);
+    if (s.length === 0) {
+      console.log(`"${o}" not found`);
+      continue;
+    }
+    const r = new Set(s.map((c) => c.filePath));
+    console.log(`"${o}" found in ${r.size} file${r.size === 1 ? "" : "s"}:`);
+    for (const c of r) {
+      const f = x(n, c);
+      console.log(`  ${f}`);
+      const a = s.filter((l) => l.filePath === c);
+      for (const l of a) {
+        const p = l.contract.entries.find(
+          (u) => u.type === "purpose" || u.type === "description"
+        );
+        console.log(p ? `    ${l.name}: ${l.kind} — ${p.value}` : `    ${l.name}: ${l.kind}`);
+        const m = l.contract.entries.find((u) => u.type === "implements");
+        m && console.log(`      @implements ${m.specifier ?? m.value}`);
+      }
+    }
+  }
+  v(e);
+}
+function Ce(i, e) {
+  S.debug("[OrientCommand#run] [routing → S7] graph");
+  const n = ne(i);
+  if (e.recursive) {
+    const t = [...n.keys()].filter((o) => {
+      const s = n.get(o);
+      return s && !s.unresolved;
+    });
+    for (const o of t) {
+      const s = se(n, o, e.depth);
+      for (const r of s) console.log(r);
+    }
+  } else
+    for (const t of de(n)) console.log(t);
+  v(e);
+}
+function Pe(i, e) {
+  S.debug("[OrientCommand#run] [routing → S8] specs overview");
+  const n = M(e);
+  for (const t of me(n)) console.log(t);
+  v(i);
+}
+function ze(i, e) {
+  S.debug(`[OrientCommand#run] [routing → S9] spec "${i.spec}"`);
+  const n = ce(e, i.spec);
+  n || (console.error(`spec "${i.spec}" not found. Use orient --specs for available specs.`), process.exit(1));
+  for (const t of ge(n)) console.log(t);
+  v(i);
+}
+function v(i) {
+  console.log(""), console.log("Hints:");
+  const e = le(i);
+  for (const n of e) console.log(`  ${n}`);
+}
+function C(i) {
+  let e;
+  try {
+    e = D(i, "utf-8");
+  } catch {
+    return { absPath: i, header: { file: "", tasks: [], consumers: [] }, exports: [] };
+  }
+  const n = V(e), t = Ne(e);
+  return { absPath: i, header: n, exports: t };
+}
+function Ne(i) {
+  const e = [], n = new G(), t = /((?:\/\*\*[\s\S]*?\*\/\s*))?export\s+(class|function|const|type|interface|enum)\s+(\w+)/g;
+  let o;
+  for (; (o = t.exec(i)) !== null; ) {
+    const s = o[1]?.trim() ?? "", r = o[2], c = o[3];
+    let f, a = "";
+    s ? (a = s, f = n.parse(s)) : f = { entries: [], format: "single-line" }, e.push({ name: c, kind: r, contract: f, rawJsdoc: a });
+  }
+  return e;
+}
+await Se(process.argv);

package/dist/chunks/{index-CaahtXiM.js → index-BghL1-Nk.js}

@@ -1,5 +1,5 @@
-import { p as j, s as e, g as x } from "./shared-Bjy30TeM.js";
-import { p as T, A as E } from "./index-CiEM-8nJ.js";
+import { p as j, s as e, g as x } from "./shared-DL_1LG0K.js";
+import { p as T, A as E } from "./index-CIvkaAQ3.js";
 import { readdirSync as G, readFileSync as P } from "node:fs";
 import { join as h, dirname as k } from "node:path";
 import { fileURLToPath as N } from "node:url";

package/dist/chunks/{index-BeL1Zcbg.js → index-BlqEQEGy.js}

@@ -1,4 +1,4 @@
-import { p as s, r as e } from "./run-review-command.logic-DpkRoEi8.js";
+import { p as s, r as e } from "./run-review-command.logic-BeYQin-I.js";
 const r = s(process.argv), o = await e({
   mode: "issues",
   args: r

package/dist/chunks/{index-D1qsi0Uc.js → index-CDM74qdR.js}

@@ -2,9 +2,9 @@ import u from "node:fs";
 import S from "node:os";
 import v from "node:path";
 import { execSync as P } from "node:child_process";
-import { p as d, A as E } from "./index-CiEM-8nJ.js";
-import { g as H, s as t, x as D, p as F } from "./shared-Bjy30TeM.js";
-import { l as N } from "./services-CaLOhuLV.js";
+import { p as d, A as E } from "./index-CIvkaAQ3.js";
+import { g as H, s as t, x as D, p as F } from "./shared-DL_1LG0K.js";
+import { l as N } from "./services-IgZptnTi.js";
 class U {
   /** @purpose Configuration with defaults for mode, prompts, timeout. */
   init;

package/dist/chunks/{index-D9ceRUyB.js → index-CGsIRefC.js}

@@ -7,8 +7,8 @@ import { promisify as h } from "node:util";
 import z from "node:os";
 import g from "node:fs";
 import { Buffer as X } from "node:buffer";
-import { p as G } from "./shared-Bjy30TeM.js";
-import { c as K } from "./services-CaLOhuLV.js";
+import { p as G } from "./shared-DL_1LG0K.js";
+import { c as K } from "./services-IgZptnTi.js";
 let F;
 function q() {
   try {