node <skill-dir>/scripts/mine-transcripts.mjs --days <N> [--repo <substr>] --html /tmp/cc-receipt.html

{
  "generatedAt": "2026-06-08T17:04:22.000Z",
  "userName": "Ada Lovelace" | null,  // `git config --global user.name`, to personalize the receipt
  "since": "2026-05-10", "until": "2026-06-08", "periodDays": 30,
  // How much was read to build this — provenance, not an achievement. Don't
  // put these in the report; they are not sessions and not files touched.
  "filesScanned": 189, "linesScanned": 36536,
  "totals": {
    "sessions": 131, "prompts": 681,
    "activeDays": 24, "calendarDays": 30,   // activeDays <= calendarDays, always
    "filesTouched": 24, "linesTouched": 4447,
    "prCreateCmds": 3,      // `gh pr create` commands CC ran
    // There is no `git commit` counter: a Bash call carries no working
    // directory, so a commit in a throwaway fixture repo under /tmp can't be
    // told apart from one in the dev's project. Commits are counted against
    // git instead — see commitsWithOurWork.
    // Commits whose changed files include something CC touched, de-duplicated
    // by SHA. NOT "commits by your git identity": that counts snapshot crons,
    // release bots and formatters running under the dev's name, and it is how
    // a report ends up claiming thousands of commits. This number requires the
    // commit to be BOTH authored by the dev AND to carry CC's work — so it
    // also catches the commit they made by hand in a terminal afterwards.
    // null means "not checked", NOT "not a git repo" — a real repo comes back
    // null when CC touched none of its tracked files, or no git identity is
    // configured, or git errored. Footnote it as "no commits carrying this
    // project's work, or not a git repo", never as a flat "not a repo".
    "commitsWithOurWork": 2 | null,
    "gitActiveDayOverlap": 2 | null,  // active days that ended with such a commit
    // Present and true ONLY if git actually errored somewhere. Its absence with
    // a null commit count means something different and much more ordinary: no
    // project produced commits (a research month, work outside a repo, a fresh
    // checkout). That's an honest zero. Don't report it as a tool failure.
    "gitUnavailable": true | undefined
    // There is deliberately NO activity/category breakdown of spend — no
    // "38% of your compute went to reading code". A turn's cost is ~90%
    // context handling, half of it re-reading what earlier turns added, so
    // charging it to whichever tool fired that turn is a modeling choice
    // rather than a measurement — and the choice decides the answer. Spend
    // appears once, per project, as byRepo[].pctSpend, which is stable
    // because it divides a real quantity by a real fact.
  },
  // Top 12 projects by pctSpend, already ordered biggest-first; the rest roll
  // into "(other repos)", whose activeDays and commits are unions, not sums.
  // Keys are a git repo's name, a `~/dir` path for work outside a repo, or
  // "Research & investigation (no project)" — sessions that searched the web,
  // read Slack, or queried a dashboard without touching a file. That last one
  // is often the biggest row; it is real work that simply has no project.
  "byRepo": {
    "<project>": {
      "sessions": N, "prompts": N, "activeDays": N,
      "filesTouched": N, "linesTouched": N,
      "prCreateCmds": N,
      "isRepo": true | false | null,      // false = a plain directory, named for
                                           // itself; null = the research bucket
                                           // or the rollup, neither of which is
                                           // a place on disk
      "commitsWithOurWork": N | null,
      "gitActiveDayOverlap": N | null,
      "pctSpend": 23.4,  // share of total relative compute; across all
                          // projects incl. "(other repos)" these sum to 100
      "projectCount": N  // ONLY on the "(other repos)" row — how many projects
                          // it rolls up. Say "everything else (N projects)".
    }
  }
}