@infodb/p3 0.0.0-stage → 0.2.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 (120) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +56 -2
  3. package/bin/p3.mjs +18 -0
  4. package/dist/web/apple-touch-icon.png +0 -0
  5. package/dist/web/assets/Outputs-Ni3pNuGU.js +1 -0
  6. package/dist/web/assets/RequestStatus-K8TZwpur.js +1 -0
  7. package/dist/web/assets/TagInput-BICKVH2x.js +1 -0
  8. package/dist/web/assets/TaskDrawer-BkDIstIN.js +3 -0
  9. package/dist/web/assets/_requestId-B5O_ytaq.js +1 -0
  10. package/dist/web/assets/_requestId-C66puEMO.js +30 -0
  11. package/dist/web/assets/action-CMjATXqv.js +1 -0
  12. package/dist/web/assets/board-CbfDjkls.js +1 -0
  13. package/dist/web/assets/copy-B1ZbihKL.js +2 -0
  14. package/dist/web/assets/done-CPQbCFHg.js +1 -0
  15. package/dist/web/assets/draft-dT3gLDIt.js +1 -0
  16. package/dist/web/assets/format-DuK6P1hb.js +1 -0
  17. package/dist/web/assets/index-BUcs2J6N.js +12 -0
  18. package/dist/web/assets/index-C3DkqwJ9.css +2 -0
  19. package/dist/web/assets/link-_s8ndNKS.js +1 -0
  20. package/dist/web/assets/new-T60RB7de.js +1 -0
  21. package/dist/web/assets/preload-helper-dXqN7N-I.js +1 -0
  22. package/dist/web/assets/release-notes-DxrPhDbt.js +3 -0
  23. package/dist/web/assets/requestData-D8ZiSZss.js +1 -0
  24. package/dist/web/assets/rolldown-runtime-hePW80VL.js +1 -0
  25. package/dist/web/assets/routes-D9ZxXoLk.js +2 -0
  26. package/dist/web/assets/search-CJ8MBKTz.js +1 -0
  27. package/dist/web/assets/settings-DsHVyqzJ.js +1 -0
  28. package/dist/web/assets/supersede-CLXlhCq0.js +1 -0
  29. package/dist/web/assets/ui-Cvke4y4X.js +1 -0
  30. package/dist/web/favicon.ico +0 -0
  31. package/dist/web/favicon.svg +12 -0
  32. package/dist/web/index.html +23 -0
  33. package/docs/architecture.md +591 -0
  34. package/docs/chatgpt-sign-in.md +163 -0
  35. package/docs/development.md +194 -0
  36. package/docs/how-to-use.md +524 -0
  37. package/docs/installation.md +284 -0
  38. package/docs/publishing.md +65 -0
  39. package/package.json +86 -3
  40. package/skills/p3/SKILL.md +95 -0
  41. package/src/cli/args.ts +179 -0
  42. package/src/cli/chatgpt.ts +74 -0
  43. package/src/cli/codex.ts +28 -0
  44. package/src/cli/format.ts +9 -0
  45. package/src/cli/help.ts +99 -0
  46. package/src/cli/main.ts +267 -0
  47. package/src/cli/output.ts +99 -0
  48. package/src/cli/preflightCommands.ts +237 -0
  49. package/src/cli/project.ts +508 -0
  50. package/src/cli/readOnly.ts +36 -0
  51. package/src/cli/releaseNotesCommands.ts +139 -0
  52. package/src/cli/render.ts +60 -0
  53. package/src/cli/requestCommands.ts +170 -0
  54. package/src/cli/showView.ts +110 -0
  55. package/src/cli/taskCommands.ts +167 -0
  56. package/src/cli/userConfig.ts +58 -0
  57. package/src/core/chatgpt.ts +33 -0
  58. package/src/core/context.ts +57 -0
  59. package/src/core/machineSettings.ts +207 -0
  60. package/src/core/machineSettingsEdit.ts +156 -0
  61. package/src/core/ops.ts +114 -0
  62. package/src/core/preflight/carryover.ts +133 -0
  63. package/src/core/preflight/codexEngine.ts +702 -0
  64. package/src/core/preflight/codexImage.ts +98 -0
  65. package/src/core/preflight/diagnose.ts +124 -0
  66. package/src/core/preflight/engine.ts +92 -0
  67. package/src/core/preflight/input.ts +65 -0
  68. package/src/core/preflight/launch.ts +86 -0
  69. package/src/core/preflight/launcher.mjs +75 -0
  70. package/src/core/preflight/mock-ui.html +24 -0
  71. package/src/core/preflight/mock-ui.png +0 -0
  72. package/src/core/preflight/mockEngine.ts +145 -0
  73. package/src/core/preflight/render-image/Dockerfile +23 -0
  74. package/src/core/preflight/render-image/render.mjs +53 -0
  75. package/src/core/preflight/render.ts +336 -0
  76. package/src/core/preflight/service.ts +690 -0
  77. package/src/core/preflight/uiMaterials.ts +272 -0
  78. package/src/core/preflight/uiRender.ts +84 -0
  79. package/src/core/preflight/wireframe.ts +69 -0
  80. package/src/core/preflight/xlsx.ts +328 -0
  81. package/src/core/redact.ts +31 -0
  82. package/src/core/releaseNotes/generate.ts +271 -0
  83. package/src/core/releaseNotes/material.ts +114 -0
  84. package/src/core/releaseNotes/mockSummarizer.ts +28 -0
  85. package/src/core/releaseNotes/service.ts +106 -0
  86. package/src/core/releaseNotes/store.ts +216 -0
  87. package/src/core/repoAdmin.ts +81 -0
  88. package/src/core/repoRefs.ts +90 -0
  89. package/src/core/requestOps.ts +140 -0
  90. package/src/core/requestStatus.ts +58 -0
  91. package/src/core/store/attachments.ts +228 -0
  92. package/src/core/store/collection.ts +282 -0
  93. package/src/core/store/frontmatter.ts +22 -0
  94. package/src/core/store/fsutil.ts +90 -0
  95. package/src/core/store/locate.ts +181 -0
  96. package/src/core/store/normalize.ts +155 -0
  97. package/src/core/store/noteStore.ts +56 -0
  98. package/src/core/store/preflightStore.ts +136 -0
  99. package/src/core/store/projectFile.ts +101 -0
  100. package/src/core/store/workspace.ts +328 -0
  101. package/src/core/supersede.ts +74 -0
  102. package/src/core/userConfig.ts +180 -0
  103. package/src/core/userTheme.ts +22 -0
  104. package/src/core/workTargets.ts +120 -0
  105. package/src/server/api/chatgptRoutes.ts +48 -0
  106. package/src/server/api/local.ts +33 -0
  107. package/src/server/api/manifest.ts +119 -0
  108. package/src/server/api/releaseNoteRoutes.ts +78 -0
  109. package/src/server/api/repoRoutes.ts +67 -0
  110. package/src/server/api/routes.ts +374 -0
  111. package/src/server/api/userThemeRoutes.ts +62 -0
  112. package/src/server/server.ts +49 -0
  113. package/src/shared/dates.ts +12 -0
  114. package/src/shared/preflightInput.ts +27 -0
  115. package/src/shared/refs.ts +55 -0
  116. package/src/shared/repos.ts +113 -0
  117. package/src/shared/scopeView.ts +48 -0
  118. package/src/shared/tags.ts +27 -0
  119. package/src/shared/types.ts +700 -0
  120. package/src/shared/workTarget.ts +44 -0
