Weavatrix Refactor Js

Name: Weavatrix Refactor Js
Author: sergii-ziborov

โดย sergii-ziborovรุ่น 0.1.6i★ –iรันบนเครื่อง

ชื่อใน registryio.github.sergii-ziborov/weavatrix-refactor-js

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Transactional refactoring MCP with 11 evidence-backed tools, hash-bound previews, and rollback.

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังใหม่มาก↓ 39/สัปดาห์ · ★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: อื่น ๆ

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: WEAVATRIX_ALLOW_SOURCE_EDITS, WEAVATRIX_REFACTOR_HOME, WEAVATRIX_PRECISION

ต้องเตรียมก่อน

npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "weavatrix-refactor-js": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix-refactor-js"
      ],
      "env": {
        "WEAVATRIX_ALLOW_SOURCE_EDITS": "ใส่ค่าของคุณ",
        "WEAVATRIX_REFACTOR_HOME": "ใส่ค่าของคุณ",
        "WEAVATRIX_PRECISION": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add weavatrix-refactor-js --env WEAVATRIX_ALLOW_SOURCE_EDITS='ใส่ค่าของคุณ' --env WEAVATRIX_REFACTOR_HOME='ใส่ค่าของคุณ' --env WEAVATRIX_PRECISION='ใส่ค่าของคุณ' -- npx -y weavatrix-refactor-js

เติมค่าที่เว้นว่างไว้ก่อนรัน

ตัวนี้ต้องใส่ค่าในคำสั่งเปิดเอง ให้คัดลอกค่าตั้งแล้วเติมค่า

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "weavatrix-refactor-js": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix-refactor-js"
      ],
      "env": {
        "WEAVATRIX_ALLOW_SOURCE_EDITS": "ใส่ค่าของคุณ",
        "WEAVATRIX_REFACTOR_HOME": "ใส่ค่าของคุณ",
        "WEAVATRIX_PRECISION": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

ตัวนี้ต้องใส่ค่าในคำสั่งเปิดเอง ให้คัดลอกค่าตั้งแล้วเติมค่า

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "weavatrix-refactor-js": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "weavatrix-refactor-js"
      ],
      "env": {
        "WEAVATRIX_ALLOW_SOURCE_EDITS": "ใส่ค่าของคุณ",
        "WEAVATRIX_REFACTOR_HOME": "ใส่ค่าของคุณ",
        "WEAVATRIX_PRECISION": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

WEAVATRIX_ALLOW_SOURCE_EDITS env
Set to 1 to authorize apply_edit_plan and rollback to write source files; unset, the refactor tools stay preview-only
WEAVATRIX_REFACTOR_HOME env
Optional directory for the rollback snapshot store; defaults to a per-repo location
WEAVATRIX_PRECISION env
Core semantic precision: lsp (default) or off

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 9 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub sergii-ziborov ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด อื่น ๆi

ดาวมากกว่า 0% ของอีก 18725 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 19% ของอีก 18725 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 18725 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Weavatrix Refactor Js ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.1.6) เข้า registry 3 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, WCS Points

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

โดย formulahendryเริ่มต้น↓ 66/สัปดาห์★ 440อัปเดต 14 เดือนที่ผ่านมา

รันบนเครื่อง

ติดตั้ง

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

โดย desktop-commanderกำลังโต★ 211อัปเดต 4 วันที่ผ่านมา

รันบนคลาวด์✓ desktopcommander.app

ติดตั้ง

WCS Points

West Coast Swing WSDC points registry: dancer points, divisions, level-ups, event results and rules.

โดย akarakotovเริ่มต้นอัปเดต วันนี้

รันบนคลาวด์✓ wcspoints.com

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Weavatrix Refactor JS

Part of the Weavatrix ecosystem. This repository preserves the explicit JavaScript refactoring line.

This is the JavaScript refactoring engine of Weavatrix, continued as

weavatrix-refactor-js. The

weavatrix-refactor

package ships the native Rust MCP host built on

weavatrix-rust and the

weavatrix-edit / weavatrix-refactor-plan / weavatrix-worktree crates.

This package continues that version line: weavatrix-refactor@0.1.5 was the

last JavaScript release under the old name, and weavatrix-refactor-js@0.1.6

picks up from it. Install weavatrix-refactor-js, or pin

weavatrix-refactor@0.1.5, to stay on the JavaScript implementation.

Evidence-backed, transactional refactoring for coding agents.

weavatrix-refactor-js is the write-capable member of the JavaScript family. It combines the complete read-only weavatrix-js code-intelligence MCP with 11 refactoring tools that can prove a change, preview it against the current working tree, apply it atomically, refresh the graph, and roll it back.

Engine boundary: this package hosts the weavatrix-js engine. It does not

use the native weavatrix-rust engine, and installing both packages does not

silently upgrade this one's analysis layer. Its state lives in

~/.weavatrix-refactor-js, kept separate from the Rust host's so the two

never share a lock, a token store, or a rollback journal.

It is substantially more than a rename wrapper:

semantic JS/TS rename through the bundled language server;
SQL table and field rename with schema-aware evidence;
strict graph-plus-lexical rename for Python, Rust, Go, Java, C#, and Solidity;
several related JS/TS renames merged into one atomic transaction;
signature, symbol-body, import, bulk-replace, move, and delete-safety workflows;
byte-exact file hashes, before text, provenance, uncertainty, and graph revision in every applyable plan;
stale-tree detection, repository locking, rollback bundles, and automatic rollback after a mid-write failure;
architecture and cycle projection before structural moves;
post-change blast-radius and verification tools inherited from the core.

Why this is a separate package

The MIT weavatrix-js core is physically read-only: its published artifact has no repository source-write path. This package is the explicit write boundary. Installing it and selecting its refactor profile makes the edit capability visible; without this package, the server cannot modify source.

The split is a safety property, not packaging cosmetics:

weavatrix-js core       weavatrix-refactor-js                 repository

read-only evidence -> plan + preview + confirmation -> atomic write graph / LSP / audit hashes / provenance / rollback refreshed graph

Architecture

The implementation is a ports-and-adapters system with one-way boundaries:

edit-plan model  <-  filesystem / lock / token adapters

^ ^ | | plan engines -> preview / apply / rollback workflows -> MCP adapter

Model validates the frozen weavatrix.edit-plan.v1 envelope and applies byte-exact edits as pure string transformations.
Platform adapters own real-path containment, atomic replacement, repository locks, single-use tokens, and durable rollback bundles.
Plan engines compute rename, signature, symbol, import, move, delete, and bulk-replace evidence without owning the write workflow.
Application workflows bind a preview to the current repository, issue and consume confirmation tokens, apply under a lock, and restore on failure.
MCP adapter composes the 11 refactor tools with the read-only weavatrix-js catalog and exposes one stdio server.

The checked-in strict architecture contract enforces zero runtime cycles, files no longer than 300 lines, and functions no longer than 100 lines. It has no exceptions or ratchet baseline.

What makes the refactor workflow different

An ordinary editor rename answers: "Which text edits should I make now?" Weavatrix Refactor also answers:

Question	Evidence returned
Is this the exact symbol?	Stable graph symbol id plus parser/LSP selection range
Which references are proven?	Per-edit provenance: `EXACT_LSP`, `RESOLVED`, `EXTRACTED`, or `LEXICAL_EXACT`
What was not proven?	Explicit `uncertainReferences`, `notModified`, warnings, and `PARTIAL` completeness
Which files were even looked at?	The rename session seeds every graph-declared reference plus every indexed file whose text contains the identifier; anything it could not open is named and forces `PARTIAL`
Did the tree change after preview?	File sha256 plus exact `before` text rechecked under the write lock
Can several renames partially succeed?	No. Related renames are conflict-checked and applied as one transaction
What happens after a disk/write failure?	Already-written files are restored; a durable rollback bundle remains
Will a move worsen architecture?	Projected runtime cycles, boundary violations, improvements, and blast radius
Did the refactor preserve behavior-shaped structure?	Refreshed graph plus `verified_change` caller/import/reference conservation

The system fails closed when proof is insufficient. It never upgrades an INFERRED edge into an applyable edit and never hides an ambiguous reference.

The complete rename workflow

rename_symbol and rename_related_symbols are complete operations, not PLANNED-only helpers. Each method owns both phases.

1. Preview

Call the rename method normally:

"symbol": "src/users.ts#getUser@12", "new_name": "getCustomer" }

The method computes the rename, validates every plan file against the working tree, and returns PREVIEW_OK with a short-lived confirmToken. Preview never writes source and does not require the environment write gate.

2. Apply through the same method

Repeat the same operation inputs and add the confirmation:

"symbol": "src/users.ts#getUser@12", "new_name": "getCustomer", "mode": "apply", "confirm_token": " " }

The tool recomputes the deterministic plan, verifies that the token belongs to that plan and repository, takes the repository lock, rechecks hashes and before text, writes a rollback bundle, and applies every edit bottom-up.

The same contract applies to a coordinated set:

"renames": [ {"symbol": "src/api.ts#getUser@8", "new_name": "getCustomer"}, {"symbol": "src/api.ts#getOrder@20", "new_name": "getPurchase"} ] }

rename_related_symbols detects overlapping edits, chains, swaps, shadowing risk, and per-sub-rename failure before it issues a token. Apply is one atomic multi-file operation.

