From ba301ae7859ee2e8ae5d1596e91baa08d5aeb4dd Mon Sep 17 00:00:00 2001 From: stevep0z <255929980+stevep0z@users.noreply.github.com> Date: Mon, 26 Oct 2026 19:16:06 -0500 Subject: [PATCH] llms.txt: regenerate and add a CI drift check public/llms.txt was missing 17 Stellar pages that merged after it was last generated: the 14 Confidential Token pages, Utilities - Math - Fixed-Point, and the two testnet walkthroughs (Agent Wallet, Build with the SDK). The file here is `pnpm run generate:llms-txt` output with no hand edits. Add .github/workflows/llms-txt.yml, which regenerates llms.txt and fails on any diff, so a page added without regenerating it is caught in review rather than silently missing from the index coding agents read. Co-Authored-By: Claude Opus 5 --- .github/workflows/llms-txt.yml | 43 ++++++++++++++++++++++++++++++++++ public/llms.txt | 17 ++++++++++++++ 2 files changed, 60 insertions(+) create mode 100644 .github/workflows/llms-txt.yml diff --git a/.github/workflows/llms-txt.yml b/.github/workflows/llms-txt.yml new file mode 100644 index 00000000..831d2fd7 --- /dev/null +++ b/.github/workflows/llms-txt.yml @@ -0,0 +1,43 @@ +name: llms.txt drift + +on: + push: + branches: [main] + pull_request: + branches: [main] + paths: + - "content/**" + - "src/navigation/**" + - "scripts/generate-llms-txt.ts" + - "public/llms.txt" + +jobs: + llms-txt: + name: llms.txt is up to date + runs-on: ubuntu-latest + + steps: + - name: Checkout code + uses: actions/checkout@v6 + + - name: Setup pnpm + uses: pnpm/action-setup@v6 + + - name: Use Node.js 22 + uses: actions/setup-node@v6 + with: + node-version: 22 + cache: "pnpm" + + - name: Install dependencies + run: pnpm install --frozen-lockfile + + - name: Regenerate llms.txt + run: pnpm run generate:llms-txt + + - name: Fail on drift + run: | + if ! git diff --exit-code -- public/llms.txt; then + echo "::error file=public/llms.txt::public/llms.txt is out of date. Run 'pnpm run generate:llms-txt' and commit the result." + exit 1 + fi diff --git a/public/llms.txt b/public/llms.txt index 4e4f94f4..a385e4b3 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -158,10 +158,26 @@ Each ecosystem section lists the smart-contract libraries and language-specific - [Accounts — Signers and Verifiers](https://docs.openzeppelin.com/stellar-contracts/accounts/signers-and-verifiers) - [Accounts — Policies](https://docs.openzeppelin.com/stellar-contracts/accounts/policies) - [Accounts — Authorization Flow](https://docs.openzeppelin.com/stellar-contracts/accounts/authorization-flow) +- [Accounts — Agent Wallet (testnet)](https://docs.openzeppelin.com/stellar-contracts/accounts/agent-wallet) - [Tokens — Fungible](https://docs.openzeppelin.com/stellar-contracts/tokens/fungible/fungible) - [Tokens — Non-Fungible](https://docs.openzeppelin.com/stellar-contracts/tokens/non-fungible/non-fungible) - [Tokens — RWA](https://docs.openzeppelin.com/stellar-contracts/tokens/rwa/rwa) - [Tokens — Vault](https://docs.openzeppelin.com/stellar-contracts/tokens/vault/vault) +- [Tokens — Confidential — Confidential Token](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/confidential) +- [Tokens — Confidential — Privacy Model](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/privacy-model) +- [Tokens — Confidential — Proof System](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/proof-system) +- [Tokens — Confidential — Operations](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/operations) +- [Tokens — Confidential — Operations — Spenders](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/spenders) +- [Tokens — Confidential — Auditing](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/auditing) +- [Tokens — Confidential — Selective Disclosure](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/selective-disclosure) +- [Tokens — Confidential — Compliance](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/compliance) +- [Tokens — Confidential — Compliance — Clawback](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/clawback) +- [Tokens — Confidential — Wallet Integration](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/wallet-integration) +- [Tokens — Confidential — Wallet Integration — Indexing and Recovery](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/indexing) +- [Tokens — Confidential — Build with the SDK](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/build-with-the-sdk) +- [Tokens — Confidential — Best Practices — Account Holders](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/best-practices/account-holders) +- [Tokens — Confidential — Best Practices — Administrators](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/best-practices/administrators) +- [Tokens — Confidential — Best Practices — Auditors](https://docs.openzeppelin.com/stellar-contracts/tokens/confidential/best-practices/auditors) - [Access — Access Control](https://docs.openzeppelin.com/stellar-contracts/access/access-control) - [Access — Ownable](https://docs.openzeppelin.com/stellar-contracts/access/ownable) - [Governance — Governor](https://docs.openzeppelin.com/stellar-contracts/governance/governor) @@ -170,6 +186,7 @@ Each ecosystem section lists the smart-contract libraries and language-specific - [Utilities — Pausable](https://docs.openzeppelin.com/stellar-contracts/utils/pausable) - [Utilities — Upgradeable](https://docs.openzeppelin.com/stellar-contracts/utils/upgradeable) - [Utilities — Math — WAD](https://docs.openzeppelin.com/stellar-contracts/utils/math/wad): High-precision decimal arithmetic +- [Utilities — Math — Fixed-Point](https://docs.openzeppelin.com/stellar-contracts/utils/math/fixed-point): Full-precision x * y / denominator for i128 and I256 with explicit rounding - [Utilities — Cryptography](https://docs.openzeppelin.com/stellar-contracts/utils/crypto/crypto) - [Utilities — Cryptography — Merkle Distributor](https://docs.openzeppelin.com/stellar-contracts/utils/crypto/merkle-distributor) - [Fee Abstraction](https://docs.openzeppelin.com/stellar-contracts/fee-abstraction)