@soederpop/luca 0.0.6 → 0.0.8

package/docs/apis/features/node/git.md

@@ -167,6 +167,7 @@ const history = git.getChangeHistoryForFiles('src/node/features/*.ts')
 
 | Property | Type | Description |
 |----------|------|-------------|
+| `gitPath` | `string` | Resolve the git binary path via `which`, caching the result. |
 | `branch` | `any` | Gets the current Git branch name. |
 | `sha` | `any` | Gets the current Git commit SHA hash. |
 | `isRepo` | `any` | Checks if the current directory is within a Git repository. |

package/docs/apis/features/node/google-auth.md

@@ -110,25 +110,44 @@ Revoke the current credentials and clear cached tokens.
 
 ### tokenRefreshed
 
-Event emitted by GoogleAuth
+Access token was refreshed
 
 
 
 ### error
 
-Event emitted by GoogleAuth
+Authentication error occurred
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error |
 
 
 
 ### authorizationRequired
 
-Event emitted by GoogleAuth
+User must visit this URL to authorize
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Authorization URL to visit |
 
 
 
 ### authenticated
 
-Event emitted by GoogleAuth
+Authentication successful
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `mode` | `string` | Auth mode used |
+| `email` | `string` | User or service account email |
 
 
 

package/docs/apis/features/node/google-calendar.md

@@ -140,13 +140,25 @@ Search events by text query across event summaries, descriptions, and locations.
 
 ### error
 
-Event emitted by GoogleCalendar
+Calendar API error occurred
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error |
 
 
 
 ### eventsFetched
 
-Event emitted by GoogleCalendar
+Events were fetched from Calendar
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `number` | Number of events returned |
 
 
 

package/docs/apis/features/node/google-docs.md

@@ -107,13 +107,26 @@ Search for Google Docs by name or content.
 
 ### documentFetched
 
-Event emitted by GoogleDocs
+A document was fetched
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Document ID |
+| `arg1` | `string` | Title |
 
 
 
 ### error
 
-Event emitted by GoogleDocs
+Docs API error occurred
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error |
 
 
 

package/docs/apis/features/node/google-drive.md

@@ -178,19 +178,37 @@ List all shared drives the user has access to.
 
 ### filesFetched
 
-Event emitted by GoogleDrive
+Files were fetched from Drive
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `number` | Number of files returned |
 
 
 
 ### error
 
-Event emitted by GoogleDrive
+Drive API error occurred
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error |
 
 
 
 ### fileDownloaded
 
-Event emitted by GoogleDrive
+A file was downloaded
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | File ID |
 
 
 

package/docs/apis/features/node/google-sheets.md

@@ -134,13 +134,25 @@ Download sheet data as CSV and save to a local file.
 
 ### error
 
-Event emitted by GoogleSheets
+Sheets API error occurred
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error |
 
 
 
 ### dataFetched
 
-Event emitted by GoogleSheets
+Sheet data was fetched
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `number` | Number of rows |
 
 
 

package/docs/apis/features/node/grep.md

@@ -185,6 +185,8 @@ const affected = await grep.findForReplace('oldFunctionName')
 | Property | Type | Description |
 |----------|------|-------------|
 | `hasRipgrep` | `boolean` | Whether ripgrep (rg) is available on this system |
+| `rgPath` | `string` | Resolved path to the rg binary |
+| `grepPath` | `string` | Resolved path to the grep binary |
 
 ## State (Zod v4 schema)
 

package/docs/apis/features/node/helpers.md

@@ -108,6 +108,35 @@ Get the introspection description for a specific helper.
 | `manifestURL` | `string` | The URL to fetch the helpers manifest from. |
 | `available` | `Record<string, string[]>` | Returns a unified view of all available helpers across all registries. Each key is a registry type, each value is the list of helper names in that registry. |
 
+## Events (Zod v4 schema)
+
+### discovered
+
+Emitted after a registry type has been discovered
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Registry type that was discovered |
+| `arg1` | `array` | Names of newly registered helpers |
+
+
+
+### registered
+
+Emitted when a single helper is registered
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Registry type |
+| `arg1` | `string` | Helper name |
+| `arg2` | `any` | The helper class or module |
+
+
+
 ## State (Zod v4 schema)
 
 | Property | Type | Description |

package/docs/apis/features/node/ink.md

@@ -217,13 +217,13 @@ await renderAsync('AsyncChart', { url: 'https://api.example.com/data' })
 
 ### mounted
 
-Event emitted by Ink
+Emitted when a React element is mounted to the terminal via render()
 
 
 
 ### unmounted
 
-Event emitted by Ink
+Emitted when the mounted Ink app exits or is unmounted
 
 
 

package/docs/apis/features/node/networking.md

@@ -205,25 +205,60 @@ Convenience method: discover and port-scan hosts across all local networks.
 
 ### scan:start
 
-Event emitted by Networking
+When a network scan begins
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `target` | `string` | Scan target identifier |
+| `type` | `string` | Scan type identifier |
 
 
 
 ### host:discovered
 
-Event emitted by Networking
+When a host is found during network scanning
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `ip` | `string` | Host IP address |
+| `mac` | `string` | MAC address when available |
+| `reachable` | `boolean` | Whether host appears reachable |
+| `method` | `'arp' | 'tcp'` | Discovery method used for this host |
 
 
 
 ### scan:complete
 
-Event emitted by Networking
+When a network scan finishes
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `target` | `string` | Scan target identifier |
+| `type` | `string` | Scan type identifier |
+| `duration` | `number` | Scan duration in milliseconds |
+| `hostsFound` | `number` | Number of hosts discovered |
+| `portsFound` | `number` | Number of open ports discovered |
 
 
 
 ### port:open
 
-Event emitted by Networking
+When an open port is detected on a host
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `host` | `string` | Host IP address |
+| `port` | `number` | Open port number |
+| `service` | `string` | Best-effort service name |
+| `banner` | `string` | Banner text when captured |
 
 
 

package/docs/apis/features/node/os.md

@@ -8,6 +8,23 @@ The OS feature provides access to operating system utilities and information. Th
 container.feature('os')
 ```
 
+## Methods
+
+### getDisplayInfo
+
+Gets information about all connected displays. Platform-specific: currently implemented for macOS (darwin). Linux and Windows will throw with a clear "not yet implemented" message.
+
+**Returns:** `DisplayInfo[]`
+
+```ts
+const displays = os.getDisplayInfo()
+displays.forEach(d => {
+ console.log(`${d.name}: ${d.resolution.width}x${d.resolution.height}${d.retina ? ' (Retina)' : ''}`)
+})
+```
+
+
+
 ## Getters
 
 | Property | Type | Description |
@@ -42,6 +59,17 @@ console.log(`Home directory: ${osInfo.homedir}`)
 
 
 
+**getDisplayInfo**
+
+```ts
+const displays = os.getDisplayInfo()
+displays.forEach(d => {
+ console.log(`${d.name}: ${d.resolution.width}x${d.resolution.height}${d.retina ? ' (Retina)' : ''}`)
+})
+```
+
+
+
 **arch**
 
 ```ts

package/docs/apis/features/node/postgres.md

@@ -113,25 +113,47 @@ await pg.close()
 
 ### query
 
-Event emitted by Postgres
+When a SELECT-like query is executed
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | The SQL query text |
+| `arg1` | `array` | Bound parameter values |
+| `arg2` | `number` | Number of rows returned |
 
 
 
 ### error
 
-Event emitted by Postgres
+When a postgres operation fails
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The error object |
 
 
 
 ### execute
 
-Event emitted by Postgres
+When a write/update/delete statement is executed
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | The SQL statement text |
+| `arg1` | `array` | Bound parameter values |
+| `arg2` | `number` | Number of rows affected |
 
 
 
 ### closed
 
-Event emitted by Postgres
+When the postgres connection is closed
 
 
 

package/docs/apis/features/node/proc.md

@@ -150,6 +150,19 @@ const version = proc.exec('node --version')
 
 
 
+### execSync
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `command` | `string` | ✓ | Parameter command |
+| `options` | `any` |  | Parameter options |
+
+**Returns:** `string`
+
+
+
 ### establishLock
 
 Establishes a PID-file lock to prevent duplicate process instances. Writes the current process PID to the given file path. If the file already exists and the PID inside it refers to a running process, the current process exits immediately. Stale PID files (where the process is no longer running) are automatically cleaned up. Cleanup handlers are registered on SIGTERM, SIGINT, and process exit to remove the PID file when the process shuts down.
