zinkee 0.1.40 → 0.1.41

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,77 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    name: Publish package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+          package-manager-cache: false
+
+      - name: Check package version
+        id: version
+        shell: bash
+        run: |
+          package_name="$(node -p "require('./package.json').name")"
+          package_version="$(node -p "require('./package.json').version")"
+
+          set +e
+          lookup_output="$(npm view "${package_name}@${package_version}" version 2>&1)"
+          lookup_status=$?
+          set -e
+
+          if [ "$lookup_status" -eq 0 ]; then
+            echo "${package_name}@${package_version} is already published; skipping."
+            echo "already-published=true" >> "$GITHUB_OUTPUT"
+          elif echo "$lookup_output" | grep -q "E404"; then
+            echo "${package_name}@${package_version} is not published yet."
+            echo "already-published=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "$lookup_output" >&2
+            exit "$lookup_status"
+          fi
+
+      - name: Set up trusted publishing
+        if: steps.version.outputs.already-published == 'false'
+        run: npm install --global npm@11.5.1
+
+      - name: Install dependencies
+        if: steps.version.outputs.already-published == 'false'
+        run: npm ci
+
+      - name: Run tests
+        if: steps.version.outputs.already-published == 'false'
+        run: npm test
+
+      - name: Run typecheck
+        if: steps.version.outputs.already-published == 'false'
+        run: npm run typecheck
+
+      - name: Build project
+        if: steps.version.outputs.already-published == 'false'
+        run: npm run build
+
+      - name: Inspect package contents
+        if: steps.version.outputs.already-published == 'false'
+        run: npm pack --dry-run
+
+      - name: Publish package
+        if: steps.version.outputs.already-published == 'false'
+        run: npm publish --access public

package/.github/workflows/pr-checks.yml

@@ -0,0 +1,36 @@
+name: PR Checks
+
+on:
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: Test, Typecheck, and Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Run typecheck
+        run: npm run typecheck
+
+      - name: Build project
+        run: npm run build

package/AGENTS.md

@@ -101,8 +101,9 @@ Prefer focused command tests and parser/client unit tests.
 
 - Versioning is patch-only today (`0.1.x`). Bump the patch number unless the
   team decides to move to a different scheme.
-- Every PR that ships user-visible changes (new commands, fixed examples,
-  behaviour changes) bumps `package.json` version in the same PR — not in a
-  separate "release" PR.
+- If an agent determines that a PR requires a new published version, it must
+  bump the version in `package.json` in that same PR and keep
+  `package-lock.json` in sync. User-visible changes (new commands, fixed
+  examples, behaviour changes) always require this.
 - Before bumping, fetch `origin/main` to make sure the version you pick isn't
   already taken by another PR that merged ahead of yours.

package/dist/index.js

@@ -7392,23 +7392,45 @@ function readJsonValueOption(raw, rawFile, rawLabel, rawFileLabel) {
 function readJsonObjectOption(raw, rawFile, rawLabel, rawFileLabel) {
   return readJsonValueOption(raw, rawFile, rawLabel, rawFileLabel) ?? {};
 }
+var NO_VALUE_COMPARATORS = /* @__PURE__ */ new Set([
+  "chg",
+  "changes",
+  "ie",
+  "is_empty",
+  "ine",
+  "is_not_empty"
+]);
+function isNoValueComparator(comparator) {
+  return NO_VALUE_COMPARATORS.has(comparator.toLowerCase());
+}
+function conditionFormatError(input) {
+  return new CliError(
+    "invalid_cli_usage",
+    `Expected condition in the form field:comparator:value, or field:comparator for comparators without value (chg, ie, ine), received "${input}".`
+  );
+}
 function parseCondition(input) {
   const firstSeparator = input.indexOf(":");
   const secondSeparator = input.indexOf(":", firstSeparator + 1);
-  if (firstSeparator <= 0 || secondSeparator <= firstSeparator + 1) {
-    throw new CliError(
-      "invalid_cli_usage",
-      `Expected condition in the form field:comparator:value, received "${input}".`
-    );
+  if (firstSeparator <= 0) {
+    throw conditionFormatError(input);
+  }
+  if (secondSeparator === -1) {
+    const field2 = input.slice(0, firstSeparator).trim();
+    const comparator2 = input.slice(firstSeparator + 1).trim();
+    if (!field2 || !comparator2 || !isNoValueComparator(comparator2)) {
+      throw conditionFormatError(input);
+    }
+    return { field: field2, comparator: comparator2, values: [] };
+  }
+  if (secondSeparator <= firstSeparator + 1) {
+    throw conditionFormatError(input);
   }
   const field = input.slice(0, firstSeparator).trim();
   const comparator = input.slice(firstSeparator + 1, secondSeparator).trim();
   const value = input.slice(secondSeparator + 1).trim();
   if (!field || !comparator || !value) {
-    throw new CliError(
-      "invalid_cli_usage",
-      `Expected condition in the form field:comparator:value, received "${input}".`
-    );
+    throw conditionFormatError(input);
   }
   return {
     field,
@@ -7555,10 +7577,11 @@ function normalizeAutomationConditions(conditions, label, options) {
     const field = typeof condition.field === "string" ? condition.field.trim() : "";
     const comparator = typeof condition.comparator === "string" ? condition.comparator.trim() : "";
     const values = condition.values;
-    if (!field || !comparator || !Array.isArray(values) || values.length === 0) {
+    const allowsEmptyValues = isNoValueComparator(comparator);
+    if (!field || !comparator || !Array.isArray(values) || values.length === 0 && !allowsEmptyValues) {
       throw new CliError(
         "invalid_cli_usage",
-        `Expected ${label} ${index + 1} to contain "field", "comparator", and a non-empty "values" array.`
+        `Expected ${label} ${index + 1} to contain "field", "comparator", and a non-empty "values" array (comparators without value, e.g. chg/ie/ine, accept an empty array).`
       );
     }
     return {
@@ -8035,7 +8058,7 @@ function addTriggerPayloadOptions(command) {
     []
   ).option(
     "--condition <field:comparator:value>",
-    "trigger condition",
+    "trigger condition (use field:comparator for comparators without value: chg, ie, ine)",
     collectValues,
     []
   ).option(
@@ -8062,7 +8085,12 @@ function addActionPayloadOptions(command) {
   return command.option(
     "--type <type>",
     "action type (create_record|update_record|search_records|send_message|http_request|execute_plugin|generate_document)"
-  ).option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option("--condition <field:comparator:value>", "action condition", collectValues, []).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
+  ).option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option(
+    "--condition <field:comparator:value>",
+    "action condition (use field:comparator for comparators without value: ie, ine)",
+    collectValues,
+    []
+  ).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
     "--timeout-ms <n>",
     "HTTP timeout in milliseconds",
     parseNonNegativeInteger