@soederpop/luca 0.0.25 → 0.0.28

package/src/introspection/generated.web.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-22T06:53:17.219Z
+// Generated at: 2026-03-23T07:45:56.989Z
 
 setBuildTimeData('features.containerLink', {
   "id": "features.containerLink",
@@ -982,6 +982,10 @@ setContainerBuildTimeData('Container', {
       "description": "Returns a map of enabled feature shortcut IDs to their instances.",
       "returns": "Partial<AvailableInstanceTypes<Features>>"
     },
+    "describer": {
+      "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+      "returns": "ContainerDescriber"
+    },
     "context": {
       "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
       "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"
@@ -2029,6 +2033,10 @@ export const containerIntrospectionData = [
         "description": "Returns a map of enabled feature shortcut IDs to their instances.",
         "returns": "Partial<AvailableInstanceTypes<Features>>"
       },
+      "describer": {
+        "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+        "returns": "ContainerDescriber"
+      },
       "context": {
         "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
         "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"

package/src/node/features/content-db.ts

@@ -428,6 +428,23 @@ export class ContentDb extends Feature<ContentDbState, ContentDbOptions> {
   async generateModelSummary(options: any) {
 	  return this.collection.generateModelSummary(options)
   }
+  
+  get modelDefinitionTable() {
+    return Object.fromEntries(this.collection.modelDefinitions.map(d => {
+      
+      const prefixPattern = this.container.paths.relative(this.collection.resolve(d.prefix))
+
+      return [d.name, {
+        description: d.name === 'Base' ? 'Any markdown document not matched to a model' : d.description,
+        glob: `${prefixPattern}/**/*.md`,
+        routePatterns: Array(d.pattern).flatMap(p => p).filter(Boolean).map(p => `${prefixPattern}/${p}`)
+      }]
+    }))
+  }
+  
+  get fileTree() {
+    return this.collection.renderFileTree()
+  }
 
   // ── Search Integration ─────────────────────────────────────────────
 

package/src/node/features/fs.ts

@@ -88,6 +88,16 @@ export class FS extends Feature {
     return readFileSync(filePath, encoding ?? 'utf-8')
   }
 
+  /**
+   * Synchronously reads a file and returns its contents as a string.
+   * added this method because AI Assistants are understandly confused by this deviation from 2000's era node style
+   * @alias readFile
+   */
+  readFileSync(path: string, encoding?: BufferEncoding | null): string | Buffer {
+    return this.readFile(path,encoding)
+  }
+  
+
   /**
    * Asynchronously reads a file and returns its contents as a string.
    *
@@ -126,6 +136,14 @@ export class FS extends Feature {
   readJson(path: string) {
     return JSON.parse(this.readFile(path) as string)
   }
+  
+  /**
+    * Read and parse a JSON file synchronously
+    * @alias readJson
+   */
+  readJsonSync(path: string) {
+    return this.readJson(path)
+  }
 
   /**
    * Asynchronously reads and parses a JSON file.