Skip to content

docs: checks a judge can run without a browser or an API key - #336

Merged
Lexirieru merged 1 commit into
mainfrom
docs/readme-judge-checks
Nov 14, 2026
Merged

Lexirieru merged 1 commit into
mainfrom
docs/readme-judge-checks

Conversation

@Lexirieru

Copy link
Copy Markdown
Contributor

A read of the README the way a screening agent would do it (every link, every command, every number) found four gaps. Everything else matched: 22 linked transactions exist and succeeded, the RPC commands print the code hashes in the tables, and steps 1 to 6 of "Through the API" work on the hosted demo.

What changed

  • README, receipts: NearBlocks answers curl with 403, so a script cannot open the transaction links. Added one command against a public archival RPC, with what it prints.
  • README and apps/docs/api.mdx: docs/openapi.json has 64 operations, not 63. The README table now has GET /v1/minds/{mindId}/payments.xlsx.
  • README, Run locally: bun install for apps/fe.
  • README and JUDGE.md, tests: which tests need no API key and no .env, and which need a NEAR AI Cloud key.

Tests

  • Clean checkout, no .env, no keys: engine test:unit 198 pass; apps/be test 165 pass, 1 skipped (local Postgres, fake engine); apps/fe test 280 pass.
  • The new RPC command was run: SuccessValue, from the Mind wallet to lin1er.testnet, a Transfer of 0.01 NEAR.
  • payments.xlsx on the hosted demo with a guest session: 200, Excel content type.
  • Mintlify validate and broken-links --check-anchors: pass.
  • Not run: cargo test in sc/ and sc/swarm/ (CI sc covers them). No load test: only documentation changed.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e

A read of the README as a screening agent would do it found four gaps:
- NearBlocks answers curl with 403, so the transaction links cannot be
  opened by a script. Added one public archival RPC command.
- docs/openapi.json has 64 operations; the README and the docs site said
  63, and the README table missed GET /v1/minds/{mindId}/payments.xlsx.
- "Run locally" had no bun install for apps/fe.
- The tests line did not say which tests need no API key.

Tests, in a clean checkout with no .env and no keys: engine test:unit
198 pass; apps/be test 165 pass, 1 skipped (local Postgres, fake
engine); apps/fe test 280 pass. The RPC command and the xlsx route were
run against testnet and the hosted demo. Mintlify validate and
broken-links pass. cargo test in sc/ was not run here (CI covers it).
No load test: only documentation changed.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
@Lexirieru
Lexirieru merged commit 0e8c737 into main Nov 14, 2026
2 checks passed
@Lexirieru

Copy link
Copy Markdown
Contributor Author

Merged as 0e8c737, before the development deadline (14 Nov 23:59 UTC).

@Lin1er @AncungAulia @Nabil-Aufa for your information: the README and JUDGE.md now say which tests run with no API key and no .env (engine test:unit, apps/be test, apps/fe test), give one RPC command to check a transaction without a browser (NearBlocks answers curl with 403), list payments.xlsx in the API table (64 operations), and add bun install for apps/fe in Run locally. No code changed.

@Lin1er

Lin1er commented Nov 14, 2026

Copy link
Copy Markdown
Contributor

Live on the hosted demo: main 0e8c737 (automatic deploy after the merge).

  • Before: 2adea9e, and the box matched git at that revision. CI: passed: Mintlify Deployment,mintlify.
  • GET /v1/health → {"ok":true,"engine":true,"revision":"0e8c737"}. No rollback.
  • Rollback target: 2adea9e (/opt/hellonear/release-old).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants