gitspace 0.2.0-rc.1

package/experiments/router/test.ts

@@ -0,0 +1,133 @@
+#!/usr/bin/env bun
+/**
+ * Test router + session architecture (single client per session)
+ */
+
+import {
+  ROUTER_SOCKET,
+  type RouterCommand,
+  type RouterResponse,
+  encodeControl,
+  isControl,
+  decodeControl,
+  type SessionEvent,
+} from "./protocol";
+
+async function routerCommand(cmd: RouterCommand): Promise<RouterResponse> {
+  return new Promise(async (resolve, reject) => {
+    const socket = await Bun.connect({
+      unix: ROUTER_SOCKET,
+      socket: {
+        data(socket, data) {
+          resolve(JSON.parse(data.toString()));
+          socket.end();
+        },
+        error(socket, error) {
+          reject(error);
+        },
+      }
+    });
+    socket.write(JSON.stringify(cmd));
+  });
+}
+
+console.log("=== Testing Router Architecture (Single Client) ===\n");
+
+// 1. Create a session
+console.log("1. Create session test/workspace-1");
+const create1 = await routerCommand({
+  type: "create",
+  project: "test",
+  workspace: "workspace-1",
+  cwd: process.cwd()
+});
+console.log("   Response:", create1.type);
+if (create1.type !== "created") process.exit(1);
+const session1 = create1.session;
+
+// 2. Connect a client
+console.log("\n2. Connect client to session");
+let client1Kicked = false;
+const client1 = await Bun.connect({
+  unix: session1.socketPath,
+  socket: {
+    data(socket, data) {
+      const buf = Buffer.from(data);
+      if (isControl(buf)) {
+        const event = decodeControl(buf) as SessionEvent;
+        if (event.type === "kicked") {
+          client1Kicked = true;
+          console.log("   Client 1 received: kicked");
+        }
+      }
+    }
+  }
+});
+await Bun.sleep(100);
+
+// 3. Check attached state
+console.log("\n3. Check session is attached");
+const list1 = await routerCommand({ type: "list" });
+const attached = (list1 as any).sessions[0]?.attached;
+console.log("   Attached:", attached ? "✓" : "✗");
+
+// 4. Try to create same session again (should return already-attached)
+console.log("\n4. Try to create same session again");
+const create2 = await routerCommand({
+  type: "create",
+  project: "test",
+  workspace: "workspace-1",
+  cwd: process.cwd()
+});
+console.log("   Response:", create2.type, create2.type === "already-attached" ? "✓" : "✗");
+
+// 5. Take over with kick
+console.log("\n5. Take over session (kick client 1)");
+const attach = await routerCommand({
+  type: "attach",
+  sessionId: session1.id,
+  mode: "take-over"
+});
+console.log("   Response:", attach.type);
+await Bun.sleep(100);
+console.log("   Client 1 was kicked:", client1Kicked ? "✓" : "✗");
+
+// 6. Connect new client after kick
+console.log("\n6. Connect new client after kick");
+const client2 = await Bun.connect({
+  unix: session1.socketPath,
+  socket: { data() {} }
+});
+await Bun.sleep(100);
+
+// 7. Detach client 2, check session still exists
+console.log("\n7. Detach client 2");
+client2.write(encodeControl({ type: "detach" }));
+await Bun.sleep(100);
+
+const list2 = await routerCommand({ type: "list" });
+const stillExists = (list2 as any).sessions.length === 1;
+const nowDetached = !(list2 as any).sessions[0]?.attached;
+console.log("   Session still exists:", stillExists ? "✓" : "✗");
+console.log("   Now detached:", nowDetached ? "✓" : "✗");
+
+// 8. Reattach to detached session (no prompt needed)
+console.log("\n8. Reattach to detached session");
+const create3 = await routerCommand({
+  type: "create",
+  project: "test",
+  workspace: "workspace-1",
+  cwd: process.cwd()
+});
+console.log("   Response:", create3.type, create3.type === "created" ? "✓" : "✗");
+
+// 9. Clean up
+console.log("\n9. Kill session");
+const kill = await routerCommand({ type: "kill", sessionId: session1.id });
+console.log("   Response:", kill.type);
+
+const list3 = await routerCommand({ type: "list" });
+console.log("   Sessions remaining:", (list3 as any).sessions.length);
+
+console.log("\n=== Test Complete ===");
+process.exit(0);

package/experiments/socket-bandwidth.ts

