@infodb/p3 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (209) hide show
  1. package/bin/p3.mjs +11 -5
  2. package/dist/web/assets/Outputs-C83ZDXvs.js +1 -0
  3. package/dist/web/assets/RequestStatus-GmiWYEcL.js +1 -0
  4. package/dist/web/assets/Tabs-CJn0Qy7W.js +1 -0
  5. package/dist/web/assets/TagInput-CtM8HM8Z.js +1 -0
  6. package/dist/web/assets/TaskDrawer-D5v36QoF.js +3 -0
  7. package/dist/web/assets/_requestId-BHUqLO-j.js +1 -0
  8. package/dist/web/assets/_requestId-DxwxbXY2.js +30 -0
  9. package/dist/web/assets/{ui-Sz7y5_TS.js → appCtx-B-VRVOyv.js} +1 -1
  10. package/dist/web/assets/board-DAaVR04x.js +1 -0
  11. package/dist/web/assets/copy-CKsXEjMi.js +1 -0
  12. package/dist/web/assets/done-CaqB_qTH.js +1 -0
  13. package/dist/web/assets/index-BF1xMdJo.css +2 -0
  14. package/dist/web/assets/index-BQYvKpjF.js +12 -0
  15. package/dist/web/assets/milestoneOrder-N7b5XFJP.js +1 -0
  16. package/dist/web/assets/new-DLVnRvrB.js +1 -0
  17. package/dist/web/assets/preflightInput-BAeEJYUK.js +2 -0
  18. package/dist/web/assets/preload-helper-B74h5i3O.js +1 -0
  19. package/dist/web/assets/progressTree-wp9mH4VF.js +1 -0
  20. package/dist/web/assets/release-notes-MTLcOcvZ.js +3 -0
  21. package/dist/web/assets/requestData-D-HXu-cy.js +1 -0
  22. package/dist/web/assets/routes-CI4Qfkjs.js +3 -0
  23. package/dist/web/assets/settings-CJMNgzi6.js +1 -0
  24. package/dist/web/index.html +4 -4
  25. package/docs/architecture.md +238 -9
  26. package/docs/development.md +16 -9
  27. package/docs/how-to-use.md +128 -12
  28. package/docs/installation.md +8 -6
  29. package/docs/publishing.md +4 -2
  30. package/lib/cli/args.js +172 -0
  31. package/lib/cli/chatgpt.js +70 -0
  32. package/lib/cli/codex.js +30 -0
  33. package/lib/cli/format.js +9 -0
  34. package/{src/cli/help.ts → lib/cli/help.js} +11 -8
  35. package/lib/cli/main.js +326 -0
  36. package/lib/cli/output.js +110 -0
  37. package/lib/cli/preflightCommands.js +301 -0
  38. package/lib/cli/project.js +649 -0
  39. package/lib/cli/readOnly.js +36 -0
  40. package/lib/cli/releaseNotesCommands.js +197 -0
  41. package/lib/cli/render.js +58 -0
  42. package/lib/cli/requestCommands.js +180 -0
  43. package/lib/cli/showView.js +100 -0
  44. package/lib/cli/taskCommands.js +152 -0
  45. package/lib/cli/userConfig.js +64 -0
  46. package/{src/core/chatgpt.ts → lib/core/chatgpt.js} +10 -16
  47. package/lib/core/context.js +41 -0
  48. package/lib/core/hierarchy.js +128 -0
  49. package/lib/core/machineSettings.js +146 -0
  50. package/lib/core/machineSettingsEdit.js +148 -0
  51. package/lib/core/ops.js +120 -0
  52. package/lib/core/preflight/carryover.js +105 -0
  53. package/lib/core/preflight/codexEngine.js +687 -0
  54. package/lib/core/preflight/codexImage.js +61 -0
  55. package/lib/core/preflight/diagnose.js +95 -0
  56. package/lib/core/preflight/engine.js +58 -0
  57. package/lib/core/preflight/input.js +83 -0
  58. package/lib/core/preflight/launch.js +68 -0
  59. package/lib/core/preflight/mockEngine.js +175 -0
  60. package/lib/core/preflight/render.js +304 -0
  61. package/lib/core/preflight/service.js +868 -0
  62. package/lib/core/preflight/split.js +83 -0
  63. package/lib/core/preflight/uiMaterials.js +281 -0
  64. package/lib/core/preflight/uiRender.js +89 -0
  65. package/lib/core/preflight/wireframe.js +63 -0
  66. package/lib/core/preflight/xlsx.js +324 -0
  67. package/lib/core/projectRegistry.js +207 -0
  68. package/lib/core/redact.js +28 -0
  69. package/lib/core/releaseNotes/completeRequests.js +106 -0
  70. package/lib/core/releaseNotes/generate.js +266 -0
  71. package/lib/core/releaseNotes/material.js +141 -0
  72. package/lib/core/releaseNotes/mockSummarizer.js +26 -0
  73. package/lib/core/releaseNotes/service.js +83 -0
  74. package/lib/core/releaseNotes/store.js +209 -0
  75. package/lib/core/repoAdmin.js +82 -0
  76. package/lib/core/repoRefs.js +72 -0
  77. package/lib/core/requestOps.js +154 -0
  78. package/lib/core/requestStatus.js +171 -0
  79. package/lib/core/store/attachments.js +242 -0
  80. package/lib/core/store/collection.js +254 -0
  81. package/lib/core/store/frontmatter.js +18 -0
  82. package/lib/core/store/fsutil.js +84 -0
  83. package/lib/core/store/locate.js +162 -0
  84. package/lib/core/store/normalize.js +150 -0
  85. package/lib/core/store/noteStore.js +59 -0
  86. package/lib/core/store/preflightStore.js +161 -0
  87. package/lib/core/store/projectFile.js +99 -0
  88. package/lib/core/store/workspace.js +320 -0
  89. package/lib/core/supersede.js +69 -0
  90. package/lib/core/userConfig.js +158 -0
  91. package/{src/core/userTheme.ts → lib/core/userTheme.js} +11 -13
  92. package/lib/core/workTargets.js +106 -0
  93. package/lib/server/api/chatgptRoutes.js +46 -0
  94. package/{src/server/api/local.ts → lib/server/api/local.js} +23 -22
  95. package/lib/server/api/manifest.js +140 -0
  96. package/lib/server/api/projectsRoutes.js +82 -0
  97. package/lib/server/api/releaseNoteRoutes.js +88 -0
  98. package/lib/server/api/repoRoutes.js +67 -0
  99. package/lib/server/api/routes.js +404 -0
  100. package/lib/server/api/userThemeRoutes.js +60 -0
  101. package/lib/server/server.js +85 -0
  102. package/lib/shared/dates.js +10 -0
  103. package/{src/shared/directTask.ts → lib/shared/directTask.js} +3 -11
  104. package/lib/shared/hierarchy.js +120 -0
  105. package/lib/shared/milestoneOrder.js +45 -0
  106. package/lib/shared/preflightInput.js +19 -0
  107. package/lib/shared/refs.js +44 -0
  108. package/lib/shared/repos.js +69 -0
  109. package/lib/shared/scopeView.js +39 -0
  110. package/{src/shared/tags.ts → lib/shared/tags.js} +9 -14
  111. package/lib/shared/types.js +74 -0
  112. package/lib/shared/workTarget.js +31 -0
  113. package/package.json +4 -7
  114. package/skills/p3/SKILL.md +29 -8
  115. package/dist/web/assets/Outputs-DqJdybkd.js +0 -1
  116. package/dist/web/assets/RequestStatus-DN-2iAM0.js +0 -1
  117. package/dist/web/assets/TagInput-D-1ILLDX.js +0 -1
  118. package/dist/web/assets/TaskDrawer-CHD7T-Su.js +0 -3
  119. package/dist/web/assets/_requestId-BzSepQIV.js +0 -30
  120. package/dist/web/assets/_requestId-pIds2tFU.js +0 -1
  121. package/dist/web/assets/board-BIkOpuC4.js +0 -1
  122. package/dist/web/assets/copy-B1ZbihKL.js +0 -2
  123. package/dist/web/assets/done-BUAUhIRr.js +0 -1
  124. package/dist/web/assets/index-Byv9j77D.js +0 -12
  125. package/dist/web/assets/index-DTfUhuQw.css +0 -2
  126. package/dist/web/assets/new-6kly4-PX.js +0 -1
  127. package/dist/web/assets/preload-helper-DlN0ouRj.js +0 -1
  128. package/dist/web/assets/release-notes-iwQWmfX6.js +0 -3
  129. package/dist/web/assets/requestData-DJ1Rlx-u.js +0 -1
  130. package/dist/web/assets/routes-Ciot9p4x.js +0 -2
  131. package/dist/web/assets/settings-DBCi6lAY.js +0 -1
  132. package/src/cli/args.ts +0 -186
  133. package/src/cli/chatgpt.ts +0 -74
  134. package/src/cli/codex.ts +0 -28
  135. package/src/cli/format.ts +0 -9
  136. package/src/cli/main.ts +0 -336
  137. package/src/cli/output.ts +0 -117
  138. package/src/cli/preflightCommands.ts +0 -245
  139. package/src/cli/project.ts +0 -672
  140. package/src/cli/readOnly.ts +0 -36
  141. package/src/cli/releaseNotesCommands.ts +0 -159
  142. package/src/cli/render.ts +0 -60
  143. package/src/cli/requestCommands.ts +0 -170
  144. package/src/cli/showView.ts +0 -110
  145. package/src/cli/taskCommands.ts +0 -167
  146. package/src/cli/userConfig.ts +0 -58
  147. package/src/core/context.ts +0 -58
  148. package/src/core/machineSettings.ts +0 -207
  149. package/src/core/machineSettingsEdit.ts +0 -156
  150. package/src/core/ops.ts +0 -114
  151. package/src/core/preflight/carryover.ts +0 -133
  152. package/src/core/preflight/codexEngine.ts +0 -703
  153. package/src/core/preflight/codexImage.ts +0 -98
  154. package/src/core/preflight/diagnose.ts +0 -124
  155. package/src/core/preflight/engine.ts +0 -92
  156. package/src/core/preflight/input.ts +0 -65
  157. package/src/core/preflight/launch.ts +0 -86
  158. package/src/core/preflight/mockEngine.ts +0 -145
  159. package/src/core/preflight/render.ts +0 -339
  160. package/src/core/preflight/service.ts +0 -707
  161. package/src/core/preflight/uiMaterials.ts +0 -272
  162. package/src/core/preflight/uiRender.ts +0 -84
  163. package/src/core/preflight/wireframe.ts +0 -69
  164. package/src/core/preflight/xlsx.ts +0 -328
  165. package/src/core/projectRegistry.ts +0 -264
  166. package/src/core/redact.ts +0 -31
  167. package/src/core/releaseNotes/generate.ts +0 -283
  168. package/src/core/releaseNotes/material.ts +0 -114
  169. package/src/core/releaseNotes/mockSummarizer.ts +0 -28
  170. package/src/core/releaseNotes/service.ts +0 -106
  171. package/src/core/releaseNotes/store.ts +0 -216
  172. package/src/core/repoAdmin.ts +0 -81
  173. package/src/core/repoRefs.ts +0 -90
  174. package/src/core/requestOps.ts +0 -140
  175. package/src/core/requestStatus.ts +0 -58
  176. package/src/core/store/attachments.ts +0 -228
  177. package/src/core/store/collection.ts +0 -282
  178. package/src/core/store/frontmatter.ts +0 -22
  179. package/src/core/store/fsutil.ts +0 -90
  180. package/src/core/store/locate.ts +0 -181
  181. package/src/core/store/normalize.ts +0 -155
  182. package/src/core/store/noteStore.ts +0 -56
  183. package/src/core/store/preflightStore.ts +0 -136
  184. package/src/core/store/projectFile.ts +0 -101
  185. package/src/core/store/workspace.ts +0 -328
  186. package/src/core/supersede.ts +0 -74
  187. package/src/core/userConfig.ts +0 -205
  188. package/src/core/workTargets.ts +0 -120
  189. package/src/server/api/chatgptRoutes.ts +0 -49
  190. package/src/server/api/manifest.ts +0 -128
  191. package/src/server/api/projectsRoutes.ts +0 -89
  192. package/src/server/api/releaseNoteRoutes.ts +0 -78
  193. package/src/server/api/repoRoutes.ts +0 -67
  194. package/src/server/api/routes.ts +0 -382
  195. package/src/server/api/userThemeRoutes.ts +0 -62
  196. package/src/server/server.ts +0 -108
  197. package/src/shared/dates.ts +0 -12
  198. package/src/shared/preflightInput.ts +0 -27
  199. package/src/shared/refs.ts +0 -55
  200. package/src/shared/repos.ts +0 -113
  201. package/src/shared/scopeView.ts +0 -48
  202. package/src/shared/types.ts +0 -700
  203. package/src/shared/workTarget.ts +0 -44
  204. /package/{src → lib}/core/preflight/launcher.mjs +0 -0
  205. /package/{src → lib}/core/preflight/mock-ui.html +0 -0
  206. /package/{src → lib}/core/preflight/mock-ui.png +0 -0
  207. /package/{src → lib}/core/preflight/render-image/Dockerfile +0 -0
  208. /package/{src → lib}/core/preflight/render-image/fonts-ja.conf +0 -0
  209. /package/{src → lib}/core/preflight/render-image/render.mjs +0 -0
