Safety And Sharing¶
This repo is tooling. Keep real SysML v2 source, private Flexo exports, rendered snapshots, run logs, and service evidence in a private workspace or private repository.
Private Workspace Boundary¶
Recommended layout:
~/work/sysmlv2-lab/ shared tooling repo
~/work/my-private-models/ private model workspace or private repo
Set MBSE_MODEL_WORKSPACE when you want generated bridge artifacts to default
outside this repo:
With that variable set, flexo-export, render-sysml, and flexo-to-syson
write generated artifacts under $MBSE_MODEL_WORKSPACE/exports/ unless you
pass explicit output paths.
Runtime Credentials¶
Runtime credential files are intentionally ignored by git:
Commit only the .example templates. Generate local runtime env files with:
Rotate local Flexo credentials at any time:
Restart Flexo after rotating credentials. For SysON, mbse-lab init creates
deploy/syson/.env from the example and replaces the placeholder database
password. When doing that manually, copy the template and set a private
password:
Service Data¶
Flexo model graph data is stored in Fuseki. In this local setup, Fuseki starts from:
Use a backup after creating important model data or changing Flexo cluster/org setup:
Backups are written to ignored storage:
Updating the tracked startup seed requires explicit intent and should be used only for synthetic, publishable startup data:
SysON stores its database in a host bind mount:
Normal mbse-lab services down keeps that data. Avoid deleting data directories
unless you intentionally want to reset the environment.
Share Check¶
Before sharing or publishing the tooling repo, run:
It checks for accidentally tracked runtime env files, service data, generated private exports, run logs, diagnostics bundles, and known local secret patterns.
Generate a static local lab report:
The report writes Markdown, HTML, and JSON snapshots under reports/latest/.
When bridge run logs exist, it links the latest run log and generated artifact
paths and summarizes render coverage counts without embedding model content.
Remove generated local reports, diagnostics, run logs, and temporary output:
Use mbse-lab cleanup --dry-run to preview cleanup targets first.