@infodb/p3 0.12.0 → 0.14.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 (219) hide show
  1. package/README.md +33 -35
  2. package/bin/p3.mjs +3 -2
  3. package/dist/web/assets/CompletionReview-BD7d6Yzt.js +1 -0
  4. package/dist/web/assets/ImprovementDialog-BoAZN1KR.js +1 -0
  5. package/dist/web/assets/Outputs-D-ZouoxF.js +1 -0
  6. package/dist/web/assets/RequestStatus-Bl3fdSbM.js +1 -0
  7. package/dist/web/assets/Tabs-CxeceOL-.js +1 -0
  8. package/dist/web/assets/TagInput-CeAbmGRR.js +1 -0
  9. package/dist/web/assets/TaskDrawer-BCriSnhe.js +6 -0
  10. package/dist/web/assets/_requestId-CZKMe_mC.js +1 -0
  11. package/dist/web/assets/_requestId-Fx4lLkFo.js +1 -0
  12. package/dist/web/assets/appCtx-BdxbkSZa.js +1 -0
  13. package/dist/web/assets/archive-D5IIxcSV.js +1 -0
  14. package/dist/web/assets/board-p6R9KMqd.js +1 -0
  15. package/dist/web/assets/done-BTOF188x.js +1 -0
  16. package/dist/web/assets/draft-BWYpm3PD.js +2 -0
  17. package/dist/web/assets/index-DFbY8NAR.css +2 -0
  18. package/dist/web/assets/index-Dpqi2dcC.js +12 -0
  19. package/dist/web/assets/link-D481whDt.js +1 -0
  20. package/dist/web/assets/metrics-CAzP6V8I.js +1 -0
  21. package/dist/web/assets/new-C65IJJg3.js +1 -0
  22. package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
  23. package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
  24. package/dist/web/assets/preload-helper-_dAYMct_.js +1 -0
  25. package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
  26. package/dist/web/assets/release-notes-Dtif8xsQ.js +5 -0
  27. package/dist/web/assets/requestData-SPc36t8Q.js +1 -0
  28. package/dist/web/assets/routes-DJj8CWuk.js +6 -0
  29. package/dist/web/assets/settings-DKJd7CLe.js +1 -0
  30. package/dist/web/assets/ui-CbEOnPnF.js +1 -0
  31. package/dist/web/assets/workTarget-DavxMs-c.js +30 -0
  32. package/dist/web/index.html +6 -4
  33. package/docs/architecture.md +430 -72
  34. package/docs/chatgpt-sign-in.md +2 -2
  35. package/docs/development.md +141 -64
  36. package/docs/feature-inventory.md +139 -0
  37. package/docs/how-to-use.md +389 -31
  38. package/docs/installation.md +261 -147
  39. package/docs/publishing.md +33 -14
  40. package/docs/refactoring.md +332 -0
  41. package/lib/cli/agentsStatus.js +198 -0
  42. package/lib/cli/guide.js +27 -0
  43. package/lib/cli/guide.md +217 -0
  44. package/lib/cli/help.js +45 -7
  45. package/lib/cli/main.js +58 -207
  46. package/lib/cli/project.js +34 -294
  47. package/lib/core/projectRegistry.js +2 -2
  48. package/lib/kit/appInfo.js +13 -0
  49. package/lib/kit/usage.js +27 -0
  50. package/lib/server/api/projectsRoutes.js +5 -5
  51. package/lib/server/server.js +7 -4
  52. package/lib/{cli → tasks/cli}/args.js +73 -9
  53. package/lib/{cli → tasks/cli}/chatgpt.js +1 -1
  54. package/lib/{cli → tasks/cli}/codex.js +1 -1
  55. package/lib/{cli → tasks/cli}/output.js +12 -2
  56. package/lib/{cli → tasks/cli}/preflightCommands.js +1 -1
  57. package/lib/tasks/cli/readOnly.js +75 -0
  58. package/lib/{cli → tasks/cli}/render.js +1 -1
  59. package/lib/{cli → tasks/cli}/requestCommands.js +24 -7
  60. package/lib/tasks/cli/showView.js +279 -0
  61. package/lib/{cli → tasks/cli}/taskCommands.js +55 -21
  62. package/lib/tasks/cli/tasksCli.js +149 -0
  63. package/lib/{core → tasks/core}/context.js +6 -9
  64. package/lib/tasks/core/errorOutcome.js +125 -0
  65. package/lib/{core → tasks/core}/hierarchy.js +1 -1
  66. package/lib/{core → tasks/core}/ops.js +17 -2
  67. package/lib/{core → tasks/core}/preflight/carryover.js +5 -1
  68. package/lib/{core → tasks/core}/preflight/codexEngine.js +36 -28
  69. package/lib/{core → tasks/core}/preflight/diagnose.js +4 -9
  70. package/lib/{core → tasks/core}/preflight/engine.js +9 -0
  71. package/lib/tasks/core/preflight/hostPaths.js +299 -0
  72. package/lib/{core → tasks/core}/preflight/input.js +33 -5
  73. package/lib/{core → tasks/core}/preflight/instructions.js +19 -2
  74. package/lib/{core → tasks/core}/preflight/mockEngine.js +27 -8
  75. package/lib/{core → tasks/core}/preflight/render.js +22 -3
  76. package/lib/{core → tasks/core}/preflight/service.js +86 -11
  77. package/lib/{core → tasks/core}/preflight/uiRender.js +5 -2
  78. package/lib/{core → tasks/core}/requestOps.js +214 -17
  79. package/lib/{core → tasks/core}/reviewRuns.js +127 -22
  80. package/lib/{core → tasks/core}/store/attachments.js +3 -2
  81. package/lib/{core → tasks/core}/store/collection.js +21 -2
  82. package/lib/tasks/core/store/fieldGroups.js +30 -0
  83. package/lib/tasks/core/store/jsonRecord.js +30 -0
  84. package/lib/{core → tasks/core}/store/normalize.js +15 -10
  85. package/lib/{core → tasks/core}/store/noteStore.js +2 -2
  86. package/lib/{core → tasks/core}/store/preflightStore.js +59 -22
  87. package/lib/{core → tasks/core}/store/projectFile.js +1 -1
  88. package/lib/{core → tasks/core}/store/workspace.js +28 -6
  89. package/lib/{core → tasks/core}/userConfig.js +1 -1
  90. package/lib/{core → tasks/core}/workTargets.js +1 -1
  91. package/lib/tasks/features/metrics/cli/metricsCommands.js +77 -0
  92. package/lib/tasks/features/metrics/core/definitions.js +445 -0
  93. package/lib/tasks/features/metrics/core/index.js +112 -0
  94. package/lib/tasks/features/metrics/core/manual.js +179 -0
  95. package/lib/tasks/features/metrics/server/metricsRoutes.js +8 -0
  96. package/lib/tasks/features/metrics/shared/metrics.js +42 -0
  97. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/code.js +2 -11
  98. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/material.js +5 -6
  99. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/review.js +2 -2
  100. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/service.js +38 -100
  101. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/store.js +3 -3
  102. package/lib/{server/api → tasks/features/milestoneReview/server}/milestoneReviewRoutes.js +7 -13
  103. package/lib/{cli → tasks/features/quality/cli}/qualityCommands.js +36 -11
  104. package/lib/{core → tasks/features/quality/core}/qualityImprovement.js +16 -15
  105. package/lib/tasks/features/records/cli/revisitCommands.js +73 -0
  106. package/lib/tasks/features/records/core/completionRefs.js +46 -0
  107. package/lib/tasks/features/records/core/reviewCandidates.js +76 -0
  108. package/lib/tasks/features/records/shared/completionRecord.js +329 -0
  109. package/lib/tasks/features/records/shared/reviewCandidate.js +313 -0
  110. package/lib/tasks/features/records/shared/reworkHistory.js +86 -0
  111. package/lib/{cli → tasks/features/releaseNotes/cli}/releaseNotesCommands.js +7 -7
  112. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/completeRequests.js +5 -6
  113. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/generate.js +3 -14
  114. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/material.js +3 -4
  115. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/service.js +1 -1
  116. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/store.js +2 -2
  117. package/lib/{server/api → tasks/features/releaseNotes/server}/releaseNoteRoutes.js +11 -20
  118. package/lib/tasks/features/requirements/cli/requirementCommands.js +289 -0
  119. package/lib/{shared → tasks/features/requirements/shared}/acceptance.js +292 -18
  120. package/lib/tasks/features/requirements/shared/requirementSource.js +635 -0
  121. package/lib/tasks/features/retro/cli/retroCommands.js +106 -0
  122. package/lib/tasks/features/retro/core/retrospective.js +197 -0
  123. package/lib/tasks/features/retro/shared/retrospective.js +286 -0
  124. package/lib/tasks/features/settings/cli/projectSettings.js +245 -0
  125. package/lib/{cli → tasks/features/settings/cli}/userConfig.js +50 -3
  126. package/lib/{core → tasks/features/settings/core}/machineSettingsEdit.js +2 -2
  127. package/lib/{core → tasks/features/settings/core}/repoAdmin.js +3 -3
  128. package/lib/{core → tasks/features/settings/core}/userTheme.js +2 -2
  129. package/lib/{server/api → tasks/features/settings/server}/repoRoutes.js +2 -2
  130. package/lib/{server/api → tasks/features/settings/server}/userThemeRoutes.js +3 -3
  131. package/lib/{cli → tasks/features/taskReview/cli}/taskReviewCommands.js +5 -5
  132. package/lib/{core/taskReview → tasks/features/taskReview/core}/material.js +13 -7
  133. package/lib/{core/taskReview → tasks/features/taskReview/core}/review.js +10 -3
  134. package/lib/{core/taskReview → tasks/features/taskReview/core}/service.js +24 -85
  135. package/lib/{core/taskReview → tasks/features/taskReview/core}/store.js +4 -4
  136. package/lib/{server/api → tasks/features/taskReview/server}/taskReviewRoutes.js +7 -14
  137. package/lib/{server → tasks/server}/api/manifest.js +51 -3
  138. package/lib/{server → tasks/server}/api/routes.js +134 -65
  139. package/lib/tasks/shared/commitRefs.js +10 -0
  140. package/lib/{shared → tasks/shared}/preflightInput.js +1 -1
  141. package/package.json +1 -43
  142. package/skills/p3/SKILL.md +9 -181
  143. package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
  144. package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
  145. package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
  146. package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
  147. package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
  148. package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
  149. package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
  150. package/dist/web/assets/_requestId-BykTgPax.js +0 -1
  151. package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
  152. package/dist/web/assets/archive-Ckh295Xe.js +0 -1
  153. package/dist/web/assets/board-BVAIjK-Y.js +0 -1
  154. package/dist/web/assets/done-BGfA-3MA.js +0 -1
  155. package/dist/web/assets/draft-CfJeyLOl.js +0 -1
  156. package/dist/web/assets/index-CgRU744I.css +0 -2
  157. package/dist/web/assets/index-DacQ0yl4.js +0 -12
  158. package/dist/web/assets/new-DVygWvVc.js +0 -1
  159. package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
  160. package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
  161. package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
  162. package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
  163. package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
  164. package/dist/web/assets/routes-Q91zvNc0.js +0 -4
  165. package/dist/web/assets/settings-BzRgcmUm.js +0 -1
  166. package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
  167. package/lib/cli/readOnly.js +0 -38
  168. package/lib/cli/showView.js +0 -166
  169. /package/lib/{core/store → kit}/frontmatter.js +0 -0
  170. /package/lib/{core/store → kit}/fsutil.js +0 -0
  171. /package/lib/{cli → tasks/cli}/format.js +0 -0
  172. /package/lib/{core → tasks/core}/chatgpt.js +0 -0
  173. /package/lib/{core → tasks/core}/machineSettings.js +0 -0
  174. /package/lib/{core → tasks/core}/preflight/codexImage.js +0 -0
  175. /package/lib/{core → tasks/core}/preflight/docker.js +0 -0
  176. /package/lib/{core → tasks/core}/preflight/launch.js +0 -0
  177. /package/lib/{core → tasks/core}/preflight/launcher.mjs +0 -0
  178. /package/lib/{core → tasks/core}/preflight/mock-ui.html +0 -0
  179. /package/lib/{core → tasks/core}/preflight/mock-ui.png +0 -0
  180. /package/lib/{core → tasks/core}/preflight/owner.js +0 -0
  181. /package/lib/{core → tasks/core}/preflight/render-image/Dockerfile +0 -0
  182. /package/lib/{core → tasks/core}/preflight/render-image/fonts-ja.conf +0 -0
  183. /package/lib/{core → tasks/core}/preflight/render-image/render.mjs +0 -0
  184. /package/lib/{core → tasks/core}/preflight/split.js +0 -0
  185. /package/lib/{core → tasks/core}/preflight/uiMaterials.js +0 -0
  186. /package/lib/{core → tasks/core}/preflight/wireframe.js +0 -0
  187. /package/lib/{core → tasks/core}/preflight/xlsx.js +0 -0
  188. /package/lib/{core → tasks/core}/redact.js +0 -0
  189. /package/lib/{core → tasks/core}/repoRefs.js +0 -0
  190. /package/lib/{core → tasks/core}/requestStatus.js +0 -0
  191. /package/lib/{core → tasks/core}/store/archivedTasks.js +0 -0
  192. /package/lib/{core → tasks/core}/store/dataWatcher.js +0 -0
  193. /package/lib/{core → tasks/core}/store/locate.js +0 -0
  194. /package/lib/{core → tasks/core}/supersede.js +0 -0
  195. /package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/mockReviewer.js +0 -0
  196. /package/lib/{shared → tasks/features/milestoneReview/shared}/milestoneReview.js +0 -0
  197. /package/lib/{core → tasks/features/quality/core}/quality.js +0 -0
  198. /package/lib/{shared → tasks/features/quality/shared}/quality.js +0 -0
  199. /package/lib/{shared → tasks/features/quality/shared}/qualityImprovement.js +0 -0
  200. /package/lib/{shared → tasks/features/quality/shared}/qualityTemplates.js +0 -0
  201. /package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/mockSummarizer.js +0 -0
  202. /package/lib/{core/taskReview → tasks/features/taskReview/core}/mockReviewer.js +0 -0
  203. /package/lib/{core/taskReview → tasks/features/taskReview/core}/paths.js +0 -0
  204. /package/lib/{shared → tasks/features/taskReview/shared}/taskReview.js +0 -0
  205. /package/lib/{server → tasks/server}/api/chatgptRoutes.js +0 -0
  206. /package/lib/{server → tasks/server}/api/local.js +0 -0
  207. /package/lib/{shared → tasks/shared}/dates.js +0 -0
  208. /package/lib/{shared → tasks/shared}/directTask.js +0 -0
  209. /package/lib/{shared → tasks/shared}/hierarchy.js +0 -0
  210. /package/lib/{shared → tasks/shared}/milestoneGoals.js +0 -0
  211. /package/lib/{shared → tasks/shared}/milestoneOrder.js +0 -0
  212. /package/lib/{shared → tasks/shared}/preflightRunner.js +0 -0
  213. /package/lib/{shared → tasks/shared}/refs.js +0 -0
  214. /package/lib/{shared → tasks/shared}/repos.js +0 -0
  215. /package/lib/{shared → tasks/shared}/scopeView.js +0 -0
  216. /package/lib/{shared → tasks/shared}/tags.js +0 -0
  217. /package/lib/{shared → tasks/shared}/taskBlock.js +0 -0
  218. /package/lib/{shared → tasks/shared}/types.js +0 -0
  219. /package/lib/{shared → tasks/shared}/workTarget.js +0 -0
