@ryanstark24/sfgraph-cli 1.1.0

package/dist/commands/ingest.js

@@ -0,0 +1,260 @@
+import path from "node:path";
+import { SqliteGraphStore, SqliteSnapshotStore, listAllAuthenticatedOrgs, liveIngest, multiOrgIngest, } from "@ryanstark24/sfgraph-core";
+import { ConsoleLogger, SfgraphError, getSfgraphPaths, safeOrgDbPath, } from "@ryanstark24/sfgraph-shared";
+function formatRow(cols, widths) {
+    return cols.map((c, i) => c.padEnd(widths[i] ?? c.length)).join("  ");
+}
+function printResultsTable(entries, mode) {
+    const header = ["Org", "Mode", "Members", "Deletions", "ParseErrors", "Elapsed(ms)", "Status"];
+    const rows = entries.map((e) => [
+        e.alias,
+        e.result?.mode ?? mode,
+        String(e.result?.membersProcessed ?? "-"),
+        String(e.result?.deletions ?? "-"),
+        String(e.result?.parseErrors ?? "-"),
+        String(e.finishedAt - e.startedAt),
+        e.status === "ok" ? "OK" : `ERR: ${e.error ?? ""}`,
+    ]);
+    const widths = header.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
+    console.log(formatRow(header, widths));
+    console.log(formatRow(widths.map((w) => "-".repeat(w)), widths));
+    for (const r of rows)
+        console.log(formatRow(r, widths));
+}
+/**
+ * Validate that a user-supplied `--db <path>` resolves to an absolute path
+ * inside `getSfgraphPaths().data`. The CLI is local, but treating `--db`
+ * as an unconstrained `fs.write` target lets a curious script overwrite
+ * unrelated files (or fill `/`). Require explicit `SFGRAPH_ALLOW_ANY_DB`
+ * to escape the data dir — for power-users who deliberately want to
+ * stash an ingest elsewhere.
+ */
+function validateDbPath(rawDbPath, dataDir) {
+    const abs = path.resolve(rawDbPath);
+    const rel = path.relative(path.resolve(dataDir), abs);
+    const inside = rel.length > 0 && !rel.startsWith("..") && !path.isAbsolute(rel);
+    if (!inside && process.env.SFGRAPH_ALLOW_ANY_DB !== "1") {
+        throw new Error(`--db path resolves outside the sfgraph data dir (${dataDir}). Refusing to write to ${abs}. Set SFGRAPH_ALLOW_ANY_DB=1 if this is intentional.`);
+    }
+    return abs;
+}
+async function buildSingleIngestOpts(alias, opts, logger, deps) {
+    const resolved = await deps.resolveOrg(alias);
+    const dataDir = getSfgraphPaths().data;
+    const dbPath = opts.db
+        ? validateDbPath(opts.db, dataDir)
+        : safeOrgDbPath(dataDir, String(resolved.orgId));
+    if (opts.rebuild) {
+        await applyRebuild(dbPath, String(resolved.orgId), Boolean(opts.noBackup), logger);
+    }
+    const graphStore = new SqliteGraphStore({ dbPath });
+    await graphStore.init();
+    const snapshotStore = new SqliteSnapshotStore({
+        dbPath,
+        db: graphStore.db,
+        skipMigrations: true,
+    });
+    await snapshotStore.init();
+    // --rebuild and --only and --retry-skipped all force a full sync because
+    // incremental wouldn't pick up newly-permitted/unblocked types.
+    const forceFull = Boolean(opts.rebuild || opts.only || opts.retrySkipped);
+    const mode = forceFull ? "full" : (opts.mode ?? "auto");
+    // Resolve onlyLabels from --only or --retry-skipped. The skip report lives
+    // at <dataDir>/<orgId>.skips.json (written at end of every ingest).
+    const skipReportPath = path.join(getSfgraphPaths().data, `${resolved.orgId}.skips.json`);
+    let onlyLabels;
+    if (opts.only) {
+        onlyLabels = new Set(opts.only
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0));
+    }
+    else if (opts.retrySkipped) {
+        const { existsSync, readFileSync } = await import("node:fs");
+        if (!existsSync(skipReportPath)) {
+            throw new Error(`--retry-skipped: no skip report found at ${skipReportPath}. Run a full ingest first.`);
+        }
+        try {
+            const raw = JSON.parse(readFileSync(skipReportPath, "utf8"));
+            const labels = (raw.skips ?? []).map((s) => s.label).filter(Boolean);
+            if (labels.length === 0) {
+                console.log("--retry-skipped: previous run had zero skips. Nothing to retry.");
+                // Return a no-op opts; the live-ingest will exit cleanly with no work.
+                onlyLabels = new Set();
+            }
+            else {
+                onlyLabels = new Set(labels);
+                console.log(`--retry-skipped: retrying ${labels.length} previously-skipped source${labels.length === 1 ? "" : "s"} from ${skipReportPath}`);
+            }
+        }
+        catch (e) {
+            throw new Error(`--retry-skipped: failed to read skip report at ${skipReportPath}: ${e.message}`);
+        }
+    }
+    return {
+        alias,
+        mode,
+        graphStore,
+        snapshotStore,
+        logger,
+        preResolved: resolved,
+        detectDeletions: Boolean(opts.detectDeletions),
+        ...(onlyLabels ? { onlyLabels } : {}),
+        skipReportPath,
+    };
+}
+/**
+ * SQLite uses WAL by default in this codebase, which means alongside
+ * `<file>.sqlite` you also get `<file>.sqlite-wal` and `<file>.sqlite-shm`.
+ * Plain rollback journals add `<file>.sqlite-journal`. Without handling
+ * these sidecars during --rebuild, the move/delete leaves orphans that
+ * SQLite later reads back into the new DB, corrupting state.
+ */
+const SQLITE_SIDECAR_SUFFIXES = ["-wal", "-shm", "-journal"];
+async function applyRebuild(dbPath, orgId, noBackup, logger) {
+    const { existsSync, mkdirSync, renameSync, unlinkSync } = await import("node:fs");
+    if (!existsSync(dbPath)) {
+        logger.info(`rebuild: no existing graph at ${dbPath}; starting fresh`);
+        return;
+    }
+    if (noBackup) {
+        unlinkSync(dbPath);
+        for (const suffix of SQLITE_SIDECAR_SUFFIXES) {
+            const sidecar = `${dbPath}${suffix}`;
+            if (existsSync(sidecar)) {
+                try {
+                    unlinkSync(sidecar);
+                }
+                catch {
+                    /* best-effort */
+                }
+            }
+        }
+        console.warn(`REBUILD: existing graph for ${orgId} DELETED (no-backup); running full sync`);
+        return;
+    }
+    const backupDir = path.join(getSfgraphPaths().data, "backups");
+    mkdirSync(backupDir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const backupPath = path.join(backupDir, `${orgId}.rebuild-${stamp}.sqlite`);
+    renameSync(dbPath, backupPath);
+    for (const suffix of SQLITE_SIDECAR_SUFFIXES) {
+        const sidecar = `${dbPath}${suffix}`;
+        if (existsSync(sidecar)) {
+            try {
+                renameSync(sidecar, `${backupPath}${suffix}`);
+            }
+            catch {
+                /* best-effort: if we can't move the sidecar, delete it so it
+                   doesn't get associated with the fresh DB */
+                try {
+                    unlinkSync(sidecar);
+                }
+                catch {
+                    /* swallow */
+                }
+            }
+        }
+    }
+    console.warn(`REBUILD: existing graph for ${orgId} moved to ${backupPath}; running full sync`);
+}
+export async function ingestCmd(opts) {
+    const logger = new ConsoleLogger("info");
+    if (opts.embedModel)
+        process.env.SFGRAPH_EMBED_MODEL_PATH = opts.embedModel;
+    if (opts.embedModelId)
+        process.env.SFGRAPH_EMBED_MODEL_ID = opts.embedModelId;
+    if (opts.embedModelDim !== undefined) {
+        process.env.SFGRAPH_EMBED_MODEL_DIM = String(opts.embedModelDim);
+    }
+    try {
+        const { resolveOrg, resolveDefaultOrgAlias, configureDefaultPools } = await import("@ryanstark24/sfgraph-core");
+        // Apply pool-concurrency overrides. CLI flags win; SFGRAPH_*_POOL env
+        // vars are a secondary knob (handled inside configureDefaultPools).
+        const poolOverrides = {};
+        if (opts.toolingPool !== undefined)
+            poolOverrides.tooling = opts.toolingPool;
+        if (opts.metadataPool !== undefined)
+            poolOverrides.metadata = opts.metadataPool;
+        if (opts.dataPool !== undefined)
+            poolOverrides.data = opts.dataPool;
+        const applied = await configureDefaultPools(poolOverrides);
+        logger.info(`ingest: pool concurrency tooling=${applied.tooling} metadata=${applied.metadata} data=${applied.data}`);
+        // Determine the alias list (multi-org modes).
+        let aliases = null;
+        if (opts.all) {
+            try {
+                aliases = await listAllAuthenticatedOrgs();
+            }
+            catch (e) {
+                console.error(`ingest --all: failed to enumerate authenticated orgs: ${e.message}`);
+                process.exitCode = 1;
+                return;
+            }
+            if (aliases.length === 0) {
+                console.error("ingest --all: no authenticated orgs found. Run `sf org login web` first.");
+                process.exitCode = 1;
+                return;
+            }
+            logger.info(`ingest --all: discovered ${aliases.length} orgs: ${aliases.join(", ")}`);
+        }
+        else if (opts.orgs) {
+            aliases = opts.orgs
+                .split(",")
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0);
+            if (aliases.length === 0) {
+                console.error("ingest --orgs: empty alias list.");
+                process.exitCode = 1;
+                return;
+            }
+        }
+        if (aliases !== null && aliases.length > 0) {
+            const list = aliases;
+            const summary = await multiOrgIngest({
+                aliases: list,
+                parallel: Boolean(opts.parallel),
+                logger,
+                buildOpts: (alias) => buildSingleIngestOpts(alias, opts, logger, { resolveOrg }),
+            });
+            console.log(`\nMulti-org ingest complete (${summary.parallel ? "parallel" : "sequential"}, ${summary.totalElapsedMs}ms):`);
+            printResultsTable(summary.entries, opts.mode ?? "auto");
+            const failed = summary.entries.filter((e) => e.status === "error").length;
+            if (failed > 0)
+                process.exitCode = 1;
+            return;
+        }
+        // Single-org path (preserved behavior).
+        let alias;
+        if (opts.org) {
+            alias = opts.org;
+        }
+        else {
+            const detected = await resolveDefaultOrgAlias();
+            if (!detected) {
+                console.error("ingest: no --org provided and no default org configured. Run `sf config set target-org <alias>` or pass --org.");
+                process.exitCode = 1;
+                return;
+            }
+            alias = detected;
+            logger.info(`ingest: using default org from sf config: ${alias}`);
+        }
+        const built = await buildSingleIngestOpts(alias, opts, logger, { resolveOrg });
+        const startedAt = Date.now();
+        logger.info(`ingest: starting alias=${alias}`);
+        const result = await liveIngest(built);
+        logger.info("ingest: capabilities", result.capabilities);
+        logger.info(`ingest: complete mode=${result.mode} members=${result.membersProcessed} deletions=${result.deletions} parseErrors=${result.parseErrors} elapsed=${Date.now() - startedAt}ms`);
+        await built.graphStore.close();
+    }
+    catch (e) {
+        if (e instanceof SfgraphError) {
+            console.error(`[${e.code}] ${e.message}`);
+        }
+        else {
+            console.error(e.message);
+        }
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=ingest.js.map

package/dist/commands/ingest.js.map

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

package/dist/commands/install.d.ts

@@ -0,0 +1,44 @@
+/** Snapshot of `sf` CLI org state at install time. Written to
+ *  `<dataDir>/orgs-snapshot.json`. list_orgs and other tools read this when
+ *  StateAggregator returns empty (the sandboxed-IDE-child case). */
+export interface OrgSnapshot {
+    recordedAt: number;
+    defaultAlias: string | null;
+    /** alias -> username */
+    aliases: Record<string, string>;
+    /** username -> { orgId, instanceUrl } */
+    authorizations: Record<string, {
+        orgId: string;
+        instanceUrl: string;
+    }>;
+}
+export declare const ORG_SNAPSHOT_FILENAME = "orgs-snapshot.json";
+/** Exported so `sfgraph refresh-orgs` can call it directly without going
+ *  through the rest of the install flow (MCP config writes, skill copies). */
+export declare function writeOrgSnapshot(dataDir: string): Promise<void>;
+export interface InstallCmdOpts {
+    target?: "claude" | "cursor" | "vscode" | "all";
+    dryRun?: boolean;
+    skillsOnly?: boolean;
+    mcpOnly?: boolean;
+    /** Write MCP entry that invokes the currently-running binary directly,
+     *  instead of `npx @ryanstark24/sfgraph`. Use this for local dev
+     *  before the package is published. */
+    local?: boolean;
+    /** Absolute path to a Node binary. With --local, the MCP entry's
+     *  `command` is pinned to this Node so IDE-spawned children always use a
+     *  Node ABI that matches the rebuilt better-sqlite3 binding. Defaults to
+     *  `process.execPath` when `--local` is set without `--pin-node`. */
+    pinNode?: string;
+    homeOverride?: string;
+    log?: (s: string) => void;
+}
+export interface InstallSummaryRow {
+    target: string;
+    kind: "skill" | "mcp";
+    name: string;
+    path: string;
+    action: string;
+}
+export declare function installCmd(opts?: InstallCmdOpts): Promise<InstallSummaryRow[]>;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAKA;;oEAEoE;AACpE,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAE1D;8EAC8E;AAC9E,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuGrE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;2CAEuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;yEAGqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA4HxF"}

package/dist/commands/install.js

@@ -0,0 +1,214 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { install as installSkills } from "@ryanstark24/sfgraph-skills";
+import { writeMcpConfig } from "./_mcp-config.js";
+export const ORG_SNAPSHOT_FILENAME = "orgs-snapshot.json";
+/** Exported so `sfgraph refresh-orgs` can call it directly without going
+ *  through the rest of the install flow (MCP config writes, skill copies). */
+export async function writeOrgSnapshot(dataDir) {
+    // Run @salesforce/core in this process (NOT the MCP child) so it can
+    // actually read ~/.sf/. Capture everything we need; the sandboxed child
+    // will read from the JSON instead of from ~/.sf/.
+    // @salesforce/core isn't a direct dep of the CLI package — resolve it
+    // through a sibling (@ryanstark24/sfgraph-server) that lists it as a
+    // direct dependency. Same pattern doctor.ts uses for better-sqlite3.
+    const { createRequire } = await import("node:module");
+    const here = createRequire(import.meta.url);
+    let resolvedSfCorePath;
+    try {
+        const serverEntry = here.resolve("@ryanstark24/sfgraph-server");
+        const sibling = createRequire(serverEntry);
+        resolvedSfCorePath = sibling.resolve("@salesforce/core");
+    }
+    catch {
+        // Fall back to direct resolve (might work in some hoisted layouts).
+        resolvedSfCorePath = "@salesforce/core";
+    }
+    const sfCore = (await import(resolvedSfCorePath));
+    const auths = await sfCore.AuthInfo.listAllAuthorizations();
+    const authorizations = {};
+    for (const a of auths) {
+        if (!a.username)
+            continue;
+        authorizations[a.username] = {
+            orgId: a.orgId ?? "",
+            instanceUrl: a.instanceUrl ?? "",
+        };
+    }
+    let aliases = {};
+    try {
+        if (sfCore.StateAggregator?.create) {
+            const agg = await sfCore.StateAggregator.create();
+            aliases = agg.aliases.getAll() ?? {};
+        }
+    }
+    catch {
+        /* aliases stay empty */
+    }
+    let defaultAlias = null;
+    try {
+        if (sfCore.ConfigAggregator?.create) {
+            const cfg = await sfCore.ConfigAggregator.create();
+            const v = (cfg.getInfo("target-org") ?? cfg.getInfo("defaultusername"))?.value;
+            if (typeof v === "string" && v.length > 0)
+                defaultAlias = v;
+        }
+    }
+    catch {
+        /* default stays null */
+    }
+    // Fallback: ConfigAggregator reads project-local config first which is
+    // usually empty when we run from outside the user's sfdx project. Read
+    // the GLOBAL config file directly so `sf config set target-org=foo`
+    // (run from any project dir) still resolves.
+    if (!defaultAlias) {
+        try {
+            const { readFileSync, existsSync } = await import("node:fs");
+            const { homedir } = await import("node:os");
+            const { join } = await import("node:path");
+            // Newer sf CLI: ~/.sf/config.json. Legacy sfdx: ~/.sfdx/sfdx-config.json.
+            const candidates = [
+                join(homedir(), ".sf", "config.json"),
+                join(homedir(), ".sfdx", "sfdx-config.json"),
+            ];
+            for (const cfgPath of candidates) {
+                if (!existsSync(cfgPath))
+                    continue;
+                const parsed = JSON.parse(readFileSync(cfgPath, "utf8"));
+                const v = parsed["target-org"] ?? parsed.defaultusername;
+                if (typeof v === "string" && v.length > 0) {
+                    defaultAlias = v;
+                    break;
+                }
+            }
+        }
+        catch {
+            /* fallback failed; defaultAlias stays null */
+        }
+    }
+    const snapshot = {
+        recordedAt: Date.now(),
+        defaultAlias,
+        aliases,
+        authorizations,
+    };
+    mkdirSync(dataDir, { recursive: true });
+    writeFileSync(join(dataDir, ORG_SNAPSHOT_FILENAME), JSON.stringify(snapshot, null, 2), "utf8");
+}
+export async function installCmd(opts = {}) {
+    const target = opts.target ?? "all";
+    const log = opts.log ?? ((s) => console.log(s));
+    const rows = [];
+    const sharedOpts = {
+        dryRun: opts.dryRun ?? false,
+    };
+    if (opts.homeOverride !== undefined)
+        sharedOpts.homeOverride = opts.homeOverride;
+    // Local-dev mode: derive the absolute path of THIS sfgraph binary so the
+    // MCP entry invokes it directly. process.argv[1] is the script path that
+    // Node received. Resolve to an absolute, normalized form.
+    let localBinPath;
+    if (opts.local) {
+        const { realpathSync } = await import("node:fs");
+        const { resolve } = await import("node:path");
+        const candidate = process.argv[1] ?? "";
+        if (!candidate) {
+            throw new Error("install --local: cannot detect this binary's path from process.argv");
+        }
+        try {
+            localBinPath = realpathSync(resolve(candidate));
+        }
+        catch {
+            localBinPath = resolve(candidate);
+        }
+    }
+    const mcpOpts = {
+        ...sharedOpts,
+    };
+    if (localBinPath)
+        mcpOpts.localBinPath = localBinPath;
+    // Always propagate the shell's resolved data/config/log dirs into the MCP
+    // entry's env. This is the only way sandboxed IDE child processes (Cursor
+    // on macOS, Claude Desktop) read from the same on-disk location the shell
+    // wrote to. Without this, the child's env-paths resolver lands in a
+    // different (often non-writable) location than the shell.
+    const { getSfgraphPaths } = await import("@ryanstark24/sfgraph-shared");
+    const shellPaths = getSfgraphPaths();
+    mcpOpts.env = {
+        SFGRAPH_DATA_DIR: shellPaths.data,
+        SFGRAPH_CONFIG_DIR: shellPaths.config,
+        SFGRAPH_CACHE_DIR: shellPaths.cache,
+        SFGRAPH_LOG_DIR: shellPaths.log,
+    };
+    // Snapshot the sf-CLI alias map + default-org at install time. The
+    // sandboxed MCP child on Cursor/Claude can't read ~/.sf/alias.json or
+    // ~/.sf/config.json (filesystem permission), so StateAggregator and
+    // ConfigAggregator return empty there. We capture both while running
+    // outside the sandbox and persist to a JSON file under the data dir
+    // (which is sandbox-readable thanks to SFGRAPH_DATA_DIR above).
+    if (!opts.dryRun) {
+        try {
+            await writeOrgSnapshot(shellPaths.data);
+        }
+        catch (e) {
+            // Best-effort: install shouldn't fail if sf isn't authenticated yet.
+            log(`note: could not snapshot sf orgs (${e.message}); list_orgs in IDE may show empty aliases`);
+        }
+    }
+    // Resolve pinNode: explicit flag wins; otherwise default to process.execPath
+    // when --local is set so the IDE child uses the same Node that ran install.
+    if (opts.pinNode) {
+        mcpOpts.pinNode = opts.pinNode;
+    }
+    else if (opts.local) {
+        mcpOpts.pinNode = process.execPath;
+    }
+    if (!opts.mcpOnly) {
+        const skillResults = await installSkills(target, sharedOpts);
+        for (const r of skillResults) {
+            rows.push({
+                target: r.target,
+                kind: "skill",
+                name: r.skill,
+                path: r.path,
+                action: r.action,
+            });
+        }
+    }
+    if (!opts.skillsOnly) {
+        const mcpTargets = target === "all" ? ["claude", "cursor", "vscode"] : [target];
+        for (const t of mcpTargets) {
+            const res = await writeMcpConfig(t, mcpOpts);
+            rows.push({
+                target: res.target,
+                kind: "mcp",
+                name: "sfgraph",
+                path: res.path,
+                action: res.action,
+            });
+        }
+    }
+    // Print summary table.
+    const header = ["target", "kind", "name", "action", "path"];
+    const widths = header.map((h) => h.length);
+    const data = rows.map((r) => [r.target, r.kind, r.name, r.action, r.path]);
+    for (const row of data) {
+        for (let i = 0; i < row.length; i++) {
+            const cell = row[i] ?? "";
+            const w = widths[i] ?? cell.length;
+            widths[i] = Math.max(w, cell.length);
+        }
+    }
+    const pad = (cells) => cells.map((c, i) => c.padEnd(widths[i] ?? c.length)).join("  ");
+    log(pad(header));
+    log(widths.map((w) => "-".repeat(w)).join("  "));
+    for (const row of data) {
+        log(pad(row));
+    }
+    if (opts.dryRun) {
+        log("");
+        log("[dry-run] no files written");
+    }
+    return rows;
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/link.d.ts

@@ -0,0 +1,6 @@
+export interface LinkOpts {
+    org: string;
+    project?: string | undefined;
+}
+export declare function linkCmd(opts: LinkOpts): Promise<void>;
+//# sourceMappingURL=link.d.ts.map

package/dist/commands/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/commands/link.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3D"}

package/dist/commands/link.js

@@ -0,0 +1,23 @@
+import path from "node:path";
+import { resolveOrg } from "@ryanstark24/sfgraph-core";
+import { ConsoleLogger, SfgraphError, findProjectRoot, linkWorkspace, } from "@ryanstark24/sfgraph-shared";
+export async function linkCmd(opts) {
+    const logger = new ConsoleLogger("info");
+    try {
+        const startDir = opts.project ? path.resolve(opts.project) : process.cwd();
+        const projectRoot = findProjectRoot(startDir) ?? startDir;
+        const resolved = await resolveOrg(opts.org);
+        const ws = await linkWorkspace(projectRoot, opts.org, resolved.orgId);
+        logger.info(`Linked ${ws.projectRoot} -> org ${opts.org} (${resolved.orgId})`);
+    }
+    catch (e) {
+        if (e instanceof SfgraphError) {
+            console.error(`[${e.code}] ${e.message}`);
+        }
+        else {
+            console.error(e.message);
+        }
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=link.js.map

package/dist/commands/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/commands/link.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,6BAA6B,CAAC;AAOrC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC3E,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,WAAW,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/rebuild-bindings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Rebuild the better-sqlite3 native binding against the *current* Node
+ * runtime. The published npm package ships prebuilts for common Node
+ * versions, but users on very new Node releases (no prebuilt yet) or who
+ * upgraded Node after install will hit "bindings file not found" / ABI
+ * mismatch errors. `npm rebuild better-sqlite3 --build-from-source`
+ * produces a binding matching `process.versions.modules`, which fixes
+ * both classes.
+ *
+ * Strategy:
+ *   1. Locate the better-sqlite3 install root via `require.resolve`.
+ *      Walking up from that to its package root gives us the directory
+ *      `npm rebuild` needs to run in.
+ *   2. Prefer the package manager that owns the install (pnpm if there's
+ *      a `node_modules/.pnpm` sibling, npm otherwise).
+ *   3. Stream child stdout/stderr through so the user sees node-gyp
+ *      progress live — a 20–60s compile feels less like a hang.
+ */
+export interface RebuildBindingsOpts {
+    /** When true, print what would be run without executing. */
+    dryRun?: boolean;
+    /** Override the resolved package manager (auto-detected otherwise). */
+    packageManager?: "npm" | "pnpm";
+}
+export declare function rebuildBindingsCmd(opts?: RebuildBindingsOpts): Promise<void>;
+//# sourceMappingURL=rebuild-bindings.d.ts.map

package/dist/commands/rebuild-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-bindings.d.ts","sourceRoot":"","sources":["../../src/commands/rebuild-bindings.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACjC;AAgDD,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFtF"}