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