Skip to content

fix(docs): address Aragorn review blockers — PR #126 - #127

Merged
mpaulosky merged 28 commits into
devfrom
squad/127-fix-pr126-review-blockers
Apr 24, 2026
Merged

fix(docs): address Aragorn review blockers — PR #126#127
mpaulosky merged 28 commits into
devfrom
squad/127-fix-pr126-review-blockers

Conversation

@mpaulosky

Copy link
Copy Markdown
Owner

Fixes 3 blocking issues flagged by Aragorn in review of PR #126:

  1. docs/index.htmlnpm run css:watchnpm run tw:watch (correct script name)
  2. README.md + docs/blog/2026-04-18-myblog-project-kickoff.md — Aspire version 13.2.213.2.3

mpaulosky and others added 28 commits April 20, 2026 08:03
- PR #62: APPROVE — pre-push hook logic verified, clean infra fix
- PR #63: conditional APPROVE — build confirmation needed before merge
- PR #60: NEEDS_CHANGES — dirty state, missing copyright headers, wrong attribution
- Systemic finding: squad-test.yml does not trigger on sprint/** PRs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add push trigger for sprint/** so direct pushes to sprint branches
  trigger the parallel test suite
- Add sprint/** to pull_request.branches so PRs targeting sprint
  consolidation branches also run CI validation

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Update .NET SDK to 10.0.202 in global.json
- Add docs/build-log.txt with build & test results
- Include refactored code improvements

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…learnings

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
GitVersion auto-increments on main; v1.0.0-sprint3 is final sprint tag.
Subsequent releases follow pure semantic versioning from v1.0.1 onwards.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Marks cutover from sprint-based tags to pure semantic versioning.

GitVersion auto-increments Patch on main.
This release validates the new versioning workflow:
- main commit → CI GitVersion tags → GitHub Release creation

Closes: versioning decision from sprint/4-planning

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
When CI runs on main after merge, create and push the git tag based on
GitVersion-determined semver. This enables v1.0.1, v1.0.2, etc. to be
automatically tagged without manual intervention.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add step to CI workflow that creates and pushes git tags for each commit
to main, using GitVersion-determined semver.

This completes the v1.0.1 release flow:
- Merge PR to main
- CI determines version with GitVersion
- CI creates and pushes tag (v1.0.1, v1.0.2, ...)
- Team creates GitHub Release from tag

Closes: versioning automation setup
GitVersion v4 action no longer accepts 'useConfigFile'. Use 'configFilePath'
to explicitly specify the GitVersion.yml location.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Replace deprecated 'useConfigFile' with 'configFilePath' in GitVersion
action.

This is required for gittools/actions/gitversion/execute@v4 to work
properly.
The 'Create and Push Git Tag' step requires 'contents: write' permission
to push tags to the repository.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Change 'contents: read' to 'contents: write' so the 'Create and Push Git
Tag' step can push tags.

This completes the automatic versioning workflow.
semVer includes pre-release height on non-main branches, resulting in tags like
v1.0.0-101. On main, we want clean semver tags like v1.0.1, which comes from
the majorMinorPatch output.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
GitVersion's semVer output includes pre-release height (e.g.
v1.0.0-101).
On main, we want clean v1.0.1 format, which comes from majorMinorPatch.

This ensures the first post-sprint release is tagged v1.0.1, not
v1.0.0-{height}.
Document the new automatic versioning workflow with GitVersion.
This is the first commit after v1.0.0, which will trigger v1.0.1 tag creation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add RELEASE.md documenting the new automatic versioning workflow.

This commit on main will trigger v1.0.1 tag creation via the CI
workflow.
Aligns with squad naming conventions and PRD specification.
All squad-managed workflows use the 'squad-' prefix.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Align CI workflow naming with squad conventions. All squad-managed
workflows use the 'squad-' prefix.
Merge dev into main for Sprint 4 release. Resolve workflow conflicts
by accepting dev versions (squad-ci.yml, squad-test.yml).
Also fix squad-preview validate to exclude AppHost.Tests/Bunit.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
## Sprint 4 Release — v1.1.0

Replaces PR #105 which had a merge conflict in workflow files
(`squad-ci.yml`, `squad-test.yml`).

### Changes included

All Sprint 4 work from `dev`:
- feat: Blazor theme system (Sprint 4 issues #81#86)
- feat: VSA migration — move Domain.Features to Web (PR #104)
- fix: Resolve all 7 flaky E2E tests in AppHost.Tests (PR #102)
- refactor: Reorganize test projects (PR #100)
- ci: Central Package Management (CPM)
- ci: Fix squad-preview validate to skip AppHost.Tests/Bunit (unrunnable
on plain runners)

### Conflict resolution

`squad-ci.yml` and `squad-test.yml` had add/add and content conflicts
from main having an older version. Resolved by accepting the `dev`
versions (correct current state).

---
Closes #105

_After merging, run **squad-milestone-release** to tag and publish
v1.1.0._
## Sprint 5 Release — Redis & Caching (v1.2.0)

Promotes `dev` → `main` for the Sprint 5 release.

### What's in this release

- **`IBlogPostCacheService`** — caching contract with
`GetOrFetchAllAsync`, `GetOrFetchByIdAsync`, `InvalidateAllAsync`,
`InvalidateByIdAsync`
- **`BlogPostCacheService`** — two-tier L1 (IMemoryCache, 1-min TTL) +
L2 (Redis, 5-min TTL), registered as Singleton via
`AddBlogPostCaching()`
- All 4 BlogPost MediatR handlers refactored to inject
`IBlogPostCacheService` only
- 16 unit tests, 2 arch tests, 3 Redis integration tests
(Testcontainers)
- ADR: `docs/adr/sprint5-caching-abstraction.md`
- CI: auto-move Done → Released on GitHub Release publish

### Closed issues
Closes #109, #110, #111, #112, #113, #114

### CI status
All checks green on `dev` ✅
Fixes literal block scalar indentation in project-board-automation.yml, add-issues-to-project.yml, and squad-test.yml. All CI checks green.
- docs/index.html: fix npm script name css:watch → tw:watch
- README.md: add BLOG_START/END markers for blog-readme-sync automation
- README.md + kickoff blog: correct Aspire version 13.2.2 → 13.2.3

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 24, 2026 16:01
@github-actions

Copy link
Copy Markdown
Contributor

🏗️ PR Added to Squad Triage Queue

This PR has been labeled with squad and added to the triage queue.

Next steps:

  • The squad Lead will review and assign to an appropriate team member
  • A squad:member label will be added after triage

If you know which squad member should handle this, you can add the appropriate squad:member label yourself.

@github-actions github-actions Bot added the squad Squad triage inbox — Lead will assign to a member label Apr 24, 2026

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.

Pull request overview

This PR updates documentation to address review blockers from PR #126 by correcting TailwindCSS watch script instructions and aligning documented .NET Aspire version with the repo’s centrally-managed package versions.

Changes:

  • Update GitHub Pages docs to use npm run tw:watch (correct Tailwind watch script).
  • Bump documented .NET Aspire version from 13.2.2 to 13.2.3 in README and the Sprint 1 kickoff blog post.
  • Add a README “Dev Blog” section with <!-- BLOG_START --> / <!-- BLOG_END --> markers and a recent-posts table.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/index.html Fixes Tailwind watch command to match repo npm scripts (tw:watch).
docs/blog/2026-04-18-myblog-project-kickoff.md Updates documented Aspire version to 13.2.3.
README.md Updates Aspire version to 13.2.3 and adds a “Dev Blog” section/table.

Comment thread README.md
Comment on lines +166 to +170
## Dev Blog

<!-- BLOG_START -->
| Date | Title | Tags |
|------|-------|------|

Copilot AI Apr 24, 2026

Copy link

Choose a reason for hiding this comment

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

The PR description only mentions updating the Tailwind watch script name and bumping the Aspire version, but this change also adds a new "Dev Blog" section (with BLOG_START/BLOG_END markers and a table) to the README. Please either update the PR description to include this additional change or move it to a separate PR to keep scope aligned with the stated review blockers.

Copilot uses AI. Check for mistakes.
@github-actions

Copy link
Copy Markdown
Contributor

Test Results Summary

206 tests  ±0   206 ✅ ±0   14s ⏱️ ±0s
  5 suites ±0     0 💤 ±0 
  5 files   ±0     0 ❌ ±0 

Results for commit 0ecb6fd. ± Comparison against base commit c75a283.

@codecov

codecov Bot commented Apr 24, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.93%. Comparing base (c75a283) to head (0ecb6fd).
⚠️ Report is 1 commits behind head on dev.

Additional details and impacted files
@@           Coverage Diff           @@
##              dev     #127   +/-   ##
=======================================
  Coverage   76.93%   76.93%           
=======================================
  Files          43       43           
  Lines         672      672           
  Branches      111      111           
=======================================
  Hits          517      517           
  Misses        105      105           
  Partials       50       50           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@mpaulosky

Copy link
Copy Markdown
Owner Author

🔱 Aragorn — APPROVED ✅

CI: ✅ All checks passed | Copilot review: ✅ Read

Blocker from #126 Fix Verified
npm run css:watchtw:watch in docs/index.html Matches root package.json
Aspire 13.2.213.2.3 in README + kickoff blog post Matches Directory.Packages.props

Copilot's PR-description scope note is non-blocking. All 3 blockers resolved. Merging. — Aragorn

@mpaulosky
mpaulosky merged commit 6352f91 into dev Apr 24, 2026
23 checks passed
@mpaulosky
mpaulosky deleted the squad/127-fix-pr126-review-blockers branch April 24, 2026 16:07

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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comment thread README.md
Comment on lines +166 to +170
## Dev Blog

<!-- BLOG_START -->
| Date | Title | Tags |
|------|-------|------|

Copilot AI Apr 24, 2026

Copy link

Choose a reason for hiding this comment

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

The PR description lists only the Tailwind watch script rename and Aspire version bump, but this diff also adds a new "Dev Blog" section (BLOG_START/BLOG_END) to the README. Please update the PR description to reflect this additional change (or split it into a separate PR if it’s out of scope).

Copilot uses AI. Check for mistakes.
@mpaulosky

Copy link
Copy Markdown
Owner Author

🔱 Aragorn — Approved ✅

Verification against PR #126 blockers:

# Issue Fix Status
1 docs/index.html: npm run css:watch (nonexistent) npm run tw:watch Fixed
3 Aspire version 13.2.2 in README + kickoff post 13.2.3 in both files (matches Directory.Packages.props) Fixed

CI: ✅ All 15 checks pass
Copilot review nit: PR description omitted the Dev Blog section addition — non-blocking; the change is correct and required.

All three review blockers addressed cleanly. Merging. 🚀

mpaulosky added a commit that referenced this pull request Apr 24, 2026
…itHub Pages

Promotes v1.2.0 documentation from dev to main:

- 6 new blog posts (Sprints 1–5 + release milestones v1.0.0/v1.1.0/v1.2.0) in docs/blog/
- docs/blog/index.md — blog landing page with Latest Posts table (blog-readme-sync compatible)
- README.md — full rewrite for v1.2.0 stack (Aspire 13.2.3, Redis, bUnit, 7 test projects)
  - Dev Blog section with BLOG_START/BLOG_END markers for automated sync
  - Release history table (v1.0.0 → v1.2.0)
- docs/index.html — GitHub Pages overhauled for v1.2.0 (release table, blog links, npm tw:watch)
- Workflow YAML heredoc indentation hardening (3 workflow files)

Fixes from PR #127 included: correct npm script (tw:watch), blog-sync markers, Aspire 13.2.3.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

squad Squad triage inbox — Lead will assign to a member

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants