chore: archive unwired scripts and fix stale doc references (#461)
* chore: archive unwired scripts and fix stale doc references - Archive momentum_tracker.py, hindsight_validation.py, init_topic_learning.py to scripts/archived/ (no workflow integration, standalone utilities) - Move associated test files to scripts/archived/ - Update distribution-strategy.md: SquadScope → Claracle branding throughout - Fix rollout-checklist.md: clarify analyze_fallback.py is local debug only, not a production fallback (pipeline is Copilot-only, fail-closed) - Processed docs (qa-report.md, learning-audit.md) already have superseded banners Closes #460 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix: exclude archived scripts from pytest and bandit scanning Archived scripts have broken imports (modules moved to archived/). Exclude: - scripts/archived/ from pytest via norecursedirs - scripts/archived/ and .ralph/ from bandit (agent infra, pre-existing findings) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix: remove runtime .squad/.watch-pids from tracking Addresses Copilot review comment — this file contains ephemeral PIDs and should not be committed. Added to .gitignore. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Juan Manuel Servera committed
Jun 13, 2026 at 20:40 UTC
6116ee94b8edca23b74fbe9e276f1a9236ec06b1
11 files changed
+25
-21
.bandit.yaml
+3
-1
@@ -8,4 +8,6 @@ exclude_dirs:
8
- site-packages
9
- node_modules
10
- __pycache__
11
- - tests
\ No newline at end of file
11
+ - tests
12
+ - scripts/archived
13
+ - .ralph
\ No newline at end of file
.gitignore
+1
@@ -35,3 +35,4 @@ squadscope-agent-result.json
35
.squad/casting-*.json
36
.ralph_tick.log
37
.squad/ralph-circuit-breaker.json
38
+.squad/.watch-pids
docs/growth/distribution-strategy.md
+19
-19
@@ -45,7 +45,7 @@ Claracle's audience spans three overlapping personas:
45
- **Signal vs. noise:** credible distinction between hype and substance
46
- **Editorial voice:** opinionated takes, not robotic summaries
47
- **Actionable context:** Why this week matters; what to watch next
48
-- **No selling:** SquadScope is analysis, not promotion of any product or company
48
+- **No selling:** Claracle is analysis, not promotion of any product or company
49
50
---
51
@@ -123,13 +123,13 @@ P.S. This is my first launch here. Let me know if I should adjust anything.
123
124
**Post 1:**
125
```
126
-🧵 New: SquadScope, a weekly digest of what's *actually* trending on GitHub.
126
+🧵 New: Claracle, a weekly digest of what's *actually* trending on GitHub.
127
128
The problem: GitHub's trending list is 40% star-farm spam (game unlockers, ROM
129
emulators, NFT tools). TechCrunch covers AI funding; developers building actual
130
infrastructure are invisible.
131
132
-SquadScope is an automated crawler + AI analysis pipeline that publishes curated
132
+Claracle is an automated crawler + AI analysis pipeline that publishes curated
133
trend reports every Monday.
134
```
135
@@ -178,14 +178,14 @@ Feedback welcome. Boosts + follows appreciated.
178
179
**Setup:** In dev.to post editor:
180
- **Canonical URL:** `https://www.claracle.com/`
181
-- **Series:** "SquadScope Weekly" (so all posts thread together)
181
+- **Series:** "Claracle Weekly" (so all posts thread together)
182
- **Tags:** `github` `trends` `opensource` `analysis`
183
184
**Draft post heading + intro:**
185
```markdown
186
-# SquadScope: Weekly Curated GitHub Trends (W22 – Supply-Chain Scanners & Agent Skills)
186
+# Claracle: Weekly Curated GitHub Trends (W22 – Supply-Chain Scanners & Agent Skills)
187
188
-Every Monday, SquadScope publishes an automated analysis of the week's most important
188
+Every Monday, Claracle publishes an automated analysis of the week's most important
189
new GitHub repositories, separated into signal and noise, with correlation to industry press.
190
191
This is the dev.to crosspost; the canonical article lives here: https://www.claracle.com/
@@ -229,7 +229,7 @@ GitHub is experiencing metric inflation via coordinated star farming"
229
230
**Step 2: Draft HN post** (5 min)
231
- Title: `Show HN: Claracle – [hook here]`
232
-- Text: ~200 words covering: problem, what SquadScope does, this week's themes, RSS link
232
+- Text: ~200 words covering: problem, what Claracle does, this week's themes, RSS link
233
- Save as `.squad/posts/2026-W22-hn.txt`
234
235
**Step 3: Thread for Mastodon** (5 min)
@@ -240,7 +240,7 @@ GitHub is experiencing metric inflation via coordinated star farming"
240
- Save as `.squad/posts/2026-W22-mastodon.md`
241
242
**Step 4: Quick Reddit/r/programming post** (5 min)
243
-- Title: Link to SquadScope headline
243
+- Title: Link to Claracle headline
244
- Body: ~100 words, ask a question or flag a pattern
245
- Example: "This week we saw coordinated star-farming at a new scale. How is your org filtering signal from noise on GitHub trending?"
246
- Save as `.squad/posts/2026-W22-reddit.txt`
@@ -278,7 +278,7 @@ GitHub is experiencing metric inflation via coordinated star farming"
278
1. **Missing `og:image` fallback for homepage**
279
- Current: Only uses `cover.image` if present; no fallback for articles without cover images
280
- Impact: Social shares show no image, reducing CTR by 40-60%
281
- - **Fix:** Generate a default SquadScope OG image (e.g., SquadScope logo + week number) and reference it in `opengraph.html` as a fallback
281
+ - **Fix:** Generate a default Claracle OG image (e.g., Claracle logo + week number) and reference it in `opengraph.html` as a fallback
282
283
2. **Missing `og:image:alt` tag**
284
- Current: No alt text for OG images
@@ -303,7 +303,7 @@ GitHub is experiencing metric inflation via coordinated star farming"
303
6. **No `article:author` tag**
304
- Current: Schema.org has author; OpenGraph does not
305
- Impact: Inconsistent social metadata
306
- - **Fix:** Add `<meta property="article:author" content="SquadScope">` in `opengraph.html` (line 30-35 area)
306
+ - **Fix:** Add `<meta property="article:author" content="Claracle">` in `opengraph.html` (line 30-35 area)
307
308
7. **Missing image width/height in OG tags**
309
- Current: `og:image` has no dimensions
@@ -333,7 +333,7 @@ GitHub is experiencing metric inflation via coordinated star farming"
333
334
{{- /* article:author tag */}}
335
{{- if .IsPage }}
336
- <meta property="article:author" content="{{ with .Params.author | default site.Params.author }}{{ . }}{{ else }}SquadScope{{ end }}">
336
+ <meta property="article:author" content="{{ with .Params.author | default site.Params.author }}{{ . }}{{ else }}Claracle{{ end }}">
337
{{- end }}
338
```
339
@@ -363,7 +363,7 @@ params:
363
twitter: "jmservera"
364
twitter_creator: "jmservera"
365
# Add a default OG image for homepage/fallback
366
- og_image: "images/squadscope-og-default.png" # 1200x630px
366
+ og_image: "images/claracle-og-default.png" # 1200x630px
367
```
368
369
### Follow-up Issue: SEO Metadata Audit Fixes
@@ -430,7 +430,7 @@ Before GA4, log weekly:
430
431
**Rationale:**
432
- **Simple:** Free tier supports up to 1,000 subscribers with unlimited emails
433
-- **Markdown-first:** Write newsletters in Markdown, same workflow as SquadScope content
433
+- **Markdown-first:** Write newsletters in Markdown, same workflow as Claracle content
434
- **GitHub integration:** Supports RSS-to-email (auto-send when new article publishes)
435
- **Minimal friction:** No fancy template builder; focus on content
436
- **Privacy-respecting:** No cross-platform ad tracking; user data stays minimal
@@ -441,8 +441,8 @@ Before GA4, log weekly:
441
2. Configure RSS-to-email trigger pointing to `https://www.claracle.com/index.xml`
442
3. Set delivery: Monday 9 AM UTC (1.5 hours after article publish)
443
4. Template: Auto-generated from RSS feed (title + excerpt + link)
444
-5. Custom intro: "New SquadScope analysis just dropped. Here's this week's trends:" + RSS excerpt
445
-6. Subscribe CTA: Add signup link to SquadScope homepage footer
444
+5. Custom intro: "New Claracle analysis just dropped. Here's this week's trends:" + RSS excerpt
445
+6. Subscribe CTA: Add signup link to Claracle homepage footer
446
447
**Alternative considered:** ConvertKit
448
- Pros: More sophisticated automation, good for building audience long-term
@@ -481,7 +481,7 @@ Before GA4, log weekly:
481
482
6. **Never include affiliate links or sponsorship plugs**
483
- Breaks trust with audience; platform ToS violations
484
- - SquadScope is pure editorial; no monetization angle
484
+ - Claracle is pure editorial; no monetization angle
485
486
7. **Avoid vanity metrics**
487
- Don't optimize for star-count or comment volume; optimize for *signal* (do comments show genuine interest?)
@@ -497,7 +497,7 @@ Before GA4, log weekly:
497
- Trend report titles should be neutral + specific: "Supply-Chain Scanners, Skills Economies, and GitHub's Star-Farm Flood" ✓ "You Won't BELIEVE What GitHub Trends Show This Week" ✗
498
499
10. **Avoid inconsistent voice**
500
- - SquadScope's editorial voice is analytical, slightly opinionated, always evidence-based
500
+ - Claracle's editorial voice is analytical, slightly opinionated, always evidence-based
501
- Social posts should reflect this tone; don't turn cheerful for Twitter or corporate for LinkedIn
502
- Consistency > optimization
503
@@ -507,7 +507,7 @@ Before GA4, log weekly:
507
508
- [ ] Distribution strategy document approved and merged (`squad/184-distribution-strategy`)
509
- [ ] SEO metadata audit issues created (routes to squad:amy)
510
-- [ ] Default OG image created (1200×630, SquadScope branding)
510
+- [ ] Default OG image created (1200×630, Claracle branding)
511
- [ ] Buttondown account set up + RSS configured
512
- [ ] First launch posts drafted in `.squad/posts/2026-W22-*`
513
- [ ] GA4 foundation in place (blocks on #182, #183)
@@ -554,4 +554,4 @@ Before GA4, log weekly:
554
4. **Month 3+ (scale):**
555
- Evaluate whether newsletter should move off Buttondown (if >1K subscribers)
556
- Explore paid distribution options (if metrics justify)
557
- - Build SquadScope brand presence on all key platforms
557
+ - Build Claracle brand presence on all key platforms
docs/rollout-checklist.md
+1
-1
@@ -115,7 +115,7 @@ Use this checklist to verify your SquadScope instance is ready for production. C
115
116
- [ ] **Manual stage execution (debug only)**
117
- [ ] Crawl: `python3 scripts/crawl.py --as-of 2026-05-18`
118
- - [ ] Analyze (fallback): `python3 scripts/analyze_fallback.py --raw-json data/raw/YYYY-WNN.json --output ./scratch-analysis.md --current-datetime 2026-05-18T16:00:00Z`
118
+ - [ ] Analyze (local debug only — not a production fallback): `python3 scripts/analyze_fallback.py --raw-json data/raw/YYYY-WNN.json --output ./scratch-analysis.md --current-datetime 2026-05-18T16:00:00Z`
119
- [ ] Gate: `python3 scripts/analysis_gate.py --analysis-file data/analyzed/YYYY-WNN-summary.md --raw-json data/raw/YYYY-WNN.json --current-datetime 2026-05-18T16:00:00Z`
120
- [ ] Generate: `python3 scripts/generate_content.py data/analyzed/YYYY-WNN-summary.md`
121
- [ ] Build search assets after Hugo: `npx pagefind --site public/`
pytest.ini
+1
@@ -1,2 +1,3 @@
1
[pytest]
2
pythonpath = .
3
+norecursedirs = scripts/archived .git __pycache__ .venv venv