Les commandes d’archec
archec <command> … — Sans commande, archec liste celles de tous les jours.
archec help --all liste toutes les commandes, classées selon leur usage (les
sections ci-dessous). archec help <command> (ou archec <command> --help)
donne l’usage d’une commande et un exemple. archec --version donne la
version. Une commande qui vérifie quelque chose sort avec le code 1 quand elle
trouve un problème : chacune peut donc servir d’étape de CI. archec ci les
lance toutes à la fois.
Chaque groupe de commandes a sa page.
| Groupe | À quoi il sert | Commandes |
|---|---|---|
| Démarrer | Les commandes qui lancent un projet et donnent de l’aide. | new, help, config |
| Écrire et vérifier | Les commandes que vous utilisez pendant que vous écrivez un modèle : le vérifier, le corriger et le mettre en forme. | check, fix, explain, suggest, vet, fmt, edit, review, live-fix, mcp, convert-handlers, stubs, patterns, ast |
| Construire et tester | Les commandes qui construisent le projet Arche, lancent ses tests et le simulent. | build, pull, test, sim, physics, fit, difftest, where, ci, validate, diff |
| Analyser | Les commandes qui analysent un modèle et le système en fonctionnement : temps de réponse, model checking, sûreté, sécurité et journaux. | analyze, timing, verify, why, why-not, replay, live, study, safety, tara, parts, merge, observe, cad, synth |
| Présenter | Les commandes qui montrent un modèle : animations, écrans du produit, application Arche et récits. | animation, ui, app, story |
| Exigences | Les commandes pour les exigences : baselines, validation, tickets, normes, spécifications et diagrammes. | baseline, approve, approvals, issues, cert, qualify, polarion, reqif, doc, diagram |
| Générer | Les commandes qui écrivent, à partir du modèle, du code et des fichiers pour d’autres outils. | gen, generator, plugin, fmi, kicad, sysml, export, api, capella |
| Importer | La commande qui lit les fichiers d’autres outils et les traduit en arche-lang. | import |
| Refactoriser | Les réécritures qui changent la façon dont un modèle est écrit, mais pas son sens. | refactor |
| Code et modèle | Les commandes qui comparent du code existant au modèle. | recover, conform, arch-diff, impact, brief, agent-context |
| Bibliothèques | La commande qui gère les bibliothèques versionnées d’un projet. | lib |
| Cartes | Les commandes pour les cartes, les périphériques et leurs broches. | board, device, pins |
| Store | Les commandes qui cherchent, ajoutent et publient des paquets de l’Arche Store. | store, add, audit, publish, search, shelf |
| Provenance | Les commandes qui indiquent qui a écrit chaque morceau de code, et qui le comprend. | provenance, guard, debt |
Exemples#
npm install && npm run build
node dist/cli.js build examples/autonomous-car/main.arche -o out # → an Arche project
../arche/dist/arche-darwin-arm64 --project out # open it
node dist/cli.js check examples/autonomous-car/main.arche # lint (exit 1 on errors, --strict on warnings, --json)
node dist/cli.js fmt --write examples/**/*.arche # format
node dist/cli.js fmt --simplify --write old.arche # rewrite in the short forms (same meaning)
node dist/cli.js fmt --extract-code --write main.arche # move ```python blocks into .py files (same meaning)
node dist/cli.js stubs main.arche # .arche/typings: Arche's helpers + the model's names, for Python and TypeScript tooling
node dist/cli.js pull main.arche --write # code edited in the Arche app → back into the .py / .arche sources
node dist/cli.js test main.arche # build + arche-cli test, errors shown at their source line
node dist/cli.js analyze examples/autonomous-car/main.arche # core load, response times, bus load, latency chains
node dist/cli.js difftest examples/live/main.arche # the simulator and the generated C on the same random inputs
node dist/cli.js physics examples/dc-motor/main.arche Drive --integrator implicit --tol 1e-6 # a physical network, a stiff one too
node dist/cli.js physics examples/dc-motor/main.arche Drive --linearize --inputs supply.v --lqr 1,0.1 # A, B, C, D, its modes, an LQR gain
node dist/cli.js physics examples/dc-motor/main.arche Drive --batch 100 --vary motor.r=0.8..1.2 --csv runs.csv # 100 runs over worker threads
node dist/cli.js sim examples/live/main.arche --html sim.html # one page that runs the model live: pause, step, speed, send, plots
node dist/cli.js doc examples/autonomous-car/main.arche -o spec.tex # LaTeX specification (lualatex spec.tex)
node dist/cli.js doc examples/autonomous-car/main.arche --template examples/templates/autonomous-car-spec.docx -o spec.docx # your Word template, filled ({{ … }}: docs/templates.md)
node dist/cli.js diagram main.arche Car --md >> README.md # a diagram as Mermaid, which GitHub draws (or --format d2|svg)
node dist/cli.js validate ../arche/sample-aesa # schema-check any Arche project
node dist/cli.js patterns # the pattern reference
node dist/cli.js import model.sysml -o model.arche # a SysML v2 model in arche-lang
node dist/cli.js import bus.dbc -o bus.arche # a CAN DBC: frames, signals, nodes, routes
node dist/cli.js capella main.arche -o project.zip # a Capella 6.1 project (and back: capella model.capella -o dir)
node dist/cli.js ci main.arche --junit report.xml # every check a pipeline runs, one exit code
node dist/cli.js check main.arche --sarif archec.sarif # the diagnostics as SARIF, for code scanning
node dist/cli.js lib main.arche lock # the versioned libraries used, locked in arche.lock
node dist/cli.js recover src -o recovered.arche # the architecture of code, as arche-lang
node dist/cli.js conform recovered.arche # the code's imports against the model's links
node dist/cli.js arch-diff src main..HEAD --md # what a branch changed in the architecture
node dist/cli.js impact main..HEAD --md # why each hunk exists: part, functions, requirements, tests