imperal-sdk 6.3.6__tar.gz → 6.3.8__tar.gz

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to `imperal-sdk` are documented here.
 
+## 6.3.8 — 2026-11-04
+
+### Fixed
+- `code_index`: one string-aware reader of resolution configs (`strip_jsonc`, `parse_jsonc`, `parse_config`).
+  Comments and trailing commas are removed outside strings only -- a regex stripper read `"@/*"` in a Next.js
+  `tsconfig.json` as a comment opener, lost `paths`, and every `@/` import fell out of the graph. The Tenant Vault
+  carries a literal copy (a test compares the source).
+- `sftp_list_tree` / `sftp_read_many` keep up to `SFTP_PARALLEL` (32) requests in flight on one connection: listing
+  walks level by level, reads go in slices. Live (Mac -> a US server, 1 572 files): listing 47 s -> 6.7 s, 200
+  files read 206 s -> 10.1 s. Results are the same (paths sorted; .gitignore rules still reach a directory's
+  children before they are filtered).
+
+## 6.3.7 — 2026-10-21
+
+### Changed
+- Plain names: `DwellGuard` / `DwellGuardStep` (module `imperal_sdk.dwell_guard`) -- the dwell guard says what it
+  checks (nesting depth, steps on one entity without coverage gain, a growing gap) and its alarms say what to do.
+  `GNCLyapunovGuard` / `GNCEnergyState` (`imperal_sdk.gnc_guard`) stay as old names of the same classes.
+- `DEFAULT_APP_ICON` (old name `DEFAULT_QUANTUM_ICON` kept); docstrings no longer say "ICNLI Quantum SDK".
+
 ## 6.3.6 — 2026-10-21
 
 ### Fixed

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: imperal-sdk
-Version: 6.3.6
+Version: 6.3.8
 Summary: SDK for building Imperal Cloud extensions
 Author: Imperal, Inc.
 Author-email: Valentin Scerbacov <valentin@imperal.io>

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/sdk-reference.json