@@ -0,0 +1,86 @@
1
+ /**
2
+ * タスクの手戻りの履歴(済みの解除・完了からの再開)の規則。CLI・API・画面で同じものを使う(保存は core/requestOps.ts の updateTask)。
3
+ *
4
+ * - タスクの reworkHistory に追記だけで持つ。状態と同じ更新(同じ rev)で書く。書く直前に読み直した値と、実際に保存する値(状態・済み)を比べて決める
5
+ * - 1つの操作で済みの外れと再開が同時に起きたら(済みの完了タスクを作業中に戻した)、両方を示す1件にする
6
+ * - 契機(cause): explicit(人・AI が済みを外した)/ acceptance(基準・証拠・基準の根拠の中身が変わって済みが外れた)/ reopen(完了から戻した)
7
+ * - 同じ値の再保存・済みを保ったままの変更・成果物の追記では足さない。再完了・再確認でも以前の履歴は消さない
8
+ * - 主体(by)は保存した変更者(申告。ai:claude / human:<名前>)。ファイルの直接編集からは作らず、過去の分は推し量らない
9
+ * - 直接編集で壊れた履歴は黙って消さず reworkProblems にし、関係のない更新ではファイルの元の値のまま書き戻す(keepRaw)。壊れている間は
10
+ * 新しい履歴を足さない(状態は変え、足せなかったことを知らせる)
11
+ */
12
+ export const REWORK_CAUSES = ["explicit", "acceptance", "reopen"];
13
+ export const REWORK_CAUSE_LABEL = {
14
+ explicit: "済みを外した",
15
+ acceptance: "基準・証拠の変更で済みが外れた",
16
+ reopen: "完了から戻した",
17
+ };
18
+ export const REWORK_KEYS = ["reworkHistory"];
19
+ export const REWORK_ID_RE = /^R\d+$/;
20
+ const str = (v) => (typeof v === "string" && v ? v : undefined);
21
+ const iso = (v) => (v instanceof Date ? v.toISOString() : str(v));
22
+ const isStatus = (v) => v === "todo" || v === "doing" || v === "done";
23
+ const isCause = (v) => typeof v === "string" && REWORK_CAUSES.includes(v);
24
+ function readState(v) {
25
+ const o = v && typeof v === "object" ? v : undefined;
26
+ if (!o || !isStatus(o.status) || typeof o.checked !== "boolean")
27
+ return undefined;
28
+ return { status: o.status, checked: o.checked };
29
+ }
30
+ /** 1 つの更新(rev)に 1 件として数える履歴(直接編集で同じ rev が重なっても 1 件。開発の指標) */
31
+ export function reworkPerRev(list) {
32
+ const seen = new Set();
33
+ return (list ?? []).filter((e) => !seen.has(e.rev) && seen.add(e.rev));
34
+ }
35
+ /** frontmatter の reworkHistory を読む(無ければ何も足さない。古いタスクは移行しない) */
36
+ export function readRework(d) {
37
+ if (d.reworkHistory === undefined || d.reworkHistory === null)
38
+ return {};
39
+ if (!Array.isArray(d.reworkHistory))
40
+ return { reworkProblems: ["reworkHistory が並びになっていません"] };
41
+ const list = [];
42
+ const problems = [];
43
+ for (const [i, raw] of d.reworkHistory.entries()) {
44
+ const o = raw && typeof raw === "object" ? raw : {};
45
+ const id = str(o.id) ?? "";
46
+ const at = `手戻りの履歴 ${i + 1} 件目${id ? `(${id})` : ""}`;
47
+ const from = readState(o.from);
48
+ const to = readState(o.to);
49
+ if (!REWORK_ID_RE.test(id))
50
+ problems.push(`${at} の id が読めません(R1, R2, ...)`);
51
+ else if (list.some((x) => x.id === id))
52
+ problems.push(`手戻りの履歴の id が重複しています: ${id}`);
53
+ else if (!iso(o.at) || !Number.isInteger(o.rev) || !isCause(o.cause) || typeof o.unchecked !== "boolean" || typeof o.reopened !== "boolean" || !from || !to)
54
+ problems.push(`${at} が読めません(at・rev・cause・unchecked・reopened・from・to が要ります)`);
55
+ else
56
+ list.push({ id, at: iso(o.at), ...(str(o.by) ? { by: str(o.by) } : {}), rev: o.rev, cause: o.cause, unchecked: o.unchecked, reopened: o.reopened, from, to });
57
+ }
58
+ return { ...(list.length ? { reworkHistory: list } : {}), ...(problems.length ? { reworkProblems: problems } : {}) };
59
+ }
60
+ /**
61
+ * 書く直前(prev)と保存する値(next)から、足す履歴を決める(無ければ undefined)。
62
+ * explicitUncheck: この操作で済みを外すと明示した / acceptanceChanged: 基準・証拠・基準の根拠の中身が変わった
63
+ */
64
+ export function reworkOf(prev, next, why) {
65
+ const reopened = prev.status === "done" && next.status !== "done";
66
+ const unchecked = !!prev.checkedAt && !next.checkedAt;
67
+ if (!reopened && !unchecked)
68
+ return undefined;
69
+ const cause = reopened ? "reopen" : why.explicitUncheck ? "explicit" : why.acceptanceChanged ? "acceptance" : "explicit";
70
+ return { cause, unchecked, reopened, from: { status: prev.status, checked: !!prev.checkedAt }, to: { status: next.status, checked: !!next.checkedAt } };
71
+ }
72
+ /** 履歴を足した値(壊れた履歴があれば足さずに undefined) */
73
+ export function appendRework(cur, entry) {
74
+ if (cur.reworkProblems?.length)
75
+ return undefined;
76
+ const list = cur.reworkHistory ?? [];
77
+ const n = Math.max(0, ...list.map((e) => Number(e.id.slice(1)))) + 1;
78
+ return [...list, { id: `R${n}`, ...entry }];
79
+ }
80
+ /** 一行の説明(CLI・画面) */
81
+ export function reworkLine(e) {
82
+ const what = [e.reopened ? "完了から戻した" : "", e.unchecked ? (e.cause === "acceptance" ? "基準・証拠の変更で済みが外れた" : "済みが外れた") : ""].filter(Boolean).join("・");
83
+ return `${e.id} ${what}(${e.from.status}${e.from.checked ? "・済み" : ""} → ${e.to.status}${e.to.checked ? "・済み" : ""})`;
84
+ }
85
+ /** 壊れた履歴のため足せなかったときの知らせ */
86
+ export const REWORK_SKIPPED = "手戻りの履歴が読めないため、今回の履歴は残していません(状態は変えました)。ファイルの reworkHistory を直してください";
@@ -1,12 +1,12 @@
1
1
  import { readFile } from "node:fs/promises";
