@infodb/p3 0.3.0 → 0.4.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/dist/web/assets/{Outputs-DqJdybkd.js → Outputs-5Hby-S5Q.js} +1 -1
- package/dist/web/assets/{RequestStatus-DN-2iAM0.js → RequestStatus-CTkGjT02.js} +1 -1
- package/dist/web/assets/{TagInput-D-1ILLDX.js → TagInput-Rj3PNOAF.js} +1 -1
- package/dist/web/assets/{TaskDrawer-CHD7T-Su.js → TaskDrawer-DtPhiYxP.js} +1 -1
- package/dist/web/assets/_requestId-CGvAfIkB.js +30 -0
- package/dist/web/assets/_requestId-DxfYhgAq.js +1 -0
- package/dist/web/assets/{board-BIkOpuC4.js → board-wt47lfrE.js} +1 -1
- package/dist/web/assets/copy-CKsXEjMi.js +1 -0
- package/dist/web/assets/{done-BUAUhIRr.js → done-C9Ct7ssb.js} +1 -1
- package/dist/web/assets/{index-Byv9j77D.js → index-BTFL2rpp.js} +4 -4
- package/dist/web/assets/index-DAyBsvua.css +2 -0
- package/dist/web/assets/milestoneOrder-N7b5XFJP.js +1 -0
- package/dist/web/assets/new-e4ID2vQV.js +1 -0
- package/dist/web/assets/preflightInput-DMxqnvF8.js +2 -0
- package/dist/web/assets/{preload-helper-DlN0ouRj.js → preload-helper-DhIyFaOW.js} +1 -1
- package/dist/web/assets/release-notes-CQ0d2r0k.js +3 -0
- package/dist/web/assets/{requestData-DJ1Rlx-u.js → requestData-BDZqyl35.js} +1 -1
- package/dist/web/assets/routes-Bipv3lwJ.js +2 -0
- package/dist/web/assets/settings-Dwh8fj6p.js +1 -0
- package/dist/web/assets/{ui-Sz7y5_TS.js → ui-DdOGYj9z.js} +1 -1
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +18 -6
- package/docs/how-to-use.md +58 -7
- package/docs/installation.md +5 -5
- package/package.json +1 -1
- package/skills/p3/SKILL.md +19 -8
- package/src/cli/help.ts +3 -0
- package/src/cli/main.ts +2 -1
- package/src/cli/project.ts +6 -3
- package/src/cli/releaseNotesCommands.ts +42 -3
- package/src/cli/requestCommands.ts +4 -2
- package/src/cli/taskCommands.ts +1 -1
- package/src/core/releaseNotes/completeRequests.ts +102 -0
- package/src/core/releaseNotes/service.ts +9 -5
- package/src/server/api/manifest.ts +8 -1
- package/src/server/api/releaseNoteRoutes.ts +11 -0
- package/src/shared/milestoneOrder.ts +44 -0
- package/src/shared/types.ts +30 -0
- package/dist/web/assets/_requestId-BzSepQIV.js +0 -30
- package/dist/web/assets/_requestId-pIds2tFU.js +0 -1
- package/dist/web/assets/copy-B1ZbihKL.js +0 -2
- package/dist/web/assets/index-DTfUhuQw.css +0 -2
- package/dist/web/assets/new-6kly4-PX.js +0 -1
- package/dist/web/assets/release-notes-iwQWmfX6.js +0 -3
- package/dist/web/assets/routes-Ciot9p4x.js +0 -2
- package/dist/web/assets/settings-DBCi6lAY.js +0 -1
|
@@ -4,6 +4,7 @@ import type { P3Context } from "../../core/context.ts";
|
|
|
4
4
|
import { GenerationRejected } from "../../core/releaseNotes/generate.ts";
|
|
5
5
|
import { exportReleaseNote, releaseNoteDetail, releaseOverview, saveReleaseNote, startGeneration } from "../../core/releaseNotes/service.ts";
|
|
6
6
|
import { ReleaseNoteError } from "../../core/releaseNotes/store.ts";
|
|
7
|
+
import { completeMilestoneRequests, CompletionRejected } from "../../core/releaseNotes/completeRequests.ts";
|
|
7
8
|
|
|
8
9
|
/**
|
|
9
10
|
* リリースノート(画面のため)。規則と保存は core/releaseNotes(CLI の p3 release-notes と同じ)。
|
|
@@ -12,6 +13,9 @@ import { ReleaseNoteError } from "../../core/releaseNotes/store.ts";
|
|
|
12
13
|
* GET /release-notes/:mid 保存したノートと材料(対象の要望・警告・出典)
|
|
13
14
|
* PUT /release-notes/:mid 保存(version 無しは新規、ありは更新。違えば 409 rev_conflict)
|
|
14
15
|
* GET /release-notes/:mid/export 保存した本文(Markdown のダウンロード)
|
|
16
|
+
* POST /release-notes/:mid/complete-requests 対応済の要望を一括で完了済にする(basedOn 必須。判定は詳細の completion)。
|
|
17
|
+
* 頼めなければ何も書かずに 409(material_changed / blocked と今の判定 plan)。
|
|
18
|
+
* 途中で止まったら 409 partial と結果(完了済にしたもの・失敗・未実行)
|
|
15
19
|
* POST /release-notes/:mid/generate 要約の生成を始める(202。保存しない)
|
|
16
20
|
* GET /release-notes/:mid/generations このマイルストーンの生成(新しい順)
|
|
17
21
|
* GET /release-generations/:id 生成1件 / POST .../cancel 取り消す
|
|
@@ -41,6 +45,7 @@ export function releaseNoteRoutes(ctx: P3Context) {
|
|
|
41
45
|
const current = await ctx.ws.releaseNotes.read(mid).catch(() => null);
|
|
42
46
|
return c.json({ error: err.message, code: "rev_conflict", reason: err.code, current }, 409);
|
|
43
47
|
}
|
|
48
|
+
if (err instanceof CompletionRejected) return c.json({ error: err.message, code: err.code, plan: err.plan }, 409);
|
|
44
49
|
if (err instanceof GenerationRejected) return c.json({ error: err.message, code: err.code }, err.code === "running" ? 409 : 400);
|
|
45
50
|
if (err instanceof z.ZodError) return c.json({ error: "invalid input", issues: err.issues }, 400);
|
|
46
51
|
console.error(err);
|
|
@@ -63,6 +68,12 @@ export function releaseNoteRoutes(ctx: P3Context) {
|
|
|
63
68
|
"Cache-Control": "no-store",
|
|
64
69
|
});
|
|
65
70
|
});
|
|
71
|
+
app.post("/release-notes/:mid/complete-requests", async (c) => {
|
|
72
|
+
const { basedOn } = z.object({ basedOn: z.string().min(1) }).parse(await c.req.json().catch(() => ({})));
|
|
73
|
+
const r = await completeMilestoneRequests(ctx, c.req.param("mid"), basedOn, actorOf(c));
|
|
74
|
+
if (r.failed) return c.json({ error: `${r.failed.id} で止まりました: ${r.failed.reason}`, code: "partial", result: r }, 409);
|
|
75
|
+
return c.json(r);
|
|
76
|
+
});
|
|
66
77
|
app.post("/release-notes/:mid/generate", async (c) => {
|
|
67
78
|
const { engine } = z.object({ engine: z.enum(["codex", "mock"]).optional() }).parse(await c.req.json().catch(() => ({})));
|
|
68
79
|
return c.json(await startGeneration(ctx, c.req.param("mid"), actorOf(c), engine), 202);
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* マイルストーンの表示の順: ID のバージョンの降順(新しいものが先)。CLI・API・画面のどの一覧・選ぶ欄でも使う。
|
|
3
|
+
* 保存してある順(project.yaml)は変えない(表示のたびに並べる)。
|
|
4
|
+
*
|
|
5
|
+
* - 比べるのは ID だけ(タイトル・期限・リリース済みかは見ない)
|
|
6
|
+
* - 先頭の v / V は比べるときだけ外す。数字の続きは数として比べる(0.10.0 > 0.9.0、v2.0 > v1.10 > v1.9)
|
|
7
|
+
* - バージョンでない ID も同じ規則で比べる(厳密な SemVer のプレリリースの順は持たない)
|
|
8
|
+
* - それでも同じなら、元の ID の文字列で決める(登録の順によらない)
|
|
9
|
+
*/
|
|
10
|
+
export function compareMilestoneIds(a: string, b: string): number {
|
|
11
|
+
const ta = tokens(a);
|
|
12
|
+
const tb = tokens(b);
|
|
13
|
+
for (let i = 0; i < Math.min(ta.length, tb.length); i++) {
|
|
14
|
+
const c = compareToken(ta[i], tb[i]);
|
|
15
|
+
if (c) return -c;
|
|
16
|
+
}
|
|
17
|
+
if (ta.length !== tb.length) return tb.length - ta.length;
|
|
18
|
+
return a < b ? 1 : a > b ? -1 : 0;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** ID の降順に並べた新しい配列(元の配列は変えない) */
|
|
22
|
+
export function sortMilestones<T extends { id: string }>(list: readonly T[]): T[] {
|
|
23
|
+
return [...list].sort((x, y) => compareMilestoneIds(x.id, y.id));
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/** 数字の続きと、それ以外の続きに分ける(先頭の v / V は外す) */
|
|
27
|
+
function tokens(id: string): string[] {
|
|
28
|
+
return id.replace(/^[vV]/, "").match(/\d+|\D+/g) ?? [];
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** 昇順の比較。数字どうしは数として(桁の多いほうが大きい。先頭の 0 は除く)、それ以外は文字列として */
|
|
32
|
+
function compareToken(a: string, b: string): number {
|
|
33
|
+
const da = /^\d/.test(a);
|
|
34
|
+
const db = /^\d/.test(b);
|
|
35
|
+
if (da && db) {
|
|
36
|
+
const na = a.replace(/^0+(?=\d)/, "");
|
|
37
|
+
const nb = b.replace(/^0+(?=\d)/, "");
|
|
38
|
+
if (na.length !== nb.length) return na.length - nb.length;
|
|
39
|
+
return na < nb ? -1 : na > nb ? 1 : 0;
|
|
40
|
+
}
|
|
41
|
+
// 数字の続きと文字の続きでは、数字を小さいとする(どちらかに決めて順を一意にする)
|
|
42
|
+
if (da !== db) return da ? -1 : 1;
|
|
43
|
+
return a < b ? -1 : a > b ? 1 : 0;
|
|
44
|
+
}
|
package/src/shared/types.ts
CHANGED
|
@@ -586,6 +586,36 @@ export interface ReleaseMaterial {
|
|
|
586
586
|
extractedAt: string;
|
|
587
587
|
}
|
|
588
588
|
|
|
589
|
+
/**
|
|
590
|
+
* マイルストーンの要望を一括で完了済にできるか(core/releaseNotes/completeRequests.ts が判定する。画面・CLI は見せるだけ)。
|
|
591
|
+
* 見送りを除く全要望が収録の条件(対応済か完了済・タスクが1件以上で全部完了・読めないタスクなし)を満たすときだけできる。
|
|
592
|
+
* 変えるのは対応済(resolved)だけで、完了済・見送り・タスク(済みを含む)・ノートは変えない
|
|
593
|
+
*/
|
|
594
|
+
export interface RequestCompletionPlan {
|
|
595
|
+
milestone: string;
|
|
596
|
+
/** 判定に使った材料の hash(実行するときにそのまま渡す) */
|
|
597
|
+
basedOn: string;
|
|
598
|
+
/** 実行できる(blockers が無い)。対象が0件でもできる(何も変えない) */
|
|
599
|
+
ready: boolean;
|
|
600
|
+
/** 完了済にする要望(対応済のもの) */
|
|
601
|
+
targets: { id: string; title: string }[];
|
|
602
|
+
/** 既に完了済(変えない) */
|
|
603
|
+
alreadyDone: string[];
|
|
604
|
+
/** 見送り(判定から除き、変えない) */
|
|
605
|
+
skipped: string[];
|
|
606
|
+
/** できない理由(target は要望 ID かマイルストーン・ファイル) */
|
|
607
|
+
blockers: { target: string; reason: string }[];
|
|
608
|
+
}
|
|
609
|
+
|
|
610
|
+
/** 一括で完了済にした結果。途中で止まったら、完了済にしたもの・失敗した1件・まだ変えていないものを分けて返す */
|
|
611
|
+
export interface RequestCompletionResult {
|
|
612
|
+
milestone: string;
|
|
613
|
+
completed: { id: string; title: string }[];
|
|
614
|
+
failed?: { id: string; reason: string; code: "conflict" | "changed" | "error" };
|
|
615
|
+
notRun: string[];
|
|
616
|
+
alreadyDone: string[];
|
|
617
|
+
}
|
|
618
|
+
|
|
589
619
|
/** 保存したリリースノート。本文(公開する Markdown)と、内部の出典(frontmatter)を分けて持つ */
|
|
590
620
|
export interface ReleaseNote {
|
|
591
621
|
milestone: string;
|