Merge pull request #24 from koxudaxi/feat/llms-txt-docs-tooling

Add llms.txt generation, docs version updater, and CHANGELOG integration

Author: koxudaxi

.github/workflows/docs.yaml

@@ -2,7 +2,7 @@ name: Docs
 
 on:
   pull_request:
-    paths: ['docs/**', 'examples/**', 'zensical.toml', 'overrides/**', 'README.md', 'CONTRIBUTING.md', 'pyproject.toml', 'uv.lock']
+    paths: ['docs/**', 'examples/**', 'zensical.toml', 'overrides/**', 'README.md', 'CONTRIBUTING.md', 'pyproject.toml', 'uv.lock', 'CHANGELOG.md']
   push:
     branches:
       - main
@@ -29,6 +29,19 @@ jobs:
         python-version: "3.14"
     - name: Install dependencies
       run: uv sync --only-group docs
+    - name: Copy CHANGELOG to docs
+      run: |
+        if [ -f CHANGELOG.md ]; then
+          cp CHANGELOG.md docs/changelog.md
+        else
+          echo "# Changelog" > docs/changelog.md
+          echo "" >> docs/changelog.md
+          echo "Changelog will be available after the first release." >> docs/changelog.md
+        fi
+    - name: Update docs version
+      run: uv run python scripts/update_docs_version.py
+      env:
+        GH_TOKEN: ${{ github.token }}
     - name: build site
       run: uv run --only-group docs zensical build --clean
 

.github/workflows/llms-txt.yaml

@@ -0,0 +1,64 @@
+name: Update llms.txt
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**/*.md'
+      - 'zensical.toml'
+      - 'scripts/build_llms_txt.py'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'docs/**/*.md'
+      - 'zensical.toml'
+      - 'scripts/build_llms_txt.py'
+  pull_request_target:
+    types: [labeled]
+    paths:
+      - 'docs/**/*.md'
+      - 'zensical.toml'
+      - 'scripts/build_llms_txt.py'
+
+permissions:
+  contents: write
+
+jobs:
+  update-llms-txt:
+    if: |
+      github.event_name == 'push' ||
+      !github.event.pull_request.head.repo.fork ||
+      github.actor == 'koxudaxi' ||
+      (github.event_name == 'pull_request_target' && github.event.label.name == 'safe-to-fix' &&
+       github.event.sender.login == 'koxudaxi')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name != github.repository
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+      - uses: actions/checkout@v4
+        if: github.event_name == 'push' || github.event_name == 'pull_request_target' || github.event.pull_request.head.repo.full_name == github.repository
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.ref || github.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
+          token: ${{ secrets.PAT }}
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.14"
+      - name: Build llms.txt
+        run: uv run python scripts/build_llms_txt.py
+      - name: Commit and push if changed
+        if: github.event_name == 'push' || github.event_name == 'pull_request_target' || github.event.pull_request.head.repo.full_name == github.repository
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add docs/llms.txt docs/llms-full.txt
+          git diff --staged --quiet || git commit -m "docs: update llms.txt files
+
+          Generated by GitHub Actions"
+          git push

.gitignore

@@ -213,3 +213,6 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# Docs build artifacts
+docs/changelog.md

CHANGELOG.md

@@ -3,29 +3,6 @@
 All notable changes to this project are documented in this file.
 This changelog is automatically generated from GitHub Releases.
 
----
-## [0.1.1](https://github.com/koxudaxi/tstring-structured-data/releases/tag/0.1.1) - 2026-03-18
-
-## What's Changed
-* build(deps): bump actions/download-artifact from 4 to 8 by @dependabot[bot] in https://github.com/koxudaxi/tstring-structured-data/pull/2
-* Add documentation site with Zensical and Cloudflare Pages by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/13
-* feat: add Rust backend check and format APIs by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/12
-* Align release workflows with datamodel-code-generator by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/14
-* Limit release draft analysis input context by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/15
-* Pin Claude base action to existing release by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/16
-* Adapt release draft to Claude base action inputs by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/17
-* Update Claude base action to current main commit by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/18
-* Restore Claude action and filter bot comments by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/19
-* Align release draft workflow with datamodel-code-generator by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/20
-* Lockstep versioning by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/21
-* Allow dirty tree in Rust release workflow by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/22
-* Run Python publish automatically on release tags by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/23
-
-## New Contributors
-* @dependabot[bot] made their first contribution in https://github.com/koxudaxi/tstring-structured-data/pull/2
-
-**Full Changelog**: https://github.com/koxudaxi/tstring-structured-data/compare/0.1.0...0.1.1
-
 ---
 
 ## [0.1.1](https://github.com/koxudaxi/tstring-structured-data/releases/tag/0.1.1) - 2026-03-18
@@ -43,6 +20,7 @@ This changelog is automatically generated from GitHub Releases.
 * Align release draft workflow with datamodel-code-generator by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/20
 * Lockstep versioning by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/21
 * Allow dirty tree in Rust release workflow by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/22
+* Run Python publish automatically on release tags by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/23
 
 ## New Contributors
 * @dependabot[bot] made their first contribution in https://github.com/koxudaxi/tstring-structured-data/pull/2
@@ -51,49 +29,6 @@ This changelog is automatically generated from GitHub Releases.
 
 ---
 
-## [0.1.1](https://github.com/koxudaxi/tstring-structured-data/releases/tag/0.1.1) - 2026-03-18
-
-## What's Changed
-* build(deps): bump actions/download-artifact from 4 to 8 by @dependabot[bot] in https://github.com/koxudaxi/tstring-structured-data/pull/2
-* Add documentation site with Zensical and Cloudflare Pages by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/13
-* feat: add Rust backend check and format APIs by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/12
-* Align release workflows with datamodel-code-generator by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/14
-* Limit release draft analysis input context by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/15
-* Pin Claude base action to existing release by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/16
-* Adapt release draft to Claude base action inputs by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/17
-* Update Claude base action to current main commit by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/18
-* Restore Claude action and filter bot comments by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/19
-* Align release draft workflow with datamodel-code-generator by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/20
-* Lockstep versioning by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/21
-
-## New Contributors
-* @dependabot[bot] made their first contribution in https://github.com/koxudaxi/tstring-structured-data/pull/2
-
-**Full Changelog**: https://github.com/koxudaxi/tstring-structured-data/compare/0.1.0...0.1.1
-
----
-
-## [0.1.1](https://github.com/koxudaxi/tstring-structured-data/releases/tag/0.1.1) - 2026-03-18
-
-## What's Changed
-* build(deps): bump actions/download-artifact from 4 to 8 by @dependabot[bot] in https://github.com/koxudaxi/tstring-structured-data/pull/2
-* Add documentation site with Zensical and Cloudflare Pages by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/13
-* feat: add Rust backend check and format APIs by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/12
-* Align release workflows with datamodel-code-generator by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/14
-* Limit release draft analysis input context by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/15
-* Pin Claude base action to existing release by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/16
-* Adapt release draft to Claude base action inputs by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/17
-* Update Claude base action to current main commit by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/18
-* Restore Claude action and filter bot comments by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/19
-* Align release draft workflow with datamodel-code-generator by @koxudaxi in https://github.com/koxudaxi/tstring-structured-data/pull/20
-
-## New Contributors
-* @dependabot[bot] made their first contribution in https://github.com/koxudaxi/tstring-structured-data/pull/2
-
-**Full Changelog**: https://github.com/koxudaxi/tstring-structured-data/compare/0.1.0...0.1.1
-
----
-
 ## [0.1.0](https://github.com/koxudaxi/tstring-structured-data/releases/tag/0.1.0) - 2026-03-18
 
 <!--