@infodb/p3 0.1.0 → 0.3.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 (72) hide show
  1. package/README.md +6 -1
  2. package/dist/web/assets/{Outputs-Ni3pNuGU.js → Outputs-DqJdybkd.js} +1 -1
  3. package/dist/web/assets/{RequestStatus-K8TZwpur.js → RequestStatus-DN-2iAM0.js} +1 -1
  4. package/dist/web/assets/TagInput-D-1ILLDX.js +1 -0
  5. package/dist/web/assets/TaskDrawer-CHD7T-Su.js +3 -0
  6. package/dist/web/assets/_requestId-BzSepQIV.js +30 -0
  7. package/dist/web/assets/_requestId-pIds2tFU.js +1 -0
  8. package/dist/web/assets/board-BIkOpuC4.js +1 -0
  9. package/dist/web/assets/directTask-Dk3H5Q2B.js +1 -0
  10. package/dist/web/assets/done-BUAUhIRr.js +1 -0
  11. package/dist/web/assets/draft-CfJeyLOl.js +1 -0
  12. package/dist/web/assets/index-Byv9j77D.js +12 -0
  13. package/dist/web/assets/index-DTfUhuQw.css +2 -0
  14. package/dist/web/assets/new-6kly4-PX.js +1 -0
  15. package/dist/web/assets/preload-helper-DlN0ouRj.js +1 -0
  16. package/dist/web/assets/release-notes-iwQWmfX6.js +3 -0
  17. package/dist/web/assets/requestData-DJ1Rlx-u.js +1 -0
  18. package/dist/web/assets/routes-Ciot9p4x.js +2 -0
  19. package/dist/web/assets/settings-DBCi6lAY.js +1 -0
  20. package/dist/web/assets/ui-Sz7y5_TS.js +1 -0
  21. package/dist/web/assets/workTarget-Cijqq4yH.js +1 -0
  22. package/dist/web/index.html +4 -5
  23. package/docs/architecture.md +70 -14
  24. package/docs/development.md +83 -7
  25. package/docs/how-to-use.md +105 -12
  26. package/docs/installation.md +157 -11
  27. package/docs/publishing.md +27 -3
  28. package/package.json +8 -5
  29. package/skills/p3/SKILL.md +2 -0
  30. package/src/cli/args.ts +9 -2
  31. package/src/cli/help.ts +10 -4
  32. package/src/cli/main.ts +73 -4
  33. package/src/cli/output.ts +18 -0
  34. package/src/cli/preflightCommands.ts +10 -2
  35. package/src/cli/project.ts +269 -98
  36. package/src/cli/releaseNotesCommands.ts +21 -1
  37. package/src/core/context.ts +3 -2
  38. package/src/core/preflight/codexEngine.ts +2 -1
  39. package/src/core/preflight/render-image/Dockerfile +3 -0
  40. package/src/core/preflight/render-image/fonts-ja.conf +28 -0
  41. package/src/core/preflight/render-image/render.mjs +10 -1
  42. package/src/core/preflight/render.ts +5 -2
  43. package/src/core/preflight/service.ts +19 -2
  44. package/src/core/projectRegistry.ts +264 -0
  45. package/src/core/releaseNotes/generate.ts +12 -0
  46. package/src/core/store/locate.ts +6 -6
  47. package/src/core/userConfig.ts +25 -0
  48. package/src/server/api/chatgptRoutes.ts +6 -5
  49. package/src/server/api/manifest.ts +9 -0
  50. package/src/server/api/projectsRoutes.ts +89 -0
  51. package/src/server/api/routes.ts +33 -25
  52. package/src/server/server.ts +74 -15
  53. package/src/shared/directTask.ts +20 -0
  54. package/src/shared/types.ts +1 -1
  55. package/dist/web/assets/TagInput-BICKVH2x.js +0 -1
  56. package/dist/web/assets/TaskDrawer-BkDIstIN.js +0 -3
  57. package/dist/web/assets/_requestId-B5O_ytaq.js +0 -1
  58. package/dist/web/assets/_requestId-C66puEMO.js +0 -30
  59. package/dist/web/assets/board-CbfDjkls.js +0 -1
  60. package/dist/web/assets/done-CPQbCFHg.js +0 -1
  61. package/dist/web/assets/draft-dT3gLDIt.js +0 -1
  62. package/dist/web/assets/index-BUcs2J6N.js +0 -12
  63. package/dist/web/assets/index-C3DkqwJ9.css +0 -2
  64. package/dist/web/assets/link-_s8ndNKS.js +0 -1
  65. package/dist/web/assets/new-T60RB7de.js +0 -1
  66. package/dist/web/assets/preload-helper-dXqN7N-I.js +0 -1
  67. package/dist/web/assets/release-notes-DxrPhDbt.js +0 -3
  68. package/dist/web/assets/requestData-D8ZiSZss.js +0 -1
  69. package/dist/web/assets/routes-D9ZxXoLk.js +0 -2
  70. package/dist/web/assets/settings-DsHVyqzJ.js +0 -1
  71. package/dist/web/assets/supersede-CLXlhCq0.js +0 -1
  72. package/dist/web/assets/ui-Cvke4y4X.js +0 -1
