Référence › Commandes

Référence

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