Skip to content

Count GitHub downloads as live; bring Hydra tutorials 2, 5 and 7 up to the flows - #237

Merged
WilcoLouwerse merged 3 commits into
developmentfrom
docs/codeberg-legacy-downloads-and-hydra-tutorials
Sep 29, 2026
Merged

WilcoLouwerse merged 3 commits into
developmentfrom
docs/codeberg-legacy-downloads-and-hydra-tutorials

Conversation

@WilcoLouwerse

Copy link
Copy Markdown
Contributor

Summary

Two fixes for content that still reflected Hydra and the Conduction apps as they were in May 2026.

Download stats: GitHub is live, Codeberg is legacy

.github/scripts/app_downloads.py still treated Codeberg as the live source and GitHub as legacy, and preferred the Codeberg repo path per app. The move to Codeberg was reversed in 2026-07, so the roles are swapped:

  • the docstring, the section headers, the progress output and the notes field
  • repo now prefers the GitHub path
  • the comment on TOTAL_DOWNLOADS in src/data/apps-catalog.js

Codeberg release counts are still added to the total, so the StatsStrip number does not drop. The committed data/app-downloads.json fallback is updated the same way: 19 repo fields and the note change, and no counts do.

Hydra tutorials 2, 5 and 7

The supervisor daemon, orchestrate.sh, secrets/credentials.json and the Claude token pool are all retired. Dispatch is the hydra-dispatch and hydra-sequencer flows, local scripts read credentials from the environment only, and the flows reach the forge through a brokered credential id.

  • Part 5 (EN + NL) is rewritten around what exists today:

    • environment credentials
    • a secrets/.env with the required HYDRA_FORGE=github
    • one stage with dev-run.sh, or the whole chain with smoke-test.sh
    • a real run started with a label

    It also says plainly that a local run writes no run record, and why HYDRA_LABEL_PREFIX no longer matters. The quiz follows the new content.

  • Part 2 (EN + NL): the stages are queued by hydra-sequencer, and the "supervisor vs orchestrator" card now explains the two flows.

  • Part 7: the credential section, the comparison table, Model 1, two troubleshooting items and quiz question 2 now describe the brokered forge credential and the per-run owner.

The source for each statement is hydra's CLAUDE.md, the scripts/dev-run.sh and scripts/smoke-test.sh headers, and flows/hydra-forge.source.json on development.

Not in this PR

The footer, navbar and JSON-LD links to codeberg.org/Conduction come from @conduction/docusaurus-preset. They are fixed in ConductionNL/design-system#94 and reach this site with the next preset bump.

Test plan

  • Front matter of every touched MDX file parses as YAML
  • python3 -m py_compile .github/scripts/app_downloads.py
  • data/app-downloads.json round-trips byte-for-byte through the script's own json.dump(indent=2, sort_keys=True) before the edit
  • CI build (MDX compile, both locales) green

🤖 Generated with Claude Code

WilcoLouwerse and others added 3 commits September 29, 2026 11:01
… legacy

The collector still described the 2026-05 move to Codeberg: Codeberg as
the live source and GitHub as legacy, and each app's repo path preferred
the Codeberg one. The move was reversed in 2026-07, so GitHub is where
releases and new downloads happen. Swap the roles in the docstring, the
section headers, the progress output and the notes field, and prefer the
GitHub repo path. Codeberg release counts are still added to the total,
so the StatsStrip number does not drop.

The committed data/app-downloads.json fallback is updated to match.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Part 5 taught a local run through hydra-supervisor.sh, secrets/
credentials.json and logs/supervisor.log. All three are gone: the
supervisor and orchestrate.sh were replaced by the hydra-dispatch and
hydra-sequencer flows, and the local scripts read GH_TOKEN and
CLAUDE_CODE_OAUTH_TOKEN from the environment only.

Rewrite the recipe around what exists: environment credentials, a
secrets/.env with the required HYDRA_FORGE=github, one stage with
dev-run.sh, the whole chain with smoke-test.sh, and a real run started
with a label. State that a local run writes no run record, and explain
why HYDRA_LABEL_PREFIX no longer matters (the flows act on bare labels
only). The quiz follows the new content. English and Dutch.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…edentials

Part 2 said the supervisor daemon queued each next stage and explained a
supervisor/orchestrator split that no longer exists. It now names the
hydra-dispatch and hydra-sequencer flows and says the shell scripts were
retired.

Part 7 described secrets/credentials.json with per-persona git tokens and
Claude token rotation. The flows reach the forge through one brokered
source that holds only a credential id, and every run has an owner so a
personal subscription only serves its owner. The credential section,
the comparison table, Model 1, the troubleshooting items and quiz
question 2 follow that.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@WilcoLouwerse
WilcoLouwerse merged commit a94f7f1 into development Sep 29, 2026
5 checks passed
@WilcoLouwerse
WilcoLouwerse deleted the docs/codeberg-legacy-downloads-and-hydra-tutorials branch September 29, 2026 09:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant