@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
@@ -1,730 +0,0 @@
1
- import type { RefScope, RepoRef } from "./repos.ts";
2
- /**
3
- * p3 のドメイン型。サーバ・CLI・Web で共有する。
4
- *
5
- * 作業の単位は「要望」。要望ごとにフォルダを作り、そこから生まれたタスクや Preflight の記録は
6
- * すべてその下に置く。タスクは要望をまたいで移動しないので、要望の中で素直な連番(T001, T002, ...)にする。
7
- *
8
- * .p3/requests/<要望ID>/request.md
9
- * .p3/requests/<要望ID>/tasks/T001.md
10
- * .p3/requests/<要望ID>/preflight/<run>/...
11
- */
12
-
13
- // ---------------------------------------------------------------------------
14
- // 関係: 多元的なので、型付きの有向エッジとして持つ。
15
- // エッジは張った側のファイルに書き、逆向きはインデックスで導く。
16
- // 相手の書き方(参照)は shared/refs.ts を参照。
17
- // ---------------------------------------------------------------------------
18
-
19
- /**
20
- * 関係の種類。A →(種類)→ B と張ったとき、画面と CLI は「役割 + 相手」で見せる:
21
- * label A から見た B の役割(A の詳細に「依存先 B」)
22
- * inverse B から見た A の役割(B の詳細に「依存元 A」)
23
- * verb 種類そのものの説明(関係を張るときの選択肢・CLI のヘルプ)
24
- * 例: T002 depends_on T001 → T002 に「依存先 T001」、T001 に「依存元 T002」
25
- */
26
- /**
27
- * タスクの関係は2つだけ(どちらも同じ要望の中のタスクを指す。target は "T003")。
28
- * depends_on: 順序(相手が先に終わっている必要がある)。Preflight の案の dependsOn から張る
29
- * supersedes: 再評価で古いタスクを置き換える(相手は古い案)。Preflight の案の supersedes から張る
30
- * 手で張る機能は持たない
31
- */
32
- export const RELATION_TYPES = {
33
- depends_on: { label: "依存先", inverse: "依存元", verb: "依存する(相手が先に終わっている必要がある)" },
34
- supersedes: { label: "旧案", inverse: "新案", verb: "置き換える(相手は古い案)" },
35
- } as const;
36
-
37
- /** 関係の向きに応じた相手の役割。out: 張った側から見た相手、in: 張られた側から見た相手(張った側) */
38
- export function relationRole(type: string, direction: "out" | "in"): string {
39
- const t = RELATION_TYPES[type as keyof typeof RELATION_TYPES];
40
- if (!t) return type;
41
- return direction === "out" ? t.label : t.inverse;
42
- }
43
-
44
- export type RelationType = keyof typeof RELATION_TYPES;
45
- export const relationTypes = Object.keys(RELATION_TYPES) as RelationType[];
46
-
47
- /** 誰が張ったか(今は Preflight のタスク化だけが張る) */
48
- export type RelationOrigin = "human" | "ai" | "preflight";
49
-
50
- export interface Relation {
51
- type: RelationType;
52
- /** 同じ要望のタスク("T003") */
53
- target: string;
54
- note?: string;
55
- origin?: RelationOrigin;
56
- }
57
-
58
- // ---------------------------------------------------------------------------
59
- // タスク
60
- // ---------------------------------------------------------------------------
61
-
62
- /**
63
- * タスクの状態は3つで固定(設定では変えない)。タスクは AI か人が実施し、人から見て必要なのは
64
- * 「まだ動いていない / 処理中 / 処理が終わった(PR・MR・ドキュメントが出た)」だけ。成果物のレビューは成果物の側で行う。
65
- * 保留や取りやめの状態は持たない: AI が進めた作業は、マージしないなら完了のまま(成果物の側で閉じる)、
66
- * 手を付けないなら未着手のままでよい。
67
- */
68
- export const TASK_STATUSES = ["todo", "doing", "done"] as const;
69
- export type TaskStatus = (typeof TASK_STATUSES)[number];
70
- export const TASK_STATUS_LABEL: Record<TaskStatus, string> = { todo: "未着手", doing: "作業中", done: "完了" };
71
- export const isTaskStatus = (s: unknown): s is TaskStatus => (TASK_STATUSES as readonly unknown[]).includes(s);
72
-
73
- export interface Task {
74
- /** 要望の中での ID(T001) */
75
- id: string;
76
- /** 所属する要望の ID(フォルダから決まる。ファイルには書かない) */
77
- request: string;
78
- /** プロジェクト全体で一意な参照(<要望ID>/T001。ファイルには書かない) */
79
- ref: string;
80
- title: string;
81
- status: TaskStatus;
82
- labels: string[];
83
- /** 触るコード領域(例: "src/core/store")。表示と絞り込みに使う */
84
- areas: string[];
85
- /** 成果物。1項目ずつ URL(PR / MR)・文章・ドキュメントのパスのどれでもよい。項目全体が http(s) の URL なら画面でリンクにする */
86
- outputs: string[];
87
- /** 作業先(作業先にできる参照先の名前)。null は作業先なし(調査・人の判断など)。shared/workTarget.ts */
88
- repo: string | null;
89
- /** リポジトリごとの成果物(PR など)。最後のタスクに、関係するリポジトリの PR を全部残せる。outputs とは別に持つ */
90
- repoOutputs?: RepoOutput[];
91
- /**
92
- * 作業中にした日時(着手を指示した目安)と、完了にした日時。
93
- * 予定ではなく、ステータスを変えたときに p3 が記録する(AI や人が書くものではない)
94
- */
95
- startedAt?: string;
96
- doneAt?: string;
97
- /** 完了したタスクを人が確認して「済み」にした日時(完了から戻すと消える) */
98
- checkedAt?: string;
99
- /**
100
- * 変更の記録(Markdown)。完了にするときに作業した側が書く: 何を変えたか・なぜ・入れた決まり・やめたもの。
101
- * 後の Preflight が経緯を調べるとき、タスク解析・リリースノートの材料に読む。AI が完了にするときは必須
102
- */
103
- record?: string;
104
- relations: Relation[];
105
- /** 楽観ロック用リビジョン。同じマシンでの AI と人の同時編集を検出する */
106
- rev: number;
107
- createdAt: string;
108
- updatedAt: string;
109
- /** 変更者(ai:claude / human:<git の user.name>) */
110
- updatedBy?: string;
111
- /** Markdown 本文 */
112
- body: string;
113
- }
114
-
115
- // ---------------------------------------------------------------------------
116
- // 要望 — 作業の単位。1要望 = 1フォルダ = 1作業ツリー(ブランチ)
117
- // ---------------------------------------------------------------------------
118
-
119
- /**
120
- * 要望のステータス。resolved(対応済)は AI など作業する側が「全タスクを終えた」と示すもので、人の確認待ち。
121
- * done(完了済)・rejected(見送り)は人が決める。
122
- */
123
- export type RequestStatus = "draft" | "preflight" | "reviewed" | "active" | "resolved" | "done" | "rejected";
124
- export const REQUEST_STATUSES: RequestStatus[] = ["draft", "preflight", "reviewed", "active", "resolved", "done", "rejected"];
125
-
126
- /** 要望の、作業先のリポジトリでのブランチ(名前だけ。git のブランチや作業ツリーは作業する人・AI が作る) */
127
- export interface Workstream {
128
- branch: string;
129
- }
130
-
131
- /** リポジトリ(参照先の名前)ごとの成果物 */
132
- export interface RepoOutput {
133
- repo: string;
134
- output: string;
135
- }
136
-
137
- export interface Request {
138
- /** フォルダ名(作成日 + 乱数。例: 261009-k7m3x) */
139
- id: string;
140
- title: string;
141
- status: RequestStatus;
142
- areas: string[];
143
- /** 期限(YYYY-MM-DD) */
144
- due?: string;
145
- /** まとめてリリースする単位(project.yaml の milestones の id) */
146
- milestone?: string;
147
- /** タグ: 外部 ID・分類の自由な文字列(例: jira:PROJ-123、group:顧客A、feature)。shared/tags.ts */
148
- tags: string[];
149
- /** 作業先のリポジトリごとのブランチ(参照先の名前 → ブランチ)。タスク化・作業先を足したときに要る分だけ割り当てる */
150
- workstreams?: Record<string, Workstream>;
151
- /** 最新 preflight run */
152
- lastPreflight?: string;
153
- rev: number;
154
- createdAt: string;
155
- updatedAt: string;
156
- updatedBy?: string;
157
- body: string;
158
- }
159
-
160
- /** 進捗の画面・CLI 用の集計 */
161
- /** 進捗のスケジュールに描くためのタスクの要約 */
162
- export type TaskMark = Pick<Task, "id" | "ref" | "title" | "status" | "createdAt" | "startedAt" | "doneAt" | "checkedAt">;
163
-
164
- export interface RequestProgress {
165
- request: Request;
166
- tasks: TaskMark[];
167
- /** ステータスごとのタスク数 */
168
- counts: Record<TaskStatus, number>;
169
- total: number;
170
- done: number;
171
- /** 最後に変更された日時(要望かタスク) */
172
- updatedAt: string;
173
- }
174
-
175
- // ---------------------------------------------------------------------------
176
- // Preflight
177
- // ---------------------------------------------------------------------------
178
-
179
- export type Verdict = "go" | "clarify" | "no_go";
180
-
181
- export interface ProposedTask {
182
- /** run 内のキー (D1, D2, ...)。タスク化すると要望の連番(T00x)が振られる */
183
- key: string;
184
- title: string;
185
- description: string;
186
- areas: string[];
187
- /** 同じ run 内の他の key */
188
- dependsOn: string[];
189
- /** 置き換える同じ要望の既存タスク("T003"。再評価で古いタスクを置き換えるとき) */
190
- supersedes: string[];
191
- /** 取り込み対象か(UI で切り替え) */
192
- include: boolean;
193
- /** 作業先(writable な参照先の名前。null / 無い → 作業先なし)。人がレビューで直せる */
194
- repo?: string | null;
195
- }
196
-
197
- export interface PreflightAssessment {
198
- summary: string;
199
- verdict: Verdict;
200
- validity: { score: number; reasons: string[] };
201
- feasibility: { score: number; reasons: string[] };
202
- risks: string[];
203
- questions: string[];
204
- areas: string[];
205
- /** 判断の根拠(調べた箇所と、推測の明示)。無ければ記録なし(以前の結果) */
206
- evidence?: Evidence[];
207
- }
208
-
209
- /**
210
- * 判断の根拠1つ。verified: 参照先のファイルを読んで確かめた / assumed: 確かめていない推測(消さずに推測と明示する)。
211
- * P3 は、見ていない参照先・参照先の外・無いファイルを指す verified を assumed に直し、note に理由を書く
212
- */
213
- export interface Evidence {
214
- /** 支える判断(例: 「実現可能性: 既存の X で足りる」「D2 の範囲」) */
215
- claim: string;
216
- kind: "verified" | "assumed";
217
- /** 参照先の名前 */
218
- repo?: string;
219
- /** 参照先の中の相対パス */
220
- file?: string;
221
- /** 行・関数名など */
222
- location?: string;
223
- /** 経緯を確かめたコミット(git の履歴を根拠にしたとき) */
224
- commit?: string;
225
- /** P3 が付けた注記(確かめた根拠として扱えなかった理由) */
226
- note?: string;
227
- }
228
-
229
- export type PreflightStatus = "running" | "completed" | "failed";
230
-
231
- /**
232
- * Preflight の run の今の状態(ディスクから読んだもの。GET /api/requests/:rid/preflight-status)。
233
- * ready: run.json を読めた / pending: run のフォルダはあるが run.json がまだ無い(保存の途中)/
234
- * missing: run のフォルダが無い / broken: run.json が読めない・壊れている
235
- * version は run.json の更新を見分ける値(中身の意味は持たない。変わったら取り直す)
236
- */
237
- export interface RunPulse {
238
- id: string;
239
- state: "ready" | "pending" | "missing" | "broken";
240
- status?: PreflightStatus;
241
- startedAt?: string;
242
- finishedAt?: string;
243
- version?: string;
244
- }
245
-
246
- /**
247
- * 要望の最新の Preflight(lastPreflight)と、見ている run の今の状態。監視(変更通知)が届かなくても、画面が軽く確かめるため。
248
- * state: ok / gone(要望のファイルが無い。削除・アーカイブ)/ broken(要望のファイルが読めない)
249
- * latest: lastPreflight の run(未実行なら null)。run: 問い合わせで指定した run(指定しなければ無い)
250
- */
251
- export interface PreflightPulse {
252
- requestId: string;
253
- state: "ok" | "gone" | "broken";
254
- latest: RunPulse | null;
255
- run?: RunPulse;
256
- }
257
-
258
- /**
259
- * Preflight の画面資料の種類。proposal: エンジンが作った画面イメージ(提案。現状の証拠ではない)/
260
- * current: 人が添付した現状の画像 / spec: 仕様書(xlsx など)から取り出した画像
261
- */
262
- export const UI_MATERIAL_KINDS = { proposal: "提案", current: "現状(添付)", spec: "仕様書から" } as const;
263
- export type UiMaterialKind = keyof typeof UI_MATERIAL_KINDS;
264
-
265
- /** 画面資料1つ(画像は PNG / JPEG。パスは run の ui/ からの相対なので、データのフォルダを動かしても辿れる) */
266
- export interface UiMaterial {
267
- /** run の中で一意(U1, U2 ...)。画像の取得は 要望 / run / この ID で行う */
268
- id: string;
269
- kind: UiMaterialKind;
270
- /** 画像(run の ui/ からの相対パス) */
271
- file: string;
272
- format: "png" | "jpeg";
273
- /** 画像の実際の大きさ(P3 が画像から読む) */
274
- width: number;
275
- height: number;
276
- bytes: number;
277
- /** 説明 */
278
- title: string;
279
- /** 出典(提案なら原稿、添付なら添付の ID など) */
280
- source?: string;
281
- /** 原稿(HTML。run の ui/ からの相対パス。画面には配信しない) */
282
- html?: string;
283
- /** 対象のタスク案(D キー。1枚に複数をまとめてもよい) */
284
- drafts: string[];
285
- /** 想定した画面の幅(px) */
286
- viewport?: number;
287
- /** 前提(仮のデータ・省いたものなど) */
288
- assumptions: string[];
289
- /** 資料を作った run */
290
- run: string;
291
- /** P3 が原稿から描いた(エンジンは画像を見ていない。利用者が確かめる)。clipped: 縦に長すぎて切った・blocked: 止めた読み込みの数 */
292
- rendered?: { by: "p3"; clipped: boolean; blocked: number };
293
- }
294
-
295
- /**
296
- * 画面資料の状態。generating: 評価中 / ready: そろった / not_needed: UI を伴わない(理由つき)/ missing: 足りない(理由つき)。
297
- * run に記録が無ければ以前の run(記録なし)
298
- */
299
- export type UiMaterialsStatus = "generating" | "ready" | "not_needed" | "missing";
300
-
301
- export interface UiMaterials {
302
- status: UiMaterialsStatus;
303
- /** UI を伴う案か(エンジンの判定。分からなければ無し) */
304
- needed?: boolean;
305
- /** 不要・不足の理由 */
306
- reason?: string;
307
- /** 画面イメージが要るタスク案(D キー) */
308
- targets: string[];
309
- items: UiMaterial[];
310
- /** 取り込めなかった資料とその理由 */
311
- problems: string[];
312
- /** 必要な画面イメージが足りないので、判定を go から clarify にした */
313
- verdictAdjusted?: { from: "go"; to: "clarify" };
314
- }
315
-
316
- export interface PreflightRun {
317
- id: string;
318
- requestId: string;
319
- engine: "codex" | "mock";
320
- status: PreflightStatus;
321
- startedAt: string;
322
- finishedAt?: string;
323
- log: PreflightLogEntry[];
324
- assessment?: PreflightAssessment;
325
- /** drafts/ 配下のファイルから読み込まれる */
326
- drafts: ProposedTask[];
327
- error?: string;
328
- threadId?: string;
329
- /** タスク化済みなら作成されたタスク ID */
330
- materialized?: string[];
331
- /**
332
- * タスク化の途中経過。途中で失敗しても、再試行で同じ案を二度作らず、同じタスクを二度アーカイブしないための記録。
333
- * created: 作った案とタスク(D1 → T004)、archive: アーカイブに選んだ置き換えられるタスク、archived: アーカイブ済み
334
- */
335
- materialization?: {
336
- created: Record<string, string>;
337
- archive: string[];
338
- archived: string[];
339
- done: boolean;
340
- /** 割り当てるブランチ(始めたときに決めたもの。やり直しでも同じ) */
341
- workstreams?: { add: Record<string, Workstream>; noGit: string[] };
342
- };
343
- /** 実行した人 */
344
- startedBy?: string;
345
- /** 結果を引き継いだ前回の run(無ければ最初から評価した) */
346
- previous?: string;
347
- /** 渡したメモの ID。内容は run ディレクトリの carryover.md に固定して残す */
348
- notes?: string[];
349
- /**
350
- * 調べた範囲: 参照先ごとに読めたか(始めるときに P3 が決める。モデルの申告では変えない)。このマシンのパスは入れない。
351
- * 無ければ以前の run(記録なし)
352
- */
353
- scope?: RefScope[];
354
- /** 画面資料(ui/)。無ければ以前の run(記録なし) */
355
- ui?: UiMaterials;
356
- /** 始めるときに固定した添付(run の attachments/ と ui/current/)。無ければ添付なし */
357
- attachments?: FixedAttachment[];
358
- /**
359
- * 評価対象: 始めるときにディスクから読み直して固定した要望のタイトルと本文(正規化済み。エンジンに渡したものと同じ)。
360
- * 無ければ以前の run(run の request.md から読む)
361
- */
362
- input?: PreflightInput;
363
- }
364
-
365
- /** Preflight の評価対象(要望のタイトルと本文)。比べるのはこの2つだけ(タグ・期限・ステータスは比べない) */
366
- export interface PreflightInput {
367
- title: string;
368
- body: string;
369
- }
370
-
371
- /**
372
- * run の評価対象と今の要望が同じか。
373
- * same: 同じ(タスク化できる) / changed: タイトルか本文が変わった / unknown: run の評価対象が読めない(以前の run の欠損など)
374
- * changed と unknown の run からはタスク化しない(再評価する)
375
- */
376
- export interface InputMatch {
377
- status: "same" | "changed" | "unknown";
378
- /** changed のとき、変わった項目 */
379
- changed?: ("title" | "body")[];
380
- /** unknown の理由 */
381
- reason?: string;
382
- }
383
-
384
- /** タスクが置き換えられていることの印。from は置き換えた側のタスク(<要望ID>/T004) */
385
- export interface SupersededMark {
386
- from: string;
387
- note?: string;
388
- }
389
-
390
- /** タスク化のときに知らせる、置き換えられる既存タスク(同じ要望の未完了のもの) */
391
- export interface SupersedeCandidate {
392
- /** T001 */
393
- id: string;
394
- /** <要望ID>/T001 */
395
- ref: string;
396
- title: string;
397
- status: TaskStatus;
398
- rev: number;
399
- /** 置き換えを書いた採用したタスク案 */
400
- reasons: { draft: string }[];
401
- }
402
-
403
- /** タスク化の結果 */
404
- export interface MaterializeResult {
405
- tasks: Task[];
406
- /** アーカイブした置き換えられたタスク(T001) */
407
- archived: string[];
408
- /** 置き換えられるが残したタスク */
409
- kept: SupersedeCandidate[];
410
- }
411
-
412
- /**
413
- * Preflight へのメモ: 確認事項への回答や方針の変更。要望のフォルダの notes/<ID>.md に1件1ファイルで書き足す。
414
- * まだ渡していないメモは、次の Preflight に前回の結果と一緒に渡す。
415
- */
416
- export interface PreflightNote {
417
- /** N-20261009-123456-ab12 */
418
- id: string;
419
- requestId: string;
420
- createdAt: string;
421
- createdBy?: string;
422
- body: string;
423
- }
424
-
425
- /** 添付の形式(初期は画像と Excel だけ) */
426
- export const ATTACHMENT_FORMATS = { png: "PNG 画像", jpeg: "JPEG 画像", xlsx: "Excel(xlsx)" } as const;
427
- export type AttachmentFormat = keyof typeof ATTACHMENT_FORMATS;
428
- /** 添付の上限(1つの要望あたり)。サーバで確かめ、画面でも作成の前に同じ値で知らせる */
429
- export const ATTACHMENT_FILE_LIMITS = {
430
- count: 20,
431
- /** 画面資料の画像と同じ上限(run の中で同じ確かめ方をするため) */
432
- imageBytes: 5 * 1024 * 1024,
433
- xlsxBytes: 20 * 1024 * 1024,
434
- totalBytes: 100 * 1024 * 1024,
435
- } as const;
436
-
437
- /**
438
- * 要望の添付(requests/<要望ID>/attachments/<ID>/)。原本は内部の名前で保存し、元の名前・説明・出典を残す。
439
- * Preflight を始めるときに run の中へコピーして固定する(後で足し・消ししても、過去の run の資料は変わらない)
440
- */
441
- export interface Attachment {
442
- /** A-20261012-123456-ab12 */
443
- id: string;
444
- requestId: string;
445
- /** 元のファイル名(表示とダウンロードの名前にだけ使う) */
446
- name: string;
447
- format: AttachmentFormat;
448
- bytes: number;
449
- sha256: string;
450
- description?: string;
451
- /** 出典(どこから持ってきたか) */
452
- source?: string;
453
- /** 画像の大きさ */
454
- width?: number;
455
- height?: number;
456
- createdAt: string;
457
- createdBy?: string;
458
- }
459
-
460
- /** run に固定した添付(path は run のフォルダからの相対) */
461
- export interface FixedAttachment extends Omit<Attachment, "requestId"> {
462
- path: string;
463
- /** xlsx から取り出したもの(無ければまだ取り出していない) */
464
- extract?: XlsxExtractRecord;
465
- }
466
-
467
- /** xlsx から取り出した範囲と、取り出せなかったもの */
468
- export interface XlsxExtractRecord {
469
- /** 取り出した内容(Markdown。run のフォルダからの相対) */
470
- text?: string;
471
- sheets: number;
472
- cells: number;
473
- /** 値が保存されていない数式など(未確認) */
474
- unknownCells: number;
475
- /** 埋め込みの画像(画面資料の「仕様書から」。file は run の ui/ からの相対) */
476
- images: { id: string; file: string; sheet: string; anchor: string; format: "png" | "jpeg"; width: number; height: number; bytes: number }[];
477
- truncated: string[];
478
- unsupported: string[];
479
- /** ブックとして読めなかった理由(このときは中身は未読) */
480
- error?: string;
481
- }
482
-
483
- export interface PreflightLogEntry {
484
- at: string;
485
- kind: "info" | "command" | "message" | "error";
486
- text: string;
487
- }
488
-
489
- // ---------------------------------------------------------------------------
490
- // プロジェクト / グラフ
491
- // ---------------------------------------------------------------------------
492
-
493
- export interface Milestone {
494
- /** 要望の milestone に書く短い名前(例: v0.2) */
495
- id: string;
496
- title: string;
497
- /** 予定日(YYYY-MM-DD) */
498
- due?: string;
499
- /** リリース済み */
500
- done?: boolean;
501
- }
502
-
503
- // ---------------------------------------------------------------------------
504
- // リリースノート — マイルストーンごとに1件(<data>/release-notes/<マイルストーンID>.md)
505
- // ---------------------------------------------------------------------------
506
-
507
- /**
508
- * 材料の警告の種類。
509
- * broken_request: 読めない要望のファイル(所属が分からないので全体の警告)
510
- * not_finished: 未完了の要望(対応済・完了済でない。収録しない)
511
- * no_tasks: タスクの無い要望(収録しない)
512
- * open_tasks: 対応済・完了済なのに完了していないタスクがある(状態の不整合。収録しない)
513
- * broken_task: 読めないタスクのファイル(収録しない)
514
- * missing_record: 変更の記録の無い完了したタスク(要約の材料にしない)
515
- * no_material: 収録する要望に変更の記録が1つも無い(要約に入らない)
516
- * no_candidates: 収録する要望が無い / no_sources: 要約の材料(変更の記録)が無い
517
- * unknown_milestone: project.yaml に無いマイルストーン(直接編集で消えた。ノートだけが残っている)
518
- * material_changed: 生成・保存のあとで材料が変わった(古い材料からの本文。自動では直さない)
519
- * suspicious_content: 生成した要約に内部のパス・秘密らしい文字列がある(公開の前に確かめる)
520
- */
521
- export type ReleaseWarningCode =
522
- | "broken_request"
523
- | "not_finished"
524
- | "no_tasks"
525
- | "open_tasks"
526
- | "broken_task"
527
- | "missing_record"
528
- | "no_material"
529
- | "no_candidates"
530
- | "no_sources"
531
- | "unknown_milestone"
532
- | "material_changed"
533
- | "suspicious_content";
534
-
535
- export interface ReleaseWarning {
536
- code: ReleaseWarningCode;
537
- /** 対象(要望 ID・<要望ID>/T001・データのフォルダからの相対パス・マイルストーン ID) */
538
- target: string;
539
- message: string;
540
- }
541
-
542
- /** 材料のタスク(完了したもの)。record があるものだけが要約の材料 */
543
- export interface ReleaseSourceTask {
544
- id: string;
545
- title: string;
546
- status: TaskStatus;
547
- record?: string;
548
- }
549
-
550
- /** 材料の要望1件(収録するもの) */
551
- export interface ReleaseSource {
552
- request: string;
553
- title: string;
554
- status: RequestStatus;
555
- tasks: ReleaseSourceTask[];
556
- }
557
-
558
- /** マイルストーンに属する要望1件と、収録するかどうか */
559
- export interface ReleaseRequestItem {
560
- id: string;
561
- title: string;
562
- status: RequestStatus;
563
- createdAt: string;
564
- /** 収録する(要望が対応済か完了済で、タスクが1件以上あり、全部が完了で読める) */
565
- included: boolean;
566
- /** 収録しない理由 */
567
- reason?: string;
568
- /** タスク(アーカイブしたものは含まない)。record はここでは持たない(sources にある) */
569
- tasks: { id: string; title: string; status: TaskStatus; hasRecord: boolean }[];
570
- warnings: ReleaseWarning[];
571
- }
572
-
573
- /**
574
- * マイルストーンのリリースノートの材料。抽出したときのディスクの状態を固定したもの。
575
- * hash は材料(要望の所属・状態・タイトル、収録するタスクの記録)の識別子で、生成・保存のあとの変更を見つけるのに使う
576
- */
577
- export interface ReleaseMaterial {
578
- milestone: { id: string; title: string; due?: string; done?: boolean; known: boolean };
579
- /** 作成日時 → ID の順 */
580
- requests: ReleaseRequestItem[];
581
- /** 収録する要望と、変更の記録のある完了したタスク(要約の材料) */
582
- sources: ReleaseSource[];
583
- /** 全体の警告(読めない要望・候補なし・材料なしなど)。要望ごとの警告は requests[].warnings */
584
- warnings: ReleaseWarning[];
585
- hash: string;
586
- extractedAt: string;
587
- }
588
-
589
- /**
590
- * マイルストーンの要望を一括で完了済にできるか(core/releaseNotes/completeRequests.ts が判定する。画面・CLI は見せるだけ)。
591
- * 見送りを除く全要望が収録の条件(対応済か完了済・タスクが1件以上で全部完了・読めないタスクなし)を満たすときだけできる。
592
- * 変えるのは対応済(resolved)だけで、完了済・見送り・タスク(済みを含む)・ノートは変えない
593
- */
594
- export interface RequestCompletionPlan {
595
- milestone: string;
596
- /** 判定に使った材料の hash(実行するときにそのまま渡す) */
597
- basedOn: string;
598
- /** 実行できる(blockers が無い)。対象が0件でもできる(何も変えない) */
599
- ready: boolean;
600
- /** 完了済にする要望(対応済のもの) */
601
- targets: { id: string; title: string }[];
602
- /** 既に完了済(変えない) */
603
- alreadyDone: string[];
604
- /** 見送り(判定から除き、変えない) */
605
- skipped: string[];
606
- /** できない理由(target は要望 ID かマイルストーン・ファイル) */
607
- blockers: { target: string; reason: string }[];
608
- }
609
-
610
- /** 一括で完了済にした結果。途中で止まったら、完了済にしたもの・失敗した1件・まだ変えていないものを分けて返す */
611
- export interface RequestCompletionResult {
612
- milestone: string;
613
- completed: { id: string; title: string }[];
614
- failed?: { id: string; reason: string; code: "conflict" | "changed" | "error" };
615
- notRun: string[];
616
- alreadyDone: string[];
617
- }
618
-
619
- /** 保存したリリースノート。本文(公開する Markdown)と、内部の出典(frontmatter)を分けて持つ */
620
- export interface ReleaseNote {
621
- milestone: string;
622
- title: string;
623
- /** 公開する本文(出力はこれだけ) */
624
- body: string;
625
- /** 保存したときの材料(出典。公開しない) */
626
- sources: ReleaseSource[];
627
- /** 保存したときの材料の hash */
628
- materialHash?: string;
629
- createdAt: string;
630
- createdBy?: string;
631
- updatedAt: string;
632
- updatedBy?: string;
633
- /** 編集の版(ファイル全体の sha256)。更新はこの版を渡し、違えば競合にする */
634
- version: string;
635
- }
636
-
637
- /** 生成した機能の要約1項目。sources は出典(要望 ID か <要望ID>/T001。材料にあるものだけ) */
638
- export interface ReleaseSummaryItem {
639
- text: string;
640
- sources: string[];
641
- }
642
-
643
- export type ReleaseGenerationStatus = "running" | "completed" | "failed" | "cancelled";
644
-
645
- /**
646
- * 生成の失敗の種類。unavailable: Codex を使えない(未接続など)/ usage_limit: 使用量の上限 / timeout: 時間切れ /
647
- * invalid_output: 結果の形が違う・出典が材料に無い・長すぎる / error: そのほか
648
- */
649
- export type ReleaseGenerationFailure = "unavailable" | "usage_limit" | "timeout" | "invalid_output" | "error";
650
-
651
- /**
652
- * リリースノートの要約の生成(1回分)。保存とは別で、生成は保存したノートを変えない。
653
- * このプロセスのメモリにだけ置く(serve を止めれば消える。CLI は終わるまで待つ)
654
- */
655
- export interface ReleaseGeneration {
656
- id: string;
657
- milestone: string;
658
- /** 頼んだ先(mock は明示したときだけ。要約はしない) */
659
- engine: "codex" | "mock";
660
- status: ReleaseGenerationStatus;
661
- startedAt: string;
662
- finishedAt?: string;
663
- startedBy?: string;
664
- /** 生成に渡した材料の hash */
665
- materialHash: string;
666
- /** 生成のあとで材料が変わった(終わったときに確かめる。古い材料からの生成) */
667
- materialChanged?: boolean;
668
- /** 要約(completed のとき) */
669
- items?: ReleaseSummaryItem[];
670
- /** 要約から P3 が組み立てた本文の案(保存はしない) */
671
- markdown?: string;
672
- warnings: ReleaseWarning[];
673
- error?: string;
674
- failure?: ReleaseGenerationFailure;
675
- log: PreflightLogEntry[];
676
- }
677
-
678
- /** マイルストーンごとのノートの有無(一覧) */
679
- export interface ReleaseNoteSummary {
680
- milestone: string;
681
- title: string;
682
- due?: string;
683
- done?: boolean;
684
- /** project.yaml にあるか(無ければノートだけが残っている) */
685
- known: boolean;
686
- /** 属する要望の数(アーカイブしたものは含まない) */
687
- requests: number;
688
- note:
689
- | { state: "none" }
690
- | { state: "ok"; version: string; updatedAt: string; updatedBy?: string }
691
- | { state: "invalid"; error: string };
692
- }
693
-
694
- export interface ProjectConfig {
695
- name: string;
696
- /** 何を作っているプロジェクトか。Preflight の前提になる */
697
- description: string;
698
- /**
699
- * 参照先(リポジトリ・フォルダ。名前・役割・最初に読むか・作業先になりうるか・主なフォルダ)。
700
- * Preflight が読み、作業先にできるものはタスクの作業先になる。このマシンのパスは個人設定に置く。shared/repos.ts
701
- */
702
- repos: RepoRef[];
703
- /** マイルストーン(リリース)。複数の要望をまとめる */
704
- milestones: Milestone[];
705
- /** ブランチ命名規則。{id} {slug} を置換 */
706
- branchPattern: string;
707
- preflight: {
708
- /** プロジェクト固有の評価の観点・制約(例: 「外部 API の追加は要相談」) */
709
- instructions: string;
710
- };
711
- }
712
-
713
- /** changed の kind "reload": データのフォルダを全部読み直した(画面の「再読み込み」)。画面はすべて取り直す */
714
- export type ServerEvent =
715
- | { type: "changed"; kind: "task" | "request" | "preflight" | "note" | "attachment" | "project" | "projects" | "chatgpt" | "user" | "reload"; request?: string; ref?: string }
716
- /** リリースノートのファイルが変わった・消えた(CLI・画面・直接編集) */
717
- | { type: "changed"; kind: "release-note"; milestone: string }
718
- /** リリースノートの要約の生成の状態が変わった */
719
- | { type: "release-generation"; id: string; milestone: string; status: ReleaseGenerationStatus }
720
- | { type: "preflight-log"; runId: string; entry: PreflightLogEntry }
721
- | { type: "preflight-status"; runId: string; status: PreflightStatus };
722
-
723
- // ---------------------------------------------------------------------------
724
- // 画面のテーマ(個人設定の ui.theme。このマシンのすべてのプロジェクトで共通)
725
- // ---------------------------------------------------------------------------
726
-
727
- /** system: OS(ブラウザ)の表示設定に合わせる(既定)/ light: 常にライト / dark: 常にダーク */
728
- export const THEMES = ["system", "light", "dark"] as const;
729
- export type Theme = (typeof THEMES)[number];
730
- export const isTheme = (v: unknown): v is Theme => typeof v === "string" && (THEMES as readonly string[]).includes(v);