@surething/cockpit 1.0.216 → 1.0.217

package/.next-prod/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":20691327,"timestamp":204749108,"id":14,"parentId":1,"tags":{},"startTime":1779801780173,"traceId":"2868cd35fd02ca16"},{"name":"run-typescript","duration":16713005,"timestamp":225450994,"id":1519,"parentId":1,"tags":{},"startTime":1779801800875,"traceId":"2868cd35fd02ca16"},{"name":"static-check","duration":1098623,"timestamp":242207653,"id":1522,"parentId":1,"tags":{},"startTime":1779801817632,"traceId":"2868cd35fd02ca16"},{"name":"static-generation","duration":6111104,"timestamp":243692459,"id":1778,"parentId":1,"tags":{},"startTime":1779801819116,"traceId":"2868cd35fd02ca16"},{"name":"collect-build-traces","duration":18808913,"timestamp":243307085,"id":1775,"parentId":1,"tags":{},"startTime":1779801818731,"traceId":"2868cd35fd02ca16"},{"name":"telemetry-flush","duration":54,"timestamp":262119910,"id":1787,"parentId":1,"tags":{},"startTime":1779801837544,"traceId":"2868cd35fd02ca16"},{"name":"next-build","duration":57539004,"timestamp":204580974,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1779801780005,"traceId":"2868cd35fd02ca16"}]
+[{"name":"run-webpack","duration":19799218,"timestamp":143062609,"id":14,"parentId":1,"tags":{},"startTime":1779817892339,"traceId":"98826c66cc2d55a4"},{"name":"run-typescript","duration":16474894,"timestamp":162871841,"id":1519,"parentId":1,"tags":{},"startTime":1779817912148,"traceId":"98826c66cc2d55a4"},{"name":"static-check","duration":1046300,"timestamp":179379791,"id":1522,"parentId":1,"tags":{},"startTime":1779817928656,"traceId":"98826c66cc2d55a4"},{"name":"static-generation","duration":5774227,"timestamp":180539499,"id":1778,"parentId":1,"tags":{},"startTime":1779817929815,"traceId":"98826c66cc2d55a4"},{"name":"collect-build-traces","duration":18014017,"timestamp":180426813,"id":1775,"parentId":1,"tags":{},"startTime":1779817929703,"traceId":"98826c66cc2d55a4"},{"name":"telemetry-flush","duration":57,"timestamp":198445089,"id":1787,"parentId":1,"tags":{},"startTime":1779817947721,"traceId":"98826c66cc2d55a4"},{"name":"next-build","duration":55513834,"timestamp":142931325,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1779817892207,"traceId":"98826c66cc2d55a4"}]

package/README.md

@@ -179,8 +179,9 @@ npm run setup       # build + npm link (registers `cockpit` and `cock`)
 ```bash
 cockpit browser <id> snapshot      # capture accessibility tree
 cockpit browser <id> click <uid>   # click element
-cockpit terminal <id> exec "ls"    # execute command
-cockpit terminal <id> output       # get terminal output
+cockpit terminal list              # list terminal bubbles
+cockpit terminal <id> output       # read terminal output (filter, cursor)
+cockpit connection list --cwd .    # list ALL bubbles (term + browser) with user-set titles
 ```
 
 ## Read more

package/README.zh.md

@@ -179,8 +179,9 @@ npm run setup       # 构建 + npm link（注册 `cockpit` 与 `cock` 命令）
 ```bash
 cockpit browser <id> snapshot      # 获取页面元素树
 cockpit browser <id> click <uid>   # 点击元素
-cockpit terminal <id> exec "ls"    # 执行命令
-cockpit terminal <id> output       # 获取终端输出
+cockpit terminal list              # 列出终端气泡
+cockpit terminal <id> output       # 读取终端输出（支持过滤、游标）
+cockpit connection list --cwd .    # 列出当前项目所有气泡（terminal + browser）含用户起的 title
 ```
 
 ## 阅读更多

package/bin/cock-codegraph.mjs

