@eat-pray-ai/wingman 0.1.0 → 0.2.0

package/.github/workflows/codeql.yml

@@ -13,13 +13,30 @@ name: "CodeQL Advanced"
 
 on:
   push:
-    branches: [ "main" ]
-    tags-ignore:
-      - '*'
+    branches: [main]
+    tags-ignore: ["*"]
+    paths:
+      - "src/**"
+      - "bin/**"
+      - "scripts/**"
+      - "package.json"
+      - "package-lock.json"
+      - "tsconfig.json"
+      - "tsdown.config.ts"
+      - ".github/**/*.yml"
   pull_request:
-    branches: [ "main" ]
+    branches: [main]
+    paths:
+      - "src/**"
+      - "bin/**"
+      - "scripts/**"
+      - "package.json"
+      - "package-lock.json"
+      - "tsconfig.json"
+      - "tsdown.config.ts"
+      - ".github/**/*.yml"
   schedule:
-    - cron: '25 7 * * 3'
+    - cron: "25 7 * * 3"
 
 jobs:
   analyze:

package/.github/workflows/publish.yml

@@ -4,18 +4,17 @@ on:
   push:
     tags: ["v*"]
 
-permissions:
-  contents: read
-  id-token: write
-
 jobs:
   publish:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-          node-version: "22"
+          node-version: "24"
           cache: npm
       - run: npm ci
       - run: npm version "${GITHUB_REF_NAME#v}" --no-git-tag-version

package/.github/workflows/release.yml

@@ -31,8 +31,20 @@ jobs:
           else
             NOTES=$(git log --pretty=format:"- %s" "${TAG}")
           fi
+          VERSION="${TAG#v}"
           {
             echo "body<<EOF"
+            echo "## Install"
+            echo ""
+            echo '```bash'
+            echo "npx @eat-pray-ai/wingman@${VERSION} card"
+            echo "npx @eat-pray-ai/wingman@${VERSION} resume"
+            echo '```'
+            echo ""
+            echo "[![npm](https://img.shields.io/npm/v/@eat-pray-ai/wingman)](https://www.npmjs.com/package/@eat-pray-ai/wingman/v/${VERSION})"
+            echo ""
+            echo "## Changes"
+            echo ""
             echo "$NOTES"
             echo "EOF"
           } >> "$GITHUB_OUTPUT"

package/.github/workflows/test.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: ["22", "lts/*"]
+        node-version: ["24", "lts/*"]
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2026] [eat-pray-ai & OpenWaygate]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # Wingman
 
