weavatrix 1.17.3 → 1.17.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -13
- package/bin/native/darwin-arm64/weavatrix +0 -0
- package/bin/native/darwin-x64/weavatrix +0 -0
- package/bin/native/linux-arm64/weavatrix +0 -0
- package/bin/native/linux-x64/weavatrix +0 -0
- package/bin/native/win32-arm64/weavatrix.exe +0 -0
- package/bin/native/win32-x64/weavatrix.exe +0 -0
- package/package.json +2 -2
- package/server.json +2 -2
- package/skill/SKILL.md +11 -4
- package/skill/references/tool-routing.md +1 -1
- package/skill/references/tools/architecture_inventory.md +20 -5
package/README.md
CHANGED
|
@@ -58,7 +58,7 @@ weavatrix mcp .
|
|
|
58
58
|
```toml
|
|
59
59
|
[mcp_servers.weavatrix]
|
|
60
60
|
command = "npx"
|
|
61
|
-
args = ["-y", "weavatrix@1.17.
|
|
61
|
+
args = ["-y", "weavatrix@1.17.4", "mcp", "."]
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
Pass an absolute repository path when the Codex process cwd is not the project
|
|
@@ -67,7 +67,7 @@ you intend to analyze.
|
|
|
67
67
|
### Claude Code
|
|
68
68
|
|
|
69
69
|
```sh
|
|
70
|
-
claude mcp add weavatrix -- npx -y weavatrix@1.17.
|
|
70
|
+
claude mcp add weavatrix -- npx -y weavatrix@1.17.4 mcp .
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
### Cursor
|
|
@@ -80,7 +80,7 @@ the plugin for the same server name:
|
|
|
80
80
|
"mcpServers": {
|
|
81
81
|
"weavatrix": {
|
|
82
82
|
"command": "npx",
|
|
83
|
-
"args": ["-y", "weavatrix@1.17.
|
|
83
|
+
"args": ["-y", "weavatrix@1.17.4", "mcp", "${workspaceFolder}"]
|
|
84
84
|
}
|
|
85
85
|
}
|
|
86
86
|
}
|
|
@@ -89,14 +89,14 @@ the plugin for the same server name:
|
|
|
89
89
|
Profiles expose bounded views of the same engine:
|
|
90
90
|
|
|
91
91
|
```sh
|
|
92
|
-
npx -y weavatrix@1.17.
|
|
93
|
-
npx -y weavatrix@1.17.
|
|
94
|
-
npx -y weavatrix@1.17.
|
|
95
|
-
npx -y weavatrix@1.17.
|
|
96
|
-
npx -y weavatrix@1.17.
|
|
97
|
-
npx -y weavatrix@1.17.
|
|
98
|
-
npx -y weavatrix@1.17.
|
|
99
|
-
npx -y weavatrix@1.17.
|
|
92
|
+
npx -y weavatrix@1.17.4 mcp . --profile=all
|
|
93
|
+
npx -y weavatrix@1.17.4 mcp . --profile=code
|
|
94
|
+
npx -y weavatrix@1.17.4 mcp . --profile=seo
|
|
95
|
+
npx -y weavatrix@1.17.4 mcp . --profile=n8n
|
|
96
|
+
npx -y weavatrix@1.17.4 mcp . --profile=dify
|
|
97
|
+
npx -y weavatrix@1.17.4 mcp . --profile=agent
|
|
98
|
+
npx -y weavatrix@1.17.4 mcp . --profile=diagram
|
|
99
|
+
npx -y weavatrix@1.17.4 mcp . --profile=web3
|
|
100
100
|
```
|
|
101
101
|
|
|
102
102
|
The package contains native binaries for Windows x64/arm64, macOS x64/arm64,
|
|
@@ -121,6 +121,10 @@ same, and a call that names its own `output_format` still wins.
|
|
|
121
121
|
|
|
122
122
|
`json` is the default and keeps the mirror, because a client that ignores
|
|
123
123
|
`structuredContent` would otherwise see an empty result.
|
|
124
|
+
For an architecture question, call `architecture_inventory` with no arguments
|
|
125
|
+
and explain its modular, onion, layered, and ports-and-adapters hypotheses in
|
|
126
|
+
prose. Report `CANDIDATE` and `INSUFFICIENT_EVIDENCE` honestly; the declared
|
|
127
|
+
contract style is not evidence of the observed architecture.
|
|
124
128
|
|
|
125
129
|
### What the new domains actually answer
|
|
126
130
|
|
|
@@ -251,6 +255,11 @@ Pagination and explicit limits bound large neighborhoods, histories, searches,
|
|
|
251
255
|
and contract inventories.
|
|
252
256
|
|
|
253
257
|
`build_graph` and `architecture_inventory` share one typed build model. They
|
|
258
|
+
also report independent, evidence-bounded hypotheses for modular source
|
|
259
|
+
organization, onion, ports-and-adapters, layered dependencies, and deployment
|
|
260
|
+
uncertainty; the declared target style is never observation. The summary
|
|
261
|
+
includes each hypothesis's status, supporting signals, contradictions, and
|
|
262
|
+
unknowns; use `detail:"full"` for paged graph evidence. They
|
|
254
263
|
preserve nested Cargo, npm/TypeScript, Go, and Python components, many-to-many
|
|
255
264
|
declared memberships, collision-free identities, configuration predicates,
|
|
256
265
|
and immutable source evidence. Totals and SCC/cycle witnesses are computed
|
|
@@ -316,11 +325,11 @@ coding agent
|
|
|
316
325
|
|
|
|
317
326
|
| MCP over stdio
|
|
318
327
|
v
|
|
319
|
-
weavatrix 1.17.
|
|
328
|
+
weavatrix 1.17.4
|
|
320
329
|
profile catalog · refresh · watcher · MCP framing
|
|
321
330
|
|
|
|
322
331
|
v
|
|
323
|
-
weavatrix-rust 2.17.
|
|
332
|
+
weavatrix-rust 2.17.3
|
|
324
333
|
typed graph · analysis · 67 product operations including local CI, n8n, Dify, agent packages, Mermaid, and Web3
|
|
325
334
|
```
|
|
326
335
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "weavatrix",
|
|
3
|
-
"version": "1.17.
|
|
4
|
-
"weavatrixEngineVersion": "2.17.
|
|
3
|
+
"version": "1.17.4",
|
|
4
|
+
"weavatrixEngineVersion": "2.17.3",
|
|
5
5
|
"description": "Native repository intelligence for coding agents: 67 read-only MCP operations backed by typed evidence graphs, impact, architecture, local CI restrictions, APIs, Git, search, semantics, memory, n8n workflows, Dify apps, agent packages, Mermaid diagrams, and Web3 ABIs.",
|
|
6
6
|
"author": "Sergii Ziborov <sergii.ziborov@gmail.com>",
|
|
7
7
|
"license": "MIT",
|
package/server.json
CHANGED
|
@@ -7,14 +7,14 @@
|
|
|
7
7
|
"url": "https://github.com/Weavatrix/weavatrix",
|
|
8
8
|
"source": "github"
|
|
9
9
|
},
|
|
10
|
-
"version": "1.17.
|
|
10
|
+
"version": "1.17.4",
|
|
11
11
|
"websiteUrl": "https://weavatrix.com",
|
|
12
12
|
"packages": [
|
|
13
13
|
{
|
|
14
14
|
"registryType": "npm",
|
|
15
15
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
16
16
|
"identifier": "weavatrix",
|
|
17
|
-
"version": "1.17.
|
|
17
|
+
"version": "1.17.4",
|
|
18
18
|
"runtimeHint": "npx",
|
|
19
19
|
"transport": {
|
|
20
20
|
"type": "stdio"
|
package/skill/SKILL.md
CHANGED
|
@@ -23,10 +23,17 @@ contracts. Do not call it merely because the server is available.
|
|
|
23
23
|
1. Call `graph_stats` and confirm `repository_context.root` matches the workspace
|
|
24
24
|
you intend. The MCP process is pinned to its launch root; it will not silently
|
|
25
25
|
answer for another repository.
|
|
26
|
-
2. For "what is this repository's architecture?",
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
26
|
+
2. For "what is this repository's architecture?", including "is it onion,
|
|
27
|
+
modular, layered, or ports-and-adapters?", call `architecture_inventory`
|
|
28
|
+
with no `detail` argument (bounded summary). Read
|
|
29
|
+
`architecture_hypotheses.hypotheses`: report each relevant `SUPPORTED`,
|
|
30
|
+
`CANDIDATE`, `CONTRADICTED`, or `INSUFFICIENT_EVIDENCE` status with one
|
|
31
|
+
decisive dependency witness or missing signal. Explain the result,
|
|
32
|
+
component areas, and limits in concise prose; do not paste the JSON. Do
|
|
33
|
+
not turn a candidate into a confirmed style, or use a declared contract
|
|
34
|
+
`style` as proof of the observed architecture. See
|
|
35
|
+
[references/tools/architecture_inventory.md](references/tools/architecture_inventory.md)
|
|
36
|
+
for the interpretation rules. Use
|
|
30
37
|
`module_map` for a directory-focused question, or `search_code` for a
|
|
31
38
|
known literal. Request `architecture_inventory` with `detail:"full"`
|
|
32
39
|
only when a specific component, edge, or cycle needs source evidence.
|
|
@@ -41,7 +41,7 @@ cannot silently switch to another repository. Pass an explicit
|
|
|
41
41
|
|
|
42
42
|
## Quality and architecture
|
|
43
43
|
|
|
44
|
-
- [`architecture_inventory`](tools/architecture_inventory.md) — Bounded architecture overview by default, with complete edge/cycle-candidate totals; `detail:"full"` gives paged evidence. Explain
|
|
44
|
+
- [`architecture_inventory`](tools/architecture_inventory.md) — Bounded architecture overview and evidence-bounded style hypotheses by default, with complete edge/cycle-candidate totals; `detail:"full"` gives paged evidence. Explain statuses and witnesses in prose, not as a JSON dump.
|
|
45
45
|
- [`ci_restrictions`](tools/ci_restrictions.md) — Local GitHub Actions checks and conditional applicability.
|
|
46
46
|
- [`explain_restriction`](tools/explain_restriction.md) — One restriction and its evidence limits.
|
|
47
47
|
- [`find_duplicates`](tools/find_duplicates.md) — Deterministic Type-1/2/3 clone families.
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
# `architecture_inventory`
|
|
2
2
|
|
|
3
|
-
Observed package, nested component, declared-membership,
|
|
4
|
-
evidence. The default is a bounded
|
|
5
|
-
dump.
|
|
3
|
+
Observed package, nested component, declared-membership, typed edge, and
|
|
4
|
+
architecture-style evidence. The default is a bounded overview, not a raw
|
|
5
|
+
graph dump. Style findings are independent hypotheses, never the target
|
|
6
|
+
contract's declared style.
|
|
6
7
|
|
|
7
8
|
## When to use
|
|
8
9
|
|
|
@@ -31,8 +32,22 @@ the component quotient is reported as architecture, not as symbol recursion.
|
|
|
31
32
|
{"name":"architecture_inventory","arguments":{}}
|
|
32
33
|
```
|
|
33
34
|
|
|
34
|
-
|
|
35
|
-
|
|
35
|
+
Read `architecture_hypotheses.hypotheses` first. `modular_source` concerns
|
|
36
|
+
source organization; `onion` and `layered` concern dependency direction;
|
|
37
|
+
`ports_and_adapters` concerns core interfaces and adapters; `microservices`
|
|
38
|
+
concerns deployment and remains unconfirmed without independent deployment
|
|
39
|
+
evidence. These dimensions may coexist. `SUPPORTED` means the rule's static
|
|
40
|
+
signals were observed, not that architectural intent or runtime behavior was
|
|
41
|
+
proven. `CANDIDATE` requires qualified language, `CONTRADICTED` needs its
|
|
42
|
+
counterexample, and `INSUFFICIENT_EVIDENCE` must not be turned into absence.
|
|
43
|
+
Path names are weak role candidates; inspect `observed_signals`,
|
|
44
|
+
`contradictions`, and `unknowns`. Never use a contract `style`, green
|
|
45
|
+
`verify_architecture` result, or package count as proof of an observed style.
|
|
46
|
+
|
|
47
|
+
Answer in your own concise prose, for example: "Modular source organization:
|
|
48
|
+
supported (module markers and cross-directory imports). Onion: insufficient
|
|
49
|
+
evidence (no application-to-domain and outer-to-core chain)." Include one
|
|
50
|
+
decisive file-level witness when available, not the entire JSON. Never
|
|
36
51
|
present a quotient/union cycle candidate as a proven executable cycle. Ask
|
|
37
52
|
for `{"detail":"full"}` only to inspect a specific edge, component, or
|
|
38
53
|
cycle witness. The full response can be large and paginates edges.
|