agent-steward 0.0.4 → 0.0.5
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/CHANGELOG.md +134 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +52 -7
- package/ROADMAP-STRATEGY.md +21 -18
- package/ROADMAP.md +140 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +351 -0
- package/dist/core/execution.d.ts +203 -0
- package/dist/core/execution.d.ts.map +1 -0
- package/dist/core/execution.js +309 -0
- package/dist/core/gate-integrity.d.ts +35 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +132 -0
- package/dist/core/git-trigger.d.ts.map +1 -1
- package/dist/core/git-trigger.js +14 -2
- package/dist/core/guard-run.d.ts +4 -0
- package/dist/core/guard-run.d.ts.map +1 -0
- package/dist/core/guard-run.js +101 -0
- package/dist/core/guard.d.ts +52 -0
- package/dist/core/guard.d.ts.map +1 -0
- package/dist/core/guard.js +362 -0
- package/dist/core/lock.d.ts +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +75 -15
- package/dist/core/mission.d.ts +83 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +334 -0
- package/dist/core/pipeline-apply.d.ts +38 -0
- package/dist/core/pipeline-apply.d.ts.map +1 -0
- package/dist/core/pipeline-apply.js +117 -0
- package/dist/core/pipeline-io.d.ts +13 -0
- package/dist/core/pipeline-io.d.ts.map +1 -0
- package/dist/core/pipeline-io.js +64 -0
- package/dist/core/pipeline-map.d.ts +46 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +196 -0
- package/dist/core/pipeline-spec.d.ts +109 -0
- package/dist/core/pipeline-spec.d.ts.map +1 -0
- package/dist/core/pipeline-spec.js +554 -0
- package/dist/core/ps-wrapper.d.ts +19 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +250 -62
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +130 -29
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -0
- package/dist/core/scheduler/linux.d.ts +8 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +34 -9
- package/dist/core/scheduler/mac.d.ts +44 -2
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +126 -15
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +15 -12
- package/dist/core/structured-log.d.ts +7 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/worktree-run.d.ts +4 -0
- package/dist/core/worktree-run.d.ts.map +1 -0
- package/dist/core/worktree-run.js +164 -0
- package/dist/core/worktree.d.ts +115 -0
- package/dist/core/worktree.d.ts.map +1 -0
- package/dist/core/worktree.js +462 -0
- package/dist/core/wrappers/bash.d.ts +17 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +175 -24
- package/dist/db/capability-repo.d.ts +43 -2
- package/dist/db/capability-repo.d.ts.map +1 -1
- package/dist/db/capability-repo.js +96 -11
- package/dist/db/history-repo.d.ts +38 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +88 -25
- package/dist/db/metrics-repo.js +2 -2
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +5 -4
- package/dist/db/run-journal.d.ts +33 -5
- package/dist/db/run-journal.d.ts.map +1 -1
- package/dist/db/run-journal.js +78 -14
- package/dist/db/run-resume.d.ts +5 -0
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +9 -2
- package/dist/db/runs-repo.d.ts +19 -2
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +22 -6
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +63 -2
- package/dist/history.d.ts +1 -1
- package/dist/history.d.ts.map +1 -1
- package/dist/i18n.d.ts +5 -0
- package/dist/i18n.d.ts.map +1 -1
- package/dist/i18n.js +11 -4
- package/dist/index.d.ts +136 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +378 -14
- package/dist/notifications.d.ts +22 -0
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +36 -8
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +25 -4
- package/dist/rpc.d.ts +246 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +117 -0
- package/dist/server.d.ts +15 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +77 -18
- package/dist/settings.d.ts +2 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +3 -3
- package/dist/shared/jobs-view.d.ts +1 -1
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +2 -0
- package/dist/task-transfer.d.ts +16 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +16 -0
- package/docs/ARCHITECTURE.md +281 -65
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +18 -4
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +22 -7
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +52 -4
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/README.ru.md +42 -3
- package/docs/README.zh.md +43 -3
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +17 -1
- package/locales/ru.json +17 -1
- package/locales/zh.json +17 -1
- package/opencode.pipeline.yaml +35 -0
- package/package.json +23 -4
- package/scripts/test-home.mjs +83 -0
- package/src/cli.ts +412 -0
- package/src/core/dry-run.ts +2 -2
- package/src/core/execution.ts +538 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +160 -0
- package/src/core/git-trigger.ts +18 -5
- package/src/core/guard-run.ts +119 -0
- package/src/core/guard.ts +431 -0
- package/src/core/lock.ts +178 -37
- package/src/core/matrix.ts +95 -50
- package/src/core/mission.ts +485 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +79 -0
- package/src/core/pipeline-map.ts +264 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +263 -63
- package/src/core/record-history.ts +164 -77
- package/src/core/router/rules.ts +6 -0
- package/src/core/schedule-gate.ts +1 -1
- package/src/core/scheduler/at-fallback.ts +1 -1
- package/src/core/scheduler/linux.ts +40 -11
- package/src/core/scheduler/logs.ts +2 -2
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/registry.ts +2 -2
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +8 -8
- package/src/core/structured-log.ts +22 -5
- package/src/core/telegram.ts +2 -2
- package/src/core/triage-worker.ts +7 -7
- package/src/core/triage.ts +2 -2
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +190 -23
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +129 -22
- package/src/db/metrics-repo.ts +2 -2
- package/src/db/recovery.ts +5 -4
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +36 -6
- package/src/db/schema.ts +65 -2
- package/src/gui.tsx +177 -13
- package/src/history.ts +1 -1
- package/src/i18n.ts +12 -4
- package/src/index.ts +524 -4
- package/src/notifications.ts +38 -8
- package/src/profiles.ts +26 -4
- package/src/rpc.ts +128 -0
- package/src/server.ts +94 -18
- package/src/settings.ts +5 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +31 -0
|
@@ -0,0 +1,600 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* W-1 (0.0.6): одноразовый git worktree на запуск.
|
|
3
|
+
*
|
|
4
|
+
* Задача с `worktree: true` выполняется не в основном дереве репозитория, а в
|
|
5
|
+
* отдельной рабочей копии на собственной ветке. Это даёт безопасный fan-out
|
|
6
|
+
* (матрица, параллельные миссии) без Docker: агент может менять файлы, не
|
|
7
|
+
* задевая основное дерево и другие запуски.
|
|
8
|
+
*
|
|
9
|
+
* Модуль чистый: не бросает исключений, возвращает структурированный результат.
|
|
10
|
+
* W-2 добавляет удаление после прогона и уборку осиротевших worktree.
|
|
11
|
+
*/
|
|
12
|
+
import { execFile } from "node:child_process";
|
|
13
|
+
import crypto from "node:crypto";
|
|
14
|
+
import fs from "node:fs/promises";
|
|
15
|
+
import path from "node:path";
|
|
16
|
+
import { promisify } from "node:util";
|
|
17
|
+
import { PLUGIN_DIR, sanitizeName } from "../types.js";
|
|
18
|
+
|
|
19
|
+
const execFileAsync = promisify(execFile);
|
|
20
|
+
|
|
21
|
+
/** Каталог одноразовых worktree. Лежит рядом с prompts/logs и вне репозитория. */
|
|
22
|
+
export const WORKTREE_ROOT_DIR = path.join(PLUGIN_DIR, "worktrees");
|
|
23
|
+
|
|
24
|
+
/** Таймаут git-операций: зависший git не должен держать обёртку. */
|
|
25
|
+
const GIT_TIMEOUT_MS = 30_000;
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* W-1 (0.0.6): служебные git-вызовы не должны наследовать пользовательские
|
|
29
|
+
* хуки — падающий `post-checkout` блокировал бы `git worktree add`, а
|
|
30
|
+
* интерактивный запрос пароля мог бы повесить вызов. `/dev/null` (Windows:
|
|
31
|
+
* `NUL`) — не каталог, поэтому git не находит ни одного хука.
|
|
32
|
+
*/
|
|
33
|
+
const GIT_SAFE_ARGS = ["-c", `core.hooksPath=${process.platform === "win32" ? "NUL" : "/dev/null"}`];
|
|
34
|
+
const GIT_SAFE_ENV = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
|
|
35
|
+
|
|
36
|
+
/** Описание созданного worktree. */
|
|
37
|
+
export interface RunWorktree {
|
|
38
|
+
/** Абсолютный путь рабочей копии. */
|
|
39
|
+
path: string;
|
|
40
|
+
/** Ветка, созданная под запуск. */
|
|
41
|
+
branch: string;
|
|
42
|
+
/** Корень основного репозитория. */
|
|
43
|
+
repoRoot: string;
|
|
44
|
+
/** Коммит, от которого создан worktree. */
|
|
45
|
+
baseCommit: string;
|
|
46
|
+
/** Время создания (ISO-8601). */
|
|
47
|
+
createdAt: string;
|
|
48
|
+
/** Корень, в котором создан worktree (для безопасной очистки). */
|
|
49
|
+
rootDir: string;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export type CreateWorktreeResult =
|
|
53
|
+
| { ok: true; worktree: RunWorktree }
|
|
54
|
+
| { ok: false; error: string };
|
|
55
|
+
|
|
56
|
+
export interface CreateWorktreeOptions {
|
|
57
|
+
/** Рабочая директория задачи: репозиторий (или его подкаталог). */
|
|
58
|
+
repoDir: string;
|
|
59
|
+
/** Имя задачи — основа для пути и ветки. */
|
|
60
|
+
taskName: string;
|
|
61
|
+
/** Куда создавать worktree. По умолчанию PLUGIN_DIR/worktrees. */
|
|
62
|
+
rootDir?: string;
|
|
63
|
+
/** Базовая ссылка (ветка/коммит). По умолчанию HEAD. */
|
|
64
|
+
baseRef?: string;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
interface GitResult {
|
|
68
|
+
ok: boolean;
|
|
69
|
+
stdout: string;
|
|
70
|
+
stderr: string;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
async function git(cwd: string, args: string[]): Promise<GitResult> {
|
|
74
|
+
try {
|
|
75
|
+
const { stdout, stderr } = await execFileAsync("git", ["-C", cwd, ...GIT_SAFE_ARGS, ...args], {
|
|
76
|
+
encoding: "utf8",
|
|
77
|
+
timeout: GIT_TIMEOUT_MS,
|
|
78
|
+
windowsHide: true,
|
|
79
|
+
maxBuffer: 1024 * 1024,
|
|
80
|
+
env: GIT_SAFE_ENV,
|
|
81
|
+
});
|
|
82
|
+
return { ok: true, stdout: String(stdout).trim(), stderr: String(stderr).trim() };
|
|
83
|
+
} catch (err: unknown) {
|
|
84
|
+
const source = err as { stdout?: unknown; stderr?: unknown; message?: unknown };
|
|
85
|
+
return {
|
|
86
|
+
ok: false,
|
|
87
|
+
stdout: typeof source.stdout === "string" ? source.stdout.trim() : "",
|
|
88
|
+
stderr:
|
|
89
|
+
(typeof source.stderr === "string" ? source.stderr.trim() : "") ||
|
|
90
|
+
(typeof source.message === "string" ? source.message : String(err)),
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Возвращает корень git-репозитория для `dir` или null, если это не репозиторий.
|
|
97
|
+
* Работает и для подкаталога, и для уже связанного worktree.
|
|
98
|
+
*/
|
|
99
|
+
export async function isGitRepository(dir: string): Promise<string | null> {
|
|
100
|
+
if (!dir || !dir.trim()) return null;
|
|
101
|
+
const result = await git(dir, ["rev-parse", "--show-toplevel"]);
|
|
102
|
+
if (!result.ok || !result.stdout) return null;
|
|
103
|
+
return result.stdout;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** Уникальный суффикс: время + случайные байты, чтобы параллельные запуски не совпали. */
|
|
107
|
+
function uniqueSuffix(): string {
|
|
108
|
+
const stamp = new Date()
|
|
109
|
+
.toISOString()
|
|
110
|
+
.replace(/[-:]/g, "")
|
|
111
|
+
.replace(/\..+$/, "");
|
|
112
|
+
return `${stamp}-${crypto.randomBytes(3).toString("hex")}`;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* git worktree add обновляет общие метаданные репозитория (refs, worktrees/).
|
|
117
|
+
* На Windows параллельные вызовы в одном процессе иногда сталкиваются на
|
|
118
|
+
* lock-файлах, поэтому сериализуем только создание каталога/ветки. сами
|
|
119
|
+
* задачи продолжают выполняться параллельно — блокируется лишь операция git.
|
|
120
|
+
*/
|
|
121
|
+
let worktreeCreateTail: Promise<void> = Promise.resolve();
|
|
122
|
+
function serializeWorktreeCreate<T>(work: () => Promise<T>): Promise<T> {
|
|
123
|
+
const result = worktreeCreateTail.then(work, work);
|
|
124
|
+
worktreeCreateTail = result.then(() => undefined, () => undefined);
|
|
125
|
+
return result;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* Ошибки, которые стоит перепробовать: гонки lock-файлов и ANTIVIRUS/FS.
|
|
130
|
+
*
|
|
131
|
+
* W-2: общий `No such file` убран из списка. Он маскировал отсутствующий
|
|
132
|
+
* `baseRef` и повреждённый репозиторий под транзиентную гонку: `addWorktree`
|
|
133
|
+
* делал 3 попытки с задержками 50 + 100 мс, а затем возвращал ту же ошибку.
|
|
134
|
+
* Гонки lock-файлов по-прежнему распознаются по `index.lock`, `cannot lock ref`
|
|
135
|
+
* и `Unable to create` — `No such file` может встречаться внутри их текста,
|
|
136
|
+
* но сам по себе больше не является признаком транзиентности.
|
|
137
|
+
*/
|
|
138
|
+
export function isTransientGitError(message: string): boolean {
|
|
139
|
+
return /index\.lock|cannot lock ref|Unable to create|lock|File exists|already (exists|registered)|resource busy|EPERM|EBUSY/i.test(
|
|
140
|
+
message,
|
|
141
|
+
);
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
function delay(ms: number): Promise<void> {
|
|
145
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
type AddWorktreeResult =
|
|
149
|
+
| { ok: true; branch: string; worktreePath: string }
|
|
150
|
+
| { ok: false; error: string };
|
|
151
|
+
|
|
152
|
+
/** Создаёт каталог и ветку worktree с повторами на transient-ошибки git. */
|
|
153
|
+
async function addWorktree(
|
|
154
|
+
rootDir: string,
|
|
155
|
+
repoRoot: string,
|
|
156
|
+
baseRef: string,
|
|
157
|
+
segment: string,
|
|
158
|
+
): Promise<AddWorktreeResult> {
|
|
159
|
+
return serializeWorktreeCreate(async () => {
|
|
160
|
+
let lastError = "неизвестная ошибка";
|
|
161
|
+
for (let attempt = 0; attempt < 3; attempt++) {
|
|
162
|
+
const suffix = uniqueSuffix();
|
|
163
|
+
const branch = `agent-steward/${segment}-${suffix}`;
|
|
164
|
+
const worktreePath = path.join(rootDir, `${segment}-${suffix}`);
|
|
165
|
+
|
|
166
|
+
try {
|
|
167
|
+
await fs.mkdir(rootDir, { recursive: true });
|
|
168
|
+
} catch (err: unknown) {
|
|
169
|
+
return {
|
|
170
|
+
ok: false,
|
|
171
|
+
error: `Не удалось создать каталог worktree «${rootDir}»: ${
|
|
172
|
+
err instanceof Error ? err.message : String(err)
|
|
173
|
+
}`,
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
// -b создаёт ветку, чтобы каждый запуск был независим.
|
|
178
|
+
const add = await git(repoRoot, ["worktree", "add", "-b", branch, worktreePath, baseRef]);
|
|
179
|
+
if (add.ok) return { ok: true, branch, worktreePath };
|
|
180
|
+
|
|
181
|
+
lastError = add.stderr || "неизвестная ошибка";
|
|
182
|
+
if (attempt < 2 && isTransientGitError(lastError)) {
|
|
183
|
+
await delay(50 * (attempt + 1));
|
|
184
|
+
continue;
|
|
185
|
+
}
|
|
186
|
+
break;
|
|
187
|
+
}
|
|
188
|
+
return { ok: false, error: `git worktree add завершился ошибкой: ${lastError}` };
|
|
189
|
+
});
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* Создаёт одноразовый worktree под запуск задачи.
|
|
194
|
+
*
|
|
195
|
+
* Никогда не бросает: ошибки git и файловой системы возвращаются как
|
|
196
|
+
* `{ok:false, error}` — обёртка должна упасть fail-closed с понятным сообщением.
|
|
197
|
+
*/
|
|
198
|
+
export async function createRunWorktree(
|
|
199
|
+
options: CreateWorktreeOptions,
|
|
200
|
+
): Promise<CreateWorktreeResult> {
|
|
201
|
+
const repoDir = options.repoDir?.trim();
|
|
202
|
+
const taskName = options.taskName?.trim();
|
|
203
|
+
if (!repoDir) {
|
|
204
|
+
return { ok: false, error: "Не задана рабочая директория задачи." };
|
|
205
|
+
}
|
|
206
|
+
if (!taskName) {
|
|
207
|
+
return { ok: false, error: "Не задано имя задачи." };
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
const repoRoot = await isGitRepository(repoDir);
|
|
211
|
+
if (!repoRoot) {
|
|
212
|
+
return {
|
|
213
|
+
ok: false,
|
|
214
|
+
error: `Рабочая директория «${repoDir}» не является git-репозиторием.`,
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
const rootDir = options.rootDir?.trim() || WORKTREE_ROOT_DIR;
|
|
219
|
+
const baseRef = options.baseRef?.trim() || "HEAD";
|
|
220
|
+
const segment = sanitizeName(taskName).slice(0, 48) || "task";
|
|
221
|
+
|
|
222
|
+
// Сериализуем только git-операцию: параллельный fan-out не должен биться
|
|
223
|
+
// об общие lock-файлы .git/refs и .git/worktrees на Windows.
|
|
224
|
+
const added = await addWorktree(rootDir, repoRoot, baseRef, segment);
|
|
225
|
+
if (!added.ok) return { ok: false, error: added.error };
|
|
226
|
+
const { branch, worktreePath } = added;
|
|
227
|
+
|
|
228
|
+
const head = await git(worktreePath, ["rev-parse", "HEAD"]);
|
|
229
|
+
if (!head.ok || !head.stdout) {
|
|
230
|
+
// Worktree уже создан — не оставляем мусор, но не маскируем ошибку.
|
|
231
|
+
await git(repoRoot, ["worktree", "remove", "--force", worktreePath]).catch(() => undefined);
|
|
232
|
+
return {
|
|
233
|
+
ok: false,
|
|
234
|
+
error: `Не удалось определить базовый коммит worktree: ${head.stderr || "неизвестная ошибка"}`,
|
|
235
|
+
};
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
const worktree: RunWorktree = {
|
|
239
|
+
path: worktreePath,
|
|
240
|
+
branch,
|
|
241
|
+
repoRoot,
|
|
242
|
+
baseCommit: head.stdout,
|
|
243
|
+
createdAt: new Date().toISOString(),
|
|
244
|
+
rootDir,
|
|
245
|
+
};
|
|
246
|
+
|
|
247
|
+
// Sidecar для будущей очистки (W-2): путь, ветка, репозиторий и время.
|
|
248
|
+
// Лежит рядом с worktree каталогом, а не внутри рабочей копии.
|
|
249
|
+
try {
|
|
250
|
+
await fs.writeFile(
|
|
251
|
+
`${worktreePath}.json`,
|
|
252
|
+
JSON.stringify({ ...worktree, taskName }, null, 2),
|
|
253
|
+
"utf8",
|
|
254
|
+
);
|
|
255
|
+
} catch {
|
|
256
|
+
// Метаданные не критичны для запуска: worktree уже готов.
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
return { ok: true, worktree };
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
// ---------------------------------------------------------------------------
|
|
263
|
+
// W-2: очистка после прогона и уборка осиротевших worktree.
|
|
264
|
+
|
|
265
|
+
/** Результат удаления одного worktree. */
|
|
266
|
+
export type RemoveWorktreeResult = { ok: true } | { ok: false; error: string };
|
|
267
|
+
|
|
268
|
+
export interface RemoveWorktreeOptions {
|
|
269
|
+
/** Абсолютный путь рабочей копии. */
|
|
270
|
+
path: string;
|
|
271
|
+
/** Корень основного репозитория (иначе берётся из sidecar). */
|
|
272
|
+
repoRoot?: string;
|
|
273
|
+
/** Ветка запуска (иначе берётся из sidecar). */
|
|
274
|
+
branch?: string;
|
|
275
|
+
/** Корень worktree (иначе берётся из sidecar или WORKTREE_ROOT_DIR). */
|
|
276
|
+
rootDir?: string;
|
|
277
|
+
/** Удалять ли ветку запуска. По умолчанию true. */
|
|
278
|
+
deleteBranch?: boolean;
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
interface SidecarData extends Partial<RunWorktree> {
|
|
282
|
+
taskName?: string;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
/** Ветки, созданные плагином, — единственные, которые разрешено удалять. */
|
|
286
|
+
const BRANCH_PREFIX = "agent-steward/";
|
|
287
|
+
|
|
288
|
+
async function pathExists(target: string): Promise<boolean> {
|
|
289
|
+
try {
|
|
290
|
+
await fs.stat(target);
|
|
291
|
+
return true;
|
|
292
|
+
} catch {
|
|
293
|
+
return false;
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
function isInside(parent: string, child: string): boolean {
|
|
298
|
+
const relative = path.relative(path.resolve(parent), path.resolve(child));
|
|
299
|
+
return relative !== "" && !relative.startsWith("..") && !path.isAbsolute(relative);
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/** realpath может отсутствовать для уже удалённого пути — тогда берём resolve. */
|
|
303
|
+
async function realPathOrResolved(target: string): Promise<string> {
|
|
304
|
+
try {
|
|
305
|
+
return await fs.realpath(target);
|
|
306
|
+
} catch {
|
|
307
|
+
return path.resolve(target);
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
/**
|
|
312
|
+
* git возвращает канонический путь: на macOS /var/... превращается в
|
|
313
|
+
* /private/var/..., на Windows может измениться регистр или короткое имя.
|
|
314
|
+
* Сравниваем и нормализованные, и реальные пути.
|
|
315
|
+
*/
|
|
316
|
+
async function samePath(left: string, right: string): Promise<boolean> {
|
|
317
|
+
const a = path.resolve(left);
|
|
318
|
+
const b = path.resolve(right);
|
|
319
|
+
const equal = (x: string, y: string): boolean =>
|
|
320
|
+
process.platform === "win32" ? x.toLowerCase() === y.toLowerCase() : x === y;
|
|
321
|
+
if (equal(a, b)) return true;
|
|
322
|
+
const [realA, realB] = await Promise.all([realPathOrResolved(a), realPathOrResolved(b)]);
|
|
323
|
+
return equal(realA, realB);
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
function isSidecarData(value: unknown): value is SidecarData {
|
|
327
|
+
return Boolean(value) && typeof value === "object" && !Array.isArray(value);
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
async function readSidecar(worktreePath: string): Promise<SidecarData | null> {
|
|
331
|
+
try {
|
|
332
|
+
const raw = await fs.readFile(`${worktreePath}.json`, "utf8");
|
|
333
|
+
const parsed: unknown = JSON.parse(raw);
|
|
334
|
+
return isSidecarData(parsed) ? parsed : null;
|
|
335
|
+
} catch {
|
|
336
|
+
return null;
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
async function removeSidecar(worktreePath: string): Promise<void> {
|
|
341
|
+
try {
|
|
342
|
+
await fs.rm(`${worktreePath}.json`, { force: true });
|
|
343
|
+
} catch {
|
|
344
|
+
// Sidecar не критичен: каталог worktree уже удалён.
|
|
345
|
+
}
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
/**
|
|
349
|
+
* Удаляет созданный плагином worktree и его ветку.
|
|
350
|
+
*
|
|
351
|
+
* Защита W-2.2: удаляется только путь внутри каталога worktree, только
|
|
352
|
+
* зарегистрированный в git (или оставшийся каталог со sidecar) и только
|
|
353
|
+
* ветка с префиксом `agent-steward/`. Повторный вызов идемпотентен.
|
|
354
|
+
*/
|
|
355
|
+
export async function removeRunWorktree(
|
|
356
|
+
options: RemoveWorktreeOptions,
|
|
357
|
+
): Promise<RemoveWorktreeResult> {
|
|
358
|
+
const requested = options.path?.trim();
|
|
359
|
+
if (!requested) {
|
|
360
|
+
return { ok: false, error: "Не задан путь worktree." };
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
const target = path.resolve(requested);
|
|
364
|
+
const sidecar = await readSidecar(target);
|
|
365
|
+
const rootDir = options.rootDir?.trim() || sidecar?.rootDir || WORKTREE_ROOT_DIR;
|
|
366
|
+
if (!isInside(rootDir, target)) {
|
|
367
|
+
return {
|
|
368
|
+
ok: false,
|
|
369
|
+
error: `Путь «${target}» находится вне каталога worktree «${rootDir}» — удаление отменено.`,
|
|
370
|
+
};
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
// Идемпотентность: каталога уже нет — удалять нечего (sidecar мог остаться).
|
|
374
|
+
// Registration в git мог остаться после прошлого падения — снимаем его тоже.
|
|
375
|
+
if (!(await pathExists(target))) {
|
|
376
|
+
const knownRepo = options.repoRoot?.trim() || sidecar?.repoRoot;
|
|
377
|
+
if (knownRepo) await git(knownRepo, ["worktree", "prune", "--expire=now"]);
|
|
378
|
+
await removeSidecar(target);
|
|
379
|
+
return { ok: true };
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
const repoRoot = options.repoRoot?.trim() || sidecar?.repoRoot;
|
|
383
|
+
if (!repoRoot) {
|
|
384
|
+
return { ok: false, error: "Не известен репозиторий worktree — удаление отменено." };
|
|
385
|
+
}
|
|
386
|
+
const branch = options.branch?.trim() || sidecar?.branch;
|
|
387
|
+
if (branch && !branch.startsWith(BRANCH_PREFIX)) {
|
|
388
|
+
return {
|
|
389
|
+
ok: false,
|
|
390
|
+
error: `Ветка «${branch}» создана не плагином — удаление отменено.`,
|
|
391
|
+
};
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
const list = await git(repoRoot, ["worktree", "list", "--porcelain"]);
|
|
395
|
+
let registered = false;
|
|
396
|
+
if (list.ok) {
|
|
397
|
+
for (const line of list.stdout.split(/\r?\n/)) {
|
|
398
|
+
if (!line.startsWith("worktree ")) continue;
|
|
399
|
+
if (await samePath(line.slice("worktree ".length).trim(), target)) {
|
|
400
|
+
registered = true;
|
|
401
|
+
break;
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
}
|
|
405
|
+
|
|
406
|
+
if (!registered && !sidecar) {
|
|
407
|
+
return {
|
|
408
|
+
ok: false,
|
|
409
|
+
error: "Worktree не зарегистрирован в git и не имеет sidecar — удаление отменено.",
|
|
410
|
+
};
|
|
411
|
+
}
|
|
412
|
+
|
|
413
|
+
if (registered) {
|
|
414
|
+
const removed = await git(repoRoot, ["worktree", "remove", "--force", target]);
|
|
415
|
+
if (!removed.ok) {
|
|
416
|
+
// Осиротевший каталог (например, git потерял запись) убираем вручную и
|
|
417
|
+
// чистим служебные ссылки. Это безопасно: путь проверен выше.
|
|
418
|
+
try {
|
|
419
|
+
await fs.rm(target, { recursive: true, force: true });
|
|
420
|
+
} catch (err: unknown) {
|
|
421
|
+
return {
|
|
422
|
+
ok: false,
|
|
423
|
+
error: `Не удалось удалить worktree «${target}»: ${
|
|
424
|
+
err instanceof Error ? err.message : String(err)
|
|
425
|
+
}`,
|
|
426
|
+
};
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
} else {
|
|
430
|
+
try {
|
|
431
|
+
await fs.rm(target, { recursive: true, force: true });
|
|
432
|
+
} catch (err: unknown) {
|
|
433
|
+
return {
|
|
434
|
+
ok: false,
|
|
435
|
+
error: `Не удалось удалить каталог worktree «${target}»: ${
|
|
436
|
+
err instanceof Error ? err.message : String(err)
|
|
437
|
+
}`,
|
|
438
|
+
};
|
|
439
|
+
}
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
// Канонический путь git может не совпадать с запрошенным (macOS /var ->
|
|
443
|
+
// /private/var, Windows-регистр). Тогда ветка \"remove\" не срабатывала и
|
|
444
|
+
// registration оставался в .git/worktrees — из-за этого `git branch -D`
|
|
445
|
+
// падала даже после успешного удаления каталога. prune --expire=now снимает
|
|
446
|
+
// registration в любом случае; для живых worktree он безвреден.
|
|
447
|
+
await git(repoRoot, ["worktree", "prune", "--expire=now"]);
|
|
448
|
+
|
|
449
|
+
// Ветка одноразовая: после удаления рабочей копии она больше не нужна.
|
|
450
|
+
if (options.deleteBranch !== false && branch && branch.startsWith(BRANCH_PREFIX)) {
|
|
451
|
+
await git(repoRoot, ["branch", "-D", branch]);
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
await removeSidecar(target);
|
|
455
|
+
return { ok: true };
|
|
456
|
+
}
|
|
457
|
+
|
|
458
|
+
/** Сколько живёт lock уборки, прежде чем считать его осиротевшим. */
|
|
459
|
+
export const CLEANUP_LOCK_STALE_MS = 10 * 60 * 1000;
|
|
460
|
+
|
|
461
|
+
/** По умолчанию осиротевшим считается worktree старше суток. */
|
|
462
|
+
export const DEFAULT_STALE_AFTER_MS = 24 * 60 * 60 * 1000;
|
|
463
|
+
|
|
464
|
+
export interface StaleCleanupOptions {
|
|
465
|
+
rootDir?: string;
|
|
466
|
+
/** Возраст, после которого worktree считается остатком. */
|
|
467
|
+
maxAgeMs?: number;
|
|
468
|
+
/** Текущее время (для тестов). */
|
|
469
|
+
now?: number;
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
export interface StaleCleanupResult {
|
|
473
|
+
/** Удалённые рабочие копии. */
|
|
474
|
+
removed: string[];
|
|
475
|
+
/** Свежие worktree, которые трогать нельзя. */
|
|
476
|
+
skipped: string[];
|
|
477
|
+
/** Sidecar без рабочей копии — убраны. */
|
|
478
|
+
pruned: string[];
|
|
479
|
+
errors: string[];
|
|
480
|
+
/** Уборку уже выполняет другой процесс. */
|
|
481
|
+
locked: boolean;
|
|
482
|
+
}
|
|
483
|
+
|
|
484
|
+
async function acquireCleanupLock(rootDir: string): Promise<boolean> {
|
|
485
|
+
const lockDir = path.join(rootDir, ".cleanup-lock");
|
|
486
|
+
try {
|
|
487
|
+
await fs.mkdir(rootDir, { recursive: true });
|
|
488
|
+
await fs.mkdir(lockDir);
|
|
489
|
+
return true;
|
|
490
|
+
} catch (err: unknown) {
|
|
491
|
+
if ((err as NodeJS.ErrnoException).code !== "EEXIST") return false;
|
|
492
|
+
try {
|
|
493
|
+
const stat = await fs.stat(lockDir);
|
|
494
|
+
if (Date.now() - stat.mtimeMs > CLEANUP_LOCK_STALE_MS) {
|
|
495
|
+
await fs.rm(lockDir, { recursive: true, force: true });
|
|
496
|
+
await fs.mkdir(lockDir);
|
|
497
|
+
return true;
|
|
498
|
+
}
|
|
499
|
+
} catch {
|
|
500
|
+
// Гонка с другим уборщиком: уступаем ему.
|
|
501
|
+
}
|
|
502
|
+
return false;
|
|
503
|
+
}
|
|
504
|
+
}
|
|
505
|
+
|
|
506
|
+
async function releaseCleanupLock(rootDir: string): Promise<void> {
|
|
507
|
+
try {
|
|
508
|
+
await fs.rm(path.join(rootDir, ".cleanup-lock"), { recursive: true, force: true });
|
|
509
|
+
} catch {
|
|
510
|
+
// Lock истечёт сам; ошибка не должна ломать запуск.
|
|
511
|
+
}
|
|
512
|
+
}
|
|
513
|
+
|
|
514
|
+
/**
|
|
515
|
+
* Убирает осиротевшие worktree старше `maxAgeMs` и sidecar без рабочей копии.
|
|
516
|
+
*
|
|
517
|
+
* Гонки W-2.2: уборка сериализуется каталогом `.cleanup-lock`; свежие worktree
|
|
518
|
+
* (моложе порога) не трогаются, поэтому активный запуск не будет удалён.
|
|
519
|
+
* Каталоги без sidecar не удаляются — это чужие данные.
|
|
520
|
+
*/
|
|
521
|
+
export async function cleanupStaleWorktrees(
|
|
522
|
+
options: StaleCleanupOptions = {},
|
|
523
|
+
): Promise<StaleCleanupResult> {
|
|
524
|
+
const rootDir = options.rootDir?.trim() || WORKTREE_ROOT_DIR;
|
|
525
|
+
const maxAgeMs = options.maxAgeMs ?? DEFAULT_STALE_AFTER_MS;
|
|
526
|
+
const now = options.now ?? Date.now();
|
|
527
|
+
const result: StaleCleanupResult = { removed: [], skipped: [], pruned: [], errors: [], locked: false };
|
|
528
|
+
|
|
529
|
+
if (!(await pathExists(rootDir))) return result;
|
|
530
|
+
if (!(await acquireCleanupLock(rootDir))) {
|
|
531
|
+
return { ...result, locked: true };
|
|
532
|
+
}
|
|
533
|
+
|
|
534
|
+
try {
|
|
535
|
+
const entries = await fs.readdir(rootDir, { withFileTypes: true });
|
|
536
|
+
for (const entry of entries) {
|
|
537
|
+
if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
|
|
538
|
+
const sidecarPath = path.join(rootDir, entry.name);
|
|
539
|
+
let sidecar: SidecarData;
|
|
540
|
+
try {
|
|
541
|
+
const parsed: unknown = JSON.parse(await fs.readFile(sidecarPath, "utf8"));
|
|
542
|
+
if (!isSidecarData(parsed)) {
|
|
543
|
+
throw new Error("sidecar не является объектом");
|
|
544
|
+
}
|
|
545
|
+
sidecar = parsed;
|
|
546
|
+
} catch (err: unknown) {
|
|
547
|
+
result.errors.push(
|
|
548
|
+
`Повреждённый sidecar «${entry.name}»: ${err instanceof Error ? err.message : String(err)}`,
|
|
549
|
+
);
|
|
550
|
+
continue;
|
|
551
|
+
}
|
|
552
|
+
|
|
553
|
+
const target = sidecar.path?.trim();
|
|
554
|
+
if (!target) {
|
|
555
|
+
result.errors.push(`Sidecar «${entry.name}» без пути worktree.`);
|
|
556
|
+
continue;
|
|
557
|
+
}
|
|
558
|
+
|
|
559
|
+
if (!(await pathExists(target))) {
|
|
560
|
+
await removeSidecar(target);
|
|
561
|
+
result.pruned.push(target);
|
|
562
|
+
continue;
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
let ageMs = typeof sidecar.createdAt === "string" ? now - Date.parse(sidecar.createdAt) : NaN;
|
|
566
|
+
if (!Number.isFinite(ageMs)) {
|
|
567
|
+
try {
|
|
568
|
+
const stat = await fs.stat(target);
|
|
569
|
+
ageMs = now - stat.mtimeMs;
|
|
570
|
+
} catch {
|
|
571
|
+
ageMs = 0;
|
|
572
|
+
}
|
|
573
|
+
}
|
|
574
|
+
if (ageMs < maxAgeMs) {
|
|
575
|
+
result.skipped.push(target);
|
|
576
|
+
continue;
|
|
577
|
+
}
|
|
578
|
+
|
|
579
|
+
const removed = await removeRunWorktree({
|
|
580
|
+
path: target,
|
|
581
|
+
repoRoot: sidecar.repoRoot,
|
|
582
|
+
branch: sidecar.branch,
|
|
583
|
+
rootDir,
|
|
584
|
+
deleteBranch: true,
|
|
585
|
+
});
|
|
586
|
+
if (removed.ok) result.removed.push(target);
|
|
587
|
+
else result.errors.push(removed.error);
|
|
588
|
+
}
|
|
589
|
+
} catch (err: unknown) {
|
|
590
|
+
result.errors.push(
|
|
591
|
+
`Не удалось прочитать каталог worktree «${rootDir}»: ${
|
|
592
|
+
err instanceof Error ? err.message : String(err)
|
|
593
|
+
}`,
|
|
594
|
+
);
|
|
595
|
+
} finally {
|
|
596
|
+
await releaseCleanupLock(rootDir);
|
|
597
|
+
}
|
|
598
|
+
|
|
599
|
+
return result;
|
|
600
|
+
}
|