@ashlr/hub 2.2.0

package/dist/core/index-engine.js

@@ -0,0 +1,486 @@
+/**
+ * index-engine.ts
+ *
+ * Scans cfg.roots, builds an AshlrIndex of fully-populated IndexedItems,
+ * and persists / loads the index from ~/.ashlr/index.json.
+ *
+ * Walk strategy
+ * ─────────────
+ * Each entry in cfg.roots is one of:
+ *   A) A github/<category> parent  – walk category → repo (depth ≤ 3).
+ *   B) A Desktop root              – index top-level folders + notable loose
+ *      files; do NOT descend into a dir already covered by a github root,
+ *      and do NOT descend into node_modules / .git / dist.
+ *
+ * Symlinks are detected with lstat. They are indexed once as kind:'symlink'
+ * and are never followed for further repo discovery (avoids double-counting).
+ *
+ * One bad directory must never crash the whole walk – every stat/readdir call
+ * is wrapped in a try/catch and failures are silently skipped.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { INDEX_PATH, CONFIG_DIR } from './config.js';
+import { categoryOf, describe, primaryLanguage, kindOf } from './classify.js';
+import { isRepo, getGitStatus, getRemoteOrg } from './git.js';
+// ─── constants ────────────────────────────────────────────────────────────────
+/** Index format version – bump when the shape changes. */
+const INDEX_VERSION = 1;
+/** Directory names to never descend into during any walk. */
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', '.next', '.turbo', 'coverage', '__pycache__']);
+/**
+ * Returns true for any Desktop top-level entry whose name starts with "."
+ * (hidden OS artefacts and tool-state dirs: .DS_Store, .vscode, .cursor,
+ * .claude, .ashlrcode, .downloads, .reorg-*, …).  Skipping these prevents
+ * them from inflating the "(uncategorized)" bucket in `ashlr index`.
+ */
+function isDesktopDotfile(name) {
+    return name.startsWith('.');
+}
+// ─── helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Derive a stable, filesystem-friendly ID from an absolute path.
+ * Replace non-alphanumeric characters (except `-`) with `-` and
+ * collapse runs; strip leading/trailing `-`.
+ */
+function pathToId(absPath) {
+    return absPath
+        .replace(/^\//, '')
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+/** Safe lstat — returns null on any error. */
+function safeLstat(p) {
+    try {
+        return fs.lstatSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+/** Safe stat (follows symlinks) — returns null on any error. */
+function safeStat(p) {
+    try {
+        return fs.statSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+/** Safe readdir with file types — returns [] on any error. */
+function safeReaddir(dir) {
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+/** Safe readlink — returns null on any error. */
+function safeReadlink(p) {
+    try {
+        return fs.readlinkSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Determine whether an item is "active" based on its last-modified ISO string
+ * and the configured staleDays threshold.
+ */
+function computeActive(lastModified, staleDays) {
+    const ms = Date.parse(lastModified);
+    if (Number.isNaN(ms))
+        return false;
+    return Date.now() - ms <= staleDays * 86_400_000;
+}
+/**
+ * Build a fully-populated IndexedItem for a single path.
+ *
+ * @param absPath   Absolute path to the filesystem entry.
+ * @param cfg       Current hub config.
+ * @param forcedKind  When the caller has already determined the kind (e.g.
+ *                    symlinks detected before kindOf runs), pass it here.
+ */
+function buildItem(absPath, cfg, forcedKind) {
+    const lstat = safeLstat(absPath);
+    if (!lstat)
+        return null;
+    const isSymlink = lstat.isSymbolicLink();
+    const kind = forcedKind ?? kindOf(absPath);
+    // For the modification timestamp prefer the real target's mtime for
+    // symlinks so we don't always show the link creation time.
+    const statForTime = isSymlink ? (safeStat(absPath) ?? lstat) : lstat;
+    let lastModified = statForTime.mtime.toISOString();
+    // Link target (for symlinks)
+    const linkTarget = isSymlink
+        ? (safeReadlink(absPath) ?? undefined)
+        : undefined;
+    // Git metadata (repos only)
+    let gitStatus = undefined;
+    let remote = null;
+    let org = null;
+    if (kind === 'repo') {
+        try {
+            gitStatus = getGitStatus(absPath) ?? undefined;
+            const remoteOrg = getRemoteOrg(absPath);
+            remote = remoteOrg.remote;
+            org = remoteOrg.org;
+            // Prefer git's last-commit timestamp over mtime when available.
+            if (gitStatus?.lastCommit) {
+                lastModified = gitStatus.lastCommit;
+            }
+        }
+        catch {
+            // git unavailable or not a real repo — continue without git info
+        }
+    }
+    const active = computeActive(lastModified, cfg.staleDays);
+    const item = {
+        id: pathToId(absPath),
+        name: path.basename(absPath),
+        path: absPath,
+        kind,
+        category: categoryOf(absPath),
+        description: describe(absPath),
+        org,
+        remote,
+        language: kind === 'repo' ? primaryLanguage(absPath) : null,
+        lastModified,
+        active,
+        sizeBytes: lstat.isFile() ? lstat.size : undefined,
+        ...(gitStatus !== undefined ? { git: gitStatus } : {}),
+        ...(linkTarget !== undefined ? { linkTarget } : {}),
+    };
+    return item;
+}
+// ─── github walk ─────────────────────────────────────────────────────────────
+/**
+ * Walk a single github/<category> root.
+ *
+ * Layout expected:
+ *   <categoryRoot>/
+ *     <repo>/          ← depth 1 repo
+ *     <monorepo>/
+ *       <nested-repo>/ ← depth 2 repo (e.g. artist-encyclopedias/factory)
+ *
+ * Symlinks at any depth are recorded as kind:'symlink' and NOT descended.
+ */
+function walkGithubCategory(categoryRoot, cfg, seenPaths, tryCachedRepo = () => null) {
+    const items = [];
+    for (const dirent of safeReaddir(categoryRoot)) {
+        const absPath = path.join(categoryRoot, dirent.name);
+        // Canonical/resolved path used for dedup (handles cases where two roots
+        // resolve to the same underlying directory).
+        let realPath;
+        try {
+            realPath = fs.realpathSync(absPath);
+        }
+        catch {
+            realPath = absPath;
+        }
+        if (seenPaths.has(realPath))
+            continue;
+        const lstat = safeLstat(absPath);
+        if (!lstat)
+            continue;
+        // ── Symlink ──
+        if (lstat.isSymbolicLink()) {
+            seenPaths.add(realPath);
+            const item = buildItem(absPath, cfg, 'symlink');
+            if (item)
+                items.push(item);
+            continue; // never follow symlinks for repo discovery
+        }
+        if (!lstat.isDirectory())
+            continue;
+        // ── Check depth-1 repo ──
+        if (isRepo(absPath)) {
+            seenPaths.add(realPath);
+            const item = tryCachedRepo(absPath) ?? buildItem(absPath, cfg, 'repo');
+            if (item)
+                items.push(item);
+            continue;
+        }
+        // ── Not a repo at depth-1: check for nested repos (depth 2) ──
+        // This handles monorepos like artist-encyclopedias/artist-encyclopedia-factory.
+        let foundNested = false;
+        for (const nested of safeReaddir(absPath)) {
+            if (SKIP_DIRS.has(nested.name))
+                continue;
+            const nestedPath = path.join(absPath, nested.name);
+            let nestedReal;
+            try {
+                nestedReal = fs.realpathSync(nestedPath);
+            }
+            catch {
+                nestedReal = nestedPath;
+            }
+            if (seenPaths.has(nestedReal))
+                continue;
+            const nestedLstat = safeLstat(nestedPath);
+            if (!nestedLstat)
+                continue;
+            if (nestedLstat.isSymbolicLink()) {
+                seenPaths.add(nestedReal);
+                const item = buildItem(nestedPath, cfg, 'symlink');
+                if (item)
+                    items.push(item);
+                foundNested = true;
+                continue;
+            }
+            if (!nestedLstat.isDirectory())
+                continue;
+            if (isRepo(nestedPath)) {
+                seenPaths.add(nestedReal);
+                foundNested = true;
+                const item = tryCachedRepo(nestedPath) ?? buildItem(nestedPath, cfg, 'repo');
+                if (item)
+                    items.push(item);
+            }
+        }
+        // If we found nested repos, also index the parent dir as a doc-folder
+        // (it's a grouping container, not a repo itself).
+        if (foundNested) {
+            seenPaths.add(realPath);
+            const parentItem = buildItem(absPath, cfg, 'doc-folder');
+            if (parentItem)
+                items.push(parentItem);
+        }
+    }
+    return items;
+}
+// ─── Desktop root walk ───────────────────────────────────────────────────────
+/**
+ * Index the top-level entries of a Desktop root directory.
+ *
+ * Rules:
+ * - Skip anything already in seenPaths (already covered by github walk).
+ * - Skip SKIP_DIRS basenames.
+ * - Symlinks → kind:'symlink', do not follow.
+ * - Directories that are git repos → kind:'repo' (record but don't double-count).
+ * - Everything else → classify normally (doc-folder, doc, asset, other).
+ * - Do NOT recurse — only top-level entries.
+ *
+ * The github/ subdirectory itself is covered by the github walk; skip it here.
+ */
+function walkDesktopRoot(root, cfg, seenPaths, tryCachedRepo = () => null) {
+    const items = [];
+    for (const dirent of safeReaddir(root)) {
+        if (SKIP_DIRS.has(dirent.name))
+            continue;
+        // Skip dotfiles / hidden entries at the Desktop top-level (.DS_Store,
+        // .vscode, .claude, .ashlrcode, .downloads, .reorg-*, …).
+        if (isDesktopDotfile(dirent.name))
+            continue;
+        const absPath = path.join(root, dirent.name);
+        const lstat = safeLstat(absPath);
+        if (!lstat)
+            continue;
+        // ── Symlink ──
+        // Check symlinks BEFORE the realpath-based seenPaths guard. A top-level
+        // symlink (e.g. 'tts agents' -> github/side-projects/precious-grove)
+        // resolves to a repo path the github walk already added to seenPaths; if
+        // we deduped on the resolved realpath we'd drop the link entirely. Dedup
+        // symlinks by their OWN path so they are still emitted as kind:'symlink'.
+        if (lstat.isSymbolicLink()) {
+            if (seenPaths.has(absPath))
+                continue;
+            seenPaths.add(absPath);
+            const item = buildItem(absPath, cfg, 'symlink');
+            if (item)
+                items.push(item);
+            continue;
+        }
+        // Non-symlink: dedup by resolved realpath so a dir already covered by the
+        // github walk is not re-indexed.
+        let realPath;
+        try {
+            realPath = fs.realpathSync(absPath);
+        }
+        catch {
+            realPath = absPath;
+        }
+        if (seenPaths.has(realPath))
+            continue;
+        // ── Directory ──
+        if (lstat.isDirectory()) {
+            // Skip the github directory — it's covered by the dedicated github walk.
+            if (dirent.name === 'github') {
+                seenPaths.add(realPath);
+                continue;
+            }
+            seenPaths.add(realPath);
+            // Repos found at desktop top-level (unusual but possible).
+            const kind = isRepo(absPath) ? 'repo' : kindOf(absPath);
+            const item = (kind === 'repo' ? tryCachedRepo(absPath) : null) ??
+                buildItem(absPath, cfg, kind);
+            if (item)
+                items.push(item);
+            continue;
+        }
+        // ── Regular file ──
+        if (lstat.isFile()) {
+            seenPaths.add(realPath);
+            const item = buildItem(absPath, cfg, kindOf(absPath));
+            if (item)
+                items.push(item);
+        }
+    }
+    return items;
+}
+/**
+ * Build a fresh (or incrementally updated) AshlrIndex by scanning all cfg.roots.
+ *
+ * Walk order:
+ *  1. Treat each root that ends in `/github/<category>` as a github category root.
+ *  2. Treat every remaining root as a "desktop" root (top-level only).
+ *  3. Track seenPaths (via realpath) across all roots to avoid double-counting.
+ *
+ * Incremental mode (opts.previousIndex present):
+ *  For repos already in the previous index, compare the directory's current
+ *  mtime against `previousIndex.generatedAt`.  If the mtime is older (i.e.
+ *  the directory has not been touched since the last index was built), reuse
+ *  the prior IndexedItem directly — no stat/readdir/git calls needed.
+ *  Any repo whose mtime is >= generatedAt (or that is new) is rebuilt normally.
+ */
+export function buildIndex(cfg, opts = {}) {
+    const seenPaths = new Set();
+    const allItems = [];
+    // ── Incremental cache ────────────────────────────────────────────────────
+    // Build a path→IndexedItem lookup from the previous index.  Only used when
+    // previousIndex is supplied; otherwise the Map stays empty and every item
+    // is built from scratch (full rebuild).
+    const prevByPath = new Map();
+    const prevGeneratedMs = opts.previousIndex
+        ? Date.parse(opts.previousIndex.generatedAt)
+        : NaN;
+    if (opts.previousIndex && !Number.isNaN(prevGeneratedMs)) {
+        for (const item of opts.previousIndex.items) {
+            prevByPath.set(item.path, item);
+        }
+    }
+    /**
+     * Try to reuse a cached item for `absPath` (repos only).
+     *
+     * Returns the cached IndexedItem when:
+     *   - the previousIndex was provided,
+     *   - the item exists in the cache,
+     *   - the item's kind is 'repo', AND
+     *   - the directory's mtime < prevGeneratedMs  (unchanged since last index).
+     *
+     * Returns null in all other cases, signalling that the item must be rebuilt.
+     */
+    function tryCachedRepo(absPath) {
+        if (prevByPath.size === 0)
+            return null;
+        const cached = prevByPath.get(absPath);
+        if (!cached || cached.kind !== 'repo')
+            return null;
+        const lstat = safeLstat(absPath);
+        if (!lstat)
+            return null;
+        // mtime < prevGeneratedMs  ⟹  directory unchanged since last build.
+        if (lstat.mtimeMs < prevGeneratedMs)
+            return cached;
+        return null;
+    }
+    // Partition roots into github-category roots vs desktop roots.
+    // A github-category root is any directory whose parent is named "github"
+    // OR that matches one of the category paths in cfg.categories.
+    const categoryPaths = new Set(Object.values(cfg.categories).map((p) => path.normalize(p)));
+    const githubRoots = [];
+    const desktopRoots = [];
+    for (const root of cfg.roots) {
+        const normalized = path.normalize(root);
+        const parentName = path.basename(path.dirname(normalized));
+        const baseName = path.basename(normalized);
+        if (categoryPaths.has(normalized) || parentName === 'github') {
+            // A category root itself (e.g. .../github/dev-tools).
+            githubRoots.push(root);
+        }
+        else if (baseName === 'github') {
+            // The github/ container root: each child directory is a category root
+            // (dev-tools, side-projects, …). Expand it into per-category github roots
+            // so walkGithubCategory descends to the actual repos.
+            for (const dirent of safeReaddir(normalized)) {
+                if (SKIP_DIRS.has(dirent.name))
+                    continue;
+                const categoryRoot = path.join(normalized, dirent.name);
+                const lstat = safeLstat(categoryRoot);
+                if (!lstat)
+                    continue;
+                // Don't follow symlinked category dirs; only real directories hold repos.
+                if (lstat.isDirectory() && !lstat.isSymbolicLink()) {
+                    githubRoots.push(categoryRoot);
+                }
+            }
+        }
+        else {
+            desktopRoots.push(root);
+        }
+    }
+    // Walk github category roots first so their realpath entries are in seenPaths
+    // before the desktop walk processes symlinks that point into github/.
+    for (const root of githubRoots) {
+        try {
+            const items = walkGithubCategory(root, cfg, seenPaths, tryCachedRepo);
+            allItems.push(...items);
+        }
+        catch {
+            // One bad root must not crash everything.
+        }
+    }
+    // Walk desktop roots (top-level only).
+    for (const root of desktopRoots) {
+        try {
+            const items = walkDesktopRoot(root, cfg, seenPaths, tryCachedRepo);
+            allItems.push(...items);
+        }
+        catch {
+            // One bad root must not crash everything.
+        }
+    }
+    // Primary root for the index metadata: first desktop root, falling back to
+    // the first root overall.
+    const primaryRoot = desktopRoots[0] ?? cfg.roots[0] ?? '';
+    return {
+        version: INDEX_VERSION,
+        generatedAt: new Date().toISOString(),
+        root: primaryRoot,
+        items: allItems,
+    };
+}
+/**
+ * Load the index from INDEX_PATH.
+ * Returns null if the file is absent, unreadable, or not valid JSON.
+ */
+export function loadIndex() {
+    try {
+        const raw = fs.readFileSync(INDEX_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        // Minimal shape validation: must have version + items array.
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            !('version' in parsed) ||
+            !('items' in parsed) ||
+            !Array.isArray(parsed.items)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist the index to INDEX_PATH as pretty-printed JSON.
+ * Creates CONFIG_DIR if it does not exist.
+ */
+export function writeIndex(index) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(INDEX_PATH, JSON.stringify(index, null, 2), 'utf8');
+}
+//# sourceMappingURL=index-engine.js.map

package/dist/core/index-engine.js.map

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

package/dist/core/integrations/desktop-notify.d.ts

@@ -0,0 +1,18 @@
+/**
+ * M32: desktop notifications — macOS only, opt-in, metadata only.
+ *
+ * Strict no-op unless BOTH hold: process.platform === 'darwin' AND
+ * cfg.notify.desktop === true (opt-in mirrors the webhook contract — when
+ * unset, nothing fires). Uses `osascript` via execFile (never a shell), with
+ * title/body escaped into the AppleScript string literal, a 2s timeout, and a
+ * never-throws contract.
+ */
+import type { AshlrConfig } from '../types.js';
+/** True when desktop notifications are enabled by config + platform. */
+export declare function desktopNotifyEnabled(cfg: AshlrConfig): boolean;
+/**
+ * Show a desktop notification. Resolves true when osascript ran successfully,
+ * false otherwise (disabled / non-darwin / missing osascript / timeout).
+ * NEVER throws; NEVER blocks beyond the timeout.
+ */
+export declare function desktopNotify(title: string, body: string, cfg: AshlrConfig): Promise<boolean>;

package/dist/core/integrations/desktop-notify.js

@@ -0,0 +1,42 @@
+/**
+ * M32: desktop notifications — macOS only, opt-in, metadata only.
+ *
+ * Strict no-op unless BOTH hold: process.platform === 'darwin' AND
+ * cfg.notify.desktop === true (opt-in mirrors the webhook contract — when
+ * unset, nothing fires). Uses `osascript` via execFile (never a shell), with
+ * title/body escaped into the AppleScript string literal, a 2s timeout, and a
+ * never-throws contract.
+ */
+import { execFile } from 'node:child_process';
+const OSASCRIPT_TIMEOUT_MS = 2_000;
+/** Escape a string for inclusion inside an AppleScript double-quoted literal. */
+function escapeAppleScript(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, ' ');
+}
+/** True when desktop notifications are enabled by config + platform. */
+export function desktopNotifyEnabled(cfg) {
+    if (process.platform !== 'darwin')
+        return false;
+    const notify = cfg.notify;
+    return notify?.desktop === true;
+}
+/**
+ * Show a desktop notification. Resolves true when osascript ran successfully,
+ * false otherwise (disabled / non-darwin / missing osascript / timeout).
+ * NEVER throws; NEVER blocks beyond the timeout.
+ */
+export function desktopNotify(title, body, cfg) {
+    if (!desktopNotifyEnabled(cfg))
+        return Promise.resolve(false);
+    const script = `display notification "${escapeAppleScript(body)}" ` +
+        `with title "${escapeAppleScript(title)}"`;
+    return new Promise((resolve) => {
+        try {
+            execFile('osascript', ['-e', script], { timeout: OSASCRIPT_TIMEOUT_MS }, (err) => resolve(!err));
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+//# sourceMappingURL=desktop-notify.js.map

package/dist/core/integrations/desktop-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-notify.js","sourceRoot":"","sources":["../../../src/core/integrations/desktop-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,iFAAiF;AACjF,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,GAAgB;IACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,MAAM,GAAI,GAA+C,CAAC,MAAM,CAAC;IACvE,OAAO,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY,EAAE,GAAgB;IACzE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE9D,MAAM,MAAM,GACV,yBAAyB,iBAAiB,CAAC,IAAI,CAAC,IAAI;QACpD,eAAe,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC;IAE7C,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,QAAQ,CACN,WAAW,EACX,CAAC,IAAI,EAAE,MAAM,CAAC,EACd,EAAE,OAAO,EAAE,oBAAoB,EAAE,EACjC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CACvB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/integrations/editors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * core/integrations/editors.ts — Editor MCP gateway wiring (M18).
+ *
+ * detectEditors(): detect which of claude / codex / cursor are present by
+ *   their config directories or files.
+ *
+ * wireEditor(target, opts): wire the ashlr MCP gateway entry into one editor's
+ *   mcpServers config, reusing the M3 install pattern (backup-first, deep-merge,
+ *   idempotent, never clobbers existing servers). LOCAL only. `opts.configPath`
+ *   overrides the default path so tests can run against TEMP files.
+ *
+ * SAFETY RULES (matching M3 contract):
+ *   - Parse the config file FIRST; abort without writing on malformed JSON.
+ *   - Backup (.bak) ONLY after a clean parse.
+ *   - Idempotent: re-running when the entry is already present is a no-op.
+ *   - Never clobber other mcpServers entries or other top-level config keys.
+ *   - Never throws — all errors are caught and returned as {ok:false, detail}.
+ *   - LOCAL only: writes only the target editor's config file.
+ *
+ * Genome note: ~/.ashlr already serves as the genome store; no extra wiring
+ * is needed here — the mcpServers entry is sufficient for the gateway.
+ */
+/**
+ * Detect which editors are installed on this machine by checking for the
+ * presence of their primary config directory or config file.
+ *
+ * Returns a subset of ['claude', 'codex', 'cursor'].
+ * Never throws.
+ */
+export declare function detectEditors(): string[];
+/**
+ * Wire the ashlr MCP gateway into one editor's mcpServers config.
+ *
+ * Follows the M3 install pattern exactly:
+ *   1. Parse FIRST — abort without any write if config is malformed JSON.
+ *   2. Backup (.bak) after a clean parse, only if the file exists.
+ *   3. Idempotency — if the "ashlr" entry already matches, return ok without writing.
+ *   4. Deep-merge — spread existing config + mcpServers, add/update only "ashlr".
+ *   5. Write the merged result as pretty-printed JSON.
+ *
+ * @param target    - Editor to wire: 'claude' | 'codex' | 'cursor'
+ * @param opts.configPath - Override the default config path (use a TEMP path in tests).
+ * @returns { ok: boolean; detail: string } — never throws.
+ */
+export declare function wireEditor(target: 'claude' | 'codex' | 'cursor', opts: {
+    configPath?: string;
+}): Promise<{
+    ok: boolean;
+    detail: string;
+}>;