gpt-connector 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.3.0 — 2026-07-14
+
+- BugHub factory向けに `gpt-connector factory-diagnostics --json` を追加した。既存
+  `gpt-connector.diagnostics.v1` の `doctor` 契約は維持する。
+- 明示的な canonical dotagents `collection.enabled: true` の時だけ動く、network I/O を
+  持たない product-owned `runtime-errors` local aggregate を追加した。
+- runtime error の公開面は固定 code/template と SHA-256 fingerprint のみを使う。prompt、
+  応答、添付、識別子、credential、CDP dump、絶対 path、raw error は保存・出力しない。
+- true headlessを使わず、cold startでは窓なしで専用profileのheadful Chromeを起動し、CDPで
+  ChatGPT targetを最初から最小化状態で作成・確認してからapp readyを待つ`gpt-connector browser start`
+  を追加した。既存endpointもapp probeより先に最小化する。現行macOS実測では最小化中も送受信を維持する。
+- `gpt-connector browser show`で、正規専用profileの一意ChatGPT windowだけを明示的に表示へ戻せるようにした。認証要求時はstartが同じwindowを表示へ戻してから`AUTH_REQUIRED`を返す。
+- window stateのCDP read-backを有界pollにし、非同期遷移直後の旧stateによるfalse failureを防いだ。
+- cold startはhidden Chrome・background minimized targetから開始し、最小化確認後に正規PIDだけをunhideしてからprobeする。
+- showはCDP stateのstale値に依存せず`Page.bringToFront`を送る。最終状態はWindowServerの正規PID/layer 0 window数で確認する。

package/README.md

@@ -10,7 +10,7 @@ Codex開発枠から、ログイン済みChatGPT公式Web runtimeの通常Chat
 > [!WARNING]
 > consumer Chatの非公開Web runtimeとminified bundleに依存する実験的実装。OpenAIの公開・安定APIではない。bundle contractが変わった場合は`RUNTIME_DRIFT`で停止し、別方式へ自動fallbackしない。
 
