@infodb/p3 0.2.0 → 0.4.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 (82) hide show
  1. package/README.md +6 -1
  2. package/dist/web/assets/{Outputs-Ni3pNuGU.js → Outputs-5Hby-S5Q.js} +1 -1
  3. package/dist/web/assets/{RequestStatus-K8TZwpur.js → RequestStatus-CTkGjT02.js} +1 -1
  4. package/dist/web/assets/TagInput-Rj3PNOAF.js +1 -0
  5. package/dist/web/assets/TaskDrawer-DtPhiYxP.js +3 -0
  6. package/dist/web/assets/_requestId-CGvAfIkB.js +30 -0
  7. package/dist/web/assets/_requestId-DxfYhgAq.js +1 -0
  8. package/dist/web/assets/board-wt47lfrE.js +1 -0
  9. package/dist/web/assets/copy-CKsXEjMi.js +1 -0
  10. package/dist/web/assets/directTask-Dk3H5Q2B.js +1 -0
  11. package/dist/web/assets/done-C9Ct7ssb.js +1 -0
  12. package/dist/web/assets/draft-CfJeyLOl.js +1 -0
  13. package/dist/web/assets/index-BTFL2rpp.js +12 -0
  14. package/dist/web/assets/index-DAyBsvua.css +2 -0
  15. package/dist/web/assets/milestoneOrder-N7b5XFJP.js +1 -0
  16. package/dist/web/assets/new-e4ID2vQV.js +1 -0
  17. package/dist/web/assets/preflightInput-DMxqnvF8.js +2 -0
  18. package/dist/web/assets/preload-helper-DhIyFaOW.js +1 -0
  19. package/dist/web/assets/release-notes-CQ0d2r0k.js +3 -0
  20. package/dist/web/assets/requestData-BDZqyl35.js +1 -0
  21. package/dist/web/assets/routes-Bipv3lwJ.js +2 -0
  22. package/dist/web/assets/settings-Dwh8fj6p.js +1 -0
  23. package/dist/web/assets/ui-DdOGYj9z.js +1 -0
  24. package/dist/web/assets/workTarget-Cijqq4yH.js +1 -0
  25. package/dist/web/index.html +4 -5
  26. package/docs/architecture.md +80 -15
  27. package/docs/development.md +83 -7
  28. package/docs/how-to-use.md +159 -15
  29. package/docs/installation.md +142 -5
  30. package/docs/publishing.md +27 -3
  31. package/package.json +8 -5
  32. package/skills/p3/SKILL.md +21 -8
  33. package/src/cli/args.ts +9 -2
  34. package/src/cli/help.ts +12 -3
  35. package/src/cli/main.ts +75 -5
  36. package/src/cli/output.ts +18 -0
  37. package/src/cli/preflightCommands.ts +10 -2
  38. package/src/cli/project.ts +268 -101
  39. package/src/cli/releaseNotesCommands.ts +63 -4
  40. package/src/cli/requestCommands.ts +4 -2
  41. package/src/cli/taskCommands.ts +1 -1
  42. package/src/core/context.ts +3 -2
  43. package/src/core/preflight/codexEngine.ts +2 -1
  44. package/src/core/preflight/render-image/Dockerfile +3 -0
  45. package/src/core/preflight/render-image/fonts-ja.conf +28 -0
  46. package/src/core/preflight/render-image/render.mjs +10 -1
  47. package/src/core/preflight/render.ts +5 -2
  48. package/src/core/preflight/service.ts +19 -2
  49. package/src/core/projectRegistry.ts +264 -0
  50. package/src/core/releaseNotes/completeRequests.ts +102 -0
  51. package/src/core/releaseNotes/generate.ts +12 -0
  52. package/src/core/releaseNotes/service.ts +9 -5
  53. package/src/core/store/locate.ts +3 -3
  54. package/src/core/userConfig.ts +25 -0
  55. package/src/server/api/chatgptRoutes.ts +6 -5
  56. package/src/server/api/manifest.ts +17 -1
  57. package/src/server/api/projectsRoutes.ts +89 -0
  58. package/src/server/api/releaseNoteRoutes.ts +11 -0
  59. package/src/server/api/routes.ts +33 -25
  60. package/src/server/server.ts +74 -15
  61. package/src/shared/directTask.ts +20 -0
  62. package/src/shared/milestoneOrder.ts +44 -0
  63. package/src/shared/types.ts +31 -1
  64. package/dist/web/assets/TagInput-BICKVH2x.js +0 -1
  65. package/dist/web/assets/TaskDrawer-BkDIstIN.js +0 -3
  66. package/dist/web/assets/_requestId-B5O_ytaq.js +0 -1
  67. package/dist/web/assets/_requestId-C66puEMO.js +0 -30
  68. package/dist/web/assets/board-CbfDjkls.js +0 -1
  69. package/dist/web/assets/copy-B1ZbihKL.js +0 -2
  70. package/dist/web/assets/done-CPQbCFHg.js +0 -1
  71. package/dist/web/assets/draft-dT3gLDIt.js +0 -1
  72. package/dist/web/assets/index-BUcs2J6N.js +0 -12
  73. package/dist/web/assets/index-C3DkqwJ9.css +0 -2
  74. package/dist/web/assets/link-_s8ndNKS.js +0 -1
  75. package/dist/web/assets/new-T60RB7de.js +0 -1
  76. package/dist/web/assets/preload-helper-dXqN7N-I.js +0 -1
  77. package/dist/web/assets/release-notes-DxrPhDbt.js +0 -3
  78. package/dist/web/assets/requestData-D8ZiSZss.js +0 -1
  79. package/dist/web/assets/routes-D9ZxXoLk.js +0 -2
  80. package/dist/web/assets/settings-DsHVyqzJ.js +0 -1
  81. package/dist/web/assets/supersede-CLXlhCq0.js +0 -1
  82. package/dist/web/assets/ui-Cvke4y4X.js +0 -1