2
2
  import { resolve as resolvePath } from "node:path";
3
- import { exportReleaseNote, releaseNoteDetail, releaseOverview, saveReleaseNote, startGeneration } from "../core/releaseNotes/service.js";
4
- import { readBody } from "./args.js";
5
- import { table } from "./format.js";
6
- import { UsageError } from "./project.js";
7
- import { shellArg } from "./output.js";
8
- import { GenerationRejected } from "../core/releaseNotes/generate.js";
9
- import { completeMilestoneRequests, CompletionRejected } from "../core/releaseNotes/completeRequests.js";
3
+ import { exportReleaseNote, releaseNoteDetail, releaseOverview, saveReleaseNote, startGeneration } from "../core/service.js";
4
+ import { readBody } from "../../../cli/args.js";
5
+ import { table } from "../../../cli/format.js";
6
+ import { UsageError } from "../../../../kit/usage.js";
7
+ import { shellArg } from "../../../cli/output.js";
8
+ import { GenerationRejected } from "../core/generate.js";
9
+ import { completeMilestoneRequests, CompletionRejected } from "../core/completeRequests.js";
10
10
  /**
11
11
  * p3 release-notes ... マイルストーンごとのリリースノート(規則と保存は core/releaseNotes)
12
12
  *
@@ -1,7 +1,7 @@
1
- import { updateRequest } from "../requestOps.js";
2
- import { hierarchyNow, resolveBlocker } from "../requestStatus.js";
3
- import { ConflictError } from "../store/collection.js";
4
- import { Workspace } from "../store/workspace.js";
1
+ import { updateRequest } from "../../../core/requestOps.js";
2
+ import { hierarchyNow, resolveBlocker } from "../../../core/requestStatus.js";
3
+ import { ConflictError } from "../../../core/store/collection.js";
4
+ import { Workspace } from "../../../core/store/workspace.js";
5
5
  import { materialOf } from "./material.js";
6
6
  import { checkMilestoneId, ReleaseNoteError } from "./store.js";
7
7
  /**
@@ -96,8 +96,7 @@ export async function completeMilestoneRequests(ctx, mid, basedOn, actor) {
96
96
  /** ディスクから読み直した状態で、材料と判定を作る。project.yaml に無く、ノートも無いマイルストーンは not_found */
