@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,3 +1,4 @@
|
|
|
1
|
+
import { applySourceOps, criterionSubject, readCriterionSources, RequirementInputError, settleSources, sourceSeq, sourcesKey } from "./requirementSource.js";
|
|
1
2
|
/**
|
|
2
3
|
* タスクの受け入れ基準(acceptanceCriteria)と、作業した側が項目ごとに残す証拠(acceptanceEvidence)の規則。
|
|
3
4
|
* CLI・API・画面で同じものを使う(保存は core/requestOps.ts の createTask / updateTask がこれで確かめる)。
|
|
@@ -8,6 +9,10 @@
|
|
|
8
9
|
* 変えたら、その証拠は「再確認が必要」(stale)として達成に数えない。基準を消しても証拠は「対応する基準のない証拠」(orphan)として残す
|
|
9
10
|
* - 結果は met(満たした)/ unmet(満たせなかった)/ unverified(確かめていない)。met は証拠の本文が要る
|
|
10
11
|
* - 証拠は作業した側の申告で、レビューの判定ではない。不足があっても完了・済みを拒まない(不足は読めるようにするだけ)
|
|
12
|
+
* - 根拠の種類(basis)は結果と別に持つ: 未確認 / 申告のみ / 読んで確認(参照先)/ 検査結果あり(コマンド・結果・対象)。
|
|
13
|
+
* どれも作業した側の申告で、P3 は検査を実行しない。読んで確認と検査結果ありは方法の違いで、正しさの上下は付けない。
|
|
14
|
+
* 人の「済み」はタスクごとの確認(checkedAt)で、根拠の種類には入れない。根拠の無い古い証拠は書き換えず、読むときだけ
|
|
15
|
+
* unverified は未確認、ほかは「申告のみ(種類未記録)」として扱う(本文から推し量って格上げしない)
|
|
11
16
|
* - 直接編集で壊れた項目は黙って消さず、problems として知らせる。problems があるタスクの基準・証拠は操作で変えず、
|
|
12
17
|
* 関係のない更新ではファイルの元の値をそのまま書き戻す(core/store/collection.ts の keepRaw)
|
|
13
18
|
*/
|
|
@@ -26,8 +31,25 @@ export const ACCEPTANCE_LIMITS = {
|
|
|
26
31
|
/** 証拠1件の文字数 */
|
|
27
32
|
evidence: 20000,
|
|
28
33
|
};
|
|
34
|
+
/** 証拠の根拠の種類 */
|
|
35
|
+
export const EVIDENCE_BASIS_KINDS = ["unverified", "declaration", "read", "machine"];
|
|
36
|
+
export const isEvidenceBasisKind = (v) => typeof v === "string" && EVIDENCE_BASIS_KINDS.includes(v);
|
|
37
|
+
export const EVIDENCE_BASIS_LABEL = {
|
|
38
|
+
unverified: "未確認",
|
|
39
|
+
declaration: "申告のみ",
|
|
40
|
+
read: "読んで確認",
|
|
41
|
+
machine: "検査結果あり",
|
|
42
|
+
};
|
|
43
|
+
/** 根拠の説明(画面の凡例・CLI の案内で使う) */
|
|
44
|
+
export const EVIDENCE_BASIS_HINT = {
|
|
45
|
+
unverified: "まだ確かめていない",
|
|
46
|
+
declaration: "満たしたと作業した側が申告しただけ(確かめた方法の記録なし)",
|
|
47
|
+
read: "作業した側(AI を含む)がコード・資料・画面を読んで確かめた",
|
|
48
|
+
machine: "作業した側が記録した検査の結果(P3 は実行していない)",
|
|
49
|
+
};
|
|
50
|
+
export const BASIS_LIMITS = { reference: 1000, command: 1000, result: 2000, target: 300 };
|
|
29
51
|
/** ファイルに書く基準・証拠の項目(壊れていたら元の値のまま書き戻す) */
|
|
30
|
-
export const ACCEPTANCE_KEYS = ["acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq"];
|
|
52
|
+
export const ACCEPTANCE_KEYS = ["acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceSources", "acceptanceSourceSeq"];
|
|
31
53
|
/** 直接編集で書いたものも読めるよう、A<番号> 以外の英数字の id も受け付ける。新しく振るのは A<番号> だけ */
|
|
32
54
|
export const CRITERION_ID_RE = /^[A-Za-z0-9._-]{1,32}$/;
|
|
33
55
|
/** 入力が規則に合わない(何も書いていない)。CLI は使い方の誤り、API は 400 */
|
|
@@ -85,15 +107,23 @@ export function readAcceptance(d) {
|
|
|
85
107
|
problems.push(`${at} の result が読めません(${ACCEPTANCE_RESULTS.join(" / ")})`);
|
|
86
108
|
else if (o.result === "met" && !body.trim())
|
|
87
109
|
problems.push(`${at} は met ですが証拠が空です`);
|
|
88
|
-
else
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
110
|
+
else {
|
|
111
|
+
const basis = o.basis === undefined || o.basis === null ? undefined : readBasis(o.basis);
|
|
112
|
+
if (typeof basis === "string")
|
|
113
|
+
problems.push(`${at} の根拠(basis)が読めません: ${basis}`);
|
|
114
|
+
else if (basis && basisMismatch(o.result, basis))
|
|
115
|
+
problems.push(`${at} の根拠(basis)が結果と合いません: ${basisMismatch(o.result, basis)}`);
|
|
116
|
+
else
|
|
117
|
+
evidence.push({
|
|
118
|
+
criterionId: id,
|
|
119
|
+
criterionText: text(o.criterionText)?.trim() ?? "",
|
|
120
|
+
result: o.result,
|
|
121
|
+
evidence: body.trim(),
|
|
122
|
+
...(basis ? { basis } : {}),
|
|
123
|
+
recordedAt: iso(o.recordedAt) ?? new Date(0).toISOString(),
|
|
124
|
+
...(text(o.recordedBy) ? { recordedBy: text(o.recordedBy) } : {}),
|
|
125
|
+
});
|
|
126
|
+
}
|
|
97
127
|
}
|
|
98
128
|
out.acceptanceEvidence = evidence;
|
|
99
129
|
}
|
|
@@ -104,10 +134,104 @@ export function readAcceptance(d) {
|
|
|
104
134
|
else
|
|
105
135
|
problems.push("acceptanceSeq が読めません");
|
|
106
136
|
}
|
|
137
|
+
// 基準ごとの要求の根拠(shared/requirementSource.ts)
|
|
138
|
+
const sources = readCriterionSources(d.acceptanceSources, problems);
|
|
139
|
+
if (sources)
|
|
140
|
+
out.acceptanceSources = sources;
|
|
141
|
+
const sourceSeqValue = readSourceSeq(d.acceptanceSourceSeq, problems);
|
|
142
|
+
if (sourceSeqValue !== undefined)
|
|
143
|
+
out.acceptanceSourceSeq = sourceSeqValue;
|
|
107
144
|
if (problems.length)
|
|
108
145
|
out.acceptanceProblems = problems;
|
|
109
146
|
return out;
|
|
110
147
|
}
|
|
148
|
+
/** 根拠に振った最後の番号(acceptanceSourceSeq)を読む。無ければ undefined、読めなければ problems に理由 */
|
|
149
|
+
export function readSourceSeq(v, problems) {
|
|
150
|
+
if (v === undefined || v === null)
|
|
151
|
+
return undefined;
|
|
152
|
+
const n = Number(v);
|
|
153
|
+
if (Number.isInteger(n) && n >= 0)
|
|
154
|
+
return n;
|
|
155
|
+
problems.push("acceptanceSourceSeq が読めません");
|
|
156
|
+
return undefined;
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* 基準ごとの根拠の次の番号の起点(振った最後の番号): 保存した番号・今ある記録・floor(旧データの完了の記録の写しに残る番号など)の最大。
|
|
160
|
+
* 消して記録にも写しにも残っていない番号は分からない(使い直しうる)
|
|
161
|
+
*/
|
|
162
|
+
export function lastSourceSeq(s, floor = 0) {
|
|
163
|
+
return sourceSeq(s.acceptanceSources ?? [], Math.max(s.acceptanceSourceSeq ?? 0, floor));
|
|
164
|
+
}
|
|
165
|
+
/** ファイルの根拠を読む(読めなければ理由の文) */
|
|
166
|
+
function readBasis(v) {
|
|
167
|
+
try {
|
|
168
|
+
return cleanBasis(v);
|
|
169
|
+
}
|
|
170
|
+
catch (e) {
|
|
171
|
+
return e instanceof Error ? e.message : String(e);
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* 入力の根拠を確かめて保存する形にする(前後の空白を除く)。知らない種類・要る項目の欠け・長すぎるは AcceptanceInputError
|
|
176
|
+
*/
|
|
177
|
+
export function cleanBasis(v) {
|
|
178
|
+
if (!v || typeof v !== "object")
|
|
179
|
+
throw new AcceptanceInputError("根拠は { kind, ... } の形で指定してください");
|
|
180
|
+
const o = v;
|
|
181
|
+
if (!isEvidenceBasisKind(o.kind))
|
|
182
|
+
throw new AcceptanceInputError(`根拠の種類は ${EVIDENCE_BASIS_KINDS.join(" / ")} のどれかです: ${String(o.kind)}`);
|
|
183
|
+
const field = (key, label) => {
|
|
184
|
+
const t = (text(o[key]) ?? "").trim();
|
|
185
|
+
if (!t)
|
|
186
|
+
throw new AcceptanceInputError(`根拠「${EVIDENCE_BASIS_LABEL[o.kind]}」には${label}(${key})が要ります`);
|
|
187
|
+
if (t.length > BASIS_LIMITS[key])
|
|
188
|
+
throw new AcceptanceInputError(`根拠の${label}(${key})は ${BASIS_LIMITS[key]} 文字までです(${t.length} 文字)`);
|
|
189
|
+
return t;
|
|
190
|
+
};
|
|
191
|
+
switch (o.kind) {
|
|
192
|
+
case "unverified":
|
|
193
|
+
case "declaration":
|
|
194
|
+
return { kind: o.kind };
|
|
195
|
+
case "read":
|
|
196
|
+
return { kind: "read", reference: field("reference", "読んだもの") };
|
|
197
|
+
case "machine":
|
|
198
|
+
return { kind: "machine", command: field("command", "検査のコマンド"), result: field("result", "検査の結果"), target: field("target", "対象(参照先とコミット)") };
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
/** 結果と根拠の組み合わせが合わなければ理由。met / unmet に未確認は付けない、unverified は未確認だけ */
|
|
202
|
+
export function basisMismatch(result, basis) {
|
|
203
|
+
if (result === "unverified" && basis.kind !== "unverified")
|
|
204
|
+
return `unverified(未検証)の根拠は「未確認」だけです(${EVIDENCE_BASIS_LABEL[basis.kind]} は付けられません)`;
|
|
205
|
+
if (result !== "unverified" && basis.kind === "unverified")
|
|
206
|
+
return `${result}(${ACCEPTANCE_RESULT_LABEL[result]})に根拠「未確認」は付けられません(確かめていないなら結果を unverified にします)`;
|
|
207
|
+
return undefined;
|
|
208
|
+
}
|
|
209
|
+
/** 根拠を省いた新しい入力の既定(unverified は未確認、ほかは申告のみ) */
|
|
210
|
+
export const defaultBasis = (result) => (result === "unverified" ? { kind: "unverified" } : { kind: "declaration" });
|
|
211
|
+
/** 読むときの根拠。古い証拠(basis なし)は recorded: false で、unverified は未確認・ほかは申告のみと解釈する */
|
|
212
|
+
export function evidenceBasisOf(e) {
|
|
213
|
+
return e.basis ? { basis: e.basis, recorded: true } : { basis: defaultBasis(e.result), recorded: false };
|
|
214
|
+
}
|
|
215
|
+
/** 根拠の短い表示(例: 「検査結果あり」「申告のみ(種類未記録)」) */
|
|
216
|
+
export function basisLabel(e) {
|
|
217
|
+
const { basis, recorded } = evidenceBasisOf(e);
|
|
218
|
+
return `${EVIDENCE_BASIS_LABEL[basis.kind]}${recorded ? "" : "(種類未記録)"}`;
|
|
219
|
+
}
|
|
220
|
+
/** 根拠の詳しい行(参照先・コマンド・結果・対象。CLI の show と画面で同じ並び) */
|
|
221
|
+
export function basisDetail(basis) {
|
|
222
|
+
switch (basis.kind) {
|
|
223
|
+
case "read":
|
|
224
|
+
return [{ label: "読んだもの", value: basis.reference }];
|
|
225
|
+
case "machine":
|
|
226
|
+
return [
|
|
227
|
+
{ label: "コマンド", value: basis.command },
|
|
228
|
+
{ label: "検査の結果", value: basis.result },
|
|
229
|
+
{ label: "対象", value: basis.target },
|
|
230
|
+
];
|
|
231
|
+
default:
|
|
232
|
+
return [];
|
|
233
|
+
}
|
|
234
|
+
}
|
|
111
235
|
function qualitySourceOf(v) {
|
|
112
236
|
if (!v || typeof v !== "object")
|
|
113
237
|
return undefined;
|
|
@@ -137,7 +261,13 @@ export function applyAcceptanceOps(state, ops, at) {
|
|
|
137
261
|
}
|
|
138
262
|
let criteria = [...(state.acceptanceCriteria ?? [])];
|
|
139
263
|
let evidence = [...(state.acceptanceEvidence ?? [])];
|
|
264
|
+
let sources = [...(state.acceptanceSources ?? [])];
|
|
140
265
|
let seq = lastSeq(state);
|
|
266
|
+
let sourceSeqNow = lastSourceSeq(state, at.sourceSeqFloor);
|
|
267
|
+
const subjectOf = (s) => {
|
|
268
|
+
const c = criteria.find((x) => x.id === s.criterionId);
|
|
269
|
+
return c ? criterionSubject(c.text) : undefined;
|
|
270
|
+
};
|
|
141
271
|
const find = (id) => {
|
|
142
272
|
const c = criteria.find((x) => x.id === id);
|
|
143
273
|
if (!c)
|
|
@@ -185,9 +315,23 @@ export function applyAcceptanceOps(state, ops, at) {
|
|
|
185
315
|
if (body.length > ACCEPTANCE_LIMITS.evidence)
|
|
186
316
|
throw new AcceptanceInputError(`${op.id} の証拠は ${ACCEPTANCE_LIMITS.evidence} 文字までです(${body.length} 文字)`);
|
|
187
317
|
const prev = evidence.find((e) => e.criterionId === c.id);
|
|
188
|
-
|
|
318
|
+
// 根拠を省いた入力(古い CLI・画面)は、同じ結果の前の証拠の根拠をそのまま使う(無ければ既定)。古い証拠を開いて同じ値で
|
|
319
|
+
// 保存し直しても、根拠を足したことにはならない
|
|
320
|
+
const basis = op.basis !== undefined ? cleanBasis(op.basis) : prev && prev.result === op.result ? prev.basis : defaultBasis(op.result);
|
|
321
|
+
const mismatch = basis && basisMismatch(op.result, basis);
|
|
322
|
+
if (mismatch)
|
|
323
|
+
throw new AcceptanceInputError(`${op.id}: ${mismatch}`);
|
|
324
|
+
if (prev && prev.result === op.result && prev.evidence === body && prev.criterionText === c.text && sameBasis(prev.basis, basis))
|
|
189
325
|
break;
|
|
190
|
-
const entry = {
|
|
326
|
+
const entry = {
|
|
327
|
+
criterionId: c.id,
|
|
328
|
+
criterionText: c.text,
|
|
329
|
+
result: op.result,
|
|
330
|
+
evidence: body,
|
|
331
|
+
...(basis ? { basis } : {}),
|
|
332
|
+
recordedAt: at.now,
|
|
333
|
+
...(at.actor ? { recordedBy: at.actor } : {}),
|
|
334
|
+
};
|
|
191
335
|
evidence = prev ? evidence.map((e) => (e === prev ? entry : e)) : [...evidence, entry];
|
|
192
336
|
break;
|
|
193
337
|
}
|
|
@@ -197,21 +341,54 @@ export function applyAcceptanceOps(state, ops, at) {
|
|
|
197
341
|
evidence = evidence.filter((e) => e.criterionId !== op.id);
|
|
198
342
|
break;
|
|
199
343
|
}
|
|
344
|
+
case "source": {
|
|
345
|
+
const c = find(op.id);
|
|
346
|
+
const target = op.source.id;
|
|
347
|
+
if (target !== undefined && !sources.some((x) => x.id === target && x.criterionId === c.id)) {
|
|
348
|
+
throw new AcceptanceInputError(`${c.id} に根拠の記録 ${target} はありません${sources.some((x) => x.criterionId === c.id) ? `(${sources.filter((x) => x.criterionId === c.id).map((x) => x.id).join(", ")})` : ""}`);
|
|
349
|
+
}
|
|
350
|
+
try {
|
|
351
|
+
const r = applySourceOps(sources, [op.source], { now: at.now, actor: at.actor, subjectOf, requestSources: at.requestSources ?? [], criterionId: c.id, seq: sourceSeqNow });
|
|
352
|
+
sources = r.list;
|
|
353
|
+
sourceSeqNow = r.seq;
|
|
354
|
+
}
|
|
355
|
+
catch (e) {
|
|
356
|
+
if (e instanceof RequirementInputError)
|
|
357
|
+
throw new AcceptanceInputError(`${c.id}: ${e.message}`);
|
|
358
|
+
throw e;
|
|
359
|
+
}
|
|
360
|
+
break;
|
|
361
|
+
}
|
|
200
362
|
default:
|
|
201
363
|
throw new AcceptanceInputError(`知らない操作です: ${String(op.op)}`);
|
|
202
364
|
}
|
|
203
365
|
}
|
|
366
|
+
// 基準の文を変えた・消した記録の確認は効かなくなる(履歴へ移す。消した基準の記録は対応先不明として残す)
|
|
367
|
+
sources = settleSources(sources, subjectOf, at.now);
|
|
204
368
|
return {
|
|
205
369
|
acceptanceCriteria: criteria.length ? criteria : undefined,
|
|
206
370
|
acceptanceEvidence: evidence.length ? evidence : undefined,
|
|
207
371
|
acceptanceSeq: seq > 0 ? seq : undefined,
|
|
372
|
+
acceptanceSources: sources.length ? sources : undefined,
|
|
373
|
+
acceptanceSourceSeq: sourceSeqNow > 0 ? sourceSeqNow : undefined,
|
|
208
374
|
};
|
|
209
375
|
}
|
|
210
|
-
/**
|
|
376
|
+
/**
|
|
377
|
+
* 旧データの根拠の採番の下限: 完了の記録の写し(acceptance.sources)に残る番号。採番を保存する前のタスクで、消した記録の番号を
|
|
378
|
+
* 使い直さないため(写しにも残っていない番号は分からない)
|
|
379
|
+
*/
|
|
380
|
+
export const recordedSourceSeq = (records) => (records ?? []).reduce((n, r) => sourceSeq(r.acceptance?.sources ?? [], n), 0);
|
|
381
|
+
/** 採番(基準・根拠の振った最後の番号)が変わったか。中身(acceptanceChanged)とは別に保存するかを決める */
|
|
382
|
+
export const acceptanceSeqChanged = (a, b) => (a.acceptanceSeq ?? 0) !== (b.acceptanceSeq ?? 0) || (a.acceptanceSourceSeq ?? 0) !== (b.acceptanceSourceSeq ?? 0);
|
|
383
|
+
/** 保存した根拠の比較の鍵(項目の順によらない) */
|
|
384
|
+
const basisKey = (b) => (b ? JSON.stringify(Object.entries(b).sort(([x], [y]) => x.localeCompare(y))) : "");
|
|
385
|
+
const sameBasis = (a, b) => basisKey(a) === basisKey(b);
|
|
386
|
+
/** 基準・証拠の中身が変わったか(並び・文言・結果・証拠・根拠・要求の根拠の記録。記録の日時と変更者・採番は見ない)。人の「済み」を外す判断に使う */
|
|
211
387
|
export function acceptanceChanged(a, b) {
|
|
212
388
|
const key = (s) => JSON.stringify([
|
|
213
389
|
(s.acceptanceCriteria ?? []).map((c) => [c.id, c.text]),
|
|
214
|
-
(s.acceptanceEvidence ?? []).map((e) => [e.criterionId, e.criterionText, e.result, e.evidence]),
|
|
390
|
+
(s.acceptanceEvidence ?? []).map((e) => [e.criterionId, e.criterionText, e.result, e.evidence, basisKey(e.basis)]),
|
|
391
|
+
sourcesKey(s.acceptanceSources),
|
|
215
392
|
]);
|
|
216
393
|
return key(a) !== key(b);
|
|
217
394
|
}
|
|
@@ -229,15 +406,33 @@ export function acceptanceStatus(t) {
|
|
|
229
406
|
});
|
|
230
407
|
const orphans = evidence.filter((e) => !criteria.some((c) => c.id === e.criterionId));
|
|
231
408
|
const ids = (s) => items.filter((i) => i.state === s).map((i) => i.id);
|
|
409
|
+
const metByBasis = Object.fromEntries(EVIDENCE_BASIS_KINDS.map((k) => [k, 0]));
|
|
410
|
+
const declarationOnly = [];
|
|
411
|
+
for (const i of items) {
|
|
412
|
+
if (i.state !== "met" || !i.evidence)
|
|
413
|
+
continue;
|
|
414
|
+
const kind = evidenceBasisOf(i.evidence).basis.kind;
|
|
415
|
+
metByBasis[kind] += 1;
|
|
416
|
+
if (kind === "declaration")
|
|
417
|
+
declarationOnly.push(i.id);
|
|
418
|
+
}
|
|
232
419
|
const shortfalls = [
|
|
233
420
|
...(ids("missing").length ? [`証拠なし: ${ids("missing").join(", ")}`] : []),
|
|
234
421
|
...(ids("unmet").length ? [`満たせなかった: ${ids("unmet").join(", ")}`] : []),
|
|
235
422
|
...(ids("unverified").length ? [`未検証: ${ids("unverified").join(", ")}`] : []),
|
|
236
423
|
...(ids("stale").length ? [`基準を変えた後の再確認が必要: ${ids("stale").join(", ")}`] : []),
|
|
424
|
+
// 注意(完了・済みは拒まない): 満たしたと申告しただけで、確かめた方法の記録が無い
|
|
425
|
+
...(declarationOnly.length ? [`申告のみの met(確かめた方法の記録なし): ${declarationOnly.join(", ")}`] : []),
|
|
237
426
|
...(orphans.length ? [`対応する基準のない証拠: ${orphans.map((e) => e.criterionId).join(", ")}`] : []),
|
|
238
427
|
...problems.map((p) => `読めない: ${p}`),
|
|
239
428
|
];
|
|
240
|
-
return { total: criteria.length, met: ids("met").length, items, orphans, problems, shortfalls };
|
|
429
|
+
return { total: criteria.length, met: ids("met").length, metByBasis, declarationOnly, items, orphans, problems, shortfalls };
|
|
430
|
+
}
|
|
431
|
+
export function evidenceSummary(t) {
|
|
432
|
+
const s = acceptanceStatus(t);
|
|
433
|
+
if (!s)
|
|
434
|
+
return undefined;
|
|
435
|
+
return { met: s.met, total: s.total, declarationOnly: s.declarationOnly.length, metByBasis: s.metByBasis, problems: s.problems.length > 0 };
|
|
241
436
|
}
|
|
242
437
|
// --- CLI の証拠の入力 -----------------------------------------------------------
|
|
243
438
|
/** `A1=met:本文` / `A1=unverified`(本文は省ける。met は本文が要る) */
|
|
@@ -281,6 +476,42 @@ export function parseEvidenceFile(src) {
|
|
|
281
476
|
throw new AcceptanceInputError(`証拠のファイルに ${dup} が2回あります`);
|
|
282
477
|
return out;
|
|
283
478
|
}
|
|
479
|
+
/**
|
|
480
|
+
* 証拠の JSON(構造化)。[{ id, result, evidence?, basis? }] の並びで、record と同じ規則で読む。
|
|
481
|
+
* 例: [{"id":"A1","result":"met","evidence":"対象のテストが通った","basis":{"kind":"machine","command":"pnpm vitest run test/x.test.ts","result":"終了コード 0","target":"p3:abc1234"}}]
|
|
482
|
+
*/
|
|
483
|
+
export function parseEvidenceJson(src) {
|
|
484
|
+
let raw;
|
|
485
|
+
try {
|
|
486
|
+
raw = JSON.parse(src);
|
|
487
|
+
}
|
|
488
|
+
catch (e) {
|
|
489
|
+
throw new AcceptanceInputError(`証拠の JSON が読めません: ${e instanceof Error ? e.message : String(e)}`);
|
|
490
|
+
}
|
|
491
|
+
if (!Array.isArray(raw) || !raw.length)
|
|
492
|
+
throw new AcceptanceInputError("証拠の JSON は [{ id, result, evidence?, basis? }] の並び(1件以上)にしてください");
|
|
493
|
+
const out = raw.map((x, i) => {
|
|
494
|
+
const at = `証拠の JSON の ${i + 1} 件目`;
|
|
495
|
+
if (!x || typeof x !== "object" || Array.isArray(x))
|
|
496
|
+
throw new AcceptanceInputError(`${at} が { id, result, ... } になっていません`);
|
|
497
|
+
const o = x;
|
|
498
|
+
const unknownKeys = Object.keys(o).filter((k) => !["id", "result", "evidence", "basis"].includes(k));
|
|
499
|
+
if (unknownKeys.length)
|
|
500
|
+
throw new AcceptanceInputError(`${at} に知らない項目があります: ${unknownKeys.join(", ")}(id・result・evidence・basis)`);
|
|
501
|
+
const id = typeof o.id === "string" ? o.id.trim() : "";
|
|
502
|
+
if (!CRITERION_ID_RE.test(id))
|
|
503
|
+
throw new AcceptanceInputError(`${at} の id が読めません`);
|
|
504
|
+
if (!isAcceptanceResult(o.result))
|
|
505
|
+
throw new AcceptanceInputError(`${at}(${id})の result は ${ACCEPTANCE_RESULTS.join(" / ")} のどれかです`);
|
|
506
|
+
if (o.evidence !== undefined && typeof o.evidence !== "string")
|
|
507
|
+
throw new AcceptanceInputError(`${at}(${id})の evidence は文字列です`);
|
|
508
|
+
return { op: "record", id, result: o.result, evidence: o.evidence ?? "", ...(o.basis !== undefined ? { basis: cleanBasis(o.basis) } : {}) };
|
|
509
|
+
});
|
|
510
|
+
const dup = out.map((e) => e.id).find((id, i, a) => a.indexOf(id) !== i);
|
|
511
|
+
if (dup)
|
|
512
|
+
throw new AcceptanceInputError(`証拠の JSON に ${dup} が2回あります`);
|
|
513
|
+
return out;
|
|
514
|
+
}
|
|
284
515
|
// --- Preflight のタスク案の基準 ----------------------------------------------------
|
|
285
516
|
/**
|
|
286
517
|
* タスク案の基準(drafts/D1.md の acceptanceCriteria)を読む。Codex・手元のエージェントが書いた文の並び(["…"])も、
|
|
@@ -342,11 +573,54 @@ export function tidyDraftCriteria(items) {
|
|
|
342
573
|
}
|
|
343
574
|
/** 基準の並びが同じか(id と文。タスク案の編集の競合を見る) */
|
|
344
575
|
export const sameCriteria = (a, b) => JSON.stringify((a ?? []).map((c) => [c.id, c.text])) === JSON.stringify((b ?? []).map((c) => [c.id, c.text]));
|
|
345
|
-
/**
|
|
346
|
-
export
|
|
576
|
+
/** タスク案の要求の根拠の記録が同じか(案の編集の競合を見る) */
|
|
577
|
+
export const sameSources = (a, b) => sourcesKey(a) === sourcesKey(b);
|
|
578
|
+
/**
|
|
579
|
+
* タスク案の基準からタスクの基準を作る(案の ID を残し、振った最後の番号を引き継ぐ)。要求の根拠の記録も写す: 要望の記録を参照した
|
|
580
|
+
* 記録(from)は、採用するときの要望の記録の内容を写し直す(内容が変われば確認は再確認が必要になる。要望の確認は引き継がない)
|
|
581
|
+
*/
|
|
582
|
+
export function criteriaForTask(criteria, sources, requestSources, now = new Date().toISOString(), sourceSeqSaved) {
|
|
347
583
|
if (!criteria?.length)
|
|
348
584
|
return {};
|
|
349
|
-
|
|
585
|
+
const ids = new Set(criteria.map((c) => c.id));
|
|
586
|
+
const copied = (sources ?? [])
|
|
587
|
+
.filter((x) => ids.has(x.criterionId))
|
|
588
|
+
.map((x) => {
|
|
589
|
+
const src = x.from ? requestSources?.find((r) => r.id === x.from) : undefined;
|
|
590
|
+
if (!src)
|
|
591
|
+
return { ...x };
|
|
592
|
+
const { target: _t, source: _s, basis: _b, ...rest } = x;
|
|
593
|
+
return { ...rest, ...(src.target ? { target: src.target } : {}), ...(src.source ? { source: src.source } : {}), ...(src.basis ? { basis: src.basis } : {}) };
|
|
594
|
+
});
|
|
595
|
+
const subjectOf = (x) => {
|
|
596
|
+
const c = criteria.find((y) => y.id === x.criterionId);
|
|
597
|
+
return c ? criterionSubject(c.text) : undefined;
|
|
598
|
+
};
|
|
599
|
+
const settled = settleSources(copied, subjectOf, now);
|
|
600
|
+
// 根拠の番号は案で振った最後の番号を引き継ぐ(写さなかった記録・案で消した記録の番号も使い直さない)
|
|
601
|
+
const lastSource = lastSourceSeq({ acceptanceSources: [...(sources ?? [])], acceptanceSourceSeq: sourceSeqSaved });
|
|
602
|
+
return {
|
|
603
|
+
acceptanceCriteria: criteria.map((c) => ({ ...c })),
|
|
604
|
+
acceptanceSeq: lastSeq({ acceptanceCriteria: [...criteria] }) || undefined,
|
|
605
|
+
...(settled.length ? { acceptanceSources: settled } : {}),
|
|
606
|
+
...(lastSource > 0 ? { acceptanceSourceSeq: lastSource } : {}),
|
|
607
|
+
};
|
|
608
|
+
}
|
|
609
|
+
/**
|
|
610
|
+
* タスク案の基準ごとの要求の根拠への操作を当てる(案の基準の文を対象にする)。規則に合わなければ AcceptanceInputError
|
|
611
|
+
*/
|
|
612
|
+
export function applyDraftSourceOps(criteria, sources, ops, at, sourceSeqSaved) {
|
|
613
|
+
const next = applyAcceptanceOps({ acceptanceCriteria: [...(criteria ?? [])], acceptanceSources: [...(sources ?? [])], acceptanceSourceSeq: sourceSeqSaved }, ops.map((o) => ({ op: "source", ...o })), at);
|
|
614
|
+
return { sources: next.acceptanceSources ?? [], seq: next.acceptanceSourceSeq ?? 0 };
|
|
615
|
+
}
|
|
616
|
+
/** タスク案の基準を直した後の根拠の記録(文を変えた基準の確認は効かなくなる。消した基準の記録は対応先不明として残す) */
|
|
617
|
+
export function settleDraftSources(criteria, sources, now) {
|
|
618
|
+
if (!sources?.length)
|
|
619
|
+
return undefined;
|
|
620
|
+
return settleSources(sources, (x) => {
|
|
621
|
+
const c = (criteria ?? []).find((y) => y.id === x.criterionId);
|
|
622
|
+
return c ? criterionSubject(c.text) : undefined;
|
|
623
|
+
}, now);
|
|
350
624
|
}
|
|
351
625
|
// --- 画面の基準の編集 ---------------------------------------------------------------
|
|
352
626
|
/**
|