@infodb/p3 0.3.0 → 0.5.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 (209) hide show
  1. package/bin/p3.mjs +11 -5
  2. package/dist/web/assets/Outputs-C83ZDXvs.js +1 -0
  3. package/dist/web/assets/RequestStatus-GmiWYEcL.js +1 -0
  4. package/dist/web/assets/Tabs-CJn0Qy7W.js +1 -0
  5. package/dist/web/assets/TagInput-CtM8HM8Z.js +1 -0
  6. package/dist/web/assets/TaskDrawer-D5v36QoF.js +3 -0
  7. package/dist/web/assets/_requestId-BHUqLO-j.js +1 -0
  8. package/dist/web/assets/_requestId-DxwxbXY2.js +30 -0
  9. package/dist/web/assets/{ui-Sz7y5_TS.js → appCtx-B-VRVOyv.js} +1 -1
  10. package/dist/web/assets/board-DAaVR04x.js +1 -0
  11. package/dist/web/assets/copy-CKsXEjMi.js +1 -0
  12. package/dist/web/assets/done-CaqB_qTH.js +1 -0
  13. package/dist/web/assets/index-BF1xMdJo.css +2 -0
  14. package/dist/web/assets/index-BQYvKpjF.js +12 -0
  15. package/dist/web/assets/milestoneOrder-N7b5XFJP.js +1 -0
  16. package/dist/web/assets/new-DLVnRvrB.js +1 -0
  17. package/dist/web/assets/preflightInput-BAeEJYUK.js +2 -0
  18. package/dist/web/assets/preload-helper-B74h5i3O.js +1 -0
  19. package/dist/web/assets/progressTree-wp9mH4VF.js +1 -0
  20. package/dist/web/assets/release-notes-MTLcOcvZ.js +3 -0
  21. package/dist/web/assets/requestData-D-HXu-cy.js +1 -0
  22. package/dist/web/assets/routes-CI4Qfkjs.js +3 -0
  23. package/dist/web/assets/settings-CJMNgzi6.js +1 -0
  24. package/dist/web/index.html +4 -4
  25. package/docs/architecture.md +238 -9
  26. package/docs/development.md +16 -9
  27. package/docs/how-to-use.md +128 -12
  28. package/docs/installation.md +8 -6
  29. package/docs/publishing.md +4 -2
  30. package/lib/cli/args.js +172 -0
  31. package/lib/cli/chatgpt.js +70 -0
  32. package/lib/cli/codex.js +30 -0
  33. package/lib/cli/format.js +9 -0
  34. package/{src/cli/help.ts → lib/cli/help.js} +11 -8
  35. package/lib/cli/main.js +326 -0
  36. package/lib/cli/output.js +110 -0
  37. package/lib/cli/preflightCommands.js +301 -0
  38. package/lib/cli/project.js +649 -0
  39. package/lib/cli/readOnly.js +36 -0
  40. package/lib/cli/releaseNotesCommands.js +197 -0
  41. package/lib/cli/render.js +58 -0
  42. package/lib/cli/requestCommands.js +180 -0
  43. package/lib/cli/showView.js +100 -0
  44. package/lib/cli/taskCommands.js +152 -0
  45. package/lib/cli/userConfig.js +64 -0
  46. package/{src/core/chatgpt.ts → lib/core/chatgpt.js} +10 -16
  47. package/lib/core/context.js +41 -0
  48. package/lib/core/hierarchy.js +128 -0
  49. package/lib/core/machineSettings.js +146 -0
  50. package/lib/core/machineSettingsEdit.js +148 -0
  51. package/lib/core/ops.js +120 -0
  52. package/lib/core/preflight/carryover.js +105 -0
  53. package/lib/core/preflight/codexEngine.js +687 -0
  54. package/lib/core/preflight/codexImage.js +61 -0
  55. package/lib/core/preflight/diagnose.js +95 -0
  56. package/lib/core/preflight/engine.js +58 -0
  57. package/lib/core/preflight/input.js +83 -0
  58. package/lib/core/preflight/launch.js +68 -0
  59. package/lib/core/preflight/mockEngine.js +175 -0
  60. package/lib/core/preflight/render.js +304 -0
  61. package/lib/core/preflight/service.js +868 -0
  62. package/lib/core/preflight/split.js +83 -0
  63. package/lib/core/preflight/uiMaterials.js +281 -0
  64. package/lib/core/preflight/uiRender.js +89 -0
  65. package/lib/core/preflight/wireframe.js +63 -0
  66. package/lib/core/preflight/xlsx.js +324 -0
  67. package/lib/core/projectRegistry.js +207 -0
  68. package/lib/core/redact.js +28 -0
  69. package/lib/core/releaseNotes/completeRequests.js +106 -0
  70. package/lib/core/releaseNotes/generate.js +266 -0
  71. package/lib/core/releaseNotes/material.js +141 -0
  72. package/lib/core/releaseNotes/mockSummarizer.js +26 -0
  73. package/lib/core/releaseNotes/service.js +83 -0
  74. package/lib/core/releaseNotes/store.js +209 -0
  75. package/lib/core/repoAdmin.js +82 -0
  76. package/lib/core/repoRefs.js +72 -0
  77. package/lib/core/requestOps.js +154 -0
  78. package/lib/core/requestStatus.js +171 -0
  79. package/lib/core/store/attachments.js +242 -0
  80. package/lib/core/store/collection.js +254 -0
  81. package/lib/core/store/frontmatter.js +18 -0
  82. package/lib/core/store/fsutil.js +84 -0
  83. package/lib/core/store/locate.js +162 -0
  84. package/lib/core/store/normalize.js +150 -0
  85. package/lib/core/store/noteStore.js +59 -0
  86. package/lib/core/store/preflightStore.js +161 -0
  87. package/lib/core/store/projectFile.js +99 -0
  88. package/lib/core/store/workspace.js +320 -0
  89. package/lib/core/supersede.js +69 -0
  90. package/lib/core/userConfig.js +158 -0
  91. package/{src/core/userTheme.ts → lib/core/userTheme.js} +11 -13
  92. package/lib/core/workTargets.js +106 -0
  93. package/lib/server/api/chatgptRoutes.js +46 -0
  94. package/{src/server/api/local.ts → lib/server/api/local.js} +23 -22
  95. package/lib/server/api/manifest.js +140 -0
  96. package/lib/server/api/projectsRoutes.js +82 -0
  97. package/lib/server/api/releaseNoteRoutes.js +88 -0
  98. package/lib/server/api/repoRoutes.js +67 -0
  99. package/lib/server/api/routes.js +404 -0
  100. package/lib/server/api/userThemeRoutes.js +60 -0
  101. package/lib/server/server.js +85 -0
  102. package/lib/shared/dates.js +10 -0
  103. package/{src/shared/directTask.ts → lib/shared/directTask.js} +3 -11
  104. package/lib/shared/hierarchy.js +120 -0
  105. package/lib/shared/milestoneOrder.js +45 -0
  106. package/lib/shared/preflightInput.js +19 -0
  107. package/lib/shared/refs.js +44 -0
  108. package/lib/shared/repos.js +69 -0
  109. package/lib/shared/scopeView.js +39 -0
  110. package/{src/shared/tags.ts → lib/shared/tags.js} +9 -14
  111. package/lib/shared/types.js +74 -0
  112. package/lib/shared/workTarget.js +31 -0
  113. package/package.json +4 -7
  114. package/skills/p3/SKILL.md +29 -8
  115. package/dist/web/assets/Outputs-DqJdybkd.js +0 -1
  116. package/dist/web/assets/RequestStatus-DN-2iAM0.js +0 -1
  117. package/dist/web/assets/TagInput-D-1ILLDX.js +0 -1
  118. package/dist/web/assets/TaskDrawer-CHD7T-Su.js +0 -3
  119. package/dist/web/assets/_requestId-BzSepQIV.js +0 -30
  120. package/dist/web/assets/_requestId-pIds2tFU.js +0 -1
  121. package/dist/web/assets/board-BIkOpuC4.js +0 -1
  122. package/dist/web/assets/copy-B1ZbihKL.js +0 -2
  123. package/dist/web/assets/done-BUAUhIRr.js +0 -1
  124. package/dist/web/assets/index-Byv9j77D.js +0 -12
  125. package/dist/web/assets/index-DTfUhuQw.css +0 -2
  126. package/dist/web/assets/new-6kly4-PX.js +0 -1
  127. package/dist/web/assets/preload-helper-DlN0ouRj.js +0 -1
  128. package/dist/web/assets/release-notes-iwQWmfX6.js +0 -3
  129. package/dist/web/assets/requestData-DJ1Rlx-u.js +0 -1
  130. package/dist/web/assets/routes-Ciot9p4x.js +0 -2
  131. package/dist/web/assets/settings-DBCi6lAY.js +0 -1
  132. package/src/cli/args.ts +0 -186
  133. package/src/cli/chatgpt.ts +0 -74
  134. package/src/cli/codex.ts +0 -28
  135. package/src/cli/format.ts +0 -9
  136. package/src/cli/main.ts +0 -336
  137. package/src/cli/output.ts +0 -117
  138. package/src/cli/preflightCommands.ts +0 -245
  139. package/src/cli/project.ts +0 -672
  140. package/src/cli/readOnly.ts +0 -36
  141. package/src/cli/releaseNotesCommands.ts +0 -159
  142. package/src/cli/render.ts +0 -60
  143. package/src/cli/requestCommands.ts +0 -170
  144. package/src/cli/showView.ts +0 -110
  145. package/src/cli/taskCommands.ts +0 -167
  146. package/src/cli/userConfig.ts +0 -58
  147. package/src/core/context.ts +0 -58
  148. package/src/core/machineSettings.ts +0 -207
  149. package/src/core/machineSettingsEdit.ts +0 -156
  150. package/src/core/ops.ts +0 -114
  151. package/src/core/preflight/carryover.ts +0 -133
  152. package/src/core/preflight/codexEngine.ts +0 -703
  153. package/src/core/preflight/codexImage.ts +0 -98
  154. package/src/core/preflight/diagnose.ts +0 -124
  155. package/src/core/preflight/engine.ts +0 -92
  156. package/src/core/preflight/input.ts +0 -65
  157. package/src/core/preflight/launch.ts +0 -86
  158. package/src/core/preflight/mockEngine.ts +0 -145
  159. package/src/core/preflight/render.ts +0 -339
  160. package/src/core/preflight/service.ts +0 -707
  161. package/src/core/preflight/uiMaterials.ts +0 -272
  162. package/src/core/preflight/uiRender.ts +0 -84
  163. package/src/core/preflight/wireframe.ts +0 -69
  164. package/src/core/preflight/xlsx.ts +0 -328
  165. package/src/core/projectRegistry.ts +0 -264
  166. package/src/core/redact.ts +0 -31
  167. package/src/core/releaseNotes/generate.ts +0 -283
  168. package/src/core/releaseNotes/material.ts +0 -114
  169. package/src/core/releaseNotes/mockSummarizer.ts +0 -28
  170. package/src/core/releaseNotes/service.ts +0 -106
  171. package/src/core/releaseNotes/store.ts +0 -216
  172. package/src/core/repoAdmin.ts +0 -81
  173. package/src/core/repoRefs.ts +0 -90
  174. package/src/core/requestOps.ts +0 -140
  175. package/src/core/requestStatus.ts +0 -58
  176. package/src/core/store/attachments.ts +0 -228
  177. package/src/core/store/collection.ts +0 -282
  178. package/src/core/store/frontmatter.ts +0 -22
  179. package/src/core/store/fsutil.ts +0 -90
  180. package/src/core/store/locate.ts +0 -181
  181. package/src/core/store/normalize.ts +0 -155
  182. package/src/core/store/noteStore.ts +0 -56
  183. package/src/core/store/preflightStore.ts +0 -136
  184. package/src/core/store/projectFile.ts +0 -101
  185. package/src/core/store/workspace.ts +0 -328
  186. package/src/core/supersede.ts +0 -74
  187. package/src/core/userConfig.ts +0 -205
  188. package/src/core/workTargets.ts +0 -120
  189. package/src/server/api/chatgptRoutes.ts +0 -49
  190. package/src/server/api/manifest.ts +0 -128
  191. package/src/server/api/projectsRoutes.ts +0 -89
  192. package/src/server/api/releaseNoteRoutes.ts +0 -78
  193. package/src/server/api/repoRoutes.ts +0 -67
  194. package/src/server/api/routes.ts +0 -382
  195. package/src/server/api/userThemeRoutes.ts +0 -62
  196. package/src/server/server.ts +0 -108
  197. package/src/shared/dates.ts +0 -12
  198. package/src/shared/preflightInput.ts +0 -27
  199. package/src/shared/refs.ts +0 -55
  200. package/src/shared/repos.ts +0 -113
  201. package/src/shared/scopeView.ts +0 -48
  202. package/src/shared/types.ts +0 -700
  203. package/src/shared/workTarget.ts +0 -44
  204. /package/{src → lib}/core/preflight/launcher.mjs +0 -0
  205. /package/{src → lib}/core/preflight/mock-ui.html +0 -0
  206. /package/{src → lib}/core/preflight/mock-ui.png +0 -0
  207. /package/{src → lib}/core/preflight/render-image/Dockerfile +0 -0
  208. /package/{src → lib}/core/preflight/render-image/fonts-ja.conf +0 -0
  209. /package/{src → lib}/core/preflight/render-image/render.mjs +0 -0
