codebase-onboarder 0.5.0 → 0.7.0

package/shared/analyzer/explainLocal.js

@@ -1,163 +1,143 @@
 // Offline explanations. When no LLM key is configured these are what the
 // user reads, so they're written like a colleague's notes, not a template
 // dump. Every claim comes straight from the static graph.
-
 import { baseName } from './pathUtil.js';
 import { roleOf, factIndex, scanIndex } from './graph.js';
 import { languageLabel } from './languages/index.js';
-
 const ROLE_LINES = {
-  entry: 'This is one of the ways into the codebase — a good place to start reading.',
-  hub: 'A lot of the codebase leans on this file. Changes here ripple outward.',
-  leaf: 'Nothing this file uses lives in the repo — it sits at the end of a chain.',
-  test: 'Test file. It verifies behavior rather than providing it.',
-  config: 'Configuration — it shapes how the rest of the code runs.',
-  module: 'A working part of the whole.',
+    entry: 'This is one of the ways into the codebase — a good place to start reading.',
+    hub: 'A lot of the codebase leans on this file. Changes here ripple outward.',
+    leaf: 'Nothing this file uses lives in the repo — it sits at the end of a chain.',
+    test: 'Test file. It verifies behavior rather than providing it.',
+    config: 'Configuration — it shapes how the rest of the code runs.',
+    module: 'A working part of the whole.',
 };
-
 export function explainFile(path, file, facts) {
-  const role = roleOf(path, facts);
-  const fin = facts.fanIn[path] || 0;
-  const fout = facts.fanOut[path] || 0;
-  const paras = [];
-
-  paras.push(`**${baseName(path)}** — ${ROLE_LINES[role]}`);
-
-  const parts = [];
-  if (fout > 0) parts.push(`pulls in ${fout} other ${fout === 1 ? 'file' : 'files'}`);
-  if (fin > 0) parts.push(`is pulled in by ${fin}`);
-  if (fin === 0 && fout === 0 && role !== 'entry') parts.push('isn’t connected to anything else we can see');
-  if (parts.length) paras.push(`It ${parts.join(' and ')}.`);
-
-  const fns = (file?.functions || []).filter((f) => f.kind !== 'method');
-  const methods = (file?.functions || []).filter((f) => f.kind === 'method');
-  if (fns.length) {
-    paras.push(
-      `Defines ${fns.length} ${fns.length === 1 ? 'function' : 'functions'} — ` +
-        `${fns.slice(0, 6).map((f) => '`' + f.name + '`').join(', ')}` +
-        (fns.length > 6 ? ` and ${fns.length - 6} more` : '') + '.'
-    );
-  }
-  if (methods.length) {
-    paras.push(`Plus ${methods.length} ${methods.length === 1 ? 'method' : 'methods'} on its classes.`);
-  }
-  if (file?.classes?.length) {
-    paras.push(`Classes: ${file.classes.map((c) => '`' + c.name + '`').join(', ')}.`);
-  }
-
-  const importers = (facts.importers[path] || []).slice(0, 5);
-  if (importers.length) {
-    paras.push(
-      `If it broke, the first to notice would be ${importers.map((p) => '`' + baseName(p) + '`').join(', ')}` +
-        (fin > 5 ? ` and ${fin - 5} others` : '') + '.'
-    );
-  }
-
-  if (factIndex(facts).inCycle.has(path)) {
-    const cycle = facts.cycles.find((c) => c.includes(path));
-    if (cycle) {
-      paras.push(
-        `⚠ It sits in a circular dependency (${cycle.length} files importing each other in a loop). Worth knowing before you refactor.`
-      );
-    }
-  }
-
-  return paras.join('\n\n');
+    const role = roleOf(path, facts);
+    const fin = facts.fanIn[path] || 0;
+    const fout = facts.fanOut[path] || 0;
+    const paras = [];
+    paras.push(`**${baseName(path)}** — ${ROLE_LINES[role]}`);
+    const parts = [];
+    if (fout > 0)
+        parts.push(`pulls in ${fout} other ${fout === 1 ? 'file' : 'files'}`);
+    if (fin > 0)
+        parts.push(`is pulled in by ${fin}`);
+    if (fin === 0 && fout === 0 && role !== 'entry')
+        parts.push('isn’t connected to anything else we can see');
+    if (parts.length)
+        paras.push(`It ${parts.join(' and ')}.`);
+    const fns = (file?.functions || []).filter((f) => f.kind !== 'method');
+    const methods = (file?.functions || []).filter((f) => f.kind === 'method');
+    if (fns.length) {
+        paras.push(`Defines ${fns.length} ${fns.length === 1 ? 'function' : 'functions'} — ` +
+            `${fns.slice(0, 6).map((f) => '`' + f.name + '`').join(', ')}` +
+            (fns.length > 6 ? ` and ${fns.length - 6} more` : '') + '.');
+    }
+    if (methods.length) {
+        paras.push(`Plus ${methods.length} ${methods.length === 1 ? 'method' : 'methods'} on its classes.`);
+    }
+    if (file?.classes?.length) {
+        paras.push(`Classes: ${file.classes.map((c) => '`' + c.name + '`').join(', ')}.`);
+    }
+    const importers = (facts.importers[path] || []).slice(0, 5);
+    if (importers.length) {
+        paras.push(`If it broke, the first to notice would be ${importers.map((p) => '`' + baseName(p) + '`').join(', ')}` +
+            (fin > 5 ? ` and ${fin - 5} others` : '') + '.');
+    }
+    if (factIndex(facts).inCycle.has(path)) {
+        const cycle = facts.cycles.find((c) => c.includes(path));
+        if (cycle) {
+            paras.push(`⚠ It sits in a circular dependency (${cycle.length} files importing each other in a loop). Worth knowing before you refactor.`);
+        }
+    }
+    return paras.join('\n\n');
 }
