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