@surething/cockpit 1.0.232 → 1.0.234

package/.next-prod/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":21093023,"timestamp":158697893,"id":14,"parentId":1,"tags":{},"startTime":1782900947547,"traceId":"dcd58a4bd7b49062"},{"name":"run-typescript","duration":18807400,"timestamp":179794924,"id":1603,"parentId":1,"tags":{},"startTime":1782900968644,"traceId":"dcd58a4bd7b49062"},{"name":"static-check","duration":1213527,"timestamp":198644615,"id":1606,"parentId":1,"tags":{},"startTime":1782900987494,"traceId":"dcd58a4bd7b49062"},{"name":"static-generation","duration":6335613,"timestamp":200113230,"id":1878,"parentId":1,"tags":{},"startTime":1782900988963,"traceId":"dcd58a4bd7b49062"},{"name":"collect-build-traces","duration":21023731,"timestamp":199858733,"id":1875,"parentId":1,"tags":{},"startTime":1782900988708,"traceId":"dcd58a4bd7b49062"},{"name":"telemetry-flush","duration":92,"timestamp":220886988,"id":1887,"parentId":1,"tags":{},"startTime":1782901009736,"traceId":"dcd58a4bd7b49062"},{"name":"next-build","duration":62368455,"timestamp":158518639,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1782900947368,"traceId":"dcd58a4bd7b49062"}]
+[{"name":"run-webpack","duration":20216814,"timestamp":210001581,"id":14,"parentId":1,"tags":{},"startTime":1782998700158,"traceId":"01c8448817b155b6"},{"name":"run-typescript","duration":18380914,"timestamp":230222194,"id":1604,"parentId":1,"tags":{},"startTime":1782998720378,"traceId":"01c8448817b155b6"},{"name":"static-check","duration":1181334,"timestamp":248649550,"id":1607,"parentId":1,"tags":{},"startTime":1782998738806,"traceId":"01c8448817b155b6"},{"name":"static-generation","duration":6411700,"timestamp":249973703,"id":1879,"parentId":1,"tags":{},"startTime":1782998740130,"traceId":"01c8448817b155b6"},{"name":"collect-build-traces","duration":20480963,"timestamp":249831652,"id":1876,"parentId":1,"tags":{},"startTime":1782998739988,"traceId":"01c8448817b155b6"},{"name":"telemetry-flush","duration":72,"timestamp":270317441,"id":1888,"parentId":1,"tags":{},"startTime":1782998760474,"traceId":"01c8448817b155b6"},{"name":"next-build","duration":60489593,"timestamp":209827934,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1782998699984,"traceId":"01c8448817b155b6"}]

package/bin/cock-browser.mjs

