theprogrammablemind_4wp 9.7.1-beta.18 → 9.7.1-beta.20

package/client.js

@@ -267,7 +267,7 @@ const throwErrorHandler = (error) => {
   throw error
 }
 
-const _process = async (config, query, { initializer, commandLineArgs, credentials, writeTests, logs, isProcess, isModule, isTest, saveDeveloper, rebuildingTemplate, testConfig, testsFN, errorHandler = throwErrorHandler } = {}) => {
+const _process = async (config, query, { queryNumber, initializer, commandLineArgs, credentials, writeTests, logs, isProcess, isModule, isTest, saveDeveloper, rebuildingTemplate, testConfig, testsFN, errorHandler = throwErrorHandler } = {}) => {
   if (credentials) {
     config.server(credentials.server, credentials.key)
   }
@@ -418,6 +418,7 @@ const _process = async (config, query, { initializer, commandLineArgs, credentia
     return response
   } catch (error) {
     error.summaries = summaries
+    error.queryNumber = queryNumber
     error.query = query
     errorHandler(error)
   }
@@ -510,7 +511,7 @@ const runTest = async (config, expected, { args, verbose, testConfig, debug, tim
       setupArgs(args, config)
       await testConfig.initializer(args)
     }
-    const result = await _process(config, test, { errorHandler, isTest: true, isProcess: true, isModule: false })
+    const result = await _process(config, test, { queryNumber: args.queryNumber, errorHandler, isTest: true, isProcess: true, isModule: false })
     result.query = test
     if (debug) {
       defaultInnerProcess(config, errorHandler, result)
@@ -630,6 +631,7 @@ const runTestsHelper = async (config, tests, failed, juicyBits) => {
     }
     const test = tests.shift()
     juicyBits.index = index
+    juicyBits.args.queryNumber = index
     const result = await runTest(config, test, juicyBits)
     if (result != null) {
       result.index = index
@@ -800,7 +802,7 @@ const defaultErrorHandler = async (error) => {
   }
 
   if (error.query) {
-    console.log('query: ', error.query)
+    console.log(`query: #${error.queryNumber} ${error.query}`)
     doErrorExit = true
   }
 
@@ -1654,12 +1656,7 @@ const knowledgeModuleImpl = async ({
           }
 
           if (hasArg('s')) {
-            const easyToRead = _.cloneDeep(config.config.semantics)
-            for (const semantic of easyToRead) {
-              semantic.match = semantic.match.toString()
-              semantic.apply = semantic.apply.toString()
-            }
-            console.dir(easyToRead)
+            config.printSemantics()
           }
         }
       }

package/index.js

@@ -1,7 +1,7 @@
 const { Semantics, Semantic } = require('./src/semantics')
 const { Generators, Generator } = require('./src/generators')
 const { Config } = require('./src/config')
-const { w, where, OverrideCheck } = require('./src/helpers')
+const { w, where, OverrideCheck, setByPath, getByPath } = require('./src/helpers')
 const Digraph = require('./src/digraph')
 const client = require('./client')
 const flattens = require('./src/flatten')
@@ -16,6 +16,8 @@ module.exports = {
   runTests: client.runTests,
   knowledgeModule: client.knowledgeModule,
   ensureTestFile: client.ensureTestFile,
+  setByPath,
+  getByPath,
   where,
   stableId: client.stableId,
   w,

package/package.json

@@ -73,6 +73,6 @@
     "scriptjs": "^2.5.9",
     "uuid": "^8.3.2"
   },
-  "version": "9.7.1-beta.18",
+  "version": "9.7.1-beta.20",
   "license": "UNLICENSED"
 }

package/src/config.js

@@ -981,6 +981,15 @@ class Config {
     return config_toServer(config)
   }
 
+  printSemantics() {
+    const easyToRead = _.cloneDeep(this.config.semantics)
+    for (const semantic of easyToRead) {
+      semantic.match = semantic.match.toString()
+      semantic.apply = semantic.apply.toString()
+    }
+    console.dir(easyToRead)
+  }
+
   async run(handler) {
     return configHelpers.run(this, handler)
   }
@@ -1683,6 +1692,7 @@ class Config {
         return
       }
     }
+
     if (global.transitoryMode) {
       def.transitoryMode = true
     }
@@ -3384,6 +3394,10 @@ class Config {
     let duplicated = new Set()
     const seen = new Set()
     for (const bridge of this.config.bridges) {
+      if (typeof bridge.id !== 'string') {
+        throw new Error('Config.addBridge: expected the bridge id to be a non-empty string.')
+      }
+
       const id = `${bridge.id}/${bridge.level} (namespace: ${bridge.uuid || this.uuid})`
       if (seen.has(id)) {
         duplicated.add(id)

package/src/configHelpers.js

@@ -165,10 +165,14 @@ const setupArgs = (args, config, logs, hierarchy, uuidForScoping) => {
   }
   args.contextHierarchy = new ContextHierarchy()
   args.namespaced = {
-    get: (km, context, property) => {
+    get: (km, context, property, _default) => {
       context.namespaced ??= {}
       context.namespaced[km] ??= {}
-      return context.namespaced[km][property] 
+      const value = context.namespaced[km][property]
+      if (value == undefined) {
+        return _default
+      }
+      return value
     },
     set: (km, context, property, value) => {
       context.namespaced ??= {}

package/src/digraph.js

@@ -73,11 +73,25 @@ class Digraph {
     this._edges = edges
   }
 
-  /*
-  set edges(edges) {
-    this._edges = edges.map( toA )
+  tos(from) {
+    const tos = []
+    for (const edge of this._edges) {
+      if (edge[0] == from) {
+        tos.push(edge[1])
+      }
+    }
+    return tos
+  }
+
+  froms(to) {
+    const froms = []
+    for (const edge of this._edges) {
+      if (edge[1] == to) {
+        froms.push(edge[0])
+      }
+    }
+    return froms
   }
-*/
 
   acdcs (s, from, to) {
     if (!s) {
@@ -170,18 +184,6 @@ class Digraph {
     return this.minima(common)
   }
 
-  /*
-  maxima (nodes) {
-    const maxima = new Set(nodes)
-    const descendants = new Set([])
-    nodes.forEach((node) => {
-      this.descendants(node).forEach((n) => descendants.add(n))
-    })
-    descendants.forEach((n) => maxima.delete(n))
-    return maxima
-  }
-  */
-
   add (child, parent) {
     this._edges.push([child, parent])
   }

package/src/digraph_internal.js

@@ -39,6 +39,26 @@ class DigraphInternal {
     this._edges = edges
   }
 
+  tos(from) {
+    const tos = []
+    for (const edge of this._edges) {
+      if (edge[0] == from) {
+        tos.push(edge[1])
+      }
+    }
+    return tos
+  }
+
+  froms(to) {
+    const froms = []
+    for (const edge of this._edges) {
+      if (edge[1] == to) {
+        froms.push(edge[0])
+      }
+    }
+    return froms
+  }
+
   get length () {
     return this._edges.length
   }
@@ -137,18 +157,6 @@ class DigraphInternal {
     return this.minima(common)
   }
 
-  /*
-  maxima (nodes) {
-    const maxima = new Set(nodes)
-    const descendants = new Set([])
-    nodes.forEach((node) => {
-      this.descendants(node).forEach((n) => descendants.add(n))
-    })
-    descendants.forEach((n) => maxima.delete(n))
-    return maxima
-  }
-  */
-
   add (child, parent) {
     this._edges.push([child, parent])
   }

package/src/generators.js

@@ -125,11 +125,10 @@ class Generator {
       args.g = args.gp
     }
     return await debug.hitScoped(args.callId, async () => {
-      if ((options.debug || {}).apply ||
-          callId === this.callId) {
+      if ((options.debug || {}).apply || process.env.DEBUG_CALLID == args.callId || callId === this.callId) {
         debugger // eslint-disable-line no-debugger
       }
-      return await this._apply(args)
+      return await this._apply(args)  // DEBUG: This is the line you want to step into
     })
   }
 }
@@ -195,7 +194,7 @@ class Generators {
           console.error("TPMKMS_TRACE", debug.counter("TPMKMS_TRACE"))
           console.error(generator.toLabel())
           console.error(generator.toString())
-          console.log(`To debug this use debug.breakAt('${args.calls.current()}. Check the 'callId' arg to see this value.')`)
+          console.log(`To debug this use debug.breakAt('${args.calls.current()}') or DEBUG_CALLID="${args.calls.current()}"`)
         }
 
         try {
@@ -232,7 +231,7 @@ class Generators {
           lines.setElement(0, 2, stack)
           lines.newRow()
           lines.setElement(0, 1, 'DEBUG')
-          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}. Check the 'callId' arg to see this value.')`)
+          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}') or DEBUG_CALLID="${args.calls.current()}"`)
           lines.newRow()
           lines.setElement(0, 1, 'ERROR')
           lines.setElement(0, 2, errorMessage)
@@ -264,7 +263,7 @@ class Generators {
           lines.setElement(0, 2, stack)
           lines.newRow()
           lines.setElement(0, 1, 'DEBUG')
-          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}. Check the 'callId' arg to see this value.')`)
+          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}')`)
           lines.newRow()
           lines.setElement(0, 1, 'TO')
           lines.setElement(0, 2, `context_id: ${context.context_id}`)

package/src/helpers.js

@@ -544,52 +544,77 @@ const stableId = (tag) => {
 }
 
 function getByPath(obj, path, defaultValue) {
+  const segments = Array.isArray(path) ? path : [path];
+  const keys = segments.flatMap((segment) => {
+    if (typeof segment !== "string") return [segment];
+    return segment
+      .replace(/\[(\d+)\]/g, ".$1")
+      .split(".")
+      .filter((key) => key !== "");
+  });
+
   let current = obj;
-  for (const key of path) {
+  for (const key of keys) {
     if (current === null || current === undefined) return defaultValue;
-    if (typeof current !== 'object') return defaultValue;
+    if (typeof current !== "object") return defaultValue;
     current = current[key];
   }
   return current === undefined ? defaultValue : current;
 }
 
+function normalizePath(path) {
+  const segments = Array.isArray(path) ? path : [path];
+  return segments.flatMap((segment) => {
+    if (typeof segment !== "string") return [segment];
+    return segment
+      .replace(/\[(\d+)\]/g, ".$1")
+      .split(".")
+      .filter((key) => key !== "");
+  });
+}
+
+function isArrayIndex(key) {
+  if (typeof key === "number") return Number.isInteger(key) && key >= 0;
+  return key !== "" && String(key >>> 0) === String(key);
+}
+
 /**
- * Set a value in an object by path array.
+ * Set a value in an object by path (string or array).
  * Automatically creates missing objects {} or arrays [] as needed.
  *
  * @param {Object} obj - The root object to modify
- * @param {Array<string|number>} path - Array of keys/indices
+ * @param {string|Array<string|number>} path - Path keys/indices
  * @param {*} value - Value to set
  * @returns {*} The set value (for chaining)
  */
 function setByPath(obj, path, value) {
-  if (!Array.isArray(path) || path.length === 0) {
-    throw new Error('Path must be a non-empty array');
+  const keys = normalizePath(path);
+
+  if (keys.length === 0) {
+    throw new Error("Path must be a non-empty string or array");
+  }
+
+  if (obj == null || typeof obj !== "object") {
+    throw new Error("Target must be an object or array");
   }
 
   let current = obj;
 
-  for (let i = 0; i < path.length; i++) {
-    const key = path[i];
-    const isLast = i === path.length - 1;
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    const isLast = i === keys.length - 1;
 
     if (isLast) {
-      // Final step — just assign
       current[key] = value;
     } else {
-      // Not last — ensure next level exists
-      const nextKey = path[i + 1];
-
-      if (current[key] == null) {
-        // Auto-create: array if next key is number, otherwise object
-        current[key] = typeof nextKey === 'number' || String(nextKey >>> 0) === nextKey
-          ? []
-          : {};
-      } else if (Array.isArray(current[key]) && typeof nextKey !== 'number') {
-        // Safety: if current is array but next key isn't a valid index → convert to object
+      const nextKey = keys[i + 1];
+      const nextIsIndex = isArrayIndex(nextKey);
+
+      if (current[key] == null || typeof current[key] !== "object") {
+        current[key] = nextIsIndex ? [] : {};
+      } else if (Array.isArray(current[key]) && !nextIsIndex) {
         current[key] = { ...current[key] };
-      } else if (!Array.isArray(current[key]) && typeof nextKey === 'number') {
-        // If next expects array but current is object → convert
+      } else if (!Array.isArray(current[key]) && nextIsIndex) {
         current[key] = Object.values(current[key]);
       }
 

package/src/semantics.js

@@ -77,10 +77,11 @@ class Semantic {
     this.fixUpArgs(args, context)
     return await debug.hitScoped(args.callId, async () => {
       const matches = await this.matcher(args)
-      if (matches && (options.debug || {}).match || args.callId === this.callId) {
-        // next line is the matcher
-        debugger // eslint-disable-line no-debugger
-        await this.matcher(args)
+      if (matches) {
+        if ((options.debug || {}).match || args.callId === this.callId || process.env.DEBUG_CALLID == args.callId) {
+          debugger // eslint-disable-line no-debugger
+          await this.matcher(args) // DEBUG: This is the line you step into
+        }
       }
       return matches
     })
@@ -100,8 +101,8 @@ class Semantic {
     this.fixUpArgs(args, contextPrime)
 
     return await debug.hitScoped(args.callId, async () => {
-      if ((options.debug || {}).apply || args.callId === this.callId) {
-        debugger // eslint-disable-line no-debugger
+      if ((options.debug || {}).apply || args.callId === this.callId || process.env.DEBUG_CALLID == args.callId) {
+        debugger // eslint-disable-line no-debugger  // STEP ABOUT THREE TIMES TO THE DEBUG LINE
       }
       if (args.breakOnSemantics) {
         debugger // eslint-disable-line no-debugger
@@ -109,7 +110,7 @@ class Semantic {
 
       try {
         args.stack.push(this)
-        await this._apply(args)
+        await this._apply(args) // DEBUG: This is the line you want to step into
         args.stack.pop()
       } catch( e ) {
         args.stack.pop()
@@ -260,7 +261,7 @@ class Semantics {
           lines.setElement(0, 2, semantic.toString())
           lines.newRow()
           lines.setElement(0, 1, 'DEBUG')
-          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}. Check the 'callId' arg to see this value.')`)
+          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}') in the code or DEBUG_CALLID="${args.calls.current()}"`)
           lines.newRow()
           lines.setElement(0, 1, 'TO')
           lines.setElement(0, 2, `context_id: ${context.context_id}`)
@@ -295,7 +296,7 @@ class Semantics {
           lines.setElement(0, 2, semantic.toString())
           lines.newRow()
           lines.setElement(0, 1, 'DEBUG')
-          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}. Check the 'callId' arg to see this value.')`)
+          lines.setElement(0, 2, `To debug this use debug.breakAt('${args.calls.current()}') in the code or DEBUG_CALLID="${args.calls.current()}"`)
           lines.newRow()
           lines.setElement(0, 1, 'TO')
           lines.setElement(0, 2, `context_id: ${context.context_id}`)