@infodb/p3 0.12.0 → 0.14.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 (219) hide show
  1. package/README.md +33 -35
  2. package/bin/p3.mjs +3 -2
  3. package/dist/web/assets/CompletionReview-BD7d6Yzt.js +1 -0
  4. package/dist/web/assets/ImprovementDialog-BoAZN1KR.js +1 -0
  5. package/dist/web/assets/Outputs-D-ZouoxF.js +1 -0
  6. package/dist/web/assets/RequestStatus-Bl3fdSbM.js +1 -0
  7. package/dist/web/assets/Tabs-CxeceOL-.js +1 -0
  8. package/dist/web/assets/TagInput-CeAbmGRR.js +1 -0
  9. package/dist/web/assets/TaskDrawer-BCriSnhe.js +6 -0
  10. package/dist/web/assets/_requestId-CZKMe_mC.js +1 -0
  11. package/dist/web/assets/_requestId-Fx4lLkFo.js +1 -0
  12. package/dist/web/assets/appCtx-BdxbkSZa.js +1 -0
  13. package/dist/web/assets/archive-D5IIxcSV.js +1 -0
  14. package/dist/web/assets/board-p6R9KMqd.js +1 -0
  15. package/dist/web/assets/done-BTOF188x.js +1 -0
  16. package/dist/web/assets/draft-BWYpm3PD.js +2 -0
  17. package/dist/web/assets/index-DFbY8NAR.css +2 -0
  18. package/dist/web/assets/index-Dpqi2dcC.js +12 -0
  19. package/dist/web/assets/link-D481whDt.js +1 -0
  20. package/dist/web/assets/metrics-CAzP6V8I.js +1 -0
  21. package/dist/web/assets/new-C65IJJg3.js +1 -0
  22. package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
  23. package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
  24. package/dist/web/assets/preload-helper-_dAYMct_.js +1 -0
  25. package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
  26. package/dist/web/assets/release-notes-Dtif8xsQ.js +5 -0
  27. package/dist/web/assets/requestData-SPc36t8Q.js +1 -0
  28. package/dist/web/assets/routes-DJj8CWuk.js +6 -0
  29. package/dist/web/assets/settings-DKJd7CLe.js +1 -0
  30. package/dist/web/assets/ui-CbEOnPnF.js +1 -0
  31. package/dist/web/assets/workTarget-DavxMs-c.js +30 -0
  32. package/dist/web/index.html +6 -4
  33. package/docs/architecture.md +430 -72
  34. package/docs/chatgpt-sign-in.md +2 -2
  35. package/docs/development.md +141 -64
  36. package/docs/feature-inventory.md +139 -0
  37. package/docs/how-to-use.md +389 -31
  38. package/docs/installation.md +261 -147
  39. package/docs/publishing.md +33 -14
  40. package/docs/refactoring.md +332 -0
  41. package/lib/cli/agentsStatus.js +198 -0
  42. package/lib/cli/guide.js +27 -0
  43. package/lib/cli/guide.md +217 -0
  44. package/lib/cli/help.js +45 -7
  45. package/lib/cli/main.js +58 -207
  46. package/lib/cli/project.js +34 -294
  47. package/lib/core/projectRegistry.js +2 -2
  48. package/lib/kit/appInfo.js +13 -0
  49. package/lib/kit/usage.js +27 -0
  50. package/lib/server/api/projectsRoutes.js +5 -5
  51. package/lib/server/server.js +7 -4
  52. package/lib/{cli → tasks/cli}/args.js +73 -9
  53. package/lib/{cli → tasks/cli}/chatgpt.js +1 -1
  54. package/lib/{cli → tasks/cli}/codex.js +1 -1
  55. package/lib/{cli → tasks/cli}/output.js +12 -2
  56. package/lib/{cli → tasks/cli}/preflightCommands.js +1 -1
  57. package/lib/tasks/cli/readOnly.js +75 -0
  58. package/lib/{cli → tasks/cli}/render.js +1 -1
  59. package/lib/{cli → tasks/cli}/requestCommands.js +24 -7
  60. package/lib/tasks/cli/showView.js +279 -0
  61. package/lib/{cli → tasks/cli}/taskCommands.js +55 -21
  62. package/lib/tasks/cli/tasksCli.js +149 -0
  63. package/lib/{core → tasks/core}/context.js +6 -9
  64. package/lib/tasks/core/errorOutcome.js +125 -0
  65. package/lib/{core → tasks/core}/hierarchy.js +1 -1
  66. package/lib/{core → tasks/core}/ops.js +17 -2
  67. package/lib/{core → tasks/core}/preflight/carryover.js +5 -1
  68. package/lib/{core → tasks/core}/preflight/codexEngine.js +36 -28
  69. package/lib/{core → tasks/core}/preflight/diagnose.js +4 -9
  70. package/lib/{core → tasks/core}/preflight/engine.js +9 -0
  71. package/lib/tasks/core/preflight/hostPaths.js +299 -0
  72. package/lib/{core → tasks/core}/preflight/input.js +33 -5
  73. package/lib/{core → tasks/core}/preflight/instructions.js +19 -2
  74. package/lib/{core → tasks/core}/preflight/mockEngine.js +27 -8
  75. package/lib/{core → tasks/core}/preflight/render.js +22 -3
  76. package/lib/{core → tasks/core}/preflight/service.js +86 -11
  77. package/lib/{core → tasks/core}/preflight/uiRender.js +5 -2
  78. package/lib/{core → tasks/core}/requestOps.js +214 -17
  79. package/lib/{core → tasks/core}/reviewRuns.js +127 -22
  80. package/lib/{core → tasks/core}/store/attachments.js +3 -2
  81. package/lib/{core → tasks/core}/store/collection.js +21 -2
  82. package/lib/tasks/core/store/fieldGroups.js +30 -0
  83. package/lib/tasks/core/store/jsonRecord.js +30 -0
  84. package/lib/{core → tasks/core}/store/normalize.js +15 -10
  85. package/lib/{core → tasks/core}/store/noteStore.js +2 -2
  86. package/lib/{core → tasks/core}/store/preflightStore.js +59 -22
  87. package/lib/{core → tasks/core}/store/projectFile.js +1 -1
  88. package/lib/{core → tasks/core}/store/workspace.js +28 -6
  89. package/lib/{core → tasks/core}/userConfig.js +1 -1
  90. package/lib/{core → tasks/core}/workTargets.js +1 -1
  91. package/lib/tasks/features/metrics/cli/metricsCommands.js +77 -0
  92. package/lib/tasks/features/metrics/core/definitions.js +445 -0
  93. package/lib/tasks/features/metrics/core/index.js +112 -0
  94. package/lib/tasks/features/metrics/core/manual.js +179 -0
  95. package/lib/tasks/features/metrics/server/metricsRoutes.js +8 -0
  96. package/lib/tasks/features/metrics/shared/metrics.js +42 -0
  97. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/code.js +2 -11
  98. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/material.js +5 -6
  99. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/review.js +2 -2
  100. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/service.js +38 -100
  101. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/store.js +3 -3
  102. package/lib/{server/api → tasks/features/milestoneReview/server}/milestoneReviewRoutes.js +7 -13
  103. package/lib/{cli → tasks/features/quality/cli}/qualityCommands.js +36 -11
  104. package/lib/{core → tasks/features/quality/core}/qualityImprovement.js +16 -15
  105. package/lib/tasks/features/records/cli/revisitCommands.js +73 -0
  106. package/lib/tasks/features/records/core/completionRefs.js +46 -0
  107. package/lib/tasks/features/records/core/reviewCandidates.js +76 -0
  108. package/lib/tasks/features/records/shared/completionRecord.js +329 -0
  109. package/lib/tasks/features/records/shared/reviewCandidate.js +313 -0
  110. package/lib/tasks/features/records/shared/reworkHistory.js +86 -0
  111. package/lib/{cli → tasks/features/releaseNotes/cli}/releaseNotesCommands.js +7 -7
  112. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/completeRequests.js +5 -6
  113. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/generate.js +3 -14
  114. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/material.js +3 -4
  115. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/service.js +1 -1
  116. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/store.js +2 -2
  117. package/lib/{server/api → tasks/features/releaseNotes/server}/releaseNoteRoutes.js +11 -20
  118. package/lib/tasks/features/requirements/cli/requirementCommands.js +289 -0
  119. package/lib/{shared → tasks/features/requirements/shared}/acceptance.js +292 -18
  120. package/lib/tasks/features/requirements/shared/requirementSource.js +635 -0
  121. package/lib/tasks/features/retro/cli/retroCommands.js +106 -0
  122. package/lib/tasks/features/retro/core/retrospective.js +197 -0
  123. package/lib/tasks/features/retro/shared/retrospective.js +286 -0
  124. package/lib/tasks/features/settings/cli/projectSettings.js +245 -0
  125. package/lib/{cli → tasks/features/settings/cli}/userConfig.js +50 -3
  126. package/lib/{core → tasks/features/settings/core}/machineSettingsEdit.js +2 -2
  127. package/lib/{core → tasks/features/settings/core}/repoAdmin.js +3 -3
  128. package/lib/{core → tasks/features/settings/core}/userTheme.js +2 -2
  129. package/lib/{server/api → tasks/features/settings/server}/repoRoutes.js +2 -2
  130. package/lib/{server/api → tasks/features/settings/server}/userThemeRoutes.js +3 -3
  131. package/lib/{cli → tasks/features/taskReview/cli}/taskReviewCommands.js +5 -5
  132. package/lib/{core/taskReview → tasks/features/taskReview/core}/material.js +13 -7
  133. package/lib/{core/taskReview → tasks/features/taskReview/core}/review.js +10 -3
  134. package/lib/{core/taskReview → tasks/features/taskReview/core}/service.js +24 -85
  135. package/lib/{core/taskReview → tasks/features/taskReview/core}/store.js +4 -4
  136. package/lib/{server/api → tasks/features/taskReview/server}/taskReviewRoutes.js +7 -14
  137. package/lib/{server → tasks/server}/api/manifest.js +51 -3
  138. package/lib/{server → tasks/server}/api/routes.js +134 -65
  139. package/lib/tasks/shared/commitRefs.js +10 -0
  140. package/lib/{shared → tasks/shared}/preflightInput.js +1 -1
  141. package/package.json +1 -43
  142. package/skills/p3/SKILL.md +9 -181
  143. package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
  144. package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
  145. package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
  146. package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
  147. package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
  148. package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
  149. package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
  150. package/dist/web/assets/_requestId-BykTgPax.js +0 -1
  151. package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
  152. package/dist/web/assets/archive-Ckh295Xe.js +0 -1
  153. package/dist/web/assets/board-BVAIjK-Y.js +0 -1
  154. package/dist/web/assets/done-BGfA-3MA.js +0 -1
  155. package/dist/web/assets/draft-CfJeyLOl.js +0 -1
  156. package/dist/web/assets/index-CgRU744I.css +0 -2
  157. package/dist/web/assets/index-DacQ0yl4.js +0 -12
  158. package/dist/web/assets/new-DVygWvVc.js +0 -1
  159. package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
  160. package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
  161. package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
  162. package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
  163. package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
  164. package/dist/web/assets/routes-Q91zvNc0.js +0 -4
  165. package/dist/web/assets/settings-BzRgcmUm.js +0 -1
  166. package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
  167. package/lib/cli/readOnly.js +0 -38
  168. package/lib/cli/showView.js +0 -166
  169. /package/lib/{core/store → kit}/frontmatter.js +0 -0
  170. /package/lib/{core/store → kit}/fsutil.js +0 -0
  171. /package/lib/{cli → tasks/cli}/format.js +0 -0
  172. /package/lib/{core → tasks/core}/chatgpt.js +0 -0
  173. /package/lib/{core → tasks/core}/machineSettings.js +0 -0
  174. /package/lib/{core → tasks/core}/preflight/codexImage.js +0 -0
  175. /package/lib/{core → tasks/core}/preflight/docker.js +0 -0
  176. /package/lib/{core → tasks/core}/preflight/launch.js +0 -0
  177. /package/lib/{core → tasks/core}/preflight/launcher.mjs +0 -0
  178. /package/lib/{core → tasks/core}/preflight/mock-ui.html +0 -0
  179. /package/lib/{core → tasks/core}/preflight/mock-ui.png +0 -0
  180. /package/lib/{core → tasks/core}/preflight/owner.js +0 -0
  181. /package/lib/{core → tasks/core}/preflight/render-image/Dockerfile +0 -0
  182. /package/lib/{core → tasks/core}/preflight/render-image/fonts-ja.conf +0 -0
  183. /package/lib/{core → tasks/core}/preflight/render-image/render.mjs +0 -0
  184. /package/lib/{core → tasks/core}/preflight/split.js +0 -0
  185. /package/lib/{core → tasks/core}/preflight/uiMaterials.js +0 -0
  186. /package/lib/{core → tasks/core}/preflight/wireframe.js +0 -0
  187. /package/lib/{core → tasks/core}/preflight/xlsx.js +0 -0
  188. /package/lib/{core → tasks/core}/redact.js +0 -0
  189. /package/lib/{core → tasks/core}/repoRefs.js +0 -0
  190. /package/lib/{core → tasks/core}/requestStatus.js +0 -0
  191. /package/lib/{core → tasks/core}/store/archivedTasks.js +0 -0
  192. /package/lib/{core → tasks/core}/store/dataWatcher.js +0 -0
  193. /package/lib/{core → tasks/core}/store/locate.js +0 -0
  194. /package/lib/{core → tasks/core}/supersede.js +0 -0
  195. /package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/mockReviewer.js +0 -0
  196. /package/lib/{shared → tasks/features/milestoneReview/shared}/milestoneReview.js +0 -0
  197. /package/lib/{core → tasks/features/quality/core}/quality.js +0 -0
  198. /package/lib/{shared → tasks/features/quality/shared}/quality.js +0 -0
  199. /package/lib/{shared → tasks/features/quality/shared}/qualityImprovement.js +0 -0
  200. /package/lib/{shared → tasks/features/quality/shared}/qualityTemplates.js +0 -0
  201. /package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/mockSummarizer.js +0 -0
  202. /package/lib/{core/taskReview → tasks/features/taskReview/core}/mockReviewer.js +0 -0
  203. /package/lib/{core/taskReview → tasks/features/taskReview/core}/paths.js +0 -0
  204. /package/lib/{shared → tasks/features/taskReview/shared}/taskReview.js +0 -0
  205. /package/lib/{server → tasks/server}/api/chatgptRoutes.js +0 -0
  206. /package/lib/{server → tasks/server}/api/local.js +0 -0
  207. /package/lib/{shared → tasks/shared}/dates.js +0 -0
  208. /package/lib/{shared → tasks/shared}/directTask.js +0 -0
  209. /package/lib/{shared → tasks/shared}/hierarchy.js +0 -0
  210. /package/lib/{shared → tasks/shared}/milestoneGoals.js +0 -0
  211. /package/lib/{shared → tasks/shared}/milestoneOrder.js +0 -0
  212. /package/lib/{shared → tasks/shared}/preflightRunner.js +0 -0
  213. /package/lib/{shared → tasks/shared}/refs.js +0 -0
  214. /package/lib/{shared → tasks/shared}/repos.js +0 -0
  215. /package/lib/{shared → tasks/shared}/scopeView.js +0 -0
  216. /package/lib/{shared → tasks/shared}/tags.js +0 -0
  217. /package/lib/{shared → tasks/shared}/taskBlock.js +0 -0
  218. /package/lib/{shared → tasks/shared}/types.js +0 -0
  219. /package/lib/{shared → tasks/shared}/workTarget.js +0 -0
