@lmctl-ai/lmctl 0.2.5 → 0.2.7

package/dist/script/lmscript.d.ts

@@ -6,13 +6,19 @@
  * 2. Scan all and check before execution: In-memory AST validation upfront. Zero intermediate files generated.
  * 3. Language features: Top-level functions, flow control (if/else, while, for, break, continue, return), tuple & destructuring assignment: (a, b) = [1, 2], dot notation (data.key), object literals { key: val }, and negative indexing arr[-1].
  * 4. Predefined functions implemented in TypeScript:
- *    - File I/O: read_file, write_file, append_file, read_lines, read_json, write_json, read_csv, write_csv, file_exists, delete_file.
+ *    - File I/O: read_file, write_file, append_file, read_lines, read_json, write_json, read_csv, write_csv, file_exists, delete_file, mkdir, rmdir, copy_file, move_file, basename, dirname, path_join, abs_path.
  *    - Data structures:
  *      * List/Array: list, len, push, pop, shift, unshift, insert, remove_at, slice, concat, reverse, sort, contains, index_of, join, unique, flatten, first, last, is_empty, sum, avg.
- *      * Hash/Map: map, keys, values, entries, from_entries, has_key, get, set, delete_key, merge, clone, clear, size.
+ *      * Hash/Map: hash, keys, values, entries, from_entries, has_key, get, set, delete_key, merge, clone, clear, size. ("map" is deliberately unimplemented, not an empty-hash constructor -- reserved for a future higher-order array-transform function.)
  *    - JSON processing: data = json(out), json_parse, json_parse_safe, json_stringify, pluck, filter_by, find_by.
+ *    - Regex: regex_test/test, regex_match/match/search, regex_find_all/findall, regex_replace, split_regex -- patterns are plain strings compiled via the host RegExp engine.
+ *    - Environment & time: env, getenv, set_env, now, timestamp, date, strftime, date_format.
+ *    - Null handling: coalesce, if_null, default_to, if_else (expression-level ternary).
  *    - System & Process: system() returning SystemResult, prompt_human() for attended terminal pause/handoff.
  *    - Comprehensive string operations (split, lines, words, join, trim, upper, lower, contains, replace, slice, etc.).
+ *    - First-class function values: a bare reference to an already-declared function name (user or host) is a
+ *      callable FunctionRef, assignable to a variable (`g = dbl; g(4);`) -- a NAMED reference, not a lexical
+ *      closure; calling through a non-identifier expression (e.g. `arr[0](x)`) is not supported.
  * 5. Register new functions: API allowing host TypeScript functions to be registered and checked statically.
  *
  * Security & Authority Model:
@@ -315,7 +321,7 @@ export declare class Parser {
     private consume;
     private consumeOptionalSemicolon;
 }