-現在版は[`gpt-connector@0.2.0`](https://www.npmjs.com/package/gpt-connector)。ソースと変更履歴は[GitHub repository](https://github.com/kitepon-rgb/gpt-connector)を正とする。
+現在版は[`gpt-connector@0.3.0`](https://www.npmjs.com/package/gpt-connector)。ソースと変更履歴は[GitHub repository](https://github.com/kitepon-rgb/gpt-connector)を正とする。
 
 ## 成立済み機能
 
@@ -26,7 +26,7 @@ Codex開発枠から、ログイン済みChatGPT公式Web runtimeの通常Chat
 - 256KiB CDP chunk転送とpage側SHA-256照合。
 - server attachment metadata read-backとモデル読取確認。
 - caller既知slugによるconsult冪等性、terminal result回収、owner-only durable job台帳。
-- upload／conversationを作らないdry-runとdiagnostics。
+- upload／conversationを作らないdry-run、既存diagnostics、factory diagnostics。
 - CLIとstdio MCP adapter。
 
 ## 前提
@@ -45,18 +45,33 @@ npm install --global gpt-connector
 ```
 
 専用Chromeを起動する。通常ChromeとOracle profileは使用しない。
+true headlessは使わず、cold startでは窓なしで専用profileのheadful Chromeを起動する。CDP browser endpointからChatGPT targetを最初から最小化状態で作成し、最小化を確認してからapp readyを待つ。既存endpointではapp probeより先に専用ChatGPT windowを最小化する。現行macOS実測では最小化中も送受信を維持する。
+
+Chromeのhidden状態はflashを覆うcold準備中だけに使い、最小化確認後は正規PIDだけをunhideしてからprobeする。hiddenのまま運用せず、Oracleのhide fallbackでもない。
+
+`browser start`が成功を返す時点では専用ChatGPT windowは最小化済みである。認証が必要になった場合だけwindowを表示へ戻す。手動でログイン／確認するには次を使う。
+
+window stateのCDP read-backは遷移直後の旧stateを単発判定せず、有界時間内に期待stateへ収束したことを確認する。
+
+ChromeのCDPはshow後も最小化状態を返すことがあるため、表示／非表示の最終判定は正規PIDのWindowServer layer 0 window数で行う。start成功時は0、show成功時は1件以上である。
+実機では同時cold startが`started` 1件／`already_ready` 1件へ収束し、新規専用Chrome PIDで15秒・10ms監視中のlayer 0 on-screen最大値は0だった。`models`とchat（`ACCEPTED_NO_FLASH_OK`）の後も0を維持し、show→startは0→1→0を確認した。
 
 ```bash
-open -na 'Google Chrome' --args \
-  --remote-debugging-port=9223 \
-  --user-data-dir="$HOME/.gpt-connector/browser-profile" \
-  --no-first-run \
-  --no-default-browser-check \
-  https://chatgpt.com/
+gpt-connector browser show
+```
+
+Chrome更新時はrelease smokeとして`browser start`、`models`、最小化中の`chat`、必要時の`browser show`を確認する。
+
+```bash
+gpt-connector browser start
 ```
 
 初回だけ、開いた専用ChromeでChatGPTへ手動ログインする。connectorはpassword、cookie、tokenを読み出さない。
 
+### AI installer向けセットアップ
+
+CodexなどのAIが導入する場合は、[AI installer向けセットアップ契約](docs/ai-installer-setup-contract.md)に従う。AIはinstall、専用Chrome起動、read-only診断、MCP設定を担当し、人間には専用ChromeでのChatGPTログインだけを依頼する。通常ChromeやOracleのprofile、認証情報は使用しない。
+
 ## source setup
 
 ```bash
@@ -114,6 +129,45 @@ gpt-connector --version
 
 `doctor`は`gpt-connector.diagnostics.v1` JSONを返します。接続可能なら`overall: "ready"`、CDPや認証などが未準備なら`overall: "not_ready"`と安定`reasonCode`をstdoutへ返し、exit codeは非0です。診断はuploadや会話作成を行いません。
 
+## BugHub factory 契約
+
+既存の `doctor` と別に、factory consumer 用の versioned read-only JSON を提供します。
+
+```bash
+gpt-connector factory-diagnostics --json
+gpt-connector runtime-errors diagnostics --json
+gpt-connector runtime-errors snapshot --after-cursor 0 --limit 256 --json
+```
+
+`factory-diagnostics` は package version、既存 diagnostics schema、overall、consult job の
+state/job schema と migration、CDP、official origin、auth、runtime bridge、stdio MCP contractを
+固定 check ID で返します。Chrome/CDP/auth が未準備なら `not_ready`、live connector を提供しない
+host は `unsupported`、検査できない項目は `unverified` です。いずれも upload、conversation、archive、
+job 作成を行いません。
+
+`runtime-errors` は product-owned local aggregate であり、network I/O は実装しません。canonical
+dotagents factory config（POSIX: `~/.config/dotagents/factory-reporter.json`、Windows native:
+`%LOCALAPPDATA%\\dotagents\\factory-reporter\\config.json`）が厳密な JSON shape で
+`collection.enabled: true` の場合だけ collection を開始します。設定なし・不正設定・
+`reporting.enabled`・token/credentialの存在は collection を有効にしません。既定はOFFです。
+
+公開操作はすべて `--json` 必須です。
+
+```bash
+gpt-connector runtime-errors snapshot --json
+gpt-connector runtime-errors diagnostics --json
+gpt-connector runtime-errors ack 12 --json
+gpt-connector runtime-errors resolve <sha256-fingerprint> --json
+gpt-connector runtime-errors reopen <sha256-fingerprint> --json
+gpt-connector runtime-errors compact --json
+```
+
+recordは固定 code/template、SHA-256 fingerprint、count、first/last seen、status、cursorだけを持ちます。
+ack cursor は単調で、compact は retention を過ぎた resolved かつ ack 済み recordだけを削除します。
+stateは製品所有directoryへ owner-only atomic writeし、symlink・権限 drift・schema改ざんを拒否します。
+prompt、assistant response、file名/内容/digest、conversation/session/job ID、cookie/token、CDP dump、
+絶対path、生stack/stderrは入力・保存・出力できません。
+
 ## Codex MCP
 
 Codexはtrusted projectの`.codex/config.toml`を読み、stdio serverは`command`と`env`で構成できる。npm global install後は、利用するprojectへ次の設定を置く。

package/dist/src/browser-launcher.d.ts

@@ -0,0 +1,57 @@
+export interface BrowserLaunchResult {
+    readonly ok: true;
+    readonly status: "already_ready" | "started";
+    readonly endpoint: "http://127.0.0.1:9223";
+}
+export interface BrowserShowResult {
+    readonly ok: true;
+    readonly status: "shown";
+    readonly endpoint: "http://127.0.0.1:9223";
+}
+type Spawned = {
+    readonly once: (event: "error", listener: (error: Error) => void) => unknown;
+};
+type Spawn = (command: string, args: readonly string[]) => Spawned;
+type Readiness = () => Promise<boolean>;
+interface ListenerProcess {
+    readonly pid: string;
+    readonly command: string;
+}
+type ProcessInspector = () => Promise<readonly ListenerProcess[]>;
+interface BrowserLock {
+    release(): Promise<void>;
+}
+type LockAcquirer = (profile: string, waitDeadlineMs: number) => Promise<BrowserLock>;
+type WindowMinimizer = () => Promise<"minimized">;
+type ColdTargetCreator = () => Promise<string>;
+type ColdWindowVerifier = (targetId: string) => Promise<"minimized">;
+type WindowShower = () => Promise<"normal">;
+type ProcessRevealer = (pid: number, timeoutMs: number) => Promise<void>;
+type ProcessActivator = (pid: number, timeoutMs: number) => Promise<void>;
+type WindowVisibilityVerifier = (pid: number, expectedVisible: boolean, timeoutMs: number) => Promise<void>;
+interface BrowserOptions {
+    readonly platform?: NodeJS.Platform;
+    readonly home?: string;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly spawn?: Spawn;
+    readonly sleep?: (milliseconds: number) => Promise<void>;
+    readonly endpointReady?: Readiness;
+    readonly appReady?: Readiness;
+    readonly connectorProbe?: Readiness;
+    readonly processInspector?: ProcessInspector;
+    readonly lockAcquirer?: LockAcquirer;
+    readonly windowMinimizer?: WindowMinimizer;
+    readonly coldTargetCreator?: ColdTargetCreator;
+    readonly coldWindowVerifier?: ColdWindowVerifier;
+    readonly windowShower?: WindowShower;
+    readonly existingTargetAbsent?: Readiness;
+    readonly processRevealer?: ProcessRevealer;
+    readonly processActivator?: ProcessActivator;
+    readonly windowVisibilityVerifier?: WindowVisibilityVerifier;
+    readonly probeTimeoutMs?: number;
+    readonly appProbeTimeoutMs?: number;
+    readonly readyDeadlineMs?: number;
+}
+export declare function startBrowser(options?: BrowserOptions): Promise<BrowserLaunchResult>;
+export declare function showBrowser(options?: BrowserOptions): Promise<BrowserShowResult>;
+export {};