diff --git a/README.md b/README.md index 3e5e7c26..0f585aa3 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,19 @@ AGIJobManager is an Ethereum smart-contract system for escrowed AGI work agreements, with optional ENS-backed job pages managed by `ENSJobPages`. +> [!IMPORTANT] +> **New here? Start with the [Genesis Console](https://montrealai.github.io/agijobmanagerv0.html).** +> This is the fastest operator/reviewer entry point for the standalone mainnet UI. +> **Repo-pinned equivalent artifact:** `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html` +> **Operator guide:** `docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md` + +### Quick links + +- **Launch Genesis Console:** +- **Read the operator guide:** `docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md` +- **Inspect the pinned standalone artifact:** `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html` +- **Deployment / contract operations:** `hardhat/README.md` and `docs/DEPLOYMENT/README.md` + > **Operational policy:** intended for autonomous AI-agent execution with accountable human owner/operator oversight. This is policy intent and is not fully enforced on-chain. ## Start here by role (30-second routing) @@ -16,7 +29,7 @@ AGIJobManager is an Ethereum smart-contract system for escrowed AGI work agreeme - **Contract owner (Etherscan-first):** start with [`docs/DEPLOYMENT/OWNER_MAINNET_DEPLOYMENT_AND_OPERATIONS_GUIDE.md`](docs/DEPLOYMENT/OWNER_MAINNET_DEPLOYMENT_AND_OPERATIONS_GUIDE.md), then [`docs/OWNER_RUNBOOK.md`](docs/OWNER_RUNBOOK.md). - **ENSJobPages replacement operator:** use one canonical flow in [`docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md`](docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md). - **Troubleshooting during deployment/cutover:** go to [`docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md`](docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md). -- **Standalone HTML UI operator/reviewer:** start with [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md), then [`docs/ui/STANDALONE_HTML_UIS.md`](docs/ui/STANDALONE_HTML_UIS.md) and [`ui/README.md`](ui/README.md) for UI surface inventory. +- **Standalone HTML UI operator/reviewer:** start with the [Genesis Console](https://montrealai.github.io/agijobmanagerv0.html), then read [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md). For the repo-pinned standalone artifact, see [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html). - **Broader/full UI contributor:** use [`docs/ui/README.md`](docs/ui/README.md) for Next.js UI roadmap, runbooks, and release/testing docs. ## Canonical operator answers (quick reference) @@ -57,16 +70,17 @@ Irreversible actions (delay until validated): - **Smart contracts (authoritative protocol state):** `contracts/` (AGIJobManager + ENSJobPages integration). - **Deployment/operator tooling (official):** `hardhat/` with runbooks in `docs/DEPLOYMENT/`. - **ENS identity layer (additive):** ENSJobPages docs in `docs/ENS/` and replacement flow in `docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md`. -- **Standalone HTML UI artifact (versioned):** `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v21.html` with operator guide at [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) and artifact index [`docs/ui/STANDALONE_HTML_UIS.md`](docs/ui/STANDALONE_HTML_UIS.md). +- **Standalone Genesis Console surfaces:** canonical newcomer entry is the hosted Genesis Console at ; repo-pinned versioned standalone artifact is [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html); operator guide is [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md); artifact inventory and broader UI references are [`docs/ui/STANDALONE_HTML_UIS.md`](docs/ui/STANDALONE_HTML_UIS.md), [`ui/README.md`](ui/README.md), and [`docs/ui/README.md`](docs/ui/README.md). - **Broader/full UI in development:** Next.js app and UI docs in [`ui/`](ui/) and [`docs/ui/README.md`](docs/ui/README.md). ### UI routing (pick the right interface quickly) | If you need to... | Use this | Why | | --- | --- | --- | -| Operate a versioned single-file mainnet interface | [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v21.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v21.html) + [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) | Fast, standalone browser artifact for direct operator/reviewer workflows. | -| Build/test the broader UI stack | [`ui/`](ui/) + [`docs/ui/README.md`](docs/ui/README.md) | Full Next.js UI effort, still in active development. | -| Deploy/replace contracts and ENS components | [`hardhat/README.md`](hardhat/README.md) + [`docs/DEPLOYMENT/README.md`](docs/DEPLOYMENT/README.md) | Canonical deployment and operator runbooks; UI is not a deployment substitute. | +| Operate the mainnet standalone interface right now | + [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) | Fastest newcomer/operator entry point for the standalone mainnet console. | +| Inspect the pinned standalone artifact in-repo | [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html) | Repo-pinned equivalent artifact for review, provenance, and versioned inspection. | +| Build/test the broader UI stack | [`ui/`](ui/) + [`docs/ui/README.md`](docs/ui/README.md) | Broader UI effort and development docs. | +| Deploy/replace contracts and ENS components | [`hardhat/README.md`](hardhat/README.md) + [`docs/DEPLOYMENT/README.md`](docs/DEPLOYMENT/README.md) | Canonical deployment/operator runbooks; UI is not a deployment substitute. | > **UI safety boundary:** the standalone HTML artifact is action-capable, but contract deployment, ownership wiring, and ENS replacement authority remain in Hardhat/deployment runbooks. @@ -85,7 +99,9 @@ Irreversible actions (delay until validated): - ENSJobPages replacement runbook (mainnet): [`docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md`](docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md) - ENS naming/behavior reference: [`docs/ENS/ENS_JOB_PAGES_OVERVIEW.md`](docs/ENS/ENS_JOB_PAGES_OVERVIEW.md) - Deployment troubleshooting: [`docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md`](docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md) -- Standalone HTML UI (v21) operator guide: [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) +- Genesis Console (hosted newcomer entry): +- Genesis Console operator guide: [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) +- Pinned standalone artifact (repo): [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html) - UI directory inventory: [`ui/README.md`](ui/README.md) ## Recommended vs legacy deployment paths @@ -161,7 +177,9 @@ npm run docs:ens:check - Main documentation index: [`docs/README.md`](docs/README.md) - UI docs hub (broader UI): [`docs/ui/README.md`](docs/ui/README.md) -- Standalone HTML UI guide (v21): [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) +- Genesis Console operator guide: [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) +- Genesis Console (hosted newcomer entry): +- Pinned standalone artifact (repo): [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html) - UI directory inventory: [`ui/README.md`](ui/README.md) - Quintessential walkthrough: [`docs/QUINTESSENTIAL_USE_CASE.md`](docs/QUINTESSENTIAL_USE_CASE.md)