@infodb/p3 0.13.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.
Files changed (204) hide show
  1. package/README.md +1 -0
  2. package/bin/p3.mjs +3 -2
  3. package/dist/web/assets/{CompletionReview-gZKZrDu_.js → CompletionReview-BD7d6Yzt.js} +1 -1
  4. package/dist/web/assets/ImprovementDialog-BoAZN1KR.js +1 -0
  5. package/dist/web/assets/{Outputs-BgHalMGb.js → Outputs-D-ZouoxF.js} +1 -1
  6. package/dist/web/assets/{RequestStatus-hZcBUUIu.js → RequestStatus-Bl3fdSbM.js} +1 -1
  7. package/dist/web/assets/{Tabs-C3NmwCc3.js → Tabs-CxeceOL-.js} +1 -1
  8. package/dist/web/assets/{TagInput-B2b862qn.js → TagInput-CeAbmGRR.js} +1 -1
  9. package/dist/web/assets/TaskDrawer-BCriSnhe.js +6 -0
  10. package/dist/web/assets/_requestId-CZKMe_mC.js +1 -0
  11. package/dist/web/assets/_requestId-Fx4lLkFo.js +1 -0
  12. package/dist/web/assets/appCtx-BdxbkSZa.js +1 -0
  13. package/dist/web/assets/archive-D5IIxcSV.js +1 -0
  14. package/dist/web/assets/board-p6R9KMqd.js +1 -0
  15. package/dist/web/assets/done-BTOF188x.js +1 -0
  16. package/dist/web/assets/{draft-BvGxfD7v.js → draft-BWYpm3PD.js} +2 -2
  17. package/dist/web/assets/index-DFbY8NAR.css +2 -0
  18. package/dist/web/assets/index-Dpqi2dcC.js +12 -0
  19. package/dist/web/assets/link-D481whDt.js +1 -0
  20. package/dist/web/assets/metrics-CAzP6V8I.js +1 -0
  21. package/dist/web/assets/new-C65IJJg3.js +1 -0
  22. package/dist/web/assets/preload-helper-_dAYMct_.js +1 -0
  23. package/dist/web/assets/{release-notes-Bpdi6RdY.js → release-notes-Dtif8xsQ.js} +4 -4
  24. package/dist/web/assets/{requestData-CbFxwW5w.js → requestData-SPc36t8Q.js} +1 -1
  25. package/dist/web/assets/routes-DJj8CWuk.js +6 -0
  26. package/dist/web/assets/settings-DKJd7CLe.js +1 -0
  27. package/dist/web/assets/ui-CbEOnPnF.js +1 -0
  28. package/dist/web/assets/{workTarget-CySfKyfB.js → workTarget-DavxMs-c.js} +3 -3
  29. package/dist/web/index.html +6 -4
  30. package/docs/architecture.md +165 -71
  31. package/docs/chatgpt-sign-in.md +2 -2
  32. package/docs/development.md +87 -54
  33. package/docs/feature-inventory.md +139 -0
  34. package/docs/how-to-use.md +10 -5
  35. package/docs/installation.md +31 -8
  36. package/docs/publishing.md +32 -13
  37. package/docs/refactoring.md +332 -0
  38. package/lib/cli/agentsStatus.js +2 -1
  39. package/lib/cli/guide.md +4 -1
  40. package/lib/cli/help.js +1 -1
  41. package/lib/cli/main.js +33 -238
  42. package/lib/cli/project.js +21 -267
  43. package/lib/core/projectRegistry.js +2 -2
  44. package/lib/kit/appInfo.js +13 -0
  45. package/lib/kit/usage.js +27 -0
  46. package/lib/server/api/projectsRoutes.js +5 -5
  47. package/lib/server/server.js +7 -4
  48. package/lib/{cli → tasks/cli}/args.js +2 -2
  49. package/lib/{cli → tasks/cli}/chatgpt.js +1 -1
  50. package/lib/{cli → tasks/cli}/codex.js +1 -1
  51. package/lib/{cli → tasks/cli}/output.js +2 -2
  52. package/lib/{cli → tasks/cli}/preflightCommands.js +1 -1
  53. package/lib/tasks/cli/readOnly.js +75 -0
  54. package/lib/{cli → tasks/cli}/render.js +1 -1
  55. package/lib/{cli → tasks/cli}/requestCommands.js +6 -6
  56. package/lib/{cli → tasks/cli}/showView.js +4 -4
  57. package/lib/{cli → tasks/cli}/taskCommands.js +16 -8
  58. package/lib/tasks/cli/tasksCli.js +149 -0
  59. package/lib/{core → tasks/core}/context.js +6 -9
  60. package/lib/tasks/core/errorOutcome.js +125 -0
  61. package/lib/{core → tasks/core}/hierarchy.js +1 -1
  62. package/lib/{core → tasks/core}/ops.js +6 -4
  63. package/lib/{core → tasks/core}/preflight/codexEngine.js +2 -11
  64. package/lib/{core → tasks/core}/preflight/hostPaths.js +39 -0
  65. package/lib/{core → tasks/core}/preflight/input.js +1 -1
  66. package/lib/{core → tasks/core}/preflight/instructions.js +2 -2
  67. package/lib/{core → tasks/core}/preflight/mockEngine.js +8 -7
  68. package/lib/{core → tasks/core}/preflight/service.js +38 -13
  69. package/lib/{core → tasks/core}/preflight/uiRender.js +2 -2
  70. package/lib/{core → tasks/core}/requestOps.js +19 -14
  71. package/lib/{core → tasks/core}/reviewRuns.js +127 -22
  72. package/lib/{core → tasks/core}/store/attachments.js +3 -2
  73. package/lib/{core → tasks/core}/store/collection.js +2 -2
  74. package/lib/tasks/core/store/fieldGroups.js +30 -0
  75. package/lib/tasks/core/store/jsonRecord.js +30 -0
  76. package/lib/{core → tasks/core}/store/normalize.js +13 -26
  77. package/lib/{core → tasks/core}/store/noteStore.js +2 -2
  78. package/lib/{core → tasks/core}/store/preflightStore.js +44 -21
  79. package/lib/{core → tasks/core}/store/projectFile.js +1 -1
  80. package/lib/{core → tasks/core}/store/workspace.js +11 -5
  81. package/lib/{core → tasks/core}/userConfig.js +1 -1
  82. package/lib/{core → tasks/core}/workTargets.js +1 -1
  83. package/lib/{cli → tasks/features/metrics/cli}/metricsCommands.js +3 -3
  84. package/lib/{core/metrics → tasks/features/metrics/core}/definitions.js +19 -8
  85. package/lib/{core/metrics → tasks/features/metrics/core}/index.js +41 -17
  86. package/lib/{core/metrics → tasks/features/metrics/core}/manual.js +27 -28
  87. package/lib/tasks/features/metrics/server/metricsRoutes.js +8 -0
  88. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/code.js +2 -11
  89. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/material.js +5 -6
  90. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/review.js +2 -2
  91. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/service.js +38 -100
  92. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/store.js +3 -3
  93. package/lib/{server/api → tasks/features/milestoneReview/server}/milestoneReviewRoutes.js +7 -13
  94. package/lib/{cli → tasks/features/quality/cli}/qualityCommands.js +3 -3
  95. package/lib/{core → tasks/features/quality/core}/qualityImprovement.js +16 -15
  96. package/lib/{cli → tasks/features/records/cli}/revisitCommands.js +2 -2
  97. package/lib/{core → tasks/features/records/core}/reviewCandidates.js +26 -6
  98. package/lib/{shared → tasks/features/records/shared}/completionRecord.js +5 -3
  99. package/lib/{shared → tasks/features/records/shared}/reviewCandidate.js +13 -8
  100. package/lib/{shared → tasks/features/records/shared}/reworkHistory.js +5 -0
  101. package/lib/{cli → tasks/features/releaseNotes/cli}/releaseNotesCommands.js +7 -7
  102. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/completeRequests.js +5 -6
  103. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/generate.js +3 -14
  104. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/material.js +3 -4
  105. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/service.js +1 -1
  106. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/store.js +2 -2
  107. package/lib/{server/api → tasks/features/releaseNotes/server}/releaseNoteRoutes.js +11 -20
  108. package/lib/{cli → tasks/features/requirements/cli}/requirementCommands.js +8 -7
  109. package/lib/{shared → tasks/features/requirements/shared}/acceptance.js +41 -7
  110. package/lib/{cli → tasks/features/retro/cli}/retroCommands.js +1 -1
  111. package/lib/{core → tasks/features/retro/core}/retrospective.js +42 -53
  112. package/lib/tasks/features/settings/cli/projectSettings.js +245 -0
  113. package/lib/{cli → tasks/features/settings/cli}/userConfig.js +5 -5
  114. package/lib/{core → tasks/features/settings/core}/machineSettingsEdit.js +2 -2
  115. package/lib/{core → tasks/features/settings/core}/repoAdmin.js +3 -3
  116. package/lib/{core → tasks/features/settings/core}/userTheme.js +2 -2
  117. package/lib/{server/api → tasks/features/settings/server}/repoRoutes.js +2 -2
  118. package/lib/{server/api → tasks/features/settings/server}/userThemeRoutes.js +3 -3
  119. package/lib/{cli → tasks/features/taskReview/cli}/taskReviewCommands.js +5 -5
  120. package/lib/{core/taskReview → tasks/features/taskReview/core}/material.js +7 -8
  121. package/lib/{core/taskReview → tasks/features/taskReview/core}/review.js +2 -2
  122. package/lib/{core/taskReview → tasks/features/taskReview/core}/service.js +24 -85
  123. package/lib/{core/taskReview → tasks/features/taskReview/core}/store.js +4 -4
  124. package/lib/{server/api → tasks/features/taskReview/server}/taskReviewRoutes.js +7 -14
  125. package/lib/{server → tasks/server}/api/routes.js +24 -75
  126. package/lib/tasks/shared/commitRefs.js +10 -0
  127. package/package.json +1 -44
  128. package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +0 -1
  129. package/dist/web/assets/TaskDrawer-4BQBELXa.js +0 -6
  130. package/dist/web/assets/_requestId-BMAG1t3o.js +0 -1
  131. package/dist/web/assets/_requestId-tbg2pA2S.js +0 -1
  132. package/dist/web/assets/archive-DMl6WyOe.js +0 -1
  133. package/dist/web/assets/board-BMTcHKyt.js +0 -1
  134. package/dist/web/assets/done-CL6Nlsua.js +0 -1
  135. package/dist/web/assets/index-Dp7Fc4VI.css +0 -2
  136. package/dist/web/assets/index-KdlgMitg.js +0 -12
  137. package/dist/web/assets/metrics-Cu7gJ7Rk.js +0 -1
  138. package/dist/web/assets/new-DTXWHuFO.js +0 -1
  139. package/dist/web/assets/preload-helper-oLCrNCwz.js +0 -1
  140. package/dist/web/assets/routes-BIt8bExF.js +0 -6
  141. package/dist/web/assets/settings-CsCqF_1B.js +0 -1
  142. package/dist/web/assets/ui-BGK72r3u.js +0 -1
  143. package/lib/cli/readOnly.js +0 -53
  144. /package/lib/{core/store → kit}/frontmatter.js +0 -0
  145. /package/lib/{core/store → kit}/fsutil.js +0 -0
  146. /package/lib/{cli → tasks/cli}/format.js +0 -0
  147. /package/lib/{core → tasks/core}/chatgpt.js +0 -0
  148. /package/lib/{core → tasks/core}/machineSettings.js +0 -0
  149. /package/lib/{core → tasks/core}/preflight/carryover.js +0 -0
  150. /package/lib/{core → tasks/core}/preflight/codexImage.js +0 -0
  151. /package/lib/{core → tasks/core}/preflight/diagnose.js +0 -0
  152. /package/lib/{core → tasks/core}/preflight/docker.js +0 -0
  153. /package/lib/{core → tasks/core}/preflight/engine.js +0 -0
  154. /package/lib/{core → tasks/core}/preflight/launch.js +0 -0
  155. /package/lib/{core → tasks/core}/preflight/launcher.mjs +0 -0
  156. /package/lib/{core → tasks/core}/preflight/mock-ui.html +0 -0
  157. /package/lib/{core → tasks/core}/preflight/mock-ui.png +0 -0
  158. /package/lib/{core → tasks/core}/preflight/owner.js +0 -0
  159. /package/lib/{core → tasks/core}/preflight/render-image/Dockerfile +0 -0
  160. /package/lib/{core → tasks/core}/preflight/render-image/fonts-ja.conf +0 -0
  161. /package/lib/{core → tasks/core}/preflight/render-image/render.mjs +0 -0
  162. /package/lib/{core → tasks/core}/preflight/render.js +0 -0
  163. /package/lib/{core → tasks/core}/preflight/split.js +0 -0
  164. /package/lib/{core → tasks/core}/preflight/uiMaterials.js +0 -0
  165. /package/lib/{core → tasks/core}/preflight/wireframe.js +0 -0
  166. /package/lib/{core → tasks/core}/preflight/xlsx.js +0 -0
  167. /package/lib/{core → tasks/core}/redact.js +0 -0
  168. /package/lib/{core → tasks/core}/repoRefs.js +0 -0
  169. /package/lib/{core → tasks/core}/requestStatus.js +0 -0
  170. /package/lib/{core → tasks/core}/store/archivedTasks.js +0 -0
  171. /package/lib/{core → tasks/core}/store/dataWatcher.js +0 -0
  172. /package/lib/{core → tasks/core}/store/locate.js +0 -0
  173. /package/lib/{core → tasks/core}/supersede.js +0 -0
  174. /package/lib/{shared → tasks/features/metrics/shared}/metrics.js +0 -0
  175. /package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/mockReviewer.js +0 -0
  176. /package/lib/{shared → tasks/features/milestoneReview/shared}/milestoneReview.js +0 -0
  177. /package/lib/{core → tasks/features/quality/core}/quality.js +0 -0
  178. /package/lib/{shared → tasks/features/quality/shared}/quality.js +0 -0
  179. /package/lib/{shared → tasks/features/quality/shared}/qualityImprovement.js +0 -0
  180. /package/lib/{shared → tasks/features/quality/shared}/qualityTemplates.js +0 -0
  181. /package/lib/{core → tasks/features/records/core}/completionRefs.js +0 -0
  182. /package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/mockSummarizer.js +0 -0
  183. /package/lib/{shared → tasks/features/requirements/shared}/requirementSource.js +0 -0
  184. /package/lib/{shared → tasks/features/retro/shared}/retrospective.js +0 -0
  185. /package/lib/{core/taskReview → tasks/features/taskReview/core}/mockReviewer.js +0 -0
  186. /package/lib/{core/taskReview → tasks/features/taskReview/core}/paths.js +0 -0
  187. /package/lib/{shared → tasks/features/taskReview/shared}/taskReview.js +0 -0
  188. /package/lib/{server → tasks/server}/api/chatgptRoutes.js +0 -0
  189. /package/lib/{server → tasks/server}/api/local.js +0 -0
  190. /package/lib/{server → tasks/server}/api/manifest.js +0 -0
  191. /package/lib/{shared → tasks/shared}/dates.js +0 -0
  192. /package/lib/{shared → tasks/shared}/directTask.js +0 -0
  193. /package/lib/{shared → tasks/shared}/hierarchy.js +0 -0
  194. /package/lib/{shared → tasks/shared}/milestoneGoals.js +0 -0
  195. /package/lib/{shared → tasks/shared}/milestoneOrder.js +0 -0
  196. /package/lib/{shared → tasks/shared}/preflightInput.js +0 -0
  197. /package/lib/{shared → tasks/shared}/preflightRunner.js +0 -0
  198. /package/lib/{shared → tasks/shared}/refs.js +0 -0
  199. /package/lib/{shared → tasks/shared}/repos.js +0 -0
  200. /package/lib/{shared → tasks/shared}/scopeView.js +0 -0
  201. /package/lib/{shared → tasks/shared}/tags.js +0 -0
  202. /package/lib/{shared → tasks/shared}/taskBlock.js +0 -0
  203. /package/lib/{shared → tasks/shared}/types.js +0 -0
  204. /package/lib/{shared → tasks/shared}/workTarget.js +0 -0
