Skip to content

Commit bef49d9

Browse files
initcronclaude
andcommitted
fix: Update release process with correct repo and docs URLs
- Fix install.sh repo name (agenticopsorg -> agenticdevops) - Update all URLs from aof.sh to docs.aof.sh - Add release process documentation to CLAUDE.md - Update RELEASE_PROCESS.md with correct URLs - Sync install scripts between scripts/ and docusaurus-site/static/ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 4e55329 commit bef49d9

6 files changed

Lines changed: 78 additions & 45 deletions

File tree

.github/workflows/release.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ jobs:
122122
### Using install script (recommended)
123123
124124
\`\`\`bash
125-
curl -sSL https://aof.sh/install.sh | bash
125+
curl -sSL https://docs.aof.sh/install.sh | bash
126126
\`\`\`
127127
128128
### Manual download
@@ -154,7 +154,7 @@ jobs:
154154
aofctl api-resources
155155
\`\`\`
156156
157-
Check out the [documentation](https://aof.sh) to get started!
157+
Check out the [documentation](https://docs.aof.sh) to get started!
158158
EOF
159159
160160
- name: Create Release
@@ -179,7 +179,7 @@ jobs:
179179

180180
- name: Deploy install script
181181
run: |
182-
echo "Install script would be deployed to: https://aof.sh/install.sh"
182+
echo "Install script would be deployed to: https://docs.aof.sh/install.sh"
183183
echo "Location: scripts/install.sh"
184184
echo ""
185185
echo "Steps to configure:"

CLAUDE.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,47 @@ aof-core = { path = "../../aof/aof/crates/aof-core" }
3232
aof-llm = { path = "../../aof/aof/crates/aof-llm" }
3333
```
3434

35+
## Release Process
36+
37+
**Documentation**: https://docs.aof.sh
38+
**Installation**: `curl -sSL https://docs.aof.sh/install.sh | bash`
39+
40+
### Creating a Release (Automated)
41+
42+
The release process is fully automated via GitHub Actions. **DO NOT create releases manually.**
43+
44+
```bash
45+
# 1. Create and push a version tag (triggers automated build)
46+
git tag -a v0.1.14 -m "Release v0.1.14: Brief description"
47+
git push origin v0.1.14
48+
49+
# 2. Monitor: https://github.com/agenticdevops/aof/actions
50+
# 3. Verify: https://github.com/agenticdevops/aof/releases
51+
```
52+
53+
The workflow will automatically:
54+
- Build binaries for Linux, macOS (Intel & Apple Silicon), Windows
55+
- Calculate SHA256 checksums
56+
- Create GitHub Release with formatted release notes
57+
- Include installation instructions
58+
59+
### Release Notes Format (Auto-generated)
60+
61+
The workflow creates consistent release notes with:
62+
- Installation instructions (curl | bash)
63+
- Manual download links
64+
- Checksum verification commands
65+
- Getting started guide
66+
67+
### Version Numbering
68+
69+
Use semantic versioning: `vMAJOR.MINOR.PATCH`
70+
- MAJOR: Breaking changes
71+
- MINOR: New features (backward compatible)
72+
- PATCH: Bug fixes
73+
74+
**Full details**: See `RELEASE_PROCESS.md`
75+
3576
---
3677

3778
# Claude Code Configuration - SPARC Development Environment

RELEASE_PROCESS.md

Lines changed: 24 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# AOF Release Process
22

3-
This document outlines how to build, test, and publish AOF binaries to make them available via the installation script at https://aof.sh/install.sh
3+
This document outlines how to build, test, and publish AOF binaries to make them available via the installation script at https://docs.aof.sh/install.sh
44

55
## Overview
66

@@ -13,7 +13,7 @@ The release process is fully automated via GitHub Actions. When you create a git
1313

1414
## Prerequisites
1515

16-
- Git with push access to https://github.com/agenticopsorg/aof
16+
- Git with push access to https://github.com/agenticdevops/aof
1717
- Rust toolchain installed locally (for testing builds)
1818
- GitHub Actions enabled on the repository
1919

@@ -54,14 +54,14 @@ This triggers the GitHub Actions workflow automatically.
5454

5555
### Step 4: Monitor the Build
5656

