@pinta-ai/pinta-copilot 0.1.0

package/dist/tools/doctor.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * doctor — read-only health check for a pinta-copilot install.
+ *
+ *   node dist/tools/doctor.js      (or: npm run doctor)
+ *
+ * Verifies the hook file, env file / OTel endpoint, and the built adapter.
+ * Exits 1 if anything required is missing; 0 if healthy.
+ */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const surface_js_1 = require("../core/surface.js");
+function copilotHome() {
+    return process.env.COPILOT_HOME || node_path_1.default.join(node_os_1.default.homedir(), ".copilot");
+}
+const checks = [];
+function check(required, ok, label, detail) {
+    checks.push({ ok, label, detail, required });
+}
+const home = copilotHome();
+const hookFile = node_path_1.default.join(home, "hooks", "pinta-copilot.json");
+const envFile = node_path_1.default.join(home, "pinta-copilot.env");
+const adapter = node_path_1.default.join(node_path_1.default.dirname(node_path_1.default.resolve(process.argv[1])), "..", "index.js");
+// 1. adapter built
+check(true, node_fs_1.default.existsSync(adapter), "adapter built (dist/index.js)", adapter);
+// 2. hook file installed + points at this adapter
+let hookOk = false;
+let hookDetail = `${hookFile} (missing — run \`npm run install-hooks\`)`;
+try {
+    const j = JSON.parse(node_fs_1.default.readFileSync(hookFile, "utf-8"));
+    const cmd = j?.hooks?.PreToolUse?.[0]?.command ?? "";
+    const events = Object.keys(j?.hooks ?? {}).length;
+    hookOk = cmd.includes("index.js");
+    hookDetail = `${hookFile} (${events} events)`;
+}
+catch {
+    /* missing */
+}
+check(true, hookOk, "hook file installed", hookDetail);
+// 3. env file (optional) + OTel endpoint configured (required for telemetry)
+const hasEnvFile = node_fs_1.default.existsSync(envFile);
+check(false, hasEnvFile, "env file present", hasEnvFile ? envFile : `${envFile} (none — config may come from process.env)`);
+let endpoint = process.env.COPILOT_PLUGIN_OPTION_ENDPOINT ||
+    process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||
+    process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+if (!endpoint && hasEnvFile) {
+    const m = node_fs_1.default
+        .readFileSync(envFile, "utf-8")
+        .match(/(?:COPILOT_PLUGIN_OPTION_ENDPOINT|OTEL_EXPORTER_OTLP_(?:TRACES_)?ENDPOINT)=(.+)/);
+    if (m)
+        endpoint = m[1].trim();
+}
+check(true, Boolean(endpoint), "traces endpoint configured", endpoint || "(unset — spans will be dropped)");
+// 4. guard endpoint (optional)
+let guardEp = process.env.PINTA_GUARD_ENDPOINT;
+if (!guardEp && hasEnvFile) {
+    const m = node_fs_1.default.readFileSync(envFile, "utf-8").match(/PINTA_GUARD_ENDPOINT=(.+)/);
+    if (m)
+        guardEp = m[1].trim();
+}
+check(false, Boolean(guardEp), "guard endpoint (optional)", guardEp || "(none — telemetry only, no allow/deny)");
+// --- report ---
+let failed = 0;
+for (const c of checks) {
+    const mark = c.ok ? "✅" : c.required ? "❌" : "⚠️ ";
+    if (!c.ok && c.required)
+        failed++;
+    // eslint-disable-next-line no-console
+    console.log(`${mark} ${c.label}${c.detail ? `  —  ${c.detail}` : ""}`);
+}
+// eslint-disable-next-line no-console
+console.log(`\nsurface (this shell): ${(0, surface_js_1.detectSurface)()}`);
+// eslint-disable-next-line no-console
+console.log(failed === 0 ? "\nhealthy ✅" : `\n${failed} required check(s) failed ❌`);
+process.exit(failed === 0 ? 0 : 1);
+//# sourceMappingURL=doctor.js.map

package/dist/tools/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/tools/doctor.ts"],"names":[],"mappings":"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"}

