@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
@@ -1,5 +1,8 @@
1
- import { basename, relative } from "node:path";
1
+ import { readFile } from "node:fs/promises";
2
+ import { basename, relative, resolve as resolvePath } from "node:path";
2
3
  import { REQUEST_STATUSES } from "../shared/types.js";
4
+ import { nextGoalId } from "../shared/milestoneGoals.js";
5
+ import { REVIEW_STATUS_LABELS, REVIEW_VERDICT_LABELS, REVIEW_VERDICTS } from "../shared/milestoneReview.js";
3
6
  import {} from "../core/context.js";
4
7
  import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, orderChildren, updateRequest } from "../core/requestOps.js";
5
8
  import { hierarchyNow, resolvedIssue } from "../core/requestStatus.js";
@@ -155,37 +158,227 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
155
158
  }
156
159
  // --- マイルストーン -----------------------------------------------------------
157
160
  /** マイルストーン(リリース)。複数の要望をまとめる単位で、project.yaml に書く */
158
- export async function milestoneCommand(ctx, out, args, o) {
161
+ const MILESTONE_USAGE = "p3 milestone [ls | show <id> | add <id> | set <id> | rm <id> | purpose <id> (--body 本文|- | --file ファイル | --off) | goal add <id> <文> | goal set <id> <G番号> <文> | goal rm <id> <G番号> | review <id> | reviews <id> | review-show <id> <run> | review-cancel <id> <run>]";
162
+ /**
163
+ * マイルストーンの操作。保存はロックの中で読んだ最新の並びから作り直す(Workspace.updateMilestones。指定した項目のほかを巻き戻さない)。
164
+ * --version(show --json の milestonesVersion)を付けると、その版から変わっていれば競合(終了コード 3)で何も書かない
165
+ */
166
+ export async function milestoneCommand(ctx, out, args, o, actor) {
159
167
  const [sub, id] = args;
168
+ if (sub === "review" || sub === "reviews" || sub === "review-show" || sub === "review-cancel")
169
+ return reviewCommand(ctx, out, args, o, actor);
160
170
  const ms = ctx.ws.project.milestones;
161
171
  const count = (mid) => ctx.ws.requests.list().filter((r) => r.milestone === mid).length;
172
+ const save = { milestonesVersion: o.version };
173
+ /** 最新の並びの中で id のマイルストーンを変える(無ければ使い方の誤り) */
174
+ const change = async (mid, fn) => {
175
+ const p = await ctx.ws.updateMilestones((cur) => {
176
+ if (!cur.some((m) => m.id === mid))
177
+ throw new UsageError(`マイルストーンがありません: ${mid}`);
178
+ return cur.map((m) => (m.id === mid ? fn(m) : m));
179
+ }, save);
180
+ return p.milestones.find((m) => m.id === mid);
181
+ };
182
+ const needId = (cmd) => {
183
+ if (!id)
184
+ throw new UsageError(`p3 milestone ${cmd} <id>`);
185
+ return id;
186
+ };
162
187
  if (sub === "add" || sub === "set") {
163
188
  if (!id || !/^[A-Za-z0-9._-]+$/.test(id))
164
189
  throw new UsageError(`p3 milestone ${sub} <id>(英数字と . _ -)`);
165
- const cur = ms.find((m) => m.id === id);
166
- if (sub === "add" && cur)
167
- throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
168
- if (sub === "set" && !cur)
169
- throw new UsageError(`マイルストーンがありません: ${id}`);
170
- const next = {
190
+ const make = (cur) => ({
191
+ ...cur,
171
192
  id,
172
193
  title: o.title ?? cur?.title ?? id,
173
194
  due: o.due !== undefined ? (o.due ? date(o.due) : undefined) : cur?.due,
174
195
  done: o.done ?? cur?.done,
175
- };
176
- await ctx.ws.saveProject({ milestones: cur ? ms.map((m) => (m.id === id ? next : m)) : [...ms, next] });
177
- return out.result(next, () => `${cur ? "更新" : "追加"}しました: ${next.title}(${id}${next.due ? ` · ${next.due}` : ""})`);
196
+ });
197
+ let existed = false;
198
+ const p = await ctx.ws.updateMilestones((cur) => {
199
+ const was = cur.find((m) => m.id === id);
200
+ existed = !!was;
201
+ if (sub === "add" && was)
202
+ throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
203
+ if (sub === "set" && !was)
204
+ throw new UsageError(`マイルストーンがありません: ${id}`);
205
+ return was ? cur.map((m) => (m.id === id ? make(m) : m)) : [...cur, make(undefined)];
206
+ }, save);
207
+ const next = p.milestones.find((m) => m.id === id);
208
+ return out.result(next, () => `${existed ? "更新" : "追加"}しました: ${next.title}(${id}${next.due ? ` · ${next.due}` : ""})`);
178
209
  }
179
210
  if (sub === "rm" || sub === "remove") {
180
211
  if (!id || !ms.some((m) => m.id === id))
181
212
  throw new UsageError(`マイルストーンがありません: ${id ?? ""}`);
182
213
  await checkMilestoneRemoval(ctx, ms.filter((m) => m.id !== id).map((m) => m.id));
183
- await ctx.ws.saveProject({ milestones: ms.filter((m) => m.id !== id) });
214
+ await ctx.ws.updateMilestones((cur) => cur.filter((m) => m.id !== id), save);
184
215
  return out.result({ removed: id }, () => `外しました: ${id}`);
185
216
  }
217
+ if (sub === "show") {
218
+ const mid = needId("show");
219
+ const m = ms.find((x) => x.id === mid);
220
+ if (!m)
221
+ throw new UsageError(`マイルストーンがありません: ${mid}`);
222
+ return out.result({ ...m, requests: count(mid), milestonesVersion: ctx.ws.milestonesVersion }, () => formatMilestone(m, count(mid)));
223
+ }
224
+ if (sub === "purpose") {
225
+ const mid = needId("purpose");
226
+ const given = [o.off, o.body !== undefined, o.file !== undefined].filter(Boolean).length;
227
+ if (given !== 1)
228
+ throw new UsageError(`p3 milestone purpose ${mid} --body 本文|- か --file ファイル か --off(どれか1つ)`);
229
+ const text = o.off ? "" : o.file !== undefined ? await readFile(resolvePath(process.cwd(), o.file), "utf8") : readBody(o.body);
230
+ const m = await change(mid, (x) => ({ ...x, purpose: text }));
231
+ return out.result(m, () => (m.purpose ? `目的を保存しました: ${mid}` : `目的を外しました: ${mid}`));
232
+ }
233
+ if (sub === "goal") {
234
+ const [, op, mid, a, b] = args;
235
+ if (!mid || !["add", "set", "rm", "remove"].includes(op ?? ""))
236
+ throw new UsageError("p3 milestone goal add <id> <文> | goal set <id> <G番号> <文> | goal rm <id> <G番号>");
237
+ if (op === "add") {
238
+ if (a === undefined)
239
+ throw new UsageError(`p3 milestone goal add ${mid} <文>`);
240
+ let gid = "";
241
+ const m = await change(mid, (x) => {
242
+ gid = nextGoalId(x.goals ?? []);
243
+ return { ...x, goals: [...(x.goals ?? []), { id: gid, text: a }] };
244
+ });
245
+ return out.result({ ...m, added: gid }, () => `予定機能を追加しました: ${mid} ${gid}`);
246
+ }
247
+ if (!a)
248
+ throw new UsageError(`p3 milestone goal ${op} ${mid} <G番号>`);
249
+ const exists = (x) => {
250
+ if (!(x.goals ?? []).some((g) => g.id === a))
251
+ throw new UsageError(`予定機能がありません: ${mid} ${a}`);
252
+ };
253
+ if (op === "set") {
254
+ if (b === undefined)
255
+ throw new UsageError(`p3 milestone goal set ${mid} ${a} <文>`);
256
+ const m = await change(mid, (x) => (exists(x), { ...x, goals: (x.goals ?? []).map((g) => (g.id === a ? { ...g, text: b } : g)) }));
257
+ return out.result(m, () => `予定機能を更新しました: ${mid} ${a}`);
258
+ }
259
+ const m = await change(mid, (x) => (exists(x), { ...x, goals: (x.goals ?? []).filter((g) => g.id !== a) }));
260
+ return out.result({ ...m, removed: a }, () => `予定機能を外しました: ${mid} ${a}`);
261
+ }
186
262
  if (sub && sub !== "ls" && sub !== "list")
187
- throw new UsageError("p3 milestone [ls | add <id> | set <id> | rm <id>]");
263
+ throw new UsageError(MILESTONE_USAGE);
188
264
  const shown = sortMilestones(ms);
189
- return out.result(shown, () => table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
265
+ return out.result(shown, () => table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`, m.purpose ? "目的あり" : "", m.goals?.length ? `予定機能 ${m.goals.length}` : ""])) ||
190
266
  "マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース --due 2026-11-30)");
191
267
  }
268
+ /** milestone show の人向けの表示 */
269
+ function formatMilestone(m, requests) {
270
+ const lines = [`${m.id} ${m.title}${m.due ? ` 期限 ${m.due}` : ""}${m.done ? " リリース済み" : ""} 要望 ${requests}`, "", "目的:"];
271
+ lines.push(m.purpose ? m.purpose.split("\n").map((l) => ` ${l}`).join("\n") : ` (なし。p3 milestone purpose ${m.id} --file 目的.md)`);
272
+ lines.push("", "予定している機能・目標:");
273
+ lines.push(m.goals?.length ? m.goals.map((g) => ` ${g.id} ${g.text}`).join("\n") : ` (なし。p3 milestone goal add ${m.id} "文")`);
274
+ return lines.join("\n");
275
+ }
276
+ // --- マイルストーンレビュー ----------------------------------------------------
277
+ /**
278
+ * マイルストーンレビュー(core/milestoneReview。画面と同じ規則)。review は終わるまで待ち、進み具合は stderr に出す(Ctrl-C で取り消す)。
279
+ * 結果は参考の記録で、要望の状態・リリースノート・リリース済みは変えない
280
+ */
281
+ async function reviewCommand(ctx, out, args, o, actor) {
282
+ const [sub, mid, run] = args;
283
+ if (!mid)
284
+ throw new UsageError(`p3 milestone ${sub} <id>${sub === "review-show" || sub === "review-cancel" ? " <run>" : ""}`);
285
+ const svc = ctx.milestoneReview;
286
+ if (sub === "reviews") {
287
+ const items = await svc.list(mid);
288
+ return out.result(items, () => items.length
289
+ ? table(items.map((x) => x.state === "broken"
290
+ ? [x.id, "読めない", x.error]
291
+ : [x.run.id, REVIEW_STATUS_LABELS[x.run.status], x.run.startedAt.slice(0, 16).replace("T", " "), verdictSummary(x.verdicts), x.run.error ?? ""]))
292
+ : `レビューの履歴はありません(p3 milestone review ${mid})`);
293
+ }
294
+ if (sub === "review-show" || sub === "review-cancel") {
295
+ if (!run)
296
+ throw new UsageError(`p3 milestone ${sub} ${mid} <run>`);
297
+ if (sub === "review-show") {
298
+ const d = await svc.get(mid, run);
299
+ return out.result(d, () => formatReview(d));
300
+ }
301
+ const r = await svc.cancel(mid, run, actor, { acknowledgeStopped: o["acknowledge-stopped"] });
302
+ return out.result(r, () => r.requested
303
+ ? `取消を頼みました: ${mid}/${run}(実行しているプロセスが見つけて止めます)`
304
+ : r.run.abandoned
305
+ ? `中断にしました: ${mid}/${run}(記録の上で終わりにしました。ほかの環境で動いているプロセスを止めたとは限りません)`
306
+ : `終わりにしました: ${mid}/${run}(${REVIEW_STATUS_LABELS[r.run.status]}${r.run.error ? `: ${r.run.error}` : ""})`);
307
+ }
308
+ if (o.engine !== undefined && o.engine !== "codex" && o.engine !== "mock")
309
+ throw new UsageError("--engine は codex か mock");
310
+ const started = await svc.start(mid, actor, o.engine);
311
+ process.stderr.write(`レビューを始めました: ${mid}/${started.id}(Ctrl-C で取り消す)\n`);
312
+ let shown = 0;
313
+ const tick = setInterval(() => {
314
+ void svc.get(mid, started.id).then((d) => {
315
+ for (const e of d.run.log.slice(shown))
316
+ process.stderr.write(` ${e.text}\n`);
317
+ shown = Math.max(shown, d.run.log.length);
318
+ }, () => undefined);
319
+ }, 500);
320
+ const onInt = () => void svc.cancel(mid, started.id, actor).catch(() => undefined);
321
+ process.on("SIGINT", onInt);
322
+ const d = await svc.wait(mid, started.id);
323
+ clearInterval(tick);
324
+ process.removeListener("SIGINT", onInt);
325
+ for (const e of d.run.log.slice(shown))
326
+ process.stderr.write(` ${e.text}\n`);
327
+ if (d.run.status !== "completed") {
328
+ if (out.json)
329
+ out.result(d, () => "");
330
+ else
331
+ process.stderr.write(`${REVIEW_STATUS_LABELS[d.run.status]}: ${d.run.error ?? ""}\n`);
332
+ return 1;
333
+ }
334
+ return out.result(d, () => formatReview(d));
335
+ }
336
+ function verdictSummary(v) {
337
+ if (!v)
338
+ return "";
339
+ return REVIEW_VERDICTS.filter((k) => v[k]).map((k) => `${REVIEW_VERDICT_LABELS[k]} ${v[k]}`).join(" · ");
340
+ }
341
+ /** review-show の人向けの表示 */
342
+ function formatReview(d) {
343
+ const { run, input, result } = d;
344
+ const lines = [`${run.milestone}/${run.id} ${REVIEW_STATUS_LABELS[run.status]} ${run.startedAt}${run.startedBy ? ` ${run.startedBy}` : ""} (${run.engine})`];
345
+ if (run.error)
346
+ lines.push(` ${run.error}`);
347
+ if (d.owner && d.owner.state !== "local" && d.owner.state !== "alive") {
348
+ lines.push(` 実行しているプロセスを確かめられません(${"reason" in d.owner ? d.owner.reason : ""})。止まっていると確かめたら p3 milestone review-cancel ${run.milestone} ${run.id} --acknowledge-stopped`);
349
+ }
350
+ if (input) {
351
+ lines.push("", "評価したときの目的:", input.milestone.purpose ? input.milestone.purpose.split("\n").map((l) => ` ${l}`).join("\n") : " (なし)");
352
+ lines.push(`材料: 要望 ${input.requests.length} 件・文脈 ${input.context.length} 件(${input.extractedAt})`);
353
+ for (const c of input.code ?? []) {
354
+ lines.push(c.status === "ok"
355
+ ? ` 参照先 ${c.name}: ${c.head ? `${c.branch ? `${c.branch} ` : ""}${c.head.slice(0, 7)}` : "HEAD なし"}${c.dirty ? `・未コミットの変更 ${c.dirty} 件` : ""}・タスクのコミット ${c.commits.filter((x) => x.found).length} 件`
356
+ : ` 参照先 ${c.name}: 読めません(${c.reason ?? c.status})`);
357
+ for (const x of c.commits)
358
+ lines.push(` ${x.sha.slice(0, 12)} ${x.from}${x.found ? "" : " (履歴に無い)"}`);
359
+ }
360
+ for (const w of input.warnings)
361
+ lines.push(` ⚠ ${w.message}`);
362
+ }
363
+ if (result) {
364
+ const text = new Map(input?.units.map((u) => [u.id, u.text]));
365
+ lines.push("", "全体の所見:", ...result.overall.split("\n").map((l) => ` ${l}`), "");
366
+ for (const u of result.units) {
367
+ lines.push(`■ ${u.unit} ${REVIEW_VERDICT_LABELS[u.verdict]} ${(text.get(u.unit) ?? "").split("\n")[0]}`);
368
+ lines.push(` 理由: ${u.reason}`);
369
+ if (u.evidence.length)
370
+ lines.push(` 根拠: ${u.evidence.join(", ")}`);
371
+ for (const g of u.gaps)
372
+ lines.push(` 不足: ${g}`);
373
+ }
374
+ if (result.unplanned) {
375
+ lines.push("", "目的・予定機能に無い変更(意図しない変更の候補):");
376
+ if (!result.unplanned.length)
377
+ lines.push(" (見つかっていません)");
378
+ for (const u of result.unplanned)
379
+ lines.push(` - ${u.text}${u.evidence.length ? `(根拠: ${u.evidence.join(", ")})` : ""}`);
380
+ }
381
+ lines.push("", `範囲: ${result.scope}`);
382
+ }
383
+ return lines.join("\n");
384
+ }
@@ -8,6 +8,8 @@ import { checkDataDir } from "./store/locate.js";
8
8
  import { Workspace } from "./store/workspace.js";
9
9
  import { ReleaseGenerator } from "./releaseNotes/generate.js";
10
10
  import { MockSummarizer } from "./releaseNotes/mockSummarizer.js";
11
+ import { MilestoneReviewService } from "./milestoneReview/service.js";
12
+ import { MockReviewer } from "./milestoneReview/mockReviewer.js";
11
13
  /** p3 本体(パッケージ)のルート */
12
14
  export const P3_ROOT = fileURLToPath(new URL("../../", import.meta.url));
13
15
  /**
@@ -37,5 +39,6 @@ export async function openProject(dataDir, opts = {}) {
37
39
  }, { pathMap: async () => (await source.get()).codex.pathMap });
38
40
  // 要約の生成も Preflight と同じ接続と既定のエンジン(preflight.engine)を使う
39
41
  const releaseGenerator = new ReleaseGenerator(ws, { codex, mock: new MockSummarizer() }, { engine: async () => (await source.get()).preflight.engine });
40
- return { ws, preflight, releaseGenerator, chatgpt, projectName: opts.projectName };
42
+ const milestoneReview = new MilestoneReviewService(ws, { codex, mock: new MockReviewer() }, { engine: async () => (await source.get()).preflight.engine });
43
+ return { ws, preflight, releaseGenerator, milestoneReview, chatgpt, projectName: opts.projectName };
41
44
  }
@@ -0,0 +1,129 @@
1
+ import { execFile } from "node:child_process";
2
+ import { createHash } from "node:crypto";
3
+ import { isAbsolute, relative } from "node:path";
4
+ import { promisify } from "node:util";
5
+ import { gitHistory } from "../repoRefs.js";
6
+ const run = promisify(execFile);
7
+ /**
8
+ * マイルストーンレビューのコードの材料。Codex には参照先を読むだけでマウントして、コードと git の履歴を読ませる。
9
+ * ここでは、そのとき読んだものが後から分かるように、参照先ごとの状態・HEAD・ブランチ・未コミットの変更の数と、
10
+ * タスクの成果物に残したコミット(参照先の履歴にあるか)を取り出す。コードの中身は保存しない。git は読むだけの操作だけ。
11
+ */
12
+ /** 成果物の文字列からコミットを取り出す(…/commit/<sha> の URL か、sha だけの文字列) */
13
+ export function commitsInOutput(output) {
14
+ const out = new Set();
15
+ for (const m of output.matchAll(/\/commit\/([0-9a-f]{7,40})\b/gi))
16
+ out.add(m[1].toLowerCase());
17
+ const bare = output.trim();
18
+ if (/^[0-9a-f]{7,40}$/i.test(bare))
19
+ out.add(bare.toLowerCase());
20
+ return [...out];
21
+ }
22
+ const git = async (local, args) => (await run("git", ["-C", local, ...args], { timeout: 10_000, maxBuffer: 4 * 1024 * 1024 })).stdout.trim();
23
+ const tryGit = (local, args) => git(local, args).catch(() => undefined);
24
+ /** git を動かして標準出力を返す(標準入力を渡せる。大きな差分も読む) */
25
+ function gitRaw(local, args, input) {
26
+ return new Promise((resolve) => {
27
+ const child = execFile("git", ["-C", local, ...args], { timeout: 30_000, maxBuffer: 256 * 1024 * 1024, encoding: "utf8" }, (err, stdout) => resolve(err ? undefined : stdout));
28
+ // git が先に終わっても(EPIPE)落とさない。結果は終わり方で決める
29
+ child.stdin?.on("error", () => undefined);
30
+ child.stdin?.end(input);
31
+ });
32
+ }
33
+ /**
34
+ * 未コミットの変更の中身の識別子(差分と、追跡していないファイルの中身から。中身そのものは保存しない)。
35
+ * 変更の数が同じでも中身が変われば変わる(材料が変わったと分かるように)
36
+ */
37
+ async function dirtyDigest(local, head, pathspec) {
38
+ const tracked = head
39
+ ? await gitRaw(local, ["diff", "--binary", "HEAD", "--", ...pathspec])
40
+ : [await gitRaw(local, ["diff", "--binary", "--cached", "--", ...pathspec]), await gitRaw(local, ["diff", "--binary", "--", ...pathspec])].join("\n");
41
+ const others = (await gitRaw(local, ["ls-files", "--others", "--exclude-standard", "-z", "--", ...pathspec])) ?? "";
42
+ const names = others.split("\0").filter(Boolean).sort();
43
+ const blobs = names.length ? await gitRaw(local, ["hash-object", "--stdin-paths"], `${names.join("\n")}\n`) : "";
44
+ if (tracked === undefined || blobs === undefined)
45
+ return undefined;
46
+ return createHash("sha256").update(tracked).update("\0").update(names.join("\0")).update("\0").update(blobs).digest("hex");
47
+ }
48
+ /**
49
+ * 参照先ごとのコードの材料と警告。dataDir: データのフォルダ(参照先の中にあれば、未コミットの変更の数に入れない。
50
+ * 要望・タスクの記録は別に材料にしている)
51
+ */
52
+ export async function reviewCode(refs, requests, dataDir) {
53
+ const warnings = [];
54
+ // 成果物に残したコミット("<参照先>: <成果物>" は、その参照先のもの)
55
+ const wanted = [];
56
+ const names = new Set(refs.map((r) => r.name));
57
+ for (const r of requests) {
58
+ for (const t of r.tasks) {
59
+ for (const o of t.outputs) {
60
+ const m = /^([^:\s]+): (.*)$/s.exec(o);
61
+ const repo = m && names.has(m[1]) ? m[1] : undefined;
62
+ for (const sha of commitsInOutput(repo ? m[2] : o)) {
63
+ if (!wanted.some((w) => w.sha === sha && w.from === t.ref))
64
+ wanted.push({ sha, from: t.ref, repo });
65
+ }
66
+ }
67
+ }
68
+ }
69
+ const code = [];
70
+ for (const r of refs) {
71
+ const base = { name: r.name, mount: r.mount, ...(r.role ? { role: r.role } : {}), status: r.status };
72
+ if (r.status !== "ok" || !r.local) {
73
+ code.push({ ...base, ...(r.reason ? { reason: r.reason } : {}), commits: [] });
74
+ warnings.push({ code: "code_unavailable", target: r.name, message: `参照先 ${r.name} を読めません(${r.reason ?? r.status})。そのコードは確かめられません` });
75
+ continue;
76
+ }
77
+ const history = gitHistory(r.local).status;
78
+ const ref = { ...base, history, commits: [] };
79
+ if (history !== "unavailable") {
80
+ const head = await tryGit(r.local, ["rev-parse", "--verify", "-q", "HEAD"]);
81
+ const branch = await tryGit(r.local, ["branch", "--show-current"]);
82
+ const rel = dataDir ? relative(r.local, dataDir) : "..";
83
+ const inside = rel !== "" && !rel.startsWith("..") && !isAbsolute(rel);
84
+ const pathspec = [".", ...(inside ? [`:(exclude)${rel}`] : [])];
85
+ const status = await tryGit(r.local, ["status", "--porcelain", "--", ...pathspec]);
86
+ if (head)
87
+ ref.head = head;
88
+ if (branch)
89
+ ref.branch = branch;
90
+ const dirty = status ? status.split("\n").filter(Boolean).length : 0;
91
+ if (dirty) {
92
+ ref.dirty = dirty;
93
+ const digest = await dirtyDigest(r.local, head, pathspec);
94
+ if (digest)
95
+ ref.dirtyDigest = digest;
96
+ warnings.push({ code: "dirty_worktree", target: r.name, message: `参照先 ${r.name} に未コミットの変更が ${dirty} 件あります(作業ツリーのコードを読むので、コミットとずれることがあります)` });
97
+ }
98
+ }
99
+ code.push(ref);
100
+ }
101
+ // コミットは、指定の参照先か、履歴のある参照先のどれかで探す
102
+ for (const w of wanted) {
103
+ const candidates = code.filter((c) => c.status === "ok" && c.history && c.history !== "unavailable" && (!w.repo || c.name === w.repo));
104
+ let placed = false;
105
+ for (const c of candidates) {
106
+ const local = refs.find((r) => r.name === c.name).local;
107
+ const full = await tryGit(local, ["rev-parse", "--verify", "-q", `${w.sha}^{commit}`]);
108
+ if (full) {
109
+ add(c.commits, { sha: full, from: w.from, found: true });
110
+ placed = true;
111
+ break;
112
+ }
113
+ }
114
+ if (!placed) {
115
+ const target = code.find((c) => c.name === w.repo) ?? candidates[0];
116
+ if (target)
117
+ add(target.commits, { sha: w.sha, from: w.from, found: false });
118
+ warnings.push({ code: "commit_missing", target: w.from, message: `${w.from} の成果物のコミット ${w.sha} が参照先の履歴にありません(中身を確かめられません)` });
119
+ }
120
+ }
121
+ if (!code.some((c) => c.status === "ok")) {
122
+ warnings.push({ code: "no_code", target: "repos", message: "読める参照先(リポジトリ)がありません。実装は確かめられず、記録だけの点検になります(p3 repo path <名前> <パス> で登録できます)" });
123
+ }
124
+ return { code, warnings };
125
+ }
126
+ function add(list, c) {
127
+ if (!list.some((x) => x.sha === c.sha && x.from === c.from))
128
+ list.push(c);
129
+ }
@@ -0,0 +1,138 @@
1
+ import { createHash } from "node:crypto";
2
+ import { PURPOSE_UNIT_ID, REVIEW_SCOPE, REVIEW_SCOPE_RECORDS_ONLY, } from "../../shared/milestoneReview.js";
3
+ import { hierarchyNow } from "../requestStatus.js";
4
+ import { Workspace } from "../store/workspace.js";
5
+ import { reviewCode } from "./code.js";
6
+ /**
7
+ * マイルストーンレビューの比較材料を取り出す。リリースノートの材料(releaseNotes/material.ts)とは別の規則で、あちらの収録の
8
+ * 条件は変えない。
9
+ *
10
+ * - 比べるのは保存してある目的・予定機能(画面の書きかけは使わない)。比較単位は予定機能。予定機能が無く目的だけなら目的そのもの
11
+ * - 確かめる対象は参照先のコード(code.ts。Codex に読むだけでマウントする)。参照先ごとの HEAD・未コミットの変更・
12
+ * タスクに残したコミットを固定する。読める参照先が無ければ警告し、範囲を「記録だけ」にする
13
+ * - 材料は、マイルストーンに直接属する要望の全部の状態(下書き・進行中・対応済・完了済・見送り)。要望の本文、各タスクの本文・状態・
14
+ * 変更の記録・成果物の参照の文字列。未完了・記録なしも省かない(見送りは状態のまま残し、成果と混同しないよう評価の指示で扱う)
15
+ * - 親子: 親・子が別のマイルストーンなら文脈(context)として ID・題・状態だけを持ち、材料には数えない(二重に数えない)
16
+ * - アーカイブした要望は通常の一覧と同じく含めない。成果物の URL・添付の中身は読まない
17
+ * - 読めない要望は所属が分からないので全体の警告、読めないタスクはその要望の欠落の警告
18
+ * - hash には目的・予定機能・所属・本文・状態・記録・関係・欠落を入れ、抽出の日時は入れない
19
+ *
20
+ * 抽出のたびにディスクから読み直した別の Workspace を使う(画面・CLI のキャッシュに左右されない)。複数のファイルを同じ時点で
21
+ * 読んだとは保証しない(抽出の始めと終わりを残す)。何も書かない。
22
+ */
23
+ export async function extractReviewInput(dataDir, mid, refs = []) {
24
+ const extractedAt = new Date().toISOString();
25
+ const snap = new Workspace(dataDir);
26
+ await snap.load();
27
+ const records = reviewInputOf(snap, mid, extractedAt);
28
+ const { code, warnings } = await reviewCode(refs, records.requests, dataDir);
29
+ return withCode(records, code, warnings);
30
+ }
31
+ /** 記録の材料にコードの材料を足す(範囲・警告・hash も合わせる) */
32
+ export function withCode(i, code, warnings = []) {
33
+ const body = {
34
+ milestone: i.milestone,
35
+ units: i.units,
36
+ requests: i.requests,
37
+ context: i.context,
38
+ warnings: [...i.warnings, ...warnings],
39
+ code,
40
+ scope: code.some((c) => c.status === "ok") ? REVIEW_SCOPE : REVIEW_SCOPE_RECORDS_ONLY,
41
+ };
42
+ return { ...body, extractedAt: i.extractedAt, extractedUntil: new Date().toISOString(), hash: reviewInputHash(body) };
43
+ }
44
+ const byId = (a, b) => a.localeCompare(b, undefined, { numeric: true });
45
+ /** 比較単位(予定機能。無ければ目的) */
46
+ export function reviewUnits(m) {
47
+ if (m?.goals?.length)
48
+ return m.goals.map((g) => ({ id: g.id, text: g.text }));
49
+ return m?.purpose ? [{ id: PURPOSE_UNIT_ID, text: m.purpose }] : [];
50
+ }
51
+ export function reviewInputOf(ws, mid, extractedAt = new Date().toISOString()) {
52
+ const m = ws.project.milestones.find((x) => x.id === mid);
53
+ const warnings = [];
54
+ if (!m)
55
+ warnings.push({ code: "unknown_milestone", target: mid, message: `マイルストーン ${mid} は project.yaml にありません` });
56
+ else if (!m.purpose && !m.goals?.length) {
57
+ warnings.push({ code: "no_goals", target: mid, message: `マイルストーン ${mid} に目的も予定機能もありません(マイルストーンのタブか p3 milestone purpose / goal add で書けます)` });
58
+ }
59
+ for (const [id, e] of ws.requests.errors) {
60
+ warnings.push({ code: "broken_request", target: `requests/${id}/request.md`, message: `要望のファイルを読めないため、このマイルストーンに属するか分かりません: ${e}` });
61
+ }
62
+ const h = hierarchyNow(ws);
63
+ const members = ws.requests
64
+ .list()
65
+ .filter((r) => r.milestone === mid)
66
+ .sort((a, b) => a.createdAt.localeCompare(b.createdAt) || byId(a.id, b.id));
67
+ const memberIds = new Set(members.map((r) => r.id));
68
+ const requests = [];
69
+ const context = [];
70
+ const addContext = (c) => {
71
+ if (!context.some((x) => x.id === c.id && x.of === c.of && x.relation === c.relation))
72
+ context.push(c);
73
+ };
74
+ for (const r of members) {
75
+ const col = ws.tasksOf(r.id);
76
+ const broken = [...col.errors.keys()].sort(byId);
77
+ for (const t of broken)
78
+ warnings.push({ code: "broken_task", target: `${r.id}/${t}`, message: `${r.id}/${t} のタスクのファイルを読めません(材料から欠けています)` });
79
+ const tasks = [...col.list()].sort((a, b) => byId(a.id, b.id));
80
+ for (const t of tasks) {
81
+ if (t.status === "done" && !t.record?.trim())
82
+ warnings.push({ code: "missing_record", target: t.ref, message: `${t.ref} は完了していますが変更の記録がありません` });
83
+ }
84
+ const kids = h.children(r.id);
85
+ requests.push({
86
+ id: r.id,
87
+ title: r.title,
88
+ status: r.status,
89
+ body: r.body.trim(),
90
+ ...(r.parent ? { parent: r.parent } : {}),
91
+ ...(kids.length ? { children: kids.map((k) => ({ id: k.id, ...(k.milestone ? { milestone: k.milestone } : {}), status: k.status })) } : {}),
92
+ tasks: tasks.map((t) => ({
93
+ id: t.id,
94
+ ref: t.ref,
95
+ title: t.title,
96
+ status: t.status,
97
+ body: t.body.trim(),
98
+ ...(t.record?.trim() ? { record: t.record.trim() } : {}),
99
+ outputs: [...t.outputs, ...(t.repoOutputs ?? []).map((o) => `${o.repo}: ${o.output}`)],
100
+ })),
101
+ });
102
+ const parent = r.parent ? ws.requests.get(r.parent) : undefined;
103
+ if (parent && !memberIds.has(parent.id))
104
+ addContext({ id: parent.id, title: parent.title, status: parent.status, milestone: parent.milestone, relation: "parent", of: r.id });
105
+ for (const k of kids) {
106
+ if (!memberIds.has(k.id))
107
+ addContext({ id: k.id, title: k.title, status: k.status, milestone: k.milestone, relation: "child", of: r.id });
108
+ }
109
+ }
110
+ if (!members.length)
111
+ warnings.push({ code: "no_requests", target: mid, message: `マイルストーン ${mid} に属する要望がありません(判断材料が無いことを記録します)` });
112
+ const milestone = {
113
+ id: mid,
114
+ title: m?.title ?? mid,
115
+ ...(m?.due ? { due: m.due } : {}),
116
+ ...(m?.done ? { done: true } : {}),
117
+ known: !!m,
118
+ ...(m?.purpose ? { purpose: m.purpose } : {}),
119
+ ...(m?.goals?.length ? { goals: m.goals.map((g) => ({ id: g.id, text: g.text })) } : {}),
120
+ };
121
+ const units = reviewUnits(m);
122
+ const body = { milestone, units, requests, context, warnings, scope: REVIEW_SCOPE_RECORDS_ONLY };
123
+ return { ...body, extractedAt, extractedUntil: new Date().toISOString(), hash: reviewInputHash(body) };
124
+ }
125
+ /** 材料の識別子(抽出の日時・警告の文言は含めない) */
126
+ export function reviewInputHash(i) {
127
+ const key = {
128
+ milestone: [i.milestone.id, i.milestone.title, i.milestone.known, i.milestone.purpose ?? null, (i.milestone.goals ?? []).map((g) => [g.id, g.text])],
129
+ requests: i.requests,
130
+ context: i.context.map((c) => [c.id, c.status, c.milestone ?? null, c.relation, c.of]),
131
+ missing: i.warnings.filter((w) => w.code === "broken_request" || w.code === "broken_task").map((w) => w.target),
132
+ // 読んだコード(HEAD・ブランチ・未コミットの変更の中身・コミットが見つかるか)が変われば材料が変わった
133
+ ...(i.code
134
+ ? { code: i.code.map((c) => [c.name, c.status, c.head ?? null, c.branch ?? null, c.dirty ?? 0, c.dirtyDigest ?? null, c.commits.map((x) => [x.sha, x.from, x.found])]) }
135
+ : {}),
136
+ };
137
+ return createHash("sha256").update(JSON.stringify(key)).digest("hex");
138
+ }
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Codex を使わずにレビューの契約(最後の応答の JSON)を再現する(オフライン開発・デモ・テスト用)。評価はせず、比較単位ごとに
3
+ * 「判断材料不足」を返す。--engine mock か個人設定の preflight.engine: mock で明示したときだけ使う(Preflight と同じ)
4
+ */
5
+ export class MockReviewer {
6
+ opts;
7
+ /** 待ち時間(ms。画面で実行中が見えるように少し待つ。テストでは 0) */
8
+ constructor(opts = {}) {
9
+ this.opts = opts;
10
+ }
11
+ async ask(input, log, signal) {
12
+ log({ kind: "info", text: "Mock でレビューします(評価はせず、どの比較単位も判断材料不足にします)" });
13
+ await new Promise((res, rej) => {
14
+ const t = setTimeout(res, this.opts.delayMs ?? 1500);
15
+ signal.addEventListener("abort", () => (clearTimeout(t), rej(new Error("aborted"))), { once: true });
16
+ });
17
+ const json = /<material>\n([\s\S]*?)\n<\/material>/.exec(input.prompt)?.[1];
18
+ const material = JSON.parse(json ?? "{}");
19
+ return {
20
+ message: JSON.stringify({
21
+ overall: `(Mock)評価していません。所属する要望 ${material.requests?.length ?? 0} 件を材料にしました`,
22
+ units: (material.units ?? []).map((u) => ({ unit: u.id, verdict: "insufficient", reason: "(Mock)評価していません", evidence: [], gaps: ["Codex で実行すると評価します"] })),
23
+ }),
24
+ seconds: 0,
25
+ };
26
+ }
27
+ }