From 2951d9bf970cb29a8a765dc5e867c5c19d4d4d2b Mon Sep 17 00:00:00 2001 From: Benson Date: Mon, 16 Mar 2026 15:40:26 +0700 Subject: [PATCH 1/3] fix(ci): collapse template literals to fix YAML block scalar parse error Multi-line JS template literals in the `script: |` block contained content at column 0 (e.g. `
`, plain prose), which fell below the 12-space YAML block scalar indentation threshold and terminated the script block early. GitHub could not parse the workflow file, causing every docs workflow run to fail immediately since 2026-02-25. Fix: collapse `linkCheckSection` and `body` template literals to single-line strings with explicit `\n` escapes so all content stays within the YAML block scalar's indentation level. Co-Authored-By: Claude Sonnet 4.6 --- .github/workflows/docs.yml | 27 ++------------------------- 1 file changed, 2 insertions(+), 25 deletions(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 67119a61..870841cc 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -120,33 +120,10 @@ jobs: if (lycheeReport) { const hasErrors = lycheeExitCode !== '0'; const statusEmoji = hasErrors ? '⚠️' : '✅'; - linkCheckSection = ` - -## ${statusEmoji} Link Check Results - -
-Click to expand link check report - -${lycheeReport} - -
-`; + linkCheckSection = `\n\n## ${statusEmoji} Link Check Results\n\n
\nClick to expand link check report\n\n${lycheeReport}\n\n
\n`; } - const body = `## 📚 Documentation Preview - -The documentation has been built successfully. - -**To preview locally:** -1. Download the \`github-pages\` artifact from [this workflow run](${artifactUrl}) -2. Extract and serve with any static file server: - \`\`\`bash - cd artifact && python -m http.server 8000 - \`\`\` -3. Open http://localhost:8000/deepcitation/ -${linkCheckSection} ---- -*Workflow run: ${runId}*`; + const body = `## 📚 Documentation Preview\n\nThe documentation has been built successfully.\n\n**To preview locally:**\n1. Download the \`github-pages\` artifact from [this workflow run](${artifactUrl})\n2. Extract and serve with any static file server:\n \`\`\`bash\n cd artifact && python -m http.server 8000\n \`\`\`\n3. Open http://localhost:8000/deepcitation/\n${linkCheckSection}\n---\n*Workflow run: ${runId}*`; // Find existing comment const { data: comments } = await github.rest.issues.listComments({ From 261dd609fc63c4715fe675301da277e74b24f0dc Mon Sep 17 00:00:00 2001 From: Benson Date: Mon, 16 Mar 2026 15:48:26 +0700 Subject: [PATCH 2/3] fix(ci): bump upload-pages-artifact to v4.0.0 to fix SHA-pinning policy v3.0.1 (56afc609) internally called actions/upload-artifact@v4 (tag-only), violating the repo's "all actions must be pinned to full SHA" enforcement. v4.0.0 (7b1f4a76) pins its internal upload-artifact call to the full commit SHA, satisfying the policy. Co-Authored-By: Claude Sonnet 4.6 --- .github/workflows/docs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 870841cc..e7ca1a6f 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -67,7 +67,7 @@ jobs: if-no-files-found: ignore - name: Upload artifact - uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1 + uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4.0.0 with: path: docs/_site From 41b9bd68cd918ad8aaa985536a98d8db9acc4f12 Mon Sep 17 00:00:00 2001 From: Benson Date: Mon, 16 Mar 2026 15:52:05 +0700 Subject: [PATCH 3/3] chore: style update for branding --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 913d6068..a0a672fa 100644 --- a/README.md +++ b/README.md @@ -12,9 +12,9 @@ Show proof for every AI citation.
[![CI](https://github.com/DeepCitation/deepcitation/actions/workflows/ci.yml/badge.svg)](https://github.com/DeepCitation/deepcitation/actions/workflows/ci.yml) -[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -[![Zero Dependencies](https://img.shields.io/badge/Zero%20Dependencies-trusted-green)](https://www.npmjs.com/package/deepcitation) -[![~17KB](https://img.shields.io/badge/gzip-~17KB-brightgreen)](https://bundlephobia.com/package/deepcitation) +[![License: MIT](https://img.shields.io/badge/License-MIT-005595?style=flat-square)](https://opensource.org/licenses/MIT) +[![Zero Dependencies](https://img.shields.io/badge/Zero%20Dependencies-trusted-10b981?style=flat-square)](https://www.npmjs.com/package/deepcitation) +[![~17KB](https://img.shields.io/badge/gzip-~17KB-10b981?style=flat-square)](https://bundlephobia.com/package/deepcitation)