sygal-cli 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Sygal CLI License
+
+Copyright (c) 2026 Cyrill Semah. All rights reserved.
+
+This software is proprietary. You may install and use it, free of charge
+during the trial period and under a valid Sygal license thereafter, for
+personal or internal business purposes.
+
+You may not copy, modify, reverse engineer, redistribute, sublicense or
+sell this software or any part of it without prior written permission
+from the author.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY ARISING FROM THE USE OF THE SOFTWARE.
+
+More information: https://sygal.app

package/README.md

@@ -0,0 +1,128 @@
+<div align="center">
+
+# Sygal CLI
+
+Convertit fichiers, dossiers et pages web en Markdown / JSON, en local.
+
+</div>
+
+<div align="center">
+  <a href="#français">Français</a> · <a href="#english">English</a>
+</div>
+
+---
+
+## Français
+
+Le moteur de l'app desktop Sygal, en ligne de commande : pipeline local
+MarkItDown (aucun document envoyé sur le réseau), OCR API pour les images,
+pensé pour les humains ET pour les agents IA (sortie `--json` stricte,
+mode OCR différé).
+
+### Installation
+
+```bash
+npm install -g sygal-cli
+```
+
+Le moteur de conversion natif (macOS Apple Silicon, Windows x64) est installé
+automatiquement. Essai gratuit 14 jours, puis licence LemonSqueezy
+(https://sygal.lemonsqueezy.com) - un poste par activation, pool partagé avec
+l'app desktop.
+
+### Conversion
+
+```bash
+sygal convert rapport.pdf                          # rapport.pdf.md à côté de la source
+sygal convert dossier/ --format both -o ./sorties  # récursif, .md + .json
+sygal convert https://example.com/article          # page web → markdown
+sygal convert scan.pdf --pdf-ocr all               # PDF scanné, OCR page par page
+sygal convert doc.docx --advanced                  # OCR des images embarquées
+sygal convert note.txt --translate en              # traduction du résultat
+```
+
+- Routage automatique par type de fichier : images → OCR API, tout le reste →
+  MarkItDown 100% local (27 extensions : pdf, docx, xlsx, pptx, xls, html,
+  csv, txt, md, json, xml, epub, msg, eml, ipynb, zip, png, jpg, gif, webp,
+  tiff, heic...).
+- Sortie par défaut : dossier source de chaque fichier, collisions gérées
+  (`nom.md` → `nom (1).md`). Enveloppe JSON identique à l'export de l'app.
+- Garde-fou de coût : `--max-ocr-calls N` (ou `sygal config set-max-ocr-calls`).
+
+### Configuration OCR
+
+```bash
+sygal config set-ocr-provider openai      # openai | mistral | claude | nvidia | gemini
+sygal config set-api-key openai           # clé lue sur stdin, chiffrée (liée à la machine)
+sygal config show                         # présence des clés, jamais leur valeur
+```
+
+Variables d'environnement : `SYGAL_OCR_PROVIDER`, `SYGAL_OCR_API_KEY`,
+`SYGAL_LICENSE_KEY` (activation auto), `SYGAL_SIDECAR_PATH`, `SYGAL_CONFIG_PATH`.
+
+### Pour les agents IA (Hermes, OpenClaw...)
+
+```bash
+# Sortie strictement machine, codes d'erreur stables, exit 1 si échec
+sygal convert dossier/ --json
+
+# OCR différé : AUCUN appel API - l'agent transcrit lui-même
+sygal convert doc.docx --advanced --ocr defer --json
+#   → images extraites dans doc.docx.images/, marqueurs ![sygal:ocr:N] dans le .md,
+#     liste "deferred" dans le JSON (index, chemin, page)
+sygal inject doc.docx.md --transcripts transcriptions.json
+#   → réintègre chaque transcription à sa position exacte
+```
+
+Codes d'erreur (`--json`) : `unsupported_format`, `api_key_missing`,
+`invalid_api_key`, `rate_limited`, `network_error`, `scanned_pdf_detected`,
+`ocr_call_limit_exceeded`, `license_expired`, `sidecar_down`, `timeout`...
+
+### Licence et mise à jour
+
+```bash
+sygal license activate <clé>   # active (un poste)
+sygal license status           # essai / active / expirée
+sygal license deactivate       # libère le poste
+sygal update                   # met à jour via npm (--check : vérifier seulement)
+```
+
+---
+
+## English
+
+The Sygal desktop engine as a CLI: local MarkItDown pipeline (documents never
+leave your machine), API OCR for images, built for humans AND AI agents
+(strict `--json` output, deferred OCR mode).
+
+### Install
+
+```bash
+npm install -g sygal-cli
+```
+
+Native conversion engine (macOS Apple Silicon, Windows x64) installs
+automatically. 14-day free trial, then a LemonSqueezy license
+(https://sygal.lemonsqueezy.com) - one seat per activation, shared with the
+desktop app.
+
+### Usage
+
+```bash
+sygal convert report.pdf                # report.pdf.md next to the source
+sygal convert folder/ --format both     # recursive, .md + .json
+sygal convert https://example.com --json
+sygal convert scan.pdf --pdf-ocr all    # scanned PDF, per-page OCR
+sygal convert doc.docx --advanced --ocr defer --json   # agent-side OCR
+sygal inject doc.docx.md --transcripts t.json
+```
+
+Configuration: `sygal config set-ocr-provider`, `sygal config set-api-key`
+(read from stdin, encrypted at rest with a machine-bound key). License:
+`sygal license activate/status/deactivate`. Updates: `sygal update`.
+
+---
+
+<div align="center">
+  © 2026 Cyrill Semah. All rights reserved.
+</div>

package/bin/sygal.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js')