@@ -0,0 +1,304 @@
1
+ import { spawn, execFile } from "node:child_process";
2
+ import { createHash, randomBytes } from "node:crypto";
3
+ import { chmod, copyFile, mkdir, readFile, rm, writeFile } from "node:fs/promises";
4
+ import { join } from "node:path";
5
+ import { fileURLToPath } from "node:url";
6
+ import { promisify } from "node:util";
7
+ import { mapPath, pathMapHowTo } from "./diagnose.js";
8
+ const exec = promisify(execFile);
9
+ /**
10
+ * 画面イメージの描画(自己完結した HTML / CSS → PNG)。
11
+ *
12
+ * P3(ホストのプロセス)が専用のイメージ(render-image/)で docker run する。Codex のコンテナに Docker のソケットは渡さない。
13
+ * 描画のコンテナは、ネットワークなし・認証情報なし・リポジトリなしで、確かめた原稿のコピー(/in。読むだけ)と
14
+ * 出力のフォルダ(/out)だけをマウントする。ルートのファイルシステムは読むだけ、権限(capability)は全部外し、
15
+ * メモリ・CPU・プロセス数・時間に上限を付ける。Chromium の sandbox は使わない(コンテナを囲いにする)。
16
+ *
17
+ * 原稿は描画の前に確かめる(checkHtml): スクリプト・イベントの属性・javascript: URL・外のファイルや通信を指す参照・
18
+ * iframe / object / embed / link / base / meta refresh は断る。参照に使えるのは data: の画像(PNG / JPEG / GIF / WebP / SVG)・
19
+ * data: のフォント(woff2 / woff / ttf / otf)と、ページの中の #id だけ。描画するときもスクリプトは無効にし、
20
+ * data: 以外の読み込みは止めて記録する(通信を止めるのは唯一の囲いではない)。
21
+ */
22
+ export const RENDER_IMAGE_DIR = fileURLToPath(new URL("./render-image/", import.meta.url));
23
+ /** 上限 */
24
+ export const RENDER_LIMITS = {
25
+ /** 1つの原稿の大きさ */
26
+ htmlBytes: 2 * 1024 * 1024,
27
+ /** 1回の描画の数 */
28
+ pages: 20,
29
+ minWidth: 320,
30
+ maxWidth: 2560,
31
+ maxHeight: 16384,
32
+ /** 1ページあたりの時間(ブラウザの中) */
33
+ pageTimeoutMs: 20_000,
34
+ /** 1回の docker run 全体の時間 = base + ページ数 × perPage */
35
+ baseTimeoutMs: 60_000,
36
+ perPageTimeoutMs: 25_000,
37
+ memory: "1g",
38
+ cpus: "1",
39
+ pids: 256,
40
+ };
41
+ export class RenderError extends Error {
42
+ step;
43
+ constructor(message, step) {
44
+ super(message);
45
+ this.step = step;
46
+ }
47
+ }
48
+ // --- 原稿の確かめ ----------------------------------------------------------
49
+ const DATA_OK = /^data:(image\/(png|jpeg|gif|webp|svg\+xml)|font\/(woff2?|ttf|otf)|application\/(font-woff2?|x-font-ttf|x-font-otf))[;,]/i;
50
+ /** 参照の値として認めるか(data: の画像・フォント、ページの中の #id) */
51
+ function refOk(v) {
52
+ const s = v.trim().replace(/^['"]|['"]$/g, "").trim();
53
+ return !s || s.startsWith("#") || DATA_OK.test(s);
54
+ }
55
+ /**
56
+ * 原稿を確かめる。問題(理由)の一覧を返す(空なら描画してよい)。
57
+ * HTML を完全に解析するのではなく、危ないものを広めに断る(読み込みを止める囲いと、コンテナの囲いがその後ろにある)
58
+ */
59
+ export function checkHtml(html) {
60
+ const problems = [];
61
+ const add = (p) => problems.includes(p) || problems.push(p);
62
+ if (Buffer.byteLength(html) > RENDER_LIMITS.htmlBytes)
63
+ add(`原稿が大きすぎます(上限 ${RENDER_LIMITS.htmlBytes} バイト)`);
64
+ // コメントは参照の判定から外す(中身は描画されない)
65
+ const body = html.replace(/<!--[\s\S]*?-->/g, "");
66
+ if (/<\s*script\b/i.test(body))
67
+ add("スクリプト(<script>)は使えません");
68
+ for (const tag of ["iframe", "frame", "frameset", "object", "embed", "applet", "link", "base", "portal"]) {
69
+ if (new RegExp(`<\\s*${tag}\\b`, "i").test(body))
70
+ add(`<${tag}> は使えません`);
71
+ }
72
+ if (/<\s*meta\b[^>]*http-equiv/i.test(body))
73
+ add("<meta http-equiv> は使えません");
74
+ if (/<[^>]*\son[a-z]+\s*=/i.test(body))
75
+ add("イベントの属性(onclick など)は使えません");
76
+ if (/javascript\s*:/i.test(body) || /vbscript\s*:/i.test(body))
77
+ add("javascript: の URL は使えません");
78
+ // 属性の参照(src / href / srcset / poster / action / formaction / data / background / xlink:href)
79
+ const attr = /\s(?:xlink:)?(src|href|srcset|poster|action|formaction|data|background|manifest|ping|cite|longdesc|lowsrc|dynsrc)\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi;
80
+ for (const m of body.matchAll(attr)) {
81
+ const name = m[1].toLowerCase();
82
+ const value = m[2].replace(/^['"]|['"]$/g, "");
83
+ // srcset は「URL 記述子, URL 記述子」。data: の URL にも , が入るので、空白で分けて記述子(1x・640w)以外を見る
84
+ const values = name === "srcset"
85
+ ? value
86
+ .split(/\s+/)
87
+ .map((x) => x.replace(/^,+|,+$/g, ""))
88
+ .filter((x) => x && !/^\d+(\.\d+)?[wx]$/.test(x))
89
+ : [value];
90
+ for (const v of values)
91
+ if (!refOk(v))
92
+ add(`外のファイル・通信を指す参照は使えません: ${name}="${v.slice(0, 80)}"`);
93
+ }
94
+ // CSS の参照(url(...) と @import)
95
+ for (const m of body.matchAll(/url\(\s*("[^"]*"|'[^']*'|[^)]*)\s*\)/gi)) {
96
+ if (!refOk(m[1]))
97
+ add(`外のファイル・通信を指す参照は使えません: url(${m[1].slice(0, 80)})`);
98
+ }
99
+ if (/@import\b/i.test(body))
100
+ add("@import は使えません(CSS は <style> の中に書いてください)");
101
+ if (/image-set\(|expression\(|-moz-binding|behavior\s*:/i.test(body))
102
+ add("image-set() / expression() などは使えません");
103
+ return problems;
104
+ }
105
+ // --- イメージ ----------------------------------------------------------------
106
+ /** イメージの資材(render-image/ の中。全部をイメージの名前の hash に入れる) */
107
+ export const RENDER_IMAGE_FILES = ["Dockerfile", "fonts-ja.conf", "render.mjs"];
108
+ /** イメージの名前(資材の中身から決める。どれかが変われば別の名前になり、作り直す) */
109
+ export async function renderImageTag(dir = RENDER_IMAGE_DIR) {
110
+ const h = createHash("sha256");
111
+ for (const f of RENDER_IMAGE_FILES)
112
+ h.update(await readFile(join(dir, f)));
113
+ return `infodb-p3-render:${h.digest("hex").slice(0, 12)}`;
114
+ }
115
+ /** Docker が使えるか(使えなければ RenderError) */
116
+ export async function checkDocker(docker = "docker") {
117
+ try {
118
+ const { stdout } = await exec(docker, ["version", "--format", "{{.Server.Version}}"], { timeout: 15_000 });
119
+ return stdout.trim();
120
+ }
121
+ catch (e) {
122
+ const err = e;
123
+ if (err.code === "ENOENT")
124
+ throw new RenderError("docker コマンドが見つかりません。Docker をインストールしてください", "docker");
125
+ const detail = (err.stderr ?? err.message).trim().split("\n").pop();
126
+ throw new RenderError(`Docker デーモンにつながりません(${detail})。Docker を起動してください`, "docker");
127
+ }
128
+ }
129
+ /** 描画のイメージが無ければ作る。force なら作り直す。イメージの名前を返す */
130
+ export async function ensureRenderImage(opts = {}) {
131
+ const docker = opts.docker ?? "docker";
132
+ const image = opts.image ?? (await renderImageTag());
133
+ await checkDocker(docker);
134
+ if (!opts.force) {
135
+ const has = await exec(docker, ["image", "inspect", "--format", "{{.Id}}", image], { timeout: 15_000 }).then(() => true, () => false);
136
+ if (has)
137
+ return { image, built: false };
138
+ }
139
+ opts.onProgress?.(`描画のイメージ ${image} を作ります(初回は数分かかります)`);
140
+ // ビルドのコンテキストは docker の CLI が送るので、パスの対応は要らない
141
+ const out = await runProcess(docker, ["build", ...(opts.force ? ["--pull", "--no-cache"] : []), "-t", image, RENDER_IMAGE_DIR], { timeoutMs: 20 * 60_000, signal: opts.signal });
142
+ if (out.code !== 0)
143
+ throw new RenderError(`描画のイメージを作れません: ${lastLine(out.stderr)}`, "image");
144
+ return { image, built: true };
145
+ }
146
+ /** docker run の引数(テストで確かめる) */
147
+ export function renderArgs(p) {
148
+ return [
149
+ "run",
150
+ "--rm",
151
+ "--name",
152
+ p.name,
153
+ "--network",
154
+ "none",
155
+ "--read-only",
156
+ "--cap-drop",
157
+ "ALL",
158
+ "--security-opt",
159
+ "no-new-privileges",
160
+ "--pids-limit",
161
+ String(RENDER_LIMITS.pids),
162
+ "--memory",
163
+ RENDER_LIMITS.memory,
164
+ "--cpus",
165
+ RENDER_LIMITS.cpus,
166
+ "--shm-size",
167
+ "256m",
168
+ "--tmpfs",
169
+ "/tmp:rw,size=256m",
170
+ "-e",
171
+ `P3_RENDER_MAX_HEIGHT=${RENDER_LIMITS.maxHeight}`,
172
+ "-e",
173
+ `P3_RENDER_PAGE_TIMEOUT=${RENDER_LIMITS.pageTimeoutMs}`,
174
+ "--mount",
175
+ `type=bind,src=${p.hostIn},dst=/in,readonly`,
176
+ "--mount",
177
+ `type=bind,src=${p.hostOut},dst=/out`,
178
+ p.image,
179
+ ];
180
+ }
181
+ /**
182
+ * 原稿を PNG にする。workDir(このマシンのパス。Docker デーモンから見えるところ)の下に一時のフォルダを作り、
183
+ * 終わったら(失敗・時間切れ・取消でも)コンテナを止めて消す。できた PNG は outDir に <id>.png で置く。
184
+ * 原稿に問題があるものは描画せずに結果に理由を返す
185
+ */
186
+ export async function renderHtml(jobs, workDir, outDir, opts = {}) {
187
+ const docker = opts.docker ?? "docker";
188
+ if (jobs.length > RENDER_LIMITS.pages)
189
+ throw new RenderError(`一度に描画できるのは ${RENDER_LIMITS.pages} 枚までです`, "check");
190
+ const results = new Map();
191
+ const ok = [];
192
+ for (const j of jobs) {
193
+ const problems = [...checkHtml(j.html)];
194
+ if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$/.test(j.id))
195
+ problems.push(`名前が使えません: ${j.id}`);
196
+ if (!Number.isInteger(j.width) || j.width < RENDER_LIMITS.minWidth || j.width > RENDER_LIMITS.maxWidth) {
197
+ problems.push(`幅は ${RENDER_LIMITS.minWidth}〜${RENDER_LIMITS.maxWidth} px にしてください: ${j.width}`);
198
+ }
199
+ if (problems.length)
200
+ results.set(j.id, { id: j.id, ok: false, error: problems.join(" / "), blocked: [] });
201
+ else
202
+ ok.push(j);
203
+ }
204
+ if (ok.length) {
205
+ const { image } = await ensureRenderImage({ ...opts, docker });
206
+ const tmp = join(workDir, `.render-${randomBytes(4).toString("hex")}`);
207
+ const name = `p3-render-${randomBytes(4).toString("hex")}`;
208
+ try {
209
+ await mkdir(join(tmp, "in"), { recursive: true });
210
+ await mkdir(join(tmp, "out"), { recursive: true });
211
+ // コンテナの中の利用者(root ではない)が書けるように
212
+ await chmod(join(tmp, "out"), 0o777);
213
+ for (const j of ok)
214
+ await writeFile(join(tmp, "in", `${j.id}.html`), j.html);
215
+ 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
+ opts.onProgress?.(`${ok.length} 枚を描画します`);
219
+ const timeoutMs = RENDER_LIMITS.baseTimeoutMs + ok.length * RENDER_LIMITS.perPageTimeoutMs;
220
+ const out = await runProcess(docker, args, { timeoutMs, signal: opts.signal, onStop: () => exec(docker, ["kill", name]).catch(() => { }) });
221
+ if (out.stopped === "cancel")
222
+ throw new RenderError("描画を取り消しました", "cancel");
223
+ if (out.stopped === "timeout")
224
+ throw new RenderError(`描画が ${Math.round(timeoutMs / 1000)} 秒で終わりませんでした`, "timeout");
225
+ if (out.code !== 0)
226
+ throw new RenderError(diagnoseRender(out.stderr, opts.pathMap ?? [], workDir), "run");
227
+ const reported = parseReport(out.stdout);
228
+ await mkdir(outDir, { recursive: true });
229
+ for (const j of ok) {
230
+ const r = reported.find((x) => x.id === j.id);
231
+ if (!r?.ok) {
232
+ results.set(j.id, { id: j.id, ok: false, error: r?.error ?? "描画の結果がありません", blocked: r?.blocked ?? [] });
233
+ continue;
234
+ }
235
+ const file = join(outDir, `${j.id}.png`);
236
+ await copyFile(join(tmp, "out", `${j.id}.png`), file);
237
+ results.set(j.id, { id: j.id, ok: true, file, clipped: !!r.clipped, blocked: r.blocked ?? [] });
238
+ }
239
+ }
240
+ finally {
241
+ await rm(tmp, { recursive: true, force: true });
242
+ }
243
+ }
244
+ return jobs.map((j) => results.get(j.id));
245
+ }
246
+ function parseReport(stdout) {
247
+ const line = stdout.trim().split("\n").pop() ?? "";
248
+ try {
249
+ const r = JSON.parse(line);
250
+ return Array.isArray(r.results) ? r.results : [];
251
+ }
252
+ catch {
253
+ throw new RenderError(`描画の結果が読めません: ${line.slice(0, 200)}`, "run");
254
+ }
255
+ }
256
+ const lastLine = (s) => s.trim().split("\n").filter(Boolean).pop() ?? "(出力なし)";
257
+ /** docker run の失敗の説明(よくある原因には次にすることを添える) */
258
+ export function diagnoseRender(stderr, pathMap, workDir) {
259
+ const last = lastLine(stderr);
260
+ if (/bind source path does not exist|invalid mount config|not a directory|no such file or directory/i.test(stderr)) {
261
+ const m = workDir ? mapPath(pathMap, workDir) : undefined;
262
+ return [
263
+ `描画のコンテナに原稿のフォルダをマウントできません(${last})。DevContainer の中から使うときは、パスの対応(codex.pathMap)が要ります`,
264
+ ...pathMapHowTo(m && { label: "描画", local: workDir, host: m.host, rule: m.rule, container: "/in" }),
265
+ ].join("\n");
266
+ }
267
+ if (/permission denied/i.test(stderr) && /docker\.sock|daemon/i.test(stderr))
268
+ return `Docker を使う権限がありません(${last})`;
269
+ if (/Unable to find image|pull access denied/i.test(stderr))
270
+ return `描画のイメージがありません(${last})。p3 render --update で作り直してください`;
271
+ return `描画に失敗しました: ${last}`;
272
+ }
273
+ /** 子プロセスを動かす。時間切れ・取消のときは onStop(コンテナを止める)を呼んでからプロセスを終わらせる */
274
+ function runProcess(cmd, args, o) {
275
+ return new Promise((resolve) => {
276
+ let stdout = "";
277
+ let stderr = "";
278
+ let stopped;
279
+ const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
280
+ child.stdout.on("data", (d) => (stdout = (stdout + d).slice(-1_000_000)));
281
+ child.stderr.on("data", (d) => (stderr = (stderr + d).slice(-100_000)));
282
+ const stop = (why) => {
283
+ if (stopped)
284
+ return;
285
+ stopped = why;
286
+ void (o.onStop?.() ?? Promise.resolve()).finally(() => child.kill("SIGKILL"));
287
+ };
288
+ const timer = setTimeout(() => stop("timeout"), o.timeoutMs);
289
+ const onAbort = () => stop("cancel");
290
+ if (o.signal?.aborted)
291
+ onAbort();
292
+ o.signal?.addEventListener("abort", onAbort, { once: true });
293
+ const done = (code) => {
294
+ clearTimeout(timer);
295
+ o.signal?.removeEventListener("abort", onAbort);
296
+ resolve({ code, stdout, stderr, stopped });
297
+ };
298
+ child.on("error", (e) => {
299
+ stderr += String(e.message);
300
+ done(-1);
301
+ });
302
+ child.on("close", done);
303
+ });
304
+ }