Module dossier 

Unknown-mod dossier writer.

When analyze returns InstallMethod::Unknown or execute surfaces InstallerError::UnknownMethod, the caller dumps a dossier so a Claude Code skill can extend the installer to handle this layout.

Layout on disk:

$XDG_DATA_HOME/modde/unknown-installers/<slug>/
  ├─ metadata.json        — Nexus mod metadata + context
  ├─ archive_tree.txt     — recursive ls (up to 500 entries)
  ├─ file_samples/        — up to 5 small text files verbatim
  ├─ analyzer_trace.json  — which probes ran, what they rejected
  └─ PROMPT.md            — self-contained skill prompt

Once a skill has landed a fix, the dossier directory is renamed to <slug>.resolved and the UI surfaces a Retry Install button.

Structs

DossierContext

Context about the mod the analyzer could not classify. Filled in by the CLI / UI caller — the installer crate itself doesn’t fetch Nexus metadata.

ProbeTrace

A single probe’s decision, recorded so the skill knows which paths were already tried.

Functions

dossier_path

Path to the dossier for a specific unknown mod.

dossier_slug

A slug identifying the dossier dir. Stable across retries.

dossiers_dir

Root directory holding all unknown-installer dossiers.

dump

Write the dossier to disk. Overwrites any existing dossier with the same slug (this is idempotent — the skill path consumes by renaming to .resolved, so a pre-existing dir here means a prior failed attempt we’re retrying).