-export declare const STDLIB_SOURCE = "# LMScript Standard Library (std.lms)\n\n# String Utilities\nfn is_blank(s) {\n  if (s == null) {\n    return true;\n  }\n  return len(trim(s)) == 0;\n}\n\n# Array Utilities\nfn chunk(arr, size) {\n  if (size <= 0) {\n    return [];\n  }\n  res = [];\n  current = [];\n  for (i = 0; i < len(arr); i = i + 1) {\n    push(current, arr[i]);\n    if (len(current) == size) {\n      push(res, current);\n      current = [];\n    }\n  }\n  if (len(current) > 0) {\n    push(res, current);\n  }\n  return res;\n}\n\nfn compact(arr) {\n  res = [];\n  for (i = 0; i < len(arr); i = i + 1) {\n    item = arr[i];\n    if (item != null) {\n      push(res, item);\n    }\n  }\n  return res;\n}\n\nfn zip(arr1, arr2) {\n  res = [];\n  limit = len(arr1);\n  if (len(arr2) < limit) {\n    limit = len(arr2);\n  }\n  for (i = 0; i < limit; i = i + 1) {\n    push(res, [arr1[i], arr2[i]]);\n  }\n  return res;\n}\n\nfn take(arr, n) {\n  res = [];\n  limit = n;\n  if (limit > len(arr)) {\n    limit = len(arr);\n  }\n  for (i = 0; i < limit; i = i + 1) {\n    push(res, arr[i]);\n  }\n  return res;\n}\n\nfn drop(arr, n) {\n  res = [];\n  start = n;\n  if (start < 0) {\n    start = 0;\n  }\n  for (i = start; i < len(arr); i = i + 1) {\n    push(res, arr[i]);\n  }\n  return res;\n}\n\n# Math Utilities\nfn clamp(val, low, high) {\n  if (val < low) {\n    return low;\n  }\n  if (val > high) {\n    return high;\n  }\n  return val;\n}\n";
+export declare const STDLIB_SOURCE = "# LMScript Standard Library (std.lms)\n\n# String Utilities\nfn is_blank(s) {\n  if (s == null) {\n    return true;\n  }\n  return len(trim(s)) == 0;\n}\n\n# Array Utilities\nfn chunk(arr, size) {\n  if (size <= 0) {\n    return [];\n  }\n  res = [];\n  current = [];\n  for (i = 0; i < len(arr); i = i + 1) {\n    push(current, arr[i]);\n    if (len(current) == size) {\n      push(res, current);\n      current = [];\n    }\n  }\n  if (len(current) > 0) {\n    push(res, current);\n  }\n  return res;\n}\n\nfn compact(arr) {\n  res = [];\n  for (i = 0; i < len(arr); i = i + 1) {\n    item = arr[i];\n    if (item != null) {\n      push(res, item);\n    }\n  }\n  return res;\n}\n\nfn zip(arr1, arr2) {\n  res = [];\n  limit = len(arr1);\n  if (len(arr2) < limit) {\n    limit = len(arr2);\n  }\n  for (i = 0; i < limit; i = i + 1) {\n    push(res, [arr1[i], arr2[i]]);\n  }\n  return res;\n}\n\nfn enumerate(arr) {\n  res = [];\n  for (i = 0; i < len(arr); i = i + 1) {\n    push(res, [i, arr[i]]);\n  }\n  return res;\n}\n\nfn take(arr, n) {\n  res = [];\n  limit = n;\n  if (limit > len(arr)) {\n    limit = len(arr);\n  }\n  for (i = 0; i < limit; i = i + 1) {\n    push(res, arr[i]);\n  }\n  return res;\n}\n\nfn drop(arr, n) {\n  res = [];\n  start = n;\n  if (start < 0) {\n    start = 0;\n  }\n  for (i = start; i < len(arr); i = i + 1) {\n    push(res, arr[i]);\n  }\n  return res;\n}\n\n# Math Utilities\nfn clamp(val, low, high) {\n  if (val < low) {\n    return low;\n  }\n  if (val > high) {\n    return high;\n  }\n  return val;\n}\n";
 export declare function getStdlibProgram(): Program;
 export interface CheckOptions {
     /** Inspect literal built-in read paths against the current filesystem. No script evaluation. */
@@ -385,6 +391,23 @@ export declare class BreakSignal {
 }
 export declare class ContinueSignal {
 }
+/**
+ * First-class function value (operator ruling, 2026-09-29, Rule 2 -- "if it
+ * is just how it came out, it is worth fixing": no stated design rationale
+ * anywhere separated function names from the variable namespace; it was an
+ * omission of scope, not a deliberate tradeoff). A bare reference to an
+ * already-declared function name (user `fn` or host) evaluates to one of
+ * these, which can be assigned, stored, and called through a variable --
+ * `g = dbl; g(4);` now works. Deliberately a NAMED reference, not a true
+ * lexical closure over an enclosing scope: nothing in the reported gaps
+ * (map/filter/reduce/etc. over top-level named functions) needs closures,
+ * and adding them is a materially bigger, separate change.
+ */
+export declare class FunctionRef {
+    readonly name: string;
+    constructor(name: string);
+    toString(): string;
+}
 export declare class Environment {
     private static nextId;
     readonly id: number;
@@ -464,6 +487,13 @@ export declare class Interpreter {
     evaluateProgram(program: Program): any;
     private execStmt;
     private evalExpr;
+    /** A call's callee name is normally used directly -- but if it names
+     * neither a declared user function nor a host function, it may be a
+     * variable holding a first-class FunctionRef (`g = dbl; g(4);`), in which
+     * case the actual function to invoke is the ref's name instead. */
+    private resolveCallTarget;
+    private invokeNamed;
+    private resolveIdentifier;
     private isTruthy;
     evaluateProgramAsync(program: Program): Promise<any>;
     private execStmtAsync;
@@ -482,6 +512,20 @@ export interface ExecutionResult {
 export declare const LANGUAGE_DOCS: FunctionDoc[];
 export declare const BUILTIN_FUNCTION_DOCS: FunctionDoc[];
 export declare const STDLIB_FUNCTION_DOCS: FunctionDoc[];
+/**
+ * Real C/Perl/Python printf-style substitution for sprintf()/printf()
+ * (math.lmctl, 2026-09-29, defect B: sprintf/printf were aliased onto
+ * format(), which is Python str.format brace syntax -- `sprintf("%s=%s",
+ * a, b)` silently returned the literal template unsubstituted, because "%s"
+ * is not a brace placeholder. "%s is the ONLY reason anyone reaches for the
+ * name sprintf" -- so these two entry points get their OWN real % syntax,
+ * format() keeps braces. Deliberately minimal: %s/%d/%f/%%, no width/
+ * precision/padding modifiers -- add more only against a concrete need.
+ * Extra args with no corresponding %-directive are silently unused,
+ * matching real printf (not folded into a "no directives -> space-join"
+ * fallback, which would just be a second silently-wrong behavior).
+ */
+export declare function printfFormat(template: any, args: any[]): string;
 export declare class LMScript {
     private readonly hostFunctions;
     private readonly functionDocs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmctl-ai/lmctl",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "A provider-agnostic control plane for teams of AI coding agents — across providers, with independent review and durable memory.",
   "type": "module",
   "homepage": "https://lmctl.com",