@eat-pray-ai/wingman 0.1.0

package/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "npm" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

package/.github/workflows/codeql.yml

@@ -0,0 +1,103 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL Advanced"
+
+on:
+  push:
+    branches: [ "main" ]
+    tags-ignore:
+      - '*'
+  pull_request:
+    branches: [ "main" ]
+  schedule:
+    - cron: '25 7 * * 3'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners (GitHub.com only)
+    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    permissions:
+      # required for all workflows
+      security-events: write
+
+      # required to fetch internal or private CodeQL packs
+      packages: read
+
+      # only required for workflows in private repositories
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - language: actions
+            build-mode: none
+          - language: javascript-typescript
+            build-mode: none
+        # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift'
+        # Use `c-cpp` to analyze code written in C, C++ or both
+        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      # Add any setup steps before running the `github/codeql-action/init` action.
+      # This includes steps like installing compilers or runtimes (`actions/setup-node`
+      # or others). This is typically only required for manual builds.
+      # - name: Setup runtime (example)
+      #   uses: actions/setup-example@v1
+
+      # Initializes the CodeQL tools for scanning.
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v4
+        with:
+          languages: ${{ matrix.language }}
+          build-mode: ${{ matrix.build-mode }}
+          # If you wish to specify custom queries, you can do so here or in a config file.
+          # By default, queries listed here will override any specified in a config file.
+          # Prefix the list here with "+" to use these queries and those in the config file.
+
+          # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+          # queries: security-extended,security-and-quality
+
+      # If the analyze step fails for one of the languages you are analyzing with
+      # "We were unable to automatically build your code", modify the matrix above
+      # to set the build mode to "manual" for that language. Then modify this step
+      # to build your code.
+      # ℹ️ Command-line programs to run using the OS shell.
+      # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+      - name: Run manual build steps
+        if: matrix.build-mode == 'manual'
+        shell: bash
+        run: |
+          echo 'If you are using a "manual" build mode for one or more of the' \
+            'languages you are analyzing, replace this with the commands to build' \
+            'your code, for example:'
+          echo '  make bootstrap'
+          echo '  make release'
+          exit 1
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v4
+        with:
+          category: "/language:${{matrix.language}}"

package/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+          cache: npm
+      - run: npm ci
+      - run: npm version "${GITHUB_REF_NAME#v}" --no-git-tag-version
+      - run: npm run build
+      - run: npm publish --provenance --access public

package/.github/workflows/release.yml

@@ -0,0 +1,52 @@
+name: Release
+
+on:
+  workflow_run:
+    workflows: [Publish]
+    types: [completed]
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    if: >-
+      github.event.workflow_run.conclusion == 'success' &&
+      startsWith(github.event.workflow_run.head_branch, 'v')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          ref: refs/tags/${{ github.event.workflow_run.head_branch }}
+
+      - name: Generate release notes
+        id: notes
+        env:
+          TAG: ${{ github.event.workflow_run.head_branch }}
+        run: |
+          PREV_TAG=$(git tag --sort=-version:refname | grep -v "^${TAG}$" | head -n1)
+          if [ -n "$PREV_TAG" ]; then
+            NOTES=$(git log --pretty=format:"- %s" "${PREV_TAG}..${TAG}")
+          else
+            NOTES=$(git log --pretty=format:"- %s" "${TAG}")
+          fi
+          {
+            echo "body<<EOF"
+            echo "$NOTES"
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.event.workflow_run.head_branch }}
+        run: |
+          PRERELEASE=""
+          if [[ "$TAG" == *-* ]]; then
+            PRERELEASE="--prerelease"
+          fi
+          gh release create "$TAG" \
+            --title "$TAG" \
+            --notes "${{ steps.notes.outputs.body }}" \
+            $PRERELEASE

package/.github/workflows/test.yml

@@ -0,0 +1,32 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+    paths-ignore:
+      - "**.md"
+      - "docs/**"
+      - "LICENSE"
+  pull_request:
+    branches: [main]
+    paths-ignore:
+      - "**.md"
+      - "docs/**"
+      - "LICENSE"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: ["22", "lts/*"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - run: npx tsc --noEmit
+      - run: npm test
+      - run: npm run build

package/.idea/workspace.xml

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="ccba457e-63dd-4ba5-bf17-c48ab102bbae" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="CopilotPersistence">
+    <persistenceIdMap>
+      <entry key="_/Users/chaoqun.yang/workspace/func/infinite-ammo" value="3BUIR6J4Z7rHzDlYXeBtEi1kMh7" />
+    </persistenceIdMap>
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitToolBoxStore">
+    <option name="recentBranches">
+      <RecentBranches>
+        <option name="branchesForRepo">
+          <list>
+            <RecentBranchesForRepo>
+              <option name="branches">
+                <list>
+                  <RecentBranch>
+                    <option name="branchName" value="main" />
+                    <option name="lastUsedInstant" value="1774857578" />
+                  </RecentBranch>
+                </list>
+              </option>
+              <option name="repositoryRootUrl" value="file://$PROJECT_DIR$" />
+            </RecentBranchesForRepo>
+          </list>
+        </option>
+      </RecentBranches>
+    </option>
+  </component>
+  <component name="MacroExpansionManager">
+    <option name="directoryName" value="w40Ke6tZ" />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 5,
+  &quot;fromUser&quot;: false
+}</component>
+  <component name="ProjectId" id="3BUIR6J4Z7rHzDlYXeBtEi1kMh7" />
+  <component name="ProjectLevelVcsManager">
+    <ConfirmationsSetting value="1" id="Add" />
+  </component>
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showExcludedFiles" value="false" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.GoLinterPluginOnboardingV2&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.GoLinterPluginStorageMigration&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.go.formatter.settings.were.checked&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.typescript.service.memoryLimit.init&quot;: &quot;true&quot;,
+    &quot;codeWithMe.voiceChat.enabledByDefault&quot;: &quot;false&quot;,
+    &quot;git-widget-placeholder&quot;: &quot;main&quot;,
+    &quot;kotlin-language-version-configured&quot;: &quot;true&quot;,
+    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
+    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
+    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
+    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
+    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
+    &quot;org.rust.first.attach.projects&quot;: &quot;true&quot;,
+    &quot;settings.editor.selected.configurable&quot;: &quot;preferences.pluginManager&quot;,
+    &quot;ts.external.directory.path&quot;: &quot;/Users/chaoqun.yang/workspace/func/infinite-ammo/node_modules/typescript/lib&quot;,
+    &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
+  }
+}</component>
+  <component name="RecentsManager">
+    <key name="MoveFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$/docs" />
+    </key>
+  </component>
+  <component name="RustProjectSettings">
+    <option name="toolchainHomeDirectory" value="$USER_HOME$/.cargo/bin" />
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="ccba457e-63dd-4ba5-bf17-c48ab102bbae" name="Changes" comment="" />
+      <created>1774537211363</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1774537211363</updated>
+      <workItem from="1774537212820" duration="1686000" />
+      <workItem from="1774615908872" duration="9536000" />
+      <workItem from="1774657336443" duration="63430000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="Vcs.Log.Tabs.Properties">
+    <option name="TAB_STATES">
+      <map>
+        <entry key="MAIN">
+          <value>
+            <State />
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+  <component name="github-copilot-workspace">
+    <instructionFileLocations>
+      <option value=".github/instructions" />
+    </instructionFileLocations>
+    <promptFileLocations>
+      <option value=".github/prompts" />
+    </promptFileLocations>
+  </component>
+</project>

package/AGENTS.md

@@ -0,0 +1,34 @@
+# AGENTS.md — Wingman (`@eat-pray-ai/wingman`)
+
+TypeScript CLI that reads local AI coding-agent usage data and produces shareable SVG stat cards and rendercv-compatible YAML resumes.
+Pipeline: Agent Adapters → `UsageRecord[]` → Aggregator → `ShowcaseData` → Renderer → SVG / YAML.
+
+---
+
+## Quick Reference
+
+```bash
+npm run dev              # run CLI via tsx (no build needed)
+npm run build            # bundle with tsdown → dist/
+npx tsc --noEmit         # type-check only (no emit)
+npm test                 # vitest run (all tests)
+npx vitest run src/foo.test.ts          # single test file
+npx vitest run -t "test name pattern"   # single test by name
+npm run test:watch       # vitest in watch mode
+```
+
+- **Node 22** · **TypeScript strict** · **ESM** · **tsdown bundler** · No linter/formatter configured
+
+---
+
+## Documentation Index
+
+| Guide | Scope |
+|---|---|
+| **[docs/AGENTS.md](docs/AGENTS.md)** | Code style, architecture, common patterns, dependencies |
+| [src/AGENTS.md](src/AGENTS.md) | Source overview, module map, key types, extension points |
+| [src/agents/AGENTS.md](src/agents/AGENTS.md) | Agent adapter contract, adding new agents |
+| [src/themes/AGENTS.md](src/themes/AGENTS.md) | Theme renderer structure, section pattern |
+| [src/svg/AGENTS.md](src/svg/AGENTS.md) | SVG component primitives, opts pattern |
+| [src/pricing/AGENTS.md](src/pricing/AGENTS.md) | Pricing engine, model metadata, models.dev API |
+| [src/resume/AGENTS.md](src/resume/AGENTS.md) | Resume YAML renderer for rendercv |

package/README.md

@@ -0,0 +1,145 @@
+# Wingman
+
+Showcase your AI pair usage — SVG cards, resumes, and more.
+
+<table>
+  <tr>
+    <th align="center">SVG Card</th>
+    <th align="center">Resume (<a href="docs/wingman.pdf">PDF</a>)</th>
+  </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>
+  </tr>
+</table>
+
+## 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 |
+
+## Quick Start
+
+```bash
+# Generate an SVG stats card (last 90 days)
+npx @eat-pray-ai/wingman card
+
+# Generate a rendercv-compatible YAML resume (last 180 days)
+npx @eat-pray-ai/wingman resume
+```
+
+## Commands
+
+### `card` — SVG Stats Card
+
+```bash
+# All agents, last 90 days (default)
+wingman card
+
+# Specific agents, custom output
+wingman card --agents claude-code,opencode -o my-stats.svg
+
+# Date range
+wingman card --since 2026-01-01 --until 2026-03-30
+
+# Last 7 days with specific theme
+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 |
+
+The default `github-dark` theme renders:
+
+1. **Header** — title + date range
+2. **Top Stats** — tokens (input/output/cache breakdown), estimated cost, sessions
+3. **Agent Legend** — color-coded bars showing share per agent
+4. **Charts** — donut chart (token types) + sparkline (daily activity) + model breakdown bars
+5. **Activity Heatmap** — GitHub-style contribution grid for daily usage
+6. **Inventory** — plugins, MCP servers, and skills detected across agents
+7. **Footer** — branding
+
+### `resume` — rendercv YAML Resume
+
+```bash
+# All agents, last 180 days (default)
+wingman resume
+
+# Custom name and headline
+wingman resume --name "My Team" --headline "AI Development"
+
+# Specific output path
+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 |
+
+The generated YAML follows the [rendercv](https://rendercv.com/) schema with sections:
+
+- **Summary** — agent count, total tokens, sessions, cost
+- **Experience** — one entry per agent (sorted by usage), with model breakdowns
+- **Education** — models grouped by AI lab (Anthropic, Google, OpenAI, etc.)
+- **Technologies** — plugins, MCP servers, skills inventory
+
+Render your resume at [rendercv.com](https://rendercv.com/).
+
+## How It Works
+
+```
+Agent Adapters → UsageRecord[] → Aggregator → ShowcaseData → Renderer → SVG / YAML
+```
+
+1. **Agent adapters** read local data from each AI coding agent (JSONL, SQLite, JSON)
+2. **Aggregator** groups by agent, calculates totals, builds per-model and daily breakdowns
+3. **Pricing engine** fetches model costs from [models.dev](https://models.dev) (24h disk cache) to estimate spend
+4. **Renderers** produce output:
+   - **Theme renderer** → self-contained SVG string (embeddable anywhere)
+   - **Resume renderer** → rendercv-compatible YAML
+
+## Development
+
+```bash
+npm install
+npm run dev -- card --days 30        # run directly via tsx
+npm run dev -- resume                # generate resume YAML
+npm run build                        # bundle to dist/
+npx tsc --noEmit                     # type-check
+npm test                             # vitest
+```
+
+See [AGENTS.md](AGENTS.md) for code style and architecture details.
+
+## Extending
+
+### Add a new agent adapter
+
+1. Create `src/agents/my-agent.ts` implementing `AgentAdapter`
+2. Register in `src/agents/registry.ts`
+
+### Add a new theme
+
+1. Create `src/themes/my-theme/index.ts` implementing `ThemeRenderer`
+2. Register in `src/themes/registry.ts`
+
+## License
+
+MIT

package/bin/wingman.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../src/cli.js";

package/dist/bin/wingman.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "../src/cli.mjs";
+export {};