fsprojects / fsprojects/FSharp.Formatting
[repo-assist] Monthly Activity 2026-09
Nobody has claimed this yet.
- 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
TODOmarkers inLatexFormatting.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_requestwhich 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_branchblocked 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
dirtymergeable_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_requestwhich 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_branchblocked 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up β it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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