@@ -0,0 +1,27 @@
1
+ import { execFileSync } from "node:child_process";
2
+ import { homedir } from "node:os";
3
+ import { join, resolve } from "node:path";
4
+ /**
5
+ * CLI の共通の小物(入口と製品のコマンドの両方が使う。複数パッケージの構成では kit に置く候補。docs/architecture.md「パッケージの構成」)
6
+ */
7
+ /** 使い方の誤り(終了コード 1。メッセージだけを出す) */
8
+ export class UsageError extends Error {
9
+ }
10
+ /** 入力されたパス。対話式の入力ではシェルが ~ を展開しないので、ここで展開する */
11
+ export const resolvePath = (cwd, p) => resolve(cwd, p === "~" ? homedir() : p.startsWith("~/") ? join(homedir(), p.slice(2)) : p);
12
+ /** git の出力(失敗・空は undefined) */
13
+ export function git(cwd, ...args) {
14
+ try {
15
+ return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim() || undefined;
16
+ }
17
+ catch {
18
+ return undefined;
19
+ }
20
+ }
21
+ /** リポジトリのルート(git のメインの作業ツリー)。git 管理外ならカレント */
22
+ export function repoRoot(cwd) {
23
+ const common = git(cwd, "rev-parse", "--path-format=absolute", "--git-common-dir");
24
+ if (common?.endsWith("/.git"))
25
+ return common.slice(0, -"/.git".length);
26
+ return git(cwd, "rev-parse", "--show-toplevel") ?? cwd;
27
+ }
@@ -1,10 +1,10 @@
1
1
  import { Hono } from "hono";
