@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
@@ -1,9 +1,11 @@
1
+ import { ASK_UNKNOWN } from "../../features/requirements/shared/requirementSource.js";
1
2
  import { writableRepos } from "../../shared/workTarget.js";
2
3
  import { mkdir, readFile, writeFile } from "node:fs/promises";
3
4
  import { join, relative } from "node:path";
4
5
  import { SPLIT_HINT_TASKS } from "../../shared/hierarchy.js";
5
- import { stringifyFrontmatter } from "../store/frontmatter.js";
6
- import { writeFileAtomic } from "../store/fsutil.js";
6
+ import { stringifyFrontmatter } from "../../../kit/frontmatter.js";
7
+ import { writeFileAtomic } from "../../../kit/fsutil.js";
8
+ import { writeJsonRecord } from "../store/jsonRecord.js";
7
9
  const wait = (ms, signal) => new Promise((res, rej) => {
8
10
  const t = setTimeout(res, ms);
9
11
  signal.addEventListener("abort", () => (clearTimeout(t), rej(new Error("aborted"))), { once: true });
@@ -89,16 +91,33 @@ export class MockEngine {
89
91
  })
90
92
  : [];
91
93
  const clarity = Math.min(100, 40 + (request.body.length + notes.reduce((n, x) => n + x.body.length, 0)) / 8);
94
+ // 確認事項への回答(要望の clarifyAnswers)もメモと同じく、確認が済んだものとして扱う
95
+ const answered = notes.length > 0 || (request.clarifyAnswers?.length ?? 0) > 0;
96
+ const unclear = clarity < 55 && !answered;
92
97
  const carried = [previous && `前回 ${previous.id} を引き継ぎ`, notes.length && `メモ ${notes.length} 件を反映`].filter(Boolean).join("、");
93
98
  const assessment = {
94
99
  summary: split
95
100
  ? `「${request.title}」は想定 ${items.length} 件のタスクになるので、${children.length} 件の子の要望に分けます。${carried ? `${carried}しました。` : ""}(mock による推定)`
96
101
  : `「${request.title}」を ${drafts.length} 件のタスクに分割しました。${carried ? `${carried}しました。` : ""}(mock による推定)`,
97
- verdict: clarity < 55 && !notes.length ? "clarify" : "go",
102
+ verdict: unclear ? "clarify" : "go",
98
103
  validity: { score: Math.round(clarity), reasons: ["mock: 本文の具体性から推定"] },
99
104
  feasibility: { score: 80, reasons: ["mock: 固定の値"] },
100
105
  risks: [],
101
- questions: clarity < 55 && !notes.length ? ["完了条件をより具体的にしてください"] : [],
106
+ questions: unclear ? ["完了条件をより具体的にしてください"] : [],
107
+ ...(unclear
108
+ ? {
109
+ clarifications: [
110
+ {
111
+ id: "Q1",
112
+ target: "要望の完了条件",
113
+ ask: ASK_UNKNOWN,
114
+ question: "完了条件をより具体的にしてください",
115
+ needed: "完了したと確かめられる条件(業務の担当が承認した例など)",
116
+ impact: "完了条件が決まらないと受け入れ基準を書けません(mock による推定)",
117
+ },
118
+ ],
119
+ }
120
+ : {}),
102
121
  areas,
103
122
  // Mock は参照先を読まないので、根拠はすべて推測
104
123
  evidence: [{ claim: "mock: 要望の本文の箇条書きからタスク案を作った(コードは読んでいない)", kind: "assumed" }],
@@ -108,14 +127,14 @@ export class MockEngine {
108
127
  reasons: [split ? `mock: 箇条書きが ${SPLIT_HINT_TASKS} 件以上` : `mock: 箇条書きが ${SPLIT_HINT_TASKS} 件未満`],
109
128
  },
110
129
  };
111
- await writeFileAtomic(join(job.runDir, "assessment.json"), JSON.stringify(assessment, null, 2) + "\n");
130
+ await writeJsonRecord(join(job.runDir, "assessment.json"), assessment);
112
131
  if (split) {
113
132
  for (const c of children) {
114
133
  const { description, ...meta } = c;
115
134
  await writeFileAtomic(join(job.runDir, "children", `${c.key}.md`), stringifyFrontmatter(meta, description));
116
135
  log({ kind: "info", text: `✎ ${relative(job.dataDir, join(job.runDir, "children", `${c.key}.md`))}` });
117
136
  }
118
- await writeFileAtomic(join(job.runDir, "ui", "index.json"), JSON.stringify({ needed: false, reason: "mock: 子の要望に分けたので、画面イメージは子の Preflight で作ります" }, null, 2) + "\n");
137
+ await writeJsonRecord(join(job.runDir, "ui", "index.json"), { needed: false, reason: "mock: 子の要望に分けたので、画面イメージは子の Preflight で作ります" });
119
138
  log({ kind: "message", text: assessment.summary });
120
139
  return { changed: [join(job.runDir, "assessment.json"), ...children.map((c) => join(job.runDir, "children", `${c.key}.md`)), join(job.runDir, "ui", "index.json")] };
121
140
  }
@@ -143,7 +162,7 @@ async function writeMockUi(job, drafts) {
143
162
  const ui = join(job.runDir, "ui");
144
163
  const r = job.request;
145
164
  if (!drafts.length || !UI_WORDS.test(`${r.title}\n${r.body}`)) {
146
- await writeFileAtomic(join(ui, "index.json"), JSON.stringify({ needed: false, reason: "mock: 要望に画面に関わる語が無いので、画面を伴わない変更とみなしました" }, null, 2) + "\n");
165
+ await writeJsonRecord(join(ui, "index.json"), { needed: false, reason: "mock: 要望に画面に関わる語が無いので、画面を伴わない変更とみなしました" });
147
166
  return [];
148
167
  }
149
168
  const target = drafts[0].key;
@@ -166,7 +185,7 @@ async function writeMockUi(job, drafts) {
166
185
  },
167
186
  ],
168
187
  };
