@infodb/p3 0.2.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 +62 -9
  24. package/docs/development.md +83 -7
  25. package/docs/how-to-use.md +103 -10
  26. package/docs/installation.md +142 -5
  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 +9 -3
  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 +262 -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 +3 -3
  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
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
- このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3
10
+ init 新しくプロジェクトを作る。管理したいリポジトリの中で実行し、データのフォルダを作って個人設定に登録する。
11
+ このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3(既にあれば作らずに断る → join)
12
12
  --project 名前 --dir フォルダ(外に置くとき。相対は今いる場所から)--repo-name 参照先の名前(既定はフォルダ名)--description
13
- --instructions 観点 --agents --yes
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