fix(open-tasks): gather issues from all Flipper One repos by stuartmhannon · Pull Request #402 · flipperdevices/flipperone-docs

stuartmhannon · 2026-07-08T14:57:24Z

Summary

Fixes #371. The generate_open_tasks.py script was silently dropping issues from repos not hardcoded in the SECTIONS list. The _build_template_sections function used by_repo.get(section["slug"], []) which only matched a single repo name — any help-wanted issue from repos outside the original 7-entry SECTIONS list was fetched by the org-wide gh search issues call but then discarded during rendering.

Investigation findings

The original --limit 200 was not the problem — only 18 total "help wanted" issues exist across the entire flipperdevices org. The real issue was that SECTIONS was missing multiple repos:

flipper-linux-kernel had a help-wanted issue (Pull request for Flipper One Docs #6) that was being fetched by gh search but then silently dropped during rendering because it wasnt in SECTIONS
Several Linux build ecosystem repos (u-boot, rkbin, rockchip-linux, bsb-protobuf) were completely absent
FlipCTL (flipctl, flipctl-fonts) had no section at all
flipperone-debug-probe was a completely missing Flipper One sub-project

Changes

Repository coverage added

Hardware: added flipperdevices/flipperone-debug-probe (debug probe for Flipper One based on RP2350)
Linux (CPU Software): extended from 1 repo to 6 — added flipper-linux-kernel, u-boot, rkbin, rockchip-linux, and bsb-protobuf
FlipCTL: new section covering flipctl and flipctl-fonts

Code changes

slug field: changed from str to list[str] for all sections to support multi-repo sections
_match_section_slug(): new helper that correctly matches a repo name against a section slug (single or list)
_build_template_sections(): fixed to iterate all fetched repos and use _match_section_slug for matching instead of the original by_repo.get(slug, [])
--limit: bumped from 200 to 1000 for future-proofing
HTML escaping: replaced manual char-by-char escaping with stdlib html.escape()

What was NOT changed

Kept the gh search issues approach (single call, works correctly, supports commentsCount natively)
Did NOT switch to per-repo gh issue list (which has a different field name for comment counts: comments returns an array, not a count)

Testing

Verified against a live snapshot of all 18 open help-wanted issues across the org
Confirmed flipper-linux-kernel#6 now appears under Linux (CPU Software) — previously silently dropped
All 3 existing unit tests pass
Generated output renders all 8 sections correctly (including sections with "no open tasks")

Closes #371

…ices#371) Extend SECTIONS to cover all Flipper One repositories listed on the flipperdevices GitHub org page: - Linux (CPU Software): add flipper-linux-kernel, u-boot, rkbin, rockchip-linux, and bsb-protobuf alongside the existing flipperone-linux-build-scripts. These repos are part of the Linux build ecosystem (kernel, bootloader, firmware blobs, protobuf definitions). - FlipCTL: add a new section covering flipctl and flipctl-fonts, as requested in the issue. To support multiple repos per section, change the slug field from str to a list of strings and add a _match_section_slug helper. Also bump --limit from 200 to 1000 to future-proof against growth in the number of help-wanted issues across the org. Tested: script runs successfully with --input-json against a live snapshot of 18 open help-wanted issues. The flipper-linux-kernel issue flipperdevices#6 now correctly appears under the Linux section where it was previously silently dropped.

NickVolynkin · 2026-07-09T08:40:16Z

Hi @stuartmhannon, thank you for the contribution! I've just merged PR #396, which searches for open PRs for each task. It could interfere with adding extra repos, so could you please rebase your branch?

I've launched CI; all looks fine except the DCO check — please note. I'll return and review this PR and #403 later today.

NickVolynkin · 2026-07-09T08:50:02Z

 SECTIONS: list[_Section] = [
    {
-        "slug": "flipperdevices/flipperone-hardware",
+        "slug": [


Let's rename it so it better reflects the content. slugs or even repos

NickVolynkin · 2026-07-09T08:51:52Z

+        "slug": ["flipperdevices/flipctl", "flipperdevices/flipctl-fonts"],
+        "title": "FlipCTL",
+        "emoji": "🎛️",
+        "description": "Command-line tool and companion fonts for managing and configuring Flipper One.",


Not quite. FlipCTL is a UI framework for building Flipper-native applications.

Suggested change

"description": "Command-line tool and companion fonts for managing and configuring Flipper One.",

"description": "UI framework for embedded Linux systems"

NickVolynkin · 2026-07-09T08:53:53Z

+        "task_tracker": "https://github.com/orgs/flipperdevices/projects/12",
+        "contribution_guide": "https://docs.flipper.net/one/user-interface/about#how-to-contribute",


Suggested change

"task_tracker": "https://github.com/orgs/flipperdevices/projects/12",

"contribution_guide": "https://docs.flipper.net/one/user-interface/about#how-to-contribute",

"task_tracker": "TBD",

"contribution_guide": "https://blog.flipper.net/flipctl-our-gui-framework-for-embedded-linux-systems/#how-you-can-join",

NickVolynkin · 2026-07-09T08:54:28Z


 class _Section(TypedDict):
-    slug: str
+    slug: str | list[str]


I think you've replaced them all with lists, so there is no need for plain str here

NickVolynkin · 2026-07-09T08:55:27Z

-            .replace(">", "&gt;")
-            .replace('"', "&quot;")
-    )
+    return html.escape(text, quote=True)


This is likely a good change, but it's out of scope for this PR. Could you please extract it to another PR? A separate commit in #403 would be fine too.

NickVolynkin · 2026-07-09T08:57:51Z

    return pattern.sub("updatedAt: -", a) == pattern.sub("updatedAt: -", b)


+def _match_section_slug(slug: str | list[str], repo_full: str) -> bool:


We have full control over the project data, so there's no real need to add this str | list[str] flexibility. Let's leave just list[str]. And rename slug, repo_full to repos, repo.

NickVolynkin · 2026-07-09T09:02:01Z

            "--label", LABEL,
            "--state", "open",
-            "--limit", "200",
+            "--limit", "1000",


I think it's some AI leftover. In the PR description, it says

The original --limit 200 was not the problem — only 18 total "help wanted" issues exist across the entire flipperdevices org. The real issue was that SECTIONS was missing multiple repos:

which also looks like AI's reply to an iteration of debugging.

Your contribution is reviewed by humans. Please read and check the PR yourself, even when you use AI.

NickVolynkin · 2026-07-09T09:29:26Z

+            "flipperdevices/flipper-linux-kernel",
+            "flipperdevices/u-boot",
+            "flipperdevices/rkbin",
+            "flipperdevices/rockchip-linux",


Mirror repository that can't have issues or PRs. Let's remove it.

Suggested change

"flipperdevices/rockchip-linux",

NickVolynkin · 2026-07-09T11:19:19Z

+            "flipperdevices/u-boot",
+            "flipperdevices/rkbin",
+            "flipperdevices/rockchip-linux",
+            "flipperdevices/bsb-protobuf",


Not a part of Flipper One development.

Suggested change

"flipperdevices/bsb-protobuf",

stuartmhannon force-pushed the fix/issue-371-open-tasks-all-repos branch from 850f4d8 to c30f31e Compare July 8, 2026 15:26

NickVolynkin self-requested a review July 9, 2026 08:40

NickVolynkin mentioned this pull request Jul 9, 2026

fix: add graceful error handling when gh CLI is missing or not authenticated #403

Open

NickVolynkin reviewed Jul 9, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix(open-tasks): gather issues from all Flipper One repos#402

fix(open-tasks): gather issues from all Flipper One repos#402
stuartmhannon wants to merge 1 commit into
flipperdevices:public-releasefrom
stuartmhannon:fix/issue-371-open-tasks-all-repos

stuartmhannon commented Jul 8, 2026 •

edited

Loading

Uh oh!

NickVolynkin commented Jul 9, 2026

Uh oh!

NickVolynkin Jul 9, 2026 •

edited

Loading

Uh oh!

NickVolynkin Jul 9, 2026

Uh oh!

NickVolynkin Jul 9, 2026

Uh oh!

NickVolynkin Jul 9, 2026

Uh oh!

NickVolynkin Jul 9, 2026 •

edited

Loading

Uh oh!

NickVolynkin Jul 9, 2026 •

edited

Loading

Uh oh!

NickVolynkin Jul 9, 2026

Uh oh!

NickVolynkin Jul 9, 2026 •

edited

Loading

Uh oh!

NickVolynkin Jul 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	"description": "Command-line tool and companion fonts for managing and configuring Flipper One.",
	"description": "UI framework for embedded Linux systems"

		"task_tracker": "https://github.com/orgs/flipperdevices/projects/12",
		"contribution_guide": "https://docs.flipper.net/one/user-interface/about#how-to-contribute",

		return pattern.sub("updatedAt: -", a) == pattern.sub("updatedAt: -", b)


		def _match_section_slug(slug: str \| list[str], repo_full: str) -> bool:

Uh oh!

Conversation

stuartmhannon commented Jul 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Investigation findings

Changes

Repository coverage added

Code changes

What was NOT changed

Testing

Uh oh!

NickVolynkin commented Jul 9, 2026

Uh oh!

NickVolynkin Jul 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

NickVolynkin Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

stuartmhannon commented Jul 8, 2026 •

edited

Loading

NickVolynkin Jul 9, 2026 •

edited

Loading

NickVolynkin Jul 9, 2026 •

edited

Loading

NickVolynkin Jul 9, 2026 •

edited

Loading

NickVolynkin Jul 9, 2026 •

edited

Loading