-
 export function explainFolder(path, scan, facts) {
-  const here = scanIndex(scan).filesIn(path);
-  const entries = factIndex(facts).entries;
-  const entriesHere = here.filter((f) => entries.has(f.path));
-  const hubsHere = here
-    .map((f) => ({ path: f.path, fanIn: facts.fanIn[f.path] || 0 }))
-    .filter((h) => h.fanIn >= 3)
-    .sort((a, b) => b.fanIn - a.fanIn);
-
-  const paras = [];
-  paras.push(`**${path}/** — ${here.length} parsed ${here.length === 1 ? 'file' : 'files'}.`);
-  if (entriesHere.length) {
-    paras.push(`The way in: ${entriesHere.map((f) => '`' + f.name + '`').join(', ')}.`);
-  }
-  if (hubsHere.length) {
-    paras.push(
-      `The load-bearing file${hubsHere.length > 1 ? 's' : ''}: ` +
-        hubsHere.slice(0, 3).map((h) => `\`${baseName(h.path)}\` (${h.fanIn} dependents)`).join(', ') + '.'
-    );
-  }
-  const internal = scan.edges.filter((e) => e.from.startsWith(path + '/') && e.to.startsWith(path + '/')).length;
-  const outward = scan.edges.filter((e) => e.from.startsWith(path + '/') && !e.to.startsWith(path + '/')).length;
-  if (internal || outward) {
-    paras.push(`${internal} internal connections, ${outward} reaching out to other folders.`);
-  }
-  return paras.join('\n\n');
+    const here = scanIndex(scan).filesIn(path);
+    const entries = factIndex(facts).entries;
+    const entriesHere = here.filter((f) => entries.has(f.path));
+    const hubsHere = here
+        .map((f) => ({ path: f.path, fanIn: facts.fanIn[f.path] || 0 }))
+        .filter((h) => h.fanIn >= 3)
+        .sort((a, b) => b.fanIn - a.fanIn);
+    const paras = [];
+    paras.push(`**${path}/** — ${here.length} parsed ${here.length === 1 ? 'file' : 'files'}.`);
+    if (entriesHere.length) {
+        paras.push(`The way in: ${entriesHere.map((f) => '`' + f.name + '`').join(', ')}.`);
+    }
+    if (hubsHere.length) {
+        paras.push(`The load-bearing file${hubsHere.length > 1 ? 's' : ''}: ` +
+            hubsHere.slice(0, 3).map((h) => `\`${baseName(h.path)}\` (${h.fanIn} dependents)`).join(', ') + '.');
+    }
+    const internal = scan.edges.filter((e) => e.from.startsWith(path + '/') && e.to.startsWith(path + '/')).length;
+    const outward = scan.edges.filter((e) => e.from.startsWith(path + '/') && !e.to.startsWith(path + '/')).length;
+    if (internal || outward) {
+        paras.push(`${internal} internal connections, ${outward} reaching out to other folders.`);
+    }
+    return paras.join('\n\n');
 }