@@ -0,0 +1,30 @@
1
+ import { CodexImageError, updateCodexImage } from "../core/preflight/codexImage.js";
2
+ import { UsageError } from "./project.js";
3
+ /**
4
+ * p3 codex update。Codex を動かすイメージを今すぐ作り直し、入った Codex の版を表示する。
5
+ * プロジェクトを決める前に動く(このマシンの Docker のもの。プロジェクト・認証・個人設定の自動更新の停止に関係しない)。
6
+ * 進み具合は stderr に出し、--json の stdout は結果だけにする。
7
+ */
8
+ export async function codexCommand(args, docker = "docker") {
9
+ const [sub] = args;
10
+ if (sub !== "update")
11
+ throw new UsageError("p3 codex update(Codex のイメージを今すぐ作り直して、最新の Codex を入れる)");
12
+ let r;
13
+ try {
14
+ r = await updateCodexImage({ docker, onProgress: (t) => process.stderr.write(`${t}\n`) });
15
+ }
16
+ catch (e) {
17
+ if (!(e instanceof CodexImageError))
18
+ throw e;
19
+ return {
20
+ data: { ok: false, step: e.step, error: e.message, detail: e.detail ?? null },
21
+ text: `更新できませんでした: ${e.message}${e.detail ? `\n ${e.detail}` : ""}`,
22
+ code: 1,
23
+ };
24
+ }
25
+ const change = r.previous && r.previous !== r.version ? `(${r.previous} から)` : r.previous ? "(変わらず。これが最新)" : "";
26
+ return {
27
+ data: { ok: true, ...r },
28
+ text: `Codex を更新しました: ${r.version}${change}\n イメージ ${r.image}${r.createdAt ? `(${r.createdAt.slice(0, 19).replace("T", " ")} 作成)` : ""}`,
29
+ };
30
+ }
@@ -0,0 +1,9 @@
1
+ /** 表示幅(全角は2)を考慮して列を揃える */
2
+ export function table(rows) {
3
+ const width = (s) => Array.from(s).reduce((w, ch) => w + (/[ᄀ-ᅟ⺀-꓏가-힣豈-﫿︰-﹏＀-⦆¢-₩]/.test(ch) ? 2 : 1), 0);
4
+ const cols = Math.max(0, ...rows.map((r) => r.length));
5
+ const max = Array.from({ length: cols - 1 }, (_, i) => Math.min(48, Math.max(...rows.map((r) => width(r[i] ?? "")))));
6
+ return rows
7
+ .map((r) => r.map((c, i) => (i < cols - 1 ? c + " ".repeat(Math.max(0, max[i] - width(c))) : c)).join(" ").trimEnd())
8
+ .join("\n");
9
+ }
@@ -1,7 +1,5 @@
1
- import { RELATION_TYPES, REQUEST_STATUSES, relationTypes } from "../shared/types.ts";
2
-
1
+ import { RELATION_TYPES, REQUEST_STATUSES, relationTypes } from "../shared/types.js";
3
2
  /** p3 help */
4
-
5
3
  export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分けて管理するファイルベースのタスク管理
6
4
 
7
5
  使い方: p3 <コマンド> [引数] [オプション]
@@ -36,6 +34,9 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
36
34
  release-notes save <id> 本文を保存する --body 本文|- / --file 本文.md --based-on <材料の hash>(生成の案を元にしたとき)
37
35
  既にあるノートの更新は --version <版>(show で見る。違えば競合で終了コード 3)
38
36
  release-notes export <id> 保存した本文だけを stdout に出す(出典・frontmatter は出さない)
37
+ release-notes complete-requests <id> --based-on <hash>
38
+ 対応済の要望を一括で完了済にする(見送り以外の全要望が全タスク完了のときだけ。タスクの済みは変えない)。
39
+ できるか・対象・hash は show で見る。材料が変わっていれば何も変えずに終了コード 3、途中で止まったら非ゼロ
39
40
  例: p3 release-notes generate v0.2 > draft.md → 直す → p3 release-notes save v0.2 --file draft.md
40
41
  p3 release-notes export v0.2 > RELEASE.md
41
42
  whoami 操作するプロジェクト・変更者・今の要望
@@ -52,15 +53,16 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
52
53
  要望
53
54
  request new <タイトル> --body 本文|- --area パス --due YYYY-MM-DD --milestone id --tag 値(外部 ID・分類。繰り返し可)
54
55
  --attach ファイル(PNG / JPEG / xlsx。繰り返し可。作る前に全部確かめ、だめなら要望を作らない)