@@ -1,5 +1,5 @@
1
1
  import { CodexImageError, updateCodexImage } from "../core/preflight/codexImage.js";
2
- import { UsageError } from "./project.js";
2
+ import { UsageError } from "../../kit/usage.js";
3
3
  /**
4
4
  * p3 codex update。Codex を動かすイメージを今すぐ作り直し、入った Codex の版を表示する。
5
5
  * プロジェクトを決める前に動く(このマシンの Docker のもの。プロジェクト・認証・個人設定の自動更新の停止に関係しない)。
@@ -1,10 +1,11 @@
1
+ import { requestRequirementView } from "../features/requirements/shared/requirementSource.js";
1
2
  import { absRef } from "../shared/refs.js";
2
3
  import { relationRole } from "../shared/types.js";
3
4
  import {} from "../core/context.js";
4
5
  import { resolve, titleOf } from "../core/ops.js";
5
6
  import {} from "../core/supersede.js";
6
7
  import { table } from "./format.js";
7
- import { formatAcceptance, formatBlock } from "./showView.js";
8
+ import { formatAcceptance, formatBlock, formatCompletionDetail, formatRequirement, formatRework } from "./showView.js";
8
9
  import { taskWork } from "../core/workTargets.js";
9
10
  import { DIRECT_TASK_NOTE, LATER_PREFLIGHT_NOTE } from "../shared/directTask.js";
10
11
  /** CLI の出力(人向けの表と --json)と、表示の部品 */
