@infodb/p3 0.4.0 → 0.6.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/README.md +1 -0
  2. package/bin/p3.mjs +11 -5
  3. package/dist/web/assets/Outputs-CQi0oba1.js +1 -0
  4. package/dist/web/assets/RequestStatus-grC0F_SQ.js +1 -0
  5. package/dist/web/assets/Tabs-BJRGzidj.js +1 -0
  6. package/dist/web/assets/TagInput-DkuISbfK.js +1 -0
  7. package/dist/web/assets/TaskDrawer-CysOMAjG.js +3 -0
  8. package/dist/web/assets/_requestId-BQCwOAbs.js +30 -0
  9. package/dist/web/assets/_requestId-DgSOUH78.js +1 -0
  10. package/dist/web/assets/{ui-DdOGYj9z.js → appCtx-DCiGJFAe.js} +1 -1
  11. package/dist/web/assets/board-BsntpZXP.js +1 -0
  12. package/dist/web/assets/done-Bhxqy7bH.js +1 -0
  13. package/dist/web/assets/index-BF1xMdJo.css +2 -0
  14. package/dist/web/assets/index-BTuEPzgc.js +12 -0
  15. package/dist/web/assets/new-BwknRX3V.js +1 -0
  16. package/dist/web/assets/{preflightInput-DMxqnvF8.js → preflightInput-BAeEJYUK.js} +1 -1
  17. package/dist/web/assets/preload-helper-B40dBmwL.js +1 -0
  18. package/dist/web/assets/progressTree-DgrdDFih.js +1 -0
  19. package/dist/web/assets/release-notes-AgwbykyG.js +3 -0
  20. package/dist/web/assets/requestData-w6fhCYmh.js +1 -0
  21. package/dist/web/assets/routes-Bu3bhOaC.js +3 -0
  22. package/dist/web/assets/settings-BkV8KeQk.js +1 -0
  23. package/dist/web/index.html +4 -4
  24. package/docs/architecture.md +271 -3
  25. package/docs/development.md +22 -9
  26. package/docs/how-to-use.md +83 -7
  27. package/docs/installation.md +8 -6
  28. package/docs/publishing.md +4 -2
  29. package/lib/cli/args.js +172 -0
  30. package/lib/cli/chatgpt.js +70 -0
  31. package/lib/cli/codex.js +30 -0
  32. package/lib/cli/format.js +9 -0
  33. package/{src/cli/help.ts → lib/cli/help.js} +10 -8
  34. package/lib/cli/main.js +327 -0
  35. package/lib/cli/output.js +110 -0
  36. package/lib/cli/preflightCommands.js +301 -0
  37. package/lib/cli/project.js +649 -0
  38. package/lib/cli/readOnly.js +36 -0
  39. package/lib/cli/releaseNotesCommands.js +197 -0
  40. package/lib/cli/render.js +58 -0
  41. package/lib/cli/requestCommands.js +191 -0
  42. package/lib/cli/showView.js +100 -0
  43. package/lib/cli/taskCommands.js +152 -0
  44. package/lib/cli/userConfig.js +64 -0
  45. package/{src/core/chatgpt.ts → lib/core/chatgpt.js} +10 -16
  46. package/lib/core/context.js +41 -0
  47. package/lib/core/hierarchy.js +158 -0
  48. package/lib/core/machineSettings.js +146 -0
  49. package/lib/core/machineSettingsEdit.js +148 -0
  50. package/lib/core/ops.js +120 -0
  51. package/lib/core/preflight/carryover.js +105 -0
  52. package/lib/core/preflight/codexEngine.js +687 -0
  53. package/lib/core/preflight/codexImage.js +61 -0
  54. package/lib/core/preflight/diagnose.js +95 -0
  55. package/lib/core/preflight/engine.js +58 -0
  56. package/lib/core/preflight/input.js +83 -0
  57. package/lib/core/preflight/launch.js +68 -0
  58. package/lib/core/preflight/mockEngine.js +175 -0
  59. package/lib/core/preflight/render.js +304 -0
  60. package/lib/core/preflight/service.js +883 -0
  61. package/lib/core/preflight/split.js +83 -0
  62. package/lib/core/preflight/uiMaterials.js +281 -0
  63. package/lib/core/preflight/uiRender.js +89 -0
  64. package/lib/core/preflight/wireframe.js +63 -0
  65. package/lib/core/preflight/xlsx.js +324 -0
  66. package/lib/core/projectRegistry.js +207 -0
  67. package/lib/core/redact.js +28 -0
  68. package/lib/core/releaseNotes/completeRequests.js +106 -0
  69. package/lib/core/releaseNotes/generate.js +266 -0
  70. package/lib/core/releaseNotes/material.js +141 -0
  71. package/lib/core/releaseNotes/mockSummarizer.js +26 -0
  72. package/lib/core/releaseNotes/service.js +83 -0
  73. package/lib/core/releaseNotes/store.js +209 -0
  74. package/lib/core/repoAdmin.js +82 -0
  75. package/lib/core/repoRefs.js +72 -0
  76. package/lib/core/requestOps.js +164 -0
  77. package/lib/core/requestStatus.js +171 -0
  78. package/lib/core/store/attachments.js +242 -0
  79. package/lib/core/store/collection.js +254 -0
  80. package/lib/core/store/frontmatter.js +18 -0
  81. package/lib/core/store/fsutil.js +84 -0
  82. package/lib/core/store/locate.js +162 -0
  83. package/lib/core/store/normalize.js +152 -0
  84. package/lib/core/store/noteStore.js +59 -0
  85. package/lib/core/store/preflightStore.js +161 -0
  86. package/lib/core/store/projectFile.js +99 -0
  87. package/lib/core/store/workspace.js +320 -0
  88. package/lib/core/supersede.js +69 -0
  89. package/lib/core/userConfig.js +158 -0
  90. package/{src/core/userTheme.ts → lib/core/userTheme.js} +11 -13
  91. package/lib/core/workTargets.js +106 -0
  92. package/lib/server/api/chatgptRoutes.js +46 -0
  93. package/{src/server/api/local.ts → lib/server/api/local.js} +23 -22
  94. package/lib/server/api/manifest.js +147 -0
  95. package/lib/server/api/projectsRoutes.js +82 -0
  96. package/lib/server/api/releaseNoteRoutes.js +88 -0
  97. package/lib/server/api/repoRoutes.js +67 -0
  98. package/lib/server/api/routes.js +416 -0
  99. package/lib/server/api/userThemeRoutes.js +60 -0
  100. package/lib/server/server.js +85 -0
  101. package/lib/shared/dates.js +10 -0
  102. package/{src/shared/directTask.ts → lib/shared/directTask.js} +3 -11
  103. package/lib/shared/hierarchy.js +135 -0
  104. package/lib/shared/milestoneOrder.js +45 -0
  105. package/lib/shared/preflightInput.js +19 -0
  106. package/lib/shared/refs.js +44 -0
  107. package/lib/shared/repos.js +69 -0
  108. package/lib/shared/scopeView.js +39 -0
  109. package/{src/shared/tags.ts → lib/shared/tags.js} +9 -14
  110. package/lib/shared/types.js +74 -0
  111. package/lib/shared/workTarget.js +31 -0
  112. package/package.json +4 -7
  113. package/skills/p3/SKILL.md +10 -0
  114. package/dist/web/assets/Outputs-5Hby-S5Q.js +0 -1
  115. package/dist/web/assets/RequestStatus-CTkGjT02.js +0 -1
  116. package/dist/web/assets/TagInput-Rj3PNOAF.js +0 -1
  117. package/dist/web/assets/TaskDrawer-DtPhiYxP.js +0 -3
  118. package/dist/web/assets/_requestId-CGvAfIkB.js +0 -30
  119. package/dist/web/assets/_requestId-DxfYhgAq.js +0 -1
  120. package/dist/web/assets/board-wt47lfrE.js +0 -1
  121. package/dist/web/assets/done-C9Ct7ssb.js +0 -1
  122. package/dist/web/assets/index-BTFL2rpp.js +0 -12
  123. package/dist/web/assets/index-DAyBsvua.css +0 -2
  124. package/dist/web/assets/new-e4ID2vQV.js +0 -1
  125. package/dist/web/assets/preload-helper-DhIyFaOW.js +0 -1
  126. package/dist/web/assets/release-notes-CQ0d2r0k.js +0 -3
  127. package/dist/web/assets/requestData-BDZqyl35.js +0 -1
  128. package/dist/web/assets/routes-Bipv3lwJ.js +0 -2
  129. package/dist/web/assets/settings-Dwh8fj6p.js +0 -1
  130. package/src/cli/args.ts +0 -186
  131. package/src/cli/chatgpt.ts +0 -74
  132. package/src/cli/codex.ts +0 -28
  133. package/src/cli/format.ts +0 -9
  134. package/src/cli/main.ts +0 -337
  135. package/src/cli/output.ts +0 -117
  136. package/src/cli/preflightCommands.ts +0 -245
  137. package/src/cli/project.ts +0 -675
  138. package/src/cli/readOnly.ts +0 -36
  139. package/src/cli/releaseNotesCommands.ts +0 -198
  140. package/src/cli/render.ts +0 -60
  141. package/src/cli/requestCommands.ts +0 -172
  142. package/src/cli/showView.ts +0 -110
  143. package/src/cli/taskCommands.ts +0 -167
  144. package/src/cli/userConfig.ts +0 -58
  145. package/src/core/context.ts +0 -58
  146. package/src/core/machineSettings.ts +0 -207
  147. package/src/core/machineSettingsEdit.ts +0 -156
  148. package/src/core/ops.ts +0 -114
  149. package/src/core/preflight/carryover.ts +0 -133
  150. package/src/core/preflight/codexEngine.ts +0 -703
  151. package/src/core/preflight/codexImage.ts +0 -98
  152. package/src/core/preflight/diagnose.ts +0 -124
  153. package/src/core/preflight/engine.ts +0 -92
  154. package/src/core/preflight/input.ts +0 -65
  155. package/src/core/preflight/launch.ts +0 -86
  156. package/src/core/preflight/mockEngine.ts +0 -145
  157. package/src/core/preflight/render.ts +0 -339
  158. package/src/core/preflight/service.ts +0 -707
  159. package/src/core/preflight/uiMaterials.ts +0 -272
  160. package/src/core/preflight/uiRender.ts +0 -84
  161. package/src/core/preflight/wireframe.ts +0 -69
  162. package/src/core/preflight/xlsx.ts +0 -328
  163. package/src/core/projectRegistry.ts +0 -264
  164. package/src/core/redact.ts +0 -31
  165. package/src/core/releaseNotes/completeRequests.ts +0 -102
  166. package/src/core/releaseNotes/generate.ts +0 -283
  167. package/src/core/releaseNotes/material.ts +0 -114
  168. package/src/core/releaseNotes/mockSummarizer.ts +0 -28
  169. package/src/core/releaseNotes/service.ts +0 -110
  170. package/src/core/releaseNotes/store.ts +0 -216
  171. package/src/core/repoAdmin.ts +0 -81
  172. package/src/core/repoRefs.ts +0 -90
  173. package/src/core/requestOps.ts +0 -140
  174. package/src/core/requestStatus.ts +0 -58
  175. package/src/core/store/attachments.ts +0 -228
  176. package/src/core/store/collection.ts +0 -282
  177. package/src/core/store/frontmatter.ts +0 -22
  178. package/src/core/store/fsutil.ts +0 -90
  179. package/src/core/store/locate.ts +0 -181
  180. package/src/core/store/normalize.ts +0 -155
  181. package/src/core/store/noteStore.ts +0 -56
  182. package/src/core/store/preflightStore.ts +0 -136
  183. package/src/core/store/projectFile.ts +0 -101
  184. package/src/core/store/workspace.ts +0 -328
  185. package/src/core/supersede.ts +0 -74
  186. package/src/core/userConfig.ts +0 -205
  187. package/src/core/workTargets.ts +0 -120
  188. package/src/server/api/chatgptRoutes.ts +0 -49
  189. package/src/server/api/manifest.ts +0 -135
  190. package/src/server/api/projectsRoutes.ts +0 -89
  191. package/src/server/api/releaseNoteRoutes.ts +0 -89
  192. package/src/server/api/repoRoutes.ts +0 -67
  193. package/src/server/api/routes.ts +0 -382
  194. package/src/server/api/userThemeRoutes.ts +0 -62
  195. package/src/server/server.ts +0 -108
  196. package/src/shared/dates.ts +0 -12
  197. package/src/shared/milestoneOrder.ts +0 -44
  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 -730
  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,36 @@