55
- request ls 一覧(--status draft,active ... --milestone id --tag 値。繰り返すとどれか)
56
- request show [<要望>] --brief 作業に要る項目だけ(本文・状態・ブランチ・タスクの一覧)
57
- request set [<要望>] キー=値 title status due milestone tags areas(status: ${REQUEST_STATUSES.join(" ")})
56
+ --parent <要望> 子の要望にする(省いた期限・マイルストーン・タグは親から写す)
57
+ request ls 一覧(--status draft,active ... --milestone id --tag 値。繰り返すとどれか。--parent <要望> で直下の子)
58
+ request show [<要望>] --brief 作業に要る項目だけ(本文・状態・ブランチ・タスクの一覧・親子)
59
+ request set [<要望>] キー=値 title status due milestone tags areas parent(status: ${REQUEST_STATUSES.join(" ")}。parent= で親を外す)
58
60
  --body 本文|- 本文を書き換える(- は標準入力。どの状態でも書き換えられる。--rev で楽観ロック)
59
61
  例: p3 request show <要望> --brief --json で rev を見て
60
62
  p3 request set <要望> --body - --rev 3 < body.md
61
63
  評価のあとでタイトル・本文を変えると、その評価からはタスク化できない(もう一度 preflight)
62
64
  --tag 値 ... タグをこの値の並びに置き換える(カンマで分けない。tags=a,b はカンマで分ける)
63
- request archive <要望>
65
+ request archive <要望> 子のある要望・親のある要望はできない(先に親を外す)
64
66
 
65
67
  タスク(今の要望の中。--req <要望> で指定、要望の作業ツリーの中なら省略可)
66
68
  ls 一覧 --status s1,s2 --area パス -q 語句 --repo <参照先>|none(作業先) --all(全要望)
@@ -89,6 +91,8 @@ Preflight
89
91
  accept [<要望>] タスク案をタスク化 --run PF-... --only D1,D2 --skip D3
90
92
  評価のあとでタイトル・本文が変わった run からはしない(code: stale_input。再評価する)
91
93
  置き換えられる既存タスクを表示して残す。--archive-superseded でアーカイブ
94
+ 分割の run(子の要望の案 C1, C2 ...)は、選んだ案から下書きの子の要望を作る(親は残す。子の Preflight はまだ)。
95
+ 途中で失敗したら同じ accept で続ける(作った子は作り直さない)
92
96
 
93
97
  共通オプション
