jinflow CLI Spickzettel

Konzepte

Begriff	Was es ist
Pack	Domain-spezifisches Analytik-Kit (z.B. Millesime fuer Weinbau, Alptrack fuer Skigebiete)
Tenant	Ein Kunde/Standort. Pack-qualifiziert: millesime.domaine_zufferey
KLS	Knowledge Store — die DuckDB-Datei, die du baust und erkundest
AFS	Artifact Store — das analytische Framework (Signals, Theses, dbt, Contracts)
Snapshot	Unveraenderliche, eingefrorene Kopie eines KLS
DLZ	Data Landing Zone — wo Rohdaten vom Quellsystem ankommen
Live Root	Wo Tenant-Instanzen auf der Festplatte leben (~/.jinflow/live/ Standard)
Deploy Root	Wo das Anwendungspaket lebt (CLI + Explorer Binary)

---

Installation

macOS

export PATH="$HOME/jinflow:$PATH"    # zum Shell-Profil hinzufuegen
jinflow version                       # Installation pruefen

Erstkonfiguration

jinflow us --live-root ~/jinflow-data        # wo Tenant-Daten leben
jinflow us --api-key sk-ant-...              # Claude API Key (fuer KI-Features)
jinflow us millesime.domaine_zufferey            # Standard-Tenant setzen

---

Befehle

jinflow us — Konfiguration

jinflow us                                # aktuelle Konfiguration mit Herkunft anzeigen
jinflow us pack.tenant                    # Standard-Tenant setzen
jinflow us --live-root /path              # Datenverzeichnis setzen
jinflow us --api-key sk-ant-...           # Claude API Key setzen
jinflow us --model claude-opus-4-6        # KI-Modell fuer Evolve setzen

jinflow ls — Tenants auflisten

jinflow ls                                # alle Packs + Tenants auflisten
jinflow ls --snapshots                    # Snapshot-Details einschliessen

jinflow init — Tenant erstellen

jinflow init --pack millesime --tenant my_org --source-system opale
jinflow init --pack millesime --tenant my_org --dlz /path/to/dlz

jinflow clone — Tenant kopieren

jinflow clone millesime.domaine_zufferey --name sandbox

jinflow make — Bauen

jinflow make                              # Standard-Tenant bauen
jinflow make millesime.domaine_zufferey   # bestimmten Tenant bauen
jinflow make millesime                    # alle Tenants im Pack (Wildcard)
jinflow make --clean                      # Loeschen und von Grund auf neu bauen
jinflow make --extract                    # XLSX → CSV → Sync → Build
jinflow make --sync                       # CSVs von DLZ kopieren
jinflow make --snapshot post-audit        # KLS nach Build einfrieren

jinflow explore — Web UI

jinflow explore                           # Standard-Tenant, Port 4000
jinflow explore --snapshot post-audit     # bestimmten Snapshot oeffnen
jinflow explore --port 3000               # benutzerdefinierter Port
jinflow explore --docker                  # Explorer in Docker

jinflow evolve — KI-Exploration

jinflow evolve                            # interaktives REPL (KI + SQL)
jinflow evolve --no-ai                    # Nur-SQL-Modus
jinflow evolve --model claude-opus-4-6    # KI-Modell waehlen

AFS-Befehle

jinflow afs update --do-it                # Pack → Tenant synchronisieren
jinflow afs status                        # Branch, Tags, geaenderte Dateien
jinflow afs pull                          # vom Remote pullen
jinflow afs push -m "message"             # committen + pushen
jinflow afs pp                            # pull dann push in einem Befehl

Weitere Befehle

jinflow stat                              # KLS-Statistiken und Gesundheitschecks
jinflow sources                           # Quelldatei-Inventar
jinflow purge millesime.domaine_zufferey --do-it  # Bronze+Silver Tabellen entfernen
jinflow snapshot post-audit               # eigenstaendiges Einfrieren (kein Build)
jinflow pack ls                           # Packs und Artefakte auflisten
jinflow cloud sync --do-it                # KLS-Dateien zu R2 hochladen
jinflow instance refresh demo             # Instanz anweisen, neu herunterzuladen
jinflow version                           # Version anzeigen

---

Evolve REPL

Befehl	Beschreibung
SELECT ...	Beliebiges SQL ausfuehren
/tenants	Tenants im KLS auflisten
/schema <name>	DuckDB-Schema beschreiben
/probes	Signals auflisten (auch /hypotheses, /diagnoses, /smebits)
/read <type> <id>	Artefakt-YAML lesen
/write <type> <id> <yaml>	Artefakt ins AFS schreiben
/make [flags]	KLS neu bauen ohne REPL zu verlassen
/ai	KI-Modus umschalten
exit	Beenden

---

Workflow

Der Kernkreislauf

  jinflow make        KLS bauen
       ↓
  jinflow explore     Findings im Web UI durchsuchen
       ↓
  jinflow evolve      Fragen stellen, Muster entdecken, Signals hinzufuegen
       ↓
  /make               Aus Evolve heraus neu bauen

---

Umgebungsvariablen

Variable	Zweck
JINFLOW_LIVE	Live Root ueberschreiben
JINFLOW_TENANT	Standard-Tenant ueberschreiben
JINFLOW_DB_PATH	Expliziter KLS DuckDB-Pfad
JINFLOW_AFS_ROOT	AFS Root (fuer Explorer)
JINFLOW_SYSTEM_DB_PATH	System DB Pfad (optional)
JINFLOW_DEPLOY_ROOT	Deploy Root fuer App-Paket
ANTHROPIC_API_KEY	Claude API Key (fuer Evolve)