@jagit/hook-copilot 0.0.0

package/README.md

@@ -0,0 +1,40 @@
+# @jagit/hook-copilot
+
+Reports per-invocation GitHub Copilot CLI usage to JaGit.
+
+## Setup
+
+The Copilot CLI has no hook mechanism and no persistent session telemetry, so
+install a shell function that wraps the real `copilot` binary and reports
+after each invocation ends:
+
+    copilot() {
+      command copilot "$@"
+      local status=$?
+      npx -y @jagit/hook-copilot >/dev/null 2>&1 || true
+      return $status
+    }
+
+Add that function to your shell rc (`~/.zshrc`, `~/.bashrc`, etc.) — it must
+appear before any `alias`/`PATH` entry that would otherwise shadow it. (Users
+on the legacy `gh copilot` preview wrapper can apply the same pattern to a
+`gh` function instead.) Uninstall by removing the shell function.
+
+For a permanent binary instead of `npx -y`:
+`npm i -g @jagit/hook-copilot`, then call `jagit-hook-copilot` in the wrapper.
+
+## Environment
+
+    export JAGIT_BASE_URL="https://your-jagit-host"
+    export JAGIT_API_KEY="<your DASHBOARD_API_TOKEN>"
+
+Identity defaults to `git config user.email`; override with `JAGIT_GIT_USERNAME`.
+
+## Notes
+
+- Copilot CLI exposes no local token/usage telemetry (billing is seat-based),
+  so each report uses a synthetic session id (`copilot-<timestamp>-<pid>`),
+  zero token counts, and `model: "copilot"` unless a future CLI version
+  surfaces real usage data.
+- `costUsd` is always `null` and will remain so — there is no per-invocation
+  cost to report under seat-based billing.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { type AgentSessionPayload } from "@jagit/agent-reporter";
+export interface CopilotInfo {
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cachedInputTokens?: number;
+    toolCallCount?: number | null;
+}
+export declare function buildPayload(cwd: string | undefined, info?: CopilotInfo): AgentSessionPayload;

package/dist/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { resolveGitUsername, reportSession } from "@jagit/agent-reporter";
+export function buildPayload(cwd, info) {
+    return {
+        tool: "copilot",
+        sessionId: `copilot-${Date.now()}-${process.pid}`,
+        gitUsername: resolveGitUsername(cwd),
+        model: info?.model ?? "copilot",
+        inputTokens: info?.inputTokens ?? 0,
+        cachedInputTokens: info?.cachedInputTokens ?? 0,
+        outputTokens: info?.outputTokens ?? 0,
+        costUsd: null,
+        toolCallCount: info?.toolCallCount ?? null,
+        startedAt: new Date().toISOString(),
+    };
+}
+async function main() {
+    try {
+        await reportSession(buildPayload(process.cwd()));
+    }
+    catch (err) {
+        console.error("[hook-copilot]", err instanceof Error ? err.message : err);
+    }
+    finally {
+        process.exit(0);
+    }
+}
+const isMain = import.meta.url.startsWith("file://") &&
+    realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1]);
+if (isMain)
+    void main();

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@jagit/hook-copilot",
+  "version": "0.0.0",
+  "type": "module",
+  "bin": {
+    "jagit-hook-copilot": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@jagit/agent-reporter": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "vitest": "^2.1.9"
+  }
+}