@infodb/p3 0.11.0 → 0.13.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 (138) hide show
  1. package/README.md +33 -33
  2. package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
  3. package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
  4. package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
  5. package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
  6. package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
  7. package/dist/web/assets/TagInput-B2b862qn.js +1 -0
  8. package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
  9. package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
  10. package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
  11. package/dist/web/assets/archive-DMl6WyOe.js +1 -0
  12. package/dist/web/assets/board-BMTcHKyt.js +1 -0
  13. package/dist/web/assets/done-CL6Nlsua.js +1 -0
  14. package/dist/web/assets/draft-BvGxfD7v.js +2 -0
  15. package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
  16. package/dist/web/assets/index-KdlgMitg.js +12 -0
  17. package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
  18. package/dist/web/assets/new-DTXWHuFO.js +1 -0
  19. package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
  20. package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
  21. package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
  22. package/dist/web/assets/quality-RFd-7k3r.js +1 -0
  23. package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
  24. package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
  25. package/dist/web/assets/routes-BIt8bExF.js +6 -0
  26. package/dist/web/assets/settings-CsCqF_1B.js +1 -0
  27. package/dist/web/assets/taskReview-_WCgnQit.js +1 -0
  28. package/dist/web/assets/ui-BGK72r3u.js +1 -0
  29. package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
  30. package/dist/web/index.html +4 -4
  31. package/docs/architecture.md +610 -33
  32. package/docs/development.md +61 -17
  33. package/docs/how-to-use.md +554 -17
  34. package/docs/installation.md +235 -144
  35. package/docs/publishing.md +1 -1
  36. package/lib/cli/agentsStatus.js +197 -0
  37. package/lib/cli/args.js +111 -2
  38. package/lib/cli/guide.js +27 -0
  39. package/lib/cli/guide.md +214 -0
  40. package/lib/cli/help.js +74 -1
  41. package/lib/cli/main.js +97 -17
  42. package/lib/cli/metricsCommands.js +77 -0
  43. package/lib/cli/output.js +19 -1
  44. package/lib/cli/preflightCommands.js +7 -1
  45. package/lib/cli/project.js +13 -24
  46. package/lib/cli/qualityCommands.js +188 -0
  47. package/lib/cli/readOnly.js +17 -0
  48. package/lib/cli/requestCommands.js +33 -4
  49. package/lib/cli/requirementCommands.js +288 -0
  50. package/lib/cli/retroCommands.js +106 -0
  51. package/lib/cli/revisitCommands.js +73 -0
  52. package/lib/cli/showView.js +183 -4
  53. package/lib/cli/taskCommands.js +341 -20
  54. package/lib/cli/taskReviewCommands.js +178 -0
  55. package/lib/cli/userConfig.js +47 -0
  56. package/lib/core/completionRefs.js +46 -0
  57. package/lib/core/context.js +4 -1
  58. package/lib/core/metrics/definitions.js +434 -0
  59. package/lib/core/metrics/index.js +88 -0
  60. package/lib/core/metrics/manual.js +180 -0
  61. package/lib/core/milestoneReview/material.js +11 -1
  62. package/lib/core/milestoneReview/mockReviewer.js +1 -0
  63. package/lib/core/milestoneReview/review.js +70 -6
  64. package/lib/core/milestoneReview/service.js +29 -93
  65. package/lib/core/milestoneReview/store.js +12 -62
  66. package/lib/core/ops.js +23 -3
  67. package/lib/core/preflight/carryover.js +6 -2
  68. package/lib/core/preflight/codexEngine.js +34 -17
  69. package/lib/core/preflight/diagnose.js +4 -9
  70. package/lib/core/preflight/engine.js +15 -0
  71. package/lib/core/preflight/hostPaths.js +260 -0
  72. package/lib/core/preflight/input.js +33 -5
  73. package/lib/core/preflight/instructions.js +36 -2
  74. package/lib/core/preflight/mockEngine.js +24 -2
  75. package/lib/core/preflight/render.js +22 -3
  76. package/lib/core/preflight/service.js +99 -8
  77. package/lib/core/preflight/uiRender.js +3 -0
  78. package/lib/core/projectRegistry.js +3 -3
  79. package/lib/core/quality.js +21 -0
  80. package/lib/core/qualityImprovement.js +221 -0
  81. package/lib/core/requestOps.js +294 -11
  82. package/lib/core/retrospective.js +208 -0
  83. package/lib/core/reviewCandidates.js +56 -0
  84. package/lib/core/reviewRuns.js +205 -0
  85. package/lib/core/store/archivedTasks.js +74 -0
  86. package/lib/core/store/collection.js +32 -3
  87. package/lib/core/store/normalize.js +35 -2
  88. package/lib/core/store/preflightStore.js +23 -1
  89. package/lib/core/store/projectFile.js +10 -0
  90. package/lib/core/store/workspace.js +49 -3
  91. package/lib/core/taskReview/material.js +459 -0
  92. package/lib/core/taskReview/mockReviewer.js +30 -0
  93. package/lib/core/taskReview/paths.js +15 -0
  94. package/lib/core/taskReview/review.js +312 -0
  95. package/lib/core/taskReview/service.js +187 -0
  96. package/lib/core/taskReview/store.js +214 -0
  97. package/lib/server/api/manifest.js +104 -5
  98. package/lib/server/api/milestoneReviewRoutes.js +4 -3
  99. package/lib/server/api/routes.js +265 -17
  100. package/lib/server/api/taskReviewRoutes.js +66 -0
  101. package/lib/server/server.js +2 -2
  102. package/lib/shared/acceptance.js +618 -0
  103. package/lib/shared/completionRecord.js +327 -0
  104. package/lib/shared/metrics.js +42 -0
  105. package/lib/shared/milestoneReview.js +2 -1
  106. package/lib/shared/preflightInput.js +1 -1
  107. package/lib/shared/quality.js +391 -0
  108. package/lib/shared/qualityImprovement.js +1 -0
  109. package/lib/shared/qualityTemplates.js +31 -0
  110. package/lib/shared/requirementSource.js +635 -0
  111. package/lib/shared/retrospective.js +286 -0
  112. package/lib/shared/reviewCandidate.js +308 -0
  113. package/lib/shared/reworkHistory.js +81 -0
  114. package/lib/shared/taskBlock.js +142 -0
  115. package/lib/shared/taskReview.js +56 -0
  116. package/package.json +3 -2
  117. package/skills/p3/SKILL.md +9 -152
  118. package/dist/web/assets/Outputs-ddwte0jj.js +0 -1
  119. package/dist/web/assets/RequestStatus-Bg1OLbRc.js +0 -1
  120. package/dist/web/assets/Tabs-DTmggzgg.js +0 -1
  121. package/dist/web/assets/TagInput-BHAgjLP7.js +0 -1
  122. package/dist/web/assets/TaskDrawer-Dz_5c2NH.js +0 -3
  123. package/dist/web/assets/_requestId-D9-gtIcG.js +0 -1
  124. package/dist/web/assets/_requestId-DzCNYvqf.js +0 -30
  125. package/dist/web/assets/appCtx-Cm24VpAf.js +0 -1
  126. package/dist/web/assets/board-MCHcZ-PU.js +0 -1
  127. package/dist/web/assets/done-zq10Bt08.js +0 -1
  128. package/dist/web/assets/draft-CfJeyLOl.js +0 -1
  129. package/dist/web/assets/index-Ce0ndpne.js +0 -12
  130. package/dist/web/assets/index-D68mkSnw.css +0 -2
  131. package/dist/web/assets/new-9TKiNT4O.js +0 -1
  132. package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
  133. package/dist/web/assets/preload-helper-FBLw7u7x.js +0 -1
  134. package/dist/web/assets/release-notes-hK5XezLW.js +0 -5
  135. package/dist/web/assets/requestData-BnN7mctX.js +0 -1
  136. package/dist/web/assets/routes-usHwrrA0.js +0 -3
  137. package/dist/web/assets/settings-BVZDnL6O.js +0 -1
  138. package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
