ci: fix pnpm 10 install for prettier plugins and snapshot job

- Add root .npmrc with public-hoist-pattern for *eslint* and *prettier*
  so transitive plugins of @theguild/{prettier,eslint}-config remain
  resolvable from the workspace root. pnpm 10 changed the default
  public-hoist-pattern from ["*eslint*","*prettier*"] to [], which
  broke `prettier -c .` with "Cannot find package 'prettier-plugin-sh'".
- Drop packageManagerVersion: 9 from publish.yml stable+snapshot jobs.
  With pnpm/action-setup@v6 it conflicted with the pnpm@10.17.1 pin in
  package.json, aborting the Snapshot job at setup.
- Reformat docs and bin/run.js touched on this branch.

Author: lutter

.github/workflows/publish.yml

@@ -36,7 +36,6 @@ jobs:
         with:
           nodeVersion: 24
           packageManager: pnpm
-          packageManagerVersion: 9
 
       - name: Build
         if: ${{ startsWith(github.event.head_commit.message, env.RELEASE_COMMIT_MSG) }}
@@ -95,7 +94,6 @@ jobs:
         with:
           nodeVersion: 24
           packageManager: pnpm
-          packageManagerVersion: 9
 
       - name: Determine snapshot tag
         id: tag

.npmrc

@@ -0,0 +1,2 @@
+public-hoist-pattern[]=*eslint*
+public-hoist-pattern[]=*prettier*

CLAUDE.md

@@ -4,10 +4,10 @@ Tools for building and deploying subgraphs on The Graph Network.
 
 ## Packages
 
-| Package | Description | Docs |
-|---------|-------------|------|
+| Package                    | Description                          | Docs                                             |
+| -------------------------- | ------------------------------------ | ------------------------------------------------ |
 | `@graphprotocol/graph-cli` | CLI for init, codegen, build, deploy | [packages/cli/CLAUDE.md](packages/cli/CLAUDE.md) |
-| `@graphprotocol/graph-ts` | AssemblyScript library for mappings | [packages/ts/CLAUDE.md](packages/ts/CLAUDE.md) |
+| `@graphprotocol/graph-ts`  | AssemblyScript library for mappings  | [packages/ts/CLAUDE.md](packages/ts/CLAUDE.md)   |
 
 ## Development Setup
 
@@ -24,14 +24,14 @@ pnpm build
 pnpm build
 
 # Run tests
-pnpm test           # All packages
-pnpm test:cli       # CLI only
-pnpm test:ts        # graph-ts only
+pnpm test     # All packages
+pnpm test:cli # CLI only
+pnpm test:ts  # graph-ts only
 
 # Code quality
-pnpm lint           # Check formatting + linting
-pnpm lint:fix       # Auto-fix issues
-pnpm type-check     # TypeScript type checking
+pnpm lint       # Check formatting + linting
+pnpm lint:fix   # Auto-fix issues
+pnpm type-check # TypeScript type checking
 ```
 
 ## Code Style

packages/cli/CLAUDE.md

@@ -39,34 +39,35 @@ src/
 
 ## Commands
 
-| Command | Description |
-|---------|-------------|
-| `init` | Scaffold a new subgraph |
-| `codegen` | Generate AssemblyScript types from schema/ABIs |
-| `build` | Compile subgraph to WASM |
-| `deploy` | Deploy to hosted service or decentralized network |
-| `test` | Run matchstick tests |
-| `create` | Create subgraph name on node |
-| `publish` | Publish to The Graph Network |
-| `add` | Add data source to manifest |
-| `remove` | Remove data source from manifest |
-| `auth` | Set deploy key |
-| `local` | Manage local Graph Node (always TS — gnd has no equivalent) |
-| `dev` | Run graph-node in dev mode (delegates to `gnd dev`) |
-| `clean` | Remove build artifacts |
+| Command   | Description                                                 |
+| --------- | ----------------------------------------------------------- |
+| `init`    | Scaffold a new subgraph                                     |
+| `codegen` | Generate AssemblyScript types from schema/ABIs              |
+| `build`   | Compile subgraph to WASM                                    |
+| `deploy`  | Deploy to hosted service or decentralized network           |
+| `test`    | Run matchstick tests                                        |
+| `create`  | Create subgraph name on node                                |
+| `publish` | Publish to The Graph Network                                |
+| `add`     | Add data source to manifest                                 |
+| `remove`  | Remove data source from manifest                            |
+| `auth`    | Set deploy key                                              |
+| `local`   | Manage local Graph Node (always TS — gnd has no equivalent) |
+| `dev`     | Run graph-node in dev mode (delegates to `gnd dev`)         |
+| `clean`   | Remove build artifacts                                      |
 
 ## Protocol System
 
 Factory pattern for multi-chain support (`src/protocols/index.ts`):
 
 ```typescript
