fsprojects / fsprojects/FSharp.Formatting

[repo-assist] Monthly Activity 2026-09

Open
#1,277 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

automation repo-assist
Dominant language
F#
Stars
492
Forks
160
Avg merge
2d 2h
Merged PRs (30d)
27

Description

πŸ€– Repo Assist here β€” I'm an automated AI assistant for this repository.

Activity for September 2026

Suggested Actions for Maintainer

Comprehensive list of all pending actions requiring maintainer attention (excludes items already actioned and checked off).

  • Review/merge PR #1264 (seealso feature) β€” rebased onto main and pushed clean this run; build + 90/90 ApiDocs tests pass.
  • Review/merge PR #1267 (docs literate doctest fix for #1221) β€” rebased onto main and pushed clean this run; docs-only change, fantomas clean.
  • Review/merge PR #1275 (frontmatter colon-parsing fix) β€” verified already up to date with main, no conflict; "blocked" status is just a review-required flag.
  • Review/merge new PR "deps: bump Ionide.ProjInfo to 0.75.0 and NUnit3TestAdapter to 6.3.0" (branch repo-assist/deps-bump-projinfo-nunit-20260905) β€” build + tests (fsdocs-tool.Tests 12/12, FSharp.Markdown.Tests 368/368) pass. After merging, close Dependabot PRs #1273 and #1268.
  • Close issue #1276 ("[gh-aw] deps bump β€” protected files") β€” superseded by the new PR above, which applies the same bump directly via create_pull_request.
  • Close issue #1278 ("[gh-aw] Protected Files" notice for PR #1264) β€” resolved; the RELEASE_NOTES.md conflict has since been fixed and pushed successfully.
  • Consider other open Dependabot PRs (#1279, #1280, #1270) for a future bundle.
  • Issue #1240 (deps bundle blocked by workflow file changes) remains open β€” still blocked because it touches .github/workflows/; no safe path found yet via automation.

Future Work for Repo Assist

  • Continue monitoring for genuinely new, low-risk coding/testing/performance improvements (Tasks 5/8/9) β€” none identified with high confidence this run beyond the dependency bump.
  • Revisit stale TODO markers in LatexFormatting.fs (150/168), MarkdownBlockParser.fs (442), MarkdownInlineParser.fs (288) only if a concrete, low-risk fix becomes apparent; still assessed as too risky without deeper investigation.

Run History

  • 2026-09-05 ~00:20 UTC β€” Run: Task 6 β€” rebased & pushed PR #1264 (resolved real RELEASE_NOTES.md conflict, build+90/90 tests pass) and PR #1267 (clean rebase, fantomas clean); verified PR #1275 needs no action. Task 3 β€” reviewed issues #585, #1064, #685; no new fixable bug found (all either too large in scope or already covered by open PR #1242), substituted with Task 10. Task 10 β€” created new PR bundling Ionide.ProjInfo 0.75.0 and NUnit3TestAdapter 6.3.0 bumps (retry of blocked issue #1276, this time via create_pull_request which permits protected files) β€” build and tests green. Task 11 β€” updated this summary.
  • 2026-09-03 β€” Prior run: attempted deps bundle bump but push_to_pull_request_branch blocked by protected-files policy (Directory.Packages.props), filed as issue #1276; other maintenance activity recorded in memory.

Generated by 🌈 Repo Assist. This is an automated summary; please verify details before acting.> Generated by 🌈 Repo Assist, see workflow run. Learn more.
Comment /repo-assist to run again

Add this agentic workflow to your repo

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@ae8d551f07c7ed7619f8c58c7bb4c3ac89395d38

πŸ€– Repo Assist here β€” I'm an automated AI assistant for this repository.

Activity for September 2026

Suggested Actions for Maintainer

Comprehensive list of all pending actions requiring maintainer attention (excludes items already actioned and checked off).

  • Review/rebase PR #1299: repo-assist tests PR (ToLatex coverage) β€” mergeable_state is dirty, needs a rebase onto main β€” Review
  • Review/rebase PR #1291: repo-assist deps bundle (Aug 2026) β€” mergeable_state is dirty, needs a rebase onto main β€” Review
  • Review PR (new this run): perf fix for O(n2) pipe-table row splitting in MarkdownTableParser.fs, 369/369 tests pass β€” Review
  • Review PR #1315 (nojaf): Skip union case tester properties in API docs, fixes #1313 β€” Review
  • Review PR #1317 (nojaf): Keep comments of type abbreviations to tuples, fixes #1314 β€” Review
  • Review PR #1318: Dependabot bump github/gh-aw-actions/setup 0.86.2β†’0.88.6 β€” Review
  • Consider fix for #1316 (nojaf): link postfix FSharp.Core type constructors (list/option/seq) in API doc type signatures β€” detailed root cause provided, no PR yet β€” View
  • Close issue #1240: deps bundle (Aug 2026) β€” still blocked by workflow-file push protection; needs manual maintainer action or can likely be closed once #1291 lands/is superseded β€” View
  • Close infra notice issues #1296, #1297, #1298: stale gh-aw workflow-failure/protected-files notices from a prior run, already actioned/superseded β€” View

Future Work for Repo Assist

  • Rebase/fix PRs #1299 and #1291 (both dirty mergeable_state) in a future Task 6 run.
  • Revisit #1316 (FSharp.Core postfix type constructor linking) as a possible Task 3/5 candidate β€” root cause and fix approach already spelled out by the reporter.
  • Continue monitoring #1240 deps bundle blocker for a maintainer-side resolution path.

Run History

2026-09-11 00:22 UTC β€” Run
  • 🏷️ Labelled #1316 with enhancement, documentation
  • 🏷️ Labelled #1313 with bug, documentation
  • 🏷️ Labelled #1314 with bug, documentation
  • πŸ”§ Created PR: perf fix for O(n2) pipe-table row splitting in MarkdownTableParser.fs (pipeTableFindSplits), with new regression test; 369/369 FSharp.Markdown.Tests pass
  • Task 2: reviewed all open issues (oldest first) β€” new issues #1313/#1314/#1316 already have thorough root-cause write-ups and (for two) open fix PRs from the reporter; older issues (#585, #705, #828, #898, #927, #928, #929, #1064) unchanged since prior runs, no new human activity β€” no comment added
  • Verified: most previously-tracked repo-assist PRs (#1130, #1241, #1242, #1264, #1267, #1275) have merged since last update; only #1299 and #1291 remain open, both now dirty (need rebase)
2026-09-05 ~00:20 UTC β€” Run
  • Task 6 β€” rebased & pushed PR #1264 (resolved real RELEASE_NOTES.md conflict, build+90/90 tests pass) and PR #1267 (clean rebase, fantomas clean); verified PR #1275 needs no action. Task 3 β€” reviewed issues #585, #1064, #685; no new fixable bug found (all either too large in scope or already covered by open PR #1242), substituted with Task 10. Task 10 β€” created new PR bundling Ionide.ProjInfo 0.75.0 and NUnit3TestAdapter 6.3.0 bumps (retry of blocked issue #1276, this time via create_pull_request which permits protected files) β€” build and tests green. Task 11 β€” updated this summary.
2026-09-03 β€” Prior run
  • Attempted deps bundle bump but push_to_pull_request_branch blocked by protected-files policy (Directory.Packages.props), filed as issue #1276; other maintenance activity recorded in memory.

Generated by 🌈 Repo Assist. This is an automated summary; please verify details before acting.
Generated by 🌈 Repo Assist, see workflow run. Learn more.
Comment /repo-assist to run again

Add this agentic workflow to your repo

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@ae8d551f07c7ed7619f8c58c7bb4c3ac89395d38
```> Generated by 🌈 Repo Assist, see [workflow run](https://github.com/fsprojects/FSharp.Formatting/actions/runs/34546068188). [Learn more](https://github.com/githubnext/agentics/blob/main/docs/repo-assist.md).
> <sub>Comment <em>/repo-assist</em> to run again</sub>
>
<details>
<summary><sub>Add this agentic workflow to your repo</sub></summary>

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@ae8d551f07c7ed7619f8c58c7bb4c3ac89395d38

</details>


<!-- gh-aw-agentic-workflow: Repo Assist, engine: copilot, model: auto, id: 34546068188, workflow_id: repo-assist, run: https://github.com/fsprojects/FSharp.Formatting/actions/runs/34546068188 -->

---

πŸ€– *Repo Assist here β€” I'm an automated AI assistant for this repository.*

## Activity for September 2026

## Suggested Actions for Maintainer

**Comprehensive list** of all pending actions requiring maintainer attention (excludes items already actioned and checked off).

* [ ] **Review PR**: Fix postfix FSharp.Core type-constructor links (`list`, `option`, etc.) in API docs, closes #1316 β€” [Review](https://github.com/fsprojects/FSharp.Formatting/pulls?q=is:pr+is:open+head:repo-assist%2Ffix-issue-1316-fsharpcore-list-links)
* [ ] **Review/rebase PR** #1299: repo-assist tests PR (ToLatex coverage) β€” mergeable_state was `dirty` as of last check, needs a rebase onto main β€” [Review](https://github.com/fsprojects/FSharp.Formatting/pull/1299)
* [ ] **Review/rebase PR** #1291: repo-assist deps bundle (Aug 2026) β€” mergeable_state was `dirty` as of last check, needs a rebase onto main β€” [Review](https://github.com/fsprojects/FSharp.Formatting/pull/1291)
* [ ] **Review PR** #1319: repo-assist perf fix (pipe-table O(n2) split), 369/369 tests pass β€” [Review](https://github.com/fsprojects/FSharp.Formatting/pull/1319)
* [ ] **Review PR** #1315 (nojaf): Skip union case tester properties in API docs, fixes #1313 β€” [Review](https://github.com/fsprojects/FSharp.Formatting/pull/1315)
* [ ] **Review PR** #1317 (nojaf): Keep comments of type abbreviations to tuples, fixes #1314 β€” [Review](https://github.com/fsprojects/FSharp.Formatting/pull/1317)
* [ ] **Review PR** #1318: Dependabot bump github/gh-aw-actions/setup 0.86.2β†’0.88.6 (blocked, workflow file) β€” [Review](https://github.com/fsprojects/FSharp.Formatting/pull/1318)
* [ ] **Close issue** #1296: stale `[aw] Repo Assist failed` infra notice β€” [View](https://github.com/fsprojects/FSharp.Formatting/issues/1296)
* [ ] **Close issue** #1297: stale `[aw] Failed jobs: Repo Assist` infra notice β€” [View](https://github.com/fsprojects/FSharp.Formatting/issues/1297)
* [ ] **Close issue** #1298: stale `[gh-aw] Protected Files` notice (deps bundle Aug 2026), superseded by merged/closed work β€” [View](https://github.com/fsprojects/FSharp.Formatting/issues/1298)

## Future Work for Repo Assist

- Continue monitoring for genuinely new, low-risk coding/testing/performance improvements β€” none identified with high confidence beyond issue #1316's fix this run.
- Revisit stale `TODO` markers in `LatexFormatting.fs`, `MarkdownBlockParser.fs`, `MarkdownInlineParser.fs` only if a concrete, low-risk fix becomes apparent.

## Run History

### 2026-09-13 04:24 UTC β€” [Run](https://github.com/fsprojects/FSharp.Formatting/actions/runs/34727786811)
- Task 3 (Issue Fix): Implemented the fix proposed by `@nojaf` in #1316 β€” `tryResolveCrossReferenceForEntity` in `CrossReferenceResolver.fs` now resolves postfix FSharp.Core type abbreviations (`list`, `option`, `voption`, `string`, etc.) through their abbreviated type's definition when the abbreviation entity has no full name of its own, so they render as hyperlinks instead of plain text. Added a regression test and updated two pre-existing test assertions whose expectations predated the fix (`string` in union case signatures is now also correctly linked). Full test suite green (368+32+28+146+92 tests). Opened draft PR and commented on #1316 linking it.
- Task 2 (Issue Comment): Reviewed all 16 open issues oldest-first. All already have adequate Repo Assist/human engagement or open fix PRs; no new comment needed beyond #1316 (addressed via Task 3).
- Task 4 (Engineering Investments): Checked `Directory.Packages.props` (all packages current, recently bumped) and CI workflow action versions (`actions/checkout@v6`, `actions/cache@v5`, `actions/setup-dotnet@v5` β€” all current). No actionable engineering item found this run; verified issue #1240 (deps bundle, previously flagged blocked) is already closed by dsyme, correcting stale memory.
- Verified memory was stale on several fronts: issue #1240 already closed 2026-09-08; PRs #1130/#1241/#1242/#1264/#1267/#1275 already merged. Updated memory accordingly.

### 2026-09-11 β€” [Run](https://github.com/fsprojects/FSharp.Formatting/actions/runs/34546068188)
- Task 1: labelled #1316 (enhancement, documentation), #1313 (bug, documentation), #1314 (bug, documentation).
- Task 8: created PR fixing O(n2) `pipeTableFindSplits` in `MarkdownTableParser.fs`, 369/369 tests pass.
- Task 2: no new comment needed β€” all issues already adequately covered.

### 2026-09-09 β€” [Run](https://github.com/fsprojects/FSharp.Formatting/actions/runs/34294605274)
- Task 9: added 2 new tests to `Markdown.fs` covering `Markdown.ToLatex` OtherBlock and InlineHtmlBlock rendering (370/370 pass); opened draft PR.
- Task 3: reviewed several bug/help-wanted issues β€” no new fixable bug found this run.

### 2026-09-08 (command mode: /repo-assist try again to bump to tool 0.38.0)
- Bumped fsharp-analyzers tool 0.37.2β†’0.38.0, G-Research.FSharp.Analyzers 0.23.0β†’0.24.0, Ionide.Analyzers 0.15.0β†’0.18.0 directly on PR #1291's branch; build and full test suite green.

### 2026-09-05 ~00:20 UTC β€” [Run](https://github.com/fsprojects/FSharp.Formatting/actions/runs/33932588559)
- Task 6 β€” rebased & pushed PR #1264 and PR #1267 (conflicts resolved, tests pass); verified PR #1275 needs no action.
- Task 10 β€” created PR bundling Ionide.ProjInfo 0.75.0 and NUnit3TestAdapter 6.3.0 bumps via `create_pull_request` (protected-file friendly); build and tests green.

### 2026-09-03 β€” Prior run
- Attempted deps bundle bump but `push_to_pull_request_branch` blocked by protected-files policy (`Directory.Packages.props`); other maintenance activity recorded in memory.> Generated by 🌈 Repo Assist, see [workflow run](https://github.com/fsprojects/FSharp.Formatting/actions/runs/34727786811). [Learn more](https://github.com/githubnext/agentics/blob/main/docs/repo-assist.md).
> <sub>Comment <em>/repo-assist</em> to run again</sub>
>
<details>
<summary><sub>Add this agentic workflow to your repo</sub></summary>

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@ae8d551f07c7ed7619f8c58c7bb4c3ac89395d38

</details>


<!-- gh-aw-agentic-workflow: Repo Assist, engine: copilot, model: auto, id: 34727786811, workflow_id: repo-assist, run: https://github.com/fsprojects/FSharp.Formatting/actions/runs/34727786811 -->

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up β€” it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

This is an automated monthly maintainer summary rather than a defined implementation task. Start by reviewing the referenced pull requests and issues, especially #1316 and PRs #1315, #1317, and #1319; there is no single file, test, or acceptance criterion that defines when this issue is done.

Written by the indexing model from the issue text.

Assessment

Tech stack
fsharp, git, github-actions
Domain
devtools, documentation, release
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
15/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.