package/dist/tools/install-hooks.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/install-hooks.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * install-hooks — write the user-level Copilot hook file that points every
+ * event at this adapter's `dist/index.js` (D4: direct hook-file install,
+ * plugin auto-discovery channel unused).
+ *
+ * Target: `$COPILOT_HOME/hooks/pinta-copilot.json` (default `~/.copilot/hooks/`).
+ * One file fires on BOTH the Copilot CLI and the VS Code extension — no VS Code
+ * setting required (`chat.useClaudeHooks` default works, §9.7). Add the same
+ * file under a repo's `.github/hooks/` for cloud/repo-scoped runs (out of scope
+ * for now).
+ *
+ * Idempotent: re-running rewrites our file in place. `--uninstall` removes it.
+ * Absolute paths are baked in at install time because user-level hooks don't
+ * receive `${COPILOT_PLUGIN_ROOT}` substitution.
+ *
+ * Usage:
+ *   node dist/tools/install-hooks.js [--dry-run] [--uninstall]
+ */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const HOOK_FILE = "pinta-copilot.json";
+// Every event routes to the single adapter binary; it branches internally
+// (telemetry for all; guard deny on PreToolUse + permissionRequest).
+const EVENTS = [
+    "SessionStart",
+    "SessionEnd",
+    "UserPromptSubmit",
+    "PreToolUse",
+    "PostToolUse",
+    "PostToolUseFailure",
+    "Stop",
+    "SubagentStart",
+    "SubagentStop",
+    "PreCompact",
+    "Notification",
+    "permissionRequest",
+];
+function copilotHome() {
+    return process.env.COPILOT_HOME || node_path_1.default.join(node_os_1.default.homedir(), ".copilot");
+}
+function hooksDir() {
+    return node_path_1.default.join(copilotHome(), "hooks");
+}
+/** Absolute path to dist/index.js. This script runs as dist/tools/install-hooks.js,
+ *  so resolve relative to the invoked script path (CJS/ESM agnostic). */
+function adapterEntry() {
+    const here = node_path_1.default.dirname(node_path_1.default.resolve(process.argv[1])); // .../dist/tools
+    return node_path_1.default.join(here, "..", "index.js"); // .../dist/index.js
+}
+function buildHooksFile() {
+    const cmd = `${process.execPath} ${adapterEntry()}`;
+    const hooks = {};
+    for (const ev of EVENTS) {
+        // Stamp the registered event name into env as a fail-safe discriminator —
+        // some payloads (CLI subagentStart) omit any hook-name field entirely.
+        hooks[ev] = [{ type: "command", command: cmd, env: { PINTA_COPILOT_EVENT: ev } }];
+    }
+    return JSON.stringify({
+        version: 1,
+        _note: "Managed by @pinta-ai/pinta-copilot install-hooks. Do not edit by hand.",
+        hooks,
+    }, null, 2) + "\n";
+}
+function main() {
+    const args = process.argv.slice(2);
+    const dryRun = args.includes("--dry-run");
+    const uninstall = args.includes("--uninstall");
+    const target = node_path_1.default.join(hooksDir(), HOOK_FILE);
+    if (uninstall) {
+        if (node_fs_1.default.existsSync(target)) {
+            if (!dryRun)
+                node_fs_1.default.rmSync(target);
+            console.log(`${dryRun ? "[dry-run] would remove" : "removed"}: ${target}`);
+        }
+        else {
+            console.log(`nothing to remove: ${target}`);
+        }
+        return;
+    }
+    const content = buildHooksFile();
+    if (node_fs_1.default.existsSync(target) && node_fs_1.default.readFileSync(target, "utf-8") === content) {
+        console.log(`already up to date: ${target}`);
+        return;
+    }
+    if (dryRun) {
+        console.log(`[dry-run] would write: ${target}\n${content}`);
+        return;
+    }
+    node_fs_1.default.mkdirSync(hooksDir(), { recursive: true });
+    node_fs_1.default.writeFileSync(target, content);
+    console.log(`installed: ${target}`);
+    console.log("→ restart the Copilot CLI / reload the VS Code window to load hooks.");
+}
+main();
+//# sourceMappingURL=install-hooks.js.map

package/dist/tools/install-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hooks.js","sourceRoot":"","sources":["../../src/tools/install-hooks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@pinta-ai/pinta-copilot",
+  "version": "0.1.0",
+  "description": "Generic OTLP forwarder + guard for GitHub Copilot hook events (CLI + VS Code extension)",
+  "main": "dist/index.js",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pinta-ai/pinta-copilot.git"
+  },
+  "homepage": "https://github.com/pinta-ai/pinta-copilot#readme",
+  "bugs": {
+    "url": "https://github.com/pinta-ai/pinta-copilot/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "mock-server": "npx tsx tools/mock-server.ts",
+    "install-hooks": "node dist/tools/install-hooks.js",
+    "uninstall-hooks": "node dist/tools/install-hooks.js --uninstall",
+    "doctor": "node dist/tools/doctor.js",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}