agent-things 0.0.0-stage → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/NOTICE +5 -0
- package/README.md +221 -2
- package/README.zh-CN.md +222 -0
- package/bin/agent-things.cjs +8 -0
- package/bin/antigravity-session-status.cjs +96 -0
- package/bin/claude-session-status.cjs +55 -0
- package/bin/codex-session-status.cjs +287 -0
- package/mods/agent-things-ui/.claude-plugin/plugin.json +12 -0
- package/mods/agent-things-ui/SKILL.md +10 -0
- package/mods/agent-things-ui/hooks/controls.js +112 -0
- package/mods/agent-things-ui/hooks/foundation.js +431 -0
- package/mods/agent-things-ui/hooks/hooks.json +1 -0
- package/mods/agent-things-ui/hooks/presentation.js +223 -0
- package/mods/agent-things-ui/hooks/progress.js +1 -0
- package/mods/agent-things-ui/hooks/register.js +382 -0
- package/native/bin/bridge +0 -0
- package/native/bin/bridge.json +20 -0
- package/native/session-status-bridge.swift +280 -0
- package/outputs/antigravity-session-status.js +2476 -0
- package/outputs/codex-session-status.js +1761 -0
- package/package.json +75 -4
- package/scripts/build-antigravity-bundle.cjs +35 -0
- package/scripts/build-codex-bundle.cjs +31 -0
- package/scripts/build-native-bridge.cjs +55 -0
- package/scripts/build-shared-ui.cjs +16 -0
- package/scripts/setup-antigravity-service.cjs +71 -0
- package/scripts/setup-claude-service.cjs +21 -0
- package/skills/agent-things/SKILL.en.md +95 -0
- package/skills/agent-things/SKILL.md +99 -0
- package/skills/codex/things/SKILL.en.md +10 -0
- package/skills/codex/things/SKILL.md +10 -0
- package/skills/things/SKILL.en.md +10 -0
- package/skills/things/SKILL.md +10 -0
- package/skills/things/checklist.en.md +91 -0
- package/skills/things/checklist.md +95 -0
- package/src/analysis-app-server.cjs +74 -0
- package/src/analysis-assets/output.en.schema.json +93 -0
- package/src/analysis-assets/output.schema.json +93 -0
- package/src/analysis-assets/prompt.en.txt +17 -0
- package/src/analysis-assets/prompt.zh-CN.txt +18 -0
- package/src/analysis-budget.cjs +105 -0
- package/src/analysis-git.cjs +38 -0
- package/src/analysis-history.cjs +150 -0
- package/src/analysis-ledger.cjs +82 -0
- package/src/analysis-log.cjs +62 -0
- package/src/analysis-runner.cjs +203 -0
- package/src/analysis-service.cjs +197 -0
- package/src/analysis-source.cjs +72 -0
- package/src/antigravity-card.cjs +2063 -0
- package/src/antigravity-hook.cjs +138 -0
- package/src/antigravity-mcp-config.cjs +36 -0
- package/src/app-server.cjs +96 -0
- package/src/cdp.cjs +115 -0
- package/src/claude-inline-install.cjs +38 -0
- package/src/claude-mcp-config.cjs +29 -0
- package/src/cli/arguments.cjs +30 -0
- package/src/cli/environment-probe.cjs +130 -0
- package/src/cli/integration-state.cjs +15 -0
- package/src/cli/interactive-cli.cjs +236 -0
- package/src/cli/prompt-tui.cjs +420 -0
- package/src/cli/setup-orchestrator.cjs +449 -0
- package/src/codex-mcp-config.cjs +67 -0
- package/src/harnesses/antigravity/analysis-profile.cjs +41 -0
- package/src/harnesses/antigravity/antigravity-git.cjs +89 -0
- package/src/harnesses/antigravity/antigravity-harness.js +1477 -0
- package/src/harnesses/antigravity/antigravity-injector.cjs +104 -0
- package/src/harnesses/antigravity/antigravity-migration.cjs +235 -0
- package/src/harnesses/antigravity/antigravity-service.cjs +357 -0
- package/src/harnesses/antigravity/antigravity-title.cjs +155 -0
- package/src/harnesses/antigravity/gemini-runner.cjs +304 -0
- package/src/harnesses/antigravity/transcript-cleaner.cjs +129 -0
- package/src/harnesses/antigravity/transcript-source.cjs +100 -0
- package/src/harnesses/claude/claude-harness.js +93 -0
- package/src/harnesses/claude/claude-host-helper.cjs +176 -0
- package/src/harnesses/claude/claude-injector.cjs +95 -0
- package/src/harnesses/claude/claude-local-source.cjs +106 -0
- package/src/harnesses/claude/claude-navigation.cjs +99 -0
- package/src/harnesses/claude/claude-runner.cjs +74 -0
- package/src/harnesses/claude/claude-service.cjs +313 -0
- package/src/harnesses/claude/claude-source.cjs +70 -0
- package/src/harnesses/codex/codex-analysis.cjs +10 -0
- package/src/harnesses/codex/codex-card-bridge.js +123 -0
- package/src/harnesses/codex/codex-card-events.cjs +76 -0
- package/src/harnesses/codex/codex-card.cjs +169 -0
- package/src/harnesses/codex/codex-git.cjs +24 -0
- package/src/harnesses/codex/codex-harness.js +229 -0
- package/src/harnesses/codex/codex-local-card.js +97 -0
- package/src/harnesses/codex/codex-progress-context.cjs +84 -0
- package/src/harnesses/codex/codex-service.cjs +502 -0
- package/src/i18n.cjs +174 -0
- package/src/launchd.cjs +105 -0
- package/src/lifecycle-lock.cjs +13 -0
- package/src/local-progress-http.cjs +267 -0
- package/src/manual-status-agent.cjs +12 -0
- package/src/manual-status-startup.cjs +66 -0
- package/src/manual-status-store.cjs +466 -0
- package/src/mcp-stdio.cjs +67 -0
- package/src/model-router.cjs +63 -0
- package/src/native-bridge.cjs +17 -0
- package/src/npm-updates.cjs +228 -0
- package/src/plugins/things/assets/logo.svg +13 -0
- package/src/plugins/things/plugin.json +6 -0
- package/src/plugins/things/sidecars/things_board/app.js +447 -0
- package/src/plugins/things/sidecars/things_board/index.html +2141 -0
- package/src/plugins/things/sidecars/things_board/main.mjs +652 -0
- package/src/plugins/things/sidecars/things_board/package.json +6 -0
- package/src/plugins/things/sidecars/things_board/sidecar.json +21 -0
- package/src/plugins/things/sidecars/things_board/styles.css +560 -0
- package/src/plugins/things/sidecars/things_board/ui-i18n.mjs +434 -0
- package/src/progress-error.cjs +54 -0
- package/src/progress-tools.cjs +145 -0
- package/src/project-path.cjs +15 -0
- package/src/renderer-resource.cjs +17 -0
- package/src/request-budget.cjs +24 -0
- package/src/resolve.cjs +51 -0
- package/src/runtime-install.cjs +635 -0
- package/src/session-status-filter.cjs +136 -0
- package/src/session-status.js +992 -0
- package/src/session-view.cjs +34 -0
- package/src/startup/controller.cjs +354 -0
- package/src/startup/watch.cjs +126 -0
- package/src/state-file-lock.cjs +31 -0
- package/src/task-provenance.cjs +42 -0
- package/src/ui-foundation.cjs +435 -0
|
@@ -0,0 +1,635 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
const fs = require('node:fs');
|
|
3
|
+
const path = require('node:path');
|
|
4
|
+
const os = require('node:os');
|
|
5
|
+
const { execFileSync } = require('node:child_process');
|
|
6
|
+
const { verifyBridgeBundle } = require('./native-bridge.cjs');
|
|
7
|
+
const PACKAGE_VERSION = require('../package.json').version;
|
|
8
|
+
|
|
9
|
+
const COMPONENT_ID = 'agent-things';
|
|
10
|
+
const MANAGED_MARKER_FILE = '.agent-things-managed.json';
|
|
11
|
+
const INSTALLED_COMPONENTS_FILE = 'installed-components.json';
|
|
12
|
+
|
|
13
|
+
function getTransactionFile(dataDir) {
|
|
14
|
+
return path.join(dataDir, 'installation-transaction.json');
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
function getInstalledComponentsFile(dataDir) {
|
|
18
|
+
return path.join(dataDir, INSTALLED_COMPONENTS_FILE);
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function writeTransactionAtomic(txFile, tx) {
|
|
22
|
+
const dir = path.dirname(txFile);
|
|
23
|
+
fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
24
|
+
const tmp = path.join(dir, `tx-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 6)}.tmp`);
|
|
25
|
+
const fd = fs.openSync(tmp, 'w', 0o600);
|
|
26
|
+
try {
|
|
27
|
+
fs.writeSync(fd, JSON.stringify(tx, null, 2) + '\n');
|
|
28
|
+
fs.fsyncSync(fd);
|
|
29
|
+
} finally {
|
|
30
|
+
fs.closeSync(fd);
|
|
31
|
+
}
|
|
32
|
+
fs.renameSync(tmp, txFile);
|
|
33
|
+
try {
|
|
34
|
+
const dirFd = fs.openSync(dir, 'r');
|
|
35
|
+
try { fs.fsyncSync(dirFd); } finally { fs.closeSync(dirFd); }
|
|
36
|
+
} catch (_) {}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* 统一归属核验规则:安装覆盖与卸载使用同一套规则。
|
|
41
|
+
* 明确区分三条互斥路径:
|
|
42
|
+
* 1. 正常受管 (Strict Managed):受管标记与外部登记严格强一致匹配
|
|
43
|
+
* 2. 历史纳管 (Legacy Adoptable):未带标记的历史开发版已知骨架结构
|
|
44
|
+
* 3. 登记修复 (Registry Repair):受管标记存在且有效,但外部登记缺失/损坏;默认拒绝,仅在显式修复授权时放行
|
|
45
|
+
* 4. 未知目录 (Unrecognized):坚决拒绝,杜绝无端覆盖与误删
|
|
46
|
+
*/
|
|
47
|
+
function verifyPluginOwnership(pluginDir, dataDir, options = {}) {
|
|
48
|
+
if (!fs.existsSync(pluginDir)) {
|
|
49
|
+
return { allowed: true, reason: 'not_exists' };
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
// 1. 优先核验版本化受管标记
|
|
53
|
+
const markerFile = path.join(pluginDir, MANAGED_MARKER_FILE);
|
|
54
|
+
if (fs.existsSync(markerFile)) {
|
|
55
|
+
let marker = null;
|
|
56
|
+
try {
|
|
57
|
+
marker = JSON.parse(fs.readFileSync(markerFile, 'utf8'));
|
|
58
|
+
} catch (_) {
|
|
59
|
+
return { allowed: false, path: 'corrupted', reason: 'corrupted_marker' };
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
if (!marker || marker.version !== 1 || marker.componentId !== COMPONENT_ID || marker.managed !== true) {
|
|
63
|
+
return { allowed: false, path: 'mismatched', reason: 'unrecognized_component' };
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
// 强制核验 installId:必须是非空有效字符串,缺失或伪造直接拒绝
|
|
67
|
+
if (!marker.installId || typeof marker.installId !== 'string' || !marker.installId.trim()) {
|
|
68
|
+
return { allowed: false, path: 'corrupted', reason: 'missing_install_id' };
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
// 校验 plugin.json 描述文件(若存在,名称必须匹配 things)
|
|
72
|
+
const pJson = path.join(pluginDir, 'plugin.json');
|
|
73
|
+
if (fs.existsSync(pJson)) {
|
|
74
|
+
try {
|
|
75
|
+
const parsed = JSON.parse(fs.readFileSync(pJson, 'utf8'));
|
|
76
|
+
if (parsed && parsed.name && parsed.name !== 'things') {
|
|
77
|
+
return { allowed: false, path: 'mismatched', reason: 'plugin_name_mismatch' };
|
|
78
|
+
}
|
|
79
|
+
} catch (_) {
|
|
80
|
+
return { allowed: false, path: 'corrupted', reason: 'corrupted_plugin_json' };
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
// 校验外部登记文件
|
|
85
|
+
const regFile = getInstalledComponentsFile(dataDir);
|
|
86
|
+
let reg = null;
|
|
87
|
+
let regCorrupted = false;
|
|
88
|
+
if (fs.existsSync(regFile)) {
|
|
89
|
+
try {
|
|
90
|
+
reg = JSON.parse(fs.readFileSync(regFile, 'utf8'));
|
|
91
|
+
} catch (_) {
|
|
92
|
+
regCorrupted = true;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
// 路径 3A:外部登记文件损坏
|
|
97
|
+
if (regCorrupted) {
|
|
98
|
+
if (options.allowRepair === true) {
|
|
99
|
+
return { allowed: true, path: 'repair', reason: 'registry_corrupted_repair_authorized', details: { marker, regFile } };
|
|
100
|
+
}
|
|
101
|
+
return { allowed: false, path: 'repair', reason: 'registry_corrupted', canRepair: true, details: { marker, regFile } };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// 路径 3B:外部登记文件不存在
|
|
105
|
+
if (!reg || !fs.existsSync(regFile)) {
|
|
106
|
+
if (options.allowRepair === true) {
|
|
107
|
+
return { allowed: true, path: 'repair', reason: 'registry_missing_repair_authorized', details: { marker } };
|
|
108
|
+
}
|
|
109
|
+
return { allowed: false, path: 'repair', reason: 'registry_missing', canRepair: true, details: { marker } };
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
// 路径 3C:外部登记存在,但缺少组件登记条目
|
|
113
|
+
const comp = reg.components && reg.components.antigravity_plugin;
|
|
114
|
+
if (!comp || !comp.installId) {
|
|
115
|
+
if (options.allowRepair === true) {
|
|
116
|
+
return { allowed: true, path: 'repair', reason: 'component_not_registered_repair_authorized', details: { marker, reg } };
|
|
117
|
+
}
|
|
118
|
+
return { allowed: false, path: 'repair', reason: 'component_not_registered', canRepair: true, details: { marker, reg } };
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// 冲突:外部登记记录了不同的 installId
|
|
122
|
+
if (comp.installId !== marker.installId) {
|
|
123
|
+
return {
|
|
124
|
+
allowed: false,
|
|
125
|
+
path: 'managed',
|
|
126
|
+
reason: 'install_id_mismatch',
|
|
127
|
+
details: { markerInstallId: marker.installId, regInstallId: comp.installId },
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
// 路径 1:正常受管插件,强一致匹配通过
|
|
132
|
+
return { allowed: true, path: 'managed', reason: 'managed_plugin', details: marker };
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
// 2. 路径 2:首次纳管流程(无受管标记,核验未带标记的历史/开发版已知特征)
|
|
136
|
+
const pJson = path.join(pluginDir, 'plugin.json');
|
|
137
|
+
const indexHtml = path.join(pluginDir, 'sidecars/things_board/index.html');
|
|
138
|
+
const logoSvg = path.join(pluginDir, 'assets/logo.svg');
|
|
139
|
+
if (fs.existsSync(pJson)) {
|
|
140
|
+
try {
|
|
141
|
+
const parsed = JSON.parse(fs.readFileSync(pJson, 'utf8'));
|
|
142
|
+
if (parsed.name === 'things' && fs.existsSync(indexHtml) && fs.existsSync(logoSvg)) {
|
|
143
|
+
return { allowed: true, path: 'adoptable', reason: 'legacy_adoptable', isAdoptable: true, details: parsed };
|
|
144
|
+
}
|
|
145
|
+
} catch (_) {}
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
// 3. 其它未知目录或第三方插件:坚决拒绝操作
|
|
149
|
+
return { allowed: false, path: 'unrecognized', reason: 'unrecognized_plugin' };
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/**
|
|
153
|
+
* 独立的显式登记修复操作:必须在用户明确授权下调用。
|
|
154
|
+
* 修复前自动备份原始登记与插件证据,登记损坏时保护其他组件信息。
|
|
155
|
+
*/
|
|
156
|
+
function repairPluginRegistry(dataDir, homeDirectory, options = {}) {
|
|
157
|
+
const home = homeDirectory || process.env.HOME || os.homedir();
|
|
158
|
+
const agyPluginDir = path.join(home, '.gemini/config/plugins/things');
|
|
159
|
+
const ownership = verifyPluginOwnership(agyPluginDir, dataDir);
|
|
160
|
+
|
|
161
|
+
if (ownership.path !== 'repair' || !ownership.canRepair) {
|
|
162
|
+
throw new Error(`当前目录无法执行登记修复(原因:${ownership.reason})`);
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
const marker = ownership.details && ownership.details.marker;
|
|
166
|
+
if (!marker || !marker.installId) {
|
|
167
|
+
throw new Error('受管标记缺失有效 installId,拒绝执行登记修复以防数据篡改');
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
const regFile = getInstalledComponentsFile(dataDir);
|
|
171
|
+
let existingComponents = {};
|
|
172
|
+
|
|
173
|
+
if (fs.existsSync(regFile)) {
|
|
174
|
+
// 修复前留存原始登记备份
|
|
175
|
+
const bakFile = `${regFile}.bak_${Date.now()}`;
|
|
176
|
+
try { fs.copyFileSync(regFile, bakFile); } catch (_) {}
|
|
177
|
+
|
|
178
|
+
try {
|
|
179
|
+
const parsed = JSON.parse(fs.readFileSync(regFile, 'utf8'));
|
|
180
|
+
if (parsed && typeof parsed.components === 'object' && parsed.components !== null) {
|
|
181
|
+
existingComponents = { ...parsed.components };
|
|
182
|
+
}
|
|
183
|
+
} catch (_) {
|
|
184
|
+
try { fs.copyFileSync(regFile, `${regFile}.corrupted.${Date.now()}`); } catch (_) {}
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
// 增量合并登记,保留其他组件
|
|
189
|
+
existingComponents.antigravity_plugin = {
|
|
190
|
+
componentId: COMPONENT_ID,
|
|
191
|
+
target: agyPluginDir,
|
|
192
|
+
installId: marker.installId,
|
|
193
|
+
packageVersion: marker.packageVersion || PACKAGE_VERSION,
|
|
194
|
+
repairedAt: new Date().toISOString(),
|
|
195
|
+
};
|
|
196
|
+
|
|
197
|
+
const regData = {
|
|
198
|
+
version: 1,
|
|
199
|
+
updatedAt: new Date().toISOString(),
|
|
200
|
+
components: existingComponents,
|
|
201
|
+
};
|
|
202
|
+
|
|
203
|
+
writeTransactionAtomic(regFile, regData);
|
|
204
|
+
return { success: true, repaired: true, installId: marker.installId };
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
function rollbackTransaction(tx) {
|
|
208
|
+
if (!tx || !Array.isArray(tx.targets)) return;
|
|
209
|
+
for (const targetInfo of [...tx.targets].reverse()) {
|
|
210
|
+
const { target, stagePath, backupPath, existed, step } = targetInfo;
|
|
211
|
+
const targetExists = fs.existsSync(target);
|
|
212
|
+
const backupExists = backupPath && fs.existsSync(backupPath);
|
|
213
|
+
const stageExists = stagePath && fs.existsSync(stagePath);
|
|
214
|
+
|
|
215
|
+
if (existed) {
|
|
216
|
+
const effectiveStep = step || (targetInfo.swapped || tx.stage === 'swapped' ? 'swap_done' : 'init');
|
|
217
|
+
// 原本存在的目标:按实际操作阶段精准回滚
|
|
218
|
+
if (effectiveStep === 'init' || effectiveStep === 'staged') {
|
|
219
|
+
// 本次事务尚未移走正式目录,正式目录保持原状,绝不使用历史或外部备份覆盖!
|
|
220
|
+
} else if (effectiveStep === 'prepare_backup') {
|
|
221
|
+
// 关键边界:旧目录成功移走但 backup_done 尚未落盘即中断
|
|
222
|
+
// 若 target 已消失且 backupPath 存在,必须将本次唯一备份还原回 target
|
|
223
|
+
if (!targetExists && backupExists) {
|
|
224
|
+
fs.renameSync(backupPath, target);
|
|
225
|
+
}
|
|
226
|
+
// 若 target 存在,说明尚未执行 rename 或已在先前回滚中还原成功,幂等安全
|
|
227
|
+
} else if (effectiveStep === 'backup_done' || effectiveStep === 'prepare_swap') {
|
|
228
|
+
// 目录已备份到 backupPath
|
|
229
|
+
if (backupExists) {
|
|
230
|
+
if (targetExists) {
|
|
231
|
+
fs.rmSync(target, { recursive: true, force: true });
|
|
232
|
+
}
|
|
233
|
+
fs.renameSync(backupPath, target);
|
|
234
|
+
}
|
|
235
|
+
// 若 backupExists 为 false 且 targetExists 为 true,说明先前回滚尝试已完成移回,幂等安全
|
|
236
|
+
} else if (effectiveStep === 'swap_done') {
|
|
237
|
+
// 正式目录已被新版本占用:先清理新版本,再将 backupPath 还原回 target
|
|
238
|
+
if (backupExists) {
|
|
239
|
+
if (targetExists) {
|
|
240
|
+
fs.rmSync(target, { recursive: true, force: true });
|
|
241
|
+
}
|
|
242
|
+
fs.renameSync(backupPath, target);
|
|
243
|
+
}
|
|
244
|
+
// 若 backupExists 为 false 且 targetExists 为 true,说明先前回滚已将备份还原回 target,幂等安全
|
|
245
|
+
}
|
|
246
|
+
} else {
|
|
247
|
+
// 原本不存在的目标(首次安装):恢复为不存在
|
|
248
|
+
if (targetExists) {
|
|
249
|
+
fs.rmSync(target, { recursive: true, force: true });
|
|
250
|
+
}
|
|
251
|
+
if (backupExists) {
|
|
252
|
+
fs.rmSync(backupPath, { recursive: true, force: true });
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
if (stageExists) {
|
|
257
|
+
fs.rmSync(stagePath, { recursive: true, force: true });
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
/**
|
|
263
|
+
* 可靠的事务提交状态探测器:在执行任何撤销/恢复前确认提交结果。
|
|
264
|
+
* 返回 { exists: boolean, corrupted: boolean, committed: boolean, stage: string|null, tx?: any, error?: string }
|
|
265
|
+
*/
|
|
266
|
+
function checkCommitStatus(dataDir) {
|
|
267
|
+
const file = getTransactionFile(dataDir);
|
|
268
|
+
if (!fs.existsSync(file)) {
|
|
269
|
+
return { exists: false, corrupted: false, committed: false, stage: null };
|
|
270
|
+
}
|
|
271
|
+
try {
|
|
272
|
+
const content = fs.readFileSync(file, 'utf8');
|
|
273
|
+
const tx = JSON.parse(content);
|
|
274
|
+
if (!tx || typeof tx !== 'object' || Array.isArray(tx)) {
|
|
275
|
+
return { exists: true, corrupted: true, committed: false, stage: null, error: '日志不是有效JSON对象' };
|
|
276
|
+
}
|
|
277
|
+
return {
|
|
278
|
+
exists: true,
|
|
279
|
+
corrupted: false,
|
|
280
|
+
committed: tx.stage === 'committed',
|
|
281
|
+
stage: tx.stage || null,
|
|
282
|
+
tx,
|
|
283
|
+
};
|
|
284
|
+
} catch (err) {
|
|
285
|
+
return { exists: true, corrupted: true, committed: false, stage: null, error: err.message };
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
/**
|
|
290
|
+
* 统一的幂等提交完成器(Finalizer)
|
|
291
|
+
* 顺序:增量更新组件登记落盘 -> 幂等清理备份与暂存 -> 移除事务日志
|
|
292
|
+
* 严格门禁:
|
|
293
|
+
* - 外部登记文件若存在,必须为有效 JSON 且结构合法(包含对象类型的 components 字段);
|
|
294
|
+
* - 登记文件损坏或结构无效时,坚决停止收尾并保留已提交事务现场供独立修复,绝不静默覆盖;
|
|
295
|
+
* - 仅当登记文件完全不存在时,才按首次安装规则建立全新登记。
|
|
296
|
+
*/
|
|
297
|
+
function finalizeCommit(dataDir, tx, txFile, targetPaths = []) {
|
|
298
|
+
// 1. 增量更新外部组件登记:保留未参与本次事务的其他组件
|
|
299
|
+
const regFile = getInstalledComponentsFile(dataDir);
|
|
300
|
+
let existingComponents = {};
|
|
301
|
+
|
|
302
|
+
if (fs.existsSync(regFile)) {
|
|
303
|
+
let parsed;
|
|
304
|
+
try {
|
|
305
|
+
parsed = JSON.parse(fs.readFileSync(regFile, 'utf8'));
|
|
306
|
+
} catch (parseErr) {
|
|
307
|
+
tx.finalizeError = `外部组件登记文件格式损坏: ${parseErr.message}`;
|
|
308
|
+
try { writeTransactionAtomic(txFile, tx); } catch (_) {}
|
|
309
|
+
throw new Error(`外部组件登记文件损坏 (${regFile}),为保护现有登记已停止提交收尾,请执行登记修复操作:${parseErr.message}`);
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed) || typeof parsed.components !== 'object' || parsed.components === null || Array.isArray(parsed.components)) {
|
|
313
|
+
tx.finalizeError = '外部组件登记文件结构无效(components 字段缺失或类型错误)';
|
|
314
|
+
try { writeTransactionAtomic(txFile, tx); } catch (_) {}
|
|
315
|
+
throw new Error(`外部组件登记文件结构无效 (${regFile}),为保护现有登记已停止提交收尾,请执行登记修复操作以核查并恢复数据`);
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
existingComponents = { ...parsed.components };
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
for (const t of tx.targets || []) {
|
|
322
|
+
existingComponents[t.name] = {
|
|
323
|
+
componentId: COMPONENT_ID,
|
|
324
|
+
target: t.target,
|
|
325
|
+
installId: tx.installId,
|
|
326
|
+
updatedAt: new Date().toISOString(),
|
|
327
|
+
};
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
const regData = {
|
|
331
|
+
version: 1,
|
|
332
|
+
updatedAt: new Date().toISOString(),
|
|
333
|
+
components: existingComponents,
|
|
334
|
+
};
|
|
335
|
+
|
|
336
|
+
try {
|
|
337
|
+
writeTransactionAtomic(regFile, regData);
|
|
338
|
+
} catch (regErr) {
|
|
339
|
+
// 登记落盘失败:保留已提交事务供恢复,绝不删除事务日志!
|
|
340
|
+
tx.finalizeError = `组件登记落盘失败: ${regErr.message}`;
|
|
341
|
+
try { writeTransactionAtomic(txFile, tx); } catch (_) {}
|
|
342
|
+
throw new Error(`安装提交已完成,但更新组件登记失败,收尾待恢复:${regErr.message}`);
|
|
343
|
+
}
|
|
344
|
+
|
|
345
|
+
// 2. 幂等清理备份与暂存目录
|
|
346
|
+
for (const t of tx.targets || []) {
|
|
347
|
+
if (t.backupPath && fs.existsSync(t.backupPath)) fs.rmSync(t.backupPath, { recursive: true, force: true });
|
|
348
|
+
if (t.stagePath && fs.existsSync(t.stagePath)) fs.rmSync(t.stagePath, { recursive: true, force: true });
|
|
349
|
+
}
|
|
350
|
+
for (const p of targetPaths) {
|
|
351
|
+
const backup = `${p}.previous`;
|
|
352
|
+
if (fs.existsSync(backup)) fs.rmSync(backup, { recursive: true, force: true });
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
// 3. 收尾全部完成,移除事务日志
|
|
356
|
+
fs.rmSync(txFile, { force: true });
|
|
357
|
+
return { committed: true, finalized: true };
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
function recoverPendingTransaction(dataDir) {
|
|
361
|
+
const file = getTransactionFile(dataDir);
|
|
362
|
+
if (!fs.existsSync(file)) return null;
|
|
363
|
+
let tx;
|
|
364
|
+
try {
|
|
365
|
+
tx = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
366
|
+
} catch (err) {
|
|
367
|
+
// 日志损坏:绝不删除日志和现场,停止并抛出明确错误
|
|
368
|
+
throw new Error(`检测到损坏的未完成安装事务日志 (${file}),为防止数据损坏已停止恢复,请保留现场进行人工核查:${err.message}`);
|
|
369
|
+
}
|
|
370
|
+
if (!tx || tx.version !== 1) {
|
|
371
|
+
throw new Error(`未完成事务日志格式无效 (${file}),已停止恢复以保留现场`);
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
// 若提交标记已落盘:统一执行幂等提交收尾(补写登记 + 幂等清理),绝不触发回滚
|
|
375
|
+
if (tx.stage === 'committed') {
|
|
376
|
+
finalizeCommit(dataDir, tx, file, []);
|
|
377
|
+
return { recovered: true, status: 'committed_cleanup' };
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
try {
|
|
381
|
+
rollbackTransaction(tx);
|
|
382
|
+
fs.rmSync(file, { force: true });
|
|
383
|
+
return { recovered: true, status: 'rolled_back' };
|
|
384
|
+
} catch (rollbackErr) {
|
|
385
|
+
// 回滚失败:保留日志并标记状态,绝不删除日志和现场
|
|
386
|
+
tx.stage = 'rollback_failed';
|
|
387
|
+
tx.rollbackError = rollbackErr.message;
|
|
388
|
+
try { writeTransactionAtomic(file, tx); } catch (_) {}
|
|
389
|
+
throw new Error(`未完成事务回滚失败,已保留事务日志与备份目录:${rollbackErr.message}`);
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
function commitInstallation(dataDir, targetPaths = []) {
|
|
394
|
+
const txFile = getTransactionFile(dataDir);
|
|
395
|
+
if (fs.existsSync(txFile)) {
|
|
396
|
+
let tx = null;
|
|
397
|
+
try {
|
|
398
|
+
tx = JSON.parse(fs.readFileSync(txFile, 'utf8'));
|
|
399
|
+
} catch (err) {
|
|
400
|
+
throw new Error(`无法确认事务状态:事务日志文件损坏 (${err.message})`);
|
|
401
|
+
}
|
|
402
|
+
|
|
403
|
+
if (!tx || typeof tx !== 'object' || Array.isArray(tx)) {
|
|
404
|
+
throw new Error('无法确认事务状态:事务日志格式无效');
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
if (tx.version === 1) {
|
|
408
|
+
// 1. 提交标记原子落盘持久化
|
|
409
|
+
tx.stage = 'committed';
|
|
410
|
+
tx.committedAt = new Date().toISOString();
|
|
411
|
+
writeTransactionAtomic(txFile, tx);
|
|
412
|
+
|
|
413
|
+
// 2. 统一执行提交收尾
|
|
414
|
+
finalizeCommit(dataDir, tx, txFile, targetPaths);
|
|
415
|
+
return { success: true, committed: true, finalized: true };
|
|
416
|
+
}
|
|
417
|
+
fs.rmSync(txFile, { force: true });
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
for (const p of targetPaths) {
|
|
421
|
+
const backup = `${p}.previous`;
|
|
422
|
+
if (fs.existsSync(backup)) fs.rmSync(backup, { recursive: true, force: true });
|
|
423
|
+
}
|
|
424
|
+
return { success: true, committed: true, finalized: true };
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
function stageRuntime(source, stage, installId) {
|
|
428
|
+
for (const directory of ['src', 'bin', 'skills', 'native', 'mods']) {
|
|
429
|
+
const srcDir = path.join(source, directory);
|
|
430
|
+
if (!fs.existsSync(srcDir)) continue;
|
|
431
|
+
fs.cpSync(srcDir, path.join(stage, directory), {
|
|
432
|
+
recursive: true,
|
|
433
|
+
filter: file => !/\.bak(?:_|$)|\.log$|\.DS_Store$/.test(path.basename(file)) && !['tests', 'test', 'evals', 'node_modules'].includes(path.basename(file)),
|
|
434
|
+
});
|
|
435
|
+
}
|
|
436
|
+
fs.mkdirSync(path.join(stage, 'scripts'), { recursive: true });
|
|
437
|
+
for (const name of ['setup-antigravity-service.cjs', 'setup-claude-service.cjs', 'build-codex-bundle.cjs', 'build-antigravity-bundle.cjs', 'build-shared-ui.cjs']) {
|
|
438
|
+
const scriptFile = path.join(source, 'scripts', name);
|
|
439
|
+
if (fs.existsSync(scriptFile)) {
|
|
440
|
+
fs.copyFileSync(scriptFile, path.join(stage, 'scripts', name));
|
|
441
|
+
}
|
|
442
|
+
}
|
|
443
|
+
for (const name of ['LICENSE', 'NOTICE', 'package.json']) {
|
|
444
|
+
const docFile = path.join(source, name);
|
|
445
|
+
if (fs.existsSync(docFile)) {
|
|
446
|
+
fs.copyFileSync(docFile, path.join(stage, name));
|
|
447
|
+
}
|
|
448
|
+
}
|
|
449
|
+
// 写入受管标记
|
|
450
|
+
const marker = {
|
|
451
|
+
version: 1,
|
|
452
|
+
componentId: COMPONENT_ID,
|
|
453
|
+
packageVersion: PACKAGE_VERSION,
|
|
454
|
+
installId,
|
|
455
|
+
managed: true,
|
|
456
|
+
installedAt: new Date().toISOString(),
|
|
457
|
+
};
|
|
458
|
+
fs.writeFileSync(path.join(stage, MANAGED_MARKER_FILE), JSON.stringify(marker, null, 2) + '\n', { mode: 0o600 });
|
|
459
|
+
execFileSync(process.execPath, [path.join(stage, 'bin/codex-session-status.cjs'), 'help'], { stdio: 'pipe', timeout: 5000 });
|
|
460
|
+
}
|
|
461
|
+
|
|
462
|
+
function stageAntigravityPlugin(source, stage, installId) {
|
|
463
|
+
const pluginSrc = path.join(source, 'src/plugins/things');
|
|
464
|
+
if (!fs.existsSync(pluginSrc)) {
|
|
465
|
+
throw new Error('安装包缺少 Antigravity 插件源码 (src/plugins/things)');
|
|
466
|
+
}
|
|
467
|
+
fs.cpSync(pluginSrc, stage, {
|
|
468
|
+
recursive: true,
|
|
469
|
+
filter: file => !/\.bak(?:_|$)|\.log$|\.DS_Store$/.test(path.basename(file)) && !['tests', 'test', 'evals', 'node_modules'].includes(path.basename(file)),
|
|
470
|
+
});
|
|
471
|
+
const pJson = path.join(stage, 'plugin.json');
|
|
472
|
+
if (!fs.existsSync(pJson)) {
|
|
473
|
+
throw new Error('Antigravity 插件缺少 plugin.json 元数据描述');
|
|
474
|
+
}
|
|
475
|
+
// 写入受管标记
|
|
476
|
+
const marker = {
|
|
477
|
+
version: 1,
|
|
478
|
+
componentId: COMPONENT_ID,
|
|
479
|
+
packageVersion: PACKAGE_VERSION,
|
|
480
|
+
installId,
|
|
481
|
+
managed: true,
|
|
482
|
+
installedAt: new Date().toISOString(),
|
|
483
|
+
};
|
|
484
|
+
fs.writeFileSync(path.join(stage, MANAGED_MARKER_FILE), JSON.stringify(marker, null, 2) + '\n', { mode: 0o600 });
|
|
485
|
+
}
|
|
486
|
+
|
|
487
|
+
function installRuntime(source, runtime, options = {}) {
|
|
488
|
+
// 契约收紧:必须显式指定应用,禁止无意识默认包含 antigravity
|
|
489
|
+
const enabledApps = Array.isArray(options.enabledApps) ? options.enabledApps : ['codex'];
|
|
490
|
+
const dataDir = options.dataDir || path.dirname(runtime);
|
|
491
|
+
const homeDirectory = options.homeDirectory || process.env.HOME || os.homedir();
|
|
492
|
+
|
|
493
|
+
fs.mkdirSync(dataDir, { recursive: true, mode: 0o700 });
|
|
494
|
+
recoverPendingTransaction(dataDir);
|
|
495
|
+
|
|
496
|
+
const txFile = getTransactionFile(dataDir);
|
|
497
|
+
const pid = process.pid;
|
|
498
|
+
const installId = `inst-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
|
|
499
|
+
|
|
500
|
+
const targets = [];
|
|
501
|
+
targets.push({
|
|
502
|
+
name: 'runtime',
|
|
503
|
+
target: runtime,
|
|
504
|
+
stagePath: `${runtime}.stage.${pid}`,
|
|
505
|
+
backupPath: `${runtime}.backup.${installId}`,
|
|
506
|
+
existed: fs.existsSync(runtime),
|
|
507
|
+
step: 'init',
|
|
508
|
+
stageFn: (sDir) => stageRuntime(source, sDir, installId),
|
|
509
|
+
});
|
|
510
|
+
|
|
511
|
+
const agyPluginDir = path.join(homeDirectory, '.gemini/config/plugins/things');
|
|
512
|
+
const agyPluginSrc = path.join(source, 'src/plugins/things');
|
|
513
|
+
|
|
514
|
+
if (enabledApps.includes('antigravity') && fs.existsSync(agyPluginSrc)) {
|
|
515
|
+
// 统一归属核验门禁
|
|
516
|
+
const ownership = verifyPluginOwnership(agyPluginDir, dataDir, { action: 'install' });
|
|
517
|
+
if (!ownership.allowed) {
|
|
518
|
+
throw new Error(`已有目录 ${agyPluginDir} 无法确认归属或属于其他插件(原因:${ownership.reason}),已终止安装以保护用户数据`);
|
|
519
|
+
}
|
|
520
|
+
targets.push({
|
|
521
|
+
name: 'antigravity_plugin',
|
|
522
|
+
target: agyPluginDir,
|
|
523
|
+
stagePath: `${agyPluginDir}.stage.${pid}`,
|
|
524
|
+
backupPath: `${agyPluginDir}.backup.${installId}`,
|
|
525
|
+
existed: fs.existsSync(agyPluginDir),
|
|
526
|
+
step: 'init',
|
|
527
|
+
stageFn: (sDir) => stageAntigravityPlugin(source, sDir, installId),
|
|
528
|
+
});
|
|
529
|
+
}
|
|
530
|
+
|
|
531
|
+
const tx = {
|
|
532
|
+
version: 1,
|
|
533
|
+
pid,
|
|
534
|
+
installId,
|
|
535
|
+
createdAt: new Date().toISOString(),
|
|
536
|
+
stage: 'init',
|
|
537
|
+
targets: targets.map(({ name, target, stagePath, backupPath, existed, step }) => ({
|
|
538
|
+
name, target, stagePath, backupPath, existed, step,
|
|
539
|
+
})),
|
|
540
|
+
};
|
|
541
|
+
writeTransactionAtomic(txFile, tx);
|
|
542
|
+
|
|
543
|
+
try {
|
|
544
|
+
// 阶段 1:暂存构建
|
|
545
|
+
for (let i = 0; i < targets.length; i++) {
|
|
546
|
+
const t = targets[i];
|
|
547
|
+
fs.rmSync(t.stagePath, { recursive: true, force: true });
|
|
548
|
+
fs.mkdirSync(t.stagePath, { recursive: true });
|
|
549
|
+
t.stageFn(t.stagePath);
|
|
550
|
+
t.step = 'staged';
|
|
551
|
+
tx.targets[i].step = 'staged';
|
|
552
|
+
}
|
|
553
|
+
tx.stage = 'staged';
|
|
554
|
+
writeTransactionAtomic(txFile, tx);
|
|
555
|
+
|
|
556
|
+
// 阶段 2:细粒度原子重命名(区分意图与完成)
|
|
557
|
+
for (let i = 0; i < targets.length; i++) {
|
|
558
|
+
const t = targets[i];
|
|
559
|
+
|
|
560
|
+
// 步 2.1:准备备份
|
|
561
|
+
tx.targets[i].step = 'prepare_backup';
|
|
562
|
+
writeTransactionAtomic(txFile, tx);
|
|
563
|
+
|
|
564
|
+
fs.rmSync(t.backupPath, { recursive: true, force: true });
|
|
565
|
+
if (t.existed) {
|
|
566
|
+
fs.renameSync(t.target, t.backupPath);
|
|
567
|
+
}
|
|
568
|
+
|
|
569
|
+
// 步 2.2:备份完成
|
|
570
|
+
tx.targets[i].step = 'backup_done';
|
|
571
|
+
writeTransactionAtomic(txFile, tx);
|
|
572
|
+
|
|
573
|
+
// 步 2.3:准备替换正式位置
|
|
574
|
+
tx.targets[i].step = 'prepare_swap';
|
|
575
|
+
writeTransactionAtomic(txFile, tx);
|
|
576
|
+
|
|
577
|
+
fs.renameSync(t.stagePath, t.target);
|
|
578
|
+
|
|
579
|
+
// 步 2.4:替换完成
|
|
580
|
+
tx.targets[i].step = 'swap_done';
|
|
581
|
+
writeTransactionAtomic(txFile, tx);
|
|
582
|
+
}
|
|
583
|
+
|
|
584
|
+
tx.stage = 'swapped';
|
|
585
|
+
writeTransactionAtomic(txFile, tx);
|
|
586
|
+
// 替换完成,保持 backupPath 留存,由外层整体成功后 commitInstallation 清理
|
|
587
|
+
} catch (error) {
|
|
588
|
+
tx.stage = 'failed';
|
|
589
|
+
tx.error = error.message;
|
|
590
|
+
try { writeTransactionAtomic(txFile, tx); } catch (_) {}
|
|
591
|
+
try {
|
|
592
|
+
rollbackTransaction(tx);
|
|
593
|
+
fs.rmSync(txFile, { force: true });
|
|
594
|
+
} catch (rbErr) {
|
|
595
|
+
tx.stage = 'rollback_failed';
|
|
596
|
+
tx.rollbackError = rbErr.message;
|
|
597
|
+
try { writeTransactionAtomic(txFile, tx); } catch (_) {}
|
|
598
|
+
throw new Error(`安装失败 (${error.message}),且回滚失败:${rbErr.message}`);
|
|
599
|
+
}
|
|
600
|
+
throw error;
|
|
601
|
+
}
|
|
602
|
+
}
|
|
603
|
+
|
|
604
|
+
function prepareStartup(source, directory) {
|
|
605
|
+
fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
606
|
+
const bridge = path.join(directory, 'bridge');
|
|
607
|
+
const temporary = `${bridge}.building`;
|
|
608
|
+
try {
|
|
609
|
+
fs.copyFileSync(verifyBridgeBundle(source), temporary);
|
|
610
|
+
fs.chmodSync(temporary, 0o755);
|
|
611
|
+
const version = JSON.parse(execFileSync(temporary, ['version'], { encoding: 'utf8', stdio: 'pipe', timeout: 5000 }));
|
|
612
|
+
if (version.protocol !== 1) throw new Error('启动桥协议不匹配,请重新获取安装包');
|
|
613
|
+
fs.renameSync(temporary, bridge);
|
|
614
|
+
} finally { fs.rmSync(temporary, { force: true }); }
|
|
615
|
+
const settings = path.join(directory, 'autostart.json');
|
|
616
|
+
if (!fs.existsSync(settings)) fs.writeFileSync(settings, JSON.stringify({ app: '/Applications/ChatGPT.app', allowClientRestart: true }) + '\n', { mode: 0o600 });
|
|
617
|
+
}
|
|
618
|
+
|
|
619
|
+
module.exports = {
|
|
620
|
+
COMPONENT_ID,
|
|
621
|
+
MANAGED_MARKER_FILE,
|
|
622
|
+
INSTALLED_COMPONENTS_FILE,
|
|
623
|
+
installRuntime,
|
|
624
|
+
prepareStartup,
|
|
625
|
+
commitInstallation,
|
|
626
|
+
recoverPendingTransaction,
|
|
627
|
+
rollbackTransaction,
|
|
628
|
+
writeTransactionAtomic,
|
|
629
|
+
verifyPluginOwnership,
|
|
630
|
+
repairPluginRegistry,
|
|
631
|
+
checkCommitStatus,
|
|
632
|
+
finalizeCommit,
|
|
633
|
+
getTransactionFile,
|
|
634
|
+
getInstalledComponentsFile,
|
|
635
|
+
};
|