Skip to content

Adopt Grove TypeScript Packages - #114

Merged
PSchmiedmayer merged 6 commits into
mainfrom
feature/grove-ts-migration
Aug 7, 2026
Merged

Adopt Grove TypeScript Packages#114
PSchmiedmayer merged 6 commits into
mainfrom
feature/grove-ts-migration

Conversation

@PSchmiedmayer

@PSchmiedmayer PSchmiedmayer commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

♻️ Current situation & Problem

Heartwood still depended on the previous shared web packages, which blocked ESLint 10 and kept obsolete naming in the repository. This follows Grove #34.

⚙️ Release Notes

  • Use Grove 0.1.1 for the browser design system and shared TypeScript configuration.
  • Add accessible light and dark modes that follow the operating system initially and retain an explicit browser preference.
  • Upgrade ESLint to 10 and prepare version 0.3.0-beta.4 across release artifacts and instructions.

📚 Documentation

README and browser documentation now use current generated desktop screenshots in both light and dark appearances, selected according to the viewer theme.

✅ Testing

  • 1,623 Python tests with 92.57% coverage; linting, typing, licenses, and release validation
  • 131 web unit tests and six Playwright workflows, including appearance selection and persistence
  • Gateway, Jupyter proxy, realistic browser-to-CLI smoke tests, dependency audit, and strict documentation build

Code of Conduct & Contributing Guidelines

By creating and submitting this pull request, you agree to follow our Code of Conduct and Contributing Guidelines:

Signed-off-by: Paul Schmiedmayer <PSchmiedmayer@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings August 7, 2026 19:34
@github-project-automation github-project-automation Bot moved this to Backlog in Heartwood Aug 7, 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.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@PSchmiedmayer, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 15 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 20d4277f-6338-4ae7-b9e4-65420d94dbd0

📥 Commits

Reviewing files that changed from the base of the PR and between 3b18529 and 65ea4da.

⛔ Files ignored due to path filters (20)
  • documentation/assets/screenshots/browser-action-review-dark.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-action-review-light.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-action-review.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-action-settings-dark.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-action-settings-light.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-action-settings.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-changes-dark.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-changes-light.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-changes.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-conversation-dark.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-conversation-light.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-conversation.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-files-dark.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-files-light.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-files.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-specialists-dark.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-specialists-light.png is excluded by !**/*.png
  • documentation/assets/screenshots/browser-specialists.png is excluded by !**/*.png
  • packages/webui/package-lock.json is excluded by !**/package-lock.json
  • uv.lock is excluded by !**/*.lock
📒 Files selected for processing (59)
  • README.md
  • VERSION.toml
  • docker-bake.hcl
  • documentation/assets/screenshots/browser-action-review-dark.png.license
  • documentation/assets/screenshots/browser-action-review-light.png.license
  • documentation/assets/screenshots/browser-action-settings-dark.png.license
  • documentation/assets/screenshots/browser-action-settings-light.png.license
  • documentation/assets/screenshots/browser-changes-dark.png.license
  • documentation/assets/screenshots/browser-changes-light.png.license
  • documentation/assets/screenshots/browser-conversation-dark.png.license
  • documentation/assets/screenshots/browser-conversation-light.png.license
  • documentation/assets/screenshots/browser-files-dark.png.license
  • documentation/assets/screenshots/browser-files-light.png.license
  • documentation/assets/screenshots/browser-specialists-dark.png.license
  • documentation/assets/screenshots/browser-specialists-light.png.license
  • documentation/contribute/releases.md
  • documentation/models/offline.md
  • documentation/platforms/carina.md
  • documentation/platforms/containers.md
  • documentation/platforms/native-linux.md
  • documentation/platforms/terra.md
  • documentation/stylesheets/extra.css
  • documentation/use/actions-audit.md
  • documentation/use/browser.md
  • documentation/use/specialists.md
  • packages/adapters/pyproject.toml
  • packages/adapters/src/heartwood/adapters/__init__.py
  • packages/audit/pyproject.toml
  • packages/audit/src/heartwood/audit/__init__.py
  • packages/cli/pyproject.toml
  • packages/cli/src/heartwood/cli/__init__.py
  • packages/compliance/pyproject.toml
  • packages/compliance/src/heartwood/compliance/__init__.py
  • packages/compliance/tests/test_container_assets.py
  • packages/compliance/tests/test_documentation_assets.py
  • packages/core-adapter/pyproject.toml
  • packages/core-adapter/src/heartwood/core_adapter/__init__.py
  • packages/detector/pyproject.toml
  • packages/detector/src/heartwood/detector/__init__.py
  • packages/fixtures/pyproject.toml
  • packages/fixtures/src/heartwood/fixtures/__init__.py
  • packages/gateway/pyproject.toml
  • packages/model-policy/pyproject.toml
  • packages/model-policy/src/heartwood/model_policy/__init__.py
  • packages/notebook/pyproject.toml
  • packages/notebook/src/heartwood/notebook/__init__.py
  • packages/persistence/pyproject.toml
  • packages/persistence/src/heartwood/persistence/__init__.py
  • packages/schemas/pyproject.toml
  • packages/schemas/src/heartwood/schemas/__init__.py
  • packages/session/pyproject.toml
  • packages/session/src/heartwood/session/__init__.py
  • packages/skills/pyproject.toml
  • packages/webui/package.json
  • packages/webui/scripts/smoke-reference-analysis.cjs
  • packages/webui/src/colorTheme.test.tsx
  • packages/webui/src/colorTheme.ts
  • packages/webui/src/components/ProjectWorkspace.test.tsx
  • packages/webui/src/e2e/app.spec.ts
📝 Walkthrough

Walkthrough

The web UI migrates from Stanford Spezi to Grove for dependencies, configuration, providers, components, and styles. It adds system-aware light and dark themes with persisted selections and a session-header toggle. Internal refs are renamed without changing asynchronous session behavior. Sheet-closing helpers now verify hidden state in smoke and end-to-end tests. Test doubles retain readonly connection-instance arrays.

Sequence Diagram(s)

sequenceDiagram
  participant Browser
  participant useColorTheme
  participant WorkspaceHeader
  Browser->>useColorTheme: Provide system appearance or stored preference
  useColorTheme->>Browser: Apply document theme
  WorkspaceHeader->>useColorTheme: Toggle theme
  useColorTheme->>Browser: Persist selected theme
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

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.
✅ Passed checks (4 passed)
Check name Status Explanation
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.
Title check ✅ Passed The title clearly identifies the primary change: adopting Grove TypeScript packages for the web interface.
Description check ✅ Passed The description directly explains the Grove migration, theme support, ESLint upgrade, documentation updates, and testing scope.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/dependabot.yml:
- Around line 28-30: Keep ESLint major updates ignored in the Dependabot
configuration at .github/dependabot.yml:28-30, so ESLint remains coupled to a
compatible Grove configuration release. The references at
packages/webui/package.json:56 and packages/webui/package.json:66 require no
direct change; they document the pinned Grove configuration and ESLint
relationship.

In `@packages/webui/eslint.config.mjs`:
- Around line 72-79: Update the ESLint rule overrides in the web UI
configuration by replacing import/no-default-export with
import-x/no-default-export and prefer-arrow/prefer-arrow-functions with
prefer-arrow-functions/prefer-arrow-functions. Alternatively, register
compatible aliases before retaining the existing names, ensuring both overrides
resolve to Grove’s supported rule namespaces.

In `@packages/webui/src/grove.css`:
- Line 12: Update the Stylelint configuration for the grove.css stylesheet so
the intentional Tailwind `@source` directive is accepted by
scss/at-rule-no-unknown. Prefer adding source to the allowed at-rule
configuration; otherwise add a narrowly scoped suppression immediately before
the `@source` directive.
🪄 Autofix

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: CHILL

Plan: Pro Plus

Run ID: 6e5f9422-8dee-48c3-aab9-898bbb19a182

📥 Commits

Reviewing files that changed from the base of the PR and between ba7d3a7 and a41932b.

⛔ Files ignored due to path filters (1)
  • packages/webui/package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (18)
  • .github/dependabot.yml
  • AGENTS.md
  • documentation/contribute/development.md
  • packages/webui/.prettierrc.mjs
  • packages/webui/eslint.config.mjs
  • packages/webui/package.json
  • packages/webui/scripts/smoke-reference-analysis.cjs
  • packages/webui/src/App.tsx
  • packages/webui/src/client.test.ts
  • packages/webui/src/components/CodeViewer.tsx
  • packages/webui/src/components/ConversationWorkspace.tsx
  • packages/webui/src/components/ProjectWorkspace.tsx
  • packages/webui/src/components/SessionRail.tsx
  • packages/webui/src/components/UtilitySheet.tsx
  • packages/webui/src/components/WorkspaceHeader.tsx
  • packages/webui/src/e2e/app.spec.ts
  • packages/webui/src/grove.css
  • packages/webui/src/main.tsx

Comment thread .github/dependabot.yml
Comment thread packages/webui/eslint.config.mjs
Comment thread packages/webui/src/grove.css

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/webui/src/colorTheme.ts`:
- Around line 42-64: Update the theme state flow around toggleTheme and the
system-theme useEffect so an explicit user selection is tracked independently of
localStorage persistence. Mark the theme as explicitly selected before setItem,
and have the storedTheme checks also honor that in-memory selection so
media-query changes cannot overwrite it when storage writes throw. Add a
regression test that makes localStorage.setItem throw, toggles the theme,
dispatches a media-query change, and verifies the explicit theme remains active.

In `@packages/webui/src/e2e/app.spec.ts`:
- Around line 44-47: Update the Escape-dismissal checks in the test around the
existing Close button locators so each Close button is first proven attached or
visible before pressing Escape, then retain the hidden assertion afterward.
Apply this to both dismissal steps, or remove the second Escape step if the
setup sheet should not reopen after reload.
🪄 Autofix

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: CHILL

Plan: Pro Plus

Run ID: 39c925e5-c28b-4c34-9e9c-4f16ad91425b

📥 Commits

Reviewing files that changed from the base of the PR and between a41932b and 3b18529.

⛔ Files ignored due to path filters (1)
  • packages/webui/package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (11)
  • documentation/use/browser.md
  • packages/webui/eslint.config.mjs
  • packages/webui/package.json
  • packages/webui/src/App.tsx
  • packages/webui/src/colorTheme.test.tsx
  • packages/webui/src/colorTheme.ts
  • packages/webui/src/components/CodeViewer.tsx
  • packages/webui/src/components/WorkspaceHeader.tsx
  • packages/webui/src/e2e/app.spec.ts
  • packages/webui/src/styles.css
  • packages/webui/src/test/setup.ts
🚧 Files skipped from review as they are similar to previous changes (3)
  • packages/webui/package.json
  • packages/webui/eslint.config.mjs
  • packages/webui/src/App.tsx

Comment thread packages/webui/src/colorTheme.ts
Comment thread packages/webui/src/e2e/app.spec.ts Outdated
@PSchmiedmayer
PSchmiedmayer merged commit c3d484e into main Aug 7, 2026
45 of 47 checks passed
@PSchmiedmayer
PSchmiedmayer deleted the feature/grove-ts-migration branch August 7, 2026 23:55
@github-project-automation github-project-automation Bot moved this from Backlog to Done in Heartwood Aug 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants