patchwork-os 0.2.0-alpha.0

package/dist/pluginLoader.js

@@ -0,0 +1,357 @@
+/**
+ * Plugin loader for Claude IDE Bridge.
+ *
+ * Discovers, validates, and dynamically imports plugin packages declared via
+ * --plugin CLI flags or the `plugins` config file key.
+ *
+ * Security model:
+ *  - Plugins are never auto-discovered. They must be explicitly declared.
+ *  - Plugins run in-process with full Node.js access (no sandbox).
+ *  - The `toolNamePrefix` field is enforced to prevent collision with built-in tools.
+ *  - Sensitive config fields (authToken, etc.) are not exposed to plugins.
+ *  - Each plugin load failure is isolated — a bad plugin is skipped, not fatal.
+ */
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { PACKAGE_VERSION } from "./version.js";
+const MANIFEST_FILE = "claude-ide-bridge-plugin.json";
+const SUPPORTED_SCHEMA_VERSION = 1;
+const MAX_TOOLS_PER_PLUGIN = 100;
+/** Runtime package version — compared against minBridgeVersion. */
+const BRIDGE_VERSION = PACKAGE_VERSION;
+// ── Semver helpers ────────────────────────────────────────────────────────────
+/** Parse a semver string into [major, minor, patch]. Returns null on bad input. */
+function parseSemver(v) {
+    const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
+    if (!m)
+        return null;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+/** Returns true if `actual` satisfies `>= required`. */
+function semverGte(actual, required) {
+    const a = parseSemver(actual);
+    const r = parseSemver(required);
+    if (!a || !r)
+        return true; // malformed — don't block
+    for (let i = 0; i < 3; i++) {
+        if ((a[i] ?? 0) > (r[i] ?? 0))
+            return true;
+        if ((a[i] ?? 0) < (r[i] ?? 0))
+            return false;
+    }
+    return true; // equal
+}
+// ── Manifest validation ───────────────────────────────────────────────────────
+const PREFIX_RE = /^[a-zA-Z][a-zA-Z0-9_]{1,19}$/;
+function validateManifest(raw, source) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        return { ok: false, reason: "manifest is not a JSON object" };
+    }
+    const m = raw;
+    if (m.schemaVersion !== SUPPORTED_SCHEMA_VERSION) {
+        return {
+            ok: false,
+            reason: `unsupported schemaVersion ${String(m.schemaVersion)} (expected ${SUPPORTED_SCHEMA_VERSION})`,
+        };
+    }
+    if (typeof m.name !== "string" || m.name.length === 0) {
+        return { ok: false, reason: '"name" must be a non-empty string' };
+    }
+    if (typeof m.entrypoint !== "string" || m.entrypoint.length === 0) {
+        return { ok: false, reason: '"entrypoint" must be a non-empty string' };
+    }
+    if (typeof m.toolNamePrefix !== "string") {
+        return { ok: false, reason: '"toolNamePrefix" must be a string' };
+    }
+    if (!PREFIX_RE.test(m.toolNamePrefix)) {
+        return {
+            ok: false,
+            reason: `"toolNamePrefix" "${m.toolNamePrefix}" must match /^[a-zA-Z][a-zA-Z0-9_]{1,19}$/`,
+        };
+    }
+    if (m.version !== undefined && typeof m.version !== "string") {
+        return { ok: false, reason: '"version" must be a string if present' };
+    }
+    if (m.permissions !== undefined &&
+        (!Array.isArray(m.permissions) ||
+            m.permissions.some((p) => typeof p !== "string"))) {
+        return {
+            ok: false,
+            reason: '"permissions" must be an array of strings if present',
+        };
+    }
+    void source; // used by caller for log context
+    return { ok: true, manifest: m };
+}
+// ── Path resolution ───────────────────────────────────────────────────────────
+/**
+ * Resolve a plugin specifier to a directory path.
+ * - Relative/absolute paths are resolved directly.
+ * - Package names are resolved via require.resolve from cwd.
+ */
+function resolvePluginDir(spec) {
+    if (spec.startsWith("./") ||
+        spec.startsWith("../") ||
+        path.isAbsolute(spec)) {
+        return path.resolve(spec);
+    }
+    // npm package — find the package.json via require.resolve, then take its directory
+    const req = createRequire(path.join(process.cwd(), "noop.js"));
+    const pkgJsonPath = req.resolve(`${spec}/package.json`);
+    return path.dirname(pkgJsonPath);
+}
+/**
+ * Load all plugins declared in config.plugins and return full LoadedPlugin objects.
+ *
+ * Collision-detection across plugins still applies.
+ */
+export async function loadPluginsFull(pluginSpecs, config, logger) {
+    if (pluginSpecs.length === 0)
+        return [];
+    const loadedPlugins = [];
+    const registeredNames = new Set(); // collision guard across plugins
+    // Deduplicate resolved paths before loading
+    const seen = new Set();
+    const specs = [];
+    for (const spec of pluginSpecs) {
+        let resolved;
+        try {
+            resolved = resolvePluginDir(spec);
+        }
+        catch {
+            resolved = spec;
+        }
+        if (!seen.has(resolved)) {
+            seen.add(resolved);
+            specs.push(spec);
+        }
+        else {
+            logger.warn(`Plugin "${spec}" resolves to a path already loaded — skipping duplicate`);
+        }
+    }
+    for (const spec of specs) {
+        const loaded = await loadOnePluginFull(spec, config, logger, registeredNames);
+        if (loaded !== null) {
+            loadedPlugins.push(loaded);
+        }
+    }
+    const totalTools = loadedPlugins.reduce((n, p) => n + p.tools.length, 0);
+    if (totalTools > 0) {
+        logger.info(`Plugins loaded: ${totalTools} tool${totalTools === 1 ? "" : "s"} registered`);
+    }
+    return loadedPlugins;
+}
+/**
+ * Load all plugins declared in config.plugins.
+ *
+ * Each plugin is loaded in isolation — a failure in one plugin is logged and
+ * skipped; the bridge continues with all successfully loaded plugins.
+ *
+ * Returns a flat list of tool registrations ready for registerAllTools().
+ */
+export async function loadPlugins(pluginSpecs, config, logger) {
+    const loaded = await loadPluginsFull(pluginSpecs, config, logger);
+    return loaded.flatMap((p) => p.tools);
+}
+export async function loadOnePluginFull(spec, config, logger, existingNames = new Set(), isHotReload = false) {
+    // 1. Resolve directory
+    let pluginDir;
+    try {
+        pluginDir = resolvePluginDir(spec);
+    }
+    catch (err) {
+        logger.warn(`Plugin "${spec}" — cannot resolve path: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    // 2. Read & parse manifest
+    const manifestPath = path.join(pluginDir, MANIFEST_FILE);
+    if (!fs.existsSync(manifestPath)) {
+        logger.warn(`Plugin "${spec}" — manifest not found at ${manifestPath}`);
+        return null;
+    }
+    let rawManifest;
+    try {
+        rawManifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+    }
+    catch (err) {
+        logger.warn(`Plugin "${spec}" — failed to parse ${MANIFEST_FILE}: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    const validation = validateManifest(rawManifest, spec);
+    if (!validation.ok) {
+        logger.warn(`Plugin "${spec}" — invalid manifest: ${validation.reason}`);
+        return null;
+    }
+    const manifest = validation.manifest;
+    // 3. Version check
+    if (manifest.minBridgeVersion &&
+        !semverGte(BRIDGE_VERSION, manifest.minBridgeVersion)) {
+        logger.warn(`Plugin "${manifest.name}" — requires bridge >= ${manifest.minBridgeVersion}, running ${BRIDGE_VERSION} (loading anyway)`);
+    }
+    // 4. Log startup info
+    const desc = manifest.description ? ` — ${manifest.description}` : "";
+    const perms = manifest.permissions && manifest.permissions.length > 0
+        ? ` [permissions: ${manifest.permissions.join(", ")}]`
+        : "";
+    logger.info(`Loading plugin "${manifest.name}"${manifest.version ? ` v${manifest.version}` : ""}${desc}${perms}`);
+    // 5. Dynamic import
+    const entrypointPath = path.resolve(pluginDir, manifest.entrypoint);
+    // Prevent entrypoint path traversal — the resolved path must stay inside pluginDir
+    if (path.relative(pluginDir, entrypointPath).startsWith("..")) {
+        logger.warn(`Plugin "${manifest.name}" — entrypoint path "${manifest.entrypoint}" escapes plugin directory (resolved to ${entrypointPath})`);
+        return null;
+    }
+    let mod;
+    const ext = path.extname(entrypointPath).toLowerCase();
+    const isCjs = ext === ".cjs" ||
+        (ext === ".js" &&
+            (() => {
+                // Detect CJS by reading the nearest package.json "type" field.
+                // A .js file is CJS unless "type": "module" is set.
+                try {
+                    let dir = path.dirname(entrypointPath);
+                    while (true) {
+                        const pkgPath = path.join(dir, "package.json");
+                        if (fs.existsSync(pkgPath)) {
+                            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+                            return pkg.type !== "module";
+                        }
+                        const parent = path.dirname(dir);
+                        if (parent === dir)
+                            break;
+                        dir = parent;
+                    }
+                }
+                catch {
+                    // Can't determine — assume ESM for safety (won't break ESM plugins)
+                }
+                return true; // default: CJS if no "type": "module" found
+            })());
+    try {
+        if (isCjs) {
+            // For CJS plugins, use createRequire + delete require.cache for reliable hot-reload.
+            // The ESM ?t= query-string approach doesn't work for CJS modules loaded via require().
+            const req = createRequire(entrypointPath);
+            // Invalidate the module and all its CJS children from the require cache
+            const visited = new Set();
+            function invalidateCjsCache(modPath) {
+                if (visited.has(modPath))
+                    return;
+                visited.add(modPath);
+                const cached = req.cache?.[modPath];
+                if (cached) {
+                    // Recurse into children before deleting the parent
+                    for (const child of cached.children ?? []) {
+                        invalidateCjsCache(child.filename);
+                    }
+                    delete req.cache?.[modPath];
+                }
+            }
+            try {
+                invalidateCjsCache(require.resolve(entrypointPath));
+            }
+            catch {
+                // resolve may fail if not yet loaded — that's fine, just load fresh
+            }
+            mod = req(entrypointPath);
+        }
+        else {
+            // For ESM (.mjs or .js with "type": "module"), append a timestamp query string
+            // to attempt cache-busting. Note: Node's ESM loader may not honour query strings
+            // in all versions — this is a best-effort approach. Plugins should avoid top-level
+            // mutable state if hot-reload correctness is required.
+            const importUrl = `${pathToFileURL(entrypointPath).href}?t=${Date.now()}`;
+            if (isHotReload) {
+                logger.warn(`Plugin "${manifest.name}" — ESM hot-reload uses query-string cache busting, which may ` +
+                    `not be fully reliable in all Node versions. Avoid top-level mutable state for correct hot-reload behaviour.`);
+            }
+            mod = await import(importUrl);
+        }
+    }
+    catch (err) {
+        logger.warn(`Plugin "${manifest.name}" — failed to import ${entrypointPath}: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    // Accept either default export or named `register` export
+    const registerFn = mod.register ??
+        mod.default;
+    if (typeof registerFn !== "function") {
+        logger.warn(`Plugin "${manifest.name}" — entrypoint must export a "register" function (or default export)`);
+        return null;
+    }
+    // 6. Build context
+    const safeConfig = {
+        workspace: config.workspace,
+        workspaceFolders: config.workspaceFolders,
+        commandTimeout: config.commandTimeout,
+        maxResultSize: config.maxResultSize,
+    };
+    const pluginLogger = {
+        info: (msg, data) => logger.info(`[plugin:${manifest.name}] ${msg}`, data),
+        warn: (msg, data) => logger.warn(`[plugin:${manifest.name}] ${msg}`, data),
+        error: (msg, data) => logger.error(`[plugin:${manifest.name}] ${msg}`, data),
+        debug: (msg, data) => logger.debug(`[plugin:${manifest.name}] ${msg}`, data),
+    };
+    const context = {
+        workspace: config.workspace,
+        workspaceFolders: config.workspaceFolders,
+        config: safeConfig,
+        logger: pluginLogger,
+    };
+    // 7. Call register()
+    let registration;
+    try {
+        registration = await registerFn(context);
+    }
+    catch (err) {
+        logger.warn(`Plugin "${manifest.name}" — register() threw: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    if (typeof registration !== "object" ||
+        registration === null ||
+        !Array.isArray(registration.tools)) {
+        logger.warn(`Plugin "${manifest.name}" — register() must return { tools: [...] }`);
+        return null;
+    }
+    if (registration.tools.length === 0) {
+        logger.warn(`Plugin "${manifest.name}" — registered 0 tools`);
+        return { spec, pluginDir, manifest, tools: [] };
+    }
+    if (registration.tools.length > MAX_TOOLS_PER_PLUGIN) {
+        logger.warn(`Plugin "${manifest.name}" — too many tools (${registration.tools.length} > ${MAX_TOOLS_PER_PLUGIN}); skipping plugin`);
+        return null;
+    }
+    // 8. Validate tool names against prefix and collision
+    const pluginToolNames = [];
+    for (const t of registration.tools) {
+        const name = t.schema?.name;
+        if (typeof name !== "string" || !/^[a-zA-Z0-9_]+$/.test(name)) {
+            logger.warn(`Plugin "${manifest.name}" — tool has invalid name "${String(name)}"; rejecting plugin`);
+            return null;
+        }
+        if (!name.startsWith(manifest.toolNamePrefix)) {
+            logger.warn(`Plugin "${manifest.name}" — tool "${name}" does not start with declared prefix "${manifest.toolNamePrefix}"; rejecting plugin`);
+            return null;
+        }
+        if (existingNames.has(name) || pluginToolNames.includes(name)) {
+            logger.warn(`Plugin "${manifest.name}" — tool name "${name}" collides with an already-registered tool; rejecting plugin`);
+            return null;
+        }
+        pluginToolNames.push(name);
+    }
+    // 9. Build final tool list
+    const tools = registration.tools.map((t) => ({
+        schema: t.schema,
+        handler: t.handler,
+        timeoutMs: t.timeoutMs,
+    }));
+    logger.info(`Plugin "${manifest.name}" — ${tools.length} tool${tools.length === 1 ? "" : "s"} registered: ${tools.map((t) => t.schema.name).join(", ")}`);
+    // Update existingNames synchronously before returning so the next plugin
+    // sees these names as already registered during its collision check.
+    for (const t of tools)
+        existingNames.add(t.schema.name);
+    return { spec, pluginDir, manifest, tools };
+}
+//# sourceMappingURL=pluginLoader.js.map

package/dist/pluginLoader.js.map

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

package/dist/pluginWatcher.d.ts

@@ -0,0 +1,24 @@
+import type { Config } from "./config.js";
+import type { Logger } from "./logger.js";
+import { type LoadedPlugin, type LoadedPluginTool } from "./pluginLoader.js";
+import type { McpTransport } from "./transport.js";
+export declare class PluginWatcher {
+    private config;
+    private logger;
+    private sendListChanged;
+    private watchers;
+    private debounceTimers;
+    private loadedPlugins;
+    private transports;
+    private stopped;
+    private reloadInFlight;
+    constructor(config: Config, logger: Logger, sendListChanged: () => void);
+    start(plugins: LoadedPlugin[]): void;
+    addTransport(transport: McpTransport): void;
+    removeTransport(transport: McpTransport): void;
+    getTools(): LoadedPluginTool[];
+    stop(): void;
+    private scheduleReload;
+    reloadPlugin(spec: string): Promise<void>;
+    private _reloadPluginInner;
+}

package/dist/pluginWatcher.js

@@ -0,0 +1,139 @@
+import fs from "node:fs";
+import { loadOnePluginFull, } from "./pluginLoader.js";
+const DEBOUNCE_MS = 300;
+export class PluginWatcher {
+    config;
+    logger;
+    sendListChanged;
+    watchers = new Map();
+    debounceTimers = new Map();
+    loadedPlugins = new Map(); // keyed by spec
+    transports = new Set();
+    stopped = false;
+    reloadInFlight = new Set();
+    constructor(config, logger, sendListChanged) {
+        this.config = config;
+        this.logger = logger;
+        this.sendListChanged = sendListChanged;
+    }
+    start(plugins) {
+        for (const plugin of plugins) {
+            this.loadedPlugins.set(plugin.spec, plugin);
+            try {
+                const watcher = fs.watch(plugin.pluginDir, { recursive: false }, (_event, _filename) => {
+                    this.scheduleReload(plugin.spec);
+                });
+                this.watchers.set(plugin.spec, watcher);
+            }
+            catch (err) {
+                this.logger.warn(`[plugin-watch] Could not watch "${plugin.pluginDir}": ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    addTransport(transport) {
+        this.transports.add(transport);
+    }
+    removeTransport(transport) {
+        this.transports.delete(transport);
+    }
+    getTools() {
+        return [...this.loadedPlugins.values()].flatMap((p) => p.tools);
+    }
+    stop() {
+        this.stopped = true;
+        for (const timer of this.debounceTimers.values())
+            clearTimeout(timer);
+        this.debounceTimers.clear();
+        for (const watcher of this.watchers.values()) {
+            try {
+                watcher.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.watchers.clear();
+    }
+    scheduleReload(spec) {
+        if (this.stopped)
+            return;
+        const existing = this.debounceTimers.get(spec);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(spec);
+            void this.reloadPlugin(spec);
+        }, DEBOUNCE_MS);
+        this.debounceTimers.set(spec, timer);
+    }
+    async reloadPlugin(spec) {
+        if (this.reloadInFlight.has(spec)) {
+            // Another reload is already running; schedule one more after it finishes
+            this.scheduleReload(spec);
+            return;
+        }
+        this.reloadInFlight.add(spec);
+        try {
+            await this._reloadPluginInner(spec);
+        }
+        finally {
+            this.reloadInFlight.delete(spec);
+        }
+    }
+    async _reloadPluginInner(spec) {
+        const old = this.loadedPlugins.get(spec);
+        if (!old)
+            return;
+        this.logger.info(`[plugin-watch] Reloading plugin "${old.manifest.name}" ...`);
+        // Collision names = all names from OTHER plugins
+        const otherNames = new Set();
+        for (const [s, p] of this.loadedPlugins) {
+            if (s !== spec) {
+                for (const t of p.tools)
+                    otherNames.add(t.schema.name);
+            }
+        }
+        let fresh;
+        try {
+            fresh = await loadOnePluginFull(spec, this.config, this.logger, otherNames, true);
+        }
+        catch (err) {
+            this.logger.warn(`[plugin-watch] Reload threw for "${old.manifest.name}": ${err instanceof Error ? err.message : String(err)}; keeping old tools`);
+            return;
+        }
+        if (!fresh) {
+            this.logger.warn(`[plugin-watch] Reload failed for "${old.manifest.name}"; keeping old tools`);
+            return;
+        }
+        // Apply to all active transports
+        for (const transport of this.transports) {
+            try {
+                transport.deregisterToolsByPrefix(old.manifest.toolNamePrefix);
+                for (const t of fresh.tools) {
+                    transport.replaceTool(t.schema, t.handler, t.timeoutMs);
+                }
+            }
+            catch (err) {
+                this.logger.warn(`[plugin-watch] Failed to patch transport for "${fresh.manifest.name}": ${err instanceof Error ? err.message : String(err)}; attempting rollback`);
+                // Rollback: remove any partially-registered tools and restore old ones.
+                // Uses old prefix — if the plugin renamed its prefix between reloads the
+                // orphaned fresh-prefix tools will remain until the next successful reload.
+                // Prefix renames are uncommon and self-heal on the next save.
+                try {
+                    transport.deregisterToolsByPrefix(old.manifest.toolNamePrefix);
+                    for (const t of old.tools) {
+                        transport.replaceTool(t.schema, t.handler, t.timeoutMs);
+                    }
+                }
+                catch {
+                    this.logger.warn(`[plugin-watch] Rollback also failed for "${old.manifest.name}"`);
+                }
+            }
+        }
+        this.loadedPlugins.set(spec, fresh);
+        const names = fresh.tools.map((t) => t.schema.name).join(", ");
+        this.logger.info(`[plugin-watch] Plugin "${fresh.manifest.name}" reloaded — ${fresh.tools.length} tool(s)${names ? `: ${names}` : ""}`);
+        this.sendListChanged();
+    }
+}
+//# sourceMappingURL=pluginWatcher.js.map

package/dist/pluginWatcher.js.map

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

package/dist/preToolUseHook.d.ts

@@ -0,0 +1,10 @@
+export interface RegisterResult {
+    action: "added" | "already-wired" | "error";
+    path: string;
+    hookCommand: string;
+    error?: string;
+}
+export declare function resolveHookScriptPath(baseDir?: string): string;
+export declare function registerPreToolUseHook(ccSettingsPath: string, opts?: {
+    hookScriptPath?: string;
+}): RegisterResult;

package/dist/preToolUseHook.js

@@ -0,0 +1,57 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const HOOK_EVENT = "PreToolUse";
+const HOOK_MARKER = "patchwork-approval-hook";
+export function resolveHookScriptPath(baseDir) {
+    // When called from dist/, src/ lives one directory up in a dev checkout
+    // or two directories up in an npm install (node_modules/patchwork-os/…).
+    // Resolving relative to this file's URL handles both.
+    const here = baseDir ?? path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "scripts", "patchwork-approval-hook.sh");
+}
+export function registerPreToolUseHook(ccSettingsPath, opts = {}) {
+    const hookScriptPath = opts.hookScriptPath ?? resolveHookScriptPath();
+    const hookCommand = `bash ${quoteIfNeeded(hookScriptPath)}`;
+    try {
+        let ccSettings = {};
+        if (existsSync(ccSettingsPath)) {
+            ccSettings = JSON.parse(readFileSync(ccSettingsPath, "utf-8"));
+        }
+        const allHooks = (ccSettings.hooks ?? {});
+        const entries = (allHooks[HOOK_EVENT] ?? []).map(normalize);
+        const alreadyWired = entries.some((entry) => (entry.hooks ?? []).some((h) => typeof h.command === "string" && h.command.includes(HOOK_MARKER)));
+        if (alreadyWired) {
+            return { action: "already-wired", path: ccSettingsPath, hookCommand };
+        }
+        entries.push({
+            matcher: "*",
+            hooks: [{ type: "command", command: hookCommand }],
+        });
+        allHooks[HOOK_EVENT] = entries;
+        ccSettings.hooks = allHooks;
+        writeFileSync(ccSettingsPath, `${JSON.stringify(ccSettings, null, 2)}\n`);
+        return { action: "added", path: ccSettingsPath, hookCommand };
+    }
+    catch (err) {
+        return {
+            action: "error",
+            path: ccSettingsPath,
+            hookCommand,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+function normalize(e) {
+    if (e && Array.isArray(e.hooks)) {
+        return {
+            matcher: e.matcher ?? "",
+            hooks: e.hooks ?? [],
+        };
+    }
+    return { matcher: "", hooks: [e] };
+}
+function quoteIfNeeded(p) {
+    return /[\s"']/.test(p) ? `"${p.replace(/"/g, '\\"')}"` : p;
+}
+//# sourceMappingURL=preToolUseHook.js.map

package/dist/preToolUseHook.js.map

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