-
 export function explainOverview(scan, facts, manifest) {
-  const paras = [];
-  const langs = Object.entries(scan.stats.languages)
-    .sort((a, b) => b[1] - a[1])
-    .map(([k, v]) => `${v} ${langLabel(k)}`)
-    .join(', ');
-  paras.push(
-    `**${scan.name}** — ${scan.stats.filesParsed} code files (${langs}), ${scan.stats.edgeCount} import connections.`
-  );
-  if (facts.entries.length) {
-    paras.push(`Start reading at ${facts.entries.slice(0, 3).map((p) => '`' + p + '`').join(', ')}.`);
-  }
-  if (facts.hubs.length) {
-    const top = facts.hubs[0];
-    paras.push(`The file everyone depends on is \`${top.path}\` (${top.fanIn} dependents).`);
-  }
-  if (manifest?.services?.length) {
-    paras.push(`Runs as ${manifest.services.length} ${manifest.services.length === 1 ? 'service' : 'services'}: ${manifest.services.map((s) => s.name).join(', ')}.`);
-  }
-  if (facts.cycles.length) {
-    paras.push(`⚠ ${facts.cycles.length} circular ${facts.cycles.length === 1 ? 'dependency' : 'dependencies'} detected.`);
-  }
-  if (facts.orphans.length) {
-    paras.push(`${facts.orphans.length} files aren’t imported by anything — dead code, or entry points we didn’t recognize.`);
-  }
-  paras.push(...scanCaveats(scan));
-  return paras.join('\n\n');
+    const paras = [];
+    const langs = Object.entries(scan.stats.languages)
+        .sort((a, b) => Number(b[1]) - Number(a[1]))
+        .map(([k, v]) => `${v} ${langLabel(k)}`)
+        .join(', ');
+    paras.push(`**${scan.name}** — ${scan.stats.filesParsed} code files (${langs}), ${scan.stats.edgeCount} import connections.`);
+    if (facts.entries.length) {
+        paras.push(`Start reading at ${facts.entries.slice(0, 3).map((p) => '`' + p + '`').join(', ')}.`);
+    }
+    if (facts.hubs.length) {
+        const top = facts.hubs[0];
+        paras.push(`The file everyone depends on is \`${top.path}\` (${top.fanIn} dependents).`);
+    }
+    if (manifest?.services?.length) {
+        paras.push(`Runs as ${manifest.services.length} ${manifest.services.length === 1 ? 'service' : 'services'}: ${manifest.services.map((s) => s.name).join(', ')}.`);
+    }
+    if (facts.cycles.length) {
+        paras.push(`⚠ ${facts.cycles.length} circular ${facts.cycles.length === 1 ? 'dependency' : 'dependencies'} detected.`);
+    }
+    if (facts.orphans.length) {
+        paras.push(`${facts.orphans.length} files aren’t imported by anything — dead code, or entry points we didn’t recognize.`);
+    }
+    paras.push(...scanCaveats(scan));
+    return paras.join('\n\n');
 }