-import Protocol from './protocols/index.js';
+import Protocol from './protocols/index.js'
 
-const protocol = Protocol.fromDataSources(dataSources);
-const manifest = protocol.getManifest();
+const protocol = Protocol.fromDataSources(dataSources)
+const manifest = protocol.getManifest()
 ```
 
 Each protocol provides:
+
 - ABI handling and type generation
 - Manifest schema and validation
 - Scaffolding templates
@@ -75,45 +76,49 @@ Each protocol provides:
 ## Scaffolding
 
 Templates in `src/scaffold/` generate:
+
 - `subgraph.yaml` manifest
 - `schema.graphql` entity definitions
 - `src/mapping.ts` event handlers
 - Test files
 
 ```typescript
-import Scaffold from './scaffold/index.js';
+import Scaffold from './scaffold/index.js'
 
 const scaffold = new Scaffold({
   protocol,
   network,
-  contractName,
+  contractName
   // ...
-});
-await scaffold.generate();
+})
+await scaffold.generate()
 ```
 
 ## Type Generation
 
 `src/type-generator.ts` creates AssemblyScript classes from:
+
 - GraphQL schema -> Entity classes
 - Contract ABIs -> Event/Call types
 
 ## Development
 
 ```bash
-pnpm build          # Compile TypeScript + generate oclif manifest
-pnpm test           # Run vitest tests
-pnpm type-check     # TypeScript type checking
+pnpm build      # Compile TypeScript + generate oclif manifest
+pnpm test       # Run vitest tests
+pnpm type-check # TypeScript type checking
 ```
 
 ### Testing
 
 Uses Vitest with snapshot tests in `tests/`. Key test files:
+
 - `tests/cli/init.test.ts` - Scaffolding tests
 - `tests/cli/validation.test.ts` - Manifest validation
 - `tests/cli/add.test.ts` - Data source addition
 
 Run specific tests:
+
 ```bash
 pnpm test:init
 pnpm test:validation
@@ -124,15 +129,15 @@ pnpm test:validation
 ### Command Structure
 
 ```typescript
-import { Command, Flags } from '@oclif/core';
+import { Command, Flags } from '@oclif/core'
 
 export default class MyCommand extends Command {
   static flags = {
-    network: Flags.string({ description: 'Network name' }),
-  };
+    network: Flags.string({ description: 'Network name' })
+  }
 
   async run() {
-    const { flags } = await this.parse(MyCommand);
+    const { flags } = await this.parse(MyCommand)
     // ...
   }
 }
@@ -141,10 +146,10 @@ export default class MyCommand extends Command {
 ### Subgraph Manifest Loading
 
 ```typescript
-import Subgraph from './subgraph.js';
+import Subgraph from './subgraph.js'
 
-const subgraph = await Subgraph.load('subgraph.yaml');
-const dataSources = subgraph.get('dataSources');
+const subgraph = await Subgraph.load('subgraph.yaml')
+const dataSources = subgraph.get('dataSources')
 ```
 
 ## Related

packages/cli/bin/run.js

@@ -2,8 +2,8 @@
 import process from 'node:process';
 import semver from 'semver';
 import { execute } from '@oclif/core';
-import { nodeVersion } from '../dist/version.js';
 import { runGnd } from '../dist/command-helpers/gnd.js';
+import { nodeVersion } from '../dist/version.js';
 
 if (!semver.satisfies(process.version, nodeVersion)) {
   process.stderr.write(

packages/ts/CLAUDE.md

@@ -28,17 +28,17 @@ This library provides types and host interfaces that compile to WASM and run in
 ## Core Types
 
 ```typescript
