@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
@@ -5,16 +5,19 @@ import { normalizeTaskId } from "../shared/refs.js";
5
5
  import { getArchivedTask, listArchivedTasks } from "../core/store/archivedTasks.js";
6
6
  import { listTasks, resolve, resolveRef, resolveRequestId } from "../core/ops.js";
7
7
  import { archiveTask, createTask, importQuality, updateTask } from "../core/requestOps.js";
8
- import { taskQualityDiff } from "../shared/quality.js";
8
+ import { taskQualityDiff } from "../features/quality/shared/quality.js";
9
9
  import { supersededMarks } from "../core/supersede.js";
10
10
  import { table } from "./format.js";
11
11
  import { taskRepo } from "../shared/workTarget.js";
12
12
  import { addRepoOutputs, parseRepoOutput, repoArg } from "../core/workTargets.js";
13
13
  import { briefTask, formatAcceptance, formatBlock, formatBriefTask, taskExtras } from "./showView.js";
14
- import { UsageError } from "./project.js";
14
+ import { formatReview } from "../features/records/cli/revisitCommands.js";
15
+ import { taskReview } from "../features/records/core/reviewCandidates.js";
16
+ import { reviewSummary } from "../features/records/shared/reviewCandidate.js";
17
+ import { UsageError } from "../../kit/usage.js";
15
18
  import { NotFoundError } from "../core/store/collection.js";
16
- import { parseTaskAssignments, checkStatus, evidenceOps, readBody } from "./args.js";
17
- import { ACCEPTANCE_RESULTS, acceptanceStatus, applyAcceptanceOps, isAcceptanceResult } from "../shared/acceptance.js";
19
+ import { basisFromOptions, parseTaskAssignments, checkStatus, evidenceOps, readBody } from "./args.js";
20
+ import { ACCEPTANCE_RESULTS, acceptanceStatus, applyAcceptanceOps, isAcceptanceResult } from "../features/requirements/shared/acceptance.js";
18
21
  import { dependentsOf, formatEntity, indent, ambiguous, replacedBy, reopenedNote, warn, deps, workHint } from "./output.js";
19
22
  import { requestCommand } from "./requestCommands.js";
20
23
  import { pickRun } from "./preflightCommands.js";
@@ -32,7 +35,7 @@ export async function taskCommand(cmd, env) {
32
35
  if (o.repo !== undefined && o.repo !== "none" && !ctx.ws.project.repos.some((r) => r.name === o.repo)) {
33
36
  throw new UsageError(`参照先「${o.repo}」は登録されていません(p3 repo ls)`);
34
37
  }
35
- const filter = { status: o.status?.split(","), area: o.area?.[0], q: o.q, repo: o.repo, blocked: o.blocked };
38
+ const filter = { status: o.status?.split(","), area: o.area?.[0], q: o.q, repo: o.repo, blocked: o.blocked, review: o.review };
36
39
  const tasks = listTasks(ctx, { ...filter, request: o.all ? undefined : requestArg(undefined) });
37
40
  const marks = supersededMarks(ctx.ws);
38
41
  const items = tasks.map((t) => (marks.has(t.ref) ? { ...t, superseded: marks.get(t.ref) } : t));
@@ -43,8 +46,8 @@ export async function taskCommand(cmd, env) {
43
46
  t.status,
44
47
  ...(multi ? [taskRepo(t) ?? "(なし)"] : []),
45
48
  t.title,
46
- [t.block ? `⏸停止 ${t.block.since.slice(0, 10)}: ${t.block.reason.split("\n")[0]}` : "", deps(t), replacedBy(t, marks)].filter(Boolean).join(" "),
47
- ])) || (o.blocked ? "止まっているタスクはありません" : "タスクはありません"));
49
+ [t.block ? `⏸停止 ${t.block.since.slice(0, 10)}: ${t.block.reason.split("\n")[0]}` : "", deps(t), replacedBy(t, marks), taskReview(ctx, t)?.state === "candidate" ? "※見直し候補" : ""].filter(Boolean).join(" "),
50
+ ])) || (o.blocked ? "止まっているタスクはありません" : o.review ? "見直しが必要(候補)のタスクはありません" : "タスクはありません"));
48
51
  }