-
 // What the scan knows it doesn't know. These go last, in the same panel as the
 // findings, because a number you can't trust is worse than no number — and
 // every one of these changes how the rest of the page should be read.
 export function scanCaveats(scan) {
-  const out = [];
-  const t = scan.stats.truncated;
-  if (t) {
-    out.push(
-      `⚠ This is a partial scan. It stopped at ${t.atFiles} files with ${t.dirsQueued} ` +
-      `${t.dirsQueued === 1 ? 'directory' : 'directories'} still unvisited, so hubs look smaller than they are ` +
-      `and the unconnected-files count is inflated. Treat the health grade as indicative, not final.`
-    );
-  }
-  const imp = scan.stats.imports;
-  if (imp && imp.total) {
-    if (imp.confidence < 90) {
-      const worst = imp.worst.slice(0, 3).map((w) => '`' + w.spec + '`').join(', ');
-      out.push(
-        `${imp.confidence}% of the ${imp.total} imports found were placed — ${imp.unresolved} ` +
-        `couldn’t be matched to a file or a package${worst ? ', most often ' + worst : ''}. ` +
-        `Imports are read with regexes, so unresolved usually means a path alias, a generated ` +
-        `file, or code quoted inside a string.`
-      );
-    }
-  }
-  const s = scan.stats.skips;
-  if (s?.readFailed || s?.analyzeFailed || s?.listFailed) {
-    const bits = [];
-    if (s.listFailed) bits.push(`${s.listFailed} ${s.listFailed === 1 ? 'directory' : 'directories'} wouldn’t list`);
-    if (s.readFailed) bits.push(`${s.readFailed} ${s.readFailed === 1 ? 'file' : 'files'} wouldn’t read`);
-    if (s.analyzeFailed) bits.push(`${s.analyzeFailed} failed to parse`);
-    out.push(`Not everything could be read: ${bits.join(', ')}. Those files are missing from the graph.`);
-  }
-  return out;
+    const out = [];
+    const t = scan.stats.truncated;
+    if (t) {
+        out.push(`⚠ This is a partial scan. It stopped at ${t.atFiles} files with ${t.dirsQueued} ` +
+            `${t.dirsQueued === 1 ? 'directory' : 'directories'} still unvisited, so hubs look smaller than they are ` +
+            `and the unconnected-files count is inflated. Treat the health grade as indicative, not final.`);
+    }
+    const imp = scan.stats.imports;
+    if (imp && imp.total) {
+        if (imp.confidence < 90) {
+            const worst = imp.worst.slice(0, 3).map((w) => '`' + w.spec + '`').join(', ');
+            out.push(`${imp.confidence}% of the ${imp.total} imports found were placed — ${imp.unresolved} ` +
+                `couldn’t be matched to a file or a package${worst ? ', most often ' + worst : ''}. ` +
+                `Imports are read with regexes, so unresolved usually means a path alias, a generated ` +
+                `file, or code quoted inside a string.`);
+        }
+    }
+    const s = scan.stats.skips;
+    if (s?.readFailed || s?.analyzeFailed || s?.listFailed) {
+        const bits = [];
+        if (s.listFailed)
+            bits.push(`${s.listFailed} ${s.listFailed === 1 ? 'directory' : 'directories'} wouldn’t list`);
+        if (s.readFailed)
+            bits.push(`${s.readFailed} ${s.readFailed === 1 ? 'file' : 'files'} wouldn’t read`);
+        if (s.analyzeFailed)
+            bits.push(`${s.analyzeFailed} failed to parse`);
+        out.push(`Not everything could be read: ${bits.join(', ')}. Those files are missing from the graph.`);
+    }
+    return out;
 }
-
 function langLabel(id) {
-  return languageLabel(id, { short: true });
+    return languageLabel(id, { short: true });
 }
+//# sourceMappingURL=explainLocal.js.map

package/shared/analyzer/explainLocal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainLocal.js","sourceRoot":"","sources":["../../src/shared/analyzer/explainLocal.ts"],"names":[],"mappings":"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","sourcesContent":["// Offline explanations. When no LLM key is configured these are what the\n// user reads, so they're written like a colleague's notes, not a template\n// dump. Every claim comes straight from the static graph.\n\nimport { baseName } from './pathUtil.js';\nimport { roleOf, factIndex, scanIndex } from './graph.js';\nimport { languageLabel } from './languages/index.js';\n\nconst ROLE_LINES = {\n  entry: 'This is one of the ways into the codebase — a good place to start reading.',\n  hub: 'A lot of the codebase leans on this file. Changes here ripple outward.',\n  leaf: 'Nothing this file uses lives in the repo — it sits at the end of a chain.',\n  test: 'Test file. It verifies behavior rather than providing it.',\n  config: 'Configuration — it shapes how the rest of the code runs.',\n  module: 'A working part of the whole.',\n};\n\nexport function explainFile(path, file, facts) {\n  const role = roleOf(path, facts);\n  const fin = facts.fanIn[path] || 0;\n  const fout = facts.fanOut[path] || 0;\n  const paras = [];\n\n  paras.push(`**${baseName(path)}** — ${ROLE_LINES[role]}`);\n\n  const parts = [];\n  if (fout > 0) parts.push(`pulls in ${fout} other ${fout === 1 ? 'file' : 'files'}`);\n  if (fin > 0) parts.push(`is pulled in by ${fin}`);\n  if (fin === 0 && fout === 0 && role !== 'entry') parts.push('isn’t connected to anything else we can see');\n  if (parts.length) paras.push(`It ${parts.join(' and ')}.`);\n\n  const fns = (file?.functions || []).filter((f) => f.kind !== 'method');\n  const methods = (file?.functions || []).filter((f) => f.kind === 'method');\n  if (fns.length) {\n    paras.push(\n      `Defines ${fns.length} ${fns.length === 1 ? 'function' : 'functions'} — ` +\n        `${fns.slice(0, 6).map((f) => '`' + f.name + '`').join(', ')}` +\n        (fns.length > 6 ? ` and ${fns.length - 6} more` : '') + '.'\n    );\n  }\n  if (methods.length) {\n    paras.push(`Plus ${methods.length} ${methods.length === 1 ? 'method' : 'methods'} on its classes.`);\n  }\n  if (file?.classes?.length) {\n    paras.push(`Classes: ${file.classes.map((c) => '`' + c.name + '`').join(', ')}.`);\n  }\n\n  const importers = (facts.importers[path] || []).slice(0, 5);\n  if (importers.length) {\n    paras.push(\n      `If it broke, the first to notice would be ${importers.map((p) => '`' + baseName(p) + '`').join(', ')}` +\n        (fin > 5 ? ` and ${fin - 5} others` : '') + '.'\n    );\n  }\n\n  if (factIndex(facts).inCycle.has(path)) {\n    const cycle = facts.cycles.find((c) => c.includes(path));\n    if (cycle) {\n      paras.push(\n        `⚠ It sits in a circular dependency (${cycle.length} files importing each other in a loop). Worth knowing before you refactor.`\n      );\n    }\n  }\n\n  return paras.join('\\n\\n');\n}\n\nexport function explainFolder(path, scan, facts) {\n  const here = scanIndex(scan).filesIn(path);\n  const entries = factIndex(facts).entries;\n  const entriesHere = here.filter((f) => entries.has(f.path));\n  const hubsHere = here\n    .map((f) => ({ path: f.path, fanIn: facts.fanIn[f.path] || 0 }))\n    .filter((h) => h.fanIn >= 3)\n    .sort((a, b) => b.fanIn - a.fanIn);\n\n  const paras = [];\n  paras.push(`**${path}/** — ${here.length} parsed ${here.length === 1 ? 'file' : 'files'}.`);\n  if (entriesHere.length) {\n    paras.push(`The way in: ${entriesHere.map((f) => '`' + f.name + '`').join(', ')}.`);\n  }\n  if (hubsHere.length) {\n    paras.push(\n      `The load-bearing file${hubsHere.length > 1 ? 's' : ''}: ` +\n        hubsHere.slice(0, 3).map((h) => `\\`${baseName(h.path)}\\` (${h.fanIn} dependents)`).join(', ') + '.'\n    );\n  }\n  const internal = scan.edges.filter((e) => e.from.startsWith(path + '/') && e.to.startsWith(path + '/')).length;\n  const outward = scan.edges.filter((e) => e.from.startsWith(path + '/') && !e.to.startsWith(path + '/')).length;\n  if (internal || outward) {\n    paras.push(`${internal} internal connections, ${outward} reaching out to other folders.`);\n  }\n  return paras.join('\\n\\n');\n}\n\nexport function explainOverview(scan, facts, manifest) {\n  const paras = [];\n  const langs = Object.entries(scan.stats.languages)\n    .sort((a, b) => Number(b[1]) - Number(a[1]))\n    .map(([k, v]) => `${v} ${langLabel(k)}`)\n    .join(', ');\n  paras.push(\n    `**${scan.name}** — ${scan.stats.filesParsed} code files (${langs}), ${scan.stats.edgeCount} import connections.`\n  );\n  if (facts.entries.length) {\n    paras.push(`Start reading at ${facts.entries.slice(0, 3).map((p) => '`' + p + '`').join(', ')}.`);\n  }\n  if (facts.hubs.length) {\n    const top = facts.hubs[0];\n    paras.push(`The file everyone depends on is \\`${top.path}\\` (${top.fanIn} dependents).`);\n  }\n  if (manifest?.services?.length) {\n    paras.push(`Runs as ${manifest.services.length} ${manifest.services.length === 1 ? 'service' : 'services'}: ${manifest.services.map((s) => s.name).join(', ')}.`);\n  }\n  if (facts.cycles.length) {\n    paras.push(`⚠ ${facts.cycles.length} circular ${facts.cycles.length === 1 ? 'dependency' : 'dependencies'} detected.`);\n  }\n  if (facts.orphans.length) {\n    paras.push(`${facts.orphans.length} files aren’t imported by anything — dead code, or entry points we didn’t recognize.`);\n  }\n  paras.push(...scanCaveats(scan));\n  return paras.join('\\n\\n');\n}\n\n// What the scan knows it doesn't know. These go last, in the same panel as the\n// findings, because a number you can't trust is worse than no number — and\n// every one of these changes how the rest of the page should be read.\nexport function scanCaveats(scan) {\n  const out = [];\n  const t = scan.stats.truncated;\n  if (t) {\n    out.push(\n      `⚠ This is a partial scan. It stopped at ${t.atFiles} files with ${t.dirsQueued} ` +\n      `${t.dirsQueued === 1 ? 'directory' : 'directories'} still unvisited, so hubs look smaller than they are ` +\n      `and the unconnected-files count is inflated. Treat the health grade as indicative, not final.`\n    );\n  }\n  const imp = scan.stats.imports;\n  if (imp && imp.total) {\n    if (imp.confidence < 90) {\n      const worst = imp.worst.slice(0, 3).map((w) => '`' + w.spec + '`').join(', ');\n      out.push(\n        `${imp.confidence}% of the ${imp.total} imports found were placed — ${imp.unresolved} ` +\n        `couldn’t be matched to a file or a package${worst ? ', most often ' + worst : ''}. ` +\n        `Imports are read with regexes, so unresolved usually means a path alias, a generated ` +\n        `file, or code quoted inside a string.`\n      );\n    }\n  }\n  const s = scan.stats.skips;\n  if (s?.readFailed || s?.analyzeFailed || s?.listFailed) {\n    const bits = [];\n    if (s.listFailed) bits.push(`${s.listFailed} ${s.listFailed === 1 ? 'directory' : 'directories'} wouldn’t list`);\n    if (s.readFailed) bits.push(`${s.readFailed} ${s.readFailed === 1 ? 'file' : 'files'} wouldn’t read`);\n    if (s.analyzeFailed) bits.push(`${s.analyzeFailed} failed to parse`);\n    out.push(`Not everything could be read: ${bits.join(', ')}. Those files are missing from the graph.`);\n  }\n  return out;\n}\n\nfunction langLabel(id) {\n  return languageLabel(id, { short: true });\n}\n"]}

