cgraphx 1.4.3 → 2.0.0

package/dist/directory.d.ts

@@ -1,147 +0,0 @@
-/**
- * Directory Management
- *
- * Manages the .cgraphx/ directory structure for CodeGraph data.
- */
-/**
- * Resolve the per-project data directory name, honoring the `CGRAPHX_DIR`
- * environment override (default `.cgraphx`). The override is a single path
- * segment that lives in the project root.
- *
- * Why this exists: two environments that share one working tree must NOT share
- * one `.cgraphx/` — most concretely Windows-native and WSL (issue #636). The
- * daemon lockfile (`.cgraphx/daemon.pid`) records a platform-specific pid and
- * socket path (a Windows named pipe vs a WSL Unix socket), and SQLite file
- * locking across the WSL2 ↔ Windows filesystem boundary is unreliable, so two
- * daemons sharing one index risks corruption. Setting `CGRAPHX_DIR=.cgraphx-win`
- * on one side gives each environment its own index in the same tree.
- *
- * Read live (not captured at load) so it is both process-accurate and testable.
- * An override that isn't a plain directory name — empty, containing a path
- * separator, `.`, `..`/traversal, or absolute — is ignored (we keep the
- * default) rather than risk writing the index outside the project or into the
- * project root itself; we warn once to stderr so the misconfiguration is seen.
- */
-export declare function codeGraphDirName(): string;
-/**
- * CodeGraph directory name — a load-time snapshot of {@link codeGraphDirName}.
- * A running process's environment is fixed, so this equals the live value;
- * it's kept as a stable string export for backward compatibility. Internal code
- * resolves the name through {@link codeGraphDirName} / {@link getCodeGraphDir}
- * so the `CGRAPHX_DIR` override always applies.
- */
-export declare const CGRAPHX_DIR: string;
-/**
- * Is `name` (a single path segment) a CodeGraph data directory? Matches the
- * default `.cgraphx`, the active `CGRAPHX_DIR` override, and any
- * `.cgraphx-*` sibling. File-watching and the indexer skip ALL of these, so
- * when two environments share one working tree (Windows + WSL, issue #636)
- * neither indexes or watches the other's index directory.
- */
-export declare function isCodeGraphDataDir(name: string): boolean;
-/**
- * Get the .cgraphx directory path for a project
- */
-export declare function getCodeGraphDir(projectRoot: string): string;
-/**
- * Check if a project has been initialized with CodeGraph
- * Requires both .cgraphx/ directory AND cgraphx.db to exist
- */
-export declare function isInitialized(projectRoot: string): boolean;
-/**
- * Find the nearest parent directory containing .cgraphx/
- *
- * Walks up from the given path to find a CodeGraph-initialized project,
- * similar to how git finds .git/ directories.
- *
- * @param startPath - Directory to start searching from
- * @returns The project root containing .cgraphx/, or null if not found
- */
-/**
- * Reason a directory is unsafe to use as an index ROOT, or null when it's fine.
- *
- * Indexing your home directory or a filesystem root drags in caches, `Library`,
- * every other project, etc. — a multi-GB index, constant file-watcher churn, and
- * (pre-1.0 on macOS) a file-descriptor blowup that exhausted `kern.maxfiles` and
- * took unrelated apps / the whole machine down (#845). The classic trigger:
- * running the installer or `cgraphx init` from `$HOME`, which auto-indexes the
- * current directory. These are never intended project roots, so the installer
- * and `init`/`index` refuse them (overridable with `--force`).
- *
- * Pure-ish (reads only `os.homedir()` + realpath) so it's easy to unit-test.
- * The returned string is a human phrase that slots into "… looks like {reason}".
- */
-export declare function unsafeIndexRootReason(projectRoot: string): string | null;
-export declare function findNearestCodeGraphRoot(startPath: string): string | null;
-/**
- * Indexed sub-project roots beneath `root` (bounded breadth-first scan). For
- * the monorepo case behind #964: the index lives in a CHILD
- * (`packages/x/.cgraphx/`), not at the workspace root the agent's cwd points
- * at. Descent stops at the first indexed directory on a branch (a project's
- * own sub-dirs aren't separate projects) and is bounded by depth + count so it
- * never turns into a full-tree crawl on a large repo.
- */
-export declare function findIndexedSubprojectRoots(root: string, opts?: {
-    maxDepth?: number;
-    max?: number;
-}): string[];
-/**
- * What the front-load hook should do for a prompt issued from a directory.
- */
-export interface FrontloadPlan {
-    /** Open + explore this project and inject its source as context. `null` when
-     *  there's no single project to front-load (none indexed, or several indexed
-     *  sub-projects with no clear match — see {@link nudgeProjects}). */
-    exploreRoot: string | null;
-    /** Indexed sub-projects to surface in a "pass `projectPath`" nudge: the rest
-     *  of a monorepo's indexed projects alongside `exploreRoot`, or — when no one
-     *  project clearly matches — the full list (with `exploreRoot` null). */
-    nudgeProjects: string[];
-    /** True when the plan came from scanning DOWN into sub-projects (cwd itself
-     *  is not under any index) — the monorepo case, where a follow-up
-     *  `codegraph_explore` needs an explicit `projectPath`. */
-    viaSubScan: boolean;
-}
-/**
- * Decide what the front-load hook injects for a `prompt` issued from `cwd`,
- * shaped by where the `.cgraphx/` index(es) actually are:
- *   1. **cwd (or an ancestor) is indexed** → front-load that project. The
- *      normal single-project / nested-file case.
- *   2. **cwd isn't indexed but looks like a workspace root** → the indexes live
- *      in sub-projects (the monorepo case behind #964). One indexed
- *      sub-project → front-load it; several → front-load the one the prompt
- *      names (by relative path like `packages/api`, or package directory name)
- *      and nudge about the rest; several with no match → nudge the full list so
- *      the agent passes `projectPath`, rather than guessing wrong.
- *   3. **nothing indexed reachable** → do nothing (the agent's own tools apply).
- */
-export declare function planFrontload(cwd: string, prompt: string): FrontloadPlan;
-/**
- * Create the .cgraphx directory structure
- * Note: Only throws if cgraphx.db already exists, not just if .cgraphx/ exists.
- */
-export declare function createDirectory(projectRoot: string): void;
-/**
- * Remove the .cgraphx directory
- */
-export declare function removeDirectory(projectRoot: string): void;
-/**
- * Get all files in the .cgraphx directory
- */
-export declare function listDirectoryContents(projectRoot: string): string[];
-/**
- * Get the total size of the .cgraphx directory in bytes
- */
-export declare function getDirectorySize(projectRoot: string): number;
-/**
- * Ensure a subdirectory exists within .cgraphx
- */
-export declare function ensureSubdirectory(projectRoot: string, subdirName: string): string;
-/**
- * Check if the .cgraphx directory has valid structure
- */
-export declare function validateDirectory(projectRoot: string): {
-    valid: boolean;
-    errors: string[];
-};
-//# sourceMappingURL=directory.d.ts.map

