kumo-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kumo
+
+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

@@ -0,0 +1,130 @@
+# Kumo CLI
+
+> _where your code drifts between devices, softly._
+
+[![npm version](https://img.shields.io/npm/v/kumo-cli.svg?style=flat-square)](https://www.npmjs.com/package/kumo-cli)
+[![node](https://img.shields.io/node/v/kumo-cli.svg?style=flat-square)](https://nodejs.org)
+[![license](https://img.shields.io/npm/l/kumo-cli.svg?style=flat-square)](./LICENSE)
+
+**Kumo CLI** is the desktop companion for the [Kumo app](https://github.com/kumo-app/kumo). It pairs your terminal with the mobile/desktop client over a secure WebSocket bridge so you can drive Claude Code (and any PTY session) from anywhere — without giving up the comfort of your local shell.
+
+---
+
+## ✨ Features
+
+- 🔗 **One-tap pairing** — link the CLI to your Kumo account with a 9-digit code from the app.
+- 🖥️ **Real PTY streaming** — spawns Claude Code (or any process) via `node-pty` and mirrors the terminal byte-for-byte.
+- 📡 **Bi-directional bridge** — keystrokes from the app flow back into the local PTY in real time.
+- 🪝 **Session hooks** — auto-injects Claude Code session hooks so your remote views stay in sync.
+- 🧠 **Smart snapshots** — periodic ANSI snapshots keep newly connected viewers up to date instantly.
+- 🌐 **Bonjour discovery** — optional local discovery for zero-config LAN setups.
+- 🔒 **Local credentials** — device tokens are stored under your user config dir, never echoed.
+
+---
+
+## 🚀 Quick start
+
+```bash
+# run on demand (no install)
+npx kumo-cli@latest
+
+# or install globally
+npm install -g kumo-cli
+kumo
+```
+
+On first launch you'll see a prompt:
+
+```
+✦ pairing code › ___
+```
+
+Open the **Kumo app**, sign in, tap **"generate"** on the pairing tab, and type the 9 digits back. That's it — your CLI is paired and a session is live.
+
+---
+
+## 📦 Requirements
+
+- **Node.js ≥ 18** (LTS recommended)
+- A working C/C++ toolchain for [`node-pty`](https://github.com/microsoft/node-pty#dependencies):
+  - **Windows:** Visual Studio Build Tools + Python 3
+  - **macOS:** Xcode Command Line Tools (`xcode-select --install`)
+  - **Linux:** `build-essential`, `python3`, `make`, `gcc`
+- [Claude Code CLI](https://docs.anthropic.com/claude/docs/claude-code) installed and on `PATH` (only if you plan to use the Claude session features)
+
+---
+
+## 🛠️ Configuration
+
+Kumo CLI is configured via environment variables. They can be exported in your shell or placed in a `.env` file in the working directory.
+
+| Variable | Default | Description |
+| --- | --- | --- |
+| `KUMO_SERVER_URL` | `http://localhost:3579` | Base URL of the Kumo backend. Auto-derives HTTP & WS endpoints. |
+| `KUMO_SERVER_HTTP_URL` | derived | Override the HTTP endpoint explicitly. |
+| `KUMO_SERVER_WS_URL` | derived | Override the WebSocket endpoint explicitly. |
+| `KUMO_PORT` | `3579` | Local port hint (used by some discovery flows). |
+
+Credentials are persisted to your OS config dir (e.g. `%APPDATA%\kumo\credentials.json` on Windows, `~/.config/kumo/credentials.json` on Linux/macOS).
+
+---
+
+## 🧭 Usage
+
+```bash
+kumo                  # interactive: pair if needed, then start a session
+kumo --help           # show available flags (if applicable)
+```
+
+To unpair, simply delete the credentials file printed on first pairing, or run:
+
+```bash
+node -e "require('node:fs').rmSync(require('node:path').join(require('node:os').homedir(), '.config', 'kumo', 'credentials.json'))"
+```
+
+---
+
+## 🧱 How it works
+
+```
+┌─────────────┐    WebSocket     ┌──────────────┐     PTY     ┌─────────────┐
+│  Kumo app   │  ◄────────────►  │  Kumo CLI    │  ◄───────►  │ Claude Code │
+└─────────────┘                  └──────────────┘             └─────────────┘
+       ▲                                │
+       │       HTTP (pairing)           │
+       └────────────────────────────────┘
+              Kumo backend
+```
+
+1. The CLI pairs with the backend using the 9-digit code → receives a long-lived `deviceToken`.
+2. It opens a WebSocket to the backend and announces itself.
+3. When the app requests a session, the CLI spawns Claude Code under a real PTY.
+4. STDIN/STDOUT are streamed both ways; periodic snapshots and Claude session hooks keep state coherent.
+
+---
+
+## 🐞 Troubleshooting
+
+- **`node-pty` build fails** — make sure your toolchain (above) is installed, then re-run `npm install -g kumo-cli`.
+- **Pairing code rejected** — codes are single-use and expire quickly. Generate a fresh one in the app.
+- **Cannot connect** — verify `KUMO_SERVER_URL` matches the backend the app is talking to.
+- **Hooks not firing** — make sure Claude Code is on `PATH` and you launched a session through the CLI (the hook settings file is auto-generated under the system temp dir).
+
+---
+
+## 🤝 Contributing
+
+Issues and PRs are welcome at [github.com/kumo-app/kumo](https://github.com/kumo-app/kumo).
+
+```bash
+git clone https://github.com/kumo-app/kumo.git
+cd kumo/cli
+npm install
+npm run dev
+```
+
+---
+
+## 📄 License
+
+[MIT](./LICENSE) © Kumo

package/dist/ansiCodes.js

@@ -0,0 +1,107 @@
+export const ESC = "\x1b";
+export const CSI = `${ESC}[`;
+export const ANSI = {
+    RESET: `${CSI}m`,
+    CURSOR: {
+        HOME: `${CSI}H`,
+        HIDE: `${CSI}?25l`,
+        SHOW: `${CSI}?25h`,
+        MOVE_RIGHT: (n) => `${CSI}${n}C`,
+        MOVE_UP: (n) => `${CSI}${n}A`,
+        MOVE_DOWN: (n) => `${CSI}${n}B`,
+        MOVE_LEFT: (n) => `${CSI}${n}D`,
+        SET_POSITION: (row, col) => `${CSI}${row};${col}H`,
+        SAVE: `${CSI}s`,
+        RESTORE: `${CSI}u`,
+    },
+    SCREEN: {
+        CLEAR: `${CSI}2J`,
+        CLEAR_LINE: `${CSI}K`,
+        CLEAR_LINE_FROM_CURSOR: `${CSI}0K`,
+        CLEAR_LINE_TO_CURSOR: `${CSI}1K`,
+        ERASE_CHARS: (n) => `${CSI}${n}X`,
+    },
+    STYLE: {
+        BOLD: `${CSI}1m`,
+        BOLD_OFF: `${CSI}22m`,
+        DIM: `${CSI}2m`,
+        ITALIC: `${CSI}3m`,
+        ITALIC_OFF: `${CSI}23m`,
+        UNDERLINE: `${CSI}4m`,
+        UNDERLINE_OFF: `${CSI}24m`,
+        INVERSE: `${CSI}7m`,
+        INVERSE_OFF: `${CSI}27m`,
+    },
+    COLOR: {
+        FG_RGB: (r, g, b) => `${CSI}38;2;${r};${g};${b}m`,
+        BG_RGB: (r, g, b) => `${CSI}48;2;${r};${g};${b}m`,
+        FG_DEFAULT: `${CSI}39m`,
+        BG_DEFAULT: `${CSI}49m`,
+    },
+    MODE: {
+        WIN32_INPUT: `${CSI}?9001h`,
+        WIN32_INPUT_OFF: `${CSI}?9001l`,
+        FOCUS_EVENT: `${CSI}?1004h`,
+        FOCUS_EVENT_OFF: `${CSI}?1004l`,
+        BRACKETED_PASTE: `${CSI}?2004h`,
+        BRACKETED_PASTE_OFF: `${CSI}?2004l`,
+        SYNC_UPDATE: `${CSI}?2026h`,
+        SYNC_UPDATE_OFF: `${CSI}?2026l`,
+        EXTENDED_KEYS: `${CSI}?2031h`,
+        EXTENDED_KEYS_OFF: `${CSI}?2031l`,
+    },
+    WINDOW: {
+        SET_SIZE: (rows, cols) => `${CSI}8;${rows};${cols}t`,
+        SET_TITLE: (title) => `${ESC}]0;${title}\x07`,
+    },
+    KEY_MODIFIERS: {
+        REPORT: `${CSI}>0q`,
+    },
+};
+export const ANSI_REGEX = {
+    CSI_SEQUENCE: /\x1b\[[0-9;?><=]*[A-Za-z~]/g,
+    SGR_COLOR: /\x1b\[(?:38|48);2;(\d+);(\d+);(\d+)m/g,
+    CURSOR_POSITION: /\x1b\[(\d+);(\d+)H/g,
+    PRIVATE_MODE: /\x1b\[\?(\d+)([hl])/g,
+    OSC_SEQUENCE: /\x1b\](\d+);([^\x07]*)\x07/g,
+    WINDOW_SIZE: /\x1b\[8;(\d+);(\d+)t/g,
+    ERASE_CHARS: /\x1b\[(\d+)X/g,
+    MOVE_CURSOR: /\x1b\[(\d+)([ABCD])/g,
+    ALL: /\x1b(?:\[[0-9;?><=]*[A-Za-z~]|\][^\x07]*\x07|[>=][0-9]*[a-z]?)/g,
+};
+export const CLAUDE_CODE_COLORS = {
+    ORANGE: { r: 215, g: 119, b: 87 },
+    GRAY: { r: 153, g: 153, b: 153 },
+    DARK_GRAY: { r: 136, g: 136, b: 136 },
+    RED: { r: 255, g: 107, b: 128 },
+    PURPLE: { r: 177, g: 185, b: 249 },
+    BG_DARK: { r: 55, g: 55, b: 55 },
+    BG_GRAY: { r: 80, g: 80, b: 80 },
+    BLACK: { r: 0, g: 0, b: 0 },
+    WHITE: { r: 255, g: 255, b: 255 },
+};
+export function stripAnsi(str) {
+    return str.replace(ANSI_REGEX.ALL, "");
+}
+export function parseRgbColor(seq) {
+    const match = seq.match(/\[(?:38|48);2;(\d+);(\d+);(\d+)m/);
+    if (match) {
+        return { r: parseInt(match[1]), g: parseInt(match[2]), b: parseInt(match[3]) };
+    }
+    return null;
+}
+export function parseCursorPosition(seq) {
+    const match = seq.match(/\[(\d+);(\d+)H/);
+    if (match) {
+        return { row: parseInt(match[1]), col: parseInt(match[2]) };
+    }
+    return null;
+}
+export function parseWindowSize(seq) {
+    const match = seq.match(/\[8;(\d+);(\d+)t/);
+    if (match) {
+        return { rows: parseInt(match[1]), cols: parseInt(match[2]) };
+    }
+    return null;
+}
+//# sourceMappingURL=ansiCodes.js.map

package/dist/ansiCodes.js.map

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

package/dist/credentialsStore.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const CRED_DIR = path.join(os.homedir(), '.kumo');
+const CRED_FILE = path.join(CRED_DIR, 'credentials.json');
+// load credentials from ~/.kumo/credentials.json if present
+export function loadCredentials() {
+    try {
+        if (!fs.existsSync(CRED_FILE))
+            return null;
+        const raw = fs.readFileSync(CRED_FILE, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed.deviceUuid || !parsed.deviceToken)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+// persist credentials; 0600 permissions on posix
+export function saveCredentials(creds) {
+    if (!fs.existsSync(CRED_DIR))
+        fs.mkdirSync(CRED_DIR, { recursive: true });
+    fs.writeFileSync(CRED_FILE, JSON.stringify(creds, null, 2), { encoding: 'utf-8', mode: 0o600 });
+}
+// remove credentials file; called by `kumo reset`
+export function clearCredentials() {
+    try {
+        if (!fs.existsSync(CRED_FILE))
+            return false;
+        fs.unlinkSync(CRED_FILE);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function credentialsPath() {
+    return CRED_FILE;
+}
+// parse a kumo:// pairing uri produced by the app's QR code
+export function parsePairingUri(input) {
+    try {
+        const normalized = input.startsWith('kumo://') ? input.replace('kumo://', 'http://x/') : input;
+        const u = new URL(normalized);
+        const code = u.searchParams.get('code');
+        const host = u.searchParams.get('host') ?? undefined;
+        if (!code)
+            return null;
+        return { code: code.toUpperCase(), host };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=credentialsStore.js.map

package/dist/credentialsStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentialsStore.js","sourceRoot":"","sources":["../src/credentialsStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAE1D,4DAA4D;AAC5D,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/F,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QACrD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/generateHookSettings.js

@@ -0,0 +1,30 @@
+import os from 'os';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function generateHookSettingsFile(hookPort) {
+    const forwarderPath = path.resolve(__dirname, '../scripts/session_hook_forwarder.cjs');
+    const settingsDir = path.join(os.tmpdir(), 'kumo-hooks');
+    fs.mkdirSync(settingsDir, { recursive: true });
+    const settingsPath = path.join(settingsDir, `settings-${Date.now()}.json`);
+    const command = `node "${forwarderPath}" --port ${hookPort}`;
+    const settings = {
+        hooks: {
+            SessionStart: [
+                {
+                    matcher: '',
+                    hooks: [
+                        {
+                            type: 'command',
+                            command,
+                        },
+                    ],
+                },
+            ],
+        },
+    };
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    return settingsPath;
+}
+//# sourceMappingURL=generateHookSettings.js.map

package/dist/generateHookSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateHookSettings.js","sourceRoot":"","sources":["../src/generateHookSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,uCAAuC,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;IACzD,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE3E,MAAM,OAAO,GAAG,SAAS,aAAa,YAAY,QAAQ,EAAE,CAAC;IAE7D,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE;YACL,YAAY,EAAE;gBACZ;oBACE,OAAO,EAAE,EAAE;oBACX,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,OAAO;yBACR;qBACF;iBACF;aACF;SACF;KACF,CAAC;IAEF,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/hookServer.js

@@ -0,0 +1,32 @@
+import http from 'http';
+export function startHookServer(onSessionFound) {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer((req, res) => {
+            if (req.method === 'POST' && req.url === '/hook/session-start') {
+                let body = '';
+                req.on('data', (chunk) => { body += chunk; });
+                req.on('end', () => {
+                    try {
+                        const data = JSON.parse(body);
+                        if (data.sessionId)
+                            onSessionFound(data.sessionId);
+                    }
+                    catch { }
+                    res.writeHead(200);
+                    res.end('ok');
+                });
+            }
+            else {
+                res.writeHead(404);
+                res.end();
+            }
+        });
+        server.listen(0, '127.0.0.1', () => {
+            const addr = server.address();
+            const port = typeof addr === 'object' && addr ? addr.port : 0;
+            resolve({ port, close: () => server.close() });
+        });
+        server.on('error', reject);
+    });
+}
+//# sourceMappingURL=hookServer.js.map

package/dist/hookServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookServer.js","sourceRoot":"","sources":["../src/hookServer.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAOxB,MAAM,UAAU,eAAe,CAAC,cAA2C;IACzE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC5C,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,qBAAqB,EAAE,CAAC;gBAC/D,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,IAAI,CAAC;wBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;wBACxD,IAAI,IAAI,CAAC,SAAS;4BAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACrD,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;oBACV,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBACnB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YACjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ignorePaths.js

@@ -0,0 +1,68 @@
+import fs from 'node:fs';
+import path from 'node:path';
+// common noisy folders/files to always ignore across ecosystems
+const DEFAULT_IGNORES = [
+    // vcs / editor / os
+    '.git', '.svn', '.hg', '.idea', '.vscode', '.DS_Store', 'Thumbs.db',
+    // node / js / ts
+    'node_modules', 'bower_components', 'dist', 'build', 'out', 'coverage',
+    '.nyc_output', '.next', '.nuxt', '.turbo', '.cache', '.parcel-cache',
+    '.svelte-kit', '.vercel', '.netlify', '.output', '.astro',
+    // python
+    '__pycache__', '.venv', 'venv', 'env', '.pytest_cache', '.mypy_cache',
+    '.tox', '.ruff_cache', '.ipynb_checkpoints',
+    // java / gradle / maven / kotlin
+    'target', '.gradle', '.mvn', '.kotlin',
+    // rust / go
+    // 'target' already listed
+    // dart / flutter
+    '.dart_tool', '.pub-cache', '.pub', '.flutter-plugins',
+    '.flutter-plugins-dependencies',
+    // mobile
+    '.expo', '.expo-shared', 'Pods', 'DerivedData', '.gradle',
+    // misc
+    'tmp', 'temp', 'logs', 'vendor', '.terraform', '.serverless',
+];
+let cache = null;
+// parse .gitignore into a set of simple name patterns
+// only supports basic names and name/ entries (ignores complex globs)
+function parseGitignore(content) {
+    const names = [];
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#') || line.startsWith('!'))
+            continue;
+        // strip leading slash and trailing slash
+        let p = line.replace(/^\/+/, '').replace(/\/+$/, '');
+        // skip patterns with wildcards or nested paths
+        if (p.includes('*') || p.includes('?') || p.includes('[') || p.includes('/'))
+            continue;
+        if (p)
+            names.push(p);
+    }
+    return names;
+}
+// load ignored names set combining defaults + .gitignore in given root
+// cached by mtime to avoid re-reading on each call
+export function loadIgnoredNames(projectRoot) {
+    const gitignore = path.join(projectRoot, '.gitignore');
+    let mtime = 0;
+    try {
+        mtime = fs.statSync(gitignore).mtimeMs;
+    }
+    catch { }
+    if (cache && cache.mtime === mtime)
+        return cache.set;
+    const set = new Set(DEFAULT_IGNORES);
+    if (mtime > 0) {
+        try {
+            const content = fs.readFileSync(gitignore, 'utf-8');
+            for (const name of parseGitignore(content))
+                set.add(name);
+        }
+        catch { }
+    }
+    cache = { mtime, set };
+    return set;
+}
+//# sourceMappingURL=ignorePaths.js.map

package/dist/ignorePaths.js.map

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