2
2
  import { ProjectRegistry, RegistryError } from "../../core/projectRegistry.js";
3
- import { PROJECT_NAME } from "../../core/userConfig.js";
4
- import { chatgptRoutes } from "./chatgptRoutes.js";
5
- import { apiRoutes, eventStream } from "./routes.js";
6
- import { userThemeRoutes, userThemeScriptRoute } from "./userThemeRoutes.js";
7
- import { AI_MANIFEST } from "./manifest.js";
3
+ import { PROJECT_NAME } from "../../tasks/core/userConfig.js";
4
+ import { chatgptRoutes } from "../../tasks/server/api/chatgptRoutes.js";
5
+ import { apiRoutes, eventStream } from "../../tasks/server/api/routes.js";
6
+ import { userThemeRoutes, userThemeScriptRoute } from "../../tasks/features/settings/server/userThemeRoutes.js";
7
+ import { AI_MANIFEST } from "../../tasks/server/api/manifest.js";
8
8
  /** 変える操作に添える登録世代のヘッダー(GET でも添えれば、違うときは断る) */
9
9
  export const GENERATION_HEADER = "x-p3-project-generation";
10
10
  const STATUS = { unknown: 404, changed: 409, duplicate: 409, unavailable: 503 };
@@ -3,12 +3,15 @@ import { serveStatic } from "@hono/node-server/serve-static";
3
3
  import { Hono } from "hono";
4
4
  import { existsSync } from "node:fs";
5
5
  import { relative } from "node:path";
6
- import { apiRoutes } from "./api/routes.js";
6
+ import { fileURLToPath } from "node:url";
7
+ import { apiRoutes } from "../tasks/server/api/routes.js";
7
8
  import { projectsRoutes } from "./api/projectsRoutes.js";
