feat(editors): Cameo plugin running models on OpenSysML

[devin-ai-integration]

What and why

Phase 1 of docs/internals/design/cameo-plugin.md: a Resource Manager-installable plugin under editors/cameo/ that lets Cameo Systems Modeler 2026x Refresh1 (2024x Refresh3 as the minimum) run models on OpenSysML.

• Context menu. An OpenSysML group on the containment-tree and diagram context menus with Instantiate, Execute action, Execute state machine, Verify requirement/constraint, Evaluate calc and Run analysis, offered for exactly one selected element. Verify picks verifyRequirement / verifySatisfaction / verifyConstraint from the symbol's kind.
• Two model paths. A SysML v2 element (2026x) is exported through SysMLTextualNotationService.exportTextual; a SysML v1 element leaves as a .mdzip (the saved file when the project is clean, otherwise ProjectsManager.exportModule of the primary model) and goes through Connection.convertFile(…, "sysml"). Both continue with parseSources and the operation.
• Results. A docking OpenSysML Results ProjectWindow per project with outcomes, diagnostics, final time and state schedule; double-click opens the element in the containment tree. Verdicts are posted as Annotations (passed → info, failed → error, error/cancelled → warning), replacing the previous run's.
• Off the EDT. Export and identity indexing run on the EDT; the service call runs under ProgressStatusRunner with cancel. Cancel closes the connection (aborting the in-flight RPC); the next run reopens it. sysml-grpc starts on the first run, not at plugin load, and close() stops it.
• Licence-free CI. openapi-stubs/ holds compile-only signatures of the com.nomagic.* / com.dassault_systemes.* API the plugin touches (every body throws UnsupportedOperationException("compile-only stub")); it is a provided dependency and never packaged. scripts/compile-against-cameo.sh compiles against a real installation via CAMEO_HOME.
• Distribution. mvn -f editors/cameo/pom.xml -Dopensysml.version=vX.Y.Z package downloads the five sysml-grpc release assets, verifies each against the digest table the Java client jar ships (unpinned version or mismatch fails the build), generates plugin.xml with a <library> per runtime jar, and zips plugins/org.openmbee.opensysml.cameo/{plugin.xml,*.jar,lib/,bin/} plus data/resourcemanager/.
• CI. New cameo-plugin job (also triggered by client/java/ changes) wired into the build-and-test gate; scripts/ci-changed-areas.sh gains a cameo area.

Deviations from the design document (recorded in §11.1 of the doc)

• Maven instead of Gradle, matching client/java; the client is consumed as an installed artifact.
• plugin-v2 is folded into plugin (package …cameo.v2): the KerML/textual classes are stubbed like the rest, so nothing forces a second module. The v2 path is taken only when the textual service class loads and the selection is a KerML element.
• Identity is by qualified name on both paths, since Convert does not return the migration report yet; every candidate for an ambiguous name is annotated, and unmatched names are shown in the results window without an element link.
• Six per-operation actions instead of a Run dialog; sweep, schedule policy and Reveal converted model are deferred.
• The results window and annotations (phase 2 in the doc) are included; the RuleViolationResult bridge is not.
• One lazily opened connection with cancel-by-close, rather than two connections with different deadlines.

Deferred

Step debugging, units, migration-report identity (needs the service change), RuleViolationResult / validation-suite bridge, sweeps.

How it was verified

• mvn -f editors/cameo/pom.xml verify -Dopensysml.requireService=true — 24 tests: path selection, qualified-name normalization, identity index (ambiguity, quoted v1 names, IDs, instance-path prefixes), results mapping for all eight client result types, annotation severities, ownership walking, host-binary naming, descriptor generation, binary staging (valid, tampered, unpinned).
• PipelineEndToEndTest against the real bin/sysml-grpc: a .mdzip built from tests/migrate/testdata/xmi/vehicle.xmi → V1MdzipSource → convert → parse → verify 'Vehicle Design'::Vehicle::'positive mass' (passes) and Requirements::'Mass Requirement' (no evaluable condition → error → warning annotation); a v2 textual fixture → verify pass/fail with asserted annotation severities, instantiate, execute state (schedule), evaluate calc, missing-symbol error, cancellation before/during a run and reconnect afterwards.
• mvn -f editors/cameo/pom.xml -Dopensysml.version=v0.3.0 verify produced OpenSysML_Cameo_v0.3.0.zip with all five platform binaries and a generated plugin.xml; -Dopensysml.version=v0.8.1 fails with version is not pinned.
• scripts/ci-changed-areas-test.sh, python3 scripts/changelog.py check, python3 scripts/check-doc-ids.py, go vet ./..., gofmt -l . clean.

Checklist

• make test and make lint pass locally
• Tests added or updated for the change
• Documentation extended where it already covers the surface (see CONTRIBUTING.md)
• Changelog entry added as changes/unreleased/<slug>.<section>.md, not as an edit to CHANGELOG.md
• baselines regenerated and make docs-counts run if a gate count moved (compliance rows need nothing: the census is counted at docs build)
• No internal work-item labels (waves, slices, F4, K5) in the body, docs, or changelog

[devin-ai-integration]

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

• Disable automatic comment, CI, and merge conflict monitoring