@@ -8,6 +8,7 @@ import { requestWorkstreams, taskRepo } from "../shared/workTarget.ts";
8
8
  import { briefRequest, formatBriefRequest } from "./showView.ts";
9
9
  import { UsageError } from "./project.ts";
10
10
  import { tagsFrom } from "../shared/tags.ts";
11
+ import { sortMilestones } from "../shared/milestoneOrder.ts";
11
12
  import { parse, splitPair, list, date, readBody, readAttachFiles } from "./args.ts";
12
13
  import { Output, formatEntity, deps } from "./output.ts";
13
14
 
@@ -160,10 +161,11 @@ export async function milestoneCommand(ctx: P3Context, out: Output, args: string
160
161
  return out.result({ removed: id }, () => `外しました: ${id}`);
161
162
  }
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);
163
165
  return out.result(
164
- ms,
166
+ shown,
165
167
  () =>
166
- table(ms.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
168
+ table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
167
169
  "マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース --due 2026-11-30)",
168
170
  );
169
171
  }
@@ -16,7 +16,7 @@ import { requestCommand } from "./requestCommands.ts";
16
16
 
17
17
  const RECORD_REQUIRED =
18
18
  "AI が完了にするときは --record で変更の記録を残してください(何を変えたか・なぜ・入れた決まり・やめたもの。Markdown。- で標準入力)\n" +
19
- " 例: p3 move T003 done --output <URL> --record - < record.md";
19
+ " 例: p3 move T003 done --output <成果物(変えたファイルや説明。URL は後から足せます)> --record - < record.md";
20
20
 