-import { BigInt, BigDecimal, Address, Bytes, Entity } from '@graphprotocol/graph-ts';
+import { Address, BigDecimal, BigInt, Bytes, Entity } from '@graphprotocol/graph-ts'
 
 // Number types
-let amount = BigInt.fromI32(100);
-let price = BigDecimal.fromString("1.5");
+let amount = BigInt.fromI32(100)
+let price = BigDecimal.fromString('1.5')
 
 // Address (20 bytes)
-let addr = Address.fromString("0x...");
+let addr = Address.fromString('0x...')
 
 // Binary data
-let data = Bytes.fromHexString("0xabcd");
+let data = Bytes.fromHexString('0xabcd')
 ```
 
 ## Host Interfaces
@@ -52,9 +52,9 @@ store.set(entity, id, data)
 store.remove(entity, id)
 
 // Logging
-log.info("Value: {}", [value.toString()])
-log.warning("Issue: {}", [msg])
-log.error("Failed: {}", [err])
+log.info('Value: {}', [value.toString()])
+log.warning('Issue: {}', [msg])
+log.error('Failed: {}', [err])
 
 // IPFS access
 ipfs.cat(hash)
@@ -73,37 +73,37 @@ Entities implement the `Entity` interface for store operations:
 ```typescript
 class Transfer extends Entity {
   constructor(id: string) {
-    super();
-    this.set("id", Value.fromString(id));
+    super()
+    this.set('id', Value.fromString(id))
   }
 
   save(): void {
-    store.set("Transfer", this.get("id")!.toString(), this);
+    store.set('Transfer', this.get('id')!.toString(), this)
   }
 
   static load(id: string): Transfer | null {
-    return changetype<Transfer | null>(store.get("Transfer", id));
+    return changetype<Transfer | null>(store.get('Transfer', id))
   }
 }
 ```
 
 ## Ethereum Types
 
 ```typescript
-import { ethereum } from '@graphprotocol/graph-ts';
+import { ethereum } from '@graphprotocol/graph-ts'
 
 // In event handler
 export function handleTransfer(event: ethereum.Event): void {
-  let block = event.block;        // ethereum.Block
-  let tx = event.transaction;     // ethereum.Transaction
-  let receipt = event.receipt;    // ethereum.TransactionReceipt | null
-  let logIndex = event.logIndex;  // BigInt
+  let block = event.block // ethereum.Block
+  let tx = event.transaction // ethereum.Transaction
+  let receipt = event.receipt // ethereum.TransactionReceipt | null
+  let logIndex = event.logIndex // BigInt
 }
 
 // Contract calls
-let result = contract.try_balanceOf(address);
+let result = contract.try_balanceOf(address)
 if (!result.reverted) {
-  let balance = result.value;
+  let balance = result.value
 }
 ```
 
@@ -112,13 +112,14 @@ if (!result.reverted) {
 Compiles to WASM via AssemblyScript:
 
 ```bash
-pnpm build  # Outputs index.wasm
-pnpm test   # Run tests
+pnpm build # Outputs index.wasm
+pnpm test  # Run tests
 ```
 
 ## Relationship to CLI
 
 The `@graphprotocol/graph-cli` package generates code that imports from this library:
+
 - `graph codegen` generates entity classes extending `Entity`
 - `graph build` compiles mappings + this library to WASM
 
@@ -128,21 +129,21 @@ The `@graphprotocol/graph-cli` package generates code that imports from this lib
 
 ```typescript
 // Generated code uses ethereum.CallResult<T>
-let result = contract.try_someFunction();
+let result = contract.try_someFunction()
 if (result.reverted) {
-  log.warning("Call reverted", []);
+  log.warning('Call reverted', [])
 } else {
-  let value = result.value;
+  let value = result.value
 }
 ```
 
 ### Dynamic Data Sources
 
 ```typescript
-import { DataSourceTemplate } from '@graphprotocol/graph-ts';
+import { DataSourceTemplate } from '@graphprotocol/graph-ts'
 
 // Create new data source at runtime
-DataSourceTemplate.create("TokenTemplate", [tokenAddress.toHexString()]);
+DataSourceTemplate.create('TokenTemplate', [tokenAddress.toHexString()])
 ```
 
 ## Related