package/shared/analyzer/github.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The `owner/repo` a git URL points at, or null if it is not a GitHub URL.
+ *
+ * Both URL shapes git accepts: `https://github.com/owner/repo(.git)` and
+ * `git@github.com:owner/repo(.git)`. Anything else is not GitHub, and gets no
+ * remote lookup — a GitLab or Bitbucket clone is a real outcome, not an error.
+ */
+export declare function githubRepoPath(url: any): string;
+/**
+ * The public facts worth showing, read out of `GET /repos/{owner}/{repo}`.
+ *
+ * Returns null for anything that is not an object, so a caller can tell "no
+ * facts" from "all zeroes" without a try/catch around every field.
+ */
+export declare function remoteFacts(json: any): {
+    stars: number;
+    forks: number;
+    watching: number;
+    issues: number;
+    description: any;
+    license: any;
+    created: any;
+    pushed: any;
+    branch: any;
+    topics: any;
+    homepage: any;
+    archived: boolean;
+};
+/**
+ * Why a remote lookup did not produce facts, in the words a person can act on.
+ *
+ * 403, 404 and 429 are separated because they mean opposite things — one is
+ * "ask less often, or authenticate", one is "private, or gone, or never there",
+ * and one is "slow down" — and collapsing them into "GitHub said no" helps
+ * nobody diagnose anything.
+ */
+export declare function remoteError(status: any): string;

package/shared/analyzer/github.js