+[![npm](https://img.shields.io/npm/v/@eat-pray-ai/wingman)](https://www.npmjs.com/package/@eat-pray-ai/wingman)
+[![test](https://img.shields.io/github/actions/workflow/status/eat-pray-ai/wingman/test.yml?label=test)](https://github.com/eat-pray-ai/wingman/actions/workflows/test.yml)
+[![license](https://img.shields.io/github/license/eat-pray-ai/wingman)](LICENSE)
+
 Showcase your AI pair usage — SVG cards, resumes, and more.
 
 <table>
@@ -7,6 +11,10 @@ Showcase your AI pair usage — SVG cards, resumes, and more.
     <th align="center">SVG Card</th>
     <th align="center">Resume (<a href="docs/wingman.pdf">PDF</a>)</th>
   </tr>
+  <tr>
+    <td align="left"><code>npx @eat-pray-ai/wingman card</code></td>
+    <td align="left"><code>npx @eat-pray-ai/wingman resume</code></td>
+  </tr>
   <tr>
     <td align="center"><img src="docs/wingman.svg" width="400" alt="SVG Card"/></td>
     <td align="center"><img src="docs/wingman.png" width="400" alt="Resume"/></td>
@@ -15,16 +23,17 @@ Showcase your AI pair usage — SVG cards, resumes, and more.
 
 ## Supported Agents
 
-| Agent | Data Source | Format |
-|---|---|---|
-| **Claude Code** | `~/.claude/projects/*/*.jsonl` | JSONL |
-| **opencode** | `~/.local/share/opencode/opencode.db` | SQLite |
-| **Gemini CLI** | `~/.gemini/tmp/*/chats/session-*.json` | JSON |
-| **Codex** | `~/.codex/state_5.sqlite` | SQLite |
+| Agent           | Data Source                            | Format |
+|-----------------|----------------------------------------|--------|
+| **Claude Code** | `~/.claude/projects/*/*.jsonl`         | JSONL  |
+| **opencode**    | `~/.local/share/opencode/opencode.db`  | SQLite |
+| **Gemini CLI**  | `~/.gemini/tmp/*/chats/session-*.json` | JSON   |
+| **Codex**       | `~/.codex/state_5.sqlite`              | SQLite |
+| **MORE**        | Coming soon!                           | TBD    |
 
 ## Quick Start
 
-```bash
+```shell
 # Generate an SVG stats card (last 90 days)
 npx @eat-pray-ai/wingman card
 
@@ -36,7 +45,7 @@ npx @eat-pray-ai/wingman resume
 
 ### `card` — SVG Stats Card
 
-```bash
+```shell
 # All agents, last 90 days (default)
 wingman card
 
@@ -50,15 +59,15 @@ wingman card --since 2026-01-01 --until 2026-03-30
 wingman card --days 7 --theme github-dark
 ```
 
-| Flag | Short | Default | Description |
-|---|---|---|---|
-| `--output` | `-o` | `wingman.svg` | Output file path |
-| `--theme` | `-t` | `github-dark` | Theme name |
-| `--agents` | | all detected | Comma-separated agent filter |
-| `--since` | | 90 days ago | Start date (YYYY-MM-DD) |
-| `--until` | | today | End date (YYYY-MM-DD) |
-| `--days` | | `90` | Last N days shorthand |
-| `--sections` | | all | Comma-separated sections to include |
+| Flag         | Short | Default       | Description                         |
+|--------------|-------|---------------|-------------------------------------|
+| `--output`   | `-o`  | `wingman.svg` | Output file path                    |
+| `--theme`    | `-t`  | `github-dark` | Theme name                          |
+| `--agents`   |       | all detected  | Comma-separated agent filter        |
+| `--since`    |       | 90 days ago   | Start date (YYYY-MM-DD)             |
+| `--until`    |       | today         | End date (YYYY-MM-DD)               |
+| `--days`     |       | `90`          | Last N days shorthand               |
+| `--sections` |       | all           | Comma-separated sections to include |
 
 The default `github-dark` theme renders:
 
@@ -72,7 +81,7 @@ The default `github-dark` theme renders:
 
 ### `resume` — rendercv YAML Resume
 
-```bash
+```shell
 # All agents, last 180 days (default)
 wingman resume
 
@@ -83,15 +92,15 @@ wingman resume --name "My Team" --headline "AI Development"
 wingman resume -o my-resume.yaml
 ```
 
-| Flag | Short | Default | Description |
-|---|---|---|---|
-| `--output` | `-o` | `resume.yaml` | Output file path |
-| `--name` | | `Wingman` | Resume name |
-| `--headline` | | `AI pair for everything` | Resume headline |
-| `--agents` | | all detected | Comma-separated agent filter |
-| `--since` | | 180 days ago | Start date (YYYY-MM-DD) |
-| `--until` | | today | End date (YYYY-MM-DD) |
-| `--days` | | `180` | Last N days shorthand |
+| Flag         | Short | Default                  | Description                  |
+|--------------|-------|--------------------------|------------------------------|
+| `--output`   | `-o`  | `resume.yaml`            | Output file path             |
+| `--name`     |       | `Wingman`                | Resume name                  |
+| `--headline` |       | `AI pair for everything` | Resume headline              |
+| `--agents`   |       | all detected             | Comma-separated agent filter |
+| `--since`    |       | 180 days ago             | Start date (YYYY-MM-DD)      |
+| `--until`    |       | today                    | End date (YYYY-MM-DD)        |
+| `--days`     |       | `180`                    | Last N days shorthand        |
 
 The generated YAML follows the [rendercv](https://rendercv.com/) schema with sections:
 
@@ -117,7 +126,7 @@ Agent Adapters → UsageRecord[] → Aggregator → ShowcaseData → Renderer
 
 ## Development
 
-```bash
+```shell
 npm install
 npm run dev -- card --days 30        # run directly via tsx
 npm run dev -- resume                # generate resume YAML

package/dist/src/cli.mjs

@@ -416,7 +416,7 @@ function getAllAdapters() {
 //#endregion
 //#region src/pricing/models-dev.ts
 const MODELS_DEV_URL = "https://models.dev/api.json";
-const CACHE_DIR = join(homedir(), ".wingman", "cache");
+const CACHE_DIR = join(homedir(), ".cache", "wingman");
 const CACHE_FILE = join(CACHE_DIR, "models.json");
 const CACHE_TTL_MS = 1440 * 60 * 1e3;
 /** Maps model family prefixes to the official AI lab name */
@@ -527,6 +527,31 @@ async function fetchModelPricing() {
 	return result;
 }
 /**
+* Fetch model family mapping from models.dev (reuses same 24h disk cache).
+*
+* Returns a Map keyed by modelId → family string (e.g. "claude-sonnet-4-5" → "claude").
+* Uses the `family` field from the API when available, falls back to modelId itself.
+*/
+async function fetchModelFamilies() {
+	let data = await readCache();
+	if (!data) {
+		data = await fetchFromApi();
+		await writeCache(data);
+	}
+	const result = /* @__PURE__ */ new Map();
+	for (const providerData of Object.values(data)) {
+		const models = providerData?.models;
+		if (!models || typeof models !== "object") continue;
+		for (const [modelId, model] of Object.entries(models)) {
+			if (result.has(modelId)) continue;
+			const raw = model;
+			const family = typeof raw.family === "string" ? raw.family : modelId;
+			result.set(modelId, family);
+		}
+	}
+	return result;
+}
+/**
 * Fetch model metadata from models.dev (reuses same 24h disk cache).
 *
 * Returns a Map keyed by model ID. Uses the same normalized-ID fallback
@@ -586,14 +611,22 @@ async function fetchModelInfo() {
 */
 async function createPricingEngine(overrides) {
 	const catalog = await fetchModelPricing();
+	const families = await fetchModelFamilies();
 	const overrideMap = /* @__PURE__ */ new Map();
 	if (overrides) for (const o of overrides) overrideMap.set(`${o.modelId}::${o.provider}`, o);
 	const normalizedIndex = /* @__PURE__ */ new Map();
+	const familyIndex = /* @__PURE__ */ new Map();
 	for (const [modelId, pricings] of catalog) {
 		const key = normalizeModelId(modelId);
 		const existing = normalizedIndex.get(key);
 		if (existing) existing.push(...pricings);
 		else normalizedIndex.set(key, [...pricings]);
+		const fam = families.get(modelId);
+		if (fam) {
+			const famExisting = familyIndex.get(fam);
+			if (famExisting) famExisting.push(...pricings);
+			else familyIndex.set(fam, [...pricings]);
+		}
 	}
 	function resolve(modelId, provider) {
 		if (provider) {
@@ -605,7 +638,12 @@ async function createPricingEngine(overrides) {
 			const match = exactEntries.find((p) => p.provider === provider);
 			if (match) return match;
 		}
-		if (exactEntries && exactEntries.length > 0) return exactEntries[0];
+		const family = families.get(modelId) ?? modelId;
+		const official = modelLab(family).toLowerCase();
+		if (exactEntries && exactEntries.length > 0) {
+			const match = exactEntries.find((p) => p.provider === official);
+			if (match) return match;
+		}
 		const normalized = normalizeModelId(modelId);
 		const fuzzyEntries = normalizedIndex.get(normalized);
 		if (fuzzyEntries && fuzzyEntries.length > 0) {
@@ -613,8 +651,16 @@ async function createPricingEngine(overrides) {
 				const match = fuzzyEntries.find((p) => p.provider === provider);
 				if (match) return match;
 			}
-			return fuzzyEntries[0];
+			const officialMatch = fuzzyEntries.find((p) => p.provider === official);
+			if (officialMatch) return officialMatch;
+		}
+		const familyEntries = familyIndex.get(family);
+		if (familyEntries && familyEntries.length > 0) {
+			const officialMatch = familyEntries.find((p) => p.provider === official);
+			if (officialMatch) return officialMatch;
 		}
+		if (fuzzyEntries && fuzzyEntries.length > 0) return fuzzyEntries[0];
+		if (exactEntries && exactEntries.length > 0) return exactEntries[0];
 		return null;
 	}
 	function calculateCost(record) {
@@ -2122,7 +2168,10 @@ program.command("card").description("Generate an SVG stats card from local AI ag
 	const until = opts.until ? /* @__PURE__ */ new Date(opts.until + "T23:59:59.999") : /* @__PURE__ */ new Date();
 	let since;
 	if (opts.since) since = /* @__PURE__ */ new Date(opts.since + "T00:00:00");
-	else since = /* @__PURE__ */ new Date(until.getTime() - opts.days * 24 * 60 * 60 * 1e3);
+	else {
+		since = /* @__PURE__ */ new Date(until.getTime() - opts.days * 24 * 60 * 60 * 1e3);
+		since.setHours(0, 0, 0, 0);
+	}
 	const theme = getTheme(opts.theme);
 	if (!theme) {
 		console.error(`Unknown theme "${opts.theme}". Available: ${getAvailableThemes().join(", ")}`);
@@ -2178,7 +2227,10 @@ program.command("resume").description("Generate a rendercv-compatible YAML resum
 	const until = opts.until ? /* @__PURE__ */ new Date(opts.until + "T23:59:59.999") : /* @__PURE__ */ new Date();
 	let since;
 	if (opts.since) since = /* @__PURE__ */ new Date(opts.since + "T00:00:00");
-	else since = /* @__PURE__ */ new Date(until.getTime() - opts.days * 24 * 60 * 60 * 1e3);
+	else {
+		since = /* @__PURE__ */ new Date(until.getTime() - opts.days * 24 * 60 * 60 * 1e3);
+		since.setHours(0, 0, 0, 0);
+	}
 	const agentFilter = opts.agents ? new Set(opts.agents.split(",").map((s) => s.trim())) : null;
 	let adapters = getAllAdapters();
 	if (agentFilter) adapters = adapters.filter((a) => agentFilter.has(a.name));