@enfocussw/switch-scripting-context 25.11.0-beta.16 → 25.11.0-beta.17

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this package are documented here. Format follows
 
 ## [Unreleased]
 
+## [25.11.0-beta.17] - 2026-09-11
+
+### Changed
+- `job.md`'s `sendToData()` entry and `connection.md`'s `getPropertyStringValue()` entry now warn
+  directly, at the point an agent is most likely to read them, that there is no way to check in
+  advance whether a connection accepts a given traffic light level. The warning previously lived
+  only in a separate section agents weren't always reaching first.
+
 ## [25.11.0-beta.16] - 2026-09-10
 
 ### Added

package/README.md

@@ -4,7 +4,7 @@ AI coding assistant context for [Enfocus Switch](https://www.enfocus.com/en/swit
 
 Installs curated API reference docs and generates config files for 8 AI coding agents (Claude Code, GitHub Copilot, Cursor, Codex CLI/OpenCode, Gemini CLI, Windsurf, Zed, and Cline) so AI assistants understand the Switch scripting API out of the box.
 
-See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.0-beta.16/CHANGELOG.md) (also included in this package) for what's changed between versions.
+See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.0-beta.17/CHANGELOG.md) (also included in this package) for what's changed between versions.
 
 ## Usage
 
@@ -84,7 +84,7 @@ A few things this gets you without asking for them by name:
   properties (app path/licence) are off-limits and left to SwitchScripter's GUI instead.
 
 Re-run `init` after upgrading this package so the copied docs and generated config files catch up.
-See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.0-beta.16/CHANGELOG.md) for what changed.
+See [CHANGELOG.md](https://cdn.jsdelivr.net/npm/@enfocussw/switch-scripting-context@25.11.0-beta.17/CHANGELOG.md) for what changed.
 
 ## Options
 

package/docs/switch-api/connection.md

@@ -37,6 +37,8 @@ connection.getPropertyStringValue(tag: string): Promise<string | string[]>
 ```
 Returns the connection property value as a string. Throws `"Invalid tag: <tag>"` if the tag is unknown **or if it's a `Dependency` dependent currently hidden by its master's value** — see [script-declaration.md § Dependency](../switch-project/script-declaration.md#custom-property-elements-elementfields). Before fetching a dependent property, confirm its condition holds (from the already-read master value, or via `hasProperty(tag)` below) rather than fetching it unconditionally.
 
+This is **not** how to check which traffic light level(s) a connection accepts before calling `job.sendToData()` — `"Success"`/`"Warning"`/`"Error"` are not property tags, so passing one throws the same invalid-tag error. There is no supported way to check in advance; see [Connection.Level enum](#connectionlevel-enum) below.
+
 ```ts
 connection.getPropertyType(tag: string): PropertyType
 ```

package/docs/switch-api/job.md

@@ -65,7 +65,7 @@ Send to a specific connection (any type). Get connections via `flowElement.getOu
 ```ts
 job.sendToData(level: Connection.Level, newName?: string): Promise<void>
 ```
-Send via a traffic light "data" connection at the specified level. Fails the job if no matching connection exists.
+Send via a traffic light "data" connection at the specified level. Fails the job if no matching connection exists. **There is no supported way to check in advance whether a connection at that level exists** — don't call `connection.getPropertyStringValue("Success")`/`"Warning"`/`"Error"` expecting to detect this; that throws an invalid-tag error, since traffic light levels aren't a readable connection property. See [job-patterns.md § Sending jobs](job-patterns.md#sending-jobs) for the pattern (an explicit custom property plus `job.sendToNull()`).
 
 ```ts
 job.sendToLog(level: Connection.Level, model: DatasetModel, newName?: string): Promise<void>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfocussw/switch-scripting-context",
-  "version": "25.11.0-beta.16",
+  "version": "25.11.0-beta.17",
   "description": "AI coding assistant context for Enfocus Switch scripting (Node.js/TypeScript)",
   "keywords": [
     "switch",