Add public tester onboarding

Author: FlowmemoryAI

.github/ISSUE_TEMPLATE/public-tester-report.yml

@@ -0,0 +1,84 @@
+name: Public Tester Report
+description: Report results from public FlowMemory tester lanes.
+title: "[Public Tester]: "
+labels:
+  - public-tester
+  - tester-report
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for testing FlowMemory. Do not include private keys, seed phrases, RPC credentials, API keys, webhook URLs, wallet secrets, or private user data.
+  - type: dropdown
+    id: lane
+    attributes:
+      label: Tester Lane
+      description: Which public tester lane did you run?
+      options:
+        - Quick JS smoke
+        - Public-agent contracts
+        - Local public-agent e2e
+        - Dashboard workbench
+        - CLI / control-plane trial
+        - Documentation review
+        - Other public local/test path
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, shell, Node/npm versions, Foundry version if relevant, browser if relevant.
+      placeholder: |
+        OS: Windows 11
+        Shell: PowerShell 7
+        Node: v22.x
+        npm: 10.x
+        Forge: 1.x
+    validations:
+      required: true
+  - type: textarea
+    id: commands
+    attributes:
+      label: Commands Run
+      description: Exact commands, in order.
+      placeholder: |
+        npm install
+        npm run public:test:quick
+    validations:
+      required: true
+  - type: dropdown
+    id: result
+    attributes:
+      label: Result
+      options:
+        - Passed
+        - Failed
+        - Partially passed
+        - Documentation unclear
+        - Could not run because prerequisite was missing
+    validations:
+      required: true
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence Or First Useful Error
+      description: Include the first useful error, short logs, screenshot notes, or returned JSON shape. Do not paste huge logs.
+    validations:
+      required: false
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Or Suggested Improvement
+      description: What should have happened, or what would make this easier to test/use?
+    validations:
+      required: true
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Safety Check
+      options:
+        - label: I did not include private keys, seed phrases, RPC credentials, API keys, webhook URLs, wallet secrets, or private user data.
+          required: true
+        - label: I understand this is local/test public infrastructure, not a production/mainnet readiness claim.
+          required: true

README.md

@@ -37,7 +37,7 @@ Repository operating system:
 - `AGENTS.md` with shared agent instructions.
 - `docs/START_HERE.md` with required reading order and local multi-agent worktree workflow.
 - Source-of-truth docs for context, roadmap, architecture, security model, project charter, agent roles, and current state.
-- Public-reader documentation now starts at `docs/PUBLIC_REPO_GUIDE.md`, with public-agent implementation details in `docs/PUBLIC_AGENT_NETWORK_TECHNICAL_GUIDE.md`, release status in `docs/PUBLIC_AGENT_NETWORK_RELEASE.md`, and tracked public gaps in `docs/PUBLIC_RELEASE_GAPS.md`.
+- Public-reader documentation now starts at `docs/PUBLIC_REPO_GUIDE.md`, with tester lanes in `docs/PUBLIC_TESTER_GUIDE.md`, public-agent implementation details in `docs/PUBLIC_AGENT_NETWORK_TECHNICAL_GUIDE.md`, release status in `docs/PUBLIC_AGENT_NETWORK_RELEASE.md`, and tracked public gaps in `docs/PUBLIC_RELEASE_GAPS.md`.
 - `docs/DECISIONS/` for durable decision records.
 - GitHub issue and pull request templates.
 - Conservative repository hygiene CI.

docs/CURRENT_STATE.md

@@ -4,7 +4,7 @@ Status: public repository release boundary, local/test implementation.
 
 This document names what exists for the public agent network, what is intentionally not claimed, and how reviewers can verify the current stack.
 
-For the end-to-end reader guide, see `docs/PUBLIC_REPO_GUIDE.md`. For component-level details, see `docs/PUBLIC_AGENT_NETWORK_TECHNICAL_GUIDE.md`.
+For the end-to-end reader guide, see `docs/PUBLIC_REPO_GUIDE.md`. For tester lanes, see `docs/PUBLIC_TESTER_GUIDE.md`. For component-level details, see `docs/PUBLIC_AGENT_NETWORK_TECHNICAL_GUIDE.md`.
 
 ## What Exists
 

docs/PUBLIC_AGENT_NETWORK_RELEASE.md

@@ -124,6 +124,8 @@ It shows public network primitives and deterministic local projections. Live eve
 
 ## 7. Local Verification
 
