From bc6e6a6d50d4e4d967aa8393b9b5bc7b6a8de0aa Mon Sep 17 00:00:00 2001
From: gabrielmoro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 21:16:39 -0300
Subject: [PATCH 1/9] update to zensical

---
 .github/workflows/documentation.yml | 16 ++++++++--------
 AGENTS.md                           |  2 +-
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index e233fc4f..1111b9d6 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -15,19 +15,19 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Configure Git Credentials
-        run: |
-          git config user.name github-actions[bot]
-          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
       - uses: actions/setup-python@v5
         with:
           python-version: 3.x
       - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
       - uses: actions/cache@v4
         with:
-          key: mkdocs-material-${{ env.cache_id }}
+          key: zensical-${{ env.cache_id }}
           path: .cache
           restore-keys: |
-            mkdocs-material-
-      - run: pip install mkdocs-material
-      - run: mkdocs gh-deploy --force
+            zensical-
+      - run: pip install zensical==0.0.46
+      - run: zensical build
+      - uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site
diff --git a/AGENTS.md b/AGENTS.md
index 21c26b73..be6a8406 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -29,7 +29,7 @@ android_kmp/
 
 ios/craftd-swiftui/     # iOS library (Swift Package + CocoaPods)
 flutter/craftd_widget/  # Flutter library (pub.dev)
-docs/                   # site documentation (MkDocs)
+docs/                   # site documentation (Zensical)
 ```
 
 Full module dependency graph → `ai/module-graph.md`

From c654808d54336e9ee6eca0041f7b74a0043ba0fd Mon Sep 17 00:00:00 2001
From: gabrielmoro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 21:20:20 -0300
Subject: [PATCH 2/9] update documentation pipeline to be triggered

---
 .github/workflows/documentation.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 1111b9d6..3afd35c4 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -8,6 +8,7 @@ on:
     paths:
       - "docs/**"
       - "mkdocs.yml"
+      - ".github/workflows/documentation.yml"
 permissions:
   contents: write
 jobs:

From ce1b09cd087b63b5d63ac14816e9acae75f826e1 Mon Sep 17 00:00:00 2001
From: gabrielmoro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 21:27:03 -0300
Subject: [PATCH 3/9] update documentation workflow

---
 .github/workflows/documentation.yml | 30 +++++++++++++----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 3afd35c4..2c54ac71 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -1,34 +1,30 @@
 name: documentation
 on:
   workflow_dispatch:
-
   pull_request:
     branches:
       - main
     paths:
       - "docs/**"
       - "mkdocs.yml"
-      - ".github/workflows/documentation.yml"
+
 permissions:
   contents: write
 jobs:
-  deploy:
+  documentation:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: 3.x
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-      - uses: actions/cache@v4
-        with:
-          key: zensical-${{ env.cache_id }}
-          path: .cache
-          restore-keys: |
-            zensical-
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5                            with:
+          python-version: 3.x                                  - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4                                   with:
+          key: zensical-${{ env.cache_id }}                        path: .cache
+          restore-keys: |                                            zensical-
       - run: pip install zensical==0.0.46
-      - run: zensical build
-      - uses: peaceiris/actions-gh-pages@v3
+      - run: zensical build                                    - uses: peaceiris/actions-gh-pages@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./site
+          github_token: ${{ secrets.GITHUB_TOKEN }}                publish_dir: ./site
\ No newline at end of file

From cb91bffe1966835811c5bad033ac321f03dd438c Mon Sep 17 00:00:00 2001
From: gabrielmoro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 21:27:50 -0300
Subject: [PATCH 4/9] update trigger

---
 .github/workflows/documentation.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 2c54ac71..f2038db8 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -7,6 +7,7 @@ on:
     paths:
       - "docs/**"
       - "mkdocs.yml"
+      - ".github/workflows/documentation.yml"
 
 permissions:
   contents: write

From b5258cb7f5584e799652519cef2b7a86bd250e2a Mon Sep 17 00:00:00 2001
From: Gabriel Bronzatti Moro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 21:29:17 -0300
Subject: [PATCH 5/9] Update documentation.yml

---
 .github/workflows/documentation.yml | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index f2038db8..d5332094 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -7,7 +7,7 @@ on:
     paths:
       - "docs/**"
       - "mkdocs.yml"
-      - ".github/workflows/documentation.yml"
+      - ".github/workflows/documentation.yml
 
 permissions:
   contents: write
@@ -20,12 +20,19 @@ jobs:
         run: |
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
-      - uses: actions/setup-python@v5                            with:
-          python-version: 3.x                                  - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-      - uses: actions/cache@v4                                   with:
-          key: zensical-${{ env.cache_id }}                        path: .cache
-          restore-keys: |                                            zensical-
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4
+        with:
+          key: zensical-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            zensical-
       - run: pip install zensical==0.0.46
-      - run: zensical build                                    - uses: peaceiris/actions-gh-pages@v3
+      - run: zensical build
+      - uses: peaceiris/actions-gh-pages@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}                publish_dir: ./site
\ No newline at end of file
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site

From fee286ea9d1b3e61f9fd00791f820ddfc051b9f8 Mon Sep 17 00:00:00 2001
From: Gabriel Bronzatti Moro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 21:31:21 -0300
Subject: [PATCH 6/9] Update documentation.yml

---
 .github/workflows/documentation.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index d5332094..5148ac39 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -7,7 +7,7 @@ on:
     paths:
       - "docs/**"
       - "mkdocs.yml"
-      - ".github/workflows/documentation.yml
+      - ".github/workflows/documentation.yml"
 
 permissions:
   contents: write

From d7adb11b3667700a2e7585479930a6a1cd95de52 Mon Sep 17 00:00:00 2001
From: Gabriel Bronzatti Moro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 22:08:30 -0300
Subject: [PATCH 7/9] Remove workflow file from paths in documentation.yml

---
 .github/workflows/documentation.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 5148ac39..5d56bc66 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -7,7 +7,6 @@ on:
     paths:
       - "docs/**"
       - "mkdocs.yml"
-      - ".github/workflows/documentation.yml"
 
 permissions:
   contents: write

From dc05bdeaf549ea0a321699080802c171b3f7dcf5 Mon Sep 17 00:00:00 2001
From: Gabriel Bronzatti Moro <gabrielbronzattimoro.es@gmail.com>
Date: Fri, 3 Jul 2026 22:10:41 -0300
Subject: [PATCH 8/9] Update documentation.yml

---
 .github/workflows/documentation.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index 5d56bc66..f9c0a2e9 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -11,7 +11,7 @@ on:
 permissions:
   contents: write
 jobs:
-  documentation:
+  deploy:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

From d72573affb1330d83906bdb9b8989d0c8733bc6d Mon Sep 17 00:00:00 2001
From: gabrielmoro <gabrielbronzattimoro.es@gmail.com>
Date: Sat, 4 Jul 2026 10:46:21 -0300
Subject: [PATCH 9/9] Add documentation.yml to workflow paths for improved
 tracking

---
 .github/workflows/documentation.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
index f9c0a2e9..1d1b9fb0 100644
--- a/.github/workflows/documentation.yml
+++ b/.github/workflows/documentation.yml
@@ -7,6 +7,7 @@ on:
     paths:
       - "docs/**"
       - "mkdocs.yml"
+      - ".github/workflows/documentation.yml"
 
 permissions:
   contents: write