Aide-mémoire CLI jinflow

Concepts

Terme	Ce que c’est
Pack	Kit analytique spécifique au domaine (par ex. Millesime pour la viticulture, Alptrack pour les stations de ski)
Tenant	Un client / site. Qualifié par pack : millesime.domaine_zufferey
KLS	Knowledge Store — le fichier DuckDB que vous construisez et explorez
AFS	Artifact Store — le framework analytique (Signals, Theses, dbt, Contracts)
Snapshot	Copie immuable et figée d’un KLS
DLZ	Data Landing Zone — où les données brutes arrivent du système source
Live Root	Où vivent les instances tenant sur disque (~/.jinflow/live/ par défaut)
Deploy Root	Où vit le package applicatif (binaire CLI + Explorer)

---

Installation

macOS

export PATH="$HOME/jinflow:$PATH"    # add to your shell profile
jinflow version                       # verify installation

Première configuration

jinflow us --live-root ~/jinflow-data        # where tenant data lives
jinflow us --api-key sk-ant-...              # Claude API key (for AI features)
jinflow us millesime.domaine_zufferey            # set default tenant

---

Commandes

Pour la référence complète de toutes les commandes avec flags et exemples, voir la version anglaise des commandes CLI. Les commandes et flags sont identiques dans toutes les langues.

Commandes essentielles

jinflow us                                # show current config
jinflow us pack.tenant                    # set default tenant
jinflow ls                                # list all packs + tenants
jinflow pick                              # interactive tenant picker
jinflow make                              # build default tenant
jinflow make --clean                      # drop + rebuild from scratch
jinflow make --sync                       # copy CSVs from DLZ first
jinflow make --snapshot post-audit        # freeze KLS after build
jinflow explore                           # default tenant, port 4000
jinflow evolve                            # interactive REPL (AI + SQL)
jinflow stat                              # KLS health check

Commandes AFS

jinflow afs update --do-it                # sync pack → tenant
jinflow afs status                        # git status
jinflow afs pull                          # pull from remote
jinflow afs push -m "message"             # commit + push

Commandes cloud

jinflow cloud ls                          # list KLS files + R2 status
jinflow cloud sync --do-it                # upload to R2
jinflow instance ls                       # list registered instances

---

Workflow

La boucle principale

  jinflow make        Build the KLS
       ↓
  jinflow explore     Browse findings in the web UI
       ↓
  jinflow evolve      Ask questions, discover patterns, add signals
       ↓
  /make               Rebuild from within evolve
       ↓
  Back to explore...

---

Pyramide analytique

                ┌─────────────┐
                │  Verdicts   │  WHY is it happening?
                ├─────────────┤
                │  Theses     │  WHAT is happening?
                ├─────────────┤
                │  Signals    │  What does the DATA show?
                ├─────────────┤
                │ Perspectives│  Entity-level health scores
                ├─────────────┤
                │    Gold     │  Product contract
                ├─────────────┤
                │   Silver    │  Domain truth
                ├─────────────┤
                │   Bronze    │  Structural ingestion
                └─────────────┘

    ┌─────────────┐
    │  SMEbits    │  Expert knowledge (free-floating)
    ├─────────────┤
    │ BitBundles  │  Curated narratives
    └─────────────┘

---

Variables d’environnement

Variable	Usage
JINFLOW_LIVE	Override du live root (répertoire de données)
JINFLOW_TENANT	Override du tenant par défaut
JINFLOW_DB_PATH	Chemin KLS DuckDB explicite
JINFLOW_AFS_ROOT	Racine AFS (pour l’Explorer)
JINFLOW_SYSTEM_DB_PATH	Chemin DB système (optionnel)
JINFLOW_DEPLOY_ROOT	Deploy root pour le package applicatif
ANTHROPIC_API_KEY	Clé API Claude (pour evolve)