@@ -1,7 +1,7 @@
1
1
  # 公開の手順(@infodb/p3)
2
2
 
3
3
  P3 を npm に `@infodb/p3` として公開するときのチェックリスト。npm への公開とタグ付けは人が行う。
4
- CI は使わず、手元で確かめてから公開する。
4
+ CI は使わず、手元で確かめてから公開する。Docker のイメージ(Docker Hub の `tamuto/p3`)も同じ版で出す(6.)。
5
5
 
6
6
  ## 1. 外部のパッケージ
7
7
 
@@ -18,7 +18,7 @@ CI は使わず、手元で確かめてから公開する。
18
18
  ```bash
19
19
  git clone <このリポジトリ> /tmp/p3-release && cd /tmp/p3-release # 隣に llmcs が無い場所で
20
20
  pnpm install --frozen-lockfile
21
- pnpm -s check # 型検査・lint・テスト・画面のビルド
21
+ pnpm -s check # 型検査・lint・テスト・画面のビルド・UI テスト
22
22
  ```
23
23
 
24
24
  ## 3. 配布物の確認
@@ -28,7 +28,7 @@ node scripts/verify-pack.mjs --docker # npm pack → 実行時の依存だ
28
28
  ```
29
29
 
30
30
  - [ ] 全段が `ok`。確かめる段: Node の版と engines / tarball の中身 / `npm install`(開発用の依存が入らない)/
31
- 別のリポジトリで `init --agents`・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
31
+ 別のリポジトリで `init --agents`・`init --agents codex` と `p3 agents`(後から足す・`--force`)・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
32
32
  `codex update`(`--docker`。未登録・未認証のまま本物の Docker でイメージを作り直し、版を読む)
33
33
  - [ ] 下限の Node でも通す: `PATH=$(dirname $(npx -y node@22.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs`
34
34
  - [ ] Docker が無い環境で確かめたときは、`codex update` の段が「実行していない」と出る。その場合は Docker のある環境で
@@ -55,6 +55,30 @@ npm publish # prepack で画面をビルドする。publishConfig.
55
55
  公開した後に、別の環境で `pnpx @infodb/p3 --help` が動くことを確かめる(その版も公開から1日は pnpm の既定では入らない。
56
56
  `npx @infodb/p3` か、`pnpm dlx --config.minimum-release-age=0 @infodb/p3` で確かめる)。
57
57
 
58
+ ## 6. Docker Hub(tamuto/p3)
59
+
60
+ イメージの中の p3 は、そのときのチェックアウトから `pnpm pack` と同じ中身で作る(npm から取らない)。npm に公開した版と同じ
61
+ コミット(版のタグ `v<版>`)から作り、タグも同じ版にする。
62
+
63
+ - [ ] npm の公開(5.)と同じコミットにいる(`git describe --tags` が `v<版>`、作業ツリーに変更が無い)
64
+ - [ ] スモークが全段 ok: `node scripts/verify-docker.mjs --image tamuto/p3:<版>`(DevContainer の中では `--work`・`--network-of auto`・
65
+ `P3_CODEX_PATH_MAP`。[development.md](development.md#docker-のイメージ))
66
+ - [ ] ソケットを渡したコンテナ(root)で Codex のイメージを作れる: `docker run --rm -v /var/run/docker.sock:/var/run/docker.sock tamuto/p3:<版> codex update`
67
+ - [ ] 本物の Codex(ChatGPT の接続・ソケット)で、コンテナから Preflight が終わる(接続できる環境で手で確かめる)
68
+ - [ ] amd64 と arm64 の両方を作る(Mac の Apple シリコンなど)。arm64 を作れない環境では、QEMU(binfmt)を入れたマシンか
69
+ arm64 のマシンで作る
70
+
71
+ ```bash
72
+ V=$(node -p "require('./package.json').version")
73
+ docker login # tamuto に push できるアカウント
74
+ docker buildx build --platform linux/amd64,linux/arm64 --build-arg P3_VERSION=$V \
75
+ -t tamuto/p3:$V -t tamuto/p3:latest --push .
76
+ docker buildx imagetools inspect tamuto/p3:$V # 両方の platform があるか
77
+ ```
78
+
79
+ 公開した後に、別の環境で `docker run --rm tamuto/p3:<版> --help` と、[導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)
80
+ の手順で起動して一覧が出ることを確かめる。Docker Hub の説明(Overview)は導入ガイドの「Docker で動かす」へのリンクにする。
81
+
58
82
  ## 履歴の確認(2026-10-11、0.1.0 の準備のとき)
59
83
 
60
84
  公開の前に Git の履歴(全ブランチ・63 コミット)を確かめた。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@infodb/p3",
3
- "version": "0.1.0",
3
+ "version": "0.3.0",
4
4
  "description": "File-based project management with AI-powered preflight (Codex App Server)",
5
5
  "keywords": [
6
6
  "project-management",
@@ -42,7 +42,7 @@
42
42
  "dependencies": {
43
43
  "@hono/node-server": "~2.1.3",
44
44
  "@infodb/chatgpt-plan": "^0.1.1",
45
- "@infodb/codex-workspace": "^0.2.0",
45
+ "@infodb/codex-workspace": "^0.2.1",
46
46
  "hono": "^4.13.13",
47
47
  "tsx": "^4.23.15",
48
48
  "yaml": "^2.9.1",
@@ -60,6 +60,7 @@
60
60
  "concurrently": "^10.0.5",
61
61
  "oxlint": "1.87.0",
62
62
  "oxlint-tsgolint": "7.0.2004",
63
+ "playwright-core": "^1.64.1",
63
64
  "react": "^19.3.0",
64
65
  "react-dom": "^19.3.0",
65
66
  "react-markdown": "^10.1.0",
@@ -80,10 +81,12 @@
80
81
  "demo:reset": "tsx scripts/demo.ts --force",
81
82
  "routes": "tsr generate",
82
83
  "typecheck": "tsr generate && tsc --noEmit -p .",
83
- "lint": "oxlint --type-aware --deny-warnings --report-unused-disable-directives-severity=error src scripts test vite.config.ts vitest.config.ts",
84
+ "lint": "oxlint --type-aware --deny-warnings --report-unused-disable-directives-severity=error src scripts test vite.config.ts vitest.config.ts vitest.ui.config.ts",
84
85
  "test": "vitest run",
85
86
  "test:watch": "vitest",
86
- "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build",
87
- "verify:pack": "node scripts/verify-pack.mjs"
87
+ "test:ui": "vitest run -c vitest.ui.config.ts",
88
+ "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm test:ui",
89
+ "verify:pack": "node scripts/verify-pack.mjs",
90
+ "video": "node scripts/video/record.mjs"
88
91
  }
89
92
  }
@@ -22,6 +22,8 @@ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
22
22
  - `via` が `cwd`(今いる場所で決まった)でなければ(`dir` / `project` / `legacy` / `only`)、それ以上 p3 を操作せず、
23
23
  対象のプロジェクトでよいかユーザーに確かめる。特に `only` は登録が1つだけというだけで、p3 を使わないフォルダでも決まる。
24
24
  推測した `--project` や `--dir` を付けて確認を避けない。ユーザーが対象を指定した・確かめた後は、その対象のまま続ける
25
+ - プロジェクトが無い・登録されていない(未登録)ときは、`p3 init`・`p3 join` を自分から実行しない。新しく作る(`init`)のか、
26
+ 共有されたものに参加する(`join`)のかをユーザーに確かめる
25
27
  - `P3_ACTOR=ai:<名前>` は変更者の記録。変更するコマンドには必ず付ける
26
28
  - 結果は `--json` で読む。人に見せる表はオプションなしの出力でよい
27
29
  - 終了コード: 0 成功 / 1 使い方の誤り(メッセージに次にすることが出る)/ 2 見つからない / 3 競合(`show --brief` で読み直してやり直す)
package/src/cli/args.ts CHANGED
@@ -14,6 +14,7 @@ import { Output } from "./output.ts";
14
14
  const OPTIONS = {
15
15
  dir: { type: "string" },
16
16
  project: { type: "string" },
17
+ "all-projects": { type: "boolean" },
17
18
  req: { type: "string" },
18
19
  request: { type: "string" },
19
20
  json: { type: "boolean" },
@@ -46,7 +47,9 @@ const OPTIONS = {
46
47
  repo: { type: "string" },
47
48
  description: { type: "string" },
48
49
  instructions: { type: "string" },
49
- agents: { type: "boolean" },
50
+ // 値なしの --agents は both(joinValues が --agents=both にする)
51
+ agents: { type: "string" },
52
+ force: { type: "boolean" },
50
53
  "note-only": { type: "boolean" },
51
54
  "archive-superseded": { type: "boolean" },
52
55
  paste: { type: "boolean" },
@@ -73,7 +76,11 @@ function joinValues(argv: string[]): string[] {
73
76
  for (let i = 0; i < argv.length; i++) {
74
77
  const name = /^--([a-z]+)$/.exec(argv[i])?.[1];
75
78
  const opt = name ? (OPTIONS as Record<string, { type: string }>)[name] : undefined;
76
- if (opt?.type === "string" && i + 1 < argv.length && !argv[i + 1].startsWith("--")) {
79
+ if (name === "agents") {
80
+ // 値は省ける(both)。次がオプション(- で始まる)か無ければ値なし。値は確かめる側(init)で断る
81
+ const next = argv[i + 1];
82
+ out.push(next !== undefined && !next.startsWith("-") ? `--agents=${argv[++i]}` : "--agents=both");
83
+ } else if (opt?.type === "string" && i + 1 < argv.length && !argv[i + 1].startsWith("--")) {
77
84
  out.push(`${argv[i]}=${argv[++i]}`);
78
85
  } else {
79
86
  out.push(argv[i]);
package/src/cli/help.ts CHANGED
@@ -7,10 +7,15 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
7
7
  使い方: p3 <コマンド> [引数] [オプション]
8
8
 
9
9
  プロジェクト
10
- init 管理したいリポジトリの中で実行。データのフォルダを作り(既にあれば参加し)、個人設定に登録する。
11
- このリポジトリを本体の参照先として登録する
12
- --project 名前 --dir フォルダ --repo-name 参照先の名前(既定はフォルダ名)--description
13
- --instructions 観点 --agents --yes
10
+ init 新しくプロジェクトを作る。管理したいリポジトリの中で実行し、データのフォルダを作って個人設定に登録する。
11
+ このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3(既にあれば作らずに断る → join)
12
+ --project 名前 --dir フォルダ(外に置くとき。相対は今いる場所から)--repo-name 参照先の名前(既定はフォルダ名)--description
13
+ --instructions 観点 --yes
14
+ --agents claude|codex|both AI 向けの使い方(スキルと AGENTS.md / CLAUDE.md の節)を置く先(値を省くと both。付けなければ置かない)
15
+ agents claude|codex|both [--force] AI 向けの使い方を、今いるリポジトリに後から置く・最新にする(選んだ先だけ。データ・個人設定は変えない)
16
+ 違うものは上書きせず知らせる。--force で選んだ先のスキルと p3 の節だけを同梱の版にする(ほかの文は残す)
17
+ join 既にあるプロジェクト(共有されたデータのフォルダ)に参加する。個人設定に登録するだけで、データ・リポジトリのファイルは変えない
18
+ --project 名前 --dir フォルダ(既定はリポジトリのルートの .p3)--repo-name 参照先の名前(共有の定義にあるもの)--yes
14
19
  project [ls | add <名前> <フォルダ> | rm <名前>] 個人設定のプロジェクト
15
20
  config [set キー=値 ...] 設定の表示・変更(name description branchPattern instructions)
16
21
  repo [ls | add | set | path | rm] Preflight が読む参照先(リポジトリ・フォルダ。数と名前は自由)
@@ -35,6 +40,7 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
35
40
  p3 release-notes export v0.2 > RELEASE.md
36
41
  whoami 操作するプロジェクト・変更者・今の要望
37
42
  serve [--port] [--host] ブラウザ用のビューアを起動(既定は個人設定の serve.port / serve.host か $P3_PORT / $P3_HOST)
43
+ --all-projects 個人設定に登録したプロジェクトを跨いで扱う(画面で選ぶ。--project / --dir とは一緒に使えない)
38
44
  chatgpt login | status | logout Preflight に使う ChatGPT プランの接続(このマシン。プロジェクトに属さない)
39
45
  login: --paste(コールバックに届かないとき URL を貼る)--no-browser --port 1455
40
46
  logout: --forget(このマシンの登録ごと消す)
package/src/cli/main.ts CHANGED
@@ -4,7 +4,7 @@ import { openProject } from "../core/context.ts";
4
4
  import { machineSettingsSource, resolveMachineSettings, SettingsError } from "../core/machineSettings.ts";
5
5
  import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.ts";
6
6
  import { OpRuleError } from "../core/requestOps.ts";
7
- import { startServer } from "../server/server.ts";
7
+ import { startServer, type RunningServer } from "../server/server.ts";
8
8
  import { ConflictError, NotFoundError } from "../core/store/collection.ts";
9
9
  import { DataDirError, onlyRegistrationNotice, ProjectNotResolvedError, resolveProject, VIA_LABEL } from "../core/store/locate.ts";
10
10
  import { loadUserConfig, UserConfigError } from "../core/userConfig.ts";
@@ -12,7 +12,7 @@ import { codexCommand } from "./codex.ts";
12
12
  import { userConfigCommand } from "./userConfig.ts";
13
13
  import { chatgptCommand } from "./chatgpt.ts";
14
14
  import { table } from "./format.ts";
15
- import { config, currentRequest, init, locateHere, projectCommand, repoCommand, resolveActor, UsageError } from "./project.ts";
15
+ import { config, currentRequest, init, isAgentChoice, joinProject, locateHere, placeAgents, projectCommand, repoCommand, repoRoot, resolveActor, UsageError } from "./project.ts";
16
16
  import { HELP } from "./help.ts";
17
17
  import { readsOnly } from "./readOnly.ts";
18
18
  import { parse, type CommandEnv } from "./args.ts";
@@ -36,6 +36,33 @@ import { GenerationRejected } from "../core/releaseNotes/generate.ts";
36
36
  * または要望の作業ツリー(ブランチ req/<要望ID>-...)から決まる。
37
37
  */
38
38
 
39
+ /**
40
+ * SIGTERM(docker stop)・SIGINT(Ctrl-C)で止める。新しい要求を断り、実行中の Preflight・生成を取り消して終わるまで待ってから終わる。
41
+ * 2回目の信号ではすぐ終わる
42
+ */
43
+ function serveUntilSignal(server: RunningServer): Promise<number> {
44
+ return new Promise<number>((done) => {
45
+ let stopping = false;
46
+ const stop = (signal: string) => {
47
+ if (stopping) return done(1);
48
+ stopping = true;
49
+ process.stderr.write(`p3: ${signal} を受けたので止めます(実行中の Preflight・生成は取り消して記録します)\n`);
50
+ void (async () => {
51
+ try {
52
+ const { pending } = await server.close();
53
+ if (pending) process.stderr.write(`p3: 待ちきれずに止めました(終わっていない実行 ${pending} 件)\n`);
54
+ done(pending ? 1 : 0);
55
+ } catch (e) {
56
+ process.stderr.write(`p3: 止める途中で失敗しました: ${(e as Error).message}\n`);
57
+ done(1);
58
+ }
59
+ })();
60
+ };
61
+ process.on("SIGTERM", () => stop("SIGTERM"));
62
+ process.on("SIGINT", () => stop("SIGINT"));
63
+ });
64
+ }
65
+
39
66
  async function main(argv: string[]): Promise<number> {
40
67
  const { values: o, positionals } = parse(argv);
41
68
  const [cmd, ...args] = positionals;
@@ -46,7 +73,48 @@ async function main(argv: string[]): Promise<number> {
46
73
  const cwd = process.cwd();
47
74
  const out = new Output(o.json ?? false);
48
75
 
76
+ // --force は p3 agents だけ(ほかのコマンドで黙って無視しない)
77
+ if (o.force && cmd !== "agents") throw new UsageError("--force は p3 agents でだけ使えます");
78
+ // --all-projects は serve だけ。1つのプロジェクトを決める指定とは一緒に使えない(どちらかに黙って決めない)
79
+ if (o["all-projects"]) {
80
+ if (cmd !== "serve") throw new UsageError("--all-projects は p3 serve でだけ使えます");
81
+ if (o.project !== undefined || o.dir !== undefined) {
82
+ throw new UsageError("--all-projects と --project / --dir は一緒に使えません(1つのプロジェクトだけを開くなら --all-projects を外す)");
83
+ }
84
+ // プロジェクトを決めずに起動する(個人設定が壊れていても、画面で理由を見せて直せるように起動する)
85
+ const user = await loadUserConfig().catch((e: Error) => {
86
+ process.stderr.write(`⚠ ${e.message}(待ち受けは既定の値で起動します)\n`);
87
+ return { settings: {} };
88
+ });
89
+ const settings = resolveMachineSettings(user, process.env, { port: o.port, host: o.host });
90
+ const source = machineSettingsSource({ cli: { port: o.port, host: o.host } });
91
+ return serveUntilSignal(await startServer({ allProjects: true, port: settings.serve.port, host: settings.serve.host, static: true, settings: source }));
92
+ }
93
+
94
+ // AI 向けの使い方を置く・最新にする。今いるリポジトリのルートに置くだけで、プロジェクトは決めない(データ・個人設定は変えない)
95
+ if (cmd === "agents") {
96
+ const [choice, ...rest] = args;
97
+ const usage = "p3 agents claude|codex|both [--force](置く先を選ぶ。省けません)";
98
+ if (!isAgentChoice(choice) || rest.length) throw new UsageError(choice === undefined ? `置く先を指定してください: ${usage}` : `置く先は claude / codex / both のどれか: ${[choice, ...rest].join(" ")}(${usage})`);
99
+ if (o.agents !== undefined) throw new UsageError(`p3 agents に --agents は要りません(${usage})`);
100
+ const root = repoRoot(cwd);
101
+ console.log([`AI 向けの使い方(${root})`, ...(await placeAgents(root, cwd, choice, o.force))].join("\n"));
102
+ return 0;
103
+ }
104
+
105
+ if (cmd === "join") {
106
+ // 参加は個人設定に登録するだけ。AI 向けのファイルと、作るときだけの項目は受け付けない(黙って無視しない)
107
+ if (o.agents !== undefined) throw new UsageError("join は AI 向けのファイルを置きません(--agents は使えません)。置く・最新にするなら p3 agents claude|codex|both");
108
+ const createOnly = (["name", "description", "instructions"] as const).filter((k) => o[k] !== undefined);
109
+ if (createOnly.length) throw new UsageError(`join では ${createOnly.map((k) => `--${k}`).join("・")} は使えません(共有の定義は変えません。変えるなら p3 config set)`);
110
+ if (args.length) throw new UsageError(`join は位置引数を取りません: ${args.join(" ")}(p3 join [--project <名前>] [--dir <フォルダ>] [--repo-name <名前>])`);
111
+ console.log(await joinProject({ cwd, project: o.project, dir: o.dir, repoName: o["repo-name"], yes: o.yes }));
112
+ return 0;
113
+ }
114
+
49
115
  if (cmd === "init") {
116
+ if (o.agents !== undefined && !isAgentChoice(o.agents)) throw new UsageError(`--agents は claude / codex / both のどれか(値を省くと both): ${o.agents || "(空)"}`);
117
+ if (args.length) throw new UsageError(`init は位置引数を取りません: ${args.join(" ")}`);
50
118
  console.log(
51
119
  await init({
52
120
  cwd,
@@ -115,8 +183,9 @@ async function main(argv: string[]): Promise<number> {
115
183
  if (cmd === "serve") {
116
184
  // 待ち受け(host / port)は起動のときに決める。Codex と Preflight の設定は Preflight を始めるたびに個人設定から読み直す
117
185
  const source = machineSettingsSource({ cli: { port: o.port, host: o.host } });
118
- await startServer({ dataDir: target.dataDir, repos: target.repos, projectName: target.name, port: settings.serve.port, host: settings.serve.host, static: true, settings: source });
119
- return await new Promise<number>(() => {}); // 終了まで動き続ける
186
+ return serveUntilSignal(
187
+ await startServer({ dataDir: target.dataDir, repos: target.repos, projectName: target.name, port: settings.serve.port, host: settings.serve.host, static: true, settings: source }),
188
+ );
120
189
  }
121
190
 
122
191
  const ctx = await openProject(target.dataDir, { repos: target.repos, settings, projectName: target.name });
package/src/cli/output.ts CHANGED
@@ -5,6 +5,7 @@ import { resolve, titleOf } from "../core/ops.ts";
5
5
  import { type Warning } from "../core/supersede.ts";
6
6
  import { table } from "./format.ts";
7
7
  import { taskWork } from "../core/workTargets.ts";
8
+ import { DIRECT_TASK_NOTE, LATER_PREFLIGHT_NOTE } from "../shared/directTask.ts";
8
9
 
9
10
  /** CLI の出力(人向けの表と --json)と、表示の部品 */
10
11
 
@@ -67,6 +68,23 @@ export function reopenedNote(rid: string | undefined): string | undefined {
67
68
  return rid;
68
69
  }
69
70
 
71
+ /** シェルにそのまま貼れる引数(記号や空白を含むものは単引用符で囲む) */
72
+ export const shellArg = (s: string) => (/^[\w./:=@%+-]+$/.test(s) ? s : `'${s.replace(/'/g, `'\\''`)}'`);
73
+
74
+ /**
75
+ * Preflight を始められなかった・失敗したときの、直接タスクを作る道の案内(人向け。stderr か、エラーの文に付けて出す)。
76
+ * --project / --dir を付けて呼ばれたら、同じ対象で動くようにそのまま付ける
77
+ */
78
+ export function directTaskHint(rid: string, scope: { project?: string; dir?: string } = {}): string {
79
+ const target = [scope.project && `--project ${shellArg(scope.project)}`, scope.dir && `--dir ${shellArg(scope.dir)}`].filter(Boolean).join(" ");
80
+ return [
81
+ "Preflight を通さずに、この要望へタスクを直接作ることもできます(Docker や ChatGPT の接続は要りません):",
82
+ ` p3 new "タスクの題" --req ${shellArg(rid)}${target ? ` ${target}` : ""} --body "作業内容と完了条件"`,
83
+ ` ${DIRECT_TASK_NOTE}`,
84
+ ` ${LATER_PREFLIGHT_NOTE}(p3 preflight ${shellArg(rid)})`,
85
+ ].join("\n");
86
+ }
87
+
70
88
  /** 警告は stderr に出す(--json の stdout を汚さない。JSON では warnings フィールドで返す) */
