@opencode-manager/ocm-cli 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,74 @@
+# ocm-cli
+
+OpenCode Manager CLI and plugin package.
+
+`ocm` lets a local OpenCode TUI attach to repos hosted by OpenCode Manager. It
+can also mirror a local git repo up to Manager or pull a Manager repo back down
+to the local working tree.
+
+## Install
+
+```bash
+pnpm add -g @opencode-manager/ocm-cli
+```
+
+The package exposes the `ocm` binary and an OpenCode plugin entrypoint. Global
+installs link the binary through the package manager. Local workspace installs
+also create a best-effort `~/.local/bin/ocm` symlink.
+
+## Login
+
+```bash
+ocm login <manager-url> [token]
+```
+
+The token is stored in macOS Keychain under the `opencode-manager` service. CLI
+state is stored at `~/.config/opencode-manager/state.json`.
+
+If `[token]` is omitted, `ocm login` reads it from hidden TTY input or stdin.
+
+## Commands
+
+```bash
+ocm
+ocm status
+ocm list
+ocm use <repoId|name>
+ocm push [--force] [--create] [--yes]
+ocm pull [--force]
+ocm logout
+```
+
+Running `ocm` with no command tries to match the current git repo's `origin`
+against ready Manager repos. If one repo matches, it attaches OpenCode to that
+Manager repo. If no repo matches, it falls back to the last selected repo, then
+to local `opencode`.
+
+`ocm use <repoId|name>` selects a Manager repo, remembers it as the last repo,
+and attaches OpenCode to it.
+
+`ocm push` uploads the current git repo to the matching Manager repo. Use
+`--create` to create a Manager repo when no origin match exists, and `--yes` to
+confirm creation in non-interactive shells.
+
+`ocm pull` replaces the current working tree with the matching Manager repo. It
+refuses to overwrite uncommitted local changes unless `--force` is passed.
+
+## OpenCode plugin
+
+The package default export is an OpenCode plugin entrypoint. Importing the
+plugin performs a best-effort local `ocm` symlink install and then returns an
+empty plugin object.
+
+```ts
+import ocm from '@opencode-manager/ocm-cli'
+
+export default [ocm]
+```
+
+## Requirements
+
+- `opencode` available on `PATH`
+- `git` and `tar` available on `PATH`
+- macOS `security` CLI for Keychain-backed token storage
+- An OpenCode Manager URL and bearer token

package/dist/ocm.js

@@ -95,6 +95,35 @@ function deleteToken(account) {
 }
 
 // src/manager-api.ts
