Skip to content

Releases

Rolling build (1616d44)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 24 Oct 06:23
1616d44

This is not a release. It is the newest state of main, rebuilt after every green CI run and replaced each time. Nothing here is signed or tested by hand; use a release for anything that matters.

Install it with the script (for the current user, no administrator rights, and no SmartScreen stop: the script downloads the installer itself and checks it against SHA256SUMS):

irm https://github.com/WKDSteve/docmap-desktop/releases/download/latest/install.ps1 | iex    # Windows, in PowerShell
curl -fsSL https://github.com/WKDSteve/docmap-desktop/releases/download/latest/install.sh | sh   # Linux x86-64

Type the line into the PowerShell session as it is. Wrapped in a new powershell -ExecutionPolicy Bypass -c "...", Microsoft Defender reports the command line as a trojan (Trojan:Win32/Commando.B!ml) and nothing is installed.

Run it again to update to the newest rolling build. Or take the file yourself:

  • Windows: docmap-desktop-windows-x86_64-setup.exe, the NSIS setup, with the engine inside. Windows SmartScreen warns about an unsigned installer you downloaded in the browser: "More info", then "Run anyway".
  • Linux: docmap-desktop-linux-x86_64.AppImage, with the engine inside. chmod +x it and run it; it needs FUSE 2 (libfuse2), or run it with --appimage-extract-and-run.
  • SHA256SUMS holds the checksums of all files.

There is no macOS build of the rolling kind: the engine is not published for macOS. A release has the .dmg. The installers are named by their platform, not by a version: docmap-desktop --version does not exist, the window's Help → About names the engine and the build.

Built from commit 1616d44d84a528bed524892fcd1913ff8c6d9e71.

docmap-desktop v0.6.0

Choose a tag to compare

@github-actions github-actions released this 02 Oct 20:06

Download

Platform File Notes
Windows docmap-desktop_0.6.0_x64-setup.exe The installer to use. Bundles the engine (documentation.nvim, commit 440bfb7) and 23 language grammars. ..._x64_en-US.msi is the same app as an MSI package.
Linux ..._amd64.AppImage, .deb, .rpm Engine bundled.
macOS ..._aarch64.dmg (Apple silicon), ..._x64.dmg (Intel) No engine bundled - it is found on PATH, or the app says it found none. The menu bar has not been checked on macOS.

What is new since v0.5.0

GitHub traffic (L11). Views, clones, referrers and top pages per project, read
from the digest that github_stats.nvim writes. The app never holds the GitHub
token and makes no call itself.

  • A traffic line in the sidebar, a 30-day views figure on the overview rows, a sort
    order and a setting for it.
  • A detail dialog per project: a sparkline per series over the whole stored span,
    referrers and the ten top pages. Referrers and titles are shown as text only; a
    top page is a link only when its path resolves inside the project root.
  • A project can opt out; an opted-out project shows nothing.

Hardening folded in before release: the detail dialog refuses a digest file that holds another repository; asking Neovim where the digest lives gives up after 30 s instead of hanging; a relative digest_dir is ignored; the engine's shell quoting refuses a % on Windows.

Also: cargo fmt over the crate, and the planning documents moved out of this
repository into the author's notes.

Checked, and not checked

CI was green on the tagged commit (including cargo test on all platforms) and all
four platform builds succeeded. The Windows installer was unpacked and its bundled
engine queried with --capabilities (23 grammars loaded, build not dirty).

Not done: a click-through of the installed app, and the traffic feature against
a real :GithubStats fetch - it is tested with fixtures only.

docmap-desktop v0.5.0

Choose a tag to compare

@github-actions github-actions released this 20 Sep 22:08

Download

Platform File Notes
Windows docmap-desktop_0.5.0_x64-setup.exe The installer to use. Bundles the engine (documentation.nvim, commit 5c84f26) and 23 language grammars. …_x64_en-US.msi is the same app as an MSI package.
Linux …_amd64.AppImage, .deb, .rpm Engine bundled.
macOS …_aarch64.dmg (Apple silicon), …_x64.dmg (Intel) No engine bundled - it is found on PATH, or the app says it found none. The menu bar has not been checked on macOS.

What is new since v0.4.0

Bulk import from a parent folder (M15). Point the app at a folder that holds
many projects and add them in one step instead of one Add per project.
Already-present roots are reported, not duplicated; one broken entry does not
stop the rest; one result summary at the end.

Dependency matrix (M16). View as matrix... shows the cross-project
dependency edges as a grid instead of a list - rows require columns, a cell is
the call-site count - for workspaces where a list of edges stops being readable
at a glance.

Fixes found by reviewing those two. A raw NUL byte in src/main.js made
grep treat the file as binary (now the � escape, same runtime value); bulk
import and the Neovim-config import rewrote workspace.json once per project
instead of once per batch.

Also: the FEATURES catalogue, LF line endings enforced by .gitattributes, the
dev docs translated to English, and two design documents - the L6 decision
(docs/AGENT_CHECKLIST_RUNNER.md) and the concept for a rules view with an
agent for the manual rules (docs/RULES_AGENT_CONCEPT.md). Neither is built.

Checked, and not checked

CI was green on the tagged commit and all four platform builds succeeded. The
Windows installer was unpacked and its bundled engine queried with
--capabilities (23 grammars loaded, engine build not dirty). **A
click-through of the installed app (project loads, Generate map, Settings, Help

About) has not been done for this release.**

docmap-desktop v0.4.0

Choose a tag to compare

@github-actions github-actions released this 24 Aug 19:26
Projekteinstellungen-Dialog: die App kennt jetzt alle Flags der Engine
statt zwei Reglern (df8e4a4), inklusive .docmap.json-Support in der
Engine-Seite (documentation.nvim@8e3f8c6).

Vorausgesetzt: documentation.nvim main ist grün auf allen fünf CI-Gates
und standalone-latest wurde am 2026-08-24 frisch gebaut (publishedAt
2026-08-24T18:52:45Z) - der Sidecar dieses Builds bündelt also den
aktuellen Engine-Stand inklusive der drei Fixes aus v0.1.0 dort.

Vor v0.4.0 kam v0.3.0 (2026-08-21), veröffentlicht - A1 in PLAN.md war
seither stale.

docmap-desktop v0.3.0

Choose a tag to compare

@github-actions github-actions released this 21 Aug 03:06

Die Ebene über einem einzelnen Projekt — und eine Engine, die dreiundzwanzig
Sprachen liest und beim Erklären hilft, statt nur aufzulisten.

Der Workspace beantwortet jetzt die Frage, die nur er beantworten kann

Mit nichts ausgewählt listet das Fenster jedes Projekt des Workspace und
ordnet sie danach, was zu tun ist. Dieser Zustand ist kein fehlendes Thema,
er ist der Workspace — und ein Bildschirm, der „wähle links ein Projekt"
sagte, war die App dabei, die eine Frage nicht zu beantworten, die nur sie
beantworten kann.

Die Rangfolge ist gemessen, nicht gewählt. Über 54 Repositories, 30 mit
erzeugter Karte: 27 stammten von Schema 2, während die Engine 5 schreibt.
Eine ältere Engine bedeutet konkret fehlende Inhalte, „veraltet" dagegen
zeigte bei 17 von 28 Fällen auf ein .gitignore aus einem einzigen Rutsch.
Deshalb führt die Engine-Version. Die naheliegende Ordnung — neuste Änderung
zuerst — ist die, die die Zahlen verworfen haben.

Dazu Veraltete erzeugen als Sammelaktion im Menü.

Was hängt woran

Ein lesender Konsument über alle Karten des Workspace: requires_external
hält fest, dass ein Modul außerhalb des Repositorys verlangt wurde, und kann
nicht sagen, wo es lebt — sie hat es nie gesehen. Mehrere Karten können es,
und dieses Fenster ist der einzige Ort, an dem mehrere liegen.

Gemessen über 30 erzeugte Karten: 1 820 deklarierte Modulnamen, kein einziger
von zwei Repositories beansprucht. Ein Treffer ist damit eine Tatsache, kein
Raten.

Zweisprachig

Die Dialoge, die Hinweise und die langen Menüeinträge sprechen jetzt beide
Sprachen — nicht nur die Menüleiste.

Der Dateibaum sagt, was git von einem Eintrag hält

Neben dem, was der Scan getan hat: nicht versioniert, ignoriert, übersprungen
oder ein verschachteltes Repository — jeweils mit dem Grund, statt mit einem
grauen Eintrag ohne Erklärung.

Die eingebaute Engine gewinnt gegen eine zufällige auf dem PATH

Vorher nicht: ein älteres docmap.exe auf dem PATH hatte still Vorrang, und
die App sah richtig aus, während sie eine zwei Tage alte Engine mit vier
statt dreiundzwanzig Sprachen fuhr. Die Seitenleiste sagt jetzt, welche läuft.


Die mitgelieferte Engine — siebzehn Commits weiter

Sie erklärt sich selbst

Jeder Ansichtsknopf und jeder Analyse-Reiter trägt eine Erklärung, was er
zeigt und was er nicht behauptet — als Karte, nicht als title-Attribut, das
auf einem Touchgerät nie erscheint und einen Screenreader zweimal dasselbe
sagen lässt.

Inline-Code in Beschreibungen wird als Code gesetzt — auf der erzeugten Seite
und im Detailbereich von :DocBrowse. Gemessen: 2 132 Inline-Spannen gegen
vier Zaunblöcke, was die Gewichtung des Entwurfs umgedreht hat.

K erklärt ein Wort — aber nur dort, wo es Code ist

Im Browser: die Glossarkarte für das Wort unter dem Cursor. Nur innerhalb
einer `code`-Spanne
, und das ist gezählt: ein Glossarbegriff steht
213-mal in einer Spanne und 2 558-mal in englischer Prosa („and", „for",
„in", „end"). Ein K, das überall antwortet, läge zwölf von dreizehn Malen
daneben — mit einer korrekten Definition am falschen Wort.

Dabei fiel auf, dass der Detailbereich gar nicht fokussierbar war: zwei von
sechzehn Einträgen rendern 46 Zeilen in einen 14-Zeilen-Bereich, ohne Weg zum
Rest. w behebt beides.

Lua wird mit Doppelpunkt geschrieben, das Glossar kannte nur Punkte

s:gsub(…) traf nichts, weil die Einträge nach Punktnamen verschlüsselt
waren. Gezählt über dieselben Snippets: 1 004 Doppelpunkt-Aufrufe gegen 6
mit Punkt
für dieselben elf Funktionen — die häufigste Aufrufform der
Sprache war für ein Feature unsichtbar, dessen Zweck das Erklären von
Stdlib-Aufrufen ist. +934 Dekorationen.

63 % einer echten Config waren für den Plugin-Scanner unsichtbar

core/plugins.lua las nur das return { … } einer Datei. Eine Config, die
über plugins.add({ … }) registriert, trug nichts bei — schweigend.
Gemessen: 52 Specs gefunden, 85 nach Deklaration des einen Wrappers, die
fehlenden 33 in einer einzigen 906-Zeilen-Datei.

opts.plugins.wrappers deklariert den Helfer. Damit lesen sich auch packer,
vim-plug und mini.deps
— geschätzt als drei eigene Extraktoren, tatsächlich
neun Zeilen, weil alle drei über einen Aufruf registrieren, den der
Wrapper-Lauf schon liest.

Ein Lazy-Load-Inventar

Welches Plugin lädt auf welches Event, welchen Dateityp, welchen Befehl,
welche Taste — und was beim Start liegt. Die Messung hat den Entwurf
korrigiert: 7 von 52 Specs standen unter dem falschen Ladezustand, weil
lazy = true ohne jeden Trigger gelesen wurde, als lüde es später. Es lädt
nie. Drei Zustände statt zwei.

Zwei Duplikate nebeneinander in Compiler Explorer

Ein Klick öffnet beide markierten Funktionen in einer Sitzung. Gemessen
über 232 Duplikatgruppen in 27 Repositories: 144 haben genau zwei Mitglieder
— ein Paar ist der Normalfall. „Ganze Gruppe kompilieren" wäre ausgerechnet
bei den Gruppen gescheitert, die man am ehesten ansieht (8-KB-Grenze der
Anfragezeile). Eine eigene Instanz lässt sich eintragen; sie liegt im
localStorage, nie im Artefakt, und die Warnung wird für localhost
umgeschrieben statt umetikettiert.

:DocMap pick

Der Name, den du kennst, und die Zeile, in der er lebt — mit vier
Sortierungen.

Kleineres, das trotzdem auffällt

  • Ein Klick auf die Hierarchie hält die Ansicht, der zweite handelt.
  • Links in einer Zusammenfassung folgen ihr ins Artefakt.
  • Ein Gate, das übersprungen wurde, gilt nicht mehr als bestanden.

runtime-analysis.nvim

proc_trace kann jetzt exakt benannt werden, und die Warnung „das kennt nur
die eigenen Wraps" erscheint nicht mehr dort, wo sie unwahr ist.