@@ -332,12 +332,13 @@ async function fetchBrowserInfo(shortId) {
 
 // Chunked evaluate result resolver
 //
-// Chrome extension 的 runtime messaging 在 sendResponse 边界有一个 ~8 KiB 的
-// 隐性 structured-clone 截断点；为了避免 evaluate 大结果被默默截掉，
-// extension 侧会把 >6 KiB 的结果暂存到 page window 上的一个 Map，
-// 返回一个 { __cockpit_chunked: true, token, totalBytes, isString } 的
-// descriptor。这里遇到 descriptor 就自动走 evaluate_chunk action 把完整
-// payload 拉回来，对上层 formatOutput 完全透明。
+// Chrome extension runtime messaging has an implicit ~8 KiB structured-clone
+// truncation point at the sendResponse boundary. To keep large evaluate
+// results from being silently cut off, the extension side stashes any result
+// >6 KiB in a Map on the page window and returns a
+// { __cockpit_chunked: true, token, totalBytes, isString } descriptor.
+// Whenever we see that descriptor here, we pull the full payload back via
+// the evaluate_chunk action — fully transparent to formatOutput above.
 async function fetchOneChunk(baseUrl, id, token, offset, cmdTimeout) {
   const resp = await fetch(`${baseUrl}/api/browser/evaluate_chunk`, {
     method: 'POST',
@@ -382,7 +383,8 @@ async function autoResolveChunked(baseUrl, id, data, cmdTimeout) {
     if (data.__cockpit_chunked === true && typeof data.token === 'string') {
       return await resolveChunkedDescriptor(baseUrl, id, data, cmdTimeout);
     }
-    // allFrames=true 聚合时可能得到数组，每一项都可能是独立 chunked
+    // With allFrames=true the aggregate may be an array, and each element
+    // may be independently chunked
     if (Array.isArray(data)) {
       return Promise.all(data.map(item => autoResolveChunked(baseUrl, id, item, cmdTimeout)));
     }
@@ -491,8 +493,9 @@ async function run() {
       process.exit(1);
     }
 
-    // 大结果由 extension 端自动 stash 并返回 chunked descriptor;
-    // 这里透明地把完整内容拉回来，调用方看不到 chunking 细节。
+    // Large results are auto-stashed by the extension side, which returns a
+    // chunked descriptor; we transparently pull the full content back here —
+    // callers never see the chunking.
     const resolved = await autoResolveChunked(baseUrl, id, data.data, timeout);
 
     // Post-`type` verification — `type` via CDP dispatchKeyEvent silently no-ops

package/bin/cock.mjs

@@ -143,12 +143,12 @@ const knownCommands = new Set(['browser', 'terminal', 'update', 'help', 'codegra
 const arg = process.argv[2];
 let projectDir = null;
 
-// 第一个参数不是 flag 且不是已知子命令 → 视为目录路径
+// First arg is neither a flag nor a known subcommand → treat it as a directory path
 if (arg && !arg.startsWith('-') && !knownCommands.has(arg)) {
-  // 展开 ~ 为 home 目录
+  // Expand ~ to the home directory
   const raw = arg.startsWith('~') ? arg.replace(/^~/, homedir()) : arg;
   projectDir = resolve(raw);
-  // 目录不存在则创建
+  // Create the directory if it doesn't exist
   if (!existsSync(projectDir)) {
     mkdirSync(projectDir, { recursive: true });
     console.log(`Created ${projectDir}`);
@@ -173,7 +173,7 @@ const { exec } = await import('child_process');
 const running = await isServerRunning();
 
 if (running) {
-  // 服务已运行 → 打开浏览器，立即退出
+  // Server already running → open the browser and exit immediately
   const base = `http://localhost:${port}`;
   const url = projectDir ? `${base}/?cwd=${encodeURIComponent(projectDir)}` : base;
   if (!process.env.COCKPIT_NO_OPEN) {
@@ -194,7 +194,7 @@ if (!isDev && !existsSync(resolve(PROJECT_ROOT, '.next-prod', 'BUILD_ID'))) {
   process.exit(1);
 }
 
-// 传递项目目录给 server.mjs，让它打开正确的 URL
+// Hand the project directory to server.mjs so it opens the right URL
 if (projectDir) {
   process.env.COCKPIT_OPEN_PROJECT = projectDir;
 }

package/bin/postinstall.mjs

@@ -21,7 +21,7 @@ try {
 }
 
 if (process.platform !== 'win32') {
-  // node-pty: spawn-helper 需要可执行权限
+  // node-pty: spawn-helper needs the executable bit
   try {
     const spawnHelper = join(
       projectRoot,
@@ -33,8 +33,8 @@ if (process.platform !== 'win32') {
 }
 
 // chrome-extension → ~/.cockpit/chrome-extension/
-// npm 安装时 projectRoot 在 node_modules 下（无 src/ 目录），需要复制到用户目录
-// npm link 时 projectRoot 是源码目录（有 src/），不需要复制
+// Installed via npm: projectRoot sits under node_modules (no src/ dir) → copy into the user dir.
+// Via npm link: projectRoot is the source checkout (has src/) → no copy needed.
 const isNpmInstall = !existsSync(join(projectRoot, 'src'));
 if (isNpmInstall) {
   try {
@@ -46,13 +46,13 @@ if (isNpmInstall) {
     cpSync(src, dest, { recursive: true, force: true });
 
     if (process.platform !== 'win32') {
-      // sudo 安装时文件 owner 是 root，Chrome 无法写入 _metadata/
-      // 用 SUDO_USER 还原为真实用户
+      // Under a sudo install the files end up owned by root and Chrome can't
+      // write _metadata/ — restore ownership to the real user via SUDO_USER
       const realUser = process.env.SUDO_USER;
       if (realUser) {
         try { execSync(`chown -R "${realUser}" "${cockpitDir}"`); } catch {}
       }
-      // macOS: 清除 com.apple.provenance 等扩展属性
+      // macOS: strip extended attributes like com.apple.provenance
       if (process.platform === 'darwin') {
         try { execSync(`xattr -cr "${dest}"`); } catch {}
       }

package/chrome-extension/automation.js

@@ -1,11 +1,12 @@
 /**
  * Cockpit Browser Automation Layer (ES Module)
  *
- * 注入到 Cockpit iframe 中，接收来自 BrowserBubble 的自动化命令，
- * 构建 a11y tree、执行 DOM 操作、返回结果。
+ * Injected into the Cockpit iframe; receives automation commands from
+ * BrowserBubble, builds the a11y tree, performs DOM operations, and
+ * returns results.
  *
- * 通过 content.js 的 activateCockpitBridge() 动态 import()。
- * 运行在 content script isolated world 中（保留 chrome.runtime 访问权）。
+ * Dynamically import()-ed by activateCockpitBridge() in content.js.
+ * Runs in the content script isolated world (retains chrome.runtime access).
  */
 
 let _realParent = null;
@@ -14,7 +15,7 @@ let _chrome = null;
 const LOG_PREFIX = '[Cockpit Automation]';
 
 // ============================================================================
-// Ref 系统：为 a11y tree 中的元素分配稳定的 ref ID
+// Ref system: assigns stable ref IDs to elements in the a11y tree
 // ============================================================================
 
 let refCounter = 0;
@@ -91,7 +92,7 @@ function findByRef(ref) {
 }
 
 // ============================================================================
-// A11y Tree 构建
+// A11y Tree construction
 // ============================================================================
 
 const IMPLICIT_ROLES = {
@@ -284,7 +285,7 @@ function safeRegex(src) {
 }
 
 // ============================================================================
-// Console 拦截
+// Console interception
 // ============================================================================
 
 const consoleBuffer = [];
@@ -312,24 +313,26 @@ function initConsoleCapture() {
 }
 
 // ============================================================================
-// Network 捕获（接收 Main World 的 network-capture.js 通过 CustomEvent 发来的条目）
+// Network capture (receives entries sent via CustomEvent from the Main
+// World's network-capture.js)
 //
-// fetch / XHR 拦截在 Main World 执行（network-capture.js），
-// 本层只负责：存储 buffer、管理录制状态、处理 CLI 命令。
+// fetch / XHR interception runs in the Main World (network-capture.js);
+// this layer is only responsible for: storing the buffer, managing
+// recording state, and handling CLI commands.
 // ============================================================================
 
 const networkBuffer = [];
 const MAX_NETWORK_BUFFER = 500;
 
-// 录制状态：由本层管理，通过 CustomEvent 同步给 Main World
+// Recording state: managed by this layer, synced to the Main World via CustomEvent
 const networkRecording = {
   active: false,
   filters: {},   // { url, method, status }
-  timer: null,   // 自动过期定时器
+  timer: null,   // auto-expiry timer
   startedAt: 0,
 };
 
-// 清除所有 entry 的 body 数据（过期时调用）
+// Clear body data from all entries (called on expiry)
 function clearAllBodies() {
   for (const entry of networkBuffer) {
     entry.requestHeaders = null;
@@ -339,32 +342,32 @@ function clearAllBodies() {
   }
 }
 
-// 同步录制状态到 Main World 的 network-capture.js
+// Sync recording state to the Main World's network-capture.js
 function syncRecordingToMainWorld() {
   window.dispatchEvent(new CustomEvent('cockpit:network-recording', {
     detail: { active: networkRecording.active, filters: networkRecording.filters },
   }));
 }
 
-// 监听 Main World 发来的网络条目
+// Listen for network entries sent from the Main World
 function initNetworkListener() {
-  // 请求发起时收到占位条目（保持发起顺序）
+  // Placeholder entry received when a request starts (preserves initiation order)
   window.addEventListener('cockpit:network-entry', (e) => {
     networkBuffer.push(e.detail);
     if (networkBuffer.length > MAX_NETWORK_BUFFER) networkBuffer.splice(0, 1);
   });
-  // 响应完成时收到更新（补全 status / duration / body 等字段）
+  // Update received when the response completes (fills in status / duration / body etc.)
   window.addEventListener('cockpit:network-update', (e) => {
     const update = e.detail;
     const entry = networkBuffer.find(r => r.id === update.id);
     if (entry) Object.assign(entry, update);
   });
-  // 通知 Main World：Isolated World 已就绪，可以 flush 缓存的条目
+  // Notify the Main World: the Isolated World is ready, cached entries can be flushed
   window.dispatchEvent(new CustomEvent('cockpit:network-bridge-ready'));
 }
 
 // ============================================================================
-// 命令处理器
+// Command handlers
 // ============================================================================
 
 const handlers = {
@@ -382,7 +385,7 @@ const handlers = {
     buildA11yTree(document.body, { filter, includeHiddenText, maxDepth }),
 
   screenshot: async () => {
-    // 1) 通知父页面（项目 iframe）：切到 console view + 切到本项目 + 返回 iframe bounds
+    // 1) Notify the parent page (project iframe): switch to console view + switch to this project + return the iframe bounds
     const boundsReqId = 'ss-' + Date.now();
     const bounds = await new Promise((resolve, reject) => {
       const timeout = setTimeout(() => reject(new Error('Timeout preparing screenshot')), 5000);
@@ -397,7 +400,7 @@ const handlers = {
       _realParent.postMessage({ type: 'cockpit:prepare-screenshot', reqId: boundsReqId }, '*');
     });
 
-    // 2) captureVisibleTab 截取整个浏览器标签页
+    // 2) captureVisibleTab captures the entire browser tab
     const dataUrl = await new Promise((resolve, reject) => {
       _chrome.runtime.sendMessage({ type: 'cockpit:capture-tab' }, (response) => {
         if (_chrome.runtime.lastError) { reject(new Error(_chrome.runtime.lastError.message)); return; }
@@ -406,7 +409,7 @@ const handlers = {
       });
     });
 
-    // 3) 裁切到 iframe 区域
+    // 3) Crop to the iframe area
     const img = new Image();
     await new Promise((resolve, reject) => { img.onload = resolve; img.onerror = reject; img.src = dataUrl; });
     const cropCanvas = document.createElement('canvas');
@@ -416,7 +419,7 @@ const handlers = {
     cropCtx.drawImage(img, bounds.x, bounds.y, bounds.width, bounds.height, 0, 0, bounds.width, bounds.height);
     const result = cropCanvas.toDataURL('image/png');
 
-    // 4) 通知父页面截图完成，恢复界面
+    // 4) Notify the parent page the screenshot is done, restore the UI
     _realParent.postMessage({ type: 'cockpit:screenshot-done' }, '*');
 
     return { image: result, format: 'png' };
@@ -659,11 +662,11 @@ const handlers = {
   },
 
   evaluate: async ({ js, allFrames }) => {
-    // 通过 background.js 的 chrome.scripting.executeScript 在 main world 执行
-    // 不受页面 CSP 限制，可访问页面 JS 变量（React state 等）
-    // allFrames: true → 在所有 frame 中执行（解决跨域 iframe 访问问题）
-    // 大结果 (>6 KiB) 会在 MAIN world 被 auto-stash 并以 descriptor 形式返回；
-    // cock-browser CLI 识别 descriptor 后会通过 evaluate_chunk 回填内容。
+    // Executed in the main world via background.js's chrome.scripting.executeScript.
+    // Not restricted by the page's CSP; can access page JS variables (React state, etc.).
+    // allFrames: true → execute in all frames (solves cross-origin iframe access).
+    // Large results (>6 KiB) are auto-stashed in the MAIN world and returned as a descriptor;
+    // the cock-browser CLI recognizes the descriptor and backfills the content via evaluate_chunk.
     return new Promise((resolve) => {
       _chrome.runtime.sendMessage({ type: 'cockpit:evaluate', js, allFrames: !!allFrames }, (response) => {
         if (_chrome.runtime.lastError) {
@@ -677,13 +680,15 @@ const handlers = {
   },
 
   evaluate_chunk: async ({ token, offset = 0, size = 5000 }) => {
-    // 读取 MAIN-world stash 里某个 token 的一段内容。token 由上一次 evaluate
-    // 返回的 descriptor 提供。注意 stash 在 page window 上，页面导航/刷新会丢；
-    // 必须同一个浏览器 session、同一个页面上下文。
+    // Reads a slice of a token's content from the MAIN-world stash. The token
+    // comes from the descriptor returned by the previous evaluate. Note the
+    // stash lives on the page window, so page navigation/reload loses it;
+    // must be the same browser session and the same page context.
     //
-    // 返回 { chunk, done, nextOffset, totalBytes, isString }；
-    // size 默认 5000 以确保每次返回对象 JSON 序列化 < 6000，远低于 Chrome
-    // 在 chrome.runtime 消息边界的 ~8192 字节隐性截断阈值。
+    // Returns { chunk, done, nextOffset, totalBytes, isString };
+    // size defaults to 5000 to keep each returned object's JSON serialization
+    // < 6000, well below Chrome's ~8192-byte implicit truncation threshold at
+    // the chrome.runtime message boundary.
     const offNum = Number(offset) || 0;
     const szNum = Math.min(Math.max(1, Number(size) || 5000), 7000);
     const tokStr = String(token);
@@ -755,10 +760,10 @@ const handlers = {
     };
   },
 
-  // 录制控制：start 开始捕获 body，stop 停止，status 查看状态
+  // Recording control: start begins body capture, stop ends it, status shows state
   network_record: async ({ action = 'status', url, method, status, ttl = 600 }) => {
     if (action === 'start') {
-      // 清除旧的过期定时器
+      // Clear the old expiry timer
       if (networkRecording.timer) clearTimeout(networkRecording.timer);
       networkRecording.active = true;
       networkRecording.filters = {};
@@ -767,7 +772,7 @@ const handlers = {
       if (status) networkRecording.filters.status = status;
       networkRecording.startedAt = Date.now();
       syncRecordingToMainWorld();
-      // ttl 秒后自动过期（默认 10 分钟）
+      // Auto-expire after ttl seconds (default 10 minutes)
       networkRecording.timer = setTimeout(() => {
         networkRecording.active = false;
         clearAllBodies();
@@ -784,7 +789,7 @@ const handlers = {
       networkRecording.active = false;
       if (networkRecording.timer) { clearTimeout(networkRecording.timer); networkRecording.timer = null; }
       syncRecordingToMainWorld();
-      // 停止后不立即清 body，允许查询已录制的数据
+      // Don't clear bodies immediately after stopping; allow querying the recorded data
       return { recording: false, recordedCount: networkBuffer.filter(r => r.recorded).length };
     }
     // status
@@ -1299,7 +1304,7 @@ function simpleJsonPath(data, path) {
 }
 
 // ============================================================================
-// 命令分发
+// Command dispatch
 // ============================================================================
 
 function handleCommand(event) {
@@ -1357,7 +1362,7 @@ function bagCounts(s) {
 }
 
 // ============================================================================
-// 导出初始化函数
+// Exported initialization function
 // ============================================================================
 
 export function initAutomation(realParent, chromeApi) {