Skip to content

Misc claude improvements#132

Merged
ejfine merged 10 commits intomainfrom
misc-claude
Mar 5, 2026
Merged

Misc claude improvements#132
ejfine merged 10 commits intomainfrom
misc-claude

Conversation

@ejfine
Copy link
Contributor

@ejfine ejfine commented Mar 5, 2026

Why is this change necessary?

Fix the settings merger so it merges the "ask" things

Update some agent instructions based on empirical experience

What side effects does this change have?

N/A

How is this change tested?

Downstream repo

Other

use ci instead of install to actually use what's in package-lock.json

Summary by CodeRabbit

  • Chores

    • Updated platform/tooling versions and installer to newer releases
    • Made development container setup more reproducible by switching install method and updating extension/version references
    • Improved permission merging to collect and deduplicate requested permissions across configs
    • Refined linting guidance for Python checks
  • Documentation

    • Expanded development guidance with testing notes and frontend tooling instructions

@ejfine ejfine self-assigned this Mar 5, 2026
@coderabbitai
Copy link

coderabbitai bot commented Mar 5, 2026

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Adds collection/deduplication of permissions.ask in the Claude settings merge script, updates devcontainer tooling and extension versions, replaces npm install with npm ci in setup scripts, tweaks Python linting guidance, and updates several dependency/version pins and documentation notes.

Changes

Cohort / File(s) Summary
Permissions merge
.claude/helpers/merge-claude-settings.sh
Collects, flattens and deduplicates permissions.ask across input JSONC files and includes it in the merged settings.json, following existing permission-array merge logic.
Devcontainer & install scripts
.devcontainer/on-create-command.sh, template/.devcontainer/on-create-command.sh.jinja-base, .devcontainer/install-ci-tooling.py, template/.devcontainer/devcontainer.json.jinja-base, .devcontainer/devcontainer.json
Replaced npm install with npm ci in container setup; bumped UV and VS Code extension versions and updated devcontainer context hash.
Configuration & context
.coderabbit.yaml, extensions/context.py
Refined Python linting guidance (ruff checks, type-hint note) and bumped multiple dependency/action version pins (FastAPI, nuxt_ui, happy_dom, gha actions, etc.).
Documentation
AGENTS.md
Expanded guidance for keyword-only parameters, added Python testing notes (mocker.spy) and frontend tooling instruction (use pnpm scripts).

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • zendern
🚥 Pre-merge checks | ✅ 1 | ❌ 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 'Misc claude improvements' is vague and generic, using non-descriptive phrasing that does not convey meaningful information about the changeset. Replace with a more specific title that reflects the main changes, such as 'Merge ask permissions in claude settings and update CI tooling' or focus on the most impactful change.
✅ Passed checks (1 passed)
Check name Status Explanation
Description check ✅ Passed The description covers most required sections from the template (Why, Side effects, Testing, Other) but lacks details on the link to issue and how changes address the issue.

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


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 and usage tips.

Copy link

@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: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@AGENTS.md`:
- Line 7: Change the phrase "single argument function" in AGENTS.md to the
hyphenated compound adjective "single-argument function"; locate the sentence
containing "Prefer keyword-only parameters (unless a very clear single argument
function): use `*` in Python signatures and destructured options objects in
TypeScript." and replace "single argument" with "single-argument" so the
compound adjective is correctly hyphenated.
- Around line 15-19: Edit the "### Python Testing" section in AGENTS.md: ensure
there is exactly one blank line immediately before the "### Python Testing"
heading (add a blank line above the heading if missing) and remove the extra
blank line after the paragraph (the stray blank line at the end of the
subsection). Keep the content unchanged, only adjust surrounding blank lines
around the "### Python Testing" heading and its paragraph.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 6aaf601a-b442-433e-98c0-6ef9120a377e

📥 Commits

Reviewing files that changed from the base of the PR and between b5ef020 and 39f0dde.

📒 Files selected for processing (7)
  • .claude/helpers/merge-claude-settings.sh
  • .coderabbit.yaml
  • .devcontainer/devcontainer.json
  • .devcontainer/on-create-command.sh
  • AGENTS.md
  • extensions/context.py
  • template/.devcontainer/on-create-command.sh.jinja-base

Comment on lines +15 to +19
### Python Testing
- When using `mocker.spy` on a class-level method (including inherited ones), the spy records the unbound call, so assertions need `ANY` as the first argument to match self: `spy.assert_called_once_with(ANY, expected_arg)`
- Before writing new mock/spy helpers, check the `tests/unit/` folder for pre-built helpers in files like `fixtures.py` or `*mocks.py`


Copy link

Choose a reason for hiding this comment

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

🧹 Nitpick | 🔵 Trivial

New Python Testing subsection is helpful; minor formatting nit.

The mocker.spy guidance about ANY for the self argument is a valuable gotcha to document. The advice to check existing helpers prevents duplication.

There's an extra blank line at line 19, and per MD022, the heading at line 15 should have a blank line above it (line 14 is blank but line 13 ends content).

,

📝 Optional formatting fix
 - Prefer using random values in tests rather than arbitrary ones (e.g. the faker library, uuids, random.randint) when possible.

 ### Python Testing
+
 - When using `mocker.spy` on a class-level method (including inherited ones), the spy records the unbound call, so assertions need `ANY` as the first argument to match self:  `spy.assert_called_once_with(ANY, expected_arg)`
 - Before writing new mock/spy helpers, check the `tests/unit/` folder for pre-built helpers in files like `fixtures.py` or `*mocks.py`
-
-
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
### Python Testing
- When using `mocker.spy` on a class-level method (including inherited ones), the spy records the unbound call, so assertions need `ANY` as the first argument to match self: `spy.assert_called_once_with(ANY, expected_arg)`
- Before writing new mock/spy helpers, check the `tests/unit/` folder for pre-built helpers in files like `fixtures.py` or `*mocks.py`
- Prefer using random values in tests rather than arbitrary ones (e.g. the faker library, uuids, random.randint) when possible.
### Python Testing
- When using `mocker.spy` on a class-level method (including inherited ones), the spy records the unbound call, so assertions need `ANY` as the first argument to match self: `spy.assert_called_once_with(ANY, expected_arg)`
- Before writing new mock/spy helpers, check the `tests/unit/` folder for pre-built helpers in files like `fixtures.py` or `*mocks.py`
🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 15-15: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)

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

In `@AGENTS.md` around lines 15 - 19, Edit the "### Python Testing" section in
AGENTS.md: ensure there is exactly one blank line immediately before the "###
Python Testing" heading (add a blank line above the heading if missing) and
remove the extra blank line after the paragraph (the stray blank line at the end
of the subsection). Keep the content unchanged, only adjust surrounding blank
lines around the "### Python Testing" heading and its paragraph.

@ejfine ejfine marked this pull request as ready for review March 5, 2026 21:35
@ejfine ejfine requested a review from zendern March 5, 2026 21:35
zendern
zendern previously approved these changes Mar 5, 2026
@ejfine ejfine merged commit 09fda0b into main Mar 5, 2026
7 checks passed
@ejfine ejfine deleted the misc-claude branch March 5, 2026 22:08
This was referenced Mar 13, 2026
@coderabbitai coderabbitai bot mentioned this pull request Mar 23, 2026
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.

2 participants