Skip to content

GitHub polish + yay badges#5

Merged
bdtran2002 merged 7 commits intomainfrom
github-polish
Apr 22, 2026
Merged

GitHub polish + yay badges#5
bdtran2002 merged 7 commits intomainfrom
github-polish

Conversation

@bdtran2002
Copy link
Copy Markdown
Owner

@bdtran2002 bdtran2002 commented Apr 22, 2026

This pull request introduces major improvements to project documentation, contribution guidelines, security policy, and GitHub workflow automation. It adds a GitHub Pages landing site, refines the README for clarity and onboarding, and establishes clear templates for issues and pull requests. Additionally, it fixes a bug in gameplay packet summarization and improves state restoration logic. The most important changes are summarized below.


Documentation and Community Standards

  • Added comprehensive CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md files to clarify contribution process, expected behavior, and security reporting. [1] [2] [3]
  • Updated and reorganized the README.md with clearer project status, setup instructions, project links, and highlights; improved onboarding for contributors and users. [1] [2] [3]

GitHub Workflow and Automation

  • Added GitHub Issue and Pull Request templates for bug reports, feature requests, and PRs, along with a configuration file to guide contributors and link to key project resources. [1] [2] [3] [4]
  • Introduced .github/release.yml to categorize changelog entries by label for automated release notes.
  • Added a GitHub Actions workflow (.github/workflows/pages.yml) to build and deploy the new landing page to GitHub Pages.

Project Site

  • Added a new landing page in docs/site/ with a styled index.html and styles.css, providing a public-facing summary and links for the project. [1] [2]

Bug Fixes and Code Improvements

  • Fixed gameplay packet summary to count only validated packets, not all entries, and updated related tests for accuracy. [1] [2]
  • Improved state restoration logic in createResumeUpstreamRuntimeState to handle error states more robustly and ensure correct session recovery; updated tests accordingly. [1] [2]

Summary by CodeRabbit

  • New Features

    • GitHub Pages documentation site now live with project landing, highlights, and release linking.
    • New issue and pull-request templates to streamline reporting and contributions.
  • Documentation

    • Added Code of Conduct, Security Policy, and Contributing Guide.
    • README updated to clarify beta status and current status/usage.
  • Bug Fixes

    • Improved upstream runtime state handling and checkpoint restore behavior.
  • Tests

    • Updated tests to match restored/resumed runtime expectations.
  • Chores

    • CI workflow and release changelog configuration for Pages and changelog categories.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 22, 2026

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Adds GitHub templates/config, CI workflow for Pages, site assets, project docs (CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, README edits), and small runtime-state changes: validated gameplay-packet counting and adjusted bridgeState resolution on resume, plus corresponding test updates.

Changes

Cohort / File(s) Summary
GitHub Templates & Config
.github/ISSUE_TEMPLATE/bug_report.md, .github/ISSUE_TEMPLATE/feature_request.md, .github/ISSUE_TEMPLATE/config.yml, .github/PULL_REQUEST_TEMPLATE.md, .github/release.yml
Adds structured issue/PR templates, template config, and changelog label→category mapping for releases.
GitHub Pages Workflow
.github/workflows/pages.yml
New workflow to build/upload docs/site and deploy to GitHub Pages with least-privilege permissions, concurrency control, and environment gating.
Project Documentation
CODE_OF_CONDUCT.md, CONTRIBUTING.md, SECURITY.md, README.md
Adds code-of-conduct, contributing and security policies; rewrites README to emphasize local-first beta, reorganize sections, and shorten setup/docs.
Website Assets
docs/site/index.html, docs/site/styles.css
Adds a landing page with SEO/meta, client-side release lookup, hero/cards/footer, and a dark glassmorphism stylesheet (responsive).
Runtime State Logic & Tests
extension/src/features/runtime-frame/upstream-runtime-state.ts, extension/tests/upstream-runtime.test.ts
Counts only validated gameplay packets in summaries; computes resumed bridgeState with explicit rules (restored.exportUrl → 'waiting'; restored.bridgeState === 'error' → 'idle' else preserve); updates tests to match new expectations.

Sequence Diagram(s)

sequenceDiagram
    participant Restorer as Checkpoint Restorer
    participant Validator as Packet Validator
    participant Resolver as BridgeState Resolver
    participant Runtime as Runtime State

    Restorer->>Validator: provide restored.packets
    Validator-->>Restorer: validated packets + validatedCount
    Restorer->>Resolver: provide restored.bridgeState, restored.exportUrl
    Resolver-->>Restorer: computed bridgeState
    Restorer->>Runtime: assemble resumed state (phase, bridgeState, gameplayPacketSummary)
    Runtime-->>Restorer: resumed runtime state returned
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Poem

🐰 I hopped through docs and CI tonight,

templates stitched by soft moonlight,
A page to show our beta gleam,
packets counted, states redeemed,
nibble on this tidy dream.

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
Title check ❓ Inconclusive The title 'GitHub polish + yay badges' is vague and uses non-descriptive terms that don't clearly convey the scope of changes, which include documentation, policies, templates, automation, a landing site, and code fixes. Consider a more specific title that captures the main changes, such as 'Add GitHub documentation, templates, and landing site' or break into multiple PRs focused on specific areas.
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch github-polish

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 4

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
README.md (1)

73-89: ⚠️ Potential issue | 🟠 Major

