Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

## Comprehensive-mode ownership

- Every new ChatGPT submission uses Oracle. Regular GPT uses the manually registered DevSpace app; Pro uses Oracle attachment-only and never selects an app.
- Every new ChatGPT submission uses Oracle. Regular GPT uses the manually registered DevSpace app. Qualified Pro uses the `pro-devspace` transport: the `@DevSpace` mention plus the absolute mission path, with mission-scoped file writes and command execution confined to the exact project root. Explicit immutable-evidence Pro uses the `pro-attachment-only` transport and never selects an app. Pro runs only on an explicit user request; no route promotes itself to Pro automatically.
- GPT comprehensive workflows use `codex.chatgpt.oracle-comprehensive/v1`. Retired backend state is host-only historical data and must not be submitted, recovered, or automatically deleted.
- The completing web GPT stage authors the next stage's semantic prompt. Local Codex may validate UTF-8, hashes, stage identity, immutable bindings, transport, recovery, and deterministic final tests, but must not rewrite the next prompt or take over expensive exploration/implementation.
- A selected Web Multi advisory uses genuine independent Oracle sessions. Provider generation is limited to at most five concurrent children; larger accepted topologies run in capacity waves without reducing their logical lane count.
Expand Down
55 changes: 42 additions & 13 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ A Windows automation toolkit that delegates planning, research, review, code
changes, and testing to web ChatGPT while keeping local Codex work focused on
transport, recovery, identity, hashes, and the final deterministic gate.

The current release is `1.8.1`.
The current release is `1.9.0`.

It connects two upstream tools:

Expand All @@ -17,9 +17,18 @@ It connects two upstream tools:

Regular GPT runs verify `GPT-5.6 Sol` at the visible `Extra High` tier (`Power
4 of 5`), then send one line containing exactly `@DevSpace` and the absolute
UTF-8 mission-file path.
Pro runs use `gpt-5.6-sol` with the proven `Power 5 of 5` (`Pro`) effort,
exact hash-frozen attachments, and no DevSpace.
UTF-8 mission-file path. Regular work uses this `extra-high` tier by default
and never promotes to Pro automatically. Pro has a limited daily allowance, so
it is selected only when the user explicitly requests it. New qualified Pro
runs use the `pro-devspace` transport: they mention `@DevSpace` and may write
mission-directed files and run the mission's commands inside the exact project
root. Repository safety rules stay authoritative; account, ChatGPT app
settings, and external state change only when the mission explicitly
authorizes them. `pro-attachment-only` remains a separate explicit
immutable-evidence route and is not an automatic fallback. The standard
comprehensive workflow allows a plan-to-Pro transition only when its manifest
sets `allow_pro: true`, which the host writes only after an explicit user
request. Pro skills never auto-invoke (`allow_implicit_invocation: false`).

## What it provides

Expand All @@ -41,7 +50,8 @@ User request
-> Codex writes a UTF-8 mission and manifest
-> Oracle starts a signed-in ChatGPT session
|-- regular GPT: @DevSpace + mission path
`-- Pro: mission + hash-frozen attachments
|-- qualified Pro: @DevSpace + mission path (writes inside the exact root)
`-- evidence Pro: mission + hash-frozen attachments
-> web GPT explores, plans, edits, and tests
-> Oracle saves the answer as a local artifact
-> Codex checks identity, hashes, and one deterministic final gate
Expand All @@ -63,18 +73,20 @@ Host state and ChatGPT output are stored outside DevSpace projects under
| Web Multi-GPT | Web Multi-GPT | Independent parallel perspectives and merger | 2-25 Oracle sessions |
| Local Multi-GPT | Local Multi-GPT | Local advisory synthesis and counterexample search | Fixed `gpt-5.6-luna` + `max`, read-only |
| Comprehensive | comprehensive mode | Plan, explicitly selected Pro/Web Multi, review, implementation, gate | Staged Oracle workflow |
| Pro | `pro` / Pro | Independent final judgment or design review; result only | Oracle attachments only; `gpt-5.6-sol` + `Power 5 of 5` |
| Pro | `pro` / Pro | Explicitly requested Pro judgment or design review; result only | Qualified `pro-devspace`: DevSpace mention + writes inside exact root; evidence `pro-attachment-only`: attachments only, no app; both `gpt-5.6-sol` + `Power 5 of 5` |

Orchestrator mode is a single web submission. Comprehensive mode contains an
orchestrator-equivalent implementation stage plus planning, independent review,
optional Pro or Web Multi-GPT, and final gates. Web Multi runs only when it is
explicitly selected; regular work and failures never transition to it automatically.

