@goodandready/dsh-context-lens 0.1.24 → 0.1.25

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to `@goodandready/dsh-context-lens` will be documented in th
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.25] - 2026-09-25
+
+### Fixed
+- **SettingsForms modern API adapter (#66)**: removed legacy call to nonexistent `sctx.settings.register` preventing crash on DSH 0.1.7-rc.1 core. Implemented `SettingsForms` adapter with `configure({ auto: false })`, live reading via `describe()` / `get()`, dynamic updates via `settings/document-updated`, and full cleanup on effect disposal.
+
 ## [0.1.24] - 2026-09-24
 
 ### Performance

package/lib/index.js

@@ -29,21 +29,69 @@ const NS = '@goodandready/dsh-context-lens';
 export { renderOutput };
 
 export function apply(ctx, config) {
-  let getConfig = () => config;
+  let readConfig = () => config;
+  const getConfig = () => readConfig();
 
   ctx.inject(['settings'], (sctx) => {
+    if (!sctx?.settings) return;
+
+    let disposeConfigure;
+    try {
+      if (typeof sctx.settings.configure === 'function') {
+        disposeConfigure = sctx.settings.configure({ auto: false }, ctx.fiber);
+      }
+    } catch (error) {
+      ctx.logger?.warn?.('dsh-context-lens: settings configure failed: ' + (error instanceof Error ? error.message : String(error)));
+    }
+
+    const readLiveSettings = () => {
+      try {
+        if (typeof sctx.settings.describe === 'function') {
+          const desc = sctx.settings.describe()?.find?.((row) => row.ns === NS);
+          if (desc && desc.value && typeof desc.value === 'object') {
+            return Config(desc.value);
+          }
+        } else if (typeof sctx.settings.get === 'function') {
+          const val = sctx.settings.get(NS);
+          if (val && typeof val === 'object') {
+            return Config(val);
+          }
+        }
+      } catch (error) {
+        ctx.logger?.warn?.('dsh-context-lens: settings describe failed: ' + (error instanceof Error ? error.message : String(error)));
+      }
+      return null;
+    };
+
+    readConfig = () => readLiveSettings() ?? Config(ctx.fiber?.config ?? config) ?? config;
+
     if (typeof sctx.effect === 'function') {
       sctx.effect(() => {
-        const scope = sctx.settings.register(NS, Config, { base: config });
-        getConfig = () => scope.get() ?? config;
+        const disposeDocUpdated = typeof sctx.on === 'function'
+          ? sctx.on('settings/document-updated', (updatedNs) => {
+              if (updatedNs === NS) {
+                // Live settings refreshed on next readLiveSettings call
+              }
+            })
+          : null;
         return () => {
-          if (typeof scope?.dispose === 'function') scope.dispose();
-          getConfig = () => config;
+          if (typeof disposeConfigure === 'function') {
+            try {
+              disposeConfigure();
+            } catch (err) {
+              ctx.logger?.debug?.('dsh-context-lens: disposeConfigure failed', err);
+            }
+          }
+          if (typeof disposeDocUpdated === 'function') {
+            try {
+              disposeDocUpdated();
+            } catch (err) {
+              ctx.logger?.debug?.('dsh-context-lens: disposeDocUpdated failed', err);
+            }
+          }
+          readConfig = () => config;
         };
       }, 'dsh-context-lens: settings');
-    } else {
-      const scope = sctx.settings.register(NS, Config, { base: config });
-      getConfig = () => scope.get() ?? config;
     }
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-context-lens",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "DSH plugin for AST context compression, test log filtering, and token budget guard",
   "type": "module",
   "main": "lib/index.js",