@infodb/p3 0.9.0 → 0.10.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 (50) hide show
  1. package/README.md +3 -2
  2. package/dist/web/assets/{Outputs-CQi0oba1.js → Outputs-B4Tr7JzU.js} +1 -1
  3. package/dist/web/assets/{RequestStatus-grC0F_SQ.js → RequestStatus-DGaoQoIa.js} +1 -1
  4. package/dist/web/assets/{Tabs-BJRGzidj.js → Tabs-D16MqQxu.js} +1 -1
  5. package/dist/web/assets/{TagInput-cIIwXAHA.js → TagInput-pSYxm4bz.js} +1 -1
  6. package/dist/web/assets/{TaskDrawer-CSZ7Z0JC.js → TaskDrawer-1Ev3RpRV.js} +1 -1
  7. package/dist/web/assets/{_requestId-Z3CBhTIL.js → _requestId-BKhn019m.js} +1 -1
  8. package/dist/web/assets/_requestId-Btpvuu7-.js +30 -0
  9. package/dist/web/assets/{appCtx-DCiGJFAe.js → appCtx-D_Iaoh2e.js} +1 -1
  10. package/dist/web/assets/{board-DyfGX5h0.js → board-DeHdxbN4.js} +1 -1
  11. package/dist/web/assets/{directTask-Dk3H5Q2B.js → directTask-C1NWDkZp.js} +1 -1
  12. package/dist/web/assets/{done-Bhxqy7bH.js → done-BFaHGt03.js} +1 -1
  13. package/dist/web/assets/{index-Bt13tvIX.js → index-CDWcKy1L.js} +3 -3
  14. package/dist/web/assets/{new-BRsIUNIb.js → new-ChFzBoL2.js} +1 -1
  15. package/dist/web/assets/{preload-helper-B40dBmwL.js → preload-helper-hSId95YD.js} +1 -1
  16. package/dist/web/assets/{release-notes-C3FdiM36.js → release-notes-BWNDFDkH.js} +1 -1
  17. package/dist/web/assets/{requestData-w6fhCYmh.js → requestData-B_320uxL.js} +1 -1
  18. package/dist/web/assets/{routes-QNgQHe48.js → routes-BBD464IS.js} +1 -1
  19. package/dist/web/assets/{settings-CoKJahEe.js → settings-D7PPrGjT.js} +1 -1
  20. package/dist/web/index.html +3 -3
  21. package/docs/architecture.md +74 -7
  22. package/docs/development.md +19 -9
  23. package/docs/how-to-use.md +51 -2
  24. package/docs/installation.md +26 -10
  25. package/docs/publishing.md +5 -1
  26. package/lib/cli/args.js +2 -0
  27. package/lib/cli/help.js +7 -2
  28. package/lib/cli/main.js +12 -3
  29. package/lib/cli/preflightCommands.js +30 -7
  30. package/lib/cli/project.js +31 -9
  31. package/lib/core/preflight/codexEngine.js +56 -12
  32. package/lib/core/preflight/codexImage.js +49 -19
  33. package/lib/core/preflight/docker.js +149 -0
  34. package/lib/core/preflight/owner.js +118 -0
  35. package/lib/core/preflight/render-image/Dockerfile +1 -1
  36. package/lib/core/preflight/service.js +235 -16
  37. package/lib/core/projectRegistry.js +2 -1
  38. package/lib/core/store/dataWatcher.js +122 -0
  39. package/lib/core/store/normalize.js +9 -1
  40. package/lib/core/store/preflightStore.js +20 -2
  41. package/lib/core/store/projectFile.js +6 -1
  42. package/lib/core/store/workspace.js +20 -37
  43. package/lib/server/api/manifest.js +10 -1
  44. package/lib/server/api/routes.js +18 -5
  45. package/lib/server/server.js +3 -1
  46. package/lib/shared/directTask.js +2 -2
  47. package/lib/shared/preflightRunner.js +18 -0
  48. package/package.json +2 -2
  49. package/skills/p3/SKILL.md +29 -17
  50. package/dist/web/assets/_requestId-C8WYk2kC.js +0 -30
@@ -8,6 +8,8 @@ import { writeFileAtomic } from "./fsutil.js";
8
8
  * drafts/D1.md ... 細分化されたタスク案(1案 = 1ファイル。人や AI が直接編集できる)
9
9
  * children/C1.md ... 子の要望の案(分割の run。タスク案とは一緒に置かない)
10
10
  */
