Weavatrix Refactor Js

Name: Weavatrix Refactor Js
Author: sergii-ziborov

von sergii-ziborovVersion 0.1.6i★ –iLäuft auf deinem Computer

Name in der Registryio.github.sergii-ziborov/weavatrix-refactor-js

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiGanz neu↓ 39/Wo. · ★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: WEAVATRIX_ALLOW_SOURCE_EDITS, WEAVATRIX_REFACTOR_HOME, WEAVATRIX_PRECISION

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "weavatrix-refactor-js": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix-refactor-js"
      ],
      "env": {
        "WEAVATRIX_ALLOW_SOURCE_EDITS": "your-value",
        "WEAVATRIX_REFACTOR_HOME": "your-value",
        "WEAVATRIX_PRECISION": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add weavatrix-refactor-js --env WEAVATRIX_ALLOW_SOURCE_EDITS=your-value --env WEAVATRIX_REFACTOR_HOME=your-value --env WEAVATRIX_PRECISION=your-value -- npx -y weavatrix-refactor-js

Trag die leeren Werte ein, bevor du ihn startest.

Dieser Server braucht Werte in seiner Befehlszeile, also kopier die Einstellungen und trag sie ein.

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "weavatrix-refactor-js": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix-refactor-js"
      ],
      "env": {
        "WEAVATRIX_ALLOW_SOURCE_EDITS": "your-value",
        "WEAVATRIX_REFACTOR_HOME": "your-value",
        "WEAVATRIX_PRECISION": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server braucht Werte in seiner Befehlszeile, also kopier die Einstellungen und trag sie ein.

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "weavatrix-refactor-js": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "weavatrix-refactor-js"
      ],
      "env": {
        "WEAVATRIX_ALLOW_SOURCE_EDITS": "your-value",
        "WEAVATRIX_REFACTOR_HOME": "your-value",
        "WEAVATRIX_PRECISION": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

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

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 9. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto sergii-ziborov bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 18871 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 19 % der anderen 18871 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 18871 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Weavatrix Refactor Js sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.6) kam vor 3 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, NotebookLM MCP

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

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

von formulahendryAm Anfang↓ 66/Wo.★ 440Aktualisiert vor 14 Monaten

Läuft auf deinem Computer

Installieren

Remote Desktop Commander

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

von desktop-commanderWachsend★ 211Aktualisiert vor 4 Tagen

Läuft in der Cloud✓ desktopcommander.app

Installieren

NotebookLM MCP

Google Gemini Notebook (ex NotebookLM) over MCP + a local REST API — cited answers, Studio, history

von roomi-fieldsAm Anfang↓ 1331/Wo.Aktualisiert heute

Läuft auf deinem Computer

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Weavatrix Refactor Js

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

NotebookLM MCP

README vom Entwickler

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