@@ -1,5 +1,5 @@
 {
-  "sdk_version": "6.3.6",
+  "sdk_version": "6.3.8",
   "symbols": {
     "ActionResult": {
       "action_vocab_safe": false,

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/sdk_claims.json

@@ -1,5 +1,5 @@
 {
-  "_sdk_version": "6.3.6",
+  "_sdk_version": "6.3.8",
   "constants": {
     "max_call_depth": {
       "counts_root": true,

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/src/imperal_sdk/__init__.py

@@ -1,7 +1,7 @@
 """Imperal Cloud SDK — build extensions for the Imperal platform."""
 from typing import TYPE_CHECKING
 
-__version__ = "6.3.6"
+__version__ = "6.3.8"
 
 # 5.2.2 (2026-06-11): the package root resolves its public surface lazily
 # (PEP 562). The eager imports pulled the HTTP transport (Context / client
@@ -48,12 +48,14 @@ _LAZY_ATTRS = {
     # hand-roll a token_refresh.py; four divergent copies are how an expired
     # Google Analytics token turned into "please reconnect" (2026-08-21).
     "fresh_token": "imperal_sdk.oauth_tokens",
-    # GNC Marathon Resilience & Tenant Vault Working RAM (ICNLI V17)
+    # Marathon dwell guard & Tenant Vault Working RAM
     "TenantVaultRAM": "imperal_sdk.vault_ram_client",
     "TargetEntity": "imperal_sdk.vault_ram_client",
     "WorkingRAMSnapshot": "imperal_sdk.vault_ram_client",
-    "GNCLyapunovGuard": "imperal_sdk.gnc_guard",
-    "GNCEnergyState": "imperal_sdk.gnc_guard",
+    "DwellGuard": "imperal_sdk.dwell_guard",
+    "DwellGuardStep": "imperal_sdk.dwell_guard",
+    "GNCLyapunovGuard": "imperal_sdk.gnc_guard",   # old name of DwellGuard
+    "GNCEnergyState": "imperal_sdk.gnc_guard",     # old name of DwellGuardStep
     "BOMExtractor": "imperal_sdk.bom_extractor",
     "BOMEntity": "imperal_sdk.bom_extractor",
     "BOMReport": "imperal_sdk.bom_extractor",

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/src/imperal_sdk/app.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 # Copyright (c) 2026 Imperal, Inc.
 # Licensed under the Apache-2.0 License.
-"""ICNLI Quantum SDK v6.0 — The Universal Zero-Boilerplate Application Engine.
+"""Imperal SDK App: an extension with no boilerplate.
 
 Empowers developers to build next-generation AI Cloud OS applications with:
 1. Zero-Manifest: 100% automatic type-to-schema extraction from Python signatures.
@@ -25,7 +25,7 @@ from imperal_sdk.context import Context
 from imperal_sdk.types.identity import UserContext, TenantContext
 from imperal_sdk.auto_ui import project_to_declarative_ir
 
-DEFAULT_QUANTUM_ICON = (
+DEFAULT_APP_ICON = (
     '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" '
     'stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-atom">'
     '<circle cx="12" cy="12" r="1"/>'
@@ -33,6 +33,7 @@ DEFAULT_QUANTUM_ICON = (
     '<path d="M15.7 15.7c4.52-4.54 6.54-9.87 4.5-11.9-2.03-2.04-7.36-.02-11.9 4.5-4.52 4.54-6.54 9.87-4.5 11.9 2.03 2.04 7.36.02 11.9-4.5Z"/>'
     '</svg>'
 )
+DEFAULT_QUANTUM_ICON = DEFAULT_APP_ICON  # old name
 
 
 def _python_type_to_json_schema(py_type):
@@ -75,7 +76,7 @@ def create_ambient_context(user_id="ambient_user"):
 
 
 class App(Extension):
-    """High-level ICNLI Quantum Application.
+    """High-level Imperal SDK application.
     
     Zero-manifest, auto-schema, ambient-context, auto-IR enabled container.
     Inherits from `Extension` for 100% backward compatibility with all
@@ -99,7 +100,7 @@ class App(Extension):
         if len(desc) < 40:
             desc = "{} Fully compliant with the ICNLI Agentic OS specification.".format(desc)
 
-        effective_icon = icon or DEFAULT_QUANTUM_ICON
+        effective_icon = icon or DEFAULT_APP_ICON
 
         super(App, self).__init__(
             app_id=app_id,

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/src/imperal_sdk/auto_ui.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 # Copyright (c) 2026 Imperal, Inc., Valentin Scerbacov, and contributors
 # Licensed under the Apache-2.0 License. See LICENSE file for details.
-"""Auto-IR & UI-as-Data Projector for ICNLI Quantum SDK.
+"""Auto UI for the Imperal SDK: return values become UI components.
 
 Transforms standard Python return types (dicts, dataclasses, lists, primitives)
 into reactive Declarative IR components without writing custom frontend templates.

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/src/imperal_sdk/bom_extractor.py

@@ -1,5 +1,5 @@
 """
-Pre-Flight BOM Extractor (RFC: ICNLI V17 / GNC Marathon Resilience Engine)
+Pre-Flight BOM Extractor 
 
 Scans target codebases (NodeJS: Express/Fastify/Koa/Next.js/HTML, Python: Flask/FastAPI/Django)
 to extract a ground-truth Bill-of-Materials (BOM) before coding starts:

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/src/imperal_sdk/code_index.py

@@ -746,6 +746,100 @@ def indexable(rel_path: str) -> str | None:
     return "code" if os.path.splitext(low)[1] in INDEXABLE_EXT else None
 
 
+# ---- resolution configs: the ONE reader (the vault's stores/repos.py carries a literal copy) ----
+
+def strip_jsonc(text: str) -> str:
+    """JSON with comments (tsconfig, jsconfig) as plain JSON: ``//`` and ``/* */`` comments and trailing
+    commas removed OUTSIDE strings only. ``"@/*"`` or ``"**/*.ts"`` is text, never a comment (live 2026-11-03:
+    a regex stripper read imperal.io's tsconfig from ``"@/*"`` to ``"**/*.ts"`` as one comment, the JSON
+    broke, ``paths`` was lost and every ``@/`` import fell out of the vault graph)."""
+    n = len(text)
+
+    def skip(i: int) -> int:
+        """The index past whitespace and comments from ``i`` (outside strings)."""
+        while i < n:
+            if text[i] in " \t\r\n":
+                i += 1
+            elif text.startswith("//", i):
+                j = text.find("\n", i)
+                i = n if j < 0 else j
+            elif text.startswith("/*", i):
+                j = text.find("*/", i + 2)
+                i = n if j < 0 else j + 2
+            else:
+                break
+        return i
+
+    out: list = []
+    i = 0
+    while i < n:
+        c = text[i]
+        if c == '"':
+            j = i + 1
+            while j < n and text[j] != '"':
+                j += 2 if text[j] == "\\" else 1
+            out.append(text[i:j + 1])
+            i = j + 1
+        elif text.startswith("//", i) or text.startswith("/*", i):
+            i = skip(i)
+            out.append(" ")
+        elif c == "," and skip(i + 1) < n and text[skip(i + 1)] in "}]":
+            i += 1
+        else:
+            out.append(c)
+            i += 1
+    return "".join(out)
+
+
+def parse_jsonc(text: str) -> dict:
+    """A JSON-with-comments object, or ``{}`` when it is not one."""
+    import json
+    try:
+        data = json.loads(strip_jsonc(text))
+    except ValueError:
+        return {}
+    return data if isinstance(data, dict) else {}
+
+
+def parse_config(path: str, text: str) -> tuple:
+    """``(kind, data)`` of a resolution config: tsconfig / jsconfig (JSON with comments), pyproject.toml,
+    setup.cfg, package.json. What the linker needs, nothing else."""
+    import posixpath
+    name = posixpath.basename(_slashes(path)).lower()
+    if name == "pyproject.toml":
+        try:
+            import tomllib
+            data = tomllib.loads(text)
+        except Exception:
+            data = {}
+        st = (data.get("tool") or {}).get("setuptools") or {}
+        find = (st.get("packages") or {}).get("find") if isinstance(st.get("packages"), dict) else None
+        return "pyproject", {"where": list((find or {}).get("where") or []),
+                             "package_dir": dict(st.get("package-dir") or {}),
+                             "name": str((data.get("project") or {}).get("name") or "")}
+    if name == "setup.cfg":
+        import configparser
+        cp = configparser.ConfigParser()
+        try:
+            cp.read_string(text)
+            raw = cp.get("options", "package_dir", fallback="")
+        except Exception:
+            raw = ""
+        pdir = {}
+        for line in raw.replace(";", "\n").splitlines():
+            k, sep, v = line.partition("=")
+            if sep:
+                pdir[k.strip()] = v.strip()
+        return "setup_cfg", {"package_dir": pdir}
+    data = parse_jsonc(text)
+    if name == "package.json":
+        return "package_json", {"name": str(data.get("name") or ""), "main": str(data.get("main") or "")}
+    co = data.get("compilerOptions") or {}
+    return ("jsconfig" if name == "jsconfig.json" else "tsconfig"), {
+        "baseUrl": str(co.get("baseUrl") or ""),
+        "paths": {str(k): [str(x) for x in v or []] for k, v in (co.get("paths") or {}).items() if isinstance(v, list)}}
+
+
 # ---- the scope graph of one file (spec 4.6.1): defs, bindings with aliases, reference chains ----
 
 _CHAIN_PARTS = 6
@@ -1872,55 +1966,94 @@ async def sftp_repo_root(sftp, path: str) -> str:
     return manifest or start
 
 
+# SFTP requests in flight on one connection. Live 2026-11-03 (Mac -> whm-jump, /home/ipw-repo): one request at a
+# time listed 1 572 files in 47 s and read 200 files in 206 s (~4 round trips a file) -- a first sync of the kernel
+# repo would have taken half an hour. asyncssh pipelines requests on one channel; 32 keeps a slow link full without
+# flooding a small server's sftp-server.
+SFTP_PARALLEL = 32
+
+
+async def _gather_bounded(coros, limit: int = SFTP_PARALLEL) -> list:
+    import asyncio
+    gate = asyncio.Semaphore(limit)
+
+    async def one(c):
+        async with gate:
+            return await c
+    return await asyncio.gather(*(one(c) for c in coros))
+
+
 async def sftp_list_tree(sftp, root: str, max_files: int = MAX_REPO_FILES) -> dict:
     """Every indexable file under ``root`` with its size and mtime: .gitignore files honoured, dotted /
     dependency / build trees and virtualenvs skipped, symlinks never followed (no loop, nothing outside
-    the root). ``{"items": [{path, size, mtime, kind}], "partial": str, "os"}``."""
+    the root). ``{"items": [{path, size, mtime, kind}], "partial": str, "os"}``. Walked level by level:
+    every directory of a level (and its .gitignore) is read at once; a directory's rules are known
+    before its children are filtered, as in a one-by-one walk."""
     import posixpath
     items: list = []
     partial = ""
     rules: list = []
-    stack = [""]
-    while stack:
-        rel_dir = stack.pop()
+    level = [""]
+
+    async def listed(rel_dir: str):
         here = posixpath.join(root, rel_dir) if rel_dir else root
         try:
-            entries = await sftp.readdir(here)
+            return rel_dir, here, await sftp.readdir(here)
         except Exception:
-            partial = partial or f"unreadable directory: {rel_dir or '.'}"
-            continue
-        names = {e.filename for e in entries}
-        if rel_dir and "pyvenv.cfg" in names:
-            continue                                  # a virtualenv, whatever it is named
-        if ".gitignore" in names:
-            try:
-                data = await _sftp_bytes(sftp, posixpath.join(here, ".gitignore"), 262144)
-                rules += gitignore_rules((data or b"").decode("utf-8", "replace"), rel_dir)
-            except Exception:
-                pass
-        for e in sorted(entries, key=lambda x: x.filename):
-            name = e.filename
-            if name in (".", ".."):
-                continue
-            rel = f"{rel_dir}/{name}" if rel_dir else name
-            kind = getattr(e.attrs, "type", None)
-            if kind == _SFTP_LINK:
+            return rel_dir, here, None
+
+    async def ignore_file(here: str):
+        try:
+            return await _sftp_bytes(sftp, posixpath.join(here, ".gitignore"), 262144)
+        except Exception:
+            return None
+
+    while level and not (partial and partial.startswith("over ")):
+        dirs = sorted(await _gather_bounded([listed(d) for d in level]), key=lambda x: x[0])
+        readable = []
+        for rel_dir, here, entries in dirs:
+            if entries is None:
+                partial = partial or f"unreadable directory: {rel_dir or '.'}"
                 continue
-            if kind == _SFTP_DIR:
-                if name.startswith(".") or name in SKIP_DIRS or name.startswith("Program Files") \
-                        or gitignored(rules, rel, True):
+            names = {e.filename for e in entries}
+            if rel_dir and "pyvenv.cfg" in names:
+                continue                              # a virtualenv, whatever it is named
+            readable.append((rel_dir, here, entries, ".gitignore" in names))
+        ignores = await _gather_bounded([ignore_file(here) for _r, here, _e, has in readable if has])
+        it = iter(ignores)
+        for rel_dir, _here, _entries, has in readable:
+            if has:
+                data = next(it)
+                if data is not None:
+                    rules += gitignore_rules(data.decode("utf-8", "replace"), rel_dir)
+        level = []
+        for rel_dir, _here, entries, _has in readable:
+            for e in sorted(entries, key=lambda x: x.filename):
+                name = e.filename
+                if name in (".", ".."):
                     continue
-                stack.append(rel)
-                continue
-            what = indexable(rel)
-            if not what or gitignored(rules, rel, False):
-                continue
-            if len(items) >= max_files:
-                partial = f"over {max_files} files"
-                stack = []
+                rel = f"{rel_dir}/{name}" if rel_dir else name
+                kind = getattr(e.attrs, "type", None)
+                if kind == _SFTP_LINK:
+                    continue
+                if kind == _SFTP_DIR:
+                    if name.startswith(".") or name in SKIP_DIRS or name.startswith("Program Files") \
+                            or gitignored(rules, rel, True):
+                        continue
+                    level.append(rel)
+                    continue
+                what = indexable(rel)
+                if not what or gitignored(rules, rel, False):
+                    continue
+                if len(items) >= max_files:
+                    partial = f"over {max_files} files"
+                    level = []
+                    break
+                items.append({"path": rel, "size": int(getattr(e.attrs, "size", 0) or 0),
+                              "mtime": float(getattr(e.attrs, "mtime", 0) or 0), "kind": what})
+            if partial.startswith("over "):
                 break
-            items.append({"path": rel, "size": int(getattr(e.attrs, "size", 0) or 0),
-                          "mtime": float(getattr(e.attrs, "mtime", 0) or 0), "kind": what})
+    items.sort(key=lambda i: i["path"])
     return {"items": items, "partial": partial, "os": sftp_os(root)}
 
 
@@ -1933,27 +2066,34 @@ async def sftp_read_many(sftp, root: str, paths: list, max_bytes: int = MAX_FILE
     skipped: list = []
     rest: list = []
     used = 0
+    todo: list = []
     for rel in paths or []:
         full = _inside(root, str(rel))
         if full is None or not indexable(str(rel)):
             skipped.append(rel)
-            continue
-        if used >= batch_bytes:
-            rest.append(rel)
-            continue
+        else:
+            todo.append((rel, full))
+
+    async def one(rel, full):
         if not await _sftp_contained(sftp, root, full):
-            skipped.append(rel)
-            continue
+            return rel, None
         try:
-            data = await _sftp_bytes(sftp, full, max_bytes)
+            return rel, await _sftp_bytes(sftp, full, max_bytes)
         except Exception:
-            skipped.append(rel)
-            continue
-        if data is None:
-            skipped.append(rel)
-            continue
-        files[rel] = data
-        used += len(data)
+            return rel, None
+
+    # read SFTP_PARALLEL files at once, a slice at a time: the batch cap is checked between slices (a batch may
+    # end one slice over it, as a one-by-one read could end one file over it)
+    for i in range(0, len(todo), SFTP_PARALLEL):
+        if used >= batch_bytes:
+            rest += [rel for rel, _full in todo[i:]]
+            break
+        for rel, data in await _gather_bounded([one(rel, full) for rel, full in todo[i:i + SFTP_PARALLEL]]):
+            if data is None:
+                skipped.append(rel)
+            else:
+                files[rel] = data
+                used += len(data)
     return {"files": files, "skipped": skipped, "rest": rest, "os": sftp_os(root)}
 
 

imperal_sdk-6.3.6/src/imperal_sdk/gnc_guard.py → imperal_sdk-6.3.8/src/imperal_sdk/dwell_guard.py

@@ -1,13 +1,15 @@
 """
-GNC Lyapunov Guard for Autonomous Long-Running Marathons (RFC: ICNLI V17)
+Dwell guard for long-running marathons: is the agent stuck on one item?
 
-Replaces scalar 1D Lyapunov error V(q, p) with a composite multi-scale potential:
-  V(S) = alpha * (1 - MacroCoverage)^2 + beta * ||x_micro||^2 + gamma * Psi(tau_dwell)
+Each step scores a gap from three measured parts:
+  gap = alpha * (1 - coverage)^2 + beta * error^2 + gamma * excess_dwell^2
 
-Features:
-  1. Sub-manifold Limit Cycle Detection (prevents 70,000s traps like Ignat's marathon)
-  2. Macro-Velocity Governor (tracks coverage progress per step/time)
-  3. Anti-Yak-Shaving Barrier (caps recursion depth <= 2 and forces scratchpad deferral)
+and raises an alarm when the agent
+  1. goes deeper than ``max_subtask_depth`` nested subtasks,
+  2. stays on one entity for more than ``max_dwell_steps`` steps without coverage gain, or
+  3. lets the gap grow while dwelling.
+
+(``imperal_sdk.gnc_guard`` keeps the old names ``GNCLyapunovGuard`` / ``GNCEnergyState``.)
 """
 
 from __future__ import annotations
@@ -19,7 +21,7 @@ from typing import Dict, List, Optional, Tuple, Any
 
 
 @dataclass
-class GNCEnergyState:
+class DwellGuardStep:
     step: int
     timestamp: float
     active_entity_id: str
@@ -35,19 +37,16 @@ class GNCEnergyState:
     alarm_reason: Optional[str] = None
 
 
-class GNCLyapunovGuard:
-    """
-    Composite Multi-Scale Lyapunov Stability Guard.
-    Directly connected to Tenant Vault Working RAM.
-    """
+class DwellGuard:
+    """Scores each step's gap and raises an alarm when the agent dwells on one entity."""
 
     def __init__(
         self,
-        alpha: float = 10.0,       # Macro-weight (high penalty for unfinished system)
-        beta: float = 1.0,         # Micro-weight (local syntax/test error)
-        gamma: float = 5.0,        # Barrier weight for dwelling/stalling
+        alpha: float = 10.0,       # weight of the unfinished share of the plan
+        beta: float = 1.0,         # weight of the local error (syntax / test)
+        gamma: float = 5.0,        # weight of the steps over the dwell budget
         max_dwell_steps: int = 12, # Max allowed steps on one entity before alarm
-        max_subtask_depth: int = 2 # Anti-Yak-Shaving depth barrier
+        max_subtask_depth: int = 2 # max nesting of subtasks
     ):
         self.alpha = alpha
         self.beta = beta
@@ -55,7 +54,7 @@ class GNCLyapunovGuard:
         self.max_dwell_steps = max_dwell_steps
         self.max_subtask_depth = max_subtask_depth
         
-        self.history: List[GNCEnergyState] = []
+        self.history: List[DwellGuardStep] = []
         self._current_subtask_depth: int = 1
         self._last_active_entity: Optional[str] = None
         self._entity_dwell_counter: int = 0
@@ -67,10 +66,8 @@ class GNCLyapunovGuard:
         active_entity_id: str,
         micro_error: float = 0.0,
         subtask_depth: int = 1
-    ) -> GNCEnergyState:
-        """
-        Calculates composite Lyapunov energy V(S) and checks stability criteria.
-        """
+    ) -> DwellGuardStep:
+        """Scores this step's gap and checks the depth, dwell and growth limits."""
         now = time.time()
         step_num = len(self.history) + 1
 
@@ -110,33 +107,33 @@ class GNCLyapunovGuard:
         else:
             delta_v = 0.0
 
-        # Detect limit cycle / stall
+        # Detect a stall
         is_limit_cycle = False
         alarm_reason = None
 
-        # Check Depth Barrier (Anti-Yak-Shaving)
+        # Too many nested subtasks
         if subtask_depth > self.max_subtask_depth:
             is_limit_cycle = True
             alarm_reason = (
-                f"Anti-Yak-Shaving Barrier tripped: subtask depth {subtask_depth} exceeds "
-                f"limit {self.max_subtask_depth}. Refuse deep refactoring; defer blocker to scratchpad."
+                f"Subtask depth {subtask_depth} exceeds the limit {self.max_subtask_depth}: "
+                f"do not go deeper; note the blocker and return to the item."
             )
-        # Check Dwell Barrier
+        # Too many steps on one entity
         elif dwell > self.max_dwell_steps:
             is_limit_cycle = True
             alarm_reason = (
-                f"Limit cycle detected on '{active_entity_id}': dwell steps ({dwell}) exceeded "
-                f"budget ({self.max_dwell_steps}) with zero macro coverage gain. Forcing phase transition!"
+                f"Stuck on '{active_entity_id}': {dwell} steps without coverage gain "
+                f"(limit {self.max_dwell_steps}). Move to another item or report the blocker."
             )
-        # Check Energy Divergence
+        # The gap grows while dwelling
         elif delta_v > 0.5 and dwell > 5:
             is_limit_cycle = True
             alarm_reason = (
-                f"Lyapunov energy diverging (Delta V = +{delta_v:.3f}): system is expanding energy "
-                f"on secondary details without macroscopic convergence."
+                f"The gap grew by {delta_v:.3f} while dwelling: the steps go into side details "
+                f"without moving the plan."
             )
 
-        state = GNCEnergyState(
+        state = DwellGuardStep(
             step=step_num,
             timestamp=now,
             active_entity_id=active_entity_id,

imperal_sdk-6.3.8/src/imperal_sdk/gnc_guard.py

@@ -0,0 +1,4 @@
+"""Old names of :mod:`imperal_sdk.dwell_guard`, kept so existing extensions keep importing."""
+from imperal_sdk.dwell_guard import DwellGuard as GNCLyapunovGuard, DwellGuardStep as GNCEnergyState
+
+__all__ = ["GNCLyapunovGuard", "GNCEnergyState"]

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/src/imperal_sdk/schema/marathon_ram.sql

@@ -1,6 +1,6 @@
 -- ============================================================================
 -- IMPERAL CLOUD OS — TENANT VAULT WORKING RAM (COGNITIVE BLACKBOARD)
--- RFC: ICNLI V17 / GNC Marathon Resilience Engine
+-- RFC: ICNLI V17
 -- ============================================================================
 
 -- 1. Target System Entities (BOM: screens, routes, models, services)

{imperal_sdk-6.3.6 → imperal_sdk-6.3.8}/src/imperal_sdk/vault_ram_client.py

@@ -1,5 +1,5 @@
 """
-Tenant Vault Working RAM Client (RFC: ICNLI V17 / GNC Marathon Resilience Engine)
+Tenant Vault Working RAM Client 
 
 Provides sub-3ms working memory access for autonomous marathons.
 Separates LLM Reasoning Core (CPU/ALU) from Persistent State Store (Working RAM).

imperal_sdk-6.3.6/tests/test_quantum_app.py → imperal_sdk-6.3.8/tests/test_app_engine.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 # Copyright (c) 2026 Imperal, Inc., Valentin Scerbacov, and contributors
 # Licensed under the Apache-2.0 License. See LICENSE file for details.
-"""Tests for ICNLI Quantum SDK v6.0 App Engine."""
+"""Tests for the Imperal SDK App."""
 from __future__ import annotations
 
 import asyncio

imperal_sdk-6.3.8/tests/test_code_index_configs.py

@@ -0,0 +1,70 @@
+"""The one reader of resolution configs (tsconfig/jsconfig are JSON with comments): comments and trailing
+commas go, strings stay whole -- live 2026-11-03, imperal.io's ``"@/*"`` was read as a comment opener."""
+from imperal_sdk.code_index import parse_config, parse_jsonc, strip_jsonc
+
+# imperal.io's own tsconfig.json (Next.js 16), verbatim in shape: "@/*" and "**/*.ts" in strings
+NEXT_TSCONFIG = """{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "strict": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}
+"""
+
+
+def test_next_tsconfig_keeps_its_paths():
+    kind, data = parse_config("tsconfig.json", NEXT_TSCONFIG)
+    assert kind == "tsconfig"
+    assert data == {"baseUrl": "", "paths": {"@/*": ["./src/*"]}}
+
+
+def test_comments_and_trailing_commas_go_outside_strings_only():
+    text = """{
+      // a line comment with "quotes" and /* inside
+      "compilerOptions": {
+        /* a block comment
+           over lines, with "@/*" text */
+        "baseUrl": ".", // after a value
+        "paths": {"~/*": ["src/*",], "url": ["https://example.com/a//b"],},
+      },
+    }"""
+    data = parse_jsonc(text)
+    assert data["compilerOptions"]["baseUrl"] == "."
+    assert data["compilerOptions"]["paths"] == {"~/*": ["src/*"], "url": ["https://example.com/a//b"]}
+
+
+def test_escaped_quotes_and_backslashes_stay_inside_the_string():
+    text = '{"a": "say \\"/*\\" not a comment", "b": "c:\\\\dir\\\\", "c": 1,}'
+    assert parse_jsonc(text) == {"a": 'say "/*" not a comment', "b": "c:\\dir\\", "c": 1}
+
+
+def test_a_comma_before_a_comment_then_a_brace_is_trailing():
+    assert parse_jsonc('{"a": [1, 2, /* end */ ], "b": 3, // last\n}') == {"a": [1, 2], "b": 3}
+
+
+def test_not_an_object_is_empty():
+    assert parse_jsonc("[1, 2]") == {}
+    assert parse_jsonc("{ broken") == {}
+    assert strip_jsonc("") == ""
+
+
+def test_package_json_and_jsconfig():
+    assert parse_config("web/package.json", '{"name": "web", "main": "index.js", // c\n}') == (
+        "package_json", {"name": "web", "main": "index.js"})
+    assert parse_config("jsconfig.json", '{"compilerOptions": {"baseUrl": "src"}}')[0] == "jsconfig"