21
21
  export async function taskCommand(cmd: string, env: CommandEnv): Promise<number | undefined> {
22
22
  const { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd } = env;
@@ -33,7 +33,7 @@ export interface P3Context {
33
33
  */
34
34
  export async function openProject(
35
35
  dataDir: string,
36
- opts: { repos?: Record<string, string>; settings?: MachineSettings | SettingsSource; projectName?: string } = {},
36
+ opts: { repos?: Record<string, string>; settings?: MachineSettings | SettingsSource; projectName?: string; chatgpt?: ChatGptAccount } = {},
37
37
  ): Promise<P3Context> {
38
38
  // データのフォルダと project.yaml が無ければ、空のプロジェクトとして開かずに止める(何も作らない)
39
39
  await checkDataDir(dataDir, opts.projectName);
@@ -44,7 +44,8 @@ export async function openProject(
44
44
  await ws.load();
45
45
  // 既定は Codex(ChatGPT プランか旧来の auth.json。どちらも無ければ使えない理由と次にすることを出す)。
46
46
  // Mock は preflight.engine: mock(P3_PREFLIGHT_ENGINE=mock)か --engine mock で明示したときだけ(認証の失敗を Mock の成功に見せない)
47
- const chatgpt = chatgptAccount();
47
+ // プロジェクトを跨ぐ serve では、サインインの待ち受けを全プロジェクトで1つにするため外から渡す
48
+ const chatgpt = opts.chatgpt ?? chatgptAccount();
48
49
  const codex = new CodexWorkspaceEngine({ load: async () => codexConfig(await source.get()), account: chatgpt });
49
50
  const engines: Partial<Record<PreflightEngine["name"], PreflightEngine>> = { codex, mock: new MockEngine() };
50
51
  const preflight = new PreflightService(ws, engines, {
@@ -629,7 +629,8 @@ function uiSection(paths: ContainerPaths) {
629
629
  日本語のラベル・項目・配置・主な操作(ボタン・リンク)・前提(仮のデータなど)が読めるように書いてください。
630
630
  見た目の作り込みより、何がどこにあるかが分かることを優先します。複数のタスク案を1画面にまとめてもよいが、drafts で対応を示してください。
631
631
  - 自己完結した HTML と <style> の CSS だけで書いてください。スクリプト・onclick などの属性・外のファイルや URL の参照(画像・CSS・フォント・
632
- @import・相対パス)は使えません(P3 が断ります)。画像が要るなら data: の PNG / JPEG / SVG にしてください。フォントは指定しなくても日本語が出ます。
632
+ @import・相対パス)は使えません(P3 が断ります)。画像が要るなら data: の PNG / JPEG / SVG にしてください。フォントは指定しなくても日本語のゴシック体(sans-serif)で描きます。
633
+ 明朝体・等幅が要るところだけ serif(明朝体にするなら "Noto Serif JP" などの名前)・monospace を指定してください。
633
634
  - PNG は Codex の終了後に P3 が原稿から描いて ui/index.json に書き足します。あなたは PNG を作らず、画像を見たとも書かないでください。
634
635
  - 再評価で前回の画面イメージがあれば(引き継ぎに書いてあります)、それは前回の提案で、今の画面の証拠ではありません。
635
636
  変えた案に合わせて、今回の run の ui/ に原稿を書き直してください(前回のファイルは書き換えない)。
@@ -3,6 +3,8 @@
3
3
  # Codex のコンテナとは別のイメージ。P3(ホストのプロセス)が docker run で動かし、
4
4
  # ネットワークなし・認証情報なし・リポジトリなしで、確かめた原稿(読むだけ)と出力のフォルダだけをマウントする。
5
5
  # Playwright と Chromium(headless shell)の版は固定し、日本語のフォント(Noto CJK, SIL Open Font License 1.1)を入れる。
6
+ # 日本語の既定と、イメージに無い日本語のフォント名は fonts-ja.conf で Noto CJK JP にする(Playwright の依存で入る
7
+ # 中国語の字形のフォントが先に選ばれないように)。
6
8
  FROM node:22-bookworm-slim
7
9
 
8
10
  ENV PLAYWRIGHT_BROWSERS_PATH=/ms-playwright \
@@ -16,6 +18,7 @@ RUN npm install --no-save --no-audit --no-fund --no-package-lock playwright@1.63
16
18
  && rm -rf /var/lib/apt/lists/* /root/.npm /tmp/* \
17
19
  && useradd --create-home --uid 10001 render
18
20
 
21
+ COPY fonts-ja.conf /etc/fonts/conf.d/99-p3-ja.conf
19
22
  COPY render.mjs /render/render.mjs
20
23
 
21
24
  USER render
@@ -0,0 +1,28 @@
1
+ <?xml version="1.0"?>
2
+ <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
3
+ <!--
4
+ 画面イメージの描画で、日本語を Noto CJK JP で描く(Dockerfile が /etc/fonts/conf.d/ に置く)。
5
+ Playwright の依存で入る WenQuanYi Zen Hei(中国語の字形)が総称の既定に先に来るので、総称と、イメージに無い日本語の
6
+ フォント名を Noto CJK JP に寄せる。原稿が明示したほかのフォント(Noto Sans CJK SC など)と埋め込みのフォントには触れない。
7
+ -->
8
+ <fontconfig>
9
+ <!-- 総称 -->
10
+ <alias binding="strong"><family>sans-serif</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
11
+ <alias binding="strong"><family>system-ui</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
12
+ <alias binding="strong"><family>serif</family><prefer><family>Noto Serif CJK JP</family></prefer></alias>
13
+ <alias binding="strong"><family>monospace</family><prefer><family>Noto Sans Mono CJK JP</family></prefer></alias>
14
+
15
+ <!-- イメージに無い日本語のゴシック体 -->
16
+ <alias binding="strong"><family>Noto Sans JP</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
17
+ <alias binding="strong"><family>Hiragino Sans</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
18
+ <alias binding="strong"><family>Hiragino Kaku Gothic ProN</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
19
+ <alias binding="strong"><family>ヒラギノ角ゴ ProN</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
20
+ <alias binding="strong"><family>Yu Gothic</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
21
+ <alias binding="strong"><family>游ゴシック</family><prefer><family>Noto Sans CJK JP</family></prefer></alias>
22
+
23
+ <!-- イメージに無い日本語の明朝体 -->
24
+ <alias binding="strong"><family>Noto Serif JP</family><prefer><family>Noto Serif CJK JP</family></prefer></alias>
25
+ <alias binding="strong"><family>Hiragino Mincho ProN</family><prefer><family>Noto Serif CJK JP</family></prefer></alias>
26
+ <alias binding="strong"><family>Yu Mincho</family><prefer><family>Noto Serif CJK JP</family></prefer></alias>
27
+ <alias binding="strong"><family>游明朝</family><prefer><family>Noto Serif CJK JP</family></prefer></alias>
28
+ </fontconfig>
@@ -5,6 +5,15 @@
5
5
  import { readFile } from "node:fs/promises";
6
6
  import { chromium } from "playwright";
7
7
 
8
+ // フォントを指定していない原稿も、ゴシック体(sans-serif)で描く(Chromium の既定は Times New Roman で、欧文が明朝系になる)。
9
+ // 原稿の先頭(doctype の後)に置き、詳細度 0 にするので、原稿のどの指定よりも弱い
10
+ const BASE_STYLE = "<style>:where(html){font-family:sans-serif}</style>";
11
+ const DOCTYPE = /^\uFEFF?\s*(?:<!--[\s\S]*?-->\s*)*<!doctype[^>]*>/i;
12
+ const withBaseStyle = (html) => {
13
+ const m = DOCTYPE.exec(html);
14
+ return m ? m[0] + BASE_STYLE + html.slice(m[0].length) : BASE_STYLE + html;
15
+ };
16
+
8
17
  const MAX_HEIGHT = Number(process.env.P3_RENDER_MAX_HEIGHT ?? 16384);
9
18
  const PAGE_TIMEOUT = Number(process.env.P3_RENDER_PAGE_TIMEOUT ?? 20000);
10
19
 
@@ -31,7 +40,7 @@ try {
31
40
  });
32
41
  const page = await context.newPage();
33
42
  page.setDefaultTimeout(PAGE_TIMEOUT);
34
- await page.setContent(await readFile(`/in/${job.file}`, "utf8"), { waitUntil: "load", timeout: PAGE_TIMEOUT });
43
+ await page.setContent(withBaseStyle(await readFile(`/in/${job.file}`, "utf8")), { waitUntil: "load", timeout: PAGE_TIMEOUT });
35
44
  const path = `/out/${job.id}.png`;
36
45
  await page.screenshot({ path, fullPage: true, animations: "disabled", timeout: PAGE_TIMEOUT });
37
46
  // 縦に長すぎるときは上から切る
@@ -104,10 +104,13 @@ export function checkHtml(html: string): string[] {
104
104
 
105
105
  // --- イメージ ----------------------------------------------------------------
106
106
 
107
- /** イメージの名前(Dockerfile と描画の中身から決める。中身が変われば別の名前になり、作り直す) */
107
+ /** イメージの資材(render-image/ の中。全部をイメージの名前の hash に入れる) */
108
+ export const RENDER_IMAGE_FILES = ["Dockerfile", "fonts-ja.conf", "render.mjs"] as const;
109
+
110
+ /** イメージの名前(資材の中身から決める。どれかが変われば別の名前になり、作り直す) */
108
111
  export async function renderImageTag(dir = RENDER_IMAGE_DIR): Promise<string> {
109
112
  const h = createHash("sha256");
110
- for (const f of ["Dockerfile", "render.mjs"]) h.update(await readFile(join(dir, f)));
113
+ for (const f of RENDER_IMAGE_FILES) h.update(await readFile(join(dir, f)));
111
114
  return `infodb-p3-render:${h.digest("hex").slice(0, 12)}`;
112
115
  }
113
116
 
@@ -31,6 +31,7 @@ import { extractXlsx, XlsxError } from "./xlsx.ts";
31
31
  import { applyUiShortage, IMAGE_TYPES, loadUiMaterials, readUiImage, UI_DIR, UiMaterialError } from "./uiMaterials.ts";
32
32
  import { compareInput, normalizeInput, renderRequestSnapshot, runInput, StaleInputError } from "./input.ts";
33
33
  import { changedLabel } from "../../shared/preflightInput.ts";
34
+ import { PREFLIGHT_CANCELLED } from "../../shared/directTask.ts";
34
35
 
35
36
  /** 始められない理由をそのまま失敗にするエンジン(run の記録とログに残すため) */
36
37
  const failing = (name: PreflightEngine["name"], message: string): PreflightEngine => ({
@@ -39,6 +40,9 @@ const failing = (name: PreflightEngine["name"], message: string): PreflightEngin
39
40
  run: async () => Promise.reject(new Error(message)),
40
41
  });
41
42
 
43
+ /** 同じ要望の Preflight が実行中(エンジンを使えないのとは別) */
44
+ export class PreflightBusyError extends Error {}
45
+
42
46
  /** タスク案の題が、編集を始めたあとに外で変わった(409 code: rev_conflict。current に今の案) */
43
47
  export class DraftConflictError extends Error {
44
48
  constructor(readonly current: ProposedTask) {
@@ -130,7 +134,7 @@ export class PreflightService {
130
134
  const input = normalizeInput(current);
131
135
  const request: Request = { ...current, ...input };
132
136
  if ([...this.active.values()].some((a) => a.run.requestId === requestId)) {
133
- throw new Error(`${requestId} の preflight は実行中です`);
137
+ throw new PreflightBusyError(`${requestId} の preflight は実行中です`);
134
138
  }
135
139
  // 既定のエンジンは始めるたびに個人設定から決める。読めなければ、この run を設定のエラーとして失敗にする
136
140
  // (古い設定や Mock に落とさない。serve とほかの操作は続ける)
@@ -228,6 +232,18 @@ export class PreflightService {
228
232
  this.active.get(runId)?.abort.abort();
229
233
  }
230
234
 
235
+ /** 実行中の run の数 */
236
+ running(): number {
237
+ return this.active.size;
238
+ }
239
+
240
+ /** 実行中の run が全部終わるまで待つ(cancel: 先に全部を取り消す)。serve を止める・登録から外れたプロジェクトを閉じる前に */
241
+ async settle(opts: { cancel?: boolean } = {}): Promise<void> {
242
+ const jobs = [...this.active.values()];
243
+ if (opts.cancel) for (const j of jobs) j.abort.abort();
244
+ await Promise.allSettled(jobs.map((j) => j.done));
245
+ }
246
+
231
247
  private log(run: PreflightRun, e: Omit<PreflightLogEntry, "at">) {
232
248
  // トークンらしいもの(Codex のエラーが一部を見せるキーなど)は残さない
233
249
  const entry = { ...e, text: redact(e.text), at: nowIso() };
@@ -292,7 +308,8 @@ export class PreflightService {
292
308
  } catch (e) {
293
309
  run.status = "failed";
294
310
  run.ui = withCurrent({ status: "missing", reason: "評価が終わらなかったので、画面資料を取り込んでいません", targets: [], items: [], problems: [] }, run);
295
- run.error = redact((e as Error).message);
311
+ // 取消はエンジンによらず同じ言い方で残す(失敗とは分けて扱う。shared/directTask.ts)
312
+ run.error = signal.aborted ? PREFLIGHT_CANCELLED : redact((e as Error).message);
296
313
  this.log(run, { kind: "error", text: run.error });
297
314
  } finally {
298
315
  run.finishedAt = nowIso();
@@ -0,0 +1,264 @@
1
+ import { createHash } from "node:crypto";
2
+ import { realpath } from "node:fs/promises";
3
+ import type { ChatGptAccount } from "./chatgpt.ts";
4
+ import { openProject, type P3Context } from "./context.ts";
5
+ import type { SettingsSource } from "./machineSettings.ts";
6
+ import { inspectUserProjects, PROJECT_NAME, userConfigPath, type InvalidProjectEntry, type UserProject } from "./userConfig.ts";
7
+
8
+ /**
9
+ * プロジェクトを跨ぐ serve(p3 serve --all-projects)が扱うプロジェクト。個人設定に登録した名前だけを対象にし、
10
+ * 任意のパスは開かない。
11
+ *
12
+ * - 一覧は refresh(明示の再取得)で個人設定から読み直す。壊れた・読めない個人設定は登録0件と区別して configError に、
13
+ * 形の違う登録は invalid に理由を付けて出し、ほかの登録は使えるようにする
14
+ * - 開くのは使うとき(open)。同時に開こうとしたら1回にまとめ、失敗したら覚えずに次の open でやり直す(直したら戻る)
15
+ * - 同じデータのフォルダ(実体のパス)を複数の名前で登録していたら、どれも開かない(Preflight・生成を二重に動かさない)
16
+ * - 登録世代(generation): 読み直したときに登録が無くなっていた・データのフォルダが変わっていたら変わる(読み直すまでの間に
17
+ * 外して同じフォルダで付け直したものは同じ登録。書く先は同じ)。画面は変える操作に世代を添え、違えば断る(古い画面の保存を
18
+ * 新しい登録先へ流さない)。参照先のパスだけの変更は今の文脈に反映して世代は変えない
19
+ * - 登録から外れた文脈には新しい要求を渡さず、実行中の Preflight・生成が終わるのを待ってから閉じる(取り消さない)
20
+ */
21
+
22
+ export type RegistryErrorCode = "unknown" | "changed" | "duplicate" | "unavailable";
23
+
24
+ /** 開けない(unknown: 登録に無い / changed: 登録世代が違う / duplicate: 同じデータを複数の名前で登録 / unavailable: 開けない) */
25
+ export class RegistryError extends Error {
26
+ constructor(
27
+ readonly code: RegistryErrorCode,
28
+ message: string,
29
+ ) {
30
+ super(message);
31
+ }
32
+ }
33
+
34
+ export interface ProjectListItem {
35
+ name: string;
36
+ generation: string;
37
+ /** ok: 開ける(開いていなくてもよい) / error: 開けない(理由は error) */
38
+ state: "ok" | "error";
39
+ error?: string;
40
+ /** 文脈を開いている */
41
+ open: boolean;
42
+ }
43
+
44
+ export interface ProjectListing {
45
+ projects: ProjectListItem[];
46
+ invalid: InvalidProjectEntry[];
47
+ /** 個人設定を読めない・壊れている(登録0件とは別) */
48
+ configError?: string;
49
+ }
50
+
51
+ interface Entry {
52
+ name: string;
53
+ dir: string;
54
+ repos: Record<string, string>;
55
+ generation: string;
56
+ /** 同じデータを別の名前でも登録している */
57
+ duplicate?: string;
58
+ ctx?: Promise<P3Context>;
59
+ /** 直前に開けなかった理由(次の open でやり直す) */
60
+ error?: string;
61
+ }
62
+
63
+ export interface RegistryOptions {
64
+ settings: SettingsSource;
65
+ /** サインインの待ち受け(全プロジェクトで1つ) */
66
+ chatgpt: ChatGptAccount;
67
+ configPath?: string;
68
+ /** 開き方(テストで差し替える) */
69
+ open?: typeof openProject;
70
+ }
71
+
72
+ export class ProjectRegistry {
73
+ private entries = new Map<string, Entry>();
74
+ private invalid: InvalidProjectEntry[] = [];
75
+ private configError?: string;
76
+ private counter = 0;
77
+ private refreshing: Promise<ProjectListing> = Promise.resolve({ projects: [], invalid: [] });
78
+ /** 登録から外れて、実行中の処理が終わるのを待っている文脈 */
79
+ private retiring = new Set<Promise<void>>();
80
+ private listeners = new Set<(kind: "projects" | "user" | "chatgpt") => void>();
81
+ private closed = false;
82
+
83
+ constructor(private opts: RegistryOptions) {}
84
+
85
+ get chatgpt(): ChatGptAccount {
86
+ return this.opts.chatgpt;
87
+ }
88
+
89
+ /** 個人設定から一覧を読み直す(同時に呼ばれたら順に) */
90
+ refresh(): Promise<ProjectListing> {
91
+ this.refreshing = this.refreshing.then(
92
+ () => this.load(),
93
+ () => this.load(),
94
+ );
95
+ return this.refreshing;
96
+ }
97
+
98
+ list(): ProjectListing {
99
+ const projects = [...this.entries.values()]
100
+ .sort((a, b) => a.name.localeCompare(b.name))
101
+ .map((e): ProjectListItem => {
102
+ const error = e.duplicate ?? e.error;
103
+ return { name: e.name, generation: e.generation, state: error ? "error" : "ok", ...(error ? { error } : {}), open: !!e.ctx };
104
+ });
105
+ return { projects, invalid: this.invalid, ...(this.configError ? { configError: this.configError } : {}) };
106
+ }
107
+
108
+ /** 登録した名前の文脈(必要なら開く)。generation を渡したら、今の登録世代と同じときだけ */
109
+ async open(name: string, generation?: string): Promise<P3Context> {
110
+ if (this.closed) throw new RegistryError("unavailable", "serve を止めています");
111
+ const e = PROJECT_NAME.test(name) ? this.entries.get(name) : undefined;
112
+ if (!e) throw new RegistryError("unknown", `プロジェクト「${name}」は個人設定に登録されていません(p3 project ls で確かめ、画面の一覧を読み直してください)`);
113
+ if (generation !== undefined && generation !== e.generation) {
114
+ throw new RegistryError("changed", `プロジェクト「${name}」の登録が変わりました(外した・付け直した・データのフォルダを変えた)。一覧を読み直して選び直してください(入力は送っていません)`);
115
+ }
116
+ if (e.duplicate) throw new RegistryError("duplicate", e.duplicate);
117
+ if (!e.ctx) {
118
+ e.ctx = (this.opts.open ?? openProject)(e.dir, { repos: e.repos, settings: this.opts.settings, projectName: e.name, chatgpt: this.opts.chatgpt });
119
+ e.ctx.then(
120
+ (ctx) => {
121
+ e.error = undefined;
122
+ void ctx.ws.watch();
123
+ // 開いている間に登録から外れた・変わった: 新しい要求には使わせず閉じる
124
+ if (this.entries.get(name) !== e || this.closed) this.retire(ctx);
125
+ },
126
+ (err: Error) => {
127
+ // 覚えずに次の open でやり直す(フォルダを戻した・共有ドライブをつないだら使える)
128
+ if (this.entries.get(name) === e) {
129
+ e.ctx = undefined;
130
+ e.error = err.message;
131
+ }
132
+ },
133
+ );
134
+ }
135
+ try {
136
+ const ctx = await e.ctx;
137
+ if (this.entries.get(name) !== e) throw new RegistryError("changed", `プロジェクト「${name}」の登録が変わりました。一覧を読み直して選び直してください`);
138
+ return ctx;
139
+ } catch (err) {
140
+ if (err instanceof RegistryError) throw err;
141
+ throw new RegistryError("unavailable", `プロジェクト「${name}」を開けません: ${(err as Error).message}`);
142
+ }
143
+ }
144
+
145
+ /** 開いている文脈(変更の知らせを全部へ流すため) */
146
+ async openContexts(): Promise<P3Context[]> {
147
+ const opened = await Promise.allSettled([...this.entries.values()].flatMap((e) => (e.ctx ? [e.ctx] : [])));
148
+ return opened.flatMap((r) => (r.status === "fulfilled" ? [r.value] : []));
149
+ }
150
+
151
+ /** プロジェクトに属さない変更(一覧・テーマ・ChatGPT の接続)を知らせる。開いている全プロジェクトの画面にも流す */
152
+ notify(kind: "projects" | "user" | "chatgpt") {
153
+ for (const l of this.listeners) l(kind);
154
+ if (kind === "projects") return;
155
+ void this.openContexts().then((all) => all.forEach((ctx) => ctx.ws.emit({ type: "changed", kind })));
156
+ }
157
+
158
+ on(listener: (kind: "projects" | "user" | "chatgpt") => void): () => void {
159
+ this.listeners.add(listener);
160
+ return () => this.listeners.delete(listener);
161
+ }
162
+
163
+ /**
164
+ * 止める。新しい要求は断り、実行中の Preflight・生成を取り消して終わるまで待つ(timeoutMs まで)。監視を外す。
165
+ * 待ちきれなかった数を返す
166
+ */
167
+ async close(opts: { timeoutMs?: number } = {}): Promise<{ pending: number }> {
168
+ this.closed = true;
169
+ const all = await this.openContexts();
170
+ for (const e of this.entries.values()) e.ctx = undefined;
171
+ const settle = Promise.all([
172
+ ...all.map(async (ctx) => {
173
+ await Promise.all([ctx.preflight.settle({ cancel: true }), ctx.releaseGenerator.settle({ cancel: true })]);
174
+ ctx.ws.close();
175
+ }),
176
+ ...this.retiring,
177
+ ]).then(() => false);
178
+ const timedOut = await Promise.race([settle, new Promise<boolean>((r) => setTimeout(() => r(true), opts.timeoutMs ?? 10_000).unref())]);
179
+ for (const ctx of all) ctx.ws.close();
180
+ return { pending: timedOut ? all.reduce((n, c) => n + c.preflight.running() + c.releaseGenerator.running(), 0) : 0 };
181
+ }
182
+
183
+ private async load(): Promise<ProjectListing> {
184
+ let projects: Record<string, UserProject>;
185
+ try {
186
+ const r = await inspectUserProjects(this.opts.configPath ?? userConfigPath());
187
+ projects = r.projects;
188
+ this.invalid = r.invalid;
189
+ this.configError = undefined;
190
+ } catch (e) {
191
+ // 読めない・壊れている: 今の一覧と開いている文脈はそのまま(直して読み直せば戻る)
192
+ this.configError = (e as Error).message;
193
+ return this.list();
194
+ }
195
+ const before = this.list();
196
+ for (const [name, e] of this.entries) {
197
+ const next = projects[name];
198
+ if (!next || next.dir !== e.dir) this.drop(name, e);
199
+ }
200
+ for (const [name, p] of Object.entries(projects)) {
201
+ const cur = this.entries.get(name);
202
+ if (cur) {
203
+ // 参照先のパスだけの変更は今の文脈に反映する(次の Preflight から使う)
204
+ if (JSON.stringify(cur.repos) !== JSON.stringify(p.repos)) {
205
+ const old = cur.repos;
206
+ cur.repos = { ...p.repos };
207
+ void cur.ctx?.then((ctx) => {
208
+ for (const k of Object.keys(old)) if (!(k in p.repos)) ctx.ws.setLocalRepo(k, null);
209
+ for (const [k, v] of Object.entries(p.repos)) if (old[k] !== v) ctx.ws.setLocalRepo(k, v);
210
+ }, () => undefined);
211
+ }
212
+ continue;
213
+ }
214
+ this.entries.set(name, { name, dir: p.dir, repos: { ...p.repos }, generation: this.nextGeneration(p.dir) });
215
+ }
216
+ await this.markDuplicates();
217
+ const after = this.list();
218
+ if (JSON.stringify(before) !== JSON.stringify(after)) this.notify("projects");
219
+ return after;
220
+ }
221
+
222
+ /** 登録から外す。新しい要求には使わせず、実行中の処理が終わってから閉じる */
223
+ private drop(name: string, e: Entry) {
224
+ this.entries.delete(name);
225
+ void e.ctx?.then((ctx) => this.retire(ctx), () => undefined);
226
+ }
227
+
228
+ private retire(ctx: P3Context) {
229
+ const p = Promise.all([ctx.preflight.settle(), ctx.releaseGenerator.settle()]).then(() => ctx.ws.close());
230
+ this.retiring.add(p);
231
+ void p.finally(() => this.retiring.delete(p));
232
+ }
233
+
234
+ /** 同じ実体のフォルダを指す登録は、どれも開かない(どれを使うかは人が個人設定で決める) */
235
+ private async markDuplicates() {
236
+ const real = new Map<string, string[]>();
237
+ for (const e of this.entries.values()) {
238
+ const key = await realpath(e.dir).catch(() => e.dir);
239
+ real.set(key, [...(real.get(key) ?? []), e.name]);
240
+ }
241
+ for (const names of real.values()) {
242
+ for (const name of names) {
243
+ const e = this.entries.get(name)!;
244
+ const was = e.duplicate;
245
+ e.duplicate =
246
+ names.length > 1
247
+ ? `同じデータのフォルダを複数の名前で登録しています: ${names.join(", ")}(二重に動かさないため、どれも開きません。p3 project rm <名前> で1つにしてください)`
248
+ : undefined;
249
+ // 重なりを外して開けるようになったら、別の登録として世代を変える
250
+ if (was && !e.duplicate) e.generation = this.nextGeneration(e.dir);
251
+ if (!was && e.duplicate && e.ctx) {
252
+ const ctx = e.ctx;
253
+ e.ctx = undefined;
254
+ void ctx.then((c) => this.retire(c), () => undefined);
255
+ }
256
+ }
257
+ }
258
+ }
259
+
260
+ private nextGeneration(dir: string): string {
261
+ this.counter += 1;
262
+ return `${createHash("sha256").update(dir).digest("hex").slice(0, 8)}-${this.counter}`;
263
+ }
264
+ }
@@ -0,0 +1,102 @@
1
+ import type { ReleaseMaterial, RequestCompletionPlan, RequestCompletionResult } from "../../shared/types.ts";
2
+ import type { P3Context } from "../context.ts";
3
+ import { updateRequest } from "../requestOps.ts";
4
+ import { resolveBlocker } from "../requestStatus.ts";
5
+ import { ConflictError } from "../store/collection.ts";
6
+ import { Workspace } from "../store/workspace.ts";
7
+ import { materialOf } from "./material.ts";
8
+ import { checkMilestoneId, ReleaseNoteError } from "./store.ts";
9
+
10
+ /**
11
+ * マイルストーンの要望を一括で完了済にする。規則はここだけに置く(CLI・API・画面は判定を見せて、表示したときの材料の hash で頼むだけ)。
12
+ *
13
+ * - 判定は材料(material.ts の収録の条件)と同じ: 見送りを除く全要望が収録できる(対応済か完了済・タスクが1件以上で全部完了・
14
+ * 読めないタスクなし)ときだけできる。マイルストーンが project.yaml に無い・所属の分からない読めない要望があればできない
15
+ * - 変えるのは対応済(resolved)の要望のステータスだけ(→ done)。完了済・見送り・アーカイブした要望、タスク(状態・済み)、
16
+ * マイルストーン、ノートは変えない。変更の記録が無い・ノートを保存していない・済みが無いことは条件にしない
17
+ * - 実行はディスクから読み直した材料で判定し直し、表示したときの hash と違えば何も書かない(material_changed)。できなければ
18
+ * 何も書かない(blocked)
19
+ * - 複数のファイルをまとめて書く仕組みは無いので、1件ずつ書く。書く直前に、タスクを読み直して確かめ、要望は判定したときの rev で
20
+ * 書く(違えば競合)。途中で失敗したら止め、完了済にしたもの・失敗した1件・まだ変えていないものを返す(戻さない。外の変更を
21
+ * 上書きしないため)。やり直しは、取り直した判定でもう一度頼む(完了済にしたものは対象から外れ、書き直さない)
22
+ */
23
+
24
+ /** 材料から判定する(書かない) */
25
+ export function completionPlanOf(material: ReleaseMaterial): RequestCompletionPlan {
26
+ const plan: RequestCompletionPlan = { milestone: material.milestone.id, basedOn: material.hash, ready: false, targets: [], alreadyDone: [], skipped: [], blockers: [] };
27
+ if (!material.milestone.known) plan.blockers.push({ target: material.milestone.id, reason: `マイルストーン ${material.milestone.id} は project.yaml にありません` });
28
+ for (const w of material.warnings.filter((x) => x.code === "broken_request")) plan.blockers.push({ target: w.target, reason: w.message });
29
+ for (const r of material.requests) {
30
+ if (r.status === "rejected") plan.skipped.push(r.id);
31
+ else if (!r.included) {
32
+ const open = r.tasks.filter((t) => t.status !== "done").map((t) => `${t.id}(${t.status})`);
33
+ const detail = r.reason === "完了していないタスクがある" && open.length ? `: ${open.join(", ")}` : "";
34
+ plan.blockers.push({ target: r.id, reason: `${r.title}(${r.id}): ${r.reason ?? "収録できません"}${detail}` });
35
+ }
36
+ else if (r.status === "resolved") plan.targets.push({ id: r.id, title: r.title });
37
+ else plan.alreadyDone.push(r.id);
38
+ }
39
+ plan.ready = plan.blockers.length === 0;
40
+ return plan;
41
+ }
42
+
43
+ /** 頼めない(何も書いていない)。material_changed: 表示したときの材料と違う / blocked: 未完了などがある。plan は今の判定 */
44
+ export class CompletionRejected extends Error {
45
+ constructor(
46
+ readonly code: "material_changed" | "blocked",
47
+ message: string,
48
+ readonly plan: RequestCompletionPlan,
49
+ ) {
50
+ super(message);
51
+ }
52
+ }
53
+
54
+ /** 今の判定(ディスクから読み直す) */
55
+ export async function completionPlan(ctx: P3Context, mid: string): Promise<RequestCompletionPlan> {
56
+ return (await snapshot(ctx, mid)).plan;
57
+ }
58
+
59
+ /** 一括で完了済にする。basedOn は判定を見せたときの材料の hash(必須) */
60
+ export async function completeMilestoneRequests(ctx: P3Context, mid: string, basedOn: string, actor?: string): Promise<RequestCompletionResult> {
61
+ const { snap, plan } = await snapshot(ctx, mid);
62
+ if (plan.basedOn !== basedOn) {
63
+ throw new CompletionRejected("material_changed", "表示したあとで、このマイルストーンの要望・タスクが変わりました。何も変えていません。読み直して確かめてから、もう一度実行してください", plan);
64
+ }
65
+ if (!plan.ready) {
66
+ throw new CompletionRejected("blocked", `完了済にできません(何も変えていません): ${plan.blockers.map((b) => b.reason).join(" / ")}`, plan);
67
+ }
68
+ const result: RequestCompletionResult = { milestone: mid, completed: [], notRun: [], alreadyDone: plan.alreadyDone };
69
+ for (const [i, t] of plan.targets.entries()) {
70
+ try {
71
+ // タスクの変更は要望の rev に出ないので、書く直前に読み直して確かめる。要望(所属・状態)は判定したときの rev で確かめる
72
+ const why = await resolveBlocker(ctx.ws, t.id);
73
+ if (why) {
74
+ result.failed = { id: t.id, reason: why, code: "changed" };
75
+ } else {
76
+ await updateRequest(ctx, t.id, { status: "done" }, { expectedRev: snap.requests.require(t.id).rev, actor });
77
+ result.completed.push(t);
78
+ continue;
79
+ }
80
+ } catch (e) {
81
+ result.failed =
82
+ e instanceof ConflictError
83
+ ? { id: t.id, reason: `判定したあとで要望が変わりました(${(e as Error).message})`, code: "conflict" }
84
+ : { id: t.id, reason: (e as Error).message, code: "error" };
85
+ }
86
+ result.notRun = plan.targets.slice(i + 1).map((x) => x.id);
87
+ break;
88
+ }
89
+ return result;
90
+ }
91
+
92
+ /** ディスクから読み直した状態で、材料と判定を作る。project.yaml に無く、ノートも無いマイルストーンは not_found */
93
+ async function snapshot(ctx: P3Context, mid: string) {
94
+ checkMilestoneId(mid);
95
+ const snap = new Workspace(ctx.ws.dataDir);
96
+ await snap.load();
97
+ const material = materialOf(snap, mid);
98
+ if (!material.milestone.known && !(await ctx.ws.releaseNotes.ids()).includes(mid)) {
99
+ throw new ReleaseNoteError("not_found", mid, `マイルストーンがありません: ${mid}`);
100
+ }
101
+ return { snap, material, plan: completionPlanOf(material) };
102
+ }
@@ -117,6 +117,18 @@ export class ReleaseGenerator {
117
117
  return true;
118
118
  }
119
119
 
120
+ /** 実行中の生成の数 */
121
+ running(): number {
122
+ return [...this.jobs.values()].filter((j) => j.status === "running").length;
123
+ }
124
+
125
+ /** 実行中の生成が全部終わるまで待つ(cancel: 先に全部を取り消す) */
126
+ async settle(opts: { cancel?: boolean } = {}): Promise<void> {
127
+ const ids = [...this.jobs.values()].filter((j) => j.status === "running").map((j) => j.id);
128
+ if (opts.cancel) for (const id of ids) this.cancel(id);
129
+ await Promise.allSettled(ids.flatMap((id) => this.done.get(id) ?? []));
130
+ }
131
+
120
132
  private emit(j: ReleaseGeneration) {
121
133
  this.ws.emit({ type: "release-generation", id: j.id, milestone: j.milestone, status: j.status });
122
134
  }
@@ -1,8 +1,10 @@
1
- import type { ReleaseGeneration, ReleaseMaterial, ReleaseNote, ReleaseNoteSummary, ReleaseWarning } from "../../shared/types.ts";
1
+ import type { ReleaseGeneration, ReleaseMaterial, ReleaseNote, ReleaseNoteSummary, ReleaseWarning, RequestCompletionPlan } from "../../shared/types.ts";
2
2
  import type { P3Context } from "../context.ts";
3
3
  import { extractMaterial } from "./material.ts";
4
4
  import type { SummaryEngine } from "./generate.ts";
5
5
  import { checkMilestoneId, ReleaseNoteError } from "./store.ts";
6
+ import { compareMilestoneIds, sortMilestones } from "../../shared/milestoneOrder.ts";
7
+ import { completionPlanOf } from "./completeRequests.ts";
6
8
 
7
9
  /**
8
10
  * リリースノートの操作(CLI と API はここを呼ぶ)。材料の規則は material.ts、保存の形は store.ts。
@@ -11,7 +13,7 @@ import { checkMilestoneId, ReleaseNoteError } from "./store.ts";
11
13
  * 保存では、そのときディスクにある材料を出典として固定する(本文の元にした材料が古ければ material_changed で知らせる)。
12
14
  */
13
15
 
14
- /** マイルストーンごとのノートの有無。並びは project.yaml の順、その後ろに project.yaml に無いノート(ID の順) */
16
+ /** マイルストーンごとのノートの有無。並びは登録したマイルストーンを ID のバージョンの降順(shared/milestoneOrder.ts)、その後ろに project.yaml に無いノート(同じ降順) */
15
17
  export async function releaseOverview(ctx: P3Context): Promise<{ milestones: ReleaseNoteSummary[]; warnings: ReleaseWarning[] }> {
16
18
  const { ws } = ctx;
17
19
  const count = (mid: string) => ws.requests.list().filter((r) => r.milestone === mid).length;
@@ -26,8 +28,8 @@ export async function releaseOverview(ctx: P3Context): Promise<{ milestones: Rel
26
28
  return { state: "invalid", error: (e as Error).message };
27
29
  }
28
30
  };
29
- const known = ws.project.milestones;
30
- const orphans = ids.filter((id) => !known.some((m) => m.id === id));
31
+ const known = sortMilestones(ws.project.milestones);
32
+ const orphans = ids.filter((id) => !known.some((m) => m.id === id)).sort(compareMilestoneIds);
31
33
  const milestones: ReleaseNoteSummary[] = [
32
34
  ...(await Promise.all(known.map(async (m) => ({ milestone: m.id, title: m.title, due: m.due, done: m.done, known: true, requests: count(m.id), note: await noteState(m.id) })))),
33
35
  ...(await Promise.all(orphans.map(async (id) => ({ milestone: id, title: id, known: false, requests: count(id), note: await noteState(id) })))),
@@ -58,6 +60,8 @@ export interface ReleaseNoteDetail {
58
60
  material: ReleaseMaterial;
59
61
  /** 保存のあとで材料が変わった(ノートが無ければ false) */
60
62
  materialChanged: boolean;
63
+ /** 要望を一括で完了済にできるか(この材料で判定。実行は completion.basedOn を添えて頼む) */
64
+ completion: RequestCompletionPlan;
61
65
  }
62
66
 
63
67
  export async function releaseNoteDetail(ctx: P3Context, mid: string): Promise<ReleaseNoteDetail> {
@@ -69,7 +73,7 @@ export async function releaseNoteDetail(ctx: P3Context, mid: string): Promise<Re
69
73
  } catch (e) {
70
74
  if (!(e instanceof ReleaseNoteError && e.code === "not_found")) noteError = (e as Error).message;
71
75
  }
72
- return { note, noteError, material, materialChanged: !!note && note.materialHash !== material.hash };
76
+ return { note, noteError, material, materialChanged: !!note && note.materialHash !== material.hash, completion: completionPlanOf(material) };
73
77
  }
74
78
 
75
79
  export interface SaveInput {