+class ManagerApiError extends Error {
+  status;
+  code;
+  operation;
+  constructor(message, status, code, operation) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.operation = operation;
+    this.name = "ManagerApiError";
+  }
+}
+async function formatErrorResponse(res, operation) {
+  const text = await res.text().catch(() => "");
+  let code = null;
+  let detail = text;
+  if (text) {
+    try {
+      const parsed = JSON.parse(text);
+      const errField = typeof parsed.error === "string" ? parsed.error : null;
+      const msgField = typeof parsed.message === "string" ? parsed.message : null;
+      code = errField;
+      detail = msgField ?? errField ?? text;
+    } catch {}
+  }
+  const message = detail ? `${operation} failed (${res.status}): ${detail}` : `${operation} failed (${res.status})`;
+  return new ManagerApiError(message, res.status, code, operation);
+}
+
 class ManagerApi {
   baseUrl;
   token;
@@ -105,39 +134,58 @@ class ManagerApi {
   headers(extra = {}) {
     return { Authorization: `Bearer ${this.token}`, ...extra };
   }
-  async mirrorUp(repoId, body, opts) {
-    const params = new URLSearchParams;
-    if (opts.force)
-      params.set("force", "1");
+  async mirrorBegin(repoId, opts) {
+    const url = `${this.baseUrl}/api/internal/repos/${repoId}/mirror/begin`;
+    const body = { force: opts.force === true };
     if (opts.create) {
-      params.set("create", "1");
-      params.set("name", opts.create.name);
+      body.create = true;
+      body.name = opts.create.name;
       if (opts.create.originUrl)
-        params.set("originUrl", opts.create.originUrl);
+        body.originUrl = opts.create.originUrl;
       if (opts.create.branch)
-        params.set("branch", opts.create.branch);
+        body.branch = opts.create.branch;
     }
-    const qs = params.toString() ? `?${params.toString()}` : "";
-    const url = `${this.baseUrl}/api/internal/repos/${repoId}/mirror${qs}`;
     const res = await fetch(url, {
       method: "POST",
-      headers: {
-        ...this.headers(),
-        "Content-Type": "application/x-tar"
-      },
-      body,
-      duplex: "half"
+      headers: { ...this.headers(), "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok)
+      throw await formatErrorResponse(res, "mirror begin");
+    return await res.json();
+  }
+  async mirrorUploadPart(repoId, uploadId, index, chunk) {
+    const url = `${this.baseUrl}/api/internal/repos/${repoId}/mirror/parts/${uploadId}/${index}`;
+    const ab = chunk.buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength);
+    const res = await fetch(url, {
+      method: "PUT",
+      headers: { ...this.headers(), "Content-Type": "application/octet-stream" },
+      body: ab
+    });
+    if (!res.ok)
+      throw await formatErrorResponse(res, `mirror part ${index}`);
+  }
+  async mirrorCommit(repoId, uploadId, totalParts) {
+    const url = `${this.baseUrl}/api/internal/repos/${repoId}/mirror/commit`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: { ...this.headers(), "Content-Type": "application/json" },
+      body: JSON.stringify({ uploadId, totalParts })
     });
     if (!res.ok)
-      throw new Error(`mirror ${res.status}: ${await res.text()}`);
+      throw await formatErrorResponse(res, "mirror commit");
     return await res.json();
   }
+  async mirrorAbort(repoId, uploadId) {
+    const url = `${this.baseUrl}/api/internal/repos/${repoId}/mirror/uploads/${uploadId}`;
+    await fetch(url, { method: "DELETE", headers: this.headers() }).catch(() => {});
+  }
   async mirrorDown(repoId) {
     const res = await fetch(`${this.baseUrl}/api/internal/repos/${repoId}/mirror`, {
       headers: this.headers()
     });
     if (!res.ok)
-      throw new Error(`mirror ${res.status}: ${await res.text()}`);
+      throw await formatErrorResponse(res, "mirror download");
     return res.body;
   }
 }
@@ -191,7 +239,9 @@ function urlsEqual(a, b) {
 }
 
 // src/mirror.ts
-var HARDCODED_EXCLUDES = ["node_modules", "dist", ".next", ".venv", "__pycache__", ".turbo"];
+var HARDCODED_EXCLUDES = ["node_modules", "dist", ".next", ".venv", "__pycache__", ".turbo", ".DS_Store", "._*"];
+var PART_RETRIES = 3;
+var PART_BACKOFF_MS = [500, 2000, 8000];
 function getGitignoreExclusions(repoRoot) {
   const res = spawnSync3("git", ["ls-files", "--others", "--ignored", "--exclude-standard", "--directory"], {
     cwd: repoRoot,
@@ -219,7 +269,68 @@ function prepareMirror(cwd, remotes) {
   const matched = remotes.filter((r) => urlsEqual(localOrigin, r.originUrl));
   return { repoRoot, localOrigin, matched };
 }
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRetryablePartError(err) {
+  if (err instanceof ManagerApiError) {
+    return err.status >= 500 || err.status === 408 || err.status === 429;
+  }
+  return true;
+}
+async function uploadPartWithRetry(api, repoId, uploadId, index, chunk) {
+  let lastError;
+  for (let attempt = 0;attempt < PART_RETRIES; attempt++) {
+    try {
+      await api.mirrorUploadPart(repoId, uploadId, index, chunk);
+      return;
+    } catch (err) {
+      lastError = err;
+      if (!isRetryablePartError(err))
+        break;
+      if (attempt < PART_RETRIES - 1) {
+        await delay(PART_BACKOFF_MS[attempt]);
+      }
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(`part ${index} failed: ${String(lastError)}`);
+}
+function createPartFlusher(api, repoId, uploadId, chunkSize) {
+  let acc = [];
+  let accLen = 0;
+  let index = 0;
+  const flush = async () => {
+    if (accLen === 0)
+      return;
+    const buf = Buffer.concat(acc, accLen);
+    acc = [];
+    accLen = 0;
+    await uploadPartWithRetry(api, repoId, uploadId, index, buf);
+    index += 1;
+  };
+  return {
+    async push(buf) {
+      let offset = 0;
+      while (offset < buf.length) {
+        const room = chunkSize - accLen;
+        const take = Math.min(room, buf.length - offset);
+        acc.push(buf.subarray(offset, offset + take));
+        accLen += take;
+        offset += take;
+        if (accLen >= chunkSize) {
+          await flush();
+        }
+      }
+    },
+    async finish() {
+      await flush();
+      return index;
+    }
+  };
+}
 async function mirrorUp(plan, opts) {
+  const repoId = opts.create ? 0 : plan.matched[0].repoId;
+  const begin = await opts.api.mirrorBegin(repoId, { force: opts.force, create: opts.create });
   const tarArgs = ["-c", "-C", plan.repoRoot];
   for (const dir of HARDCODED_EXCLUDES)
     tarArgs.push("--exclude", dir);
@@ -232,7 +343,10 @@ async function mirrorUp(plan, opts) {
     tarArgs.push("--exclude-from", excludeFile);
   }
   tarArgs.push(".");
-  const child = spawn("tar", tarArgs, { stdio: ["pipe", "pipe", "pipe"] });
+  const child = spawn("tar", tarArgs, {
+    stdio: ["pipe", "pipe", "pipe"],
+    env: { ...process.env, COPYFILE_DISABLE: "1" }
+  });
   const stderrChunks = [];
   child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
   const tarExit = new Promise((resolve, reject) => {
@@ -246,17 +360,20 @@ async function mirrorUp(plan, opts) {
     });
     child.on("error", reject);
   });
-  const body = Readable.toWeb(child.stdout);
-  const repoId = opts.create ? 0 : plan.matched[0].repoId;
+  const flusher = createPartFlusher(opts.api, begin.repoId, begin.uploadId, begin.chunkSize);
   try {
-    const [result] = await Promise.all([
-      opts.api.mirrorUp(repoId, body, {
-        force: opts.force,
-        create: opts.create
-      }),
-      tarExit
-    ]);
+    for await (const chunk of child.stdout) {
+      await flusher.push(chunk);
+    }
+    await tarExit;
+    const totalParts = await flusher.finish();
+    const result = await opts.api.mirrorCommit(begin.repoId, begin.uploadId, totalParts);
     return result;
+  } catch (err) {
+    if (!child.killed)
+      child.kill("SIGKILL");
+    await opts.api.mirrorAbort(begin.repoId, begin.uploadId);
+    throw err;
   } finally {
     if (excludeFile) {
       await fsp.rm(excludeFile, { force: true }).catch(() => {});
@@ -344,8 +461,49 @@ function toTarget(last) {
     directory: last.directory
   };
 }
+// package.json
+var package_default = {
+  name: "@opencode-manager/ocm-cli",
+  version: "0.1.2",
+  description: "OpenCode Manager CLI: attach a local OpenCode TUI to a Manager-hosted repo.",
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/chriswritescode-dev/opencode-manager.git",
+    directory: "ocm-cli"
+  },
+  type: "module",
+  main: "./dist/plugin.js",
+  exports: {
+    ".": {
+      import: "./dist/plugin.js"
+    }
+  },
+  bin: {
+    ocm: "./dist/ocm.js"
+  },
+  files: [
+    "dist",
+    "README.md"
+  ],
+  scripts: {
+    build: "bun scripts/build.ts",
+    postinstall: "node scripts/postinstall.mjs || true",
+    typecheck: "tsc --noEmit",
+    test: "bun scripts/build.ts && vitest run",
+    "test:watch": "vitest",
+    prepublishOnly: "bun scripts/build.ts"
+  },
+  dependencies: {},
+  devDependencies: {
+    "@types/node": "^22.0.0",
+    typescript: "^5.5.0",
+    vitest: "^3.1.0"
+  }
+};
 
 // bin/ocm.ts
+var VERSION = package_default.version;
 var USAGE = `ocm - OpenCode Manager workspace launcher
 
 Usage:
@@ -359,6 +517,7 @@ Usage:
   ocm use <repoId|name>     Attach to a specific repo and remember it as last
   ocm push [--force] [--create] [--yes]   Mirror $PWD to the matching Manager repo (or create one)
   ocm pull [--force]                      Mirror the matching Manager repo over $PWD
+  ocm --version             Show the installed ocm version
   ocm --help                Show this help
 `;
 function die(msg, code = 1) {
@@ -478,9 +637,11 @@ async function cmdLogout() {
 async function cmdStatus() {
   const state = readState();
   if (!state) {
+    info(`version:      ${VERSION}`);
     info("no state. run: ocm login <url>");
     return;
   }
+  info(`version:      ${VERSION}`);
   info(`manager url:  ${state.managerUrl}`);
   info(`token in kc:  ${getToken(state.managerUrl) ? "yes" : "no"}`);
   if (state.lastRepoId !== undefined) {
@@ -672,6 +833,10 @@ async function main() {
     process.stdout.write(USAGE);
     return;
   }
+  if (cmd === "--version" || cmd === "-v" || cmd === "version") {
+    info(VERSION);
+    return;
+  }
   try {
     switch (cmd) {
       case undefined:

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@opencode-manager/ocm-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "OpenCode Manager CLI: attach a local OpenCode TUI to a Manager-hosted repo.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/chriswritescode-dev/opencode-manager.git",
+    "url": "https://github.com/chriswritescode-dev/opencode-manager.git",
     "directory": "ocm-cli"
   },
   "type": "module",
@@ -16,7 +16,7 @@
     }
   },
   "bin": {
-    "ocm": "dist/ocm.js"
+    "ocm": "./dist/ocm.js"
   },
   "files": [
     "dist",