@@ -27,7 +28,7 @@ export function formatEntity(ctx, item, file) {
27
28
  const lines = [`${head} ${item.title}`, ""];
28
29
  if ("ref" in item)
29
30
  lines.push(` ${"作業先".padEnd(11)} ${workHint(ctx, item).replace(/^作業先: /, "")}`);
30
- const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record", "acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceProblems", "block", "blockHistory", "blockProblems"]);
31
+ const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record", "acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceSources", "acceptanceSourceSeq", "acceptanceProblems", "block", "blockHistory", "blockProblems", "requirementSources", "requirementSeq", "clarifyAnswers", "requirementProblems", "completionRecords", "completionProblems", "reworkHistory", "reworkProblems"]);
31
32
  for (const [k, v] of Object.entries(item)) {
32
33
  if (skip.has(k) || v === undefined || (Array.isArray(v) && !v.length))
33
34
  continue;
@@ -44,6 +45,15 @@ export function formatEntity(ctx, item, file) {
44
45
  }
45
46
  if ("ref" in item)
46
47
  lines.push("", ...formatAcceptance(item));
48
+ if (!("ref" in item)) {
49
+ const req = requestRequirementView(item);
50
+ if (req.sources.length || req.answers.length || req.problems.length)
51
+ lines.push("", ...formatRequirement(req));
52
+ }
53
+ if ("ref" in item && (item.reworkHistory?.length || item.reworkProblems?.length))
54
+ lines.push("", ...formatRework(item));
55
+ if (item.completionRecords?.length || item.completionProblems?.length)
56
+ lines.push("", ...formatCompletionDetail(item));
47
57
  if ("ref" in item) {
48
58
  const out = item.relations.map((r) => ` → ${pad(relationRole(r.type, "out"))} ${r.target} ${titleOf(ctx, `${home}/${r.target}`)}`);
49
59
  const inc = [
@@ -6,7 +6,7 @@ import {} from "../core/context.js";
6
6
  import { NotFoundError } from "../core/store/collection.js";
7
7
  import { table } from "./format.js";
8
8
  import { evidenceLines, scopeLines } from "../shared/scopeView.js";
9
- import { UsageError } from "./project.js";
9
+ import { UsageError } from "../../kit/usage.js";
10
10
  import { StaleInputError, staleMessage } from "../core/preflight/input.js";
11
11
  import { changedLabel, isMaterialized } from "../shared/preflightInput.js";
12
12
  import { readBody } from "./args.js";
@@ -0,0 +1,75 @@
1
+ import { SOURCE_SUBS } from "../features/requirements/cli/requirementCommands.js";
2
+ /**
3
+ * 読むだけの操作か(データのフォルダ・個人設定・ファイルを変えず、外の生成も始めない)。
4
+ * 登録が1つだけでプロジェクトが決まったとき(via: only)に、読むだけなら警告して続け、ほかは止めるために使う(main.ts)。
5
+ * 載っていない操作(新しいコマンド・知らないサブコマンド)は書く操作として扱う。サブコマンドの省略は各コマンドの既定に合わせる。
6
+ * 引数の読み方(対象の ID とサブコマンドの見分け)は各コマンドのハンドラと同じにし、書き込みに変わるオプション(--sources-json など)も見る。
7
+ */
8
+ export function readsOnly(cmd, args, opts = {}) {
9
+ const sub = args[0];
10
+ switch (cmd) {
11
+ case "whoami":
12
+ case "guide":
13
+ case "progress":
14
+ case "ls":
15
+ case "list":
16
+ case "show":
17
+ case "find":
18
+ case "resolve":
19
+ case "notes":
20
+ case "drafts":
21
+ case "clarify":
22
+ case "revisit":
23
+ return true;
24
+ case "metrics":
25
+ // 集計(引数なし)と人の記録の一覧だけ
26
+ return sub === undefined || sub === "records";
27
+ case "retro":
28
+ case "retrospective": {
29
+ // retro [<要望>] [show](retroCommands.ts と同じ読み方)
30
+ const rest = sub !== undefined && !["show", "confirm", "judge"].includes(sub) ? args.slice(1) : args;
31
+ return (rest[0] ?? "show") === "show";
32
+ }
33
+ case "premise":
34
+ case "premises": {
35
+ // premise [<要望>] [ls](revisitCommands.ts と同じ読み方)
36
+ const rest = sub !== undefined && !["add", "ack", "ls"].includes(sub) ? args.slice(1) : args;
37
+ return (rest[0] ?? "ls") === "ls";
38
+ }
39
+ case "source":
40
+ case "sources":
41
+ return sourceReadsOnly(args, opts);
42
+ case "request":
43
+ case "req":
44
+ return sub === "ls" || sub === "list" || sub === "show";
45
+ case "quality":
46
+ return sub === undefined || sub === "show" || sub === "templates" || sub === "template";
47
+ case "milestone":
48
+ case "milestones":
49
+ return sub === undefined || sub === "ls" || sub === "list";
50
+ case "config":
51
+ return sub === undefined;
52
+ case "repo":
53
+ case "attach":
54
+ return sub === undefined || sub === "ls";
55
+ case "release-notes":
56
+ case "release-note":
57
+ return sub === undefined || sub === "ls" || sub === "list" || sub === "show" || sub === "export";
58
+ default:
59
+ return false;
60
+ }
61
+ }
62
+ /**
63
+ * source の一覧だけか(requirementCommands.ts の sourceCommand と同じ読み方)。--sources-json はファイルか標準入力の操作をまとめて当てるので、
64
+ * 操作の語が無くても書く操作。対象が要望なら source [<要望>] [ls|show]、タスク・案なら source <T|D> [<基準>] [ls|show]
65
+ */
66
+ function sourceReadsOnly(args, opts) {
67
+ if (opts["sources-json"] !== undefined)
68
+ return false;
69
+ const head = args[0];
70
+ const criterionTarget = !!head && /^(?:[^/]+\/)?[DT]\d+$/i.test(head);
71
+ let rest = head !== undefined && !SOURCE_SUBS.has(head) ? args.slice(1) : args;
72
+ if (criterionTarget && rest[0] !== undefined && !SOURCE_SUBS.has(rest[0]))
73
+ rest = rest.slice(1);
74
+ return rest[0] === undefined || rest[0] === "ls" || rest[0] === "show";
75
+ }
@@ -1,7 +1,7 @@
1
1
  import { readFile } from "node:fs/promises";
2
2
  import { basename, dirname, extname, join, resolve } from "node:path";
3
3
  import { ensureRenderImage, RenderError, renderHtml } from "../core/preflight/render.js";
4
- import { UsageError } from "./project.js";
4
+ import { UsageError } from "../../kit/usage.js";
5
5
  const USAGE = [
6
6
  "p3 render <原稿.html> [--out 画像.png] [--width 1280] 自己完結した HTML / CSS を PNG にする(Docker が要る)",
7
7
  "p3 render update 描画のイメージを今すぐ作り直す",
@@ -2,8 +2,8 @@ import { readFile } from "node:fs/promises";
2
2
  import { basename, relative, resolve as resolvePath } from "node:path";
3
3
  import { REQUEST_STATUSES } from "../shared/types.js";
4
4
  import { nextGoalId } from "../shared/milestoneGoals.js";
5
- import { QUALITY_VERDICT_LABELS } from "../shared/taskReview.js";
6
- import { REVIEW_STATUS_LABELS, REVIEW_VERDICT_LABELS, REVIEW_VERDICTS } from "../shared/milestoneReview.js";
5
+ import { QUALITY_VERDICT_LABELS } from "../features/taskReview/shared/taskReview.js";
6
+ import { REVIEW_STATUS_LABELS, REVIEW_VERDICT_LABELS, REVIEW_VERDICTS } from "../features/milestoneReview/shared/milestoneReview.js";
7
7
  import {} from "../core/context.js";
8
8
  import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, orderChildren, updateRequest } from "../core/requestOps.js";
9
9
  import { hierarchyNow, resolvedIssue } from "../core/requestStatus.js";
@@ -12,7 +12,17 @@ import { resolveRequestId } from "../core/ops.js";
12
12
  import { table } from "./format.js";
13
13
  import { requestWorkstreams, taskRepo } from "../shared/workTarget.js";
14
14
  import { briefRequest, formatBriefRequest, formatFamily } from "./showView.js";
15
- import { UsageError } from "./project.js";
15
+ import { formatReview as formatRevisit } from "../features/records/cli/revisitCommands.js";
16
+ import { requestReview } from "../features/records/core/reviewCandidates.js";
17
+ import { reviewSummary } from "../features/records/shared/reviewCandidate.js";
18
+ /** 要望の配下の見直し候補の件数(無ければ何も出さない。親の件数は集約で、親自身を候補とは扱わない) */
19
+ function reviewCountLines(review) {
20
+ const { tasks, below } = review.counts;
21
+ if (!tasks && !below)
22
+ return [];
23
+ return ["", `見直しが必要(候補): タスク ${tasks} 件${below ? `・配下 ${below} 件(子の要望とそのタスク)` : ""}(p3 revisit で理由)`];
24
+ }
25
+ import { UsageError } from "../../kit/usage.js";
16
26
  import { tagsFrom } from "../shared/tags.js";
17
27
  import { sortMilestones } from "../shared/milestoneOrder.js";
18
28
  import { parse, splitPair, list, date, readBody, readAttachFiles } from "./args.js";
@@ -71,15 +81,18 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
71
81
  const rid = requestArg(rest[0]);
72
82
  const r = ctx.ws.requests.require(rid);
73
83
  const family = await hierarchyView(ctx.ws, rid);
84
+ const review = requestReview(ctx, rid);
74
85
  if (o.brief) {
75
- const view = { ...briefRequest(ctx, r, resolvedIssue(ctx.ws, r)), ...family };
76
- return out.result(view, () => formatBriefRequest(view));
86
+ // 見直しの概要は、要望自身か配下に候補があるときだけ(記録なし・差分なしは短い出力に出さない)
87
+ const brief = review.self?.state === "candidate" || review.counts.tasks || review.counts.below ? { review: { ...(review.self ? { self: reviewSummary(review.self) } : {}), counts: review.counts } } : {};
88
+ const view = { ...briefRequest(ctx, r, resolvedIssue(ctx.ws, r)), ...family, ...brief };
89
+ return out.result(view, () => [formatBriefRequest(view), ...reviewCountLines(review)].join("\n"));
77
90
  }
78
91
  const file = relative(process.cwd(), ctx.ws.requests.path(rid));
79
92
  const issue = resolvedIssue(ctx.ws, r);
80
93
  const branches = requestWorkstreams(r);
81
94
  const multi = ctx.ws.project.repos.length > 0;
82
- return out.result({ item: r, workstreams: branches, tasks: ctx.ws.tasksOf(rid).list(), file, ...family, ...(issue ? { issue } : {}) }, () => {
95
+ return out.result({ item: r, workstreams: branches, tasks: ctx.ws.tasksOf(rid).list(), file, ...family, ...(issue ? { issue } : {}), review }, () => {
83
96
  const tasks = ctx.ws.tasksOf(rid).list();
84
97
  return [
85
98
  issue ? `※ ${issue}\n` : "",
@@ -91,7 +104,9 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
91
104
  : []),
92
105
  "",
93
106
  `タスク (${tasks.length}):`,
94
- table(tasks.map((t) => [` ${t.id}`, t.status, ...(multi ? [taskRepo(t) ?? "(なし)"] : []), t.title, deps(t)])) || " (なし)",
107
+ table(tasks.map((t) => [` ${t.id}`, t.status, ...(multi ? [taskRepo(t) ?? "(なし)"] : []), t.title, [deps(t), review.tasks[t.id]?.state === "candidate" ? "※見直し候補" : ""].filter(Boolean).join(" ")])) || " (なし)",
108
+ ...reviewCountLines(review),
109
+ ...(review.self ? ["", ...formatRevisit(review.self)] : []),
95
110
  ].join("\n");
96
111
  });
97
112
  }
@@ -134,6 +149,8 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
134
149
  const next = await updateRequest(ctx, rid, patch, { expectedRev, actor });
135
150
  warn(next.warnings ?? []);
136
151
  reopenedNote(undefined, next.reopenedAncestors);
152
+ if (next.completionSkipped)
153
+ process.stderr.write(`${next.completionSkipped}\n`);
137
154
  return out.result(next, () => `更新: ${next.id} (rev ${next.rev}) ${Object.keys(patch).join(", ")}`);
138
155
  }
139
156
  case "order": {
@@ -0,0 +1,279 @@
1
+ import { ANSWER_STATE_LABEL, criteriaSourceView, requestRequirementView, SOURCE_STATE_LABEL } from "../features/requirements/shared/requirementSource.js";
2
+ import { absRef, parseRef } from "../shared/refs.js";
3
+ import { acceptanceStatus, basisDetail, basisLabel, EVIDENCE_BASIS_KINDS, EVIDENCE_BASIS_LABEL, evidenceBasisOf } from "../features/requirements/shared/acceptance.js";
4
+ import { blockWarnings } from "../shared/taskBlock.js";
5
+ import { REWORK_CAUSE_LABEL, reworkLine } from "../features/records/shared/reworkHistory.js";
6
+ import { COMPLETION_TRIGGER_LABEL, REF_CAPTURE_LABEL } from "../features/records/shared/completionRecord.js";
7
+ import { supersededWarnings } from "../core/supersede.js";
8
+ import { table } from "./format.js";
9
+ import { taskWork } from "../core/workTargets.js";
10
+ import { requestWorkstreams } from "../shared/workTarget.js";
11
+ export function dependencyStates(ctx, task) {
12
+ return task.relations
13
+ .filter((r) => r.type === "depends_on")
14
+ .map((r) => {
15
+ const ref = absRef(r.target, task.request) ?? r.target;
16
+ const p = parseRef(ref);
17
+ const target = p?.task ? ctx.ws.task(ref) : ctx.ws.requests.get(ref);
18
+ return { ref, title: target?.title ?? null, status: target?.status ?? null };
19
+ });
20
+ }
21
+ /** タスクの詳細で共通に出す項目(通常・短い出力の両方) */
22
+ export function taskExtras(ctx, task, marks) {
23
+ const superseded = marks.get(task.ref) ?? [];
24
+ const warnings = supersededWarnings(superseded, task.ref);
25
+ return { superseded, dependencies: dependencyStates(ctx, task), warnings };
26
+ }
27
+ const BRIEF_TASK_KEYS = ["id", "ref", "request", "title", "status", "body", "rev", "outputs", "relations"];
28
+ const STATE_MARK = { met: "✓ 満たした", unmet: "✗ 満たせなかった", unverified: "? 未検証", missing: "・ 証拠なし", stale: "! 再確認が必要(基準を変えた後)" };
29
+ /** 停止の行(show・brief・アーカイブで共通。履歴は通常の show だけ)。停止も履歴も問題も無ければ空 */
30
+ export function formatBlock(task, { history = false } = {}) {
31
+ const lines = [];
32
+ const b = task.block;
33
+ if (b) {
34
+ lines.push(`⏸ 止まっています(${b.since} から${b.updatedBy ? `・${b.updatedBy}` : ""})`, ...b.reason.split("\n").map((l) => ` ${l}`));
35
+ if (b.decision)
36
+ lines.push(" 決めてほしいこと:", ...b.decision.split("\n").map((l) => ` ${l}`));
37
+ }
38
+ for (const w of blockWarnings(task))
39
+ lines.push(`※ ${w}`);
40
+ if (history && task.blockHistory?.length) {
41
+ lines.push("停止の履歴:");
42
+ const label = { set: "付けた", update: "直した", clear: "解除した" };
43
+ for (const h of task.blockHistory) {
44
+ lines.push(` ${h.at} ${label[h.action]}${h.by ? ` ${h.by}` : ""}`);
45
+ const shown = h.after ?? h.before;
46
+ if (shown)
47
+ lines.push(` 理由: ${shown.reason.split("\n")[0]}`);
48
+ if (h.resolution)
49
+ lines.push(` 回答・解決: ${h.resolution.split("\n").join(" / ")}`);
50
+ }
51
+ }
52
+ return lines;
53
+ }
54
+ /**
55
+ * 受け入れ基準と証拠・不足の行(show・criteria で共通)。基準が無いタスクは「受け入れ基準なし」の1行(emptyLine: false なら出さない)。
56
+ * 証拠は作業した側の申告で、人が「済み」にする前に読むもの
57
+ */
58
+ export function formatAcceptance(task, { emptyLine = true } = {}) {
59
+ const acc = acceptanceStatus(task);
60
+ if (!acc)
61
+ return emptyLine ? ["受け入れ基準なし"] : [];
62
+ const kinds = EVIDENCE_BASIS_KINDS.filter((k) => acc.metByBasis[k] > 0).map((k) => `${EVIDENCE_BASIS_LABEL[k]} ${acc.metByBasis[k]}`);
63
+ const lines = [`受け入れ基準(${acc.met}/${acc.total} を満たしたと申告${kinds.length ? `。根拠: ${kinds.join("・")}` : ""}):`];
64
+ // 根拠の行: 結果と別に、種類(古い証拠は「種類未記録」)と、読んだもの・検査のコマンド・結果・対象
65
+ const basisLines = (e) => [` 根拠: ${basisLabel(e)}`, ...basisDetail(evidenceBasisOf(e).basis).map((d) => ` ${d.label}: ${d.value.split("\n").join("\n ")}`)];
66
+ // 要求の出典と確認(実装後の証拠とは別。要望者の申告の記録)
67
+ const sv = task.acceptanceSources?.length ? criteriaSourceView(task.acceptanceCriteria, task.acceptanceSources) : undefined;
68
+ const sourceLine = (id) => {
69
+ const it = sv?.items.find((x) => x.id === id);
70
+ if (!it || !it.sources.length)
71
+ return [];
72
+ return [` 出典と確認: ${SOURCE_STATE_LABEL[it.state]}(${it.sources.map((x) => `${x.id}${x.source ? ` ${x.source}` : ""}${x.confirmed ? ` ${x.confirmed.by}・${x.confirmed.on}` : ""}`).join(" / ")})`];
73
+ };
74
+ for (const i of acc.items) {
75
+ lines.push(` ${i.id} ${i.text}`, ` ${STATE_MARK[i.state]}`, ...sourceLine(i.id));
76
+ if (i.evidence)
77
+ lines.push(...basisLines(i.evidence));
78
+ if (i.evidence?.evidence)
79
+ lines.push(...i.evidence.evidence.split("\n").map((l) => ` ${l}`));
80
+ if (i.state === "stale" && i.evidence)
81
+ lines.push(` (記録したときの基準: ${i.evidence.criterionText})`);
82
+ }
83
+ for (const e of acc.orphans)
84
+ lines.push(` ${e.criterionId} (基準は消されています: ${e.criterionText})`, ` ${STATE_MARK[e.result]}`, ...basisLines(e), ...(e.evidence ? e.evidence.split("\n").map((l) => ` ${l}`) : []));
85
+ for (const x of sv?.orphans ?? [])
86
+ lines.push(` ${x.criterionId} (基準が無い出典と確認の記録 ${x.id}: 対応先不明)`);
87
+ if (acc.shortfalls.length)
88
+ lines.push("不足:", ...acc.shortfalls.map((s) => ` - ${s}`));
89
+ return lines;
90
+ }
91
+ export function briefTask(ctx, task, marks) {
92
+ const item = Object.fromEntries(BRIEF_TASK_KEYS.map((k) => [k, task[k]]));
93
+ item.relations = task.relations.filter((r) => r.type === "depends_on");
94
+ if (task.repoOutputs?.length)
95
+ item.repoOutputs = task.repoOutputs;
96
+ // 変更の記録(完了したタスク)。経緯を知るために読む
97
+ if (task.record)
98
+ item.record = task.record;
99
+ // 受け入れ基準と証拠(着手時に読み、完了時に項目ごとの証拠を残す)
100
+ if (task.acceptanceCriteria?.length)
101
+ item.acceptanceCriteria = task.acceptanceCriteria;
102
+ if (task.acceptanceEvidence?.length)
103
+ item.acceptanceEvidence = task.acceptanceEvidence;
104
+ // 基準ごとの要求の出典と確認(あるときだけ)
105
+ if (task.acceptanceSources?.length)
106
+ item.acceptanceSources = task.acceptanceSources;
107
+ if (task.acceptanceProblems?.length)
108
+ item.acceptanceProblems = task.acceptanceProblems;
109
+ // 停止の今の値と読み取りの問題(履歴は省く)
110
+ if (task.block)
111
+ item.block = task.block;
112
+ if (task.blockProblems?.length)
113
+ item.blockProblems = task.blockProblems;
114
+ // 着手先: 作業先のリポジトリとそのブランチ(作業先なしは repo: null)
115
+ // 基準・証拠の状態(基準なしのタスクでは省く)
116
+ const acceptance = acceptanceStatus(task);
117
+ const completion = completionBrief(task);
118
+ return { item, work: taskWork(ctx.ws, task), ...taskExtras(ctx, task, marks), ...(acceptance ? { acceptance } : {}), ...(completion ? { completion } : {}) };
119
+ }
120
+ /** 完了の記録の概要(契機・日時・主体・rev。条件の写しは p3 show(--brief でない)か API の詳細で読む)。記録も問題も無ければ省く */
121
+ export function completionBrief(x) {
122
+ if (!x.completionRecords?.length && !x.completionProblems?.length)
123
+ return undefined;
124
+ return {
125
+ records: (x.completionRecords ?? []).map((r) => ({ id: r.id, trigger: r.trigger, at: r.at, ...(r.by ? { by: r.by } : {}), rev: r.rev, status: r.status })),
126
+ ...(x.completionProblems?.length ? { problems: x.completionProblems } : {}),
127
+ };
128
+ }
129
+ const refLine = (r) => r.state === "ok"
130
+ ? `${r.name}: ${r.commit?.slice(0, 12) ?? ""}${r.dirty === true ? "(未コミットの変更あり)" : r.dirty === false ? "" : `(未コミットの変更は不明${r.reason ? `: ${r.reason}` : ""})`}`
131
+ : `${r.name}: ${r.reason ?? REF_CAPTURE_LABEL[r.state]}`;
132
+ /** 完了の記録の詳細(p3 show。そのときの条件の写しで、今の値とは別) */
133
+ export function formatCompletionDetail(x) {
134
+ const lines = ["完了の記録(そのときの条件の写し。今の値とは別):"];
135
+ for (const r of x.completionRecords ?? []) {
136
+ lines.push(` ${r.id} ${COMPLETION_TRIGGER_LABEL[r.trigger]} ${r.at} ${r.by ?? "(主体なし)"} rev ${r.rev} ${r.status}${r.checked ? " 済み" : ""}`);
137
+ const q = r.quality;
138
+ lines.push(` 品質: ${q.state === "set" ? "設定済" : q.state === "unset" ? "未設定" : "読めない"} 版 ${q.version}${q.standards ? ` 項目 ${q.standards.map((s) => `${s.id}${s.exempt ? "(除外)" : ""}`).join(", ") || "なし"}` : ""}`);
139
+ if (r.acceptance?.problems)
140
+ lines.push(` 受け入れ基準: 読めない(${r.acceptance.problems.join(" / ")})`);
141
+ for (const c of r.acceptance?.criteria ?? []) {
142
+ const e = r.acceptance?.evidence?.find((v) => v.criterionId === c.id);
143
+ lines.push(` ${c.id} ${c.text}${e ? ` → ${e.result}・${basisLabel(e)}` : " → 証拠なし"}`);
144
+ }
145
+ if (r.title !== undefined)
146
+ lines.push(` 題: ${r.title}`);
147
+ if (r.requirement?.problems)
148
+ lines.push(` 要求の根拠: 読めない(${r.requirement.problems.join(" / ")})`);
149
+ else if (r.requirement?.sources?.length)
150
+ lines.push(` 要求の根拠: ${r.requirement.sources.map((s) => s.id).join(", ")}`);
151
+ if (r.tasks)
152
+ lines.push(` タスク: ${r.tasks.map((t) => `${t.id} rev ${t.rev} ${t.status}${t.record ? ` ${t.record}` : "(記録なし)"}`).join(" / ") || "なし"}`);
153
+ if (r.children?.length)
154
+ lines.push(` 子の要望: ${r.children.map((t) => `${t.id} rev ${t.rev} ${t.status}${t.record ? ` ${t.record}` : "(記録なし)"}`).join(" / ")}`);
155
+ lines.push(` 参照先: ${r.refs ? r.refs.map(refLine).join(" / ") || "登録なし" : "取得していません"}`);
156
+ }
157
+ for (const p of x.completionProblems ?? [])
158
+ lines.push(` ※読めない: ${p}(ファイルの completionRecords を直すまで新しい記録は足しません)`);
159
+ return lines;
160
+ }
161
+ /** 手戻りの履歴(済みの解除・完了からの再開)の行 */
162
+ export function formatRework(t) {
163
+ return [
164
+ "手戻りの履歴(済みの解除・完了からの再開):",
165
+ ...(t.reworkHistory ?? []).map((e) => ` ${reworkLine(e)} ${REWORK_CAUSE_LABEL[e.cause]} ${e.at} ${e.by ?? "(主体なし)"} rev ${e.rev}`),
166
+ ...(t.reworkProblems ?? []).map((p) => ` ※読めない: ${p}(ファイルの reworkHistory を直すまで新しい履歴は足しません)`),
167
+ ];
168
+ }
169
+ /** 完了の記録の行(今の値とは別の、そのときの記録) */
170
+ export function formatCompletion(c) {
171
+ return [
172
+ "完了の記録(そのときの条件の写し。今の値とは別):",
173
+ ...c.records.map((r) => ` ${r.id} ${COMPLETION_TRIGGER_LABEL[r.trigger]} ${r.at} ${r.by ?? "(主体なし)"} rev ${r.rev}`),
174
+ ...(c.problems ?? []).map((p) => ` ※読めない: ${p}(ファイルの completionRecords を直すまで新しい記録は足しません)`),
175
+ ];
176
+ }
177
+ export function formatBriefTask(view) {
178
+ const { item, work, dependencies, warnings } = view;
179
+ const short = (ref) => (ref.startsWith(`${item.request}/`) ? ref.slice(item.request.length + 1) : ref);
180
+ const lines = [`${item.ref} ${item.title}`, ` status ${item.status} rev ${item.rev}`];
181
+ lines.push(...formatBlock(item));
182
+ lines.push(` 作業先 ${work.repo ? `${work.repo}${work.branch ? ` branch ${work.branch}` : "(ブランチなし)"}${work.registered ? "" : ` ※このマシンのパスが未登録(p3 repo path ${work.repo} <パス>)`}` : "なし"}`);
183
+ if (dependencies.length) {
184
+ lines.push(` 依存 ${dependencies.map((d) => `${short(d.ref)} ${d.status ?? "(状態不明)"}`).join(" / ")}`);
185
+ }
186
+ for (const o of item.outputs)
187
+ lines.push(` 成果物 ${o}`);
188
+ for (const o of item.repoOutputs ?? [])
189
+ lines.push(` 成果物 ${o.repo}: ${o.output}`);
190
+ for (const w of warnings)
191
+ lines.push(`※ ${w.message}`);
192
+ if (item.body.trim())
193
+ lines.push("", item.body.trim());
194
+ if (item.record)
195
+ lines.push("", "## 変更の記録", item.record);
196
+ lines.push("", ...formatAcceptance(item));
197
+ if (view.completion)
198
+ lines.push("", ...formatCompletion(view.completion));
199
+ return lines.join("\n");
200
+ }
201
+ export function briefRequest(ctx, r, issue) {
202
+ const item = {
203
+ id: r.id,
204
+ title: r.title,
205
+ status: r.status,
206
+ ...(r.parent ? { parent: r.parent } : {}),
207
+ body: r.body,
208
+ rev: r.rev,
209
+ ...(r.workstreams ? { workstreams: r.workstreams } : {}),
210
+ };
211
+ const branches = requestWorkstreams(r);
212
+ const tasks = ctx.ws
213
+ .tasksOf(r.id)
214
+ .list()
215
+ .map((t) => ({ id: t.id, ref: t.ref, title: t.title, status: t.status, repo: t.repo, ...(t.block ? { blocked: true } : {}) }));
216
+ // 要求の出典と確認(記録・回答・読めない値があるときだけ)
217
+ const req = requestRequirementView(r);
218
+ const requirement = req.sources.length || req.answers.length || req.problems.length ? req : undefined;
219
+ const completion = completionBrief(r);
220
+ return { item, branches, tasks, ...(issue ? { issue } : {}), ...(requirement ? { requirement } : {}), ...(completion ? { completion } : {}) };
221
+ }
222
+ const confirmLine = (c) => `${c.by}・${c.on}`;
223
+ export function sourceLines(s, pad = " ") {
224
+ return [
225
+ `${pad}${s.id} [${SOURCE_STATE_LABEL[s.state]}${s.confirmed ? `: ${confirmLine(s.confirmed)}` : ""}]${s.from ? ` (要望の ${s.from} を写したもの)` : ""}`,
226
+ ...(s.target ? [`${pad} 対象: ${s.target}`] : []),
227
+ ...(s.source ? [`${pad} 出典: ${s.source}`] : []),
228
+ ...(s.basis ? [`${pad} 根拠: ${s.basis.split("\n").join(`\n${pad} `)}`] : []),
229
+ ...(s.history?.length ? [`${pad} 前の確認: ${s.history.map((h) => `${confirmLine(h)}${h.lapsedAt ? `(${h.lapsedAt.slice(0, 10)} に効かなくなった)` : ""}`).join(" / ")}`] : []),
230
+ ];
231
+ }
232
+ /** 要望の根拠と回答(p3 source・p3 show で使う) */
233
+ export function formatRequirement(v) {
234
+ const lines = [`要求の出典と確認: ${SOURCE_STATE_LABEL[v.state]}(申告の記録。P3 の保証ではありません)`];
235
+ if (!v.sources.length)
236
+ lines.push(" 記録なし(任意。p3 source add --source <出典> --grounds <根拠> で残せます)");
237
+ for (const s of v.sources)
238
+ lines.push(...sourceLines(s));
239
+ if (v.answers.length) {
240
+ lines.push("確認事項への回答:");
241
+ for (const a of v.answers)
242
+ lines.push(` ${a.run}/${a.question} [${ANSWER_STATE_LABEL[a.state]}] ${a.copy.question}`, ` 回答${a.by || a.on ? `(${[a.by, a.on].filter(Boolean).join("・")})` : ""}: ${a.answer.split("\n").join("\n ")}`);
243
+ }
244
+ for (const p of v.problems)
245
+ lines.push(` ※読めない: ${p}(request.md を直してください)`);
246
+ return lines;
247
+ }
248
+ /** 親子の行(祖先と直下の子。無ければ何も出さない) */
249
+ export function formatFamily(f) {
250
+ return [
251
+ ...(f.ancestors.length ? [` 親 ${f.ancestors.map((a) => `${a.id} ${a.title}`).join(" > ")}`] : []),
252
+ ...(f.children.length
253
+ ? ["", `子の要望 (${f.children.length}、表示順。実行の順ではない):`, table(f.children.map((c) => [` ${c.id}`, c.status, `${c.tasks.done}/${c.tasks.total}`, c.title]))]
254
+ : []),
255
+ ];
256
+ }
257
+ export function formatBriefRequest(view) {
258
+ const { item, branches, tasks, issue } = view;
259
+ const family = view.ancestors && view.children && view.hierarchyIssues ? view : undefined;
260
+ const names = Object.keys(branches);
261
+ // ブランチは作業先ごと
262
+ const branchLine = "";
263
+ return [
264
+ issue ? `※ ${issue}` : "",
265
+ ...(family?.hierarchyIssues.map((i) => `※ ${i.message}`) ?? []),
266
+ `${item.id} ${item.title}`,
267
+ ` status ${item.status} rev ${item.rev}${branchLine}`,
268
+ ...(branchLine ? [] : names.map((n) => ` branch ${n}: ${branches[n].branch}`)),
269
+ ...(family ? formatFamily(family) : []),
270
+ item.body.trim() ? `\n${item.body.trim()}` : "",
271
+ ...(view.requirement ? ["", ...formatRequirement(view.requirement)] : []),
272
+ ...(view.completion ? ["", ...formatCompletion(view.completion)] : []),
273
+ "",
274
+ `タスク (${tasks.length}):`,
275
+ table(tasks.map((t) => [` ${t.id}`, t.status, t.repo ?? "(作業先なし)", `${t.title}${t.blocked ? " ⏸停止" : ""}`])) || " (なし)",
276
+ ]
277
+ .filter((l, i) => l !== "" || i > 1)
278
+ .join("\n");
279
+ }