docs: document bridge node pruning and archival mode

.gemini/README.md

@@ -0,0 +1,5 @@
+# Gemini Code Assist
+
+Gemini Code Assist is disabled for this repository via `config.yaml`.
+
+See: <https://github.com/celestiaorg/CIPs/pull/391#pullrequestreview-3878157393>

.gemini/config.yaml

@@ -0,0 +1,4 @@
+# Disable Gemini Code Assist for this repository
+# For more information, see: https://developers.google.com/gemini-code-assist/docs/customize-gemini-behavior-github
+code_review:
+  disable: true

.github/workflows/check-endpoints.yml

@@ -0,0 +1,81 @@
+name: Check Community Endpoints
+
+on:
+  schedule:
+    # Run weekly on Monday at 9 AM UTC
+    - cron: "0 9 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  check-endpoints:
+    name: Check community endpoints across all networks
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Check endpoints and remove broken ones
+        run: node scripts/check-endpoints.mjs
+
+      - name: Read summary and check for changes
+        id: diff
+        run: |
+          if [ -f endpoint-check-summary.txt ]; then
+            {
+              echo "summary<<EOF"
+              cat endpoint-check-summary.txt
+              echo
+              echo "EOF"
+            } >> "$GITHUB_OUTPUT"
+            rm endpoint-check-summary.txt
+          fi
+          if git diff --quiet; then
+            echo "has_changes=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "has_changes=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Build PR body
+        if: steps.diff.outputs.has_changes == 'true'
+        id: body
+        env:
+          SUMMARY: ${{ steps.diff.outputs.summary }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          {
+            echo "text<<EOF"
+            echo "## Summary"
+            echo ""
+            echo "The weekly endpoint health check found unreachable community endpoints"
+            echo "and removed them from the network documentation pages."
+            echo ""
+            echo "### Removed endpoints"
+            echo ""
+            echo "$SUMMARY"
+            echo ""
+            echo "---"
+            echo ""
+            echo "Detected by [automated endpoint check]($RUN_URL)."
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create pull request
+        if: steps.diff.outputs.has_changes == 'true'
+        uses: peter-evans/create-pull-request@22a9089034f40e5a961c8808d113e2c98fb63676 # v7
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: automated/remove-broken-endpoints
+          delete-branch: true
+          title: "fix: remove unreachable community endpoints"
+          body: ${{ steps.body.outputs.text }}
+          labels: endpoint-check
+          commit-message: "fix: remove unreachable community endpoints"

.github/workflows/deploy.yml

@@ -21,10 +21,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: 20
           cache: yarn

.github/workflows/latest-tags.yaml

@@ -32,11 +32,11 @@ jobs:
       OWNER: celestiaorg
       NETWORK: ${{ matrix.network }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Fetch latest tags and commit SHAs
         id: latest
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
@@ -165,7 +165,7 @@ jobs:
 
       - name: Open PR
         if: steps.latest.outputs.should_update == 'true'
-        uses: peter-evans/create-pull-request@v6
+        uses: peter-evans/create-pull-request@v8
         with:
           branch: gh-action/latest-tags-${{ matrix.network }}
           commit-message: "[automated GH action] update latest release tags & commit sha (${{ matrix.network }})"

.github/workflows/lint.yaml

@@ -19,10 +19,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.1.7
+        uses: actions/checkout@v6
 
       - name: Setup Node
-        uses: actions/setup-node@v4.0.3
+        uses: actions/setup-node@v6
         with:
           node-version: 20
           cache: npm
@@ -37,10 +37,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.1.7
+        uses: actions/checkout@v6
 
       - name: Setup Node
-        uses: actions/setup-node@v4.0.3
+        uses: actions/setup-node@v6
         with:
           node-version: 20
           cache: npm

.github/workflows/preview.yaml

@@ -21,10 +21,10 @@ jobs:
       pull-requests: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.1.7
+        uses: actions/checkout@v6
 
       - name: Setup Node
-        uses: actions/setup-node@v4.0.3
+        uses: actions/setup-node@v6
         with:
           node-version: 20
           cache: yarn
@@ -42,7 +42,7 @@ jobs:
         run: yarn build
 
       - name: Checkout docs-preview repository
-        uses: actions/checkout@v4.1.7
+        uses: actions/checkout@v6
         with:
           repository: celestiaorg/docs-preview
           token: ${{ secrets.PR_PREVIEW_DEPLOY }}
@@ -74,11 +74,12 @@ jobs:
             echo "No changes to deploy"
           else
             git commit -m "Deploy preview for PR #${{ github.event.number }} from ${{ github.sha }}"
+            git pull --rebase
             git push
           fi
 
       - name: Post Preview Link
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
         with:
           script: |
             const prNumber = context.payload.pull_request.number;
@@ -119,7 +120,7 @@ jobs:
       contents: read
     steps:
       - name: Checkout docs-preview repository
-        uses: actions/checkout@v4.1.7
+        uses: actions/checkout@v6
         with:
           repository: celestiaorg/docs-preview
           token: ${{ secrets.PR_PREVIEW_DEPLOY }}
@@ -137,6 +138,7 @@ jobs:
             git config user.email "github-actions[bot]@users.noreply.github.com"
             git add .
             git commit -m "Remove preview for PR #${{ github.event.number }}"
+            git pull --rebase
             git push
           else
             echo "Preview directory $TARGET_DIR does not exist, skipping cleanup."

.gitignore

@@ -46,3 +46,11 @@ _pagefind/
 # agents llms
 AGENTS.md
 /public/llms.txt
+/public/llms-full.txt
+/public/**/*.md
+!/public/SKILL.md
+/public/**/llms.txt
+/public/robots.txt
+/public/sitemap.xml
+/public/.well-known/
+package-lock.json

README.md

@@ -10,8 +10,27 @@
 Welcome to the official documentation repository for [Celestia](https://celestia.org/).
 
 - Live site: https://docs.celestia.org
+
+## LLM and agent support
+
+### Quick reference for AI agents
+
+```
+Celestia Documentation Access:
+- Clean markdown: Add .md to any URL (e.g., https://docs.celestia.org/learn/TIA/overview.md)
+- LLMs.txt: https://docs.celestia.org/llms.txt
+- Skill file: https://docs.celestia.org/SKILL.md
+- CIPs: https://cips.celestia.org
+- DeepWikis: https://deepwiki.com/celestiaorg/docs, https://deepwiki.com/celestiaorg/cips, https://deepwiki.com/celestiaorg/celestia-app, https://deepwiki.com/celestiaorg/celestia-node
+```
+
+### Resources
+
 - LLMs.txt: https://docs.celestia.org/llms.txt
+- Skill file: https://docs.celestia.org/SKILL.md (served from `public/SKILL.md`)
+- CIPs (Celestia Improvement Proposals): https://cips.celestia.org
 - Built with: Next.js + Nextra (MDX), exported as a static site.
+- **LLM-ready**: Add `.md` to any URL to get clean markdown (e.g., `https://docs.celestia.org/learn/TIA/overview` → `https://docs.celestia.org/learn/TIA/overview.md`)
 - DeepWikis for @celestiaorg:
     - https://deepwiki.com/celestiaorg/docs
     - https://deepwiki.com/celestiaorg/cips
@@ -53,14 +72,18 @@ BASE=/docs-preview/new_docs/ NEXT_PUBLIC_BASE_PATH=/docs-preview/new_docs yarn b
 
 - `app/**/page.mdx`: documentation pages
 - `app/**/_meta.js`: sidebar order/titles
-- `public/`: static assets
+- `public/`: static assets, including the published agent skill at `public/SKILL.md`
 - `constants/*.json`: shared values referenced in MDX (e.g. `{{mainnetVersions['app-latest-tag']}}`), replaced by `plugins/remark-replace-variables.mjs`
 
 ## Useful scripts
 
 - `yarn lint`: lint the codebase (also runs on `git push` via hook)
 - `yarn check-links -- --all`: validate internal + external links (see `scripts/check-links.mjs --help`)
-- `yarn generate:llms`: generate `public/llms.txt` (ignored by git) for ingestion tools/LLMs
+- `yarn generate:llms`: generate LLM-ready markdown files from MDX sources
+  - Creates clean `.md` versions of all documentation pages
+  - Removes JSX components, imports, and MDX-specific syntax
+  - Automatically runs during build process (`yarn build`)
+  - Access any doc page as markdown by adding `.md` to the URL
 
 ## Contribution guidelines
 
@@ -87,10 +110,10 @@ This section outlines the standards and guidelines for maintaining consistent, h
 - **Node types**: use lowercase for node types (e.g., “bridge node”, not “Bridge Node”)
 - **Politeness**: avoid using “please” in instructional content
 - **Unique headings**: ensure no duplicate headings within a document
-- **Network references**: use “Coffee Beta” network (note the specific capitalization)
+- **Network references**: use "Mainnet Beta" network (note the specific capitalization)
 - **Latin abbreviations**: use italicized _i.e._ or _e.g._ instead of plain i.e. or e.g.
 - **Code references**: use “celestia-app” in regular text (not inline code) when referring to the application name
-- **Tab ordering**: when using tabs, order them as: Coffee Beta, Mocha, Arabica
+- **Tab ordering**: when using tabs, order them as: Mainnet Beta, Mocha, Arabica
 - **Placeholders**: use angle brackets with underscores for placeholders: `<flag_name>` not `<flag-name>` or `<flag name>`
 
 ### Documentation update procedures

app/_meta.js

@@ -12,6 +12,11 @@ const meta = {
     title: "Operate",
     type: "page",
   },
+  status: {
+    title: "Status",
+    type: "page",
+    href: "https://status.celestia.org",
+  },
 };
 
 export default meta;

app/build/blobstream/integrate-contracts/page.mdx

@@ -115,9 +115,8 @@ the following chains:
 | SP1 Blobstream | Ethereum Mainnet       | [`0x7Cf3876F681Dbb6EdA8f6FfC45D66B996Df08fAe`](https://etherscan.io/address/0x7Cf3876F681Dbb6EdA8f6FfC45D66B996Df08fAe#events)                   | [Mainnet Beta](/operate/networks/mainnet-beta)        | [Deployment on Celenium](https://celenium.io/blobstream?network=ethereum&page=1)       |
 | SP1 Blobstream | Arbitrum One           | [`0xA83ca7775Bc2889825BcDeDfFa5b758cf69e8794`](https://arbiscan.io/address/0xA83ca7775Bc2889825BcDeDfFa5b758cf69e8794#events)                    | [Mainnet Beta](/operate/networks/mainnet-beta)        | [Deployment on Celenium](https://celenium.io/blobstream?network=arbitrum&page=1)       |
 | SP1 Blobstream | Base                   | [`0xA83ca7775Bc2889825BcDeDfFa5b758cf69e8794`](https://basescan.org/address/0xA83ca7775Bc2889825BcDeDfFa5b758cf69e8794#events)                   | [Mainnet Beta](/operate/networks/mainnet-beta)        | [Deployment on Celenium](https://celenium.io/blobstream?network=base&page=1)           |
-| SP1 Blobstream | Scroll                 | [`0x5008fa5CC3397faEa90fcde71C35945db6822218`](https://scrollscan.com/address/0x5008fa5CC3397faEa90fcde71C35945db6822218)                        | [Mainnet Beta](/operate/networks/mainnet-beta)        | N/A                                                                                    |
 | SP1 Blobstream | Sepolia                | [`0xf0c6429ebab2e7dc6e05dafb61128be21f13cb1e`](https://sepolia.etherscan.io/address/0xf0c6429ebab2e7dc6e05dafb61128be21f13cb1e#events)           | [Mocha testnet](/operate/networks/mocha-testnet) | [Deployment on Celenium](https://mocha.celenium.io/blobstream?network=ethereum&page=1) |
 | SP1 Blobstream | Arbitrum Sepolia       | [`0xc3e209eb245Fd59c8586777b499d6A665DF3ABD2`](https://sepolia.arbiscan.io/address/0xc3e209eb245Fd59c8586777b499d6A665DF3ABD2#events)            | [Mocha testnet](/operate/networks/mocha-testnet) | [Deployment on Celenium](https://mocha.celenium.io/blobstream?network=arbitrum&page=1) |
 | SP1 Blobstream | Base Sepolia           | [`0xc3e209eb245Fd59c8586777b499d6A665DF3ABD2`](https://sepolia.basescan.org/address/0xc3e209eb245Fd59c8586777b499d6A665DF3ABD2#events)           | [Mocha testnet](/operate/networks/mocha-testnet) | [Deployment on Celenium](https://mocha.celenium.io/blobstream?network=base&page=1)     |
 | SP1 Blobstream | Holesky                | [`0x315A044cb95e4d44bBf6253585FbEbcdB6fb41ef`](https://holesky.etherscan.io/address/0x315A044cb95e4d44bBf6253585FbEbcdB6fb41ef)                  | [Mocha testnet](/operate/networks/mocha-testnet) | N/A                                                                                    |
-| SP1 Blobstream | ZKSync Gateway Staging | [`0x3a038D77A9b4eBBc8A7482B438BCff11c3591792`](https://explorer.era-gateway-stage.zksync.dev/address/0x3a038D77A9b4eBBc8A7482B438BCff11c3591792) | [Mocha testnet](/operate/networks/mocha-testnet) | N/A                                                                                    |
+| SP1 Blobstream | ZKSync Gateway Staging | `0x3a038D77A9b4eBBc8A7482B438BCff11c3591792`                                                                                                      | [Mocha testnet](/operate/networks/mocha-testnet) | N/A                                                                                    |

app/build/blobstream/integrate-offchain/page.mdx

@@ -71,7 +71,7 @@ The rollup sequencer is responsible for creating blocks and, in this demo, writi
 
 Therefore, we can start by first defining the reading and writing interactions rollup nodes will have with both the Celestia and Ethereum networks. The actual implementations of these interfaces are left as exercises to the reader. Assume that those implementations of these interfaces are verifying the respective chain. For the connection to Celestia, this would likely mean connecting to a Celestia light node, which can detect faults in consensus such as hidden data. For the connection to Ethereum, this would likely mean running and connecting to a full node.
 
-More information on the RPC that is exposed by a Celestia light node can be found [in the RPC documentation](https://node-rpc-docs.celestia.org/?version=v0.28.4). Additionally, if you need more information on how to run a light node, you can [check out the documentation](/operate/data-availability/light-node/quickstart).
+More information on the RPC that is exposed by a Celestia light node can be found [in the Node API docs](/build/rpc/node-api/). Additionally, if you need more information on how to run a light node, you can [check out the documentation](/operate/data-availability/light-node/quickstart).
 
 ```go
 // CelestiaLightNodeClient summarizes the actions that a rollup that uses
@@ -246,4 +246,4 @@ As linked above, use the [Celestia Node API](/build/rpc/node-api) or [check out
 
 ### Posting headers to Ethereum
 
-How headers are posted to Ethereum is entirely dependent upon how the rollup light client contracts work. For examples of interacting with the Ethereum blockchain programmatically, please see the [go-ethereum book](https://goethereumbook.org/en/transactions/) or one of the many other resources for [submitting transactions](https://github.com/ethereumbook/ethereumbook/blob/first_edition_first_print/06transactions.asciidoc) or [writing contracts](https://github.com/ethereumbook/ethereumbook/blob/first_edition_first_print/07smart-contracts-solidity.asciidoc).
+How headers are posted to Ethereum is entirely dependent upon how the rollup light client contracts work. For examples of interacting with the Ethereum blockchain programmatically, please see resources for [submitting transactions](https://github.com/ethereumbook/ethereumbook/blob/first_edition_first_print/06transactions.asciidoc) or [writing contracts](https://github.com/ethereumbook/ethereumbook/blob/first_edition_first_print/07smart-contracts-solidity.asciidoc).