Standalone Pro is a one-shot review route, separate from comprehensive mode. It
reviews the attached plan, code, or document, returns the durable result, and
stops; it never transitions automatically into implementation or another stage.
Use comprehensive mode only when the work must continue from planning through
implementation and gates.
Standalone Pro is a one-shot route, separate from comprehensive mode. The
evidence route (`pro-attachment-only`) reviews the attached plan, code, or
document and returns the durable result; qualified Pro (`pro-devspace`) can
write files and run commands inside the exact project root within the
mission's scope. Neither Pro route transitions automatically into
implementation or another stage; use comprehensive mode only when the work
must continue from planning through implementation and gates.

Local Multi-GPT and Web Multi-GPT are separate paths. Local Multi-GPT is an
optional advisory tool that runs Codex child lanes on the PC. Every stage is
Expand Down Expand Up @@ -173,9 +185,26 @@ top-level `oracle_manifest_sha256` in the same command as

## Pro example

Pro uses no project app. Build and validate the 1 MiB context packet described
in `skills/chatgpt-pro-browser/SKILL.md`; dispatch then revalidates its manifest,
Pro runs only on an explicit user request. Qualified Pro (`pro-devspace`)
sends no attachments: the dispatch emits the `@DevSpace` mention plus the
absolute mission path, and the web Pro session may write mission-directed
files and run the mission's commands inside the exact project root.

