opencode-multidevice-sync 0.1.0

package/docs/SAFETY.md

@@ -0,0 +1,31 @@
+# Safety model and limits
+
+## Database boundaries
+
+Live databases and journals stay local. Export reads a SQLite snapshot transaction and writes one canonical compressed JSON shard per selected session. Import validates supported tables, row ownership and columns. Existing projects are not replaced. Messages are inserted before parts, and a single transaction covers the import batch. Integrity is checked before COMMIT; a failure rolls back the transaction, not the database file underneath another process.
+
+Before a non-empty import, `VACUUM INTO` creates a separate consistent snapshot by default. The snapshot is checked before it is accepted as a backup. Retention defaults to ten verified snapshots; failed backup creation blocks import. Backups can contain the entire private conversation history and must be protected like the original database.
+
+Manual restore requires explicit offline confirmation, checks for OpenCode processes in the CLI, and refuses existing WAL/SHM/journal files. OS process checks are best-effort, so users must still ensure every database client is closed. No routine import replaces the live database file.
+
+## Conflicts
+
+Local content baselines live beside the database in `.omds-bases.json`, outside Git. Hashes include session metadata and child rows. A two-sided change or an unknown divergent baseline blocks the batch. This is conflict detection, not a CRDT or an automatic conversation merge. Incoming snapshots that would silently drop existing child rows are refused.
+
+## Git and privacy
+
+Only use trusted private repositories. Verification of sensitive GitHub sync uses `gh`. Local filesystem remotes are allowed for tests/development, not treated as cloud privacy guarantees. Local configuration backups are created before pull changes. Ordinary Git conflicts preserve a stash for manual recovery.
+
+Credential-file sync is off by default. Known credential/runtime filenames and some inline JSON secrets are blocked on push. This is a heuristic, not comprehensive DLP: secrets in prose, tool output, arbitrary scripts, Git history or binary data may remain. No end-to-end encryption is implemented.
+
+Synced plugins and skills can execute code. Anyone with write access to your sync repository is therefore trusted with your OpenCode environment. Do not add unknown collaborators or consume unreviewed sync repositories.
+
+## Preview and concurrency
+
+Dry-run uses a disposable copy and does not update the original Git worktree or session DB. It can require significant temporary disk space. `extraPaths` previews are deliberately refused.
+
+The lock coordinates processes on one computer only. Use one active device. Git rejects conflicting branch updates, but there is no distributed ownership lease or safe simultaneous editing guarantee. Auto-push waits for startup pull and reports errors; it is not a background system service and cannot finish after the application is terminated.
+
+## Compatibility
+
+The initial target is OpenCode 1.18.30 on Windows with Node 22.13+ or 24. Node and OS combinations covered by CI are listed in the workflow. Real Desktop behavior and new OpenCode schemas require separate acceptance testing. Passing tests is not a guarantee against every form of data loss.

package/examples/home-laptop.jsonc

@@ -0,0 +1,31 @@
+{
+  "repo": {
+    "owner": "YOUR_GITHUB_ACCOUNT",
+    "name": "my-opencode-config",
+    "branch": "main"
+  },
+  "machineAlias": "home-laptop",
+  "includeCredentials": false,
+  "includeSkills": true,
+  "includeState": false,
+  "extraPaths": [],
+  "sessions": {
+    "enabled": true,
+    "days": 30,
+    "maxSessions": 50,
+    "maxSessionBytes": 5242880,
+    "include": [],
+    "exclude": [],
+    "directories": [],
+    "backupBeforeImport": true,
+    "backupRetention": 10,
+    "pathMappings": [
+      {
+        "from": "C:/Projects",
+        "to": "D:/Projects"
+      }
+    ]
+  },
+  "autoPullOnStartup": true,
+  "autoPushOnIdle": false
+}

package/examples/opencode-sync.overrides.jsonc

@@ -0,0 +1,4 @@
+// Machine-local only. Never commit to your sync repository.
+{
+  "instructions": ["C:/Users/YOU/.config/opencode/AGENTS.md"]
+}

package/examples/work-laptop.jsonc

@@ -0,0 +1,26 @@
+{
+  "repo": {
+    "owner": "YOUR_GITHUB_ACCOUNT",
+    "name": "my-opencode-config",
+    "branch": "main"
+  },
+  "machineAlias": "work-laptop",
+  "includeCredentials": false,
+  "includeSkills": true,
+  "includeState": false,
+  "extraPaths": [],
+  "sessions": {
+    "enabled": true,
+    "days": 30,
+    "maxSessions": 50,
+    "maxSessionBytes": 5242880,
+    "include": [],
+    "exclude": [],
+    "directories": [],
+    "backupBeforeImport": true,
+    "backupRetention": 10,
+    "pathMappings": []
+  },
+  "autoPullOnStartup": true,
+  "autoPushOnIdle": false
+}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "opencode-multidevice-sync",
+  "version": "0.1.0",
+  "description": "Reliable multi-device synchronization for OpenCode configuration, sessions, skills and plugins with safety checks, backups and recovery.",
+  "type": "module",
+  "license": "MIT",
+  "author": "logser13 and contributors",
+  "homepage": "https://github.com/logser13/opencode-multidevice-sync#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/logser13/opencode-multidevice-sync.git"
+  },
+  "bugs": {
+    "url": "https://github.com/logser13/opencode-multidevice-sync/issues"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "sync",
+    "multi-device",
+    "session-sync",
+    "config-sync",
+    "backup",
+    "sqlite",
+    "github",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "main": "./dist/plugin/index.js",
+  "types": "./dist/plugin/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/plugin/index.d.ts",
+      "default": "./dist/plugin/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "opencode-multidevice-sync": "./dist/cli/index.js",
+    "omds": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.ru.md",
+    "LICENSE",
+    "NOTICE",
+    "docs/*.md",
+    "examples/*.jsonc"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check src tests",
+    "lint:fix": "biome check --write src tests",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run lint && npm run typecheck && npm run build && npm run test",
+    "prepublishOnly": "npm run check && npm run build",
+    "test:regressions": "vitest run tests/regressions.test.ts",
+    "pack:check": "npm pack --dry-run",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.11",
+    "vite": "^6.4.3"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "1.18.30"
+  }
+}