aws-runtime-bridge 1.7.31 → 1.7.32

package/dist/routes/git.d.ts

@@ -9,6 +9,14 @@ export declare const gitRouter: import("express-serve-static-core").Router;
  * 主流程：优先使用环境变量，非法或过小配置回落到默认值，避免 Git 检测请求长期挂起。
  */
 export declare function resolveGitCommandTimeoutMs(): number;
+interface GitRepositoryContext {
+    workspacePath: string;
+    repositoryRootPath: string | null;
+    hasRepository: boolean;
+    isGitRepo: boolean;
+    usingParentGitRepo: boolean;
+    relativeWorkspacePath: string;
+}
 export declare function assertGitWorkspacePathAccessible(workspacePath: string): Promise<void>;
 type GitDiffFileStatus = 'modified' | 'added' | 'deleted' | 'renamed';
 /**
@@ -36,5 +44,12 @@ interface LatestGitStash {
  * 主流程：提取 stash 引用并保留后续描述，供无变更快照复用最近快照引用。
  */
 export declare function parseLatestGitStash(output: string): LatestGitStash | null;
+/**
+ * 解析 git diff 的 name-status 与 numstat 输出，生成前端文件树需要的汇总数据。
+ */
+export declare function parseGitStatusStagedPaths(output: string): Set<string>;
+export declare function normalizeGitCommitMessage(message: unknown): string;
+export declare function createScopedGitPathspecArgs(context: Pick<GitRepositoryContext, 'relativeWorkspacePath'>): string[];
+export declare function createScopedFilePathspecArgs(filePath: string, context: Pick<GitRepositoryContext, 'relativeWorkspacePath'>): string[];
 export {};
 //# sourceMappingURL=git.d.ts.map

package/dist/routes/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/routes/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,eAAO,MAAM,SAAS,4CAAW,CAAC;AAIlC;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAOnD;AAWD,wBAAsB,gCAAgC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3F;AASD,KAAK,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,GACpB,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK3E;AAED,wBAAgB,uCAAuC,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAWzE"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/routes/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,eAAO,MAAM,SAAS,4CAAW,CAAC;AAIlC;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAOnD;AAED,UAAU,oBAAoB;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAsB,gCAAgC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3F;AASD,KAAK,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAkBtE;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,GACpB,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK3E;AAED,wBAAgB,uCAAuC,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAWzE;AA+KD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAmBrE;AAkDD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAElE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,MAAM,EAAE,CAElH;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,MAAM,EAAE,CAErI"}

package/dist/routes/git.js

@@ -232,6 +232,96 @@ function parseRenameDisplayPath(rawPath) {
     }
     return normalizedPath;
 }