49
52
  case "show": {
50
53
  if (o.archived)
@@ -57,15 +60,21 @@ export async function taskCommand(cmd, env) {
57
60
  return requestCommand(ctx, out, ["show", ref], o, actor, requestArg, expectedRev);
58
61
  const item = ctx.ws.requireTask(ref);
59
62
  const marks = supersededMarks(ctx.ws);
63
+ const review = taskReview(ctx, item);
60
64
  if (o.brief) {
61
- const view = briefTask(ctx, item, marks);
62
- return out.result(view, () => formatBriefTask(view));
65
+ // 見直しの概要は候補のときだけ(記録なし・差分なしは短い出力に出さない)
66
+ const view = { ...briefTask(ctx, item, marks), ...(review?.state === "candidate" ? { review: reviewSummary(review) } : {}) };
67
+ return out.result(view, () => [formatBriefTask(view), ...(review?.state === "candidate" ? ["", ...formatReview(review)] : [])].join("\n"));
63
68
  }
64
69
  const file = relative(cwd, split(ref).col.path(item.id));
65
70
  const { superseded, dependencies, warnings } = taskExtras(ctx, item, marks);
66
71
  const dependents = dependentsOf(ctx, item).map((t) => ({ ref: t.ref, title: t.title, status: t.status }));
67
72
  const acceptance = acceptanceStatus(item) ?? null;
68
- return out.result({ item, file, superseded, dependencies, dependents, warnings, acceptance }, () => [superseded.length ? `※ 置き換えられています: ${superseded.map((m) => `${m.from}${m.note ? `(${m.note})` : ""}`).join(" / ")}\n` : "", formatEntity(ctx, item, file)].join(""));
73
+ return out.result({ item, file, superseded, dependencies, dependents, warnings, acceptance, review: review ?? null }, () => [
74
+ superseded.length ? `※ 置き換えられています: ${superseded.map((m) => `${m.from}${m.note ? `(${m.note})` : ""}`).join(" / ")}\n` : "",
75
+ formatEntity(ctx, item, file),
76
+ review ? `\n\n${formatReview(review).join("\n")}` : "",
77
+ ].join(""));
69
78
  }
70
79
  case "find":
71
80
  case "resolve": {
@@ -118,17 +127,19 @@ export async function taskCommand(cmd, env) {
118
127
  const add = o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x));
119
128
  patch.repoOutputs = addRepoOutputs(patch.repoOutputs ?? col.require(tid).repoOutputs ?? [], add);
120
129
  }
121
- // 受け入れ基準を足す(--criterion)・証拠を残す(--evidence / --evidence-file)
130
+ // 受け入れ基準を足す(--criterion)・証拠を残す(--evidence / --evidence-file / --evidence-json)
122
131
  const acceptance = [...(o.criterion ?? []).map((text) => ({ op: "add", text })), ...evidenceOps(o)];
123
132
  if (!Object.keys(patch).length && !acceptance.length)
124
- throw new UsageError("キー=値 を指定してください(受け入れ基準は --criterion、証拠は --evidence / --evidence-file)");
133
+ throw new UsageError("キー=値 を指定してください(受け入れ基準は --criterion、証拠は --evidence / --evidence-file / --evidence-json)");
125
134
  const r = await updateTask(ctx, ref.split("/")[0], tid, { ...patch, ...(acceptance.length ? { acceptance } : {}) }, { expectedRev, actor });
126
135
  const { task: next, warnings } = r;
127
136
  warn(warnings);
128
137
  checkClearedNote(r.checkCleared);
138
+ completionSkippedNote(r.completionSkipped);
139
+ completionSkippedNote(r.reworkSkipped);
129
140
  const reopened = reopenedNote(r.reopened, r.reopenedAncestors);
130
141
  const keys = [...Object.keys(patch), ...(acceptance.length ? ["acceptance"] : [])];
131
- return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => [`更新: ${next.ref} (rev ${next.rev}) ${keys.join(", ")}`, "repo" in patch ? workHint(ctx, next) : ""].filter(Boolean).join("\n"));
142
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}), ...recordSkips(r) }, () => [`更新: ${next.ref} (rev ${next.rev}) ${keys.join(", ")}`, "repo" in patch ? workHint(ctx, next) : ""].filter(Boolean).join("\n"));
132
143
  }
133
144
  case "move": {
134
145
  const ref = taskArg(args[0]);
@@ -149,22 +160,26 @@ export async function taskCommand(cmd, env) {
149
160
  // リポジトリごとの成果物(最後のタスクに、関係するリポジトリの PR を全部残せる)
150
161
  if (o["repo-output"]?.length)
151
162
  patch.repoOutputs = addRepoOutputs(cur.repoOutputs ?? [], o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x)));
152
- // 完了と同時に項目ごとの証拠を残す(--evidence / --evidence-file。不足があっても完了は拒まない)
163
+ // 完了と同時に項目ごとの証拠を残す(--evidence / --evidence-file / --evidence-json。不足があっても完了は拒まない)
153
164
  const acceptance = evidenceOps(o);
154
165
  const r = await updateTask(ctx, cur.request, tid, { ...patch, ...(acceptance.length ? { acceptance } : {}) }, { expectedRev, actor });
155
166
  const { task: next, warnings } = r;
156
167
  warn(warnings);
157
168
  checkClearedNote(r.checkCleared);
169
+ completionSkippedNote(r.completionSkipped);
170
+ completionSkippedNote(r.reworkSkipped);
158
171
  const reopened = reopenedNote(r.reopened, r.reopenedAncestors);
159
172
  const short = status === "done" ? acceptanceStatus(next)?.shortfalls : undefined;
160
173
  if (short?.length)
161
174
  process.stderr.write(`受け入れ基準の不足(完了はしました。人が確かめます): ${short.join(" / ")}\n`);
162
- return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => `${next.ref} → ${status}${[...(o.output ?? []), ...(o["repo-output"] ?? [])].length ? ` (${[...(o.output ?? []), ...(o["repo-output"] ?? [])].join(", ")})` : ""}`);
175
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}), ...recordSkips(r) }, () => `${next.ref} → ${status}${[...(o.output ?? []), ...(o["repo-output"] ?? [])].length ? ` (${[...(o.output ?? []), ...(o["repo-output"] ?? [])].join(", ")})` : ""}`);
163
176
  }
