@infodb/p3 0.9.0 → 0.11.0

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.
Files changed (65) hide show
  1. package/README.md +5 -2
  2. package/dist/web/assets/{Outputs-CQi0oba1.js → Outputs-ddwte0jj.js} +1 -1
  3. package/dist/web/assets/{RequestStatus-grC0F_SQ.js → RequestStatus-Bg1OLbRc.js} +1 -1
  4. package/dist/web/assets/{Tabs-BJRGzidj.js → Tabs-DTmggzgg.js} +1 -1
  5. package/dist/web/assets/{TagInput-cIIwXAHA.js → TagInput-BHAgjLP7.js} +1 -1
  6. package/dist/web/assets/{TaskDrawer-CSZ7Z0JC.js → TaskDrawer-Dz_5c2NH.js} +1 -1
  7. package/dist/web/assets/{_requestId-Z3CBhTIL.js → _requestId-D9-gtIcG.js} +1 -1
  8. package/dist/web/assets/_requestId-DzCNYvqf.js +30 -0
  9. package/dist/web/assets/{appCtx-DCiGJFAe.js → appCtx-Cm24VpAf.js} +1 -1
  10. package/dist/web/assets/{board-DyfGX5h0.js → board-MCHcZ-PU.js} +1 -1
  11. package/dist/web/assets/{directTask-Dk3H5Q2B.js → directTask-C1NWDkZp.js} +1 -1
  12. package/dist/web/assets/{done-Bhxqy7bH.js → done-zq10Bt08.js} +1 -1
  13. package/dist/web/assets/{index-Bt13tvIX.js → index-Ce0ndpne.js} +3 -3
  14. package/dist/web/assets/index-D68mkSnw.css +2 -0
  15. package/dist/web/assets/{new-BRsIUNIb.js → new-9TKiNT4O.js} +1 -1
  16. package/dist/web/assets/{preload-helper-B40dBmwL.js → preload-helper-FBLw7u7x.js} +1 -1
  17. package/dist/web/assets/release-notes-hK5XezLW.js +5 -0
  18. package/dist/web/assets/{requestData-w6fhCYmh.js → requestData-BnN7mctX.js} +1 -1
  19. package/dist/web/assets/{routes-QNgQHe48.js → routes-usHwrrA0.js} +1 -1
  20. package/dist/web/assets/{settings-CoKJahEe.js → settings-BVZDnL6O.js} +1 -1
  21. package/dist/web/index.html +4 -4
  22. package/docs/architecture.md +151 -8
  23. package/docs/development.md +19 -9
  24. package/docs/how-to-use.md +128 -7
  25. package/docs/installation.md +26 -10
  26. package/docs/publishing.md +5 -1
  27. package/lib/cli/args.js +2 -0
  28. package/lib/cli/help.js +14 -2
  29. package/lib/cli/main.js +28 -5
  30. package/lib/cli/preflightCommands.js +30 -7
  31. package/lib/cli/project.js +31 -9
  32. package/lib/cli/requestCommands.js +207 -14
  33. package/lib/core/context.js +4 -1
  34. package/lib/core/milestoneReview/code.js +129 -0
  35. package/lib/core/milestoneReview/material.js +138 -0
  36. package/lib/core/milestoneReview/mockReviewer.js +27 -0
  37. package/lib/core/milestoneReview/review.js +261 -0
  38. package/lib/core/milestoneReview/service.js +278 -0
  39. package/lib/core/milestoneReview/store.js +226 -0
  40. package/lib/core/preflight/codexEngine.js +75 -17
  41. package/lib/core/preflight/codexImage.js +49 -19
  42. package/lib/core/preflight/docker.js +149 -0
  43. package/lib/core/preflight/owner.js +118 -0
  44. package/lib/core/preflight/render-image/Dockerfile +1 -1
  45. package/lib/core/preflight/service.js +235 -16
  46. package/lib/core/projectRegistry.js +5 -4
  47. package/lib/core/requestOps.js +4 -0
  48. package/lib/core/store/dataWatcher.js +122 -0
  49. package/lib/core/store/normalize.js +36 -2
  50. package/lib/core/store/preflightStore.js +20 -2
  51. package/lib/core/store/projectFile.js +14 -2
  52. package/lib/core/store/workspace.js +102 -41
  53. package/lib/server/api/manifest.js +29 -2
  54. package/lib/server/api/milestoneReviewRoutes.js +69 -0
  55. package/lib/server/api/routes.js +37 -8
  56. package/lib/server/server.js +5 -3
  57. package/lib/shared/directTask.js +2 -2
  58. package/lib/shared/milestoneGoals.js +57 -0
  59. package/lib/shared/milestoneReview.js +26 -0
  60. package/lib/shared/preflightRunner.js +18 -0
  61. package/package.json +2 -2
  62. package/skills/p3/SKILL.md +29 -17
  63. package/dist/web/assets/_requestId-C8WYk2kC.js +0 -30
  64. package/dist/web/assets/index-BF1xMdJo.css +0 -2
  65. package/dist/web/assets/release-notes-C3FdiM36.js +0 -3
