sysml-validate 0.10.15 → 0.10.16

package/README.md

@@ -43,7 +43,7 @@ sysml-validate [paths...] [options]
   --max-warnings <n>    Fail when more than n warnings are reported.
   --all                 Report informational notices and hints too.
   --lint-profile <p>    Override sysml.lint.profile: default | quiet | strict.
-  --workspace <path>    Project root holding .vscode/ (default: auto-detected).
+  --workspace <path>    Index this project for cross-file reference resolution.
   --no-config           Ignore .vscode/settings.json and .vscode/sysml/project.json.
   --library <path>      Standard-library directory (default: the bundled library).
   --color, --no-color   Force ANSI colour on or off (default: on a terminal only).
@@ -51,7 +51,10 @@ sysml-validate [paths...] [options]
 
 Paths may be files or directories; directories are searched recursively for
 `.sysml` and `.kerml`, skipping `node_modules`, VCS directories, build output,
-and vendored library trees. With no path, the working directory is checked.
+and vendored library trees. With no path, the working directory is checked.
+By default, no model file outside the paths you name is discovered or indexed.
+Use `--workspace <path>` only when references should resolve against other
+project files.
 
 The OMG standard library ships with the package, so `Real`, `ISQ::*`, `SI::*`
 and the rest resolve with nothing else installed.
@@ -112,14 +115,21 @@ $ sysml-validate models/ --format json | jq '.counts, .diagnostics[0].code'
 $ sysml-validate models/ --max-warnings 5 && echo "model is publishable"
 ```
 
-**Check just what changed**, letting the rest of the project resolve around it:
+**Check just what changed**, without loading any model outside that list:
 
 ```console
-$ git diff --name-only --diff-filter=d origin/main | grep -E '\.(sysml|kerml)$' | xargs -r sysml-validate
-```
-
-Cross-file references still resolve: the whole project is indexed for lookups,
-while only the files you name are reported on.
+$ git diff --name-only --diff-filter=d origin/main | grep -E '\.(sysml|kerml)$' | xargs -r sysml-validate
+```
+
+If those files need definitions elsewhere in the checkout, opt into workspace
+indexing explicitly:
+
+```console
+$ git diff --name-only --diff-filter=d origin/main | grep -E '\.(sysml|kerml)$' | xargs -r sysml-validate --workspace .
+```
+
+`--workspace .` indexes the rest of the project for reference resolution, but
+still reports diagnostics only for the files you named.
 
 **Use it from a coding agent.** The default output is plain text with a stable
 one-line summary, so an agent can act on it directly:

package/out/main.js

@@ -8898,7 +8898,9 @@ Usage:
   sysml-validate [paths...] [options]
 
 Paths may be files or directories; directories are searched recursively for
-.sysml and .kerml files. With no path, the working directory is checked.
+.sysml and .kerml files. Validation never discovers model files outside those
+paths unless --workspace is supplied. With no path, the working directory is
+checked.
 
 Options:
   --format <fmt>        ${REPORT_FORMATS.join(" | ")} (default: text).
@@ -8909,7 +8911,7 @@ Options:
   --max-warnings <n>    Fail when more than n warnings are reported.
   --all                 Report informational notices and hints too.
   --lint-profile <p>    Override sysml.lint.profile: ${LINT_PROFILES.join(" | ")}.
-  --workspace <path>    Project root holding .vscode/ (default: auto-detected).
+  --workspace <path>    Index this project for cross-file reference resolution.
   --no-config           Ignore .vscode/settings.json and .vscode/sysml/project.json.
   --library <path>      Standard-library directory (default: the bundled library).
   --color, --no-color   Force ANSI colour on or off (default: on a terminal only).
@@ -8923,6 +8925,7 @@ Exit codes:
 
 Examples:
   sysml-validate model.sysml
+  sysml-validate model.sysml --workspace .
   sysml-validate models/ --strict
   sysml-validate . --format sarif --out sysml.sarif
   sysml-validate . --format github        # inline annotations in a workflow log
@@ -68346,14 +68349,16 @@ function applySettings(settings, lintProfileOverride) {
 }
 async function runValidation(command) {
   const files = collectModelFiles(command.paths);
-  const root3 = command.workspace ? path10.resolve(command.workspace) : findWorkspaceRoot(files[0] ?? command.paths[0] ?? ".");
+  const workspaceRoot = command.workspace === void 0 ? void 0 : path10.resolve(command.workspace);
+  const root3 = workspaceRoot ?? findWorkspaceRoot(files[0] ?? command.paths[0] ?? ".");
   applySettings(command.noConfig ? {} : sysmlSettings(root3), command.lintProfile);
   const services = await bootServices({
     fromDir: path10.dirname(fileURLToPath(import.meta.url)),
     library: command.library,
-    // Index the project root so cross-file references resolve the way they
-    // do with the workspace open in the editor.
-    workspaceFolders: [root3]
+    // A validator invocation is scoped exactly to the paths the user named.
+    // Project-wide discovery is an explicit opt-in through --workspace.
+    workspaceFolders: [root3],
+    skipWorkspaceIndex: workspaceRoot === void 0
   });
   const documents = [];
   for (const file of files) documents.push(await services.document(file));
@@ -68370,7 +68375,7 @@ async function runValidation(command) {
 }
 
 // src/main.ts
-var VERSION2 = true ? "0.10.15" : "dev";
+var VERSION2 = true ? "0.10.16" : "dev";
 async function main(argv) {
   const command = parseArgs(argv);
   if (command.kind === "help") {