57-
1. Go to: https://github.com/agenticopsorg/aof/actions
57+
1. Go to: https://github.com/agenticdevops/aof/actions
5858
2. Watch the "Build and Release Binaries" workflow
5959
3. Wait for all platforms to build successfully
6060
4. The workflow will create a GitHub Release with all binaries
6161

6262
### Step 5: Verify the Release
6363

64-
Once complete, verify at: https://github.com/agenticopsorg/aof/releases
64+
Once complete, verify at: https://github.com/agenticdevops/aof/releases
6565

6666
You should see:
6767
- Binaries for each platform (linux-x86_64, macos-x86_64, etc.)
@@ -70,24 +70,17 @@ You should see:
7070

7171
### Step 6: Deploy install.sh
7272

73-
The install script needs to be accessible at https://aof.sh/install.sh
73+
The install script is served from the Docusaurus site at https://docs.aof.sh/install.sh
7474

75-
#### Option A: GitHub Pages (Simple)
75+
The install script is automatically deployed with the Docusaurus site:
7676

77-
1. Create a `gh-pages` branch
78-
2. Push the install script there
79-
3. Configure GitHub Pages to serve from `/scripts/install.sh`
80-
81-
#### Option B: Dedicated Web Server (Recommended)
82-
83-
1. Copy `scripts/install.sh` to your web server
84-
2. Make it accessible at `https://aof.sh/install.sh`
85-
3. Ensure proper HTTPS and CORS headers
86-
87-
#### Option C: GitHub Raw Content
77+
1. The script lives in `docusaurus-site/static/install.sh`
78+
2. GitHub Actions deploys it to GitHub Pages (docs.aof.sh)
79+
3. It's accessible at `https://docs.aof.sh/install.sh`
8880

81+
**Alternative (GitHub Raw Content):**
8982
```
90-
https://raw.githubusercontent.com/agenticopsorg/aof/main/scripts/install.sh
83+
https://raw.githubusercontent.com/agenticdevops/aof/main/scripts/install.sh
9184
```
9285

9386
## Testing the Installation
@@ -96,16 +89,16 @@ After releasing, test the installation script:
9689

9790
```bash
9891
# Test with latest version
99-
curl -sSL https://aof.sh/install.sh | bash
92+
curl -sSL https://docs.aof.sh/install.sh | bash
10093

10194
# Test with specific version
102-
curl -sSL https://aof.sh/install.sh | bash -s -- --version v0.2.0
95+
curl -sSL https://docs.aof.sh/install.sh | bash -s -- --version v0.2.0
10396

10497
# Test with custom install directory
105-
curl -sSL https://aof.sh/install.sh | bash -s -- --install-dir /usr/local/bin
98+
curl -sSL https://docs.aof.sh/install.sh | bash -s -- --install-dir /usr/local/bin
10699

107100
# Verbose output for debugging
108-
curl -sSL https://aof.sh/install.sh | bash -s -- --verbose
101+
curl -sSL https://docs.aof.sh/install.sh | bash -s -- --verbose
109102
```
110103

111104
## Supported Platforms
@@ -140,7 +133,7 @@ The `install.sh` script:
140133

141134
### Build fails for a platform
142135

143-
1. Check the Actions log: https://github.com/agenticopsorg/aof/actions
136+
1. Check the Actions log: https://github.com/agenticdevops/aof/actions
144137
2. Common issues:
145138
- Cross-compilation tools missing (automatic via `cross`)
146139
- Rust target not installed (automatic)
@@ -220,27 +213,26 @@ Examples:
220213
The installation script always downloads from GitHub Releases. To automatically use the latest version:
221214

222215
```bash
223-
curl -sSL https://aof.sh/install.sh | bash
216+
curl -sSL https://docs.aof.sh/install.sh | bash
224217
```
225218

226219
To pin to a specific version:
227220

228221
```bash
229-
curl -sSL https://aof.sh/install.sh | bash -s -- --version v0.1.0
222+
curl -sSL https://docs.aof.sh/install.sh | bash -s -- --version v0.1.0
230223
```
231224

232225
## Next Steps
233226