+/**
+ * 解析 git diff 的 name-status 与 numstat 输出，生成前端文件树需要的汇总数据。
+ */
+export function parseGitStatusStagedPaths(output) {
+    const stagedPaths = new Set();
+    const lines = String(output || '').split('\n').filter(line => line.trim());
+    for (const line of lines) {
+        const indexStatus = line[0] || ' ';
+        if (indexStatus === ' ' || indexStatus === '?') {
+            continue;
+        }
+        const rawPath = line.slice(3).trim();
+        const pathParts = rawPath.split(' -> ');
+        const displayPath = parseRenameDisplayPath(pathParts[pathParts.length - 1] || rawPath);
+        if (displayPath) {
+            stagedPaths.add(displayPath);
+        }
+    }
+    return stagedPaths;
+}
+/**
+ * 解析 git diff 的 name-status 与 numstat 输出，生成前端文件树需要的汇总数据。
+ */
+function parseGitDiffSummary(nameStatusOutput, numstatOutput, stagedPaths = new Set()) {
+    const statusMap = new Map();
+    const nameStatusLines = nameStatusOutput.split('\n').filter(line => line.trim());
+    for (const line of nameStatusLines) {
+        const parts = line.split('\t');
+        if (parts.length < 2) {
+            continue;
+        }
+        const status = resolveGitDiffStatus(parts[0]);
+        const pathIndex = status === 'renamed' && parts.length >= 3 ? 2 : 1;
+        const displayPath = parseRenameDisplayPath(parts[pathIndex]);
+        if (!displayPath) {
+            continue;
+        }
+        statusMap.set(displayPath, status);
+    }
+    const files = [];
+    const lines = numstatOutput.split('\n').filter(line => line.trim());
+    for (const line of lines) {
+        const parts = line.split('\t');
+        if (parts.length < 3)
+            continue;
+        const isBinaryDiff = parts[0] === '-' || parts[1] === '-';
+        const additions = parts[0] === '-' ? 0 : parseInt(parts[0], 10) || 0;
+        const deletions = parts[1] === '-' ? 0 : parseInt(parts[1], 10) || 0;
+        const filePath = parseRenameDisplayPath(parts.slice(2).join('\t').trim());
+        const status = statusMap.get(filePath) || 'modified';
+        if (!filePath || !shouldIncludeGitDiffSummaryFile(status, additions, deletions, isBinaryDiff)) {
+            continue;
+        }
+        files.push({ path: filePath, status, additions, deletions, staged: stagedPaths.has(filePath) });
+    }
+    return files;
+}
+function normalizeCommitHash(commitHash) {
+    return String(commitHash || '').trim();
+}
+export function normalizeGitCommitMessage(message) {
+    return String(message || '').trim();
+}
+export function createScopedGitPathspecArgs(context) {
+    return ['--', context.relativeWorkspacePath || '.'];
+}
+export function createScopedFilePathspecArgs(filePath, context) {
+    return ['--', resolveRepositoryRelativeFilePath(filePath, context)];
+}
+/**
+ * 解析 git log 的 NUL 分隔输出，避免提交标题中的特殊字符破坏字段切分。
+ */
+function parseGitCommitLog(output) {
+    const fields = output.split('\0');
+    const commits = [];
+    for (let index = 0; index + 4 < fields.length; index += 5) {
+        const hash = fields[index]?.trim();
+        if (!hash) {
+            continue;
+        }
+        commits.push({
+            hash,
+            shortHash: fields[index + 1]?.trim() || hash.slice(0, 8),
+            authorName: fields[index + 2]?.trim() || 'unknown',
+            authorDate: fields[index + 3]?.trim() || '',
+            subject: fields[index + 4]?.trim() || hash,
+        });
+    }
+    return commits;
+}
 /**
  * 检查路径是否为 git 仓库
  * POST /runtime/git/check
@@ -504,38 +594,12 @@ gitRouter.post('/git/diff', validateToken, async (req, res) => {
             res.status(400).json({ error: result.stderr || 'git diff failed' });
             return;
         }
-        const statusMap = new Map();
-        const nameStatusLines = nameStatusResult.stdout.split('\n').filter(line => line.trim());
-        for (const line of nameStatusLines) {
-            const parts = line.split('\t');
-            if (parts.length < 2) {
-                continue;
-            }
-            const status = resolveGitDiffStatus(parts[0]);
-            const pathIndex = status === 'renamed' && parts.length >= 3 ? 2 : 1;
-            const displayPath = parseRenameDisplayPath(parts[pathIndex]);
-            if (!displayPath) {
-                continue;
-            }
-            statusMap.set(displayPath, status);
-        }
-        const files = [];
-        const lines = result.stdout.split('\n').filter(line => line.trim());
-        for (const line of lines) {
-            // 格式: "12\t5\tsrc/file.java"
-            const parts = line.split('\t');
-            if (parts.length < 3)
-                continue;
-            const isBinaryDiff = parts[0] === '-' || parts[1] === '-';
-            const additions = parts[0] === '-' ? 0 : parseInt(parts[0], 10) || 0;
-            const deletions = parts[1] === '-' ? 0 : parseInt(parts[1], 10) || 0;
-            const filePath = parseRenameDisplayPath(parts.slice(2).join('\t').trim());
-            const status = statusMap.get(filePath) || 'modified';
-            if (!filePath || !shouldIncludeGitDiffSummaryFile(status, additions, deletions, isBinaryDiff)) {
-                continue;
-            }
-            files.push({ path: filePath, status, additions, deletions });
+        const statusResult = await execGitCommand(context.repositoryRootPath, createScopedGitArgs(['status', '--porcelain=v1'], context));
+        if (statusResult.exitCode !== 0) {
+            res.status(400).json({ error: statusResult.stderr || 'git status failed' });
+            return;
         }
+        const files = parseGitDiffSummary(nameStatusResult.stdout, result.stdout, parseGitStatusStagedPaths(statusResult.stdout));
         res.json({
             ok: true,
             isGitRepo: context.isGitRepo,
@@ -553,12 +617,200 @@ gitRouter.post('/git/diff', validateToken, async (req, res) => {
         res.status(500).json({ error: err.message || 'git diff failed' });
     }
 });
+/**
+ * 提交工作区未提交变更
+ * POST /runtime/git/commit
+ */
+gitRouter.post('/git/commit', validateToken, async (req, res) => {
+    const { workspacePath, repositoryPath, message } = req.body || {};
+    if (!workspacePath || !String(workspacePath).trim()) {
+        res.status(400).json({ error: 'workspacePath is required' });
+        return;
+    }
+    const commitMessage = normalizeGitCommitMessage(message);
+    if (!commitMessage) {
+        res.status(400).json({ error: 'commit message is required' });
+        return;
+    }
+    try {
+        const context = await resolveGitRepositoryContext(String(repositoryPath || workspacePath).trim());
+        if (!context.hasRepository || !context.repositoryRootPath) {
+            res.status(400).json({ error: 'workspace is not inside a git repository' });
+            return;
+        }
+        const pathspecArgs = createScopedGitPathspecArgs(context);
+        const addResult = await execGitCommand(context.repositoryRootPath, ['add', '--all', ...pathspecArgs]);
+        if (addResult.exitCode !== 0) {
+            res.status(400).json({ error: addResult.stderr || 'git add failed' });
+            return;
+        }
+        const stagedResult = await execGitCommand(context.repositoryRootPath, ['diff', '--cached', '--quiet', ...pathspecArgs]);
+        if (stagedResult.exitCode === 0) {
+            res.status(400).json({ error: '没有可提交的变更' });
+            return;
+        }
+        if (stagedResult.exitCode !== 1) {
+            res.status(400).json({ error: stagedResult.stderr || 'git staged diff failed' });
+            return;
+        }
+        const commitResult = await execGitCommand(context.repositoryRootPath, ['commit', '-m', commitMessage, ...pathspecArgs]);
+        if (commitResult.exitCode !== 0) {
+            res.status(400).json({ error: commitResult.stderr || commitResult.stdout || 'git commit failed' });
+            return;
+        }
+        res.json({
+            ok: true,
+            message: '提交完成',
+            output: commitResult.stdout,
+            workspacePath: context.workspacePath,
+            repositoryRootPath: context.repositoryRootPath,
+            relativeWorkspacePath: context.relativeWorkspacePath,
+        });
+    }
+    catch (error) {
+        const err = error;
+        res.status(500).json({ error: err.message || 'git commit failed' });
+    }
+});
+/**
+ * 将单个文件加入暂存区
+ * POST /runtime/git/add-file
+ */
+gitRouter.post('/git/add-file', validateToken, async (req, res) => {
+    const { workspacePath, repositoryPath, filePath } = req.body || {};
+    if (!workspacePath || !String(workspacePath).trim()) {
+        res.status(400).json({ error: 'workspacePath is required' });
+        return;
+    }
+    const normalizedFilePath = normalizeGitPath(String(filePath || '').trim());
+    if (!normalizedFilePath) {
+        res.status(400).json({ error: 'filePath is required' });
+        return;
+    }
+    try {
+        const context = await resolveGitRepositoryContext(String(repositoryPath || workspacePath).trim());
+        if (!context.hasRepository || !context.repositoryRootPath) {
+            res.status(400).json({ error: 'workspace is not inside a git repository' });
+            return;
+        }
+        const addResult = await execGitCommand(context.repositoryRootPath, ['add', ...createScopedFilePathspecArgs(normalizedFilePath, context)]);
+        if (addResult.exitCode !== 0) {
+            res.status(400).json({ error: addResult.stderr || 'git add file failed' });
+            return;
+        }
+        res.json({
+            ok: true,
+            filePath: normalizedFilePath,
+            workspacePath: context.workspacePath,
+            repositoryRootPath: context.repositoryRootPath,
+            relativeWorkspacePath: context.relativeWorkspacePath,
+        });
+    }
+    catch (error) {
+        const err = error;
+        res.status(500).json({ error: err.message || 'git add file failed' });
+    }
+});
+/**
+ * 获取工作区提交列表
+ * POST /runtime/git/commits
+ */
+gitRouter.post('/git/commits', validateToken, async (req, res) => {
+    const { workspacePath, repositoryPath, limit } = req.body || {};
+    if (!workspacePath || !String(workspacePath).trim()) {
+        res.status(400).json({ error: 'workspacePath is required' });
+        return;
+    }
+    try {
+        const context = await resolveGitRepositoryContext(String(repositoryPath || workspacePath).trim());
+        if (!context.hasRepository || !context.repositoryRootPath) {
+            res.json({ ok: true, commits: [], workspacePath: context.workspacePath, repositoryRootPath: null });
+            return;
+        }
+        const parsedLimit = Number(limit);
+        const safeLimit = Number.isInteger(parsedLimit) && parsedLimit > 0 && parsedLimit <= 100 ? parsedLimit : 30;
+        const result = await execGitCommand(context.repositoryRootPath, [
+            'log',
+            `-${safeLimit}`,
+            '--date=iso-strict',
+            '--pretty=format:%H%x00%h%x00%an%x00%ad%x00%s%x00',
+            '--',
+            context.relativeWorkspacePath || '.',
+        ]);
+        if (result.exitCode !== 0) {
+            res.status(400).json({ error: result.stderr || 'git log failed' });
+            return;
+        }
+        res.json({
+            ok: true,
+            commits: parseGitCommitLog(result.stdout),
+            workspacePath: context.workspacePath,
+            repositoryRootPath: context.repositoryRootPath,
+            relativeWorkspacePath: context.relativeWorkspacePath,
+        });
+    }
+    catch (error) {
+        const err = error;
+        res.status(500).json({ error: err.message || 'git commits failed' });
+    }
+});
+/**
+ * 获取指定提交相对父提交的变更概览
+ * POST /runtime/git/commit-diff
+ */
+gitRouter.post('/git/commit-diff', validateToken, async (req, res) => {
+    const { workspacePath, repositoryPath, commitHash } = req.body || {};
+    if (!workspacePath || !String(workspacePath).trim()) {
+        res.status(400).json({ error: 'workspacePath is required' });
+        return;
+    }
+    const normalizedCommitHash = normalizeCommitHash(commitHash);
+    if (!normalizedCommitHash) {
+        res.status(400).json({ error: 'commitHash is required' });
+        return;
+    }
+    try {
+        const context = await resolveGitRepositoryContext(String(repositoryPath || workspacePath).trim());
+        if (!context.hasRepository || !context.repositoryRootPath) {
+            res.status(400).json({ error: 'workspace is not inside a git repository' });
+            return;
+        }
+        const diffBaseArgs = ['diff', `${normalizedCommitHash}^!`];
+        const nameStatusResult = await execGitCommand(context.repositoryRootPath, createScopedGitArgs([...diffBaseArgs, '--name-status'], context));
+        if (nameStatusResult.exitCode !== 0) {
+            res.status(400).json({ error: nameStatusResult.stderr || 'git commit diff failed' });
+            return;
+        }
+        const numstatResult = await execGitCommand(context.repositoryRootPath, createScopedGitArgs([...diffBaseArgs, '--numstat'], context));
+        if (numstatResult.exitCode !== 0) {
+            res.status(400).json({ error: numstatResult.stderr || 'git commit diff failed' });
+            return;
+        }
+        const files = parseGitDiffSummary(nameStatusResult.stdout, numstatResult.stdout);
+        res.json({
+            ok: true,
+            commitHash: normalizedCommitHash,
+            isGitRepo: context.isGitRepo,
+            hasRepository: true,
+            usingParentGitRepo: context.usingParentGitRepo,
+            hasChanges: files.length > 0,
+            files,
+            workspacePath: context.workspacePath,
+            repositoryRootPath: context.repositoryRootPath,
+            relativeWorkspacePath: context.relativeWorkspacePath,
+        });
+    }
+    catch (error) {
+        const err = error;
+        res.status(500).json({ error: err.message || 'git commit diff failed' });
+    }
+});
 /**
  * 获取单个文件的详细差异
  * POST /runtime/git/diff-file
  */
 gitRouter.post('/git/diff-file', validateToken, async (req, res) => {
-    const { workspacePath, filePath } = req.body || {};
+    const { workspacePath, filePath, commitHash } = req.body || {};
     if (!workspacePath || !String(workspacePath).trim()) {
         res.status(400).json({ error: 'workspacePath is required' });
         return;
@@ -577,7 +829,11 @@ gitRouter.post('/git/diff-file', validateToken, async (req, res) => {
             return;
         }
         const repositoryRelativeFilePath = resolveRepositoryRelativeFilePath(normalizedFilePath, context);
-        const result = await execGitCommand(context.repositoryRootPath, ['diff', '--', repositoryRelativeFilePath]);
+        const normalizedCommitHash = normalizeCommitHash(commitHash);
+        const gitArgs = normalizedCommitHash
+            ? ['show', '--format=', '--no-ext-diff', normalizedCommitHash, '--', repositoryRelativeFilePath]
+            : ['diff', '--', repositoryRelativeFilePath];
+        const result = await execGitCommand(context.repositoryRootPath, gitArgs);
         if (result.exitCode !== 0) {
             res.status(400).json({ error: result.stderr || 'git diff file failed' });
             return;
@@ -586,6 +842,7 @@ gitRouter.post('/git/diff-file', validateToken, async (req, res) => {
             ok: true,
             filePath: normalizedFilePath,
             repositoryRelativeFilePath,
+            commitHash: normalizedCommitHash || null,
             diffContent: result.stdout,
             workspacePath: context.workspacePath,
             repositoryRootPath: context.repositoryRootPath,

package/dist/routes/git.test.d.ts

@@ -1,5 +1,2 @@
-/**
- * Git 路由单元测试
- */
 export {};
 //# sourceMappingURL=git.test.d.ts.map

package/dist/routes/git.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.test.d.ts","sourceRoot":"","sources":["../../src/routes/git.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"git.test.d.ts","sourceRoot":"","sources":["../../src/routes/git.test.ts"],"names":[],"mappings":""}

package/dist/routes/git.test.js

@@ -1,175 +1,23 @@
-/**
- * Git 路由单元测试
- */
-import { mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
 import { describe, expect, it } from 'vitest';
-import { assertGitWorkspacePathAccessible, createMissingInitialCommitSnapshotError, isGitStashNoChangesOutput, isGitStashMissingInitialCommitError, parseLatestGitStash, resolveGitCommandTimeoutMs, shouldIncludeGitDiffSummaryFile, } from './git.js';
-describe('git stash operations', () => {
-    function parseStashList(output) {
-        const stashes = [];
-        const lines = output.split('\n').filter(line => line.trim());
-        for (const line of lines) {
-            const refMatch = line.match(/^(stash@\{\d+\})/);
-            if (!refMatch)
-                continue;
-            const ref = refMatch[1];
-            const restOfLine = line.slice(ref.length + 2);
-            let branch = '';
-            let message = restOfLine;
-            const branchMatch = restOfLine.match(/^(?:On|WIP on)\s+([^:]+):\s*(.*)$/);
-            if (branchMatch) {
-                branch = branchMatch[1].trim();
-                message = branchMatch[2].trim();
-            }
-            stashes.push({ ref, branch, message });
-        }
-        return stashes;
-    }
-    it('parses simple stash list output', () => {
-        const output = 'stash@{0}: On main: 快照: 添加新功能';
-        const result = parseStashList(output);
-        expect(result.length).toBe(1);
-        expect(result[0].ref).toBe('stash@{0}');
-        expect(result[0].branch).toBe('main');
-        expect(result[0].message).toBe('快照: 添加新功能');
-    });
-    it('parses WIP stash format', () => {
-        const output = 'stash@{0}: WIP on feature: test changes';
-        const result = parseStashList(output);
-        expect(result.length).toBe(1);
-        expect(result[0].branch).toBe('feature');
-        expect(result[0].message).toBe('test changes');
-    });
-    it('handles multiple stash entries', () => {
-        const output = [
-            'stash@{0}: On main: 最新快照',
-            'stash@{1}: On main: 旧快照',
-        ].join('\n');
-        const result = parseStashList(output);
-        expect(result.length).toBe(2);
-    });
-    it('returns empty array for empty output', () => {
-        expect(parseStashList('')).toEqual([]);
-    });
-    it('parses latest stash for no-change snapshot reuse', () => {
-        const result = parseLatestGitStash('stash@{0}: On master: 快照: 快照: t1\n');
-        expect(result).toEqual({
-            ref: 'stash@{0}',
-            message: 'On master: 快照: 快照: t1',
-        });
-    });
-    it('returns null when there is no latest stash to reuse', () => {
-        expect(parseLatestGitStash('')).toBeNull();
-        expect(parseLatestGitStash('not a stash line')).toBeNull();
-    });
-});
-describe('git command validation', () => {
-    it('falls back to a safe git command timeout for invalid configuration', () => {
-        const previous = process.env.AWS_RUNTIME_GIT_COMMAND_TIMEOUT_MS;
-        try {
-            process.env.AWS_RUNTIME_GIT_COMMAND_TIMEOUT_MS = 'not-a-number';
-            expect(resolveGitCommandTimeoutMs()).toBe(10_000);
-            process.env.AWS_RUNTIME_GIT_COMMAND_TIMEOUT_MS = '999';
-            expect(resolveGitCommandTimeoutMs()).toBe(10_000);
-            process.env.AWS_RUNTIME_GIT_COMMAND_TIMEOUT_MS = '1500';
-            expect(resolveGitCommandTimeoutMs()).toBe(1500);
-        }
-        finally {
-            if (previous === undefined) {
-                delete process.env.AWS_RUNTIME_GIT_COMMAND_TIMEOUT_MS;
-            }
-            else {
-                process.env.AWS_RUNTIME_GIT_COMMAND_TIMEOUT_MS = previous;
-            }
-        }
-    });
-    it('validates workspacePath requirement', () => {
-        const validateInput = (body) => {
-            if (!body.workspacePath || !String(body.workspacePath).trim()) {
-                return { valid: false, error: 'workspacePath is required' };
-            }
-            return { valid: true };
-        };
-        expect(validateInput({}).valid).toBe(false);
-        expect(validateInput({ workspacePath: '/valid/path' }).valid).toBe(true);
-    });
-    it('validates stashRef format', () => {
-        const isValidStashRef = (ref) => /^stash@\{\d+\}$/.test(ref);
-        expect(isValidStashRef('stash@{0}')).toBe(true);
-        expect(isValidStashRef('stash@{99}')).toBe(true);
-        expect(isValidStashRef('invalid')).toBe(false);
-    });
-});
-describe('git workspace path validation', () => {
-    it('accepts existing workspace directories', async () => {
-        const workspaceDir = await mkdtemp(path.join(tmpdir(), 'aws-git-workspace-'));
-        try {
-            await expect(assertGitWorkspacePathAccessible(workspaceDir)).resolves.toBeUndefined();
-        }
-        finally {
-            await rm(workspaceDir, { recursive: true, force: true });
-        }
-    });
-    it('rejects missing workspace paths with a diagnostic error', async () => {
-        const missingPath = path.join(tmpdir(), `aws-missing-workspace-${Date.now()}`);
-        await expect(assertGitWorkspacePathAccessible(missingPath)).rejects.toThrow('workspace path does not exist');
-    });
-    it('rejects file paths because git cwd must be a directory', async () => {
-        const workspaceDir = await mkdtemp(path.join(tmpdir(), 'aws-git-workspace-file-'));
-        const filePath = path.join(workspaceDir, 'workspace.txt');
-        try {
-            await writeFile(filePath, 'not a directory');
-            await expect(assertGitWorkspacePathAccessible(filePath)).rejects.toThrow('workspace path is not a directory');
-        }
-        finally {
-            await rm(workspaceDir, { recursive: true, force: true });
-        }
-    });
-});
-describe('git diff summary visibility', () => {
-    it('filters ordinary modified files without textual changes', () => {
-        expect(shouldIncludeGitDiffSummaryFile('modified', 0, 0, false)).toBe(false);
-    });
-    it('keeps modified files with text or binary changes', () => {
-        expect(shouldIncludeGitDiffSummaryFile('modified', 1, 0, false)).toBe(true);
-        expect(shouldIncludeGitDiffSummaryFile('modified', 0, 1, false)).toBe(true);
-        expect(shouldIncludeGitDiffSummaryFile('modified', 0, 0, true)).toBe(true);
-    });
-    it('keeps structural status changes even when line counts are zero', () => {
-        expect(shouldIncludeGitDiffSummaryFile('added', 0, 0, false)).toBe(true);
-        expect(shouldIncludeGitDiffSummaryFile('deleted', 0, 0, false)).toBe(true);
-        expect(shouldIncludeGitDiffSummaryFile('renamed', 0, 0, false)).toBe(true);
-    });
-});
-describe('error handling', () => {
-    it('detects "no local changes" error', () => {
-        expect(isGitStashNoChangesOutput('No local changes to save')).toBe(true);
-        expect(isGitStashNoChangesOutput('stdout: No changes to save')).toBe(true);
-        expect(isGitStashNoChangesOutput('没有本地变更需要保存')).toBe(true);
-        expect(isGitStashNoChangesOutput('other error')).toBe(false);
-    });
-    it('detects stash failure before initial commit and returns an actionable message', () => {
-        expect(isGitStashMissingInitialCommitError('You do not have the initial commit yet\n')).toBe(true);
-        expect(isGitStashMissingInitialCommitError("fatal: bad revision 'HEAD'\n")).toBe(true);
-        expect(isGitStashMissingInitialCommitError("fatal: ambiguous argument 'HEAD': unknown revision\n")).toBe(true);
-        expect(isGitStashMissingInitialCommitError('No local changes to save')).toBe(false);
-        expect(createMissingInitialCommitSnapshotError()).toContain('请先提交一次初始提交');
-    });
-    it('detects conflict during pop', () => {
-        const hasConflict = (stdout, stderr) => stdout.includes('CONFLICT') || stderr.includes('CONFLICT');
-        expect(hasConflict('CONFLICT (content): Merge conflict', '')).toBe(true);
-        expect(hasConflict('clean merge', '')).toBe(false);
-    });
-    it('uses apply as the non-consuming restore command', () => {
-        const buildRestoreCommand = (mode, ref) => ['stash', mode, ref];
-        expect(buildRestoreCommand('apply', 'stash@{0}')).toEqual(['stash', 'apply', 'stash@{0}']);
-        expect(buildRestoreCommand('pop', 'stash@{0}')).toEqual(['stash', 'pop', 'stash@{0}']);
-    });
-    it('detects invalid stash reference', () => {
-        const isInvalidRef = (stderr) => stderr.includes('is not a valid reference');
-        expect(isInvalidRef('stash@{99} is not a valid reference')).toBe(true);
-        expect(isInvalidRef('other error')).toBe(false);
+import { createScopedFilePathspecArgs, createScopedGitPathspecArgs, normalizeGitCommitMessage, parseGitStatusStagedPaths, } from './git.js';
+describe('git commit helpers', () => {
+    it('normalizes commit messages before executing git commit', () => {
+        expect(normalizeGitCommitMessage('  chore: update dashboard  ')).toBe('chore: update dashboard');
+        expect(normalizeGitCommitMessage('   ')).toBe('');
+        expect(normalizeGitCommitMessage(null)).toBe('');
+    });
+    it('creates pathspec args scoped to the selected workspace path', () => {
+        expect(createScopedGitPathspecArgs({ relativeWorkspacePath: 'packages/app' })).toEqual(['--', 'packages/app']);
+        expect(createScopedGitPathspecArgs({ relativeWorkspacePath: '' })).toEqual(['--', '.']);
+    });
+    it('creates file pathspec args relative to parent git repositories', () => {
+        expect(createScopedFilePathspecArgs('src/App.vue', { relativeWorkspacePath: 'packages/app' })).toEqual([
+            '--',
+            'packages/app/src/App.vue',
+        ]);
+    });
+    it('parses staged paths from porcelain status output', () => {
+        const stagedPaths = parseGitStatusStagedPaths('M  staged.ts\n M unstaged.ts\nA  added.ts\n?? untracked.ts\nR  old.ts -> renamed.ts\n');
+        expect([...stagedPaths].sort()).toEqual(['added.ts', 'renamed.ts', 'staged.ts']);
     });
 });

package/dist/routes/instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAYrD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,IAAI,CAEN;AAED,eAAO,MAAM,cAAc,4CAAW,CAAC;AAyBvC,wBAAgB,4BAA4B,CAAC,gBAAgB,EAAE,MAAM,GAAG;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,EAAE,EAAE,OAAO,CAAC;QACZ,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAqCA;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,iCAAiC;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,8BAA8B,CAAC;IACtC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,KAAK,EACZ,0BAA0B,EAAE,MAAM,GACjC,4BAA4B,CAiB9B;AAoDD;;;GAGG;AACH,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,MAAM,EAAE,GACnB,iCAAiC,CAUnC;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQhF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAaR;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC,CAY3F"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBrD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,IAAI,CAEN;AAED,eAAO,MAAM,cAAc,4CAAW,CAAC;AAmGvC,wBAAgB,4BAA4B,CAAC,gBAAgB,EAAE,MAAM,GAAG;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,EAAE,EAAE,OAAO,CAAC;QACZ,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAqCA;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,iCAAiC;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,8BAA8B,CAAC;IACtC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,KAAK,EACZ,0BAA0B,EAAE,MAAM,GACjC,4BAA4B,CAiB9B;AAoDD;;;GAGG;AACH,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,MAAM,EAAE,GACnB,iCAAiC,CAUnC;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQhF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAaR;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC,CAY3F"}

package/dist/routes/instance.js

@@ -1,5 +1,6 @@
 import { Router } from "express";
 import axios from "axios";
+import { spawn } from "node:child_process";
 import { createHash, timingSafeEqual } from "node:crypto";
 import { validateToken } from "../middleware/auth.js";
 import { resolveSchedulerBaseUrlFrom } from "../config.js";
@@ -20,6 +21,63 @@ export function setGracefulShutdownFn(fn) {
     gracefulShutdownFn = fn;
 }
 export const instanceRouter = Router();
+function resolveNpmExecutable() {
+    return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+function truncateCommandOutput(output) {
+    const maxLength = 16_000;
+    return output.length > maxLength
+        ? `${output.slice(output.length - maxLength)}\n[output truncated]`
+        : output;
+}
+function runCommand(command, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            shell: false,
+            windowsHide: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", reject);
+        child.on("close", (exitCode) => {
+            resolve({
+                command,
+                args,
+                exitCode,
+                stdout: truncateCommandOutput(stdout),
+                stderr: truncateCommandOutput(stderr),
+            });
+        });
+    });
+}
+async function writeRestartSessionFlag(preserveSessions) {
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    const os = await import("node:os");
+    const restartFlagFile = path.join(os.tmpdir(), "agentswork-runtime-bridge", ".preserve-sessions");
+    if (preserveSessions) {
+        await fs.mkdir(path.dirname(restartFlagFile), { recursive: true });
+        await fs.writeFile(restartFlagFile, JSON.stringify({
+            preserveSessions: true,
+            timestamp: new Date().toISOString(),
+        }), "utf-8");
+        log.info(`[prepare-restart] 已创建保留会话标记文件: ${restartFlagFile}`);
+        return;
+    }
+    try {
+        await fs.unlink(restartFlagFile);
+        log.info("[prepare-restart] 已删除保留会话标记文件");
+    }
+    catch {
+        // 文件不存在时无需处理。
+    }
+}
 function md5Hex(value) {
     return createHash("md5").update(value, "utf8").digest("hex");
 }
@@ -488,30 +546,8 @@ instanceRouter.post("/prepare-restart", validateToken, async (req, res) => {
     const { preserveSessions = true } = req.body || {};
     try {
         log.info(`[prepare-restart] 收到准备重启通知，preserveSessions=${preserveSessions}`);
-        // 记录重启模式到文件，供下次启动时判断
-        const fs = await import("fs/promises");
-        const path = await import("path");
-        const os = await import("os");
-        const restartFlagFile = path.join(os.tmpdir(), "agentswork-runtime-bridge", ".preserve-sessions");
-        if (preserveSessions) {
-            // 创建标记文件，表示 aws-mcp-server 重启，需要保留会话
-            await fs.mkdir(path.dirname(restartFlagFile), { recursive: true });
-            await fs.writeFile(restartFlagFile, JSON.stringify({
-                preserveSessions: true,
-                timestamp: new Date().toISOString(),
-            }), "utf-8");
-            log.info(`[prepare-restart] 已创建保留会话标记文件: ${restartFlagFile}`);
-        }
-        else {
-            // 删除标记文件，表示 bridge 自己关闭，需要清理会话
-            try {
-                await fs.unlink(restartFlagFile);
-                log.info(`[prepare-restart] 已删除保留会话标记文件`);
-            }
-            catch {
-                // 文件不存在，忽略
-            }
-        }
+        // 记录重启模式到文件，供下次启动时判断。
+        await writeRestartSessionFlag(Boolean(preserveSessions));
         res.json({
             ok: true,
             preserveSessions,
@@ -526,3 +562,69 @@ instanceRouter.post("/prepare-restart", validateToken, async (req, res) => {
         res.status(500).json({ error: err.message });
     }
 });
+/**
+ * POST /runtime/update-bridge
+ *
+ * 通过当前 Bridge 进程执行全局 npm 包更新，等价于 CLI 的
+ * `awsb update`，用于面板上的“更新实例 Bridge”。
+ */
+instanceRouter.post("/update-bridge", validateToken, async (_req, res) => {
+    const command = resolveNpmExecutable();
+    const args = ["install", "-g", "aws-runtime-bridge@latest"];
+    try {
+        log.info("[update-bridge] 正在更新 aws-runtime-bridge 到最新版本");
+        const result = await runCommand(command, args);
+        if (result.exitCode !== 0) {
+            res.status(500).json({
+                ok: false,
+                error: `更新失败，npm 退出码: ${result.exitCode ?? "unknown"}`,
+                result,
+            });
+            return;
+        }
+        res.json({
+            ok: true,
+            message: "Bridge 更新完成，请重启实例 Bridge 以加载新版本。",
+            result,
+        });
+    }
+    catch (error) {
+        const err = error;
+        log.error("[update-bridge] Error:", err);
+        res.status(500).json({ error: err.message || "update bridge failed" });
+    }
+});
+/**
+ * POST /runtime/restart-bridge
+ *
+ * 写入保留会话标记后优雅关闭当前 Bridge 进程。真正的重新拉起由
+ * systemd、PM2、Docker 外部守护或用户手动启动完成。
+ */
+instanceRouter.post("/restart-bridge", validateToken, async (req, res) => {
+    const { preserveSessions = true } = req.body || {};
+    try {
+        log.info(`[restart-bridge] 收到实例 Bridge 重启请求，preserveSessions=${preserveSessions}`);
+        await writeRestartSessionFlag(Boolean(preserveSessions));
+        res.json({
+            ok: true,
+            preserveSessions: Boolean(preserveSessions),
+            message: "Bridge 正在优雅退出；若实例由 systemd/PM2 等守护管理，将自动重启，否则需要手动重新启动。",
+        });
+        setTimeout(() => {
+            if (gracefulShutdownFn) {
+                gracefulShutdownFn("PANEL_RESTART", Boolean(preserveSessions)).catch((error) => {
+                    const err = error;
+                    log.error("[restart-bridge] graceful shutdown failed:", err);
+                    process.exit(1);
+                });
+                return;
+            }
+            process.exit(0);
+        }, 250);
+    }
+    catch (error) {
+        const err = error;
+        log.error("[restart-bridge] Error:", err);
+        res.status(500).json({ error: err.message || "restart bridge failed" });
+    }
+});

package/dist/routes/instance.test.js

@@ -2,6 +2,8 @@
  * Instance 路由单元测试
  */
 import { describe, it, expect, vi, afterEach } from 'vitest';
+import { EventEmitter } from 'node:events';
+const spawnMock = vi.hoisted(() => vi.fn());
 vi.mock('axios', () => ({
     default: {
         get: vi.fn(),
@@ -14,9 +16,36 @@ vi.mock('../services/auto-register.js', () => ({
 vi.mock('../services/runtime-binding.js', () => ({
     getRuntimeAccessToken: vi.fn(() => 'stale-runtime-token-123456'),
 }));
+vi.mock('node:child_process', async (importOriginal) => ({
+    ...(await importOriginal()),
+    spawn: spawnMock,
+}));
 afterEach(() => {
+    vi.useRealTimers();
     vi.clearAllMocks();
 });
+function mockSpawnResult(exitCode, stdoutText = '', stderrText = '') {
+    spawnMock.mockImplementationOnce(() => {
+        const child = new EventEmitter();
+        child.stdout = new EventEmitter();
+        child.stderr = new EventEmitter();
+        process.nextTick(() => {
+            if (stdoutText) {
+                child.stdout.emit('data', Buffer.from(stdoutText));
+            }
+            if (stderrText) {
+                child.stderr.emit('data', Buffer.from(stderrText));
+            }
+            child.emit('close', exitCode);
+        });
+        return child;
+    });
+}
+function createMockResponse() {
+    const json = vi.fn();
+    const status = vi.fn(() => ({ json }));
+    return { json, status };
+}
 describe('instance route validation', () => {
     it('builds correct ping response when healthy', () => {
         const buildPingResponse = (schedulerStatus, schedulerBaseUrl) => ({
@@ -292,4 +321,52 @@ describe('instance route validation', () => {
             hint: expect.stringContaining('AWS_RUNTIME_SCHEDULER_BASE_URL'),
         });
     });
+    it('updates bridge package through npm global install route', async () => {
+        const { instanceRouter } = await import('./instance.js');
+        mockSpawnResult(0, 'updated');
+        const handler = instanceRouter.stack.find((layer) => layer.route?.path === '/update-bridge')?.route?.stack[1]?.handle;
+        expect(handler).toBeTypeOf('function');
+        const { json, status } = createMockResponse();
+        await handler?.({}, { json, status }, vi.fn());
+        expect(spawnMock).toHaveBeenCalledWith(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install', '-g', 'aws-runtime-bridge@latest'], { shell: false, windowsHide: true });
+        expect(status).not.toHaveBeenCalled();
+        expect(json).toHaveBeenCalledWith({
+            ok: true,
+            message: 'Bridge 更新完成，请重启实例 Bridge 以加载新版本。',
+            result: expect.objectContaining({ exitCode: 0, stdout: 'updated' }),
+        });
+    });
+    it('returns update failure details when npm exits non-zero', async () => {
+        const { instanceRouter } = await import('./instance.js');
+        mockSpawnResult(1, '', 'permission denied');
+        const handler = instanceRouter.stack.find((layer) => layer.route?.path === '/update-bridge')?.route?.stack[1]?.handle;
+        expect(handler).toBeTypeOf('function');
+        const { json, status } = createMockResponse();
+        await handler?.({}, { json, status }, vi.fn());
+        expect(status).toHaveBeenCalledWith(500);
+        expect(json).toHaveBeenCalledWith({
+            ok: false,
+            error: '更新失败，npm 退出码: 1',
+            result: expect.objectContaining({ exitCode: 1, stderr: 'permission denied' }),
+        });
+    });
+    it('responds before triggering graceful bridge restart', async () => {
+        vi.useFakeTimers();
+        const { instanceRouter, setGracefulShutdownFn } = await import('./instance.js');
+        const gracefulShutdown = vi.fn().mockResolvedValue(undefined);
+        setGracefulShutdownFn(gracefulShutdown);
+        const handler = instanceRouter.stack.find((layer) => layer.route?.path === '/restart-bridge')?.route?.stack[1]?.handle;
+        expect(handler).toBeTypeOf('function');
+        const { json, status } = createMockResponse();
+        await handler?.({ body: { preserveSessions: true } }, { json, status }, vi.fn());
+        expect(status).not.toHaveBeenCalled();
+        expect(json).toHaveBeenCalledWith({
+            ok: true,
+            preserveSessions: true,
+            message: 'Bridge 正在优雅退出；若实例由 systemd/PM2 等守护管理，将自动重启，否则需要手动重新启动。',
+        });
+        expect(gracefulShutdown).not.toHaveBeenCalled();
+        await vi.advanceTimersByTimeAsync(250);
+        expect(gracefulShutdown).toHaveBeenCalledWith('PANEL_RESTART', true);
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-runtime-bridge",
-  "version": "1.7.31",
+  "version": "1.7.32",
   "description": "AgentsWorkStudio runtime bridge service for machine-level agent runtime integration",
   "type": "module",
   "main": "dist/index.js",