update-lexicon

Regenerate lexicon/*.md keyword lookup tables from local clones of Dash Platform repos.

Step 1: Clone repos

bash scripts/clone-repos.sh

Clones/updates all source repos into .repos/ (gitignored). Note commit SHAs from output for lexicon headers.

All content at dashpay.github.io/platform is generated from dashpay/platform — read source directly, no WebFetch needed.

Step 2: Generate lexicon/rust.md

Rust lexicon is generated deterministically from rustdoc JSON — no agent needed.

bash scripts/gen-rustdoc-json.sh

Note the DOC_DIR=... line from output, then:

python3 scripts/gen-rust-lexicon.py "$DOC_DIR" --patterns lexicon/rust-patterns.md > lexicon/rust.md

Requires cargo +nightly (only for this step).

Step 3: Spawn agents

Spawn 4 agents in parallel (subagent_type: "general-purpose"). Each reads source files locally from .repos/.

Critical: Be exhaustive. Read every source file in assigned packages. Extract every public type, function, trait, struct, enum, const, service, RPC, example. Aim for 50+ entries per section. Coverage > speed.

Agent 1: lexicon/rust-patterns.md

Paths: .repos/platform/packages/rs-sdk/src/platform/ (Fetch, FetchMany, Put traits, queries, transitions, builders, mock), .repos/platform/packages/rs-sdk/examples/, .repos/platform/packages/rs-sdk/tests/, .repos/dash-evo-tool/src/ (real-world usage).

Extract: SDK usage patterns (trait conventions, builder patterns, error handling, async, proof verification, mock testing) and examples (every example file, every significant dash-evo-tool backend task). Output only ## Patterns and ## Examples tables — no Types/Functions (those come from the script). Aim for 15+ patterns and 20+ examples.

After this agent completes, re-run the gen-rust-lexicon.py script to concatenate:

python3 scripts/gen-rust-lexicon.py "$DOC_DIR" --patterns lexicon/rust-patterns.md > lexicon/rust.md

Agent 2: lexicon/contract.md

Paths: .repos/platform/packages/rs-dpp/ (contract types, document types, validation), .repos/platform/packages/wasm-dpp/ (WASM bindings), .repos/yappr/contracts/ (contract examples), .repos/dash-bridge/ (TS types).

Extract: Every public type related to data contracts, document types, state transitions, validation, JSON Schema, token config, group actions. Every contract JSON example.

Agent 3: lexicon/js.md

Paths: .repos/platform/packages/js-evo-sdk/, .repos/platform/packages/wasm-dpp/, .repos/platform/packages/wasm-dpp2/, .repos/platform/packages/wasm-sdk/, .repos/yappr/ (TS files), .repos/dash-bridge/ (TS files), .repos/evo-sdk-website/.

Extract: Every exported class, function, type, interface, facade method. Usage patterns from example apps. WASM init patterns.

Agent 4: lexicon/grpc.md

Paths: .repos/platform/packages/dapi-grpc/protos/ (all .proto files).

Extract: Every service, RPC, message type, enum, field. Single package — be completely exhaustive. Every RPC must have a row.

Step 4: Generate API changelog (MANDATORY)

After lexicon tables are regenerated, run the /update-api-changelog skill. This step is not optional — the lexicon and the changelog are released together.

Invoke /update-api-changelog and follow its procedure (plan → gather → synthesis → prune); the full runnable commands and the synthesis-agent prompt live in skills/update-api-changelog/SKILL.md. Existing changelog files are skipped (idempotent), so steady-state runs are cheap.

lexicon/changelog/platform/*.md is produced by this step and committed alongside the rest of lexicon.

Agent Prompt Template

Include in each agent's prompt:

Working directory: {plugin_root}

Local clones are in .repos/. Read source files directly — no gh api or WebFetch. Walk every file in assigned paths using Glob and Read.

Be exhaustive. 50+ rows per section minimum. Read every file, not just top-level modules.

Write result to {output_file} using the format and link prefixes below.

Output Format

# <Stack> Lexicon
<!-- Auto-generated by update-lexicon. Do not edit. Updated: YYYY-MM-DD -->
<!-- Sources: repo@commit, ... -->

## Types
| Keyword | Description | Src | Docs |
|---------|-------------|-----|------|

## Functions
| Keyword | Description | Src | Docs |
|---------|-------------|-----|------|

## Patterns
| Keyword | Description | Example |
|---------|-------------|---------|

## Examples
| Keyword | Description | File |
|---------|-------------|------|

Link Prefixes

Pre	Expands to
P:	https://github.com/dashpay/platform/blob/master/packages/
R:	https://dashpay.github.io/platform/api/rust/
G:	https://dashpay.github.io/platform/api/grpc/
B:	https://dashpay.github.io/platform/
T:	https://github.com/dashpay/dash-evo-tool/blob/master/
Y:	https://github.com/PastaPastaPasta/yappr/blob/master/
D:	https://github.com/PastaPastaPasta/dash-bridge/blob/master/
E:	https://github.com/dashpay/evo-sdk-website/blob/master/