devlens-mcp 0.3.0

package/README.md

@@ -0,0 +1,354 @@
+# DevLens
+
+### Playwright-style MCP server for React Native mobile development
+
+DevLens gives AI agents the ability to **see, interact with, and verify** your mobile app running on a simulator or emulator. It bridges the gap between "AI writes code" and "AI confirms the code works" — enabling a fully automated **design-to-code-to-verification loop**.
+
+```
+Figma Design  ──►  AI Agent  ──►  Code Changes  ──►  Hot Reload  ──►  Screenshot  ──►  Compare
+                       ▲                                                                   │
+                       └───────────────── Fix & repeat until > 95% match ──────────────────┘
+```
+
+---
+
+## Quick Start
+
+### Step 1 — Clone and build
+
+```bash
+git clone https://JioOmni@dev.azure.com/JioOmni/OmniAI/_git/mcp-devlens
+cd mcp-devlens
+npm install
+npm run build
+```
+
+Note the **absolute path** to the cloned folder — you'll need it in the next step (e.g. `/Users/yourname/mcp-devlens`).
+
+### Step 2 — Add to your AI client
+
+**Cursor IDE** — edit `~/.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "devlens": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-devlens/dist/bin/cli.js"],
+      "env": {
+        "METRO_PORT": "8081",
+        "FIGMA_TOKEN": "figd_xxxxx"
+      }
+    }
+  }
+}
+```
+
+**Claude Code**:
+```bash
+claude mcp add devlens -- node /absolute/path/to/mcp-devlens/dist/bin/cli.js
+```
+
+**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "devlens": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-devlens/dist/bin/cli.js"],
+      "env": {
+        "METRO_PORT": "8081",
+        "FIGMA_TOKEN": "figd_xxxxx"
+      }
+    }
+  }
+}
+```
+
+Restart your AI client after editing the config.
+
+---
+
+## What Problems Does It Solve?
+
+Without DevLens, AI agents resort to manual, error-prone workflows:
+
+| Without DevLens (Manual) | With DevLens |
+|---|---|
+| `adb exec-out screencap -p > /tmp/screenshot.png` | `devlens_screenshot` |
+| `adb shell input tap 100 180` (coordinate guessing) | `devlens_tap(ref: "e5")` (element refs) |
+| Visually comparing screenshot to Figma export | `devlens_compare_with_figma(figmaUrl: "...")` |
+| `adb shell am force-stop` + `am start` | `devlens_terminate_app` + `devlens_launch_app` |
+| `curl http://localhost:8081/status` | `devlens_metro_status` |
+| Multiple manual reload attempts | `devlens_hot_reload` |
+| Guessing if an element rendered | `devlens_find_element` + `devlens_snapshot(validate: true)` |
+| `sleep 3 && adb screencap` loops | `devlens_wait_for_screen` |
+| Grep-reading token files and component interfaces | `devlens_ds_context` |
+
+---
+
+## New in v0.3.1
+
+- **Layout-Aware Comparison** — `devlens_compare_with_figma` now reports per-element similarity scores using the accessibility tree. Instead of a single misleading global pixel-diff number, you get `"Header: 94%, ChatInput: 61%, ToolsGrid: 44% ← investigate"`. Set `layoutReport: false` to disable.
+- **Design System Context** — new `devlens_ds_context` tool reads your design token file, component interfaces, and scans actual usage patterns in `.tsx` files. AI agents use this to write correct DS-compliant code instead of guessing token names.
+- **Moved/Resized Element Detection** — incremental snapshot diffs now distinguish elements that moved from elements that were removed and re-added:
+  ```
+  MOVED:
+    -> Button "Sign In" moved by (+0, +16)px
+  RESIZED:
+    <> LinearLayout 1080x200 → 1080x248
+  ```
+- **Side-by-Side Comparison Output** — `devlens_compare_with_figma` now returns three images: device screenshot, Figma reference, and pixel diff — so the AI sees both sides simultaneously.
+
+---
+
+## New in v0.3.0
+
+- **Direct Figma Comparison** — `devlens_compare_with_figma` fetches a Figma design via REST API and compares against the device in a single call. No more broken base64 piping.
+- **Debug Overlay Dismissal** — `devlens_dismiss_overlays` suppresses React Native LogBox banners and debug menus that ruin screenshots
+- **Batch Flow Capture** — `devlens_capture_flow` executes a sequence of actions (tap → screenshot → back) and returns all labeled screenshots in one call
+- **Region Comparison** — `devlens_compare_screenshot` now accepts `cropRef` or `region` to compare a specific element or area instead of the full screen
+- **Type Filter** — `devlens_find_element(type: "Button")` searches by element type (Button, ScrollView, EditText, etc.)
+- **Auto-Reset Incremental Snapshots** — Navigation actions (tap, swipe, go_back) automatically reset incremental snapshot state
+- **A/B Image Comparison** — `devlens_compare_images` compares any two saved screenshots (before/after)
+
+---
+
+## Tools (34)
+
+### Device Management (3)
+| Tool | Description |
+|------|-------------|
+| `devlens_list_devices` | List running simulators/emulators |
+| `devlens_device_info` | Screen size, OS version, orientation |
+| `devlens_set_orientation` | Set portrait/landscape |
+
+### App Management (4)
+| Tool | Description |
+|------|-------------|
+| `devlens_launch_app` | Launch app by bundle/package ID |
+| `devlens_terminate_app` | Force stop an app |
+| `devlens_install_app` | Install .apk/.app/.ipa |
+| `devlens_list_apps` | List installed apps |
+
+### Snapshot & Elements (5)
+| Tool | Description |
+|------|-------------|
+| `devlens_snapshot` | Accessibility tree with ref IDs + optional validation |
+| `devlens_find_element` | Find elements by text, label, or type (warns about invisible matches) |
+| `devlens_wait_for_element` | Wait for element to appear |
+| `devlens_wait_for_screen` | Wait for screen stability or specific content |
+| `devlens_element_info` | Detailed info + inferred layout direction |
+
+### Interaction (8)
+| Tool | Description |
+|------|-------------|
+| `devlens_tap` | Tap element by ref |
+| `devlens_type` | Type text into input |
+| `devlens_swipe` | Swipe gesture |
+| `devlens_scroll` | Scroll a container |
+| `devlens_long_press` | Long press element |
+| `devlens_press_button` | Home/Back/Enter |
+| `devlens_fill_form` | Fill multiple fields at once |
+| `devlens_capture_flow` | Batch execute actions + capture labeled screenshots |
+
+### Screenshots & Visual (5)
+| Tool | Description |
+|------|-------------|
+| `devlens_screenshot` | Take screenshot (base64 + file) |
+| `devlens_compare_screenshot` | Compare with reference (file, URL, base64) + cropRef/region support |
+| `devlens_element_screenshot` | Screenshot a specific element |
+| `devlens_compare_images` | A/B compare two saved screenshots |
+| `devlens_compare_with_figma` | Compare device screen against Figma design with per-element layout report |
+
+### React Native / Metro (6)
+| Tool | Description |
+|------|-------------|
+| `devlens_metro_status` | Check if Metro is running and healthy |
+| `devlens_metro_logs` | Console.log/warn/error from Metro |
+| `devlens_component_tree` | React component hierarchy |
+| `devlens_hot_reload` | Trigger fast refresh |
+| `devlens_network_requests` | Fetch/XHR requests from the app |
+| `devlens_dismiss_overlays` | Dismiss React Native debug banners and LogBox |
+
+### Navigation (2)
+| Tool | Description |
+|------|-------------|
+| `devlens_open_url` | Open URL / deep link |
+| `devlens_go_back` | Navigate back |
+
+### Design System (1)
+| Tool | Description |
+|------|-------------|
+| `devlens_ds_context` | Load design tokens, component interfaces, and usage patterns from your codebase |
+
+---
+
+## The Figma Verification Workflow
+
+DevLens integrates with Figma to create an automated design verification loop:
+
+```
+┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
+│  Figma   │────►│   AI     │────►│  Code    │────►│  Device  │
+│  Design  │     │  Agent   │     │  Editor  │     │  Screen  │
+└──────────┘     └──────┬───┘     └──────────┘     └────┬─────┘
+                        │                                │
+                        │◄─── devlens_compare ───────────┘
+                        │     (similarity < 95%?)
+                        │              │
+                        ▼              ▼
+                   Fix Code ◄─── Layout Report
+                                (per-element scores)
+```
+
+### Step-by-step:
+
+1. **Check Metro** — `devlens_metro_status` to verify Metro is healthy
+2. **Dismiss overlays** — `devlens_dismiss_overlays` to remove debug banners
+3. **Load DS context** — `devlens_ds_context` so the AI knows token names and component props
+4. **Generate code** — AI creates/updates the React Native component using correct DS tokens
+5. **Hot reload** — `devlens_hot_reload` triggers Metro fast refresh
+6. **Wait for stability** — `devlens_wait_for_screen` waits until UI stops changing
+7. **Validate elements** — `devlens_snapshot(validate: true)` catches invisible/zero-size elements
+8. **Compare with Figma** — `devlens_compare_with_figma(figmaUrl: "...")` returns device screenshot, Figma reference, diff image, and per-element layout scores
+9. **Analyze diff** — AI reads which elements are `poor`/`partial` and fixes those specifically
+10. **Fix & repeat** — Adjust code until overall similarity > 95%
+
+---
+
+## How It Works
+
+### Architecture
+
+```
+AI Agent  ──(MCP JSON-RPC over stdio)──►  DevLens Server  ──(ADB/simctl)──►  Device
+                                               │
+                                               ├──(CDP WebSocket)──►  Metro Bundler
+                                               │
+                                               └──(fs/regex)──►  Design System Files
+
+AI Agent  ◄──(accessibility tree + refs)──  DevLens Server  ◄──(UI hierarchy)──  Device
+```
+
+### Playwright-style Ref System
+
+Every interactive element gets a unique ref (e1, e2, e3...). Instead of guessing pixel coordinates, AI agents use refs:
+
+```
+- LinearLayout
+  - TextView "Welcome to MyApp" [ref=e1]
+  - EditText "Email" [ref=e2] [focused]
+  - EditText "Password" [ref=e3]
+  - Button "Sign In" [ref=e4]
+```
+
+Then: `devlens_tap(ref="e4")` — no coordinate math, no misses.
+
+### Incremental Snapshots
+
+In `incremental` mode, DevLens only sends what changed since the last snapshot — saving 60-80% tokens in iterative workflows. Elements that move are now tracked as moved, not as a remove+add pair:
+
+```
+[Incremental update]
+CHANGED:
+  ~ Button "Submit": text: "Submit" → "Save"
+ADDED:
+  + TextView "Changes saved!"
+MOVED:
+  -> Button "Sign In" moved by (+0, +16)px
+RESIZED:
+  <> LinearLayout 1080x200 → 1080x248
+```
+
+### Layout-Aware Visual Comparison
+
+`devlens_compare_with_figma` uses the accessibility tree to compare per UI region instead of the full screen:
+
+- Scales each element's device-space bounds into Figma image space using `scaleX = figmaW / screenW`
+- Crops both images to the scaled region and runs `pixelmatch` independently per element
+- Returns a weighted similarity score per element plus an area-weighted overall score
+- Elements with area < 3000px² are skipped (too small for reliable comparison)
+
+Example output:
+```
+--- Layout Region Analysis ---
+Device: 1080x2400px  |  Figma: 430x932px  |  Scale: 2.51x
+Regions: 8 analyzed, 12 too small
+
+  [✓] [e2] "Welcome Back": 94.1%
+  [~] [e7] "Sign In" (Button): 83.2%
+  [!] [e3] AssistantCards: 61.4%  <- investigate (312 diff pixels)
+  [X] [e5] ToolsGrid: 44.2%  <- investigate (1,089 diff pixels)
+
+Overall (area-weighted): 68.7%
+```
+
+### Design System Context
+
+`devlens_ds_context` reads directly from your codebase — no build step, no separate service:
+
+- **Tokens** — regex-parsed from your token constants file (e.g. `FIGMA_COLORS`, `FIGMA_SPACING`)
+- **Component interfaces** — reads generated TypeScript prop types from `componentsDir`
+- **Usage patterns** — scans `.tsx` files for `<JDS*>`, `<Icon>`, `<Chip>` with their actual prop values
+
+Configure via `devlens.config.json` in your app root (see [Setup Guide](./docs/setup-guide.md)).
+
+---
+
+## Prerequisites
+
+- **Node.js** >= 18
+- **Android**: Android SDK with `adb` in PATH (Android Studio)
+- **iOS** (macOS only): Xcode with Command Line Tools
+- **React Native**: Metro bundler running (`npx react-native start`)
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `FIGMA_TOKEN` | — | Figma personal access token (required for `devlens_compare_with_figma`). Needs **File content: Read** scope. |
+| `DEVLENS_CONFIG` | — | Absolute path to `devlens.config.json`. Enables `devlens_ds_context`. |
+| `METRO_PORT` | `8081` | Metro bundler port |
+| `ANDROID_HOME` | auto-detect | Android SDK path |
+| `ANDROID_SDK_ROOT` | auto-detect | Alternative to `ANDROID_HOME` |
+| `DEVICE_ID` | first available | Target a specific device |
+
+## Platform Support
+
+| Feature | Android Emulator | iOS Simulator |
+|---------|-----------------|---------------|
+| Accessibility snapshots | UI Automator | simctl + a11y API |
+| Screenshots | ADB screencap | simctl screenshot |
+| Tap/Type/Swipe | ADB input | simctl io |
+| App management | ADB + pm | simctl |
+| Metro integration | CDP WebSocket | CDP WebSocket |
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| "No running simulators or emulators" | Start a device from Android Studio or Xcode |
+| "Could not connect to Metro bundler" | Run `npx react-native start` and check `METRO_PORT` |
+| "ADB command not found" | Set `ANDROID_HOME` or add `platform-tools` to PATH |
+| "simctl not found" | Install Xcode Command Line Tools: `xcode-select --install` |
+| DevLens tools not available | Run `npm run register` (local dev) or check MCP config |
+| "Invalid token" on Figma compare | Use a personal access token (`figd_...`), not an OAuth token. Required scope: **File content: Read**. |
+| "File not exportable" on Figma compare | Disable "Prevent viewers from copying and exporting" in Figma share settings |
+| `devlens_ds_context` returns empty | Set `DEVLENS_CONFIG` env var to your `devlens.config.json` path |
+| Comparison similarity always low | Run `devlens_snapshot` first so layout report has element bounds to work with |
+
+---
+
+## Documentation
+
+- **[docs/setup-guide.md](./docs/setup-guide.md)** - Full setup guide: prerequisites, Figma token, design system config
+- **[docs/figma-workflow.md](./docs/figma-workflow.md)** - Figma integration workflow
+- **[docs/tool-reference.md](./docs/tool-reference.md)** - Detailed tool API reference
+
+## Repository
+
+- **Azure DevOps**: https://dev.azure.com/JioOmni/OmniAI/_git/mcp-devlens
+
+## License
+
+MIT

