open-research-protocol 0.3.0 → 0.4.1

package/INSTALL.md

@@ -7,6 +7,7 @@ ORP supports both:
 
 The default runtime story is now:
 
+- `orp auth ...`, `orp ideas ...`, `orp feature ...`, `orp world ...`, `orp checkpoint ...`, and `orp agent ...` for hosted workspace work
 - `orp discover ...` for profile-based GitHub scanning and opportunity selection
 - `orp collaborate ...` for repository collaboration
 - `orp erdos ...` for Erdos-specific workflows
@@ -30,6 +31,12 @@ Agent-friendly discovery surfaces:
 
 - bare `orp` for the CLI home screen with packs, repo status, and quick actions
 - `orp home --json` for machine-readable landing context
+- `orp auth login` for hosted workspace login
+- `orp whoami --json` for the current hosted identity
+- `orp ideas list --json` for hosted idea listing
+- `orp world bind --idea-id <idea-id> --project-root /abs/path --codex-session-id <session-id> --json` for hosted world binding
+- `orp checkpoint queue --idea-id <idea-id> --json` for queueing a hosted checkpoint
+- `orp agent work --once --json` for processing one hosted checkpoint job
 - `orp discover profile init --json` for a portable discovery profile scaffold
 - `orp discover github scan --profile orp.profile.default.json --json` for ranked GitHub repo/issue/person recommendations
 - `orp collaborate init` for immediate collaboration scaffolding
@@ -37,7 +44,7 @@ Agent-friendly discovery surfaces:
 - `orp collaborate gates --workflow full_flow --json` for the exact gate chain
 - `llms.txt` for quick repo/package discovery
 - `orp about --json` for machine-readable capabilities, schemas, artifacts, and bundled packs
-- `docs/DISCOVER.md` for the discovery profile model and Coda relationship
+- `docs/DISCOVER.md` for the discovery profile model and scan artifacts
 - `docs/AGENT_LOOP.md` for the intended agent operating rhythm
 - `orp pack list --json` for machine-readable bundled pack inventory
 
@@ -52,6 +59,17 @@ orp collaborate run --workflow full_flow --json
 This uses ORP's built-in collaboration ability. You do not need to think in
 terms of separate governance packs for the default collaboration path.
 
+Fastest hosted workspace loop from the published ORP binary:
+
+```sh
+orp auth login
+orp whoami --json
+orp ideas list --json
+orp world bind --idea-id <idea-id> --project-root /abs/path --codex-session-id <session-id> --json
+orp checkpoint queue --idea-id <idea-id> --json
+orp agent work --once --json
+```
+
 To choose where collaboration should start, scaffold a profile first:
 
 ```sh

package/README.md

@@ -21,7 +21,6 @@ verification remains independent of framing. See `modules/instruments/README.md`
 - `PROTOCOL.md` — the protocol to copy into a project
 - `INSTALL.md` — how to adopt ORP in an existing repo or start a new project from it
 - `docs/AGENT_LOOP.md` — canonical operating loop when an agent is the primary ORP user
-- `docs/CODA_ORP_CONTRACT.md` — boundary between Coda app/wrapper concerns and ORP runtime concerns
 - `docs/EXTERNAL_CONTRIBUTION_GOVERNANCE.md` — canonical local-first workflow for external OSS PR work
 - `docs/OSS_CONTRIBUTION_AGENT_LOOP.md` — agent operating rhythm for external contribution workflows
 - `templates/` — claim, verification, failure, and issue templates
@@ -39,6 +38,7 @@ verification remains independent of framing. See `modules/instruments/README.md`
 
 ORP should feel like one CLI with built-in abilities:
 
+- `workspace` for hosted auth, idea, feature, world, checkpoint, and worker operations
 - `discover` for profile-based GitHub scanning and opportunity selection
 - `collaborate` for repository collaboration setup and workflow execution
 - `erdos` for Erdos-specific data and workflow support
@@ -95,6 +95,12 @@ Agent-first discovery surfaces:
 orp
 orp home --json
 orp about --json
+orp auth login
+orp whoami --json
+orp ideas list --json
+orp world bind --idea-id <idea-id> --project-root /abs/path --codex-session-id <session-id> --json
+orp checkpoint queue --idea-id <idea-id> --json
+orp agent work --once --json
 orp discover profile init --json
 orp discover github scan --profile orp.profile.default.json --json
 orp collaborate workflows --json
@@ -112,11 +118,12 @@ These surfaces are meant to help automated systems discover ORP quickly:
 
 - bare `orp` opens a home screen with repo/runtime status, available packs, and next commands
 - `orp home --json` returns the same landing context in machine-readable form
-- `orp discover ...` exposes profile-based GitHub scanning inside ORP itself instead of forcing discovery into a separate wrapper
+- `orp auth ...`, `orp ideas ...`, `orp world ...`, `orp checkpoint ...`, and `orp agent ...` expose the hosted workspace surface directly through ORP
+- `orp discover ...` exposes profile-based GitHub scanning as a built-in ORP ability
 - `orp collaborate ...` exposes built-in collaboration setup and workflow execution without asking users to think in terms of separate governance packs
 - `llms.txt` gives a concise repo/package map for agents that scan documentation.
 - `docs/AGENT_LOOP.md` gives agents one intended operating rhythm instead of leaving them to invent one.
-- `docs/DISCOVER.md` explains the portable discovery profile model and how it relates to Coda.
+- `docs/DISCOVER.md` explains the portable discovery profile model and scan artifacts.
 - `orp about --json` returns machine-readable capability, artifact, schema, and pack metadata.
 - Core runtime and pack commands can emit JSON so agents do not need to scrape human text.
 - Stable artifact paths make it easy to follow outputs across runs:
@@ -131,6 +138,7 @@ These surfaces are meant to help automated systems discover ORP quickly:
 Release process:
 
 - `docs/NPM_RELEASE_CHECKLIST.md`
+- `docs/ORP_PUBLIC_LAUNCH_CHECKLIST.md`
 - `.github/workflows/npm-publish.yml` (publishes on `v*` tags)
 
 ## Quick start (existing repo)
@@ -163,11 +171,15 @@ ORP remains docs-first by default. For teams that want local gate execution and
 Minimal CLI skeleton:
 
 ```bash
+orp auth login
+orp ideas list --json
+orp world bind --idea-id <idea-id> --project-root /abs/path --codex-session-id <session-id> --json
+orp checkpoint queue --idea-id <idea-id> --json
+orp agent work --once --json
 orp init
 orp gate run --profile default
 orp packet emit --profile default
 orp report summary --run-id <run_id>
-orp pack list
 orp erdos sync
 ```