Skip to content

Commit b38dda4

Browse files
committed
docs: separate gsbot and hotchocolabot from fleet roster
1 parent f74e11e commit b38dda4

25 files changed

Lines changed: 94 additions & 88 deletions

EXPLAINME.adoc

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -139,9 +139,12 @@ execution testing. Gates the path from draft to publishable.
139139
| `bots/finishingbot/`
140140
|===
141141

142-
Additional bots present in `bots/`: `accessibilitybot`, `cipherbot`, `panicbot`
143-
(pre-commit gate wrapping panic-attacker), `gsbot` (game-server integration),
144-
`the-hotchocolabot` (onboarding/warmth checks).
142+
Additional fleet bots present in `bots/`: `accessibilitybot`, `cipherbot`,
143+
`panicbot` (pre-commit gate wrapping panic-attacker).
144+
145+
Standalone repos that are not part of gitbot-fleet but are still maintained in
146+
the estate: `gsbot` (https://github.com/hyperpolymath/gsbot) and
147+
`hotchocolabot` (https://github.com/hyperpolymath/hotchocolabot).
145148

146149
== Dogfooded Across The Account
147150

README.adoc

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ toc::[]
1616

1717
== Overview
1818

19-
Gitbot Fleet coordinates 11 specialised bots through a shared-context layer. The
19+
Gitbot Fleet coordinates 9 specialised bots through a shared-context layer. The
2020
`fleet-coordinator` dispatches Hypatia scanner findings to bots based on
2121
the **safety triangle**:
2222

@@ -82,21 +82,18 @@ The historical `TOPOLOGY.md` dashboard is at the repo root.
8282
|Release readiness. Placeholder removal, license validation, claim verification, execution testing.
8383
|Complete
8484

85-
|**gsbot**
86-
|Discord bot for garment sustainability. Sustainability scores, environmental impact analysis, sustainable brand discovery.
87-
|Active
88-
8985
|**panicbot**
9086
|Panic recovery and error handling validation. Ensures graceful degradation and proper error handling patterns.
9187
|Active
92-
93-
|**the-hotchocolabot**
94-
|Educational robotics platform for teaching reverse engineering and systems thinking. Over-engineered hot chocolate dispenser.
95-
|Active
9688
|===
9789

9890
*Status legend:* `Active` = Tier 1 Verifier or Specialist bot running on every push. `Complete` = Tier 2 Finisher bot that runs after verifiers to validate final release readiness.
9991

92+
Standalone repos that are intentionally not fleet bots:
93+
94+
* `gsbot` - https://github.com/hyperpolymath/gsbot
95+
* `hotchocolabot` - https://github.com/hyperpolymath/hotchocolabot
96+
10097
The component-readiness assessment (CRG grades, evidence) lives in
10198
link:READINESS.md[READINESS.md].
10299

ROADMAP.adoc

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ toc::[]
1212

1313
== Current State
1414

15-
Gitbot Fleet coordinates 11 bots through a shared-context system with safety-triangle-aware
15+
Gitbot Fleet coordinates 9 bots through a shared-context system with safety-triangle-aware
1616
routing. The fleet-coordinator dispatches findings from Hypatia scans to specialised bots
1717
based on confidence thresholds (Eliminate >= 0.95, Substitute >= 0.85, Control < 0.85).
1818

@@ -29,12 +29,15 @@ based on confidence thresholds (Eliminate >= 0.95, Substitute >= 0.85, Control <
2929
| seambot | Integration seam maintenance | Yes
3030
| finishingbot | Completion of partial work | Yes
3131
| panicbot | Security scanning (panic-attack) | No (uses panic-attack roadmap)
32-
| gsbot | Git-seo, discoverability | Yes
3332
| accessibilitybot | Accessibility compliance | Yes
3433
| cipherbot | Cryptographic hygiene | Yes
35-
| the-hotchocolabot | Developer experience, warmth | Yes
3634
|===
3735

36+
Standalone repos kept out of the fleet roster:
37+
38+
* `gsbot` - separate repo: https://github.com/hyperpolymath/gsbot
39+
* `hotchocolabot` - separate repo: https://github.com/hyperpolymath/hotchocolabot
40+
3841
**Infrastructure:**
3942

4043
* fleet-coordinator.sh -- orchestration layer

bots/gsbot/README.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -232,8 +232,8 @@ gsbot/
232232
[source,bash]
233233
----
234234
# Clone repository
235-
git clone https://github.com/hyperpolymath/gitbot-fleet.git
236-
cd gitbot-fleet/bots/gsbot
235+
git clone https://github.com/hyperpolymath/gsbot.git
236+
cd gsbot
237237
238238
# Configure environment
239239
cp .env.example .env

bots/gsbot/content/docs/DEPLOYMENT.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,8 @@ This guide covers deployment options for the Garment Sustainability Bot.
3939
### Quick Start
4040

4141
```bash
42-
git clone https://github.com/hyperpolymath/gitbot-fleet.git
43-
cd gitbot-fleet/bots/gsbot
42+
git clone https://github.com/hyperpolymath/gsbot.git
43+
cd gsbot
4444
cp .env.example .env # then edit .env: set DISCORD_TOKEN
4545
just init # build + load sample data
4646
just run # run the bot
@@ -50,8 +50,8 @@ just run # run the bot
5050

5151
1. **Clone repository:**
5252
```bash
53-
git clone https://github.com/hyperpolymath/gitbot-fleet.git
54-
cd gitbot-fleet/bots/gsbot
53+
git clone https://github.com/hyperpolymath/gsbot.git
54+
cd gsbot
5555
```
5656

5757
2. **Configure environment:**
@@ -157,8 +157,8 @@ sudo apt update && sudo apt install -y git
157157

158158
3. **Clone and build:**
159159
```bash
160-
git clone https://github.com/hyperpolymath/gitbot-fleet.git
161-
cd gitbot-fleet/bots/gsbot
160+
git clone https://github.com/hyperpolymath/gsbot.git
161+
cd gsbot
162162
cargo build --release --bin gsbot
163163
```
164164

@@ -178,9 +178,9 @@ After=network.target
178178
[Service]
179179
Type=simple
180180
User=ubuntu
181-
WorkingDirectory=/home/ubuntu/gitbot-fleet/bots/gsbot
182-
EnvironmentFile=/home/ubuntu/gitbot-fleet/bots/gsbot/.env
183-
ExecStart=/home/ubuntu/gitbot-fleet/bots/gsbot/target/release/gsbot
181+
WorkingDirectory=/home/ubuntu/gsbot
182+
EnvironmentFile=/home/ubuntu/gsbot/.env
183+
ExecStart=/home/ubuntu/gsbot/target/release/gsbot
184184
Restart=always
185185
RestartSec=10
186186
@@ -242,7 +242,7 @@ Schedule it from cron, e.g.:
242242

243243
```bash
244244
# crontab -e
245-
0 2 * * * cd /home/ubuntu/gitbot-fleet/bots/gsbot && ./target/release/gsbot-backup-db
245+
0 2 * * * cd /home/ubuntu/gsbot && ./target/release/gsbot-backup-db
246246
```
247247

248248
You can also export to JSON:
@@ -458,7 +458,7 @@ If an update fails:
458458

459459
## Support
460460

461-
- GitHub Issues: https://github.com/hyperpolymath/gitbot-fleet/issues
461+
- GitHub Issues: https://github.com/hyperpolymath/gsbot/issues
462462
- Documentation: README.adoc, CLAUDE.md
463463
- Architecture: docs/ARCHITECTURE.md
464464
- API docs: docs/API.md

bots/gsbot/docs/DEPLOYMENT.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -34,8 +34,8 @@ This guide covers deployment options for the Garment Sustainability Bot.
3434
### Quick Start
3535

3636
```bash
37-
git clone https://github.com/hyperpolymath/gitbot-fleet.git
38-
cd gitbot-fleet/bots/gsbot
37+
git clone https://github.com/hyperpolymath/gsbot.git
38+
cd gsbot
3939
cp .env.example .env # then edit .env: set DISCORD_TOKEN
4040
just init # build + load sample data
4141
just run # run the bot
@@ -45,8 +45,8 @@ just run # run the bot
4545

4646
1. **Clone repository:**
4747
```bash
48-
git clone https://github.com/hyperpolymath/gitbot-fleet.git
49-
cd gitbot-fleet/bots/gsbot
48+
git clone https://github.com/hyperpolymath/gsbot.git
49+
cd gsbot
5050
```
5151

5252
2. **Configure environment:**
@@ -152,8 +152,8 @@ sudo apt update && sudo apt install -y git
152152

153153
3. **Clone and build:**
154154
```bash
155-
git clone https://github.com/hyperpolymath/gitbot-fleet.git
156-
cd gitbot-fleet/bots/gsbot
155+
git clone https://github.com/hyperpolymath/gsbot.git
156+
cd gsbot
157157
cargo build --release --bin gsbot
158158
```
159159

@@ -173,9 +173,9 @@ After=network.target
173173
[Service]
174174
Type=simple
175175
User=ubuntu
176-
WorkingDirectory=/home/ubuntu/gitbot-fleet/bots/gsbot
177-
EnvironmentFile=/home/ubuntu/gitbot-fleet/bots/gsbot/.env
178-
ExecStart=/home/ubuntu/gitbot-fleet/bots/gsbot/target/release/gsbot
176+
WorkingDirectory=/home/ubuntu/gsbot
177+
EnvironmentFile=/home/ubuntu/gsbot/.env
178+
ExecStart=/home/ubuntu/gsbot/target/release/gsbot
179179
Restart=always
180180
RestartSec=10
181181
@@ -237,7 +237,7 @@ Schedule it from cron, e.g.:
237237

238238
```bash
239239
# crontab -e
240-
0 2 * * * cd /home/ubuntu/gitbot-fleet/bots/gsbot && ./target/release/gsbot-backup-db
240+
0 2 * * * cd /home/ubuntu/gsbot && ./target/release/gsbot-backup-db
241241
```
242242

243243
You can also export to JSON:
@@ -453,7 +453,7 @@ If an update fails:
453453

454454
## Support
455455

456-
- GitHub Issues: https://github.com/hyperpolymath/gitbot-fleet/issues
456+
- GitHub Issues: https://github.com/hyperpolymath/gsbot/issues
457457
- Documentation: README.adoc, CLAUDE.md
458458
- Architecture: docs/ARCHITECTURE.md
459459
- API docs: docs/API.md

bots/the-hotchocolabot/CLAUDE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22

33
## Project Overview
44

5-
**the-hotchocolabot** is a bot project designed to automate tasks and provide interactive functionality.
5+
**hotchocolabot** is a bot project designed to automate tasks and provide interactive functionality.
66

77
## Project Structure
88

99
This is a new project. The typical structure will include:
1010

1111
```
12-
the-hotchocolabot/
12+
hotchocolabot/
1313
├── src/ # Source code
1414
├── tests/ # Test files
1515
├── config/ # Configuration files
@@ -92,7 +92,7 @@ Install dependencies according to the package manager used in the project.
9292
## Resources
9393

9494
### Useful Links
95-
- Project repository: https://github.com/Hyperpolymath/the-hotchocolabot
95+
- Project repository: https://github.com/Hyperpolymath/hotchocolabot
9696
- Add links to relevant documentation, APIs, or frameworks
9797

9898
### Documentation

bots/the-hotchocolabot/Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ edition = "2021"
55
authors = ["UAL Creative Communities - MechCC"]
66
description = "Educational robotics platform teaching reverse engineering through an over-engineered hot chocolate dispenser"
77
license = "MPL-2.0"
8-
repository = "https://github.com/Hyperpolymath/the-hotchocolabot"
8+
repository = "https://github.com/Hyperpolymath/hotchocolabot"
99
readme = "README.md"
1010
keywords = ["robotics", "education", "embedded", "raspberry-pi"]
1111
categories = ["embedded", "hardware-support"]

bots/the-hotchocolabot/HANDOVER.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -231,7 +231,7 @@ All printable as PDF packets (~15-20 pages per student).
231231
## Repository Structure
232232

233233
```
234-
the-hotchocolabot/
234+
hotchocolabot/
235235
├── .github/
236236
│ ├── workflows/ # CI/CD automation
237237
│ │ ├── rust_ci.yml # Test, lint, audit, cross-compile
@@ -287,8 +287,8 @@ the-hotchocolabot/
287287

288288
```bash
289289
# Clone repository
290-
git clone https://github.com/Hyperpolymath/the-hotchocolabot.git
291-
cd the-hotchocolabot
290+
git clone https://github.com/Hyperpolymath/hotchocolabot.git
291+
cd hotchocolabot
292292

293293
# Install Rust (if needed)
294294
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
@@ -320,7 +320,7 @@ just deploy HOST=pi@raspberrypi.local
320320

321321
# Or build directly on Pi
322322
ssh pi@raspberrypi.local
323-
cd ~/the-hotchocolabot
323+
cd ~/hotchocolabot
324324
cargo build --release
325325
sudo ./target/release/hotchocolabot
326326
```
@@ -582,9 +582,9 @@ These questions from the original handover should be addressed:
582582
## Contact & Support
583583

584584
### Repository
585-
- GitHub: https://github.com/Hyperpolymath/the-hotchocolabot
586-
- Issues: https://github.com/Hyperpolymath/the-hotchocolabot/issues
587-
- Discussions: https://github.com/Hyperpolymath/the-hotchocolabot/discussions
585+
- GitHub: https://github.com/Hyperpolymath/hotchocolabot
586+
- Issues: https://github.com/Hyperpolymath/hotchocolabot/issues
587+
- Discussions: https://github.com/Hyperpolymath/hotchocolabot/discussions
588588

589589
### Team
590590
- Lead: [Your name] (see MAINTAINERS.md)

bots/the-hotchocolabot/MAINTAINERS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -123,8 +123,8 @@ _None yet - project is new!_
123123

124124
### For General Questions
125125

126-
- **GitHub Issues**: https://github.com/Hyperpolymath/the-hotchocolabot/issues
127-
- **Discussions**: https://github.com/Hyperpolymath/the-hotchocolabot/discussions
126+
- **GitHub Issues**: https://github.com/Hyperpolymath/hotchocolabot/issues
127+
- **Discussions**: https://github.com/Hyperpolymath/hotchocolabot/discussions
128128

129129
### For Private Matters
130130

0 commit comments

Comments
 (0)