94
98
  --project 名前 操作するプロジェクト(既定: 今いるリポジトリに登録したもの → 登録が1つならそれ。
@@ -102,4 +106,3 @@ Preflight
102
106
  タスクの関係(同じ要望の中だけ。Preflight のタスク化が張り、手では張らない。A → B のとき A には「相手の役割 B」、B には「相手の役割 A」と出る):
103
107
  ${relationTypes.map((t) => ` ${t.padEnd(13)} ${RELATION_TYPES[t].verb} →「${RELATION_TYPES[t].label}」/ 逆「${RELATION_TYPES[t].inverse}」`).join("\n")}
104
108
  `;
105
-
@@ -0,0 +1,326 @@
1
+ import { renderCommand } from "./render.js";
2
+ import { daysUntil, localToday } from "../shared/dates.js";
3
+ import { openProject } from "../core/context.js";
4
+ import { machineSettingsSource, resolveMachineSettings, SettingsError } from "../core/machineSettings.js";
5
+ import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.js";
6
+ import { OpRuleError } from "../core/requestOps.js";
7
+ import { HierarchyError } from "../core/hierarchy.js";
8
+ import { startServer } from "../server/server.js";
9
+ import { ConflictError, NotFoundError } from "../core/store/collection.js";
10
+ import { DataDirError, onlyRegistrationNotice, ProjectNotResolvedError, resolveProject, VIA_LABEL } from "../core/store/locate.js";
11
+ import { loadUserConfig, UserConfigError } from "../core/userConfig.js";
12
+ import { codexCommand } from "./codex.js";
13
+ import { userConfigCommand } from "./userConfig.js";
14
+ import { chatgptCommand } from "./chatgpt.js";
15
+ import { table } from "./format.js";
16
+ import { config, currentRequest, init, isAgentChoice, joinProject, locateHere, placeAgents, projectCommand, repoCommand, repoRoot, resolveActor, UsageError } from "./project.js";
17
+ import { HELP } from "./help.js";
18
+ import { readsOnly } from "./readOnly.js";
19
+ import { parse } from "./args.js";
20
+ import { Output, bar } from "./output.js";
21
+ import { requestCommand, milestoneCommand } from "./requestCommands.js";
22
+ import { taskCommand } from "./taskCommands.js";
23
+ import { preflightCommand } from "./preflightCommands.js";
24
+ import { releaseNotesCommand } from "./releaseNotesCommands.js";
25
+ import { ReleaseNoteError } from "../core/releaseNotes/store.js";
26
+ import { sortMilestones } from "../shared/milestoneOrder.js";
27
+ import { GenerationRejected } from "../core/releaseNotes/generate.js";
28
+ /**
29
+ * p3 CLI。人も AI エージェントも使う。
30
+ *
31
+ * サーバを経由せず、プロジェクトのデータのフォルダのファイルを直接読み書きする。
32
+ * 操作するプロジェクトは --project、今いる場所(登録したリポジトリの中か)、個人設定から決める(store/locate.ts)。
33
+ * だから認証は要らず、サーバが動いていれば変更は監視経由でそのまま画面に反映される。
34
+ * AI は `--json` で機械可読な出力を得て、`P3_ACTOR=ai:<name>` で変更者を名乗る。
35
+ *
36
+ * 作業の単位は要望。タスクの操作は「今の要望」に対して行う。今の要望は --req、P3_REQUEST、
37
+ * または要望の作業ツリー(ブランチ req/<要望ID>-...)から決まる。
38
+ */
39
+ /**
40
+ * SIGTERM(docker stop)・SIGINT(Ctrl-C)で止める。新しい要求を断り、実行中の Preflight・生成を取り消して終わるまで待ってから終わる。
41
+ * 2回目の信号ではすぐ終わる
42
+ */
43
+ function serveUntilSignal(server) {
44
+ return new Promise((done) => {
45
+ let stopping = false;
46
+ const stop = (signal) => {
47
+ if (stopping)
48
+ return done(1);
49
+ stopping = true;
50
+ process.stderr.write(`p3: ${signal} を受けたので止めます(実行中の Preflight・生成は取り消して記録します)\n`);
51
+ void (async () => {
52
+ try {
53
+ const { pending } = await server.close();
54
+ if (pending)
55
+ process.stderr.write(`p3: 待ちきれずに止めました(終わっていない実行 ${pending} 件)\n`);
56
+ done(pending ? 1 : 0);
57
+ }
58
+ catch (e) {
59
+ process.stderr.write(`p3: 止める途中で失敗しました: ${e.message}\n`);
60
+ done(1);
61
+ }
62
+ })();
63
+ };
64
+ process.on("SIGTERM", () => stop("SIGTERM"));
65
+ process.on("SIGINT", () => stop("SIGINT"));
66
+ });
67
+ }
68
+ async function main(argv) {
69
+ const { values: o, positionals } = parse(argv);
70
+ const [cmd, ...args] = positionals;
71
+ if (!cmd || o.help || cmd === "help") {
72
+ process.stdout.write(HELP);
73
+ return 0;
74
+ }
75
+ const cwd = process.cwd();
76
+ const out = new Output(o.json ?? false);
77
+ // --force は p3 agents だけ(ほかのコマンドで黙って無視しない)
78
+ if (o.force && cmd !== "agents")
79
+ throw new UsageError("--force は p3 agents でだけ使えます");
80
+ // --all-projects は serve だけ。1つのプロジェクトを決める指定とは一緒に使えない(どちらかに黙って決めない)
81
+ if (o["all-projects"]) {
82
+ if (cmd !== "serve")
83
+ throw new UsageError("--all-projects は p3 serve でだけ使えます");
84
+ if (o.project !== undefined || o.dir !== undefined) {
85
+ throw new UsageError("--all-projects と --project / --dir は一緒に使えません(1つのプロジェクトだけを開くなら --all-projects を外す)");
86
+ }
87
+ // プロジェクトを決めずに起動する(個人設定が壊れていても、画面で理由を見せて直せるように起動する)
88
+ const user = await loadUserConfig().catch((e) => {
89
+ process.stderr.write(`⚠ ${e.message}(待ち受けは既定の値で起動します)\n`);
90
+ return { settings: {} };
91
+ });
92
+ const settings = resolveMachineSettings(user, process.env, { port: o.port, host: o.host });
93
+ const source = machineSettingsSource({ cli: { port: o.port, host: o.host } });
94
+ return serveUntilSignal(await startServer({ allProjects: true, port: settings.serve.port, host: settings.serve.host, static: true, settings: source }));
95
+ }
96
+ // AI 向けの使い方を置く・最新にする。今いるリポジトリのルートに置くだけで、プロジェクトは決めない(データ・個人設定は変えない)
97
+ if (cmd === "agents") {
98
+ const [choice, ...rest] = args;
99
+ const usage = "p3 agents claude|codex|both [--force](置く先を選ぶ。省けません)";
100
+ if (!isAgentChoice(choice) || rest.length)
101
+ throw new UsageError(choice === undefined ? `置く先を指定してください: ${usage}` : `置く先は claude / codex / both のどれか: ${[choice, ...rest].join(" ")}(${usage})`);
102
+ if (o.agents !== undefined)
103
+ throw new UsageError(`p3 agents に --agents は要りません(${usage})`);
104
+ const root = repoRoot(cwd);
105
+ console.log([`AI 向けの使い方(${root})`, ...(await placeAgents(root, cwd, choice, o.force))].join("\n"));
106
+ return 0;
107
+ }
108
+ if (cmd === "join") {
109
+ // 参加は個人設定に登録するだけ。AI 向けのファイルと、作るときだけの項目は受け付けない(黙って無視しない)
110
+ if (o.agents !== undefined)
111
+ throw new UsageError("join は AI 向けのファイルを置きません(--agents は使えません)。置く・最新にするなら p3 agents claude|codex|both");
112
+ const createOnly = ["name", "description", "instructions"].filter((k) => o[k] !== undefined);
113
+ if (createOnly.length)
114
+ throw new UsageError(`join では ${createOnly.map((k) => `--${k}`).join("・")} は使えません(共有の定義は変えません。変えるなら p3 config set)`);
115
+ if (args.length)
116
+ throw new UsageError(`join は位置引数を取りません: ${args.join(" ")}(p3 join [--project <名前>] [--dir <フォルダ>] [--repo-name <名前>])`);
117
+ console.log(await joinProject({ cwd, project: o.project, dir: o.dir, repoName: o["repo-name"], yes: o.yes }));
118
+ return 0;
119
+ }
120
+ if (cmd === "init") {
121
+ if (o.agents !== undefined && !isAgentChoice(o.agents))
122
+ throw new UsageError(`--agents は claude / codex / both のどれか(値を省くと both): ${o.agents || "(空)"}`);
123
+ if (args.length)
124
+ throw new UsageError(`init は位置引数を取りません: ${args.join(" ")}`);
125
+ console.log(await init({
126
+ cwd,
127
+ project: o.project,
128
+ dir: o.dir,
129
+ name: o.name,
130
+ description: o.description,
131
+ instructions: o.instructions,
132
+ agents: o.agents,
133
+ yes: o.yes,
134
+ repoName: o["repo-name"],
135
+ }));
136
+ return 0;
137
+ }
138
+ // ChatGPT との接続はこのマシンのもの(どのプロジェクトにも属さない)なので、プロジェクトを決める前に扱う
139
+ if (cmd === "chatgpt") {
140
+ const r = await chatgptCommand(args, o);
141
+ out.result(r.data, () => r.text);
142
+ return r.code ?? 0;
143
+ }
144
+ // Codex のイメージはこのマシンの Docker のもの。プロジェクト・認証が無くても更新できる
145
+ if (cmd === "codex") {
146
+ const r = await codexCommand(args);
147
+ out.result(r.data, () => r.text);
148
+ return r.code ?? 0;
149
+ }
150
+ // 描画はこのマシンの Docker のもの。プロジェクトが決まらなくても使える(パスの対応は個人設定から)
151
+ if (cmd === "render") {
152
+ const r = await renderCommand(args, o, resolveMachineSettings(await loadUserConfig(), process.env));
153
+ out.result(r.data, () => r.text);
154
+ return r.code ?? 0;
155
+ }
156
+ // 個人設定(このマシン・この人)。プロジェクトが決まらなくても使える
157
+ if (cmd === "user-config") {
158
+ const r = await userConfigCommand(args);
159
+ return out.result(r.data, () => r.text);
160
+ }
161
+ const user = await loadUserConfig();
162
+ if (cmd === "project") {
163
+ let current;
164
+ try {
165
+ current = resolveProject({ cwd, dir: o.dir, project: o.project, user }).name;
166
+ }
167
+ catch {
168
+ // 決まらなくても一覧は出す
169
+ }
170
+ const r = await projectCommand(cwd, args, o, current);
171
+ return out.result(r.data, () => r.text);
172
+ }
173
+ const target = resolveProject({ cwd, dir: o.dir, project: o.project, user });
174
+ // 登録が1つだけで決まった(今いる場所では決まっていない)なら、変える操作は何も読み書きする前に止め、読むだけなら警告する
175
+ if (target.via === "only") {
176
+ const write = !readsOnly(cmd, args);
177
+ if (write)
178
+ throw new ProjectNotResolvedError(onlyRegistrationNotice(target, true));
179
+ process.stderr.write(`${onlyRegistrationNotice(target, false)}\n`);
180
+ }
181
+ // マシンごとの設定は環境変数と個人設定から(.env は読まない)
182
+ const settings = resolveMachineSettings(user, process.env, { port: o.port, host: o.host });
183
+ if (cmd === "serve") {
184
+ // 待ち受け(host / port)は起動のときに決める。Codex と Preflight の設定は Preflight を始めるたびに個人設定から読み直す
185
+ const source = machineSettingsSource({ cli: { port: o.port, host: o.host } });
186
+ return serveUntilSignal(await startServer({ dataDir: target.dataDir, repos: target.repos, projectName: target.name, port: settings.serve.port, host: settings.serve.host, static: true, settings: source }));
187
+ }
188
+ const ctx = await openProject(target.dataDir, { repos: target.repos, settings, projectName: target.name });
189
+ const actor = resolveActor(o.actor ?? process.env.P3_ACTOR, cwd);
190
+ const current = currentRequest(ctx, o.req ?? o.request ?? process.env.P3_REQUEST, cwd);
191
+ const expectedRev = o.rev !== undefined ? Number(o.rev) : undefined;
192
+ /** 要望の引数(省略時は今の要望) */
193
+ const requestArg = (raw) => {
194
+ if (raw) {
195
+ const id = resolveRequestId(ctx, raw);
196
+ if (!id)
197
+ throw new NotFoundError(raw);
198
+ return id;
199
+ }
200
+ if (!current)
201
+ throw new UsageError("要望を指定してください(引数か --req。要望の作業ツリーの中なら省略可)");
202
+ return current;
203
+ };
204
+ /** タスクの引数(T003 は今の要望の中) */
205
+ const taskArg = (raw) => {
206
+ if (!raw)
207
+ throw new UsageError("タスクを指定してください(T003 / <要望>/T003)");
208
+ const ref = resolveRef(ctx, raw, current);
209
+ if (ref?.includes("/"))
210
+ return ref;
211
+ if (!ref && !raw.includes("/") && !current)
212
+ throw new UsageError(`${raw}: 要望を --req で指定してください`);
213
+ throw new NotFoundError(raw);
214
+ };
215
+ const split = (ref) => {
216
+ const [rid, tid] = ref.split("/");
217
+ return { col: ctx.ws.tasksOf(rid), rid, tid };
218
+ };
219
+ const env = { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd, target };
220
+ const handled = (await taskCommand(cmd, env)) ?? (await preflightCommand(cmd, env));
221
+ if (handled !== undefined)
222
+ return handled;
223
+ switch (cmd) {
224
+ case "config": {
225
+ const r = await config(ctx.ws, args);
226
+ return out.result(r.data, () => r.text);
227
+ }
228
+ case "repo": {
229
+ const r = await repoCommand(ctx.ws, target.name, cwd, args, { local: o.local });
230
+ return out.result(r.data, () => r.text);
231
+ }
232
+ case "whoami": {
233
+ const here = locateHere(ctx, cwd);
234
+ return out.result({ project: target.name ?? null, dataDir: target.dataDir, via: target.via, here: here.repos, branch: here.branch ?? null, actor, request: current ?? null }, () => [
235
+ `プロジェクト ${target.name ?? "(未登録)"} ${target.dataDir}`,
236
+ `決まり方 ${target.via}(${VIA_LABEL[target.via]})`,
237
+ `今いる参照先 ${here.repos.length ? here.repos.join(", ") : "(どの参照先の中でもない。p3 repo ls)"}${here.branch ? ` ブランチ ${here.branch}` : ""}`,
238
+ `変更者 ${actor}`,
239
+ `要望 ${current ? `${current} ${titleOf(ctx, current)}` : "(なし)"}`,
240
+ ].join("\n"));
241
+ }
242
+ case "progress": {
243
+ const ps = progress(ctx).filter((p) => o.all || !["done", "rejected"].includes(p.request.status));
244
+ const today = localToday();
245
+ return out.result(ps, () => {
246
+ const groups = [
247
+ ...sortMilestones(ctx.ws.project.milestones).map((m) => ({ m, ps: ps.filter((p) => p.request.milestone === m.id) })),
248
+ { m: undefined, ps: ps.filter((p) => !p.request.milestone) },
249
+ ];
250
+ return (groups
251
+ .filter((g) => g.ps.length)
252
+ .map((g) => {
253
+ const done = g.ps.reduce((n, p) => n + p.done, 0);
254
+ const total = g.ps.reduce((n, p) => n + p.total, 0);
255
+ const head = g.m
256
+ ? `■ ${g.m.title}(${g.m.id}${g.m.due ? ` · ${g.m.due}` : ""}${g.m.done ? " · リリース済み" : ""}) タスク ${done}/${total}`
257
+ : "■ マイルストーンなし";
258
+ const rows = g.ps.map((p) => [
259
+ ` ${p.request.id}`,
260
+ p.request.status,
261
+ `${bar(p.total ? p.done / p.total : 0)} ${p.done}/${p.total}`,
262
+ p.request.due
263
+ ? `${p.request.due}${daysUntil(p.request.due, today) < 0 && !["done", "rejected"].includes(p.request.status) ? " 超過" : ""}`
264
+ : "",
265
+ p.request.tags.map((t) => `#${t}`).join(" "),
266
+ // 子のある要望は配下の集計(自分の値とは別)、子は親を添える
267
+ `${p.request.title}${p.children.length ? ` [配下 ${p.subtree.done}/${p.subtree.total}・子 ${p.children.length}]` : ""}${p.request.parent ? ` ↑${p.request.parent}` : ""}${p.hierarchyIssues.length ? " ※親子の問題" : ""}`,
268
+ ]);
269
+ return `${head}\n${table(rows)}`;
270
+ })
271
+ .join("\n\n") || "要望はありません");
272
+ });
273
+ }
274
+ case "milestone":
275
+ case "milestones":
276
+ return milestoneCommand(ctx, out, args, o);
277
+ case "release-notes":
278
+ case "release-note":
279
+ return releaseNotesCommand(env);
280
+ // --- 要望 ---------------------------------------------------------------
281
+ case "request":
282
+ case "req":
283
+ return requestCommand(ctx, out, args, o, actor, requestArg, expectedRev);
284
+ default:
285
+ throw new UsageError(`不明なコマンド: ${cmd}(p3 help)`);
286
+ }
287
+ }
288
+ main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
289
+ if (e instanceof ConflictError) {
290
+ process.stderr.write(`競合: ${e.message}。最新を取得してやり直してください\n`);
291
+ process.exit(3);
292
+ }
293
+ if (e instanceof UserConfigError) {
294
+ process.stderr.write(`${e.message}\n`);
295
+ process.exit(1);
296
+ }
297
+ if (e instanceof SettingsError) {
298
+ process.stderr.write(`設定: ${e.message}\n`);
299
+ process.exit(1);
300
+ }
301
+ if (e instanceof ProjectNotResolvedError || e instanceof DataDirError) {
302
+ process.stderr.write(`${e.message}\n`);
303
+ process.exit(1);
304
+ }
305
+ // リリースノート: 無い → 2、版の競合・既にある → 3、読めない・ID が使えない → 1
306
+ if (e instanceof ReleaseNoteError) {
307
+ process.stderr.write(`${e.code === "conflict" ? "競合: " : ""}${e.message}\n`);
308
+ process.exit(e.code === "not_found" ? 2 : e.code === "conflict" || e.code === "exists" ? 3 : 1);
309
+ }
310
+ // 生成を始められない(材料が無い・上限・実行中)。Codex は呼んでいない
311
+ if (e instanceof GenerationRejected) {
312
+ process.stderr.write(`${e.message}\n`);
313
+ process.exit(1);
314
+ }
315
+ // 要望の親子: ロックを取れない → 3(そのままやり直せる)、規則に合わない → 1
316
+ if (e instanceof HierarchyError) {
317
+ process.stderr.write(`${e.message}\n`);
318
+ process.exit(e.code === "hierarchy_busy" ? 3 : 1);
319
+ }
320
+ if (e instanceof NotFoundError) {
321
+ process.stderr.write(`見つかりません: ${e.id}\n`);
322
+ process.exit(2);
323
+ }
324
+ process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError ? "" : "エラー: "}${e.message}\n`);
325
+ process.exit(1);
326
+ });
@@ -0,0 +1,110 @@
1
+ import { absRef } from "../shared/refs.js";
2
+ import { relationRole } from "../shared/types.js";
3
+ import {} from "../core/context.js";
4
+ import { resolve, titleOf } from "../core/ops.js";
5
+ import {} from "../core/supersede.js";
6
+ import { table } from "./format.js";
7
+ import { taskWork } from "../core/workTargets.js";
8
+ import { DIRECT_TASK_NOTE, LATER_PREFLIGHT_NOTE } from "../shared/directTask.js";
9
+ /** CLI の出力(人向けの表と --json)と、表示の部品 */
10
+ // --- 表示 -----------------------------------------------------------------
11
+ export class Output {
12
+ json;
13
+ constructor(json) {
14
+ this.json = json;
15
+ }
16
+ result(data, human) {
17
+ process.stdout.write(this.json ? `${JSON.stringify(data, null, 2)}\n` : `${human()}\n`);
18
+ return 0;
19
+ }
20
+ }
21
+ /** 同じ要望の中で、このタスクに依存しているタスク */
22
+ export const dependentsOf = (ctx, t) => ctx.ws.tasksOf(t.request).list().filter((x) => x.relations.some((r) => r.type === "depends_on" && r.target === t.id));
23
+ export function formatEntity(ctx, item, file) {
24
+ const head = "ref" in item ? item.ref : item.id;
25
+ const home = "ref" in item ? item.request : item.id;
26
+ const lines = [`${head} ${item.title}`, ""];
27
+ if ("ref" in item)
28
+ lines.push(` ${"作業先".padEnd(11)} ${workHint(ctx, item).replace(/^作業先: /, "")}`);
29
+ const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record"]);
30
+ for (const [k, v] of Object.entries(item)) {
31
+ if (skip.has(k) || v === undefined || (Array.isArray(v) && !v.length))
32
+ continue;
33
+ lines.push(` ${k.padEnd(13)} ${typeof v === "object" ? JSON.stringify(v) : v}`);
34
+ }
35
+ if (item.body.trim())
36
+ lines.push("", indent(item.body.trim()));
37
+ if ("record" in item && item.record)
38
+ lines.push("", "変更の記録:", indent(item.record));
39
+ if ("ref" in item) {
40
+ const out = item.relations.map((r) => ` → ${pad(relationRole(r.type, "out"))} ${r.target} ${titleOf(ctx, `${home}/${r.target}`)}`);
41
+ const inc = [
42
+ ...dependentsOf(ctx, item).map((t) => ` ← ${pad(relationRole("depends_on", "in"))} ${t.id} ${t.title}`),
43
+ ...ctx.ws.tasksOf(home).list().filter((t) => t.relations.some((r) => r.type === "supersedes" && r.target === item.id)).map((t) => ` ← ${pad(relationRole("supersedes", "in"))} ${t.id} ${t.title}`),
44
+ ];
45
+ if (out.length || inc.length)
46
+ lines.push("", "関係:", ...out, ...inc);
47
+ }
48
+ lines.push("", `ファイル: ${file}`);
49
+ return lines.join("\n");
50
+ }
51
+ export function ambiguous(out, ctx, query, current) {
52
+ const r = resolve(ctx, query, current);
53
+ out.result(r, () => r.candidates.length ? `候補が複数あります:\n${table(r.candidates.map((c) => [c.ref, c.score.toFixed(2), c.title]))}` : `見つかりません: ${query}`);
54
+ return r.candidates.length ? 1 : 2; // 候補が複数なら使い方の誤り(1)、何も無ければ見つからない(2)
55
+ }
56
+ /** 依存先(同じ要望なら T003、別の要望なら絶対参照) */
57
+ /** 置き換えられたタスクの印(同じ要望の中は T005 と短く) */
58
+ export const replacedBy = (t, marks) => {
59
+ const m = marks.get(t.ref);
60
+ return m?.length ? `※置換 ← ${m.map((x) => (x.from.startsWith(`${t.request}/`) ? x.from.slice(t.request.length + 1) : x.from)).join(",")}` : "";
61
+ };
62
+ /** タスクを変えた後、対応済の要望を進行中に戻していたら知らせる(requestOps が戻す)。戻した要望の ID を返す */
63
+ export function reopenedNote(rid, ancestors = []) {
64
+ if (rid)
65
+ process.stderr.write(`要望 ${rid} を対応済から進行中に戻しました(未完了のタスクがあるため)\n`);
66
+ if (ancestors.length)
67
+ process.stderr.write(`祖先の要望 ${ancestors.join(", ")} を対応済から進行中に戻しました(配下に未完了があるため)\n`);
68
+ return rid;
69
+ }
70
+ /** シェルにそのまま貼れる引数(記号や空白を含むものは単引用符で囲む) */
71
+ export const shellArg = (s) => (/^[\w./:=@%+-]+$/.test(s) ? s : `'${s.replace(/'/g, `'\\''`)}'`);
72
+ /**
73
+ * Preflight を始められなかった・失敗したときの、直接タスクを作る道の案内(人向け。stderr か、エラーの文に付けて出す)。
74
+ * --project / --dir を付けて呼ばれたら、同じ対象で動くようにそのまま付ける
75
+ */
76
+ export function directTaskHint(rid, scope = {}) {
77
+ const target = [scope.project && `--project ${shellArg(scope.project)}`, scope.dir && `--dir ${shellArg(scope.dir)}`].filter(Boolean).join(" ");
78
+ return [
79
+ "Preflight を通さずに、この要望へタスクを直接作ることもできます(Docker や ChatGPT の接続は要りません):",
80
+ ` p3 new "タスクの題" --req ${shellArg(rid)}${target ? ` ${target}` : ""} --body "作業内容と完了条件"`,
81
+ ` ${DIRECT_TASK_NOTE}`,
82
+ ` ${LATER_PREFLIGHT_NOTE}(p3 preflight ${shellArg(rid)})`,
83
+ ].join("\n");
84
+ }
85
+ /** 警告は stderr に出す(--json の stdout を汚さない。JSON では warnings フィールドで返す) */
86
+ export const warn = (warnings) => {
87
+ for (const w of warnings)
88
+ process.stderr.write(`警告: ${w.message}\n`);
89
+ };
90
+ export const deps = (t) => {
91
+ const d = t.relations.filter((r) => r.type === "depends_on").map((r) => (absRef(r.target, t.request)?.startsWith(`${t.request}/`) ? r.target : (absRef(r.target, t.request) ?? r.target)));
92
+ return d.length ? `← ${d.join(",")}` : "";
93
+ };
94
+ export const bar = (ratio, width = 10) => {
95
+ const n = Math.round(ratio * width);
96
+ return `${"█".repeat(n)}${"░".repeat(width - n)}`;
97
+ };
98
+ export const indent = (s) => s.split("\n").map((l) => ` ${l}`).join("\n");
99
+ /** 関係の役割を同じ幅にそろえる(全角は2桁として数える。CLI の詳細で相手の列がそろうように) */
100
+ export function pad(label, width = 8) {
101
+ const w = Array.from(label).reduce((n, ch) => n + (ch.charCodeAt(0) > 0xff ? 2 : 1), 0);
102
+ return label + " ".repeat(Math.max(1, width - w));
103
+ }
104
+ /** 作業先の案内(このマシンのパスが無ければ登録の仕方) */
105
+ export function workHint(ctx, t) {
106
+ const w = taskWork(ctx.ws, t);
107
+ if (!w.repo)
108
+ return "作業先: なし";
109
+ return `作業先: ${w.repo}${w.branch ? ` ブランチ ${w.branch}` : "(ブランチなし)"}${w.registered ? "" : `\n このマシンのパスが未登録です: p3 repo path ${w.repo} <パス>`}`;
110
+ }