164
177
  case "check": {
165
178
  const ref = taskArg(args[0]);
166
179
  const { tid } = split(ref);
167
- const { task: next } = await updateTask(ctx, ref.split("/")[0], tid, { checked: !o.off }, { expectedRev, actor });
180
+ const { task: next, completionSkipped, reworkSkipped } = await updateTask(ctx, ref.split("/")[0], tid, { checked: !o.off }, { expectedRev, actor });
181
+ completionSkippedNote(completionSkipped);
182
+ completionSkippedNote(reworkSkipped);
168
183
  return out.result(next, () => `${next.ref} ${o.off ? "の済みを外しました" : "を済みにしました"}`);
169
184
  }
170
185
  case "block":
@@ -223,6 +238,19 @@ function checkClearedNote(msg) {
223
238
  if (msg)
224
239
  process.stderr.write(`${msg}\n`);
225
240
  }
241
+ /** 完了の記録・手戻りの履歴を足せなかった(壊れた記録)ことを知らせる */
242
+ /**
243
+ * 状態は変えたが記録を残せなかった知らせ(完了の記録 completionSkipped・手戻りの履歴 reworkSkipped)。--json の結果にも、API のタスクの PATCH と
244
+ * 同じ項目名・文で入れる(無ければ省く)。AI は JSON だけを読むので、標準エラーの知らせと別に要る
245
+ */
246
+ const recordSkips = (r) => ({
247
+ ...(r.completionSkipped ? { completionSkipped: r.completionSkipped } : {}),
248
+ ...(r.reworkSkipped ? { reworkSkipped: r.reworkSkipped } : {}),
249
+ });
250
+ export function completionSkippedNote(msg) {
251
+ if (msg)
252
+ process.stderr.write(`${msg}\n`);
253
+ }
226
254
  /** 基準・証拠の操作を当てて、今の基準と不足を出す */
227
255
  async function applyAcceptance({ ctx, out, actor, expectedRev, split }, ref, acceptance) {
228
256
  const { tid } = split(ref);
@@ -341,8 +369,9 @@ async function draftCriteriaCommand({ ctx, out, args, o, requestArg }, head, key
341
369
  return out.result({ request: rid, run: run.id, key, criteria: saved.acceptanceCriteria ?? [], problems: [] }, () => show(saved));
342
370
  }
343
371
  /**
344
- * evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md] 1項目の証拠を残す(再記録は置き換え)
372
+ * evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md] [--basis 種類 ...] 1項目の証拠を残す(再記録は置き換え)
345
373
  * evidence <タスク> --file 証拠.md|- 見出し「## <ID> <結果>」ごとにまとめて残す
374
+ * evidence <タスク> --evidence-json 証拠.json|- 根拠つきでまとめて残す
346
375
  * evidence <タスク> rm <ID> [...] 証拠を消す
347
376
  */
348
377
  async function evidenceCommand(env) {
@@ -355,10 +384,14 @@ async function evidenceCommand(env) {
355
384
  return applyAcceptance(env, ref, rest.map((id) => ({ op: "unrecord", id })));
356
385
  }
357
386
  if (first === undefined) {
358
- if (o.file === undefined)
359
- throw new UsageError("使い方: p3 evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md](まとめてなら --file 証拠.md)");
360
- return applyAcceptance(env, ref, evidenceOps({ "evidence-file": o.file }));
387
+ if (o.file === undefined && o["evidence-json"] === undefined)
388
+ throw new UsageError("使い方: p3 evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md] [--basis 種類](まとめてなら --file 証拠.md か --evidence-json 証拠.json)");
389
+ if (o.basis !== undefined)
390
+ throw new UsageError("まとめて残すときの根拠は、--evidence-json の各項目の basis に書いてください(--basis は1項目のときだけ)");
391
+ return applyAcceptance(env, ref, evidenceOps({ "evidence-file": o.file, "evidence-json": o["evidence-json"] }));
361
392
  }
393
+ if (o["evidence-json"] !== undefined)
394
+ throw new UsageError("--evidence-json はまとめて残すときだけ使えます(p3 evidence <タスク> --evidence-json 証拠.json)");
362
395
  const result = rest[0];
363
396
  if (!isAcceptanceResult(result))
364
397
  throw new UsageError(`結果は ${ACCEPTANCE_RESULTS.join(" / ")} のどれかです: p3 evidence <タスク> ${first} <結果>`);
@@ -375,7 +408,8 @@ async function evidenceCommand(env) {
375
408
  throw new UsageError(`証拠のファイルが読めません: ${o.file}`);
376
409
  }
377
410
  }
378
- return applyAcceptance(env, ref, [{ op: "record", id: first, result, evidence }]);
411
+ const basis = basisFromOptions(o);
412
+ return applyAcceptance(env, ref, [{ op: "record", id: first, result, evidence, ...(basis ? { basis } : {}) }]);
379
413
  }
380
414
  // --- アーカイブしたタスク(--archived を付けたときだけ。読むだけ) ------------------------------------
381
415
  /** ls --archived: 今の要望(--req)のアーカイブの一覧。通常の絞り込み・--all とは混ぜない */