@@ -219,35 +232,39 @@ for (const pid of proc.findPidsByPort(3000)) {
 
 
 
-### onSignal
+### isProcessRunning
 
-Registers a handler for a process signal (e.g. SIGINT, SIGTERM, SIGUSR1). Returns a cleanup function that removes the listener when called.
+Checks whether any process matching a given name is currently running. Uses `pgrep -x` for an exact match against process names.
 
 **Parameters:**
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `signal` | `NodeJS.Signals` | ✓ | The signal name to listen for (e.g. 'SIGINT', 'SIGTERM', 'SIGUSR2') |
-| `handler` | `() => void` | ✓ | The function to call when the signal is received |
+| `name` | `string` | ✓ | The process name to look for (e.g. 'afplay', 'node', 'nginx') |
 
-**Returns:** `() => void`
+**Returns:** `boolean`
 
 ```ts
-// Graceful shutdown
-proc.onSignal('SIGTERM', () => {
- console.log('Shutting down gracefully...')
- process.exit(0)
-})
-
-// Remove the listener later
-const off = proc.onSignal('SIGUSR2', () => {
- console.log('Received SIGUSR2')
-})
-off()
+if (proc.isProcessRunning('afplay')) {
+ console.log('Audio is currently playing')
+}
 ```
 
 
 
+### onSignal
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `signal` | `NodeJS.Signals` | ✓ | Parameter signal |
+| `handler` | `() => void` | ✓ | Parameter handler |
+
+**Returns:** `() => void`
+
+
+
 ## State (Zod v4 schema)
 
 | Property | Type | Description |
@@ -371,19 +388,11 @@ for (const pid of proc.findPidsByPort(3000)) {
 
 
 
-**onSignal**
+**isProcessRunning**
 
 ```ts
-// Graceful shutdown
-proc.onSignal('SIGTERM', () => {
- console.log('Shutting down gracefully...')
- process.exit(0)
-})
-
-// Remove the listener later
-const off = proc.onSignal('SIGUSR2', () => {
- console.log('Received SIGUSR2')
-})
-off()
+if (proc.isProcessRunning('afplay')) {
+ console.log('Audio is currently playing')
+}
 ```
 

package/docs/apis/features/node/process-manager.md

@@ -150,31 +150,59 @@ Called by SpawnHandler when a process finishes. Updates feature-level state.
 
 ### spawned
 
-Event emitted by ProcessManager
+Emitted when a new process is spawned
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | process ID |
+| `arg1` | `any` | process metadata |
 
 
 
 ### exited
 
-Event emitted by ProcessManager
+Emitted when a process exits normally
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | process ID |
+| `arg1` | `number` | exit code |
 
 
 
 ### crashed
 
-Event emitted by ProcessManager
+Emitted when a process exits with non-zero code
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | process ID |
+| `arg1` | `number` | exit code |
+| `arg2` | `any` | error info |
 
 
 
 ### killed
 
-Event emitted by ProcessManager
+Emitted when a process is killed
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | process ID |
 
 
 
 ### allStopped
 
-Event emitted by ProcessManager
+Emitted when all tracked processes have stopped
 
 
 

package/docs/apis/features/node/repl.md

@@ -36,7 +36,7 @@ Start the REPL session. Creates a VM context populated with the container and it
 
 | Property | Type | Description |
 |----------|------|-------------|
-| `historyPath` | `any` | Custom path for the history file (defaults to node_modules/.cache/.repl_history) |
+| `historyPath` | `any` | Custom path for the history file (defaults to ~/.cache/luca/repl-{cwdHash}.history) |
 | `context` | `any` | Additional variables to inject into the VM context |
 
 **Returns:** `void`

package/docs/apis/features/node/runpod.md

@@ -462,6 +462,7 @@ gpus.forEach(g => console.log(`${g.gpuType}: $${g.ondemandPrice}/hr`))
 | Property | Type | Description |
 |----------|------|-------------|
 | `proc` | `any` | The proc feature used for executing CLI commands like runpodctl. |
+| `runpodctlPath` | `string` | Resolve the runpodctl binary path via `which`, caching the result. |
 | `apiKey` | `any` | RunPod API key from options or the RUNPOD_API_KEY environment variable. |
 | `dataCenterId` | `any` | Preferred data center ID, defaults to 'US-TX-3'. |
 

package/docs/apis/features/node/secure-shell.md

@@ -105,6 +105,13 @@ await ssh.upload('./build/app.tar.gz', '/opt/releases/app.tar.gz')
 
 
 
+## Getters
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `sshPath` | `string` | Resolved path to the ssh binary |
+| `scpPath` | `string` | Resolved path to the scp binary |
+
 ## State (Zod v4 schema)
 
 | Property | Type | Description |

package/docs/apis/features/node/semantic-search.md

@@ -1,6 +1,6 @@
 # SemanticSearch (features.semanticSearch)
 
-No description provided
+Semantic search feature providing BM25 keyword search, vector similarity search, and hybrid search with Reciprocal Rank Fusion over a SQLite-backed index. Uses bun:sqlite for FTS5 keyword search and BLOB-stored embeddings with JavaScript cosine similarity for vector search.
 
 ## Usage
 
@@ -353,25 +353,32 @@ Install node-llama-cpp into the user's project for local embedding support. Dete
 
 ### dbReady
 
-Event emitted by SemanticSearch
+When the SQLite database is initialized and ready
 
 
 
 ### modelLoaded
 
-Event emitted by SemanticSearch
+When the local embedding model is loaded into memory
 
 
 
 ### modelDisposed
 
-Event emitted by SemanticSearch
+When the local embedding model is disposed from memory
 
 
 
 ### indexed
 
-Event emitted by SemanticSearch
+When documents are indexed with embeddings
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `documents` | `number` | Number of documents indexed |
+| `chunks` | `number` | Number of chunks created |