Skip to content

feat: launch public connector site and harden scene review - #7

Merged
Ker102 merged 2 commits into
mainfrom
feature/mcp-client-tool-skills
Oct 7, 2026
Merged

Ker102 merged 2 commits into
mainfrom
feature/mcp-client-tool-skills

Conversation

@Ker102

@Ker102 Ker102 commented Jul 29, 2026 •

Copy link
Copy Markdown
Collaborator

Public connector launch and result review

Publish the repository's static overview through GitHub Pages and improve the
agent's result review. Image-producing calls can attach bounded previews directly.
Finalize can preserve the artist's presentation, render without a blend save,
and withhold output when an explicit spatial check fails. Guidance replaces fixed
preview counts with task-specific inspection and reports unresolved defects.

Synchronize the current addon/tool metadata, refresh the dependency lock, verify
every packaged skill reference, and prepare the aligned 1.3.0 release.

Validation: standalone typecheck, MCP conformance including inline image transport,
build, package validation, dependency audit; focused scene-stage and waitlist
handler checks. The Studio waitlist is deployed separately on Vercel.

The previous CodeRabbit pass has been inspected and its two actionable findings
are addressed. A second review cycle is intentionally skipped for this launch
batch; normal CI remains required. This does not claim a new live benchmark or
comprehensive artist acceptance of every Blender tool.

@coderabbitai

coderabbitai Bot commented Jul 29, 2026 •

Copy link
Copy Markdown

Review Change Stack

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: dbd6c5c4-dbf2-47cd-9122-0c6527f89163

Note

Reviews paused

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

The PR replaces the private data/tool-guides corpus with an installable public agent skill and reference documents, updates guidance lookup and package exports, and documents native MCP client setup, portable gateway usage, and Docker limitations.

Changes

Portable skill migration

Layer / File(s) Summary
Agent skill and reference corpus
skills/using-vipermesh-blender/*, data/tool-guides/*
Adds the using-vipermesh-blender skill and five focused reference documents while removing the previous private tool-guide corpus.
Guidance lookup migration
lib/portable-mcp/guidance.ts, lib/portable-mcp/server.ts, tests/conformance.ts
Resolves guidance from the skill references directory, enforces path containment, emits tool-skills results, updates tool descriptions, and strengthens conformance checks.
Public package contents
package.json, scripts/validate-package.mjs
Packages skills instead of data and verifies required public skill files while rejecting data/tool-guides.
Client setup and public documentation
README.md, docs/client-setup.md, docs/portable-blender-mcp.md, llms.txt, CHANGELOG.md
Documents native stdio configuration through the built Node entry point, skill-based retrieval, optional unsupported Docker Toolkit usage, and the public skill migration.

Estimated code review effort: 3 (Moderate) | ~20 minutes

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

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.
Description check ⚠️ Warning The description includes a summary and validation details, but its main claims about GitHub Pages, image previews, finalize behavior, and spatial checks are not supported by the file summaries or stat… Rewrite the summary to describe the portable Blender agent skill, MCP client setup documentation, guidance migration, and package validation changes shown in the pull request. Keep only implementation claims supported by the changes. Add a …
✅ Passed checks (3 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 is concise and partly matches the changes: the skill and setup documentation support a public connector launch, and the new references cover scene review. The file summaries do not show a co…
Full details: Description check

Explanation

The description includes a summary and validation details, but its main claims about GitHub Pages, image previews, finalize behavior, and spatial checks are not supported by the file summaries or stated objectives. It also omits the required Blender impact section.

Resolution

Rewrite the summary to describe the portable Blender agent skill, MCP client setup documentation, guidance migration, and package validation changes shown in the pull request. Keep only implementation claims supported by the changes. Add a Blender impact section with tested versions, scene mutation risk, and rollback behavior, and clarify the validation performed.

✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/mcp-client-tool-skills

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: 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 `@scripts/validate-package.mjs`:
- Around line 11-17: Update the package validation assertions in
scripts/validate-package.mjs to verify every expected shipped reference file,
rather than checking only
skills/using-vipermesh-blender/references/spatial-validation.md. Prefer
validating the complete npm pack dry-run file list if that is the established
approach; otherwise add assertions for all expected reference files while
preserving the existing skill and data/tool-guides checks.

In `@skills/using-vipermesh-blender/references/scene-operations.md`:
- Around line 34-36: Update the completion workflow around
run_blender_scene_stage so blend-file saving occurs only for mutating tasks when
the user explicitly provides and approves blendPath. Preserve inspection-only
and render/export-only workflows without saving or overwriting a blend file,
while continuing to produce any requested render or export artifacts.
🪄 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 Plus

Run ID: 8a3b9fd8-a01f-4f28-a4fc-fa52ba71573e

📥 Commits

Reviewing files that changed from the base of the PR and between dc24190 and fd5779e.

📒 Files selected for processing (36)
  • CHANGELOG.md
  • README.md
  • data/tool-guides/aesthetic-quality-guide.md
  • data/tool-guides/animation-guide.md
  • data/tool-guides/architectural-completeness-guide.md
  • data/tool-guides/blend-file-health-guide.md
  • data/tool-guides/blender-docs-lookup-guide.md
  • data/tool-guides/camera-guide.md
  • data/tool-guides/execute-code-guide.md
  • data/tool-guides/export-guide.md
  • data/tool-guides/lighting-guide.md
  • data/tool-guides/local-asset-guide.md
  • data/tool-guides/material-realism-guide.md
  • data/tool-guides/materials-guide.md
  • data/tool-guides/modifiers-guide.md
  • data/tool-guides/object-assembly-guide.md
  • data/tool-guides/render-guide.md
  • data/tool-guides/rigging-guide.md
  • data/tool-guides/scene-composition-guide.md
  • data/tool-guides/scene-management-guide.md
  • data/tool-guides/spatial-positioning-guide.md
  • data/tool-guides/weight-painting-guide.md
  • docs/client-setup.md
  • docs/portable-blender-mcp.md
  • lib/portable-mcp/guidance.ts
  • lib/portable-mcp/server.ts
  • llms.txt
  • package.json
  • scripts/validate-package.mjs
  • skills/using-vipermesh-blender/SKILL.md
  • skills/using-vipermesh-blender/references/character-animation-export.md
  • skills/using-vipermesh-blender/references/geometry-materials-assets.md
  • skills/using-vipermesh-blender/references/scene-operations.md
  • skills/using-vipermesh-blender/references/spatial-validation.md
  • skills/using-vipermesh-blender/references/visual-presentation.md
  • tests/conformance.ts
💤 Files with no reviewable changes (20)
  • data/tool-guides/rigging-guide.md
  • data/tool-guides/export-guide.md
  • data/tool-guides/execute-code-guide.md
  • data/tool-guides/aesthetic-quality-guide.md
  • data/tool-guides/blender-docs-lookup-guide.md
  • data/tool-guides/modifiers-guide.md
  • data/tool-guides/animation-guide.md
  • data/tool-guides/scene-composition-guide.md
  • data/tool-guides/object-assembly-guide.md
  • data/tool-guides/local-asset-guide.md
  • data/tool-guides/lighting-guide.md
  • data/tool-guides/material-realism-guide.md
  • data/tool-guides/weight-painting-guide.md
  • data/tool-guides/render-guide.md
  • data/tool-guides/camera-guide.md
  • data/tool-guides/blend-file-health-guide.md
  • data/tool-guides/architectural-completeness-guide.md
  • data/tool-guides/scene-management-guide.md
  • data/tool-guides/spatial-positioning-guide.md
  • data/tool-guides/materials-guide.md

Comment on lines +11 to +17
assert.ok(fs.existsSync("skills/using-vipermesh-blender/SKILL.md"))
assert.ok(
fs.existsSync(
"skills/using-vipermesh-blender/references/spatial-validation.md"
)
)
assert.ok(!fs.existsSync("data/tool-guides"))

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🗄️ Data Integrity & Integration | 🔵 Trivial | ⚡ Quick win

Validate every shipped skill reference, not just one.

These assertions cover only spatial-validation.md; a missing package reference could pass validation and fail at runtime when requested. Assert all expected reference files, or inspect the npm pack --dry-run --json file list.

🤖 Prompt for 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.

In `@scripts/validate-package.mjs` around lines 11 - 17, Update the package
validation assertions in scripts/validate-package.mjs to verify every expected
shipped reference file, rather than checking only
skills/using-vipermesh-blender/references/spatial-validation.md. Prefer
validating the complete npm pack dry-run file list if that is the established
approach; otherwise add assertions for all expected reference files while
preserving the existing skill and data/tool-guides checks.

Comment on lines +34 to +36
Before reporting completion, confirm that the requested objects and changes
exist, inspect any high-risk structural relationships, save the intended blend
file, and produce the visual or export artifact requested by the user.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Make blend-file saving conditional on the user’s requested output.

run_blender_scene_stage exposes renderPath and blendPath as optional, and the skill supports inspection-only sessions. Requiring every workflow to save a blend file can cause an unsolicited write or overwrite when no destination was requested. Save only for mutating tasks with an explicit user-approved path.

🛡️ Proposed wording
-Before reporting completion, confirm that the requested objects and changes
-exist, inspect any high-risk structural relationships, save the intended blend
-file, and produce the visual or export artifact requested by the user.
+Before reporting completion, confirm that the requested objects and changes
+exist and inspect any high-risk structural relationships. For mutating tasks,
+save the blend file only when the user has requested an output path; produce
+visual or export artifacts only when requested.
📝 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
Before reporting completion, confirm that the requested objects and changes
exist, inspect any high-risk structural relationships, save the intended blend
file, and produce the visual or export artifact requested by the user.
Before reporting completion, confirm that the requested objects and changes
exist and inspect any high-risk structural relationships. For mutating tasks,
save the blend file only when the user has requested an output path; produce
visual or export artifacts only when requested.
🤖 Prompt for 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.

In `@skills/using-vipermesh-blender/references/scene-operations.md` around lines
34 - 36, Update the completion workflow around run_blender_scene_stage so
blend-file saving occurs only for mutating tasks when the user explicitly
provides and approves blendPath. Preserve inspection-only and render/export-only
workflows without saving or overwriting a blend file, while continuing to
produce any requested render or export artifacts.

@Ker102

Ker102 commented Oct 6, 2026

Copy link
Copy Markdown
Collaborator Author

@coderabbitai pause

The existing review has been inspected. Both findings are addressed in the
upcoming coherent launch batch: every shipped skill reference is validated,
and blend saving is requested explicitly with an optional blendPath. Finalize
also supports preserving existing presentation and checking named spatial
constraints. We are intentionally avoiding a second review cycle and will rely
on the package/conformance checks and normal CI for publication.

@coderabbitai

coderabbitai Bot commented Oct 6, 2026

Copy link
Copy Markdown

@Ker102, I’ll pause automatic reviews. I won’t trigger another review cycle. I understand that you will rely on package checks, conformance checks, and normal CI for publication.

✅ Action performed

Reviews paused.

@Ker102 Ker102 changed the title docs: add persistent MCP client skill setup feat: launch public connector site and harden scene review Oct 7, 2026
@Ker102
Ker102 merged commit 74b9ada into main Oct 7, 2026
2 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