@@ -0,0 +1,149 @@
1
+ import { daysUntil, localToday } from "../shared/dates.js";
2
+ import { openProject } from "../core/context.js";
3
+ import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.js";
4
+ import { requirementCommand } from "../features/requirements/cli/requirementCommands.js";
5
+ import { revisitCommand } from "../features/records/cli/revisitCommands.js";
6
+ import { retroCommand } from "../features/retro/cli/retroCommands.js";
7
+ import { metricsCommand } from "../features/metrics/cli/metricsCommands.js";
8
+ import { taskReviewCommand } from "../features/taskReview/cli/taskReviewCommands.js";
9
+ import { qualityCommand } from "../features/quality/cli/qualityCommands.js";
10
+ import { NotFoundError } from "../core/store/collection.js";
11
+ import { VIA_LABEL } from "../core/store/locate.js";
12
+ import { table } from "./format.js";
13
+ import { cliExit } from "../core/errorOutcome.js";
14
+ import { config, currentRequest, locateHere, repoCommand, resolveActor, runnerText } from "../features/settings/cli/projectSettings.js";
15
+ import { UsageError } from "../../kit/usage.js";
16
+ import { sortMilestones } from "../shared/milestoneOrder.js";
17
+ import { runnerView } from "../shared/preflightRunner.js";
18
+ import { Output, bar } from "./output.js";
19
+ import { requestCommand, milestoneCommand } from "./requestCommands.js";
20
+ import { taskCommand } from "./taskCommands.js";
21
+ import { preflightCommand } from "./preflightCommands.js";
22
+ import { releaseNotesCommand } from "../features/releaseNotes/cli/releaseNotesCommands.js";
23
+ /**
24
+ * tasks の CLI: プロジェクトを開いた後のコマンドの振り分け(要望・タスク・Preflight・レビュー・品質・マイルストーン・リリースノート・
25
+ * 振り返り・指標・設定・参照先)と、エラーから終了コードへの対応。引数の解釈・プロジェクトの決定・登録が1つだけのときの抑止・serve・
26
+ * help・guide・init・join・agents は入口(main.ts)が受け持ち、ここを呼ぶ
27
+ */
28
+ /** 進捗の行の見直し候補の印(要望自身・自分のタスク・配下を分ける。無ければ空) */
29
+ function reviewMark(p) {
30
+ const r = p.review;
31
+ if (!r)
32
+ return "";
33
+ const parts = [r.self?.state === "candidate" ? "要望" : "", r.tasks ? `タスク ${r.tasks}` : "", r.below ? `配下 ${r.below}` : ""].filter(Boolean);
34
+ return parts.length ? ` ※見直し候補(${parts.join("・")})` : "";
35
+ }
36
+ /** 決まったプロジェクトで tasks のコマンドを動かす(知らないコマンドは使い方の誤り) */
37
+ export async function runTasksCommand(r) {
38
+ const { cmd, args, o, cwd, out, target, settings } = r;
39
+ const ctx = await openProject(target.dataDir, { repos: target.repos, settings, projectName: target.name });
40
+ const actor = resolveActor(o.actor ?? process.env.P3_ACTOR, cwd);
41
+ const current = currentRequest(ctx, o.req ?? o.request ?? process.env.P3_REQUEST, cwd);
42
+ const expectedRev = o.rev !== undefined ? Number(o.rev) : undefined;
43
+ /** 要望の引数(省略時は今の要望) */
44
+ const requestArg = (raw) => {
45
+ if (raw) {
46
+ const id = resolveRequestId(ctx, raw);
47
+ if (!id)
48
+ throw new NotFoundError(raw);
49
+ return id;
50
+ }
51
+ if (!current)
52
+ throw new UsageError("要望を指定してください(引数か --req。要望の作業ツリーの中なら省略可)");
53
+ return current;
54
+ };
55
+ /** タスクの引数(T003 は今の要望の中) */
56
+ const taskArg = (raw) => {
57
+ if (!raw)
58
+ throw new UsageError("タスクを指定してください(T003 / <要望>/T003)");
59
+ const ref = resolveRef(ctx, raw, current);
60
+ if (ref?.includes("/"))
61
+ return ref;
62
+ if (!ref && !raw.includes("/") && !current)
63
+ throw new UsageError(`${raw}: 要望を --req で指定してください`);
64
+ throw new NotFoundError(raw);
65
+ };
66
+ const split = (ref) => {
67
+ const [rid, tid] = ref.split("/");
68
+ return { col: ctx.ws.tasksOf(rid), rid, tid };
69
+ };
70
+ const env = { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd, target };
71
+ const handled = (await taskCommand(cmd, env)) ?? (await taskReviewCommand(cmd, env)) ?? (await preflightCommand(cmd, env)) ?? (await requirementCommand(cmd, env)) ?? (await revisitCommand(cmd, env)) ?? (await retroCommand(cmd, env)) ?? (await metricsCommand(cmd, env));
72
+ if (handled !== undefined)
73
+ return handled;
74
+ switch (cmd) {
75
+ case "config": {
76
+ const r = await config(ctx.ws, args);
77
+ return out.result(r.data, () => r.text);
78
+ }
79
+ case "repo": {
80
+ const r = await repoCommand(ctx.ws, target.name, cwd, args, { local: o.local });
81
+ return out.result(r.data, () => r.text);
82
+ }
83
+ case "whoami": {
84
+ const here = locateHere(ctx, cwd);
85
+ // Preflight の担当(AI 向けの手順が読む。読めなければ runner: null と problem。agent と推測しない)
86
+ const pf = runnerView(ctx.ws.project.preflight);
87
+ const preflight = { runner: pf.runner, source: pf.source, ...(pf.problem ? { problem: pf.problem } : {}) };
88
+ // 置いた AI 向けの入口の状態(読むだけ。古くても操作は断らない)
89
+ const { status: agents, lines: agentLines } = r.agents();
90
+ return out.result({ project: target.name ?? null, dataDir: target.dataDir, via: target.via, here: here.repos, branch: here.branch ?? null, actor, request: current ?? null, preflight, agents }, () => [
91
+ `プロジェクト ${target.name ?? "(未登録)"} ${target.dataDir}`,
92
+ `決まり方 ${target.via}(${VIA_LABEL[target.via]})`,
93
+ `今いる参照先 ${here.repos.length ? here.repos.join(", ") : "(どの参照先の中でもない。p3 repo ls)"}${here.branch ? ` ブランチ ${here.branch}` : ""}`,
94
+ `変更者 ${actor}`,
95
+ `要望 ${current ? `${current} ${titleOf(ctx, current)}` : "(なし)"}`,
96
+ `Preflight ${runnerText(pf)}`,
97
+ ...agentLines.map((l, i) => (i ? ` ${l}` : `AI の入口 ${l}`)),
98
+ ].join("\n"));
99
+ }
100
+ case "progress": {
101
+ const ps = progress(ctx).filter((p) => o.all || !["done", "rejected"].includes(p.request.status));
102
+ const today = localToday();
103
+ return out.result(ps, () => {
104
+ const groups = [
105
+ ...sortMilestones(ctx.ws.project.milestones).map((m) => ({ m, ps: ps.filter((p) => p.request.milestone === m.id) })),
106
+ { m: undefined, ps: ps.filter((p) => !p.request.milestone) },
107
+ ];
108
+ return (groups
109
+ .filter((g) => g.ps.length)
110
+ .map((g) => {
111
+ const done = g.ps.reduce((n, p) => n + p.done, 0);
112
+ const total = g.ps.reduce((n, p) => n + p.total, 0);
113
+ const head = g.m
114
+ ? `■ ${g.m.title}(${g.m.id}${g.m.due ? ` · ${g.m.due}` : ""}${g.m.done ? " · リリース済み" : ""}) タスク ${done}/${total}`
115
+ : "■ マイルストーンなし";
116
+ const rows = g.ps.map((p) => [
117
+ ` ${p.request.id}`,
118
+ p.request.status,
119
+ `${bar(p.total ? p.done / p.total : 0)} ${p.done}/${p.total}`,
120
+ p.request.due
121
+ ? `${p.request.due}${daysUntil(p.request.due, today) < 0 && !["done", "rejected"].includes(p.request.status) ? " 超過" : ""}`
122
+ : "",
123
+ p.request.tags.map((t) => `#${t}`).join(" "),
124
+ // 子のある要望は配下の集計(自分の値とは別)、子は親を添える
125
+ `${p.request.title}${p.blocked ? ` ⏸停止 ${p.blocked}` : ""}${p.children.length ? ` [配下 ${p.subtree.done}/${p.subtree.total}・子 ${p.children.length}${p.subtree.blocked > p.blocked ? `・配下の停止 ${p.subtree.blocked - p.blocked}` : ""}]` : ""}${p.request.parent ? ` ↑${p.request.parent}` : ""}${p.hierarchyIssues.length ? " ※親子の問題" : ""}${reviewMark(p)}`,
126
+ ]);
127
+ return `${head}\n${table(rows)}`;
128
+ })
129
+ .join("\n\n") || "要望はありません");
130
+ });
131
+ }
132
+ case "quality":
133
+ return qualityCommand(env);
134
+ case "milestone":
135
+ case "milestones":
136
+ return milestoneCommand(ctx, out, args, o, actor);
137
+ case "release-notes":
138
+ case "release-note":
139
+ return releaseNotesCommand(env);
140
+ // --- 要望 ---------------------------------------------------------------
141
+ case "request":
142
+ case "req":
143
+ return requestCommand(ctx, out, args, o, actor, requestArg, expectedRev);
144
+ default:
145
+ throw new UsageError(`不明なコマンド: ${cmd}(p3 help)`);
146
+ }
147
+ }
148
+ /** エラーを標準エラーに出し、終了コードを返す(競合 3・見つからない 2・ほか 1。対応の表は core/errorOutcome.ts) */
149
+ export const reportError = (e) => cliExit(e, (t) => process.stderr.write(t));
@@ -1,4 +1,3 @@
1
- import { fileURLToPath } from "node:url";
2
1
  import { chatgptAccount } from "./chatgpt.js";
