opencode-multidevice-sync 0.1.0

package/dist/core/repo.js

@@ -0,0 +1,196 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ensureFile, writeIfDiffers } from "./fsx.js";
+import { git, isGitRepo, toGitError } from "./git.js";
+import { AGENTS_DIR, DATA_DIR, SESSIONS_DIR, STATE_DIR } from "./paths.js";
+import { OVERRIDES_FILE, SETTINGS_FILE } from "./settings.js";
+/**
+ * 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 const DEFAULT_GITIGNORE = `# opencode-github-sync — machine-local, never committed
+${SETTINGS_FILE}
+${OVERRIDES_FILE}
+.opencode-sync.lock
+
+# Runtime / generated
+node_modules/
+*.backup-*
+*.bak-*
+*.omds-*
+*.edit-tmp
+.env
+.env.*
+_state/locks/
+bun.lock
+logs/
+**/__pycache__/
+*.pyc
+
+# Session storage lives in ${SESSIONS_DIR}/ as portable shards.
+# The raw database is far too large for git and cannot be merged.
+${DATA_DIR}/opencode.db
+${DATA_DIR}/opencode.db-shm
+${DATA_DIR}/opencode.db-wal
+${DATA_DIR}/bin/
+${DATA_DIR}/log/
+${DATA_DIR}/tool-output/
+${DATA_DIR}/snapshot/
+${DATA_DIR}/storage/session
+${DATA_DIR}/storage/session_diff
+
+# Machine-local UI state
+${STATE_DIR}/session.json
+
+# Empty directories recreated by OpenCode at runtime
+plugin/
+
+# OS files
+.DS_Store
+Thumbs.db
+desktop.ini
+`;
+export const DEFAULT_GITATTRIBUTES = `# Store and check out everything with LF.
+# "text=auto" alone would rewrite files to CRLF on Windows, which silently
+# breaks shell scripts shipped inside skills and makes every cross-platform
+# pull look like a whole-file change.
+* text=auto eol=lf
+
+# Append-only history files merge cleanly by taking both sides
+${STATE_DIR}/prompt-history.jsonl text eol=lf merge=union
+
+# Session shards are gzipped JSON — binary, and never line-merged
+${SESSIONS_DIR}/*.json.gz binary
+`;
+/**
+ * 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 const LOCAL_RUNTIME_PATHS = [
+    `${DATA_DIR}/opencode.db`,
+    `${DATA_DIR}/opencode.db-shm`,
+    `${DATA_DIR}/opencode.db-wal`,
+    `${DATA_DIR}/storage/session`,
+    `${DATA_DIR}/storage/session_diff`,
+    `${DATA_DIR}/tool-output`,
+    `${DATA_DIR}/snapshot`,
+];
+export function isLocalRuntimePath(candidate) {
+    const normalized = String(candidate ?? "").replace(/\\/g, "/");
+    return LOCAL_RUNTIME_PATHS.some((prefix) => {
+        const clean = prefix.replace(/\/$/, "");
+        return normalized === clean || normalized.startsWith(`${clean}/`);
+    });
+}
+export function excludePathspecs() {
+    return LOCAL_RUNTIME_PATHS.map((p) => `:(exclude)${p}`);
+}
+/** Unstage runtime paths in a single git call — subprocesses are slow on Windows. */
+export function unstageLocalRuntimePaths(root) {
+    git(["reset", "-q", "HEAD", "--", ...LOCAL_RUNTIME_PATHS], { cwd: root });
+}
+/** Configure identity and metadata files. Safe to call repeatedly. */
+export function ensureGitIdentity(root) {
+    const name = git(["config", "user.name"], { cwd: root });
+    if (!name.ok || !name.stdout) {
+        git(["config", "user.name", "OpenCode Sync"], { cwd: root });
+    }
+    const email = git(["config", "user.email"], { cwd: root });
+    if (!email.ok || !email.stdout) {
+        git(["config", "user.email", "sync@opencode.local"], { cwd: root });
+    }
+}
+export function writeRepoMetadata(root) {
+    const ignore = path.join(root, ".gitignore");
+    const current = fs.existsSync(ignore) ? fs.readFileSync(ignore, "utf8") : "";
+    const missing = DEFAULT_GITIGNORE.split("\n").filter((l) => l && !l.startsWith("#") && !current.split(/\r?\n/).includes(l));
+    if (missing.length)
+        writeIfDiffers(ignore, current + (current.endsWith("\n") ? "" : "\n") + missing.join("\n") + "\n");
+    writeIfDiffers(path.join(root, ".gitattributes"), DEFAULT_GITATTRIBUTES);
+}
+/**
+ * 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 function initRepo(options) {
+    const { root, remote, branch } = options;
+    ensureFile(path.join(root, ".gitignore"), DEFAULT_GITIGNORE);
+    ensureFile(path.join(root, ".gitattributes"), DEFAULT_GITATTRIBUTES);
+    git(["init", "-b", branch], { cwd: root });
+    const existingRemote = git(["remote", "get-url", "origin"], { cwd: root });
+    if (existingRemote.ok) {
+        if (existingRemote.stdout !== remote) {
+            git(["remote", "set-url", "origin", remote], { cwd: root });
+        }
+    }
+    else {
+        git(["remote", "add", "origin", remote], { cwd: root });
+    }
+    ensureGitIdentity(root);
+    const fetched = git(["fetch", "origin", branch], { cwd: root });
+    if (fetched.ok && git(["rev-parse", `origin/${branch}`], { cwd: root }).ok) {
+        git(["reset", "--hard", `origin/${branch}`], { cwd: root });
+        git(["branch", `--set-upstream-to=origin/${branch}`, branch], { cwd: root });
+        return "adopted";
+    }
+    if (!fetched.ok && !isMissingBranch(fetched))
+        throw toGitError("Initial fetch", fetched);
+    return "fresh";
+}
+function isMissingBranch(result) {
+    return /couldn't find remote ref|remote branch .* not found/i.test(`${result.stderr}\n${result.stdout}`);
+}
+export function ensureRepo(options) {
+    if (!isGitRepo(options.root))
+        return initRepo(options);
+    ensureGitIdentity(options.root);
+    const remote = git(["remote", "get-url", "origin"], { cwd: options.root });
+    if (!remote.ok) {
+        git(["remote", "add", "origin", options.remote], { cwd: options.root });
+    }
+    else if (remote.stdout !== options.remote) {
+        git(["remote", "set-url", "origin", options.remote], { cwd: options.root });
+    }
+    return "ready";
+}
+/** Fail fast when the remote is unreachable, distinguishing auth from network. */
+export function assertRemoteReachable(root, branch, operation, allowMissingBranch = false) {
+    const result = git(["ls-remote", "--exit-code", "origin", `refs/heads/${branch}`], { cwd: root });
+    if (result.ok)
+        return;
+    if (allowMissingBranch && git(["ls-remote", "origin"], { cwd: root }).ok)
+        return;
+    throw toGitError(operation, result);
+}
+/**
+ * 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 function assertPushLanded(root, branch, operation) {
+    const local = git(["rev-parse", "HEAD"], { cwd: root });
+    const remote = git(["ls-remote", "origin", `refs/heads/${branch}`], { cwd: root });
+    if (!remote.ok)
+        throw toGitError(operation, remote);
+    if (!local.ok)
+        throw toGitError(operation, local);
+    const remoteHead = remote.stdout.split(/\s+/)[0] ?? "";
+    if (remoteHead === local.stdout)
+        return;
+    throw new Error(`${operation} reported success but the remote did not move.\n` +
+        `  local:  ${local.stdout}\n  remote: ${remoteHead || "(empty)"}`);
+}
+export const REPO_DIRS = { DATA_DIR, STATE_DIR, AGENTS_DIR, SESSIONS_DIR };
+//# sourceMappingURL=repo.js.map

package/dist/core/repo.js.map

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

package/dist/core/reporter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Terminal presentation layer.
+ *
+ * The core never writes to stdout directly. It emits structured events through
+ * a `Reporter`, so the same sync logic can render as a pretty CLI, as silent
+ * JSON, or as OpenCode toast notifications from inside the plugin.
+ */
+export type ChangeKind = "added" | "modified" | "deleted" | "renamed";
+export interface ChangeSummary {
+    added: number;
+    modified: number;
+    deleted: number;
+    renamed: number;
+}
+export interface ChangedFile {
+    kind: ChangeKind;
+    path: string;
+}
+export interface Reporter {
+    step(message: string): void;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    detail(message: string): void;
+    changes(summary: ChangeSummary, files: ChangedFile[]): void;
+}
+export declare const silentReporter: Reporter;
+/** Collects everything for later inspection — used by the plugin and tests. */
+export declare class CollectingReporter implements Reporter {
+    readonly lines: {
+        level: string;
+        message: string;
+    }[];
+    summary: ChangeSummary;
+    files: ChangedFile[];
+    private push;
+    step(message: string): void;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    detail(message: string): void;
+    changes(summary: ChangeSummary, files: ChangedFile[]): void;
+    get text(): string;
+}
+export declare function emptySummary(): ChangeSummary;
+export declare function summarize(files: ChangedFile[]): ChangeSummary;
+export declare function totalChanges(summary: ChangeSummary): number;
+//# sourceMappingURL=reporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/core/reporter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;CAC7D;AAED,eAAO,MAAM,cAAc,EAAE,QAQ5B,CAAC;AAEF,+EAA+E;AAC/E,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAM;IAC1D,OAAO,EAAE,aAAa,CAAqD;IAC3E,KAAK,EAAE,WAAW,EAAE,CAAM;IAE1B,OAAO,CAAC,IAAI;IAIZ,IAAI,CAAC,OAAO,EAAE,MAAM;IAGpB,IAAI,CAAC,OAAO,EAAE,MAAM;IAGpB,OAAO,CAAC,OAAO,EAAE,MAAM;IAGvB,IAAI,CAAC,OAAO,EAAE,MAAM;IAGpB,KAAK,CAAC,OAAO,EAAE,MAAM;IAGrB,MAAM,CAAC,OAAO,EAAE,MAAM;IAGtB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE;IAKpD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,wBAAgB,YAAY,IAAI,aAAa,CAE5C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,aAAa,CAI7D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D"}

