@infodb/p3 0.4.0 → 0.5.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/bin/p3.mjs +11 -5
- package/dist/web/assets/Outputs-C83ZDXvs.js +1 -0
- package/dist/web/assets/RequestStatus-GmiWYEcL.js +1 -0
- package/dist/web/assets/Tabs-CJn0Qy7W.js +1 -0
- package/dist/web/assets/TagInput-CtM8HM8Z.js +1 -0
- package/dist/web/assets/TaskDrawer-D5v36QoF.js +3 -0
- package/dist/web/assets/_requestId-BHUqLO-j.js +1 -0
- package/dist/web/assets/_requestId-DxwxbXY2.js +30 -0
- package/dist/web/assets/{ui-DdOGYj9z.js → appCtx-B-VRVOyv.js} +1 -1
- package/dist/web/assets/board-DAaVR04x.js +1 -0
- package/dist/web/assets/done-CaqB_qTH.js +1 -0
- package/dist/web/assets/index-BF1xMdJo.css +2 -0
- package/dist/web/assets/index-BQYvKpjF.js +12 -0
- package/dist/web/assets/new-DLVnRvrB.js +1 -0
- package/dist/web/assets/{preflightInput-DMxqnvF8.js → preflightInput-BAeEJYUK.js} +1 -1
- package/dist/web/assets/preload-helper-B74h5i3O.js +1 -0
- package/dist/web/assets/progressTree-wp9mH4VF.js +1 -0
- package/dist/web/assets/release-notes-MTLcOcvZ.js +3 -0
- package/dist/web/assets/requestData-D-HXu-cy.js +1 -0
- package/dist/web/assets/routes-CI4Qfkjs.js +3 -0
- package/dist/web/assets/settings-CJMNgzi6.js +1 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +220 -3
- package/docs/development.md +16 -9
- package/docs/how-to-use.md +72 -7
- package/docs/installation.md +8 -6
- package/docs/publishing.md +4 -2
- package/lib/cli/args.js +172 -0
- package/lib/cli/chatgpt.js +70 -0
- package/lib/cli/codex.js +30 -0
- package/lib/cli/format.js +9 -0
- package/{src/cli/help.ts → lib/cli/help.js} +8 -8
- package/lib/cli/main.js +326 -0
- package/lib/cli/output.js +110 -0
- package/lib/cli/preflightCommands.js +301 -0
- package/lib/cli/project.js +649 -0
- package/lib/cli/readOnly.js +36 -0
- package/lib/cli/releaseNotesCommands.js +197 -0
- package/lib/cli/render.js +58 -0
- package/lib/cli/requestCommands.js +180 -0
- package/lib/cli/showView.js +100 -0
- package/lib/cli/taskCommands.js +152 -0
- package/lib/cli/userConfig.js +64 -0
- package/{src/core/chatgpt.ts → lib/core/chatgpt.js} +10 -16
- package/lib/core/context.js +41 -0
- package/lib/core/hierarchy.js +128 -0
- package/lib/core/machineSettings.js +146 -0
- package/lib/core/machineSettingsEdit.js +148 -0
- package/lib/core/ops.js +120 -0
- package/lib/core/preflight/carryover.js +105 -0
- package/lib/core/preflight/codexEngine.js +687 -0
- package/lib/core/preflight/codexImage.js +61 -0
- package/lib/core/preflight/diagnose.js +95 -0
- package/lib/core/preflight/engine.js +58 -0
- package/lib/core/preflight/input.js +83 -0
- package/lib/core/preflight/launch.js +68 -0
- package/lib/core/preflight/mockEngine.js +175 -0
- package/lib/core/preflight/render.js +304 -0
- package/lib/core/preflight/service.js +868 -0
- package/lib/core/preflight/split.js +83 -0
- package/lib/core/preflight/uiMaterials.js +281 -0
- package/lib/core/preflight/uiRender.js +89 -0
- package/lib/core/preflight/wireframe.js +63 -0
- package/lib/core/preflight/xlsx.js +324 -0
- package/lib/core/projectRegistry.js +207 -0
- package/lib/core/redact.js +28 -0
- package/lib/core/releaseNotes/completeRequests.js +106 -0
- package/lib/core/releaseNotes/generate.js +266 -0
- package/lib/core/releaseNotes/material.js +141 -0
- package/lib/core/releaseNotes/mockSummarizer.js +26 -0
- package/lib/core/releaseNotes/service.js +83 -0
- package/lib/core/releaseNotes/store.js +209 -0
- package/lib/core/repoAdmin.js +82 -0
- package/lib/core/repoRefs.js +72 -0
- package/lib/core/requestOps.js +154 -0
- package/lib/core/requestStatus.js +171 -0
- package/lib/core/store/attachments.js +242 -0
- package/lib/core/store/collection.js +254 -0
- package/lib/core/store/frontmatter.js +18 -0
- package/lib/core/store/fsutil.js +84 -0
- package/lib/core/store/locate.js +162 -0
- package/lib/core/store/normalize.js +150 -0
- package/lib/core/store/noteStore.js +59 -0
- package/lib/core/store/preflightStore.js +161 -0
- package/lib/core/store/projectFile.js +99 -0
- package/lib/core/store/workspace.js +320 -0
- package/lib/core/supersede.js +69 -0
- package/lib/core/userConfig.js +158 -0
- package/{src/core/userTheme.ts → lib/core/userTheme.js} +11 -13
- package/lib/core/workTargets.js +106 -0
- package/lib/server/api/chatgptRoutes.js +46 -0
- package/{src/server/api/local.ts → lib/server/api/local.js} +23 -22
- package/lib/server/api/manifest.js +140 -0
- package/lib/server/api/projectsRoutes.js +82 -0
- package/lib/server/api/releaseNoteRoutes.js +88 -0
- package/lib/server/api/repoRoutes.js +67 -0
- package/lib/server/api/routes.js +404 -0
- package/lib/server/api/userThemeRoutes.js +60 -0
- package/lib/server/server.js +85 -0
- package/lib/shared/dates.js +10 -0
- package/{src/shared/directTask.ts → lib/shared/directTask.js} +3 -11
- package/lib/shared/hierarchy.js +120 -0
- package/lib/shared/milestoneOrder.js +45 -0
- package/lib/shared/preflightInput.js +19 -0
- package/lib/shared/refs.js +44 -0
- package/lib/shared/repos.js +69 -0
- package/lib/shared/scopeView.js +39 -0
- package/{src/shared/tags.ts → lib/shared/tags.js} +9 -14
- package/lib/shared/types.js +74 -0
- package/lib/shared/workTarget.js +31 -0
- package/package.json +4 -7
- package/skills/p3/SKILL.md +10 -0
- package/dist/web/assets/Outputs-5Hby-S5Q.js +0 -1
- package/dist/web/assets/RequestStatus-CTkGjT02.js +0 -1
- package/dist/web/assets/TagInput-Rj3PNOAF.js +0 -1
- package/dist/web/assets/TaskDrawer-DtPhiYxP.js +0 -3
- package/dist/web/assets/_requestId-CGvAfIkB.js +0 -30
- package/dist/web/assets/_requestId-DxfYhgAq.js +0 -1
- package/dist/web/assets/board-wt47lfrE.js +0 -1
- package/dist/web/assets/done-C9Ct7ssb.js +0 -1
- package/dist/web/assets/index-BTFL2rpp.js +0 -12
- package/dist/web/assets/index-DAyBsvua.css +0 -2
- package/dist/web/assets/new-e4ID2vQV.js +0 -1
- package/dist/web/assets/preload-helper-DhIyFaOW.js +0 -1
- package/dist/web/assets/release-notes-CQ0d2r0k.js +0 -3
- package/dist/web/assets/requestData-BDZqyl35.js +0 -1
- package/dist/web/assets/routes-Bipv3lwJ.js +0 -2
- package/dist/web/assets/settings-Dwh8fj6p.js +0 -1
- package/src/cli/args.ts +0 -186
- package/src/cli/chatgpt.ts +0 -74
- package/src/cli/codex.ts +0 -28
- package/src/cli/format.ts +0 -9
- package/src/cli/main.ts +0 -337
- package/src/cli/output.ts +0 -117
- package/src/cli/preflightCommands.ts +0 -245
- package/src/cli/project.ts +0 -675
- package/src/cli/readOnly.ts +0 -36
- package/src/cli/releaseNotesCommands.ts +0 -198
- package/src/cli/render.ts +0 -60
- package/src/cli/requestCommands.ts +0 -172
- package/src/cli/showView.ts +0 -110
- package/src/cli/taskCommands.ts +0 -167
- package/src/cli/userConfig.ts +0 -58
- package/src/core/context.ts +0 -58
- package/src/core/machineSettings.ts +0 -207
- package/src/core/machineSettingsEdit.ts +0 -156
- package/src/core/ops.ts +0 -114
- package/src/core/preflight/carryover.ts +0 -133
- package/src/core/preflight/codexEngine.ts +0 -703
- package/src/core/preflight/codexImage.ts +0 -98
- package/src/core/preflight/diagnose.ts +0 -124
- package/src/core/preflight/engine.ts +0 -92
- package/src/core/preflight/input.ts +0 -65
- package/src/core/preflight/launch.ts +0 -86
- package/src/core/preflight/mockEngine.ts +0 -145
- package/src/core/preflight/render.ts +0 -339
- package/src/core/preflight/service.ts +0 -707
- package/src/core/preflight/uiMaterials.ts +0 -272
- package/src/core/preflight/uiRender.ts +0 -84
- package/src/core/preflight/wireframe.ts +0 -69
- package/src/core/preflight/xlsx.ts +0 -328
- package/src/core/projectRegistry.ts +0 -264
- package/src/core/redact.ts +0 -31
- package/src/core/releaseNotes/completeRequests.ts +0 -102
- package/src/core/releaseNotes/generate.ts +0 -283
- package/src/core/releaseNotes/material.ts +0 -114
- package/src/core/releaseNotes/mockSummarizer.ts +0 -28
- package/src/core/releaseNotes/service.ts +0 -110
- package/src/core/releaseNotes/store.ts +0 -216
- package/src/core/repoAdmin.ts +0 -81
- package/src/core/repoRefs.ts +0 -90
- package/src/core/requestOps.ts +0 -140
- package/src/core/requestStatus.ts +0 -58
- package/src/core/store/attachments.ts +0 -228
- package/src/core/store/collection.ts +0 -282
- package/src/core/store/frontmatter.ts +0 -22
- package/src/core/store/fsutil.ts +0 -90
- package/src/core/store/locate.ts +0 -181
- package/src/core/store/normalize.ts +0 -155
- package/src/core/store/noteStore.ts +0 -56
- package/src/core/store/preflightStore.ts +0 -136
- package/src/core/store/projectFile.ts +0 -101
- package/src/core/store/workspace.ts +0 -328
- package/src/core/supersede.ts +0 -74
- package/src/core/userConfig.ts +0 -205
- package/src/core/workTargets.ts +0 -120
- package/src/server/api/chatgptRoutes.ts +0 -49
- package/src/server/api/manifest.ts +0 -135
- package/src/server/api/projectsRoutes.ts +0 -89
- package/src/server/api/releaseNoteRoutes.ts +0 -89
- package/src/server/api/repoRoutes.ts +0 -67
- package/src/server/api/routes.ts +0 -382
- package/src/server/api/userThemeRoutes.ts +0 -62
- package/src/server/server.ts +0 -108
- package/src/shared/dates.ts +0 -12
- package/src/shared/milestoneOrder.ts +0 -44
- package/src/shared/preflightInput.ts +0 -27
- package/src/shared/refs.ts +0 -55
- package/src/shared/repos.ts +0 -113
- package/src/shared/scopeView.ts +0 -48
- package/src/shared/types.ts +0 -730
- package/src/shared/workTarget.ts +0 -44
- /package/{src → lib}/core/preflight/launcher.mjs +0 -0
- /package/{src → lib}/core/preflight/mock-ui.html +0 -0
- /package/{src → lib}/core/preflight/mock-ui.png +0 -0
- /package/{src → lib}/core/preflight/render-image/Dockerfile +0 -0
- /package/{src → lib}/core/preflight/render-image/fonts-ja.conf +0 -0
- /package/{src → lib}/core/preflight/render-image/render.mjs +0 -0
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { execFile } from "node:child_process";
|
|
2
|
+
import { promisify } from "node:util";
|
|
3
|
+
import { DEFAULT_IMAGE, ensureImage } from "@infodb/codex-workspace";
|
|
4
|
+
const run = promisify(execFile);
|
|
5
|
+
/** いつもの Preflight の前に。中の Codex の版を返す */
|
|
6
|
+
export function ensureCodexImage({ docker = "docker", image = DEFAULT_IMAGE } = {}) {
|
|
7
|
+
return ensureImage({ docker, image });
|
|
8
|
+
}
|
|
9
|
+
/** 更新に失敗した段と、次にすること */
|
|
10
|
+
export class CodexImageError extends Error {
|
|
11
|
+
step;
|
|
12
|
+
detail;
|
|
13
|
+
constructor(step, message, detail) {
|
|
14
|
+
super(message);
|
|
15
|
+
this.step = step;
|
|
16
|
+
this.detail = detail;
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
/** 今すぐ作り直して、入った Codex の版を返す。進み具合は onProgress へ(CLI は stderr に出す) */
|
|
20
|
+
export async function updateCodexImage({ docker = "docker", image = DEFAULT_IMAGE, onProgress = () => { }, } = {}) {
|
|
21
|
+
try {
|
|
22
|
+
await run(docker, ["version", "--format", "{{.Server.Version}}"], { timeout: 15_000 });
|
|
23
|
+
}
|
|
24
|
+
catch (e) {
|
|
25
|
+
const err = e;
|
|
26
|
+
if (err.code === "ENOENT") {
|
|
27
|
+
throw new CodexImageError("docker", "docker コマンドが見つかりません。Docker をインストールし、PATH から docker を実行できるようにしてください");
|
|
28
|
+
}
|
|
29
|
+
throw new CodexImageError("daemon", "Docker デーモンに接続できません。Docker を起動し、この利用者が使える(docker version が通る)ことを確かめてください", firstLine(err.stderr));
|
|
30
|
+
}
|
|
31
|
+
const exists = await run(docker, ["image", "inspect", "--format", "{{.Id}}", image]).then(() => true, () => false);
|
|
32
|
+
const previous = exists ? await codexVersion(docker, image).catch(() => null) : null;
|
|
33
|
+
onProgress(`Codex のイメージ ${image} を作り直しています(最新の Codex を入れます。数分かかることがあります)`);
|
|
34
|
+
let version;
|
|
35
|
+
try {
|
|
36
|
+
// 作った日時によらず作り直す(maxAgeMs を -∞ にすると、どんな作成日時でも「古い」になる)。返すのは作り直した中の版
|
|
37
|
+
version = await ensureImage({ docker, image, maxAgeMs: Number.NEGATIVE_INFINITY });
|
|
38
|
+
}
|
|
39
|
+
catch (e) {
|
|
40
|
+
const err = e;
|
|
41
|
+
if (err.cmd?.includes(" build ")) {
|
|
42
|
+
throw new CodexImageError("build", "イメージを作れませんでした。ネットワーク(Codex の取得)と Docker のディスクの空きを確かめて、もう一度実行してください", lastLine(err.stderr));
|
|
43
|
+
}
|
|
44
|
+
throw new CodexImageError("version", "イメージは作りましたが、中の Codex の版を読めませんでした。もう一度実行してください", lastLine(err.stderr ?? err.message));
|
|
45
|
+
}
|
|
46
|
+
if (!version)
|
|
47
|
+
throw new CodexImageError("version", "イメージは作りましたが、中の Codex の版を読めませんでした。もう一度実行してください");
|
|
48
|
+
const createdAt = await run(docker, ["image", "inspect", "--format", "{{.Created}}", image])
|
|
49
|
+
.then((r) => r.stdout.trim() || null)
|
|
50
|
+
.catch(() => null);
|
|
51
|
+
return { image, version, previous, createdAt };
|
|
52
|
+
}
|
|
53
|
+
async function codexVersion(docker, image) {
|
|
54
|
+
const { stdout } = await run(docker, ["run", "--rm", "--entrypoint", "codex", image, "--version"], { timeout: 60_000 });
|
|
55
|
+
const v = stdout.trim();
|
|
56
|
+
if (!v)
|
|
57
|
+
throw new Error("codex --version が空");
|
|
58
|
+
return v;
|
|
59
|
+
}
|
|
60
|
+
const firstLine = (s) => s?.trim().split("\n")[0] || undefined;
|
|
61
|
+
const lastLine = (s) => s?.trim().split("\n").at(-1) || undefined;
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
/** 前から順に、境界(/)が合う最初の対応を使う */
|
|
2
|
+
export function mapPath(pathMap, local) {
|
|
3
|
+
for (const rule of pathMap) {
|
|
4
|
+
const [from, to] = rule;
|
|
5
|
+
if (local === from || local.startsWith(`${from}/`))
|
|
6
|
+
return { host: to + local.slice(from.length), rule };
|
|
7
|
+
}
|
|
8
|
+
return { host: local };
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* パスの対応の説明。共有の記録(run.json)に残るので、このマシンのパスと Docker のホストのパスは出さず、
|
|
12
|
+
* 参照先の名前・コンテナの中のパス・codex.pathMap の対応が当たったかだけを書く
|
|
13
|
+
*/
|
|
14
|
+
export function describeMapping(m, rules) {
|
|
15
|
+
const how = m.rule
|
|
16
|
+
? m.rule[0] === m.rule[1]
|
|
17
|
+
? "codex.pathMap の対応あり(パスは変わらない)"
|
|
18
|
+
: "codex.pathMap の対応あり"
|
|
19
|
+
: rules
|
|
20
|
+
? `codex.pathMap の対応なし(${rules} 件のどれにも当たらない。このマシンのパスのまま渡す)`
|
|
21
|
+
: "codex.pathMap の対応なし(このマシンのパスのまま渡す)";
|
|
22
|
+
return `${m.label} → コンテナ ${m.container}(${how})`;
|
|
23
|
+
}
|
|
24
|
+
/** Docker の出力に出るこのマシン・ホストのパスを、参照先の名前に置き換える(長いパスから) */
|
|
25
|
+
export function hidePaths(text, mappings) {
|
|
26
|
+
const pairs = mappings.flatMap((m) => [
|
|
27
|
+
[m.host, `<${m.label}>`],
|
|
28
|
+
[m.local, `<${m.label}>`],
|
|
29
|
+
]);
|
|
30
|
+
return pairs
|
|
31
|
+
.filter(([p]) => p && p !== "/")
|
|
32
|
+
.sort((a, b) => b[0].length - a[0].length)
|
|
33
|
+
.reduce((t, [p, name]) => t.split(p).join(name), text);
|
|
34
|
+
}
|
|
35
|
+
/** 要約に出す行: エラーらしい最後の行(docker の「Run 'docker run --help'…」のような案内の行は避ける)。無ければ最後の行 */
|
|
36
|
+
const lastLine = (s) => {
|
|
37
|
+
const lines = s
|
|
38
|
+
.split("\n")
|
|
39
|
+
.map((l) => l.trim())
|
|
40
|
+
.filter(Boolean);
|
|
41
|
+
return lines.findLast((l) => /error|denied|cannot|unable|not found|no such|does not exist|failed|killed/i.test(l)) ?? lines.at(-1);
|
|
42
|
+
};
|
|
43
|
+
/**
|
|
44
|
+
* パスの対応の直し方(書き方と設定するコマンド)。共有の記録に残るので、このマシンのパスは例のパスで示す。
|
|
45
|
+
* 対応が当たっていたのに無いなら行き先の誤り、当たっていなければ対応が足りない
|
|
46
|
+
*/
|
|
47
|
+
export function pathMapHowTo(which) {
|
|
48
|
+
return [
|
|
49
|
+
which?.rule
|
|
50
|
+
? "直し方: 対応の行き先(Docker のホストから見たパス)が違います。同じ「このマシンのパス」で足し直すと置き換わります"
|
|
51
|
+
: "直し方: このパスを含む「このマシンのパス」と「Docker のホストから見たパス」の対応を足します",
|
|
52
|
+
" p3 user-config set codex.pathMap+=<このマシンのパス>=<Docker のホストから見たパス>",
|
|
53
|
+
" 例: p3 user-config set codex.pathMap+=/workspaces=/home/me/workspaces",
|
|
54
|
+
" Docker のホストから見たパスは、ホストで docker inspect <この開発コンテナ> の Mounts(Source が Docker のホスト、Destination がこのマシン)で分かります。",
|
|
55
|
+
" 今の対応は p3 user-config で確かめられます。直せば serve はそのままで次の Preflight から効きます",
|
|
56
|
+
];
|
|
57
|
+
}
|
|
58
|
+
export function diagnoseLaunch(r, ctx) {
|
|
59
|
+
const { exit } = r;
|
|
60
|
+
// 共有の記録に残るので、パスは参照先の名前にしてから使う
|
|
61
|
+
const stderr = hidePaths(r.stderr, ctx.mappings);
|
|
62
|
+
const last = lastLine(stderr);
|
|
63
|
+
const when = ctx.phase === "start" ? "初期化の前に" : "途中で";
|
|
64
|
+
let head;
|
|
65
|
+
if (exit?.spawnError)
|
|
66
|
+
head = `app-server(docker run)を起動できません(${exit.spawnError})`;
|
|
67
|
+
else if (r.stopped)
|
|
68
|
+
head = "app-server(docker run)が応答しないので止めました";
|
|
69
|
+
else if (exit?.signal)
|
|
70
|
+
head = `app-server(docker run)が${when}シグナル ${exit.signal} で終わりました`;
|
|
71
|
+
else if (exit)
|
|
72
|
+
head = `app-server(docker run)が${when}終わりました(終了コード ${exit.code})`;
|
|
73
|
+
else
|
|
74
|
+
head = "app-server(docker run)から応答がありません(終わったかどうかは確かめられませんでした)";
|
|
75
|
+
if (last)
|
|
76
|
+
head += `: ${last}`;
|
|
77
|
+
const hints = [];
|
|
78
|
+
const bind = /bind source path does not exist: (\S+)/.exec(r.stderr);
|
|
79
|
+
if (exit?.spawnError === "ENOENT")
|
|
80
|
+
hints.push("docker コマンドが見つかりません。Docker を入れて、PATH を確かめてください");
|
|
81
|
+
if (bind) {
|
|
82
|
+
const which = ctx.mappings.find((m) => m.host === bind[1]);
|
|
83
|
+
hints.push(`${which ? `${which.label} のパス` : "マウントするパス"}が Docker のホストにありません。個人設定(config.yaml)の codex.pathMap を確かめてください`, "今のパスの対応:", ...ctx.mappings.map((m) => ` ${describeMapping(m, ctx.rules)}`), ...pathMapHowTo(which));
|
|
84
|
+
}
|
|
85
|
+
else if (/Cannot connect to the Docker daemon|Is the docker daemon running|error during connect|permission denied while trying to connect to the Docker daemon/i.test(stderr)) {
|
|
86
|
+
hints.push("Docker のデーモンに繋がりません。Docker を起動し、接続先(DOCKER_HOST・docker context)と権限を確かめてください");
|
|
87
|
+
}
|
|
88
|
+
else if (/Unable to find image|pull access denied|No such image|repository does not exist/i.test(stderr)) {
|
|
89
|
+
hints.push(`イメージ ${ctx.image} がありません。p3 codex update で作ってください`);
|
|
90
|
+
}
|
|
91
|
+
else if (!exit?.spawnError) {
|
|
92
|
+
hints.push(stderr.trim() ? "上の Docker の出力を確かめてください" : "Docker の出力はありませんでした");
|
|
93
|
+
}
|
|
94
|
+
return { message: [head, ...hints].join("\n"), stderr: stderr.trim() };
|
|
95
|
+
}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
export const ASSESSMENT_SPEC = `{
|
|
2
|
+
"summary": "要望の要約と結論(日本語, 2-4文)",
|
|
3
|
+
"verdict": "go" | "clarify" | "no_go",
|
|
4
|
+
"validity": { "score": 0-100, "reasons": ["要望として妥当か: 目的・価値・既存方針との整合"] },
|
|
5
|
+
"feasibility": { "score": 0-100, "reasons": ["実現可能か: 既存コード・技術的制約・規模"] },
|
|
6
|
+
"risks": ["..."],
|
|
7
|
+
"questions": ["要望者に確認すべき事項"],
|
|
8
|
+
"areas": ["影響するコード領域やコンポーネント(リポジトリ相対パス推奨)"],
|
|
9
|
+
"split": { "decision": "split" | "keep", "estimatedTasks": 想定するタスクの数(概算), "reasons": ["分割する・しない理由"] },
|
|
10
|
+
"evidence": [
|
|
11
|
+
{ "claim": "支える判断(例: 実現可能性: 既存の X で足りる / D2 の範囲)", "kind": "verified" | "assumed",
|
|
12
|
+
"repo": "参照先の名前(verified のとき)", "file": "参照先の中の相対パス", "location": "行・関数名など",
|
|
13
|
+
"commit": "経緯を確かめたコミット(git の履歴を根拠にしたとき)" }
|
|
14
|
+
]
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
evidence には、判断に使ったファイル・箇所を書いてください。実際に読んで確かめたものは verified(repo・file を必ず書く)、
|
|
18
|
+
読まずに推測した判断も消さずに assumed として書いてください(推測で書いた部分が分かるように)。`;
|
|
19
|
+
/** 分割の基準(SPLIT_HINT_TASKS と同じ数を書く) */
|
|
20
|
+
export const SPLIT_GUIDE = (hint) => `分割するか・しないか(split):
|
|
21
|
+
- 想定するタスクの数が ${hint} 以上なら、分割するか・しないかとその理由を必ず split に書く(数は概算でよい。数を出すためだけに大きなタスク案を書かない)。
|
|
22
|
+
- ${hint} 未満でも、独立したインフラ(基盤・Lambda・IaC など)、権限や運用の担当が違う、リリースの境界が違う、別のリポジトリで別にレビューしたい作業があれば分割の候補(split に理由を書く)。
|
|
23
|
+
- ${hint} 以上でも、同じ契約(API の型とその呼び出し側、保存の形とその読み書き)を一緒に直さないと途中が壊れる、1つの PR でしかレビューできないなら分けない(keep と理由)。
|
|
24
|
+
- 小さいプロジェクトのフロントエンドとバックエンドは機械的に分けない。
|
|
25
|
+
- 分割する(split)なら、タスク案(drafts/)は書かずに子の要望の案(children/)だけを書く。分けないならタスク案だけを書く(両方は書かない)。
|
|
26
|
+
子は人が採用した後、子ごとに別の Preflight でタスクにする(ここでは子のタスク案は書かない)。`;
|
|
27
|
+
export const CHILD_SPEC = `---
|
|
28
|
+
key: C1 # C1, C2 ... の連番
|
|
29
|
+
title: 子の要望の題
|
|
30
|
+
estimatedTasks: 3 # 想定するタスクの数(概算)
|
|
31
|
+
requires: [C2] # 前提にする他の子の案の key(無ければ省略。タスクの依存ではなく、前提の契約として本文に書く)
|
|
32
|
+
overlaps: [T002] # 親の既存のタスクと重なりうるもの(無ければ省略)
|
|
33
|
+
include: true
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 目的
|
|
37
|
+
## 範囲
|
|
38
|
+
## 範囲外
|
|
39
|
+
## 完了条件
|
|
40
|
+
## 分割の理由
|
|
41
|
+
## 他の子との前提と契約
|
|
42
|
+
## 出典
|
|
43
|
+
(見出しはこの順。目的と完了条件は必ず書く。出典には根拠にした <参照先>:<ファイル> を書く)`;
|
|
44
|
+
export const DRAFT_SPEC = `---
|
|
45
|
+
key: D2 # D1, D2 ... の連番
|
|
46
|
+
title: タスク名
|
|
47
|
+
repo: <作業先> # 作業するリポジトリ・フォルダ(「作業先にできる」参照先の名前)。調査・人の判断など作業先が無いタスクは none
|
|
48
|
+
areas: [src/foo] # 触る領域
|
|
49
|
+
dependsOn: [D1] # 同じ preflight 内で先に終わっている必要があるタスク案の key
|
|
50
|
+
supersedes: [T003] # この案が置き換える、同じ要望の既存タスク(再評価で古いタスクを置き換えるときだけ。無ければ省略)
|
|
51
|
+
include: true
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
作業内容・完了条件を Markdown で。最後に次の2つの見出しを付けてください:
|
|
55
|
+
## 判断の根拠
|
|
56
|
+
- この作業範囲にした根拠(<参照先>:<ファイル> の箇所。確かめていなければ「推測」と書く)
|
|
57
|
+
## 未確認
|
|
58
|
+
- 確かめられなかったこと(無ければ「なし」)`;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { readFile } from "node:fs/promises";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { changedLabel, normalizeInput } from "../../shared/preflightInput.js";
|
|
5
|
+
export { normalizeInput };
|
|
6
|
+
/**
|
|
7
|
+
* Preflight の評価対象(要望のタイトルと本文)の固定と比較。正規化の規則は shared/preflightInput.ts。
|
|
8
|
+
*
|
|
9
|
+
* 比べるのは保存されたタイトルと本文そのもの(rev や lastPreflight では比べない。Preflight 自身の状態の更新や、
|
|
10
|
+
* タグ・期限・ステータスだけの変更では古い評価にしない)。本文を元に戻せば一致に戻る。
|
|
11
|
+
*/
|
|
12
|
+
/** run の request.md(人が読む評価対象)。input と同じ内容にする */
|
|
13
|
+
export function renderRequestSnapshot(requestId, input) {
|
|
14
|
+
return `# ${requestId} ${input.title}\n\n${input.body}`;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* run の評価対象。run.json の input が無い以前の run は request.md(`# <要望ID> <タイトル>\n\n<本文>`)から読む。
|
|
18
|
+
* 読めない・形が違うときは理由を返す(一致とはみなさない)
|
|
19
|
+
*/
|
|
20
|
+
export async function runInput(run, runDir) {
|
|
21
|
+
if (run.input) {
|
|
22
|
+
const { title, body } = run.input;
|
|
23
|
+
return typeof title === "string" && typeof body === "string" ? normalizeInput({ title, body }) : { error: "run.json の評価対象(input)が壊れています" };
|
|
24
|
+
}
|
|
25
|
+
let text;
|
|
26
|
+
try {
|
|
27
|
+
text = await readFile(join(runDir, "request.md"), "utf8");
|
|
28
|
+
}
|
|
29
|
+
catch {
|
|
30
|
+
return { error: "この run には評価対象の記録(request.md)がありません" };
|
|
31
|
+
}
|
|
32
|
+
const m = /^# (\S+) ([^\r\n]*)(?:\r?\n\r?\n([\s\S]*))?$/.exec(text);
|
|
33
|
+
if (!m || m[1] !== run.requestId)
|
|
34
|
+
return { error: "この run の request.md の形が読めません" };
|
|
35
|
+
return normalizeInput({ title: m[2], body: m[3] ?? "" });
|
|
36
|
+
}
|
|
37
|
+
/** 要望の題と本文の識別子(親の目的・子の要望を run に固定して比べる。正規化してから作る) */
|
|
38
|
+
export function inputHash(r) {
|
|
39
|
+
const n = normalizeInput(r);
|
|
40
|
+
return createHash("sha256").update(`${n.title}\n${n.body}`).digest("hex").slice(0, 16);
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* 親子の評価対象を比べる(run に記録が無ければ比べない)。変わった項目を返す。
|
|
44
|
+
* parent: 今の親が記録と違う・無い・題か本文が変わった / children: 今の子(この run の採用で作った子は除く)の集合か題・本文が違う
|
|
45
|
+
*/
|
|
46
|
+
export function compareFamily(saved, runId, request, parent, children) {
|
|
47
|
+
const out = [];
|
|
48
|
+
if (saved?.parent && (request.parent !== saved.parent.id || !parent || inputHash(parent) !== saved.parent.hash))
|
|
49
|
+
out.push("parent");
|
|
50
|
+
if (saved?.children) {
|
|
51
|
+
const now = children.filter((c) => !c.splitFrom?.startsWith(`${runId}/`)).map((c) => `${c.id}:${inputHash(c)}`).sort();
|
|
52
|
+
const then = saved.children.map((c) => `${c.id}:${c.hash}`).sort();
|
|
53
|
+
if (now.join(",") !== then.join(","))
|
|
54
|
+
out.push("children");
|
|
55
|
+
}
|
|
56
|
+
return out;
|
|
57
|
+
}
|
|
58
|
+
export function compareInput(saved, current) {
|
|
59
|
+
if ("error" in saved)
|
|
60
|
+
return { status: "unknown", reason: saved.error };
|
|
61
|
+
const now = normalizeInput(current);
|
|
62
|
+
const changed = ["title", "body"].filter((k) => saved[k] !== now[k]);
|
|
63
|
+
return changed.length ? { status: "changed", changed: [...changed] } : { status: "same" };
|
|
64
|
+
}
|
|
65
|
+
/** 評価対象が今の要望と違う(か分からない)run からタスク化しようとした */
|
|
66
|
+
export class StaleInputError extends Error {
|
|
67
|
+
requestId;
|
|
68
|
+
runId;
|
|
69
|
+
match;
|
|
70
|
+
code = "stale_input";
|
|
71
|
+
constructor(requestId, runId, match) {
|
|
72
|
+
super(staleMessage(requestId, runId, match));
|
|
73
|
+
this.requestId = requestId;
|
|
74
|
+
this.runId = runId;
|
|
75
|
+
this.match = match;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
export function staleMessage(requestId, runId, m) {
|
|
79
|
+
const why = m.status === "changed"
|
|
80
|
+
? `${runId} の評価のあとで要望の${changedLabel(m.changed)}が変わりました`
|
|
81
|
+
: `${runId} が何を評価したか確かめられません(${m.reason ?? "不明"})`;
|
|
82
|
+
return `${why}。古い評価からはタスク化しません。今の内容でもう一度 Preflight を実行してください(p3 preflight ${requestId})。この評価のままタスク化するなら、要望を評価した時点の内容に戻してください`;
|
|
83
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { mkdtemp, readFile, rm } from "node:fs/promises";
|
|
2
|
+
import { tmpdir } from "node:os";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { fileURLToPath } from "node:url";
|
|
5
|
+
/** 中継(launcher.mjs)。app-server の stderr と終わり方を残す */
|
|
6
|
+
const LAUNCHER = fileURLToPath(new URL("./launcher.mjs", import.meta.url));
|
|
7
|
+
/**
|
|
8
|
+
* app-server を中継ごしに起こす準備。run ごとに一時フォルダを作り、そこに診断を書かせる。
|
|
9
|
+
* 呼ぶ側は command で起こし、失敗したら result() で診断を読み、最後に cleanup() する(中継が残っていれば止める)。
|
|
10
|
+
*/
|
|
11
|
+
export async function prepareLaunch(command) {
|
|
12
|
+
const dir = await mkdtemp(join(tmpdir(), "p3-launch-"));
|
|
13
|
+
const read = (name) => readFile(join(dir, name), "utf8").catch(() => undefined);
|
|
14
|
+
const pid = async () => Number(await read("pid")) || undefined;
|
|
15
|
+
const exited = async () => {
|
|
16
|
+
const text = await read("exit.json");
|
|
17
|
+
return text ? JSON.parse(text) : undefined;
|
|
18
|
+
};
|
|
19
|
+
const wait = async (ms) => {
|
|
20
|
+
const until = Date.now() + ms;
|
|
21
|
+
for (;;) {
|
|
22
|
+
const e = await exited();
|
|
23
|
+
if (e || Date.now() >= until)
|
|
24
|
+
return e;
|
|
25
|
+
await new Promise((r) => setTimeout(r, 50));
|
|
26
|
+
}
|
|
27
|
+
};
|
|
28
|
+
const alive = (p) => {
|
|
29
|
+
try {
|
|
30
|
+
process.kill(p, 0);
|
|
31
|
+
return true;
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return false;
|
|
35
|
+
}
|
|
36
|
+
};
|
|
37
|
+
/** 中継を止める(子にも伝わる)。少し待っても残っていれば強制で */
|
|
38
|
+
const stop = async () => {
|
|
39
|
+
const p = await pid();
|
|
40
|
+
if (!p || !alive(p))
|
|
41
|
+
return;
|
|
42
|
+
process.kill(p, "SIGTERM");
|
|
43
|
+
if (!(await wait(3000)) && alive(p))
|
|
44
|
+
process.kill(p, "SIGKILL");
|
|
45
|
+
};
|
|
46
|
+
return {
|
|
47
|
+
command: [process.execPath, LAUNCHER, dir, "--", ...command],
|
|
48
|
+
/**
|
|
49
|
+
* 終わり方と stderr を読む。終わったばかりなら waitMs まで出し切りを待つ。
|
|
50
|
+
* stopIfRunning: まだ動いていれば止めてから読む(初期化に失敗したとき)
|
|
51
|
+
*/
|
|
52
|
+
async result({ waitMs = 3000, stopIfRunning = false } = {}) {
|
|
53
|
+
let exit = await wait(waitMs);
|
|
54
|
+
let stopped = false;
|
|
55
|
+
if (!exit && stopIfRunning) {
|
|
56
|
+
await stop();
|
|
57
|
+
stopped = true;
|
|
58
|
+
exit = await exited();
|
|
59
|
+
}
|
|
60
|
+
return { exit, stderr: (await read("stderr")) ?? "", stopped };
|
|
61
|
+
},
|
|
62
|
+
/** 中継が残っていれば止め、一時フォルダを消す */
|
|
63
|
+
async cleanup() {
|
|
64
|
+
await stop().catch(() => undefined);
|
|
65
|
+
await rm(dir, { recursive: true, force: true });
|
|
66
|
+
},
|
|
67
|
+
};
|
|
68
|
+
}
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
import { writableRepos } from "../../shared/workTarget.js";
|
|
2
|
+
import { mkdir, readFile, writeFile } from "node:fs/promises";
|
|
3
|
+
import { join, relative } from "node:path";
|
|
4
|
+
import { SPLIT_HINT_TASKS } from "../../shared/hierarchy.js";
|
|
5
|
+
import { stringifyFrontmatter } from "../store/frontmatter.js";
|
|
6
|
+
import { writeFileAtomic } from "../store/fsutil.js";
|
|
7
|
+
const wait = (ms, signal) => new Promise((res, rej) => {
|
|
8
|
+
const t = setTimeout(res, ms);
|
|
9
|
+
signal.addEventListener("abort", () => (clearTimeout(t), rej(new Error("aborted"))), { once: true });
|
|
10
|
+
});
|
|
11
|
+
/**
|
|
12
|
+
* Codex を使わずに preflight のファイル契約を再現するエンジン(オフライン開発・UI 確認用)。
|
|
13
|
+
* 要望本文の箇条書きをタスク案にし、関連項目から影響を推定するだけの単純なヒューリスティック。
|
|
14
|
+
* 再評価では、メモの箇条書きをタスク案に足し、前回不採用にした案(同じ題)は不採用のままにする。
|
|
15
|
+
* メモがあれば確認事項は答えられたものとして扱う(意味は解釈しない)。
|
|
16
|
+
* 箇条書きが分割の目安(SPLIT_HINT_TASKS)以上なら、タスク案の代わりに子の要望の案(3件ずつ)を書く。
|
|
17
|
+
*/
|
|
18
|
+
export class MockEngine {
|
|
19
|
+
name = "mock";
|
|
20
|
+
/** 待ち時間の倍率(画面で進み具合が見えるように少し待つ。テストでは 0) */
|
|
21
|
+
delay;
|
|
22
|
+
constructor(opts = {}) {
|
|
23
|
+
this.delay = opts.delay ?? 1;
|
|
24
|
+
}
|
|
25
|
+
async status() {
|
|
26
|
+
return {
|
|
27
|
+
name: "mock",
|
|
28
|
+
ok: true,
|
|
29
|
+
detail: "Mock(要望本文の箇条書きをそのままタスク案にする簡易評価)で実行します。P3_PREFLIGHT_ENGINE=mock か個人設定の preflight.engine: mock で選ばれています",
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
sleep(ms, signal) {
|
|
33
|
+
return wait(ms * this.delay, signal);
|
|
34
|
+
}
|
|
35
|
+
async run(job, log, signal) {
|
|
36
|
+
const { request } = job;
|
|
37
|
+
log({ kind: "info", text: "mock engine: Codex を使わずにヒューリスティックで評価します" });
|
|
38
|
+
await this.sleep(400, signal);
|
|
39
|
+
for (const r of job.refs)
|
|
40
|
+
for (const m of r.map)
|
|
41
|
+
log({ kind: "command", text: `$ ls ${r.name}:${m.path}` });
|
|
42
|
+
log({ kind: "command", text: `$ rg -l "${request.title.slice(0, 20)}" .` });
|
|
43
|
+
await this.sleep(400, signal);
|
|
44
|
+
const notes = job.carryover?.notes ?? [];
|
|
45
|
+
const previous = job.carryover?.previous;
|
|
46
|
+
if (previous)
|
|
47
|
+
log({ kind: "command", text: `$ cat ${relative(job.dataDir, join(job.runDir, "carryover.md"))}` });
|
|
48
|
+
const bullets = [...new Set([request.body, ...notes.map((n) => n.body)].flatMap(bulletsOf))].slice(0, 8);
|
|
49
|
+
const rejected = new Set(previous?.drafts.filter((d) => !d.include).map((d) => d.title));
|
|
50
|
+
const items = bullets.length ? bullets : [`${request.title} の設計`, `${request.title} の実装`, `${request.title} のテスト`];
|
|
51
|
+
const areas = request.areas.length ? request.areas : ["src"];
|
|
52
|
+
const drafts = items.map((title, i) => ({
|
|
53
|
+
key: `D${i + 1}`,
|
|
54
|
+
title,
|
|
55
|
+
description: `要望 ${request.id} より。\n\n## 完了条件\n- ${title} が動作すること\n- 既存機能に回帰がないこと`,
|
|
56
|
+
areas,
|
|
57
|
+
dependsOn: i === 0 ? [] : [`D${i}`],
|
|
58
|
+
supersedes: [],
|
|
59
|
+
include: !rejected.has(title),
|
|
60
|
+
// 作業先は作業先にできる参照先の先頭(Mock は読まないので推定しない。無ければ作業先なし)
|
|
61
|
+
repo: writableRepos(job.project)[0] ?? null,
|
|
62
|
+
}));
|
|
63
|
+
// 箇条書きが分割の目安(SPLIT_HINT_TASKS)以上なら、タスク案ではなく子の要望の案にする(3件ずつ)
|
|
64
|
+
const split = items.length >= SPLIT_HINT_TASKS;
|
|
65
|
+
const children = split
|
|
66
|
+
? Array.from({ length: Math.ceil(items.length / 3) }, (_, i) => {
|
|
67
|
+
const part = items.slice(i * 3, i * 3 + 3);
|
|
68
|
+
return {
|
|
69
|
+
key: `C${i + 1}`,
|
|
70
|
+
title: `${request.title}(${i + 1}): ${part[0]}`,
|
|
71
|
+
description: [
|
|
72
|
+
`## 目的\n${part.join("・")} を、親の要望の一部として仕上げる`,
|
|
73
|
+
`## 範囲\n${part.map((x) => `- ${x}`).join("\n")}`,
|
|
74
|
+
"## 範囲外\n- ほかの子の要望の項目",
|
|
75
|
+
`## 完了条件\n${part.map((x) => `- ${x} が動作すること`).join("\n")}`,
|
|
76
|
+
"## 分割の理由\nmock: 箇条書きを3件ずつに分けた(境界は推定していない)",
|
|
77
|
+
`## 他の子との前提と契約\n${i ? `- C${i} の後に進める` : "- なし"}`,
|
|
78
|
+
`## 出典\n- 要望 ${request.id} の本文`,
|
|
79
|
+
].join("\n\n"),
|
|
80
|
+
estimatedTasks: part.length,
|
|
81
|
+
requires: i ? [`C${i}`] : [],
|
|
82
|
+
overlaps: [],
|
|
83
|
+
include: true,
|
|
84
|
+
};
|
|
85
|
+
})
|
|
86
|
+
: [];
|
|
87
|
+
const clarity = Math.min(100, 40 + (request.body.length + notes.reduce((n, x) => n + x.body.length, 0)) / 8);
|
|
88
|
+
const carried = [previous && `前回 ${previous.id} を引き継ぎ`, notes.length && `メモ ${notes.length} 件を反映`].filter(Boolean).join("、");
|
|
89
|
+
const assessment = {
|
|
90
|
+
summary: split
|
|
91
|
+
? `「${request.title}」は想定 ${items.length} 件のタスクになるので、${children.length} 件の子の要望に分けます。${carried ? `${carried}しました。` : ""}(mock による推定)`
|
|
92
|
+
: `「${request.title}」を ${drafts.length} 件のタスクに分割しました。${carried ? `${carried}しました。` : ""}(mock による推定)`,
|
|
93
|
+
verdict: clarity < 55 && !notes.length ? "clarify" : "go",
|
|
94
|
+
validity: { score: Math.round(clarity), reasons: ["mock: 本文の具体性から推定"] },
|
|
95
|
+
feasibility: { score: 80, reasons: ["mock: 固定の値"] },
|
|
96
|
+
risks: [],
|
|
97
|
+
questions: clarity < 55 && !notes.length ? ["完了条件をより具体的にしてください"] : [],
|
|
98
|
+
areas,
|
|
99
|
+
// Mock は参照先を読まないので、根拠はすべて推測
|
|
100
|
+
evidence: [{ claim: "mock: 要望の本文の箇条書きからタスク案を作った(コードは読んでいない)", kind: "assumed" }],
|
|
101
|
+
split: {
|
|
102
|
+
decision: split ? "split" : "keep",
|
|
103
|
+
estimatedTasks: items.length,
|
|
104
|
+
reasons: [split ? `mock: 箇条書きが ${SPLIT_HINT_TASKS} 件以上` : `mock: 箇条書きが ${SPLIT_HINT_TASKS} 件未満`],
|
|
105
|
+
},
|
|
106
|
+
};
|
|
107
|
+
await writeFileAtomic(join(job.runDir, "assessment.json"), JSON.stringify(assessment, null, 2) + "\n");
|
|
108
|
+
if (split) {
|
|
109
|
+
for (const c of children) {
|
|
110
|
+
const { description, ...meta } = c;
|
|
111
|
+
await writeFileAtomic(join(job.runDir, "children", `${c.key}.md`), stringifyFrontmatter(meta, description));
|
|
112
|
+
log({ kind: "info", text: `✎ ${relative(job.dataDir, join(job.runDir, "children", `${c.key}.md`))}` });
|
|
113
|
+
}
|
|
114
|
+
await writeFileAtomic(join(job.runDir, "ui", "index.json"), JSON.stringify({ needed: false, reason: "mock: 子の要望に分けたので、画面イメージは子の Preflight で作ります" }, null, 2) + "\n");
|
|
115
|
+
log({ kind: "message", text: assessment.summary });
|
|
116
|
+
return { changed: [join(job.runDir, "assessment.json"), ...children.map((c) => join(job.runDir, "children", `${c.key}.md`)), join(job.runDir, "ui", "index.json")] };
|
|
117
|
+
}
|
|
118
|
+
for (const d of drafts) {
|
|
119
|
+
const { description, ...meta } = d;
|
|
120
|
+
await writeFileAtomic(join(job.runDir, "drafts", `${d.key}.md`), stringifyFrontmatter(meta, description));
|
|
121
|
+
log({ kind: "info", text: `✎ ${relative(job.dataDir, join(job.runDir, "drafts", `${d.key}.md`))}` });
|
|
122
|
+
await this.sleep(150, signal);
|
|
123
|
+
}
|
|
124
|
+
const ui = await writeMockUi(job, drafts);
|
|
125
|
+
log({ kind: "info", text: ui.length ? `✎ 画面イメージ ${ui.filter((f) => f.endsWith(".png")).length} 件(ui/)` : "画面イメージは不要としました(ui/index.json)" });
|
|
126
|
+
log({ kind: "message", text: assessment.summary });
|
|
127
|
+
return {
|
|
128
|
+
changed: [join(job.runDir, "assessment.json"), ...drafts.map((d) => join(job.runDir, "drafts", `${d.key}.md`)), join(job.runDir, "ui", "index.json"), ...ui],
|
|
129
|
+
};
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
/** 画面を伴う要望とみなす語 */
|
|
133
|
+
const UI_WORDS = /画面|UI|ボタン|一覧|表示|フォーム|入力欄|ダイアログ|メニュー/;
|
|
134
|
+
/**
|
|
135
|
+
* 画面資料(決まった日本語の例)。画面を伴う要望なら、原稿(HTML)と箱だけの PNG を書く(Mock は描画のコンテナを使わない)。
|
|
136
|
+
* そうでなければ不要の理由を書く。書いた画像と原稿のパスを返す
|
|
137
|
+
*/
|
|
138
|
+
async function writeMockUi(job, drafts) {
|
|
139
|
+
const ui = join(job.runDir, "ui");
|
|
140
|
+
const r = job.request;
|
|
141
|
+
if (!drafts.length || !UI_WORDS.test(`${r.title}\n${r.body}`)) {
|
|
142
|
+
await writeFileAtomic(join(ui, "index.json"), JSON.stringify({ needed: false, reason: "mock: 要望に画面に関わる語が無いので、画面を伴わない変更とみなしました" }, null, 2) + "\n");
|
|
143
|
+
return [];
|
|
144
|
+
}
|
|
145
|
+
const target = drafts[0].key;
|
|
146
|
+
// 決まった原稿と、それを描画のコンテナで描いておいた画像(Mock は Docker を使わない。原稿と画像は同じもの)
|
|
147
|
+
await mkdir(join(ui, "src"), { recursive: true });
|
|
148
|
+
await writeFile(join(ui, "src", "U1.html"), await readFile(MOCK_HTML));
|
|
149
|
+
await writeFile(join(ui, "U1.png"), await readFile(MOCK_PNG));
|
|
150
|
+
const index = {
|
|
151
|
+
needed: true,
|
|
152
|
+
targets: [target],
|
|
153
|
+
items: [
|
|
154
|
+
{
|
|
155
|
+
id: "U1",
|
|
156
|
+
file: "U1.png",
|
|
157
|
+
html: "src/U1.html",
|
|
158
|
+
title: `${r.title}: 一覧と絞り込み(mock の例)`,
|
|
159
|
+
drafts: [target],
|
|
160
|
+
viewport: 960,
|
|
161
|
+
assumptions: ["mock: 要望の内容は読まずに決まった一覧画面の形で描いた", "表の行は仮のデータ"],
|
|
162
|
+
},
|
|
163
|
+
],
|
|
164
|
+
};
|
|
165
|
+
await writeFileAtomic(join(ui, "index.json"), JSON.stringify(index, null, 2) + "\n");
|
|
166
|
+
return [join(ui, "U1.png"), join(ui, "src", "U1.html"), join(ui, "index.json")];
|
|
167
|
+
}
|
|
168
|
+
const MOCK_HTML = new URL("./mock-ui.html", import.meta.url);
|
|
169
|
+
const MOCK_PNG = new URL("./mock-ui.png", import.meta.url);
|
|
170
|
+
function bulletsOf(text) {
|
|
171
|
+
return text
|
|
172
|
+
.split("\n")
|
|
173
|
+
.map((l) => /^\s*(?:[-*]|\d+\.)\s+(.+)/.exec(l)?.[1]?.trim())
|
|
174
|
+
.filter((s) => !!s);
|
|
175
|
+
}
|