Refactoring tools

Complete write workflows

Tool	What it actually does
`rename_symbol`	Cross-language preview/confirm/apply rename. Dispatches to exact JS/TS LSP, SQL schema, or strict graph+lexical backends; returns honest backend completeness and every uncovered reference.
`rename_related_symbols`	Coordinates up to 50 JS/TS symbol renames in one shared language-server session and one atomic edit plan. Detects conflicts, chains, swaps, snapshot drift, and any failed sub-rename before writing.
`apply_edit_plan`	Generic two-phase executor for `weavatrix.edit-plan.v1` envelopes from the other tools or `weavatrix-online`. Preview issues a plan-bound token; apply writes atomically with rollback.
`rollback_last_apply`	Restores the latest pre-apply bundle. Refuses if post-apply files drifted; retries converge after an incomplete restore.

Proven plan producers

Tool	What it actually does
`change_signature`	Adds or removes a JS/TS function or method parameter. Performs byte-exact declaration and call-argument surgery; spread calls and value-requiring additions remain explicit uncertainty.
`edit_symbol`	Uses the indexed parser range for `replace_symbol_body`, `insert_before_symbol`, or `insert_after_symbol`. JS/TS output is parse-gated; line endings and UTF-16 coordinates are preserved.
`bulk_replace`	Two-stage, occurrence-selective replacement over indexed files. First returns stable occurrence ids; the second call accepts chosen ids or an exact expected count and emits a hash-bound plan. Literal mode is the default; regex replacements use real capture expansion.
`organize_imports`	Removes only provably unused named JS/TS imports. Default and namespace imports stay uncertain; side-effect imports are untouched; sorting is deliberately left to the formatter.

These plans are applied with apply_edit_plan, using the same preview, token, atomic-write, and rollback protocol as rename.

Structural review and safety tools

Tool	What it actually does
`move_file`	Builds a JS/TS relocate review: rewrites importer specifiers and the moved file's own relative imports, then projects architecture effects. File renaming itself remains an explicit editor/agent action, so this is intentionally not an apply envelope.
`move_symbol`	Projects a declaration move without inventing byte edits. Reports introduced/removed runtime cycles, target-file dependencies, architecture violations or improvements, and blast radius.
`delete_readiness`	Returns `safe: true`, `false`, or `UNPROVEN` with known references, dynamic/reflection risks, confidence, and the declaration span. Exported symbols are capped at `UNPROVEN`; deletion is never automated.

Language and proof matrix

Surface	Backend	Applyable provenance	Completeness contract
JavaScript / TypeScript rename	Bundled TypeScript language server	`EXACT_LSP`	`COMPLETE` only when every file that could mention the symbol was opened in the rename session and proven; any candidate left out forces `PARTIAL`
SQL table rename	Schema-aware SQL scanner across SQL and host files	`EXTRACTED` / `LEXICAL_EXACT`	Reports every skipped or ambiguous reference
SQL field rename	Definition-safe SQL backend	Proven definition edits only	Usages remain `UNPROVEN` rather than guessed
Python / Rust / Go / Java / C# / Solidity rename	Indexed graph references plus exact lexical location on the recorded line	`EXTRACTED` / `LEXICAL_EXACT`	Always `PARTIAL`; ambiguous lines are never edited
JS/TS signature and imports	Parser plus graph call/reference evidence	`EXTRACTED` / `RESOLVED`	Explicitly partial where graph reach cannot prove absence
Symbol-anchored edit	Indexed parser ranges for every indexed language	`EXTRACTED`	JS/TS parse gate; other languages retain the parser-range evidence boundary

Edit-plan proof envelope

Every applyable plan uses weavatrix.edit-plan.v1. Its load-bearing fields are:

operation and graph revision;
repository-relative target paths only;
sha256 of every target file;
exact 1-based line and UTF-16 character ranges;
exact before and after text;
per-edit provenance;
uncertainReferences, notModified, warnings, and completeness.

The applier additionally protects against:

absolute paths, traversal, .git casing/trailing-dot tricks, NTFS streams, and escaping symlinks/junctions;
non-UTF-8 or oversized files;
overlapping edits, stale ranges, lone surrogates, and edits that split surroga

ตัดมาแค่ช่วงต้น อ่านต่อใน repo

Weavatrix Refactor Js

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด อื่น ๆi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Spec Driven Development

Remote Desktop Commander

WCS Points

README จากผู้ทำ

Weavatrix Refactor JS

Why this is a separate package

Architecture

What makes the refactor workflow different

The complete rename workflow

1. Preview

2. Apply through the same method

Refactoring tools

Complete write workflows

Proven plan producers

Structural review and safety tools

Language and proof matrix

Edit-plan proof envelope