@@ -0,0 +1,226 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { mkdir, readdir, readFile } from "node:fs/promises";
3
+ import { join, resolve, sep } from "node:path";
4
+ import { REVIEW_STATUSES, REVIEW_VERDICTS, } from "../../shared/milestoneReview.js";
5
+ import { withFileLock, writeFileAtomic } from "../store/fsutil.js";
6
+ /**
7
+ * マイルストーンレビューの履歴。
8
+ *
9
+ * <data>/milestone-reviews/<マイルストーンID>/<run>/input.json 固定した比較材料(作ったら変えない)
10
+ * <data>/milestone-reviews/<マイルストーンID>/<run>/run.json 実行の記録(状態・実行者・エンジン・所有者・失敗の理由・取消の要求)
11
+ * <data>/milestone-reviews/<マイルストーンID>/<run>/review.json 結果(completed のときだけ。書き終えてから completed にする)
12
+ * <data>/milestone-reviews/.locks/<マイルストーンID>.lock 状態を変えるときのロック(プロセス間)
13
+ *
14
+ * - 状態は running → completed / failed / cancelled の一方向。終わった run は変えない(遅れて届いた結果も取り込まない)
15
+ * - パスの ID(マイルストーン・run)は形を確かめ、保存先の外を指すもの・「.」「..」は断る。同じ run は作り直さない
16
+ * - ファイルは tmp に書いてから rename する。壊れた記録は「無い」と分けて返す(一覧からも隠さない)
17
+ * - 今の要望・目的と比べても、過去の input / review は変えない
18
+ */
19
+ export const MILESTONE_REVIEWS_DIR = "milestone-reviews";
20
+ const MILESTONE_ID = /^[A-Za-z0-9._-]+$/;
21
+ const RUN_ID = /^MR-\d{8}-\d{6}-[0-9a-f]{4}$/;
22
+ /** 履歴の操作の失敗。not_found: 無い / broken: 読めない / bad_id: ID が使えない / exists: 既にある / finished: 終わった run */
23
+ export class ReviewStoreError extends Error {
24
+ code;
25
+ constructor(code, message) {
26
+ super(message);
27
+ this.code = code;
28
+ }
29
+ }
30
+ export function checkReviewMilestoneId(id) {
31
+ if (!MILESTONE_ID.test(id) || id === "." || id === "..")
32
+ throw new ReviewStoreError("bad_id", `マイルストーンの ID に使えません: ${JSON.stringify(id)}(英数字と . _ -)`);
33
+ }
34
+ export function checkRunId(id) {
35
+ if (!RUN_ID.test(id))
36
+ throw new ReviewStoreError("bad_id", `レビューの run の ID ではありません: ${JSON.stringify(id)}(MR-YYYYMMDD-HHMMSS-xxxx)`);
37
+ }
38
+ export function newReviewRunId(now = new Date()) {
39
+ const s = now.toISOString().replace(/[-:]/g, "").replace("T", "-").slice(0, 15);
40
+ return `MR-${s}-${randomBytes(2).toString("hex")}`;
41
+ }
42
+ const isTerminal = (r) => r.status !== "running";
43
+ export class MilestoneReviewStore {
44
+ dataDir;
45
+ constructor(dataDir) {
46
+ this.dataDir = dataDir;
47
+ }
48
+ get dir() {
49
+ return join(this.dataDir, MILESTONE_REVIEWS_DIR);
50
+ }
51
+ within(...parts) {
52
+ const p = resolve(this.dir, ...parts);
53
+ if (!p.startsWith(resolve(this.dir) + sep))
54
+ throw new ReviewStoreError("bad_id", `保存先の外を指します: ${parts.join("/")}`);
55
+ return p;
56
+ }
57
+ milestoneDir(mid) {
58
+ checkReviewMilestoneId(mid);
59
+ return this.within(mid);
60
+ }
61
+ runDir(mid, run) {
62
+ checkReviewMilestoneId(mid);
63
+ checkRunId(run);
64
+ return this.within(mid, run);
65
+ }
66
+ /** マイルストーンの状態を変えるときのロック(ほかのプロセスの開始・終わり・取消と1つずつにする) */
67
+ withLock(mid, fn) {
68
+ checkReviewMilestoneId(mid);
69
+ return withFileLock(join(this.dir, ".locks", `${mid}.lock`), fn, {
70
+ busyMessage: `マイルストーン ${mid} のレビューの記録を変えられませんでした(別のプロセスが使っています。少し待ってやり直してください)`,
71
+ });
72
+ }
73
+ /** 履歴のあるマイルストーン(run のフォルダが1つでもあるもの。project.yaml に無い孤立も含む) */
74
+ async milestones() {
75
+ const out = [];
76
+ for (const d of await dirs(this.dir)) {
77
+ if (d.startsWith(".") || !MILESTONE_ID.test(d) || d === "..")
78
+ continue;
79
+ if ((await dirs(join(this.dir, d))).some((r) => RUN_ID.test(r)))
80
+ out.push(d);
81
+ }
82
+ return out.sort();
83
+ }
84
+ async hasHistory(mid) {
85
+ return (await this.runIds(mid)).length > 0;
86
+ }
87
+ /** run の ID(新しい順) */
88
+ async runIds(mid) {
89
+ return (await dirs(this.milestoneDir(mid))).filter((r) => RUN_ID.test(r)).sort().reverse();
90
+ }
91
+ /**
92
+ * 新しい run を作る(input.json と running の run.json)。同じ ID が既にあれば exists で断る(上書きしない)。
93
+ * 呼ぶ側がロックの中で呼ぶ(同時に実行中の run を作らないため)
94
+ */
95
+ async create(input, run) {
96
+ const dir = this.runDir(run.milestone, run.id);
97
+ await mkdir(this.milestoneDir(run.milestone), { recursive: true });
98
+ try {
99
+ await mkdir(dir);
100
+ }
101
+ catch (e) {
102
+ if (e.code === "EEXIST")
103
+ throw new ReviewStoreError("exists", `既にある run です: ${run.milestone}/${run.id}`);
104
+ throw e;
105
+ }
106
+ await writeJson(join(dir, "input.json"), input);
107
+ await writeJson(join(dir, "run.json"), run);
108
+ }
109
+ async readRun(mid, run) {
110
+ return readJson(join(this.runDir(mid, run), "run.json"), `${mid}/${run}`, checkRunShape);
111
+ }
112
+ async readInput(mid, run) {
113
+ return readJson(join(this.runDir(mid, run), "input.json"), `${mid}/${run} の input.json`, (x) => {
114
+ const i = x;
115
+ if (!i.milestone || !Array.isArray(i.units) || !Array.isArray(i.requests) || typeof i.hash !== "string")
116
+ throw new Error("形が違います");
117
+ });
118
+ }
119
+ async readResult(mid, run) {
120
+ return readJson(join(this.runDir(mid, run), "review.json"), `${mid}/${run} の review.json`, (x) => {
121
+ const r = x;
122
+ if (typeof r.overall !== "string" || !Array.isArray(r.units))
123
+ throw new Error("形が違います");
124
+ });
125
+ }
126
+ /** 1回分(無ければ not_found、どれかが読めなければ broken) */
127
+ async get(mid, run) {
128
+ const r = await this.readRun(mid, run);
129
+ const input = await this.readInput(mid, run);
130
+ const result = r.status === "completed" ? await this.readResult(mid, run) : undefined;
131
+ return { run: r, input, ...(result ? { result } : {}) };
132
+ }
133
+ /** 一覧(新しい順)。読めない記録も broken として出す */
134
+ async list(mid) {
135
+ const out = [];
136
+ for (const id of await this.runIds(mid)) {
137
+ try {
138
+ const rec = await this.get(mid, id);
139
+ const verdicts = {};
140
+ for (const u of rec.result?.units ?? [])
141
+ verdicts[u.verdict] = (verdicts[u.verdict] ?? 0) + 1;
142
+ out.push({
143
+ state: "ok",
144
+ run: rec.run,
145
+ units: rec.input.units,
146
+ ...(rec.input.milestone.purpose ? { purpose: rec.input.milestone.purpose } : {}),
147
+ inputHash: rec.input.hash,
148
+ ...(rec.result ? { verdicts } : {}),
149
+ });
150
+ }
151
+ catch (e) {
152
+ out.push({ state: "broken", id, error: e.message });
153
+ }
154
+ }
155
+ // 同じ秒の run は ID では並ばないので、始めた時刻(ミリ秒)の新しい順にする(読めない記録は ID の時刻で)
156
+ const at = (x) => (x.state === "ok" ? x.run.startedAt.replace(/[-:]/g, "").replace("T", "-") : x.id.slice(3, 18));
157
+ return out.sort((a, b) => (at(a) < at(b) ? 1 : at(a) > at(b) ? -1 : 0));
158
+ }
159
+ /** run.json を書き換える(呼ぶ側がロックの中で呼ぶ)。終わった run は finished で断る */
160
+ async updateRunning(mid, run, fn) {
161
+ const cur = await this.readRun(mid, run);
162
+ if (isTerminal(cur))
163
+ throw new ReviewStoreError("finished", `${mid}/${run} は既に終わっています(${cur.status})`);
164
+ const next = fn(cur);
165
+ await writeJson(join(this.runDir(mid, run), "run.json"), next);
166
+ return next;
167
+ }
168
+ /**
169
+ * 終わりにする(呼ぶ側がロックの中で呼ぶ)。completed は結果を書き終えてから run.json を completed にする。
170
+ * 既に終わっていれば finished で断り、何も書かない
171
+ */
172
+ async finish(mid, run, patch, result) {
173
+ const cur = await this.readRun(mid, run);
174
+ if (isTerminal(cur))
175
+ throw new ReviewStoreError("finished", `${mid}/${run} は既に終わっています(${cur.status})`);
176
+ if (patch.status === "completed") {
177
+ if (!result)
178
+ throw new Error("completed には結果が要ります");
179
+ await writeJson(join(this.runDir(mid, run), "review.json"), result);
180
+ }
181
+ const next = { ...cur, ...patch, finishedAt: patch.finishedAt ?? new Date().toISOString() };
182
+ await writeJson(join(this.runDir(mid, run), "run.json"), next);
183
+ return next;
184
+ }
185
+ }
186
+ function checkRunShape(x) {
187
+ const r = x;
188
+ if (typeof r.id !== "string" || typeof r.milestone !== "string" || !REVIEW_STATUSES.includes(r.status) || typeof r.startedAt !== "string")
189
+ throw new Error("形が違います");
190
+ if (!Array.isArray(r.log))
191
+ throw new Error("log がありません");
192
+ }
193
+ /** 判定の区分か */
194
+ export const isVerdict = (v) => REVIEW_VERDICTS.includes(v);
195
+ async function dirs(path) {
196
+ try {
197
+ return (await readdir(path, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name);
198
+ }
199
+ catch (e) {
200
+ if (e.code === "ENOENT")
201
+ return [];
202
+ throw e;
203
+ }
204
+ }
205
+ async function writeJson(path, v) {
206
+ await writeFileAtomic(path, `${JSON.stringify(v, null, 2)}\n`);
207
+ }
208
+ async function readJson(path, label, check) {
209
+ let text;
210
+ try {
211
+ text = await readFile(path, "utf8");
212
+ }
213
+ catch (e) {
214
+ if (e.code === "ENOENT")
215
+ throw new ReviewStoreError("not_found", `レビューの記録がありません: ${label}`);
216
+ throw e;
217
+ }
218
+ try {
219
+ const v = JSON.parse(text);
220
+ check(v);
221
+ return v;
222
+ }
223
+ catch (e) {
224
+ throw new ReviewStoreError("broken", `レビューの記録を読めません: ${label}(${e.message})`);
225
+ }
226
+ }
@@ -58,6 +58,7 @@ import { ACCESS_TOKEN_ENV, CONTAINER_WORKSPACE, DEFAULT_IMAGE, UsageLimitError,
58
58
  import { APP_NAME, chatgptAccount, ChatGptAuthError, CODEX_TOKEN_MIN_VALID_MS } from "../chatgpt.js";
59
59
  import { redact } from "../redact.js";
60
60
  import { ensureCodexImage } from "./codexImage.js";
61
+ import { CONTAINER_LABEL, containerName, DOCKER_LIMITS, DockerAbortError, removeContainer, removeLog, withContainerName } from "./docker.js";
61
62
  import { renderManuscripts } from "./uiRender.js";
62
63
  import { describeMapping, diagnoseLaunch, mapPath } from "./diagnose.js";
63
64
  import { prepareLaunch } from "./launch.js";
@@ -250,21 +251,35 @@ export class CodexWorkspaceEngine {
250
251
  return this.authorized("Preflight", log, (a) => this.runWith(a.cfg, job, a.auth, a.env, a.log, signal));
251
252
  }
252
253
  /**
253
- * Preflight 以外の1回の頼みごと(リリースノートの要約など)。設定・認証・イメージ・起動の診断は Preflight と同じものを使い、
254
- * 参照先もデータのフォルダもマウントしない(/workspace は空の tmpfs で、終われば消える)。渡すのは依頼文だけで、
255
- * 結果は最後の応答の文。評価やタスク化はしない。結果を確かめて取り込むのは呼ぶ側
254
+ * Preflight 以外の1回の頼みごと(リリースノートの要約・マイルストーンのレビュー)。設定・認証・イメージ・起動の診断は Preflight と
255
+ * 同じものを使い、データのフォルダはマウントしない(/workspace は tmpfs で、終われば消える)。refs を渡したときだけ、その参照先を
256
+ * Preflight と同じく /workspace/<名前> に読むだけでマウントする(コードと git の履歴を読ませる)。結果は最後の応答の文。
257
+ * 評価やタスク化はしない。結果を確かめて取り込むのは呼ぶ側
256
258
  */
257
259
  async ask(input, log, signal) {
258
260
  return this.authorized(input.label, log, async ({ cfg, auth, env, log }) => {
259
- await this.prepareImage(cfg, log);
260
- const command = cfg.command?.({ repos: [], data: null, auth: auth.mode }) ??
261
- withMounts(dockerCommand(PLACEHOLDER, auth.mode === "chatgpt" ? { accessTokenEnv: ACCESS_TOKEN_ENV } : { authVolume: cfg.authVolume, authFile: cfg.authFile }), [], null);
262
- return this.launched(cfg, command, [], log, signal, (launch, onError) => this.session(cfg, launch, env, log, onError, async (session) => {
261
+ const readable = (input.refs ?? []).filter((r) => r.status === "ok" && r.local);
262
+ const mappings = readable.map((r) => ({
263
+ label: `参照先 ${r.name}`,
264
+ local: r.local,
265
+ ...mapPath(cfg.pathMap, r.local),
266
+ container: `${CONTAINER_WORKSPACE}/${r.mount}`,
267
+ }));
268
+ const repos = readable.map((r, i) => ({ name: r.name, host: mappings[i].host, container: mappings[i].container }));
269
+ if (mappings.length) {
270
+ log({ kind: "info", text: "パスの対応(個人設定の codex.pathMap。読むだけでマウントします):" });
271
+ for (const m of mappings)
272
+ log({ kind: "info", text: ` ${describeMapping(m, cfg.pathMap.length)}` });
273
+ }
274
+ await this.prepareImage(cfg, log, signal);
275
+ const command = cfg.command?.({ repos, data: null, auth: auth.mode }) ??
276
+ withMounts(dockerCommand(PLACEHOLDER, auth.mode === "chatgpt" ? { accessTokenEnv: ACCESS_TOKEN_ENV } : { authVolume: cfg.authVolume, authFile: cfg.authFile }), repos, null);
277
+ return this.launched("ask", cfg, command, mappings, log, signal, (launch, onError) => this.session(cfg, launch, env, log, onError, async (session) => {
263
278
  await checkUsage(session, auth, log);
264
279
  await session.startThread(input.instructions);
265
280
  log({ kind: "info", text: `スレッドを立てました (model: ${session.model})` });
266
281
  try {
267
- const result = await session.runTurn(input.prompt, { signal });
282
+ const result = await turnWithGrace(session, input.prompt, signal, log);
268
283
  if (result.status === "interrupted" || signal.aborted)
269
284
  throw new Error("中止しました");
270
285
  if (result.status !== "completed")
@@ -317,15 +332,17 @@ export class CodexWorkspaceEngine {
317
332
  throw e;
318
333
  }
319
334
  }
320
- /** イメージが古ければ作り直す(個人設定で止められる) */
321
- async prepareImage(cfg, log) {
335
+ /** イメージが古ければ作り直す(個人設定で止められる)。各段に上限があり、中止で戻る(docker.ts) */
336
+ async prepareImage(cfg, log, signal) {
322
337
  if (!cfg.ensureImage)
323
338
  return;
324
339
  log({ kind: "info", text: "コンテナのイメージを確かめています" });
325
340
  try {
326
- log({ kind: "info", text: `Codex ${await ensureCodexImage()}` });
341
+ log({ kind: "info", text: `Codex ${await ensureCodexImage({ signal, onCleanup: (text) => log({ kind: "info", text }) })}` });
327
342
  }
328
343
  catch (e) {
344
+ if (e instanceof DockerAbortError && e.reason === "aborted")
345
+ throw new Error("中止しました", { cause: e });
329
346
  // docker run の前(イメージの用意)で失敗した
330
347
  throw new Error(`Codex のイメージを用意できません(app-server を起こす前): ${e.message}`, { cause: e });
331
348
  }
@@ -334,8 +351,11 @@ export class CodexWorkspaceEngine {
334
351
  * 中継ごしに起こして(launcher.mjs)、すぐ終わったときの Docker の出力と終わり方を残す。
335
352
  * work には、中継ごしのコマンドと、app-server が終わったことによる失敗に診断を付ける onError を渡す
336
353
  */
337
- async launched(cfg, command, mappings, log, signal, work) {
338
- const launch = await prepareLaunch(command);
354
+ async launched(kind, cfg, command, mappings, log, signal, work) {
355
+ // docker run なら名前とラベルを付けて起こし、終わったら(正常・失敗・中止・時間切れのどれでも)そのコンテナだけを消す
356
+ const docker = command[1] === "run" ? command[0] : undefined;
357
+ const name = docker ? containerName(kind) : undefined;
358
+ const launch = await prepareLaunch(docker && name ? withContainerName(command, name, { [CONTAINER_LABEL]: kind }) : command);
339
359
  const diag = { image: DEFAULT_IMAGE, mappings, rules: cfg.pathMap.length };
340
360
  /** app-server が終わったことによる失敗なら、診断つきのエラーにする(それ以外は undefined) */
341
361
  const diagnosed = async (e, phase) => {
@@ -353,11 +373,21 @@ export class CodexWorkspaceEngine {
353
373
  log({ kind: "error", text: `Docker の出力:\n${d.stderr}` });
354
374
  return new Error(d.message, { cause: e });
355
375
  };
376
+ let ok = false;
356
377
  try {
357
- return await work(launch.command, async (e, phase) => (await diagnosed(e, phase)) ?? e);
378
+ const r = await work(launch.command, async (e, phase) => (await diagnosed(e, phase)) ?? e);
379
+ ok = true;
380
+ return r;
358
381
  }
359
382
  finally {
360
383
  await launch.cleanup();
384
+ if (docker && name) {
385
+ // どの終わり方でも消す(残っていれば)。正常に終わったときは --rm の削除の途中のことがあるので、消せなかったときだけ知らせる
386
+ const removed = await removeContainer(docker, name);
387
+ const text = ok && removed.state === "removed" ? undefined : removeLog(name, removed);
388
+ if (text)
389
+ log({ kind: removed.state === "failed" ? "error" : "info", text });
390
+ }
361
391
  }
362
392
  }
363
393
  async runWith(cfg, job, auth, env, log, signal) {
@@ -375,10 +405,10 @@ export class CodexWorkspaceEngine {
375
405
  for (const m of r.map)
376
406
  if (m.entry && entryMissing(r, m.entry))
377
407
  log({ kind: "info", text: `入口のファイルがありません: ${r.name}:${m.entry}` });
378
- await this.prepareImage(cfg, log);
408
+ await this.prepareImage(cfg, log, signal);
379
409
  const command = cfg.command?.({ repos, data, auth: auth.mode }) ??
380
410
  withMounts(dockerCommand(PLACEHOLDER, auth.mode === "chatgpt" ? { accessTokenEnv: ACCESS_TOKEN_ENV } : { authVolume: cfg.authVolume, authFile: cfg.authFile }), repos, data);
381
- const outcome = await this.launched(cfg, command, mappings, log, signal, (launch, onError) => this.session(cfg, launch, env, log, onError, (session) => this.turn(session, job, auth, log, signal)));
411
+ const outcome = await this.launched("preflight", cfg, command, mappings, log, signal, (launch, onError) => this.session(cfg, launch, env, log, onError, (session) => this.turn(session, job, auth, log, signal)));
382
412
  // 画面イメージ: Codex が書いた原稿を、Codex の後に P3 が描画のコンテナで PNG にする(Codex のコンテナに Docker は渡さない)。
383
413
  // 描けなくても評価は残す(取り込みで不足として扱う)
384
414
  await renderManuscripts(job.runDir, { pathMap: cfg.pathMap, signal, log, render: cfg.render });
@@ -426,7 +456,7 @@ export class CodexWorkspaceEngine {
426
456
  await session.startThread(developerInstructions(job, env));
427
457
  log({ kind: "info", text: `スレッドを立てました (model: ${session.model})` });
428
458
  try {
429
- const result = await session.runTurn(preflightPrompt(job, env), { signal });
459
+ const result = await turnWithGrace(session, preflightPrompt(job, env), signal, log);
430
460
  if (result.status === "interrupted")
431
461
  throw new Error("中止しました");
432
462
  log({ kind: "info", text: `完了 (${result.seconds}s, ${result.commands.length} commands, 変更 ${result.changed.length} files)` });
@@ -437,6 +467,34 @@ export class CodexWorkspaceEngine {
437
467
  }
438
468
  }
439
469
  }
470
+ /**
471
+ * 1回頼む(runTurn。上限 30 分は codex-workspace の turnTimeoutMs の既定)。中止したら turn/interrupt を送るが、app-server が
472
+ * 応答しなければ runTurn はターンの上限まで待ち続けるので、中止から DOCKER_LIMITS.abortGraceMs で打ち切る(後片付けで閉じて消す)
473
+ */
474
+ async function turnWithGrace(session, prompt, signal, log) {
475
+ let timer;
476
+ let arm = () => { };
477
+ const giveUp = new Promise((_, reject) => {
478
+ arm = () => {
479
+ timer = setTimeout(() => {
480
+ log({ kind: "error", text: `中止を頼みましたが、app-server が ${DOCKER_LIMITS.abortGraceMs / 1000} 秒で止まらないので打ち切ります` });
481
+ reject(new Error("中止しました"));
482
+ }, DOCKER_LIMITS.abortGraceMs);
483
+ };
484
+ });
485
+ giveUp.catch(() => undefined);
486
+ if (signal.aborted)
487
+ arm();
488
+ else
489
+ signal.addEventListener("abort", arm, { once: true });
490
+ try {
491
+ return await Promise.race([session.runTurn(prompt, { signal }), giveUp]);
492
+ }
493
+ finally {
494
+ signal.removeEventListener("abort", arm);
495
+ clearTimeout(timer);
496
+ }
497
+ }
440
498
  /** Codex を使えない(未接続など。Docker は起動していない) */
441
499
  export class CodexUnavailableError extends Error {
442
500
  }
@@ -1,10 +1,38 @@
1
- import { execFile } from "node:child_process";
2
- import { promisify } from "node:util";
3
- import { DEFAULT_IMAGE, ensureImage } from "@infodb/codex-workspace";
4
- const run = promisify(execFile);
5
- /** いつもの Preflight の前に。中の Codex の版を返す */
6
- export function ensureCodexImage({ docker = "docker", image = DEFAULT_IMAGE } = {}) {
7
- return ensureImage({ docker, image });
1
+ import { DEFAULT_IMAGE, DOCKER_CONTEXT, parseCreated } from "@infodb/codex-workspace";
2
+ import { DOCKER_LIMITS, DockerAbortError, DockerCommandError, dockerExec, runNamedContainer } from "./docker.js";
3
+ const DAY = 86_400_000;
4
+ /** いつもの Preflight の前に: 無いか1日より古ければ作り直す。中の Codex の版を返す */
5
+ export async function ensureCodexImage(o = {}) {
6
+ return (await prepare(o, DAY)).version;
7
+ }
8
+ /** イメージを確かめ、maxAgeMs より古ければ作り直し、中の版を読む(ensureImage と同じ判定) */
9
+ async function prepare(o, maxAgeMs) {
10
+ const { docker = "docker", image = DEFAULT_IMAGE, signal } = o;
11
+ const limits = { ...DOCKER_LIMITS, ...o.limits };
12
+ const moment = o.now ?? new Date();
13
+ const created = await imageCreated(docker, image, limits.inspectMs, signal);
14
+ const built = created === null || moment.getTime() - created.getTime() > maxAgeMs;
15
+ if (built) {
16
+ const refresh = moment.toISOString().replace(/\.\d{3}Z$/, "+00:00");
17
+ await dockerExec(docker, ["build", "-q", "-t", image, "--build-arg", `CODEX_REFRESH=${refresh}`, DOCKER_CONTEXT], {
18
+ stage: "Codex のイメージのビルド",
19
+ timeoutMs: limits.buildMs,
20
+ signal,
21
+ });
22
+ }
23
+ return { version: await codexVersion(docker, image, limits.versionMs, signal, o.onCleanup), built };
24
+ }
25
+ async function imageCreated(docker, image, timeoutMs, signal) {
26
+ try {
27
+ const { stdout } = await dockerExec(docker, ["image", "inspect", "--format", "{{.Created}}", image], { stage: "イメージの確認", timeoutMs, signal });
28
+ return parseCreated(stdout.trim());
29
+ }
30
+ catch (e) {
31
+ // 時間切れ・取消は「無い」とみなさない(無いと思って作り直しに進まない)
32
+ if (e instanceof DockerAbortError)
33
+ throw e;
34
+ return null;
35
+ }
8
36
  }
9
37
  /** 更新に失敗した段と、次にすること */
10
38
  export class CodexImageError extends Error {
@@ -17,44 +45,46 @@ export class CodexImageError extends Error {
17
45
  }
18
46
  }
19
47
  /** 今すぐ作り直して、入った Codex の版を返す。進み具合は onProgress へ(CLI は stderr に出す) */
20
- export async function updateCodexImage({ docker = "docker", image = DEFAULT_IMAGE, onProgress = () => { }, } = {}) {
48
+ export async function updateCodexImage({ docker = "docker", image = DEFAULT_IMAGE, onProgress = () => { }, ...rest } = {}) {
49
+ const limits = { ...DOCKER_LIMITS, ...rest.limits };
21
50
  try {
22
- await run(docker, ["version", "--format", "{{.Server.Version}}"], { timeout: 15_000 });
51
+ await dockerExec(docker, ["version", "--format", "{{.Server.Version}}"], { stage: "Docker デーモンの確認", timeoutMs: limits.inspectMs, signal: rest.signal });
23
52
  }
24
53
  catch (e) {
25
54
  const err = e;
26
55
  if (err.code === "ENOENT") {
27
56
  throw new CodexImageError("docker", "docker コマンドが見つかりません。Docker をインストールし、PATH から docker を実行できるようにしてください");
28
57
  }
29
- throw new CodexImageError("daemon", "Docker デーモンに接続できません。Docker を起動し、この利用者が使える(docker version が通る)ことを確かめてください", firstLine(err.stderr));
58
+ throw new CodexImageError("daemon", "Docker デーモンに接続できません。Docker を起動し、この利用者が使える(docker version が通る)ことを確かめてください", firstLine(err.stderr) ?? (e instanceof DockerAbortError ? e.message : undefined));
30
59
  }
31
- const exists = await run(docker, ["image", "inspect", "--format", "{{.Id}}", image]).then(() => true, () => false);
32
- const previous = exists ? await codexVersion(docker, image).catch(() => null) : null;
60
+ const exists = await dockerExec(docker, ["image", "inspect", "--format", "{{.Id}}", image], { stage: "イメージの確認", timeoutMs: limits.inspectMs, signal: rest.signal }).then(() => true, () => false);
61
+ const previous = exists ? await codexVersion(docker, image, limits.versionMs, rest.signal, rest.onCleanup).catch(() => null) : null;
33
62
  onProgress(`Codex のイメージ ${image} を作り直しています(最新の Codex を入れます。数分かかることがあります)`);
34
63
  let version;
35
64
  try {
36
65
  // 作った日時によらず作り直す(maxAgeMs を -∞ にすると、どんな作成日時でも「古い」になる)。返すのは作り直した中の版
37
- version = await ensureImage({ docker, image, maxAgeMs: Number.NEGATIVE_INFINITY });
66
+ version = (await prepare({ docker, image, ...rest }, Number.NEGATIVE_INFINITY)).version;
38
67
  }
39
68
  catch (e) {
40
69
  const err = e;
41
- if (err.cmd?.includes(" build ")) {
42
- throw new CodexImageError("build", "イメージを作れませんでした。ネットワーク(Codex の取得)と Docker のディスクの空きを確かめて、もう一度実行してください", lastLine(err.stderr));
70
+ if (err.cmd?.includes(" build ") || (e instanceof DockerAbortError && e.stage.includes("ビルド"))) {
71
+ throw new CodexImageError("build", "イメージを作れませんでした。ネットワーク(Codex の取得)と Docker のディスクの空きを確かめて、もう一度実行してください", lastLine(err.stderr) ?? err.message);
43
72
  }
44
73
  throw new CodexImageError("version", "イメージは作りましたが、中の Codex の版を読めませんでした。もう一度実行してください", lastLine(err.stderr ?? err.message));
45
74
  }
46
75
  if (!version)
47
76
  throw new CodexImageError("version", "イメージは作りましたが、中の Codex の版を読めませんでした。もう一度実行してください");
48
- const createdAt = await run(docker, ["image", "inspect", "--format", "{{.Created}}", image])
77
+ const createdAt = await dockerExec(docker, ["image", "inspect", "--format", "{{.Created}}", image], { stage: "イメージの確認", timeoutMs: limits.inspectMs })
49
78
  .then((r) => r.stdout.trim() || null)
50
79
  .catch(() => null);
51
80
  return { image, version, previous, createdAt };
52
81
  }
53
- async function codexVersion(docker, image) {
54
- const { stdout } = await run(docker, ["run", "--rm", "--entrypoint", "codex", image, "--version"], { timeout: 60_000 });
82
+ /** 中の Codex の版(認証は使わない)。名前を付けたコンテナで動かし、上限を過ぎたらそのコンテナを消す */
83
+ async function codexVersion(docker, image, timeoutMs, signal, onCleanup) {
84
+ const { stdout } = await runNamedContainer(docker, ["--entrypoint", "codex", image, "--version"], { stage: "Codex の版の確認", timeoutMs, signal, kind: "codex-version", onCleanup });
55
85
  const v = stdout.trim();
56
86
  if (!v)
57
- throw new Error("codex --version が空");
87
+ throw new DockerCommandError("codex --version が空", 0, "", "codex --version");
58
88
  return v;
59
89
  }
60
90
  const firstLine = (s) => s?.trim().split("\n")[0] || undefined;
@@ -0,0 +1,149 @@
1
+ import { spawn } from "node:child_process";
2
+ import { randomBytes } from "node:crypto";
3
+ /**
4
+ * Preflight が使う docker の操作に、待つ時間の上限と取消を持たせる(261103-gtfcg/T003)。
5
+ * 以前は版の確認(docker run ... codex --version)・ビルド・inspect に上限が無く、版を出力した後も終わらないコンテナを待って
6
+ * Preflight が止まった。時間切れ・取消では docker の CLI を止め、名前を付けて起こしたコンテナはそのコンテナだけを消す
7
+ * (docker ps の全部・イメージ名では消さない)。
8
+ */
9
+ /** 上限の既定(テストは短くする。docs/architecture.md の「Docker の待ち時間の上限」) */
10
+ export const DOCKER_LIMITS = {
11
+ /** docker version / image inspect など、デーモンに聞くだけの操作 */
12
+ inspectMs: 15_000,
13
+ /** 版の確認(docker run --rm ... codex --version) */
14
+ versionMs: 60_000,
15
+ /** イメージのビルド(Codex を入れ直す) */
16
+ buildMs: 10 * 60_000,
17
+ /** コンテナを消す(docker rm -f) */
18
+ removeMs: 10_000,
19
+ /** 中止を頼んでも app-server が応答しないとき、打ち切るまで待つ時間 */
20
+ abortGraceMs: 15_000,
21
+ };
22
+ /** P3 が起こしたコンテナに付けるラベル(消すときは名前で指す。ラベルは人が見分けるため) */
23
+ export const CONTAINER_LABEL = "infodb.p3";
24
+ /** 時間切れ・取消で止めた(stage は何をしていたか) */
25
+ export class DockerAbortError extends Error {
26
+ stage;
27
+ reason;
28
+ constructor(stage, reason, message) {
29
+ super(message);
30
+ this.stage = stage;
31
+ this.reason = reason;
32
+ }
33
+ }
34
+ /** docker の CLI の失敗(終了コード・stderr) */
35
+ export class DockerCommandError extends Error {
36
+ code;
37
+ stderr;
38
+ cmd;
39
+ constructor(message, code, stderr, cmd) {
40
+ super(message);
41
+ this.code = code;
42
+ this.stderr = stderr;
43
+ this.cmd = cmd;
44
+ }
45
+ }
46
+ /**
47
+ * docker の CLI を動かして終わりを待つ。timeoutMs を過ぎるか signal で止めると、CLI を SIGTERM(2 秒後に SIGKILL)で止めて
48
+ * DockerAbortError。終了コードが 0 でなければ DockerCommandError。起動できなければ(ENOENT など)そのエラー
49
+ */
50
+ export function dockerExec(docker, args, o) {
51
+ return new Promise((resolve, reject) => {
52
+ if (o.signal?.aborted)
53
+ return reject(new DockerAbortError(o.stage, "aborted", `${o.stage}を中止しました`));
54
+ const child = spawn(docker, args, { stdio: ["ignore", "pipe", "pipe"] });
55
+ const max = o.maxBuffer ?? 16 * 1024 * 1024;
56
+ let stdout = "";
57
+ let stderr = "";
58
+ child.stdout.on("data", (d) => {
59
+ if (stdout.length < max)
60
+ stdout += d.toString();
61
+ });
62
+ child.stderr.on("data", (d) => {
63
+ if (stderr.length < max)
64
+ stderr += d.toString();
65
+ });
66
+ let stopped;
67
+ const stop = (reason) => {
68
+ if (stopped || child.exitCode !== null)
69
+ return;
70
+ stopped = new DockerAbortError(o.stage, reason, reason === "timeout" ? `${o.stage}が ${Math.round(o.timeoutMs / 1000)} 秒で終わらないので止めました` : `${o.stage}を中止しました`);
71
+ child.kill("SIGTERM");
72
+ setTimeout(() => child.exitCode === null && child.kill("SIGKILL"), 2_000).unref();
73
+ };
74
+ const timer = setTimeout(() => stop("timeout"), o.timeoutMs);
75
+ const onAbort = () => stop("aborted");
76
+ o.signal?.addEventListener("abort", onAbort, { once: true });
77
+ const done = () => {
78
+ clearTimeout(timer);
79
+ o.signal?.removeEventListener("abort", onAbort);
80
+ };
81
+ child.once("error", (e) => {
82
+ done();
83
+ reject(e);
84
+ });
85
+ child.once("close", (code) => {
86
+ done();
87
+ if (stopped)
88
+ return reject(stopped);
89
+ if (code === 0)
90
+ return resolve({ stdout, stderr });
91
+ const cmd = [docker, ...args].join(" ");
92
+ reject(new DockerCommandError(`${o.stage}に失敗しました(終了コード ${code}): ${lastLine(stderr) ?? ""}`, code, stderr, cmd));
93
+ });
94
+ });
95
+ }
96
+ /** P3 が起こすコンテナの名前(docker の名前の規則 [a-zA-Z0-9][a-zA-Z0-9_.-]+ に合わせる) */
97
+ export function containerName(kind, id) {
98
+ const base = `p3-${kind}${id ? `-${id}` : ""}`.toLowerCase().replace(/[^a-z0-9_.-]/g, "-");
99
+ return `${base}-${randomBytes(3).toString("hex")}`;
100
+ }
101
+ /** docker run の引数に名前とラベルを足す("run" の直後。docker run 以外の形なら変えない) */
102
+ export function withContainerName(command, name, labels) {
103
+ const at = command.indexOf("run");
104
+ if (at !== 1)
105
+ return command;
106
+ const label = Object.entries(labels).flatMap(([k, v]) => ["--label", `${k}=${v}`]);
107
+ return [...command.slice(0, at + 1), "--name", name, ...label, ...command.slice(at + 1)];
108
+ }
109
+ /**
110
+ * 名前で指したコンテナを消す(docker rm -f)。もう無ければ gone(--rm で消えた・起動の前に止めた)。
111
+ * 消せない・時間切れは failed(残っているかもしれない。消えたとは断定しない)
112
+ */
113
+ export async function removeContainer(docker, name, timeoutMs = DOCKER_LIMITS.removeMs) {
114
+ try {
115
+ await dockerExec(docker, ["rm", "-f", name], { stage: `コンテナ ${name} の削除`, timeoutMs });
116
+ return { state: "removed" };
117
+ }
118
+ catch (e) {
119
+ if (e instanceof DockerCommandError && /no such container/i.test(e.stderr))
120
+ return { state: "gone" };
121
+ return { state: "failed", reason: e instanceof Error ? e.message : String(e) };
122
+ }
123
+ }
124
+ /** 片付けの結果をログの文にする(gone は何も言わない) */
125
+ export function removeLog(name, r) {
126
+ if (r.state === "removed")
127
+ return `コンテナ ${name} が残っていたので消しました`;
128
+ if (r.state === "failed")
129
+ return `コンテナ ${name} を消せませんでした(残っているかもしれません。docker ps -a --filter label=${CONTAINER_LABEL} で確かめ、docker rm -f ${name} で消してください): ${r.reason}`;
130
+ return undefined;
131
+ }
132
+ /**
133
+ * 名前を付けたコンテナで docker run を動かし、終わりを待つ(版の確認など、すぐ終わるもの)。
134
+ * 時間切れ・取消・失敗のときは、そのコンテナを消す(残っていれば)。片付けの結果は onCleanup へ。
135
+ * 正常に終わったときは消さない(CLI が終わった直後は --rm の削除がまだ途中のことがあり、消すと「残っていた」と誤って知らせる)
136
+ */
137
+ export async function runNamedContainer(docker, runArgs, o) {
138
+ const name = containerName(o.kind, o.id);
139
+ try {
140
+ return await dockerExec(docker, ["run", "--rm", "--name", name, "--label", `${CONTAINER_LABEL}=${o.kind}`, ...runArgs], o);
141
+ }
142
+ catch (e) {
143
+ const text = removeLog(name, await removeContainer(docker, name));
144
+ if (text)
145
+ o.onCleanup?.(text);
146
+ throw e;
147
+ }
148
+ }
149
+ const lastLine = (s) => s?.trim().split("\n").at(-1) || undefined;