97
97
  async function snapshot(ctx, mid) {
98
98
  checkMilestoneId(mid);
99
- const snap = new Workspace(ctx.ws.dataDir);
100
- await snap.load();
99
+ const snap = await Workspace.snapshot(ctx.ws.dataDir);
101
100
  const material = materialOf(snap, mid);
102
101
  if (!material.milestone.known && !(await ctx.ws.releaseNotes.ids()).includes(mid)) {
103
102
  throw new ReleaseNoteError("not_found", mid, `マイルストーンがありません: ${mid}`);
@@ -1,6 +1,5 @@
1
1
  import { randomBytes } from "node:crypto";
2
- import { CodexUnavailableError, CodexUsageLimitError } from "../preflight/codexEngine.js";
3
- import { ChatGptAuthError } from "../chatgpt.js";
2
+ import { classifyAiFailure, pickReviewer } from "../../../core/reviewRuns.js";
4
3
  import { extractMaterial } from "./material.js";
5
4
  /**
6
5
  * リリースノートの機能の要約を Codex に頼む。保存とは分ける(結果は案で、人が確かめてから保存する)。
@@ -50,8 +49,7 @@ export class ReleaseGenerator {
50
49
  throw new GenerationRejected("running", `${mid} の要約は生成中です(終わるのを待つか取り消してください)`);
51
50
  }
52
51
  const input = summaryInput(material);
53
- const name = engine ?? (await this.opts.engine?.().catch(() => "codex")) ?? "codex";
54
- const summarizer = this.summarizers[name];
52
+ const { name, reviewer: summarizer } = await pickReviewer(this.summarizers, engine, this.opts.engine);
55
53
  if (!summarizer)
56
54
  throw new GenerationRejected("unavailable", `要約を頼む先(${name})がありません`);
57
55
  const job = {
@@ -151,16 +149,7 @@ export class ReleaseGenerator {
151
149
  return job;
152
150
  }
153
151
  }
154
- function classify(e) {
155
- const msg = e?.message ?? String(e);
156
- if (e instanceof CodexUnavailableError || e instanceof ChatGptAuthError)
157
- return ["unavailable", msg];
158
- if (e instanceof CodexUsageLimitError)
159
- return ["usage_limit", msg];
160
- if (e instanceof InvalidSummary)
161
- return ["invalid_output", msg];
162
- return ["error", msg];
163
- }
152
+ const classify = (e) => classifyAiFailure(e, (x) => x instanceof InvalidSummary);
164
153
  /** 結果が使えない(形が違う・出典が材料に無い・長すぎる) */
165
154
  export class InvalidSummary extends Error {
166
155
  }
@@ -1,6 +1,6 @@
1
1
  import { createHash } from "node:crypto";
2
- import { completionCheckOf, hierarchyNow } from "../requestStatus.js";
3
- import { Workspace } from "../store/workspace.js";
2
+ import { completionCheckOf, hierarchyNow } from "../../../core/requestStatus.js";
3
+ import { Workspace } from "../../../core/store/workspace.js";
4
4
  /**
5
5
  * マイルストーンのリリースノートの材料を取り出す。規則はここだけに置く(CLI・API・画面は結果を見せるだけ)。
6
6
  *
@@ -18,8 +18,7 @@ import { Workspace } from "../store/workspace.js";
18
18
  * 抽出のたびにディスクから読み直した別の Workspace を使い、その時点の状態を固定して返す(画面・CLI のキャッシュに左右されない)。
19
19
  */
20
20
  export async function extractMaterial(dataDir, milestone) {
21
- const snap = new Workspace(dataDir);
22
- await snap.load();
21
+ const snap = await Workspace.snapshot(dataDir);
23
22
  return materialOf(snap, milestone);
24
23
  }
25
24
  const byId = (a, b) => a.localeCompare(b, undefined, { numeric: true });
@@ -1,6 +1,6 @@
1
1
  import { extractMaterial } from "./material.js";
2
2
  import { checkMilestoneId, ReleaseNoteError } from "./store.js";
3
- import { compareMilestoneIds, sortMilestones } from "../../shared/milestoneOrder.js";
3
+ import { compareMilestoneIds, sortMilestones } from "../../../shared/milestoneOrder.js";
4
4
  import { completionPlanOf } from "./completeRequests.js";
5
5
  /**
6
6
  * リリースノートの操作(CLI と API はここを呼ぶ)。材料の規則は material.ts、保存の形は store.ts。
@@ -1,8 +1,8 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { readdir, readFile } from "node:fs/promises";
3
3
  import { join, resolve, sep } from "node:path";
4
- import { parseFrontmatter, stringifyFrontmatter } from "../store/frontmatter.js";
5
- import { createExclusive, nowIso, withFileLock, writeFileAtomic } from "../store/fsutil.js";
4
+ import { parseFrontmatter, stringifyFrontmatter } from "../../../../kit/frontmatter.js";
5
+ import { createExclusive, nowIso, withFileLock, writeFileAtomic } from "../../../../kit/fsutil.js";
6
6
  /**
7
7
  * <data>/release-notes/<マイルストーンID>.md リリースノート(マイルストーンごとに1件)
8
8
  *
@@ -1,9 +1,9 @@
1
+ import { apiError } from "../../../core/errorOutcome.js";
1
2
  import { Hono } from "hono";
2
3
  import { z } from "zod";
3
- import { GenerationRejected } from "../../core/releaseNotes/generate.js";
4
- import { exportReleaseNote, releaseNoteDetail, releaseOverview, saveReleaseNote, startGeneration } from "../../core/releaseNotes/service.js";
5
- import { ReleaseNoteError } from "../../core/releaseNotes/store.js";
6
- import { completeMilestoneRequests, CompletionRejected } from "../../core/releaseNotes/completeRequests.js";
4
+ import { exportReleaseNote, releaseNoteDetail, releaseOverview, saveReleaseNote, startGeneration } from "../core/service.js";
5
+ import { ReleaseNoteError } from "../core/store.js";
6
+ import { completeMilestoneRequests } from "../core/completeRequests.js";
7
7
  /**
8
8
  * リリースノート(画面のため)。規則と保存は core/releaseNotes(CLI の p3 release-notes と同じ)。
9
9
  *
@@ -29,25 +29,16 @@ const saveInput = z.object({
29
29
  const actorOf = (c) => c.req.header("x-p3-actor") ?? "human:web";
30
30
  export function releaseNoteRoutes(ctx) {
31
31
  const app = new Hono();
32
+ // エラーの状態と code は core/errorOutcome.ts の表。版の競合・既にあるときは今のノート(読めれば)を添える(画面は入力を残したまま見比べる)
32
33
  app.onError(async (err, c) => {
33
- if (err instanceof ReleaseNoteError) {
34
- const mid = err.milestone;
35
- if (err.code === "not_found")
36
- return c.json({ error: err.message, code: "not_found" }, 404);
37
- if (err.code === "bad_id")
38
- return c.json({ error: err.message, code: "bad_id" }, 400);
39
- if (err.code === "invalid")
40
- return c.json({ error: err.message, code: "invalid" }, 422);
41
- // 版の競合・既にある: 今のノート(読めれば)を添える。画面は入力を残したまま見比べる
42
- const current = await ctx.ws.releaseNotes.read(mid).catch(() => null);
43
- return c.json({ error: err.message, code: "rev_conflict", reason: err.code, current }, 409);
44
- }
45
- if (err instanceof CompletionRejected)
46
- return c.json({ error: err.message, code: err.code, plan: err.plan }, 409);
47
- if (err instanceof GenerationRejected)
48
- return c.json({ error: err.message, code: err.code }, err.code === "running" ? 409 : 400);
49
34
  if (err instanceof z.ZodError)
50
35
  return c.json({ error: "invalid input", issues: err.issues }, 400);
36
+ const r = apiError(err);
37
+ if (r) {
38
+ if (err instanceof ReleaseNoteError && (err.code === "conflict" || err.code === "exists"))
39
+ r.body.current = await ctx.ws.releaseNotes.read(err.milestone).catch(() => null);
40
+ return c.json(r.body, r.status);
41
+ }
51
42
  console.error(err);
52
43
  return c.json({ error: err.message }, 400);
53
44
  });
@@ -0,0 +1,289 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { resolve as resolvePath } from "node:path";
3
+ import { ANSWER_STATE_LABEL, clarificationStates, criteriaSourceView, requestRequirementView, RequirementInputError, SOURCE_STATE_LABEL, } from "../shared/requirementSource.js";
4
+ import { resolveRequestId } from "../../../core/ops.js";
5
+ import { saveClarifyAnswer, updateRequirement, updateTask } from "../../../core/requestOps.js";
6
+ import { NotFoundError } from "../../../core/store/collection.js";
7
+ import { pickRun } from "../../../cli/preflightCommands.js";
8
+ import { UsageError } from "../../../../kit/usage.js";
9
+ import { formatRequirement, sourceLines } from "../../../cli/showView.js";
10
+ /**
11
+ * 要求の根拠(出典・確かめた人・日・根拠)と、Preflight の確認事項への回答のコマンド(規則は shared/requirementSource.ts)。
12
+ *
13
+ * source [<要望>] [ls] 要望の根拠の記録と状態(回答も)
14
+ * source [<要望>] add|edit <S>|confirm <S>|rm <S> 要望の根拠の記録を変える
15
+ * source <T001|D1> [<基準>] [add|edit|confirm|rm] 受け入れ基準ごとの記録(D1 はタスク案。--run で run、省くと最新)
16
+ * source <対象> --sources-json ops.json|- 操作をまとめて当てる(複数行の根拠はこちら)
17
+ * clarify [<要望>] [--run <run>] 確認事項(確認先・質問・必要な根拠・判断への影響)と回答の状態
18
+ * answer [<要望>] <Q> --body 回答|- [...] 確認事項に回答する(要望に残す。過去の run は書き換えない)
19
+ * answer [<要望>] <Q> rm 回答を消す
20
+ */
21
+ /** source の操作の語(対象・基準の ID と見分ける。読むだけの判定 readOnly.ts も使う) */
22
+ export const SOURCE_SUBS = new Set(["ls", "show", "add", "edit", "set", "confirm", "rm", "remove"]);
23
+ /** 標準入力(-)は1つの項目にだけ */
24
+ function readText(v, flag, used) {
25
+ if (v === undefined)
26
+ return undefined;
27
+ if (v !== "-")
28
+ return v;
29
+ if (used.stdin)
30
+ throw new UsageError(`標準入力(-)は ${used.stdin} と ${flag} のどちらか一方だけに使えます(もう一方はファイルか文字で渡してください)`);
31
+ used.stdin = flag;
32
+ return readFileSync(0, "utf8");
33
+ }
34
+ function readJsonFile(file, flag) {
35
+ let src;
36
+ try {
37
+ src = file === "-" ? readFileSync(0, "utf8") : readFileSync(resolvePath(process.cwd(), file), "utf8");
38
+ }
39
+ catch {
40
+ throw new UsageError(`${flag} のファイルが読めません: ${file}`);
41
+ }
42
+ try {
43
+ return JSON.parse(src);
44
+ }
45
+ catch (e) {
46
+ throw new UsageError(`${flag} が JSON として読めません: ${e.message}`);
47
+ }
48
+ }
49
+ function formatCriteriaSources(head, v, problems = []) {
50
+ const lines = [head];
51
+ if (!v.items.length)
52
+ lines.push(" 受け入れ基準なし");
53
+ for (const i of v.items) {
54
+ lines.push(` ${i.id} [${SOURCE_STATE_LABEL[i.state]}] ${i.text}`);
55
+ for (const s of i.sources)
56
+ lines.push(...sourceLines(s, " "));
57
+ }
58
+ if (v.orphans.length) {
59
+ lines.push(" 対応先不明(基準を消した・参照元が無い):");
60
+ for (const s of v.orphans)
61
+ lines.push(...sourceLines(s, " ").map((l, n) => (n ? l : `${l} 基準 ${s.criterionId}`)));
62
+ }
63
+ for (const p of problems)
64
+ lines.push(` ※読めない: ${p}`);
65
+ return lines.join("\n");
66
+ }
67
+ /** フラグから1つの操作を作る */
68
+ function sourceOpFromFlags(env, sub, id) {
69
+ const { o } = env;
70
+ const used = {};
71
+ const fields = {
72
+ ...(o.target?.length ? { target: o.target.join(" ") } : {}),
73
+ ...(o.source !== undefined ? { source: o.source } : {}),
74
+ ...(o.grounds !== undefined ? { basis: readText(o.grounds, "--grounds", used) } : {}),
75
+ };
76
+ const confirm = o.by !== undefined || o.on !== undefined ? { by: o.by ?? "", on: o.on ?? "" } : undefined;
77
+ const needId = () => {
78
+ if (!id)
79
+ throw new UsageError(`使い方: p3 source ... ${sub} <S1>`);
80
+ return id;
81
+ };
82
+ switch (sub) {
83
+ case "add":
84
+ return { op: "add", ...fields, ...(o.from ? { from: o.from } : {}), ...(confirm ? { confirm } : {}) };
85
+ case "edit":
86
+ case "set":
87
+ return { op: "edit", id: needId(), ...fields, ...(confirm ? { confirm } : {}) };
88
+ case "confirm":
89
+ if (!confirm)
90
+ throw new UsageError("使い方: p3 source ... confirm <S1> --by <確かめた役割・アクター> --on YYYY-MM-DD");
91
+ return { op: "confirm", id: needId(), ...confirm };
92
+ case "rm":
93
+ case "remove":
94
+ return { op: "remove", id: needId() };
95
+ }
96
+ throw new UsageError(`source の操作は add / edit / confirm / rm です: ${sub}`);
97
+ }
98
+ export async function requirementCommand(cmd, env) {
99
+ switch (cmd) {
100
+ case "source":
101
+ case "sources":
102
+ return sourceCommand(env);
103
+ case "clarify":
104
+ return clarifyCommand(env);
105
+ case "answer":
106
+ return answerCommand(env);
107
+ }
108
+ return undefined;
109
+ }
110
+ async function sourceCommand(env) {
111
+ const { args } = env;
112
+ const head = args[0];
113
+ if (head && /^(?:([^/]+)\/)?D\d+$/i.test(head))
114
+ return criterionSources(env, "draft");
115
+ if (head && /^(?:[^/]+\/)?T\d+$/i.test(head))
116
+ return criterionSources(env, "task");
117
+ return requestSources(env);
118
+ }
119
+ async function requestSources(env) {
120
+ const { ctx, out, args, o, actor, expectedRev, requestArg } = env;
121
+ const rid = args[0] && !SOURCE_SUBS.has(args[0]) ? requestArg(args[0]) : requestArg(undefined);
122
+ const rest = args[0] && !SOURCE_SUBS.has(args[0]) ? args.slice(1) : args;
123
+ const [sub, id] = rest;
124
+ const view = () => requestRequirementView(ctx.ws.requests.require(rid));
125
+ const show = () => [`${rid} ${ctx.ws.requests.require(rid).title}`, ...formatRequirement(view())].join("\n");
126
+ const json = o["sources-json"];
127
+ if (json === undefined && (sub === undefined || sub === "ls" || sub === "show"))
128
+ return out.result({ request: rid, ...view() }, show);
129
+ let ops;
130
+ if (json !== undefined) {
131
+ if (sub !== undefined)
132
+ throw new UsageError("--sources-json と add / edit などの操作は一緒に使えません");
133
+ const raw = readJsonFile(json, "--sources-json");
134
+ if (!Array.isArray(raw))
135
+ throw new UsageError("--sources-json は操作の並び([{\"op\":\"add\",...}])です");
136
+ ops = raw;
137
+ }
138
+ else
139
+ ops = [sourceOpFromFlags(env, sub, id)];
140
+ const r = await updateRequirement(ctx, rid, ops, { expectedRev, actor });
141
+ return out.result({ request: rid, rev: r.rev, ...requestRequirementView(r) }, () => [`更新: ${rid} (rev ${r.rev})`, ...formatRequirement(requestRequirementView(r))].join("\n"));
142
+ }
143
+ async function criterionSources(env, kind) {
144
+ const { ctx, out, args, o, actor, expectedRev, taskArg, requestArg } = env;
145
+ const [target, ...after] = args;
146
+ // 基準の ID(A1)は省ける(一覧だけ)
147
+ const criterion = after[0] && !SOURCE_SUBS.has(after[0]) ? after[0] : undefined;
148
+ const [sub, id] = criterion ? after.slice(1) : after;
149
+ const json = o["sources-json"];
150
+ const listOnly = json === undefined && (sub === undefined || sub === "ls" || sub === "show");
151
+ let ops = [];
152
+ if (!listOnly) {
153
+ if (json !== undefined) {
154
+ if (sub !== undefined)
155
+ throw new UsageError("--sources-json と add / edit などの操作は一緒に使えません");
156
+ const raw = readJsonFile(json, "--sources-json");
157
+ if (!Array.isArray(raw))
158
+ throw new UsageError("--sources-json は操作の並び([{\"criterion\":\"A1\",\"op\":\"add\",...}])です");
159
+ ops = raw.map((x, i) => {
160
+ const { criterion: c, ...op } = (x && typeof x === "object" ? x : {});
161
+ const cid = c ?? criterion;
162
+ if (!cid)
163
+ throw new UsageError(`--sources-json の ${i + 1} 件目に基準の ID(criterion)がありません`);
164
+ return { id: cid, source: op };
165
+ });
166
+ }
167
+ else {
168
+ if (!criterion)
169
+ throw new UsageError(`使い方: p3 source ${target} <基準の ID> ${sub} ...`);
170
+ ops = [{ id: criterion, source: sourceOpFromFlags(env, sub, id) }];
171
+ }
172
+ }
173
+ if (kind === "task") {
174
+ const ref = taskArg(target);
175
+ const rid = ref.split("/")[0];
176
+ const reqIds = () => (ctx.ws.requests.get(rid)?.requirementSources ?? []).map((s) => s.id);
177
+ const render = (t) => criteriaSourceView(t.acceptanceCriteria, t.acceptanceSources, reqIds());
178
+ if (listOnly) {
179
+ const t = ctx.ws.requireTask(ref);
180
+ const v = render(t);
181
+ return out.result({ ref: t.ref, rev: t.rev, ...v, problems: t.acceptanceProblems ?? [] }, () => formatCriteriaSources(`${t.ref} ${t.title} の基準ごとの出典と確認`, v, t.acceptanceProblems));
182
+ }
183
+ const acceptance = ops.map((x) => ({ op: "source", id: x.id, source: x.source }));
184
+ const r = await updateTask(ctx, rid, ref.split("/")[1], { acceptance }, { expectedRev, actor });
185
+ if (r.checkCleared)
186
+ process.stderr.write(`${r.checkCleared}\n`);
187
+ const v = render(r.task);
188
+ return out.result({ ref: r.task.ref, rev: r.task.rev, ...v, ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => formatCriteriaSources(`更新: ${r.task.ref} (rev ${r.task.rev})`, v));
189
+ }
190
+ // タスク案
191
+ const m = /^(?:([^/]+)\/)?(D\d+)$/i.exec(target);
192
+ const rid = m[1] ? resolveRequestId(ctx, m[1]) : requestArg(undefined);
193
+ if (!rid)
194
+ throw new NotFoundError(m[1] ?? "要望");
195
+ const key = m[2].toUpperCase();
196
+ const run = await pickRun(ctx, rid, o.run);
197
+ const d = run.drafts.find((x) => x.key === key);
198
+ if (!d)
199
+ throw new NotFoundError(`${run.id}/${key}`);
200
+ const reqIds = (ctx.ws.requests.get(rid)?.requirementSources ?? []).map((s) => s.id);
201
+ const head = (x) => `${rid} / ${run.id} / ${x.key} ${x.title} の基準ごとの出典と確認`;
202
+ if (listOnly) {
203
+ const v = criteriaSourceView(d.acceptanceCriteria, d.acceptanceSources, reqIds);
204
+ return out.result({ request: rid, run: run.id, key, ...v, problems: d.acceptanceProblems ?? [] }, () => formatCriteriaSources(head(d), v, d.acceptanceProblems));
205
+ }
206
+ if (run.materialized?.length || run.children)
207
+ throw new UsageError(`${run.id} はタスク化済みか子の要望の案の run です(タスクの記録は p3 source <T>)`);
208
+ const saved = await ctx.preflight.updateDraft(rid, run.id, key, { sourceOps: ops }, { expectedSources: d.acceptanceSources ?? [], actor });
209
+ const v = criteriaSourceView(saved.acceptanceCriteria, saved.acceptanceSources, reqIds);
210
+ return out.result({ request: rid, run: run.id, key, ...v, problems: saved.acceptanceProblems ?? [] }, () => formatCriteriaSources(head(saved), v, saved.acceptanceProblems));
211
+ }
212
+ /** 要望と run の確認事項(構造化した確認事項が無い以前の run は文の確認事項だけ) */
213
+ async function runClarifications(env, raw) {
214
+ const { ctx, o, requestArg } = env;
215
+ const rid = requestArg(raw);
216
+ const run = await pickRun(ctx, rid, o.run);
217
+ return { rid, run, clarifications: run.assessment?.clarifications ?? [] };
218
+ }
219
+ async function clarifyCommand(env) {
220
+ const { ctx, out, args } = env;
221
+ if (args.length > 1)
222
+ throw new UsageError("使い方: p3 clarify [<要望>] [--run <run>]");
223
+ const { rid, run, clarifications } = await runClarifications(env, args[0]);
224
+ const r = ctx.ws.requests.require(rid);
225
+ const items = clarificationStates(run.id, clarifications, r.clarifyAnswers, r.requirementSources);
226
+ const questions = run.assessment?.questions ?? [];
227
+ const problems = run.assessment?.clarificationProblems ?? [];
228
+ return out.result({ request: rid, run: run.id, verdict: run.assessment?.verdict ?? null, items, questions, problems }, () => {
229
+ const lines = [`${rid} / ${run.id} 判定 ${run.assessment?.verdict ?? "(評価なし)"}`];
230
+ if (!items.length)
231
+ lines.push("構造化した確認事項はありません(以前の run か、確認事項なし)");
232
+ for (const i of items) {
233
+ const q = i.clarification;
234
+ lines.push(` ${q.id} [${ANSWER_STATE_LABEL[i.state]}] ${q.question}`, ` 確認先: ${q.ask}`, ` 対象: ${q.target}`, ...(q.needed ? [` 必要な根拠: ${q.needed}`] : []), ...(q.impact ? [` 判断への影響: ${q.impact}`] : []), ...(i.answer ? [` 回答${i.answer.by || i.answer.on ? `(${[i.answer.by, i.answer.on].filter(Boolean).join("・")})` : ""}: ${i.answer.answer.split("\n").join("\n ")}`] : []));
235
+ }
236
+ if (questions.length)
237
+ lines.push("確認事項(文):", ...questions.map((x) => ` - ${x}`));
238
+ for (const p of problems)
239
+ lines.push(` ※読めない確認事項: ${p}`);
240
+ if (items.length)
241
+ lines.push(`回答: p3 answer ${rid} <Q> --body <回答> [--by <役割> --on YYYY-MM-DD --source <出典> --grounds <根拠> --link <S1>] --run ${run.id}`);
242
+ lines.push(`回答を保存したら、明示して再評価します: p3 preflight ${rid}`);
243
+ return lines.join("\n");
244
+ });
245
+ }
246
+ async function answerCommand(env) {
247
+ const { ctx, out, args, o, actor, expectedRev } = env;
248
+ // answer [<要望>] <Q> [rm]
249
+ const looksQ = (x) => !!x && /^[A-Za-z0-9._-]{1,32}$/.test(x) && !resolveRequestId(ctx, x);
250
+ const [a0, a1, a2] = args;
251
+ const [rawRid, qid, tail] = looksQ(a0) ? [undefined, a0, a1] : [a0, a1, a2];
252
+ if (!qid)
253
+ throw new UsageError("使い方: p3 answer [<要望>] <Q1> --body 回答|- [--by <役割> --on YYYY-MM-DD --source <出典> --grounds <根拠> --link <S1>] [--run <run>]");
254
+ const { rid, run, clarifications } = await runClarifications(env, rawRid);
255
+ const q = clarifications.find((x) => x.id === qid);
256
+ if (!q)
257
+ throw new UsageError(`${run.id} に確認事項 ${qid} はありません${clarifications.length ? `(${clarifications.map((x) => x.id).join(", ")})` : "(構造化した確認事項がありません。以前の run の文の確認事項にはメモで答えます: p3 note)"}`);
258
+ if (tail === "rm" || tail === "remove") {
259
+ const r = await saveClarifyAnswer(ctx, rid, run.id, q, null, { expectedRev, actor });
260
+ return out.result({ request: rid, rev: r.request.rev, run: run.id, question: q.id, removed: true }, () => `回答を消しました: ${rid} ${run.id}/${q.id}`);
261
+ }
262
+ if (tail !== undefined)
263
+ throw new UsageError(`answer の操作は rm だけです: ${tail}`);
264
+ let input;
265
+ if (o["answer-json"] !== undefined) {
266
+ if (o.body !== undefined || o.grounds !== undefined)
267
+ throw new UsageError("--answer-json と --body / --grounds は一緒に使えません");
268
+ const raw = readJsonFile(o["answer-json"], "--answer-json");
269
+ if (!raw || typeof raw !== "object" || Array.isArray(raw))
270
+ throw new UsageError("--answer-json は {\"answer\": ..., \"by\": ..., \"on\": ..., \"source\": ..., \"basis\": ..., \"links\": [...]} の形です");
271
+ input = raw;
272
+ }
273
+ else {
274
+ const used = {};
275
+ const answer = readText(o.body, "--body", used);
276
+ if (answer === undefined)
277
+ throw new UsageError("回答を --body で書いてください(複数行は --body - か --answer-json)");
278
+ input = { answer, by: o.by, on: o.on, source: o.source, basis: readText(o.grounds, "--grounds", used), links: o.link };
279
+ }
280
+ try {
281
+ const r = await saveClarifyAnswer(ctx, rid, run.id, q, input, { expectedRev, actor });
282
+ return out.result({ request: rid, rev: r.request.rev, run: run.id, question: q.id, answer: r.answer ?? null }, () => [`回答を要望に残しました: ${rid} ${run.id}/${q.id}(rev ${r.request.rev})`, "回答だけでは根拠の記録を「確認記録あり」にしません(確認は p3 source ... confirm)", `今の内容で評価し直すなら: p3 preflight ${rid}`].join("\n"));
283
+ }
284
+ catch (e) {
285
+ if (e instanceof RequirementInputError)
286
+ throw new UsageError(e.message);
287
+ throw e;
288
+ }
289
+ }