169
- await writeFileAtomic(join(ui, "index.json"), JSON.stringify(index, null, 2) + "\n");
188
+ await writeJsonRecord(join(ui, "index.json"), index);
170
189
  return [join(ui, "U1.png"), join(ui, "src", "U1.html"), join(ui, "index.json")];
171
190
  }
172
191
  const MOCK_HTML = new URL("./mock-ui.html", import.meta.url);
@@ -5,6 +5,8 @@ import { join } from "node:path";
5
5
  import { fileURLToPath } from "node:url";
6
6
  import { promisify } from "node:util";
7
7
  import { mapPath, pathMapHowTo } from "./diagnose.js";
8
+ import { DockerAbortError } from "./docker.js";
9
+ import { PATHS_CHECK, resolveHostPaths, unresolvedMessage } from "./hostPaths.js";
8
10
  const exec = promisify(execFile);
9
11
  /**
10
12
  * 画面イメージの描画(自己完結した HTML / CSS → PNG)。
@@ -213,8 +215,25 @@ export async function renderHtml(jobs, workDir, outDir, opts = {}) {
213
215
  for (const j of ok)
214
216
  await writeFile(join(tmp, "in", `${j.id}.html`), j.html);
215
217
  await writeFile(join(tmp, "in", "jobs.json"), JSON.stringify(ok.map((j) => ({ id: j.id, file: `${j.id}.html`, width: j.width }))));
216
- const host = (p) => mapPath(opts.pathMap ?? [], p).host;
217
- const args = renderArgs({ image, name, hostIn: host(join(tmp, "in")), hostOut: host(join(tmp, "out")) });
218
+ // 実際にマウントする一時の in / out を、描画のコンテナを起こす前に決める(1つでも決まらなければ起こさない)
219
+ let paths;
220
+ try {
221
+ paths = await resolveHostPaths([join(tmp, "in"), join(tmp, "out")], { pathMap: opts.pathMap ?? [], docker, signal: opts.signal, probe: opts.hostProbe });
222
+ }
223
+ catch (e) {
224
+ if (e instanceof DockerAbortError)
225
+ throw new RenderError("描画を取り消しました", "cancel");
226
+ throw e;
227
+ }
228
+ if (!paths.ok) {
229
+ const items = [
230
+ { label: "描画の原稿", result: paths.paths[0] },
231
+ { label: "描画の出力", result: paths.paths[1] },
232
+ ];
233
+ throw new RenderError(unresolvedMessage("描画", items), "paths");
234
+ }
235
+ const [hostIn, hostOut] = paths.paths.map((p) => (p.ok ? p.host : ""));
236
+ const args = renderArgs({ image, name, hostIn, hostOut });
218
237
  opts.onProgress?.(`${ok.length} 枚を描画します`);
219
238
  const timeoutMs = RENDER_LIMITS.baseTimeoutMs + ok.length * RENDER_LIMITS.perPageTimeoutMs;
220
239
  const out = await runProcess(docker, args, { timeoutMs, signal: opts.signal, onStop: () => exec(docker, ["kill", name]).catch(() => { }) });
@@ -260,7 +279,7 @@ export function diagnoseRender(stderr, pathMap, workDir) {
260
279
  if (/bind source path does not exist|invalid mount config|not a directory|no such file or directory/i.test(stderr)) {
261
280
  const m = workDir ? mapPath(pathMap, workDir) : undefined;
262
281
  return [
263
- `描画のコンテナに原稿のフォルダをマウントできません(${last})。DevContainer の中から使うときは、パスの対応(codex.pathMap)が要ります`,
282
+ `描画のコンテナに原稿のフォルダをマウントできません(${last})。Docker のホストから見たパスが違います(このマシンで ${PATHS_CHECK} で確かめられます)`,
264
283
  ...pathMapHowTo(m && { label: "描画", local: workDir, host: m.host, rule: m.rule, container: "/in" }),
265
284
  ].join("\n");
266
285
  }
@@ -4,9 +4,10 @@ import { isAbsolute, join, relative } from "node:path";
4
4
  import { createHash, randomBytes } from "node:crypto";
5
5
  import {} from "../../shared/types.js";
6
6
  import { normalizeTaskId, REQUEST_ID } from "../../shared/refs.js";
7
- import { AcceptanceInputError, applyAcceptanceOps, criteriaForTask, sameCriteria, tidyDraftCriteria } from "../../shared/acceptance.js";
8
- import { qualityCriteria, qualitySnapshot } from "../../shared/quality.js";
9
- import { newRequestId, nowIso, withFileLock, writeFileAtomic } from "../store/fsutil.js";
7
+ import { AcceptanceInputError, applyAcceptanceOps, applyDraftSourceOps, criteriaForTask, readDraftCriteria, readSourceSeq, sameCriteria, sameSources, settleDraftSources, tidyDraftCriteria } from "../../features/requirements/shared/acceptance.js";
8
+ import { readClarifications, readCriterionSources, RequirementInputError, requirementInputOf } from "../../features/requirements/shared/requirementSource.js";
9
+ import { qualityCriteria, qualitySnapshot } from "../../features/quality/shared/quality.js";
10
+ import { newRequestId, nowIso, withFileLock, writeFileAtomic } from "../../../kit/fsutil.js";
10
11
  import { ConflictError, NotFoundError } from "../store/collection.js";
11
12
  import { supersedeCandidates } from "../supersede.js";
12
13
  import { hierarchyNow, reopenAncestors } from "../requestStatus.js";
@@ -39,7 +40,11 @@ export class PreflightBusyError extends Error {
39
40
  export class DraftConflictError extends Error {
40
41
  current;
41
42
  constructor(current, what = "title") {
42
- super(what === "title" ? `${current.key} の題が他で変わりました(今の題: ${current.title})` : `${current.key} の受け入れ基準が他で変わりました(読み直してから直してください)`);
43
+ super(what === "title"
44
+ ? `${current.key} の題が他で変わりました(今の題: ${current.title})`
45
+ : what === "criteria"
46
+ ? `${current.key} の受け入れ基準が他で変わりました(読み直してから直してください)`
47
+ : `${current.key} の基準の出典と確認が他で変わりました(読み直してから直してください)`);
43
48
  this.current = current;
44
49
  }
45
50
  }
@@ -217,7 +222,15 @@ export class PreflightService {
217
222
  throw new LocalResultError(problems);
218
223
  }
219
224
  // 画面イメージ: 原稿があるときだけ描画のコンテナを使う。描けなくても評価は残す(取り込みで不足として扱う)
220
- await renderManuscripts(runDir, { pathMap: await this.renderOpts.pathMap().catch(() => []), log: (e) => this.log(run, e), render: this.renderOpts.render });
225
+ let pathMap;
226
+ let settingsError;
227
+ try {
228
+ pathMap = await this.renderOpts.pathMap();
229
+ }
230
+ catch (e) {
231
+ settingsError = hideConfigPath(e);
232
+ }
233
+ await renderManuscripts(runDir, { pathMap, settingsError, log: (e) => this.log(run, e), render: this.renderOpts.render });
221
234
  await this.ingest(run, runDir, refs);
222
235
  run.status = "completed";
223
236
  await this.finishLocked(run, run.local.before);
@@ -447,10 +460,16 @@ export class PreflightService {
447
460
  // 親子の評価対象も固定する: 子なら親の目的、親なら今の子(分割の採用・子のタスク化の直前に比べる。input.ts の compareFamily)
448
461
  const parent = current.parent ? this.ws.requests.get(current.parent) : undefined;
449
462
  const kids = hierarchyNow(this.ws).children(requestId);
463
+ // 要求の根拠と回答も固定する(壊れていれば始めない: 評価の資料と比べる対象が決まらない)
464
+ if (current.requirementProblems?.length) {
465
+ throw new RequirementInputError(`${requestId} の要求の根拠・回答のファイルの値が読めないため、Preflight を始められません。request.md を直してください: ${current.requirementProblems.join(" / ")}`);
466
+ }
467
+ const requirement = requirementInputOf(current);
450
468
  const input = {
451
469
  ...text,
452
470
  ...(parent ? { parent: { id: parent.id, hash: inputHash(parent) } } : {}),
453
471
  children: kids.map((c) => ({ id: c.id, hash: inputHash(c) })),
472
+ ...(requirement ? { requirement } : {}),
454
473
  };
455
474
  const busy = await this.busy(requestId);
456
475
  if (busy)
@@ -637,6 +656,9 @@ export class PreflightService {
637
656
  /** run のフォルダの成果物(評価・案・子の案・画面資料)を取り込む。評価が読めなければ例外 */
