@runfile/cli 0.21.0 → 0.23.0

package/bin/darwin-arm64/README.md

@@ -224,6 +224,11 @@ but you can use it anywhere:
   { "if": "{{ ARGS.env != 'development' && ARGS.env != 'production' }}",
     "then": ["./deploy-staging.sh"] },
 
+  // Invert any boolean-returning value with unary `!` — including the
+  // comparison helpers (`less_than`, `is_number`, …) and `contains` etc.:
+  { "if": "{{ !is_number(ARGS.port) }}",
+    "then": ["echo 'port must be a number' && exit 1"] },
+
   // FLAGS.x works as a bare boolean inside DSL — no `== 'true'` needed:
   { "if": "{{ RUN.os == 'windows' && FLAGS.wsl }}",
     "then": "wsl --shell-type login -- vite build" },
@@ -259,10 +264,11 @@ and work as full substitution bodies *or* as chain segments:
   //   trim      : trim, trim_start, trim_end
   //   inspect   : length, starts_with, ends_with, contains
   //   transform : escape, repeat, replace_all, remove_all
-  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture
+  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture, regex_capture_all
   //   build     : concat, join
   //   split     : nth, first, last, count_parts
   //   math      : add, subtract, multiply, divide
+  //   compare   : less_than, less_than_or_equal, greater_than, greater_than_or_equal, is_number
   //   validate  : one_of
   //   encoding  : base64_encode, base64_decode
   //   hashing   : sha256, md5
@@ -284,6 +290,9 @@ and work as full substitution bodies *or* as chain segments:
   // greedy-replace trick needed. Group 0 is the whole match; group N is the
   // N-th `(...)`. Out-of-bounds returns "" (same convention as `nth`).
   "echo version={{ regex_capture(read_file('app/build.gradle.kts'), 'versionName = \"([^\"]+)\"', '1') }}",
+  // Pull group N out of EVERY match and join with a separator (the "all" variant
+  // of regex_capture). Here: every quoted dependency name, comma-separated.
+  "echo deps={{ regex_capture_all(read_file('deps.txt'), 'name = \"([^\"]+)\"', '1', ',') }}",
   // Split-by-separator scalar accessors — string in, string out, no list type:
   // basename idiom (last segment after `/`); empty string when input ends in `/`.
   "echo basename={{ last(ARGS.path, '/') }}",
@@ -314,6 +323,15 @@ and work as full substitution bodies *or* as chain segments:
   "echo next-build={{ add(VARS.versionCode, '1') }}",
   "echo half={{ divide(VARS.total, '2') }}",
 
+  // Numeric comparisons — coerce both args to numbers (same rules as the
+  // arithmetic family, so non-numeric input errors) and return "true"/"false",
+  // so they work as DSL `Truthy` values in `if` conditions:
+  // "if": "{{ greater_than(VARS.count, '50') }}"
+  // "if": "{{ less_than_or_equal(ARGS.retries, '3') }}"
+  // `is_number` tests whether a value parses as a (finite) number — it returns
+  // "false" instead of erroring on non-numeric input:
+  // "if": "{{ is_number(ARGS.port) }}"
+
   // Validate a value against a fixed allow-list. Returns the value on
   // match; lists every valid option in the error on mismatch. Collapses
   // the four-case `match { major: define(part, 'major'), ... }` boilerplate.

package/bin/darwin-x64/README.md

@@ -224,6 +224,11 @@ but you can use it anywhere:
   { "if": "{{ ARGS.env != 'development' && ARGS.env != 'production' }}",
     "then": ["./deploy-staging.sh"] },
 
+  // Invert any boolean-returning value with unary `!` — including the
+  // comparison helpers (`less_than`, `is_number`, …) and `contains` etc.:
+  { "if": "{{ !is_number(ARGS.port) }}",
+    "then": ["echo 'port must be a number' && exit 1"] },
+
   // FLAGS.x works as a bare boolean inside DSL — no `== 'true'` needed:
   { "if": "{{ RUN.os == 'windows' && FLAGS.wsl }}",
     "then": "wsl --shell-type login -- vite build" },
@@ -259,10 +264,11 @@ and work as full substitution bodies *or* as chain segments:
   //   trim      : trim, trim_start, trim_end
   //   inspect   : length, starts_with, ends_with, contains
   //   transform : escape, repeat, replace_all, remove_all
-  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture
+  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture, regex_capture_all
   //   build     : concat, join
   //   split     : nth, first, last, count_parts
   //   math      : add, subtract, multiply, divide
