chapa-cli 0.2.7 → 0.2.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 juan294
+
+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,58 +1,110 @@
 # chapa-cli
 
-Merge GitHub EMU (Enterprise Managed User) contributions into your [Chapa](https://chapa.thecreativetoken.com) developer impact badge.
+[![npm version](https://img.shields.io/npm/v/chapa-cli)](https://www.npmjs.com/package/chapa-cli)
+[![CI](https://github.com/juan294/chapa-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/juan294/chapa-cli/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/node/v/chapa-cli)](https://nodejs.org)
 
-If your employer uses GitHub EMU accounts, your work contributions are invisible on your personal profile. This CLI fetches your EMU stats and uploads them to Chapa so your badge reflects your full impact.
+![Chapa Badge](https://chapa.thecreativetoken.com/u/juan294/badge.svg)
+
+Merge GitHub Enterprise Managed User (EMU) contributions into your [Chapa](https://chapa.thecreativetoken.com) developer impact badge.
+
+## Why?
+
+If you use a GitHub EMU account at work, your contributions live on a separate identity from your personal GitHub. Chapa badges only see your personal account. This CLI bridges the gap by fetching your EMU stats and merging them into your Chapa badge.
+
+## Install
+
+```bash
+npm install -g chapa-cli
+```
+
+Requires Node.js 18+.
 
 ## Quick start
 
 ```bash
-# 1. Authenticate with Chapa (opens browser)
-npx chapa-cli login
+# 1. Log in with your personal GitHub (opens browser)
+chapa login
 
-# 2. Merge your EMU stats
-npx chapa-cli merge --emu-handle your-emu-handle
+# 2. Merge your EMU contributions
+chapa merge --emu-handle your-emu-handle --emu-token ghp_your_emu_token
 ```
 
-That's it! Your personal handle and auth token are auto-detected from the login step.
-
 ## Commands
 
-| Command | Description |
-|---------|-------------|
-| `chapa login` | Authenticate via browser (like `npm login`) |
-| `chapa logout` | Clear stored credentials |
-| `chapa merge` | Fetch EMU stats and upload to Chapa |
+### `chapa login`
+
+Authenticate with the Chapa server. Opens a browser window where you approve the CLI with your **personal** GitHub account.
+
+```bash
+chapa login
+chapa login --server http://localhost:3001  # local dev
+chapa login --insecure                       # corporate TLS interception
+chapa login --verbose                        # debug polling
+```
+
+### `chapa logout`
+
+Clear stored credentials from `~/.chapa/credentials.json`.
 
-## Options (for merge)
+```bash
+chapa logout
+```
+
+### `chapa merge`
+
+Fetch stats from your EMU account and upload them to Chapa.
+
+```bash
+chapa merge --emu-handle your-emu-handle
+```
+
+The EMU token can be provided via `--emu-token` flag or `GITHUB_EMU_TOKEN` environment variable. The token needs `read:user` scope.
 
-| Flag | Description | Required |
-|------|-------------|----------|
-| `--emu-handle <handle>` | Your EMU GitHub handle | Yes |
-| `--emu-token <token>` | EMU GitHub token | No* |
-| `--handle <handle>` | Override personal handle | No |
-| `--token <token>` | Override auth token | No |
-| `--server <url>` | Chapa server URL | No |
-| `--version`, `-v` | Show version number | |
-| `--help`, `-h` | Show help message | |
+## Options
 
-*EMU token is resolved from: flag > `GITHUB_EMU_TOKEN` env var.
+| Flag | Description |
+|------|-------------|
+| `--emu-handle <handle>` | Your EMU GitHub handle (required for merge) |
+| `--emu-token <token>` | EMU GitHub token (or set `GITHUB_EMU_TOKEN`) |
+| `--handle <handle>` | Override personal handle (auto-detected from login) |
+| `--token <token>` | Override auth token (auto-detected from login) |
+| `--server <url>` | Chapa server URL (default: production) |
+| `--verbose` | Show detailed polling logs during login |
+| `--insecure` | Skip TLS certificate verification |
+| `--version`, `-v` | Show version number |
+| `--help`, `-h` | Show help message |
 
-## EMU token setup
+## Corporate networks
 
-You need one token from your EMU (work) GitHub account with `read:user` scope:
+Many corporate networks use TLS interception (MITM proxies). If you see errors like:
+
+- `UNABLE_TO_VERIFY_LEAF_SIGNATURE`
+- `SELF_SIGNED_CERT_IN_CHAIN`
+- `self-signed certificate in certificate chain`
+
+Use the `--insecure` flag:
 
 ```bash
-export GITHUB_EMU_TOKEN=ghp_your_emu_token
+chapa login --insecure
+chapa merge --emu-handle your-emu --insecure
 ```
 
+This disables TLS certificate verification for the CLI session only.
+
 ## How it works
 
-1. `chapa login` opens your browser for OAuth authentication with Chapa
-2. After approval, a signed CLI token is saved to `~/.chapa/credentials.json`
-3. `chapa merge` fetches your last 12 months of EMU activity via GitHub GraphQL API
-4. Stats (commits, PRs merged, reviews) are uploaded to the Chapa server
-5. Your badge recalculates on next refresh, combining personal + EMU contributions
+1. **Login**: The CLI generates a session ID, displays an authorization URL, and polls the Chapa server until you approve in the browser. Credentials are saved to `~/.chapa/credentials.json`.
+
+2. **Merge**: The CLI fetches your EMU account's contribution data via GitHub's GraphQL API (using your EMU token), then uploads the aggregated stats to the Chapa server. Your badge will reflect the combined data on next refresh.
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+- [Report a bug](https://github.com/juan294/chapa-cli/issues/new?template=bug_report.yml)
+- [Request a feature](https://github.com/juan294/chapa-cli/issues/new?template=feature_request.yml)
 
 ## License
 

package/dist/index.js

@@ -45,7 +45,9 @@ function resolveToken(flag, envVar) {
   return null;
 }
 
-// ../shared/src/github-query.ts
+// src/shared.ts
+var SCORING_WINDOW_DAYS = 365;
+var PR_WEIGHT_AGG_CAP = 120;
 var CONTRIBUTION_QUERY = `
 query($login: String!, $since: DateTime!, $until: DateTime!, $historySince: GitTimestamp!, $historyUntil: GitTimestamp!) {
   user(login: $login) {
@@ -101,18 +103,10 @@ query($login: String!, $since: DateTime!, $until: DateTime!, $historySince: GitT
   }
 }
 `;
-
-// ../shared/src/scoring.ts
 function computePrWeight(pr) {
   const w = 0.5 + 0.25 * Math.log(1 + pr.changedFiles) + 0.25 * Math.log(1 + pr.additions + pr.deletions);
   return Math.min(w, 3);
 }
-
-// ../shared/src/constants.ts
-var SCORING_WINDOW_DAYS = 365;
-var PR_WEIGHT_AGG_CAP = 120;
-
-// ../shared/src/stats-aggregation.ts
 function buildStatsFromRaw(raw) {
   const heatmapData = [];
   for (const week of raw.contributionCalendar.weeks) {
@@ -177,6 +171,10 @@ function buildStatsFromRaw(raw) {
 }
 
 // src/fetch-emu.ts
+var MAX_ERROR_BODY_LENGTH = 200;
+function truncate(s, max) {
+  return s.length > max ? s.slice(0, max) + "..." : s;
+}
 async function fetchEmuStats(login2, emuToken) {
   const now = /* @__PURE__ */ new Date();
   const since = new Date(now);
@@ -202,21 +200,20 @@ async function fetchEmuStats(login2, emuToken) {
     });
     if (!res.ok) {
       const body = await res.text().catch(() => "(unreadable)");
-      console.error(`[cli] GraphQL HTTP ${res.status}: ${body}`);
+      console.error(`[cli] GraphQL HTTP ${res.status}: ${truncate(body, MAX_ERROR_BODY_LENGTH)}`);
       return null;
     }
     const json = await res.json();
     if (json.errors) {
-      console.error(`[cli] GraphQL errors for ${login2}:`, json.errors);
+      const errStr = truncate(JSON.stringify(json.errors), MAX_ERROR_BODY_LENGTH);
+      console.error(`[cli] GraphQL errors for ${login2}: ${errStr}`);
     }
     if (!json.data?.user) return null;
     const user = json.data.user;
     const cc = user.contributionsCollection;
     const prNodes = cc.pullRequestContributions.nodes.filter(
       (n) => n != null && n.pullRequest != null
-    ).map(
-      (n) => n.pullRequest
-    );
+    ).map((n) => n.pullRequest);
     const raw = {
       login: user.login,
       name: user.name,
@@ -238,7 +235,7 @@ async function fetchEmuStats(login2, emuToken) {
     };
     return buildStatsFromRaw(raw);
   } catch (err) {
-    console.error(`[cli] fetch error:`, err);
+    console.error("[cli] fetch error:", err.message);
     return null;
   }
 }
@@ -431,7 +428,7 @@ Logged in as ${data.handle}!`);
 }
 
 // src/index.ts
-var VERSION = true ? "0.2.7" : "0.0.0-dev";
+var VERSION = true ? "0.2.8" : "0.0.0-dev";
 var HELP_TEXT = `chapa-cli v${VERSION}
 
 Merge GitHub EMU (Enterprise Managed User) contributions into your Chapa badge.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chapa-cli",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Merge GitHub EMU contributions into your Chapa developer impact badge",
   "type": "module",
   "bin": {
@@ -13,7 +13,11 @@
   "scripts": {
     "build": "tsup",
     "prepublishOnly": "tsup",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit"
   },
   "keywords": [
     "chapa",
@@ -22,22 +26,27 @@
     "developer",
     "impact",
     "emu",
-    "cli"
+    "cli",
+    "enterprise-managed-users"
   ],
   "author": "juan294",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/juan294/chapa",
-    "directory": "packages/cli"
+    "url": "https://github.com/juan294/chapa-cli"
+  },
+  "homepage": "https://github.com/juan294/chapa-cli#readme",
+  "bugs": {
+    "url": "https://github.com/juan294/chapa-cli/issues"
   },
   "engines": {
     "node": ">=18"
   },
   "devDependencies": {
-    "@chapa/shared": "workspace:*",
     "@types/node": "^22.19.10",
+    "@vitest/coverage-v8": "^4.0.0",
     "tsup": "^8.5.1",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.0"
   }
 }