plccheck 2.10.1 → 2.11.0

package/README.md

@@ -15,6 +15,8 @@ npx plccheck check ./path/to/project
 - `plccheck serve` (LSP server over stdio)
 - `plccheck check <files-or-folders...>`
 - `plccheck emit --target <language> <file>`
+- `plccheck compile --out <exe> <file-or-folder>`
+- `plccheck run <file-or-folder> [-- runtime args...]`
 - `plccheck test [--filter <text>] [--events-json] [--coverage-json <file>] [--coverage-lcov <file>] <file-or-folder>`
 - `plccheck tia <list|export|import|repair-library-dependencies|online|offline|snapshot|compile|download|trust> ...`
 - `plccheck version`
@@ -41,6 +43,20 @@ npx plccheck test ./my-plc-project --coverage-json coverage.json --coverage-lcov
 
 Note: `--events-json` prints a stream of execution events to stdout, while `--coverage-json` writes a finalized coverage report to a file. Coverage artifacts include statement, function, and branch data where runtime data is available. For AI analysis, use the file artifact from `--coverage-json`.
 
+## Compile and Run PLC Runtime
+
+Build a runnable PLC runtime executable:
+
+```bash
+npx plccheck compile --out plc-run.exe ./my-plc-project
+```
+
+Build and run it immediately, forwarding runtime flags after `--`:
+
+```bash
+npx plccheck run ./my-plc-project -- --opcua-port 4849 --scan-period 24h
+```
+
 ## TIA Portal Openness
 
 On Windows x64 machines with TIA Portal Openness V21 or newer, `plccheck tia` can attach to a running TIA project or open an explicit `.ap21`/`.zap21` path.
@@ -49,6 +65,7 @@ On Windows x64 machines with TIA Portal Openness V21 or newer, `plccheck tia` ca
 npx plccheck tia trust --json
 npx plccheck tia export --project Demo.ap21 --out exported --plc PLC_1 --delete-stale
 npx plccheck tia import --project Demo.ap21 --root exported "exported/PLC_1/Program blocks/Main.scl" --create
+npx plccheck tia import --project Demo.ap21 --root exported "exported/PLC_1/Program blocks/Main.scl" --overwrite-remote-changes
 npx plccheck tia import --project Demo.ap21 --root exported --skip-library-instances "exported/PLC_1"
 npx plccheck tia import --project Demo.ap21 --root exported "exported/PLC_1/Program blocks"
 npx plccheck tia repair-library-dependencies --project Demo.ap21 --plc PLC_1 --owner CA