@@ -0,0 +1,77 @@
+/**
+ * Unix socket bandwidth test
+ * How much can we push through a single socket?
+ */
+import { unlinkSync } from "fs";
+
+const SOCKET_PATH = "/tmp/spaces-bw.sock";
+try { unlinkSync(SOCKET_PATH); } catch {}
+
+const CHUNK_SIZE = 64 * 1024; // 64KB chunks
+const TEST_DURATION_MS = 2000;
+
+let totalBytes = 0;
+let messageCount = 0;
+
+const server = Bun.listen({
+  unix: SOCKET_PATH,
+  socket: {
+    data(socket, data) {
+      totalBytes += data.byteLength;
+      messageCount++;
+      // Echo back (simulates bidirectional)
+      socket.write(data);
+    },
+  }
+});
+
+await Bun.sleep(50);
+
+const chunk = Buffer.alloc(CHUNK_SIZE, "x");
+let clientReceived = 0;
+
+const client = await Bun.connect({
+  unix: SOCKET_PATH,
+  socket: {
+    data(socket, data) {
+      clientReceived += data.byteLength;
+    },
+    drain(socket) {
+      // Socket ready for more data - keep pumping
+      socket.write(chunk);
+    }
+  }
+});
+
+console.log("Testing Unix socket bandwidth (bidirectional)...\n");
+
+const start = performance.now();
+
+// Prime the pump
+for (let i = 0; i < 100; i++) {
+  client.write(chunk);
+}
+
+await Bun.sleep(TEST_DURATION_MS);
+
+const elapsed = (performance.now() - start) / 1000;
+const serverThroughput = (totalBytes / 1024 / 1024) / elapsed;
+const clientThroughput = (clientReceived / 1024 / 1024) / elapsed;
+
+console.log("=== Single Socket Bandwidth ===");
+console.log(`Server received: ${(totalBytes / 1024 / 1024).toFixed(0)} MB`);
+console.log(`Client received: ${(clientReceived / 1024 / 1024).toFixed(0)} MB`);
+console.log(`Server throughput: ${serverThroughput.toFixed(0)} MB/s`);
+console.log(`Client throughput: ${clientThroughput.toFixed(0)} MB/s`);
+console.log(`Messages: ${messageCount}`);
+console.log(`Avg chunk: ${(totalBytes / messageCount / 1024).toFixed(1)} KB`);
+
+// Context
+console.log("\n=== Context ===");
+console.log(`4K terminal @ 60fps: ~${(4000 * 60 * 60 / 1024 / 1024).toFixed(1)} MB/s worst case`);
+console.log(`Typical terminal use: < 1 MB/s`);
+console.log(`10 concurrent sessions: < 10 MB/s`);
+
+server.stop();
+client.end();
+try { unlinkSync(SOCKET_PATH); } catch {}

package/homebrew/gitspace.rb

@@ -0,0 +1,45 @@
+# Homebrew formula for GitSpace CLI (gssh)
+#
+# To install from a tap:
+#   brew tap inkibra/gitspace
+#   brew install gitspace
+#
+# Or install directly from this file:
+#   brew install --formula homebrew/gitspace.rb
+
+class Gitspace < Formula
+  desc "CLI for managing GitHub workspaces with git worktrees and secure remote terminal access"
+  homepage "https://gitspace.sh"
+  version "0.1.5"
+  license "SEE LICENSE IN LICENSE"
+
+  on_macos do
+    on_arm do
+      url "https://github.com/inkibra/gitspace.sh/releases/download/v#{version}/gssh-darwin-arm64.tar.gz"
+      # sha256 "REPLACE_WITH_ACTUAL_SHA256"
+    end
+    on_intel do
+      url "https://github.com/inkibra/gitspace.sh/releases/download/v#{version}/gssh-darwin-x64.tar.gz"
+      # sha256 "REPLACE_WITH_ACTUAL_SHA256"
+    end
+  end
+
+  on_linux do
+    on_arm do
+      url "https://github.com/inkibra/gitspace.sh/releases/download/v#{version}/gssh-linux-arm64.tar.gz"
+      # sha256 "REPLACE_WITH_ACTUAL_SHA256"
+    end
+    on_intel do
+      url "https://github.com/inkibra/gitspace.sh/releases/download/v#{version}/gssh-linux-x64.tar.gz"
+      # sha256 "REPLACE_WITH_ACTUAL_SHA256"
+    end
+  end
+
+  def install
+    bin.install "gssh"
+  end
+
+  test do
+    assert_match "gssh", shell_output("#{bin}/gssh --version")
+  end
+end

package/landing-page/ATTRIBUTIONS.md

@@ -0,0 +1,3 @@
+This Figma Make file includes components from [shadcn/ui](https://ui.shadcn.com/) used under [MIT license](https://github.com/shadcn-ui/ui/blob/main/LICENSE.md).
+
+This Figma Make file includes photos from [Unsplash](https://unsplash.com) used under [license](https://unsplash.com/license).

package/landing-page/README.md

@@ -0,0 +1,11 @@
+
+  # Landing Page Design
+
+  This is a code bundle for Landing Page Design. The original project is available at https://www.figma.com/design/X1VjullY3NR4Kh5s63m6JS/Landing-Page-Design.
+
+  ## Running the code
+
+  Run `npm i` to install the dependencies.
+
+  Run `npm run dev` to start the development server.
+