@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 { apiError } from "../../core/errorOutcome.js";
|
|
1
2
|
import { Hono } from "hono";
|
|
2
3
|
import { streamSSE } from "hono/streaming";
|
|
3
4
|
import { z } from "zod";
|
|
@@ -5,30 +6,31 @@ import { normalizeTaskId } from "../../shared/refs.js";
|
|
|
5
6
|
import { REQUEST_STATUSES, TASK_STATUSES } from "../../shared/types.js";
|
|
6
7
|
import { listTasks, progress, resolve } from "../../core/ops.js";
|
|
7
8
|
import { ConflictError, NotFoundError } from "../../core/store/collection.js";
|
|
8
|
-
import { ACCEPTANCE_RESULTS,
|
|
9
|
-
import {
|
|
10
|
-
import {
|
|
11
|
-
import {
|
|
12
|
-
import {
|
|
9
|
+
import { ACCEPTANCE_RESULTS, acceptanceStatus } from "../../features/requirements/shared/acceptance.js";
|
|
10
|
+
import { requestRequirementView } from "../../features/requirements/shared/requirementSource.js";
|
|
11
|
+
import { MILESTONE_REVIEW_SECTIONS, RISK_STATES, TASK_REVIEW_SECTIONS } from "../../features/retro/shared/retrospective.js";
|
|
12
|
+
import { confirmRetrospectiveTarget, judgeRisk, retrospectiveView } from "../../features/retro/core/retrospective.js";
|
|
13
|
+
import { metricsRoutes } from "../../features/metrics/server/metricsRoutes.js";
|
|
14
|
+
import { requestReview, reviewCandidates, taskReview } from "../../features/records/core/reviewCandidates.js";
|
|
15
|
+
import { taskQualityDiff } from "../../features/quality/shared/quality.js";
|
|
16
|
+
import { qualityTemplate, qualityView, updateQuality } from "../../features/quality/core/quality.js";
|
|
17
|
+
import { diagnoseQuality, improvementDraft, registerImprovement } from "../../features/quality/core/qualityImprovement.js";
|
|
13
18
|
import { ATTACHMENT_LIMITS, ATTACHMENT_TYPES, AttachmentError, safeFileName } from "../../core/store/attachments.js";
|
|
14
19
|
import { bodyLimit } from "hono/body-limit";
|
|
15
|
-
import {
|
|
16
|
-
import { ArchivedTaskReadError, getArchivedTask, listArchivedTasks } from "../../core/store/archivedTasks.js";
|
|
20
|
+
import { getArchivedTask, listArchivedTasks } from "../../core/store/archivedTasks.js";
|
|
17
21
|
import { completionCheckOf, hierarchyNow, resolvedIssue } from "../../core/requestStatus.js";
|
|
18
|
-
import {
|
|
22
|
+
import { hierarchyView } from "../../core/hierarchy.js";
|
|
19
23
|
import { supersededMarks } from "../../core/supersede.js";
|
|
20
24
|
import { chatgptRoutes } from "./chatgptRoutes.js";
|
|
21
|
-
import { userThemeRoutes, userThemeScriptRoute } from "
|
|
22
|
-
import { UserConfigError } from "../../core/userConfig.js";
|
|
25
|
+
import { userThemeRoutes, userThemeScriptRoute } from "../../features/settings/server/userThemeRoutes.js";
|
|
23
26
|
import { AI_MANIFEST } from "./manifest.js";
|
|
24
|
-
import { repoRoutes } from "
|
|
25
|
-
import { releaseNoteRoutes } from "
|
|
26
|
-
import { milestoneReviewRoutes } from "
|
|
27
|
-
import { taskReviewRoutes } from "
|
|
28
|
-
import { archiveTask, checkMilestoneRemoval, createRequest, createTask, orderChildren, updateRequest, updateTask, importQuality } from "../../core/requestOps.js";
|
|
27
|
+
import { repoRoutes } from "../../features/settings/server/repoRoutes.js";
|
|
28
|
+
import { releaseNoteRoutes } from "../../features/releaseNotes/server/releaseNoteRoutes.js";
|
|
29
|
+
import { milestoneReviewRoutes } from "../../features/milestoneReview/server/milestoneReviewRoutes.js";
|
|
30
|
+
import { taskReviewRoutes } from "../../features/taskReview/server/taskReviewRoutes.js";
|
|
31
|
+
import { archiveTask, checkMilestoneRemoval, createRequest, createTask, orderChildren, updateRequest, updateTask, importQuality, saveClarifyAnswer, updateRequirement, recordPremise } from "../../core/requestOps.js";
|
|
29
32
|
import { PREFLIGHT_RUNNERS } from "../../shared/preflightRunner.js";
|
|
30
|
-
import {
|
|
31
|
-
import { CancelRefusedError, ChildConflictError, ChildDraftsChangedError, DraftConflictError, PulseInputError } from "../../core/preflight/service.js";
|
|
33
|
+
import { CancelRefusedError, PulseInputError } from "../../core/preflight/service.js";
|
|
32
34
|
/**
|
|
33
35
|
* ブラウザ用のローカル API。AI や人の操作は CLI(ファイルを直接読み書き)が主で、ここは画面のため。
|
|
34
36
|
*
|
|
@@ -39,6 +41,7 @@ import { CancelRefusedError, ChildConflictError, ChildDraftsChangedError, DraftC
|
|
|
39
41
|
* /requests/:rid/preflight[/:run] Preflight
|
|
40
42
|
* /requests/:rid/notes Preflight へのメモ
|
|
41
43
|
* /release-notes[/:mid] マイルストーンのリリースノート(releaseNoteRoutes.ts)
|
|
44
|
+
* /metrics[?milestone=<ID>] 開発の指標(features/metrics。読むだけ)
|
|
42
45
|
* /milestones/:mid/review[s...] マイルストーンレビュー(milestoneReviewRoutes.ts)
|
|
43
46
|
* /requests/:rid/tasks/:tid/review[s...] タスクの AI レビュー(taskReviewRoutes.ts)
|
|
44
47
|
*/
|
|
@@ -62,8 +65,11 @@ const acceptanceOp = z.discriminatedUnion("op", [
|
|
|
62
65
|
z.object({ op: z.literal("edit"), id: z.string(), text: z.string() }),
|
|
63
66
|
z.object({ op: z.literal("remove"), id: z.string() }),
|
|
64
67
|
z.object({ op: z.literal("order"), ids: z.array(z.string()) }),
|
|
65
|
-
|
|
68
|
+
// basis(根拠)の形と組み合わせは shared/acceptance.ts の cleanBasis・basisMismatch が確かめる(規則を2か所に書かない)
|
|
69
|
+
z.object({ op: z.literal("record"), id: z.string(), result: z.enum(ACCEPTANCE_RESULTS), evidence: z.string().default(""), basis: z.custom((v) => v !== null && typeof v === "object").optional() }),
|
|
66
70
|
z.object({ op: z.literal("unrecord"), id: z.string() }),
|
|
71
|
+
// 基準ごとの要求の根拠(出典・確認)。操作の形と規則は shared/requirementSource.ts の applySourceOps が確かめる
|
|
72
|
+
z.object({ op: z.literal("source"), id: z.string(), source: z.custom((v) => v !== null && typeof v === "object") }),
|
|
67
73
|
]);
|
|
68
74
|
/** 品質基準の操作(規則は shared/quality.ts。CLI の p3 quality と同じ) */
|
|
69
75
|
const qualityCheck = z.discriminatedUnion("kind", [
|
|
@@ -167,51 +173,17 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
167
173
|
const { ws, preflight } = ctx;
|
|
168
174
|
const notify = opts.notify ?? ((kind) => ws.emit({ type: "changed", kind }));
|
|
169
175
|
const app = new Hono();
|
|
176
|
+
// エラーの状態と code は core/errorOutcome.ts の表(CLI の終了コードと同じ所)。版の競合は今の値(要望・タスク)を添える
|
|
170
177
|
app.onError((err, c) => {
|
|
171
|
-
if (err instanceof NotFoundError)
|
|
172
|
-
return c.json({ error: err.message }, 404);
|
|
173
|
-
// 409 は code で分ける: rev_conflict(読み直してやり直す)/ stale_input(評価のあとで要望が変わった。再評価する)
|
|
174
|
-
if (err instanceof DraftConflictError || err instanceof ChildConflictError)
|
|
175
|
-
return c.json({ error: err.message, code: "rev_conflict", current: err.current }, 409);
|
|
176
|
-
if (err instanceof ChildDraftsChangedError)
|
|
177
|
-
return c.json({ error: err.message, code: err.code }, 409);
|
|
178
|
-
if (err instanceof StaleInputError)
|
|
179
|
-
return c.json({ error: err.message, code: err.code, inputMatch: err.match }, 409);
|
|
180
178
|
if (err instanceof ConflictError) {
|
|
181
179
|
const current = err.id.includes("/") ? ws.task(err.id) : c.req.param("tid") ? ws.tasksOf(c.req.param("rid")).get(err.id) : ws.requests.get(err.id);
|
|
182
180
|
return c.json({ error: err.message, code: "rev_conflict", current }, 409);
|
|
183
181
|
}
|
|
184
|
-
// 要望の親子(code: hierarchy_invalid・hierarchy_busy・has_children・has_parent。何も書いていない)
|
|
185
|
-
if (err instanceof HierarchyError)
|
|
186
|
-
return c.json({ error: err.message, code: err.code, ...err.detail }, 409);
|
|
187
|
-
// マイルストーンの版が違う(編集を始めた後に他で変わった。何も書いていない)
|
|
188
|
-
if (err instanceof MilestonesConflictError)
|
|
189
|
-
return c.json({ error: err.message, code: err.code, milestonesVersion: err.current }, 409);
|
|
190
182
|
if (err instanceof z.ZodError)
|
|
191
183
|
return c.json({ error: "invalid input", issues: err.issues }, 400);
|
|
192
|
-
|
|
193
|
-
if (
|
|
194
|
-
return c.json(
|
|
195
|
-
// 停止の操作が規則に合わない・止まったままの移動(何も書いていない)
|
|
196
|
-
if (err instanceof BlockInputError)
|
|
197
|
-
return c.json({ error: err.message, code: err.code }, err.code === "blocked" ? 409 : 400);
|
|
198
|
-
// 品質基準(版が違えば 409 quality_conflict。何も書いていない)
|
|
199
|
-
if (err instanceof QualityInputError)
|
|
200
|
-
return c.json({ error: err.message, code: err.code }, err.code === "quality_conflict" ? 409 : 400);
|
|
201
|
-
// 改善要望(診断が変わった・登録先がある → 409。作っていない)
|
|
202
|
-
if (err instanceof ImprovementError) {
|
|
203
|
-
const status = err.code === "not_found" ? 404 : err.code === "diagnosis_changed" || err.code === "existing" || err.code === "closed_existing" ? 409 : 400;
|
|
204
|
-
return c.json({ error: err.message, code: err.code, ...(err.existing ? { existing: err.existing } : {}) }, status);
|
|
205
|
-
}
|
|
206
|
-
// 個人設定のファイルが読めない・壊れている(ファイルは変えていない)
|
|
207
|
-
if (err instanceof UserConfigError)
|
|
208
|
-
return c.json({ error: err.message }, 500);
|
|
209
|
-
// データのフォルダが読めない(メモリ上の状態は変えていない)
|
|
210
|
-
if (err instanceof ReloadError)
|
|
211
|
-
return c.json({ error: err.message }, 503);
|
|
212
|
-
// アーカイブのフォルダ・ファイルが読めない(無いのは 404)
|
|
213
|
-
if (err instanceof ArchivedTaskReadError)
|
|
214
|
-
return c.json({ error: err.message, code: err.code }, 500);
|
|
184
|
+
const r = apiError(err);
|
|
185
|
+
if (r)
|
|
186
|
+
return c.json(r.body, r.status);
|
|
215
187
|
console.error(err);
|
|
216
188
|
return c.json({ error: err.message }, 400);
|
|
217
189
|
});
|
|
@@ -271,6 +243,8 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
271
243
|
const id = rid(c);
|
|
272
244
|
return c.json({
|
|
273
245
|
request: ws.requests.get(id),
|
|
246
|
+
// 要求の根拠の記録と回答の状態(shared/requirementSource.ts。申告の記録で、P3 の保証ではない)
|
|
247
|
+
requirement: requestRequirementView(ws.requests.require(id)),
|
|
274
248
|
tasks: ws.tasksOf(id).list(),
|
|
275
249
|
runs: await Promise.all((await preflight.list(id)).map((r) => preflight.withInputMatch(id, r))),
|
|
276
250
|
// 対応済なのに未完了のタスクがある(外部の直接編集など)
|
|
@@ -278,6 +252,8 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
278
252
|
// 親子(parent・ancestors・children・hierarchyIssues)と、対応済にできるか(blocker・見送りで対象外の子 excluded)
|
|
279
253
|
...(await hierarchyView(ws, id)),
|
|
280
254
|
completion: completionCheckOf(ws, hierarchyNow(ws), id),
|
|
255
|
+
// 見直しが必要(候補): 要望自身(対応済・完了済)・タスクごとの概要・配下の件数(読むだけ。shared/reviewCandidate.ts)
|
|
256
|
+
review: requestReview(ctx, id),
|
|
281
257
|
// 置き換えられたタスクの印(T001 → 置き換えた側)
|
|
282
258
|
superseded: Object.fromEntries([...supersededMarks(ws)].filter(([ref]) => ref.startsWith(`${id}/`)).map(([ref, m]) => [ref.slice(id.length + 1), m])),
|
|
283
259
|
});
|
|
@@ -286,6 +262,84 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
286
262
|
const { rev, ...patch } = requestPatch.parse(await c.req.json());
|
|
287
263
|
return c.json(await updateRequest(ctx, rid(c), unnull(patch), { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) }));
|
|
288
264
|
});
|
|
265
|
+
/** 要望の要求の根拠の記録を変える(CLI の p3 source と同じ操作。順に当て、1つでも合わなければ何も書かない) */
|
|
266
|
+
app.post("/requests/:rid/sources", async (c) => {
|
|
267
|
+
const { ops, rev } = z.object({ ops: z.array(z.custom((v) => v !== null && typeof v === "object")).min(1), rev: z.number().int().optional() }).parse(await c.req.json());
|
|
268
|
+
const r = await updateRequirement(ctx, rid(c), ops, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
|
|
269
|
+
return c.json({ request: r, requirement: requestRequirementView(r) });
|
|
270
|
+
});
|
|
271
|
+
/**
|
|
272
|
+
* Preflight の確認事項に回答する(CLI の p3 answer と同じ)。answer: null で回答を消す。回答は要望に残し、過去の run は書き換えない。
|
|
273
|
+
* 回答しただけでは根拠の記録を確認記録ありにしない。再評価は別に明示して始める
|
|
274
|
+
*/
|
|
275
|
+
/**
|
|
276
|
+
* 前提の変更(外部の規則の変更など)を記録する。add: {op: "add", targets, reason, condition} / ack: {op: "ack", id, target, condition}。
|
|
277
|
+
* 過去の完了の記録・状態・済みは変えない。対象が無い・規則に合わなければ 400 premise_invalid、rev が違えば 409(何も書かない)
|
|
278
|
+
*/
|
|
279
|
+
app.get("/requests/:rid/premises", (c) => c.json(ws.requests.require(rid(c)).premiseChanges ?? []));
|
|
280
|
+
app.post("/requests/:rid/premises", async (c) => {
|
|
281
|
+
const b = z
|
|
282
|
+
.discriminatedUnion("op", [
|
|
283
|
+
z.object({ op: z.literal("add"), targets: z.array(z.string()), reason: z.string(), condition: z.string(), rev: z.number().int().optional() }),
|
|
284
|
+
z.object({ op: z.literal("ack"), id: z.string(), target: z.string(), condition: z.string(), rev: z.number().int().optional() }),
|
|
285
|
+
])
|
|
286
|
+
.parse(await c.req.json());
|
|
287
|
+
const { rev, ...op } = b;
|
|
288
|
+
const r = await recordPremise(ctx, rid(c), op, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
|
|
289
|
+
return c.json({ change: r.change, rev: r.request.rev });
|
|
290
|
+
});
|
|
291
|
+
/** 要望の振り返り: 確定した対象・訂正の履歴・候補(採用を終えた run と根拠)。読むだけ */
|
|
292
|
+
app.get("/requests/:rid/retrospective", async (c) => c.json(await retrospectiveView(ctx, rid(c))));
|
|
293
|
+
/** 振り返りの対象を確定する {run, reason?(2回目からの訂正で必須), version?(読んだときの版)} */
|
|
294
|
+
app.post("/requests/:rid/retrospective/target", async (c) => {
|
|
295
|
+
const b = z.object({ run: z.string().min(1), reason: z.string().optional(), version: z.number().int().optional() }).parse(await c.req.json());
|
|
296
|
+
return c.json(await confirmRetrospectiveTarget(ctx, rid(c), { run: b.run, reason: b.reason }, { expectedVersion: b.version, actor: actorOf(c) }));
|
|
297
|
+
});
|
|
298
|
+
/** リスクの確認を記録する {risk(0 から), state, facts?, scope?, reason?, evidence: [根拠の指定], version?}(人の判断。追記) */
|
|
299
|
+
app.post("/requests/:rid/retrospective/judgments", async (c) => {
|
|
300
|
+
const ev = z.discriminatedUnion("kind", [
|
|
301
|
+
z.object({ kind: z.literal("task_review"), task: z.string(), run: z.string(), section: z.enum(TASK_REVIEW_SECTIONS), index: z.number().int().optional() }),
|
|
302
|
+
z.object({ kind: z.literal("milestone_review"), milestone: z.string(), run: z.string(), section: z.enum(MILESTONE_REVIEW_SECTIONS), index: z.number().int().optional(), reason: z.string().optional() }),
|
|
303
|
+
z.object({ kind: z.literal("rework"), task: z.string(), history: z.string() }),
|
|
304
|
+
z.object({ kind: z.literal("manual"), reference: z.string(), note: z.string().optional() }),
|
|
305
|
+
]);
|
|
306
|
+
const b = z
|
|
307
|
+
.object({ risk: z.number().int().min(0), state: z.enum(RISK_STATES), facts: z.string().optional(), scope: z.string().optional(), reason: z.string().optional(), evidence: z.array(ev).default([]), version: z.number().int().optional() })
|
|
308
|
+
.parse(await c.req.json());
|
|
309
|
+
const { version, ...input } = b;
|
|
310
|
+
return c.json(await judgeRisk(ctx, rid(c), input, { expectedVersion: version, actor: actorOf(c) }));
|
|
311
|
+
});
|
|
312
|
+
/** 見直しが必要(候補)の一覧(完了したタスクと対応済・完了済の要望。完了済みも含む。?request= でその要望だけ) */
|
|
313
|
+
app.route("/", metricsRoutes(ctx));
|
|
314
|
+
app.get("/revisit", (c) => {
|
|
315
|
+
const request = c.req.query("request");
|
|
316
|
+
return c.json(reviewCandidates(ctx, request ? { request } : {}));
|
|
317
|
+
});
|
|
318
|
+
app.post("/requests/:rid/answers", async (c) => {
|
|
319
|
+
const b = z
|
|
320
|
+
.object({
|
|
321
|
+
run: z.string(),
|
|
322
|
+
question: z.string(),
|
|
323
|
+
answer: z.string().nullable(),
|
|
324
|
+
by: z.string().optional(),
|
|
325
|
+
on: z.string().optional(),
|
|
326
|
+
source: z.string().optional(),
|
|
327
|
+
basis: z.string().optional(),
|
|
328
|
+
links: z.array(z.string()).optional(),
|
|
329
|
+
rev: z.number().int().optional(),
|
|
330
|
+
})
|
|
331
|
+
.parse(await c.req.json());
|
|
332
|
+
const id = rid(c);
|
|
333
|
+
const run = await preflight.get(id, b.run);
|
|
334
|
+
if (!run)
|
|
335
|
+
throw new NotFoundError(b.run);
|
|
336
|
+
const q = run.assessment?.clarifications?.find((x) => x.id === b.question);
|
|
337
|
+
if (!q)
|
|
338
|
+
return c.json({ error: `${b.run} に確認事項 ${b.question} はありません`, code: "requirement_invalid" }, 400);
|
|
339
|
+
const input = b.answer === null ? null : { answer: b.answer, by: b.by, on: b.on, source: b.source, basis: b.basis, links: b.links };
|
|
340
|
+
const r = await saveClarifyAnswer(ctx, id, b.run, q, input, { expectedRev: expectedRev(c, b), actor: actorOf(c) });
|
|
341
|
+
return c.json({ request: r.request, answer: r.answer ?? null, requirement: requestRequirementView(r.request) });
|
|
342
|
+
});
|
|
289
343
|
/** 子の表示順(直下の子を全部、上から順に。CLI の request order と同じ操作) */
|
|
290
344
|
app.put("/requests/:rid/child-order", async (c) => {
|
|
291
345
|
const { children, rev } = childOrderInput.parse(await c.req.json());
|
|
@@ -324,8 +378,8 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
324
378
|
});
|
|
325
379
|
// --- tasks(要望の中) --------------------------------------------------------
|
|
326
380
|
app.get("/requests/:rid/tasks", (c) => {
|
|
327
|
-
const { status, area, q, blocked } = c.req.query();
|
|
328
|
-
return c.json(listTasks(ctx, { request: rid(c), status: status?.split(","), area, q, blocked: blocked === "true" }));
|
|
381
|
+
const { status, area, q, blocked, review } = c.req.query();
|
|
382
|
+
return c.json(listTasks(ctx, { request: rid(c), status: status?.split(","), area, q, blocked: blocked === "true", review: review === "true" }));
|
|
329
383
|
});
|
|
330
384
|
app.post("/requests/:rid/tasks", async (c) => {
|
|
331
385
|
const raw = taskCreate.parse(await c.req.json());
|
|
@@ -337,7 +391,7 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
337
391
|
});
|
|
338
392
|
app.get("/requests/:rid/tasks/:tid", (c) => {
|
|
339
393
|
const task = ws.tasksOf(rid(c)).require(tid(c));
|
|
340
|
-
return c.json({ task, superseded: supersededMarks(ws).get(task.ref) ?? [], acceptance: acceptanceStatus(task) ?? null });
|
|
394
|
+
return c.json({ task, superseded: supersededMarks(ws).get(task.ref) ?? [], acceptance: acceptanceStatus(task) ?? null, review: taskReview(ctx, task) ?? null });
|
|
341
395
|
});
|
|
342
396
|
app.patch("/requests/:rid/tasks/:tid", async (c) => {
|
|
343
397
|
const { rev, checked, acceptance, blockOp: bop, ...patch } = taskPatch.parse(await c.req.json());
|
|
@@ -349,8 +403,17 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
349
403
|
...(acceptance?.length ? { acceptance } : {}),
|
|
350
404
|
};
|
|
351
405
|
// 置き換えられたタスクを作業中にしたら警告を添える(操作は続ける)。基準・証拠が変わって済みを外したら checkCleared
|
|
352
|
-
|
|
353
|
-
|
|
406
|
+
// 完了の記録が壊れていて足せなかったら completionSkipped(状態は変えた)
|
|
407
|
+
const { task, warnings, reopened, reopenedAncestors, checkCleared, completionSkipped, reworkSkipped } = await updateTask(ctx, rid(c), tid(c), next, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
|
|
408
|
+
return c.json({
|
|
409
|
+
...task,
|
|
410
|
+
...(warnings.length ? { warnings } : {}),
|
|
411
|
+
...(reopened ? { reopened } : {}),
|
|
412
|
+
...(reopenedAncestors ? { reopenedAncestors } : {}),
|
|
413
|
+
...(checkCleared ? { checkCleared } : {}),
|
|
414
|
+
...(completionSkipped ? { completionSkipped } : {}),
|
|
415
|
+
...(reworkSkipped ? { reworkSkipped } : {}),
|
|
416
|
+
});
|
|
354
417
|
});
|
|
355
418
|
/** 今の品質基準との差分(読むだけ。タスクは書き換えない) */
|
|
356
419
|
app.get("/requests/:rid/tasks/:tid/quality-diff", (c) => {
|
|
@@ -497,22 +560,28 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
497
560
|
// expectedTitle: 編集を始めたときの題(制御用。案には書かない)。今の題と違えば 409 で書かない
|
|
498
561
|
// acceptanceCriteria: 受け入れ基準の並び全体(id は残し、無い項目に振る)。expectedCriteria: 編集を始めたときの基準(違えば 409)
|
|
499
562
|
const criterion = z.object({ id: z.string().nullish(), text: z.string() });
|
|
500
|
-
|
|
563
|
+
// sourceOps: 基準ごとの要求の根拠への操作。expectedSources: 編集を始めたときの根拠の記録(違えば 409。根拠だけの編集の競合も見る)
|
|
564
|
+
const { expectedTitle, expectedCriteria, expectedSources, ...patch } = z
|
|
501
565
|
.object({
|
|
502
566
|
title: z.string(),
|
|
503
567
|
description: z.string(),
|
|
504
568
|
include: z.boolean(),
|
|
505
569
|
repo: z.string().nullable(),
|
|
506
570
|
acceptanceCriteria: z.array(criterion),
|
|
571
|
+
sourceOps: z.array(z.object({ id: z.string(), source: z.custom((v) => v !== null && typeof v === "object") })),
|
|
507
572
|
expectedTitle: z.string(),
|
|
508
573
|
expectedCriteria: z.array(z.object({ id: z.string(), text: z.string() })),
|
|
574
|
+
expectedSources: z.array(z.custom((v) => v !== null && typeof v === "object")),
|
|
509
575
|
})
|
|
510
576
|
.partial()
|
|
511
577
|
.parse(await c.req.json());
|
|
512
578
|
if (patch.acceptanceCriteria !== undefined && expectedCriteria === undefined) {
|
|
513
579
|
return c.json({ error: "受け入れ基準を直すときは expectedCriteria(編集を始めたときの基準)を渡してください", code: "acceptance_invalid" }, 400);
|
|
514
580
|
}
|
|
515
|
-
|
|
581
|
+
if (patch.sourceOps?.length && expectedSources === undefined) {
|
|
582
|
+
return c.json({ error: "要求の根拠を直すときは expectedSources(編集を始めたときの根拠の記録)を渡してください", code: "requirement_invalid" }, 400);
|
|
583
|
+
}
|
|
584
|
+
return c.json(await preflight.updateDraft(rid(c), c.req.param("run"), c.req.param("key"), patch, { expectedTitle, expectedCriteria, expectedSources, actor: actorOf(c) }));
|
|
516
585
|
});
|
|
517
586
|
/** 子の要望の案(分割の run)を直す。expectedTitle は上と同じ */
|
|
518
587
|
app.patch("/requests/:rid/preflight/:run/children/:key", async (c) => {
|
|
@@ -537,8 +606,8 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
537
606
|
});
|
|
538
607
|
// --- 横断 --------------------------------------------------------------
|
|
539
608
|
app.get("/tasks", (c) => {
|
|
540
|
-
const { status, area, q, blocked } = c.req.query();
|
|
541
|
-
return c.json(listTasks(ctx, { status: status?.split(","), area, q, blocked: blocked === "true" }));
|
|
609
|
+
const { status, area, q, blocked, review } = c.req.query();
|
|
610
|
+
return c.json(listTasks(ctx, { status: status?.split(","), area, q, blocked: blocked === "true", review: review === "true" }));
|
|
542
611
|
});
|
|
543
612
|
/** 参照・タイトルから対象を特定する(?request= で今の要望を優先) */
|
|
544
613
|
app.get("/resolve", (c) => c.json(resolve(ctx, c.req.query("q") ?? "", c.req.query("request"))));
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/** 成果物の文字列からコミットを取り出す(…/commit/<sha> の URL か、sha だけの文字列) */
|
|
2
|
+
export function commitsInOutput(output) {
|
|
3
|
+
const out = new Set();
|
|
4
|
+
for (const m of output.matchAll(/\/commit\/([0-9a-f]{7,40})\b/gi))
|
|
5
|
+
out.add(m[1].toLowerCase());
|
|
6
|
+
const bare = output.trim();
|
|
7
|
+
if (/^[0-9a-f]{7,40}$/i.test(bare))
|
|
8
|
+
out.add(bare.toLowerCase());
|
|
9
|
+
return [...out];
|
|
10
|
+
}
|
|
@@ -12,7 +12,7 @@ export function normalizeInput(r) {
|
|
|
12
12
|
}
|
|
13
13
|
/** 保存すると同じになる本文か */
|
|
14
14
|
export const sameText = (a, b) => normalizeText(a) === normalizeText(b);
|
|
15
|
-
const FIELD_LABEL = { title: "タイトル", body: "本文", parent: "親の目的(題・本文)", children: "子の要望" };
|
|
15
|
+
const FIELD_LABEL = { title: "タイトル", body: "本文", parent: "親の目的(題・本文)", children: "子の要望", requirement: "要求の根拠・確認事項への回答" };
|
|
16
16
|
/** 変わった項目の表示(「タイトルと本文」) */
|
|
17
17
|
export const changedLabel = (fields) => (fields ?? []).map((k) => FIELD_LABEL[k]).join("と");
|
|
18
18
|
/** この run からのタスク化が終わっている(途中で止まったものは含めない) */
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@infodb/p3",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.14.0",
|
|
4
4
|
"description": "File-based project management with AI-powered preflight (Codex App Server)",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"project-management",
|
|
@@ -43,47 +43,5 @@
|
|
|
43
43
|
"hono": "^4.13.13",
|
|
44
44
|
"yaml": "^2.9.1",
|
|
45
45
|
"zod": "^4.6.5"
|
|
46
|
-
},
|
|
47
|
-
"devDependencies": {
|
|
48
|
-
"@tailwindcss/vite": "^4.3.3",
|
|
49
|
-
"@tanstack/react-router": "^1.170.41",
|
|
50
|
-
"@tanstack/router-cli": "^1.167.40",
|
|
51
|
-
"@tanstack/router-plugin": "^1.168.42",
|
|
52
|
-
"@types/node": "^24.0.0",
|
|
53
|
-
"@types/react": "^19.3.0",
|
|
54
|
-
"@types/react-dom": "^19.3.0",
|
|
55
|
-
"@vitejs/plugin-react": "^6.1.2",
|
|
56
|
-
"concurrently": "^10.0.5",
|
|
57
|
-
"oxlint": "1.87.0",
|
|
58
|
-
"oxlint-tsgolint": "7.0.2004",
|
|
59
|
-
"playwright-core": "^1.64.1",
|
|
60
|
-
"react": "^19.3.0",
|
|
61
|
-
"react-dom": "^19.3.0",
|
|
62
|
-
"react-markdown": "^10.1.0",
|
|
63
|
-
"remark-gfm": "^4.0.1",
|
|
64
|
-
"tailwindcss": "^4.3.3",
|
|
65
|
-
"tsx": "^4.23.15",
|
|
66
|
-
"typescript": "^7.0.2",
|
|
67
|
-
"vite": "^8.3.3",
|
|
68
|
-
"vitest": "^4.1.11"
|
|
69
|
-
},
|
|
70
|
-
"scripts": {
|
|
71
|
-
"dev": "pnpm demo && concurrently -n server,web -c blue,magenta \"pnpm:dev:server\" \"pnpm:dev:web\"",
|
|
72
|
-
"dev:server": "tsx watch --clear-screen=false src/cli/main.ts serve --dir .p3-demo",
|
|
73
|
-
"dev:web": "vite",
|
|
74
|
-
"build": "vite build && node scripts/build-cli.mjs",
|
|
75
|
-
"start": "pnpm demo && node bin/p3.mjs serve --dir .p3-demo",
|
|
76
|
-
"p3": "node bin/p3.mjs",
|
|
77
|
-
"demo": "tsx scripts/demo.ts",
|
|
78
|
-
"demo:reset": "tsx scripts/demo.ts --force",
|
|
79
|
-
"routes": "tsr generate",
|
|
80
|
-
"typecheck": "tsr generate && tsc --noEmit -p .",
|
|
81
|
-
"lint": "oxlint --type-aware --deny-warnings --report-unused-disable-directives-severity=error src scripts test vite.config.ts vitest.config.ts vitest.ui.config.ts",
|
|
82
|
-
"test": "vitest run",
|
|
83
|
-
"test:watch": "vitest",
|
|
84
|
-
"test:ui": "vitest run -c vitest.ui.config.ts",
|
|
85
|
-
"check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm test:ui",
|
|
86
|
-
"verify:pack": "node scripts/verify-pack.mjs",
|
|
87
|
-
"video": "node scripts/video/record.mjs"
|
|
88
46
|
}
|
|
89
47
|
}
|
package/skills/p3/SKILL.md
CHANGED
|
@@ -1,189 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: p3
|
|
3
3
|
description: infodb p3(P³)で、このリポジトリの要望とタスクを管理する。ユーザーが要望の登録・Preflight(頼まれた評価の実行と結果の確認)・タスクの着手や完了・進捗の確認を頼んだとき、または要望 ID(261009-k7m3x の形)やタスク(T003)に触れたときに使う。
|
|
4
|
+
metadata:
|
|
5
|
+
p3-entry-version: "1"
|
|
4
6
|
---
|
|
5
7
|
|
|
6
|
-
# p3
|
|
8
|
+
# p3 でこのプロジェクトの作業を管理する(入口)
|
|
7
9
|
|
|
8
10
|
このリポジトリの作業は、infodb p3 の **要望** と、要望から生まれた **タスク** で管理する。
|
|
9
|
-
|
|
10
|
-
データのフォルダのファイルは直接編集しない。必ず CLI を通す。
|
|
11
|
+
作業の手順の本文はこのファイルには無く、動いている p3 の CLI が返す(CLI が新しくなれば手順も新しくなる)。
|
|
11
12
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
- `p3` が入っていなければ `pnpx @infodb/p3 <コマンド>` で同じように動く(`npx @infodb/p3` でもよい)
|
|
19
|
-
- 最初に `p3 whoami --json` で、操作するプロジェクト・データのフォルダ・決まり方(`via`)・変更者・今の要望・Preflight の担当
|
|
20
|
-
(`preflight.runner`。下の「Preflight を頼まれたとき」)を確かめる。
|
|
21
|
-
対象のプロジェクトは今いる場所(リポジトリ・作業ツリー)と個人設定から決まる。決まらなければ、出てきた一覧と案内に従って
|
|
22
|
-
`--project <名前>` を付ける(名前を推測で決めない)
|
|
23
|
-
- `via` が `cwd`(今いる場所で決まった)でなければ(`dir` / `project` / `legacy` / `only`)、それ以上 p3 を操作せず、
|
|
24
|
-
対象のプロジェクトでよいかユーザーに確かめる。特に `only` は登録が1つだけというだけで、p3 を使わないフォルダでも決まる。
|
|
25
|
-
推測した `--project` や `--dir` を付けて確認を避けない。ユーザーが対象を指定した・確かめた後は、その対象のまま続ける
|
|
26
|
-
- プロジェクトが無い・登録されていない(未登録)ときは、`p3 init`・`p3 join` を自分から実行しない。新しく作る(`init`)のか、
|
|
27
|
-
共有されたものに参加する(`join`)のかをユーザーに確かめる
|
|
28
|
-
- `P3_ACTOR=ai:<名前>` は変更者の記録。変更するコマンドには必ず付ける
|
|
29
|
-
- 結果は `--json` で読む。人に見せる表はオプションなしの出力でよい
|
|
30
|
-
- 終了コード: 0 成功 / 1 使い方の誤り(メッセージに次にすることが出る)/ 2 見つからない / 3 競合(`show --brief` で読み直してやり直す)
|
|
31
|
-
- 詳細は、作業に使うときは短い出力 `show <要望ID>/T003 --brief --json` / `request show <要望ID> --brief --json` で読む
|
|
32
|
-
(本文・状態・rev・依存とその状態・置き換えの注意・成果物・ブランチだけが出る)
|
|
33
|
-
- 迷ったら `p3 help`
|
|
34
|
-
|
|
35
|
-
## 人と AI の役割
|
|
36
|
-
|
|
37
|
-
| 操作 | するのは |
|
|
38
|
-
| --- | --- |
|
|
39
|
-
| 要望の登録(`request new`) | AI も人も |
|
|
40
|
-
| Preflight(評価・細分化。`preflight`) | 担当(`whoami --json` の `preflight.runner`)で決まる。**codex** は人(人がチャットで対象の要望の手元の評価を明示的に頼んだときだけ AI が評価する)、**agent** は人に頼まれた AI(手元で評価する)。どちらも AI から始めない(下の「Preflight を頼まれたとき」) |
|
|
41
|
-
| タスク化(`accept`) | **人だけ** |
|
|
42
|
-
| タスクの着手・完了(`move ... doing` / `done`)と成果物の登録、作業中に見つけたタスクの追加 | AI も人も |
|
|
43
|
-
| 要望を対応済にする(`request set <要望ID> status=resolved`) | 作業を終えた AI(か人) |
|
|
44
|
-
| 要望の完了済(`done`)・見送り(`rejected`)、タスクの済み(`check`) | **人だけ** |
|
|
45
|
-
|
|
46
|
-
## 要望を登録する(ユーザーから新しい作業を頼まれたとき)
|
|
47
|
-
|
|
48
|
-
1. `request new "<タイトル>" --body "<背景・やりたいこと・完了条件を箇条書きで>"`(任意で `--area src/web --tag ui --due YYYY-MM-DD --milestone <id>`)
|
|
49
|
-
2. 登録したら要望 ID をユーザーに伝えて終える。**Preflight(評価・細分化)は自分から始めず、タスク化(`accept`)は人が行う。**
|
|
50
|
-
Preflight を勧めたり、実行してよいか尋ねたりもしない。人に Preflight を頼まれたら、下の「Preflight を頼まれたとき」に従う
|
|
51
|
-
(担当で分ける)。人がタスク化を終えたら、タスクを進める
|
|
52
|
-
|
|
53
|
-
人が行った Preflight の内容を聞かれたら、`drafts <要望ID>` で評価とタスク案を読んで答えてよい(読むだけ)。
|
|
54
|
-
`drafts` には「調べた範囲」(参照先ごとに読んだか)と「判断の根拠」(確かめた / 推測)も出る。答えるときは、見ていない参照先や
|
|
55
|
-
推測の根拠に基づく判断であることを伝える。参照先の登録(`repo add` / `repo path`)はユーザーに頼まれたときだけ行う。
|
|
56
|
-
評価の確認事項(questions)への回答を頼まれたら、`preflight <要望ID> --note "..." --note-only` でメモとして残す(実行はしない)。
|
|
57
|
-
|
|
58
|
-
## Preflight を頼まれたとき(担当で分ける)
|
|
59
|
-
|
|
60
|
-
誰が Preflight を実行するかは、プロジェクトの担当(`whoami --json` の `preflight.runner`)で決まる。担当は人が
|
|
61
|
-
`p3 init` か `p3 config set preflight.runner=...` で決める(AI は変えない)。
|
|
62
|
-
|
|
63
|
-
- **`codex`**(`preflight` の項目が無い古い p3 も同じ): Preflight は人が `p3 preflight` か画面から実行する(Codex が評価する)。
|
|
64
|
-
AI は `p3 preflight <要望ID>`(`--prepare` の無い通常の実行)をしない。人がチャットで対象の要望を挙げて、手元の評価を明示的に
|
|
65
|
-
頼んだとき(例: 「要望 261009-k7m3x の Preflight を Claude Code のこのチャットで実行して」)だけ、下の手順で評価する。
|
|
66
|
-
「Preflight して」とだけ頼まれたら、断らずに、人が `p3 preflight <要望ID>`・画面で実行するのか、このチャットで手元の評価をするのかを確かめる
|
|
67
|
-
- **`agent`**(Codex を使えない環境): 人に Preflight を頼まれたら(「Preflight して」「要望 <ID> の Preflight をして」など。
|
|
68
|
-
「このチャットで」のような言い方は求めない)、下の手順で手元で評価する。`p3 preflight <要望ID>`(`--prepare` の無い通常の実行)はしない
|
|
69
|
-
- **`runner` が `null`**(担当が読めない。理由は `problem`): `agent` と推測しない。`problem` を人に伝え、`codex` と同じ扱いにする
|
|
70
|
-
- どの担当でも: 要望の登録・タスクの作業・子の要望の作成・分割の採用のついでに自分から始めない(勧めたり、実行してよいか尋ねたりも
|
|
71
|
-
しない)。対象の要望が分からなければ確かめる。子の要望も親と同じ担当・同じ手順。P3 はモデルを呼ばない(`claude -p` や API キーは使わない)
|
|
72
|
-
|
|
73
|
-
1. `whoami --json` で対象のプロジェクトと担当を確かめ(`via` の扱いは上と同じ)、`request show <要望ID> --brief --json` で頼まれた要望かを確かめる
|
|
74
|
-
2. 準備: `preflight <要望ID> --prepare --json`(変更なので `P3_ACTOR` を付ける)。評価対象を固定し、`instructions`(指示のファイル)・
|
|
75
|
-
`outputs`(書く成果物)・`run`(PF-...)・`next`(次のコマンド)を返す。始められない(同じ要望の Preflight が待っている・実行中)
|
|
76
|
-
ときは止めて人に伝える(自分の判断で `--cancel` しない。`--acknowledge-stopped` は、人が run の止まっていることを確かめて
|
|
77
|
-
中断にするよう頼んだときだけ)
|
|
78
|
-
3. `instructions` のファイルを最後まで読み、その「制約」に従って評価する。指示の長い文はスキルに写さない(P3 が要望ごとに作る)。
|
|
79
|
-
参照先は読むだけ(変更・git の書き込み・アプリの起動をしない)。書き込むのは `outputs` に挙がった、その run の成果物だけ
|
|
80
|
-
(`assessment.json`・`drafts/`・`children/`・`ui/index.json`・`ui/src/`)。これが「データのフォルダを直接編集しない」の唯一の例外で、
|
|
81
|
-
`run.json`・`instructions.md`・ほかの要望やタスクのファイルは書かない。指示のファイル・添付・参照先が読めなければ、読んだことにせず、
|
|
82
|
-
評価に未確認として書く(読めない理由も人に伝える)
|
|
83
|
-
4. 書き終えたら `preflight <要望ID> --complete --run <run> --json`。`code: invalid_result` なら `problems` を直して同じコマンドをやり直す
|
|
84
|
-
(run は待ったまま。ファイルを消して作り直さない)
|
|
85
|
-
5. `drafts <要望ID>` で取り込んだ評価(判定・確認事項・タスク案か子の案)を読み、要約を人に伝えて終える。**タスク化(`accept`)・タスクの着手はしない**
|
|
86
|
-
(人が案を確かめて採用してから、「タスクを進める」に従う)
|
|
87
|
-
- 人にやめるよう頼まれたら `preflight <要望ID> --cancel --run <run>`
|
|
88
|
-
|
|
89
|
-
## タスクを進める
|
|
90
|
-
|
|
91
|
-
作業は **作業先のリポジトリの、要望のブランチ** で行う。タスクごとの作業先とブランチは
|
|
92
|
-
`show <要望ID>/T003 --brief --json` の `work`(`repo`・`branch`)に出る(要望全体は `request show <要望ID> --brief --json` の `branches`)。
|
|
93
|
-
|
|
94
|
-
1. 作業先に入る: `work.repo` のリポジトリ(場所は `repo ls`)で、`work.branch` に切り替える(無ければ最新の既定のブランチから作る。
|
|
95
|
-
作業ツリーを使うかどうかと置き場所は任せる)。`work.repo` が `null`(作業先なし: 調査・人の判断など)なら移動は要らない。ブランチの無い
|
|
96
|
-
作業先(git でないフォルダ)はそのフォルダで作業する。このマシンのパスが未登録(`work.registered` が false)なら、場所をユーザーに
|
|
97
|
-
聞いて登録してもらい(`repo path <名前> <パス>`)、`whoami` で今の要望と今いる参照先を確かめてから始める
|
|
98
|
-
2. `ls --req <要望ID>` で一覧、`show <要望ID>/T003 --brief --json` で中身と依存を読む。`dependencies` の `status` が
|
|
99
|
-
`done` でない依存があるタスクから始めない(`null` は相手が見つからない。完了とは扱わず、ユーザーに確かめる)。
|
|
100
|
-
**置き換えられたタスク**(`ls` の `※置換`、`--json` の `superseded` と `warnings`)からは始めない。残っていれば扱いをユーザーに確かめる
|
|
101
|
-
(不要ならユーザーの了承を得て `archive`)。`move` が警告(`warnings`)を返したら、作業を止めてユーザーに伝える
|
|
102
|
-
**受け入れ基準**(`--brief --json` の `item.acceptanceCriteria`。A1, A2, ...)があれば、着手する前に読み、何を確かめれば完了かを
|
|
103
|
-
決めてから作業する(無いタスクは本文の完了条件で判断する)。`[Q1]` で始まる基準はプロジェクトの品質基準
|
|
104
|
-
(`p3 quality`)から取り込んだもので、確認の方法(検査のコマンドと成功の条件か、人の確認の方法)が書いてある
|
|
105
|
-
3. 着手: `move T003 doing --req <要望ID>`
|
|
106
|
-
4. 作業し、プロジェクトのテストを通したら、**コミットする前に** 完了にする:
|
|
107
|
-
`move T003 done --req <要望ID> --output <成果物> --record - < record.md`(成果物が複数あれば `--output` を繰り返す)。
|
|
108
|
-
成果物は今あるもの(変えたファイル・ドキュメントのパスや短い説明)。まだ無い URL や仮のコミットの SHA は書かない(URL は 8 で足す)。
|
|
109
|
-
**変更の記録(`--record`)は必須**: 何を変えたか(振る舞いの言葉で)・なぜ・入れた決まり・やめたもの を Markdown で短く書く。
|
|
110
|
-
後の Preflight が経緯を調べるとき、タスクの解析・リリースノートの材料として読む(パスの羅列ではなく、目的と決まりを書く)。
|
|
111
|
-
テストが通っていない・作業が途中のうちは完了にしない。
|
|
112
|
-
**受け入れ基準があるタスクは、完了と同時に基準ごとの証拠を残す**: `--evidence-file evidence.md`(見出し `## A1 met` ごとに、
|
|
113
|
-
通したテスト・実行したコマンドと結果・画面で確かめたこと・成果物の場所を書く。`--record -` と標準入力を取り合うので証拠はファイルで)。
|
|
114
|
-
結果は `met`(満たした。証拠が要る)/ `unmet`(満たせなかった)/ `unverified`(確かめていない)で、満たせなかった・確かめて
|
|
115
|
-
いない項目はそうと理由を正直に書く(推測で `met` にしない)。証拠は自分の申告で、レビューの判定ではない。
|
|
116
|
-
変更の記録(`--record`)は何を変えたか・なぜ、証拠は基準ごとの確かめた材料で、役割が違う(両方書く)。
|
|
117
|
-
未達・未検証を残して完了にしたら、そのことと理由をユーザーに伝える(不足があっても完了は拒まれないが、済みにするかは人が決める)。
|
|
118
|
-
後から証拠を足す・直すなら `evidence <T> <ID> <結果> --file 本文.md`。
|
|
119
|
-
品質基準の検査は作業する側(あなた)が実行し、証拠には実行したコマンド・参照先とコミット(未コミットならそう書く)・結果・確かめた
|
|
120
|
-
範囲・省いたならその理由を書く。P3 が実行して確かめたとは書かない(P3 はコマンドを実行しない)
|
|
121
|
-
5. 作業中に見つけた追加の作業は `new "<タイトル>" --req <要望ID> --body "..."` でタスクにする(タスクの関係は Preflight のタスク化が張るもので、手では張らない。順序は本文に書く)
|
|
122
|
-
**進められなくなったら止まっている理由を付けて終える**(安全に続けられる通常の修正・調査の途中では使わない):
|
|
123
|
-
人の判断や権限が要る・前提が崩れた・直しても調べてもテストが通らず先に進めない、などでこのタスクを続けられなくなったら、
|
|
124
|
-
`block <T> --req <要望ID> --reason "<具体的な理由>" --decision "<人に決めてほしいこと>" --json`(複数行は `--reason -` で標準入力)。
|
|
125
|
-
人への質問を新しいタスクにする代わりに、今のタスクに付ける。未着手の依存待ちのタスクを作業中にしてまで付けない。
|
|
126
|
-
返った JSON の `block` で保存できたことを確かめ、要望とタスクの ID・理由・いつから(`since`)・答えてほしいこと・確かめたこと・
|
|
127
|
-
再開のしかたをユーザーに伝えて、そのタスクの作業を終えて回答を待つ。止まったまま完了・済み・要望の対応済に進めない
|
|
128
|
-
(止まったままは完了へ動かせない)。止まっていることを避けるために基準や証拠を書き換えない。停止の履歴と完了の変更の記録(`record`)は別。
|
|
129
|
-
保存が競合・失敗したら読み直して結果を確かめ、記録できたと偽らずに伝える(タスクを変え続けて理由を覆い隠さない)
|
|
130
|
-
**回答を受けたら解除して再開する**: `unblock <T> --req <要望ID> --resolution "<回答・解決の内容>"`。人が先に解除していたら、
|
|
131
|
-
`show <T> --json` の停止の履歴で回答を読み、前提が満たされたことを確かめてから再開する。解除だけでは自動で再開しない。
|
|
132
|
-
新しい理由で止まったら、新しい停止として付ける
|
|
133
|
-
6. 要望のタスクが全部完了したら(`ls --req <要望ID>` が全部 done、成果物と検証も済み)、コミットする前に要望を **対応済** にする:
|
|
134
|
-
`request set <要望ID> status=resolved --json`。未完了のタスクがあると拒否される(終わらせるか、不要ならユーザーの了承を得て
|
|
135
|
-
`archive`)。拒否をタスクを偽って完了にする・ファイルを直接書き換えるなどで回避しない
|
|
136
|
-
7. コミットして push する。データのフォルダ(`whoami` の場所)がこの作業ツリーの中にあって git で管理されている(無視されていない)なら、
|
|
137
|
-
**要望のフォルダ(`<データのフォルダ>/requests/<要望ID>/`)の変更も実装と同じコミットに入れる**。要望とタスク・変更の記録が
|
|
138
|
-
コードと一緒に残り、後のレビュー(AI のレビューも)で、コードだけでなく「何を目的に頼まれ、何をしたか」を精査できる。
|
|
139
|
-
親子でつながる要望のフォルダも、まだコミットに入っていない変更があれば入れる: 子の要望なら**祖先の要望のフォルダ**(分割の採用・
|
|
140
|
-
子の順・状態は親に残る)、親を対応済にするときは**子孫の要望のフォルダ**(見送りにした子など、実装の無い要望)。それ以外の要望や
|
|
141
|
-
関係ない変更はまとめて add しない(`git status` でフォルダを確かめてから add する)。データのフォルダが外・別のリポジトリ・git で無視されている、または git の作業ツリー(worktree)で作業して
|
|
142
|
-
いてデータがメインの作業ツリーにあるときは、同じコミットには入らない(データの移動・写し・`git add -f` はしない。記録は p3 に
|
|
143
|
-
残り、コードとは成果物の URL で結ぶ)。commit・push に失敗したら、完了の記録はそのまま残し、公開できていないことをユーザーに
|
|
144
|
-
伝えてやり直す(完了を push できたことのように伝えない)。同じコミットに入れた要望のフォルダは、
|
|
145
|
-
マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、
|
|
146
|
-
データはブランチにある(作り直したり、別のブランチから写したりしない。親の詳細には `child_missing` が出る)
|
|
147
|
-
8. コミットや PR の URL を残すなら、後から `move T003 done --req <要望ID> --output <URL>` で足す(完了・記録・前の成果物はそのまま。
|
|
148
|
-
完了から戻さない)。要望のフォルダを同じコミットに入れているなら、この追記もコミットして同じブランチに push する(追記のコミット
|
|
149
|
-
自身の URL は残さなくてよい)。PR はユーザーに確認してから作る(本文に要望 ID とタスクの一覧)。作った PR の URL は最後のタスクに
|
|
150
|
-
足す。複数のリポジトリにまたがる要望は、関係するリポジトリの PR を全部 `--repo-output <参照先の名前>=<PR の URL>` で最後のタスクに
|
|
151
|
-
残す(例: `move T005 done --repo-output app=<URL> --repo-output infra=<URL>`。1つのリポジトリなら今までどおり `--output` でよい)。
|
|
152
|
-
マージ・要望の完了済(`done`)は人が行う
|
|
153
|
-
9. 対応済の後にタスクを足した・完了から戻したときは、要望は自動で進行中に戻る(`--json` の `reopened`)。
|
|
154
|
-
終えたらもう一度 6 で対応済にする
|
|
155
|
-
|
|
156
|
-
### 子の要望(大きい要望を分けたもの)
|
|
157
|
-
|
|
158
|
-
- 子の要望(`parent` のある要望)は、親とは別の要望として、子ごとのタスクとブランチで作業する(親のタスクにしない。
|
|
159
|
-
手順は上と同じ)。親子は `request show <要望ID> --brief --json` の `parent`・`ancestors`・`children` で読む
|
|
160
|
-
- 分割の案(Preflight の子の案)の採用(`accept`)は人が行う。子の Preflight は親と同じく、頼まれたときだけ
|
|
161
|
-
「Preflight を頼まれたとき」の担当に従う(分割の採用・子の作成から、自分で子の評価へ進まない)
|
|
162
|
-
- 子のタスクを全部終えたら、子を対応済にする(6)。親を対応済にするのは、親のタスクと見送り以外の子(`children`)が
|
|
163
|
-
全部 対応済か完了済になってから。条件を満たさなければ拒否される(理由が出る)
|
|
164
|
-
- 子にタスクを足す・完了から戻すと、対応済の親も進行中に戻る(`--json` の `reopenedAncestors`)。完了済の親は変わらず
|
|
165
|
-
`warnings`(`ancestor_done`)が出るので、作業を止めて人に伝える
|
|
166
|
-
|
|
167
|
-
## してはいけないこと
|
|
168
|
-
|
|
169
|
-
- Preflight(`preflight`)を自分から始めない・勧めない。`p3 preflight <要望ID>`(Codex で評価する通常の実行)は人が行い、AI は
|
|
170
|
-
しない。手元の評価(`--prepare` / `--complete`)は、上の「Preflight を頼まれたとき」の担当ごとの条件を満たしたときだけ
|
|
171
|
-
- タスク化(`accept`)をしない(人が行う。Preflight を頼まれたときも、評価の後にタスク化・着手へ進まない)
|
|
172
|
-
- `check`(済み)を付けない。済みは人が成果物を確認して付ける
|
|
173
|
-
- 要望のステータスを `done`(完了済)/ `rejected`(見送り)にしない(人が決める)。AI がするのは作業を終えたときの `resolved`(対応済)まで。
|
|
174
|
-
タスク化で `active` になるのは自動
|
|
175
|
-
- タスクを要望をまたいで動かさない。別の要望の作業なら、その要望にタスクを足すか、新しい要望を提案する
|
|
176
|
-
- データのフォルダ(`p3 whoami` に出る場所)や個人設定(`~/.config/infodb-p3/`)のファイルを直接書き換えない
|
|
177
|
-
(例外は、頼まれた Preflight で `--prepare` が返した run の成果物だけ)
|
|
178
|
-
- 人への質問をタスクにしない(続けられないなら今のタスクに止まっている理由を付ける)
|
|
179
|
-
- 止まっている理由を付けたまま作業を続けたり、完了・済み・対応済に進めたりしない。回答を受けずに自分で解除しない
|
|
180
|
-
- タスクの AI レビュー(`review`)を頼まれずに始めない(Codex を使い、利用者のプランを消費する)。頼まれたら Preflight と同じく担当で
|
|
181
|
-
分け、`agent` のプロジェクトでも Codex で実行するのは人が明示したときだけ(`--engine codex`)。レビューの結果を理由に済みにしない・
|
|
182
|
-
基準や証拠を書き換えない(結果は参考の記録で、済みは人が決める)
|
|
183
|
-
- 受け入れ基準を自分で消す・書き換える・並べ替えて、満たしたことにしない(基準を変える必要があれば人に確かめる。済みのタスクの
|
|
184
|
-
基準・証拠を変えると人の済みが外れる)。確かめていない項目を `met` にしない
|
|
185
|
-
|
|
186
|
-
## 状況を報告する
|
|
187
|
-
|
|
188
|
-
- 全体: `progress`(マイルストーンごと)。要望の中: `ls --req <要望ID>`
|
|
189
|
-
- 画面はユーザーが `p3 serve` で開く(既定 http://localhost:4310)。CLI の変更はそのまま画面に反映される
|
|
13
|
+
1. p3 を操作する前に `pnpx @infodb/p3 guide --json` を実行し、返った JSON の `guide`(作業の手順)を最後まで読んで、その手順に従う。
|
|
14
|
+
手順の中の `p3 <コマンド>` も、同じ呼び方(`pnpx @infodb/p3`)で呼ぶ
|
|
15
|
+
2. `guide` を取得できなければ(コマンドが無い・エラーになる・JSON が読めない)、p3 を操作しない。出たエラーと
|
|
16
|
+
呼び方(`pnpx @infodb/p3 guide --json`)を人に伝えて終える
|
|
17
|
+
3. 手順をこのファイルや AGENTS.md に写さない。このファイルを自分で書き換えない(更新は人が `p3 agents` で行う)
|