@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.
- package/README.md +33 -33
- 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-RFd-7k3r.js +1 -0
- 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/taskReview-_WCgnQit.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 +610 -33
- package/docs/development.md +61 -17
- package/docs/how-to-use.md +554 -17
- package/docs/installation.md +235 -144
- package/docs/publishing.md +1 -1
- package/lib/cli/agentsStatus.js +197 -0
- package/lib/cli/args.js +111 -2
- package/lib/cli/guide.js +27 -0
- package/lib/cli/guide.md +214 -0
- package/lib/cli/help.js +74 -1
- package/lib/cli/main.js +97 -17
- package/lib/cli/metricsCommands.js +77 -0
- package/lib/cli/output.js +19 -1
- package/lib/cli/preflightCommands.js +7 -1
- package/lib/cli/project.js +13 -24
- package/lib/cli/qualityCommands.js +188 -0
- package/lib/cli/readOnly.js +17 -0
- package/lib/cli/requestCommands.js +33 -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 +183 -4
- package/lib/cli/taskCommands.js +341 -20
- package/lib/cli/taskReviewCommands.js +178 -0
- package/lib/cli/userConfig.js +47 -0
- package/lib/core/completionRefs.js +46 -0
- package/lib/core/context.js +4 -1
- 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/milestoneReview/material.js +11 -1
- package/lib/core/milestoneReview/mockReviewer.js +1 -0
- package/lib/core/milestoneReview/review.js +70 -6
- package/lib/core/milestoneReview/service.js +29 -93
- package/lib/core/milestoneReview/store.js +12 -62
- package/lib/core/ops.js +23 -3
- package/lib/core/preflight/carryover.js +6 -2
- package/lib/core/preflight/codexEngine.js +34 -17
- package/lib/core/preflight/diagnose.js +4 -9
- package/lib/core/preflight/engine.js +15 -0
- package/lib/core/preflight/hostPaths.js +260 -0
- package/lib/core/preflight/input.js +33 -5
- package/lib/core/preflight/instructions.js +36 -2
- package/lib/core/preflight/mockEngine.js +24 -2
- package/lib/core/preflight/render.js +22 -3
- package/lib/core/preflight/service.js +99 -8
- package/lib/core/preflight/uiRender.js +3 -0
- package/lib/core/projectRegistry.js +3 -3
- package/lib/core/quality.js +21 -0
- package/lib/core/qualityImprovement.js +221 -0
- package/lib/core/requestOps.js +294 -11
- package/lib/core/retrospective.js +208 -0
- package/lib/core/reviewCandidates.js +56 -0
- package/lib/core/reviewRuns.js +205 -0
- package/lib/core/store/archivedTasks.js +74 -0
- package/lib/core/store/collection.js +32 -3
- package/lib/core/store/normalize.js +35 -2
- package/lib/core/store/preflightStore.js +23 -1
- package/lib/core/store/projectFile.js +10 -0
- package/lib/core/store/workspace.js +49 -3
- package/lib/core/taskReview/material.js +459 -0
- package/lib/core/taskReview/mockReviewer.js +30 -0
- package/lib/core/taskReview/paths.js +15 -0
- package/lib/core/taskReview/review.js +312 -0
- package/lib/core/taskReview/service.js +187 -0
- package/lib/core/taskReview/store.js +214 -0
- package/lib/server/api/manifest.js +104 -5
- package/lib/server/api/milestoneReviewRoutes.js +4 -3
- package/lib/server/api/routes.js +265 -17
- package/lib/server/api/taskReviewRoutes.js +66 -0
- package/lib/server/server.js +2 -2
- package/lib/shared/acceptance.js +618 -0
- package/lib/shared/completionRecord.js +327 -0
- package/lib/shared/metrics.js +42 -0
- package/lib/shared/milestoneReview.js +2 -1
- package/lib/shared/preflightInput.js +1 -1
- package/lib/shared/quality.js +391 -0
- package/lib/shared/qualityImprovement.js +1 -0
- package/lib/shared/qualityTemplates.js +31 -0
- 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/lib/shared/taskBlock.js +142 -0
- package/lib/shared/taskReview.js +56 -0
- package/package.json +3 -2
- package/skills/p3/SKILL.md +9 -152
- package/dist/web/assets/Outputs-ddwte0jj.js +0 -1
- package/dist/web/assets/RequestStatus-Bg1OLbRc.js +0 -1
- package/dist/web/assets/Tabs-DTmggzgg.js +0 -1
- package/dist/web/assets/TagInput-BHAgjLP7.js +0 -1
- package/dist/web/assets/TaskDrawer-Dz_5c2NH.js +0 -3
- package/dist/web/assets/_requestId-D9-gtIcG.js +0 -1
- package/dist/web/assets/_requestId-DzCNYvqf.js +0 -30
- package/dist/web/assets/appCtx-Cm24VpAf.js +0 -1
- package/dist/web/assets/board-MCHcZ-PU.js +0 -1
- package/dist/web/assets/done-zq10Bt08.js +0 -1
- package/dist/web/assets/draft-CfJeyLOl.js +0 -1
- package/dist/web/assets/index-Ce0ndpne.js +0 -12
- package/dist/web/assets/index-D68mkSnw.css +0 -2
- package/dist/web/assets/new-9TKiNT4O.js +0 -1
- package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
- package/dist/web/assets/preload-helper-FBLw7u7x.js +0 -1
- package/dist/web/assets/release-notes-hK5XezLW.js +0 -5
- package/dist/web/assets/requestData-BnN7mctX.js +0 -1
- package/dist/web/assets/routes-usHwrrA0.js +0 -3
- package/dist/web/assets/settings-BVZDnL6O.js +0 -1
- package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
package/lib/cli/taskCommands.js
CHANGED
|
@@ -1,16 +1,27 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { join, relative, resolve as resolvePath } from "node:path";
|
|
3
|
+
import { relationRole } from "../shared/types.js";
|
|
4
|
+
import { normalizeTaskId } from "../shared/refs.js";
|
|
5
|
+
import { getArchivedTask, listArchivedTasks } from "../core/store/archivedTasks.js";
|
|
6
|
+
import { listTasks, resolve, resolveRef, resolveRequestId } from "../core/ops.js";
|
|
7
|
+
import { archiveTask, createTask, importQuality, updateTask } from "../core/requestOps.js";
|
|
8
|
+
import { taskQualityDiff } from "../shared/quality.js";
|
|
4
9
|
import { supersededMarks } from "../core/supersede.js";
|
|
5
10
|
import { table } from "./format.js";
|
|
6
11
|
import { taskRepo } from "../shared/workTarget.js";
|
|
7
12
|
import { addRepoOutputs, parseRepoOutput, repoArg } from "../core/workTargets.js";
|
|
8
|
-
import { briefTask, formatBriefTask, taskExtras } from "./showView.js";
|
|
13
|
+
import { briefTask, formatAcceptance, formatBlock, formatBriefTask, taskExtras } from "./showView.js";
|
|
14
|
+
import { formatReview } from "./revisitCommands.js";
|
|
15
|
+
import { taskReview } from "../core/reviewCandidates.js";
|
|
16
|
+
import { reviewSummary } from "../shared/reviewCandidate.js";
|
|
9
17
|
import { UsageError } from "./project.js";
|
|
10
|
-
import {
|
|
11
|
-
import {
|
|
18
|
+
import { NotFoundError } from "../core/store/collection.js";
|
|
19
|
+
import { basisFromOptions, parseTaskAssignments, checkStatus, evidenceOps, readBody } from "./args.js";
|
|
20
|
+
import { ACCEPTANCE_RESULTS, acceptanceStatus, applyAcceptanceOps, isAcceptanceResult } from "../shared/acceptance.js";
|
|
21
|
+
import { dependentsOf, formatEntity, indent, ambiguous, replacedBy, reopenedNote, warn, deps, workHint } from "./output.js";
|
|
12
22
|
import { requestCommand } from "./requestCommands.js";
|
|
13
|
-
|
|
23
|
+
import { pickRun } from "./preflightCommands.js";
|
|
24
|
+
/** タスクのコマンド(ls / show / find / impact / new / set / move / check / criteria / evidence / archive)。変更は server/requestOps.ts を通す。扱わないコマンドは undefined */
|
|
14
25
|
const RECORD_REQUIRED = "AI が完了にするときは --record で変更の記録を残してください(何を変えたか・なぜ・入れた決まり・やめたもの。Markdown。- で標準入力)\n" +
|
|
15
26
|
" 例: p3 move T003 done --output <成果物(変えたファイルや説明。URL は後から足せます)> --record - < record.md";
|
|
16
27
|
export async function taskCommand(cmd, env) {
|
|
@@ -19,10 +30,12 @@ export async function taskCommand(cmd, env) {
|
|
|
19
30
|
// --- タスク -------------------------------------------------------------
|
|
20
31
|
case "ls":
|
|
21
32
|
case "list": {
|
|
33
|
+
if (o.archived)
|
|
34
|
+
return listArchived(env);
|
|
22
35
|
if (o.repo !== undefined && o.repo !== "none" && !ctx.ws.project.repos.some((r) => r.name === o.repo)) {
|
|
23
36
|
throw new UsageError(`参照先「${o.repo}」は登録されていません(p3 repo ls)`);
|
|
24
37
|
}
|
|
25
|
-
const filter = { status: o.status?.split(","), area: o.area?.[0], q: o.q, repo: o.repo };
|
|
38
|
+
const filter = { status: o.status?.split(","), area: o.area?.[0], q: o.q, repo: o.repo, blocked: o.blocked, review: o.review };
|
|
26
39
|
const tasks = listTasks(ctx, { ...filter, request: o.all ? undefined : requestArg(undefined) });
|
|
27
40
|
const marks = supersededMarks(ctx.ws);
|
|
28
41
|
const items = tasks.map((t) => (marks.has(t.ref) ? { ...t, superseded: marks.get(t.ref) } : t));
|
|
@@ -33,10 +46,12 @@ export async function taskCommand(cmd, env) {
|
|
|
33
46
|
t.status,
|
|
34
47
|
...(multi ? [taskRepo(t) ?? "(なし)"] : []),
|
|
35
48
|
t.title,
|
|
36
|
-
[deps(t), replacedBy(t, marks)].filter(Boolean).join(" "),
|
|
37
|
-
])) || "タスクはありません");
|
|
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 ? "見直しが必要(候補)のタスクはありません" : "タスクはありません"));
|
|
38
51
|
}
|
|
39
52
|
case "show": {
|
|
53
|
+
if (o.archived)
|
|
54
|
+
return showArchived(env);
|
|
40
55
|
const query = args.join(" ");
|
|
41
56
|
const ref = resolveRef(ctx, query, current) ?? resolve(ctx, query, current).match;
|
|
42
57
|
if (!ref)
|
|
@@ -45,14 +60,21 @@ export async function taskCommand(cmd, env) {
|
|
|
45
60
|
return requestCommand(ctx, out, ["show", ref], o, actor, requestArg, expectedRev);
|
|
46
61
|
const item = ctx.ws.requireTask(ref);
|
|
47
62
|
const marks = supersededMarks(ctx.ws);
|
|
63
|
+
const review = taskReview(ctx, item);
|
|
48
64
|
if (o.brief) {
|
|
49
|
-
|
|
50
|
-
|
|
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"));
|
|
51
68
|
}
|
|
52
69
|
const file = relative(cwd, split(ref).col.path(item.id));
|
|
53
70
|
const { superseded, dependencies, warnings } = taskExtras(ctx, item, marks);
|
|
54
71
|
const dependents = dependentsOf(ctx, item).map((t) => ({ ref: t.ref, title: t.title, status: t.status }));
|
|
55
|
-
|
|
72
|
+
const acceptance = acceptanceStatus(item) ?? null;
|
|
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(""));
|
|
56
78
|
}
|
|
57
79
|
case "find":
|
|
58
80
|
case "resolve": {
|
|
@@ -81,6 +103,9 @@ export async function taskCommand(cmd, env) {
|
|
|
81
103
|
areas: o.area ?? [],
|
|
82
104
|
outputs: o.output ?? [],
|
|
83
105
|
...(repoOutputs.length ? { repoOutputs: addRepoOutputs([], repoOutputs) } : {}),
|
|
106
|
+
...(o.criterion?.length ? { criteria: o.criterion } : {}),
|
|
107
|
+
// 品質基準: 省く・all は作業先に当てはまるもの(作業先なしは取り込まない)、none は取り込まない、Q1,Q2 は明示したもの
|
|
108
|
+
...(o.quality !== undefined ? { quality: o.quality === "all" ? "auto" : o.quality === "none" ? "none" : o.quality.split(",").map((x) => x.trim()).filter(Boolean) } : {}),
|
|
84
109
|
body: readBody(o.body),
|
|
85
110
|
}, actor);
|
|
86
111
|
const t = r.task;
|
|
@@ -102,13 +127,19 @@ export async function taskCommand(cmd, env) {
|
|
|
102
127
|
const add = o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x));
|
|
103
128
|
patch.repoOutputs = addRepoOutputs(patch.repoOutputs ?? col.require(tid).repoOutputs ?? [], add);
|
|
104
129
|
}
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
130
|
+
// 受け入れ基準を足す(--criterion)・証拠を残す(--evidence / --evidence-file / --evidence-json)
|
|
131
|
+
const acceptance = [...(o.criterion ?? []).map((text) => ({ op: "add", text })), ...evidenceOps(o)];
|
|
132
|
+
if (!Object.keys(patch).length && !acceptance.length)
|
|
133
|
+
throw new UsageError("キー=値 を指定してください(受け入れ基準は --criterion、証拠は --evidence / --evidence-file / --evidence-json)");
|
|
134
|
+
const r = await updateTask(ctx, ref.split("/")[0], tid, { ...patch, ...(acceptance.length ? { acceptance } : {}) }, { expectedRev, actor });
|
|
108
135
|
const { task: next, warnings } = r;
|
|
109
136
|
warn(warnings);
|
|
137
|
+
checkClearedNote(r.checkCleared);
|
|
138
|
+
completionSkippedNote(r.completionSkipped);
|
|
139
|
+
completionSkippedNote(r.reworkSkipped);
|
|
110
140
|
const reopened = reopenedNote(r.reopened, r.reopenedAncestors);
|
|
111
|
-
|
|
141
|
+
const keys = [...Object.keys(patch), ...(acceptance.length ? ["acceptance"] : [])];
|
|
142
|
+
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"));
|
|
112
143
|
}
|
|
113
144
|
case "move": {
|
|
114
145
|
const ref = taskArg(args[0]);
|
|
@@ -129,18 +160,35 @@ export async function taskCommand(cmd, env) {
|
|
|
129
160
|
// リポジトリごとの成果物(最後のタスクに、関係するリポジトリの PR を全部残せる)
|
|
130
161
|
if (o["repo-output"]?.length)
|
|
131
162
|
patch.repoOutputs = addRepoOutputs(cur.repoOutputs ?? [], o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x)));
|
|
132
|
-
|
|
163
|
+
// 完了と同時に項目ごとの証拠を残す(--evidence / --evidence-file / --evidence-json。不足があっても完了は拒まない)
|
|
164
|
+
const acceptance = evidenceOps(o);
|
|
165
|
+
const r = await updateTask(ctx, cur.request, tid, { ...patch, ...(acceptance.length ? { acceptance } : {}) }, { expectedRev, actor });
|
|
133
166
|
const { task: next, warnings } = r;
|
|
134
167
|
warn(warnings);
|
|
168
|
+
checkClearedNote(r.checkCleared);
|
|
169
|
+
completionSkippedNote(r.completionSkipped);
|
|
170
|
+
completionSkippedNote(r.reworkSkipped);
|
|
135
171
|
const reopened = reopenedNote(r.reopened, r.reopenedAncestors);
|
|
136
|
-
|
|
172
|
+
const short = status === "done" ? acceptanceStatus(next)?.shortfalls : undefined;
|
|
173
|
+
if (short?.length)
|
|
174
|
+
process.stderr.write(`受け入れ基準の不足(完了はしました。人が確かめます): ${short.join(" / ")}\n`);
|
|
175
|
+
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(", ")})` : ""}`);
|
|
137
176
|
}
|
|
138
177
|
case "check": {
|
|
139
178
|
const ref = taskArg(args[0]);
|
|
140
179
|
const { tid } = split(ref);
|
|
141
|
-
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);
|
|
142
183
|
return out.result(next, () => `${next.ref} ${o.off ? "の済みを外しました" : "を済みにしました"}`);
|
|
143
184
|
}
|
|
185
|
+
case "block":
|
|
186
|
+
case "unblock":
|
|
187
|
+
return blockCommand(cmd, env);
|
|
188
|
+
case "criteria":
|
|
189
|
+
return criteriaCommand(env);
|
|
190
|
+
case "evidence":
|
|
191
|
+
return evidenceCommand(env);
|
|
144
192
|
case "archive": {
|
|
145
193
|
const ref = taskArg(args[0]);
|
|
146
194
|
const { tid } = split(ref);
|
|
@@ -150,3 +198,276 @@ export async function taskCommand(cmd, env) {
|
|
|
150
198
|
}
|
|
151
199
|
return undefined;
|
|
152
200
|
}
|
|
201
|
+
// --- 止まっている理由(停止) ---------------------------------------------------------
|
|
202
|
+
/**
|
|
203
|
+
* block <T> --reason 理由|- [--decision 決めてほしいこと|-] 作業中のタスクに停止を付ける・内容を直す(止まった時刻は変えない)
|
|
204
|
+
* unblock <T> --resolution 回答・解決の内容|- 解除する(状態は変えない。自動では再開しない)
|
|
205
|
+
* - は標準入力(どれか1つだけ)
|
|
206
|
+
*/
|
|
207
|
+
async function blockCommand(cmd, { ctx, out, args, o, actor, expectedRev, taskArg, split }) {
|
|
208
|
+
const ref = taskArg(args[0]);
|
|
209
|
+
const stdin = [o.reason, o.decision, o.resolution].filter((v) => v === "-").length;
|
|
210
|
+
if (stdin > 1)
|
|
211
|
+
throw new UsageError("標準入力(-)は --reason / --decision / --resolution のどれか1つだけに使えます");
|
|
212
|
+
let op;
|
|
213
|
+
if (cmd === "block") {
|
|
214
|
+
if (o.reason === undefined)
|
|
215
|
+
throw new UsageError(`使い方: p3 block ${args[0] ?? "<T>"} --reason "止まっている理由" [--decision "決めてほしいこと"]`);
|
|
216
|
+
op = { op: "set", reason: readBody(o.reason), ...(o.decision !== undefined ? { decision: readBody(o.decision) } : {}) };
|
|
217
|
+
}
|
|
218
|
+
else {
|
|
219
|
+
if (o.resolution === undefined)
|
|
220
|
+
throw new UsageError(`使い方: p3 unblock ${args[0] ?? "<T>"} --resolution "回答・解決の内容"`);
|
|
221
|
+
op = { op: "clear", resolution: readBody(o.resolution) };
|
|
222
|
+
}
|
|
223
|
+
const { tid } = split(ref);
|
|
224
|
+
const before = ctx.ws.requireTask(ref);
|
|
225
|
+
const r = await updateTask(ctx, ref.split("/")[0], tid, { blockOp: op }, { expectedRev, actor });
|
|
226
|
+
const t = r.task;
|
|
227
|
+
const changed = t.rev !== before.rev;
|
|
228
|
+
return out.result({ ...t, changed }, () => !changed
|
|
229
|
+
? cmd === "block"
|
|
230
|
+
? `${t.ref} は同じ内容で止まっています(変えていません)`
|
|
231
|
+
: `${t.ref} は止まっていません(変えていません)`
|
|
232
|
+
: t.block
|
|
233
|
+
? `${t.ref} を止めました(${t.block.since} から): ${t.block.reason}${t.block.decision ? `\n 決めてほしいこと: ${t.block.decision}` : ""}`
|
|
234
|
+
: `${t.ref} の停止を解除しました(状態は ${t.status} のまま。自動では再開しません)`);
|
|
235
|
+
}
|
|
236
|
+
// --- 受け入れ基準と証拠 -------------------------------------------------------------
|
|
237
|
+
function checkClearedNote(msg) {
|
|
238
|
+
if (msg)
|
|
239
|
+
process.stderr.write(`${msg}\n`);
|
|
240
|
+
}
|
|
241
|
+
/** 完了の記録・手戻りの履歴を足せなかった(壊れた記録)ことを知らせる */
|
|
242
|
+
export function completionSkippedNote(msg) {
|
|
243
|
+
if (msg)
|
|
244
|
+
process.stderr.write(`${msg}\n`);
|
|
245
|
+
}
|
|
246
|
+
/** 基準・証拠の操作を当てて、今の基準と不足を出す */
|
|
247
|
+
async function applyAcceptance({ ctx, out, actor, expectedRev, split }, ref, acceptance) {
|
|
248
|
+
const { tid } = split(ref);
|
|
249
|
+
const r = await updateTask(ctx, ref.split("/")[0], tid, { acceptance }, { expectedRev, actor });
|
|
250
|
+
checkClearedNote(r.checkCleared);
|
|
251
|
+
const acc = acceptanceStatus(r.task);
|
|
252
|
+
return out.result({ ...r.task, acceptance: acc ?? null, ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => [`更新: ${r.task.ref} (rev ${r.task.rev})`, ...formatAcceptance(r.task)].join("\n"));
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* criteria <タスク> 基準と証拠・不足を出す
|
|
256
|
+
* criteria <タスク> add <文> [<文> ...] 足す(ID は A1, A2, ... を振る)
|
|
257
|
+
* criteria <タスク> edit <ID> <文> 文を変える(記録済みの証拠は再確認が必要になる)
|
|
258
|
+
* criteria <タスク> rm <ID> [...] 消す(証拠は対応する基準のない証拠として残る)
|
|
259
|
+
* criteria <タスク> order <ID> ... 並べ替える(今の ID を全部)
|
|
260
|
+
*/
|
|
261
|
+
async function criteriaCommand(env) {
|
|
262
|
+
const { ctx, out, args, taskArg } = env;
|
|
263
|
+
// タスク案(D1。--run で run、省くと最新)の基準はタスク化の前に直す
|
|
264
|
+
const draft = /^(?:([^/]+)\/)?(D\d+)$/i.exec(args[0] ?? "");
|
|
265
|
+
if (draft)
|
|
266
|
+
return draftCriteriaCommand(env, draft[1], draft[2].toUpperCase());
|
|
267
|
+
const ref = taskArg(args[0]);
|
|
268
|
+
const [sub, ...rest] = args.slice(1);
|
|
269
|
+
if (sub === "quality")
|
|
270
|
+
return qualitySubcommand(env, ref, rest);
|
|
271
|
+
if (sub === undefined || sub === "ls" || sub === "show") {
|
|
272
|
+
const task = ctx.ws.requireTask(ref);
|
|
273
|
+
const acc = acceptanceStatus(task);
|
|
274
|
+
return out.result({ ref: task.ref, rev: task.rev, criteria: task.acceptanceCriteria ?? [], evidence: task.acceptanceEvidence ?? [], acceptance: acc ?? null }, () => formatAcceptance(task).join("\n"));
|
|
275
|
+
}
|
|
276
|
+
const need = (n, usage) => {
|
|
277
|
+
if (rest.length < n)
|
|
278
|
+
throw new UsageError(`使い方: p3 criteria <タスク> ${usage}`);
|
|
279
|
+
};
|
|
280
|
+
switch (sub) {
|
|
281
|
+
case "add":
|
|
282
|
+
need(1, "add <文> [<文> ...]");
|
|
283
|
+
return applyAcceptance(env, ref, rest.map((text) => ({ op: "add", text })));
|
|
284
|
+
case "edit":
|
|
285
|
+
case "set":
|
|
286
|
+
need(2, "edit <ID> <文>");
|
|
287
|
+
return applyAcceptance(env, ref, [{ op: "edit", id: rest[0], text: rest.slice(1).join(" ") }]);
|
|
288
|
+
case "rm":
|
|
289
|
+
case "remove":
|
|
290
|
+
need(1, "rm <ID> [<ID> ...]");
|
|
291
|
+
return applyAcceptance(env, ref, rest.map((id) => ({ op: "remove", id })));
|
|
292
|
+
case "order":
|
|
293
|
+
need(1, "order <ID> <ID> ...(今の ID を全部)");
|
|
294
|
+
return applyAcceptance(env, ref, [{ op: "order", ids: rest }]);
|
|
295
|
+
}
|
|
296
|
+
throw new UsageError(`criteria の操作は add / edit / rm / order です: ${sub}`);
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* criteria <T> quality 今の品質基準との差分(追加・変更・削除・除外・タスクで直した)。読むだけ
|
|
300
|
+
* criteria <T> quality import [<kind>:<Q>...] 差分を明示して取り込む(省くと「直した」以外の全部)
|
|
301
|
+
*/
|
|
302
|
+
async function qualitySubcommand({ ctx, out, actor, expectedRev }, ref, rest) {
|
|
303
|
+
const t = ctx.ws.requireTask(ref);
|
|
304
|
+
if (rest[0] === undefined || rest[0] === "diff") {
|
|
305
|
+
const q = ctx.ws.project.quality;
|
|
306
|
+
const diff = taskQualityDiff(t.acceptanceCriteria ?? [], q, t.repo);
|
|
307
|
+
const state = q?.state ?? "unset";
|
|
308
|
+
const label = { add: "足す", change: "変わった", remove: "消す", exempt: "除外になった", edited: "タスクで直した" };
|
|
309
|
+
return out.result({ ref: t.ref, quality: state, version: ctx.ws.project.qualityVersion, diff }, () => state !== "set"
|
|
310
|
+
? `品質基準は${state === "unset" ? "未設定" : "読めません"}です(p3 quality)`
|
|
311
|
+
: diff.length
|
|
312
|
+
? [
|
|
313
|
+
`${t.ref} と今の品質基準の差分(版 ${ctx.ws.project.qualityVersion}):`,
|
|
314
|
+
...diff.map((d) => ` ${d.kind}:${d.quality} ${label[d.kind]}${d.criterion ? `(${d.criterion})` : ""}${d.text ? ` ${d.text}` : ""}${d.reason ? ` ${d.reason}` : ""}`),
|
|
315
|
+
t.repo ? "" : " ※作業先なしのタスクには、足す案を出しません(p3 new --quality Q1,Q2 のように明示して取り込めます)",
|
|
316
|
+
`取り込む: p3 criteria ${t.id} quality import [<kind>:<Q>...]`,
|
|
317
|
+
]
|
|
318
|
+
.filter(Boolean)
|
|
319
|
+
.join("\n")
|
|
320
|
+
: `${t.ref} は今の品質基準と差分がありません`);
|
|
321
|
+
}
|
|
322
|
+
if (rest[0] !== "import")
|
|
323
|
+
throw new UsageError("使い方: p3 criteria <T> quality [import [<kind>:<Q>...]]");
|
|
324
|
+
const r = await importQuality(ctx, t.request, t.id, rest.length > 1 ? rest.slice(1) : undefined, { expectedRev, actor });
|
|
325
|
+
if (r.checkCleared)
|
|
326
|
+
process.stderr.write(`${r.checkCleared}\n`);
|
|
327
|
+
return out.result({ ...r.task, applied: r.applied, ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => [`取り込みました: ${r.applied.join(", ")}`, ...formatAcceptance(r.task)].join("\n"));
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* criteria <D1> [add|edit|rm|order] --req <要望> [--run <run>]: タスク案の基準(タスク化すると ID ごとタスクに写る)。
|
|
331
|
+
* 案のファイルを読み直し、読んだときの基準と比べてから書く(他で変わっていれば競合)。読めなかった項目は、直すと消える
|
|
332
|
+
*/
|
|
333
|
+
async function draftCriteriaCommand({ ctx, out, args, o, requestArg }, head, key) {
|
|
334
|
+
const rid = head ? resolveRequestId(ctx, head) : requestArg(undefined);
|
|
335
|
+
if (!rid)
|
|
336
|
+
throw new NotFoundError(head ?? "要望");
|
|
337
|
+
const run = await pickRun(ctx, rid, o.run);
|
|
338
|
+
const d = run.drafts.find((x) => x.key === key);
|
|
339
|
+
if (!d)
|
|
340
|
+
throw new NotFoundError(`${run.id}/${key}`);
|
|
341
|
+
const [sub, ...rest] = args.slice(1);
|
|
342
|
+
const show = (x) => [
|
|
343
|
+
`${rid} / ${run.id} / ${x.key} ${x.title}`,
|
|
344
|
+
...(x.acceptanceCriteria?.length ? x.acceptanceCriteria.map((c) => ` ${c.id} ${c.text}`) : [" 受け入れ基準なし"]),
|
|
345
|
+
...(x.acceptanceProblems ?? []).map((p) => ` ※読めない: ${p}(直すと消えます)`),
|
|
346
|
+
].join("\n");
|
|
347
|
+
if (sub === undefined || sub === "ls" || sub === "show")
|
|
348
|
+
return out.result({ request: rid, run: run.id, key, criteria: d.acceptanceCriteria ?? [], problems: d.acceptanceProblems ?? [] }, () => show(d));
|
|
349
|
+
if (run.materialized?.length || run.children)
|
|
350
|
+
throw new UsageError(`${run.id} はタスク化済みか子の要望の案の run です(タスクの基準は p3 criteria <T>)`);
|
|
351
|
+
const ops = sub === "add" ? rest.map((text) => ({ op: "add", text }))
|
|
352
|
+
: sub === "edit" || sub === "set" ? [{ op: "edit", id: rest[0] ?? "", text: rest.slice(1).join(" ") }]
|
|
353
|
+
: sub === "rm" || sub === "remove" ? rest.map((id) => ({ op: "remove", id }))
|
|
354
|
+
: sub === "order" ? [{ op: "order", ids: rest }]
|
|
355
|
+
: [];
|
|
356
|
+
if (!ops.length)
|
|
357
|
+
throw new UsageError("使い方: p3 criteria <D1> add <文>... / edit <ID> <文> / rm <ID>... / order <ID>... --req <要望> [--run <run>]");
|
|
358
|
+
// 案は採番を持たないので、操作は今の基準だけに当てる(読めなかった項目は除いたまま書き直す)
|
|
359
|
+
const next = applyAcceptanceOps({ acceptanceCriteria: d.acceptanceCriteria }, ops, { now: new Date().toISOString() });
|
|
360
|
+
const saved = await ctx.preflight.updateDraft(rid, run.id, key, { acceptanceCriteria: next.acceptanceCriteria ?? [] }, { expectedCriteria: d.acceptanceCriteria ?? [] });
|
|
361
|
+
return out.result({ request: rid, run: run.id, key, criteria: saved.acceptanceCriteria ?? [], problems: [] }, () => show(saved));
|
|
362
|
+
}
|
|
363
|
+
/**
|
|
364
|
+
* evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md] [--basis 種類 ...] 1項目の証拠を残す(再記録は置き換え)
|
|
365
|
+
* evidence <タスク> --file 証拠.md|- 見出し「## <ID> <結果>」ごとにまとめて残す
|
|
366
|
+
* evidence <タスク> --evidence-json 証拠.json|- 根拠つきでまとめて残す
|
|
367
|
+
* evidence <タスク> rm <ID> [...] 証拠を消す
|
|
368
|
+
*/
|
|
369
|
+
async function evidenceCommand(env) {
|
|
370
|
+
const { args, o, taskArg } = env;
|
|
371
|
+
const ref = taskArg(args[0]);
|
|
372
|
+
const [first, ...rest] = args.slice(1);
|
|
373
|
+
if (first === "rm" || first === "remove") {
|
|
374
|
+
if (!rest.length)
|
|
375
|
+
throw new UsageError("使い方: p3 evidence <タスク> rm <ID> [<ID> ...]");
|
|
376
|
+
return applyAcceptance(env, ref, rest.map((id) => ({ op: "unrecord", id })));
|
|
377
|
+
}
|
|
378
|
+
if (first === undefined) {
|
|
379
|
+
if (o.file === undefined && o["evidence-json"] === undefined)
|
|
380
|
+
throw new UsageError("使い方: p3 evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md] [--basis 種類](まとめてなら --file 証拠.md か --evidence-json 証拠.json)");
|
|
381
|
+
if (o.basis !== undefined)
|
|
382
|
+
throw new UsageError("まとめて残すときの根拠は、--evidence-json の各項目の basis に書いてください(--basis は1項目のときだけ)");
|
|
383
|
+
return applyAcceptance(env, ref, evidenceOps({ "evidence-file": o.file, "evidence-json": o["evidence-json"] }));
|
|
384
|
+
}
|
|
385
|
+
if (o["evidence-json"] !== undefined)
|
|
386
|
+
throw new UsageError("--evidence-json はまとめて残すときだけ使えます(p3 evidence <タスク> --evidence-json 証拠.json)");
|
|
387
|
+
const result = rest[0];
|
|
388
|
+
if (!isAcceptanceResult(result))
|
|
389
|
+
throw new UsageError(`結果は ${ACCEPTANCE_RESULTS.join(" / ")} のどれかです: p3 evidence <タスク> ${first} <結果>`);
|
|
390
|
+
if (o.body !== undefined && o.file !== undefined)
|
|
391
|
+
throw new UsageError("--body と --file はどちらか一方です");
|
|
392
|
+
let evidence = rest.slice(1).join(" ");
|
|
393
|
+
if (o.body !== undefined)
|
|
394
|
+
evidence = readBody(o.body);
|
|
395
|
+
else if (o.file !== undefined) {
|
|
396
|
+
try {
|
|
397
|
+
evidence = readFileSync(resolvePath(process.cwd(), o.file), "utf8");
|
|
398
|
+
}
|
|
399
|
+
catch {
|
|
400
|
+
throw new UsageError(`証拠のファイルが読めません: ${o.file}`);
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
const basis = basisFromOptions(o);
|
|
404
|
+
return applyAcceptance(env, ref, [{ op: "record", id: first, result, evidence, ...(basis ? { basis } : {}) }]);
|
|
405
|
+
}
|
|
406
|
+
// --- アーカイブしたタスク(--archived を付けたときだけ。読むだけ) ------------------------------------
|
|
407
|
+
/** ls --archived: 今の要望(--req)のアーカイブの一覧。通常の絞り込み・--all とは混ぜない */
|
|
408
|
+
async function listArchived({ ctx, out, o, requestArg }) {
|
|
409
|
+
const mixed = ["all", "status", "area", "q", "repo", "blocked"].filter((k) => o[k] !== undefined && o[k] !== false);
|
|
410
|
+
if (mixed.length)
|
|
411
|
+
throw new UsageError(`--archived では ${mixed.map((k) => `--${k}`).join(" ")} を使えません(要望は --req で1つ指定)`);
|
|
412
|
+
const list = await listArchivedTasks(ctx.ws, requestArg(undefined));
|
|
413
|
+
return out.result(list, () => [
|
|
414
|
+
table(list.tasks.map((t) => [t.id, t.status, t.updatedAt.slice(0, 10), t.title])) || "アーカイブしたタスクはありません",
|
|
415
|
+
...list.errors.map((e) => `読めない: ${e.id} ${e.error}`),
|
|
416
|
+
list.tasks.length || list.errors.length ? "(状態・日付はアーカイブする前の最後の値。進捗・対応済の判定には数えない)" : "",
|
|
417
|
+
]
|
|
418
|
+
.filter(Boolean)
|
|
419
|
+
.join("\n"));
|
|
420
|
+
}
|
|
421
|
+
/** show <T003|要望/T003> --archived: アーカイブの1件。通常のタスクは探さない(同じ ID が通常にあってもアーカイブを読む) */
|
|
422
|
+
async function showArchived({ ctx, out, args, current, cwd }) {
|
|
423
|
+
const raw = args.join(" ").trim();
|
|
424
|
+
if (!raw)
|
|
425
|
+
throw new UsageError("タスクを指定してください(T003 / <要望>/T003)");
|
|
426
|
+
const [head, tail] = raw.split("/", 2);
|
|
427
|
+
const rid = tail !== undefined ? resolveRequestId(ctx, head) : current;
|
|
428
|
+
if (tail === undefined && !current)
|
|
429
|
+
throw new UsageError(`${raw}: 要望を --req で指定してください`);
|
|
430
|
+
if (!rid)
|
|
431
|
+
throw new NotFoundError(head);
|
|
432
|
+
const tid = normalizeTaskId(tail ?? head);
|
|
433
|
+
if (!tid)
|
|
434
|
+
throw new UsageError(`${raw}: タスクの ID(T003)を指定してください`);
|
|
435
|
+
const item = await getArchivedTask(ctx.ws, rid, tid);
|
|
436
|
+
const file = relative(cwd, join(ctx.ws.requestsDir, rid, "tasks", ".archive", `${tid}.md`));
|
|
437
|
+
return out.result({ item, file }, () => formatArchived(item, file));
|
|
438
|
+
}
|
|
439
|
+
function formatArchived(t, file) {
|
|
440
|
+
const lines = [`${t.ref} ${t.title}`, " [アーカイブ・閲覧専用] 状態・最終更新はアーカイブする前の最後の値(アーカイブの日時ではない)", ""];
|
|
441
|
+
const fields = [
|
|
442
|
+
["status", t.status],
|
|
443
|
+
["repo", t.repo ?? "(なし)"],
|
|
444
|
+
["labels", t.labels.join(", ")],
|
|
445
|
+
["areas", t.areas.join(", ")],
|
|
446
|
+
["outputs", t.outputs.join(" / ")],
|
|
447
|
+
["repoOutputs", t.repoOutputs?.map((r) => `${r.repo}=${r.output}`).join(" / ")],
|
|
448
|
+
["createdAt", t.createdAt],
|
|
449
|
+
["startedAt", t.startedAt],
|
|
450
|
+
["doneAt", t.doneAt],
|
|
451
|
+
["checkedAt", t.checkedAt],
|
|
452
|
+
["updatedAt", t.updatedAt],
|
|
453
|
+
["updatedBy", t.updatedBy],
|
|
454
|
+
];
|
|
455
|
+
for (const [k, v] of fields)
|
|
456
|
+
if (v)
|
|
457
|
+
lines.push(` ${k.padEnd(13)} ${String(v)}`);
|
|
458
|
+
if (t.body.trim())
|
|
459
|
+
lines.push("", indent(t.body.trim()));
|
|
460
|
+
if (t.record)
|
|
461
|
+
lines.push("", "変更の記録:", indent(t.record));
|
|
462
|
+
const acc = formatAcceptance(t, { emptyLine: false });
|
|
463
|
+
if (acc.length)
|
|
464
|
+
lines.push("", ...acc);
|
|
465
|
+
const blk = formatBlock(t, { history: true });
|
|
466
|
+
if (blk.length)
|
|
467
|
+
lines.push("", ...blk);
|
|
468
|
+
// 保存された関係をそのまま出す(相手が今の通常のタスクかは解かない)
|
|
469
|
+
if (t.relations.length)
|
|
470
|
+
lines.push("", "保存された関係:", ...t.relations.map((r) => ` → ${relationRole(r.type, "out")} ${r.target}`));
|
|
471
|
+
lines.push("", `ファイル: ${file}`);
|
|
472
|
+
return lines.join("\n");
|
|
473
|
+
}
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import { resolveRequestId } from "../core/ops.js";
|
|
2
|
+
import { NotFoundError } from "../core/store/collection.js";
|
|
3
|
+
import { normalizeTaskId } from "../shared/refs.js";
|
|
4
|
+
import { previewOf, QUALITY_VERDICT_LABELS, TASK_REVIEW_SCOPE, TASK_REVIEW_VERDICT_LABELS, TASK_REVIEW_VERDICTS } from "../shared/taskReview.js";
|
|
5
|
+
import { table } from "./format.js";
|
|
6
|
+
import { UsageError } from "./project.js";
|
|
7
|
+
/**
|
|
8
|
+
* タスクの AI レビュー(core/taskReview。画面と同じサービス)。
|
|
9
|
+
* review <T> [--target ...] [--viewpoint ...] [--engine codex|mock] [--preview] 材料を固定して始め、終わるまで待つ(進み具合は stderr、
|
|
10
|
+
* Ctrl-C で取り消す)。--preview は材料を見るだけ
|
|
11
|
+
* reviews <T> / review-show <T> <run> / review-cancel <T> <run> [--acknowledge-stopped]
|
|
12
|
+
* 結果は参考の記録で、タスクの状態・済み・基準・証拠を変えない。アーカイブしたタスクの履歴も読める
|
|
13
|
+
*/
|
|
14
|
+
const STATUS_LABEL = { running: "実行中", completed: "完了", failed: "失敗", cancelled: "取消" };
|
|
15
|
+
/** タスクの参照(アーカイブしたタスクも読むので、今のタスクの一覧では探さない) */
|
|
16
|
+
function taskKey({ ctx, current }, raw) {
|
|
17
|
+
if (!raw)
|
|
18
|
+
throw new UsageError("タスクを指定してください(T003 / <要望>/T003)");
|
|
19
|
+
const [head, tail] = raw.split("/", 2);
|
|
20
|
+
const rid = tail !== undefined ? resolveRequestId(ctx, head) : current;
|
|
21
|
+
if (tail === undefined && !current)
|
|
22
|
+
throw new UsageError(`${raw}: 要望を --req で指定してください`);
|
|
23
|
+
if (!rid)
|
|
24
|
+
throw new NotFoundError(head);
|
|
25
|
+
const tid = normalizeTaskId(tail ?? head);
|
|
26
|
+
if (!tid)
|
|
27
|
+
throw new UsageError(`${raw}: タスクの ID(T003)を指定してください`);
|
|
28
|
+
return { rid, tid };
|
|
29
|
+
}
|
|
30
|
+
export async function taskReviewCommand(cmd, env) {
|
|
31
|
+
if (cmd !== "review" && cmd !== "reviews" && cmd !== "review-show" && cmd !== "review-cancel")
|
|
32
|
+
return undefined;
|
|
33
|
+
const { ctx, out, args, o, actor } = env;
|
|
34
|
+
const svc = ctx.taskReview;
|
|
35
|
+
const { rid, tid } = taskKey(env, args[0]);
|
|
36
|
+
const key = `${rid}/${tid}`;
|
|
37
|
+
if (cmd === "reviews") {
|
|
38
|
+
const items = await svc.list(rid, tid);
|
|
39
|
+
return out.result(items, () => items.length
|
|
40
|
+
? table(items.map((x) => x.state === "broken"
|
|
41
|
+
? [x.id, "読めない", x.error]
|
|
42
|
+
: [x.run.id, STATUS_LABEL[x.run.status], x.run.startedAt.slice(0, 16).replace("T", " "), verdictSummary(x.verdicts), x.run.error ?? ""]))
|
|
43
|
+
: `レビューの履歴はありません(p3 review ${key})`);
|
|
44
|
+
}
|
|
45
|
+
if (cmd === "review-show" || cmd === "review-cancel") {
|
|
46
|
+
const run = args[1];
|
|
47
|
+
if (!run)
|
|
48
|
+
throw new UsageError(`p3 ${cmd} ${key} <run>`);
|
|
49
|
+
if (cmd === "review-show") {
|
|
50
|
+
const d = await svc.get(rid, tid, run);
|
|
51
|
+
return out.result(d, () => formatTaskReview(d));
|
|
52
|
+
}
|
|
53
|
+
const r = await svc.cancel(rid, tid, run, actor, { acknowledgeStopped: o["acknowledge-stopped"] });
|
|
54
|
+
return out.result(r, () => r.requested
|
|
55
|
+
? `取消を頼みました: ${key}/${run}(実行しているプロセスが見つけて止めます)`
|
|
56
|
+
: r.run.abandoned
|
|
57
|
+
? `中断にしました: ${key}/${run}(記録の上で終わりにしました。ほかの環境で動いているプロセスを止めたとは限りません)`
|
|
58
|
+
: `終わりにしました: ${key}/${run}(${STATUS_LABEL[r.run.status]}${r.run.error ? `: ${r.run.error}` : ""})`);
|
|
59
|
+
}
|
|
60
|
+
if (o.engine !== undefined && o.engine !== "codex" && o.engine !== "mock")
|
|
61
|
+
throw new UsageError("--engine は codex か mock");
|
|
62
|
+
const opts = { targets: o.target, viewpoint: o.viewpoint };
|
|
63
|
+
if (o.preview) {
|
|
64
|
+
const p = await svc.preview(rid, tid, opts);
|
|
65
|
+
const view = { ...previewOf(p.input), engineRequired: p.engineRequired };
|
|
66
|
+
return out.result(view, () => formatPreview(view));
|
|
67
|
+
}
|
|
68
|
+
const started = await svc.start(rid, tid, actor, { ...opts, engine: o.engine });
|
|
69
|
+
process.stderr.write(`レビューを始めました: ${key}/${started.id}(Ctrl-C で取り消す)\n`);
|
|
70
|
+
let shown = 0;
|
|
71
|
+
const tick = setInterval(() => {
|
|
72
|
+
void svc.get(rid, tid, started.id).then((d) => {
|
|
73
|
+
for (const e of d.run.log.slice(shown))
|
|
74
|
+
process.stderr.write(` ${e.text}\n`);
|
|
75
|
+
shown = Math.max(shown, d.run.log.length);
|
|
76
|
+
}, () => undefined);
|
|
77
|
+
}, 500);
|
|
78
|
+
const onInt = () => void svc.cancel(rid, tid, started.id, actor).catch(() => undefined);
|
|
79
|
+
process.on("SIGINT", onInt);
|
|
80
|
+
const d = await svc.wait(rid, tid, started.id);
|
|
81
|
+
clearInterval(tick);
|
|
82
|
+
process.removeListener("SIGINT", onInt);
|
|
83
|
+
for (const e of d.run.log.slice(shown))
|
|
84
|
+
process.stderr.write(` ${e.text}\n`);
|
|
85
|
+
if (d.run.status !== "completed") {
|
|
86
|
+
if (out.json)
|
|
87
|
+
out.result(d, () => "");
|
|
88
|
+
else
|
|
89
|
+
process.stderr.write(`${STATUS_LABEL[d.run.status]}: ${d.run.error ?? ""}\n`);
|
|
90
|
+
return 1;
|
|
91
|
+
}
|
|
92
|
+
return out.result(d, () => formatTaskReview(d));
|
|
93
|
+
}
|
|
94
|
+
function verdictSummary(v) {
|
|
95
|
+
if (!v)
|
|
96
|
+
return "";
|
|
97
|
+
return TASK_REVIEW_VERDICTS.filter((k) => v[k]).map((k) => `${TASK_REVIEW_VERDICT_LABELS[k]} ${v[k]}`).join(" · ");
|
|
98
|
+
}
|
|
99
|
+
function formatPreview(p) {
|
|
100
|
+
const lines = [`${p.task.ref} ${p.task.title}`, `材料の hash: ${p.hash}`, "", "比較項目:"];
|
|
101
|
+
for (const i of p.items)
|
|
102
|
+
lines.push(` ${i.id} ${i.text.split("\n")[0]}${i.kind === "body" ? "(本文から)" : ""}`);
|
|
103
|
+
lines.push("", "比較対象:");
|
|
104
|
+
for (const t of p.targets) {
|
|
105
|
+
lines.push(` ${t.repo} ${t.kind === "range" ? `${t.range.baseSpec}..${t.range.headSpec}(merge-base ${t.range.mergeBase.slice(0, 12)})` : "コミット"} 変更 ${t.changes} 件 出典: ${t.sources.join(", ")}`);
|
|
106
|
+
for (const c of t.commits)
|
|
107
|
+
lines.push(` ${c.sha.slice(0, 12)} ${c.subject}${c.otherTasks.length ? ` ※ほかのタスク ${c.otherTasks.join(", ")}` : ""}`);
|
|
108
|
+
}
|
|
109
|
+
if (p.quality)
|
|
110
|
+
lines.push("", `品質基準: ${p.quality.state === "set" ? `版 ${p.quality.version}・判定する ${p.quality.applies.map((q) => q.id).join(", ") || "なし"}${p.quality.exempt.length ? `・除外 ${p.quality.exempt.map((q) => q.id).join(", ")}` : ""}` : p.quality.state === "unset" ? "未設定" : "読めません"}`);
|
|
111
|
+
lines.push("", `観点: ${p.viewpoint.source}${p.viewpoint.repo ? `(${p.viewpoint.repo}@${p.viewpoint.sha?.slice(0, 12)}:${p.viewpoint.path})` : ""}`);
|
|
112
|
+
for (const n of p.notes)
|
|
113
|
+
lines.push(` ⚠ ${n.message}`);
|
|
114
|
+
if (p.engineRequired)
|
|
115
|
+
lines.push("", "※ Preflight の担当が agent なので、Codex で実行するなら --engine codex を付けてください");
|
|
116
|
+
return lines.join("\n");
|
|
117
|
+
}
|
|
118
|
+
/** 品質の表示(評価した版・最新との差・基準ごとの判定・違反の指摘)。古い記録は品質を評価していない */
|
|
119
|
+
function qualityLines(input, result) {
|
|
120
|
+
const q = input.quality;
|
|
121
|
+
if (!q)
|
|
122
|
+
return ["品質: 評価していません(品質基準を材料に入れる前の記録です)"];
|
|
123
|
+
if (q.latest.state !== "set")
|
|
124
|
+
return [`品質: 評価していません(品質基準が${q.latest.state === "unset" ? "未設定" : "読めません"})`];
|
|
125
|
+
const lines = [`品質(最新の品質基準 版 ${q.latest.version}。タスクに取り込んだ版: ${q.imported.length ? [...new Set(q.imported.map((x) => x.version))].join(", ") : "なし"}):`];
|
|
126
|
+
for (const d of q.diff.filter((x) => x.kind !== "edited"))
|
|
127
|
+
lines.push(` 差: ${d.kind}:${d.quality}${d.reason ? `(${d.reason})` : ""}`);
|
|
128
|
+
for (const r of result.quality ?? []) {
|
|
129
|
+
lines.push(` ${r.verdict === "violated" ? "✗" : "・"} ${r.standard} ${QUALITY_VERDICT_LABELS[r.verdict]} ${r.reason}`);
|
|
130
|
+
if (r.evidence.length)
|
|
131
|
+
lines.push(` 根拠: ${r.evidence.join(", ")}`);
|
|
132
|
+
if (r.unread)
|
|
133
|
+
lines.push(` 確かめられなかった範囲: ${r.unread}`);
|
|
134
|
+
}
|
|
135
|
+
for (const e of q.exempt)
|
|
136
|
+
lines.push(` ・ ${e.id} 除外(${e.exempt?.reason ?? ""})`);
|
|
137
|
+
const violated = (result.quality ?? []).filter((r) => r.verdict === "violated");
|
|
138
|
+
if (violated.length)
|
|
139
|
+
lines.push(`品質の指摘: ${violated.map((r) => r.standard).join(", ")} に違反があります(作業した側の証拠とは別の判定です)`);
|
|
140
|
+
return lines;
|
|
141
|
+
}
|
|
142
|
+
/** review-show の人向けの表示 */
|
|
143
|
+
export function formatTaskReview(d) {
|
|
144
|
+
const { run, input, result } = d;
|
|
145
|
+
const lines = [`${run.request}/${run.task}/${run.id} ${STATUS_LABEL[run.status]} ${run.startedAt}${run.startedBy ? ` ${run.startedBy}` : ""} (${run.engine}${run.model ? ` ${run.model}` : ""})`];
|
|
146
|
+
if (run.error)
|
|
147
|
+
lines.push(` ${run.error}`);
|
|
148
|
+
if (d.owner && d.owner.state !== "local" && d.owner.state !== "alive") {
|
|
149
|
+
lines.push(` 実行しているプロセスを確かめられません(${"reason" in d.owner ? d.owner.reason : ""})。止まっていると確かめたら p3 review-cancel ${run.request}/${run.task} ${run.id} --acknowledge-stopped`);
|
|
150
|
+
}
|
|
151
|
+
lines.push(`材料: 比較項目 ${input.items.length} 件・ファイル ${input.files.length} 件・観点 ${input.viewpoint.source}(${input.extractedAt})`);
|
|
152
|
+
for (const t of input.targets)
|
|
153
|
+
lines.push(` ${t.repo}: ${t.kind === "range" ? `${t.range.base.slice(0, 12)}..${t.range.head.slice(0, 12)}` : t.commits.map((c) => c.sha.slice(0, 12)).join(", ")}`);
|
|
154
|
+
for (const n of input.notes)
|
|
155
|
+
lines.push(` ⚠ ${n.message}`);
|
|
156
|
+
if (result) {
|
|
157
|
+
const text = new Map(input.items.map((i) => [i.id, i.text]));
|
|
158
|
+
lines.push("", "全体の所見:", ...result.overall.split("\n").map((l) => ` ${l}`), "");
|
|
159
|
+
for (const i of result.items) {
|
|
160
|
+
lines.push(`■ ${i.item} ${TASK_REVIEW_VERDICT_LABELS[i.verdict]} ${(text.get(i.item) ?? "").split("\n")[0]}`);
|
|
161
|
+
lines.push(` 理由: ${i.reason}`);
|
|
162
|
+
if (i.evidence.length)
|
|
163
|
+
lines.push(` 根拠: ${i.evidence.join(", ")}`);
|
|
164
|
+
for (const g of i.gaps)
|
|
165
|
+
lines.push(` 不足: ${g}`);
|
|
166
|
+
}
|
|
167
|
+
lines.push("", "意図しない変更の候補:");
|
|
168
|
+
if (!result.unplanned.length)
|
|
169
|
+
lines.push(" (見つかっていません)");
|
|
170
|
+
for (const u of result.unplanned)
|
|
171
|
+
lines.push(` - ${u.text}${u.evidence.length ? `(根拠: ${u.evidence.join(", ")})` : ""}`);
|
|
172
|
+
if (result.checks.length)
|
|
173
|
+
lines.push("", "人が確かめる点:", ...result.checks.map((c) => ` - ${c}`));
|
|
174
|
+
lines.push("", ...qualityLines(input, result));
|
|
175
|
+
lines.push("", `読めた範囲: ${result.coverage.read}`, `読めなかった範囲: ${result.coverage.unread || "(なし)"}`, "", `範囲: ${TASK_REVIEW_SCOPE}`);
|
|
176
|
+
}
|
|
177
|
+
return lines.join("\n");
|
|
178
|
+
}
|