@@ -0,0 +1,139 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { resolve as resolvePath } from "node:path";
3
+ import type { ReleaseGeneration, ReleaseMaterial, ReleaseWarning } from "../shared/types.ts";
4
+ import { exportReleaseNote, releaseNoteDetail, releaseOverview, saveReleaseNote, startGeneration } from "../core/releaseNotes/service.ts";
5
+ import { readBody, type CommandEnv } from "./args.ts";
6
+ import { table } from "./format.ts";
7
+ import { UsageError } from "./project.ts";
8
+
9
+ /**
10
+ * p3 release-notes ... マイルストーンごとのリリースノート(規則と保存は core/releaseNotes)
11
+ *
12
+ * ls マイルストーンごとのノートの有無と要望の数
13
+ * show <id> 保存したノート(本文・版)と、対象の要望・警告
14
+ * generate <id> 機能の要約を生成して案を出す(保存しない。進み具合は stderr)
15
+ * save <id> 本文を保存する(--body 本文|- か --file。更新は --version 必須)
16
+ * export <id> 保存した本文だけを stdout に出す
17
+ */
18
+ export async function releaseNotesCommand(env: CommandEnv): Promise<number> {
19
+ const { ctx, out, args, o, actor } = env;
20
+ const [sub = "ls", mid] = args;
21
+ const need = () => {
22
+ if (!mid) throw new UsageError(`p3 release-notes ${sub} <マイルストーン>`);
23
+ return mid;
24
+ };
25
+ switch (sub) {
26
+ case "ls":
27
+ case "list": {
28
+ const r = await releaseOverview(ctx);
29
+ return out.result(r, () => {
30
+ const rows = r.milestones.map((m) => [
31
+ m.milestone,
32
+ m.title,
33
+ `要望 ${m.requests}`,
34
+ m.note.state === "ok" ? `ノートあり(${m.note.updatedAt.slice(0, 10)})` : m.note.state === "invalid" ? "ノートを読めません" : "ノートなし",
35
+ m.known ? "" : "マイルストーンが project.yaml にありません",
36
+ ]);
37
+ return [table(rows) || "マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース)", ...warnLines(r.warnings)].join("\n");
38
+ });
39
+ }
40
+
41
+ case "show": {
42
+ const d = await releaseNoteDetail(ctx, need());
43
+ return out.result(d, () => {
44
+ const lines = [`${d.material.milestone.id} ${d.material.milestone.title}${d.material.milestone.done ? "(リリース済み)" : ""}`, ""];
45
+ lines.push(...materialLines(d.material), "");
46
+ if (d.noteError) lines.push(`ノート: 読めません(${d.noteError})`, " 直すまで新しく保存できません。frontmatter を直すか、本文を退避してファイルを消してください");
47
+ else if (!d.note) lines.push("ノート: まだありません(p3 release-notes generate → save)");
48
+ else {
49
+ lines.push(`ノート: 更新 ${d.note.updatedAt}${d.note.updatedBy ? `(${d.note.updatedBy})` : ""}`, ` 版 ${d.note.version}(更新は --version にこの値)`);
50
+ if (d.materialChanged) lines.push(" ※ 保存のあとで要望・タスクが変わっています(本文は変えていません。必要なら生成し直して保存してください)");
51
+ lines.push("", d.note.body || "(本文なし)");
52
+ }
53
+ return lines.join("\n");
54
+ });
55
+ }
56
+
57
+ case "generate": {
58
+ if (o.engine !== undefined && o.engine !== "codex" && o.engine !== "mock") throw new UsageError("--engine は codex か mock");
59
+ const g = await startGeneration(ctx, need(), actor, o.engine);
60
+ const gen = ctx.releaseGenerator;
61
+ // 進み具合は stderr(stdout は本文の案か JSON だけにする)
62
+ let shown = 0;
63
+ const tick = setInterval(() => (shown = flushLog(gen.get(g.id)!, shown)), 300);
64
+ // Ctrl-C で取り消す(保存したノートは変えない)。終わるまでは何度押しても取り消すだけ
65
+ const onInt = () => gen.cancel(g.id);
66
+ process.on("SIGINT", onInt);
67
+ const done = (await gen.wait(g.id))!;
68
+ clearInterval(tick);
69
+ process.removeListener("SIGINT", onInt);
70
+ flushLog(done, shown);
71
+ if (done.status !== "completed") {
72
+ if (out.json) out.result(done, () => "");
73
+ else process.stderr.write(`${failureLine(done)}\n`);
74
+ return 1;
75
+ }
76
+ if (!out.json) {
77
+ process.stderr.write(`${summaryLines(done).join("\n")}\n`);
78
+ }
79
+ return out.result(done, () => done.markdown!);
80
+ }
81
+
82
+ case "save": {
83
+ const body = o.file !== undefined ? await readFile(resolvePath(process.cwd(), o.file), "utf8") : o.body !== undefined ? readBody(o.body) : undefined;
84
+ if (body === undefined) throw new UsageError("本文を --body 本文|- か --file ファイルで指定してください");
85
+ const r = await saveReleaseNote(ctx, need(), { body, title: o.title, basedOn: o["based-on"], version: o.version }, actor);
86
+ return out.result(r, () =>
87
+ [`保存しました: ${r.note.milestone} 版 ${r.note.version}`, ` ${ctx.ws.releaseNotes.path(r.note.milestone)}`, ...warnLines(r.warnings)].join("\n"),
88
+ );
89
+ }
90
+
91
+ case "export": {
92
+ const body = await exportReleaseNote(ctx, need());
93
+ if (out.json) return out.result({ milestone: mid, body }, () => "");
94
+ process.stdout.write(body);
95
+ return 0;
96
+ }
97
+
98
+ default:
99
+ throw new UsageError("p3 release-notes [ls | show <id> | generate <id> | save <id> | export <id>]");
100
+ }
101
+ }
102
+
103
+ const warnLines = (ws: ReleaseWarning[]) => ws.map((w) => ` ⚠ ${w.code}: ${w.message}`);
104
+
105
+ function materialLines(m: ReleaseMaterial): string[] {
106
+ const rows = m.requests.map((r) => [
107
+ ` ${r.included ? "収録" : "対象外"}`,
108
+ r.id,
109
+ r.status,
110
+ `${r.tasks.filter((t) => t.hasRecord).length}/${r.tasks.length} 記録`,
111
+ r.title,
112
+ r.reason ? `(${r.reason})` : "",
113
+ ]);
114
+ return [
115
+ `対象の要望 ${m.requests.length} 件(収録 ${m.requests.filter((r) => r.included).length}) 材料 ${m.hash.slice(0, 12)}`,
116
+ ...(rows.length ? [table(rows)] : [" (このマイルストーンの要望はありません)"]),
117
+ ...warnLines([...m.warnings, ...m.requests.flatMap((r) => r.warnings)]),
118
+ ];
119
+ }
120
+
121
+ function flushLog(g: ReleaseGeneration, from: number): number {
122
+ for (const e of g.log.slice(from)) process.stderr.write(`[${e.kind}] ${e.text}\n`);
123
+ return g.log.length;
124
+ }
125
+
126
+ function failureLine(g: ReleaseGeneration): string {
127
+ if (g.status === "cancelled") return "取り消しました(保存したノートは変えていません)";
128
+ return `生成できませんでした(${g.failure}): ${g.error}(保存したノートは変えていません)`;
129
+ }
130
+
131
+ function summaryLines(g: ReleaseGeneration): string[] {
132
+ return [
133
+ `生成しました: ${g.id}(保存はしていません) 材料 ${g.materialHash.slice(0, 12)}`,
134
+ "出典:",
135
+ ...g.items!.map((x, i) => ` ${i + 1}. ${x.sources.join(", ")}`),
136
+ ...warnLines(g.warnings),
137
+ `保存するときは本文を確かめてから: p3 release-notes save ${g.milestone} --file <本文.md> --based-on ${g.materialHash}`,
138
+ ];
139
+ }
@@ -0,0 +1,60 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { basename, dirname, extname, join, resolve } from "node:path";
3
+ import type { MachineSettings } from "../core/machineSettings.ts";
4
+ import { ensureRenderImage, RenderError, renderHtml } from "../core/preflight/render.ts";
5
+ import { UsageError } from "./project.ts";
6
+
7
+ const USAGE = [
8
+ "p3 render <原稿.html> [--out 画像.png] [--width 1280] 自己完結した HTML / CSS を PNG にする(Docker が要る)",
9
+ "p3 render update 描画のイメージを今すぐ作り直す",
10
+ ].join("\n");
11
+
12
+ /**
13
+ * p3 render。Preflight の画面イメージと同じ描画(専用のコンテナ。ネットワークなし)で、手元の HTML を PNG にする。
14
+ * プロジェクトを決める前に動く。DevContainer の中から使うときは、原稿の隣に作る一時のフォルダにもパスの対応(codex.pathMap)が効く
15
+ */
16
+ export async function renderCommand(
17
+ args: string[],
18
+ o: { out?: string; width?: string },
19
+ settings: Pick<MachineSettings, "codex">,
20
+ cwd = process.cwd(),
21
+ ): Promise<{ data: unknown; text: string; code?: number }> {
22
+ const [sub] = args;
23
+ const progress = (t: string) => process.stderr.write(`${t}\n`);
24
+ try {
25
+ if (sub === "update") {
26
+ const { image } = await ensureRenderImage({ force: true, onProgress: progress });
27
+ return { data: { ok: true, image }, text: `描画のイメージを作り直しました: ${image}` };
28
+ }
29
+ if (!sub || args.length > 1) throw new UsageError(USAGE);
30
+ const src = resolve(cwd, sub);
31
+ const html = await readFile(src, "utf8").catch(() => {
32
+ throw new UsageError(`原稿が読めません: ${sub}`);
33
+ });
34
+ const out = resolve(cwd, o.out ?? join(dirname(src), `${basename(src, extname(src))}.png`));
35
+ const width = o.width === undefined ? 1280 : Number(o.width);
36
+ const [r] = await renderHtml([{ id: "page", html, width }], dirname(out), join(dirname(out), `.p3-render-out-${process.pid}`), {
37
+ pathMap: settings.codex.pathMap,
38
+ onProgress: progress,
39
+ }).then(async (rs) => {
40
+ // 一時の出力から、指定の名前に移す
41
+ const { rename, rm } = await import("node:fs/promises");
42
+ const tmp = join(dirname(out), `.p3-render-out-${process.pid}`);
43
+ try {
44
+ if (rs[0].ok) await rename(rs[0].file!, out);
45
+ } finally {
46
+ await rm(tmp, { recursive: true, force: true });
47
+ }
48
+ return rs;
49
+ });
50
+ if (!r.ok) return { data: { ok: false, error: r.error, blocked: r.blocked }, text: `描画できません: ${r.error}`, code: 1 };
51
+ const notes = [
52
+ r.clipped ? " 縦に長すぎるので上から切りました" : "",
53
+ r.blocked.length ? ` 止めた読み込み: ${r.blocked.join(", ")}` : "",
54
+ ].filter(Boolean);
55
+ return { data: { ok: true, file: out, clipped: r.clipped, blocked: r.blocked }, text: [`描画しました: ${out}`, ...notes].join("\n") };
56
+ } catch (e) {
57
+ if (!(e instanceof RenderError)) throw e;
58
+ return { data: { ok: false, step: e.step, error: e.message }, text: `描画できません: ${e.message}`, code: 1 };
59
+ }
60
+ }
@@ -0,0 +1,170 @@
1
+ import { basename, relative } from "node:path";
2
+ import { REQUEST_STATUSES, type Request, type Attachment } from "../shared/types.ts";
3
+ import { type P3Context } from "../core/context.ts";
4
+ import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, updateRequest } from "../core/requestOps.ts";
5
+ import { resolvedIssue } from "../core/requestStatus.ts";
6
+ import { table } from "./format.ts";
7
+ import { requestWorkstreams, taskRepo } from "../shared/workTarget.ts";
8
+ import { briefRequest, formatBriefRequest } from "./showView.ts";
9
+ import { UsageError } from "./project.ts";
10
+ import { tagsFrom } from "../shared/tags.ts";
11
+ import { parse, splitPair, list, date, readBody, readAttachFiles } from "./args.ts";
12
+ import { Output, formatEntity, deps } from "./output.ts";
13
+
14
+ /** 要望(p3 request ...)とマイルストーン(p3 milestone ...)のコマンド。変更は server/requestOps.ts を通す */
15
+
16
+ // --- 要望 -----------------------------------------------------------------
17
+
18
+ export async function requestCommand(
19
+ ctx: P3Context,
20
+ out: Output,
21
+ args: string[],
22
+ o: ReturnType<typeof parse>["values"],
23
+ actor: string,
24
+ requestArg: (raw: string | undefined) => string,
25
+ expectedRev: number | undefined,
26
+ ): Promise<number> {
27
+ const [sub, ...rest] = args;
28
+ switch (sub) {
29
+ case "new":
30
+ case "add": {
31
+ const title = rest.join(" ").trim();
32
+ if (!title) throw new UsageError("タイトルを指定してください");
33
+ checkMilestone(ctx, o.milestone);
34
+ const files = await readAttachFiles(o.attach ?? []);
35
+ const r = await createRequest(
36
+ ctx,
37
+ { title, body: readBody(o.body), areas: o.area ?? [], tags: tagsFrom(o.tag ?? []), due: o.due && date(o.due), milestone: o.milestone },
38
+ actor,
39
+ );
40
+ const head = `作成: ${r.id} ${r.title}\n ${relative(process.cwd(), ctx.ws.requests.path(r.id))}`;
41
+ if (!files.length) return out.result(r, () => head);
42
+ // 確かめ済みなので通常は失敗しない。失敗しても要望は残し、付け直す方法を出す
43
+ const attachments: Attachment[] = [];
44
+ const failed: { file: string; error: string }[] = [];
45
+ for (const f of files) {
46
+ try {
47
+ attachments.push(await ctx.preflight.addAttachment(r.id, { data: f.data, name: basename(f.path) }, actor));
48
+ } catch (e) {
49
+ failed.push({ file: f.path, error: (e as Error).message });
50
+ }
51
+ }
52
+ out.result({ ...r, attachments, ...(failed.length ? { failedAttachments: failed } : {}) }, () =>
53
+ [
54
+ head,
55
+ ...attachments.map((a) => ` 添付: ${a.id} ${a.name}`),
56
+ ...failed.map((f) => ` 添付できませんでした: ${f.file}(${f.error})→ p3 attach add ${f.file} --req ${r.id}`),
57
+ ].join("\n"),
58
+ );
59
+ return failed.length ? 1 : 0;
60
+ }
61
+ case undefined:
62
+ case "ls":
63
+ case "list": {
64
+ const status = o.status?.split(",");
65
+ const reqs = ctx.ws.requests
66
+ .list()
67
+ .filter((r) => !status || status.includes(r.status))
68
+ .filter((r) => !o.milestone || r.milestone === o.milestone)
69
+ .filter((r) => !o.tag?.length || o.tag.some((t) => r.tags.includes(t)));
70
+ return out.result(reqs, () =>
71
+ table(reqs.map((r) => [r.id, r.status, r.title, r.milestone ?? "", r.due ?? "", r.tags.map((t) => `#${t}`).join(" ")])) || "要望はありません",
72
+ );
73
+ }
74
+ case "show": {
75
+ const rid = requestArg(rest[0]);
76
+ const r = ctx.ws.requests.require(rid);
77
+ if (o.brief) {
78
+ const view = briefRequest(ctx, r, resolvedIssue(ctx.ws, r));
79
+ return out.result(view, () => formatBriefRequest(view));
80
+ }
81
+ const file = relative(process.cwd(), ctx.ws.requests.path(rid));
82
+ const issue = resolvedIssue(ctx.ws, r);
83
+ const branches = requestWorkstreams(r);
84
+ const multi = ctx.ws.project.repos.length > 0;
85
+ return out.result({ item: r, workstreams: branches, tasks: ctx.ws.tasksOf(rid).list(), file, ...(issue ? { issue } : {}) }, () => {
86
+ const tasks = ctx.ws.tasksOf(rid).list();
87
+ return [
88
+ issue ? `※ ${issue}\n` : "",
89
+ formatEntity(ctx, r, file),
90
+ ...(Object.keys(branches).length
91
+ ? ["", "ブランチ(作業先のリポジトリごと):", ...Object.entries(branches).map(([name, w]) => ` ${name} ${w.branch}`)]
92
+ : []),
93
+ "",
94
+ `タスク (${tasks.length}):`,
95
+ table(tasks.map((t) => [` ${t.id}`, t.status, ...(multi ? [taskRepo(t) ?? "(なし)"] : []), t.title, deps(t)])) || " (なし)",
96
+ ].join("\n");
97
+ });
98
+ }
99
+ case "set": {
100
+ // 1つ目が要望の参照なら対象、キー=値なら今の要望
101
+ const explicit = rest[0] && !rest[0].includes("=") ? rest.shift() : undefined;
102
+ const rid = requestArg(explicit);
103
+ const patch: Partial<Request> = {};
104
+ for (const pair of rest) {
105
+ const [key, value] = splitPair(pair);
106
+ if (key === "title") patch.title = value;
107
+ else if (key === "areas") patch.areas = list(value);
108
+ else if (key === "tags") patch.tags = list(value);
109
+ else if (key === "due") patch.due = value ? date(value) : undefined;
110
+ else if (key === "milestone") patch.milestone = value || undefined;
111
+ else if (key === "status") {
112
+ if (!REQUEST_STATUSES.includes(value as Request["status"])) throw new UsageError(`要望のステータスは ${REQUEST_STATUSES.join(", ")}`);
113
+ patch.status = value as Request["status"];
114
+ } else throw new UsageError("変更できるキー: title status due milestone tags areas");
115
+ }
116
+ if (o.body !== undefined) patch.body = readBody(o.body);
117
+ if (o.tag) {
118
+ if (patch.tags) throw new UsageError("tags= と --tag は一緒に使えません(カンマを含む値は --tag で)");
119
+ patch.tags = tagsFrom(o.tag);
120
+ }
121
+ if (!Object.keys(patch).length) throw new UsageError("キー=値 を指定してください");
122
+ const next = await updateRequest(ctx, rid, patch, { expectedRev, actor });
123
+ return out.result(next, () => `更新: ${next.id} (rev ${next.rev}) ${Object.keys(patch).join(", ")}`);
124
+ }
125
+ case "archive": {
126
+ const rid = requestArg(rest[0]);
127
+ await archiveRequest(ctx, rid);
128
+ return out.result({ archived: rid }, () => `アーカイブ: ${rid}(requests/.archive/ へ)`);
129
+ }
130
+ default:
131
+ throw new UsageError("p3 request [new | ls | show | set | archive]");
132
+ }
133
+ }
134
+
135
+ // --- マイルストーン -----------------------------------------------------------
136
+
137
+ /** マイルストーン(リリース)。複数の要望をまとめる単位で、project.yaml に書く */
138
+ export async function milestoneCommand(ctx: P3Context, out: Output, args: string[], o: ReturnType<typeof parse>["values"]): Promise<number> {
139
+ const [sub, id] = args;
140
+ const ms = ctx.ws.project.milestones;
141
+ const count = (mid: string) => ctx.ws.requests.list().filter((r) => r.milestone === mid).length;
142
+ if (sub === "add" || sub === "set") {
143
+ if (!id || !/^[A-Za-z0-9._-]+$/.test(id)) throw new UsageError(`p3 milestone ${sub} <id>(英数字と . _ -)`);
144
+ const cur = ms.find((m) => m.id === id);
145
+ if (sub === "add" && cur) throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
146
+ if (sub === "set" && !cur) throw new UsageError(`マイルストーンがありません: ${id}`);
147
+ const next = {
148
+ id,
149
+ title: o.title ?? cur?.title ?? id,
150
+ due: o.due !== undefined ? (o.due ? date(o.due) : undefined) : cur?.due,
151
+ done: o.done ?? cur?.done,
152
+ };
153
+ await ctx.ws.saveProject({ milestones: cur ? ms.map((m) => (m.id === id ? next : m)) : [...ms, next] });
154
+ return out.result(next, () => `${cur ? "更新" : "追加"}しました: ${next.title}(${id}${next.due ? ` · ${next.due}` : ""})`);
155
+ }
156
+ if (sub === "rm" || sub === "remove") {
157
+ if (!id || !ms.some((m) => m.id === id)) throw new UsageError(`マイルストーンがありません: ${id ?? ""}`);
158
+ await checkMilestoneRemoval(ctx, ms.filter((m) => m.id !== id).map((m) => m.id));
159
+ await ctx.ws.saveProject({ milestones: ms.filter((m) => m.id !== id) });
160
+ return out.result({ removed: id }, () => `外しました: ${id}`);
161
+ }
162
+ if (sub && sub !== "ls" && sub !== "list") throw new UsageError("p3 milestone [ls | add <id> | set <id> | rm <id>]");
163
+ return out.result(
164
+ ms,
165
+ () =>
166
+ table(ms.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
167
+ "マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース --due 2026-11-30)",
168
+ );
169
+ }
170
+
@@ -0,0 +1,110 @@
1
+ import { absRef, parseRef } from "../shared/refs.ts";
2
+ import type { Request, SupersededMark, Task } from "../shared/types.ts";
3
+ import type { P3Context } from "../core/context.ts";
4
+ import { supersededWarnings, type Warning } from "../core/supersede.ts";
5
+ import { table } from "./format.ts";
6
+ import { taskWork } from "../core/workTargets.ts";
7
+ import { requestWorkstreams } from "../shared/workTarget.ts";
8
+
9
+ /**
10
+ * show の短い出力(--brief)と、通常の出力と共通の項目。
11
+ *
12
+ * 短い出力は、AI がタスクを進めるのに要るものだけにする(本文は切り詰めない):
13
+ * タスク: id・ref・request・title・status・body・rev・outputs・repoOutputs・依存(relations の depends_on)
14
+ * + work(作業先とそのブランチ)・dependencies(依存の相手と状態)・superseded・warnings
15
+ * 要望: id・title・status・body・rev・workstreams + branches(作業先ごとのブランチ)+
16
+ * タスクの一覧(id・ref・title・status・repo)・issue
17
+ * 省くもの: 日時・areas・labels・変更者・ファイルのパス・依存以外の関係・関係しそう(暗黙の近さ)・影響範囲。
18
+ * JSON の項目名と階層は通常の --json と同じで、項目を省くだけ(短い出力だけの別名は作らない)。
19
+ */
20
+
21
+ /** 依存の相手とその状態。相手が見つからない(アーカイブした・参照の誤り)ときは title・status が null(完了とは扱わない) */
22
+ export interface DependencyState {
23
+ ref: string;
24
+ title: string | null;
25
+ status: string | null;
26
+ }
27
+
28
+ export function dependencyStates(ctx: P3Context, task: Task): DependencyState[] {
29
+ return task.relations
30
+ .filter((r) => r.type === "depends_on")
31
+ .map((r) => {
32
+ const ref = absRef(r.target, task.request) ?? r.target;
33
+ const p = parseRef(ref);
34
+ const target = p?.task ? ctx.ws.task(ref) : ctx.ws.requests.get(ref);
35
+ return { ref, title: target?.title ?? null, status: target?.status ?? null };
36
+ });
37
+ }
38
+
39
+ /** タスクの詳細で共通に出す項目(通常・短い出力の両方) */
40
+ export function taskExtras(ctx: P3Context, task: Task, marks: Map<string, SupersededMark[]>) {
41
+ const superseded = marks.get(task.ref) ?? [];
42
+ const warnings: Warning[] = supersededWarnings(superseded, task.ref);
43
+ return { superseded, dependencies: dependencyStates(ctx, task), warnings };
44
+ }
45
+
46
+ const BRIEF_TASK_KEYS = ["id", "ref", "request", "title", "status", "body", "rev", "outputs", "relations"] as const;
47
+
48
+ export function briefTask(ctx: P3Context, task: Task, marks: Map<string, SupersededMark[]>) {
49
+ const item = Object.fromEntries(BRIEF_TASK_KEYS.map((k) => [k, task[k]])) as unknown as Pick<Task, (typeof BRIEF_TASK_KEYS)[number]> & Pick<Task, "repoOutputs" | "record">;
50
+ item.relations = task.relations.filter((r) => r.type === "depends_on");
51
+ if (task.repoOutputs?.length) item.repoOutputs = task.repoOutputs;
52
+ // 変更の記録(完了したタスク)。経緯を知るために読む
53
+ if (task.record) item.record = task.record;
54
+ // 着手先: 作業先のリポジトリとそのブランチ(作業先なしは repo: null)
55
+ return { item, work: taskWork(ctx.ws, task), ...taskExtras(ctx, task, marks) };
56
+ }
57
+
58
+ export function formatBriefTask(view: ReturnType<typeof briefTask>): string {
59
+ const { item, work, dependencies, warnings } = view;
60
+ const short = (ref: string) => (ref.startsWith(`${item.request}/`) ? ref.slice(item.request.length + 1) : ref);
61
+ const lines = [`${item.ref} ${item.title}`, ` status ${item.status} rev ${item.rev}`];
62
+ lines.push(
63
+ ` 作業先 ${work.repo ? `${work.repo}${work.branch ? ` branch ${work.branch}` : "(ブランチなし)"}${work.registered ? "" : ` ※このマシンのパスが未登録(p3 repo path ${work.repo} <パス>)`}` : "なし"}`,
64
+ );
65
+ if (dependencies.length) {
66
+ lines.push(` 依存 ${dependencies.map((d) => `${short(d.ref)} ${d.status ?? "(状態不明)"}`).join(" / ")}`);
67
+ }
68
+ for (const o of item.outputs) lines.push(` 成果物 ${o}`);
69
+ for (const o of item.repoOutputs ?? []) lines.push(` 成果物 ${o.repo}: ${o.output}`);
70
+ for (const w of warnings) lines.push(`※ ${w.message}`);
71
+ if (item.body.trim()) lines.push("", item.body.trim());
72
+ if (item.record) lines.push("", "## 変更の記録", item.record);
73
+ return lines.join("\n");
74
+ }
75
+
76
+ export function briefRequest(ctx: P3Context, r: Request, issue: string | undefined) {
77
+ const item: Pick<Request, "id" | "title" | "status" | "body" | "rev" | "workstreams"> = {
78
+ id: r.id,
79
+ title: r.title,
80
+ status: r.status,
81
+ body: r.body,
82
+ rev: r.rev,
83
+ ...(r.workstreams ? { workstreams: r.workstreams } : {}),
84
+ };
85
+ const branches = requestWorkstreams(r);
86
+ const tasks = ctx.ws
87
+ .tasksOf(r.id)
88
+ .list()
89
+ .map((t) => ({ id: t.id, ref: t.ref, title: t.title, status: t.status, repo: t.repo }));
90
+ return { item, branches, tasks, ...(issue ? { issue } : {}) };
91
+ }
92
+
93
+ export function formatBriefRequest(view: ReturnType<typeof briefRequest>): string {
94
+ const { item, branches, tasks, issue } = view;
95
+ const names = Object.keys(branches);
96
+ // ブランチは作業先ごと
97
+ const branchLine = "";
98
+ return [
99
+ issue ? `※ ${issue}` : "",
100
+ `${item.id} ${item.title}`,
101
+ ` status ${item.status} rev ${item.rev}${branchLine}`,
102
+ ...(branchLine ? [] : names.map((n) => ` branch ${n}: ${branches[n].branch}`)),
103
+ item.body.trim() ? `\n${item.body.trim()}` : "",
104
+ "",
105
+ `タスク (${tasks.length}):`,
106
+ table(tasks.map((t) => [` ${t.id}`, t.status, t.repo ?? "(作業先なし)", t.title])) || " (なし)",
107
+ ]
108
+ .filter((l, i) => l !== "" || i > 1)
109
+ .join("\n");
110
+ }
@@ -0,0 +1,167 @@
1
+ import { relative } from "node:path";
2
+ import type { Task } from "../shared/types.ts";
3
+ import { listTasks, resolve, resolveRef } from "../core/ops.ts";
4
+ import { archiveTask, createTask, updateTask } from "../core/requestOps.ts";
5
+ import { supersededMarks } from "../core/supersede.ts";
6
+ import { table } from "./format.ts";
7
+ import { taskRepo } from "../shared/workTarget.ts";
8
+ import { addRepoOutputs, parseRepoOutput, repoArg } from "../core/workTargets.ts";
9
+ import { briefTask, formatBriefTask, taskExtras } from "./showView.ts";
10
+ import { UsageError } from "./project.ts";
11
+ import { parseTaskAssignments, checkStatus, readBody, type CommandEnv } from "./args.ts";
12
+ import { dependentsOf, formatEntity, ambiguous, replacedBy, reopenedNote, warn, deps, workHint } from "./output.ts";
13
+ import { requestCommand } from "./requestCommands.ts";
14
+
15
+ /** タスクのコマンド(ls / show / find / impact / new / set / move / check / link / unlink / archive)。変更は server/requestOps.ts を通す。扱わないコマンドは undefined */
16
+
17
+ const RECORD_REQUIRED =
18
+ "AI が完了にするときは --record で変更の記録を残してください(何を変えたか・なぜ・入れた決まり・やめたもの。Markdown。- で標準入力)\n" +
19
+ " 例: p3 move T003 done --output <URL> --record - < record.md";
20
+
21
+ export async function taskCommand(cmd: string, env: CommandEnv): Promise<number | undefined> {
22
+ const { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd } = env;
23
+ switch (cmd) {
24
+ // --- タスク -------------------------------------------------------------
25
+ case "ls":
26
+ case "list": {
27
+ if (o.repo !== undefined && o.repo !== "none" && !ctx.ws.project.repos.some((r) => r.name === o.repo)) {
28
+ throw new UsageError(`参照先「${o.repo}」は登録されていません(p3 repo ls)`);
29
+ }
30
+ const filter = { status: o.status?.split(","), area: o.area?.[0], q: o.q, repo: o.repo };
31
+ const tasks = listTasks(ctx, { ...filter, request: o.all ? undefined : requestArg(undefined) });
32
+ const marks = supersededMarks(ctx.ws);
33
+ const items = tasks.map((t) => (marks.has(t.ref) ? { ...t, superseded: marks.get(t.ref) } : t));
34
+ // 共有の参照先があるときは作業先の列を出す
35
+ const multi = ctx.ws.project.repos.length > 0;
36
+ return out.result(items, () =>
37
+ table(
38
+ tasks.map((t) => [
39
+ o.all ? t.ref : t.id,
40
+ t.status,
41
+ ...(multi ? [taskRepo(t) ?? "(なし)"] : []),
42
+ t.title,
43
+ [deps(t), replacedBy(t, marks)].filter(Boolean).join(" "),
44
+ ]),
45
+ ) || "タスクはありません",
46
+ );
47
+ }
48
+
49
+ case "show": {
50
+ const query = args.join(" ");
51
+ const ref = resolveRef(ctx, query, current) ?? resolve(ctx, query, current).match;
52
+ if (!ref) return ambiguous(out, ctx, query, current);
53
+ if (!ref.includes("/")) return requestCommand(ctx, out, ["show", ref], o, actor, requestArg, expectedRev);
54
+ const item = ctx.ws.requireTask(ref);
55
+ const marks = supersededMarks(ctx.ws);
56
+ if (o.brief) {
57
+ const view = briefTask(ctx, item, marks);
58
+ return out.result(view, () => formatBriefTask(view));
59
+ }
60
+ const file = relative(cwd, split(ref).col.path(item.id));
61
+ const { superseded, dependencies, warnings } = taskExtras(ctx, item, marks);
62
+ const dependents = dependentsOf(ctx, item).map((t) => ({ ref: t.ref, title: t.title, status: t.status }));
63
+ return out.result({ item, file, superseded, dependencies, dependents, warnings }, () =>
64
+ [superseded.length ? `※ 置き換えられています: ${superseded.map((m) => `${m.from}${m.note ? `(${m.note})` : ""}`).join(" / ")}\n` : "", formatEntity(ctx, item, file)].join(""),
65
+ );
66
+ }
67
+
68
+ case "find":
69
+ case "resolve": {
70
+ const r = resolve(ctx, args.join(" "), current);
71
+ return out.result(r, () => table(r.candidates.map((c) => [c.ref, c.score.toFixed(2), c.title, c.reasons.join(" / ")])) || "見つかりません");
72
+ }
73
+
74
+ case "new":
75
+ case "add": {
76
+ // 互換: new task <タイトル> / new request <タイトル>
77
+ if (args[0] === "request" || args[0] === "req") return requestCommand(ctx, out, ["new", ...args.slice(1)], o, actor, requestArg, expectedRev);
78
+ const title = (args[0] === "task" ? args.slice(1) : args).join(" ").trim();
79
+ if (!title) throw new UsageError("タイトルを指定してください");
80
+ const rid = requestArg(undefined);
81
+ const status = o.status ?? "todo";
82
+ checkStatus(status);
83
+ // 作業先(--repo <名前>|none)。作業先にできるものだけ。書く前に確かめる
84
+ const repo = repoArg(o.repo);
85
+ const repoOutputs = (o["repo-output"] ?? []).map((x) => parseRepoOutput(ctx.ws, x));
86
+ const r = await createTask(
87
+ ctx,
88
+ rid,
89
+ {
90
+ title,
91
+ status,
92
+ ...(repo !== undefined ? { repo } : {}),
93
+ labels: o.label ?? [],
94
+ areas: o.area ?? [],
95
+ outputs: o.output ?? [],
96
+ ...(repoOutputs.length ? { repoOutputs: addRepoOutputs([], repoOutputs) } : {}),
97
+ body: readBody(o.body),
98
+ },
99
+ actor,
100
+ );
101
+ const t = r.task;
102
+ const reopened = reopenedNote(r.reopened);
103
+ return out.result(reopened ? { ...t, reopened } : t, () => [`作成: ${t.ref} ${t.title}`, workHint(ctx, t)].filter(Boolean).join("\n"));
104
+ }
105
+
106
+ case "set": {
107
+ const ref = taskArg(args[0]);
108
+ const patch = parseTaskAssignments(args.slice(1));
109
+ if (o.body !== undefined) patch.body = readBody(o.body);
110
+ if (o.record !== undefined) patch.record = readBody(o.record).trim() || undefined;
111
+ const { col, tid } = split(ref);
112
+ if (patch.status === "done" && actor.startsWith("ai:") && !patch.record && !col.require(tid).record) throw new UsageError(RECORD_REQUIRED);
113
+ if (o["repo-output"]?.length) {
114
+ const add = o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x));
115
+ patch.repoOutputs = addRepoOutputs(patch.repoOutputs ?? col.require(tid).repoOutputs ?? [], add);
116
+ }
117
+ if (!Object.keys(patch).length) throw new UsageError("キー=値 を指定してください");
118
+ const r = await updateTask(ctx, ref.split("/")[0], tid, patch, { expectedRev, actor });
119
+ const { task: next, warnings } = r;
120
+ warn(warnings);
121
+ const reopened = reopenedNote(r.reopened);
122
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}) }, () =>
123
+ [`更新: ${next.ref} (rev ${next.rev}) ${Object.keys(patch).join(", ")}`, "repo" in patch ? workHint(ctx, next) : ""].filter(Boolean).join("\n"),
124
+ );
125
+ }
126
+
127
+ case "move": {
128
+ const ref = taskArg(args[0]);
129
+ const status = args[1];
130
+ if (!status) throw new UsageError("移動先のステータスを指定してください");
131
+ checkStatus(status);
132
+ const { col, tid } = split(ref);
133
+ const cur = col.require(tid);
134
+ const patch: Partial<Task> = { status };
135
+ if (o.record !== undefined) patch.record = readBody(o.record).trim() || undefined;
136
+ // AI が完了にするときは変更の記録を残す(後の Preflight・タスク解析・リリースノートが読む)
137
+ if (status === "done" && actor.startsWith("ai:") && !patch.record && !cur.record) throw new UsageError(RECORD_REQUIRED);
138
+ if (o.output?.length) patch.outputs = [...new Set([...cur.outputs, ...o.output])];
139
+ // リポジトリごとの成果物(最後のタスクに、関係するリポジトリの PR を全部残せる)
140
+ if (o["repo-output"]?.length) patch.repoOutputs = addRepoOutputs(cur.repoOutputs ?? [], o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x)));
141
+ const r = await updateTask(ctx, cur.request, tid, patch, { expectedRev, actor });
142
+ const { task: next, warnings } = r;
143
+ warn(warnings);
144
+ const reopened = reopenedNote(r.reopened);
145
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}) }, () =>
146
+ `${next.ref} → ${status}${[...(o.output ?? []), ...(o["repo-output"] ?? [])].length ? ` (${[...(o.output ?? []), ...(o["repo-output"] ?? [])].join(", ")})` : ""}`,
147
+ );
148
+ }
149
+
150
+ case "check": {
151
+ const ref = taskArg(args[0]);
152
+ const { tid } = split(ref);
153
+ const { task: next } = await updateTask(ctx, ref.split("/")[0], tid, { checked: !o.off }, { expectedRev, actor });
154
+ return out.result(next, () => `${next.ref} ${o.off ? "の済みを外しました" : "を済みにしました"}`);
155
+ }
156
+
157
+ case "archive": {
158
+ const ref = taskArg(args[0]);
159
+ const { tid } = split(ref);
160
+ await archiveTask(ctx, ref.split("/")[0], tid);
161
+ return out.result({ archived: ref }, () => `アーカイブ: ${ref}`);
162
+ }
163
+
164
+ }
165
+ return undefined;
166
+ }
167
+