638
657
  async ingest(run, runDir, refs) {
639
658
  run.assessment = parseAssessment(await readFile(join(runDir, "assessment.json"), "utf8"), refs);
659
+ // 読めない確認事項は評価に残し(clarificationProblems)、人が読めるよう知らせる
660
+ for (const p of run.assessment.clarificationProblems ?? [])
661
+ this.log(run, { kind: "error", text: `確認事項(clarifications)を読めません: ${p}` });
640
662
  run.drafts = await this.ws.preflight.loadDrafts(run.requestId, run.id);
641
663
  // 読めない受け入れ基準は案に残し(その案はタスク化できない)、人が直せるよう知らせる
642
664
  for (const d of run.drafts)
@@ -807,6 +829,10 @@ export class PreflightService {
807
829
  * (その場合は確かめない)。期待値はファイルに書かない。読んでから書くまでの間に外のプロセスが書くことまでは防げない
808
830
  */
809
831
  async updateDraft(requestId, runId, key, patch, opts = {}) {
832
+ // 読み直し・競合の確認・根拠の採番・保存を同じ排他の中で行う
833
+ return this.ws.preflight.withDraftLock(requestId, runId, key, () => this.updateDraftLocked(requestId, runId, key, patch, opts));
834
+ }
835
+ async updateDraftLocked(requestId, runId, key, patch, opts = {}) {
810
836
  const run = await this.ws.preflight.get(requestId, runId);
811
837
  const draft = run?.drafts.find((d) => d.key === key);
812
838
  if (!run || !draft)
@@ -816,20 +842,57 @@ export class PreflightService {
816
842
  // 基準を変えるときは、編集を始めたときの基準と今の基準を比べる(同じ題のまま他で基準が変わっても上書きしない)
817
843
  if (opts.expectedCriteria !== undefined && !sameCriteria(draft.acceptanceCriteria, opts.expectedCriteria))
818
844
  throw new DraftConflictError(draft, "criteria");
845
+ // 根拠だけを変えるときも、編集を始めたときの根拠と比べる
846
+ if (opts.expectedSources !== undefined && !sameSources(draft.acceptanceSources, opts.expectedSources))
847
+ throw new DraftConflictError(draft, "sources");
819
848
  // 作業先は作業先にできる参照先だけ(変える前に断る)
820
849
  if ("repo" in patch)
821
850
  checkRepoTarget(this.ws, patch.repo);
822
851
  // 基準は並び全体の置き換え(id は残し、無い項目に振る。空の並びは基準なし)。直せば読めなかった理由も消える
823
- const { acceptanceCriteria: rawCriteria, acceptanceProblems: _p, ...rest } = patch;
852
+ // 根拠の採番(acceptanceSourceSeq)は p3 が振る。patch から上書きしない
853
+ const { acceptanceCriteria: rawCriteria, acceptanceProblems: _p, acceptanceSourceSeq: _sq, sourceOps, ...rest } = patch;
824
854
  const criteria = rawCriteria !== undefined ? tidyDraftCriteria(rawCriteria) : undefined;
855
+ // 根拠の記録が読めないとき: 操作は断り、関係のない更新ではファイルの元の値のまま書き戻す(基準も、置き換えないなら同じ)
856
+ const rawCriteriaFile = await this.ws.preflight.rawDraftField(requestId, runId, key, "acceptanceCriteria");
857
+ const rawSources = await this.ws.preflight.rawDraftField(requestId, runId, key, "acceptanceSources");
858
+ const rawSourceSeq = await this.ws.preflight.rawDraftField(requestId, runId, key, "acceptanceSourceSeq");
859
+ const sourceProblems = [];
860
+ readCriterionSources(rawSources, sourceProblems);
861
+ readSourceSeq(rawSourceSeq, sourceProblems);
862
+ if (sourceProblems.length && sourceOps?.length)
863
+ throw new AcceptanceInputError(`${key} の要求の根拠の記録が読めないため変えられません。ファイルを直してください: ${sourceProblems.join(" / ")}`);
864
+ const now = new Date().toISOString();
865
+ const finalCriteria = rawCriteria !== undefined ? (criteria.length ? criteria : undefined) : draft.acceptanceCriteria;
866
+ let sources = draft.acceptanceSources;
867
+ let sourceSeqNext = draft.acceptanceSourceSeq;
868
+ if (sourceOps?.length) {
869
+ const r = applyDraftSourceOps(finalCriteria, sources, sourceOps, { now, actor: opts.actor, requestSources: this.ws.requests.get(requestId)?.requirementSources ?? [] }, draft.acceptanceSourceSeq);
870
+ sources = r.sources;
871
+ sourceSeqNext = r.seq > 0 ? r.seq : undefined;
872
+ }
873
+ else if (rawCriteria !== undefined)
874
+ sources = settleDraftSources(finalCriteria, sources, now);
825
875
  const next = {
826
876
  ...draft,
827
877
  ...rest,
828
878
  key,
829
- ...(rawCriteria !== undefined ? { acceptanceCriteria: criteria.length ? criteria : undefined, acceptanceProblems: undefined } : {}),
879
+ ...(rawCriteria !== undefined ? { acceptanceCriteria: finalCriteria, acceptanceProblems: undefined } : {}),
880
+ acceptanceSources: sources?.length ? sources : undefined,
881
+ acceptanceSourceSeq: sourceSeqNext,
830
882
  };
831
- await this.ws.preflight.saveDraft(requestId, runId, next);
832
- return next;
883
+ const keep = {
884
+ ...(rawCriteria === undefined && readDraftCriteria(rawCriteriaFile).problems ? { acceptanceCriteria: rawCriteriaFile } : {}),
885
+ ...(sourceProblems.length ? { acceptanceSources: rawSources, acceptanceSourceSeq: rawSourceSeq } : {}),
886
+ };
887
+ if (Object.keys(keep).length)
888
+ await this.ws.preflight.saveDraftRaw(requestId, runId, next, keep);
889
+ else
890
+ await this.ws.preflight.saveDraft(requestId, runId, next);
891
+ // 応答は保存したファイルを再読込と同じ規則で読み直したもの(読めない理由を二重にせず、読めた値も再読込と揃える)
892
+ const saved = await this.ws.preflight.loadDraft(requestId, runId, key);
893
+ if (!saved)
894
+ throw new Error(`${runId}/${key} not found`);
895
+ return saved;
833
896
  }
834
897
  /**
835
898
  * run の評価対象と今の要望が同じか。fresh: 要望をディスクから読み直してから比べる(タスク化の直前など)。
@@ -1102,7 +1165,7 @@ export class PreflightService {
1102
1165
  outputs: [],
1103
1166
  relations: supersedes(d),
1104
1167
  // 案の受け入れ基準を ID ごと写し、作業先に当てはまる品質基準(始めたときの版)を出典つきで足す(採用した案だけ。やり直しで作ったタスクは上書きしない)
1105
- ...withQuality(criteriaForTask(d.acceptanceCriteria), run.quality, draftRepo(d)),
1168
+ ...withQuality(criteriaForTask(d.acceptanceCriteria, d.acceptanceSources, request.requirementSources, undefined, d.acceptanceSourceSeq), run.quality, draftRepo(d)),
1106
1169
  body: `${d.description}\n\n${marker}`,
1107
1170
  }, actor));
1108
1171
  if (state.created[d.key] !== t.id) {
@@ -1213,7 +1276,9 @@ async function localProblems(ws, run, runDir) {
1213
1276
  problems.push("assessment.json がありません");
1214
1277
  else {
1215
1278
  try {
1216
- parseAssessment(text);
1279
+ const a = parseAssessment(text);
1280
+ for (const p of a.clarificationProblems ?? [])
1281
+ problems.push(`assessment.json の clarifications: ${p}`);
1217
1282
  }
1218
1283
  catch (e) {
1219
1284
  problems.push(e.message);
@@ -1333,6 +1398,15 @@ function verifiedProblem(ev, refs) {
1333
1398
  return `${ev.repo}:${file} がありません`;
1334
1399
  return undefined;
1335
1400
  }
1401
+ /**
1402
+ * 構造化した確認事項を読む(壊れた項目は黙って捨てず clarificationProblems に理由を残す)。この読み取りは Codex・手元のエージェントで
1403
+ * 共通だが、確定の規則はエンジンで違う: Codex の取り込み(ingest)は理由をログにも残して取り込み、手元のエージェント(localProblems)は
1404
+ * 直すまで確定を断る
1405
+ */
1406
+ function clarificationsOf(v) {
1407
+ const { clarifications, problems } = readClarifications(v);
1408
+ return { ...(clarifications ? { clarifications } : {}), ...(problems ? { clarificationProblems: problems } : {}) };
1409
+ }
1336
1410
  export function parseAssessment(text, refs) {
1337
1411
  let a;
1338
1412
  try {
@@ -1349,6 +1423,7 @@ export function parseAssessment(text, refs) {
1349
1423
  feasibility: { score: clampScore(a.feasibility?.score), reasons: strs(a.feasibility?.reasons) },
1350
1424
  risks: strs(a.risks),
1351
1425
  questions: strs(a.questions),
1426
+ ...clarificationsOf(a.clarifications),
1352
1427
  areas: strs(a.areas),
1353
1428
  ...(Array.isArray(a.evidence) ? { evidence: parseEvidence(a.evidence, refs) } : {}),
1354
1429
  ...(parseSplit(a.split) ? { split: parseSplit(a.split) } : {}),
@@ -1,6 +1,6 @@
1
1
  import { lstat, readFile } from "node:fs/promises";
2
2
  import { join } from "node:path";
3
- import { writeFileAtomic } from "../store/fsutil.js";
3
+ import { writeJsonRecord } from "../store/jsonRecord.js";
4
4
  import { RENDER_LIMITS, RenderError, renderHtml } from "./render.js";
5
5
  import { safeRelative, UI_DIR, UI_INDEX } from "./uiMaterials.js";
6
6
  /**
@@ -60,6 +60,9 @@ export async function renderManuscripts(runDir, opts) {
60
60
  if (jobs.length) {
61
61
  opts.log({ kind: "info", text: `画面イメージを描画します(${jobs.length} 枚。評価の後に P3 が描きます)` });
62
62
  try {
63
+ // 個人設定(パスの対応)を読めないときは、空の対応で描かずに理由を残す
64
+ if (opts.settingsError)
65
+ throw new RenderError(`個人設定を読めないので描画しません(Docker は起動していません): ${opts.settingsError}`, "paths");
63
66
  const results = await (opts.render ?? renderHtml)(jobs, uiDir, uiDir, opts);
64
67
  for (const r of results) {
65
68
  const item = byId.get(r.id);
@@ -85,5 +88,5 @@ export async function renderManuscripts(runDir, opts) {
85
88
  }
86
89
  }
87
90
  if (forged || jobs.length || items.some((x) => x.renderError))
88
- await writeFileAtomic(indexFile, JSON.stringify(index, null, 2) + "\n");
91
+ await writeJsonRecord(indexFile, index);
89
92
  }