71
89
  export const warn = (warnings: Warning[]) => {
72
90
  for (const w of warnings) process.stderr.write(`警告: ${w.message}\n`);
@@ -10,7 +10,9 @@ import { UsageError } from "./project.ts";
10
10
  import { StaleInputError, staleMessage } from "../core/preflight/input.ts";
11
11
  import { changedLabel, isMaterialized } from "../shared/preflightInput.ts";
12
12
  import { readBody, type CommandEnv } from "./args.ts";
13
- import { deps, indent } from "./output.ts";
13
+ import { deps, directTaskHint, indent } from "./output.ts";
14
+ import { PreflightBusyError } from "../core/preflight/service.ts";
15
+ import { preflightFailed } from "../shared/directTask.ts";
14
16
 
15
17
  /** Preflight のコマンド(preflight / attach / notes / drafts / accept)。扱わないコマンドは undefined */
16
18
 
@@ -29,16 +31,22 @@ export async function preflightCommand(cmd: string, env: CommandEnv): Promise<nu
29
31
  const off = ctx.ws.on((e) => {
30
32
  if (e.type === "preflight-log" && !out.json) process.stderr.write(`${e.entry.at.slice(11, 19)} ${e.entry.text}\n`);
31
33
  });
34
+ const hint = () => directTaskHint(rid, { project: o.project, dir: o.dir });
32
35
  const started = await ctx.preflight.start(rid, { engine, actor }).catch((e: Error) => {
33
36
  off();
34
37
  // メモは残っているので、書き直さずに p3 preflight だけで再実行できる
35
- throw note ? new Error(`${e.message}(メモ ${note.id} は保存済みです。p3 preflight ${rid} で再実行できます)`) : e;
38
+ const err = note ? new Error(`${e.message}(メモ ${note.id} は保存済みです。p3 preflight ${rid} で再実行できます)`) : e;
39
+ // 始められなかったら直接作る道を添える(実行中・要望が無いときは別の理由なので添えない。終了コードは変えない)
40
+ if (!(e instanceof PreflightBusyError) && !(e instanceof NotFoundError)) err.message += `\n${hint()}`;
41
+ throw err;
36
42
  });
37
43
  if (!out.json) process.stderr.write(`preflight ${started.id} (${started.engine})\n`);
38
44
  const run = await ctx.preflight.wait(rid, started.id);
39
45
  off();
40
46
  if (!run) throw new Error("preflight の結果が読めません");
41
47
  out.result(run, () => formatRun(ctx, rid, run));
48
+ // 失敗したら直接作る道を stderr に出す(--json の stdout は変えない。取消は失敗と扱わない)
49
+ if (preflightFailed(run)) process.stderr.write(`${hint()}\n`);
42
50
  return run.status === "completed" ? 0 : 1;
43
51
  }
44
52