@@ -181,11 +181,17 @@ async function cmdSearch() {
   const pos = positional(subArgs);
   const q = pos[0];
   const limit = getInt(subArgs, '--limit') ?? 15;
+  // v1.0.216+: opt-in flag to also surface identifier-shaped string literals
+  // (tool names / event names / config keys / route paths) that only exist
+  // in source as strings, never as identifiers.
+  const includeLiterals = subArgs.includes('--include-literals');
   if (!q) {
     stderr.write('codegraph search: missing <query>\n');
     exit(2);
   }
-  const resp = await get('/api/projectGraph/search', { q, limit });
+  const params = { q, limit };
+  if (includeLiterals) params.includeLiterals = 'true';
+  const resp = await get('/api/projectGraph/search', params);
   const data = await resp.json();
   if (wantJson) { emitJson(data); exit(0); }
 
@@ -616,15 +622,22 @@ Examples:
 // call (which runs before this declaration is reached in module order)
 // doesn't hit a const TDZ.
 function getSubHelp() { return {
-  search: `Usage: cock codegraph search <query> [--limit N=15] [--json]
+  search: `Usage: cock codegraph search <query> [--limit N=15] [--include-literals] [--json]
 
 Purpose:  Find symbols (and files) matching a name fragment. Tokenised
-          match across name + qualifiedName + filePath. Use this when
-          you know the symbol's name but not its location.
+          match across name + qualifiedName + filePath, with case +
+          word-separator folding (so 'build_code_index' ↔ 'buildCodeIndex'
+          ↔ 'BUILD-CODE-INDEX' all collide). Use this when you know the
+          symbol's name but not its location.
 
 Flags:
-  --limit N        Max symbol hits to return (default 15)
-  --json           Emit raw JSON {files: [...], symbols: [...]}
+  --limit N            Max symbol hits to return (default 15)
+  --include-literals   Also search identifier-shaped string literals
+                       in source (tool names / event names / config
+                       keys / route paths). Off by default to keep
+                       results lean. Surfaces names that never appear
+                       as identifiers, only as strings.
+  --json               Emit raw JSON {files: [...], symbols: [...]}
 
 Output (plain, TAB-separated):
   sym <TAB> <file>:<line> <TAB> <kind> <TAB> <qname>
@@ -636,7 +649,9 @@ Exit: 0=hits, 1=no hits, 2=usage, 3=server unreachable
 
 Examples:
   cock codegraph search getCodeIndex
+  cock codegraph search build_code_index             # snake-case query, still finds buildCodeIndex
   cock codegraph search useChatStore --limit 5
+  cock codegraph search 'agent.fork' --include-literals    # find a name hiding in a literal
   cock codegraph search authenticate --json | jq '.symbols[].target'`,
 
   callers: `Usage: cock codegraph callers <qname> [--file PATH] [--json]

package/bin/cock-connection.mjs

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+/**
+ * cockpit connection — cross-type bubble enumeration.
+ *
+ * One subcommand:
+ *
+ *   cockpit connection list [--cwd PATH] [--all] [--json]
+ *
+ * Returns a unified listing of terminal + browser bubbles, each with the
+ * user-set `title` (if any). Designed for /cc slash mode and ad-hoc
+ * "what bubbles exist in this project" lookups before driving them via
+ * `cockpit terminal <id> ...` / `cockpit browser <id> ...`.
+ *
+ * By default only alive bubbles (running terminal / connected browser)
+ * are returned. Pass `--all` to include stale entries.
+ */
+import { readFileSync } from 'fs';
+import { join, resolve } from 'path';
+import { homedir } from 'os';
+
+const argv = process.argv.slice(2);
+
+function readServerPort() {
+  try {
+    return JSON.parse(readFileSync(join(homedir(), '.cockpit', 'server.json'), 'utf8')).port;
+  } catch {
+    return null;
+  }
+}
+
+const port = process.env.COCKPIT_PORT || readServerPort() || 3457;
+const baseUrl = `http://localhost:${port}`;
+
+const { stdout, stderr, exit } = process;
+
+function printHelp() {
+  stdout.write(`Usage: cock connection list [--cwd PATH] [--all] [--json]
+
+Purpose:  Enumerate all bubbles (terminal + browser) across the running
+          Cockpit server. Each entry carries the user-set title if any
+          (set via the ✎ button next to the bubble's short id), so an
+          LLM can map cryptic 4-char ids to human-meaningful purposes.
+
+Subcommands:
+  list                List bubbles (the only subcommand)
+
+Flags:
+  --cwd PATH          Only list bubbles whose project cwd matches PATH
+                      (canonicalised). Use \$PWD to scope to the
+                      current shell.
+  --all               Include dead entries (exited terminals,
+                      disconnected browsers). Off by default.
+  --json              Emit raw JSON instead of TAB-separated lines.
+
+Output (plain, TAB-separated):
+  <type> <TAB> <shortId> <TAB> <title-or-(none)> <TAB> <projectCwd-or-?> <TAB> <command-or-empty>
+
+JSON: array of { type, shortId, title?, projectCwd?, tabId?, command?, alive }
+
+Exit: 0=hits, 1=no bubbles, 2=usage, 3=server unreachable
+
+Examples:
+  cockpit connection list                     # all alive bubbles
+  cockpit connection list --cwd \$PWD         # this project only
+  cockpit connection list --all --json | jq   # everything, programmatic
+`);
+}
+
+if (argv.length === 0 || argv.includes('--help') || argv.includes('-h')) {
+  printHelp();
+  exit(0);
+}
+
+const sub = argv[0];
+if (sub !== 'list') {
+  stderr.write(`Unknown subcommand: ${sub}\n`);
+  stderr.write(`Run \`cockpit connection --help\` to see usage.\n`);
+  exit(2);
+}
+
+// Parse list-subcommand flags.
+const rest = argv.slice(1);
+const flags = { cwd: undefined, all: false, json: false };
+for (let i = 0; i < rest.length; i++) {
+  const tok = rest[i];
+  if (tok === '--all') flags.all = true;
+  else if (tok === '--json') flags.json = true;
+  else if (tok === '--cwd') {
+    flags.cwd = rest[++i];
+    if (!flags.cwd) {
+      stderr.write('Missing value for --cwd\n');
+      exit(2);
+    }
+  } else if (tok === '--help' || tok === '-h') {
+    printHelp();
+    exit(0);
+  } else {
+    stderr.write(`Unknown flag: ${tok}\n`);
+    exit(2);
+  }
+}
+
+// Hit the server.
+let data;
+try {
+  const body = {};
+  if (flags.cwd) body.cwd = resolve(flags.cwd);
+  if (flags.all) body.all = true;
+  const res = await fetch(`${baseUrl}/api/connection/list`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(10_000),
+  });
+  const j = await res.json().catch(() => null);
+  if (!res.ok || !j?.ok) {
+    stderr.write(`HTTP ${res.status}: ${j?.error || 'unknown error'}\n`);
+    exit(3);
+  }
+  data = j.data;
+} catch (err) {
+  if (err?.cause?.code === 'ECONNREFUSED') {
+    stderr.write(`Connection refused: Cockpit server not running at ${baseUrl}\n`);
+  } else {
+    stderr.write(`Error: ${err.message}\n`);
+  }
+  exit(3);
+}
+
+if (!Array.isArray(data) || data.length === 0) {
+  // Empty list — exit 1 so callers can short-circuit cleanly.
+  exit(1);
+}
+
+if (flags.json) {
+  stdout.write(JSON.stringify({ connections: data }, null, 2) + '\n');
+  exit(0);
+}
+
+// Plain text: TAB-separated, one line per bubble.
+//   <type>  <shortId>  <title>  <projectCwd>  <command-or-empty>
+const TYPE_LABEL = { terminal: 'term', browser: 'brow' };
+for (const c of data) {
+  const type = TYPE_LABEL[c.type] || c.type;
+  const title = c.title || '(none)';
+  const cwd = c.projectCwd || '?';
+  const command = (c.command || '').replace(/\s+/g, ' ').slice(0, 120);
+  stdout.write(`${type}\t${c.shortId}\t${title}\t${cwd}\t${command}\n`);
+}
+exit(0);

package/bin/cock.mjs

@@ -22,6 +22,7 @@ Commands:
   browser <id> <action>          Control browser bubbles
   terminal <id> <action>         Control terminal bubbles
   codegraph <subcmd> [...]       Query the project code graph (search/risk/affected/...)
+  connection list [--cwd …]      List all bubbles (term + browser) with user-set titles
   update                         Update to latest version
 
 Options:
@@ -101,6 +102,16 @@ if (process.argv[2] === 'codegraph') {
   await flushAndExit(0);
 }
 
+if (process.argv[2] === 'connection') {
+  process.argv.splice(2, 1);
+  // cock-connection.mjs handles flow + exit itself (single subcmd, simple).
+  await import('./cock-connection.mjs');
+  // import() resolves when the module finishes top-level await; that script
+  // already calls process.exit() on its own paths, so this fallback only
+  // fires for the 0-exit happy path that finished normally.
+  await flushAndExit(0);
+}
+
 if (process.argv[2] === 'update') {
   console.log('Updating @surething/cockpit...');
   const result = spawnSync('npm', ['install', '-g', '@surething/cockpit@latest'], { stdio: 'inherit' });
@@ -118,7 +129,7 @@ if (process.argv[2] === 'update') {
 const { existsSync, mkdirSync } = await import('fs');
 const { homedir } = await import('os');
 
-const knownCommands = new Set(['browser', 'terminal', 'update', 'help', 'codegraph']);
+const knownCommands = new Set(['browser', 'terminal', 'update', 'help', 'codegraph', 'connection']);
 const arg = process.argv[2];
 let projectDir = null;
 

package/bin/setup-dev.mjs

@@ -27,7 +27,6 @@
 import { existsSync, lstatSync, unlinkSync, symlinkSync, chmodSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { execSync } from 'node:child_process';
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 const REPO_ROOT = resolve(SCRIPT_DIR, '..');
@@ -39,15 +38,18 @@ if (!existsSync(SOURCE)) {
   process.exit(1);
 }
 
-// Resolve global npm bin dir.
-let prefix;
-try {
-  prefix = execSync('npm config get prefix', { encoding: 'utf8' }).trim();
-} catch (err) {
-  console.error('✗ Failed to resolve npm prefix:', err?.message);
-  process.exit(1);
-}
-const TARGET = resolve(prefix, 'bin/cockpit-dev');
+// Resolve the bin dir from process.execPath rather than `npm config get
+// prefix`. Why: `sudo npm run setup-dev` runs npm under root's env, where
+// `npm config get prefix` can resolve to a DIFFERENT path than the user's
+// non-sudo npm (because of /root/.npmrc, HOME differences, or sudo's
+// secure_path stripping). process.execPath is just `node`'s own absolute
+// path — node lives at `<prefix>/bin/node` on every normal install
+// (brew, nvm, manual), so `dirname(dirname(execPath))` gives the right
+// prefix regardless of sudo.
+//
+// Override with COCKPIT_BIN_DIR=... if you've got an exotic layout.
+const BIN_DIR = process.env.COCKPIT_BIN_DIR || dirname(process.execPath);
+const TARGET = resolve(BIN_DIR, 'cockpit-dev');
 
 // Ensure source is executable.
 try {
@@ -72,9 +74,9 @@ try {
 } catch (err) {
   if (err?.code === 'EACCES' || err?.code === 'EPERM') {
     console.error(`✗ Permission denied creating ${TARGET}`);
-    console.error(`  Either: sudo ln -sf ${SOURCE} ${TARGET}`);
-    console.error(`  Or:     configure npm prefix to a user-writable dir`);
-    console.error(`           (e.g. npm config set prefix ~/.npm-global)`);
+    console.error(`  Run with sudo: sudo npm run setup-dev`);
+    console.error(`  Or one-liner:  sudo ln -sf ${SOURCE} ${TARGET}`);
+    console.error(`  Or override:   COCKPIT_BIN_DIR=~/.local/bin npm run setup-dev`);
     process.exit(1);
   }
   console.error(`✗ Failed:`, err?.message);