```powershell
python "$env:USERPROFILE\.codex\bin\chatgpt_oracle_dispatch.py" `
--mode pro `
--project-root C:\project `
--mission-path C:\project\pro.md `
--manifest-output C:\project\.ai-bridge\pro.json `
--dry-run
```

The evidence route (`pro-attachment-only`) uses no project app. Build and
validate the 1 MiB context packet described in
`skills/chatgpt-pro-browser/SKILL.md`; dispatch then revalidates its manifest,
receipt, mission, packet, and evidence hashes before submission.
`--attachment` and `--context-manifest` are accepted only on this evidence
route.

```powershell
python "$env:USERPROFILE\.codex\bin\chatgpt_oracle_dispatch.py" `
Expand Down
50 changes: 39 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
Codex가 웹 ChatGPT에 계획·리서치·검토·코드 구현을 맡기고, 로컬 Codex는
제출·복구·해시·최종 테스트만 담당하도록 만드는 Windows용 자동화 도구입니다.

현재 릴리스는 `1.8.1`입니다.
현재 릴리스는 `1.9.0`입니다.

이 프로젝트는 다음 두 도구를 연결합니다.

Expand All @@ -16,9 +16,17 @@ Codex가 웹 ChatGPT에 계획·리서치·검토·코드 구현을 맡기고,

일반 GPT 작업은 Oracle이 `GPT-5.6 Sol`과 보이는 `Extra High` 등급
(`Power 4 of 5`)을 확인한 뒤 정확히 `@DevSpace`와 절대 UTF-8 미션 파일
경로만 ChatGPT에 전달합니다. Pro 작업은 `gpt-5.6-sol`과 증명된
`Power 5 of 5`(`Pro`) 등급, 정확한 첨부 파일만 사용하며 DevSpace를
사용하지 않습니다.
경로만 ChatGPT에 전달합니다. 일반 작업은 이 `extra-high` 등급을 기본으로
사용하며 자동으로 Pro로 승격하지 않습니다. Pro는 일일 할당량 제한이 있으므로
사용자가 명시적으로 요청할 때만 선택됩니다. 새 qualified Pro 실행은
`pro-devspace` transport를 사용하며, `@DevSpace` 멘션으로 exact project
root 안에서 미션이 지시한 파일 쓰기와 명령 실행을 수행할 수 있습니다.
저장소 안전성 규칙은 여전히 상위이며, 계정·ChatGPT 앱 설정·외부 상태 변경은
미션이 명시적으로 승인할 때만 허용됩니다. `pro-attachment-only`는 별개의
명시적 불변 증거 경로로 남으며 자동 fallback이 아닙니다. 표준 종합
워크플로는 manifest에 `allow_pro: true`가 있을 때만 plan의 Pro 전환을
허용하며, 그 값은 사용자의 명시적 요청 이후에만 넣습니다. Pro 스킬은
자동으로 호출되지 않습니다(`allow_implicit_invocation: false`).

## 이 도구로 할 수 있는 일

Expand All @@ -41,7 +49,8 @@ Codex가 UTF-8 미션 파일과 실행 manifest 작성
Oracle이 로그인된 ChatGPT 세션 실행
├─ 일반 GPT: @DevSpace + 미션 경로
└─ Pro: 미션 + 고정 해시 첨부 파일
├─ qualified Pro: @DevSpace + 미션 경로 (exact root 안 쓰기)
└─ 증거 Pro: 미션 + 고정 해시 첨부 파일
웹 GPT가 프로젝트 탐색·계획·구현·테스트
Expand All @@ -66,16 +75,19 @@ Codex가 해시·상태·최종 결정론적 테스트만 확인
| Web Multi-GPT | Web Multi-GPT | 여러 관점의 독립 탐색·검증 | 독립 Oracle 세션 2~25개 + merger |
| Local Multi-GPT | Local Multi-GPT | 로컬 병렬 자문·반례 탐색 | `gpt-5.6-luna` + `max` 고정, 읽기 전용 |
| 종합모드 | comprehensive mode | 계획부터 구현·최종 게이트까지 자동 연결 | plan → 명시적으로 선택한 Pro/Web Multi → review → implementation → gate |
| Pro | `pro` / Pro | 독립적인 최종 판단·설계 검토 후 결과만 반환 | Oracle `gpt-5.6-sol` + `Power 5 of 5`, 첨부 전용, DevSpace 없음 |
| Pro | `pro` / Pro | 사용자가 명시적으로 요청한 Pro 판단·검토만 수행 | qualified `pro-devspace`: DevSpace 멘션 + exact root 안 쓰기; 증거 `pro-attachment-only`: 첨부 전용, 앱 없음; 둘 다 `gpt-5.6-sol` + `Power 5 of 5` |

지휘는 웹 제출 한 번으로 끝나는 실행 모드입니다. 종합모드는 지휘와 같은
구현 단계를 포함하면서 계획·독립 검토·선택적 Pro/Web Multi·최종 게이트를
추가한 다단계 워크플로입니다. Web Multi는 명시적으로 선택한 경우에만
실행하며 일반 작업이나 실패한 작업에서 자동으로 전환하지 않습니다.

단순 Pro는 종합모드와 별개인 한 번짜리 검토 경로입니다. 첨부된 계획·코드·문서를
검토하고 결과 파일을 반환하면 끝나며, 자동으로 구현이나 다음 단계로 넘어가지
않습니다. 계획부터 구현까지 이어야 할 때만 종합모드를 사용합니다.
단순 Pro는 종합모드와 별개인 한 번짜리 경로입니다. 증거 경로
(`pro-attachment-only`)는 첨부된 계획·코드·문서를 검토하고 결과 파일을
반환하며, qualified Pro(`pro-devspace`)는 미션이 지시한 범위에서 exact
root 안의 파일을 쓰고 명령을 실행할 수 있습니다. 어떤 Pro 경로도 자동으로
구현이나 다음 단계로 넘어가지 않으며, 계획부터 구현까지 이어야 할 때만
종합모드를 사용합니다.

Local Multi-GPT와 Web Multi-GPT는 서로 다른 경로입니다. Local Multi-GPT는
PC의 Codex 하위 레인을 사용하는 선택적 자문 도구이며, 모든 단계가
Expand Down Expand Up @@ -190,8 +202,24 @@ python "$env:USERPROFILE\.codex\bin\chatgpt_oracle_dispatch.py" `

## Pro 실행 예시

Pro는 프로젝트 앱을 사용하지 않습니다. 미션과 필요한 증거 파일을 정확한
해시로 고정해 첨부합니다.
Pro는 사용자가 명시적으로 요청할 때만 실행됩니다. qualified
Pro(`pro-devspace`)는 첨부 없이 `@DevSpace` 멘션과 절대 미션 경로를
전달하며, exact project root 안에서 미션이 지시한 파일 쓰기와 명령 실행을
수행합니다.

```powershell
python "$env:USERPROFILE\.codex\bin\chatgpt_oracle_dispatch.py" `
--mode pro `
--project-root C:\project `
--mission-path C:\project\pro.md `
--manifest-output C:\project\.ai-bridge\pro.json `
--chatgpt-project-url https://chatgpt.com/g/g-p-example/project `
--dry-run
```

증거 경로(`pro-attachment-only`)는 프로젝트 앱을 사용하지 않습니다. 미션과
필요한 증거 파일을 정확한 해시로 고정해 첨부합니다. `--attachment`와
`--context-manifest`는 이 증거 경로에서만 사용합니다.

```powershell
python "$env:USERPROFILE\.codex\bin\chatgpt_oracle_dispatch.py" `
Expand Down
Loading