@infodb/p3 0.12.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.
- package/README.md +32 -35
- package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
- package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
- package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
- package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
- package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
- package/dist/web/assets/TagInput-B2b862qn.js +1 -0
- package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
- package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
- package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
- package/dist/web/assets/archive-DMl6WyOe.js +1 -0
- package/dist/web/assets/board-BMTcHKyt.js +1 -0
- package/dist/web/assets/done-CL6Nlsua.js +1 -0
- package/dist/web/assets/draft-BvGxfD7v.js +2 -0
- package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
- package/dist/web/assets/index-KdlgMitg.js +12 -0
- package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
- package/dist/web/assets/new-DTXWHuFO.js +1 -0
- package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
- package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
- package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
- package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
- package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
- package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
- package/dist/web/assets/routes-BIt8bExF.js +6 -0
- package/dist/web/assets/settings-CsCqF_1B.js +1 -0
- package/dist/web/assets/ui-BGK72r3u.js +1 -0
- package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +300 -36
- package/docs/development.md +60 -16
- package/docs/how-to-use.md +381 -28
- package/docs/installation.md +235 -144
- package/docs/publishing.md +1 -1
- package/lib/cli/agentsStatus.js +197 -0
- package/lib/cli/args.js +72 -8
- package/lib/cli/guide.js +27 -0
- package/lib/cli/guide.md +214 -0
- package/lib/cli/help.js +44 -6
- package/lib/cli/main.js +76 -20
- package/lib/cli/metricsCommands.js +77 -0
- package/lib/cli/output.js +12 -2
- package/lib/cli/project.js +13 -27
- package/lib/cli/qualityCommands.js +33 -8
- package/lib/cli/readOnly.js +15 -0
- package/lib/cli/requestCommands.js +21 -4
- package/lib/cli/requirementCommands.js +288 -0
- package/lib/cli/retroCommands.js +106 -0
- package/lib/cli/revisitCommands.js +73 -0
- package/lib/cli/showView.js +119 -6
- package/lib/cli/taskCommands.js +42 -16
- package/lib/cli/userConfig.js +47 -0
- package/lib/core/completionRefs.js +46 -0
- package/lib/core/metrics/definitions.js +434 -0
- package/lib/core/metrics/index.js +88 -0
- package/lib/core/metrics/manual.js +180 -0
- package/lib/core/ops.js +15 -2
- package/lib/core/preflight/carryover.js +5 -1
- package/lib/core/preflight/codexEngine.js +34 -17
- package/lib/core/preflight/diagnose.js +4 -9
- package/lib/core/preflight/engine.js +9 -0
- package/lib/core/preflight/hostPaths.js +260 -0
- package/lib/core/preflight/input.js +33 -5
- package/lib/core/preflight/instructions.js +18 -1
- package/lib/core/preflight/mockEngine.js +20 -2
- package/lib/core/preflight/render.js +22 -3
- package/lib/core/preflight/service.js +59 -9
- package/lib/core/preflight/uiRender.js +3 -0
- package/lib/core/requestOps.js +206 -14
- package/lib/core/retrospective.js +208 -0
- package/lib/core/reviewCandidates.js +56 -0
- package/lib/core/store/collection.js +20 -1
- package/lib/core/store/normalize.js +22 -4
- package/lib/core/store/preflightStore.js +19 -5
- package/lib/core/store/workspace.js +17 -1
- package/lib/core/taskReview/material.js +7 -0
- package/lib/core/taskReview/review.js +9 -2
- package/lib/server/api/manifest.js +51 -3
- package/lib/server/api/routes.js +131 -11
- package/lib/shared/acceptance.js +258 -18
- package/lib/shared/completionRecord.js +327 -0
- package/lib/shared/metrics.js +42 -0
- package/lib/shared/preflightInput.js +1 -1
- package/lib/shared/requirementSource.js +635 -0
- package/lib/shared/retrospective.js +286 -0
- package/lib/shared/reviewCandidate.js +308 -0
- package/lib/shared/reworkHistory.js +81 -0
- package/package.json +3 -2
- package/skills/p3/SKILL.md +9 -181
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
- package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
- package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
- package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
- package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
- package/dist/web/assets/_requestId-BykTgPax.js +0 -1
- package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
- package/dist/web/assets/archive-Ckh295Xe.js +0 -1
- package/dist/web/assets/board-BVAIjK-Y.js +0 -1
- package/dist/web/assets/done-BGfA-3MA.js +0 -1
- package/dist/web/assets/draft-CfJeyLOl.js +0 -1
- package/dist/web/assets/index-CgRU744I.css +0 -2
- package/dist/web/assets/index-DacQ0yl4.js +0 -12
- package/dist/web/assets/new-DVygWvVc.js +0 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
- package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
- package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
- package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
- package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
- package/dist/web/assets/routes-Q91zvNc0.js +0 -4
- package/dist/web/assets/settings-BzRgcmUm.js +0 -1
- package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
|
@@ -8,10 +8,11 @@ import { UsageError } from "./project.js";
|
|
|
8
8
|
* 品質基準(core/quality.ts。画面の設定の「品質基準」と同じ)。
|
|
9
9
|
* quality 今の設定(未設定・設定済み・読めない)とテンプレートの改版の差分
|
|
10
10
|
* quality templates / quality template <id> 同梱のテンプレートの一覧・中身
|
|
11
|
-
* quality init
|
|
11
|
+
* quality init 空の品質基準を設定する(意図して空。必須ではなく、設定済みなら内容は変えない)
|
|
12
12
|
* quality adopt <テンプレート> テンプレートを写して採用する / quality upgrade <テンプレート> 改版の差分を当てる
|
|
13
13
|
* quality add --text 文 [--repo 名前]... (--command コマンド --success 成功の条件 | --reference 確かめ方)
|
|
14
|
-
* quality set <Q1> [--text] [--repo]... [--command --success | --reference] quality rm <Q1>
|
|
14
|
+
* quality set <Q1> [--text] [--repo 名前|all]... [--command --success | --reference] quality rm <Q1>
|
|
15
|
+
* --repo は繰り返して複数の参照先を指定する(qualityRepos)。add で省くと全参照先、set で省くと対象は変えない
|
|
15
16
|
* quality exempt <Q1> --reason 理由 / quality unexempt <Q1>
|
|
16
17
|
* 変える操作は --version <版>(quality --json の version)を付けると、違えば競合(終了コード 3)
|
|
17
18
|
*/
|
|
@@ -45,6 +46,8 @@ export async function qualityCommand(env) {
|
|
|
45
46
|
return { kind: "machine", command: o.command ?? "", success: o.success ?? "" };
|
|
46
47
|
return undefined;
|
|
47
48
|
};
|
|
49
|
+
if (o.repos !== undefined && sub !== "add" && sub !== "set")
|
|
50
|
+
throw new UsageError(`--repo は p3 quality add / set でだけ使えます(${sub} は対象を取りません)`);
|
|
48
51
|
let ops;
|
|
49
52
|
switch (sub) {
|
|
50
53
|
case "init":
|
|
@@ -64,14 +67,16 @@ export async function qualityCommand(env) {
|
|
|
64
67
|
const c = check();
|
|
65
68
|
if (!c)
|
|
66
69
|
throw new UsageError("確認の方法を指定してください: --command <コマンド> --success <成功の条件>(機械の検査)か --reference <確かめ方>(人の確認)");
|
|
67
|
-
|
|
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 } }];
|
|
68
72
|
break;
|
|
69
73
|
}
|
|
70
74
|
case "set": {
|
|
71
75
|
if (!rest[0])
|
|
72
|
-
throw new UsageError("使い方: p3 quality set <Q1> [--text 文] [--repo
|
|
76
|
+
throw new UsageError("使い方: p3 quality set <Q1> [--text 文] [--repo 名前 ...|all] [--command ... --success ... | --reference ...]");
|
|
73
77
|
const c = check();
|
|
74
|
-
|
|
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 } : {}) } }];
|
|
75
80
|
break;
|
|
76
81
|
}
|
|
77
82
|
case "rm":
|
|
@@ -96,6 +101,24 @@ export async function qualityCommand(env) {
|
|
|
96
101
|
const v = await updateQuality(ws, ops, { expectedVersion: o.version });
|
|
97
102
|
return out.result(v, () => formatQuality(v));
|
|
98
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
|
+
}
|
|
99
122
|
/**
|
|
100
123
|
* quality improve [task <要望>/<T> <run> | milestone <ID> <run>] 不足の診断と改善要望の原稿(読むだけ。省くとプロジェクトの設定)
|
|
101
124
|
* --key <不足の鍵>...(省くと既定で選ぶもの)
|
|
@@ -140,8 +163,10 @@ export function formatQuality(v) {
|
|
|
140
163
|
const q = v.quality;
|
|
141
164
|
if (q.state === "unset") {
|
|
142
165
|
return [
|
|
143
|
-
"品質基準:
|
|
144
|
-
"
|
|
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(意図して空にする。設定済みなら何も変えない)",
|
|
145
170
|
].join("\n");
|
|
146
171
|
}
|
|
147
172
|
if (q.state === "invalid")
|
|
@@ -150,7 +175,7 @@ export function formatQuality(v) {
|
|
|
150
175
|
if (!q.config.standards.length)
|
|
151
176
|
lines.push(" (意図して空にしています)");
|
|
152
177
|
for (const s of q.config.standards) {
|
|
153
|
-
lines.push(` ${s.id} ${s.text}${s.
|
|
178
|
+
lines.push(` ${s.id} ${s.text}${s.exempt ? " ※除外" : ""}`, ` 対象: ${s.repos?.length ? s.repos.join(", ") : "全参照先"}`, ` ${checkLine(s.check)}`);
|
|
154
179
|
if (s.exempt)
|
|
155
180
|
lines.push(` 除外の理由: ${s.exempt.reason}`);
|
|
156
181
|
}
|
package/lib/cli/readOnly.js
CHANGED
|
@@ -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,7 +16,21 @@ 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";
|
|
@@ -12,6 +12,16 @@ 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 { 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
|
+
}
|
|
15
25
|
import { UsageError } from "./project.js";
|
|
16
26
|
import { tagsFrom } from "../shared/tags.js";
|
|
17
27
|
import { sortMilestones } from "../shared/milestoneOrder.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
|
-
|
|
76
|
-
|
|
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,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
|
+
}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { ADOPTION_KIND_LABEL, EVIDENCE_CHECK_LABEL, isRiskState, RETRO_EVIDENCE_LABEL, RISK_STATE_LABEL, RISK_STATES, } from "../shared/retrospective.js";
|
|
3
|
+
import { confirmRetrospectiveTarget, judgeRisk, retrospectiveView } from "../core/retrospective.js";
|
|
4
|
+
import { UsageError } from "./project.js";
|
|
5
|
+
/**
|
|
6
|
+
* 要望の振り返り(Preflight で心配したリスクが実装の後に起きたか)のコマンド(規則は shared/retrospective.ts)。
|
|
7
|
+
*
|
|
8
|
+
* retro [<要望>] 振り返りの対象(確定した run・リスク)と候補(採用済みの run と根拠)
|
|
9
|
+
* retro [<要望>] confirm <run> [--reason 理由] 対象を確定する(2回目からは訂正で理由が要る。--rev で版を照らす)
|
|
10
|
+
* retro [<要望>] judge <リスクの番号> --state occurred|not_occurred|unchecked [--facts 事実] [--scope 範囲] [--reason 理由]
|
|
11
|
+
* --evidence review:T001:<run>:<項目>[:<位置>] | milestone:<ID>:<run>:<項目>[:<位置>][:<結び付く理由>] | rework:T001:R1 | manual:<参照>
|
|
12
|
+
* (繰り返し可)/ --evidence-json 根拠.json|- リスクの確認を記録する(人の判断。根拠だけなら unchecked のまま結び付ける)
|
|
13
|
+
*/
|
|
14
|
+
/** 根拠の指定の文字列を読む */
|
|
15
|
+
export function parseEvidenceSpec(spec) {
|
|
16
|
+
const [kind, ...rest] = spec.split(":");
|
|
17
|
+
const num = (v) => (v === undefined || v === "" ? undefined : Number.isInteger(Number(v)) ? Number(v) : NaN);
|
|
18
|
+
if (kind === "manual" && rest.join(":").trim())
|
|
19
|
+
return { kind: "manual", reference: rest.join(":").trim() };
|
|
20
|
+
if (kind === "rework" && rest.length === 2)
|
|
21
|
+
return { kind: "rework", task: rest[0], history: rest[1] };
|
|
22
|
+
if (kind === "review" && rest.length >= 3 && !Number.isNaN(num(rest[3])))
|
|
23
|
+
return { kind: "task_review", task: rest[0], run: rest[1], section: rest[2], index: num(rest[3]) };
|
|
24
|
+
if (kind === "milestone" && rest.length >= 3 && !Number.isNaN(num(rest[3])))
|
|
25
|
+
return { kind: "milestone_review", milestone: rest[0], run: rest[1], section: rest[2], index: num(rest[3]), ...(rest.length > 4 ? { reason: rest.slice(4).join(":") } : {}) };
|
|
26
|
+
throw new UsageError(`根拠の指定が読めません: ${spec}(review:T001:<run>:<項目>[:<位置>] / milestone:<ID>:<run>:<項目>[:<位置>][:<理由>] / rework:T001:R1 / manual:<参照>)`);
|
|
27
|
+
}
|
|
28
|
+
const evidenceLine = (e, check) => {
|
|
29
|
+
const where = e.kind === "task_review" ? `${e.request}/${e.task} ${e.run} ${e.section}[${e.index}]` : e.kind === "milestone_review" ? `${e.milestone} ${e.run} ${e.section}[${e.index}]${e.inputChanged ? "(実行中に材料が変わった)" : ""}` : e.kind === "rework" ? `${e.request}/${e.task} ${e.history}` : e.reference;
|
|
30
|
+
const text = e.kind === "manual" ? (e.note ?? "") : e.excerpt;
|
|
31
|
+
return `${RETRO_EVIDENCE_LABEL[e.kind]} ${where}${check ? ` [${EVIDENCE_CHECK_LABEL[check]}]` : ""}${text ? `\n 当時の抜粋: ${text}` : ""}${e.kind === "milestone_review" && e.reason ? `\n 結び付く理由: ${e.reason}` : ""}`;
|
|
32
|
+
};
|
|
33
|
+
const judgmentLines = (j, checks) => [
|
|
34
|
+
` ${j.id} ${RISK_STATE_LABEL[j.state]} ${j.at} ${j.by ?? ""}${j.reason ? ` 理由: ${j.reason}` : ""}`,
|
|
35
|
+
...(j.facts ? [` 事実: ${j.facts}`] : []),
|
|
36
|
+
...(j.scope ? [` 範囲: ${j.scope}`] : []),
|
|
37
|
+
...j.evidence.map((e, i) => ` 根拠: ${evidenceLine(e, checks?.[i])}`),
|
|
38
|
+
];
|
|
39
|
+
const basisLine = (b) => `${b.key ? `${b.key}→` : ""}${b.target}${b.state === "present" ? "" : `(${{ archived: "アーカイブ済み", missing: "見つからない", mismatch: "採用元が合わない" }[b.state]})`}`;
|
|
40
|
+
export function formatTarget(t) {
|
|
41
|
+
return [
|
|
42
|
+
`${t.id} ${t.run} ${ADOPTION_KIND_LABEL[t.kind]} ${t.at} ${t.by ?? ""}${t.replaces ? ` (${t.replaces} を訂正: ${t.reason ?? ""})` : ""}`,
|
|
43
|
+
` 評価の版 ${t.assessmentVersion} 根拠: ${t.basis.map(basisLine).join(", ")}`,
|
|
44
|
+
...(t.risks.length ? t.risks.map((r) => ` リスク ${r.index + 1}: ${r.text}`) : [" リスクなし"]),
|
|
45
|
+
];
|
|
46
|
+
}
|
|
47
|
+
export function formatRetro(v) {
|
|
48
|
+
const lines = [v.target ? "振り返りの対象:" : "振り返りの対象: 未確定(p3 retro confirm <run> で確定する)"];
|
|
49
|
+
if (v.target) {
|
|
50
|
+
lines.push(` ${formatTarget(v.target)[0]}`, ` 評価の版 ${v.target.assessmentVersion}`);
|
|
51
|
+
lines.push("", `リスクの確認(人の判断。起きた ${v.counts.occurred}・起きなかった ${v.counts.not_occurred}・未確認 ${v.counts.unchecked}):`);
|
|
52
|
+
if (!v.risks.length)
|
|
53
|
+
lines.push(" リスクなし(評価にリスクがありませんでした)");
|
|
54
|
+
for (const r of v.risks) {
|
|
55
|
+
lines.push(` ${r.index + 1}. [${RISK_STATE_LABEL[r.state]}] ${r.text}`);
|
|
56
|
+
for (const j of r.history)
|
|
57
|
+
lines.push(...judgmentLines(j, v.checks[j.id]));
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
if (v.targets.length > 1)
|
|
61
|
+
lines.push("", "前の対象(訂正の履歴):", ...v.targets.slice(0, -1).flatMap((t) => formatTarget(t).slice(0, 1).map((l) => ` ${l}`)));
|
|
62
|
+
lines.push("", "候補(採用を終えた Preflight。新しい順):");
|
|
63
|
+
if (!v.candidates.length)
|
|
64
|
+
lines.push(` なし: ${v.none ?? ""}`);
|
|
65
|
+
for (const c of v.candidates)
|
|
66
|
+
lines.push(` ${c.run} ${ADOPTION_KIND_LABEL[c.kind]}${c.latest ? " 最新" : ""}${v.target?.run === c.run ? " ← 対象" : ""} リスク ${c.risks} 根拠: ${c.basis.map(basisLine).join(", ")}`);
|
|
67
|
+
return lines.join("\n");
|
|
68
|
+
}
|
|
69
|
+
export async function retroCommand(cmd, env) {
|
|
70
|
+
if (cmd !== "retro" && cmd !== "retrospective")
|
|
71
|
+
return undefined;
|
|
72
|
+
const { ctx, out, args, o, actor, expectedRev, requestArg } = env;
|
|
73
|
+
const subs = new Set(["show", "confirm", "judge"]);
|
|
74
|
+
const explicit = args[0] && !subs.has(args[0]) ? args[0] : undefined;
|
|
75
|
+
const rid = requestArg(explicit);
|
|
76
|
+
const rest = explicit ? args.slice(1) : args;
|
|
77
|
+
const sub = rest[0] ?? "show";
|
|
78
|
+
if (sub === "show") {
|
|
79
|
+
const v = await retrospectiveView(ctx, rid);
|
|
80
|
+
return out.result(v, () => formatRetro(v));
|
|
81
|
+
}
|
|
82
|
+
if (sub === "confirm") {
|
|
83
|
+
const run = rest[1];
|
|
84
|
+
if (!run)
|
|
85
|
+
throw new UsageError("p3 retro [<要望>] confirm <run> [--reason 理由](run は p3 retro の候補から)");
|
|
86
|
+
const v = await confirmRetrospectiveTarget(ctx, rid, { run, reason: o.reason }, { expectedVersion: expectedRev, actor });
|
|
87
|
+
return out.result(v, () => `確定しました(版 ${v.version})\n${formatRetro(v)}`);
|
|
88
|
+
}
|
|
89
|
+
if (sub === "judge") {
|
|
90
|
+
const no = Number(rest[1]);
|
|
91
|
+
if (!Number.isInteger(no) || no < 1)
|
|
92
|
+
throw new UsageError("p3 retro [<要望>] judge <リスクの番号(1 から)> --state occurred|not_occurred|unchecked ...");
|
|
93
|
+
if (!isRiskState(o.state))
|
|
94
|
+
throw new UsageError(`--state は ${RISK_STATES.join(" / ")} です`);
|
|
95
|
+
const evidence = (o.evidence ?? []).map(parseEvidenceSpec);
|
|
96
|
+
if (o["evidence-json"]) {
|
|
97
|
+
const raw = JSON.parse(readFileSync(o["evidence-json"] === "-" ? 0 : o["evidence-json"], "utf8"));
|
|
98
|
+
if (!Array.isArray(raw))
|
|
99
|
+
throw new UsageError("--evidence-json は根拠の並び([{kind: task_review|milestone_review|rework|manual, ...}])にしてください");
|
|
100
|
+
evidence.push(...raw);
|
|
101
|
+
}
|
|
102
|
+
const v = await judgeRisk(ctx, rid, { risk: no - 1, state: o.state, facts: o.facts, scope: o.scope, reason: o.reason, evidence }, { expectedVersion: expectedRev, actor });
|
|
103
|
+
return out.result(v, () => `記録しました(版 ${v.version})\n${formatRetro(v)}`);
|
|
104
|
+
}
|
|
105
|
+
throw new UsageError("p3 retro [<要望>] [show | confirm <run> | judge <番号>]");
|
|
106
|
+
}
|