@driftless-sh/cli 0.1.39 → 0.1.43

package/dist/index.js

@@ -172,12 +172,21 @@ function isTransient(err) {
   const msg = err instanceof Error ? err.message : String(err);
   return !/HTTP 4\d\d:/.test(msg);
 }
+function defaultsFor(method) {
+  const isGet = method === "GET";
+  return {
+    timeoutMs: isGet ? 15e3 : 2e4,
+    retries: isGet ? 1 : 0
+  };
+}
 async function request(method, path, body, opts) {
-  const retries = opts?.retries ?? 0;
+  const d = defaultsFor(method);
+  const timeoutMs = opts?.timeoutMs ?? d.timeoutMs;
+  const retries = opts?.retries ?? d.retries;
   let lastErr;
   for (let attempt = 0; attempt <= retries; attempt++) {
     try {
-      return await singleRequest(method, path, body, opts?.timeoutMs);
+      return await singleRequest(method, path, body, timeoutMs);
     } catch (e) {
       lastErr = e;
       if (attempt === retries || !isTransient(e)) break;
@@ -214633,7 +214642,7 @@ async function installSkillCommand() {
 // src/commands/init.ts
 function getVersion() {
   try {
-    return "0.1.39";
+    return "0.1.43";
   } catch {
     return "0.0.0";
   }
@@ -215103,7 +215112,7 @@ async function initCommand(args) {
         watchersSkipped++;
       }
     }
-    step("creating context", `${watchersCreated} topics \u2713`);
+    step("creating context", `${watchersCreated} suggested \u2713`);
   } else {
     step("creating context", "skipped (use --suggest to auto-generate)");
   }
@@ -215120,14 +215129,14 @@ async function initCommand(args) {
   step("installing skill", skillLine);
   console.log("");
   console.log("\u2713 repo context bootstrapped");
-  console.log(`  \u251C\u2500 topics        ${suggest ? watchersCreated : "(use --suggest to generate)"}`);
+  console.log(`  \u251C\u2500 suggested     ${suggest ? `${watchersCreated} topic(s) \u2014 pending review, not yet active` : "(use --suggest to generate)"}`);
   console.log(`  \u251C\u2500 rules          ${suggest ? rulesCreated : "(use --suggest to generate)"}`);
   console.log(`  \u251C\u2500 docs found    ${existingDocs.length} (ask your agent to sync them)`);
   console.log(`  \u251C\u2500 components   ${components.length}`);
   console.log(`  \u2514\u2500 relations    ${relationCount}`);
   console.log("");
   console.log("  dashboard  \u2192  driftless.icu/ecosystem");
-  console.log("  next       \u2192  driftless context list");
+  console.log(`  next       \u2192  ${suggest && watchersCreated > 0 ? "driftless context list --suggested   # review & confirm suggestions" : "driftless context list"}`);
   console.log("");
   console.log(DIVIDER);
   analyticsEvent("cli_init_run", workspaceSlug, {
@@ -215315,11 +215324,13 @@ function renderSummaryHuman(items) {
   const topicWidth = Math.max(...items.map((i) => i.topic.length), 12) + 2;
   const badgeWidth = Math.max(...items.map((i) => formatBadges(i.badges).length), 8) + 2;
   const statusWidth = Math.max(...items.map((i) => (i.classification?.status || "").length), 8) + 2;
+  const kindWidth = Math.max(...items.map((i) => (i.classification?.kind || "").length), 8) + 2;
   for (const item of items) {
     const topic = pad(item.topic, topicWidth);
     const badges = pad(formatBadges(item.badges), badgeWidth);
     const status = pad(item.classification?.status || "", statusWidth);
-    console.log(`${topic}${status}${badges}${item.summary}`);
+    const kind = pad(item.classification?.kind || "", kindWidth);
+    console.log(`${topic}${status}${kind}${badges}${item.summary}`);
   }
   console.log(`
 ${items.length} topic${items.length === 1 ? "" : "s"}.`);
@@ -215468,6 +215479,41 @@ async function contextCommand(args) {
   const { flags, positional } = parseArgs(args);
   const subCommand = positional[0];
   const isJSON = !!flags["json"];
+  if (subCommand === "doctor") {
+    let audit;
+    try {
+      audit = await api.get(`/workspaces/${workspaceSlug}/watchers/audit`);
+    } catch (e) {
+      console.error(`Failed to audit context: ${formatError(e)}`);
+      process.exit(1);
+    }
+    if (isJSON) {
+      emitJSON2(audit);
+      const blocking2 = audit.orphaned.length + audit.repo_leak.length;
+      process.exit(blocking2 > 0 ? 1 : 0);
+    }
+    const section = (label, items) => {
+      if (items.length === 0) return;
+      console.log(`
+${label} (${items.length}):`);
+      for (const it of items) {
+        console.log(`  ${it.slug}${it.reason ? `  \u2014 ${it.reason}` : ""}`);
+      }
+    };
+    console.log(`Context audit \u2014 ${audit.total} topic${audit.total === 1 ? "" : "s"}`);
+    section("\u26A0 stale (code changed, context not updated)", audit.stale);
+    section("\u2717 orphaned (repo deleted \u2014 hidden from agents)", audit.orphaned);
+    section("\u2022 draft (suggested, never confirmed)", audit.draft);
+    section("\u2022 docs-pending (doc anchored, never synced)", audit.docs_pending);
+    section("\u2717 repo-leak (references unknown repo ids)", audit.repo_leak);
+    const blocking = audit.orphaned.length + audit.repo_leak.length;
+    if (audit.stale.length + audit.draft.length + audit.docs_pending.length + blocking === 0) {
+      console.log("\nAll context is healthy.");
+    } else if (blocking > 0) {
+      console.log("\nResolve orphaned / repo-leak topics \u2014 they indicate deleted-repo fallout.");
+    }
+    process.exit(blocking > 0 ? 1 : 0);
+  }
   if (subCommand === "list") {
     const query = [];
     if (flags["stale"]) query.push("stale=true");
@@ -216167,12 +216213,14 @@ async function resolveRepo() {
     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
+        hasScanBaseline: !!repo.scan_summary,
+        source
       };
     }
     lastLinkedSlug = slug;
@@ -216255,21 +216303,26 @@ async function syncCommand(args) {
     }
     process.exit(1);
   }
-  const { workspaceSlug, repoId, remote } = resolution;
-  const [eventsRes, staleTopics, violations, suggestedTopics] = await Promise.allSettled([
+  const { workspaceSlug, repoId, remote, source } = resolution;
+  const [eventsRes, staleTopics, violations, suggestedTopics, prActivity] = await Promise.allSettled([
     api.get(`/workspaces/${workspaceSlug}/watchers/events?repo_id=${repoId}&limit=20`),
     api.get(`/workspaces/${workspaceSlug}/watchers?stale=true&repo=${repoId}`),
     api.get(`/workspaces/${workspaceSlug}/violations?repo_id=${repoId}&status=open&limit=20`),
-    api.get(`/workspaces/${workspaceSlug}/watchers?suggested=true&repo=${repoId}`)
+    api.get(`/workspaces/${workspaceSlug}/watchers?suggested=true&repo=${repoId}`),
+    api.get(`/workspaces/${workspaceSlug}/pr-activity?repo_id=${repoId}&limit=5`)
   ]);
   const events = eventsRes.status === "fulfilled" ? eventsRes.value.events ?? [] : [];
   const stale = staleTopics.status === "fulfilled" ? staleTopics.value : [];
   const rawViolations = violations.status === "fulfilled" ? violations.value : [];
   const openViolations = Array.isArray(rawViolations) ? rawViolations : rawViolations.violations ?? rawViolations.items ?? [];
   const suggested = suggestedTopics.status === "fulfilled" ? suggestedTopics.value : [];
+  const rawPr = prActivity.status === "fulfilled" ? prActivity.value : [];
+  const prs = Array.isArray(rawPr) ? rawPr : rawPr.items ?? [];
   if (isJSON) {
     emitJSON3({
       repo: `${remote.org}/${remote.repo}`,
+      workspace: workspaceSlug,
+      resolved_via: source,
       stale_topics: stale.map((t) => ({ topic: t.topic, reason: t.stale?.reason ?? null })),
       recent_events: events.slice(0, 10).map((e) => ({
         type: e.event_type,
@@ -216283,11 +216336,20 @@ async function syncCommand(args) {
         status: v.status,
         author: v.author
       })),
-      suggested_pending: suggested.length
+      suggested_pending: suggested.length,
+      pr_activity: prs.slice(0, 5).map((p) => ({
+        pr_number: p.pr_number,
+        title: p.pr_title,
+        author: p.pr_author,
+        risk: p.risk ?? null,
+        topics: p.watcher_slugs ?? [],
+        observed_at: p.observed_at
+      }))
     });
     process.exit(0);
   }
-  console.log(`\u258C ${remote.org}/${remote.repo}
+  console.log(`\u258C ${remote.org}/${remote.repo}`);
+  console.log(`  workspace: ${workspaceSlug}  (resolved via ${source})
 `);
   if (stale.length > 0) {
     console.log(`\u26A0  ${stale.length} stale topic${stale.length === 1 ? "" : "s"} \u2014 code changed, context not updated:`);
@@ -216315,12 +216377,21 @@ async function syncCommand(args) {
     if (openViolations.length > 5) console.log(`   ... and ${openViolations.length - 5} more`);
     console.log("");
   }
+  if (prs.length > 0) {
+    console.log(`PR activity (${prs.length}, via GitHub App \u2014 remote, not local):`);
+    for (const p of prs.slice(0, 5)) {
+      const risk = p.risk ? `[${p.risk}] ` : "";
+      const topics = (p.watcher_slugs ?? []).length ? `  \u2192 ${(p.watcher_slugs ?? []).join(", ")}` : "";
+      console.log(`  ${risk}#${p.pr_number} ${String(p.pr_title ?? "").slice(0, 70)}${topics}`);
+    }
+    console.log("");
+  }
   if (suggested.length > 0) {
     console.log(`${suggested.length} suggested topic${suggested.length === 1 ? "" : "s"} from init \u2014 review and confirm:`);
     console.log(`  driftless context list --suggested`);
     console.log("");
   }
-  if (stale.length === 0 && events.length === 0 && openViolations.length === 0 && suggested.length === 0) {
+  if (stale.length === 0 && events.length === 0 && openViolations.length === 0 && suggested.length === 0 && prs.length === 0) {
     console.log("Cloud context is up to date. Nothing to sync.");
   } else {
     console.log("Review stale topics, then update context before touching code.");
@@ -216449,7 +216520,7 @@ async function doctorCommand() {
   if (localOrNoKey) {
     checks.push({ name: "Workspace", status: "warn", detail: "Skipped (local API or no key)" });
   } else if (resolution.ok) {
-    checks.push({ name: "Workspace", status: "ok", detail: resolution.workspaceSlug });
+    checks.push({ name: "Workspace", status: "ok", detail: `${resolution.workspaceSlug} (source: ${resolution.source})` });
   } else if (resolution.reason === "not_linked" && resolution.workspaceSlug) {
     checks.push({ name: "Workspace", status: "ok", detail: resolution.workspaceSlug });
   } else if (resolution.reason === "no_workspace" && resolution.diagnostics) {
@@ -216492,18 +216563,23 @@ async function doctorCommand() {
     if (me?.slug) {
       try {
         const integrations = await api.get(`/workspaces/${me.slug}/integrations`);
-        const ghApp = integrations.find((i) => i.type === "github_app" && i.active);
-        if (ghApp) {
+        const ghApp = integrations.find((i) => i.type === "github_app");
+        if (ghApp && ghApp.active) {
           checks.push({ name: "GitHub App", status: "ok", detail: "Installed and active" });
+        } else if (ghApp && !ghApp.active) {
+          checks.push({ name: "GitHub App", status: "warn", detail: "Installed, activating \u2014 wait ~60s then re-run doctor" });
         } else {
-          checks.push({ name: "GitHub App", status: "warn", detail: "Not installed \u2014 driftless.icu/ecosystem \u2192 Settings \u2192 Integrations (if just installed, wait ~60s)" });
+          checks.push({ name: "GitHub App", status: "warn", detail: "Not installed \u2014 driftless.icu/ecosystem \u2192 Settings \u2192 Integrations" });
         }
       } catch (err) {
-        const isNotFound = err?.status === 404 || String(err?.message ?? "").includes("404");
+        const msg = String(err?.message ?? "");
+        const isNotFound = err?.status === 404 || /HTTP 404|404/.test(msg);
         if (isNotFound) {
           checks.push({ name: "GitHub App", status: "warn", detail: "Not installed \u2014 driftless.icu/ecosystem \u2192 Settings \u2192 Integrations" });
+        } else if (/timed out|Connection failed|ENOTFOUND|ECONNREFUSED/i.test(msg)) {
+          checks.push({ name: "GitHub App", status: "warn", detail: "Could not verify \u2014 API unreachable (network/timeout)" });
         } else {
-          checks.push({ name: "GitHub App", status: "warn", detail: "Could not verify \u2014 check your connection or API key" });
+          checks.push({ name: "GitHub App", status: "warn", detail: "Could not verify \u2014 API key may lack permission for this workspace" });
         }
       }
     } else {
@@ -216543,7 +216619,7 @@ function pad2(s, n) {
 }
 
 // src/index.ts
-var VERSION = "0.1.39";
+var VERSION = "0.1.43";
 var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Living repo context for humans and coding agents
 
 Install:  npm install -g @driftless-sh/cli
@@ -216588,6 +216664,7 @@ Context subcommands:
   update <topic> --invariant ".." Append an invariant
   update <topic> --check "..."  Append a required check
   delete <topic>                Delete a topic
+  doctor                        Audit context health (stale/orphaned/draft/docs-pending/repo-leak)
   load --files "p1,p2"          Match topics by file paths
 
 Flags:
@@ -216688,6 +216765,7 @@ Subcommands:
   sync <topic> --note "..."     Add a note to a topic
   update <topic> [opts]         Update topic fields
   delete <topic>                Delete a topic
+  doctor                        Audit context health (stale/orphaned/draft/docs-pending/repo-leak)
   load --files "p1,p2,..."      Match topics for given file paths
 
 List filters:
@@ -216825,7 +216903,11 @@ async function main() {
   }
 }
 main().catch((err) => {
-  console.error("Error:", err.message);
+  const msg = err?.message ?? String(err);
+  console.error("Error:", msg);
+  if (/Connection failed|timed out|ENOTFOUND|ECONNREFUSED|Unauthorized|HTTP 401|HTTP 403|resolve workspace/i.test(msg)) {
+    console.error("\nNext: run `driftless doctor` to diagnose auth/connectivity/workspace.");
+  }
   process.exit(1);
 });
 /*! Bundled license information: