@mmerterden/multi-agent-toolkit-mcp 3.9.0 → 3.12.0
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/CHANGELOG.md +239 -0
- package/README.md +79 -2
- package/README.tr.md +6 -3
- package/index.js +160 -21
- package/package.json +9 -3
- package/tools/code-intel/index.js +665 -0
- package/tools/code-intel/kotlin.js +159 -0
- package/tools/code-intel/lsp-client.js +422 -0
- package/tools/code-intel/pool.js +273 -0
- package/tools/code-intel/positions.js +195 -0
- package/tools/code-intel/swift.js +249 -0
- package/tools/ios-app-store-audit/context.js +160 -9
- package/tools/ios-app-store-audit/index.js +24 -1
- package/tools/offload/index.js +28 -8
- package/tools/pass-kit/index.js +432 -0
- package/tools/pass-kit/sign.js +255 -0
- package/tools/pass-kit/spec.js +317 -0
- package/tools/pass-kit/validate.js +329 -0
package/CHANGELOG.md
CHANGED
|
@@ -15,6 +15,245 @@ Releases before this file exists are recorded in the git tags and commit history
|
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
+
## Unreleased
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## 3.12.0
|
|
23
|
+
|
|
24
|
+
The CI matrix had been red for five runs. Every fix below is something the red
|
|
25
|
+
leg was pointing at; three of them are defects a green local run could not see,
|
|
26
|
+
because the thing that broke was the assumption that the host is a Mac.
|
|
27
|
+
|
|
28
|
+
### Fixed
|
|
29
|
+
|
|
30
|
+
- **`ios_app_store_audit` answered PASS on an archive it never read.** Plist
|
|
31
|
+
parsing went entirely through `plutil`, a macOS binary. Off macOS every read
|
|
32
|
+
returned `null`, all 18 rules saw an empty archive, found nothing, and the
|
|
33
|
+
verdict came back clean - on a fixture built to be non-compliant. There are
|
|
34
|
+
now three answers instead of two: `plutil` when it is there, a small XML plist
|
|
35
|
+
reader when it is not, and an explicit record of what could be read by
|
|
36
|
+
neither. An audit with a non-empty `unreadablePlists` reports
|
|
37
|
+
`measurable: false` and an `archive-readable` error, so it can no longer
|
|
38
|
+
return PASS. An unreadable archive and a compliant one now look different.
|
|
39
|
+
- **Argument rules were unreachable on a host without Xcode.** `handleIOS`
|
|
40
|
+
refused everything with "Xcode not installed" before any handler ran, so the
|
|
41
|
+
checks that answer from the arguments alone - `extra_args` shell
|
|
42
|
+
metacharacters, `project` XOR `workspace`, `mode=diff` without
|
|
43
|
+
`baseline_graph`, `ios_leaks` with neither `pid` nor `bundle_id`,
|
|
44
|
+
`ios_testflight_validate` with neither `ipa_path` nor `list_providers` - never
|
|
45
|
+
ran there, and the tests that prove them could not run either. They are
|
|
46
|
+
evaluated before the capability gate now, so a malformed call is named as
|
|
47
|
+
malformed on any host. The `extra_args` character class is additionally
|
|
48
|
+
declared as `pattern` on the tool schema, where a host can enforce it too.
|
|
49
|
+
- **`build-stack-plugins.mjs`-style "works on the author's machine" in the
|
|
50
|
+
test harness.** Gate 10 printed a bare exit code when a suite failed, so a red
|
|
51
|
+
CI leg said which file failed and nothing about why. It now prints the failing
|
|
52
|
+
assertions, matching both reporter shapes `node:test` uses (TAP when piped,
|
|
53
|
+
spec on a terminal).
|
|
54
|
+
|
|
55
|
+
### Changed
|
|
56
|
+
|
|
57
|
+
- **`validateArgs` enforces the whole schema, not three keywords of it.** It
|
|
58
|
+
checked `type`, `required` and `enum`; `pattern`, `minimum`, `maximum`,
|
|
59
|
+
`minLength`, `maxLength`, `minItems`, `maxItems` and `items` were declarable
|
|
60
|
+
and unenforced. A schema the server does not keep is worse than no schema,
|
|
61
|
+
because the host shows the caller a contract that is not real. Array `items`
|
|
62
|
+
are validated element by element, including nested `required` and property
|
|
63
|
+
types. No existing tool declared any of the newly-enforced keywords, so
|
|
64
|
+
nothing that used to be accepted is now refused.
|
|
65
|
+
- **`design-check` tests are `node:test` cases.** 1002 lines and 143 assertions
|
|
66
|
+
ran inside a hand-rolled tally that ended in `process.exit(1)`: the runner saw
|
|
67
|
+
one opaque suite, coverage could not attribute a line, and a failure named the
|
|
68
|
+
file rather than the check. Same assertions, now 143 reported cases. The two
|
|
69
|
+
that need `ripgrep` register as skips with a reason instead of printing a
|
|
70
|
+
warning nobody reads.
|
|
71
|
+
- **Dependency advisories closed by upgrade, not by allowlist.** `fast-uri`,
|
|
72
|
+
`hono` and `qs` reach this tree only through `@modelcontextprotocol/sdk`;
|
|
73
|
+
bounded `overrides` resolve all three. `scripts/audit-allowlist.mjs` now has
|
|
74
|
+
an empty accepted list, and its stdio-only assertion runs on every invocation
|
|
75
|
+
rather than only when an advisory happens to be open.
|
|
76
|
+
- **Repo tooling only, nothing in the published package.** A `PostToolUse` hook
|
|
77
|
+
(`.claude/settings.json` -> `scripts/hooks/stdout-hygiene.sh`) greps the file
|
|
78
|
+
that was just edited for `console.log` under `index.js` and `tools/`, and
|
|
79
|
+
fails the edit back to the author when it finds one. stdout is this server's
|
|
80
|
+
JSON-RPC channel, so a stray log corrupts the protocol stream and the client
|
|
81
|
+
reports only a closed connection. Gate 5 in `scripts/gates.sh` remains the
|
|
82
|
+
authority - it decides whether the package ships; the hook only moves the
|
|
83
|
+
catch from ship-day to edit-second, and gate 5 now also asserts that the hook
|
|
84
|
+
exists, parses and is wired.
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 3.11.0
|
|
89
|
+
|
|
90
|
+
### Added
|
|
91
|
+
|
|
92
|
+
- **Wallet Passes, four `pass_*` tools** - `pass_validate`, `pass_build`,
|
|
93
|
+
`pass_inspect`, `pass_certificates`. Build, sign, validate and inspect Apple
|
|
94
|
+
Wallet passes; offline, deterministic, and generic by construction. All five
|
|
95
|
+
of Apple's styles are first-class with a per-style image contract, and no
|
|
96
|
+
brand, airline or project appears anywhere in the directory. 95 tools become
|
|
97
|
+
99. Three are read-only; `pass_build` writes the file the caller named.
|
|
98
|
+
|
|
99
|
+
**A literal passphrase is not an accepted input.** The caller names an
|
|
100
|
+
environment variable (`passphrase_env`) or a keychain entry, and the value
|
|
101
|
+
reaches openssl through `-passin env:` rather than as an argument, because an
|
|
102
|
+
argument is world-readable in `ps` for as long as the process runs. It is
|
|
103
|
+
never written to disk, never returned, and scrubbed out of error text. A test
|
|
104
|
+
asserts the tool surface contains no bare `passphrase` property, and another
|
|
105
|
+
asserts the value never reaches a result.
|
|
106
|
+
|
|
107
|
+
**Findings are graded by consequence, and the warning grade is the point.** An
|
|
108
|
+
error is a pass Wallet refuses. A warning is a pass Wallet accepts while
|
|
109
|
+
quietly doing less than intended, and those are the ones nobody finds: one
|
|
110
|
+
unknown `PKPassengerCapability*` value raises nothing anywhere and drops an
|
|
111
|
+
enhanced boarding pass back to the old layout; a tag renamed in iOS 26 is
|
|
112
|
+
ignored rather than rejected, so whatever it drove simply does not appear;
|
|
113
|
+
`footer@1x.png` is not the 1x footer, since Wallet looks for `footer.png`.
|
|
114
|
+
|
|
115
|
+
Run against a real signed production boarding pass, the validator reported
|
|
116
|
+
zero errors and found two genuine defects - the `@1x` file and a set of
|
|
117
|
+
labels that were half localization keys and half literal text. It also
|
|
118
|
+
reported two things wrongly on that same pass, and both were corrected rather
|
|
119
|
+
than explained: `footerFields` is a real bucket, and a dozen semantic tags it
|
|
120
|
+
called unknown are real tags.
|
|
121
|
+
|
|
122
|
+
`pass_build` refuses to build with an expired Pass Type ID certificate. Such a
|
|
123
|
+
pass builds, signs and verifies; Wallet is the first thing that refuses it,
|
|
124
|
+
and it does not say why.
|
|
125
|
+
|
|
126
|
+
### Fixed
|
|
127
|
+
|
|
128
|
+
Six defects found reviewing the two families above before either reached npm.
|
|
129
|
+
Neither 3.10.0 nor 3.11.0 was ever published, so they are recorded here rather
|
|
130
|
+
than as a patch release.
|
|
131
|
+
|
|
132
|
+
- **The server pool started two servers for one root.** `withServer` read its
|
|
133
|
+
lock off a map entry that did not exist yet, so two concurrent calls for a
|
|
134
|
+
cold root each spawned a language server and the second `servers.set`
|
|
135
|
+
orphaned the first - never disposed, never swept, invisible to the idle
|
|
136
|
+
sweeper. The queue now lives in its own map, taken before any state is read.
|
|
137
|
+
`onCrash` mutated a copy, which broke identity for in-flight callers and put
|
|
138
|
+
a dead server back in the map; it mutates in place, and the crash-poison
|
|
139
|
+
window outlives the entry it belonged to.
|
|
140
|
+
|
|
141
|
+
- **`dispose()` dropped an in-flight request instead of settling it.** It
|
|
142
|
+
cleared each pending timer and then the map, discarding the only reference to
|
|
143
|
+
the resolver, so the exit event that would have settled them found nothing and
|
|
144
|
+
the caller awaited forever. Only reachable against a server that ignores
|
|
145
|
+
`shutdown` - which is the case `dispose()` exists for.
|
|
146
|
+
|
|
147
|
+
- **The Swift index report missed the index and guessed at its age.**
|
|
148
|
+
DerivedData folders were matched against the checkout's directory name; Xcode
|
|
149
|
+
names them after the project, and in most checkouts those differ - one
|
|
150
|
+
measured here reported `indexBuilt: false` with an 18,205-unit store on disk,
|
|
151
|
+
and printed a remedy telling the caller to build it. The candidate names now
|
|
152
|
+
come from the `.xcodeproj` / `.xcworkspace` in the root. Separately, "newest
|
|
153
|
+
unit" was sampled from the first 200 entries of a `readdir`, which is hash
|
|
154
|
+
order rather than a timeline; the directory's own mtime answers exactly, for
|
|
155
|
+
one syscall instead of 200.
|
|
156
|
+
|
|
157
|
+
- **The Kotlin probe reported no JVM on a machine running Java 17.**
|
|
158
|
+
`java -version` writes to stderr and exits 0, and the version was read from
|
|
159
|
+
`execFileSync`'s return value, which is stdout. The `catch` that reads
|
|
160
|
+
`e.stderr` never ran, because nothing threw. Latent only because the probe
|
|
161
|
+
short-circuits where `kotlin-lsp` is absent - so it would have fired for
|
|
162
|
+
exactly the users who install it.
|
|
163
|
+
|
|
164
|
+
- **`code_index_status` answered about paths it could not look at.** "Always
|
|
165
|
+
succeeds" is a promise about a missing toolchain, not about bad input, and it
|
|
166
|
+
had been implemented as "never validates": a relative path, a path that does
|
|
167
|
+
not exist, or literally the string `undefined` all resolved to
|
|
168
|
+
`semantic: false` with `buildSettingsSource: "fallback"` - the same answer a
|
|
169
|
+
genuinely unconfigured repo gets - and then printed a remedy telling the
|
|
170
|
+
caller to point `workspace_root` at a project root, sending them after a build
|
|
171
|
+
system that was never the problem. Every other tool in the family refused
|
|
172
|
+
those paths by name. Found by running the tools end to end rather than by
|
|
173
|
+
reading them. A call with no path at all still answers, because there is
|
|
174
|
+
nothing there to be wrong about and that is the "can this machine do anything"
|
|
175
|
+
call.
|
|
176
|
+
|
|
177
|
+
- **The per-root server queue outlived the work it guarded.** The lock map
|
|
178
|
+
gained an entry for every distinct `language:root` ever asked about and
|
|
179
|
+
removed none, so a server running for days accumulated one dead promise chain
|
|
180
|
+
per root. Introduced by the fix above it, which moved the queue out of the
|
|
181
|
+
server entry precisely so it could outlive it.
|
|
182
|
+
|
|
183
|
+
- **`pass_validate` filtered findings by their message text.** Checking a bare
|
|
184
|
+
`pass.json` has no files to look at, so image findings were dropped by
|
|
185
|
+
matching the sentence they were phrased with - improving the wording would
|
|
186
|
+
have silently turned them back on. They carry `kind: "asset"` now.
|
|
187
|
+
|
|
188
|
+
### Changed
|
|
189
|
+
|
|
190
|
+
- Gates 14c and 14d now cover `tools/pass-kit/` as well as `tools/code-intel/`:
|
|
191
|
+
no shell, and no writing to the MCP stdout channel.
|
|
192
|
+
|
|
193
|
+
- **Gate 15 is new: nothing personal or corporate ships to public npm.** Every
|
|
194
|
+
tracked file is scanned for home directories, the author's username, employer
|
|
195
|
+
hostnames and day-job brands. It failed on its first run, on a design-check
|
|
196
|
+
handoff note carrying an employer app name, an internal module path, two real
|
|
197
|
+
Figma file keys and three corporate component names - a file nothing had ever
|
|
198
|
+
scanned, in a package published to the public registry.
|
|
199
|
+
|
|
200
|
+
- **Gate 3b reads `README.tr.md` too, and checks the category count.** It had
|
|
201
|
+
read only `README.md`, so the Turkish page drifted three whole families
|
|
202
|
+
behind while its headline still claimed the right total, and `README.md`
|
|
203
|
+
itself said "9 categories" over ten bullets. The sum was the only number
|
|
204
|
+
anything checked.
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## 3.10.0
|
|
209
|
+
|
|
210
|
+
### Added
|
|
211
|
+
|
|
212
|
+
- **Code Intelligence, eight `code_*` tools** - compiler-grade answers about
|
|
213
|
+
Swift and Kotlin source, over the language server each platform already
|
|
214
|
+
ships. `code_definition`, `code_references`, `code_hover`,
|
|
215
|
+
`code_document_symbols`, `code_workspace_symbols`, `code_diagnostics`,
|
|
216
|
+
`code_index_status`, `code_server_reset`. Swift needs nothing installed:
|
|
217
|
+
`sourcekit-lsp` comes with Xcode. Seven are read-only; `code_server_reset`
|
|
218
|
+
discards a cache and is marked idempotent.
|
|
219
|
+
|
|
220
|
+
One family rather than two, with the language inferred from the file
|
|
221
|
+
extension. The capability set genuinely is symmetric - both sides are LSP
|
|
222
|
+
servers answering the same methods - and duplicating the surface would double
|
|
223
|
+
the tool count for no new capability. The asymmetry lives in the output:
|
|
224
|
+
every result carries `language`, `semantic` and the resolved build-settings
|
|
225
|
+
source, and Kotlin answers carry `confidence: "alpha"`.
|
|
226
|
+
|
|
227
|
+
**What is measured, and why the tools say what they say.** On Swift 6.3.1,
|
|
228
|
+
`textDocument/references` against a two-file package answered `[]` at 0.7s
|
|
229
|
+
and `[3]` at 5.8s with nothing changed except that the background index had
|
|
230
|
+
finished. `initialize` returns `referencesProvider: true` either way, so the
|
|
231
|
+
server's own capability flag is no guide. These tools therefore wait for the
|
|
232
|
+
index and report `indexReady`, because "0 references" reads as "this symbol
|
|
233
|
+
is unused" and that is the wrong thing to be wrong about. A 658-file package
|
|
234
|
+
with dependencies had still not finished at 70s, so `index_wait_sec` is an
|
|
235
|
+
input rather than a constant. On an `.xcodeproj` root with no
|
|
236
|
+
`buildServer.json`, cross-file answers are impossible and diagnostics are
|
|
237
|
+
actively misleading; both are marked `semantic: false` with the remedy, and
|
|
238
|
+
nothing writes a build config into anyone's repository.
|
|
239
|
+
|
|
240
|
+
Kotlin runs on JetBrains `kotlin-lsp`, which is Alpha, partially closed
|
|
241
|
+
source, and not installed here or in CI. The probe and the absence path are
|
|
242
|
+
covered by tests; **the Kotlin server path is exercised by no gate in this
|
|
243
|
+
repository**, and the README says so rather than letting a green suite imply
|
|
244
|
+
coverage.
|
|
245
|
+
|
|
246
|
+
- **Gate 14c** - `tools/code-intel/` must reach no shell. Gate 14b protects
|
|
247
|
+
shell templates by demanding a sanitizer on every interpolation, so it has
|
|
248
|
+
nothing to inspect in a directory that only spawns argv arrays - and would
|
|
249
|
+
have stayed silent the day one of those spawns became a `run()` template
|
|
250
|
+
taking a caller-supplied path.
|
|
251
|
+
- **Gate 14d** - no code-intel module may touch `process.stdout` or inherit a
|
|
252
|
+
child's stdio. A language server speaks JSON-RPC too, and any of its stream
|
|
253
|
+
reaching fd 1 corrupts the host channel and takes all 95 tools down, not one.
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
18
257
|
## 3.9.0
|
|
19
258
|
|
|
20
259
|
### Changed
|
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
🇹🇷 Türkçe: [README.tr.md](./README.tr.md)
|
|
9
9
|
|
|
10
|
-
**
|
|
10
|
+
**99 tools** for iOS Simulator, Android Emulator, and headless web control. MCP server that lets your AI coding assistant see, interact with, and audit your mobile apps - plus drive browsers, run an 18-rule App Store compliance audit, and orchestrate multi-step batch flows.
|
|
11
11
|
|
|
12
12
|
Distributed on the **public npm registry** - `npx @mmerterden/multi-agent-toolkit-mcp` resolves with no auth, no token, no `~/.npmrc` setup.
|
|
13
13
|
|
|
@@ -15,7 +15,7 @@ Distributed on the **public npm registry** - `npx @mmerterden/multi-agent-toolki
|
|
|
15
15
|
|
|
16
16
|
That distinction is worth keeping straight. This line once called five hosts "the multi-agent-pipeline's full-orchestration targets", which stopped being true in pipeline v10.7.0 when the Cursor / Antigravity / Codex / Copilot Chat adapters were deleted. Codex CLI returned as a first-class target in pipeline v13.0.0 on capability - it now has skills, parallel sub-agents, hooks and MCP - and it is on the verified list only because a gate exercises it, not because it is supported elsewhere. Claiming hosts nobody exercises is not free either: 2.20.0 and 2.21.0 shipped an illegal `outputSchema` on the first tool, so Claude Code rejected the whole `tools/list` and served zero of the 78 - in the primary host, for two releases, with every gate in this repo green.
|
|
17
17
|
|
|
18
|
-
**
|
|
18
|
+
**10 categories:**
|
|
19
19
|
- **Device Control** (59 tools) - screenshot, tap, swipe, type, navigate, dark mode, locale, orientation, location, permissions, push notifications, real start/stop screen recording
|
|
20
20
|
- **Memory** (2 tools) - `ios_leaks` runs /usr/bin/leaks against a simulator or host process, snapshot or diff against a saved memory graph; `android_meminfo` reads dumpsys meminfo, snapshot or diff. Both report `measurable:false` rather than a clean result when they could not look
|
|
21
21
|
- **Crash Diagnostics** (2 tools) - `ios_list_crashes` reads the host's DiagnosticReports, `android_list_crashes` dumps the adb crash buffer, both tail-bounded
|
|
@@ -23,6 +23,8 @@ That distinction is worth keeping straight. This line once called five hosts "th
|
|
|
23
23
|
- **Store Compliance** (5 tools) - App Store / Play Store readiness; **18-rule deep `ios_app_store_audit`** cross-references Apple ITMS error codes + App Store Review Guidelines (privacy manifest, required-reason API, Info.plist, code signing, entitlements, embedded SDK, IPv6, debug-tool leak, ...)
|
|
24
24
|
- **Web Automation** (8 tools) - Playwright-powered: goto, click (CSS selectors), type, eval JS, wait for selector, extract text, screenshot. Chromium / WebKit / Firefox engines. **Requires `playwright` peer dependency.**
|
|
25
25
|
- **Design Audit** (6 tools) - mock-mode vs Figma conformance: scenario inventory, mock detection, mock launch, live UI geometry, pixel/geometry/typography compare, and the HTML/PDF report with its coverage gate
|
|
26
|
+
- **Code Intelligence** (8 tools) - compiler-grade answers about Swift and Kotlin source, over the language server each platform already ships: definition, references, hover, document and workspace symbols, diagnostics without a full build, plus `code_index_status` for whether this machine can answer at all. Cross-file answers need a background index, so they report whether it had settled instead of returning an empty list that reads as "unused"
|
|
27
|
+
- **Wallet Passes** (4 tools) - build, sign, validate and inspect Apple Wallet passes. All five styles, offline and deterministic, and a literal passphrase is deliberately not an accepted input: the caller names an environment variable or a keychain entry. The validator grades by consequence, because the interesting failures are the silent ones - one unknown `PKPassengerCapability` value raises nothing and quietly drops an enhanced pass back to the old layout
|
|
26
28
|
- **Autonomous Agent DSL** (2 tools) - `agent_run_steps` executes a batch array of {tool, args, continue_on_error?, wait_ms?} steps in one MCP round trip. Ideal for scripted login flows, form fills, multi-step QA paths. `agent_query_output` searches the full output of an earlier call that was too large to return inline, so a follow-up question does not mean re-running an expensive tool.
|
|
27
29
|
|
|
28
30
|
## Quick Start
|
|
@@ -281,6 +283,81 @@ Mock-mode vs Figma design audit. Generic and platform-agnostic - the heavy orche
|
|
|
281
283
|
| `design_visual_compare` | Compare a Figma render vs a live screenshot without failing on size mismatch: normalizes scale, crops chrome, reports perceptual diff %, spacing/size/position (px), color (ΔE), and typography. Writes figma/live/diff/overlay/side-by-side PNGs. |
|
|
282
284
|
| `design_report` | Render a design-audit report object to self-contained HTML (base64 images, CSS-positioned annotations) + optional PDF. Enforces a coverage gate: every target must be audited or skipped with an explicit reason, so a partial audit cannot render as a clean report. Wording comes from a label pack (English default, Turkish built in). |
|
|
283
285
|
|
|
286
|
+
### Code Intelligence Tools (8)
|
|
287
|
+
|
|
288
|
+
Compiler-grade answers about Swift and Kotlin, over the language server each
|
|
289
|
+
platform already ships. Swift needs nothing installed: `sourcekit-lsp` comes
|
|
290
|
+
with Xcode. Kotlin uses JetBrains `kotlin-lsp`, which is Alpha and must be
|
|
291
|
+
installed separately - every Kotlin answer is labelled `confidence: "alpha"`,
|
|
292
|
+
and **no gate in this repository exercises the Kotlin server**, so treat that
|
|
293
|
+
side as written-but-unverified.
|
|
294
|
+
|
|
295
|
+
| Tool | What it does |
|
|
296
|
+
|---|---|
|
|
297
|
+
| `code_definition` | Where a symbol is declared. Takes a 1-based line+column, or a `symbol` name so the caller never has to count columns. |
|
|
298
|
+
| `code_references` | Every reference across the workspace. Index-backed, and reports whether the index had settled. |
|
|
299
|
+
| `code_hover` | Type, signature and doc comment at a position. Works without an index for same-file and standard-library symbols. |
|
|
300
|
+
| `code_document_symbols` | The symbol tree of one file. The only capability that needs no build configuration at all. |
|
|
301
|
+
| `code_workspace_symbols` | Find a symbol by name across the workspace. Index-backed. |
|
|
302
|
+
| `code_diagnostics` | Compiler diagnostics for one file without a full build. Says "did not look" rather than reporting 0 when nothing was published. |
|
|
303
|
+
| `code_index_status` | Per language: is a server installed, which build system was found, is an index on disk, what to do if not. Always succeeds. |
|
|
304
|
+
| `code_server_reset` | Stop the pooled servers. For a server wedged on stale build settings. Discards a cache, never source. |
|
|
305
|
+
|
|
306
|
+
**What these can and cannot answer, by root.** sourcekit-lsp takes its compiler
|
|
307
|
+
arguments from a build system, and which one it finds decides everything. The
|
|
308
|
+
resolved root and how it was found come back in every result, so an answer is
|
|
309
|
+
never separated from what it is worth.
|
|
310
|
+
|
|
311
|
+
| Root | definition | references / workspace symbols | diagnostics |
|
|
312
|
+
|---|---|---|---|
|
|
313
|
+
| `Package.swift` (SwiftPM) | yes | yes, once the background index settles | yes |
|
|
314
|
+
| `buildServer.json` | yes | yes | yes |
|
|
315
|
+
| `.xcodeproj` with no build server | same-file only | **no** - `semantic: false` and a remedy | misleading, and marked non-semantic |
|
|
316
|
+
|
|
317
|
+
Measured on Swift 6.3.1: against a two-file package, `code_references` answered
|
|
318
|
+
0 at 0.7s and 3 at 5.8s, with nothing changed except that the background index
|
|
319
|
+
had finished. That gap is why these tools wait for the index and report
|
|
320
|
+
`indexReady` rather than returning the empty list - "0 references" reads as
|
|
321
|
+
"this symbol is unused", and that is the wrong thing to be wrong about. On a
|
|
322
|
+
658-file package with dependencies the first index had still not finished at
|
|
323
|
+
70s, so budget accordingly with `index_wait_sec`.
|
|
324
|
+
|
|
325
|
+
|
|
326
|
+
### Wallet Pass Tools (4)
|
|
327
|
+
|
|
328
|
+
Build, sign, validate and inspect Apple Wallet passes. Offline, deterministic,
|
|
329
|
+
and generic: all five of Apple's styles are first-class and nothing here is tied
|
|
330
|
+
to a brand, an airline or a project.
|
|
331
|
+
|
|
332
|
+
| Tool | What it does |
|
|
333
|
+
|---|---|
|
|
334
|
+
| `pass_validate` | Check a pass.json, a `.pass` directory or a built `.pkpass` against Apple's rules. Grades findings by consequence. |
|
|
335
|
+
| `pass_build` | Assemble, sign (openssl, detached PKCS#7 over a SHA-1 manifest) and archive a `.pkpass`. Validates first and refuses on an error unless told otherwise. |
|
|
336
|
+
| `pass_inspect` | Open a `.pkpass` and report what is in it: style, semantic tags, images and scales, localizations, manifest integrity and the signing chain. Never needs the private key. |
|
|
337
|
+
| `pass_certificates` | Report the signing material: identity, expiry, and whether a passphrase source is configured. Never reads or reports key material. |
|
|
338
|
+
|
|
339
|
+
**Secrets.** A literal passphrase is not an accepted parameter anywhere. The
|
|
340
|
+
caller passes `passphrase_env` (the NAME of an environment variable) or
|
|
341
|
+
`keychain_account`, and the value reaches openssl through `-passin env:` so it
|
|
342
|
+
never appears in `ps`, never lands in a log, and is scrubbed from any error text
|
|
343
|
+
on the way back.
|
|
344
|
+
|
|
345
|
+
**Grading, and why it is the point.** An `error` is a pass Wallet refuses. A
|
|
346
|
+
`warning` is a pass Wallet accepts while quietly doing less than intended, and
|
|
347
|
+
that grade exists because those are the ones nobody finds:
|
|
348
|
+
|
|
349
|
+
- one unknown `PKPassengerCapability*` value raises nothing at all and drops the
|
|
350
|
+
enhanced layout back to the old one
|
|
351
|
+
- a semantic tag renamed in iOS 26 is not rejected, it is ignored, so whatever
|
|
352
|
+
it drove simply does not appear
|
|
353
|
+
- `footer@1x.png` is not the 1x footer - Wallet looks for `footer.png` and never
|
|
354
|
+
finds this file, which is hashed into the manifest for nothing
|
|
355
|
+
- labels that are half localization keys and half literal text localize the keys
|
|
356
|
+
and leave the rest in one language
|
|
357
|
+
|
|
358
|
+
Run against a real signed production boarding pass, the validator reported zero
|
|
359
|
+
errors and found both of the last two.
|
|
360
|
+
|
|
284
361
|
### Use Cases
|
|
285
362
|
|
|
286
363
|
- **Visual bug hunting** - Screenshot every screen, AI analyzes for layout issues
|
package/README.tr.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
🇬🇧 English: [README.md](./README.md)
|
|
9
9
|
|
|
10
|
-
iOS Simulator, Android Emulator ve headless web kontrolü için **
|
|
10
|
+
iOS Simulator, Android Emulator ve headless web kontrolü için **99 araç**. AI kodlama asistanının mobil uygulamalarını görmesini, onlarla etkileşime girmesini ve denetlemesini sağlayan bir MCP sunucusu - ayrıca tarayıcıları sürer, 18-kurallık bir App Store uyumluluk denetimi çalıştırır ve çok-adımlı batch akışlarını orkestre eder.
|
|
11
11
|
|
|
12
12
|
**Public npm registry** üzerinden dağıtılır - `npx @mmerterden/multi-agent-toolkit-mcp`, auth'suz, token'sız, `~/.npmrc` ayarı gerekmeden çözülür.
|
|
13
13
|
|
|
@@ -15,13 +15,16 @@ iOS Simulator, Android Emulator ve headless web kontrolü için **87 araç**. AI
|
|
|
15
15
|
|
|
16
16
|
Bu ayrımı net tutmakta fayda var. Bu satır bir zamanlar beş host'u "multi-agent-pipeline'ın tam-orkestrasyon hedefleri" olarak adlandırıyordu, bu da pipeline v10.7.0'da Cursor / Antigravity / Codex / Copilot Chat adaptörleri silindiğinde doğru olmaktan çıktı. Codex CLI, pipeline v13.0.0'da yetenek üzerinden birinci-sınıf bir hedef olarak geri döndü - artık skill'leri, paralel sub-agent'ları, hook'ları ve MCP'si var - ve doğrulanmış listede sadece bir kapı onu çalıştırdığı için yer alıyor, başka bir yerde desteklendiği için değil. Kimsenin çalıştırmadığı host'ları iddia etmek de bedavaya gelmiyor: 2.20.0 ve 2.21.0, ilk araçta yasa dışı bir `outputSchema` gönderdi, bu yüzden Claude Code tüm `tools/list`'i reddetti ve 78'in sıfırını sundu - birincil host'ta, iki release boyunca, bu repo'daki her kapı yeşilken.
|
|
17
17
|
|
|
18
|
-
**
|
|
18
|
+
**10 kategori:**
|
|
19
19
|
- **Device Control** (59 araç) - screenshot, tap, swipe, type, navigate, dark mode, locale, orientation, location, permissions, push notifications, gerçek start/stop ekran kaydı
|
|
20
|
+
- **Memory** (2 araç) - `ios_leaks`, bir simülatör ya da host süreci üzerinde /usr/bin/leaks çalıştırır; anlık görüntü alır ya da kayıtlı bir memory graph ile karşılaştırır. `android_meminfo`, dumpsys meminfo okur, aynı şekilde anlık görüntü ya da fark. İkisi de bakamadıklarında temiz bir sonuç değil `measurable:false` döner
|
|
20
21
|
- **Crash Diagnostics** (2 araç) - `ios_list_crashes` host'un DiagnosticReports dizinini okur, `android_list_crashes` adb crash buffer'ını döker, ikisi de tail-sınırlı
|
|
21
|
-
- **Accessibility Audit** (
|
|
22
|
+
- **Accessibility Audit** (3 araç) - `ios_accessibility_audit` / `android_accessibility_audit` canlı ağacı okur: eksik label, ekran okuyucunun adlandıramadığı kontrol, küçük tap target, eksik identifier ve görsel düzeni izlemeyen okuma sırası. `ios_accessibility_audit_deep` ise ağacın gösteremeyeceği şeyler için Apple'ın kendi XCUIAccessibilityAudit'ini XCUITest'iniz üzerinden çalıştırır: kontrast, Dynamic Type, kırpılmış metin. Üçü de bakamadıklarında temiz bir sonuç değil, gerekçesiyle `measurable:false` döner
|
|
22
23
|
- **Store Compliance** (5 araç) - App Store / Play Store hazırlığı; **18-kurallık derin `ios_app_store_audit`**, Apple ITMS hata kodları + App Store Review Guidelines'a çapraz referans verir (privacy manifest, required-reason API, Info.plist, code signing, entitlements, gömülü SDK, IPv6, debug-tool sızıntısı, ...)
|
|
23
24
|
- **Web Automation** (8 araç) - Playwright-destekli: goto, click (CSS selector'lar), type, JS eval, selector bekleme, metin çıkarma, screenshot. Chromium / WebKit / Firefox motorları. **`playwright` peer dependency'si gerektirir.**
|
|
24
25
|
- **Design Audit** (6 araç) - mock-mode vs Figma uygunluğu: scenario envanteri, mock tespiti, mock launch, canlı UI geometrisi, piksel/geometri/tipografi karşılaştırması, ve coverage kapısıyla birlikte HTML/PDF rapor
|
|
26
|
+
- **Code Intelligence** (8 araç) - Swift ve Kotlin kaynağı hakkında derleyici seviyesinde cevaplar, her platformun zaten getirdiği dil sunucusu üzerinden: tanım, referanslar, hover, dosya ve proje geneli semboller, tam build olmadan tanılamalar, ve bu makinenin soruyu cevaplayıp cevaplayamayacağını söyleyen `code_index_status`. Çapraz dosya cevapları arka plan index'ine bağlı olduğu için, "kullanılmıyor" diye okunan boş bir liste yerine index'in oturup oturmadığını raporlar
|
|
27
|
+
- **Wallet Passes** (4 araç) - Apple Wallet pass'i üret, imzala, doğrula ve incele. Beş stilin hepsi, çevrimdışı ve deterministik; düz metin parola bilerek kabul edilen bir girdi değil: çağıran taraf bir ortam değişkeninin adını ya da bir keychain kaydını verir. Doğrulayıcı bulguları sonucuna göre derecelendirir, çünkü asıl önemli hatalar sessiz olanlar - tanınmayan tek bir `PKPassengerCapability` değeri hiçbir uyarı üretmez ve gelişmiş pass'i sessizce eski düzene düşürür
|
|
25
28
|
- **Autonomous Agent DSL** (2 araç) - `agent_run_steps`, tek bir MCP round trip'inde {tool, args, continue_on_error?, wait_ms?} adımlarından oluşan bir batch dizisini çalıştırır. Scriptlenmiş login akışları, form doldurma, çok-adımlı QA yolları için ideal. `agent_query_output`, satır içi dönemeyecek kadar büyük olan önceki bir çağrının tam çıktısını arar; böylece bir takip sorusu pahalı aracı yeniden koşturmak anlamına gelmez.
|
|
26
29
|
|
|
27
30
|
## Hızlı Başlangıç
|