package/bin/cli.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { createServer } from "../src/index.js";
+
+async function main() {
+  const server = await createServer();
+
+  process.on("SIGINT", async () => {
+    await server.close();
+    process.exit(0);
+  });
+
+  process.on("SIGTERM", async () => {
+    await server.close();
+    process.exit(0);
+  });
+}
+
+main().catch((error) => {
+  console.error("DevLens failed to start:", error);
+  process.exit(1);
+});

package/bin/register.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+/**
+ * DevLens MCP Registration Script
+ *
+ * Usage:
+ *   node dist/bin/register.js          — Check status + print instructions
+ *   node dist/bin/register.js --register — Actually register with Claude Code
+ */
+
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { resolve } from "path";
+import { existsSync, readFileSync } from "fs";
+
+const execFileAsync = promisify(execFile);
+
+async function register(): Promise<void> {
+  const cliPath = resolve(__dirname, "cli.js");
+
+  if (!existsSync(cliPath)) {
+    console.error("Error: dist/bin/cli.js not found. Run 'npm run build' first.");
+    process.exit(1);
+  }
+
+  const autoRegister = process.argv.includes("--register");
+
+  // Check common config locations for existing registration
+  const home = process.env.HOME || process.env.USERPROFILE || "~";
+  const configPaths = [
+    resolve(home, ".claude", "mcp.json"),
+    resolve(home, ".claude", "settings.json"),
+    resolve(home, ".config", "claude", "mcp.json"),
+  ];
+
+  let alreadyRegistered = false;
+  for (const configPath of configPaths) {
+    if (existsSync(configPath)) {
+      try {
+        const content = readFileSync(configPath, "utf-8");
+        if (content.includes("devlens")) {
+          alreadyRegistered = true;
+          console.log(`DevLens already registered in: ${configPath}`);
+          break;
+        }
+      } catch {
+        // Ignore read errors
+      }
+    }
+  }
+
+  if (alreadyRegistered) {
+    console.log("DevLens MCP server is already registered. No action needed.");
+    return;
+  }
+
+  const command = `claude mcp add devlens -- node ${cliPath}`;
+
+  if (autoRegister) {
+    console.log("Registering DevLens MCP server...");
+    console.log(`Running: ${command}`);
+    try {
+      const { stdout, stderr } = await execFileAsync("claude", [
+        "mcp",
+        "add",
+        "devlens",
+        "--",
+        "node",
+        cliPath,
+      ]);
+      if (stdout) console.log(stdout);
+      if (stderr) console.error(stderr);
+      console.log("DevLens registered successfully!");
+    } catch (error: any) {
+      console.error(`Registration failed: ${error.message}`);
+      console.log(`\nPlease register manually:\n  ${command}`);
+      process.exit(1);
+    }
+  } else {
+    console.log("");
+    console.log("=== DevLens MCP Registration ===");
+    console.log("");
+    console.log("DevLens is not registered as an MCP tool.");
+    console.log("To register, run one of these commands:");
+    console.log("");
+    console.log(`  npm run register`);
+    console.log(`  # or manually:`);
+    console.log(`  ${command}`);
+    console.log("");
+  }
+}
+
+register().catch((err) => {
+  console.error("Registration error:", err);
+  process.exit(1);
+});

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":""}