1
+ /**
2
+ * 読むだけの操作か(データのフォルダ・個人設定・ファイルを変えず、外の生成も始めない)。
3
+ * 登録が1つだけでプロジェクトが決まったとき(via: only)に、読むだけなら警告して続け、ほかは止めるために使う(main.ts)。
4
+ * 載っていない操作(新しいコマンド・知らないサブコマンド)は書く操作として扱う。サブコマンドの省略は各コマンドの既定に合わせる。
5
+ */
6
+ export function readsOnly(cmd, args) {
7
+ const sub = args[0];
8
+ switch (cmd) {
9
+ case "whoami":
10
+ case "progress":
11
+ case "ls":
12
+ case "list":
13
+ case "show":
14
+ case "find":
15
+ case "resolve":
16
+ case "notes":
17
+ case "drafts":
18
+ return true;
19
+ case "request":
20
+ case "req":
21
+ return sub === "ls" || sub === "list" || sub === "show";
22
+ case "milestone":
23
+ case "milestones":
24
+ return sub === undefined || sub === "ls" || sub === "list";
25
+ case "config":
26
+ return sub === undefined;
27
+ case "repo":
28
+ case "attach":
29
+ return sub === undefined || sub === "ls";
30
+ case "release-notes":
31
+ case "release-note":
32
+ return sub === undefined || sub === "ls" || sub === "list" || sub === "show" || sub === "export";
33
+ default:
34
+ return false;
35
+ }
36
+ }
@@ -0,0 +1,197 @@
1
+ import { readFile } from "node:fs/promises";
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";
10
+ /**
11
+ * p3 release-notes ... マイルストーンごとのリリースノート(規則と保存は core/releaseNotes)
12
+ *
13
+ * ls マイルストーンごとのノートの有無と要望の数
14
+ * show <id> 保存したノート(本文・版)と、対象の要望・警告
15
+ * generate <id> 機能の要約を生成して案を出す(保存しない。進み具合は stderr)
16
+ * save <id> 本文を保存する(--body 本文|- か --file。更新は --version 必須)
17
+ * export <id> 保存した本文だけを stdout に出す
18
+ * complete-requests <id> --based-on <hash> 対応済の要望を一括で完了済にする(判定と hash は show。頼めない・途中で止まったら非ゼロ)
19
+ */
20
+ export async function releaseNotesCommand(env) {
21
+ const { ctx, out, args, o, actor } = env;
22
+ const [sub = "ls", mid] = args;
23
+ const need = () => {
24
+ if (!mid)
25
+ throw new UsageError(`p3 release-notes ${sub} <マイルストーン>`);
26
+ return mid;
27
+ };
28
+ switch (sub) {
29
+ case "ls":
30
+ case "list": {
31
+ const r = await releaseOverview(ctx);
32
+ return out.result(r, () => {
33
+ const rows = r.milestones.map((m) => [
34
+ m.milestone,
35
+ m.title,
36
+ `要望 ${m.requests}`,
37
+ m.note.state === "ok" ? `ノートあり(${m.note.updatedAt.slice(0, 10)})` : m.note.state === "invalid" ? "ノートを読めません" : "ノートなし",
38
+ m.known ? "" : "マイルストーンが project.yaml にありません",
39
+ ]);
40
+ return [table(rows) || "マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース)", ...warnLines(r.warnings)].join("\n");
41
+ });
42
+ }
43
+ case "show": {
44
+ const d = await releaseNoteDetail(ctx, need());
45
+ return out.result(d, () => {
46
+ const lines = [`${d.material.milestone.id} ${d.material.milestone.title}${d.material.milestone.done ? "(リリース済み)" : ""}`, ""];
47
+ lines.push(...materialLines(d.material), "", ...completionLines(d.completion), "");
48
+ if (d.noteError)
49
+ lines.push(`ノート: 読めません(${d.noteError})`, " 直すまで新しく保存できません。frontmatter を直すか、本文を退避してファイルを消してください");
50
+ else if (!d.note)
51
+ lines.push("ノート: まだありません(p3 release-notes generate → save)");
52
+ else {
53
+ lines.push(`ノート: 更新 ${d.note.updatedAt}${d.note.updatedBy ? `(${d.note.updatedBy})` : ""}`, ` 版 ${d.note.version}(更新は --version にこの値)`);
54
+ if (d.materialChanged)
55
+ lines.push(" ※ 保存のあとで要望・タスクが変わっています(本文は変えていません。必要なら生成し直して保存してください)");
56
+ lines.push("", d.note.body || "(本文なし)");
57
+ }
58
+ return lines.join("\n");
59
+ });
60
+ }
61
+ case "generate": {
62
+ if (o.engine !== undefined && o.engine !== "codex" && o.engine !== "mock")
63
+ throw new UsageError("--engine は codex か mock");
64
+ const id = need();
65
+ const g = await startGeneration(ctx, id, actor, o.engine).catch((e) => {
66
+ // 始められなければ手で書く道を添える(実行中は別の理由なので添えない。終了コードは変えない)
67
+ if (e instanceof GenerationRejected && e.code !== "running")
68
+ e.message += `\n${manualSaveHint(id)}`;
69
+ throw e;
70
+ });
71
+ const gen = ctx.releaseGenerator;
72
+ // 進み具合は stderr(stdout は本文の案か JSON だけにする)
73
+ let shown = 0;
74
+ const tick = setInterval(() => (shown = flushLog(gen.get(g.id), shown)), 300);
75
+ // Ctrl-C で取り消す(保存したノートは変えない)。終わるまでは何度押しても取り消すだけ
76
+ const onInt = () => gen.cancel(g.id);
77
+ process.on("SIGINT", onInt);
78
+ const done = (await gen.wait(g.id));
79
+ clearInterval(tick);
80
+ process.removeListener("SIGINT", onInt);
81
+ flushLog(done, shown);
82
+ if (done.status !== "completed") {
83
+ if (out.json)
84
+ out.result(done, () => "");
85
+ else
86
+ process.stderr.write(`${failureLine(done)}\n`);
87
+ // 失敗したら手で書く道を stderr に出す(--json の stdout は変えない。取消は失敗と扱わない)
88
+ if (done.status === "failed")
89
+ process.stderr.write(`${manualSaveHint(done.milestone)}\n`);
90
+ return 1;
91
+ }
92
+ if (!out.json) {
93
+ process.stderr.write(`${summaryLines(done).join("\n")}\n`);
94
+ }
95
+ return out.result(done, () => done.markdown);
96
+ }
97
+ case "save": {
98
+ const body = o.file !== undefined ? await readFile(resolvePath(process.cwd(), o.file), "utf8") : o.body !== undefined ? readBody(o.body) : undefined;
99
+ if (body === undefined)
100
+ throw new UsageError("本文を --body 本文|- か --file ファイルで指定してください");
101
+ const r = await saveReleaseNote(ctx, need(), { body, title: o.title, basedOn: o["based-on"], version: o.version }, actor);
102
+ return out.result(r, () => [`保存しました: ${r.note.milestone} 版 ${r.note.version}`, ` ${ctx.ws.releaseNotes.path(r.note.milestone)}`, ...warnLines(r.warnings)].join("\n"));
103
+ }
104
+ case "export": {
105
+ const body = await exportReleaseNote(ctx, need());
106
+ if (out.json)
107
+ return out.result({ milestone: mid, body }, () => "");
108
+ process.stdout.write(body);
109
+ return 0;
110
+ }
111
+ case "complete-requests": {
112
+ const id = need();
113
+ const basedOn = o["based-on"];
114
+ if (!basedOn)
115
+ throw new UsageError(`判定を確かめた材料の hash を --based-on で指定してください(p3 release-notes show ${shellArg(id)} --json の completion.basedOn)`);
116
+ try {
117
+ const r = await completeMilestoneRequests(ctx, id, basedOn, actor);
118
+ out.result(r, () => [
119
+ r.completed.length ? `完了済にしました(${r.completed.length} 件):` : r.failed ? "完了済にした要望はありません" : "完了済にする要望はありません(変えていません)",
120
+ ...r.completed.map((t) => ` ${t.id} ${t.title}`),
121
+ ...(r.failed ? [`止まりました: ${r.failed.id}(${r.failed.reason})`, ...(r.notRun.length ? [`まだ変えていません: ${r.notRun.join(", ")}`] : []), `やり直すには show で読み直してから、表示された --based-on で実行してください`] : []),
122
+ ].join("\n"));
123
+ return r.failed ? (r.failed.code === "error" ? 1 : 3) : 0;
124
+ }
125
+ catch (e) {
126
+ if (!(e instanceof CompletionRejected))
127
+ throw e;
128
+ if (out.json)
129
+ out.result({ error: e.message, code: e.code, plan: e.plan }, () => "");
130
+ else
131
+ process.stderr.write(`${[e.message, ...completionLines(e.plan)].join("\n")}\n`);
132
+ return e.code === "material_changed" ? 3 : 1;
133
+ }
134
+ }
135
+ default:
136
+ throw new UsageError("p3 release-notes [ls | show <id> | generate <id> | save <id> | export <id> | complete-requests <id> --based-on <hash>]");
137
+ }
138
+ }
139
+ const warnLines = (ws) => ws.map((w) => ` ⚠ ${w.code}: ${w.message}`);
140
+ function materialLines(m) {
141
+ const rows = m.requests.map((r) => [
142
+ ` ${r.included ? "収録" : "対象外"}`,
143
+ r.id,
144
+ r.status,
145
+ `${r.tasks.filter((t) => t.hasRecord).length}/${r.tasks.length} 記録`,
146
+ r.title,
147
+ r.reason ? `(${r.reason})` : "",
148
+ ]);
149
+ return [
150
+ `対象の要望 ${m.requests.length} 件(収録 ${m.requests.filter((r) => r.included).length}) 材料 ${m.hash.slice(0, 12)}`,
151
+ ...(rows.length ? [table(rows)] : [" (このマイルストーンの要望はありません)"]),
152
+ ...warnLines([...m.warnings, ...m.requests.flatMap((r) => r.warnings)]),
153
+ ];
154
+ }
155
+ /** 要望を一括で完了済にできるか(show と、頼めなかったとき) */
156
+ function completionLines(p) {
157
+ const head = !p.ready
158
+ ? "要望の一括完了: できません(見送り以外の全要望が、全タスク完了の対応済か完了済になってから)"
159
+ : p.targets.length
160
+ ? `要望の一括完了: 対応済 ${p.targets.length} 件を完了済にできます(タスクの済みは変えません)`
161
+ : "要望の一括完了: 完了済にする要望はありません";
162
+ return [
163
+ head,
164
+ ...p.blockers.map((b) => ` ✕ ${b.target}: ${b.reason}`),
165
+ ...p.targets.map((t) => ` → ${t.id} ${t.title}`),
166
+ ...(p.ready && p.targets.length ? [` 実行: p3 release-notes complete-requests ${shellArg(p.milestone)} --based-on ${p.basedOn}`] : []),
167
+ ];
168
+ }
169
+ function flushLog(g, from) {
170
+ for (const e of g.log.slice(from))
171
+ process.stderr.write(`[${e.kind}] ${e.text}\n`);
172
+ return g.log.length;
173
+ }
174
+ /** 要約を生成できないときの、本文を手で書いて保存する道(Codex・Docker・ChatGPT は要らない) */
175
+ function manualSaveHint(mid) {
176
+ const m = shellArg(mid);
177
+ return [
178
+ "生成せずに、本文を手で書いて保存できます(Docker や ChatGPT の接続は要りません):",
179
+ ` p3 release-notes show ${m} # 材料(収録する要望と変更の記録)を確かめる`,
180
+ ` p3 release-notes save ${m} --file <本文.md> # 新しく保存する`,
181
+ ` 既にノートがあるときは、show で読んだ版を付けて更新します: p3 release-notes save ${m} --file <本文.md> --version <版>`,
182
+ ].join("\n");
183
+ }
184
+ function failureLine(g) {
185
+ if (g.status === "cancelled")
186
+ return "取り消しました(保存したノートは変えていません)";
187
+ return `生成できませんでした(${g.failure}): ${g.error}(保存したノートは変えていません)`;
188
+ }
189
+ function summaryLines(g) {
190
+ return [
191
+ `生成しました: ${g.id}(保存はしていません) 材料 ${g.materialHash.slice(0, 12)}`,
192
+ "出典:",
193
+ ...g.items.map((x, i) => ` ${i + 1}. ${x.sources.join(", ")}`),
194
+ ...warnLines(g.warnings),
195
+ `保存するときは本文を確かめてから: p3 release-notes save ${g.milestone} --file <本文.md> --based-on ${g.materialHash}`,
196
+ ];
197
+ }
@@ -0,0 +1,58 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { basename, dirname, extname, join, resolve } from "node:path";
3
+ import { ensureRenderImage, RenderError, renderHtml } from "../core/preflight/render.js";
4
+ import { UsageError } from "./project.js";
5
+ const USAGE = [
6
+ "p3 render <原稿.html> [--out 画像.png] [--width 1280] 自己完結した HTML / CSS を PNG にする(Docker が要る)",
7
+ "p3 render update 描画のイメージを今すぐ作り直す",
8
+ ].join("\n");
9
+ /**
10
+ * p3 render。Preflight の画面イメージと同じ描画(専用のコンテナ。ネットワークなし)で、手元の HTML を PNG にする。
11
+ * プロジェクトを決める前に動く。DevContainer の中から使うときは、原稿の隣に作る一時のフォルダにもパスの対応(codex.pathMap)が効く
12
+ */
13
+ export async function renderCommand(args, o, settings, cwd = process.cwd()) {
14
+ const [sub] = args;
15
+ const progress = (t) => process.stderr.write(`${t}\n`);
16
+ try {
17
+ if (sub === "update") {
18
+ const { image } = await ensureRenderImage({ force: true, onProgress: progress });
19
+ return { data: { ok: true, image }, text: `描画のイメージを作り直しました: ${image}` };
20
+ }
21
+ if (!sub || args.length > 1)
22
+ throw new UsageError(USAGE);
23
+ const src = resolve(cwd, sub);
24
+ const html = await readFile(src, "utf8").catch(() => {
25
+ throw new UsageError(`原稿が読めません: ${sub}`);
26
+ });
27
+ const out = resolve(cwd, o.out ?? join(dirname(src), `${basename(src, extname(src))}.png`));
28
+ const width = o.width === undefined ? 1280 : Number(o.width);
29
+ const [r] = await renderHtml([{ id: "page", html, width }], dirname(out), join(dirname(out), `.p3-render-out-${process.pid}`), {
30
+ pathMap: settings.codex.pathMap,
31
+ onProgress: progress,
32
+ }).then(async (rs) => {
33
+ // 一時の出力から、指定の名前に移す
34
+ const { rename, rm } = await import("node:fs/promises");
35
+ const tmp = join(dirname(out), `.p3-render-out-${process.pid}`);
36
+ try {
37
+ if (rs[0].ok)
38
+ await rename(rs[0].file, out);
39
+ }
40
+ finally {
41
+ await rm(tmp, { recursive: true, force: true });
42
+ }
43
+ return rs;
44
+ });
45
+ if (!r.ok)
46
+ return { data: { ok: false, error: r.error, blocked: r.blocked }, text: `描画できません: ${r.error}`, code: 1 };
47
+ const notes = [
48
+ r.clipped ? " 縦に長すぎるので上から切りました" : "",
49
+ r.blocked.length ? ` 止めた読み込み: ${r.blocked.join(", ")}` : "",
50
+ ].filter(Boolean);
51
+ return { data: { ok: true, file: out, clipped: r.clipped, blocked: r.blocked }, text: [`描画しました: ${out}`, ...notes].join("\n") };
52
+ }
53
+ catch (e) {
54
+ if (!(e instanceof RenderError))
55
+ throw e;
56
+ return { data: { ok: false, step: e.step, error: e.message }, text: `描画できません: ${e.message}`, code: 1 };
57
+ }
58
+ }
@@ -0,0 +1,191 @@
1
+ import { basename, relative } from "node:path";
2
+ import { REQUEST_STATUSES } from "../shared/types.js";
3
+ import {} from "../core/context.js";
4
+ import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, orderChildren, updateRequest } from "../core/requestOps.js";
5
+ import { hierarchyNow, resolvedIssue } from "../core/requestStatus.js";
6
+ import { hierarchyView } from "../core/hierarchy.js";
7
+ import { resolveRequestId } from "../core/ops.js";
8
+ import { table } from "./format.js";
9
+ import { requestWorkstreams, taskRepo } from "../shared/workTarget.js";
10
+ import { briefRequest, formatBriefRequest, formatFamily } from "./showView.js";
11
+ import { UsageError } from "./project.js";
12
+ import { tagsFrom } from "../shared/tags.js";
13
+ import { sortMilestones } from "../shared/milestoneOrder.js";
14
+ import { parse, splitPair, list, date, readBody, readAttachFiles } from "./args.js";
15
+ import { Output, formatEntity, deps, reopenedNote, warn } from "./output.js";
16
+ /** 要望(p3 request ...)とマイルストーン(p3 milestone ...)のコマンド。変更は server/requestOps.ts を通す */
17
+ // --- 要望 -----------------------------------------------------------------
18
+ export async function requestCommand(ctx, out, args, o, actor, requestArg, expectedRev) {
19
+ const [sub, ...rest] = args;
20
+ // 親は短い書き方(k7m3x)でもよい。解けなければそのまま渡し、規則(無い・形が違う)で断る
21
+ const parentArg = (raw) => resolveRequestId(ctx, raw) ?? raw;
22
+ switch (sub) {
23
+ case "new":
24
+ case "add": {
25
+ const title = rest.join(" ").trim();
26
+ if (!title)
27
+ throw new UsageError("タイトルを指定してください");
28
+ checkMilestone(ctx, o.milestone);
29
+ const files = await readAttachFiles(o.attach ?? []);
30
+ const r = await createRequest(ctx, { title, body: readBody(o.body), areas: o.area ?? [], tags: tagsFrom(o.tag ?? []), due: o.due && date(o.due), milestone: o.milestone, ...(o.parent ? { parent: parentArg(o.parent) } : {}) }, actor);
31
+ warn(r.warnings ?? []);
32
+ reopenedNote(undefined, r.reopenedAncestors);
33
+ const head = `作成: ${r.id} ${r.title}${r.parent ? `(${r.parent} の子)` : ""}\n ${relative(process.cwd(), ctx.ws.requests.path(r.id))}`;
34
+ if (!files.length)
35
+ return out.result(r, () => head);
36
+ // 確かめ済みなので通常は失敗しない。失敗しても要望は残し、付け直す方法を出す
37
+ const attachments = [];
38
+ const failed = [];
39
+ for (const f of files) {
40
+ try {
41
+ attachments.push(await ctx.preflight.addAttachment(r.id, { data: f.data, name: basename(f.path) }, actor));
42
+ }
43
+ catch (e) {
44
+ failed.push({ file: f.path, error: e.message });
45
+ }
46
+ }
47
+ out.result({ ...r, attachments, ...(failed.length ? { failedAttachments: failed } : {}) }, () => [
48
+ head,
49
+ ...attachments.map((a) => ` 添付: ${a.id} ${a.name}`),
50
+ ...failed.map((f) => ` 添付できませんでした: ${f.file}(${f.error})→ p3 attach add ${f.file} --req ${r.id}`),
51
+ ].join("\n"));
52
+ return failed.length ? 1 : 0;
53
+ }
54
+ case undefined:
55
+ case "ls":
56
+ case "list": {
57
+ const status = o.status?.split(",");
58
+ // --parent: 直下の子だけを、親の表示順(子の一覧・詳細・画面と同じ)で
59
+ const parent = o.parent === undefined ? undefined : parentArg(o.parent);
60
+ const reqs = (parent === undefined ? ctx.ws.requests.list() : hierarchyNow(ctx.ws).children(parent))
61
+ .filter((r) => !status || status.includes(r.status))
62
+ .filter((r) => !o.milestone || r.milestone === o.milestone)
63
+ .filter((r) => !o.tag?.length || o.tag.some((t) => r.tags.includes(t)));
64
+ return out.result(reqs, () => table(reqs.map((r) => [r.id, r.status, r.title, r.milestone ?? "", r.due ?? "", r.tags.map((t) => `#${t}`).join(" "), r.parent ? `↑${r.parent}` : ""])) || "要望はありません");
65
+ }
66
+ case "show": {
67
+ const rid = requestArg(rest[0]);
68
+ const r = ctx.ws.requests.require(rid);
69
+ const family = await hierarchyView(ctx.ws, rid);
70
+ if (o.brief) {
71
+ const view = { ...briefRequest(ctx, r, resolvedIssue(ctx.ws, r)), ...family };
72
+ return out.result(view, () => formatBriefRequest(view));
73
+ }
74
+ const file = relative(process.cwd(), ctx.ws.requests.path(rid));
75
+ const issue = resolvedIssue(ctx.ws, r);
76
+ const branches = requestWorkstreams(r);
77
+ const multi = ctx.ws.project.repos.length > 0;
78
+ return out.result({ item: r, workstreams: branches, tasks: ctx.ws.tasksOf(rid).list(), file, ...family, ...(issue ? { issue } : {}) }, () => {
79
+ const tasks = ctx.ws.tasksOf(rid).list();
80
+ return [
81
+ issue ? `※ ${issue}\n` : "",
82
+ ...family.hierarchyIssues.map((i) => `※ ${i.message}\n`),
83
+ formatEntity(ctx, r, file),
84
+ ...formatFamily(family),
85
+ ...(Object.keys(branches).length
86
+ ? ["", "ブランチ(作業先のリポジトリごと):", ...Object.entries(branches).map(([name, w]) => ` ${name} ${w.branch}`)]
87
+ : []),
88
+ "",
89
+ `タスク (${tasks.length}):`,
90
+ table(tasks.map((t) => [` ${t.id}`, t.status, ...(multi ? [taskRepo(t) ?? "(なし)"] : []), t.title, deps(t)])) || " (なし)",
91
+ ].join("\n");
92
+ });
93
+ }
94
+ case "set": {
95
+ // 1つ目が要望の参照なら対象、キー=値なら今の要望
96
+ const explicit = rest[0] && !rest[0].includes("=") ? rest.shift() : undefined;
97
+ const rid = requestArg(explicit);
98
+ const patch = {};
99
+ for (const pair of rest) {
100
+ const [key, value] = splitPair(pair);
101
+ if (key === "title")
102
+ patch.title = value;
103
+ else if (key === "areas")
104
+ patch.areas = list(value);
105
+ else if (key === "tags")
106
+ patch.tags = list(value);
107
+ else if (key === "due")
108
+ patch.due = value ? date(value) : undefined;
109
+ else if (key === "milestone")
110
+ patch.milestone = value || undefined;
111
+ else if (key === "parent")
112
+ patch.parent = value ? parentArg(value) : undefined;
113
+ else if (key === "status") {
114
+ if (!REQUEST_STATUSES.includes(value))
115
+ throw new UsageError(`要望のステータスは ${REQUEST_STATUSES.join(", ")}`);
116
+ patch.status = value;
117
+ }
118
+ else
119
+ throw new UsageError("変更できるキー: title status due milestone tags areas parent");
120
+ }
121
+ if (o.body !== undefined)
122
+ patch.body = readBody(o.body);
123
+ if (o.tag) {
124
+ if (patch.tags)
125
+ throw new UsageError("tags= と --tag は一緒に使えません(カンマを含む値は --tag で)");
126
+ patch.tags = tagsFrom(o.tag);
127
+ }
128
+ if (!Object.keys(patch).length)
129
+ throw new UsageError("キー=値 を指定してください");
130
+ const next = await updateRequest(ctx, rid, patch, { expectedRev, actor });
131
+ warn(next.warnings ?? []);
132
+ reopenedNote(undefined, next.reopenedAncestors);
133
+ return out.result(next, () => `更新: ${next.id} (rev ${next.rev}) ${Object.keys(patch).join(", ")}`);
134
+ }
135
+ case "order": {
136
+ // p3 request order <親> <子...>: 直下の子の表示順を保存する(全部の子を並べる)。子を省くと今の並びを出す
137
+ const [head, ...kids] = rest;
138
+ const rid = requestArg(head);
139
+ if (!kids.length) {
140
+ const now = hierarchyNow(ctx.ws).children(rid);
141
+ return out.result({ id: rid, children: now.map((c) => c.id) }, () => (now.length ? now.map((c, i) => `${i + 1}. ${c.id} ${c.title}`).join("\n") : `${rid} には子の要望がありません`));
142
+ }
143
+ const r = await orderChildren(ctx, rid, kids.map((k) => resolveRequestId(ctx, k) ?? k), { expectedRev, actor });
144
+ const now = hierarchyNow(ctx.ws).children(rid);
145
+ return out.result({ id: r.id, rev: r.rev, children: now.map((c) => c.id) }, () => [`子の表示順を保存しました: ${r.id} (rev ${r.rev})`, ...now.map((c, i) => ` ${i + 1}. ${c.id} ${c.title}`)].join("\n"));
146
+ }
147
+ case "archive": {
148
+ const rid = requestArg(rest[0]);
149
+ await archiveRequest(ctx, rid);
150
+ return out.result({ archived: rid }, () => `アーカイブ: ${rid}(requests/.archive/ へ)`);
151
+ }
152
+ default:
153
+ throw new UsageError("p3 request [new | ls | show | set | order | archive]");
154
+ }
155
+ }
156
+ // --- マイルストーン -----------------------------------------------------------
157
+ /** マイルストーン(リリース)。複数の要望をまとめる単位で、project.yaml に書く */
158
+ export async function milestoneCommand(ctx, out, args, o) {
159
+ const [sub, id] = args;
160
+ const ms = ctx.ws.project.milestones;
161
+ const count = (mid) => ctx.ws.requests.list().filter((r) => r.milestone === mid).length;
162
+ if (sub === "add" || sub === "set") {
163
+ if (!id || !/^[A-Za-z0-9._-]+$/.test(id))
164
+ throw new UsageError(`p3 milestone ${sub} <id>(英数字と . _ -)`);
165
+ const cur = ms.find((m) => m.id === id);
166
+ if (sub === "add" && cur)
167
+ throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
168
+ if (sub === "set" && !cur)
169
+ throw new UsageError(`マイルストーンがありません: ${id}`);
170
+ const next = {
171
+ id,
172
+ title: o.title ?? cur?.title ?? id,
173
+ due: o.due !== undefined ? (o.due ? date(o.due) : undefined) : cur?.due,
174
+ done: o.done ?? cur?.done,
175
+ };
176
+ await ctx.ws.saveProject({ milestones: cur ? ms.map((m) => (m.id === id ? next : m)) : [...ms, next] });
177
+ return out.result(next, () => `${cur ? "更新" : "追加"}しました: ${next.title}(${id}${next.due ? ` · ${next.due}` : ""})`);
178
+ }
179
+ if (sub === "rm" || sub === "remove") {
180
+ if (!id || !ms.some((m) => m.id === id))
181
+ throw new UsageError(`マイルストーンがありません: ${id ?? ""}`);
182
+ await checkMilestoneRemoval(ctx, ms.filter((m) => m.id !== id).map((m) => m.id));
183
+ await ctx.ws.saveProject({ milestones: ms.filter((m) => m.id !== id) });
184
+ return out.result({ removed: id }, () => `外しました: ${id}`);
185
+ }
186
+ if (sub && sub !== "ls" && sub !== "list")
187
+ throw new UsageError("p3 milestone [ls | add <id> | set <id> | rm <id>]");
188
+ const shown = sortMilestones(ms);
189
+ return out.result(shown, () => table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
190
+ "マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース --due 2026-11-30)");
191
+ }
@@ -0,0 +1,100 @@
1
+ import { absRef, parseRef } from "../shared/refs.js";
2
+ import { supersededWarnings } from "../core/supersede.js";
3
+ import { table } from "./format.js";
4
+ import { taskWork } from "../core/workTargets.js";
5
+ import { requestWorkstreams } from "../shared/workTarget.js";
6
+ export function dependencyStates(ctx, task) {
7
+ return task.relations
8
+ .filter((r) => r.type === "depends_on")
9
+ .map((r) => {
10
+ const ref = absRef(r.target, task.request) ?? r.target;
11
+ const p = parseRef(ref);
12
+ const target = p?.task ? ctx.ws.task(ref) : ctx.ws.requests.get(ref);
13
+ return { ref, title: target?.title ?? null, status: target?.status ?? null };
14
+ });
15
+ }
16
+ /** タスクの詳細で共通に出す項目(通常・短い出力の両方) */
17
+ export function taskExtras(ctx, task, marks) {
18
+ const superseded = marks.get(task.ref) ?? [];
19
+ const warnings = supersededWarnings(superseded, task.ref);
20
+ return { superseded, dependencies: dependencyStates(ctx, task), warnings };
21
+ }
22
+ const BRIEF_TASK_KEYS = ["id", "ref", "request", "title", "status", "body", "rev", "outputs", "relations"];
23
+ export function briefTask(ctx, task, marks) {
24
+ const item = Object.fromEntries(BRIEF_TASK_KEYS.map((k) => [k, task[k]]));
25
+ item.relations = task.relations.filter((r) => r.type === "depends_on");
26
+ if (task.repoOutputs?.length)
27
+ item.repoOutputs = task.repoOutputs;
28
+ // 変更の記録(完了したタスク)。経緯を知るために読む
29
+ if (task.record)
30
+ item.record = task.record;
31
+ // 着手先: 作業先のリポジトリとそのブランチ(作業先なしは repo: null)
32
+ return { item, work: taskWork(ctx.ws, task), ...taskExtras(ctx, task, marks) };
33
+ }
34
+ export function formatBriefTask(view) {
35
+ const { item, work, dependencies, warnings } = view;
36
+ const short = (ref) => (ref.startsWith(`${item.request}/`) ? ref.slice(item.request.length + 1) : ref);
37
+ const lines = [`${item.ref} ${item.title}`, ` status ${item.status} rev ${item.rev}`];
38
+ lines.push(` 作業先 ${work.repo ? `${work.repo}${work.branch ? ` branch ${work.branch}` : "(ブランチなし)"}${work.registered ? "" : ` ※このマシンのパスが未登録(p3 repo path ${work.repo} <パス>)`}` : "なし"}`);
39
+ if (dependencies.length) {
40
+ lines.push(` 依存 ${dependencies.map((d) => `${short(d.ref)} ${d.status ?? "(状態不明)"}`).join(" / ")}`);
41
+ }
42
+ for (const o of item.outputs)
43
+ lines.push(` 成果物 ${o}`);
44
+ for (const o of item.repoOutputs ?? [])
45
+ lines.push(` 成果物 ${o.repo}: ${o.output}`);
46
+ for (const w of warnings)
47
+ lines.push(`※ ${w.message}`);
48
+ if (item.body.trim())
49
+ lines.push("", item.body.trim());
50
+ if (item.record)
51
+ lines.push("", "## 変更の記録", item.record);
52
+ return lines.join("\n");
53
+ }
54
+ export function briefRequest(ctx, r, issue) {
55
+ const item = {
56
+ id: r.id,
57
+ title: r.title,
58
+ status: r.status,
59
+ ...(r.parent ? { parent: r.parent } : {}),
60
+ body: r.body,
61
+ rev: r.rev,
62
+ ...(r.workstreams ? { workstreams: r.workstreams } : {}),
63
+ };
64
+ const branches = requestWorkstreams(r);
65
+ const tasks = ctx.ws
66
+ .tasksOf(r.id)
67
+ .list()
68
+ .map((t) => ({ id: t.id, ref: t.ref, title: t.title, status: t.status, repo: t.repo }));
69
+ return { item, branches, tasks, ...(issue ? { issue } : {}) };
70
+ }
71
+ /** 親子の行(祖先と直下の子。無ければ何も出さない) */
72
+ export function formatFamily(f) {
73
+ return [
74
+ ...(f.ancestors.length ? [` 親 ${f.ancestors.map((a) => `${a.id} ${a.title}`).join(" > ")}`] : []),
75
+ ...(f.children.length
76
+ ? ["", `子の要望 (${f.children.length}、表示順。実行の順ではない):`, table(f.children.map((c) => [` ${c.id}`, c.status, `${c.tasks.done}/${c.tasks.total}`, c.title]))]
77
+ : []),
78
+ ];
79
+ }
80
+ export function formatBriefRequest(view) {
81
+ const { item, branches, tasks, issue } = view;
82
+ const family = view.ancestors && view.children && view.hierarchyIssues ? view : undefined;
83
+ const names = Object.keys(branches);
84
+ // ブランチは作業先ごと
85
+ const branchLine = "";
86
+ return [
87
+ issue ? `※ ${issue}` : "",
88
+ ...(family?.hierarchyIssues.map((i) => `※ ${i.message}`) ?? []),
89
+ `${item.id} ${item.title}`,
90
+ ` status ${item.status} rev ${item.rev}${branchLine}`,
91
+ ...(branchLine ? [] : names.map((n) => ` branch ${n}: ${branches[n].branch}`)),
92
+ ...(family ? formatFamily(family) : []),
93
+ item.body.trim() ? `\n${item.body.trim()}` : "",
94
+ "",
95
+ `タスク (${tasks.length}):`,
96
+ table(tasks.map((t) => [` ${t.id}`, t.status, t.repo ?? "(作業先なし)", t.title])) || " (なし)",
97
+ ]
98
+ .filter((l, i) => l !== "" || i > 1)
99
+ .join("\n");
100
+ }