opencode-multidevice-sync 0.1.0

package/dist/core/overrides.d.ts

@@ -0,0 +1,43 @@
+/** Locate the OpenCode config file inside a directory, if there is one. */
+export declare function findConfigFile(dir: string): string | undefined;
+export declare function hasOverrides(configRoot: string): boolean;
+export declare function loadOverrides(configRoot: string): Record<string, any>;
+/**
+ * Merge the local overrides into the config file after a pull.
+ *
+ * Returns true when the file was rewritten.
+ */
+export declare function applyOverrides(configRoot: string): boolean;
+/**
+ * Remove override-owned keys from an effective config so it can be pushed.
+ *
+ * `previous` is the version currently stored in the repository; the values it
+ * holds for overridden keys are what gets restored. Keys the repository has
+ * never seen are dropped.
+ */
+export declare function stripOverrides(effective: Record<string, any>, overrides: Record<string, any>, previous: Record<string, any> | undefined): Record<string, any>;
+/**
+ * True when the config on disk is, apart from override-owned keys, exactly what
+ * the repository already holds.
+ *
+ * Once overrides are in use the file on disk permanently differs from the
+ * committed version — that is the whole point. Plain `git status` therefore
+ * reports it as modified forever, which looks like pending work that never goes
+ * away. This lets the status command tell a real edit apart from the expected
+ * override difference.
+ *
+ * Returns `false` when there are no overrides, so callers fall back to git.
+ */
+export declare function configMatchesRepo(configRoot: string, previousText: string | undefined): boolean;
+/**
+ * Produce the text that should be committed for the config file.
+ *
+ * `previousText` is the version currently recorded in the repository. It has to
+ * be read out of git rather than off disk, because the worktree *is* the config
+ * directory — the file on disk is the effective config, overrides and all, so
+ * using it as the baseline would quietly publish this machine's overrides.
+ *
+ * Returns `undefined` when the file can be committed as-is.
+ */
+export declare function configTextForRepo(configRoot: string, previousText: string | undefined): string | undefined;
+//# sourceMappingURL=overrides.d.ts.map

package/dist/core/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/core/overrides.ts"],"names":[],"mappings":"AA+BA,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM9D;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAKxD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CASrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAa1D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GACxC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAqBrB;AAkBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAgB/F;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAWpB"}

package/dist/core/overrides.js

