@drazenbebic/wdid 0.3.0 → 0.4.0

package/README.md

@@ -28,10 +28,13 @@ This puts a `wdid` binary on your `PATH`.
 ## Usage
 
 ```sh
-wdid                       # all commits authored by you, across all branches
+wdid                       # show help (no args = nothing to do)
 wdid today                 # commits from today
+wdid yesterday             # commits from yesterday
 wdid 2026-05-27            # commits from a specific day (YYYY-MM-DD)
+wdid 2026-05               # commits from a specific month (YYYY-MM)
 wdid --from 2026-05-01 --to 2026-05-07   # a date range
+wdid --all                 # all commits, no date filter
 wdid --author "Jane Doe"   # someone else's commits
 wdid --repo ../api ../web  # query multiple repos at once
 ```
@@ -75,7 +78,8 @@ With `--group-by-day`, the date moves into a section heading instead of repeatin
 
 | Option                     | Description                                                                                  |
 | -------------------------- | -------------------------------------------------------------------------------------------- |
-| `[date]`                   | A `YYYY-MM-DD` date or the literal `today`. Omit to show all history.                        |
+| `[date]`                   | A `YYYY-MM-DD` date, a `YYYY-MM` month, or the literal `today` / `yesterday`.                |
+| `--all`                    | Show all history (no date filter). Required to opt into the unfiltered view explicitly.      |
 | `--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).  |

package/dist/index.js

@@ -973,12 +973,32 @@ var VALID_PRESETS = [
 function isIsoDate(value) {
   return /^\d{4}-\d{2}-\d{2}$/.test(value);
 }
+function isYearMonth(value) {
+  return /^\d{4}-(0[1-9]|1[0-2])$/.test(value);
+}
+function resolveYearMonth(value) {
+  const year = Number.parseInt(value.slice(0, 4), 10);
+  const month = Number.parseInt(value.slice(5, 7), 10);
+  const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();
+  const pad = (n) => String(n).padStart(2, "0");
+  return {
+    from: `${year}-${pad(month)}-01`,
+    to: `${year}-${pad(month)}-${pad(lastDay)}`
+  };
+}
 function resolveDate(input) {
   if (input === "today") {
     return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   }
+  if (input === "yesterday") {
+    const d = /* @__PURE__ */ new Date();
+    d.setUTCDate(d.getUTCDate() - 1);
+    return d.toISOString().slice(0, 10);
+  }
   if (!isIsoDate(input)) {
-    throw new Error(`invalid date "${input}" \u2014 expected YYYY-MM-DD or "today"`);
+    throw new Error(
+      `invalid date "${input}" \u2014 expected YYYY-MM-DD, "today", or "yesterday"`
+    );
   }
   return input;
 }
@@ -1007,9 +1027,15 @@ async function run(dateArg, options) {
   let from = options.from ? resolveDate(options.from) : void 0;
   let to = options.to ? resolveDate(options.to) : void 0;
   if (dateArg) {
-    const day = resolveDate(dateArg);
-    from = day;
-    to = day;
+    if (isYearMonth(dateArg)) {
+      const range = resolveYearMonth(dateArg);
+      from = range.from;
+      to = range.to;
+    } else {
+      const day = resolveDate(dateArg);
+      from = day;
+      to = day;
+    }
   }
   const limit = parseLimit(options.limit);
   const perRepoEntries = await Promise.all(
@@ -1223,7 +1249,39 @@ async function runTogglSync(dateArg, options) {
 }
 var program = new Command();
 program.enablePositionalOptions();
-program.name("wdid").description("What did I do? \u2014 summarize your git commits as a table").version("0.3.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(
+var isoArt = String.raw`      ___           ___                       ___
+     /\__\         /\  \          ___        /\  \
+    /:/ _/_       /::\  \        /\  \      /::\  \
+   /:/ /\__\     /:/\:\  \       \:\  \    /:/\:\  \
+  /:/ /:/ _/_   /:/  \:\__\      /::\__\  /:/  \:\__\
+ /:/_/:/ /\__\ /:/__/ \:|__|  __/:/\/__/ /:/__/ \:|__|
+ \:\/:/ /:/  / \:\  \ /:/  / /\/:/  /    \:\  \ /:/  /
+  \::/_/:/  /   \:\  /:/  /  \::/__/      \:\  /:/  /
+   \:\/:/  /     \:\/:/  /    \:\__\       \:\/:/  /
+    \::/  /       \::/__/      \/__/        \::/__/
+     \/__/         ~~                        ~~`;
+function gradientPaint(text, from, to) {
+  const lines = text.split("\n");
+  const maxY = Math.max(lines.length - 1, 1);
+  const maxX = Math.max(1, ...lines.map((l) => l.length - 1));
+  return lines.map(
+    (line, y) => Array.from(line, (ch, x) => {
+      if (ch === " ") {
+        return ch;
+      }
+      const t = (y / maxY + x / maxX) / 2;
+      const r = Math.round(from[0] + (to[0] - from[0]) * t);
+      const g = Math.round(from[1] + (to[1] - from[1]) * t);
+      const b = Math.round(from[2] + (to[2] - from[2]) * t);
+      return chalk3.rgb(r, g, b)(ch);
+    }).join("")
+  ).join("\n");
+}
+var banner = gradientPaint(isoArt, [34, 211, 238], [217, 70, 239]) + "  " + chalk3.rgb(217, 70, 239)(`v${"0.4.0"}`) + "\n";
+program.name("wdid").description("What did I do? \u2014 summarize your git commits as a table").version("0.4.0", "-V, --version", "output the version number").addHelpText("before", banner).argument(
+  "[date]",
+  'a YYYY-MM-DD date, YYYY-MM month, "today", or "yesterday"'
+).option("--all", "show all history (no date filter)").option("--from <date>", 'start date (YYYY-MM-DD, "today", or "yesterday")').option("--to <date>", 'end date (YYYY-MM-DD, "today", or "yesterday")').option(
   "--author <name>",
   "override the git author (defaults to git config user.name, then defaultAuthor in config)"
 ).option(
@@ -1256,7 +1314,20 @@ program.name("wdid").description("What did I do? \u2014 summarize your git commi
     process.exitCode = 1;
   }
 });
-var togglCmd = program.command("toggl").description("Toggl integration commands");
+var togglCmd = program.command("toggl").description("Toggl integration commands").action(() => {
+  togglCmd.help();
+});
+togglCmd.addHelpText(
+  "after",
+  `
+Examples:
+  $ wdid toggl sync                                  push today's commits
+  $ wdid toggl sync yesterday                        push yesterday's commits
+  $ wdid toggl sync 2026-05-27                       push a specific day
+  $ wdid toggl sync today --dry-run                  preview without pushing
+  $ wdid toggl sync --workspace 12345 today          override the workspace
+  $ wdid toggl sync --from 2026-05-25 --to 2026-05-27  push a multi-day range`
+);
 togglCmd.command("sync [date]").description(
   "push the day's commits as Toggl time entries. Default: today. Pass --from/--to for a range."
 ).option("--dry-run", "preview the plan without pushing").option(
@@ -1313,7 +1384,23 @@ async function runConfigList(options) {
 function runConfigPath() {
   process.stdout.write(globalConfigPath() + "\n");
 }
-var configCmd = program.command("config").description("Read and write the global wdid config file");
+var configCmd = program.command("config").description("Read and write the global wdid config file").action(() => {
+  configCmd.help();
+});
+configCmd.addHelpText(
+  "after",
+  `
+Examples:
+  $ wdid config keys                              list every available key
+  $ wdid config set togglApiToken tok_abc123      set a scalar field
+  $ wdid config set togglWorkspaceId 12345        numbers are parsed
+  $ wdid config set togglOneEntryPerTicket false  booleans take true/false
+  $ wdid config set togglProjects.ABC- 67890      set a nested record entry
+  $ wdid config get togglApiToken                 secrets are masked
+  $ wdid config get togglApiToken --show-secrets  reveal the secret
+  $ wdid config list                              show all set fields
+  $ wdid config path                              print the config file path`
+);
 configCmd.command("set <key> <value>").description(
   "Set a value in the global config (~/.config/wdid/config.json). Use dotted access for nested fields (togglProjects.ABC-)."
 ).action(async (key, value) => {
@@ -1355,4 +1442,20 @@ configCmd.command("path").description(
 configCmd.command("keys").description("List every config key with its type, default, and description.").action(() => {
   process.stdout.write(renderConfigKeys() + "\n");
 });
+program.addHelpText(
+  "after",
+  `
+Examples:
+  $ wdid today                              commits from today
+  $ wdid yesterday                          commits from yesterday
+  $ wdid 2026-05-27                         commits from a specific day
+  $ wdid 2026-05                            commits from a whole month
+  $ wdid --from 2026-05-01 --to 2026-05-07  a date range
+  $ wdid --all                              all history, no filter
+  $ wdid toggl sync today                   push today's commits to Toggl
+  $ wdid config list                        show global config`
+);
+if (process.argv.length <= 2) {
+  program.help();
+}
 program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drazenbebic/wdid",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "What did I do? — summarize your git activity per day as a tidy table, grouped by JIRA ticket.",
   "keywords": [
     "git",