package/dist/core/reporter.js

@@ -0,0 +1,63 @@
+/**
+ * Terminal presentation layer.
+ *
+ * The core never writes to stdout directly. It emits structured events through
+ * a `Reporter`, so the same sync logic can render as a pretty CLI, as silent
+ * JSON, or as OpenCode toast notifications from inside the plugin.
+ */
+export const silentReporter = {
+    step() { },
+    info() { },
+    success() { },
+    warn() { },
+    error() { },
+    detail() { },
+    changes() { },
+};
+/** Collects everything for later inspection — used by the plugin and tests. */
+export class CollectingReporter {
+    lines = [];
+    summary = { added: 0, modified: 0, deleted: 0, renamed: 0 };
+    files = [];
+    push(level, message) {
+        this.lines.push({ level, message });
+    }
+    step(message) {
+        this.push("step", message);
+    }
+    info(message) {
+        this.push("info", message);
+    }
+    success(message) {
+        this.push("success", message);
+    }
+    warn(message) {
+        this.push("warn", message);
+    }
+    error(message) {
+        this.push("error", message);
+    }
+    detail(message) {
+        this.push("detail", message);
+    }
+    changes(summary, files) {
+        this.summary = summary;
+        this.files = files;
+    }
+    get text() {
+        return this.lines.map((l) => l.message).join("\n");
+    }
+}
+export function emptySummary() {
+    return { added: 0, modified: 0, deleted: 0, renamed: 0 };
+}
+export function summarize(files) {
+    const summary = emptySummary();
+    for (const file of files)
+        summary[file.kind]++;
+    return summary;
+}
+export function totalChanges(summary) {
+    return summary.added + summary.modified + summary.deleted + summary.renamed;
+}
+//# sourceMappingURL=reporter.js.map

