@shoppingjaws/peer 0.1.0 → 0.1.1

package/dist/index.js

@@ -31,10 +31,15 @@ function initDb() {
 			from_pane_id TEXT NOT NULL,
 			to_pane_id TEXT NOT NULL,
 			relation TEXT NOT NULL CHECK(relation IN ('parent', 'child')),
+			description TEXT DEFAULT NULL,
 			created_at TEXT NOT NULL DEFAULT (datetime('now')),
 			PRIMARY KEY (session_id, from_pane_id, to_pane_id)
 		)
 	`);
+  const columns = db.prepare("PRAGMA table_info(peer_edges)").all();
+  if (!columns.some((c) => c.name === "description")) {
+    db.run("ALTER TABLE peer_edges ADD COLUMN description TEXT DEFAULT NULL");
+  }
   return db;
 }
 
@@ -82,11 +87,11 @@ function getPeerGroupPaneIds(db) {
   const rows = db.prepare("SELECT DISTINCT to_pane_id FROM peer_edges WHERE session_id = ? AND from_pane_id = ?").all(sessionId, myPaneId);
   return new Set(rows.map((r) => r.to_pane_id));
 }
-function registerPeerEdge(db, fromPaneId, toPaneId, relation) {
+function registerPeerEdge(db, fromPaneId, toPaneId, relation, description) {
   const sessionId = getSessionId();
   const reverseRelation = relation === "child" ? "parent" : "child";
-  db.prepare("INSERT OR IGNORE INTO peer_edges (session_id, from_pane_id, to_pane_id, relation) VALUES (?, ?, ?, ?)").run(sessionId, fromPaneId, toPaneId, relation);
-  db.prepare("INSERT OR IGNORE INTO peer_edges (session_id, from_pane_id, to_pane_id, relation) VALUES (?, ?, ?, ?)").run(sessionId, toPaneId, fromPaneId, reverseRelation);
+  db.prepare("INSERT OR IGNORE INTO peer_edges (session_id, from_pane_id, to_pane_id, relation, description) VALUES (?, ?, ?, ?, ?)").run(sessionId, fromPaneId, toPaneId, relation, description ?? null);
+  db.prepare("INSERT OR IGNORE INTO peer_edges (session_id, from_pane_id, to_pane_id, relation, description) VALUES (?, ?, ?, ?, ?)").run(sessionId, toPaneId, fromPaneId, reverseRelation, description ?? null);
 }
 function getPeerRelation(db, paneId) {
   const sessionId = getSessionId();
@@ -94,6 +99,12 @@ function getPeerRelation(db, paneId) {
   const row = db.prepare("SELECT relation FROM peer_edges WHERE session_id = ? AND from_pane_id = ? AND to_pane_id = ?").get(sessionId, myPaneId, paneId);
   return row?.relation ?? null;
 }
+function getPeerDescription(db, paneId) {
+  const sessionId = getSessionId();
+  const myPaneId = getMyPaneId();
+  const row = db.prepare("SELECT description FROM peer_edges WHERE session_id = ? AND from_pane_id = ? AND to_pane_id = ?").get(sessionId, myPaneId, paneId);
+  return row?.description ?? null;
+}
 
 // commands/clean.ts
 function cmdClean() {
@@ -146,10 +157,12 @@ async function cmdList() {
   const peerPaneIds = getPeerGroupPaneIds(db);
   const sameTabIds = new Set(panes.filter((p) => p.tab_id === myPane.tab_id).map((p) => p.pane_id));
   const visiblePanes = panes.filter((p) => sameTabIds.has(p.pane_id) || peerPaneIds.has(String(p.pane_id)));
-  console.log("WINID\tTABID\tPANEID\tRELATION\tWORKSPACE\tSIZE\tTITLE");
+  console.log("WINID\tTABID\tPANEID\tRELATION\tDESCRIPTION\tWORKSPACE\tSIZE\tTITLE");
   for (const p of visiblePanes) {
-    const relation = p.pane_id === Number(myPaneId) ? "self" : getPeerRelation(db, String(p.pane_id)) ?? "none";
-    console.log(`${p.window_id}	${p.tab_id}	${p.pane_id}	${relation}	${p.workspace}	${p.size}	${p.title}`);
+    const isSelf = p.pane_id === Number(myPaneId);
+    const relation = isSelf ? "self" : getPeerRelation(db, String(p.pane_id)) ?? "none";
+    const description = isSelf ? "" : getPeerDescription(db, String(p.pane_id)) ?? "";
+    console.log(`${p.window_id}	${p.tab_id}	${p.pane_id}	${relation}	${description}	${p.workspace}	${p.size}	${p.title}`);
   }
   db.close();
 }
@@ -160,12 +173,22 @@ async function cmdNewPane(args) {
   const myPaneId = getMyPaneId();
   const splitArgs = [];
   let commandArgs = [];
-  const separatorIndex = args.indexOf("--");
+  let description;
+  const filteredArgs = [];
+  for (let i = 0;i < args.length; i++) {
+    if (args[i] === "--description" && i + 1 < args.length) {
+      description = args[i + 1];
+      i++;
+    } else {
+      filteredArgs.push(args[i]);
+    }
+  }
+  const separatorIndex = filteredArgs.indexOf("--");
   if (separatorIndex >= 0) {
-    splitArgs.push(...args.slice(0, separatorIndex));
-    commandArgs = args.slice(separatorIndex + 1);
+    splitArgs.push(...filteredArgs.slice(0, separatorIndex));
+    commandArgs = filteredArgs.slice(separatorIndex + 1);
   } else {
-    splitArgs.push(...args);
+    splitArgs.push(...filteredArgs);
   }
   if (commandArgs.length > 0) {
     splitArgs.push("--", ...commandArgs);
@@ -177,7 +200,7 @@ async function cmdNewPane(args) {
     process.exit(1);
   }
   const db = initDb();
-  registerPeerEdge(db, myPaneId, newPaneId, "child");
+  registerPeerEdge(db, myPaneId, newPaneId, "child", description);
   db.close();
   console.log(`Created pane ${newPaneId} and added to peer group.`);
 }
@@ -188,12 +211,22 @@ async function cmdNewTab(args) {
   const myPaneId = getMyPaneId();
   const spawnArgs = [];
   let commandArgs = [];
-  const separatorIndex = args.indexOf("--");
+  let description;
+  const filteredArgs = [];
+  for (let i = 0;i < args.length; i++) {
+    if (args[i] === "--description" && i + 1 < args.length) {
+      description = args[i + 1];
+      i++;
+    } else {
+      filteredArgs.push(args[i]);
+    }
+  }
+  const separatorIndex = filteredArgs.indexOf("--");
   if (separatorIndex >= 0) {
-    spawnArgs.push(...args.slice(0, separatorIndex));
-    commandArgs = args.slice(separatorIndex + 1);
+    spawnArgs.push(...filteredArgs.slice(0, separatorIndex));
+    commandArgs = filteredArgs.slice(separatorIndex + 1);
   } else {
-    spawnArgs.push(...args);
+    spawnArgs.push(...filteredArgs);
   }
   if (commandArgs.length > 0) {
     spawnArgs.push("--", ...commandArgs);
@@ -205,7 +238,7 @@ async function cmdNewTab(args) {
     process.exit(1);
   }
   const db = initDb();
-  registerPeerEdge(db, myPaneId, newPaneId, "child");
+  registerPeerEdge(db, myPaneId, newPaneId, "child", description);
   db.close();
   console.log(`Created tab with pane ${newPaneId} and added to peer group.`);
 }
@@ -337,8 +370,8 @@ switch (command) {
     console.log("  list                   List panes (same tab + peer group)");
     console.log("  peek <pane-id>         Read terminal text from a pane");
     console.log("  inbox <open|send>      Manage inbox messages");
-    console.log("  new-pane [opts] [-- cmd]  Split a new pane in current tab");
-    console.log("  new-tab  [opts] [-- cmd]  Spawn a new tab and add to peer group");
+    console.log("  new-pane [opts] [--description text] [-- cmd]  Split a new pane");
+    console.log("  new-tab  [opts] [--description text] [-- cmd]  Spawn a new tab");
     console.log("  history [pane-id]      Show message history");
     console.log("  clean                  Reset the message database");
     process.exit(command ? 1 : 0);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@shoppingjaws/peer",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"description": "CLI tool for managing wezterm panes, peer groups, and inter-pane messaging",
 	"type": "module",
 	"bin": {