@opencodehub/cli 0.1.0

package/dist/embedder-downloader.js

@@ -0,0 +1,261 @@
+/**
+ * SHA256-pinned downloader for gte-modernbert-base weights.
+ *
+ * Resolves the target directory via {@link resolveModelDir}, then for each
+ * pinned file in {@link GTE_MODERNBERT_BASE_PINS}:
+ *   1. Skip when the file already exists and its SHA256 matches the pin.
+ *   2. Otherwise stream-download to `<target>.tmp`, hash during write, verify
+ *      hash, and atomically rename to the final path.
+ *
+ * Retries transient network errors (ECONNRESET / timeout / 5xx) up to 3 times
+ * with exponential backoff (100ms, 500ms, 2s). A SHA256 mismatch is a hard
+ * error — the `.tmp` file is deleted and the error thrown. We never ship
+ * weights that don't match the pin.
+ *
+ * All disk access is streaming; we never buffer a 596 MB file in memory.
+ */
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream } from "node:fs";
+import { mkdir, rename, stat, unlink } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { Readable, Writable } from "node:stream";
+import { pipeline as streamPipeline } from "node:stream/promises";
+import { setTimeout as delay } from "node:timers/promises";
+import { GTE_MODERNBERT_BASE_PINS, resolveModelDir } from "@opencodehub/embedder";
+const DEFAULT_BACKOFF_MS = [100, 500, 2000];
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Thrown when a downloaded file's SHA256 doesn't match the pinned value.
+ *
+ * The temp file is deleted before this throws so partial corrupt payloads
+ * never linger on disk.
+ */
+export class Sha256MismatchError extends Error {
+    code = "EMBEDDER_SHA256_MISMATCH";
+    fileName;
+    expected;
+    actual;
+    constructor(fileName, expected, actual) {
+        super(`SHA256 mismatch for ${fileName}: expected ${expected}, got ${actual}`);
+        this.name = "Sha256MismatchError";
+        this.fileName = fileName;
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+/**
+ * Thrown for all non-hash download failures (404, network, etc.). Carries the
+ * URL in the message so operators can reproduce with curl.
+ */
+export class DownloadError extends Error {
+    code = "EMBEDDER_DOWNLOAD_FAILED";
+    url;
+    constructor(url, message, options) {
+        super(`Download failed for ${url}: ${message}`, options);
+        this.name = "DownloadError";
+        this.url = url;
+    }
+}
+/**
+ * Hash an existing file on disk in streaming fashion.
+ *
+ * Returns `undefined` if the file does not exist — callers use that as the
+ * "not yet downloaded" signal rather than a dedicated stat() probe.
+ */
+async function hashFileIfExists(path) {
+    try {
+        await stat(path);
+    }
+    catch {
+        return undefined;
+    }
+    const hasher = createHash("sha256");
+    const rs = createReadStream(path);
+    await streamPipeline(rs, new Writable({
+        write(chunk, _enc, cb) {
+            // Convert Buffer → Uint8Array view so strict TS typings accept it.
+            hasher.update(new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength));
+            cb();
+        },
+    }));
+    return hasher.digest("hex");
+}
+/**
+ * Decide whether a network error is retryable. We treat `ECONNRESET`,
+ * `ETIMEDOUT`, `EAI_AGAIN`, `ECONNREFUSED`, generic `AbortError` on timeout,
+ * and 5xx HTTP responses as transient. SHA mismatch and 4xx are permanent.
+ */
+function isRetryableError(err) {
+    if (err instanceof Sha256MismatchError)
+        return false;
+    if (!(err instanceof Error))
+        return false;
+    const transientCodes = new Set([
+        "ECONNRESET",
+        "ETIMEDOUT",
+        "EAI_AGAIN",
+        "ECONNREFUSED",
+        "ENETUNREACH",
+        "UND_ERR_SOCKET",
+    ]);
+    // Walk the error + its .cause chain; the network-layer code lives on the
+    // underlying cause when we've wrapped the error as a DownloadError.
+    let cur = err;
+    let hops = 0;
+    while (cur instanceof Error && hops < 8) {
+        const codeCandidate = cur.code;
+        if (typeof codeCandidate === "string" && transientCodes.has(codeCandidate)) {
+            return true;
+        }
+        cur = cur.cause;
+        hops += 1;
+    }
+    // DownloadError with a 5xx status is retryable; the message encodes the code.
+    if (err instanceof DownloadError && /HTTP 5\d\d/.test(err.message)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Stream one pinned file to disk. Hash-as-we-write, verify, and atomic rename.
+ * Does NOT retry — that's the caller's job via {@link withRetry}.
+ */
+async function downloadOne(pin, targetPath, fetchImpl) {
+    const tmpPath = `${targetPath}.tmp`;
+    // Best-effort cleanup of any stale tmp from a previous failed run.
+    try {
+        await unlink(tmpPath);
+    }
+    catch {
+        // Doesn't exist — fine.
+    }
+    let res;
+    try {
+        res = await fetchImpl(pin.url, { redirect: "follow" });
+    }
+    catch (err) {
+        throw new DownloadError(pin.url, err instanceof Error ? err.message : String(err), err instanceof Error ? { cause: err } : undefined);
+    }
+    if (!res.ok) {
+        throw new DownloadError(pin.url, `HTTP ${res.status} ${res.statusText}`);
+    }
+    if (res.body === null) {
+        throw new DownloadError(pin.url, "response body is null");
+    }
+    const hasher = createHash("sha256");
+    let bytesWritten = 0;
+    const writeStream = createWriteStream(tmpPath);
+    // Web ReadableStream → Node Readable bridge. `fetch` returns a Web stream
+    // in all Node releases we support (>=20). We assert through the Node
+    // stream/web type because `fetch`'s global typings reference lib.dom which
+    // we deliberately exclude from this package.
+    const bodyAsNode = Readable.fromWeb(res.body);
+    try {
+        await streamPipeline(bodyAsNode, new Writable({
+            write(chunk, _enc, cb) {
+                const view = new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+                hasher.update(view);
+                bytesWritten += chunk.byteLength;
+                if (!writeStream.write(chunk)) {
+                    writeStream.once("drain", () => cb());
+                }
+                else {
+                    cb();
+                }
+            },
+            final(cb) {
+                writeStream.end(() => cb());
+            },
+        }));
+    }
+    catch (err) {
+        // Clean up partial tmp before bubbling — no corrupt files on disk.
+        try {
+            await unlink(tmpPath);
+        }
+        catch {
+            // Nothing to do.
+        }
+        throw new DownloadError(pin.url, err instanceof Error ? err.message : String(err), err instanceof Error ? { cause: err } : undefined);
+    }
+    const actual = hasher.digest("hex");
+    if (actual !== pin.sha256) {
+        try {
+            await unlink(tmpPath);
+        }
+        catch {
+            // Nothing to do.
+        }
+        throw new Sha256MismatchError(pin.name, pin.sha256, actual);
+    }
+    await rename(tmpPath, targetPath);
+    return bytesWritten;
+}
+/**
+ * Run `task` with exponential backoff. The error type determines whether a
+ * retry is attempted; non-transient errors bubble immediately.
+ */
+async function withRetry(task, maxRetries, backoffMs) {
+    let lastErr;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        try {
+            return await task();
+        }
+        catch (err) {
+            lastErr = err;
+            if (!isRetryableError(err) || attempt === maxRetries - 1) {
+                throw err;
+            }
+            const waitMs = backoffMs[attempt] ?? backoffMs[backoffMs.length - 1] ?? 0;
+            if (waitMs > 0) {
+                await delay(waitMs);
+            }
+        }
+    }
+    // Unreachable — the loop always either returns or throws.
+    throw lastErr;
+}
+/**
+ * Download every pinned file for the requested variant, skipping files whose
+ * on-disk SHA256 already matches the pin (unless `force` is set).
+ *
+ * Returns `{downloaded, skipped, totalBytes}` where `totalBytes` counts the
+ * newly-downloaded bytes only (skipped files are not re-hashed into the
+ * total).
+ */
+export async function downloadEmbedderWeights(opts) {
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+        throw new Error("Global fetch is not available. Node >= 18 required; supply opts.fetchImpl otherwise.");
+    }
+    const maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const backoffMs = opts.backoffMs ?? DEFAULT_BACKOFF_MS;
+    const modelDir = resolveModelDir(opts.modelDir, opts.variant);
+    await mkdir(modelDir, { recursive: true });
+    const files = GTE_MODERNBERT_BASE_PINS[opts.variant].files;
+    let downloaded = 0;
+    let skipped = 0;
+    let totalBytes = 0;
+    for (let i = 0; i < files.length; i++) {
+        const pin = files[i];
+        const target = join(modelDir, pin.name);
+        const pct = Math.round((i / files.length) * 100);
+        opts.onProgress?.(pct, pin.name);
+        if (!opts.force) {
+            const existing = await hashFileIfExists(target);
+            if (existing === pin.sha256) {
+                skipped += 1;
+                continue;
+            }
+        }
+        // Ensure parent dir exists (target itself lives directly under modelDir
+        // so this is mostly belt-and-suspenders for unusual overrides).
+        await mkdir(dirname(target), { recursive: true });
+        const bytes = await withRetry(() => downloadOne(pin, target, fetchImpl), maxRetries, backoffMs);
+        downloaded += 1;
+        totalBytes += bytes;
+    }
+    opts.onProgress?.(100, "done");
+    return { downloaded, skipped, totalBytes, modelDir };
+}
+//# sourceMappingURL=embedder-downloader.js.map

package/dist/embedder-downloader.js.map

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

package/dist/fs-atomic.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Thin async wrapper around `write-file-atomic` that encodes our invariants:
+ *   - always UTF-8
+ *   - always fsync the temp file before rename
+ *   - always a trailing newline (makes diffs readable across editors)
+ *
+ * `write-file-atomic` already handles the pid/ts-suffixed temp file, fsync, and
+ * atomic rename. We centralize the import so the rest of the package depends on
+ * a single import shape — and so tests can swap in an in-memory implementation
+ * via dependency injection if they want.
+ */
+export interface WriteAtomicOptions {
+    readonly mode?: number;
+    /** If true, do not add a trailing newline. Defaults to false. */
+    readonly raw?: boolean;
+}
+/**
+ * Write `contents` to `path` atomically. The parent directory must already
+ * exist — callers that cannot guarantee that should `mkdir -p` first.
+ */
+export declare function writeFileAtomic(path: string, contents: string, opts?: WriteAtomicOptions): Promise<void>;
+//# sourceMappingURL=fs-atomic.d.ts.map

package/dist/fs-atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-atomic.d.ts","sourceRoot":"","sources":["../src/fs-atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/fs-atomic.js

@@ -0,0 +1,28 @@
+/**
+ * Thin async wrapper around `write-file-atomic` that encodes our invariants:
+ *   - always UTF-8
+ *   - always fsync the temp file before rename
+ *   - always a trailing newline (makes diffs readable across editors)
+ *
+ * `write-file-atomic` already handles the pid/ts-suffixed temp file, fsync, and
+ * atomic rename. We centralize the import so the rest of the package depends on
+ * a single import shape — and so tests can swap in an in-memory implementation
+ * via dependency injection if they want.
+ */
+import { default as wfa } from "write-file-atomic";
+/**
+ * Write `contents` to `path` atomically. The parent directory must already
+ * exist — callers that cannot guarantee that should `mkdir -p` first.
+ */
+export async function writeFileAtomic(path, contents, opts = {}) {
+    const payload = opts.raw === true || contents.endsWith("\n") ? contents : `${contents}\n`;
+    const writeOpts = {
+        encoding: "utf8",
+        fsync: true,
+    };
+    if (opts.mode !== undefined) {
+        writeOpts.mode = opts.mode;
+    }
+    await wfa(path, payload, writeOpts);
+}
+//# sourceMappingURL=fs-atomic.js.map

package/dist/fs-atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-atomic.js","sourceRoot":"","sources":["../src/fs-atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAQnD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,QAAgB,EAChB,OAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC;IAC1F,MAAM,SAAS,GAAgE;QAC7E,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAC7B,CAAC;IACD,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC"}

package/dist/groups.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Cross-repo group registry at `~/.codehub/groups/<name>.json`.
+ *
+ * A group is a named bundle of already-indexed repos. Each group lives in its
+ * own JSON file so that:
+ *   - `write-file-atomic` rewrites of one group never serialize against another,
+ *   - deletion is a single `unlink`, and
+ *   - additive use (two users sharing `~/.codehub` via sync) sees minimal
+ *     conflicts.
+ *
+ * The on-disk shape is intentionally minimal (name + createdAt + repos[] +
+ * optional description). Callers that need richer metadata should compose
+ * against `~/.codehub/registry.json` via `readRegistry` at call time — we do
+ * NOT duplicate per-repo stats into the group file.
+ *
+ * Determinism: `repos[]` is sorted by `name` on every write; on-disk JSON ends
+ * with a single trailing newline; writes go through `write-file-atomic`. Group
+ * names must be filesystem-safe (`[a-z0-9_-]+`) and are validated before any
+ * filesystem call.
+ */
+/** Per-group subdirectory under `~/.codehub`. */
+export declare const GROUPS_DIR_NAME = "groups";
+/** Allowed group names. Matches a single path segment that is safe on macOS, Linux, and Windows. */
+export declare const GROUP_NAME_PATTERN: RegExp;
+export interface GroupRepo {
+    readonly name: string;
+    readonly path: string;
+}
+export interface GroupEntry {
+    readonly name: string;
+    readonly createdAt: string;
+    readonly repos: readonly GroupRepo[];
+    readonly description?: string;
+}
+export interface GroupsOptions {
+    /** Override `~` root used to locate `~/.codehub/groups` (tests pass a tmpdir). */
+    readonly home?: string;
+}
+/**
+ * Validate a group name up front so we never create filesystem paths from
+ * arbitrary user input. Throws on bad names.
+ */
+export declare function assertValidGroupName(name: string): void;
+/** Resolve the absolute path of the `groups/` directory. */
+export declare function resolveGroupsDir(opts?: GroupsOptions): string;
+/** Resolve the absolute path of a group's JSON file. */
+export declare function resolveGroupFile(name: string, opts?: GroupsOptions): string;
+/** Read a single group by name. Returns `null` when the file does not exist. */
+export declare function readGroup(name: string, opts?: GroupsOptions): Promise<GroupEntry | null>;
+/**
+ * Write a group to disk atomically. The `repos` array is sorted by `name` so
+ * byte-for-byte output is stable across invocations. Creates the parent
+ * directory when missing.
+ */
+export declare function writeGroup(group: GroupEntry, opts?: GroupsOptions): Promise<void>;
+/** Delete a group. Returns `true` if the file existed, `false` otherwise. */
+export declare function deleteGroup(name: string, opts?: GroupsOptions): Promise<boolean>;
+/**
+ * Enumerate every group under `~/.codehub/groups`. Returned entries are
+ * sorted by name. Unreadable/malformed files are skipped with an error logged
+ * to stderr rather than tearing down the caller.
+ */
+export declare function listGroups(opts?: GroupsOptions): Promise<readonly GroupEntry[]>;
+//# sourceMappingURL=groups.d.ts.map

package/dist/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../src/groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,iDAAiD;AACjD,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,oGAAoG;AACpG,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOvD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CAGjE;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAG/E;AAED,gFAAgF;AAChF,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAY5B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3F;AAED,6EAA6E;AAC7E,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAU1F;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CA0BzF"}

package/dist/groups.js

@@ -0,0 +1,172 @@
+/**
+ * Cross-repo group registry at `~/.codehub/groups/<name>.json`.
+ *
+ * A group is a named bundle of already-indexed repos. Each group lives in its
+ * own JSON file so that:
+ *   - `write-file-atomic` rewrites of one group never serialize against another,
+ *   - deletion is a single `unlink`, and
+ *   - additive use (two users sharing `~/.codehub` via sync) sees minimal
+ *     conflicts.
+ *
+ * The on-disk shape is intentionally minimal (name + createdAt + repos[] +
+ * optional description). Callers that need richer metadata should compose
+ * against `~/.codehub/registry.json` via `readRegistry` at call time — we do
+ * NOT duplicate per-repo stats into the group file.
+ *
+ * Determinism: `repos[]` is sorted by `name` on every write; on-disk JSON ends
+ * with a single trailing newline; writes go through `write-file-atomic`. Group
+ * names must be filesystem-safe (`[a-z0-9_-]+`) and are validated before any
+ * filesystem call.
+ */
+// biome-ignore-all lint/complexity/useLiteralKeys: dot-access disallowed on Record index signatures
+import { mkdir, readdir, readFile, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { writeFileAtomic } from "./fs-atomic.js";
+import { CODEHUB_HOME_DIR } from "./registry.js";
+/** Per-group subdirectory under `~/.codehub`. */
+export const GROUPS_DIR_NAME = "groups";
+/** Allowed group names. Matches a single path segment that is safe on macOS, Linux, and Windows. */
+export const GROUP_NAME_PATTERN = /^[a-z0-9_-]+$/;
+/**
+ * Validate a group name up front so we never create filesystem paths from
+ * arbitrary user input. Throws on bad names.
+ */
+export function assertValidGroupName(name) {
+    if (!GROUP_NAME_PATTERN.test(name)) {
+        throw new Error(`Invalid group name "${name}". Names must match ${GROUP_NAME_PATTERN} ` +
+            "(lowercase letters, digits, underscore, hyphen).");
+    }
+}
+/** Resolve the absolute path of the `groups/` directory. */
+export function resolveGroupsDir(opts = {}) {
+    const home = opts.home ?? homedir();
+    return resolve(home, CODEHUB_HOME_DIR, GROUPS_DIR_NAME);
+}
+/** Resolve the absolute path of a group's JSON file. */
+export function resolveGroupFile(name, opts = {}) {
+    assertValidGroupName(name);
+    return join(resolveGroupsDir(opts), `${name}.json`);
+}
+/** Read a single group by name. Returns `null` when the file does not exist. */
+export async function readGroup(name, opts = {}) {
+    assertValidGroupName(name);
+    const file = resolveGroupFile(name, opts);
+    let raw;
+    try {
+        raw = await readFile(file, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+    const parsed = JSON.parse(raw);
+    return validateGroup(parsed, file);
+}
+/**
+ * Write a group to disk atomically. The `repos` array is sorted by `name` so
+ * byte-for-byte output is stable across invocations. Creates the parent
+ * directory when missing.
+ */
+export async function writeGroup(group, opts = {}) {
+    assertValidGroupName(group.name);
+    const file = resolveGroupFile(group.name, opts);
+    await mkdir(dirname(file), { recursive: true });
+    const sortedRepos = [...group.repos]
+        .map((r) => ({ name: r.name, path: r.path }))
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    const payload = {
+        name: group.name,
+        createdAt: group.createdAt,
+        repos: sortedRepos,
+        ...(group.description !== undefined ? { description: group.description } : {}),
+    };
+    const serialized = `${JSON.stringify(payload, null, 2)}\n`;
+    await writeFileAtomic(file, serialized, { raw: true });
+}
+/** Delete a group. Returns `true` if the file existed, `false` otherwise. */
+export async function deleteGroup(name, opts = {}) {
+    assertValidGroupName(name);
+    const file = resolveGroupFile(name, opts);
+    try {
+        await unlink(file);
+        return true;
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return false;
+        throw err;
+    }
+}
+/**
+ * Enumerate every group under `~/.codehub/groups`. Returned entries are
+ * sorted by name. Unreadable/malformed files are skipped with an error logged
+ * to stderr rather than tearing down the caller.
+ */
+export async function listGroups(opts = {}) {
+    const dir = resolveGroupsDir(opts);
+    let dirents;
+    try {
+        dirents = await readdir(dir);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const names = dirents
+        .filter((f) => extname(f) === ".json")
+        .map((f) => basename(f, ".json"))
+        .filter((n) => GROUP_NAME_PATTERN.test(n))
+        .sort();
+    const out = [];
+    for (const name of names) {
+        try {
+            const group = await readGroup(name, opts);
+            if (group)
+                out.push(group);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`codehub groups: skipping malformed group "${name}": ${msg}`);
+        }
+    }
+    return out;
+}
+// ----------------------------------------------------------------------------
+// Internal helpers
+// ----------------------------------------------------------------------------
+function validateGroup(value, file) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`Invalid group at ${file}: expected top-level object`);
+    }
+    const raw = value;
+    if (typeof raw["name"] !== "string") {
+        throw new Error(`Invalid group at ${file}: missing "name"`);
+    }
+    if (typeof raw["createdAt"] !== "string") {
+        throw new Error(`Invalid group at ${file}: missing "createdAt"`);
+    }
+    if (!Array.isArray(raw["repos"])) {
+        throw new Error(`Invalid group at ${file}: missing "repos" array`);
+    }
+    const repos = [];
+    for (const entry of raw["repos"]) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const r = entry;
+        if (typeof r["name"] !== "string" || typeof r["path"] !== "string")
+            continue;
+        repos.push({ name: r["name"], path: r["path"] });
+    }
+    repos.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    const out = {
+        name: raw["name"],
+        createdAt: raw["createdAt"],
+        repos,
+        ...(typeof raw["description"] === "string" ? { description: raw["description"] } : {}),
+    };
+    return out;
+}
+//# sourceMappingURL=groups.js.map

package/dist/groups.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * `codehub` CLI entrypoint.
+ *
+ * Every subcommand is loaded lazily via `await import(...)` so that
+ * `codehub --help` (and `codehub <command> --help`) stays fast: no DuckDB
+ * native binding, no pipeline, no MCP SDK unless we are actually going to
+ * run that subcommand.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}