@oal-sarl/code 6.0.0

package/LICENSE.md

@@ -0,0 +1,23 @@
+Copyright (c) 2026 OAL SARL. All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to OAL SARL.
+
+No license is granted to use, copy, modify, merge, publish, distribute,
+sublicense, sell, rent, lease, reverse engineer, decompile, disassemble, or
+create derivative works from the Software, in whole or in part, except under a
+separate written agreement signed by OAL SARL.
+
+You may not remove, alter, or obscure any copyright, trademark, confidentiality,
+or proprietary notices included with the Software.
+
+The Software is provided "AS IS", without warranties of any kind, express or
+implied, including but not limited to merchantability, fitness for a particular
+purpose, title, non-infringement, or uninterrupted operation.
+
+In no event shall OAL SARL be liable for any claim, damages, or other liability,
+whether in an action of contract, tort, or otherwise, arising from, out of, or
+in connection with the Software or the use or other dealings in the Software.
+
+For licensing, commercial use, redistribution, OEM, or partnership inquiries:
+legal@oalsarl.example

package/README.md

@@ -0,0 +1,286 @@
+# Code v6 Augmented
+
+Produit CLI de coding `OAL SARL`, propulse par Pollinations AI (`kimi`, `mistral`, `gemini-fast`).
+
+## Proprietary Product Notice
+
+`Code` est un produit proprietaire de `OAL SARL`.
+
+- Licence du produit: voir [LICENSE.md](./LICENSE.md)
+- Notice produit: voir [NOTICE.md](./NOTICE.md)
+- Marques et branding: voir [TRADEMARKS.md](./TRADEMARKS.md)
+
+## Prerequis
+
+- Node.js `>= 20`
+- Bun `>= 1.0`
+- Git
+- Shell local disponible
+  - Windows: PowerShell 5+ ou PowerShell 7+
+  - macOS / Linux: `bash` ou `sh`
+  - Git Bash sur Windows reste supporte, mais n'est plus obligatoire
+
+## Installation
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+Installation globale:
+
+```bash
+npm pack
+npm install -g ./oal-sarl-code-6.0.0.tgz
+```
+
+Si `oal-code` n'est pas reconnu sous PowerShell:
+
+```powershell
+$env:Path += ";$env:APPDATA\npm"
+```
+
+## Configuration API
+
+Obtiens une cle sur <https://enter.pollinations.ai> puis:
+
+```bash
+oal-code config --key pk_xxx
+```
+
+Options:
+
+```bash
+oal-code config --model mistral
+oal-code config --language fr
+oal-code config --no-memory
+oal-code config --no-web-search
+oal-code config --no-undo
+```
+
+## Usage
+
+Mode interactif:
+
+```bash
+oal-code chat
+```
+
+Publication npm publique:
+
+```bash
+npm login
+npm publish --access public
+```
+
+Package npm cible:
+
+```text
+@oal-sarl/code
+```
+
+Repository npm/publication cible:
+
+```text
+https://github.com/oal-sarl/code
+```
+
+Statut de diffusion:
+
+- package public npm
+- code source interne non expose via `src/`
+- artefact distribue via bundle `dist/`
+
+Mode one-shot (CI/script):
+
+```bash
+oal-code run "Analyse ce projet et propose un plan."
+```
+
+## Slash Commands v6
+
+- `/plan <task>`
+- `/fix <error>`
+- `/test <file>`
+- `/review`
+- `/refactor <file>`
+- `/model <kimi|mistral|gemini-fast>`
+- `/git <action>`
+- `/file <path>` (PDF/image/csv/json/txt)
+- `/img <path>` (alias)
+- `/screenshot [url]`
+- `/preview [url]`
+- `/history`
+- `/share`
+- `/skill [name]`
+- `/render <remotion|manim>`
+- `/agents t1 | t2 | t3`
+- `/session <new|list|switch|close>`
+- `/sandbox <safe|docker|none>`
+- `/undo`
+- `/memory`
+- `/env`
+- `/clear`
+- `/clear --memory`
+- `/help`
+
+## Capacites v6
+
+- Multi-session interactive (creation/switch/close, sessions paralleles).
+- Historique JSONL par projet/session (`~/.code/history/...`).
+- Vision fichiers (`/file`, `/img`) avec PDF/CSV/image.
+- Screenshot Playwright (`/screenshot`) + analyse visuelle.
+- Preview server local (`/preview`) avec auto-reload.
+- Skills built-in + user skills (`src/skills`, `~/.code/skills`).
+- Sandbox shell (`safe`, `docker`, `none`) avec fallback robuste.
+- Transactions atomiques avec rollback et preview.
+- Edition AST TypeScript avec fallback propre.
+- Judge hybride et verification outillee avant reponse finale.
+- Tool verification policy + parser dual `<n>/<name>`.
+- Compaction contexte abortable + fallback local anti-blocage.
+
+## Tool Verification Policy
+
+Code impose une regle de verification:
+
+- Toute affirmation factuelle sur le codebase (fichiers, symboles, architecture, etat git) doit etre basee sur au moins un appel outil (`read_file`, `search_code`, `list_dir`, `git_*`, `bash`).
+- Si aucune preuve outil n'est collectee, Code force un appel d'outil avant la reponse finale.
+
+## Debug et Monitoring
+
+Activer les logs:
+
+```bash
+CODE_DEBUG=1 oal-code chat
+```
+
+Logs exposes:
+
+- tool calls parses,
+- execution parallele,
+- ledger de preuves outils,
+- raisons de compaction fallback,
+- healing attempts.
+- metrics de fiabilite (`iterations`, `toolCalls`, `toolErrors`, retries, interruptions) en mode debug.
+
+## Benchmarks publics
+
+Benchmark fiabilite v1:
+
+```bash
+npm run bench
+```
+
+Sorties:
+- `bench/results/latest.json`
+- `bench/results/latest.md`
+
+Variables utiles:
+- `CODE_BENCH_TIMEOUT_MS` (defaut: `180000`)
+- `CODE_BENCH_RETRIES` (defaut: `1`)
+- `CODE_BENCH_SCENARIO_LIMIT` (defaut: `0`, tous les scenarios)
+
+## SWE-lite (pass@1)
+
+Mesure proxy de type SWE (non officielle SWE-bench), avec verifications attendues scenario par scenario:
+
+```bash
+npm run swe:lite
+```
+
+Sorties:
+- `bench/results/swe-lite-latest.json`
+- `bench/results/swe-lite-latest.md`
+
+Variables utiles:
+- `CODE_SWE_LITE_TIMEOUT_MS` (defaut: `120000`)
+- `CODE_SWE_LITE_MODEL` (defaut: `mistral`)
+
+## Troubleshooting
+
+### Windows UTF-8 / glyphes
+
+- Code supporte fallback ASCII via `src/ui/glyphs.ts`.
+- Si besoin, force ASCII:
+
+```powershell
+$env:CODE_GLYPHS = "ascii"
+```
+
+### Shell introuvable
+
+Code choisit automatiquement un shell selon l'OS:
+
+- Windows: Git Bash si present, sinon `pwsh`, puis `powershell`, puis `cmd`
+- macOS / Linux: `bash`, puis `sh`
+
+Tu peux forcer un shell avec:
+
+```powershell
+$env:CODE_SHELL_PATH = "C:\Program Files\PowerShell\7\pwsh.exe"
+```
+
+Compatibilite historique Git Bash:
+
+```powershell
+$env:CODE_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
+```
+
+### Erreurs API Pollinations
+
+- `401`: cle invalide.
+- `402`: solde insuffisant.
+- `429`: rate-limit (retry/backoff auto).
+- `503`: indisponibilite temporaire (retry auto).
+
+### TTY / session interactive
+
+- `oal-code chat` requiert un terminal TTY.
+- En CI, utilise `oal-code run "..."`
+
+## Release v6
+
+Verification release locale:
+
+```bash
+npm test
+npm run build
+npm pack
+```
+
+Verification du tarball:
+
+```bash
+npm install -g ./oal-sarl-code-6.0.0.tgz
+oal-code --version
+oal-code run "Lis package.json et donne-moi le nom du projet."
+```
+
+## Distribution multi-plateforme
+
+Code est aujourd'hui distribue comme CLI Node.js cross-platform, pas comme binaire natif autonome.
+
+Plateformes cibles:
+
+- Windows 10/11 avec PowerShell ou Git Bash
+- macOS avec `bash` ou `sh`
+- Linux avec `bash` ou `sh`
+
+Points de verification avant publication:
+
+- `npm test`
+- `npm run build`
+- `npm pack`
+- test local Windows
+- test local macOS
+- test local Linux
+
+Commande de smoke test recommandee sur chaque OS:
+
+```bash
+oal-code --version
+oal-code run "Lis package.json et donne-moi le nom du projet."
+oal-code chat --setup
+```