Skip to content

feat(flows): a Flows section beside Projects, generated from flowverse - #8

Merged
futrime merged 7 commits into
mainfrom
claude/flows-section
Oct 5, 2026
Merged

futrime merged 7 commits into
mainfrom
claude/flows-section

Conversation

@futrime

@futrime futrime commented Oct 5, 2026 •

Copy link
Copy Markdown
Member

Summary

Adds a Flows section to humanfia.ai at /flows/, with a nav dropdown right of Projects. It replaces the flow pages in the humanize docs, which humanfia/humanize#222 redirects here under the same slugs.

  • Pages. All 14 slugs that humanize#222 redirects to have a page: chat, ralph-loop, stateful-ralph, continue-loop, goal, flame-chase, ralph-loop-agent-cleanup, flame-chase-agent-cleanup, rlar, humanize1, aot, parallel-flame-chase, parallel-flame-chase-git-pr, recursive-lean-prover. A new page covers fixed-interrupt-flame-chase. /flows without the slash reaches the catalogue: GitHub Pages redirects a directory to its slash, and VitePress's router does the same.
  • Roles and -a/-e. Every page has a roles table (Role | What it is | How it is filled), and every table includes the workspace environment role. A note under each table says that each agent role takes -a role=CLI[@PROVIDER]/MODEL[:EFFORT]. It also says no -e is given: workspace is a local environment and an -e naming it is refused. humanize1 has one table per phase.
  • Humanize 1. /flows/humanize1 is now where Humanize 1's story lives: the PolyArch plugin, RLCR, what became of it, then the gen-idea, gen-plan and rlcr phases.
  • Generated from the flowverse. .vitepress/flowverse.mts reads humanfia/flowverse and each flow repo's metadata and README at its pinned commit, once per build. If the network fails or the API rate-limits, the whole build falls back to the committed flowverse.snapshot.json; FLOWVERSE=offline forces that. pnpm flowverse refreshes the snapshot. A released module with no hand-written page gets /flows/<slug> built from its README. Relative links, titled links, reference links and raw-HTML links are rewritten to the repo; code is left as written; the README is wrapped in v-pre. Manifests are parsed with yaml. CI passes GITHUB_TOKEN to the build.
  • Animations. The flow player and grammar are ported from the humanize docs and restyled in the constructivist brand: drifting planes, ruled wires, slow comets with a ripple, and a softer camera. Every colour comes from a CSS var, so light and dark flip live. Reduced motion shows a still frame. <FlowsHero> heads the catalogue. Lane names now sit over a wider shade, so they stay clear of the turns behind them.
  • Code sample. The chat sample uses the new API: spawn() takes no env, and run(..., env=None).
  • Other changes. docs-links.mjs no longer has a flows section. The Humanize project page's catalogue card now links to /flows/. In config.mts only the Flows nav dropdown, its comment and the /flows/ sidebar changed.

Test plan

  • pnpm build, pnpm check:anchors, pnpm check:feed, pnpm check:docs
  • FLOWVERSE=offline pnpm build
  • Built a generated README page by temporarily hiding a hand-written one. Its relative links, including one with inline code in the link text, resolve, and the build has no dead links.
  • Playwright against pnpm preview: /flows/, ralph-loop, rlar, humanize1, fixed-interrupt-flame-chase and the open Flows dropdown, in light and dark, at 1440px and 375px, with no page errors. A bare /flows lands on /flows/.

🤖 Generated with Claude Code

@futrime
futrime marked this pull request as ready for review October 5, 2026 10:11
Copilot AI balanced review requested due to automatic review settings October 5, 2026 10:11

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

futrime and others added 7 commits October 5, 2026 19:16
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ze 1 its story

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…verse snapshot

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ows.html for /flows/

A bare /flows already reaches the catalogue: GitHub Pages redirects a directory to its slash,
and VitePress's router does the same in the preview.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…utline's numbers apart

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…anifests with a YAML parser

A generated page now rewrites titled, reference-style and raw-HTML links, leaves code as it was
written, and is wrapped in v-pre instead of escaping {{. flow.yaml is parsed with yaml, so a
dependency on an owned module is no longer dropped.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@futrime
futrime force-pushed the claude/flows-section branch from 5220379 to 77d6d37 Compare October 5, 2026 11:17
@futrime
futrime requested a review from Lyken17 as a code owner October 5, 2026 11:17
@futrime
futrime merged commit b2e9065 into main Oct 5, 2026
7 checks passed
@futrime
futrime deleted the claude/flows-section branch October 5, 2026 11:18
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.

2 participants