@@ -0,0 +1,188 @@
1
+ import { qualityTemplate, qualityView, updateQuality } from "../core/quality.js";
2
+ import { checkLine } from "../shared/quality.js";
3
+ import { diagnoseQuality, improvementDraft, registerImprovement } from "../core/qualityImprovement.js";
4
+ import { readBody } from "./args.js";
5
+ import { table } from "./format.js";
6
+ import { UsageError } from "./project.js";
7
+ /**
8
+ * 品質基準(core/quality.ts。画面の設定の「品質基準」と同じ)。
9
+ * quality 今の設定(未設定・設定済み・読めない)とテンプレートの改版の差分
10
+ * quality templates / quality template <id> 同梱のテンプレートの一覧・中身
11
+ * quality init 空の品質基準を設定する(意図して空。必須ではなく、設定済みなら内容は変えない)
12
+ * quality adopt <テンプレート> テンプレートを写して採用する / quality upgrade <テンプレート> 改版の差分を当てる
13
+ * quality add --text 文 [--repo 名前]... (--command コマンド --success 成功の条件 | --reference 確かめ方)
14
+ * quality set <Q1> [--text] [--repo 名前|all]... [--command --success | --reference] quality rm <Q1>
15
+ * --repo は繰り返して複数の参照先を指定する(qualityRepos)。add で省くと全参照先、set で省くと対象は変えない
16
+ * quality exempt <Q1> --reason 理由 / quality unexempt <Q1>
17
+ * 変える操作は --version <版>(quality --json の version)を付けると、違えば競合(終了コード 3)
18
+ */
19
+ export async function qualityCommand(env) {
20
+ const { ctx, out, args, o } = env;
21
+ const [sub, ...rest] = args;
22
+ const ws = ctx.ws;
23
+ if (sub === undefined || sub === "show") {
24
+ const v = qualityView(ws);
25
+ return out.result(v, () => formatQuality(v));
26
+ }
27
+ if (sub === "templates") {
28
+ const v = qualityView(ws);
29
+ return out.result(v.templates, () => table(v.templates.map((t) => [`${t.id}@${t.version}`, t.title, `${t.items} 件`, t.description])));
30
+ }
31
+ if (sub === "template") {
32
+ const t = qualityTemplate(rest[0] ?? "", o.version ? Number(o.version) : undefined);
33
+ if (!t)
34
+ throw new UsageError(`テンプレートがありません: ${rest[0] ?? ""}(p3 quality templates)`);
35
+ return out.result(t, () => [`${t.id}@${t.version} ${t.title}`, ` ${t.description}`, "", ...t.items.map((i) => ` ${i.key} ${i.text}\n ${checkLine(i.check)}`)].join("\n"));
36
+ }
37
+ if (sub === "improve")
38
+ return improveCommand(env, rest);
39
+ const check = () => {
40
+ if (o.reference !== undefined) {
41
+ if (o.command !== undefined || o.success !== undefined)
42
+ throw new UsageError("--reference(人の確認)と --command / --success(機械の検査)はどちらか一方です");
43
+ return { kind: "manual", reference: readBody(o.reference) };
44
+ }
45
+ if (o.command !== undefined || o.success !== undefined)
46
+ return { kind: "machine", command: o.command ?? "", success: o.success ?? "" };
47
+ return undefined;
48
+ };
49
+ if (o.repos !== undefined && sub !== "add" && sub !== "set")
50
+ throw new UsageError(`--repo は p3 quality add / set でだけ使えます(${sub} は対象を取りません)`);
51
+ let ops;
52
+ switch (sub) {
53
+ case "init":
54
+ ops = [{ op: "init" }];
55
+ break;
56
+ case "adopt":
57
+ if (!rest[0])
58
+ throw new UsageError("使い方: p3 quality adopt <テンプレート>(p3 quality templates)");
59
+ ops = [{ op: "adopt", template: rest[0] }];
60
+ break;
61
+ case "upgrade":
62
+ if (!rest[0])
63
+ throw new UsageError("使い方: p3 quality upgrade <テンプレート>(差分は p3 quality で見る)");
64
+ ops = [{ op: "upgrade", template: rest[0] }];
65
+ break;
66
+ case "add": {
67
+ const c = check();
68
+ if (!c)
69
+ throw new UsageError("確認の方法を指定してください: --command <コマンド> --success <成功の条件>(機械の検査)か --reference <確かめ方>(人の確認)");
70
+ const repos = qualityRepos(o.repos, ws.project.repos.map((r) => r.name));
71
+ ops = [{ op: "add", standard: { text: readBody(o.text ?? ""), ...(repos ? { repos } : {}), check: c } }];
72
+ break;
73
+ }
74
+ case "set": {
75
+ if (!rest[0])
76
+ throw new UsageError("使い方: p3 quality set <Q1> [--text 文] [--repo 名前 ...|all] [--command ... --success ... | --reference ...]");
77
+ const c = check();
78
+ const repos = qualityRepos(o.repos, ws.project.repos.map((r) => r.name));
79
+ ops = [{ op: "edit", id: rest[0], standard: { ...(o.text !== undefined ? { text: readBody(o.text) } : {}), ...(repos ? { repos } : {}), ...(c ? { check: c } : {}) } }];
80
+ break;
81
+ }
82
+ case "rm":
83
+ case "remove":
84
+ if (!rest.length)
85
+ throw new UsageError("使い方: p3 quality rm <Q1> [...]");
86
+ ops = rest.map((id) => ({ op: "remove", id }));
87
+ break;
88
+ case "exempt":
89
+ if (!rest[0] || o.reason === undefined)
90
+ throw new UsageError("使い方: p3 quality exempt <Q1> --reason 理由(理由は必須)");
91
+ ops = [{ op: "exempt", id: rest[0], reason: readBody(o.reason) }];
92
+ break;
93
+ case "unexempt":
94
+ if (!rest[0])
95
+ throw new UsageError("使い方: p3 quality unexempt <Q1>");
96
+ ops = [{ op: "unexempt", id: rest[0] }];
97
+ break;
98
+ default:
99
+ throw new UsageError(`quality の操作は show / templates / template / init / adopt / upgrade / add / set / rm / exempt / unexempt / improve です: ${sub}`);
100
+ }
101
+ const v = await updateQuality(ws, ops, { expectedVersion: o.version });
102
+ return out.result(v, () => formatQuality(v));
103
+ }
104
+ /**
105
+ * 品質基準の対象(--repo を繰り返した全部)。省くと undefined(add は全参照先・set は今の対象のまま)、all は全参照先([])。
106
+ * all と個別の名前は一緒に使えない。同じ名前は1つにまとめる。登録されていない名前は保存の規則(shared/quality.ts)が断る
107
+ */
108
+ export function qualityRepos(raw, repoNames) {
109
+ if (raw === undefined)
110
+ return undefined;
111
+ const names = [...new Set(raw.map((r) => r.trim()))];
112
+ if (names.includes(""))
113
+ throw new UsageError("--repo に参照先の名前を指定してください(全参照先なら --repo all)");
114
+ if (!names.includes("all"))
115
+ return names;
116
+ if (names.length > 1)
117
+ throw new UsageError(`--repo all(全参照先)と個別の参照先(${names.filter((n) => n !== "all").join(", ")})は一緒に指定できません`);
118
+ if (repoNames.includes("all"))
119
+ throw new UsageError("「all」という名前の参照先があるため、--repo all が全参照先か参照先 all かを決められません(画面の品質基準で対象を選んでください)");
120
+ return [];
121
+ }
122
+ /**
123
+ * quality improve [task <要望>/<T> <run> | milestone <ID> <run>] 不足の診断と改善要望の原稿(読むだけ。省くとプロジェクトの設定)
124
+ * --key <不足の鍵>...(省くと既定で選ぶもの)
125
+ * --register --hash <診断の版> [--title 題] [--body 本文|-] [--reopen] 明示して登録する
126
+ */
127
+ async function improveCommand({ ctx, out, o, actor }, rest) {
128
+ const [kind, a, b] = rest;
129
+ let source;
130
+ if (kind === undefined || kind === "project")
131
+ source = { type: "project" };
132
+ else if (kind === "task") {
133
+ const [rid, tid] = (a ?? "").split("/");
134
+ if (!rid || !tid || !b)
135
+ throw new UsageError("使い方: p3 quality improve task <要望>/<T> <run>");
136
+ source = { type: "task-review", request: rid, task: tid, run: b };
137
+ }
138
+ else if (kind === "milestone") {
139
+ if (!a || !b)
140
+ throw new UsageError("使い方: p3 quality improve milestone <ID> <run>");
141
+ source = { type: "milestone-review", milestone: a, run: b };
142
+ }
143
+ else
144
+ throw new UsageError("使い方: p3 quality improve [task <要望>/<T> <run> | milestone <ID> <run>]");
145
+ const d = await diagnoseQuality(ctx, source);
146
+ const keys = o.key?.length ? o.key : d.findings.filter((f) => f.suggested).map((f) => f.key);
147
+ if (!o.register) {
148
+ const draft = keys.length ? improvementDraft(d, keys) : undefined;
149
+ return out.result({ ...d, picked: keys, ...(draft ? { draft } : {}) }, () => [
150
+ `品質の診断(${kind ?? "project"}。版 ${d.hash}):`,
151
+ ...(d.findings.length ? d.findings.map((f) => ` [${keys.includes(f.key) ? "x" : " "}] ${f.key} ${f.reason}${d.registered[f.key] ? ` → 登録済み ${d.registered[f.key].request}(${d.registered[f.key].status ?? "?"})` : ""}`) : [" 不足はありません"]),
152
+ ...d.notes.map((n) => ` ※ ${n}`),
153
+ ...(draft ? ["", `題: ${draft.title}`, "", draft.body, "", `登録するなら: p3 quality improve ${rest.join(" ")} --register --hash ${d.hash}${o.key?.length ? o.key.map((k) => ` --key ${k}`).join("") : ""}`] : []),
154
+ ].join("\n"));
155
+ }
156
+ if (!o.hash)
157
+ throw new UsageError("登録するには、原稿を確かめた診断の版を --hash で渡してください(p3 quality improve で出ます)");
158
+ const draft = improvementDraft(d, keys);
159
+ const r = await registerImprovement(ctx, { source, keys, title: o.title ?? draft.title, body: o.body !== undefined ? readBody(o.body) : draft.body, hash: o.hash, reopenClosed: o.reopen }, actor);
160
+ return out.result(r, () => `要望を登録しました: ${r.request.id} ${r.request.title}(不足 ${r.keys.join(", ")})`);
161
+ }
162
+ export function formatQuality(v) {
163
+ const q = v.quality;
164
+ if (q.state === "unset") {
165
+ return [
166
+ "品質基準: 未設定(このままでも作業は続けられます。p3 quality init は必須ではありません)",
167
+ " 基準を足す: p3 quality add --text 文 (--command コマンド --success 成功の条件 | --reference 確かめ方) [--repo 名前 ...]",
168
+ " テンプレートから: p3 quality adopt basic(一覧は p3 quality templates)",
169
+ " 基準を置かないと決めたことを残す: p3 quality init(意図して空にする。設定済みなら何も変えない)",
170
+ ].join("\n");
171
+ }
172
+ if (q.state === "invalid")
173
+ return ["品質基準: 読めません(project.yaml の quality を直してください。保存しても消しません)", ...q.problems.map((p) => ` - ${p}`)].join("\n");
174
+ const lines = [`品質基準: ${q.config.standards.length} 件(版 ${v.version}${q.config.templates?.length ? `・テンプレート ${q.config.templates.map((t) => `${t.id}@${t.version}`).join(", ")}` : ""})`];
175
+ if (!q.config.standards.length)
176
+ lines.push(" (意図して空にしています)");
177
+ for (const s of q.config.standards) {
178
+ lines.push(` ${s.id} ${s.text}${s.exempt ? " ※除外" : ""}`, ` 対象: ${s.repos?.length ? s.repos.join(", ") : "全参照先"}`, ` ${checkLine(s.check)}`);
179
+ if (s.exempt)
180
+ lines.push(` 除外の理由: ${s.exempt.reason}`);
181
+ }
182
+ for (const w of q.warnings ?? [])
183
+ lines.push(` ⚠ ${w}`);
184
+ for (const d of v.diffs) {
185
+ lines.push(`テンプレート ${d.template} に新しい版があります(${d.from} → ${d.to}。足す ${d.added.length}・変わる ${d.changed.length}・消える ${d.removed.length})。当てるなら p3 quality upgrade ${d.template}`);
186
+ }
187
+ return lines.join("\n");
188
+ }
@@ -7,6 +7,7 @@ export function readsOnly(cmd, args) {
7
7
  const sub = args[0];
8
8
  switch (cmd) {
9
9
  case "whoami":
10
+ case "guide":
10
11
  case "progress":
11
12
  case "ls":
12
13
  case "list":
@@ -15,10 +16,26 @@ export function readsOnly(cmd, args) {
15
16
  case "resolve":
16
17
  case "notes":
17
18
  case "drafts":
19
+ case "clarify":
20
+ case "revisit":
18
21
  return true;
22
+ case "metrics":
23
+ return sub !== "record" && sub !== "rm" && sub !== "remove";
24
+ case "retro":
25
+ case "retrospective":
26
+ return !args.includes("confirm") && !args.includes("judge");
27
+ case "premise":
28
+ case "premises":
29
+ return !args.some((a) => a === "add" || a === "ack");
30
+ case "source":
31
+ case "sources":
32
+ // 対象(要望・T001・D1)と基準の ID の後に操作が無ければ読むだけ
33
+ return !args.some((a) => ["add", "edit", "set", "confirm", "rm", "remove"].includes(a));
19
34
  case "request":
20
35
  case "req":
21
36
  return sub === "ls" || sub === "list" || sub === "show";
37
+ case "quality":
38
+ return sub === undefined || sub === "show" || sub === "templates" || sub === "template";
22
39
  case "milestone":
23
40
  case "milestones":
24
41
  return sub === undefined || sub === "ls" || sub === "list";
@@ -2,6 +2,7 @@ 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";
5
6
  import { REVIEW_STATUS_LABELS, REVIEW_VERDICT_LABELS, REVIEW_VERDICTS } from "../shared/milestoneReview.js";
6
7
  import {} from "../core/context.js";
7
8
  import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, orderChildren, updateRequest } from "../core/requestOps.js";
@@ -11,6 +12,16 @@ import { resolveRequestId } from "../core/ops.js";
11
12
  import { table } from "./format.js";
12
13
  import { requestWorkstreams, taskRepo } from "../shared/workTarget.js";
13
14
  import { briefRequest, formatBriefRequest, formatFamily } from "./showView.js";
15
+ import { formatReview as formatRevisit } from "./revisitCommands.js";
16
+ import { requestReview } from "../core/reviewCandidates.js";
17
+ import { reviewSummary } from "../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
+ }
14
25
  import { UsageError } from "./project.js";
15
26
  import { tagsFrom } from "../shared/tags.js";
16
27
  import { sortMilestones } from "../shared/milestoneOrder.js";
@@ -70,15 +81,18 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
70
81
  const rid = requestArg(rest[0]);
71
82
  const r = ctx.ws.requests.require(rid);
72
83
  const family = await hierarchyView(ctx.ws, rid);
84
+ const review = requestReview(ctx, rid);
73
85
  if (o.brief) {
74
- const view = { ...briefRequest(ctx, r, resolvedIssue(ctx.ws, r)), ...family };
75
- 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"));
76
90
  }
77
91
  const file = relative(process.cwd(), ctx.ws.requests.path(rid));
78
92
  const issue = resolvedIssue(ctx.ws, r);
79
93
  const branches = requestWorkstreams(r);
80
94
  const multi = ctx.ws.project.repos.length > 0;
81
- 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 }, () => {
82
96
  const tasks = ctx.ws.tasksOf(rid).list();
83
97
  return [
84
98
  issue ? `※ ${issue}\n` : "",
@@ -90,7 +104,9 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
90
104
  : []),
91
105
  "",
92
106
  `タスク (${tasks.length}):`,
93
- 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)] : []),
94
110
  ].join("\n");
95
111
  });
96
112
  }
@@ -133,6 +149,8 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
133
149
  const next = await updateRequest(ctx, rid, patch, { expectedRev, actor });
134
150
  warn(next.warnings ?? []);
135
151
  reopenedNote(undefined, next.reopenedAncestors);
152
+ if (next.completionSkipped)
153
+ process.stderr.write(`${next.completionSkipped}\n`);
136
154
  return out.result(next, () => `更新: ${next.id} (rev ${next.rev}) ${Object.keys(patch).join(", ")}`);
137
155
  }
138
156
  case "order": {
@@ -378,6 +396,17 @@ function formatReview(d) {
378
396
  for (const u of result.unplanned)
379
397
  lines.push(` - ${u.text}${u.evidence.length ? `(根拠: ${u.evidence.join(", ")})` : ""}`);
380
398
  }
399
+ const q = input?.quality;
400
+ lines.push("", !q ? "品質: 評価していません(品質基準を材料に入れる前の記録です)" : q.state !== "set" ? `品質: 評価していません(品質基準が${q.state === "unset" ? "未設定" : "読めません"})` : `品質(品質基準 版 ${q.version}。目的の達成とは別):`);
401
+ for (const r of result.quality ?? []) {
402
+ lines.push(` ${r.verdict === "violated" ? "✗" : "・"} ${r.standard} ${QUALITY_VERDICT_LABELS[r.verdict]}${r.regression ? "(品質の低下)" : ""} ${r.reason}`);
403
+ if (r.evidence.length)
404
+ lines.push(` 根拠: ${r.evidence.join(", ")}`);
405
+ if (r.unread)
406
+ lines.push(` 確かめられなかった範囲: ${r.unread}`);
407
+ }
408
+ if (d.run.inputChanged)
409
+ lines.push("※ 実行中に材料が変わりました(結果は始めたときの材料に対するものです)");
381
410
  lines.push("", `範囲: ${result.scope}`);
382
411
  }
