@soederpop/luca 0.0.29 → 0.0.30

package/src/node/features/package-finder.ts

@@ -148,7 +148,7 @@ export class PackageFinder<
    * }, '/project/node_modules/lodash/package.json');
    * ```
    */
-  addPackage(manifest: PartialManifest, path: string) {
+  addPackage(manifest: PartialManifest, path: string): void {
     const { name } = manifest
     
     if (!this.packages[name]) {
@@ -179,7 +179,7 @@ export class PackageFinder<
    * });
    * ```
    */
-  get duplicates() {
+  get duplicates(): string[] {
     return Object.keys(
       pickBy(this.packages, (packages) => packages.length > 1)
     )
@@ -199,7 +199,7 @@ export class PackageFinder<
    * console.log(`Found ${finder.packageNames.length} unique packages`);
    * ```
    */
-  async start() {
+  async start(): Promise<this | undefined> {
     if (this.isStarted) {
       return this;
     }
@@ -234,7 +234,7 @@ export class PackageFinder<
    * console.log(`Scanned ${finder.manifests.length} packages`);
    * ```
    */
-  async scan(options: { exclude?: string | string[] } = {}) {
+  async scan(options: { exclude?: string | string[] } = {}): Promise<this> {
     const packageFolders = await this.findAllPackageFolders()
     const manifestPaths = packageFolders.map((folder) => `${folder}/package.json`)
 
@@ -256,7 +256,7 @@ export class PackageFinder<
    * 
    * @returns True if the finder has been started and scanning is complete
    */
-  get isStarted() {
+  get isStarted(): boolean {
     return !!this.state.get("started");
   }
  
@@ -271,7 +271,7 @@ export class PackageFinder<
    * console.log(`Found ${names.length} unique packages`);
    * ```
    */
-  get packageNames() {
+  get packageNames(): string[] {
     return Object.keys(this.packages)
   }
   
@@ -294,7 +294,7 @@ export class PackageFinder<
    * });
    * ```
    */
-  get scopes() {
+  get scopes(): string[] {
     return Array.from(
       new Set(this.packageNames.filter(p => p.startsWith('@')).map(p => p.split('/')[0]))
     )
@@ -317,7 +317,7 @@ export class PackageFinder<
    * }
    * ```
    */
-  findByName(name: string) {
+  findByName(name: string): PartialManifest | undefined {
     return this.find((i) => i.name === name)  
   }
 
@@ -340,7 +340,7 @@ export class PackageFinder<
    * });
    * ```
    */
-  findDependentsOf(packageName: string) {
+  findDependentsOf(packageName: string): PartialManifest[] {
     return this.filter(({ dependencies = {}, devDependencies = {} }) => {
       return packageName in dependencies || packageName in devDependencies
     })
@@ -361,7 +361,7 @@ export class PackageFinder<
    * const utility = finder.find(pkg => pkg.description?.includes('utility'));
    * ```
    */
-  find(filter: (manifest: PartialManifest) => boolean) {
+  find(filter: (manifest: PartialManifest) => boolean): PartialManifest | undefined {
     return this.manifests.find(filter)
   }
   
@@ -383,7 +383,7 @@ export class PackageFinder<
    * const scoped = finder.filter(pkg => pkg.name.startsWith('@'));
    * ```
    */
-  filter(filter: (manifest: PartialManifest) => boolean) {
+  filter(filter: (manifest: PartialManifest) => boolean): PartialManifest[] {
     return this.manifests.filter(filter)
   }
 
@@ -404,7 +404,7 @@ export class PackageFinder<
    * const unscoped = finder.exclude(pkg => pkg.name.startsWith('@'));
    * ```
    */
-  exclude(filter: (manifest: PartialManifest) => boolean) {
+  exclude(filter: (manifest: PartialManifest) => boolean): PartialManifest[] {
     return this.manifests.filter((m) => !filter(m))
   }
 
@@ -428,7 +428,7 @@ export class PackageFinder<
    * }, {});
    * ```
    */
-  get manifests() {
+  get manifests(): (PartialManifest & { __path: string })[] {
     return Object.values(this.packages).flat()
   }
   
@@ -452,7 +452,7 @@ export class PackageFinder<
    *   });
    * ```
    */
-  get counts() {
+  get counts(): Record<string, number> {
     return mapValues(this.packages, (packages) => packages.length)
   }
 
@@ -489,7 +489,7 @@ export class PackageFinder<
     return results;
   }
 
-  async findLocalPackageFolders() {
+  async findLocalPackageFolders(): Promise<string[]> {
 	  const cmd = "find . -name package.json"
 	  const result = this.container.proc.exec(cmd)
 	  const all = result.split("\n").filter(Boolean).map((path: string) => this.container.paths.dirname(path))

package/src/node/features/proc.ts

@@ -233,7 +233,7 @@ export class ChildProcess extends Feature {
    * Useful when callers need streaming access to stdout/stderr and
    * direct lifecycle control (for example, cancellation via kill()).
    */
-  spawn(command: string, args: string[] = [], options: RawSpawnOptions = {}) {
+  spawn(command: string, args: string[] = [], options: RawSpawnOptions = {}): import('child_process').ChildProcess {
     const cwd = options.cwd ?? this.container.cwd
     const stdout = options.stdout ?? 'pipe'
     const stderr = options.stderr ?? 'pipe'

package/src/node/features/ui.ts

@@ -104,7 +104,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * @param text - The markdown string to parse and render
    * @returns The rendered terminal-formatted string
    */
-  markdown(text: string) {
+  markdown(text: string): string | Promise<string> {
     return marked.parse(text)
   }
 
@@ -220,7 +220,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * });
    * ```
    */
-  get randomColor() {
+  get randomColor(): string | undefined {
     const colors = Object.keys(this.colors);
     const index = Math.floor(Math.random() * colors.length);
 
@@ -321,7 +321,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * ], { version: '1.0.0' });
    * ```
    */
-  wizard(questions: any[], initialAnswers: any = {}) {
+  wizard(questions: any[], initialAnswers: any = {}): Promise<any> {
     return inquirer.createPromptModule()(questions, initialAnswers);
   }
 
@@ -331,7 +331,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * @param question - The question message to display
    * @returns Promise resolving to the answers object with a `question` key
    */
-  askQuestion(question: string) {
+  askQuestion(question: string): Promise<any> {
     return inquirer.createPromptModule()([{
       type: 'input',
       name: 'question',
@@ -371,7 +371,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * const editedMarkdown = await ui.openInEditor(markdown, '.md');
    * ```
    */
-  async openInEditor(text: string, extension = ".ts") {
+  async openInEditor(text: string, extension = ".ts"): Promise<unknown> {
     const results = await new Promise((resolve, reject) => {
       /*
       editAsync(
@@ -429,7 +429,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * console.log('Available fonts:', ui.fonts.slice(0, 10).join(', '));
    * ```
    */
-  asciiArt(text: string, font: Fonts) {
+  asciiArt(text: string, font: Fonts): string {
     if (!figlet) return text;
     return figlet.textSync(text, font);
   }
@@ -481,7 +481,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * // Available colors: any chalk color names
    * ```
    */
-  banner(text: string, options: { font: Fonts; colors: Color[] } = { font: 'Star Wars', colors: ['red', 'white', 'blue'] }) {
+  banner(text: string, options: { font: Fonts; colors: Color[] } = { font: 'Star Wars', colors: ['red', 'white', 'blue'] }): string {
     const art = this.asciiArt(text, options.font || 'Star Wars');
     const colored = this.applyGradient(art, options.colors || ['red', 'white', 'blue']);
 
@@ -495,7 +495,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * @param args - Tagged template literal arguments
    * @returns The dedented string
    */
-  endent(...args: any[]) {
+  endent(...args: any[]): string {
     // @ts-ignore
     return endent(...args)
   }
@@ -544,7 +544,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
     text: string,
     lineColors: Color[] = ["red", "white", "blue"],
     direction: "horizontal" | "vertical" = "horizontal"
-  ) {
+  ): string {
     if (direction === "horizontal") {
       return this.applyHorizontalGradient(text, lineColors);
     }
@@ -587,7 +587,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
   applyHorizontalGradient(
     text: string,
     lineColors: Color[] = ["red", "white", "blue"]
-  ) {
+  ): string {
     const gColors = Object.fromEntries(
       lineColors.map((color) => [color, this.colors[color]])
     );
@@ -639,7 +639,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
   applyVerticalGradient(
     text: string,
     lineColors: Color[] = ["red", "white", "blue"]
-  ) {
+  ): string {
     const gColors = Object.fromEntries(
       lineColors.map((color) => [color, this.colors[color]])
     );
@@ -689,7 +689,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * const title = ui.padLeft('TITLE', 20, '-'); // '---------------TITLE'
    * ```
    */
-  padLeft(str: string, length: number, padChar = " ") {
+  padLeft(str: string, length: number, padChar = " "): string {
     if (str.length >= length) {
       return str;
     }
@@ -744,7 +744,7 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
    * const menuItem = ui.padRight('Coffee', 20, '.') + '$3.50';
    * ```
    */
-  padRight(str: string, length: number, padChar = " ") {
+  padRight(str: string, length: number, padChar = " "): string {
     if (str.length >= length) {
       return str;
     }

package/src/node/features/vm.ts

@@ -67,7 +67,7 @@ export class VM<
    * // import { Container } from '@soederpop/luca'  → works
    * ```
    */
-  defineModule(id: string, exports: any) {
+  defineModule(id: string, exports: any): void {
     this.modules.set(id, exports)
   }
 
@@ -78,7 +78,7 @@ export class VM<
    * @param filePath - The file path to scope native require resolution to
    * @returns A require function with `.resolve` preserved from the native require
    */
-  createRequireFor(filePath: string) {
+  createRequireFor(filePath: string): ((id: string) => any) & { resolve: RequireResolve } {
     const nodeRequire = createRequire(filePath)
     const modules = this.modules
 
@@ -111,7 +111,7 @@ export class VM<
    * const result2 = script.runInContext(vm.createContext({ a: 10, b: 20 }))
    * ```
    */
-  createScript(code: string, options?: vm.ScriptOptions) {
+  createScript(code: string, options?: vm.ScriptOptions): vm.Script {
     return new vm.Script(code, {
       ...options
     })
@@ -152,7 +152,7 @@ export class VM<
    * const result = vm.runSync('user.name', context)
    * ```
    */
-  createContext(ctx: any = {}) {
+  createContext(ctx: any = {}): vm.Context {
     if (this.isContext(ctx)) return ctx
     return vm.createContext({
       console,

package/src/scaffolds/generated.ts

@@ -1,5 +1,5 @@
 // Auto-generated scaffold and MCP readme content
-// Generated at: 2026-03-24T01:41:40.005Z
+// Generated at: 2026-03-24T06:38:36.374Z
 // Source: docs/scaffolds/*.md, docs/examples/assistant/, and docs/mcp/readme.md
 //
 // Do not edit manually. Run: luca build-scaffolds

package/src/servers/express.ts

@@ -55,11 +55,11 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
     _listener?: any
     _mountedEndpoints: Endpoint[] = []
 
-    get express() {
+    get express(): typeof express {
       return express
     }
 
-    get hooks() {
+    get hooks(): { create: (app: Express, server: Server) => Express; beforeStart: (options: any, server: Server) => any } {
       const { create = defaultCreate, beforeStart = () => {} } = this.options  
       
       return {
@@ -68,7 +68,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       }
     }
 
-    get app() {
+    get app(): Express {
       if(this._app) {
         return this._app
       }
@@ -99,7 +99,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
      *
      * @param options - Optional runtime overrides for port and host
      */
-    override async start(options?: StartOptions) {
+    override async start(options?: StartOptions): Promise<this> {
       if (this.isListening) {
         return this
       }
@@ -137,7 +137,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       return this
     }
 
-    override async stop() {
+    override async stop(): Promise<this> {
       if (this.isStopped) {
         return this
       }
@@ -167,7 +167,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       return this
     }
     
-    override async configure() {
+    override async configure(): Promise<this> {
       this.state.set('configured', true)
       return this
     }

package/src/servers/mcp.ts

@@ -428,7 +428,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
    * Configure the MCP protocol server and register all protocol handlers.
    * Called automatically before start() if not already configured.
    */
-  override async configure() {
+  override async configure(): Promise<this> {
     if (this.isConfigured) return this
 
     const serverName = this.options.serverName || this.container.manifest?.name || 'luca-mcp'
@@ -470,7 +470,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
     host?: string
     mcpCompat?: MCPCompatMode
     stdioCompat?: StdioCompatMode
-  }) {
+  }): Promise<this> {
     if (this.isListening) return this
     await this._drainPendingPlugins()
     if (!this.isConfigured) await this.configure()
@@ -499,7 +499,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
   /**
    * Stop the MCP server and close all connections.
    */
-  override async stop() {
+  override async stop(): Promise<this> {
     if (this.isStopped) return this
 
     if (this._mcpServer) {
@@ -631,7 +631,7 @@ export class MCPServer extends Server<MCPServerState, MCPServerOptions> {
   }
 
   /** Start an HTTP transport using StreamableHTTPServerTransport. */
-  private async _startHTTPTransport(port: number, compat: MCPCompatMode) {
+  private async _startHTTPTransport(port: number, compat: MCPCompatMode): Promise<void> {
     const { createServer } = await import('node:http')
     const { StreamableHTTPServerTransport } = await import(
       '@modelcontextprotocol/sdk/server/streamableHttp.js'

package/src/servers/socket.ts

@@ -65,7 +65,7 @@ export class WebsocketServer<T extends ServerState = ServerState, K extends Sock
     
     _wss?: BaseServer 
 
-    get wss() {
+    get wss(): BaseServer {
       if (this._wss) {
         return this._wss
       }
@@ -78,7 +78,7 @@ export class WebsocketServer<T extends ServerState = ServerState, K extends Sock
     connections : Set<any> = new Set()
     _pending = new Map<string, PendingRequest>()
 
-    async broadcast(message: any) {
+    async broadcast(message: any): Promise<this> {
       for(const ws of this.connections) {
         await ws.send(JSON.stringify(message))
       }
@@ -86,7 +86,7 @@ export class WebsocketServer<T extends ServerState = ServerState, K extends Sock
       return this
     }
     
-    async send(ws: any, message: any) {
+    async send(ws: any, message: any): Promise<this> {
       await ws.send(JSON.stringify(message))
       return this
     }
@@ -158,7 +158,7 @@ export class WebsocketServer<T extends ServerState = ServerState, K extends Sock
      *
      * @param options - Optional runtime overrides for port and host
      */
-    override async start(options?: StartOptions) {
+    override async start(options?: StartOptions): Promise<this> {
       if (this.isListening) {
         return this
       }
@@ -209,7 +209,7 @@ export class WebsocketServer<T extends ServerState = ServerState, K extends Sock
       return this
     }
 
-    override async stop() {
+    override async stop(): Promise<this> {
       if (this.isStopped) {
         return this
       }
@@ -250,7 +250,7 @@ export class WebsocketServer<T extends ServerState = ServerState, K extends Sock
     }
     
     /** The port this server will bind to. Defaults to 8081 if not set via constructor options or start(). */
-    override get port() {
+    override get port(): number {
       return this.state.get('port') || this.options.port || 8081
     }
 }