@drazenbebic/wdid 0.1.0 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 > What did I do? — a small CLI that summarizes your git activity as a tidy table, so you can fill in your timesheet without trying to remember Tuesday.
 
-`wdid` reads `git log` for your author across one or more repos and renders the output as a colorized table with **Date**, **Ticket** (JIRA-style `ABC-123`, parsed from the commit subject), and **Description**.
+`wdid` reads `git log` for your author across one or more repos and renders the output as a colorized table with **Date** (with commit time, shown in your local timezone), **Ticket** (JIRA-style `ABC-123` by default, parsed from the commit subject), and **Description**.
 
 ## Install
 
@@ -28,26 +28,90 @@ By default `wdid` uses `git config user.name` as the author and the current work
 ### Example output
 
 ```
-┌────────────┬──────────────┬──────────────────────────────────────────────────┐
-│ Date       │ Ticket       │ Description                                      │
-├────────────┼──────────────┼──────────────────────────────────────────────────┤
-│ 2026-05-27 │ ABC-123      │ feat(ABC-123): add login flow                    │
-│ 2026-05-27 │ —            │ chore: bump deps                                 │
-│ 2026-05-26 │ ABC-119      │ fix(ABC-119): handle empty payload               │
-└────────────┴──────────────┴──────────────────────────────────────────────────┘
+┌──────────────────┬──────────────┬──────────────────────────────────────────────────┐
+│ Date             │ Ticket       │ Description                                      │
+├──────────────────┼──────────────┼──────────────────────────────────────────────────┤
+│ 2026-05-27 16:42 │ ABC-123      │ feat(ABC-123): add login flow                    │
+│ 2026-05-27 11:08 │ —            │ chore: bump deps                                 │
+│ 2026-05-26 17:53 │ ABC-119      │ fix(ABC-119): handle empty payload               │
+└──────────────────┴──────────────┴──────────────────────────────────────────────────┘
 ```
 
+The time is rendered dimmed and shown in your local timezone (parsed from the committer's full ISO timestamp).
+
 If a commit doesn't reference a ticket, the Ticket column is left blank (rendered as `—`).
 
+With `--group-by-day`, the date moves into a section heading instead of repeating per row, making longer outputs feel more like a journal:
+
+```
+┌───────┬──────────────┬─────────────────────────────────────┐
+│ Time  │ Ticket       │ Description                         │
+├───────┴──────────────┴─────────────────────────────────────┤
+│ 2026-05-27                                                 │
+├───────┬──────────────┬─────────────────────────────────────┤
+│ 16:42 │ ABC-123      │ feat(ABC-123): add login flow       │
+│ 11:08 │ —            │ chore: bump deps                    │
+├───────┴──────────────┴─────────────────────────────────────┤
+│ 2026-05-26                                                 │
+├───────┬──────────────┬─────────────────────────────────────┤
+│ 17:53 │ ABC-119      │ fix(ABC-119): handle empty payload  │
+└───────┴──────────────┴─────────────────────────────────────┘
+```
+
 ## Options
 
-| Option             | Description                                                           |
-| ------------------ | --------------------------------------------------------------------- |
-| `[date]`           | A `YYYY-MM-DD` date or the literal `today`. Omit to show all history. |
-| `--from <date>`    | Start date (inclusive).                                               |
-| `--to <date>`      | End date (inclusive).                                                 |
-| `--author <name>`  | Override the git author. Defaults to `git config user.name`.          |
-| `--repo <path...>` | One or more repo paths to query. Defaults to the current directory.   |
+| Option                     | Description                                                                                  |
+| -------------------------- | -------------------------------------------------------------------------------------------- |
+| `[date]`                   | A `YYYY-MM-DD` date or the literal `today`. Omit to show all history.                        |
+| `--from <date>`            | Start date (inclusive).                                                                      |
+| `--to <date>`              | End date (inclusive).                                                                        |
+| `--author <name>`          | Override the git author. Defaults to `git config user.name` (or `defaultAuthor` in config).  |
+| `--repo <path...>`         | One or more repo paths to query. Defaults to `defaultRepos` in config, then the current dir. |
+| `--format <preset>`        | Ticket format: `jira`, `github`, `conventional`, or `custom`. Defaults to `jira`.            |
+| `--ticket-pattern <regex>` | Custom regex for ticket extraction. Implies `--format custom`; overrides `--format`.         |
+| `--no-color`               | Disable colored output. Also honored via the `NO_COLOR` env var.                             |
+| `--limit <N>`              | Cap the table to the most recent `N` rows. Positive integer.                                 |
+| `--group-by-day`           | Group rows under a bold date heading per day; the row only shows the time.                   |
+| `--json`                   | Emit a JSON array of commit entries to stdout instead of the table. Empty result is `[]`.    |
+
+## Configuration
+
+`wdid` looks for a config file in this order:
+
+1. **Repo-level** (current directory and walking up): `wdid.config.{js,cjs,mjs,ts,json,yaml,yml}`, `.wdidrc{,.json,.yaml,.yml,.js,.cjs}`, or a `"wdid"` field in `package.json`.
+2. **Global**: `~/.config/wdid/config.json` (honors `XDG_CONFIG_HOME`).
+
+CLI flags always win. The first match in this list is used in full (configs do not merge across levels).
+
+### Schema
+
+```json
+{
+  "format": "jira",
+  "customPattern": "^\\[([A-Z]+-\\d+)\\]",
+  "defaultAuthor": "Jane Doe",
+  "defaultRepos": ["~/work/api", "~/work/web"]
+}
+```
+
+| Field               | Type                                               | Description                                                                        |
+| ------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `format`            | `"jira" \| "github" \| "conventional" \| "custom"` | Ticket extraction preset. Default `jira`.                                          |
+| `customPattern`     | `string`                                           | Regex used when `format` is `"custom"`. First capture group wins, else full match. |
+| `defaultAuthor`     | `string`                                           | Used when `--author` is not passed and you want to skip the `git config` lookup.   |
+| `defaultRepos`      | `string[]`                                         | Paths to query when no `--repo` is given. `~` is expanded.                         |
+| `ticketColumnLabel` | `string`                                           | Override the auto-picked column header (see below).                                |
+
+### Format presets
+
+| Preset         | Matches                                          | Example commit → match                 | Column header |
+| -------------- | ------------------------------------------------ | -------------------------------------- | ------------- |
+| `jira`         | `ABC-123` style (uppercase project key + digits) | `feat(ABC-123): add login` → `ABC-123` | `Ticket`      |
+| `github`       | `#123` style                                     | `Closes #42` → `42`                    | `Issue`       |
+| `conventional` | Conventional Commit `type(scope)!`               | `feat(auth)!: ...` → `feat(auth)!`     | `Type`        |
+| `custom`       | Your `customPattern` regex                       | depends on the regex                   | `Match`       |
+
+The column header is picked automatically based on the active format. To override it for a specific preset (e.g. call them "Tasks" instead of "Ticket"), set `ticketColumnLabel` in your config.
 
 ## Development
 

package/dist/index.js

@@ -1,73 +1,264 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import chalk2 from "chalk";
 import { Command } from "commander";
 
 // src/git.ts
-import { execFile } from "child_process";
+import { execFile, spawn } from "child_process";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
 var FIELD_SEP = "";
 var RECORD_SEP = "";
-var JIRA_TICKET_RE = /\b([A-Z][A-Z0-9]+-\d+)\b/;
-function extractTicket(message) {
-  const match = message.match(JIRA_TICKET_RE);
-  return match ? match[1] : null;
+var TRUNK_BRANCHES = /* @__PURE__ */ new Set(["main", "master"]);
+var pad2 = (n) => String(n).padStart(2, "0");
+function formatLocalDateTime(iso) {
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) {
+    return { date: "", time: "" };
+  }
+  const date = `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
+  const time = `${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
+  return { date, time };
 }
-async function getGitUserName(cwd) {
-  const { stdout } = await execFileAsync("git", ["config", "user.name"], {
-    cwd
+function extractTicket(message, pattern) {
+  const match = message.match(pattern);
+  if (!match) {
+    return null;
+  }
+  return match[1] ?? match[0];
+}
+function normalizeBranchName(rawName) {
+  const clean = rawName.replace(/[~^].*$/, "").trim();
+  if (!clean || clean === "undefined" || TRUNK_BRANCHES.has(clean)) {
+    return null;
+  }
+  return clean;
+}
+async function runGitWithStdin(cwd, args, input) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn("git", args, { cwd });
+    let stdout = "";
+    let stderr = "";
+    proc.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    proc.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    proc.on("error", reject);
+    proc.on("close", (code) => {
+      if (code !== 0) {
+        reject(new Error(`git ${args.join(" ")} failed: ${stderr.trim()}`));
+        return;
+      }
+      resolve(stdout);
+    });
+    proc.stdin.write(input);
+    proc.stdin.end();
   });
-  return stdout.trim();
+}
+async function getBranchMap(cwd, shas) {
+  const map = /* @__PURE__ */ new Map();
+  if (shas.length === 0) {
+    return map;
+  }
+  let stdout;
+  try {
+    stdout = await runGitWithStdin(
+      cwd,
+      ["name-rev", "--stdin", "--refs=refs/heads/*"],
+      shas.join("\n") + "\n"
+    );
+  } catch {
+    return map;
+  }
+  for (const line of stdout.split("\n")) {
+    const m = line.match(/^([0-9a-fA-F]+)\s+\((.+)\)\s*$/);
+    if (!m) {
+      continue;
+    }
+    const sha = m[1];
+    const rawName = m[2];
+    if (!sha || !rawName) {
+      continue;
+    }
+    map.set(sha, normalizeBranchName(rawName));
+  }
+  return map;
+}
+async function assertGitRepo(cwd) {
+  try {
+    await execFileAsync("git", ["rev-parse", "--is-inside-work-tree"], {
+      cwd
+    });
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      throw new Error("git is not installed or not on PATH", { cause: err });
+    }
+    throw new Error(
+      `not inside a git repository: ${cwd} \u2014 cd into a repo or pass --repo <path>`,
+      { cause: err }
+    );
+  }
+}
+async function getGitUserName(cwd) {
+  try {
+    const { stdout } = await execFileAsync("git", ["config", "user.name"], {
+      cwd
+    });
+    const name = stdout.trim();
+    if (!name) {
+      throw new Error("empty");
+    }
+    return name;
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      throw new Error("git is not installed or not on PATH", { cause: err });
+    }
+    throw new Error(
+      'could not read git user.name \u2014 set it with `git config user.name "Your Name"` or pass --author',
+      { cause: err }
+    );
+  }
 }
 async function getCommits(opts) {
+  await assertGitRepo(opts.cwd);
   const args = [
     "log",
     "--all",
     "--author-date-order",
     "--regexp-ignore-case",
     `--author=${opts.author}`,
-    `--pretty=format:%cs${FIELD_SEP}%s${RECORD_SEP}`
+    `--pretty=format:%H${FIELD_SEP}%cI${FIELD_SEP}%s${RECORD_SEP}`
   ];
-  if (opts.from) args.push(`--after=${opts.from} 00:00`);
-  if (opts.to) args.push(`--before=${opts.to} 23:59`);
-  const { stdout } = await execFileAsync("git", args, {
-    cwd: opts.cwd,
-    maxBuffer: 32 * 1024 * 1024
-  });
-  return stdout.split(RECORD_SEP).map((r) => r.trim()).filter((r) => r.length > 0).map((record) => {
-    const [date = "", subject = ""] = record.split(FIELD_SEP);
+  if (opts.from) {
+    args.push(`--after=${opts.from} 00:00`);
+  }
+  if (opts.to) {
+    args.push(`--before=${opts.to} 23:59`);
+  }
+  if (opts.limit !== void 0) {
+    args.push(`--max-count=${opts.limit}`);
+  }
+  let stdout;
+  try {
+    const result = await execFileAsync("git", args, {
+      cwd: opts.cwd,
+      maxBuffer: 32 * 1024 * 1024
+    });
+    stdout = result.stdout;
+  } catch (err) {
+    const stderr = String(err.stderr ?? "");
+    if (stderr.includes("does not have any commits") || stderr.includes("bad default revision") || stderr.includes("unknown revision")) {
+      return [];
+    }
+    throw err;
+  }
+  const parsed = stdout.split(RECORD_SEP).map((r) => r.trim()).filter((r) => r.length > 0).map((record) => {
+    const [sha = "", iso = "", subject = ""] = record.split(FIELD_SEP);
+    const { date, time } = formatLocalDateTime(iso);
     return {
+      sha,
       date,
-      ticket: extractTicket(subject),
+      time,
+      ticket: extractTicket(subject, opts.pattern),
       description: subject
     };
   });
+  const branchMap = await getBranchMap(
+    opts.cwd,
+    parsed.map((p) => p.sha).filter((s) => s.length > 0)
+  );
+  return parsed.map((p) => ({
+    date: p.date,
+    time: p.time,
+    ticket: p.ticket,
+    description: p.description,
+    branch: branchMap.get(p.sha) ?? null
+  }));
 }
 
 // src/format.ts
 import Table from "cli-table3";
 import chalk from "chalk";
-function renderTable(entries) {
+function renderDateCell(entry) {
+  if (!entry.time) {
+    return entry.date;
+  }
+  return `${entry.date} ${chalk.dim(entry.time)}`;
+}
+function renderDescriptionCell(entry) {
+  if (!entry.branch) {
+    return entry.description;
+  }
+  return `${entry.description} ${chalk.magenta(`[${entry.branch}]`)}`;
+}
+function renderTable(entries, ticketColumnLabel = "Ticket") {
   const table = new Table({
     head: [
       chalk.bold.cyan("Date"),
-      chalk.bold.cyan("Ticket"),
+      chalk.bold.cyan(ticketColumnLabel),
+      chalk.bold.cyan("Description")
+    ],
+    style: { head: [], border: [] },
+    wordWrap: true,
+    colWidths: [18, 14, 80]
+  });
+  for (const entry of entries) {
+    table.push([
+      renderDateCell(entry),
+      entry.ticket ? chalk.yellow(entry.ticket) : chalk.gray("\u2014"),
+      renderDescriptionCell(entry)
+    ]);
+  }
+  return table.toString();
+}
+function renderTableGroupedByDay(entries, ticketColumnLabel = "Ticket") {
+  const table = new Table({
+    head: [
+      chalk.bold.cyan("Time"),
+      chalk.bold.cyan(ticketColumnLabel),
       chalk.bold.cyan("Description")
     ],
     style: { head: [], border: [] },
     wordWrap: true,
-    colWidths: [12, 14, 80]
+    colWidths: [8, 14, 90]
   });
+  let currentDate = "";
   for (const entry of entries) {
+    if (entry.date && entry.date !== currentDate) {
+      table.push([
+        {
+          content: chalk.bold(entry.date),
+          colSpan: 3,
+          hAlign: "left"
+        }
+      ]);
+      currentDate = entry.date;
+    }
     table.push([
-      chalk.dim(entry.date),
+      entry.time ? chalk.dim(entry.time) : chalk.gray("\u2014"),
       entry.ticket ? chalk.yellow(entry.ticket) : chalk.gray("\u2014"),
-      entry.description
+      renderDescriptionCell(entry)
     ]);
   }
   return table.toString();
 }
+function toJsonKey(label) {
+  return label.toLowerCase().replace(/\s+/g, "_");
+}
+function renderJson(entries, ticketColumnLabel = "Ticket") {
+  const key = toJsonKey(ticketColumnLabel);
+  const transformed = entries.map((e) => ({
+    date: e.date,
+    time: e.time,
+    [key]: e.ticket,
+    description: e.description,
+    branch: e.branch
+  }));
+  return JSON.stringify(transformed, null, 2);
+}
 function renderEmpty() {
   return chalk.gray("No commits found for the given filters.");
 }
@@ -75,7 +266,165 @@ function renderError(message) {
   return chalk.red(`error: ${message}`);
 }
 
+// src/config.ts
+import { homedir } from "os";
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { cosmiconfig } from "cosmiconfig";
+var DEFAULT_COLUMN_LABELS = {
+  jira: "Ticket",
+  github: "Issue",
+  conventional: "Type",
+  custom: "Match"
+};
+function getColumnLabel(format, override) {
+  return override ?? DEFAULT_COLUMN_LABELS[format];
+}
+var PRESET_PATTERNS = {
+  jira: /\b([A-Z][A-Z0-9]+-\d+)\b/,
+  github: /#(\d+)/,
+  conventional: /^(\w+(?:\([^)]+\))?!?):/
+};
+var VALID_FORMATS = [
+  "jira",
+  "github",
+  "conventional",
+  "custom"
+];
+var MAX_CUSTOM_PATTERN_LENGTH = 500;
+function compileUserRegex(pattern) {
+  if (pattern.length > MAX_CUSTOM_PATTERN_LENGTH) {
+    throw new Error(
+      `customPattern is ${pattern.length} characters; limit is ${MAX_CUSTOM_PATTERN_LENGTH}`
+    );
+  }
+  try {
+    return new RegExp(pattern);
+  } catch (err) {
+    throw new Error(
+      `customPattern is not a valid regex: ${err.message}`,
+      { cause: err }
+    );
+  }
+}
+function getTicketPattern(format, customPattern) {
+  if (format === "custom") {
+    if (!customPattern) {
+      throw new Error('format "custom" requires customPattern to be set');
+    }
+    return compileUserRegex(customPattern);
+  }
+  return PRESET_PATTERNS[format];
+}
+function expandPath(p) {
+  if (p === "~") {
+    return homedir();
+  }
+  if (p.startsWith("~/")) {
+    return join(homedir(), p.slice(2));
+  }
+  return p;
+}
+function validateConfig(raw) {
+  if (typeof raw !== "object" || raw === null) {
+    throw new Error("config must be an object");
+  }
+  const obj = raw;
+  const cfg = {};
+  if ("format" in obj) {
+    if (typeof obj.format !== "string" || !VALID_FORMATS.includes(obj.format)) {
+      throw new Error(
+        `invalid format "${String(obj.format)}" \u2014 must be one of ${VALID_FORMATS.join(", ")}`
+      );
+    }
+    cfg.format = obj.format;
+  }
+  if ("customPattern" in obj) {
+    if (typeof obj.customPattern !== "string") {
+      throw new Error("customPattern must be a string");
+    }
+    if (obj.customPattern.length > MAX_CUSTOM_PATTERN_LENGTH) {
+      throw new Error(
+        `customPattern is ${obj.customPattern.length} characters; limit is ${MAX_CUSTOM_PATTERN_LENGTH}`
+      );
+    }
+    cfg.customPattern = obj.customPattern;
+  }
+  if (cfg.format === "custom" && !cfg.customPattern) {
+    throw new Error('format "custom" requires customPattern to be set');
+  }
+  if ("defaultAuthor" in obj) {
+    if (typeof obj.defaultAuthor !== "string") {
+      throw new Error("defaultAuthor must be a string");
+    }
+    cfg.defaultAuthor = obj.defaultAuthor;
+  }
+  if ("defaultRepos" in obj) {
+    if (!Array.isArray(obj.defaultRepos) || !obj.defaultRepos.every((r) => typeof r === "string")) {
+      throw new Error("defaultRepos must be an array of strings");
+    }
+    cfg.defaultRepos = obj.defaultRepos;
+  }
+  if ("ticketColumnLabel" in obj) {
+    if (typeof obj.ticketColumnLabel !== "string") {
+      throw new Error("ticketColumnLabel must be a string");
+    }
+    cfg.ticketColumnLabel = obj.ticketColumnLabel;
+  }
+  return cfg;
+}
+function globalConfigPath() {
+  const xdgConfigHome = process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+  return join(xdgConfigHome, "wdid", "config.json");
+}
+async function loadGlobalConfig() {
+  try {
+    const content = await readFile(globalConfigPath(), "utf-8");
+    return validateConfig(JSON.parse(content));
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return null;
+    }
+    throw err;
+  }
+}
+async function loadConfig(cwd) {
+  const explorer = cosmiconfig("wdid");
+  const local = await explorer.search(cwd);
+  if (local?.config) {
+    return validateConfig(local.config);
+  }
+  const global = await loadGlobalConfig();
+  if (global) {
+    return global;
+  }
+  return {};
+}
+
 // src/index.ts
+function parseLimit(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const n = Number.parseInt(raw, 10);
+  if (!Number.isInteger(n) || n < 1 || String(n) !== raw.trim()) {
+    throw new Error(`invalid --limit "${raw}" \u2014 must be a positive integer`);
+  }
+  return n;
+}
+function shouldDisableColor(options) {
+  if (options.color === false) {
+    return true;
+  }
+  const noColor = process.env.NO_COLOR ?? "";
+  return noColor.length > 0;
+}
+var VALID_PRESETS = [
+  "jira",
+  "github",
+  "conventional",
+  "custom"
+];
 function isIsoDate(value) {
   return /^\d{4}-\d{2}-\d{2}$/.test(value);
 }
@@ -89,7 +438,27 @@ function resolveDate(input) {
   return input;
 }
 async function run(dateArg, options) {
-  const repos = options.repo && options.repo.length > 0 ? options.repo : [process.cwd()];
+  const config = await loadConfig(process.cwd());
+  let format;
+  let customPattern;
+  if (options.ticketPattern) {
+    format = "custom";
+    customPattern = options.ticketPattern;
+  } else if (options.format) {
+    if (!VALID_PRESETS.includes(options.format)) {
+      throw new Error(
+        `invalid --format "${options.format}" \u2014 must be one of ${VALID_PRESETS.join(", ")}`
+      );
+    }
+    format = options.format;
+    customPattern = config.customPattern;
+  } else {
+    format = config.format ?? "jira";
+    customPattern = config.customPattern;
+  }
+  const pattern = getTicketPattern(format, customPattern);
+  const configRepos = config.defaultRepos?.map(expandPath) ?? [];
+  const repos = options.repo && options.repo.length > 0 ? options.repo : configRepos.length > 0 ? configRepos : [process.cwd()];
   let from = options.from ? resolveDate(options.from) : void 0;
   let to = options.to ? resolveDate(options.to) : void 0;
   if (dateArg) {
@@ -97,27 +466,56 @@ async function run(dateArg, options) {
     from = day;
     to = day;
   }
-  const allEntries = [];
-  for (const cwd of repos) {
-    const author = options.author ?? await getGitUserName(cwd);
-    const entries = await getCommits({ author, from, to, cwd });
-    allEntries.push(...entries);
+  const limit = parseLimit(options.limit);
+  const perRepoEntries = await Promise.all(
+    repos.map(async (cwd) => {
+      const author = options.author ?? config.defaultAuthor ?? await getGitUserName(cwd);
+      return getCommits({ author, from, to, cwd, pattern, limit });
+    })
+  );
+  const allEntries = perRepoEntries.flat();
+  allEntries.sort(
+    (a, b) => `${b.date} ${b.time}`.localeCompare(`${a.date} ${a.time}`)
+  );
+  const display = limit !== void 0 ? allEntries.slice(0, limit) : allEntries;
+  const ticketColumnLabel = getColumnLabel(format, config.ticketColumnLabel);
+  if (options.json) {
+    process.stdout.write(renderJson(display, ticketColumnLabel) + "\n");
+    return;
   }
-  allEntries.sort((a, b) => b.date.localeCompare(a.date));
-  if (allEntries.length === 0) {
+  if (display.length === 0) {
     process.stdout.write(renderEmpty() + "\n");
     return;
   }
-  process.stdout.write(renderTable(allEntries) + "\n");
+  const rendered = options.groupByDay ? renderTableGroupedByDay(display, ticketColumnLabel) : renderTable(display, ticketColumnLabel);
+  process.stdout.write(rendered + "\n");
 }
 var program = new Command();
-program.name("wdid").description("What did I do? \u2014 summarize your git commits as a table").argument("[date]", 'a YYYY-MM-DD date or "today"; omit to show all history').option("--from <date>", 'start date (YYYY-MM-DD or "today")').option("--to <date>", 'end date (YYYY-MM-DD or "today")').option(
+program.name("wdid").description("What did I do? \u2014 summarize your git commits as a table").version("0.2.0", "-V, --version", "output the version number").argument("[date]", 'a YYYY-MM-DD date or "today"; omit to show all history').option("--from <date>", 'start date (YYYY-MM-DD or "today")').option("--to <date>", 'end date (YYYY-MM-DD or "today")').option(
   "--author <name>",
-  "override the git author (defaults to git config user.name)"
+  "override the git author (defaults to git config user.name, then defaultAuthor in config)"
 ).option(
   "--repo <path...>",
-  "one or more repo paths to query (defaults to current directory)"
-).action(async (dateArg, options) => {
+  "one or more repo paths to query (overrides defaultRepos in config; defaults to current directory)"
+).option(
+  "--format <preset>",
+  "ticket format: jira | github | conventional | custom (default: jira, or config.format)"
+).option(
+  "--ticket-pattern <regex>",
+  "custom regex for ticket extraction (implies --format custom; overrides --format)"
+).option(
+  "--no-color",
+  "disable colored output (also honored via the NO_COLOR env var)"
+).option(
+  "--limit <N>",
+  "cap the table to the most recent N rows (positive integer)"
+).option(
+  "--group-by-day",
+  "group rows under a bold date heading per day (time-only in row)"
+).option("--json", "emit a JSON array of commit entries instead of the table").action(async (dateArg, options) => {
+  if (shouldDisableColor(options)) {
+    chalk2.level = 0;
+  }
   try {
     await run(dateArg, options);
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drazenbebic/wdid",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "What did I do? — summarize your git activity per day as a tidy table, grouped by JIRA ticket.",
   "keywords": [
     "git",
@@ -15,12 +15,12 @@
   "author": "Your Name <you@example.com>",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/your-org/wdid.git"
+    "url": "git+https://github.com/drazenbebic/wdid.git"
   },
   "bugs": {
-    "url": "https://github.com/your-org/wdid/issues"
+    "url": "https://github.com/drazenbebic/wdid/issues"
   },
-  "homepage": "https://github.com/your-org/wdid#readme",
+  "homepage": "https://github.com/drazenbebic/wdid#readme",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -46,22 +46,36 @@
     "format:check": "prettier --check .",
     "test": "vitest run",
     "test:watch": "vitest",
+    "prepare": "husky",
     "prepublishOnly": "pnpm run build"
   },
   "publishConfig": {
     "access": "public"
   },
+  "lint-staged": {
+    "*.{ts,tsx,js,cjs,mjs}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write"
+    ]
+  },
   "dependencies": {
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "cosmiconfig": "^9.0.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
     "@types/node": "^20.19.41",
     "eslint": "^10.4.0",
     "eslint-config-prettier": "^10.1.8",
     "globals": "^17.6.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.5",
     "prettier": "^3.8.3",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",