383
412
  return lines.join("\n");
@@ -0,0 +1,288 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { resolve as resolvePath } from "node:path";
3
+ import { ANSWER_STATE_LABEL, clarificationStates, criteriaSourceView, requestRequirementView, RequirementInputError, SOURCE_STATE_LABEL, } from "../shared/requirementSource.js";
4
+ import { resolveRequestId } from "../core/ops.js";
5
+ import { saveClarifyAnswer, updateRequirement, updateTask } from "../core/requestOps.js";
6
+ import { NotFoundError } from "../core/store/collection.js";
7
+ import { pickRun } from "./preflightCommands.js";
8
+ import { UsageError } from "./project.js";
9
+ import { formatRequirement, sourceLines } from "./showView.js";
10
+ /**
11
+ * 要求の根拠(出典・確かめた人・日・根拠)と、Preflight の確認事項への回答のコマンド(規則は shared/requirementSource.ts)。
12
+ *
13
+ * source [<要望>] [ls] 要望の根拠の記録と状態(回答も)
14
+ * source [<要望>] add|edit <S>|confirm <S>|rm <S> 要望の根拠の記録を変える
15
+ * source <T001|D1> [<基準>] [add|edit|confirm|rm] 受け入れ基準ごとの記録(D1 はタスク案。--run で run、省くと最新)
16
+ * source <対象> --sources-json ops.json|- 操作をまとめて当てる(複数行の根拠はこちら)
17
+ * clarify [<要望>] [--run <run>] 確認事項(確認先・質問・必要な根拠・判断への影響)と回答の状態
18
+ * answer [<要望>] <Q> --body 回答|- [...] 確認事項に回答する(要望に残す。過去の run は書き換えない)
19
+ * answer [<要望>] <Q> rm 回答を消す
20
+ */
21
+ const SOURCE_SUBS = new Set(["ls", "show", "add", "edit", "set", "confirm", "rm", "remove"]);
22
+ /** 標準入力(-)は1つの項目にだけ */
23
+ function readText(v, flag, used) {
24
+ if (v === undefined)
25
+ return undefined;
26
+ if (v !== "-")
27
+ return v;
28
+ if (used.stdin)
29
+ throw new UsageError(`標準入力(-)は ${used.stdin} と ${flag} のどちらか一方だけに使えます(もう一方はファイルか文字で渡してください)`);
30
+ used.stdin = flag;
31
+ return readFileSync(0, "utf8");
32
+ }
33
+ function readJsonFile(file, flag) {
34
+ let src;
35
+ try {
36
+ src = file === "-" ? readFileSync(0, "utf8") : readFileSync(resolvePath(process.cwd(), file), "utf8");
37
+ }
38
+ catch {
39
+ throw new UsageError(`${flag} のファイルが読めません: ${file}`);
40
+ }
41
+ try {
42
+ return JSON.parse(src);
43
+ }
44
+ catch (e) {
45
+ throw new UsageError(`${flag} が JSON として読めません: ${e.message}`);
46
+ }
47
+ }
48
+ function formatCriteriaSources(head, v, problems = []) {
49
+ const lines = [head];
50
+ if (!v.items.length)
51
+ lines.push(" 受け入れ基準なし");
52
+ for (const i of v.items) {
53
+ lines.push(` ${i.id} [${SOURCE_STATE_LABEL[i.state]}] ${i.text}`);
54
+ for (const s of i.sources)
55
+ lines.push(...sourceLines(s, " "));
56
+ }
57
+ if (v.orphans.length) {
58
+ lines.push(" 対応先不明(基準を消した・参照元が無い):");
59
+ for (const s of v.orphans)
60
+ lines.push(...sourceLines(s, " ").map((l, n) => (n ? l : `${l} 基準 ${s.criterionId}`)));
61
+ }
62
+ for (const p of problems)
63
+ lines.push(` ※読めない: ${p}`);
64
+ return lines.join("\n");
65
+ }
66
+ /** フラグから1つの操作を作る */
67
+ function sourceOpFromFlags(env, sub, id) {
68
+ const { o } = env;
69
+ const used = {};
70
+ const fields = {
71
+ ...(o.target?.length ? { target: o.target.join(" ") } : {}),
72
+ ...(o.source !== undefined ? { source: o.source } : {}),
73
+ ...(o.grounds !== undefined ? { basis: readText(o.grounds, "--grounds", used) } : {}),
74
+ };
75
+ const confirm = o.by !== undefined || o.on !== undefined ? { by: o.by ?? "", on: o.on ?? "" } : undefined;
76
+ const needId = () => {
77
+ if (!id)
78
+ throw new UsageError(`使い方: p3 source ... ${sub} <S1>`);
79
+ return id;
80
+ };
81
+ switch (sub) {
82
+ case "add":
83
+ return { op: "add", ...fields, ...(o.from ? { from: o.from } : {}), ...(confirm ? { confirm } : {}) };
84
+ case "edit":
85
+ case "set":
86
+ return { op: "edit", id: needId(), ...fields, ...(confirm ? { confirm } : {}) };
87
+ case "confirm":
88
+ if (!confirm)
89
+ throw new UsageError("使い方: p3 source ... confirm <S1> --by <確かめた役割・アクター> --on YYYY-MM-DD");
90
+ return { op: "confirm", id: needId(), ...confirm };
91
+ case "rm":
92
+ case "remove":
93
+ return { op: "remove", id: needId() };
94
+ }
95
+ throw new UsageError(`source の操作は add / edit / confirm / rm です: ${sub}`);
96
+ }
97
+ export async function requirementCommand(cmd, env) {
98
+ switch (cmd) {
99
+ case "source":
100
+ case "sources":
101
+ return sourceCommand(env);
102
+ case "clarify":
103
+ return clarifyCommand(env);
104
+ case "answer":
105
+ return answerCommand(env);
106
+ }
107
+ return undefined;
108
+ }
109
+ async function sourceCommand(env) {
110
+ const { args } = env;
111
+ const head = args[0];
112
+ if (head && /^(?:([^/]+)\/)?D\d+$/i.test(head))
113
+ return criterionSources(env, "draft");
114
+ if (head && /^(?:[^/]+\/)?T\d+$/i.test(head))
115
+ return criterionSources(env, "task");
116
+ return requestSources(env);
117
+ }
118
+ async function requestSources(env) {
119
+ const { ctx, out, args, o, actor, expectedRev, requestArg } = env;
120
+ const rid = args[0] && !SOURCE_SUBS.has(args[0]) ? requestArg(args[0]) : requestArg(undefined);
121
+ const rest = args[0] && !SOURCE_SUBS.has(args[0]) ? args.slice(1) : args;
122
+ const [sub, id] = rest;
123
+ const view = () => requestRequirementView(ctx.ws.requests.require(rid));
124
+ const show = () => [`${rid} ${ctx.ws.requests.require(rid).title}`, ...formatRequirement(view())].join("\n");
125
+ const json = o["sources-json"];
126
+ if (json === undefined && (sub === undefined || sub === "ls" || sub === "show"))
127
+ return out.result({ request: rid, ...view() }, show);
128
+ let ops;
129
+ if (json !== undefined) {
130
+ if (sub !== undefined)
131
+ throw new UsageError("--sources-json と add / edit などの操作は一緒に使えません");
132
+ const raw = readJsonFile(json, "--sources-json");
133
+ if (!Array.isArray(raw))
134
+ throw new UsageError("--sources-json は操作の並び([{\"op\":\"add\",...}])です");
135
+ ops = raw;
136
+ }
137
+ else
138
+ ops = [sourceOpFromFlags(env, sub, id)];
139
+ const r = await updateRequirement(ctx, rid, ops, { expectedRev, actor });
140
+ return out.result({ request: rid, rev: r.rev, ...requestRequirementView(r) }, () => [`更新: ${rid} (rev ${r.rev})`, ...formatRequirement(requestRequirementView(r))].join("\n"));
141
+ }
142
+ async function criterionSources(env, kind) {
143
+ const { ctx, out, args, o, actor, expectedRev, taskArg, requestArg } = env;
144
+ const [target, ...after] = args;
145
+ // 基準の ID(A1)は省ける(一覧だけ)
146
+ const criterion = after[0] && !SOURCE_SUBS.has(after[0]) ? after[0] : undefined;
147
+ const [sub, id] = criterion ? after.slice(1) : after;
148
+ const json = o["sources-json"];
149
+ const listOnly = json === undefined && (sub === undefined || sub === "ls" || sub === "show");
150
+ let ops = [];
151
+ if (!listOnly) {
152
+ if (json !== undefined) {
153
+ if (sub !== undefined)
154
+ throw new UsageError("--sources-json と add / edit などの操作は一緒に使えません");
155
+ const raw = readJsonFile(json, "--sources-json");
156
+ if (!Array.isArray(raw))
157
+ throw new UsageError("--sources-json は操作の並び([{\"criterion\":\"A1\",\"op\":\"add\",...}])です");
158
+ ops = raw.map((x, i) => {
159
+ const { criterion: c, ...op } = (x && typeof x === "object" ? x : {});
160
+ const cid = c ?? criterion;
161
+ if (!cid)
162
+ throw new UsageError(`--sources-json の ${i + 1} 件目に基準の ID(criterion)がありません`);
163
+ return { id: cid, source: op };
164
+ });
165
+ }
166
+ else {
167
+ if (!criterion)
168
+ throw new UsageError(`使い方: p3 source ${target} <基準の ID> ${sub} ...`);
169
+ ops = [{ id: criterion, source: sourceOpFromFlags(env, sub, id) }];
170
+ }
171
+ }
172
+ if (kind === "task") {
173
+ const ref = taskArg(target);
174
+ const rid = ref.split("/")[0];
175
+ const reqIds = () => (ctx.ws.requests.get(rid)?.requirementSources ?? []).map((s) => s.id);
176
+ const render = (t) => criteriaSourceView(t.acceptanceCriteria, t.acceptanceSources, reqIds());
177
+ if (listOnly) {
178
+ const t = ctx.ws.requireTask(ref);
179
+ const v = render(t);
180
+ return out.result({ ref: t.ref, rev: t.rev, ...v, problems: t.acceptanceProblems ?? [] }, () => formatCriteriaSources(`${t.ref} ${t.title} の基準ごとの出典と確認`, v, t.acceptanceProblems));
181
+ }
182
+ const acceptance = ops.map((x) => ({ op: "source", id: x.id, source: x.source }));
183
+ const r = await updateTask(ctx, rid, ref.split("/")[1], { acceptance }, { expectedRev, actor });
184
+ if (r.checkCleared)
185
+ process.stderr.write(`${r.checkCleared}\n`);
186
+ const v = render(r.task);
187
+ return out.result({ ref: r.task.ref, rev: r.task.rev, ...v, ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => formatCriteriaSources(`更新: ${r.task.ref} (rev ${r.task.rev})`, v));
188
+ }
189
+ // タスク案
190
+ const m = /^(?:([^/]+)\/)?(D\d+)$/i.exec(target);
191
+ const rid = m[1] ? resolveRequestId(ctx, m[1]) : requestArg(undefined);
192
+ if (!rid)
193
+ throw new NotFoundError(m[1] ?? "要望");
194
+ const key = m[2].toUpperCase();
195
+ const run = await pickRun(ctx, rid, o.run);
196
+ const d = run.drafts.find((x) => x.key === key);
197
+ if (!d)
198
+ throw new NotFoundError(`${run.id}/${key}`);
199
+ const reqIds = (ctx.ws.requests.get(rid)?.requirementSources ?? []).map((s) => s.id);
200
+ const head = (x) => `${rid} / ${run.id} / ${x.key} ${x.title} の基準ごとの出典と確認`;
201
+ if (listOnly) {
202
+ const v = criteriaSourceView(d.acceptanceCriteria, d.acceptanceSources, reqIds);
203
+ return out.result({ request: rid, run: run.id, key, ...v, problems: d.acceptanceProblems ?? [] }, () => formatCriteriaSources(head(d), v, d.acceptanceProblems));
204
+ }
205
+ if (run.materialized?.length || run.children)
206
+ throw new UsageError(`${run.id} はタスク化済みか子の要望の案の run です(タスクの記録は p3 source <T>)`);
207
+ const saved = await ctx.preflight.updateDraft(rid, run.id, key, { sourceOps: ops }, { expectedSources: d.acceptanceSources ?? [], actor });
208
+ const v = criteriaSourceView(saved.acceptanceCriteria, saved.acceptanceSources, reqIds);
209
+ return out.result({ request: rid, run: run.id, key, ...v, problems: saved.acceptanceProblems ?? [] }, () => formatCriteriaSources(head(saved), v, saved.acceptanceProblems));
210
+ }
211
+ /** 要望と run の確認事項(構造化した確認事項が無い以前の run は文の確認事項だけ) */
212
+ async function runClarifications(env, raw) {
213
+ const { ctx, o, requestArg } = env;
214
+ const rid = requestArg(raw);
215
+ const run = await pickRun(ctx, rid, o.run);
216
+ return { rid, run, clarifications: run.assessment?.clarifications ?? [] };
217
+ }
218
+ async function clarifyCommand(env) {
219
+ const { ctx, out, args } = env;
220
+ if (args.length > 1)
221
+ throw new UsageError("使い方: p3 clarify [<要望>] [--run <run>]");
222
+ const { rid, run, clarifications } = await runClarifications(env, args[0]);
223
+ const r = ctx.ws.requests.require(rid);
224
+ const items = clarificationStates(run.id, clarifications, r.clarifyAnswers, r.requirementSources);
225
+ const questions = run.assessment?.questions ?? [];
226
+ const problems = run.assessment?.clarificationProblems ?? [];
227
+ return out.result({ request: rid, run: run.id, verdict: run.assessment?.verdict ?? null, items, questions, problems }, () => {
228
+ const lines = [`${rid} / ${run.id} 判定 ${run.assessment?.verdict ?? "(評価なし)"}`];
229
+ if (!items.length)
230
+ lines.push("構造化した確認事項はありません(以前の run か、確認事項なし)");
231
+ for (const i of items) {
232
+ const q = i.clarification;
233
+ lines.push(` ${q.id} [${ANSWER_STATE_LABEL[i.state]}] ${q.question}`, ` 確認先: ${q.ask}`, ` 対象: ${q.target}`, ...(q.needed ? [` 必要な根拠: ${q.needed}`] : []), ...(q.impact ? [` 判断への影響: ${q.impact}`] : []), ...(i.answer ? [` 回答${i.answer.by || i.answer.on ? `(${[i.answer.by, i.answer.on].filter(Boolean).join("・")})` : ""}: ${i.answer.answer.split("\n").join("\n ")}`] : []));
234
+ }
235
+ if (questions.length)
236
+ lines.push("確認事項(文):", ...questions.map((x) => ` - ${x}`));
237
+ for (const p of problems)
238
+ lines.push(` ※読めない確認事項: ${p}`);
239
+ if (items.length)
240
+ lines.push(`回答: p3 answer ${rid} <Q> --body <回答> [--by <役割> --on YYYY-MM-DD --source <出典> --grounds <根拠> --link <S1>] --run ${run.id}`);
241
+ lines.push(`回答を保存したら、明示して再評価します: p3 preflight ${rid}`);
242
+ return lines.join("\n");
243
+ });
244
+ }
245
+ async function answerCommand(env) {
246
+ const { ctx, out, args, o, actor, expectedRev } = env;
247
+ // answer [<要望>] <Q> [rm]
248
+ const looksQ = (x) => !!x && /^[A-Za-z0-9._-]{1,32}$/.test(x) && !resolveRequestId(ctx, x);
249
+ const [a0, a1, a2] = args;
250
+ const [rawRid, qid, tail] = looksQ(a0) ? [undefined, a0, a1] : [a0, a1, a2];
251
+ if (!qid)
252
+ throw new UsageError("使い方: p3 answer [<要望>] <Q1> --body 回答|- [--by <役割> --on YYYY-MM-DD --source <出典> --grounds <根拠> --link <S1>] [--run <run>]");
253
+ const { rid, run, clarifications } = await runClarifications(env, rawRid);
254
+ const q = clarifications.find((x) => x.id === qid);
255
+ if (!q)
256
+ throw new UsageError(`${run.id} に確認事項 ${qid} はありません${clarifications.length ? `(${clarifications.map((x) => x.id).join(", ")})` : "(構造化した確認事項がありません。以前の run の文の確認事項にはメモで答えます: p3 note)"}`);
257
+ if (tail === "rm" || tail === "remove") {
258
+ const r = await saveClarifyAnswer(ctx, rid, run.id, q, null, { expectedRev, actor });
259
+ return out.result({ request: rid, rev: r.request.rev, run: run.id, question: q.id, removed: true }, () => `回答を消しました: ${rid} ${run.id}/${q.id}`);
260
+ }
261
+ if (tail !== undefined)
262
+ throw new UsageError(`answer の操作は rm だけです: ${tail}`);
263
+ let input;
264
+ if (o["answer-json"] !== undefined) {
265
+ if (o.body !== undefined || o.grounds !== undefined)
266
+ throw new UsageError("--answer-json と --body / --grounds は一緒に使えません");
267
+ const raw = readJsonFile(o["answer-json"], "--answer-json");
268
+ if (!raw || typeof raw !== "object" || Array.isArray(raw))
269
+ throw new UsageError("--answer-json は {\"answer\": ..., \"by\": ..., \"on\": ..., \"source\": ..., \"basis\": ..., \"links\": [...]} の形です");
270
+ input = raw;
271
+ }
272
+ else {
273
+ const used = {};
274
+ const answer = readText(o.body, "--body", used);
275
+ if (answer === undefined)
276
+ throw new UsageError("回答を --body で書いてください(複数行は --body - か --answer-json)");
277
+ input = { answer, by: o.by, on: o.on, source: o.source, basis: readText(o.grounds, "--grounds", used), links: o.link };
278
+ }
279
+ try {
280
+ const r = await saveClarifyAnswer(ctx, rid, run.id, q, input, { expectedRev, actor });
281
+ return out.result({ request: rid, rev: r.request.rev, run: run.id, question: q.id, answer: r.answer ?? null }, () => [`回答を要望に残しました: ${rid} ${run.id}/${q.id}(rev ${r.request.rev})`, "回答だけでは根拠の記録を「確認記録あり」にしません(確認は p3 source ... confirm)", `今の内容で評価し直すなら: p3 preflight ${rid}`].join("\n"));
282
+ }
283
+ catch (e) {
284
+ if (e instanceof RequirementInputError)
285
+ throw new UsageError(e.message);
286
+ throw e;
287
+ }
288
+ }