Repository navigation
Wingbox 0.14.0
Two changes need your attention when you upgrade.
- The query commands (
impact,usages,advice,align,place,compare) print S-expressions by default.--humanprints the text they printed before,--jsonprints JSON for code, and--sexpprints exactly what 0.13.0 printed with it. - MCP clients: three tools have new names,
buildisgraph,moduleismodules,queryisfacts. Thewingboxcommand keeps its command names.
Changes
- The block that
wingbox installwrites into the assistant's instructions file says more. It now
tells the assistant to ask the graph beforegrep,rg,findor opening files and to read
only the files and lines the graph names, with text search as the fallback for a keyword that is
not a symbol or a graph older than the files; and that tests follow the impact analysis: the
dependentswingbox impactnames decide which tests to write and run, and for every changed
function a test that reaches it is shown (wingbox diff_functions,wingbox usages). Run
wingbox installorwingbox updateonce to get the new block. - Three MCP tools are renamed, so that all eleven are nouns named after their answer:
buildis
graph,moduleismodules,queryisfacts. An MCP client that calls one of the three by
its old name must use the new one; the other eight tools and everywingboxcommand keep their
names. - The description of every MCP tool is rewritten for an agent that reads nothing else: what the tool
does and what comes back, when to use it, which tool to use for the neighbouring question, that a
long list stops at 200 items unlessallis true, and what an unknown name returns.definitions
now says thatnamemay be a pattern (parse_.*). - The default output of the commands that answer a question changed.
wingbox impact,usages,
advice,align,placeandcompareprinted text for people; without an option they now
print S-expressions, the compact form a coding agent reads.--humangives the old text, byte
for byte as 0.13.0 printed it, with its list limits (--alllifts them).--jsonprints the
same answer as one JSON object for code. The other query commands (analyze,quick,module,
deps,rdeps,layers,boundaries,entity,search, thefind_*commands and the rest)
printed fact lines before and print the same lines now; they take--humanand--jsonas
well, and their default answer is complete:analyzeandquickno longer stop at 200
dependents unless--humanis given. Two form options at once are an invalid argument. impacttakes several files in one call:wingbox impact a.py b.py 2(a last argument that is a
whole number is the depth). The answer opens with(graph :built <UTC time> :files <n> :stale <n>), which says when the graph was written, how many files it holds and how many changed
files it is known to miss (0 after the refresh every query starts; the number of changed files
withWINGBOX_AUTO_REFRESH=0), then one answer per file in the order given. A file that is not
in the graph gives(error no-match <file> ...)in its place, the other files are answered, and
the exit status is 1.- The default form of
impactnames each thing once:(impact <file> :direct N :total M (1 <file> ...) (2 (:through <file> <file> ...)) (read-first <file> ...)), with file paths, the rows
grouped by depth and by the file they are reached through, and the reason of each row (:via
for a relation that is not an import,:more N, the name lists of the edge). The default form
ofusagesis(usages <Name> <kind> :at <file>:<line> :uses U :files M (<file> <kind> <line>:<col> ...) ...). Both are complete: nothing is cut and--allchanges nothing there.
impact --jsonprints{"graph": {...}, "impact": [{"file", "direct", "total", "rows", "read_first", "advice"}, ...]}andusages --json{"usages": {..., "rows": [...]}}; every
other command prints{"facts": [...]}, one object per fact line. - Code for Claude Code's Code Mode: the skill carries
references/code-mode.md, one JavaScript
helper (wingbox(...args), the command with--jsonthrough$`...`) and a recipe per
question: what depends on several files, every use of a name, where a feature lives, what
changed since a commit with the tests that use it, the architecture rules. The block that
wingbox installwrites names the call and the file. - A
--jsoncall that fails as a whole says so in one place: the document starts with"error": {"code", "message"}on standard output, for a folder without a graph (no-graph), an argument
that is not valid (invalid-argument), a name nothing matches (no-match) and a git reference
that does not exist (git-diff-failed). Code checksanswer.errorand nothing else. A file of
animpactcall that is not in the graph carries its ownerrorand the other files are
answered. --sexpstays where 0.13 had it and prints exactly what 0.13.0 printed with it: forimpact
andusagesthe flat facts, one per line (impact-root,(impact <root> <dependent> :lang .. :via .. :depth N ...),impact-summary,read-first;usages-target,usage,
usages-summary), with module IDs, the list limits unless--all, and exit status 0 for a file
that is not in the graph; foradvice,align,placeandcomparetheir facts.wingbox module <id>,wingbox boundariesandwingbox boundaries --strictprint the same lines with
the same exit statuses. A script written for 0.13 that passes--sexp(the pull request check
does) reads what it read; a script that parsed the text ofimpactorusageswithout an
option adds--human.- MCP: the
impacttool takestarget(one file) ortargets(a list) and answers in the
default S-expression form, complete, with the graph fact first when several files are asked;
it answered in text before, cut at 200 dependents unlessall.allis still accepted there
and changes nothing. The other ten tools answer as before. - The skill has a short section "Use from code" (one call for several files, read as JSON), and
the always-on block ofwingbox installsays the same in one line;wingbox updaterefreshes
both. The skill no longer tells an agent to pass--sexpto a command that answers in facts
by default.
Fixes
wingbox query "(help)", and so the MCP toolfactswith the expression(help), lists the
functions of the query language, as the tool's description says. It answered "unknown function:
help" outside the interactivewingbox repl.
Upgrade: wingbox update, or pipx upgrade wingbox / uv tool upgrade wingbox / pip install -U wingbox.