@@ -0,0 +1,79 @@
+// Reading a GitHub repository's public facts — the part the browser and the
+// terminal both need, and the part that was quietly wrong in one of them.
+//
+// This module is pure: it takes an already-parsed API payload and returns plain
+// data. The `fetch` deliberately stays on either side of it, because the two
+// callers can do things the other cannot — the browser must not hold a token,
+// and the terminal can. `shared/` may not know which runtime it is in, so the
+// network call is not here; only the reading of the answer is.
+//
+// One implementation, because the previous arrangement had the browser with its
+// own copy of the URL regex and its own idea of which counter means "watching",
+// and the two drifted apart without anything noticing.
+/**
+ * The `owner/repo` a git URL points at, or null if it is not a GitHub URL.
+ *
+ * Both URL shapes git accepts: `https://github.com/owner/repo(.git)` and
+ * `git@github.com:owner/repo(.git)`. Anything else is not GitHub, and gets no
+ * remote lookup — a GitLab or Bitbucket clone is a real outcome, not an error.
+ */
+export function githubRepoPath(url) {
+    const m = String(url ?? '').match(/github\.com[:/]([^/\s]+\/[^/\s]+?)(?:\.git)?\/?$/);
+    return m ? m[1] : null;
+}
+/**
+ * The public facts worth showing, read out of `GET /repos/{owner}/{repo}`.
+ *
+ * Returns null for anything that is not an object, so a caller can tell "no
+ * facts" from "all zeroes" without a try/catch around every field.
+ */
+export function remoteFacts(json) {
+    if (!json || typeof json !== 'object')
+        return null;
+    const count = (v) => (Number.isFinite(v) && v >= 0 ? Math.trunc(v) : 0);
+    return {
+        stars: count(json.stargazers_count),
+        forks: count(json.forks_count),
+        // `subscribers_count`, not `watchers_count`. The API has carried both for
+        // years and `watchers_count` is a legacy alias for the *stargazer* count —
+        // so labelling it "watching" printed the star number twice and called one
+        // of them watchers. The real watcher count is the subscribers number.
+        watching: count(json.subscribers_count),
+        issues: count(json.open_issues_count),
+        description: typeof json.description === 'string' ? json.description.trim() : '',
+        // "NOASSERTION" is GitHub's way of saying it found a license file it could
+        // not identify, which is not a license anyone can comply with.
+        license: json.license?.spdx_id && json.license.spdx_id !== 'NOASSERTION'
+            ? json.license.spdx_id
+            : '',
+        created: typeof json.created_at === 'string' ? json.created_at : '',
+        pushed: typeof json.pushed_at === 'string' ? json.pushed_at : '',
+        branch: typeof json.default_branch === 'string' ? json.default_branch : '',
+        topics: Array.isArray(json.topics)
+            ? json.topics.filter((t) => typeof t === 'string' && t).slice(0, 12)
+            : [],
+        homepage: typeof json.homepage === 'string' ? json.homepage.trim() : '',
+        archived: Boolean(json.archived),
+    };
+}
+/**
+ * Why a remote lookup did not produce facts, in the words a person can act on.
+ *
+ * 403, 404 and 429 are separated because they mean opposite things — one is
+ * "ask less often, or authenticate", one is "private, or gone, or never there",
+ * and one is "slow down" — and collapsing them into "GitHub said no" helps
+ * nobody diagnose anything.
+ */
+export function remoteError(status) {
+    if (status === 403) {
+        return 'GitHub rate-limited the ask — the unauthenticated allowance is 60 an hour.';
+    }
+    if (status === 404) {
+        return 'GitHub has no such repository, or it is private.';
+    }
+    if (status === 429) {
+        return 'GitHub is throttling this machine — try again in a minute.';
+    }
+    return 'GitHub answered ' + status + '.';
+}
+//# sourceMappingURL=github.js.map

