@soederpop/luca 0.0.19 → 0.0.21

package/docs/bootstrap/SKILL.md

@@ -26,6 +26,13 @@ luca describe clients      # index of all available clients
 luca describe servers      # index of all available servers
 ```
 
+You can even learn about features in the browser container, or a specific platform (server, node are the same, browser,web are the same)
+
+```shell
+luca describe features --platform=web 
+luca describe features --platform=server
+```
+
 ### Learn about specific helpers
 
 ```shell
@@ -230,6 +237,15 @@ This is useful inside commands and scripts where you need introspection data pro
 
 ---
 
+## Server development troubleshooting
+
+- You can use `container.proc.findPidsByPort(3000)` which will return an array of numbers.
+- You can use `container.proc.kill(pid)` to kill that process
+- You can combine these two functions in `luca eval` if a server you're developing won't start because a previous instance is running (common inside e.g. claude code sessions )
+- `luca serve --force` will also replace the running process with the current one
+- `luca serve --any-port` will open on any port
+
+
 ## Reference
 
 See `references/api-docs/` for the full pre-generated API reference for every built-in feature, client, and server.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soederpop/luca",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "website": "https://luca.soederpop.com",
   "description": "lightweight universal conversational architecture AKA Le Ultimate Component Architecture AKA Last Universal Common Ancestor, part AI part Human",
   "author": "jon soeder aka the people's champ <jon@soederpop.com>",

package/src/bootstrap/generated.ts

@@ -1,5 +1,5 @@
 // Auto-generated bootstrap content
-// Generated at: 2026-03-20T21:13:00.583Z
+// Generated at: 2026-03-21T05:24:16.832Z
 // Source: docs/bootstrap/*.md, docs/bootstrap/templates/*
 //
 // Do not edit manually. Run: luca build-bootstrap
@@ -33,6 +33,13 @@ luca describe clients      # index of all available clients
 luca describe servers      # index of all available servers
 \`\`\`
 
+You can even learn about features in the browser container, or a specific platform (server, node are the same, browser,web are the same)
+
+\`\`\`shell
+luca describe features --platform=web 
+luca describe features --platform=server
+\`\`\`
+
 ### Learn about specific helpers
 
 \`\`\`shell
@@ -237,6 +244,15 @@ This is useful inside commands and scripts where you need introspection data pro
 
 ---
 
+## Server development troubleshooting
+
+- You can use \`container.proc.findPidsByPort(3000)\` which will return an array of numbers.
+- You can use \`container.proc.kill(pid)\` to kill that process
+- You can combine these two functions in \`luca eval\` if a server you're developing won't start because a previous instance is running (common inside e.g. claude code sessions )
+- \`luca serve --force\` will also replace the running process with the current one
+- \`luca serve --any-port\` will open on any port
+
+
 ## Reference
 
 See \`references/api-docs/\` for the full pre-generated API reference for every built-in feature, client, and server.

package/src/commands/chat.ts

@@ -187,8 +187,20 @@ export default async function chat(options: z.infer<typeof argsSchema>, context:
 		output: process.stdout,
 	})
 
+	let rlClosed = false
+	rl.on('close', () => { rlClosed = true })
+
+	function ensureRl() {
+		if (rlClosed) {
+			rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+			rlClosed = false
+			rl.on('close', () => { rlClosed = true })
+		}
+	}
+
 	function prompt(): Promise<string> {
 		return new Promise((resolve) => {
+			ensureRl()
 			rl.question(ui.colors.dim(`\n${name} > `), (answer: string) => resolve(answer.trim()))
 		})
 	}
@@ -247,6 +259,8 @@ export default async function chat(options: z.infer<typeof argsSchema>, context:
 			console.log()
 			console.log(ui.colors.dim(`  Back in chat with ${ui.colors.cyan(name)}.`))
 			rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+			rlClosed = false
+			rl.on('close', () => { rlClosed = true })
 			continue
 		}