234-
1. Configure `aof.sh` to serve `scripts/install.sh` at `/install.sh`
235-
2. Create first release tag: `git tag -a v0.1.0 -m "Initial release"`
236-
3. Push tag to trigger build: `git push origin v0.1.0`
237-
4. Monitor build at: https://github.com/agenticopsorg/aof/actions
238-
5. Verify release: https://github.com/agenticopsorg/aof/releases
239-
6. Test installation
227+
1. Create release tag: `git tag -a v0.1.0 -m "Initial release"`
228+
2. Push tag to trigger build: `git push origin v0.1.0`
229+
3. Monitor build at: https://github.com/agenticdevops/aof/actions
230+
4. Verify release: https://github.com/agenticdevops/aof/releases
231+
5. Test installation: `curl -sSL https://docs.aof.sh/install.sh | bash`
240232

241233
## Support
242234

243235
For issues with the release process:
244236
1. Check GitHub Actions logs
245237
2. Review this document
246-
3. Open an issue: https://github.com/agenticopsorg/aof/issues
238+
3. Open an issue: https://github.com/agenticdevops/aof/issues

docs/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ docs/
2828

2929
### User Documentation (`/docusaurus-site/docs/`)
3030

31-
This is the **production documentation** published at https://aof.sh
31+
This is the **production documentation** published at https://docs.aof.sh
3232

3333
Contains:
3434
- **getting-started.md** - Installation and setup
@@ -79,7 +79,7 @@ GitHub Actions workflow (`/.github/workflows/deploy-docs.yml`):
7979

8080
1. **Triggers on:** Push to main/dev branches in docusaurus-site/ or docs/
8181
2. **Builds:** Docusaurus site from `/docusaurus-site/docs/`
82-
3. **Deploys:** To GitHub Pages (https://aof.sh when configured)
82+
3. **Deploys:** To GitHub Pages (https://docs.aof.sh)
8383

8484
## ✅ Best Practices
8585

docusaurus-site/static/install.sh

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
#!/bin/bash
22
# AOF Installation Script
3-
# Usage: curl -sSL https://aof.sh/install.sh | bash
4-
# or: curl -sSL https://aof.sh/install.sh | bash -s -- --version v0.1.0
3+
# Usage: curl -sSL https://docs.aof.sh/install.sh | bash
4+
# or: curl -sSL https://docs.aof.sh/install.sh | bash -s -- --version v0.1.0
55

66
set -e
77

88
# Configuration
9-
REPO="agenticopsorg/aof"
9+
REPO="agenticdevops/aof"
1010
INSTALL_DIR="${INSTALL_DIR:-/usr/local/bin}"
1111
GITHUB_RELEASE_API="https://api.github.com/repos/$REPO/releases"
1212
VERSION="${1:-latest}"
@@ -290,7 +290,7 @@ while [[ $# -gt 0 ]]; do
290290
--help)
291291
echo "AOF Installation Script"
292292
echo ""
293-
echo "Usage: curl -sSL https://aof.sh/install.sh | bash [options]"
293+
echo "Usage: curl -sSL https://docs.aof.sh/install.sh | bash [options]"
294294
echo ""
295295
echo "Options:"
296296
echo " --version VERSION Install specific version (default: latest)"

scripts/install.sh

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
#!/bin/bash
22
# AOF Installation Script
3-
# Usage: curl -sSL https://aof.sh/install.sh | bash
4-
# or: curl -sSL https://aof.sh/install.sh | bash -s -- --version v0.1.0
3+
# Usage: curl -sSL https://docs.aof.sh/install.sh | bash
4+
# or: curl -sSL https://docs.aof.sh/install.sh | bash -s -- --version v0.1.0
55

66
set -e
77

88
# Configuration
9-
REPO="agenticopsorg/aof"
9+
REPO="agenticdevops/aof"
1010
INSTALL_DIR="${INSTALL_DIR:-/usr/local/bin}"
1111
GITHUB_RELEASE_API="https://api.github.com/repos/$REPO/releases"
1212
VERSION="${1:-latest}"
@@ -290,7 +290,7 @@ while [[ $# -gt 0 ]]; do
290290
--help)
291291
echo "AOF Installation Script"
292292
echo ""
293-
echo "Usage: curl -sSL https://aof.sh/install.sh | bash [options]"
293+
echo "Usage: curl -sSL https://docs.aof.sh/install.sh | bash [options]"
294294
echo ""
295295
echo "Options:"
296296
echo " --version VERSION Install specific version (default: latest)"

0 commit comments

Comments
 (0)