3
2
  import { CodexWorkspaceEngine, codexConfig } from "./preflight/codexEngine.js";
4
3
  import { fixedSettings, machineSettingsSource } from "./machineSettings.js";
@@ -6,14 +5,12 @@ import { MockEngine } from "./preflight/mockEngine.js";
6
5
  import { PreflightService } from "./preflight/service.js";
7
6
  import { checkDataDir } from "./store/locate.js";
8
7
  import { Workspace } from "./store/workspace.js";
9
- import { ReleaseGenerator } from "./releaseNotes/generate.js";
10
- import { MockSummarizer } from "./releaseNotes/mockSummarizer.js";
11
- import { MilestoneReviewService } from "./milestoneReview/service.js";
12
- import { MockReviewer } from "./milestoneReview/mockReviewer.js";
13
- import { TaskReviewService } from "./taskReview/service.js";
14
- import { MockTaskReviewer } from "./taskReview/mockReviewer.js";
15
- /** p3 本体(パッケージ)のルート */
16
- export const P3_ROOT = fileURLToPath(new URL("../../", import.meta.url));
8
+ import { ReleaseGenerator } from "../features/releaseNotes/core/generate.js";
9
+ import { MockSummarizer } from "../features/releaseNotes/core/mockSummarizer.js";
10
+ import { MilestoneReviewService } from "../features/milestoneReview/core/service.js";
11
+ import { MockReviewer } from "../features/milestoneReview/core/mockReviewer.js";
12
+ import { TaskReviewService } from "../features/taskReview/core/service.js";
13
+ import { MockTaskReviewer } from "../features/taskReview/core/mockReviewer.js";
17
14
  /**
18
15
  * サーバと CLI が共有する組み立て。どちらもデータのフォルダのファイルを直接読み書きする。
19
16
  * repos: 参照先の名前 → このマシンのパス(個人設定)
@@ -0,0 +1,125 @@
1
+ import { UsageError } from "../../kit/usage.js";
2
+ import { AcceptanceInputError } from "../features/requirements/shared/acceptance.js";
3
+ import { MetricsError } from "../features/metrics/shared/metrics.js";
4
+ import { QualityInputError } from "../features/quality/shared/quality.js";
5
+ import { RequirementInputError } from "../features/requirements/shared/requirementSource.js";
6
+ import { RetrospectiveError } from "../features/retro/shared/retrospective.js";
7
+ import { PremiseInputError } from "../features/records/shared/reviewCandidate.js";
8
+ import { BlockInputError } from "../shared/taskBlock.js";
9
+ import { HierarchyError } from "./hierarchy.js";
10
+ import { SettingsError } from "./machineSettings.js";
11
+ import { ReviewRejected } from "../features/milestoneReview/core/service.js";
12
+ import { StaleInputError } from "./preflight/input.js";
13
+ import { ChildConflictError, ChildDraftsChangedError, DraftConflictError } from "./preflight/service.js";
14
+ import { ImprovementError } from "../features/quality/core/qualityImprovement.js";
15
+ import { CompletionRejected } from "../features/releaseNotes/core/completeRequests.js";
16
+ import { GenerationRejected } from "../features/releaseNotes/core/generate.js";
17
+ import { ReleaseNoteError } from "../features/releaseNotes/core/store.js";
18
+ import { OpRuleError } from "./requestOps.js";
19
+ import { ReviewCancelRefused, ReviewStoreError } from "./reviewRuns.js";
20
+ import { ArchivedTaskReadError } from "./store/archivedTasks.js";
21
+ import { ConflictError, NotFoundError } from "./store/collection.js";
22
+ import { DataDirError, ProjectNotResolvedError } from "./store/locate.js";
23
+ import { MilestonesConflictError, ProjectInputError, ReloadError } from "./store/workspace.js";
24
+ import { TaskReviewRejected } from "../features/taskReview/core/material.js";
25
+ import { UserConfigError } from "./userConfig.js";
26
+ const conflict = (e) => `競合: ${e.message}`;
27
+ export function errorOutcome(e) {
28
+ if (!(e instanceof Error))
29
+ return undefined;
30
+ const coded = (status, code, extra = {}) => ({ status, body: { code, ...extra } });
31
+ if (e instanceof ConflictError)
32
+ return { exit: 3, cli: `競合: ${e.message}。最新を取得してやり直してください`, status: 409, body: { code: "rev_conflict" } };
33
+ if (e instanceof NotFoundError)
34
+ return { exit: 2, cli: `見つかりません: ${e.id}`, status: 404 };
35
+ if (e instanceof UserConfigError)
36
+ return { exit: 1, cli: e.message, status: 500 };
37
+ if (e instanceof SettingsError)
38
+ return { exit: 1, cli: `設定: ${e.message}` };
39
+ if (e instanceof ProjectNotResolvedError || e instanceof DataDirError)
40
+ return { exit: 1, cli: e.message };
41
+ if (e instanceof ReleaseNoteError) {
42
+ const exit = e.code === "not_found" ? 2 : e.code === "conflict" || e.code === "exists" ? 3 : 1;
43
+ const cli = e.code === "conflict" ? conflict(e) : e.message;
44
+ if (e.code === "not_found")
45
+ return { exit, cli, ...coded(404, "not_found") };
46
+ if (e.code === "bad_id")
47
+ return { exit, cli, ...coded(400, "bad_id") };
48
+ if (e.code === "invalid")
49
+ return { exit, cli, ...coded(422, "invalid") };
50
+ return { exit, cli, ...coded(409, "rev_conflict", { reason: e.code }) };
51
+ }
52
+ if (e instanceof MetricsError)
53
+ return { exit: e.code === "metrics_conflict" ? 3 : 1, cli: e.code === "metrics_conflict" ? conflict(e) : e.message, ...coded(400, e.code) };
54
+ if (e instanceof RetrospectiveError)
55
+ return { exit: e.code === "retro_conflict" ? 3 : 1, cli: e.code === "retro_conflict" ? conflict(e) : e.message, ...coded(e.code === "retro_invalid" ? 400 : 409, e.code) };
56
+ if (e instanceof GenerationRejected)
57
+ return { exit: 1, cli: e.message, ...coded(e.code === "running" ? 409 : 400, e.code) };
58
+ if (e instanceof CompletionRejected)
59
+ return { ...coded(409, e.code, { plan: e.plan }) };
60
+ if (e instanceof HierarchyError) {
61
+ // 子の表示順を読んだ後に子の集合が変わった・ロックを取れない → 3(読み直してやり直す)
62
+ const changedSet = e.code === "child_order_invalid" && (e.detail.reason === "not_child" || e.detail.reason === "missing");
63
+ return { exit: e.code === "hierarchy_busy" || changedSet ? 3 : 1, cli: e.message, ...coded(409, e.code, { ...e.detail }) };
64
+ }
65
+ if (e instanceof ReviewRejected) {
66
+ const exit = e.code === "unknown_milestone" ? 2 : e.code === "running" ? 3 : 1;
67
+ const status = e.code === "running" || e.code === "material_changed" ? 409 : e.code === "unknown_milestone" ? 404 : 400;
68
+ return { exit, cli: e.message, ...coded(status, e.code, e.running ? { run: e.running } : {}) };
69
+ }
70
+ if (e instanceof ReviewStoreError) {
71
+ const exit = e.code === "not_found" ? 2 : e.code === "finished" || e.code === "exists" ? 3 : 1;
72
+ const status = e.code === "not_found" ? 404 : e.code === "bad_id" ? 400 : e.code === "broken" ? 422 : 409;
73
+ return { exit, cli: e.message, ...coded(status, e.code) };
74
+ }
75
+ if (e instanceof ReviewCancelRefused)
76
+ return { exit: 3, cli: e.message, ...coded(409, e.code) };
77
+ if (e instanceof TaskReviewRejected) {
78
+ const busy = e.code === "running" || e.code === "material_changed";
79
+ return { exit: busy ? 3 : 1, cli: e.message, ...coded(busy ? 409 : 400, e.code, e.running ? { run: e.running } : {}) };
80
+ }
81
+ if (e instanceof ImprovementError) {
82
+ const busy = e.code === "diagnosis_changed" || e.code === "existing" || e.code === "closed_existing";
83
+ return { exit: e.code === "not_found" ? 2 : busy ? 3 : 1, cli: e.message, ...coded(e.code === "not_found" ? 404 : busy ? 409 : 400, e.code, e.existing ? { existing: e.existing } : {}) };
84
+ }
85
+ if (e instanceof QualityInputError)
86
+ return { exit: e.code === "quality_conflict" ? 3 : 1, cli: e.message, ...coded(e.code === "quality_conflict" ? 409 : 400, e.code) };
87
+ if (e instanceof MilestonesConflictError)
88
+ return { exit: 3, cli: conflict(e), ...coded(409, e.code, { milestonesVersion: e.current }) };
89
+ // 規則に合わない入力(何も書いていない)。CLI は前置きなし
90
+ if (e instanceof AcceptanceInputError || e instanceof RequirementInputError || e instanceof PremiseInputError)
91
+ return { exit: 1, cli: e.message, ...coded(400, e.code) };
92
+ if (e instanceof BlockInputError)
93
+ return { exit: 1, cli: e.message, ...coded(e.code === "blocked" ? 409 : 400, e.code) };
94
+ if (e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError)
95
+ return { exit: 1, cli: e.message };
96
+ // Preflight の案・子の案・評価対象(API だけ。409 は code で分ける: rev_conflict は読み直してやり直す / stale_input は評価のあとで要望が変わった)
97
+ if (e instanceof DraftConflictError || e instanceof ChildConflictError)
98
+ return { ...coded(409, "rev_conflict", { current: e.current }) };
99
+ if (e instanceof ChildDraftsChangedError)
100
+ return { ...coded(409, e.code) };
101
+ if (e instanceof StaleInputError)
102
+ return { ...coded(409, e.code, { inputMatch: e.match }) };
103
+ if (e instanceof ReloadError)
104
+ return { status: 503 };
105
+ if (e instanceof ArchivedTaskReadError)
106
+ return { ...coded(500, e.code) };
107
+ return undefined;
108
+ }
109
+ /** CLI: 標準エラーに出し、終了コードを返す */
110
+ export function cliExit(e, write) {
111
+ const o = errorOutcome(e);
112
+ if (o?.exit) {
113
+ write(`${o.cli ?? e.message}\n`);
114
+ return o.exit;
115
+ }
116
+ write(`エラー: ${e.message}\n`);
117
+ return 1;
118
+ }
119
+ /** API: 応答の状態と本文(表に無ければ undefined。各アプリが 400 と console.error で返す) */
120
+ export function apiError(e) {
121
+ const o = errorOutcome(e);
122
+ if (!o?.status)
123
+ return undefined;
124
+ return { status: o.status, body: { error: e.message, ...o.body } };
125
+ }
@@ -2,7 +2,7 @@ import { readdir } from "node:fs/promises";
2
2
  import { join } from "node:path";