package/dist/directory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAqBzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAqB,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;;;;;;;GAQG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BxE;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBzE;AA2BD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,MAAM,EAAE,CAmBV;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;yEAEqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;6EAEyE;IACzE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;+DAE2D;IAC3D,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAwCxE;AAyDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAgBzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAuBzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+B5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYlF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA6BA"}

package/dist/directory.js

@@ -1,523 +0,0 @@
-"use strict";
-/**
- * Directory Management
- *
- * Manages the .cgraphx/ directory structure for CodeGraph data.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CGRAPHX_DIR = void 0;
-exports.codeGraphDirName = codeGraphDirName;
-exports.isCodeGraphDataDir = isCodeGraphDataDir;
-exports.getCodeGraphDir = getCodeGraphDir;
-exports.isInitialized = isInitialized;
-exports.unsafeIndexRootReason = unsafeIndexRootReason;
-exports.findNearestCodeGraphRoot = findNearestCodeGraphRoot;
-exports.findIndexedSubprojectRoots = findIndexedSubprojectRoots;
-exports.planFrontload = planFrontload;
-exports.createDirectory = createDirectory;
-exports.removeDirectory = removeDirectory;
-exports.listDirectoryContents = listDirectoryContents;
-exports.getDirectorySize = getDirectorySize;
-exports.ensureSubdirectory = ensureSubdirectory;
-exports.validateDirectory = validateDirectory;
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-/** The default per-project data directory name. */
-const DEFAULT_CGRAPHX_DIR = '.cgraphx';
-let warnedBadDirName = false;
-/**
- * Resolve the per-project data directory name, honoring the `CGRAPHX_DIR`
- * environment override (default `.cgraphx`). The override is a single path
- * segment that lives in the project root.
- *
- * Why this exists: two environments that share one working tree must NOT share
- * one `.cgraphx/` — most concretely Windows-native and WSL (issue #636). The
- * daemon lockfile (`.cgraphx/daemon.pid`) records a platform-specific pid and
- * socket path (a Windows named pipe vs a WSL Unix socket), and SQLite file
- * locking across the WSL2 ↔ Windows filesystem boundary is unreliable, so two
- * daemons sharing one index risks corruption. Setting `CGRAPHX_DIR=.cgraphx-win`
- * on one side gives each environment its own index in the same tree.
- *
- * Read live (not captured at load) so it is both process-accurate and testable.
- * An override that isn't a plain directory name — empty, containing a path
- * separator, `.`, `..`/traversal, or absolute — is ignored (we keep the
- * default) rather than risk writing the index outside the project or into the
- * project root itself; we warn once to stderr so the misconfiguration is seen.
- */
-function codeGraphDirName() {
-    const raw = process.env.CGRAPHX_DIR?.trim();
-    if (!raw)
-        return DEFAULT_CGRAPHX_DIR;
-    const invalid = raw === '.' ||
-        raw.includes('..') ||
-        raw.includes('/') ||
-        raw.includes('\\') ||
-        path.isAbsolute(raw);
-    if (invalid) {
-        if (!warnedBadDirName) {
-            warnedBadDirName = true;
-            // stderr only — stdout is the MCP protocol channel.
-            console.warn(`[cgraphx] Ignoring invalid CGRAPHX_DIR="${raw}" — it must be a plain ` +
-                `directory name (no path separators, no "..", not absolute). Using "${DEFAULT_CGRAPHX_DIR}".`);
-        }
-        return DEFAULT_CGRAPHX_DIR;
-    }
-    return raw;
-}
-/**
- * CodeGraph directory name — a load-time snapshot of {@link codeGraphDirName}.
- * A running process's environment is fixed, so this equals the live value;
- * it's kept as a stable string export for backward compatibility. Internal code
- * resolves the name through {@link codeGraphDirName} / {@link getCodeGraphDir}
- * so the `CGRAPHX_DIR` override always applies.
- */
-exports.CGRAPHX_DIR = codeGraphDirName();
-/**
- * Is `name` (a single path segment) a CodeGraph data directory? Matches the
- * default `.cgraphx`, the active `CGRAPHX_DIR` override, and any
- * `.cgraphx-*` sibling. File-watching and the indexer skip ALL of these, so
- * when two environments share one working tree (Windows + WSL, issue #636)
- * neither indexes or watches the other's index directory.
- */
-function isCodeGraphDataDir(name) {
-    return (name === DEFAULT_CGRAPHX_DIR ||
-        name === codeGraphDirName() ||
-        name.startsWith(DEFAULT_CGRAPHX_DIR + '-'));
-}
-/**
- * Get the .cgraphx directory path for a project
- */
-function getCodeGraphDir(projectRoot) {
-    return path.join(projectRoot, codeGraphDirName());
-}
-/**
- * Check if a project has been initialized with CodeGraph
- * Requires both .cgraphx/ directory AND cgraphx.db to exist
- */
-function isInitialized(projectRoot) {
-    const codegraphDir = getCodeGraphDir(projectRoot);
-    if (!fs.existsSync(codegraphDir) || !fs.statSync(codegraphDir).isDirectory()) {
-        return false;
-    }
-    // Must have cgraphx.db, not just .cgraphx folder
-    const dbPath = path.join(codegraphDir, 'cgraphx.db');
-    return fs.existsSync(dbPath);
-}
-/**
- * Find the nearest parent directory containing .cgraphx/
- *
- * Walks up from the given path to find a CodeGraph-initialized project,
- * similar to how git finds .git/ directories.
- *
- * @param startPath - Directory to start searching from
- * @returns The project root containing .cgraphx/, or null if not found
- */
-/**
- * Reason a directory is unsafe to use as an index ROOT, or null when it's fine.
- *
- * Indexing your home directory or a filesystem root drags in caches, `Library`,
- * every other project, etc. — a multi-GB index, constant file-watcher churn, and
- * (pre-1.0 on macOS) a file-descriptor blowup that exhausted `kern.maxfiles` and
- * took unrelated apps / the whole machine down (#845). The classic trigger:
- * running the installer or `cgraphx init` from `$HOME`, which auto-indexes the
- * current directory. These are never intended project roots, so the installer
- * and `init`/`index` refuse them (overridable with `--force`).
- *
- * Pure-ish (reads only `os.homedir()` + realpath) so it's easy to unit-test.
- * The returned string is a human phrase that slots into "… looks like {reason}".
- */
-function unsafeIndexRootReason(projectRoot) {
-    const resolve = (p) => {
-        try {
-            return fs.realpathSync(path.resolve(p));
-        }
-        catch {
-            return path.resolve(p);
-        }
-    };
-    const resolved = resolve(projectRoot);
-    // Filesystem root: `/` on POSIX, a drive root like `C:\` on Windows.
-    if (path.parse(resolved).root === resolved) {
-        return 'the filesystem root';
-    }
-    const home = resolve(os.homedir());
-    // Case-insensitive on macOS/Windows (case-preserving but case-insensitive FS).
-    const norm = (p) => process.platform === 'darwin' || process.platform === 'win32' ? p.toLowerCase() : p;
-    const r = norm(resolved);
-    const h = norm(home);
-    if (r === h) {
-        return 'your home directory';
-    }
-    // An ancestor of home (e.g. `/Users`, `/home`) — even broader than home.
-    if (h.startsWith(r + path.sep)) {
-        return 'a parent of your home directory';
-    }
-    return null;
-}
-function findNearestCodeGraphRoot(startPath) {
-    let current = path.resolve(startPath);
-    const root = path.parse(current).root;
-    while (current !== root) {
-        if (isInitialized(current)) {
-            return current;
-        }
-        const parent = path.dirname(current);
-        if (parent === current)
-            break; // Reached filesystem root
-        current = parent;
-    }
-    // Check root as well
-    if (isInitialized(current)) {
-        return current;
-    }
-    return null;
-}
-/** Heavy/irrelevant directory names the sub-project scan never descends into. */
-const SUBPROJECT_SCAN_SKIP = new Set([
-    'node_modules', '.git', '.svn', '.hg', 'dist', 'build', 'out', 'target',
-    'vendor', 'bin', 'obj', '.next', '.nuxt', '.svelte-kit', '.cache', 'coverage',
-    '.venv', 'venv', '__pycache__', '.turbo', '.idea', '.vscode', 'tmp', 'temp',
-]);
-/** Manifests that mark a directory as a project/workspace root. The down-scan
- *  is gated on one of these so a non-project cwd (e.g. `$HOME`) is a cheap
- *  no-op instead of a deep filesystem crawl. */
-const WORKSPACE_ROOT_MANIFESTS = [
-    'package.json', 'pnpm-workspace.yaml', 'lerna.json', 'nx.json', 'turbo.json',
-    'go.work', 'go.mod', 'Cargo.toml', 'pom.xml', 'build.gradle', 'build.gradle.kts',
-    'settings.gradle', 'pyproject.toml', 'composer.json', 'Gemfile', 'rush.json',
-    'WORKSPACE', 'WORKSPACE.bazel',
-];
-function looksLikeProjectRoot(dir) {
-    return WORKSPACE_ROOT_MANIFESTS.some((m) => fs.existsSync(path.join(dir, m)));
-}
-function escapeRegExp(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-/**
- * Indexed sub-project roots beneath `root` (bounded breadth-first scan). For
- * the monorepo case behind #964: the index lives in a CHILD
- * (`packages/x/.cgraphx/`), not at the workspace root the agent's cwd points
- * at. Descent stops at the first indexed directory on a branch (a project's
- * own sub-dirs aren't separate projects) and is bounded by depth + count so it
- * never turns into a full-tree crawl on a large repo.
- */
-function findIndexedSubprojectRoots(root, opts = {}) {
-    const maxDepth = opts.maxDepth ?? 4;
-    const max = opts.max ?? 64;
-    const out = [];
-    const walk = (dir, depth) => {
-        if (out.length >= max || depth > maxDepth)
-            return;
-        let entries;
-        try {
-            entries = fs.readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const e of entries) {
-            if (out.length >= max)
-                return;
-            if (!e.isDirectory())
-                continue;
-            if (e.name.startsWith('.') || SUBPROJECT_SCAN_SKIP.has(e.name))
-                continue;
-            const child = path.join(dir, e.name);
-            if (isInitialized(child)) {
-                out.push(child);
-                continue;
-            } // don't descend into an indexed project
-            walk(child, depth + 1);
-        }
-    };
-    walk(root, 1);
-    return out;
-}
-/**
- * Decide what the front-load hook injects for a `prompt` issued from `cwd`,
- * shaped by where the `.cgraphx/` index(es) actually are:
- *   1. **cwd (or an ancestor) is indexed** → front-load that project. The
- *      normal single-project / nested-file case.
- *   2. **cwd isn't indexed but looks like a workspace root** → the indexes live
- *      in sub-projects (the monorepo case behind #964). One indexed
- *      sub-project → front-load it; several → front-load the one the prompt
- *      names (by relative path like `packages/api`, or package directory name)
- *      and nudge about the rest; several with no match → nudge the full list so
- *      the agent passes `projectPath`, rather than guessing wrong.
- *   3. **nothing indexed reachable** → do nothing (the agent's own tools apply).
- */
-function planFrontload(cwd, prompt) {
-    const none = { exploreRoot: null, nudgeProjects: [], viaSubScan: false };
-    // 1. up-walk — nearest indexed ancestor (incl. cwd). Cheap; covers the common
-    //    single-project case without a down-scan.
-    let dir = path.resolve(cwd);
-    for (let i = 0; i < 6; i++) {
-        if (isInitialized(dir))
-            return { exploreRoot: dir, nudgeProjects: [], viaSubScan: false };
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    // 2. down-scan — only from something that looks like a workspace root, so a
-    //    non-project cwd (e.g. $HOME) is a cheap no-op, not a deep crawl.
-    const base = path.resolve(cwd);
-    if (!looksLikeProjectRoot(base))
-        return none;
-    const subs = findIndexedSubprojectRoots(base);
-    if (subs.length === 0)
-        return none;
-    if (subs.length === 1)
-        return { exploreRoot: subs[0], nudgeProjects: [], viaSubScan: true };
-    // Several indexed sub-projects — pick the one the prompt points at, if any.
-    const p = prompt.toLowerCase();
-    let best = null;
-    for (const s of subs) {
-        const rel = path.relative(base, s);
-        const relLc = rel.split(path.sep).join('/').toLowerCase();
-        const name = path.basename(s).toLowerCase();
-        let score = 0;
-        if (relLc && p.includes(relLc))
-            score = 10; // "packages/api"
-        else if (name.length >= 3 && new RegExp(`\\b${escapeRegExp(name)}\\b`).test(p))
-            score = 5; // "api"
-        if (score > 0 && (!best || score > best.score || (score === best.score && rel.length < best.relLen))) {
-            best = { root: s, score, relLen: rel.length };
-        }
-    }
-    if (best) {
-        return { exploreRoot: best.root, nudgeProjects: subs.filter((s) => s !== best.root), viaSubScan: true };
-    }
-    // No clear match — nudge the full list rather than front-load a guess.
-    return { exploreRoot: null, nudgeProjects: subs, viaSubScan: true };
-}
-/**
- * Contents of `.cgraphx/.gitignore`. A single wildcard ignore keeps every
- * transient file in the index dir — the database, `daemon.pid`, the socket,
- * logs, cache, and anything future versions add — out of git, without having
- * to enumerate each name (issues #788, #492, #484). Older versions wrote an
- * explicit allowlist that never listed `daemon.pid` or the socket, so those
- * runtime files were silently committed.
- */
-const GITIGNORE_CONTENT = `# cgraphx data files — local to each machine, not for committing.
-# Ignore everything in .cgraphx/ except this file itself, so transient
-# files (the database, daemon.pid, sockets, logs) never show up in git.
-*
-!.gitignore
-`;
-/** Header line that prefixes every .gitignore older CodeGraph versions auto-generated — kept to detect+heal stale pre-wildcard files (issue #788). New writes use # cgraphx data files. */
-const GITIGNORE_MARKER = '# CodeGraph data files';
-/**
- * Is `content` a stale CodeGraph-generated `.gitignore` that should be
- * regenerated in place? True when it carries our header but predates the
- * wildcard ignore (it has no bare `*` line) — i.e. one of the old explicit
- * allowlists (`*.db`, `cache/`, `.dirty`, …) that never ignored `daemon.pid`
- * or the socket (issue #788). A file WITHOUT our header is user-authored and
- * is left untouched; one that already has the wildcard is current. Matching
- * on the header (not a byte-exact list of past defaults) heals every old
- * variant — v0.7.x through 0.9.9 — and is idempotent once upgraded.
- */
-function isStaleDefaultGitignore(content) {
-    if (!content.trimStart().startsWith(GITIGNORE_MARKER))
-        return false;
-    return !content.split('\n').some((line) => line.trim() === '*');
-}
-/**
- * Write `.cgraphx/.gitignore` if it's absent, or upgrade a stale
- * CodeGraph-generated default in place; a user-customized file is left alone.
- * Best-effort — returns `false` only if a needed write failed.
- */
-function ensureGitignore(gitignorePath) {
-    let existing;
-    try {
-        existing = fs.readFileSync(gitignorePath, 'utf-8');
-    }
-    catch {
-        existing = null; // absent (ENOENT) or unreadable — (re)create below
-    }
-    // Current default or a user-authored file: nothing to do.
-    if (existing !== null && !isStaleDefaultGitignore(existing))
-        return true;
-    try {
-        fs.writeFileSync(gitignorePath, GITIGNORE_CONTENT, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Create the .cgraphx directory structure
- * Note: Only throws if cgraphx.db already exists, not just if .cgraphx/ exists.
- */
-function createDirectory(projectRoot) {
-    const codegraphDir = getCodeGraphDir(projectRoot);
-    const dbPath = path.join(codegraphDir, 'cgraphx.db');
-    // Only throw if CodeGraph is actually initialized (db exists)
-    // .cgraphx/ folder alone is fine
-    if (fs.existsSync(dbPath)) {
-        throw new Error(`cgraphx already initialized in ${projectRoot}`);
-    }
-    // Create main directory (if it doesn't exist)
-    fs.mkdirSync(codegraphDir, { recursive: true });
-    // Write .gitignore inside .cgraphx (create if absent, upgrade a stale
-    // pre-wildcard default left by an older version — issue #788).
-    ensureGitignore(path.join(codegraphDir, '.gitignore'));
-}
-/**
- * Remove the .cgraphx directory
- */
-function removeDirectory(projectRoot) {
-    const codegraphDir = getCodeGraphDir(projectRoot);
-    if (!fs.existsSync(codegraphDir)) {
-        return;
-    }
-    // Verify .cgraphx is a real directory, not a symlink pointing elsewhere
-    const lstat = fs.lstatSync(codegraphDir);
-    if (lstat.isSymbolicLink()) {
-        // Only remove the symlink itself, never follow it for recursive delete
-        fs.unlinkSync(codegraphDir);
-        return;
-    }
-    if (!lstat.isDirectory()) {
-        // Not a directory - remove the single file
-        fs.unlinkSync(codegraphDir);
-        return;
-    }
-    // Recursively remove directory
-    fs.rmSync(codegraphDir, { recursive: true, force: true });
-}
-/**
- * Get all files in the .cgraphx directory
- */
-function listDirectoryContents(projectRoot) {
-    const codegraphDir = getCodeGraphDir(projectRoot);
-    if (!fs.existsSync(codegraphDir)) {
-        return [];
-    }
-    const files = [];
-    function walkDir(dir, prefix = '') {
-        const entries = fs.readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
-            // Skip symlinks to prevent following links outside .cgraphx
-            if (entry.isSymbolicLink()) {
-                continue;
-            }
-            if (entry.isDirectory()) {
-                walkDir(path.join(dir, entry.name), relativePath);
-            }
-            else {
-                files.push(relativePath);
-            }
-        }
-    }
-    walkDir(codegraphDir);
-    return files;
-}
-/**
- * Get the total size of the .cgraphx directory in bytes
- */
-function getDirectorySize(projectRoot) {
-    const codegraphDir = getCodeGraphDir(projectRoot);
-    if (!fs.existsSync(codegraphDir)) {
-        return 0;
-    }
-    let totalSize = 0;
-    function walkDir(dir) {
-        const entries = fs.readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            // Skip symlinks to prevent following links outside .cgraphx
-            if (entry.isSymbolicLink()) {
-                continue;
-            }
-            const fullPath = path.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                walkDir(fullPath);
-            }
-            else {
-                const stats = fs.statSync(fullPath);
-                totalSize += stats.size;
-            }
-        }
-    }
-    walkDir(codegraphDir);
-    return totalSize;
-}
-/**
- * Ensure a subdirectory exists within .cgraphx
- */
-function ensureSubdirectory(projectRoot, subdirName) {
-    if (subdirName.includes('..') || subdirName.includes(path.sep) || subdirName.includes('/')) {
-        throw new Error(`Invalid subdirectory name: ${subdirName}`);
-    }
-    const subdirPath = path.join(getCodeGraphDir(projectRoot), subdirName);
-    if (!fs.existsSync(subdirPath)) {
-        fs.mkdirSync(subdirPath, { recursive: true });
-    }
-    return subdirPath;
-}
-/**
- * Check if the .cgraphx directory has valid structure
- */
-function validateDirectory(projectRoot) {
-    const errors = [];
-    const codegraphDir = getCodeGraphDir(projectRoot);
-    if (!fs.existsSync(codegraphDir)) {
-        errors.push('cgraphx directory does not exist');
-        return { valid: false, errors };
-    }
-    if (!fs.statSync(codegraphDir).isDirectory()) {
-        errors.push('.cgraphx exists but is not a directory');
-        return { valid: false, errors };
-    }
-    // Auto-repair / upgrade .gitignore (non-critical file). A missing one is
-    // recreated; a stale pre-wildcard default that never ignored daemon.pid is
-    // regenerated in place (issue #788); a user-authored file is left alone.
-    const gitignorePath = path.join(codegraphDir, '.gitignore');
-    const existedBefore = fs.existsSync(gitignorePath);
-    if (!ensureGitignore(gitignorePath) && !existedBefore) {
-        // Only a missing-and-uncreatable file is surfaced; a failed in-place
-        // upgrade of an existing file is non-fatal — the index still works.
-        errors.push('.gitignore missing in .cgraphx directory and could not be created');
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-    };
-}
-//# sourceMappingURL=directory.js.map