@@ -60,8 +77,10 @@ npx plccheck tia snapshot --project Demo.ap21 --plc PLC_1 --json
 npx plccheck tia download --project Demo.ap21 --plc PLC_1 --json
 ```
 
-`export` writes PLC roots with `.plc.json` files and the TIA folder structure. `import` accepts one or more source files or folders, expands folders recursively, and needs `--create` before creating missing TIA folders or blocks. Supported direct import sources are `.scl`, `.s7dcl`, `.db`, `.udt`, `.xml`, `.awl`, `.lad`, and `.fbd`; pass the owning source file instead of `.s7res` resource sidecars or `.meta.json` metadata sidecars. Import refuses to overwrite an existing project-library type instance or one of its project-library dependencies by default; pass `--skip-library-instances` to leave those library-owned targets unchanged and continue importing the rest, or pass `--allow-library-instance-overwrite` only for an intentional mutation run. `repair-library-dependencies` is the safe repair path for that failure class: it recreates the named library instance's project-local dependency objects from the project library. `snapshot` uses TIA's online DB snapshot before moving retained values to start values, skipping safety DBs and DBs without retained members. `download` compiles first, uses the project-configured target, reports the selected target in JSON, and falls back to software-only changes when Siemens Openness rejects a full load because of fail-safe data.
+`export` writes PLC roots with `.plc.json` files and the TIA folder structure. `import` accepts one or more source files or folders, expands folders recursively, and needs `--create` before creating missing TIA folders or blocks. Supported direct import sources are `.scl`, `.s7dcl`, `.db`, `.udt`, `.xml`, `.awl`, `.lad`, and `.fbd`; pass the owning source file instead of `.s7res` resource sidecars or `.meta.json` metadata sidecars. By default, import skips unchanged local files, skips local files whose TIA object changed while the local source stayed unchanged, and rejects files changed both locally and in TIA since the last metadata refresh. Pass `--overwrite` to import when both sides changed, or `--overwrite-remote-changes` to import when only the TIA object changed. Import refuses to overwrite an existing project-library type instance or one of its project-library dependencies by default; pass `--skip-library-instances` to leave those library-owned targets unchanged and continue importing the rest, or pass `--allow-library-instance-overwrite` only for an intentional mutation run. `repair-library-dependencies` is the safe repair path for that failure class: it recreates the named library instance's project-local dependency objects from the project library. `snapshot` uses TIA's online DB snapshot before moving retained values to start values, skipping safety DBs and DBs without retained members. `download` compiles first, uses the project-configured target, reports the selected target in JSON, and falls back to software-only changes when Siemens Openness rejects a full load because of fail-safe data.
+
+If `tia list --json` shows `projectPath` but project commands report that TIA Openness did not expose the project, close that TIA Portal instance and rerun a verification export with `npx plccheck tia export --project <path> --out <dir>` to surface TIA's native open error. This often means the machine is missing a TIA product or add-on required by the project.
 
 Device actions automatically accept non-secret TLS and online-authentication modes. If the PLC requires a project/global/password user, pass `--online-auth-type`, `--online-user` where applicable, and `--online-password-env <env>` so the password is read from an environment variable. Without flags, the bridge also reads `PLCCHECK_TIA_ONLINE_USER_TYPE` or `PLCCHECK_TIA_ONLINE_AUTH_TYPE`, `PLCCHECK_TIA_ONLINE_USER`, and `PLCCHECK_TIA_ONLINE_PASSWORD`.
 
-Use `tia trust --install` to install the Siemens Openness AllowList entry for the packaged bridge after reviewing the `tia trust --json` output. Installation writes HKLM and may require Windows administrator approval through UAC. If the UAC relaunch path is blocked, save the returned `registryFile` content as a `.reg` file and import it from an already elevated shell.
+Use `tia trust --install` to install the Siemens Openness AllowList entry for the packaged bridge after reviewing the `tia trust --json` output. Installation writes HKLM and ensures the current Windows user is a member of the local `Siemens TIA Openness` group, so it may require Windows administrator approval through UAC. If the UAC relaunch path is blocked, run the same command from an already elevated shell.

package/bin/plccheck.js

@@ -49,13 +49,16 @@ const commandValueFlags = {
   check: ['--jobs', '-jobs'],
   emit: ['--target', '-target'],
   transpile: ['--from', '-from', '--to', '-to'],
-  'go-gen': ['--out', '-out', '--module', '-module', '--entry-ob', '-entry-ob'],
+  generate: ['--out', '-out', '--module', '-module', '--entry-ob', '-entry-ob'],
+  compile: ['--out', '-out', '--workdir', '-workdir', '--module', '-module', '--entry-ob', '-entry-ob'],
+  run: ['--out', '-out', '--workdir', '-workdir', '--module', '-module', '--entry-ob', '-entry-ob'],
   test: testValueFlags,
 };
 
 const pathValueFlags = [
   ...coverageValueFlags,
   '--out', '-out',
+  '--workdir', '-workdir',
 ];
 
 function cacheRoot() {
@@ -357,6 +360,9 @@ function resolveGoRunPaths(args, cwd) {
   const valueFlags = commandValueFlags[nextArgs[0]] || [];
   for (let i = 1; i < nextArgs.length; i++) {
     const arg = nextArgs[i];
+    if (nextArgs[0] === 'run' && arg === '--') {
+      break;
+    }
     if (arg.startsWith('-')) {
       const baseFlag = arg.split('=')[0];
       if (arg.includes('=')) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plccheck",
-  "version": "2.10.1",
+  "version": "2.11.0",
   "description": "Siemens PLC language checker + LSP CLI (SCL/ST/LAD/FBD, etc.)",
   "license": "CC-BY-NC-4.0",
   "bin": {
@@ -15,12 +15,12 @@
     "version": "node ../scripts/plccheck-npm-version-hook.mjs"
   },
   "optionalDependencies": {
-    "@danielv123/plccheck-win-x64": "2.10.1",
-    "@danielv123/plccheck-win-arm64": "2.10.1",
-    "@danielv123/plccheck-linux-x64": "2.10.1",
-    "@danielv123/plccheck-linux-arm64": "2.10.1",
-    "@danielv123/plccheck-darwin-x64": "2.10.1",
-    "@danielv123/plccheck-darwin-arm64": "2.10.1"
+    "@danielv123/plccheck-win-x64": "2.11.0",
+    "@danielv123/plccheck-win-arm64": "2.11.0",
+    "@danielv123/plccheck-linux-x64": "2.11.0",
+    "@danielv123/plccheck-linux-arm64": "2.11.0",
+    "@danielv123/plccheck-darwin-x64": "2.11.0",
+    "@danielv123/plccheck-darwin-arm64": "2.11.0"
   },
   "repository": {
     "type": "git",