Skip to content

docs(ai): align energy purchase, security, and agent contracts - #102

Merged
bbsyaya merged 7 commits into
justlend:mainfrom
BlackChar92:codex/ai-readability-20260819
Aug 28, 2026
Merged

docs(ai): align energy purchase, security, and agent contracts#102
bbsyaya merged 7 commits into
justlend:mainfrom
BlackChar92:codex/ai-readability-20260819

Conversation

@BlackChar92

@BlackChar92 BlackChar92 commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Scope

This is the single documentation PR for the coordinated open-source release. It documents the same three workstreams shipped by CLI, MCP, and Skills.

1. Energy direct purchase

  • document quote-bound direct purchase, explicit confirmation, token-bearing order tracking, public payer history, and payment-risk recovery
  • publish the six-tool MCP contract and corresponding CLI/Skills routing
  • document the official https://tegrow.ablesdxd.link mainnet default and the explicit custom/non-mainnet override boundary
  • distinguish direct purchase from rental and TRX resource staking
  • document tokenless idempotent responses and the no-argument, configured-wallet get_energy_payment_risk inspection; it never replays a stored payment, and another payment remains blocked while risk is unresolved

2. Security audit remediation

  • document payer-scoped locking, duplicate-payment prevention, redirect blocking, credential redaction, and solidified-success checks
  • disclose that an ambiguous result may retain the exact signed request in a local mode-0600 recovery file; it remains broadcastable until expiry and is redacted from normal output
  • mark the legacy unauthenticated browser-wallet bridge as disabled
  • publish signing, broadcast, retry, and HITL boundaries across CLI, MCP, Skills, and V2 Utils
  • keep high-risk/write annotations visible in the generated tool catalog

3. AI readability

  • reconcile all AI entry points around 24 markets: 18 active + 6 legacy, including active jU
  • publish CLI v1.0.1, MCP v1.1.3, and Skills v1.1.1 discovery and machine-output contracts
  • regenerate the 104-tool MCP catalog with input/output schemas and side-effect metadata
  • correct the CLI inventory to 30 top-level command groups and document nested energy purchase history
  • add raw Markdown publication, CLI/SDK routing, API acceptance evidence, and deterministic consistency checks

Validation

  • node scripts/verify-ai-consistency.mjs — passed
  • node scripts/api-acceptance.mjs --json — 9/9 live read-only checks passed on 2026-08-24
  • mkdocs build --strict — passed
  • generated catalog — 104 tool headings and 104 output schemas
  • raw Markdown publication — 52 source files
  • pull-request workflow — deterministic consistency and strict build run before merge; live acceptance remains on push, schedule, and manual runs

Coordinated rollout

Surface PR Candidate
CLI justlend-cli#2 v1.0.1
MCP mcp-server-justlend#30 v1.1.3
Skills justlend-skills#8 v1.1.1
Docs justlend-docs#102 coordinated docs

This PR may merge first. Because pushes to Docs main deploy automatically, merge CLI, MCP, and Skills in the same release window to minimize any temporary documentation/implementation mismatch. Portal MR !53 is AI-readability-only and can wait until these documentation links are live.

- Lock the 24-market roster and account API behavior with live acceptance checks.\n- Publish raw Markdown and first-class CLI and SDK discovery paths.\n- Sync CLI, MCP, and Skills versions with structured output contracts.
- Document quote-bound energy direct purchase and recovery safeguards.
- Mark the legacy unauthenticated browser bridge as disabled.
- Regenerate the full catalog and enforce 103 output schemas.
- document all six skill workflows and the bundled read-only boundary\n- clarify backend-controlled Energy purchase broadcasts\n- validate AI contracts and strict builds on pull requests
- reserve live API acceptance for push, scheduled, and manual runs\n- keep source consistency and strict MkDocs validation on pull requests
- move checkout, Node.js setup, and Python setup to Node 24-based releases\n- remove deprecated action runtime warnings from pull request validation
- publish the 104-tool MCP catalog with payer history
- align API defaults and signed recovery-state disclosures
- correct the CLI inventory to 30 top-level command groups
- Refresh the generated catalog from MCP PR justlend#30.\n- Document the no-argument configured-wallet risk check.\n- Keep recovery replay behind a separately confirmed purchase call.
@bbsyaya
bbsyaya merged commit b9ce67f into justlend:main Aug 28, 2026
1 check passed
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