Skip to content

Commit 96bbd8f

Browse files
jbellerbjbellerb
authored
Move CLI docs generator to scheduled action (#158)
1 parent 45e38c8 commit 96bbd8f

2 files changed

Lines changed: 99 additions & 90 deletions

File tree

‎.github/workflows/ci.yml‎

Lines changed: 1 addition & 90 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ on:
88
- '*.md'
99

1010
permissions:
11-
contents: write
11+
contents: read
1212
pull-requests: write
1313

1414
jobs:
@@ -39,98 +39,9 @@ jobs:
3939
- name: Lint
4040
run: pnpm lint
4141

42-
- name: Install Sprites CLI
43-
run: |
44-
curl -fsSL https://sprites.dev/install.sh | bash
45-
echo "$HOME/.local/bin" >> $GITHUB_PATH
46-
47-
- name: Setup Sprites auth
48-
run: sprite auth setup --token "$SPRITES_TEST_TOKEN"
49-
env:
50-
SPRITES_TEST_TOKEN: ${{ secrets.SPRITES_TEST_TOKEN }}
51-
52-
- name: Generate CLI Docs
53-
run: pnpm generate:cli-docs
54-
env:
55-
SKIP_CLI_TESTS: 'true'
56-
57-
- name: Commit generated CLI docs
58-
run: |
59-
git config user.name "github-actions[bot]"
60-
git config user.email "github-actions[bot]@users.noreply.github.com"
61-
git add src/content/docs/cli/commands.mdx
62-
if git diff --cached --quiet; then
63-
echo "No changes to CLI docs"
64-
else
65-
git commit -m "Update auto-generated CLI documentation"
66-
git push
67-
fi
68-
6942
- name: Build
7043
run: pnpm build
7144

72-
- name: Comment CLI Test Results on PR
73-
if: always() && github.event_name == 'pull_request'
74-
uses: actions/github-script@v7
75-
with:
76-
script: |
77-
const fs = require('fs');
78-
const path = './cli-test-report.json';
79-
80-
let body = '### CLI Documentation Generator\n\n';
81-
82-
if (!fs.existsSync(path)) {
83-
body += '⚠️ No test report found (tests may have been skipped)\n';
84-
} else {
85-
const report = JSON.parse(fs.readFileSync(path, 'utf8'));
86-
87-
const allPassed = report.testsFailed === 0;
88-
const emoji = allPassed ? '✅' : '❌';
89-
90-
body += `| Metric | Value |\n`;
91-
body += `|--------|-------|\n`;
92-
body += `| CLI Version | \`${report.cliVersion}\` |\n`;
93-
body += `| Commands Generated | ${report.commandsGenerated.length} |\n`;
94-
body += `| Tests | ${emoji} ${report.testsPassed}/${report.testsRun} passed |\n`;
95-
96-
if (report.errors.length > 0) {
97-
body += `\n<details><summary>❌ ${report.errors.length} Error(s)</summary>\n\n`;
98-
for (const error of report.errors) {
99-
body += `- **${error.command}** (${error.phase}): ${error.message}\n`;
100-
}
101-
body += `\n</details>\n`;
102-
}
103-
104-
if (report.commandsGenerated.length > 0) {
105-
body += `\n<details><summary>📚 Commands documented</summary>\n\n`;
106-
body += report.commandsGenerated.map(c => `- \`${c}\``).join('\n');
107-
body += `\n</details>\n`;
108-
}
109-
}
110-
111-
const { data: comments } = await github.rest.issues.listComments({
112-
owner: context.repo.owner,
113-
repo: context.repo.repo,
114-
issue_number: context.issue.number,
115-
});
116-
const existing = comments.find(c => c.body.includes('### CLI Documentation Generator'));
117-
118-
if (existing) {
119-
await github.rest.issues.updateComment({
120-
owner: context.repo.owner,
121-
repo: context.repo.repo,
122-
comment_id: existing.id,
123-
body,
124-
});
125-
} else {
126-
await github.rest.issues.createComment({
127-
owner: context.repo.owner,
128-
repo: context.repo.repo,
129-
issue_number: context.issue.number,
130-
body,
131-
});
132-
}
133-
13445
preview:
13546
name: Preview Deployment
13647
runs-on: ubuntu-latest

‎.github/workflows/update-cli-docs.yml‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
name: Update CLI Docs
2+
3+
on:
4+
schedule:
5+
- cron: "0 8 * * 1"
6+
workflow_dispatch:
7+
8+
permissions:
9+
contents: write
10+
pull-requests: write
11+
12+
env:
13+
BRANCH: actions/update-cli-docs
14+
15+
jobs:
16+
update-cli-docs:
17+
name: Update CLI Docs
18+
runs-on: ubuntu-latest
19+
20+
steps:
21+
- uses: actions/checkout@v4
22+
with:
23+
ref: main
24+
token: ${{ secrets.GITHUB_TOKEN }}
25+
26+
- uses: pnpm/action-setup@v4
27+
with:
28+
version: latest
29+
30+
- uses: actions/setup-node@v4
31+
with:
32+
node-version: 22
33+
cache: pnpm
34+
35+
- name: Install dependencies
36+
run: pnpm install --frozen-lockfile
37+
38+
- name: Install Sprites CLI
39+
run: |
40+
curl -fsSL https://sprites.dev/install.sh | bash
41+
echo "$HOME/.local/bin" >> $GITHUB_PATH
42+
43+
- name: Setup Sprites auth
44+
run: sprite auth setup --token "$SPRITES_TEST_TOKEN"
45+
env:
46+
SPRITES_TEST_TOKEN: ${{ secrets.SPRITES_TEST_TOKEN }}
47+
48+
- name: Generate CLI Docs
49+
run: pnpm generate:cli-docs
50+
51+
- name: Check for changes
52+
id: changes
53+
run: |
54+
if git diff --quiet src/content/docs/cli/commands.mdx
55+
then
56+
echo "changed=false" >> $GITHUB_OUTPUT
57+
echo "CLI docs are already up to date."
58+
else
59+
echo "changed=true" >> $GITHUB_OUTPUT
60+
echo "Updated CLI docs"
61+
git diff src/content/docs/cli/commands.mdx
62+
fi
63+
64+
- name: Commit and push to automated branch
65+
if: steps.changes.outputs.changed == 'true'
66+
run: |
67+
git config user.name "github-actions[bot]"
68+
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
69+
70+
git checkout -B "$BRANCH"
71+
git add src/content/docs/cli/commands.mdx
72+
git commit -m "Update auto-generated CLI documentation ($(date -u +%Y-%m-%d))"
73+
74+
git push origin "$BRANCH" --force
75+
76+
- name: Open or update PR
77+
if: steps.changes.outputs.changed == 'true'
78+
env:
79+
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
80+
run: |
81+
cat > /tmp/pr-body.md << EOF
82+
Built from $(sprite --version) on $(date -u +%Y-%m-%d)
83+
84+
> *Generated by the weekly CLI docs update workflow. This PR is automatically updated when new releases are available.*
85+
EOF
86+
87+
pr=$(gh pr list --head "$BRANCH" --state open --json number --jq '.[0].number')
88+
if test -z "$pr"
89+
then
90+
gh pr create \
91+
--title "Update auto-generated CLI documentation" \
92+
--body-file /tmp/pr-body.md \
93+
--head "$BRANCH" \
94+
--base main
95+
else
96+
gh pr edit "$pr" --body-file /tmp/pr-body.md
97+
echo "Updated existing PR #$pr"
98+
fi

0 commit comments

Comments
 (0)