gitfamiliar 0.9.0 → 0.10.0

package/dist/bin/gitfamiliar.js

@@ -8,7 +8,7 @@ import {
   processBatch,
   resolveUser,
   walkFiles
-} from "../chunk-NGCQUB2H.js";
+} from "../chunk-6XUJIHN3.js";
 
 // src/cli/index.ts
 import { createRequire } from "module";
@@ -25,7 +25,7 @@ var DEFAULT_EXPIRATION = {
 
 // src/cli/options.ts
 function parseOptions(raw, repoPath) {
-  const mode = validateMode(raw.mode || "binary");
+  const mode = validateMode(raw.mode || "committed");
   let weights = DEFAULT_WEIGHTS;
   if (raw.weights) {
     weights = parseWeights(raw.weights);
@@ -45,7 +45,8 @@ function parseOptions(raw, repoPath) {
       hotspot = "personal";
     }
   }
-  const windowDays = raw.window ? parseInt(raw.window, 10) : void 0;
+  const sinceRaw = raw.since || raw.window;
+  const sinceDays = sinceRaw ? parseInt(sinceRaw, 10) : void 0;
   return {
     mode,
     user,
@@ -54,13 +55,20 @@ function parseOptions(raw, repoPath) {
     weights,
     repoPath,
     team: raw.team || false,
-    teamCoverage: raw.teamCoverage || false,
+    contributorsPerFile: raw.contributorsPerFile || raw.contributors || raw.teamCoverage || false,
     hotspot,
-    window: windowDays
+    since: sinceDays
   };
 }
+var MODE_ALIASES = {
+  binary: "committed",
+  authorship: "code-coverage"
+};
 function validateMode(mode) {
-  const valid = ["binary", "authorship", "weighted"];
+  if (mode in MODE_ALIASES) {
+    return MODE_ALIASES[mode];
+  }
+  const valid = ["committed", "code-coverage", "weighted"];
   if (!valid.includes(mode)) {
     throw new Error(
       `Invalid mode: "${mode}". Valid modes: ${valid.join(", ")}`
@@ -99,10 +107,10 @@ function formatPercent(score) {
 }
 function getModeLabel(mode) {
   switch (mode) {
-    case "binary":
-      return "Binary mode";
-    case "authorship":
-      return "Authorship mode";
+    case "committed":
+      return "Committed mode";
+    case "code-coverage":
+      return "Code Coverage mode";
     case "weighted":
       return "Weighted mode";
     default:
@@ -129,7 +137,7 @@ function renderFolder(node, indent, mode, maxDepth) {
         NAME_COLUMN_WIDTH - prefixWidth - name.length
       );
       const padding = " ".repeat(padWidth);
-      if (mode === "binary") {
+      if (mode === "committed") {
         const readCount = folder.readCount || 0;
         lines.push(
           `${prefix}${chalk.bold(name)}${padding} ${bar}  ${pct.padStart(4)} (${readCount}/${folder.fileCount} files)`
@@ -153,7 +161,7 @@ function renderTerminal(result) {
     chalk.bold(`GitFamiliar \u2014 ${repoName} (${getModeLabel(mode)})`)
   );
   console.log("");
-  if (mode === "binary") {
+  if (mode === "committed") {
     const readCount = tree.readCount || 0;
     const pct = formatPercent(tree.score);
     console.log(`Overall: ${readCount}/${tree.fileCount} files (${pct})`);
@@ -167,7 +175,7 @@ function renderTerminal(result) {
     console.log(line);
   }
   console.log("");
-  if (mode === "binary") {
+  if (mode === "committed") {
     const { writtenCount } = result;
     console.log(`Written: ${writtenCount} files`);
     console.log("");
@@ -1087,7 +1095,7 @@ async function computeMultiUser(options) {
         ...options,
         user: userName,
         team: false,
-        teamCoverage: false
+        contributorsPerFile: false
       };
       const result = await computeFamiliarity(userOptions);
       results.push({ userName, result });
@@ -1209,10 +1217,10 @@ function formatPercent2(score) {
 }
 function getModeLabel2(mode) {
   switch (mode) {
-    case "binary":
-      return "Binary mode";
-    case "authorship":
-      return "Authorship mode";
+    case "committed":
+      return "Committed mode";
+    case "code-coverage":
+      return "Code Coverage mode";
     case "weighted":
       return "Weighted mode";
     default:
@@ -1257,7 +1265,7 @@ function renderMultiUserTerminal(result) {
     const name = truncateName(summary.user.name, 14).padEnd(14);
     const bar = makeBar2(summary.overallScore);
     const pct = formatPercent2(summary.overallScore);
-    if (mode === "binary") {
+    if (mode === "committed") {
       console.log(
         `  ${name} ${bar}  ${pct.padStart(4)} (${summary.writtenCount}/${totalFiles} files)`
       );
@@ -1627,7 +1635,7 @@ async function computeHotspots(options) {
   const repoRoot = await gitClient.getRepoRoot();
   const filter = createFilter(repoRoot);
   const tree = await buildFileTree(gitClient, filter);
-  const timeWindow = options.window || DEFAULT_WINDOW;
+  const timeWindow = options.since || DEFAULT_WINDOW;
   const isTeamMode = options.hotspot === "team";
   const trackedFiles = /* @__PURE__ */ new Set();
   walkFiles(tree, (f) => trackedFiles.add(f.path));
@@ -1649,7 +1657,7 @@ async function computeHotspots(options) {
     const result = await computeFamiliarity({
       ...options,
       team: false,
-      teamCoverage: false
+      contributorsPerFile: false
     });
     userName = result.userName;
     familiarityMap = /* @__PURE__ */ new Map();
@@ -2104,10 +2112,10 @@ async function generateAndOpenHotspotHTML(result, repoPath) {
 // src/core/unified.ts
 async function computeUnified(options) {
   console.log("Computing unified dashboard data...");
-  console.log("  [1/4] Scoring (binary, authorship, weighted)...");
-  const [binary, authorship, weighted] = await Promise.all([
-    computeFamiliarity({ ...options, mode: "binary" }),
-    computeFamiliarity({ ...options, mode: "authorship" }),
+  console.log("  [1/4] Scoring (committed, code-coverage, weighted)...");
+  const [committed, codeCoverage, weighted] = await Promise.all([
+    computeFamiliarity({ ...options, mode: "committed" }),
+    computeFamiliarity({ ...options, mode: "code-coverage" }),
     computeFamiliarity({ ...options, mode: "weighted" })
   ]);
   console.log("  [2/4] Team coverage...");
@@ -2138,9 +2146,9 @@ async function computeUnified(options) {
   });
   console.log("Done.");
   return {
-    repoName: binary.repoName,
-    userName: binary.userName,
-    scoring: { binary, authorship, weighted },
+    repoName: committed.repoName,
+    userName: committed.userName,
+    scoring: { committed, codeCoverage, weighted },
     coverage,
     hotspot,
     hotspotTeamFamiliarity,
@@ -2152,8 +2160,10 @@ async function computeUnified(options) {
 import { writeFileSync as writeFileSync5 } from "fs";
 import { join as join5 } from "path";
 function generateUnifiedHTML(data) {
-  const scoringBinaryJson = JSON.stringify(data.scoring.binary.tree);
-  const scoringAuthorshipJson = JSON.stringify(data.scoring.authorship.tree);
+  const scoringCommittedJson = JSON.stringify(data.scoring.committed.tree);
+  const scoringCodeCoverageJson = JSON.stringify(
+    data.scoring.codeCoverage.tree
+  );
   const scoringWeightedJson = JSON.stringify(data.scoring.weighted.tree);
   const coverageTreeJson = JSON.stringify(data.coverage.tree);
   const coverageRiskJson = JSON.stringify(data.coverage.riskFiles);
@@ -2530,12 +2540,12 @@ function generateUnifiedHTML(data) {
 <body>
 <div id="header">
   <h1>GitFamiliar \u2014 ${data.repoName}</h1>
-  <div class="info">${data.userName} | ${data.scoring.binary.totalFiles} files</div>
+  <div class="info">${data.userName} | ${data.scoring.committed.totalFiles} files</div>
 </div>
 
 <div id="tabs">
   <div class="tab active" onclick="switchTab('scoring')">Scoring</div>
-  <div class="tab" onclick="switchTab('coverage')">Coverage</div>
+  <div class="tab" onclick="switchTab('coverage')">Contributors</div>
   <div class="tab" onclick="switchTab('multiuser')">Multi-User</div>
   <div class="tab" onclick="switchTab('hotspots')">Hotspots</div>
 </div>
@@ -2544,7 +2554,7 @@ function generateUnifiedHTML(data) {
   Your personal familiarity with each file, based on Git history. Larger blocks = more lines of code. Color shows how well you know each file.
 </div>
 <div id="tab-desc-coverage" class="tab-desc">
-  Team knowledge distribution: how many people have contributed to each file. Low contributor count = high bus factor risk.
+  Contributors per file: how many people have committed to each file. Low contributor count = high bus factor risk.
 </div>
 <div id="tab-desc-multiuser" class="tab-desc">
   Compare familiarity scores across team members. Select a user to see the codebase colored by their knowledge.
@@ -2554,9 +2564,9 @@ function generateUnifiedHTML(data) {
 </div>
 
 <div id="scoring-controls" class="visible">
-  <button class="subtab active" onclick="switchScoringMode('binary')">Binary</button>
-  <button class="subtab" onclick="switchScoringMode('authorship')">Authorship</button>
-  <button class="subtab" onclick="switchScoringMode('weighted')">Weighted</button>
+  <button class="subtab active" data-mode="committed" onclick="switchScoringMode('committed')">Committed</button>
+  <button class="subtab" data-mode="code-coverage" onclick="switchScoringMode('code-coverage')">Code Coverage</button>
+  <button class="subtab" data-mode="weighted" onclick="switchScoringMode('weighted')">Weighted</button>
   <div id="weight-controls">
     <span>Blame:</span>
     <span class="weight-label" id="blame-label">50%</span>
@@ -2576,13 +2586,13 @@ function generateUnifiedHTML(data) {
 
 <div id="hotspot-controls">
   <label>Mode:</label>
-  <button class="subtab active" onclick="switchHotspotMode('personal')">Personal</button>
-  <button class="subtab" onclick="switchHotspotMode('team')">Team</button>
+  <button class="subtab active" data-mode="personal" onclick="switchHotspotMode('personal')">Personal</button>
+  <button class="subtab" data-mode="team" onclick="switchHotspotMode('team')">Team</button>
   <span class="sep-v"></span>
   <label>Scoring:</label>
-  <button class="subtab hs-scoring active" onclick="switchHotspotScoring('binary')">Binary</button>
-  <button class="subtab hs-scoring" onclick="switchHotspotScoring('authorship')">Authorship</button>
-  <button class="subtab hs-scoring" onclick="switchHotspotScoring('weighted')">Weighted</button>
+  <button class="subtab hs-scoring active" data-mode="committed" onclick="switchHotspotScoring('committed')">Committed</button>
+  <button class="subtab hs-scoring" data-mode="code-coverage" onclick="switchHotspotScoring('code-coverage')">Code Coverage</button>
+  <button class="subtab hs-scoring" data-mode="weighted" onclick="switchHotspotScoring('weighted')">Weighted</button>
 </div>
 
 <div id="breadcrumb"><span onclick="zoomTo('')">root</span></div>
@@ -2632,8 +2642,8 @@ function generateUnifiedHTML(data) {
 <script>
 // \u2500\u2500 Data \u2500\u2500
 const scoringData = {
-  binary: ${scoringBinaryJson},
-  authorship: ${scoringAuthorshipJson},
+  committed: ${scoringCommittedJson},
+  'code-coverage': ${scoringCodeCoverageJson},
   weighted: ${scoringWeightedJson},
 };
 const coverageData = ${coverageTreeJson};
@@ -2646,14 +2656,14 @@ const multiUserSummaries = ${multiUserSummariesJson};
 
 // \u2500\u2500 State \u2500\u2500
 let activeTab = 'scoring';
-let scoringMode = 'binary';
+let scoringMode = 'committed';
 let blameWeight = 0.5;
 let scoringPath = '';
 let coveragePath = '';
 let multiuserPath = '';
 let currentUser = 0;
 let hotspotMode = 'personal';
-let hotspotScoring = 'binary';
+let hotspotScoring = 'committed';
 const rendered = { scoring: false, coverage: false, hotspots: false, multiuser: false };
 
 // \u2500\u2500 Hotspot recalculation utilities \u2500\u2500
@@ -2668,8 +2678,8 @@ function extractFlatScores(node) {
 }
 
 const personalScores = {
-  binary: extractFlatScores(scoringData.binary),
-  authorship: extractFlatScores(scoringData.authorship),
+  committed: extractFlatScores(scoringData.committed),
+  'code-coverage': extractFlatScores(scoringData['code-coverage']),
   weighted: extractFlatScores(scoringData.weighted),
 };
 
@@ -2691,7 +2701,7 @@ function recalculateHotspotData() {
 function switchHotspotMode(mode) {
   hotspotMode = mode;
   document.querySelectorAll('#hotspot-controls .subtab:not(.hs-scoring)').forEach(el => {
-    el.classList.toggle('active', el.textContent.toLowerCase() === mode);
+    el.classList.toggle('active', el.dataset.mode === mode);
   });
   // Disable scoring buttons in team mode
   const isTeam = mode === 'team';
@@ -2706,7 +2716,7 @@ function switchHotspotScoring(mode) {
   if (hotspotMode === 'team') return;
   hotspotScoring = mode;
   document.querySelectorAll('#hotspot-controls .hs-scoring').forEach(el => {
-    el.classList.toggle('active', el.textContent.toLowerCase() === mode);
+    el.classList.toggle('active', el.dataset.mode === mode);
   });
   renderHotspot();
   renderHotspotSidebar();
@@ -2806,8 +2816,8 @@ function truncateLabel(name, w, h) {
 
 // \u2500\u2500 Tab switching \u2500\u2500
 const modeDescriptions = {
-  binary: 'Binary: Have you ever committed to this file? Yes (green) or No (red).',
-  authorship: 'Authorship: How much of the current code did you write? Based on git blame line ownership.',
+  committed: 'Committed: Have you ever committed to this file? Yes (green) or No (red).',
+  'code-coverage': 'Code Coverage: How much of the current code did you write? Based on git blame line ownership.',
   weighted: 'Weighted: Combines blame ownership and commit history with adjustable weights. Use the sliders to tune.',
 };
 
@@ -2883,7 +2893,7 @@ function switchScoringMode(mode) {
   scoringPath = '';
   updateBreadcrumb('');
   document.querySelectorAll('#scoring-controls .subtab').forEach(el => {
-    el.classList.toggle('active', el.textContent.toLowerCase() === mode);
+    el.classList.toggle('active', el.dataset.mode === mode);
   });
   document.getElementById('weight-controls').classList.toggle('visible', mode === 'weighted');
   document.getElementById('mode-desc-text').textContent = modeDescriptions[mode];
@@ -3337,8 +3347,8 @@ function createProgram() {
   const program2 = new Command();
   program2.name("gitfamiliar").description("Visualize your code familiarity from Git history").version(pkg.version).option(
     "-m, --mode <mode>",
-    "Scoring mode: binary, authorship, weighted",
-    "binary"
+    "Scoring mode: committed, code-coverage, weighted",
+    "committed"
   ).option(
     "-u, --user <user>",
     "Git user name or email (repeatable for comparison)",
@@ -3352,18 +3362,15 @@ function createProgram() {
     "-w, --weights <weights>",
     'Weights for weighted mode: blame,commit (e.g., "0.5,0.5")'
   ).option("--team", "Compare all contributors", false).option(
-    "--team-coverage",
-    "Show team coverage map (bus factor analysis)",
+    "--contributors-per-file",
+    "Analyze number of contributors per file (bus factor)",
     false
-  ).option("--hotspot [mode]", "Hotspot analysis: personal (default) or team").option(
-    "--window <days>",
-    "Time window for hotspot analysis in days (default: 90)"
-  ).action(async (rawOptions) => {
+  ).option("--contributors", "Alias for --contributors-per-file").option("--team-coverage", "Deprecated alias for --contributors-per-file").option("--hotspot [mode]", "Hotspot analysis: personal (default) or team").option("--since <days>", "Hotspot analysis period in days (default: 90)").option("--window <days>", "Deprecated alias for --since").action(async (rawOptions) => {
     try {
       const repoPath = process.cwd();
       const options = parseOptions(rawOptions, repoPath);
       const isMultiUserCheck = options.team || Array.isArray(options.user) && options.user.length > 1;
-      if (options.html && !options.hotspot && !options.teamCoverage && !isMultiUserCheck) {
+      if (options.html && !options.hotspot && !options.contributorsPerFile && !isMultiUserCheck) {
         const data = await computeUnified(options);
         await generateAndOpenUnifiedHTML(data, repoPath);
         return;
@@ -3377,7 +3384,7 @@ function createProgram() {
         }
         return;
       }
-      if (options.teamCoverage) {
+      if (options.contributorsPerFile) {
         const result2 = await computeTeamCoverage(options);
         if (options.html) {
           await generateAndOpenCoverageHTML(result2, repoPath);