8
- import { chatgptAccount } from "../core/chatgpt.js";
9
- import { openProject, P3_ROOT } from "../core/context.js";
10
- import { machineSettingsSource } from "../core/machineSettings.js";
9
+ import { chatgptAccount } from "../tasks/core/chatgpt.js";
10
+ import { openProject } from "../tasks/core/context.js";
11
+ import { machineSettingsSource } from "../tasks/core/machineSettings.js";
11
12
  import { ProjectRegistry } from "../core/projectRegistry.js";
13
+ /** p3 本体(配布するパッケージ)のルート。画面のビルド(dist/web)を探す(src/server・lib/server のどちらからも2つ上) */
14
+ const P3_ROOT = fileURLToPath(new URL("../../", import.meta.url));
12
15
  /** 1つのプロジェクトの API(通常の serve)。/api の下 */
13
16
  export function singleProjectApp(ctx) {
14
17
  const app = new Hono();
@@ -3,11 +3,11 @@ import { readFile } from "node:fs/promises";
3
3
  import { basename, resolve as resolvePath } from "node:path";
4
4
  import { parseArgs } from "node:util";
5
5
  import { ATTACHMENT_LIMITS, AttachmentError, inspectAttachment } from "../core/store/attachments.js";
6
- import { cleanBasis, EVIDENCE_BASIS_KINDS, isEvidenceBasisKind, parseEvidenceArg, parseEvidenceFile, parseEvidenceJson } from "../shared/acceptance.js";
6
+ import { cleanBasis, EVIDENCE_BASIS_KINDS, isEvidenceBasisKind, parseEvidenceArg, parseEvidenceFile, parseEvidenceJson } from "../features/requirements/shared/acceptance.js";
7
7
  import { TASK_STATUSES, isTaskStatus } from "../shared/types.js";
8
8
  import {} from "../core/context.js";
9
9
  import { repoArg } from "../core/workTargets.js";
10
- import { UsageError } from "./project.js";
10
+ import { UsageError } from "../../kit/usage.js";
11
11
  import { Output } from "./output.js";
12
12
  /** CLI の入力の解釈(オプション・キー=値・本文・添付のファイル)と、コマンドに渡すもの(CommandEnv) */
13
13
  const OPTIONS = {
@@ -1,7 +1,7 @@
1
1
  import { spawn } from "node:child_process";
2
2
  import { createInterface } from "node:readline";
3
3
  import { chatgptAccount, signInFailure } from "../core/chatgpt.js";
4
- import { UsageError } from "./project.js";
4
+ import { UsageError } from "../../kit/usage.js";
5
5
  /**
6
6
  * p3 chatgpt login | status | logout。プロジェクトを決める前に動く(どのプロジェクトにも属さない、このマシンの接続)。
7
7
  * 設計: docs/chatgpt-sign-in.md
@@ -1,5 +1,5 @@
1
1
  import { CodexImageError, updateCodexImage } from "../core/preflight/codexImage.js";
2
- import { UsageError } from "./project.js";
2
+ import { UsageError } from "../../kit/usage.js";
3
3
  /**
4
4
  * p3 codex update。Codex を動かすイメージを今すぐ作り直し、入った Codex の版を表示する。
5
5
  * プロジェクトを決める前に動く(このマシンの Docker のもの。プロジェクト・認証・個人設定の自動更新の停止に関係しない)。
@@ -1,4 +1,4 @@
1
- import { requestRequirementView } from "../shared/requirementSource.js";
1
+ import { requestRequirementView } from "../features/requirements/shared/requirementSource.js";
2
2
  import { absRef } from "../shared/refs.js";
3
3
  import { relationRole } from "../shared/types.js";
4
4
  import {} from "../core/context.js";
@@ -28,7 +28,7 @@ export function formatEntity(ctx, item, file) {
28
28
  const lines = [`${head} ${item.title}`, ""];
29
29
  if ("ref" in item)
30
30
  lines.push(` ${"作業先".padEnd(11)} ${workHint(ctx, item).replace(/^作業先: /, "")}`);
31
- const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record", "acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceSources", "acceptanceProblems", "block", "blockHistory", "blockProblems", "requirementSources", "requirementSeq", "clarifyAnswers", "requirementProblems", "completionRecords", "completionProblems", "reworkHistory", "reworkProblems"]);
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"]);
32
32
  for (const [k, v] of Object.entries(item)) {
33
33
  if (skip.has(k) || v === undefined || (Array.isArray(v) && !v.length))
34
34
  continue;
@@ -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 "./project.js";
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 "./project.js";
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,9 +12,9 @@ import { resolveRequestId } from "../core/ops.js";
12
12
  import { table } from "./format.js";
13
13
  import { requestWorkstreams, taskRepo } from "../shared/workTarget.js";
14
14
  import { briefRequest, formatBriefRequest, formatFamily } from "./showView.js";
15
- import { formatReview as formatRevisit } from "./revisitCommands.js";
16
- import { requestReview } from "../core/reviewCandidates.js";
17
- import { reviewSummary } from "../shared/reviewCandidate.js";
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
18
  /** 要望の配下の見直し候補の件数(無ければ何も出さない。親の件数は集約で、親自身を候補とは扱わない) */
19
19
  function reviewCountLines(review) {
20
20
  const { tasks, below } = review.counts;
@@ -22,7 +22,7 @@ function reviewCountLines(review) {
22
22
  return [];
23
23
  return ["", `見直しが必要(候補): タスク ${tasks} 件${below ? `・配下 ${below} 件(子の要望とそのタスク)` : ""}(p3 revisit で理由)`];
24
24
  }
25
- import { UsageError } from "./project.js";
25
+ import { UsageError } from "../../kit/usage.js";
26
26
  import { tagsFrom } from "../shared/tags.js";
27
27
  import { sortMilestones } from "../shared/milestoneOrder.js";
28
28
  import { parse, splitPair, list, date, readBody, readAttachFiles } from "./args.js";
@@ -1,9 +1,9 @@
1
- import { ANSWER_STATE_LABEL, criteriaSourceView, requestRequirementView, SOURCE_STATE_LABEL } from "../shared/requirementSource.js";
1
+ import { ANSWER_STATE_LABEL, criteriaSourceView, requestRequirementView, SOURCE_STATE_LABEL } from "../features/requirements/shared/requirementSource.js";
2
2
  import { absRef, parseRef } from "../shared/refs.js";
3
- import { acceptanceStatus, basisDetail, basisLabel, EVIDENCE_BASIS_KINDS, EVIDENCE_BASIS_LABEL, evidenceBasisOf } from "../shared/acceptance.js";
3
+ import { acceptanceStatus, basisDetail, basisLabel, EVIDENCE_BASIS_KINDS, EVIDENCE_BASIS_LABEL, evidenceBasisOf } from "../features/requirements/shared/acceptance.js";
4
4
  import { blockWarnings } from "../shared/taskBlock.js";
5
- import { REWORK_CAUSE_LABEL, reworkLine } from "../shared/reworkHistory.js";
6
- import { COMPLETION_TRIGGER_LABEL, REF_CAPTURE_LABEL } from "../shared/completionRecord.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
7
  import { supersededWarnings } from "../core/supersede.js";
8
8
  import { table } from "./format.js";
9
9
  import { taskWork } from "../core/workTargets.js";
@@ -5,19 +5,19 @@ import { normalizeTaskId } from "../shared/refs.js";
5
5
  import { getArchivedTask, listArchivedTasks } from "../core/store/archivedTasks.js";
6
6
  import { listTasks, resolve, resolveRef, resolveRequestId } from "../core/ops.js";
7
7
  import { archiveTask, createTask, importQuality, updateTask } from "../core/requestOps.js";
8
- import { taskQualityDiff } from "../shared/quality.js";
8
+ import { taskQualityDiff } from "../features/quality/shared/quality.js";
9
9
  import { supersededMarks } from "../core/supersede.js";
10
10
  import { table } from "./format.js";
11
11
  import { taskRepo } from "../shared/workTarget.js";
12
12
  import { addRepoOutputs, parseRepoOutput, repoArg } from "../core/workTargets.js";
13
13
  import { briefTask, formatAcceptance, formatBlock, formatBriefTask, taskExtras } from "./showView.js";
14
- import { formatReview } from "./revisitCommands.js";
15
- import { taskReview } from "../core/reviewCandidates.js";
16
- import { reviewSummary } from "../shared/reviewCandidate.js";
17
- import { UsageError } from "./project.js";
14
+ import { formatReview } from "../features/records/cli/revisitCommands.js";
15
+ import { taskReview } from "../features/records/core/reviewCandidates.js";
16
+ import { reviewSummary } from "../features/records/shared/reviewCandidate.js";
17
+ import { UsageError } from "../../kit/usage.js";
18
18
  import { NotFoundError } from "../core/store/collection.js";
19
19
  import { basisFromOptions, parseTaskAssignments, checkStatus, evidenceOps, readBody } from "./args.js";
20
- import { ACCEPTANCE_RESULTS, acceptanceStatus, applyAcceptanceOps, isAcceptanceResult } from "../shared/acceptance.js";
20
+ import { ACCEPTANCE_RESULTS, acceptanceStatus, applyAcceptanceOps, isAcceptanceResult } from "../features/requirements/shared/acceptance.js";
21
21
  import { dependentsOf, formatEntity, indent, ambiguous, replacedBy, reopenedNote, warn, deps, workHint } from "./output.js";
22
22
  import { requestCommand } from "./requestCommands.js";
23
23
  import { pickRun } from "./preflightCommands.js";
@@ -139,7 +139,7 @@ export async function taskCommand(cmd, env) {
139
139
  completionSkippedNote(r.reworkSkipped);
140
140
  const reopened = reopenedNote(r.reopened, r.reopenedAncestors);
141
141
  const keys = [...Object.keys(patch), ...(acceptance.length ? ["acceptance"] : [])];
142
- return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => [`更新: ${next.ref} (rev ${next.rev}) ${keys.join(", ")}`, "repo" in patch ? workHint(ctx, next) : ""].filter(Boolean).join("\n"));
142
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}), ...recordSkips(r) }, () => [`更新: ${next.ref} (rev ${next.rev}) ${keys.join(", ")}`, "repo" in patch ? workHint(ctx, next) : ""].filter(Boolean).join("\n"));
143
143
  }
