@driftless-sh/cli 0.1.49 → 0.1.51

package/dist/index.js

@@ -214344,12 +214344,222 @@ var require_enricher = __commonJS({
   }
 });
 
+// ../../libs/scanner/dist/coverage.js
+var require_coverage = __commonJS({
+  "../../libs/scanner/dist/coverage.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.computeCoverage = computeCoverage;
+    exports2.summarizeCoverage = summarizeCoverage;
+    function normalizePath(p) {
+      return p.trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "");
+    }
+    function globToRegExp(glob) {
+      const g = normalizePath(glob);
+      let out = "";
+      for (let i = 0; i < g.length; i++) {
+        const c = g[i];
+        if (c === "*") {
+          if (g[i + 1] === "*") {
+            i++;
+            if (g[i + 1] === "/")
+              i++;
+            out += ".*";
+          } else {
+            out += "[^/]*";
+          }
+        } else if (c === "?") {
+          out += "[^/]";
+        } else if ("\\^$+.()|{}[]".includes(c)) {
+          out += "\\" + c;
+        } else {
+          out += c;
+        }
+      }
+      return new RegExp("^" + out + "$");
+    }
+    function matchesPattern(filePath, pattern) {
+      if (!pattern)
+        return false;
+      try {
+        return globToRegExp(pattern).test(normalizePath(filePath));
+      } catch {
+        return false;
+      }
+    }
+    var SENSITIVE = /(auth|admin|billing|payment|credit|invoice|token|secret|webhook|api[-_]?key|password|session)/i;
+    function isHighRisk(c) {
+      if (c.type === "guard")
+        return true;
+      if (c.type === "endpoint") {
+        const guards = c.metadata?.guard_names;
+        if (!guards || guards.length === 0)
+          return true;
+      }
+      const hay = `${c.file_path} ${c.name} ${c.metadata?.path ?? ""}`;
+      return SENSITIVE.test(hay);
+    }
+    var RANK_TO_SPECIFICITY = {
+      4: "file",
+      3: "pattern",
+      2: "repo",
+      1: "weak"
+    };
+    function matchRank(filePath, topic, repoId) {
+      const np = normalizePath(filePath);
+      const files = topic.where_files ?? [];
+      if (files.some((f) => normalizePath(f) === np))
+        return 4;
+      if (matchesPattern(np, topic.pattern))
+        return 3;
+      const repoScoped = !!repoId && !!topic.where_repos && topic.where_repos.includes(repoId);
+      if (repoScoped) {
+        const hasAnchors = files.length > 0 || !!topic.pattern;
+        return hasAnchors ? 2 : 1;
+      }
+      return 0;
+    }
+    function reviewLevel(topic) {
+      if (topic.suggested)
+        return "suggested";
+      if (topic.status === "reviewed")
+        return "reviewed";
+      if (topic.status === "draft")
+        return "draft";
+      return "none";
+    }
+    var STATUS_RANK = {
+      none: 0,
+      suggested: 1,
+      draft: 2,
+      reviewed: 3
+    };
+    function strongerStatus(a, b) {
+      return STATUS_RANK[a] >= STATUS_RANK[b] ? a : b;
+    }
+    function decideAction(best, highRisk, hasStale, hasOrphaned) {
+      if (highRisk && best === "none")
+        return "document-now";
+      if (hasOrphaned)
+        return "reattach-or-remove";
+      if (hasStale)
+        return "refresh-stale";
+      if (best === "none")
+        return "add-topic";
+      if (best === "suggested")
+        return "review-suggested";
+      if (best === "draft")
+        return "promote-draft";
+      return "none";
+    }
+    function computeCoverage(components, topics, opts = {}) {
+      return components.map((c) => {
+        const direct = [];
+        const indirect = [];
+        let bestRank = 0;
+        let best = "none";
+        let hasStale = false;
+        let hasOrphaned = false;
+        for (const t of topics) {
+          const rank = matchRank(c.file_path, t, opts.repoId);
+          if (rank === 0)
+            continue;
+          if (t.stale)
+            hasStale = true;
+          if (t.status === "orphaned")
+            hasOrphaned = true;
+          if (rank >= 4)
+            direct.push(t.slug);
+          else
+            indirect.push(t.slug);
+          if (rank > bestRank)
+            bestRank = rank;
+          best = strongerStatus(best, reviewLevel(t));
+        }
+        const highRisk = isHighRisk(c);
+        const specificity = bestRank === 0 ? "weak" : RANK_TO_SPECIFICITY[bestRank];
+        return {
+          component: `${c.type}:${normalizePath(c.file_path)}:${c.name}:${c.line_number}`,
+          file_path: c.file_path,
+          best_status: best,
+          direct_topics: [...new Set(direct)].sort(),
+          indirect_topics: [...new Set(indirect)].sort(),
+          match_specificity: specificity,
+          has_stale: hasStale,
+          has_orphaned: hasOrphaned,
+          is_high_risk: highRisk,
+          recommended_action: decideAction(best, highRisk, hasStale, hasOrphaned)
+        };
+      });
+    }
+    function summarizeCoverage(rows) {
+      const by_status = { reviewed: 0, draft: 0, suggested: 0, none: 0 };
+      const by_specificity = {
+        component: 0,
+        file: 0,
+        pattern: 0,
+        repo: 0,
+        weak: 0
+      };
+      let covered = 0;
+      let strong = 0;
+      let high_risk_uncovered = 0;
+      let stale_count = 0;
+      let orphaned_count = 0;
+      for (const r of rows) {
+        by_status[r.best_status]++;
+        by_specificity[r.match_specificity]++;
+        if (r.best_status !== "none")
+          covered++;
+        if (r.best_status === "reviewed" && (r.match_specificity === "file" || r.match_specificity === "component")) {
+          strong++;
+        }
+        if (r.is_high_risk && r.best_status === "none")
+          high_risk_uncovered++;
+        if (r.has_stale)
+          stale_count++;
+        if (r.has_orphaned)
+          orphaned_count++;
+      }
+      const total = rows.length;
+      const uncovered = total - covered;
+      const partial = covered - strong;
+      let status;
+      if (total === 0)
+        status = "empty";
+      else if (high_risk_uncovered > 0)
+        status = "critical-gap";
+      else if (uncovered > 0)
+        status = "gap";
+      else if (partial > 0)
+        status = "partial";
+      else
+        status = "covered";
+      return {
+        total,
+        covered,
+        uncovered,
+        by_status,
+        by_specificity,
+        strong,
+        partial,
+        high_risk_uncovered,
+        stale_count,
+        orphaned_count,
+        has_stale: stale_count > 0,
+        has_orphaned: orphaned_count > 0,
+        status
+      };
+    }
+  }
+});
+
 // ../../libs/scanner/dist/index.js
 var require_dist = __commonJS({
   "../../libs/scanner/dist/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.enrichComponents = exports2.extractNestJSWithReport = exports2.extractNestJS = exports2.identifyRepo = void 0;
+    exports2.summarizeCoverage = exports2.computeCoverage = exports2.enrichComponents = exports2.extractNestJSWithReport = exports2.extractNestJS = exports2.identifyRepo = void 0;
     exports2.scanRepo = scanRepo2;
     var identity_1 = require_identity();
     Object.defineProperty(exports2, "identifyRepo", { enumerable: true, get: function() {
@@ -214366,6 +214576,13 @@ var require_dist = __commonJS({
     Object.defineProperty(exports2, "enrichComponents", { enumerable: true, get: function() {
       return enricher_1.enrichComponents;
     } });
+    var coverage_1 = require_coverage();
+    Object.defineProperty(exports2, "computeCoverage", { enumerable: true, get: function() {
+      return coverage_1.computeCoverage;
+    } });
+    Object.defineProperty(exports2, "summarizeCoverage", { enumerable: true, get: function() {
+      return coverage_1.summarizeCoverage;
+    } });
     async function scanRepo2(rootPath) {
       const startMs = Date.now();
       const startMem = process.memoryUsage().heapUsed;
@@ -214625,7 +214842,7 @@ async function installSkillCommand() {
 // src/commands/init.ts
 function getVersion() {
   try {
-    return "0.1.49";
+    return "0.1.51";
   } catch {
     return "0.0.0";
   }
@@ -215285,6 +215502,101 @@ ${result.violations.length} violation(s) found (${rulesEvaluated} rule(s) evalua
 
 // src/commands/context.ts
 init_api_client();
+
+// src/repo-resolver.ts
+init_api_client();
+function notLinkedMessage(remote, workspaceSlug) {
+  return `Repo '${remote.org}/${remote.repo}' is not registered in workspace '${workspaceSlug}'. Run \`driftless init\` to register it.`;
+}
+function formatDiagnostics(d) {
+  const lines = [];
+  if (d.remote) lines.push(`  repo:        ${d.remote.org}/${d.remote.repo}`);
+  lines.push(`  tried slugs: ${d.triedSlugs.length ? d.triedSlugs.join(", ") : "(none)"}`);
+  lines.push(`  config slug: ${d.configSlug ?? "(not cached \u2014 run `driftless login` or `driftless init`)"}`);
+  if (!d.meAttempted) {
+    lines.push("  /me:         not attempted");
+  } else if (d.meReturned) {
+    lines.push(`  /me:         returned slug=${d.meSlug ?? "(none)"} workspace_id=${d.meWorkspaceId ?? "(none)"}`);
+  } else {
+    lines.push(`  /me:         FAILED \u2014 ${d.meError ?? "unknown error"}`);
+  }
+  if (d.failedEndpoint) lines.push(`  last endpoint: ${d.failedEndpoint} (rejected)`);
+  return lines.join("\n");
+}
+async function fetchRepos(slug) {
+  try {
+    const raw = await api.get(`/workspaces/${slug}/repos`);
+    if (Array.isArray(raw)) return { repos: raw };
+    return { error: "unexpected response shape" };
+  } catch (e) {
+    return { error: e instanceof Error ? e.message : String(e) };
+  }
+}
+async function resolveRepo() {
+  const remote = getGitRemote();
+  if (!remote) return { ok: false, reason: "no_remote" };
+  const configSlug = getCachedWorkspace().slug;
+  let meSlug;
+  let meWorkspaceId;
+  let meReturned = false;
+  let meError;
+  try {
+    const me = await api.get("/me", { timeoutMs: 8e3, retries: 1 });
+    meReturned = true;
+    meSlug = me?.slug;
+    meWorkspaceId = me?.workspace_id;
+    if (meSlug) saveWorkspaceToConfig(meSlug, meWorkspaceId);
+  } catch (e) {
+    meError = e instanceof Error ? e.message : String(e);
+  }
+  const candidates = [...new Set([configSlug, meSlug, remote.org].filter(Boolean))];
+  let lastLinkedSlug;
+  let failedEndpoint;
+  for (const slug of candidates) {
+    const result = await fetchRepos(slug);
+    if ("error" in result) {
+      failedEndpoint = `/workspaces/${slug}/repos`;
+      continue;
+    }
+    const repo = result.repos.find((r) => r.github_org === remote.org && r.github_repo === remote.repo);
+    if (repo) {
+      saveWorkspaceToConfig(slug, meWorkspaceId);
+      const source = slug === configSlug ? "config" : slug === meSlug ? "me" : "git-org";
+      return {
+        ok: true,
+        workspaceSlug: slug,
+        repoId: repo.id,
+        remote,
+        hasScanBaseline: !!repo.scan_summary,
+        source
+      };
+    }
+    lastLinkedSlug = slug;
+  }
+  const diagnostics = {
+    remote,
+    triedSlugs: candidates,
+    configSlug,
+    meAttempted: true,
+    meReturned,
+    meSlug,
+    meWorkspaceId,
+    meError,
+    failedEndpoint
+  };
+  if (lastLinkedSlug) {
+    return { ok: false, reason: "not_linked", workspaceSlug: lastLinkedSlug, remote, diagnostics };
+  }
+  return {
+    ok: false,
+    reason: "no_workspace",
+    remote,
+    detail: formatDiagnostics(diagnostics),
+    diagnostics
+  };
+}
+
+// src/commands/context.ts
 var import_node_fs5 = require("node:fs");
 var import_node_path5 = require("node:path");
 init_analytics();
@@ -215941,68 +216253,61 @@ ${label} (${items.length}):`);
     if (missingFiles.length > 0 && !isJSON) {
       console.error(`File(s) not found locally: ${missingFiles.join(", ")}. Matching by pattern only.`);
     }
-    if (flags["dry-run"]) {
-      try {
-        const results = await api.post(
-          `/workspaces/${workspaceSlug}/watchers/match-files`,
-          { files }
-        );
-        console.log(`Would match ${results.length} topic${results.length === 1 ? "" : "s"}:`);
-        for (const r of results) {
-          console.log(`  ${r.context.topic} via ${r.match_reason}`);
-        }
-        if (missingFiles.length > 0) {
-          console.log(`
-Warnings:`);
-          for (const f of missingFiles) {
-            console.log(`  ${f} does not exist locally \u2014 matched by pattern only`);
-          }
-        }
-        if (!isJSON) {
-          console.log("\n(Dry run \u2014 no context delivered)");
-        }
-        if (isJSON) {
-          emitJSON2({ dry_run: true, matched: results.map((r) => ({ topic: r.context.topic, reason: r.match_reason })), missing_files: missingFiles });
-        }
-      } catch (e) {
-        console.error(`Dry run failed: ${formatError(e)}`);
-        process.exit(1);
+    const resolution = await resolveRepo();
+    if (!resolution.ok) {
+      if (resolution.reason === "not_linked") {
+        console.error(notLinkedMessage(resolution.remote, resolution.workspaceSlug));
+      } else {
+        console.error("Error: could not resolve workspace/repo. Run `driftless doctor`.");
       }
-      process.exit(0);
+      process.exit(1);
     }
+    const wsSlug = resolution.workspaceSlug;
+    const repoId = resolution.repoId;
+    let payload;
     try {
-      const results = await api.post(
-        `/workspaces/${workspaceSlug}/watchers/match-files`,
+      payload = await api.post(
+        `/workspaces/${wsSlug}/repos/${repoId}/context/load`,
         { files }
       );
-      if (results.length === 0 && !isJSON) {
-        console.log(`No context topics match these files.`);
-      }
-      if (isJSON) {
-        emitJSON2(results);
-      } else {
-        if (results.length > 0) {
-          console.log(`Matched ${results.length} context topic${results.length === 1 ? "" : "s"} for ${files.length} file${files.length === 1 ? "" : "s"}:
-`);
-          for (const r of results) {
-            try {
-              const fullCtx = await api.get(`/workspaces/${workspaceSlug}/watchers/${r.context.topic}`);
-              renderContextHuman(fullCtx);
-              console.log("");
-            } catch {
-              console.log(`\u258C ${r.context.topic}  (${r.match_reason})`);
-              console.log(`  ${r.context.summary}`);
-              console.log("");
-            }
-          }
-        } else {
-          console.log(`No context topics match these files. No context covers the changed paths.`);
-        }
-      }
     } catch (e) {
       console.error(`Load failed: ${formatError(e)}`);
       process.exit(1);
     }
+    if (flags["dry-run"] && !isJSON) {
+      console.log("(Dry run \u2014 context loaded for inspection, nothing written)\n");
+    }
+    if (isJSON) {
+      emitJSON2(payload);
+      process.exit(0);
+    }
+    const allTopics = /* @__PURE__ */ new Set();
+    for (const f of payload.files) {
+      const c = f.coverage;
+      console.log(`\u258C ${f.file}`);
+      console.log(`  coverage   ${c.status}${c.high_risk ? "  \u26A0 high-risk" : ""}`);
+      console.log(`  action     ${c.recommended_action}`);
+      const dt = c.direct_topics ?? [];
+      const it = c.indirect_topics ?? [];
+      if (dt.length) console.log(`  direct     ${dt.join(", ")}`);
+      if (it.length) console.log(`  indirect   ${it.join(", ")}`);
+      if (!dt.length && !it.length) console.log(`  topics     (none \u2014 no context covers this file)`);
+      if (c.has_stale) console.log(`  \u26A0 a matching topic is stale`);
+      if (c.has_orphaned) console.log(`  \u26A0 a matching topic is orphaned`);
+      for (const t of [...dt, ...it]) allTopics.add(t);
+      console.log("");
+    }
+    for (const slug of [...allTopics].sort()) {
+      try {
+        const fullCtx = await api.get(`/workspaces/${wsSlug}/watchers/${slug}`);
+        renderContextHuman(fullCtx);
+        console.log("");
+      } catch {
+      }
+    }
+    if (allTopics.size === 0) {
+      console.log("No context covers the requested paths. Consider `driftless context add`.");
+    }
     return;
   }
   if (subCommand === "export") {
@@ -216163,101 +216468,6 @@ Run 'driftless help context' for full reference.`);
 
 // src/commands/sync.ts
 init_api_client();
-
-// src/repo-resolver.ts
-init_api_client();
-function notLinkedMessage(remote, workspaceSlug) {
-  return `Repo '${remote.org}/${remote.repo}' is not registered in workspace '${workspaceSlug}'. Run \`driftless init\` to register it.`;
-}
-function formatDiagnostics(d) {
-  const lines = [];
-  if (d.remote) lines.push(`  repo:        ${d.remote.org}/${d.remote.repo}`);
-  lines.push(`  tried slugs: ${d.triedSlugs.length ? d.triedSlugs.join(", ") : "(none)"}`);
-  lines.push(`  config slug: ${d.configSlug ?? "(not cached \u2014 run `driftless login` or `driftless init`)"}`);
-  if (!d.meAttempted) {
-    lines.push("  /me:         not attempted");
-  } else if (d.meReturned) {
-    lines.push(`  /me:         returned slug=${d.meSlug ?? "(none)"} workspace_id=${d.meWorkspaceId ?? "(none)"}`);
-  } else {
-    lines.push(`  /me:         FAILED \u2014 ${d.meError ?? "unknown error"}`);
-  }
-  if (d.failedEndpoint) lines.push(`  last endpoint: ${d.failedEndpoint} (rejected)`);
-  return lines.join("\n");
-}
-async function fetchRepos(slug) {
-  try {
-    const raw = await api.get(`/workspaces/${slug}/repos`);
-    if (Array.isArray(raw)) return { repos: raw };
-    return { error: "unexpected response shape" };
-  } catch (e) {
-    return { error: e instanceof Error ? e.message : String(e) };
-  }
-}
-async function resolveRepo() {
-  const remote = getGitRemote();
-  if (!remote) return { ok: false, reason: "no_remote" };
-  const configSlug = getCachedWorkspace().slug;
-  let meSlug;
-  let meWorkspaceId;
-  let meReturned = false;
-  let meError;
-  try {
-    const me = await api.get("/me", { timeoutMs: 8e3, retries: 1 });
-    meReturned = true;
-    meSlug = me?.slug;
-    meWorkspaceId = me?.workspace_id;
-    if (meSlug) saveWorkspaceToConfig(meSlug, meWorkspaceId);
-  } catch (e) {
-    meError = e instanceof Error ? e.message : String(e);
-  }
-  const candidates = [...new Set([configSlug, meSlug, remote.org].filter(Boolean))];
-  let lastLinkedSlug;
-  let failedEndpoint;
-  for (const slug of candidates) {
-    const result = await fetchRepos(slug);
-    if ("error" in result) {
-      failedEndpoint = `/workspaces/${slug}/repos`;
-      continue;
-    }
-    const repo = result.repos.find((r) => r.github_org === remote.org && r.github_repo === remote.repo);
-    if (repo) {
-      saveWorkspaceToConfig(slug, meWorkspaceId);
-      const source = slug === configSlug ? "config" : slug === meSlug ? "me" : "git-org";
-      return {
-        ok: true,
-        workspaceSlug: slug,
-        repoId: repo.id,
-        remote,
-        hasScanBaseline: !!repo.scan_summary,
-        source
-      };
-    }
-    lastLinkedSlug = slug;
-  }
-  const diagnostics = {
-    remote,
-    triedSlugs: candidates,
-    configSlug,
-    meAttempted: true,
-    meReturned,
-    meSlug,
-    meWorkspaceId,
-    meError,
-    failedEndpoint
-  };
-  if (lastLinkedSlug) {
-    return { ok: false, reason: "not_linked", workspaceSlug: lastLinkedSlug, remote, diagnostics };
-  }
-  return {
-    ok: false,
-    reason: "no_workspace",
-    remote,
-    detail: formatDiagnostics(diagnostics),
-    diagnostics
-  };
-}
-
-// src/commands/sync.ts
 function parseArgs2(args) {
   const flags = {};
   for (let i = 0; i < args.length; i++) {
@@ -216657,8 +216867,8 @@ async function graphCommand(args) {
   const isJSON = args.includes("--json");
   const depthIdx = args.indexOf("--depth");
   const depth = depthIdx !== -1 && args[depthIdx + 1] ? `&depth=${encodeURIComponent(args[depthIdx + 1])}` : "";
-  if (sub !== "file" && sub !== "impact") {
-    console.error('Usage:\n  driftless graph file <path> [--depth N] [--json]\n  driftless graph impact --files "a,b" [--depth N] [--json]');
+  if (sub !== "file" && sub !== "impact" && sub !== "coverage") {
+    console.error('Usage:\n  driftless graph file <path> [--depth N] [--json]\n  driftless graph impact --files "a,b" [--depth N] [--json]\n  driftless graph coverage [--json]');
     process.exit(1);
   }
   const resolution = await resolveRepo();
@@ -216673,6 +216883,34 @@ async function graphCommand(args) {
   const { workspaceSlug, repoId } = resolution;
   const base = `/workspaces/${workspaceSlug}/repos/${repoId}/graph`;
   try {
+    if (sub === "coverage") {
+      const r = await api.get(`/workspaces/${workspaceSlug}/repos/${repoId}/architecture-summary`);
+      const cov = r?.coverage;
+      if (!cov || !cov.summary) {
+        console.error("No coverage in architecture-summary. The API may be on an older build, or run `driftless init` first.");
+        process.exit(1);
+      }
+      if (isJSON) {
+        emitJSON4(cov);
+        process.exit(0);
+      }
+      const s = cov.summary;
+      console.log("\u258C context coverage\n");
+      console.log(`  status     ${s.status}`);
+      console.log(`  components ${s.covered}/${s.total} covered  (strong ${s.strong} \xB7 partial ${s.partial} \xB7 none ${s.uncovered})`);
+      if (s.high_risk_uncovered > 0) console.log(`  \u26A0 high-risk uncovered: ${s.high_risk_uncovered}`);
+      if (s.stale_count > 0 || s.orphaned_count > 0) {
+        console.log(`  flags      stale ${s.stale_count} \xB7 orphaned ${s.orphaned_count}`);
+      }
+      const mods = Object.entries(cov.by_module).sort((a, b) => a[0].localeCompare(b[0]));
+      if (mods.length) {
+        console.log("\n  modules:");
+        for (const [name, m] of mods) {
+          console.log(`    ${name}  \u2014  ${m.status}  (${m.covered}/${m.total})`);
+        }
+      }
+      process.exit(0);
+    }
     if (sub === "file") {
       const path = args[1];
       if (!path || path.startsWith("--")) {
@@ -216752,7 +216990,7 @@ async function graphCommand(args) {
 }
 
 // src/index.ts
-var VERSION = "0.1.49";
+var VERSION = "0.1.51";
 var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Living repo context for humans and coding agents
 
 Install:  npm install -g @driftless-sh/cli