+  //   compare   : less_than, less_than_or_equal, greater_than, greater_than_or_equal, is_number
   //   validate  : one_of
   //   encoding  : base64_encode, base64_decode
   //   hashing   : sha256, md5
@@ -284,6 +290,9 @@ and work as full substitution bodies *or* as chain segments:
   // greedy-replace trick needed. Group 0 is the whole match; group N is the
   // N-th `(...)`. Out-of-bounds returns "" (same convention as `nth`).
   "echo version={{ regex_capture(read_file('app/build.gradle.kts'), 'versionName = \"([^\"]+)\"', '1') }}",
+  // Pull group N out of EVERY match and join with a separator (the "all" variant
+  // of regex_capture). Here: every quoted dependency name, comma-separated.
+  "echo deps={{ regex_capture_all(read_file('deps.txt'), 'name = \"([^\"]+)\"', '1', ',') }}",
   // Split-by-separator scalar accessors — string in, string out, no list type:
   // basename idiom (last segment after `/`); empty string when input ends in `/`.
   "echo basename={{ last(ARGS.path, '/') }}",
@@ -314,6 +323,15 @@ and work as full substitution bodies *or* as chain segments:
   "echo next-build={{ add(VARS.versionCode, '1') }}",
   "echo half={{ divide(VARS.total, '2') }}",
 
+  // Numeric comparisons — coerce both args to numbers (same rules as the
+  // arithmetic family, so non-numeric input errors) and return "true"/"false",
+  // so they work as DSL `Truthy` values in `if` conditions:
+  // "if": "{{ greater_than(VARS.count, '50') }}"
+  // "if": "{{ less_than_or_equal(ARGS.retries, '3') }}"
+  // `is_number` tests whether a value parses as a (finite) number — it returns
+  // "false" instead of erroring on non-numeric input:
+  // "if": "{{ is_number(ARGS.port) }}"
+
   // Validate a value against a fixed allow-list. Returns the value on
   // match; lists every valid option in the error on mismatch. Collapses
   // the four-case `match { major: define(part, 'major'), ... }` boilerplate.

package/bin/linux-arm64/README.md

@@ -224,6 +224,11 @@ but you can use it anywhere:
   { "if": "{{ ARGS.env != 'development' && ARGS.env != 'production' }}",
     "then": ["./deploy-staging.sh"] },
 
+  // Invert any boolean-returning value with unary `!` — including the
+  // comparison helpers (`less_than`, `is_number`, …) and `contains` etc.:
+  { "if": "{{ !is_number(ARGS.port) }}",
+    "then": ["echo 'port must be a number' && exit 1"] },
+
   // FLAGS.x works as a bare boolean inside DSL — no `== 'true'` needed:
   { "if": "{{ RUN.os == 'windows' && FLAGS.wsl }}",
     "then": "wsl --shell-type login -- vite build" },
@@ -259,10 +264,11 @@ and work as full substitution bodies *or* as chain segments:
   //   trim      : trim, trim_start, trim_end
   //   inspect   : length, starts_with, ends_with, contains
   //   transform : escape, repeat, replace_all, remove_all
-  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture
+  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture, regex_capture_all
   //   build     : concat, join
   //   split     : nth, first, last, count_parts
   //   math      : add, subtract, multiply, divide
+  //   compare   : less_than, less_than_or_equal, greater_than, greater_than_or_equal, is_number
   //   validate  : one_of
   //   encoding  : base64_encode, base64_decode
   //   hashing   : sha256, md5
@@ -284,6 +290,9 @@ and work as full substitution bodies *or* as chain segments:
   // greedy-replace trick needed. Group 0 is the whole match; group N is the
   // N-th `(...)`. Out-of-bounds returns "" (same convention as `nth`).
   "echo version={{ regex_capture(read_file('app/build.gradle.kts'), 'versionName = \"([^\"]+)\"', '1') }}",
+  // Pull group N out of EVERY match and join with a separator (the "all" variant
+  // of regex_capture). Here: every quoted dependency name, comma-separated.
+  "echo deps={{ regex_capture_all(read_file('deps.txt'), 'name = \"([^\"]+)\"', '1', ',') }}",
   // Split-by-separator scalar accessors — string in, string out, no list type:
   // basename idiom (last segment after `/`); empty string when input ends in `/`.
   "echo basename={{ last(ARGS.path, '/') }}",