@@ -0,0 +1,169 @@
+import fs from "node:fs";
+import path from "node:path";
+import { deepMerge, parseJsonc } from "./jsonc.js";
+import { OVERRIDES_FILE, overridesPath } from "./settings.js";
+/**
+ * Per-machine configuration overrides.
+ *
+ * A synced repository makes every machine identical, which is wrong for the
+ * settings that are genuinely machine-specific: a corporate proxy, a local
+ * toolchain path, an MCP server that only exists on one box. Overrides restore
+ * that freedom by splitting the config into two layers.
+ *
+ *   repo `opencode.jsonc`            shared baseline, committed
+ *   local `opencode-sync.overrides.jsonc`  this machine only, never committed
+ *   ───────────────────────────────  deep merge
+ *   effective `opencode.jsonc`       what OpenCode actually reads
+ *
+ * The interesting half is push. Because the effective file is what lives on
+ * disk, a naive push would upload this machine's overrides to everyone. So on
+ * push any key that the overrides file claims is restored to the value the
+ * repository already had (or removed entirely if the repository never had it).
+ * Overridden keys therefore become invisible to sync in both directions.
+ *
+ * When no overrides file exists the config is copied byte for byte, which keeps
+ * comments and formatting untouched. The structural rewrite only happens for
+ * users who actually opted into overrides.
+ */
+const CONFIG_FILENAMES = ["opencode.jsonc", "opencode.json"];
+/** Locate the OpenCode config file inside a directory, if there is one. */
+export function findConfigFile(dir) {
+    for (const name of CONFIG_FILENAMES) {
+        const candidate = path.join(dir, name);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+export function hasOverrides(configRoot) {
+    const file = overridesPath(configRoot);
+    if (!fs.existsSync(file))
+        return false;
+    const parsed = loadOverrides(configRoot);
+    return Object.keys(parsed).length > 0;
+}
+export function loadOverrides(configRoot) {
+    const file = overridesPath(configRoot);
+    if (!fs.existsSync(file))
+        return {};
+    try {
+        const parsed = parseJsonc(fs.readFileSync(file, "utf8"));
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch (e) {
+        throw new Error(`Cannot read ${OVERRIDES_FILE}: ${e.message}`);
+    }
+}
+/**
+ * Merge the local overrides into the config file after a pull.
+ *
+ * Returns true when the file was rewritten.
+ */
+export function applyOverrides(configRoot) {
+    const overrides = loadOverrides(configRoot);
+    if (Object.keys(overrides).length === 0)
+        return false;
+    const configFile = findConfigFile(configRoot);
+    if (!configFile)
+        return false;
+    const base = parseJsonc(fs.readFileSync(configFile, "utf8"));
+    const merged = deepMerge(base, overrides);
+    const next = `${JSON.stringify(merged, null, 2)}\n`;
+    if (fs.readFileSync(configFile, "utf8") === next)
+        return false;
+    fs.writeFileSync(configFile, next);
+    return true;
+}
+/**
+ * Remove override-owned keys from an effective config so it can be pushed.
+ *
+ * `previous` is the version currently stored in the repository; the values it
+ * holds for overridden keys are what gets restored. Keys the repository has
+ * never seen are dropped.
+ */
+export function stripOverrides(effective, overrides, previous) {
+    const result = { ...effective };
+    for (const [key, overrideValue] of Object.entries(overrides)) {
+        const previousValue = previous?.[key];
+        const isNestedMerge = isPlainObject(overrideValue) && isPlainObject(result[key]) && isPlainObject(previousValue);
+        if (isNestedMerge) {
+            result[key] = stripOverrides(result[key], overrideValue, previousValue);
+            continue;
+        }
+        if (previous && Object.hasOwn(previous, key)) {
+            result[key] = previousValue;
+        }
+        else {
+            delete result[key];
+        }
+    }
+    return result;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Serialise with sorted keys, so comparisons ignore key order. */
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(",")}]`;
+    if (isPlainObject(value)) {
+        const entries = Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`);
+        return `{${entries.join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+/**
+ * True when the config on disk is, apart from override-owned keys, exactly what
+ * the repository already holds.
+ *
+ * Once overrides are in use the file on disk permanently differs from the
+ * committed version — that is the whole point. Plain `git status` therefore
+ * reports it as modified forever, which looks like pending work that never goes
+ * away. This lets the status command tell a real edit apart from the expected
+ * override difference.
+ *
+ * Returns `false` when there are no overrides, so callers fall back to git.
+ */
+export function configMatchesRepo(configRoot, previousText) {
+    const overrides = loadOverrides(configRoot);
+    if (Object.keys(overrides).length === 0)
+        return false;
+    if (!previousText)
+        return false;
+    const configFile = findConfigFile(configRoot);
+    if (!configFile)
+        return false;
+    try {
+        const effective = parseJsonc(fs.readFileSync(configFile, "utf8"));
+        const previous = parseJsonc(previousText);
+        return canonical(stripOverrides(effective, overrides, previous)) === canonical(previous);
+    }
+    catch {
+        // Unparseable on either side: treat it as a genuine difference.
+        return false;
+    }
+}
+/**
+ * Produce the text that should be committed for the config file.
+ *
+ * `previousText` is the version currently recorded in the repository. It has to
+ * be read out of git rather than off disk, because the worktree *is* the config
+ * directory — the file on disk is the effective config, overrides and all, so
+ * using it as the baseline would quietly publish this machine's overrides.
+ *
+ * Returns `undefined` when the file can be committed as-is.
+ */
+export function configTextForRepo(configRoot, previousText) {
+    const overrides = loadOverrides(configRoot);
+    if (Object.keys(overrides).length === 0)
+        return undefined;
+    const configFile = findConfigFile(configRoot);
+    if (!configFile)
+        return undefined;
+    const effective = parseJsonc(fs.readFileSync(configFile, "utf8"));
+    const previous = previousText ? parseJsonc(previousText) : undefined;
+    return `${JSON.stringify(stripOverrides(effective, overrides, previous), null, 2)}\n`;
+}
+//# sourceMappingURL=overrides.js.map

package/dist/core/overrides.js.map

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

package/dist/core/paths.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Resolve every directory opencode-multidevice-sync knows about.
+ *
+ * Each root can be overridden with an environment variable, which is what the
+ * test-suite uses to run against a scratch directory instead of the real
+ * machine.
+ */
+export interface Roots {
+    /** `~/.config/opencode` — also the git worktree for the sync repo. */
+    config: string;
+    /** `~/.local/share/opencode` — auth, account, sqlite database. */
+    data: string;
+    /** `~/.local/state/opencode` — frecency, kv store, model cache. */
+    state: string;
+    /** `~/.agents/skills` — skills installed by the `skills` CLI. */
+    agents: string;
+    /** `~/.cache/opencode` — plugin package cache. */
+    cache: string;
+}
+export declare function getConfigRoot(): string;
+export declare function getDataRoot(): string;
+export declare function getStateRoot(): string;
+export declare function getAgentsRoot(): string;
+export declare function getCacheRoot(): string;
+export declare function getRoots(): Roots;
+/** Path of the OpenCode SQLite database that holds all sessions. */
+export declare function getDatabasePath(roots?: Roots): string;
+/** Directory inside the sync repo where session shards are written. */
+export declare const SESSIONS_DIR = "_sessions";
+/** Directory inside the sync repo mirroring the OpenCode data root. */
+export declare const DATA_DIR = "_data";
+/** Directory inside the sync repo mirroring the OpenCode state root. */
+export declare const STATE_DIR = "_state";
+/** Directory inside the sync repo mirroring `~/.agents/skills`. */
+export declare const AGENTS_DIR = "_agents";
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAgB,QAAQ,IAAI,KAAK,CAQhC;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,KAAK,GAAE,KAAkB,GAAG,MAAM,CAEjE;AAED,uEAAuE;AACvE,eAAO,MAAM,YAAY,cAAc,CAAC;AACxC,uEAAuE;AACvE,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,wEAAwE;AACxE,eAAO,MAAM,SAAS,WAAW,CAAC;AAClC,mEAAmE;AACnE,eAAO,MAAM,UAAU,YAAY,CAAC"}

package/dist/core/paths.js

@@ -0,0 +1,55 @@
+import os from "node:os";
+import path from "node:path";
+function xdg(envVar, ...fallback) {
+    const fromEnv = process.env[envVar];
+    if (fromEnv)
+        return fromEnv;
+    return path.join(os.homedir(), ...fallback);
+}
+export function getConfigRoot() {
+    if (process.env.SYNC_CONFIG_ROOT)
+        return process.env.SYNC_CONFIG_ROOT;
+    return path.join(xdg("XDG_CONFIG_HOME", ".config"), "opencode");
+}
+export function getDataRoot() {
+    if (process.env.SYNC_DATA_ROOT)
+        return process.env.SYNC_DATA_ROOT;
+    return path.join(xdg("XDG_DATA_HOME", ".local", "share"), "opencode");
+}
+export function getStateRoot() {
+    if (process.env.SYNC_STATE_ROOT)
+        return process.env.SYNC_STATE_ROOT;
+    return path.join(xdg("XDG_STATE_HOME", ".local", "state"), "opencode");
+}
+export function getAgentsRoot() {
+    if (process.env.SYNC_AGENTS_ROOT)
+        return process.env.SYNC_AGENTS_ROOT;
+    return path.join(os.homedir(), ".agents", "skills");
+}
+export function getCacheRoot() {
+    if (process.env.SYNC_CACHE_ROOT)
+        return process.env.SYNC_CACHE_ROOT;
+    return path.join(xdg("XDG_CACHE_HOME", ".cache"), "opencode");
+}
+export function getRoots() {
+    return {
+        config: getConfigRoot(),
+        data: getDataRoot(),
+        state: getStateRoot(),
+        agents: getAgentsRoot(),
+        cache: getCacheRoot(),
+    };
+}
+/** Path of the OpenCode SQLite database that holds all sessions. */
+export function getDatabasePath(roots = getRoots()) {
+    return path.join(roots.data, "opencode.db");
+}
+/** Directory inside the sync repo where session shards are written. */
+export const SESSIONS_DIR = "_sessions";
+/** Directory inside the sync repo mirroring the OpenCode data root. */
+export const DATA_DIR = "_data";
+/** Directory inside the sync repo mirroring the OpenCode state root. */
+export const STATE_DIR = "_state";
+/** Directory inside the sync repo mirroring `~/.agents/skills`. */
+export const AGENTS_DIR = "_agents";
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAsB7B,SAAS,GAAG,CAAC,MAAc,EAAE,GAAG,QAAkB;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO;QACL,MAAM,EAAE,aAAa,EAAE;QACvB,IAAI,EAAE,WAAW,EAAE;QACnB,KAAK,EAAE,YAAY,EAAE;QACrB,MAAM,EAAE,aAAa,EAAE;QACvB,KAAK,EAAE,YAAY,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,QAAe,QAAQ,EAAE;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AACxC,uEAAuE;AACvE,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC;AAChC,wEAAwE;AACxE,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAClC,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC"}

package/dist/core/preview.d.ts

@@ -0,0 +1,3 @@
+import type { SyncOptions, SyncResult } from "./sync.js";
+export declare function previewSync(action: "push" | "pull", options: SyncOptions, run: (o: SyncOptions) => Promise<SyncResult>): Promise<SyncResult>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/core/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAiDrB"}

package/dist/core/preview.js

@@ -0,0 +1,56 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createDatabaseBackup } from "./backup.js";
+import { git } from "./git.js";
+import { getRoots } from "./paths.js";
+import { loadSettings } from "./settings.js";
+export async function previewSync(action, options, run) {
+    const roots = options.roots ?? getRoots();
+    const settings = options.settings ?? loadSettings(roots.config);
+    if (settings.extraPaths.length)
+        throw new Error("Preview with extraPaths is not supported yet; refusing to touch external files");
+    const temp = fs.mkdtempSync(path.join(os.tmpdir(), "omds-preview-"));
+    const isolated = {};
+    try {
+        const marker = path.join(roots.config, ".git");
+        if (fs.existsSync(marker) && !fs.lstatSync(marker).isDirectory())
+            throw new Error("Preview of linked Git worktrees is not supported");
+        for (const key of ["config", "data", "state", "agents", "cache"]) {
+            isolated[key] = path.join(temp, key);
+            fs.mkdirSync(isolated[key], { recursive: true });
+            if (!fs.existsSync(roots[key]) || key === "cache")
+                continue;
+            fs.cpSync(roots[key], isolated[key], {
+                recursive: true,
+                dereference: false,
+                filter: (p) => {
+                    const name = path.basename(p);
+                    return (![
+                        "node_modules",
+                        "backups",
+                        "log",
+                        "tool-output",
+                        "snapshot",
+                        "repos",
+                        "locks",
+                        ".opencode-sync.lock",
+                    ].includes(name) && !/^opencode\.db(?:-|$)/.test(name));
+                },
+            });
+        }
+        const database = path.join(roots.data, "opencode.db");
+        if (settings.sessions.enabled && fs.existsSync(database)) {
+            const snapshot = await createDatabaseBackup(database, path.join(temp, "snapshot"), 1);
+            fs.copyFileSync(snapshot.path, path.join(isolated.data, "opencode.db"));
+        }
+        fs.mkdirSync(path.join(temp, "no-hooks"));
+        git(["config", "core.hooksPath", path.join(temp, "no-hooks")], { cwd: isolated.config });
+        const result = await run({ ...options, roots: isolated, settings, dryRun: action === "push" });
+        return { ...result, message: `Preview only: ${result.message}`, restartRequired: false };
+    }
+    finally {
+        fs.rmSync(temp, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+    }
+}
+//# sourceMappingURL=preview.js.map

package/dist/core/preview.js.map

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

package/dist/core/repo.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Files the sync repository must never track.
+ *
+ * Three categories:
+ *   - local-only settings (`opencode-sync*.jsonc`)
+ *   - the SQLite database and its journals, which are gigabytes and are
+ *     represented instead by the shards in `_sessions/`
+ *   - caches, logs and OS junk
+ */
+export declare const DEFAULT_GITIGNORE = "# opencode-github-sync \u2014 machine-local, never committed\nopencode-sync.jsonc\nopencode-sync.overrides.jsonc\n.opencode-sync.lock\n\n# Runtime / generated\nnode_modules/\n*.backup-*\n*.bak-*\n*.omds-*\n*.edit-tmp\n.env\n.env.*\n_state/locks/\nbun.lock\nlogs/\n**/__pycache__/\n*.pyc\n\n# Session storage lives in _sessions/ as portable shards.\n# The raw database is far too large for git and cannot be merged.\n_data/opencode.db\n_data/opencode.db-shm\n_data/opencode.db-wal\n_data/bin/\n_data/log/\n_data/tool-output/\n_data/snapshot/\n_data/storage/session\n_data/storage/session_diff\n\n# Machine-local UI state\n_state/session.json\n\n# Empty directories recreated by OpenCode at runtime\nplugin/\n\n# OS files\n.DS_Store\nThumbs.db\ndesktop.ini\n";
+export declare const DEFAULT_GITATTRIBUTES = "# Store and check out everything with LF.\n# \"text=auto\" alone would rewrite files to CRLF on Windows, which silently\n# breaks shell scripts shipped inside skills and makes every cross-platform\n# pull look like a whole-file change.\n* text=auto eol=lf\n\n# Append-only history files merge cleanly by taking both sides\n_state/prompt-history.jsonl text eol=lf merge=union\n\n# Session shards are gzipped JSON \u2014 binary, and never line-merged\n_sessions/*.json.gz binary\n";
+/**
+ * Paths that exist inside the worktree but must stay out of every commit.
+ *
+ * These are runtime artefacts of the machine, not configuration. They are
+ * excluded from `add`, from stashing and from `clean`, so a sync can never
+ * delete a user's local database or tool output.
+ */
+export declare const LOCAL_RUNTIME_PATHS: string[];
+export declare function isLocalRuntimePath(candidate: string): boolean;
+export declare function excludePathspecs(): string[];
+/** Unstage runtime paths in a single git call — subprocesses are slow on Windows. */
+export declare function unstageLocalRuntimePaths(root: string): void;
+export interface EnsureRepoOptions {
+    root: string;
+    remote: string;
+    branch: string;
+}
+export type RepoState = "ready" | "adopted" | "fresh";
+/** Configure identity and metadata files. Safe to call repeatedly. */
+export declare function ensureGitIdentity(root: string): void;
+export declare function writeRepoMetadata(root: string): void;
+/**
+ * Make `root` a git worktree pointing at `remote`.
+ *
+ * Returns `adopted` when the remote already had commits (they become the local
+ * state) and `fresh` when the remote exists but is empty.
+ */
+export declare function initRepo(options: EnsureRepoOptions): RepoState;
+export declare function ensureRepo(options: EnsureRepoOptions): RepoState;
+/** Fail fast when the remote is unreachable, distinguishing auth from network. */
+export declare function assertRemoteReachable(root: string, branch: string, operation: string, allowMissingBranch?: boolean): void;
+/**
+ * Verify the commit really landed on the remote.
+ *
+ * `git push` can exit zero against a misconfigured proxy or a stale credential
+ * helper without the remote actually moving, so success is confirmed by reading
+ * the remote head back.
+ */
+export declare function assertPushLanded(root: string, branch: string, operation: string): void;
+export declare const REPO_DIRS: {
+    DATA_DIR: string;
+    STATE_DIR: string;
+    AGENTS_DIR: string;
+    SESSIONS_DIR: string;
+};
+//# sourceMappingURL=repo.d.ts.map

package/dist/core/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/core/repo.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,yvBAyC7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,meAWjC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAQ/B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CASpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYpD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CA0B9D;AAQD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAUhE;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,kBAAkB,UAAQ,GACzB,IAAI,CAKN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAWtF;AAED,eAAO,MAAM,SAAS;;;;;CAAoD,CAAC"}