3
3
  import { Hierarchy } from "../shared/hierarchy.js";
4
4
  import { REQUEST_ID } from "../shared/refs.js";
5
- import { withFileLock } from "./store/fsutil.js";
5
+ import { withFileLock } from "../../kit/fsutil.js";
6
6
  /** 親子の規則に合わない・ロックを取れない(何も書いていない) */
7
7
  export class HierarchyError extends Error {
8
8
  code;
@@ -1,7 +1,10 @@
1
+ import { evidenceSummary } from "../features/requirements/shared/acceptance.js";
1
2
  import { normalizeTaskId } from "../shared/refs.js";
2
3
  import { REQUEST_STATUSES, TASK_STATUSES } from "../shared/types.js";
3
4
  import { hierarchyNow } from "./requestStatus.js";
4
- export function listTasks({ ws }, f = {}) {
5
+ import { requestReviewCounts, reviewMemo, taskReview } from "../features/records/core/reviewCandidates.js";
6
+ export function listTasks(ctx, f = {}) {
7
+ const { ws } = ctx;
5
8
  let tasks = f.request ? ws.tasksOf(f.request).list() : ws.allTasks();
6
9
  if (f.status?.length)
7
10
  tasks = tasks.filter((t) => f.status.includes(t.status));
@@ -12,6 +15,8 @@ export function listTasks({ ws }, f = {}) {
12
15
  tasks = tasks.filter((t) => (t.repo ?? null) === (f.repo === "none" ? null : f.repo));
13
16
  if (f.blocked)
14
17
  tasks = tasks.filter((t) => !!t.block);
18
+ if (f.review)
19
+ tasks = tasks.filter((t) => taskReview(ctx, t)?.state === "candidate");
15
20
  if (f.q) {
16
21
  const q = f.q.toLowerCase();
17
22
  tasks = tasks.filter((t) => `${t.ref} ${t.title} ${t.body}`.toLowerCase().includes(q));
@@ -77,6 +82,8 @@ export function titleOf({ ws }, ref) {
77
82
  */
78
83
  export function progress(ctx) {
79
84
  const h = hierarchyNow(ctx.ws);
85
+ // 見直しの診断はこの呼び出しの中で使い回す(タスク行と、要望の自身・自分のタスク・配下の件数で同じ結果を使う)
86
+ const memo = reviewMemo(ctx);
80
87
  const zero = () => Object.fromEntries(TASK_STATUSES.map((s) => [s, 0]));
81
88
  return ctx.ws.requests
82
89
  .list()
@@ -110,7 +117,14 @@ export function progress(ctx) {
110
117
  }
111
118
  return {
112
119
  request,
113
- tasks: tasks.map(({ id, ref, title, status, createdAt, startedAt, doneAt, checkedAt, block }) => ({ id, ref, title, status, createdAt, startedAt, doneAt, checkedAt, ...(block ? { block } : {}) })),
120
+ tasks: tasks.map((t) => {
121
+ const { id, ref, title, status, createdAt, startedAt, doneAt, checkedAt, block } = t;
122
+ // 証拠の小さな概要(本文は載せない。規則は shared/acceptance.ts)
123
+ const evidence = evidenceSummary(t);
124
+ // 完了したタスクの見直しの診断の状態(理由は詳細で読む)
125
+ const review = memo.task(t)?.state;
126
+ return { id, ref, title, status, createdAt, startedAt, doneAt, checkedAt, ...(block ? { block } : {}), ...(evidence ? { evidence } : {}), ...(review ? { review } : {}) };
127
+ }),
114
128
  counts,
115
129
  total: tasks.length,
116
130
  done: done.length,
@@ -119,6 +133,7 @@ export function progress(ctx) {
119
133
  children: h.children(request.id).map((c) => c.id),
120
134
  subtree: sub,
121
135
  hierarchyIssues: h.issuesAround(request.id),
136
+ review: requestReviewCounts(ctx, request, h, memo),
122
137
  };
123
138
  })
124
139
  .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt) || byId(a.request.id, b.request.id));
@@ -82,7 +82,11 @@ export function renderCarryover(c) {
82
82
  const list = (xs) => (xs.length ? xs.map((x) => `- ${x}`).join("\n") : "(なし)");
83
83
  if (c.requestChange)
84
84
  out.push(requestChangeSection(c.requestChange, p.id));
85
- out.push(`## 前回の評価(${p.id})`, `判定: ${a.verdict} / 妥当性 ${a.validity.score} / 実現可能性 ${a.feasibility.score}`, a.summary, `### 確認事項\n${list(a.questions)}`, `### リスク\n${list(a.risks)}`,
85
+ out.push(`## 前回の評価(${p.id})`, `判定: ${a.verdict} / 妥当性 ${a.validity.score} / 実現可能性 ${a.feasibility.score}`, a.summary, `### 確認事項\n${list(a.questions)}`, ...(a.clarifications?.length
86
+ ? [
87
+ `### 構造化した確認事項(回答は要望の「要求の出典と確認」に元の組のまま載せています)\n${list(a.clarifications.map((q) => `${p.id}/${q.id}: ${q.question}(確認先: ${q.ask} / 対象: ${q.target}${q.needed ? ` / 必要な根拠: ${q.needed}` : ""})`))}`,
88
+ ]
89
+ : []), `### リスク\n${list(a.risks)}`,
86
90
  // 前回の根拠は前回の時点のもの。今回の確かめた根拠としてそのまま写させない
87
91
  `### 前回の根拠(前回の時点のもの。使うなら今回あらためて確かめ、確かめていなければ assumed にする)\n${a.evidence === undefined
88
92
  ? "(記録なし)"