@@ -314,6 +323,15 @@ and work as full substitution bodies *or* as chain segments:
   "echo next-build={{ add(VARS.versionCode, '1') }}",
   "echo half={{ divide(VARS.total, '2') }}",
 
+  // Numeric comparisons — coerce both args to numbers (same rules as the
+  // arithmetic family, so non-numeric input errors) and return "true"/"false",
+  // so they work as DSL `Truthy` values in `if` conditions:
+  // "if": "{{ greater_than(VARS.count, '50') }}"
+  // "if": "{{ less_than_or_equal(ARGS.retries, '3') }}"
+  // `is_number` tests whether a value parses as a (finite) number — it returns
+  // "false" instead of erroring on non-numeric input:
+  // "if": "{{ is_number(ARGS.port) }}"
+
   // Validate a value against a fixed allow-list. Returns the value on
   // match; lists every valid option in the error on mismatch. Collapses
   // the four-case `match { major: define(part, 'major'), ... }` boilerplate.

package/bin/linux-x64/README.md

@@ -224,6 +224,11 @@ but you can use it anywhere:
   { "if": "{{ ARGS.env != 'development' && ARGS.env != 'production' }}",
     "then": ["./deploy-staging.sh"] },
 
+  // Invert any boolean-returning value with unary `!` — including the
+  // comparison helpers (`less_than`, `is_number`, …) and `contains` etc.:
+  { "if": "{{ !is_number(ARGS.port) }}",
+    "then": ["echo 'port must be a number' && exit 1"] },
+
   // FLAGS.x works as a bare boolean inside DSL — no `== 'true'` needed:
   { "if": "{{ RUN.os == 'windows' && FLAGS.wsl }}",
     "then": "wsl --shell-type login -- vite build" },
@@ -259,10 +264,11 @@ and work as full substitution bodies *or* as chain segments:
   //   trim      : trim, trim_start, trim_end
   //   inspect   : length, starts_with, ends_with, contains
   //   transform : escape, repeat, replace_all, remove_all
-  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture
+  //   regex     : regex_replace, regex_remove, regex_matches, regex_capture, regex_capture_all
   //   build     : concat, join
   //   split     : nth, first, last, count_parts
   //   math      : add, subtract, multiply, divide
+  //   compare   : less_than, less_than_or_equal, greater_than, greater_than_or_equal, is_number
   //   validate  : one_of
   //   encoding  : base64_encode, base64_decode
   //   hashing   : sha256, md5
@@ -284,6 +290,9 @@ and work as full substitution bodies *or* as chain segments:
   // greedy-replace trick needed. Group 0 is the whole match; group N is the
   // N-th `(...)`. Out-of-bounds returns "" (same convention as `nth`).
   "echo version={{ regex_capture(read_file('app/build.gradle.kts'), 'versionName = \"([^\"]+)\"', '1') }}",
+  // Pull group N out of EVERY match and join with a separator (the "all" variant
+  // of regex_capture). Here: every quoted dependency name, comma-separated.
+  "echo deps={{ regex_capture_all(read_file('deps.txt'), 'name = \"([^\"]+)\"', '1', ',') }}",
   // Split-by-separator scalar accessors — string in, string out, no list type:
   // basename idiom (last segment after `/`); empty string when input ends in `/`.
   "echo basename={{ last(ARGS.path, '/') }}",
@@ -314,6 +323,15 @@ and work as full substitution bodies *or* as chain segments:
   "echo next-build={{ add(VARS.versionCode, '1') }}",
   "echo half={{ divide(VARS.total, '2') }}",
 
+  // Numeric comparisons — coerce both args to numbers (same rules as the
+  // arithmetic family, so non-numeric input errors) and return "true"/"false",
+  // so they work as DSL `Truthy` values in `if` conditions:
+  // "if": "{{ greater_than(VARS.count, '50') }}"
+  // "if": "{{ less_than_or_equal(ARGS.retries, '3') }}"
+  // `is_number` tests whether a value parses as a (finite) number — it returns
+  // "false" instead of erroring on non-numeric input:
+  // "if": "{{ is_number(ARGS.port) }}"
+
   // Validate a value against a fixed allow-list. Returns the value on
   // match; lists every valid option in the error on mismatch. Collapses
   // the four-case `match { major: define(part, 'major'), ... }` boilerplate.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runfile/cli",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Runfile CLI — an easy-to-use, batteries-included task runner",
   "repository": "https://github.com/Skiley/runfile",
   "homepage": "https://github.com/Skiley/runfile",