144
144
  case "move": {
145
145
  const ref = taskArg(args[0]);
@@ -172,7 +172,7 @@ export async function taskCommand(cmd, env) {
172
172
  const short = status === "done" ? acceptanceStatus(next)?.shortfalls : undefined;
173
173
  if (short?.length)
174
174
  process.stderr.write(`受け入れ基準の不足(完了はしました。人が確かめます): ${short.join(" / ")}\n`);
175
- return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => `${next.ref} → ${status}${[...(o.output ?? []), ...(o["repo-output"] ?? [])].length ? ` (${[...(o.output ?? []), ...(o["repo-output"] ?? [])].join(", ")})` : ""}`);
175
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}), ...recordSkips(r) }, () => `${next.ref} → ${status}${[...(o.output ?? []), ...(o["repo-output"] ?? [])].length ? ` (${[...(o.output ?? []), ...(o["repo-output"] ?? [])].join(", ")})` : ""}`);
176
176
  }
177
177
  case "check": {
178
178
  const ref = taskArg(args[0]);
@@ -239,6 +239,14 @@ function checkClearedNote(msg) {
239
239
  process.stderr.write(`${msg}\n`);
240
240
  }
241
241
  /** 完了の記録・手戻りの履歴を足せなかった(壊れた記録)ことを知らせる */
242
+ /**
243
+ * 状態は変えたが記録を残せなかった知らせ(完了の記録 completionSkipped・手戻りの履歴 reworkSkipped)。--json の結果にも、API のタスクの PATCH と
244
+ * 同じ項目名・文で入れる(無ければ省く)。AI は JSON だけを読むので、標準エラーの知らせと別に要る
245
+ */
246
+ const recordSkips = (r) => ({
247
+ ...(r.completionSkipped ? { completionSkipped: r.completionSkipped } : {}),
248
+ ...(r.reworkSkipped ? { reworkSkipped: r.reworkSkipped } : {}),
249
+ });
242
250
  export function completionSkippedNote(msg) {
243
251
  if (msg)
244
252
  process.stderr.write(`${msg}\n`);
@@ -0,0 +1,149 @@
1
+ import { daysUntil, localToday } from "../shared/dates.js";
2
+ import { openProject } from "../core/context.js";
3
+ import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.js";
4
+ import { requirementCommand } from "../features/requirements/cli/requirementCommands.js";
5
+ import { revisitCommand } from "../features/records/cli/revisitCommands.js";
6
+ import { retroCommand } from "../features/retro/cli/retroCommands.js";
7
+ import { metricsCommand } from "../features/metrics/cli/metricsCommands.js";
8
+ import { taskReviewCommand } from "../features/taskReview/cli/taskReviewCommands.js";
9
+ import { qualityCommand } from "../features/quality/cli/qualityCommands.js";
10
+ import { NotFoundError } from "../core/store/collection.js";
11
+ import { VIA_LABEL } from "../core/store/locate.js";
12
+ import { table } from "./format.js";
13
+ import { cliExit } from "../core/errorOutcome.js";
14
+ import { config, currentRequest, locateHere, repoCommand, resolveActor, runnerText } from "../features/settings/cli/projectSettings.js";
15
+ import { UsageError } from "../../kit/usage.js";
16
+ import { sortMilestones } from "../shared/milestoneOrder.js";
17
+ import { runnerView } from "../shared/preflightRunner.js";
18
+ import { Output, bar } from "./output.js";
19
+ import { requestCommand, milestoneCommand } from "./requestCommands.js";
20
+ import { taskCommand } from "./taskCommands.js";
21
+ import { preflightCommand } from "./preflightCommands.js";
22
+ import { releaseNotesCommand } from "../features/releaseNotes/cli/releaseNotesCommands.js";
23
+ /**
24
+ * tasks の CLI: プロジェクトを開いた後のコマンドの振り分け(要望・タスク・Preflight・レビュー・品質・マイルストーン・リリースノート・
25
+ * 振り返り・指標・設定・参照先)と、エラーから終了コードへの対応。引数の解釈・プロジェクトの決定・登録が1つだけのときの抑止・serve・
26
+ * help・guide・init・join・agents は入口(main.ts)が受け持ち、ここを呼ぶ
27
+ */
28
+ /** 進捗の行の見直し候補の印(要望自身・自分のタスク・配下を分ける。無ければ空) */
29
+ function reviewMark(p) {
30
+ const r = p.review;
31
+ if (!r)
32
+ return "";
33
+ const parts = [r.self?.state === "candidate" ? "要望" : "", r.tasks ? `タスク ${r.tasks}` : "", r.below ? `配下 ${r.below}` : ""].filter(Boolean);
34
+ return parts.length ? ` ※見直し候補(${parts.join("・")})` : "";
35
+ }
36
+ /** 決まったプロジェクトで tasks のコマンドを動かす(知らないコマンドは使い方の誤り) */
37
+ export async function runTasksCommand(r) {
38
+ const { cmd, args, o, cwd, out, target, settings } = r;
39
+ const ctx = await openProject(target.dataDir, { repos: target.repos, settings, projectName: target.name });
40
+ const actor = resolveActor(o.actor ?? process.env.P3_ACTOR, cwd);
41
+ const current = currentRequest(ctx, o.req ?? o.request ?? process.env.P3_REQUEST, cwd);
42
+ const expectedRev = o.rev !== undefined ? Number(o.rev) : undefined;
43
+ /** 要望の引数(省略時は今の要望) */
44
+ const requestArg = (raw) => {
45
+ if (raw) {
46
+ const id = resolveRequestId(ctx, raw);
47
+ if (!id)
48
+ throw new NotFoundError(raw);
49
+ return id;
50
+ }
51
+ if (!current)
52
+ throw new UsageError("要望を指定してください(引数か --req。要望の作業ツリーの中なら省略可)");
53
+ return current;
54
+ };
55
+ /** タスクの引数(T003 は今の要望の中) */
56
+ const taskArg = (raw) => {
57
+ if (!raw)
58
+ throw new UsageError("タスクを指定してください(T003 / <要望>/T003)");
59
+ const ref = resolveRef(ctx, raw, current);
60
+ if (ref?.includes("/"))
61
+ return ref;
62
+ if (!ref && !raw.includes("/") && !current)
63
+ throw new UsageError(`${raw}: 要望を --req で指定してください`);
64
+ throw new NotFoundError(raw);
65
+ };
66
+ const split = (ref) => {
67
+ const [rid, tid] = ref.split("/");
68
+ return { col: ctx.ws.tasksOf(rid), rid, tid };
69
+ };
70
+ const env = { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd, target };
71
+ const handled = (await taskCommand(cmd, env)) ?? (await taskReviewCommand(cmd, env)) ?? (await preflightCommand(cmd, env)) ?? (await requirementCommand(cmd, env)) ?? (await revisitCommand(cmd, env)) ?? (await retroCommand(cmd, env)) ?? (await metricsCommand(cmd, env));
72
+ if (handled !== undefined)
73
+ return handled;
74
+ switch (cmd) {
75
+ case "config": {
76
+ const r = await config(ctx.ws, args);
77
+ return out.result(r.data, () => r.text);
78
+ }
79
+ case "repo": {
80
+ const r = await repoCommand(ctx.ws, target.name, cwd, args, { local: o.local });
81
+ return out.result(r.data, () => r.text);
82
+ }
83
+ case "whoami": {
84
+ const here = locateHere(ctx, cwd);
85
+ // Preflight の担当(AI 向けの手順が読む。読めなければ runner: null と problem。agent と推測しない)
86
+ const pf = runnerView(ctx.ws.project.preflight);
87
+ const preflight = { runner: pf.runner, source: pf.source, ...(pf.problem ? { problem: pf.problem } : {}) };
88
+ // 置いた AI 向けの入口の状態(読むだけ。古くても操作は断らない)
89
+ const { status: agents, lines: agentLines } = r.agents();
90
+ return out.result({ project: target.name ?? null, dataDir: target.dataDir, via: target.via, here: here.repos, branch: here.branch ?? null, actor, request: current ?? null, preflight, agents }, () => [
91
+ `プロジェクト ${target.name ?? "(未登録)"} ${target.dataDir}`,
92
+ `決まり方 ${target.via}(${VIA_LABEL[target.via]})`,
93
+ `今いる参照先 ${here.repos.length ? here.repos.join(", ") : "(どの参照先の中でもない。p3 repo ls)"}${here.branch ? ` ブランチ ${here.branch}` : ""}`,
94
+ `変更者 ${actor}`,
95
+ `要望 ${current ? `${current} ${titleOf(ctx, current)}` : "(なし)"}`,
96
+ `Preflight ${runnerText(pf)}`,
97
+ ...agentLines.map((l, i) => (i ? ` ${l}` : `AI の入口 ${l}`)),
98
+ ].join("\n"));
99
+ }
100
+ case "progress": {
101
+ const ps = progress(ctx).filter((p) => o.all || !["done", "rejected"].includes(p.request.status));
102
+ const today = localToday();
103
+ return out.result(ps, () => {
104
+ const groups = [
105
+ ...sortMilestones(ctx.ws.project.milestones).map((m) => ({ m, ps: ps.filter((p) => p.request.milestone === m.id) })),
106
+ { m: undefined, ps: ps.filter((p) => !p.request.milestone) },
107
+ ];
108
+ return (groups
109
+ .filter((g) => g.ps.length)
110
+ .map((g) => {
111
+ const done = g.ps.reduce((n, p) => n + p.done, 0);
112
+ const total = g.ps.reduce((n, p) => n + p.total, 0);
113
+ const head = g.m
114
+ ? `■ ${g.m.title}(${g.m.id}${g.m.due ? ` · ${g.m.due}` : ""}${g.m.done ? " · リリース済み" : ""}) タスク ${done}/${total}`
115
+ : "■ マイルストーンなし";
116
+ const rows = g.ps.map((p) => [
117
+ ` ${p.request.id}`,
118
+ p.request.status,
119
+ `${bar(p.total ? p.done / p.total : 0)} ${p.done}/${p.total}`,
120
+ p.request.due
121
+ ? `${p.request.due}${daysUntil(p.request.due, today) < 0 && !["done", "rejected"].includes(p.request.status) ? " 超過" : ""}`
122
+ : "",
123
+ p.request.tags.map((t) => `#${t}`).join(" "),
124
+ // 子のある要望は配下の集計(自分の値とは別)、子は親を添える
125
+ `${p.request.title}${p.blocked ? ` ⏸停止 ${p.blocked}` : ""}${p.children.length ? ` [配下 ${p.subtree.done}/${p.subtree.total}・子 ${p.children.length}${p.subtree.blocked > p.blocked ? `・配下の停止 ${p.subtree.blocked - p.blocked}` : ""}]` : ""}${p.request.parent ? ` ↑${p.request.parent}` : ""}${p.hierarchyIssues.length ? " ※親子の問題" : ""}${reviewMark(p)}`,
126
+ ]);
127
+ return `${head}\n${table(rows)}`;
128
+ })
129
+ .join("\n\n") || "要望はありません");
130
+ });
131
+ }
132
+ case "quality":
133
+ return qualityCommand(env);
134
+ case "milestone":
135
+ case "milestones":
136
+ return milestoneCommand(ctx, out, args, o, actor);
137
+ case "release-notes":
138
+ case "release-note":
139
+ return releaseNotesCommand(env);
140
+ // --- 要望 ---------------------------------------------------------------
141
+ case "request":
142
+ case "req":
143
+ return requestCommand(ctx, out, args, o, actor, requestArg, expectedRev);
144
+ default:
145
+ throw new UsageError(`不明なコマンド: ${cmd}(p3 help)`);
146
+ }
147
+ }
148
+ /** エラーを標準エラーに出し、終了コードを返す(競合 3・見つからない 2・ほか 1。対応の表は core/errorOutcome.ts) */
149
+ export const reportError = (e) => cliExit(e, (t) => process.stderr.write(t));
@@ -1,4 +1,3 @@
1
- import { fileURLToPath } from "node:url";
2
1
  import { chatgptAccount } from "./chatgpt.js";
3
2
  import { CodexWorkspaceEngine, codexConfig } from "./preflight/codexEngine.js";
4
3
  import { fixedSettings, machineSettingsSource } from "./machineSettings.js";
@@ -6,14 +5,12 @@ import { MockEngine } from "./preflight/mockEngine.js";
6
5
  import { PreflightService } from "./preflight/service.js";
7
6
  import { checkDataDir } from "./store/locate.js";
8
7
  import { Workspace } from "./store/workspace.js";
9
- import { ReleaseGenerator } from "./releaseNotes/generate.js";
10
- import { MockSummarizer } from "./releaseNotes/mockSummarizer.js";
11
- import { MilestoneReviewService } from "./milestoneReview/service.js";
12
- import { MockReviewer } from "./milestoneReview/mockReviewer.js";
13
- import { TaskReviewService } from "./taskReview/service.js";
14
- import { MockTaskReviewer } from "./taskReview/mockReviewer.js";
15
- /** p3 本体(パッケージ)のルート */
16
- export const P3_ROOT = fileURLToPath(new URL("../../", import.meta.url));
8
+ import { ReleaseGenerator } from "../features/releaseNotes/core/generate.js";
9
+ import { MockSummarizer } from "../features/releaseNotes/core/mockSummarizer.js";
10
+ import { MilestoneReviewService } from "../features/milestoneReview/core/service.js";
11
+ import { MockReviewer } from "../features/milestoneReview/core/mockReviewer.js";
12
+ import { TaskReviewService } from "../features/taskReview/core/service.js";
13
+ import { MockTaskReviewer } from "../features/taskReview/core/mockReviewer.js";
17
14
  /**
18
15
  * サーバと CLI が共有する組み立て。どちらもデータのフォルダのファイルを直接読み書きする。
19
16
  * repos: 参照先の名前 → このマシンのパス(個人設定)
@@ -0,0 +1,125 @@
1
+ import { UsageError } from "../../kit/usage.js";
2
+ import { AcceptanceInputError } from "../features/requirements/shared/acceptance.js";
3
+ import { MetricsError } from "../features/metrics/shared/metrics.js";
4
+ import { QualityInputError } from "../features/quality/shared/quality.js";
5
+ import { RequirementInputError } from "../features/requirements/shared/requirementSource.js";
6
+ import { RetrospectiveError } from "../features/retro/shared/retrospective.js";
7
+ import { PremiseInputError } from "../features/records/shared/reviewCandidate.js";
8
+ import { BlockInputError } from "../shared/taskBlock.js";
9
+ import { HierarchyError } from "./hierarchy.js";
10
+ import { SettingsError } from "./machineSettings.js";
11
+ import { ReviewRejected } from "../features/milestoneReview/core/service.js";
12
+ import { StaleInputError } from "./preflight/input.js";
13
+ import { ChildConflictError, ChildDraftsChangedError, DraftConflictError } from "./preflight/service.js";
14
+ import { ImprovementError } from "../features/quality/core/qualityImprovement.js";
15
+ import { CompletionRejected } from "../features/releaseNotes/core/completeRequests.js";
16
+ import { GenerationRejected } from "../features/releaseNotes/core/generate.js";
17
+ import { ReleaseNoteError } from "../features/releaseNotes/core/store.js";
18
+ import { OpRuleError } from "./requestOps.js";
19
+ import { ReviewCancelRefused, ReviewStoreError } from "./reviewRuns.js";
20
+ import { ArchivedTaskReadError } from "./store/archivedTasks.js";
21
+ import { ConflictError, NotFoundError } from "./store/collection.js";
22
+ import { DataDirError, ProjectNotResolvedError } from "./store/locate.js";
23
+ import { MilestonesConflictError, ProjectInputError, ReloadError } from "./store/workspace.js";
24
+ import { TaskReviewRejected } from "../features/taskReview/core/material.js";
25
+ import { UserConfigError } from "./userConfig.js";
26
+ const conflict = (e) => `競合: ${e.message}`;
27
+ export function errorOutcome(e) {
28
+ if (!(e instanceof Error))
29
+ return undefined;
30
+ const coded = (status, code, extra = {}) => ({ status, body: { code, ...extra } });
31
+ if (e instanceof ConflictError)
32
+ return { exit: 3, cli: `競合: ${e.message}。最新を取得してやり直してください`, status: 409, body: { code: "rev_conflict" } };
33
+ if (e instanceof NotFoundError)
34
+ return { exit: 2, cli: `見つかりません: ${e.id}`, status: 404 };
35
+ if (e instanceof UserConfigError)
36
+ return { exit: 1, cli: e.message, status: 500 };
37
+ if (e instanceof SettingsError)
38
+ return { exit: 1, cli: `設定: ${e.message}` };
39
+ if (e instanceof ProjectNotResolvedError || e instanceof DataDirError)
40
+ return { exit: 1, cli: e.message };
41
+ if (e instanceof ReleaseNoteError) {
42
+ const exit = e.code === "not_found" ? 2 : e.code === "conflict" || e.code === "exists" ? 3 : 1;
43
+ const cli = e.code === "conflict" ? conflict(e) : e.message;
44
+ if (e.code === "not_found")
45
+ return { exit, cli, ...coded(404, "not_found") };
46
+ if (e.code === "bad_id")
47
+ return { exit, cli, ...coded(400, "bad_id") };
48
+ if (e.code === "invalid")
49
+ return { exit, cli, ...coded(422, "invalid") };
50
+ return { exit, cli, ...coded(409, "rev_conflict", { reason: e.code }) };
51
+ }
52
+ if (e instanceof MetricsError)
53
+ return { exit: e.code === "metrics_conflict" ? 3 : 1, cli: e.code === "metrics_conflict" ? conflict(e) : e.message, ...coded(400, e.code) };
54
+ if (e instanceof RetrospectiveError)
55
+ return { exit: e.code === "retro_conflict" ? 3 : 1, cli: e.code === "retro_conflict" ? conflict(e) : e.message, ...coded(e.code === "retro_invalid" ? 400 : 409, e.code) };
56
+ if (e instanceof GenerationRejected)
57
+ return { exit: 1, cli: e.message, ...coded(e.code === "running" ? 409 : 400, e.code) };
58
+ if (e instanceof CompletionRejected)
59
+ return { ...coded(409, e.code, { plan: e.plan }) };
60
+ if (e instanceof HierarchyError) {
61
+ // 子の表示順を読んだ後に子の集合が変わった・ロックを取れない → 3(読み直してやり直す)
62
+ const changedSet = e.code === "child_order_invalid" && (e.detail.reason === "not_child" || e.detail.reason === "missing");
63
+ return { exit: e.code === "hierarchy_busy" || changedSet ? 3 : 1, cli: e.message, ...coded(409, e.code, { ...e.detail }) };
64
+ }
65
+ if (e instanceof ReviewRejected) {
66
+ const exit = e.code === "unknown_milestone" ? 2 : e.code === "running" ? 3 : 1;
67
+ const status = e.code === "running" || e.code === "material_changed" ? 409 : e.code === "unknown_milestone" ? 404 : 400;
68
+ return { exit, cli: e.message, ...coded(status, e.code, e.running ? { run: e.running } : {}) };
69
+ }
70
+ if (e instanceof ReviewStoreError) {
71
+ const exit = e.code === "not_found" ? 2 : e.code === "finished" || e.code === "exists" ? 3 : 1;
72
+ const status = e.code === "not_found" ? 404 : e.code === "bad_id" ? 400 : e.code === "broken" ? 422 : 409;
73
+ return { exit, cli: e.message, ...coded(status, e.code) };
74
+ }
75
+ if (e instanceof ReviewCancelRefused)
76
+ return { exit: 3, cli: e.message, ...coded(409, e.code) };
77
+ if (e instanceof TaskReviewRejected) {
78
+ const busy = e.code === "running" || e.code === "material_changed";
79
+ return { exit: busy ? 3 : 1, cli: e.message, ...coded(busy ? 409 : 400, e.code, e.running ? { run: e.running } : {}) };
80
+ }
81
+ if (e instanceof ImprovementError) {
82
+ const busy = e.code === "diagnosis_changed" || e.code === "existing" || e.code === "closed_existing";
83
+ return { exit: e.code === "not_found" ? 2 : busy ? 3 : 1, cli: e.message, ...coded(e.code === "not_found" ? 404 : busy ? 409 : 400, e.code, e.existing ? { existing: e.existing } : {}) };
84
+ }
85
+ if (e instanceof QualityInputError)
86
+ return { exit: e.code === "quality_conflict" ? 3 : 1, cli: e.message, ...coded(e.code === "quality_conflict" ? 409 : 400, e.code) };
87
+ if (e instanceof MilestonesConflictError)
88
+ return { exit: 3, cli: conflict(e), ...coded(409, e.code, { milestonesVersion: e.current }) };
89
+ // 規則に合わない入力(何も書いていない)。CLI は前置きなし
90
+ if (e instanceof AcceptanceInputError || e instanceof RequirementInputError || e instanceof PremiseInputError)
91
+ return { exit: 1, cli: e.message, ...coded(400, e.code) };
92
+ if (e instanceof BlockInputError)
93
+ return { exit: 1, cli: e.message, ...coded(e.code === "blocked" ? 409 : 400, e.code) };
94
+ if (e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError)
95
+ return { exit: 1, cli: e.message };
96
+ // Preflight の案・子の案・評価対象(API だけ。409 は code で分ける: rev_conflict は読み直してやり直す / stale_input は評価のあとで要望が変わった)
97
+ if (e instanceof DraftConflictError || e instanceof ChildConflictError)
98
+ return { ...coded(409, "rev_conflict", { current: e.current }) };
99
+ if (e instanceof ChildDraftsChangedError)
100
+ return { ...coded(409, e.code) };
101
+ if (e instanceof StaleInputError)
102
+ return { ...coded(409, e.code, { inputMatch: e.match }) };
103
+ if (e instanceof ReloadError)
104
+ return { status: 503 };
105
+ if (e instanceof ArchivedTaskReadError)
106
+ return { ...coded(500, e.code) };
107
+ return undefined;
108
+ }
109
+ /** CLI: 標準エラーに出し、終了コードを返す */
110
+ export function cliExit(e, write) {
111
+ const o = errorOutcome(e);
112
+ if (o?.exit) {
113
+ write(`${o.cli ?? e.message}\n`);
114
+ return o.exit;
115
+ }
116
+ write(`エラー: ${e.message}\n`);
117
+ return 1;
118
+ }
119
+ /** API: 応答の状態と本文(表に無ければ undefined。各アプリが 400 と console.error で返す) */
120
+ export function apiError(e) {
121
+ const o = errorOutcome(e);
122
+ if (!o?.status)
123
+ return undefined;
124
+ return { status: o.status, body: { error: e.message, ...o.body } };
125
+ }