package/dist/core/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/core/reporter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,OAAO,KAAI,CAAC;IACZ,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;IACV,MAAM,KAAI,CAAC;IACX,OAAO,KAAI,CAAC;CACb,CAAC;AAEF,+EAA+E;AAC/E,MAAM,OAAO,kBAAkB;IACpB,KAAK,GAAyC,EAAE,CAAC;IAC1D,OAAO,GAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC3E,KAAK,GAAkB,EAAE,CAAC;IAElB,IAAI,CAAC,KAAa,EAAE,OAAe;QACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,OAAe;QACrB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,CAAC,OAAe;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,CAAC,OAAe;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,OAAsB,EAAE,KAAoB;QAClD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,OAAO,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;AAC9E,CAAC"}

package/dist/core/sessions.d.ts

@@ -0,0 +1,83 @@
+import type { Reporter } from "./reporter.js";
+import type { SessionSettings } from "./settings.js";
+import { type SqliteDatabase } from "./sqlite.js";
+/**
+ * `event` and `event_sequence` are deliberately excluded. They are an internal
+ * append-only runtime log, they dwarf everything else in row count, and nothing
+ * about resuming a conversation on another machine depends on them.
+ */
+export interface SessionRecord {
+    id: string;
+    title: string;
+    directory: string;
+    timeUpdated: number;
+    timeCreated: number;
+    projectId: string;
+}
+export interface SessionShard {
+    formatVersion: 1;
+    session: Record<string, unknown>;
+    project?: Record<string, unknown>;
+    workspace?: Record<string, unknown>;
+    tables: Record<string, Record<string, unknown>[]>;
+    exportedAt: number;
+}
+export interface SelectOptions extends SessionSettings {
+    now?: number;
+}
+export interface ExportResult {
+    written: string[];
+    skippedTooLarge: {
+        id: string;
+        title: string;
+        bytes: number;
+    }[];
+    considered: number;
+    conflicts?: string[];
+}
+export interface ImportResult {
+    imported: number;
+    skippedOlder: number;
+    conflicts: {
+        sessionId: string;
+        reason: string;
+    }[];
+    failed: {
+        file: string;
+        reason: string;
+    }[];
+    backup?: string;
+    rolledBack?: boolean;
+    dryRun?: boolean;
+}
+export interface ImportOptions {
+    dryRun?: boolean;
+    preferRemote?: boolean;
+    backupBeforeImport?: boolean;
+    backupRetention?: number;
+    pathMappings?: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+/** Session ids are opaque; keep them filesystem-safe without losing identity. */
+export declare function sanitizeId(id: string): string;
+/**
+ * Choose which sessions to export.
+ *
+ * Explicitly included ids always win, even when they fall outside the window.
+ * Everything else must be inside the time window, pass the directory filter and
+ * survive the count cap, which keeps the newest sessions.
+ */
+export declare function selectSessions(db: SqliteDatabase, options: SelectOptions): SessionRecord[];
+type Mapping = {
+    from: string;
+    to: string;
+};
+export declare function exportSessions(file: string, repo: string, options: SelectOptions, reporter: Reporter): Promise<ExportResult>;
+export declare function acknowledgeExport(file: string, repo: string, mappings?: Mapping[]): Promise<void>;
+export declare function importSessions(file: string, repo: string, reporter: Reporter, options?: ImportOptions): Promise<ImportResult>;
+/** List sessions available locally, newest first - powers `sessions list`. */
+export declare function listSessions(databaseFile: string, limit: number): Promise<SessionRecord[]>;
+export {};
+//# sourceMappingURL=sessions.d.ts.map

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

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