@aexol/spectral 0.2.8 → 0.2.9

package/dist/relay/dispatcher.js

@@ -39,6 +39,7 @@
  *    transparent to this layer — we just respond when we can.
  */
 import { BadRequestError, NotFoundError } from "../server/handlers/errors.js";
+import { handlePathAutocomplete } from "../server/handlers/paths-autocomplete.js";
 import { handleCreateProject, handleDeleteProject, handleListProjects, handleListSessionsByProject, handleUpdateProject, } from "../server/handlers/projects.js";
 import { handleCreateSession, handleDeleteSession, handleGetSessionDetail, handleUpdateSession, } from "../server/handlers/sessions.js";
 import { shutdownState } from "../server/shutdown.js";
@@ -50,9 +51,16 @@ import { shutdownState } from "../server/shutdown.js";
  * also marginally slower and harder to read for ~9 routes.
  */
 export function matchRoute(method, path) {
-    // Strip query string if any (we don't use any, but be defensive).
+    // Strip query string for path matching but keep it for the handler.
     const qIdx = path.indexOf("?");
     const cleanPath = qIdx === -1 ? path : path.slice(0, qIdx);
+    const query = qIdx >= 0 ? new URLSearchParams(path.slice(qIdx + 1)) : undefined;
+    // /api/paths/autocomplete
+    if (cleanPath === "/api/paths/autocomplete") {
+        if (method === "GET")
+            return { route: "list_path_autocomplete", query };
+        return null;
+    }
     // /api/projects
     if (cleanPath === "/api/projects") {
         if (method === "GET")
@@ -267,6 +275,10 @@ function dispatchRoute(match, body, deps) {
             }
             return { ok: true };
         }
+        case "list_path_autocomplete": {
+            const prefix = match.query?.get("prefix") ?? "";
+            return handlePathAutocomplete(prefix);
+        }
     }
 }
 /**

package/dist/server/handlers/paths-autocomplete.js

@@ -0,0 +1,67 @@
+/**
+ * Filesystem autocomplete for project path creation.
+ *
+ * When a user types a partial path in the New Project form, the browser
+ * sends `GET /api/paths/autocomplete?prefix=<partial>`. This handler
+ * expands the prefix (tilde → $HOME, relative → absolute), lists the
+ * containing directory, and returns up to 10 directory suggestions whose
+ * basenames start with the typed partial segment.
+ *
+ * Dotfiles are excluded — they are rarely intentional project roots.
+ * Symlinks to directories ARE included (readdirSync with withFileTypes
+ * returns true for both real dirs and symlink dirs).
+ *
+ * Thread-safety: synchronous, called from the relay-dispatcher hot path.
+ * fs ops block the event loop for microseconds on local SSDs; the form
+ * is typed by a single human, so this is perfectly fine.
+ */
+import { readdirSync } from "node:fs";
+import { join, sep } from "node:path";
+import { expandPath } from "../paths.js";
+/**
+ * List directories inside `expandedPrefix`'s parent that start with the
+ * trailing (post-separator) segment of the expanded prefix.
+ *
+ * Examples (assume $HOME=/Users/alice, dirs are `projects`, `proj-old`,
+ * `Documents`, `.config`):
+ *   prefix="~/pro"  → expanded="/Users/alice/pro", parent="/Users/alice/"
+ *                      → ["/Users/alice/projects", "/Users/alice/proj-old"]
+ *   prefix="~/proj" → expanded="/Users/alice/proj"
+ *                      → ["/Users/alice/projects"]
+ *   prefix="~"      → expanded="/Users/alice", parent="/Users/alice/"
+ *                      → all top-level dirs in $HOME (except dotfiles)
+ */
+export function handlePathAutocomplete(prefix) {
+    const expanded = expandPath(prefix);
+    // Split into parent directory and basename prefix.
+    // On POSIX, `expanded` is always absolute after expandPath, so we
+    // always hit the else branch below with a trailing sep.
+    const lastSep = expanded.lastIndexOf(sep);
+    let parentDir;
+    let basenamePrefix;
+    if (lastSep < 0) {
+        // Shouldn't happen after expandPath, but be defensive.
+        parentDir = expanded;
+        basenamePrefix = "";
+    }
+    else {
+        parentDir = expanded.slice(0, lastSep + 1);
+        basenamePrefix = expanded.slice(lastSep + 1);
+    }
+    let suggestions = [];
+    try {
+        const entries = readdirSync(parentDir, { withFileTypes: true });
+        suggestions = entries
+            .filter((e) => e.isDirectory() &&
+            e.name.startsWith(basenamePrefix) &&
+            !e.name.startsWith("."))
+            .map((e) => join(parentDir, e.name))
+            .slice(0, 10); // keep the list short for the UI
+    }
+    catch {
+        // Directory doesn't exist or is unreadable → return empty list.
+        // The caller (dispatcher) returns a 200 with an empty suggestions[]
+        // so the UI can show a "no matching directories" hint.
+    }
+    return { suggestions, expandedPrefix: expanded };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Always-on coding agent for Aexol — branded pi wrapper with relay-based browser access.",
   "type": "module",
   "private": false,