package/dist/bin/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("../src/index.js");
+async function main() {
+    const server = await (0, index_js_1.createServer)();
+    process.on("SIGINT", async () => {
+        await server.close();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        await server.close();
+        process.exit(0);
+    });
+}
+main().catch((error) => {
+    console.error("DevLens failed to start:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";;;AAEA,8CAA+C;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAY,GAAE,CAAC;IAEpC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/bin/register.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * DevLens MCP Registration Script
+ *
+ * Usage:
+ *   node dist/bin/register.js          — Check status + print instructions
+ *   node dist/bin/register.js --register — Actually register with Claude Code
+ */
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/bin/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../bin/register.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}

package/dist/bin/register.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * DevLens MCP Registration Script
+ *
+ * Usage:
+ *   node dist/bin/register.js          — Check status + print instructions
+ *   node dist/bin/register.js --register — Actually register with Claude Code
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const path_1 = require("path");
+const fs_1 = require("fs");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+async function register() {
+    const cliPath = (0, path_1.resolve)(__dirname, "cli.js");
+    if (!(0, fs_1.existsSync)(cliPath)) {
+        console.error("Error: dist/bin/cli.js not found. Run 'npm run build' first.");
+        process.exit(1);
+    }
+    const autoRegister = process.argv.includes("--register");
+    // Check common config locations for existing registration
+    const home = process.env.HOME || process.env.USERPROFILE || "~";
+    const configPaths = [
+        (0, path_1.resolve)(home, ".claude", "mcp.json"),
+        (0, path_1.resolve)(home, ".claude", "settings.json"),
+        (0, path_1.resolve)(home, ".config", "claude", "mcp.json"),
+    ];
+    let alreadyRegistered = false;
+    for (const configPath of configPaths) {
+        if ((0, fs_1.existsSync)(configPath)) {
+            try {
+                const content = (0, fs_1.readFileSync)(configPath, "utf-8");
+                if (content.includes("devlens")) {
+                    alreadyRegistered = true;
+                    console.log(`DevLens already registered in: ${configPath}`);
+                    break;
+                }
+            }
+            catch {
+                // Ignore read errors
+            }
+        }
+    }
+    if (alreadyRegistered) {
+        console.log("DevLens MCP server is already registered. No action needed.");
+        return;
+    }
+    const command = `claude mcp add devlens -- node ${cliPath}`;
+    if (autoRegister) {
+        console.log("Registering DevLens MCP server...");
+        console.log(`Running: ${command}`);
+        try {
+            const { stdout, stderr } = await execFileAsync("claude", [
+                "mcp",
+                "add",
+                "devlens",
+                "--",
+                "node",
+                cliPath,
+            ]);
+            if (stdout)
+                console.log(stdout);
+            if (stderr)
+                console.error(stderr);
+            console.log("DevLens registered successfully!");
+        }
+        catch (error) {
+            console.error(`Registration failed: ${error.message}`);
+            console.log(`\nPlease register manually:\n  ${command}`);
+            process.exit(1);
+        }
+    }
+    else {
+        console.log("");
+        console.log("=== DevLens MCP Registration ===");
+        console.log("");
+        console.log("DevLens is not registered as an MCP tool.");
+        console.log("To register, run one of these commands:");
+        console.log("");
+        console.log(`  npm run register`);
+        console.log(`  # or manually:`);
+        console.log(`  ${command}`);
+        console.log("");
+    }
+}
+register().catch((err) => {
+    console.error("Registration error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=register.js.map

package/dist/bin/register.js.map

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