+For external tester lanes and expected results, see `docs/PUBLIC_TESTER_GUIDE.md`.
+
 Public-agent contract suites:
 
 ```powershell

docs/PUBLIC_AGENT_NETWORK_TECHNICAL_GUIDE.md

@@ -2,20 +2,21 @@
 
 Status: public-reader guide for the current local/test repository release.
 
-FlowMemory is a Base-native AI memory, Rootflow, public-agent-network, FlowChain local/test, and FlowRouter research repository. It is public so builders, reviewers, and operators can inspect the work, reproduce the local flows, and see the exact gaps that remain. It is not a production deployment, not an audited network, and not a mainnet-readiness claim.
+FlowMemory is a Base-native agent memory and accountability protocol workbench. It is public so builders, reviewers, and operators can inspect the agent-memory, Agent Bonds, public-agent, service, SDK, and dashboard surfaces; reproduce the local flows; and see the exact gaps that remain. Separate chain-devnet research also exists in this repository, but it is not the public-reader starting point.
 
 ## The Short Version
 
-FlowMemory makes agent memory explicit and replayable without pretending heavy AI state belongs on-chain.
+FlowMemory makes agent work explicit, replayable, and economically accountable without pretending heavy AI state belongs on-chain.
 
 The repository currently contains:
 
 - local/test Solidity contracts for FlowPulse, Rootfield, Base on-chain agent memory, Agent Bonds, and the public-agent network;
 - fixture-first indexer, verifier, Flow Memory, control-plane, SDK, and dashboard packages;
 - deterministic Rootflow and Flow Memory V0 fixtures;
-- a local no-value FlowChain devnet prototype;
+- signed Agent Bonds quote attestations, recourse-policy fixtures, and requester quote/create SDK helpers;
 - a public-agent launch and swarm stack with Foundry tests and a local e2e script;
-- public docs that describe what exists, what does not, and what must be verified before broader claims are allowed.
+- FlowRouter hardware/resilience research materials;
+- public docs that describe what exists, what works locally, and what must be verified before broader value-bearing claims are allowed.
 
 ## How The Pieces Fit Together
 
@@ -47,24 +48,46 @@ registered class + approved tool set
 | --- | --- |
 | Understand the repo boundary | `README.md`, `docs/CURRENT_STATE.md`, `docs/MARKETING_CLAIMS_GUARDRAILS.md` |
 | Understand the public-agent release | `docs/PUBLIC_AGENT_NETWORK_RELEASE.md`, `docs/PUBLIC_AGENT_NETWORK_TECHNICAL_GUIDE.md` |
+| Test what works locally | `docs/PUBLIC_TESTER_GUIDE.md` |
 | See exactly what is still missing | `docs/PUBLIC_RELEASE_GAPS.md` and GitHub issues #164-#168 |
 | Understand Base on-chain agent memory | `docs/base-onchain-agent-memory/README.md` |
 | Understand Rootflow and Flow Memory V0 | `docs/ROOTFLOW_V0.md`, `docs/FLOW_MEMORY_V0.md`, `docs/V0_LAUNCH_ACCEPTANCE.md` |
 | Operate or contribute safely | `AGENTS.md`, `docs/START_HERE.md`, `CONTRIBUTING.md`, `SECURITY.md` |
 | Check deployment and claim boundaries | `docs/PRODUCTION_READINESS_CHECKLIST.md`, `contracts/DEPLOYMENT_BOUNDARY.md`, `contracts/ACCESS_CONTROL_REVIEW.md` |
 
+## Public Tester Commands
+
+Start with the low-friction lane:
+
+```powershell
+npm run public:test:quick
+```
+
+Then add the lanes that match your local tools:
+
+```powershell
+npm run public:test:contracts
+npm run public:test:e2e
+npm run public:test:dashboard
+```
+
+The full public local pass is:
+
+```powershell
+npm run public:test:all
+```
+
+See `docs/PUBLIC_TESTER_GUIDE.md` for expected results, CLI/control-plane commands, dashboard review prompts, and the tester-report template.
+
 ## Verification Commands
 
-Run the checks for the area you are inspecting. The broad local/test confidence path is:
+Run the checks for the area you are inspecting. The broad public confidence path is:
 
 ```powershell
 npm test
-npm run contracts:hardening
-npm run launch:candidate
-npm run public-agent-network:contracts
-npm run public-agent-network:local-e2e
-npm test --prefix apps/dashboard
-npm run build --prefix apps/dashboard
+npm run build:production
+npm run flowmemory:agent-bonds:phase2
+npm run flowmemory:agent-bonds:readiness
 node infra/scripts/check-unsafe-claims.mjs
 git diff --check
 ```
@@ -82,7 +105,7 @@ Some checks require local tools such as Foundry, Rust, dashboard dependencies, o
 | `services/verifier/` | Local/test verifier reports and status projection. |
 | `services/flowmemory/` | Launch-core generation, public-agent helpers, Agent Bonds helpers, and deterministic fixture builders. |
 | `services/control-plane/` | Local JSON-RPC style control-plane methods and smoke client. |
-| `services/flowchain-sdk/` | FlowChain client and CLI wrappers. |
+| `services/flowchain-sdk/` | Client and CLI wrappers for the separate chain-devnet research track; not required for the main public quickstart. |
 | `services/agent-memory-sdk/` | Agent-memory client for fixture-backed and local control-plane flows. |
 | `apps/dashboard/` | Vite/React fixture-backed dashboard and public-network projection views. |
 | `fixtures/` | Deterministic local/test outputs used by services and dashboard. |