package/shared/analyzer/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/shared/analyzer/github.ts"],"names":[],"mappings":"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","sourcesContent":["// Reading a GitHub repository's public facts — the part the browser and the\n// terminal both need, and the part that was quietly wrong in one of them.\n//\n// This module is pure: it takes an already-parsed API payload and returns plain\n// data. The `fetch` deliberately stays on either side of it, because the two\n// callers can do things the other cannot — the browser must not hold a token,\n// and the terminal can. `shared/` may not know which runtime it is in, so the\n// network call is not here; only the reading of the answer is.\n//\n// One implementation, because the previous arrangement had the browser with its\n// own copy of the URL regex and its own idea of which counter means \"watching\",\n// and the two drifted apart without anything noticing.\n\n/**\n * The `owner/repo` a git URL points at, or null if it is not a GitHub URL.\n *\n * Both URL shapes git accepts: `https://github.com/owner/repo(.git)` and\n * `git@github.com:owner/repo(.git)`. Anything else is not GitHub, and gets no\n * remote lookup — a GitLab or Bitbucket clone is a real outcome, not an error.\n */\nexport function githubRepoPath(url) {\n  const m = String(url ?? '').match(/github\\.com[:/]([^/\\s]+\\/[^/\\s]+?)(?:\\.git)?\\/?$/);\n  return m ? m[1] : null;\n}\n\n/**\n * The public facts worth showing, read out of `GET /repos/{owner}/{repo}`.\n *\n * Returns null for anything that is not an object, so a caller can tell \"no\n * facts\" from \"all zeroes\" without a try/catch around every field.\n */\nexport function remoteFacts(json) {\n  if (!json || typeof json !== 'object') return null;\n  const count = (v) => (Number.isFinite(v) && v >= 0 ? Math.trunc(v) : 0);\n\n  return {\n    stars: count(json.stargazers_count),\n    forks: count(json.forks_count),\n    // `subscribers_count`, not `watchers_count`. The API has carried both for\n    // years and `watchers_count` is a legacy alias for the *stargazer* count —\n    // so labelling it \"watching\" printed the star number twice and called one\n    // of them watchers. The real watcher count is the subscribers number.\n    watching: count(json.subscribers_count),\n    issues: count(json.open_issues_count),\n    description: typeof json.description === 'string' ? json.description.trim() : '',\n    // \"NOASSERTION\" is GitHub's way of saying it found a license file it could\n    // not identify, which is not a license anyone can comply with.\n    license: json.license?.spdx_id && json.license.spdx_id !== 'NOASSERTION'\n      ? json.license.spdx_id\n      : '',\n    created: typeof json.created_at === 'string' ? json.created_at : '',\n    pushed: typeof json.pushed_at === 'string' ? json.pushed_at : '',\n    branch: typeof json.default_branch === 'string' ? json.default_branch : '',\n    topics: Array.isArray(json.topics)\n      ? json.topics.filter((t) => typeof t === 'string' && t).slice(0, 12)\n      : [],\n    homepage: typeof json.homepage === 'string' ? json.homepage.trim() : '',\n    archived: Boolean(json.archived),\n  };\n}\n\n/**\n * Why a remote lookup did not produce facts, in the words a person can act on.\n *\n * 403, 404 and 429 are separated because they mean opposite things — one is\n * \"ask less often, or authenticate\", one is \"private, or gone, or never there\",\n * and one is \"slow down\" — and collapsing them into \"GitHub said no\" helps\n * nobody diagnose anything.\n */\nexport function remoteError(status) {\n  if (status === 403) {\n    return 'GitHub rate-limited the ask — the unauthenticated allowance is 60 an hour.';\n  }\n  if (status === 404) {\n    return 'GitHub has no such repository, or it is private.';\n  }\n  if (status === 429) {\n    return 'GitHub is throttling this machine — try again in a minute.';\n  }\n  return 'GitHub answered ' + status + '.';\n}"]}

package/shared/analyzer/graph.d.ts

@@ -0,0 +1,41 @@
+export declare function computeFacts(scan: any, manifest?: Record<string, any>): {
+    communities: {
+        id: any;
+        members: any;
+        size: any;
+    }[];
+    betweenness: {
+        [k: string]: number;
+    };
+    betweennessExact: boolean;
+    fanIn: any;
+    fanOut: any;
+    importers: any;
+    importsOf: any;
+    entries: any;
+    hubs: any;
+    orphans: any;
+    cycles: any[];
+    inCycle: unknown[];
+    deadExports: any[];
+    testCoverage: {
+        testedCount: number;
+        totalNonTest: any;
+        ratio: number;
+    };
+    untestedHubs: any;
+    depsDrift: {
+        unusedDeclared: string[];
+        undeclaredImported: string[];
+    };
+    folderEdges: {
+        from: any;
+        to: any;
+        count: any;
+    }[];
+    entrySet: any;
+};
+export declare function factIndex(facts: any): any;
+export declare function roleOf(path: any, facts: any): "config" | "entry" | "hub" | "leaf" | "module" | "test";
+export declare function inCycle(path: any, facts: any): any;
+export declare function scanIndex(scan: any): any;