sparring (Engine)

Deterministische Pipeline, Analyse und CLI des analytischen Finanz-Sparringspartners — plus die Claude-Code-Skills und das Workspace-Template. Teil des Monorepos MrGoro/sparring (Gesamt-README dort).

Installation

pnpm dlx sparring init mein-workspace   # Workspace scaffolden (Git-Repo + Claude-Code-Skills inklusive)
cd mein-workspace && pnpm install

Danach in Claude Code /setup aufrufen — die geführte Einrichtung (Haushalt, Konten, Zugangsdaten, erster Refresh, erste Analyse). Details und der volle Schnellstart stehen im Monorepo-README.

Alternativ in ein bestehendes Projekt: pnpm add sparring.

Das Paket liefert sein CLI vorgebaut aus (dist/cli/main.js) — beim Install läuft kein Build-Script.

CLI

sparring init [dir]        # neuen Workspace scaffolden (+ Git-Repo, + Claude-Code-Skills)
sparring init-status [--json] [--strict]   # Setup-Doctor: was fehlt noch, was ist der nächste Schritt?
sparring init-secrets      # gitignorierte Zugangsdaten-Skelette aus config/accounts.json ableiten
sparring check             # Aktualität der Daten prüfen
sparring refresh-all       # FinTS/Importe/Kurse/manuell
sparring analysis portfolio | savings | projections
sparring manifest | sync-skills | commit-data

sparring --help listet alle Subcommands; : und - sind austauschbar.

Programmatische API

Exportiert werden die zod-Schemata der data/-Artefakte (der Einstieg sparring ist gleichwertig zu sparring/schemas):

import { PortfolioSchema, TransactionSchema } from 'sparring/schemas';

Die Rechen-Primitiven (fvAnnuity, ratio, …) nutzt die Analyse intern; im Workspace werden sie über die Analyse-Kommandos und die Skills konsumiert, nicht als Paket-API.

Datenquellen

FinTS (via lib-fints), Trade-Republic-CSV, FNZ-XML-Export, manuelle Krypto-Bestände. Konto-Identifikatoren sind frei (offener String) — die gültige Kontenmenge definiert config/accounts.json des Workspace.

Lizenz

MIT © Philipp Schürmann