Clarify full-tab as temporary/debug-only, not a target runtime surface.

Line 78/Line 81 and Line 144 currently read like full-tab is a first-class target path. That can steer contributors away from the intended popup/side-panel shipped surface.

Suggested doc tweak
-  BG --> FT[Host page in full tab]
+  BG --> FT[Host page in full tab (temporary debug/migration path)]
@@
-5. Use **Move to full tab** and confirm the run transfers.
+5. (Optional debug) Use **Move to full tab** and confirm transfer still works during migration.
+6. Confirm popup/side-panel-style flow remains the primary shipped experience.

Based on learnings: The visible runtime surface must be extension-owned and constrained like a popup or side panel; do not treat a full browser tab as the final shipped runtime surface.

Also applies to: 140-145

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 73 - 89, Update the README mermaid diagram and
surrounding text to clarify that the "FT[Host page in full tab]" path is only
for temporary/debug use and not a supported production runtime: annotate or
rename FT to something like "FT[Host page in full tab (debug-only)]", and update
any prose references around the RH, PW, FT nodes (lines referencing FT/Host page
in full tab and the paragraphs around 140-145) to explicitly state full-tab is a
development-only surface while PU (Extension popup UI) / side-panel remain the
intended shipped surfaces; ensure the diagram arrows (BG -> FT and FT -> RH)
stay for completeness but are labeled or footnoted as debug-only to avoid
implying full-tab is a first-class runtime.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.github/ISSUE_TEMPLATE/config.yml:
- Around line 1-11: The contact_links entries contain two broken URLs; update or
remove the entries for "Contributing guide" (url currently set to
https://github.com/bdtran2002/ForkOrFry/blob/main/CONTRIBUTING.md) and "Project
site" (url currently set to https://bdtran2002.github.io/ForkOrFry/) in the
config.yml's contact_links block: either correct them to valid, reachable URLs
or delete those contact_links objects so only the working "Project README" link
remains; ensure you keep the YAML structure (keys: contact_links, name, url,
about) and do not alter blank_issues_enabled.

In `@docs/site/index.html`:
- Line 70: Replace the hardcoded prerelease anchor in the footer ("Current
prerelease: <a ...>v0.0.1-beta.1</a>") with a dynamic source: either point the
href/text to GitHub's releases/latest URL or fetch the latest tag at
build/runtime (via GitHub API or a small client-side script) and inject the tag
into the same anchor text so it never goes stale; update the anchor element with
the new dynamic approach and keep the visible label "Current prerelease:" so
visitors still see the same UI.

In `@docs/site/styles.css`:
- Around line 95-118: Add explicit keyboard focus styles for interactive
controls by defining :focus-visible rules for .button and links under
.subtle-links (and any other interactive selectors you have) so keyboard users
get a visible focus ring without changing mouse focus behavior; update the CSS
to include .button:focus-visible and .subtle-links a:focus-visible with a clear
outline or box-shadow, ensure the focus styling uses accessible contrast and
matches your hover/active transitions, and avoid using outline: none so the
focus remains visible for keyboard users.

In `@README.md`:
- Around line 45-49: The first-time setup in the README's "How to try it" steps
is missing dependency installation; update the ordered steps (around the
existing "Run `npm run build` in `extension/`" and the list of Firefox load
steps) to insert a prior step to run `npm install` (or `npm ci`) inside the
`extension/` directory so dependencies are installed before running `npm run
build`, and mention which package manager (npm/yarn/pnpm) is supported if
applicable.

---

Outside diff comments:
In `@README.md`:
- Around line 73-89: Update the README mermaid diagram and surrounding text to
clarify that the "FT[Host page in full tab]" path is only for temporary/debug
use and not a supported production runtime: annotate or rename FT to something
like "FT[Host page in full tab (debug-only)]", and update any prose references
around the RH, PW, FT nodes (lines referencing FT/Host page in full tab and the
paragraphs around 140-145) to explicitly state full-tab is a development-only
surface while PU (Extension popup UI) / side-panel remain the intended shipped
surfaces; ensure the diagram arrows (BG -> FT and FT -> RH) stay for
completeness but are labeled or footnoted as debug-only to avoid implying
full-tab is a first-class runtime.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: ffc1fe94-ef97-47d0-b93a-9cf92eb41867

📥 Commits

Reviewing files that changed from the base of the PR and between 0b87bd7 and 37e9461.

📒 Files selected for processing (14)
  • .github/ISSUE_TEMPLATE/bug_report.md
  • .github/ISSUE_TEMPLATE/config.yml
  • .github/ISSUE_TEMPLATE/feature_request.md
  • .github/PULL_REQUEST_TEMPLATE.md
  • .github/release.yml
  • .github/workflows/pages.yml
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • README.md
  • SECURITY.md
  • docs/site/index.html
  • docs/site/styles.css
  • extension/src/features/runtime-frame/upstream-runtime-state.ts
  • extension/tests/upstream-runtime.test.ts

Comment thread .github/ISSUE_TEMPLATE/config.yml Outdated
Comment thread docs/site/index.html Outdated
Comment thread docs/site/styles.css
Comment thread README.md Outdated
@bdtran2002
Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 22, 2026

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@bdtran2002 bdtran2002 merged commit 7a96638 into main Apr 22, 2026
2 of 3 checks passed
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.

1 participant