11
+ /** 中断の依頼のファイル(run のフォルダの中) */
12
+ export const CANCEL_REQUEST_FILE = "cancel-request.json";
11
13
  export class PreflightStore {
12
14
  requestsDir;
13
15
  /** requestsDir: .p3/requests */
@@ -18,7 +20,8 @@ export class PreflightStore {
18
20
  return join(this.requestsDir, requestId, "preflight", runId);
19
21
  }
20
22
  async save(run) {
21
- const { drafts, children, ...meta } = run;
23
+ // 中断の依頼は別のファイル(cancel-request.json。頼む側と実行する側が同じファイルを書き合わないように)
24
+ const { drafts, children, cancelRequested, ...meta } = run;
22
25
  await writeFileAtomic(join(this.runDir(run.requestId, run.id), "run.json"), JSON.stringify(meta, null, 2) + "\n");
23
26
  }
24
27
  async saveDrafts(requestId, runId, drafts) {
@@ -81,7 +84,8 @@ export class PreflightStore {
81
84
  try {
82
85
  const meta = JSON.parse(await readFile(join(this.runDir(requestId, runId), "run.json"), "utf8"));
83
86
  const children = await this.loadChildren(requestId, runId);
84
- return { ...meta, drafts: await this.loadDrafts(requestId, runId), ...(children ? { children } : {}) };
87
+ const cancelRequested = meta.status === "running" ? await this.cancelRequest(requestId, runId) : undefined;
88
+ return { ...meta, drafts: await this.loadDrafts(requestId, runId), ...(children ? { children } : {}), ...(cancelRequested ? { cancelRequested } : {}) };
85
89
  }
86
90
  catch {
87
91
  return undefined;
@@ -114,6 +118,20 @@ export class PreflightStore {
114
118
  return { id: runId, state: "broken" };
115
119
  }
116
120
  }
121
+ /** 中断の依頼(無ければ undefined) */
122
+ async cancelRequest(requestId, runId) {
123
+ try {
124
+ const v = JSON.parse(await readFile(join(this.runDir(requestId, runId), CANCEL_REQUEST_FILE), "utf8"));
125
+ return { at: String(v.at ?? ""), ...(typeof v.by === "string" ? { by: v.by } : {}) };
126
+ }
127
+ catch {
128
+ return undefined;
129
+ }
130
+ }
131
+ /** 中断を頼む(実行しているプロセスが見て止める) */
132
+ async requestCancel(requestId, runId, by) {
133
+ await writeFileAtomic(join(this.runDir(requestId, runId), CANCEL_REQUEST_FILE), JSON.stringify({ at: new Date().toISOString(), ...(by ? { by } : {}) }) + "\n");
134
+ }
117
135
  async list(requestId) {
118
136
  const ids = await readdir(join(this.requestsDir, requestId, "preflight")).catch(() => []);
119
137
  const runs = await Promise.all(ids.filter((i) => i.startsWith("PF-")).map((i) => this.get(requestId, i)));
@@ -14,9 +14,14 @@ function toPlain(cfg) {
14
14
  ? cfg.milestones.map((m) => Object.fromEntries(Object.entries({ id: m.id, title: m.title, due: m.due, done: m.done || undefined }).filter(([, v]) => v !== undefined)))
15
15
  : undefined,
16
16
  branchPattern: cfg.branchPattern,
17
- preflight: cfg.preflight.instructions ? { instructions: cfg.preflight.instructions } : undefined,
17
+ preflight: preflightPlain(cfg.preflight),
18
18
  };
19
19
  }
20
+ /** preflight の項目(空の観点は省く。担当は設定したときだけ書き、読めない値もそのまま残す) */
21
+ function preflightPlain(p) {
22
+ const out = Object.fromEntries(Object.entries({ instructions: p.instructions || undefined, runner: p.runner ?? p.invalidRunner }).filter(([, v]) => v !== undefined));
23
+ return Object.keys(out).length ? out : undefined;
24
+ }
20
25
  /**
21
26
  * project.yaml を書く。既存のファイルがあれば YAML の文書として更新し、人が書いたコメントを残す。
22
27
  */
@@ -1,4 +1,4 @@
1
- import { readdir, readFile, watch } from "node:fs/promises";
1
+ import { readdir, readFile } from "node:fs/promises";
2
2
  import { join } from "node:path";
3
3
  import YAML from "yaml";
4
4
  import { parseRef, REQUEST_ID, TASK_ID, taskId } from "../../shared/refs.js";
@@ -6,6 +6,7 @@ import { fileLayout, folderLayout, MarkdownCollection, NotFoundError } from "./c
6
6
  import { newRequestId } from "./fsutil.js";
7
7
  import { normalizeProject, normalizeRequest, normalizeTaskIn, REQUEST_KEY_ORDER, TASK_KEY_ORDER } from "./normalize.js";
8
8
  import { AttachmentStore } from "./attachments.js";
9
+ import { DataWatcher } from "./dataWatcher.js";
9
10
  import { NoteStore } from "./noteStore.js";
10
11
  import { PreflightStore } from "./preflightStore.js";
11
12
  import { writeProjectFile } from "./projectFile.js";
@@ -32,19 +33,6 @@ export function stampStatus(prev, next) {
32
33
  checkedAt: done ? next.checkedAt : undefined,
33
34
  };
34
35
  }
35
- /**
36
- * 1リポジトリ = 1プロジェクト。データディレクトリ配下がすべての状態で、要望ごとにフォルダを分ける。
37
- *
38
- * <data>/project.yaml
39
- * <data>/requests/<要望ID>/request.md
40
- * <data>/requests/<要望ID>/tasks/T001.md
41
- * <data>/requests/<要望ID>/preflight/PF-.../{run.json, assessment.json, carryover.md, drafts/D1.md}
42
- * <data>/requests/<要望ID>/notes/N-....md Preflight へのメモ
43
- * <data>/requests/<要望ID>/attachments/A-.../{meta.json, file.*} 添付(画像・xlsx)
44
- * <data>/release-notes/<マイルストーンID>.md リリースノート(マイルストーンごとに1件。releaseNotes/store.ts)
45
- *
46
- * 共有(git / ファイル共有)も要望のフォルダ単位で行える。
47
- */
48
36
  export class Workspace {
49
37
  dataDir;
50
38
  localRepos;
@@ -56,7 +44,8 @@ export class Workspace {
56
44
  releaseNotes;
57
45
  taskCollections = new Map();
58
46
  listeners = new Set();
59
- abort = new AbortController();
47
+ watcher;
48
+ closed = false;
60
49
  /** localRepos: 個人設定の参照先の名前 → このマシンのパス(repoRefs.ts) */
61
50
  constructor(dataDir, localRepos = {}) {
62
51
  this.dataDir = dataDir;
@@ -220,7 +209,11 @@ export class Workspace {
220
209
  /** プロジェクト設定を更新して project.yaml に書く(コメントは残す) */
221
210
  async saveProject(patch) {
222
211
  await this.loadProject();
223
- const next = { ...this.project, ...patch };
212
+ // preflight は項目ごとに重ねる(観点だけ・担当だけの更新で、もう片方を消さない。以前の API の形 { instructions } も同じ)。
213
+ // 担当を設定したら、読めなかった値は消す
214
+ const pf = patch.preflight;
215
+ const preflight = pf ? { ...this.project.preflight, ...pf, ...(pf.runner ? { invalidRunner: undefined } : {}) } : this.project.preflight;
216
+ const next = { ...this.project, ...patch, preflight };
224
217
  await writeProjectFile(join(this.dataDir, "project.yaml"), next);
225
218
  await this.loadProject();
226
219
  this.emit({ type: "changed", kind: "project" });
@@ -251,28 +244,17 @@ export class Workspace {
251
244
  l(e);
252
245
  }
253
246
  /**
254
- * データディレクトリを監視し、外部からのファイル編集(エディタ・AI・Codex・git pull)を取り込む(補助)。
247
+ * データディレクトリを監視し、外部からのファイル編集(エディタ・AI・Codex・git pull)を取り込む(補助。dataWatcher.ts)。
255
248
  * NFS などでは通知が届かず、Node の再帰的な監視は置き換えて保存したファイルの2回目以降の変更を通知しないことがある。
256
- * 正しさはこれに頼らず、画面の「再読み込み」(reloadAll)で保証する。
249
+ * 正しさはこれに頼らず、画面の「再読み込み」(reloadAll)で保証する。監視が壊れても serve は止めない(ログに残し、立て直す)。
250
+ * 既に監視していれば何もしない。close の後は始めない
257
251
  */
258
- async watch() {
259
- const pending = new Map();
260
- try {
261
- for await (const ev of watch(this.dataDir, { recursive: true, signal: this.abort.signal })) {
262
- const f = ev.filename;
263
- if (!f || f.endsWith(".tmp") || f.includes(".archive"))
264
- continue;
265
- clearTimeout(pending.get(f));
266
- pending.set(f, setTimeout(() => {
267
- pending.delete(f);
268
- void this.onFileChanged(f);
269
- }, 80));
270
- }
271
- }
272
- catch (e) {
273
- if (e.name !== "AbortError")
274
- console.error("[watch]", e);
275
- }
252
+ watch(options) {
253
+ if (this.closed)
254
+ return undefined;
255
+ this.watcher ??= new DataWatcher(this.dataDir, (rel) => this.onFileChanged(rel), options);
256
+ this.watcher.start();
257
+ return this.watcher;
276
258
  }
277
259
  async onFileChanged(rel) {
278
260
  const [top, rid, kind, file] = rel.split(/[\\/]/);
@@ -315,6 +297,7 @@ export class Workspace {
315
297
  }
316
298
  }
317
299
  close() {
318
- this.abort.abort();
300
+ this.closed = true;
301
+ this.watcher?.close();
319
302
  }
320
303
  }
@@ -83,7 +83,16 @@ export const AI_MANIFEST = {
83
83
  {
84
84
  method: "GET",
85
85
  path: "/api/requests/:rid/preflight[/:run]",
86
- desc: "Preflight の run。各 run に inputMatch {status: same|changed|unknown, changed?: [title|body], reason?}(評価対象と今の要望が同じか。タグ・期限・ステータスは比べない)",
86
+ desc: "Preflight の run。各 run に inputMatch {status: same|changed|unknown, changed?: [title|body], reason?}(評価対象と今の要望が同じか。タグ・期限・ステータスは比べない)。" +
87
+ "running の run には liveness {state: alive|waiting|dead|unknown, reason?}(実行しているプロセスの今の状態)と、頼まれていれば cancelRequested {at, by?}。" +
88
+ "中断した run には interrupted {reason, at, acknowledgedBy?}",
89
+ },
90
+ {
91
+ method: "POST",
92
+ path: "/api/requests/:rid/preflight/:run/cancel",
93
+ desc: "run を中断する {acknowledgeStopped?: boolean}(最新でなくてもよい)→ {state: cancelled|requested|already, message, run, acknowledgeable?}。" +
94
+ "requested は中断を頼んだ(まだ running。実行しているプロセスが止める)。acknowledgeable は動いているか確かめられない run で、" +
95
+ "止まっていることを人が確かめたら acknowledgeStopped: true で中断にできる。無い run は 404、完了した run・動いている run への確認は 409(code: completed|alive)",
87
96
  },
88
97
  {
89
98
  method: "PATCH",
@@ -18,8 +18,9 @@ import { AI_MANIFEST } from "./manifest.js";
18
18
  import { repoRoutes } from "./repoRoutes.js";
19
19
  import { releaseNoteRoutes } from "./releaseNoteRoutes.js";
20
20
  import { archiveTask, checkMilestoneRemoval, createRequest, createTask, orderChildren, updateRequest, updateTask } from "../../core/requestOps.js";
21
+ import { PREFLIGHT_RUNNERS } from "../../shared/preflightRunner.js";
21
22
  import { StaleInputError } from "../../core/preflight/input.js";
22
- import { ChildConflictError, ChildDraftsChangedError, DraftConflictError, PulseInputError } from "../../core/preflight/service.js";
23
+ import { CancelRefusedError, ChildConflictError, ChildDraftsChangedError, DraftConflictError, PulseInputError } from "../../core/preflight/service.js";
23
24
  /**
24
25
  * ブラウザ用のローカル API。AI や人の操作は CLI(ファイルを直接読み書き)が主で、ここは画面のため。
25
26
  *
@@ -72,7 +73,8 @@ const projectPatch = z
72
73
  done: z.boolean().optional(),
73
74
  })),
74
75
  branchPattern: z.string().includes("{id}"),
75
- preflight: z.object({ instructions: z.string() }),
76
+ // 担当(runner)は省ける(以前の形 { instructions } の更新でも、保存は項目ごとに重ねるので担当は残る)
77
+ preflight: z.object({ instructions: z.string().optional(), runner: z.enum(PREFLIGHT_RUNNERS).optional() }),
76
78
  })
77
79
  .partial()
78
80
  .superRefine((p, ctx) => {
@@ -345,9 +347,20 @@ export function apiRoutes(ctx, opts = {}) {
345
347
  const text = await preflight.fixedExtract(rid(c), c.req.param("run"), c.req.param("aid"));
346
348
  return c.body(text, 200, { "Content-Type": "text/plain; charset=utf-8", "X-Content-Type-Options": "nosniff", "Content-Security-Policy": "default-src 'none'" });
347
349
  });
348
- app.post("/requests/:rid/preflight/:run/cancel", (c) => {
349
- preflight.cancel(c.req.param("run"));
350
- return c.json({ ok: true });
350
+ // 中断(最新でなくてもよい)。state: cancelled(中断した)/ requested(中断を頼んだ。まだ running)/ already(既に終わっている)。
351
+ // acknowledgeStopped: 動いているか確かめられない run を、人が止まっていることを確かめて中断にする。完了した run・動いている run への
352
+ // 確認は 409(code)。無い run は 404
353
+ app.post("/requests/:rid/preflight/:run/cancel", async (c) => {
354
+ const body = z.object({ acknowledgeStopped: z.boolean().optional() }).parse(await c.req.json().catch(() => ({})));
355
+ try {
356
+ const r = await preflight.cancelRun(rid(c), c.req.param("run"), { acknowledgeStopped: body.acknowledgeStopped, actor: actorOf(c) });
357
+ return c.json({ state: r.state, message: r.message, run: r.run, ...(r.acknowledgeable ? { acknowledgeable: true } : {}) });
358
+ }
359
+ catch (e) {
360
+ if (e instanceof CancelRefusedError)
361
+ return c.json({ error: e.message, code: e.code }, 409);
362
+ throw e;
363
+ }
351
364
  });
352
365
  app.patch("/requests/:rid/preflight/:run/drafts/:key", async (c) => {
353
366
  // expectedTitle: 編集を始めたときの題(制御用。案には書かない)。今の題と違えば 409 で書かない
@@ -33,7 +33,9 @@ export async function startServer(opts) {
33
33
  if (!opts.dataDir)
34
34
  throw new Error("serve: データのフォルダが決まっていません");
35
35
  ctx = await openProject(opts.dataDir, { repos: opts.repos, settings: opts.settings, projectName: opts.projectName });
36
- void ctx.ws.watch();
36
+ ctx.ws.watch();
37
+ // 落ちたプロセスが残した run(実行していたプロセスが終わっていると確かめられるもの)を中断にする。失敗しても serve は続ける
38
+ void ctx.preflight.recover().catch((e) => console.error(`[preflight] 残った run を確かめられません: ${e.message}`));
37
39
  app.route("/api", singleProjectApp(ctx));
38
40
  }
39
41
  if (opts.static) {
@@ -8,5 +8,5 @@ export const DIRECT_TASK_NOTE = "Preflight の評価・細分化・根拠の調
8
8
  export const LATER_PREFLIGHT_NOTE = "後から Preflight を使えるようになったら、この要望に実行できます。実行しても既にあるタスクは変わらず、案をタスク化すると新しいタスクが増えるので、重複を確かめて採否を選んでください。";
9
9
  /** 取り消した Preflight の記録のエラー(失敗とは扱わない) */
10
10
  export const PREFLIGHT_CANCELLED = "中止しました";
11
- /** Preflight が失敗した(取消は含まない)。直接作る道を案内する */
12
- export const preflightFailed = (run) => run.status === "failed" && run.error !== PREFLIGHT_CANCELLED;
11
+ /** Preflight が失敗した(取消と、落ちたプロセスが残した run の中断は含まない。中断は始め直せばよい)。直接作る道を案内する */
12
+ export const preflightFailed = (run) => run.status === "failed" && run.error !== PREFLIGHT_CANCELLED && !run.interrupted;
@@ -0,0 +1,18 @@
1
+ export const PREFLIGHT_RUNNERS = ["codex", "agent"];
2
+ /** 未設定のときの担当(以前のプロジェクトはこれ) */
3
+ export const DEFAULT_PREFLIGHT_RUNNER = "codex";
4
+ export const isPreflightRunner = (v) => PREFLIGHT_RUNNERS.includes(v);
5
+ export function runnerView(preflight) {
6
+ if (preflight.invalidRunner !== undefined) {
7
+ return {
8
+ runner: null,
9
+ source: "project",
10
+ problem: `project.yaml の preflight.runner が読めません: ${preflight.invalidRunner}(${PREFLIGHT_RUNNERS.join(" / ")} のどれか。p3 config set preflight.runner=codex で直せます)`,
11
+ };
12
+ }
13
+ return preflight.runner ? { runner: preflight.runner, source: "project" } : { runner: DEFAULT_PREFLIGHT_RUNNER, source: "default" };
14
+ }
15
+ export const RUNNER_LABEL = {
16
+ codex: "人が p3 から実行する(Codex)",
17
+ agent: "手元の AI エージェントが評価する(頼まれたとき)",
18
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@infodb/p3",
3
- "version": "0.9.0",
3
+ "version": "0.10.0",
4
4
  "description": "File-based project management with AI-powered preflight (Codex App Server)",
5
5
  "keywords": [
6
6
  "project-management",
@@ -21,7 +21,7 @@
21
21
  },
22
22
  "type": "module",
23
23
  "engines": {
24
- "node": ">=22"
24
+ "node": ">=24"
25
25
  },
26
26
  "bin": {
27
27
  "p3": "bin/p3.mjs"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: p3
3
- description: infodb p3(P³)で、このリポジトリの要望とタスクを管理する。ユーザーが要望の登録・Preflight の結果の確認・タスクの着手や完了・進捗の確認を頼んだとき、または要望 ID(261009-k7m3x の形)やタスク(T003)に触れたときに使う。
3
+ description: infodb p3(P³)で、このリポジトリの要望とタスクを管理する。ユーザーが要望の登録・Preflight(頼まれた評価の実行と結果の確認)・タスクの着手や完了・進捗の確認を頼んだとき、または要望 ID(261009-k7m3x の形)やタスク(T003)に触れたときに使う。
4
4
  ---
5
5
 
6
6
  # p3 でこのプロジェクトの作業を管理する
@@ -16,7 +16,8 @@ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
16
16
  ```
17
17
 
18
18
  - `p3` が入っていなければ `pnpx @infodb/p3 <コマンド>` で同じように動く(`npx @infodb/p3` でもよい)
19
- - 最初に `p3 whoami --json` で、操作するプロジェクト・データのフォルダ・決まり方(`via`)・変更者・今の要望を確かめる。
19
+ - 最初に `p3 whoami --json` で、操作するプロジェクト・データのフォルダ・決まり方(`via`)・変更者・今の要望・Preflight の担当
20
+ (`preflight.runner`。下の「Preflight を頼まれたとき」)を確かめる。
20
21
  対象のプロジェクトは今いる場所(リポジトリ・作業ツリー)と個人設定から決まる。決まらなければ、出てきた一覧と案内に従って
21
22
  `--project <名前>` を付ける(名前を推測で決めない)
22
23
  - `via` が `cwd`(今いる場所で決まった)でなければ(`dir` / `project` / `legacy` / `only`)、それ以上 p3 を操作せず、
@@ -36,7 +37,7 @@ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
36
37
  | 操作 | するのは |
37
38
  | --- | --- |
38
39
  | 要望の登録(`request new`) | AI も人も |
39
- | Preflight(評価・細分化。`preflight`) | **人**(人がチャットで対象の要望の Preflight を明示的に頼んだときだけ、AI が手元で評価してよい。下の「Preflight を頼まれたとき」) |
40
+ | Preflight(評価・細分化。`preflight`) | 担当(`whoami --json` の `preflight.runner`)で決まる。**codex** は人(人がチャットで対象の要望の手元の評価を明示的に頼んだときだけ AI が評価する)、**agent** は人に頼まれた AI(手元で評価する)。どちらも AI から始めない(下の「Preflight を頼まれたとき」) |
40
41
  | タスク化(`accept`) | **人だけ** |
41
42
  | タスクの着手・完了(`move ... doing` / `done`)と成果物の登録、作業中に見つけたタスクの追加 | AI も人も |
42
43
  | 要望を対応済にする(`request set <要望ID> status=resolved`) | 作業を終えた AI(か人) |
@@ -45,26 +46,35 @@ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
45
46
  ## 要望を登録する(ユーザーから新しい作業を頼まれたとき)
46
47
 
47
48
  1. `request new "<タイトル>" --body "<背景・やりたいこと・完了条件を箇条書きで>"`(任意で `--area src/web --tag ui --due YYYY-MM-DD --milestone <id>`)
48
- 2. 登録したら要望 ID をユーザーに伝えて終える。**Preflight(評価・細分化)とタスク化(`accept`)は人が行う。**
49
- AI からは実行しない(勧めたり、実行してよいか尋ねたりもしない)。人がタスク化を終えたら、タスクを進める。
50
- 例外は、人がチャットで対象の要望の Preflight を明示的に頼んだときだけ(下の「Preflight を頼まれたとき」)
49
+ 2. 登録したら要望 ID をユーザーに伝えて終える。**Preflight(評価・細分化)は自分から始めず、タスク化(`accept`)は人が行う。**
50
+ Preflight を勧めたり、実行してよいか尋ねたりもしない。人に Preflight を頼まれたら、下の「Preflight を頼まれたとき」に従う
51
+ (担当で分ける)。人がタスク化を終えたら、タスクを進める
51
52
 
52
53
  人が行った Preflight の内容を聞かれたら、`drafts <要望ID>` で評価とタスク案を読んで答えてよい(読むだけ)。
53
54
  `drafts` には「調べた範囲」(参照先ごとに読んだか)と「判断の根拠」(確かめた / 推測)も出る。答えるときは、見ていない参照先や
54
55
  推測の根拠に基づく判断であることを伝える。参照先の登録(`repo add` / `repo path`)はユーザーに頼まれたときだけ行う。
55
56
  評価の確認事項(questions)への回答を頼まれたら、`preflight <要望ID> --note "..." --note-only` でメモとして残す(実行はしない)。
56
57
 
57
- ## Preflight を頼まれたとき(このチャットで評価する)
58
+ ## Preflight を頼まれたとき(担当で分ける)
58
59
 
59
- Preflight は普段は人が実行する(Codex)。人がこのチャットで、対象の要望を挙げて Preflight を明示的に頼んだとき
60
- (例: 「要望 261009-k7m3x の Preflight を Claude Code のこのチャットで実行して」)だけ、P3 が作る指示に従って手元で評価してよい。
61
- P3 はモデルを呼ばない(`claude -p` や API キーは使わない)。要望の登録・タスクの作業のついでに自分から始めない(勧めたり、
62
- 実行してよいか尋ねたりもしない)。対象の要望が分からなければ確かめる。
60
+ 誰が Preflight を実行するかは、プロジェクトの担当(`whoami --json` の `preflight.runner`)で決まる。担当は人が
61
+ `p3 init` か `p3 config set preflight.runner=...` で決める(AI は変えない)。
63
62
 
64
- 1. `whoami --json` で対象のプロジェクトを確かめ(`via` の扱いは上と同じ)、`request show <要望ID> --brief --json` で頼まれた要望かを確かめる
63
+ - **`codex`**(`preflight` の項目が無い古い p3 も同じ): Preflight は人が `p3 preflight` か画面から実行する(Codex が評価する)。
64
+ AI は `p3 preflight <要望ID>`(`--prepare` の無い通常の実行)をしない。人がチャットで対象の要望を挙げて、手元の評価を明示的に
65
+ 頼んだとき(例: 「要望 261009-k7m3x の Preflight を Claude Code のこのチャットで実行して」)だけ、下の手順で評価する。
66
+ 「Preflight して」とだけ頼まれたら、断らずに、人が `p3 preflight <要望ID>`・画面で実行するのか、このチャットで手元の評価をするのかを確かめる
67
+ - **`agent`**(Codex を使えない環境): 人に Preflight を頼まれたら(「Preflight して」「要望 <ID> の Preflight をして」など。
68
+ 「このチャットで」のような言い方は求めない)、下の手順で手元で評価する。`p3 preflight <要望ID>`(`--prepare` の無い通常の実行)はしない
69
+ - **`runner` が `null`**(担当が読めない。理由は `problem`): `agent` と推測しない。`problem` を人に伝え、`codex` と同じ扱いにする
70
+ - どの担当でも: 要望の登録・タスクの作業・子の要望の作成・分割の採用のついでに自分から始めない(勧めたり、実行してよいか尋ねたりも
71
+ しない)。対象の要望が分からなければ確かめる。子の要望も親と同じ担当・同じ手順。P3 はモデルを呼ばない(`claude -p` や API キーは使わない)
72
+
73
+ 1. `whoami --json` で対象のプロジェクトと担当を確かめ(`via` の扱いは上と同じ)、`request show <要望ID> --brief --json` で頼まれた要望かを確かめる
65
74
  2. 準備: `preflight <要望ID> --prepare --json`(変更なので `P3_ACTOR` を付ける)。評価対象を固定し、`instructions`(指示のファイル)・
66
75
  `outputs`(書く成果物)・`run`(PF-...)・`next`(次のコマンド)を返す。始められない(同じ要望の Preflight が待っている・実行中)
67
- ときは止めて人に伝える(自分の判断で `--cancel` しない)
76
+ ときは止めて人に伝える(自分の判断で `--cancel` しない。`--acknowledge-stopped` は、人が run の止まっていることを確かめて
77
+ 中断にするよう頼んだときだけ)
68
78
  3. `instructions` のファイルを最後まで読み、その「制約」に従って評価する。指示の長い文はスキルに写さない(P3 が要望ごとに作る)。
69
79
  参照先は読むだけ(変更・git の書き込み・アプリの起動をしない)。書き込むのは `outputs` に挙がった、その run の成果物だけ
70
80
  (`assessment.json`・`drafts/`・`children/`・`ui/index.json`・`ui/src/`)。これが「データのフォルダを直接編集しない」の唯一の例外で、
@@ -72,7 +82,7 @@ P3 はモデルを呼ばない(`claude -p` や API キーは使わない)。
72
82
  評価に未確認として書く(読めない理由も人に伝える)
73
83
  4. 書き終えたら `preflight <要望ID> --complete --run <run> --json`。`code: invalid_result` なら `problems` を直して同じコマンドをやり直す
74
84
  (run は待ったまま。ファイルを消して作り直さない)
75
- 5. `drafts <要望ID>` で取り込んだ評価(判定・確認事項・タスク案)を読み、要約を人に伝えて終える。**タスク化(`accept`)・タスクの着手はしない**
85
+ 5. `drafts <要望ID>` で取り込んだ評価(判定・確認事項・タスク案か子の案)を読み、要約を人に伝えて終える。**タスク化(`accept`)・タスクの着手はしない**
76
86
  (人が案を確かめて採用してから、「タスクを進める」に従う)
77
87
  - 人にやめるよう頼まれたら `preflight <要望ID> --cancel --run <run>`
78
88
 
@@ -124,7 +134,8 @@ P3 はモデルを呼ばない(`claude -p` や API キーは使わない)。
124
134
 
125
135
  - 子の要望(`parent` のある要望)は、親とは別の要望として、子ごとのタスクとブランチで作業する(親のタスクにしない。
126
136
  手順は上と同じ)。親子は `request show <要望ID> --brief --json` の `parent`・`ancestors`・`children` で読む
127
- - 分割の案(Preflight の子の案)の採用(`accept`)と、子の Preflight は人が行う
137
+ - 分割の案(Preflight の子の案)の採用(`accept`)は人が行う。子の Preflight は親と同じく、頼まれたときだけ
138
+ 「Preflight を頼まれたとき」の担当に従う(分割の採用・子の作成から、自分で子の評価へ進まない)
128
139
  - 子のタスクを全部終えたら、子を対応済にする(6)。親を対応済にするのは、親のタスクと見送り以外の子(`children`)が
129
140
  全部 対応済か完了済になってから。条件を満たさなければ拒否される(理由が出る)
130
141
  - 子にタスクを足す・完了から戻すと、対応済の親も進行中に戻る(`--json` の `reopenedAncestors`)。完了済の親は変わらず
@@ -132,8 +143,9 @@ P3 はモデルを呼ばない(`claude -p` や API キーは使わない)。
132
143
 
133
144
  ## してはいけないこと
134
145
 
135
- - Preflight の実行(`preflight`)とタスク化(`accept`)をしない。どちらも人が行う。例外は、人がチャットで対象の要望の Preflight を
136
- 明示的に頼んだときの `--prepare` / `--complete`(上の「Preflight を頼まれたとき」)だけで、そのときも `accept` はしない
146
+ - Preflight(`preflight`)を自分から始めない・勧めない。`p3 preflight <要望ID>`(Codex で評価する通常の実行)は人が行い、AI は
147
+ しない。手元の評価(`--prepare` / `--complete`)は、上の「Preflight を頼まれたとき」の担当ごとの条件を満たしたときだけ
148
+ - タスク化(`accept`)をしない(人が行う。Preflight を頼まれたときも、評価の後にタスク化・着手へ進まない)
137
149
  - `check`(済み)を付けない。済みは人が成果物を確認して付ける
138
150
  - 要望のステータスを `done`(完了済)/ `rejected`(見送り)にしない(人が決める)。AI がするのは作業を終えたときの `resolved`(対応済)まで。
139
151
  タスク化で `active` になるのは自動