toolcraft 0.0.68 → 0.0.70

package/dist/cli.js

@@ -3328,11 +3328,21 @@ function findUnknownCommanderCommand(program, argv) {
                 commandPath: pathSegments.join(" ")
             };
         }
-        if (current.commands.length === 0 || getDefaultCommanderCommandName(current) !== undefined) {
+        if (current.commands.length === 0) {
             return undefined;
         }
         const child = current.commands.find((command) => command.name() === token || command.aliases().includes(token));
         if (child === undefined) {
+            if (getDefaultCommanderCommandName(current) !== undefined) {
+                if (shouldRejectDefaultCommandToken(current, token, pathSegments)) {
+                    return {
+                        input: token,
+                        currentCommand: current,
+                        commandPath: pathSegments.join(" ")
+                    };
+                }
+                return undefined;
+            }
             return {
                 input: token,
                 currentCommand: current,
@@ -3344,6 +3354,38 @@ function findUnknownCommanderCommand(program, argv) {
     }
     return undefined;
 }
+function shouldRejectDefaultCommandToken(command, token, pathSegments) {
+    return (pathSegments.length === 0 &&
+        isBareCommandLikeToken(token) &&
+        hasNonDefaultPublicChildCommand(command));
+}
+function hasNonDefaultPublicChildCommand(command) {
+    const defaultName = getDefaultCommanderCommandName(command);
+    return command.commands.some((child) => child.name() !== defaultName &&
+        !isToolcraftHiddenCommander(child) &&
+        !getToolcraftReservedChildNames(command).includes(child.name()));
+}
+function isBareCommandLikeToken(token) {
+    if (token.length === 0) {
+        return false;
+    }
+    for (const character of token) {
+        if (!isCommandNameCharacter(character)) {
+            return false;
+        }
+    }
+    return true;
+}
+function isCommandNameCharacter(character) {
+    const code = character.codePointAt(0);
+    if (code === undefined) {
+        return false;
+    }
+    const isLowercaseLetter = code >= 97 && code <= 122;
+    const isUppercaseLetter = code >= 65 && code <= 90;
+    const isDigit = code >= 48 && code <= 57;
+    return isLowercaseLetter || isUppercaseLetter || isDigit || character === "-" || character === "_";
+}
 function getDefaultCommanderCommandName(command) {
     const candidate = command;
     return typeof candidate._defaultCommandName === "string"

package/node_modules/toolcraft-design/dist/explorer/two-pane.d.ts

@@ -37,6 +37,11 @@ export interface TwoPaneExplorerConfig<R> {
     panes: [TwoPaneDefinition, TwoPaneDefinition];
     actions: TwoPaneAction<R>[];
     refresh?: () => void | Promise<void>;
+    trace?: (record: TwoPaneTraceRecord) => void | Promise<void>;
+}
+export interface TwoPaneTraceRecord {
+    event: string;
+    [key: string]: unknown;
 }
 export interface TwoPanePaneState {
     id: string;
@@ -75,6 +80,8 @@ export declare class TwoPaneExplorerRuntime<R> {
     constructor(config: TwoPaneExplorerConfig<R>, driver: TerminalDriver);
     run(): Promise<R | null>;
     private startTerminal;
+    private subscribeKeypress;
+    private pauseKeypress;
     private loadRows;
     private refresh;
     private dispatchKey;
@@ -90,5 +97,6 @@ export declare class TwoPaneExplorerRuntime<R> {
     private render;
     private exit;
     private fail;
+    private trace;
 }
 export declare function renderTwoPaneExplorer<R>(state: TwoPaneExplorerState, actions: TwoPaneAction<R>[], screen: ScreenBuffer): void;

package/node_modules/toolcraft-design/dist/explorer/two-pane.js

@@ -51,14 +51,21 @@ export class TwoPaneExplorerRuntime {
         this.driver.enterAltScreen();
         this.driver.disableLineWrap();
         this.driver.hideCursor();
-        this.unsubscribeKeypress = this.driver.onKeypress((key) => {
-            this.dispatchKey(key);
-        });
+        this.subscribeKeypress();
         this.unsubscribeResize = this.driver.onResize(() => {
             this.state = { ...this.state, size: normalizeSize(this.driver.getSize()) };
             this.render();
         });
     }
+    subscribeKeypress() {
+        this.unsubscribeKeypress = this.driver.onKeypress((key) => {
+            this.dispatchKey(key);
+        });
+    }
+    pauseKeypress() {
+        this.unsubscribeKeypress?.();
+        this.unsubscribeKeypress = undefined;
+    }
     async loadRows(requestToken = ++this.rowsRequestToken) {
         const [leftRows, rightRows] = await Promise.all([
             this.config.panes[0].rows(),
@@ -84,6 +91,14 @@ export class TwoPaneExplorerRuntime {
         if (this.stopped) {
             return;
         }
+        this.trace("key", {
+            key: traceKey(key),
+            filterFocused: this.state.filterFocused,
+            pane: this.activePane().id,
+            cursor: this.activePane().cursor,
+            selected: this.activePane().selected.size,
+            filter: this.activePane().filter
+        });
         if (this.state.filterFocused) {
             this.dispatchFilterKey(key);
             return;
@@ -92,7 +107,7 @@ export class TwoPaneExplorerRuntime {
             this.exit(null);
             return;
         }
-        if (key.name === "tab") {
+        if (isTabKey(key)) {
             this.state = {
                 ...this.state,
                 activePaneIndex: this.state.activePaneIndex === 0 ? 1 : 0
@@ -112,7 +127,7 @@ export class TwoPaneExplorerRuntime {
             this.setCursor(filteredRows(this.activePane()).length - 1);
             return;
         }
-        if (key.ch === " ") {
+        if (key.ch === " " || key.name === "space") {
             this.toggleSelection();
             return;
         }
@@ -131,8 +146,14 @@ export class TwoPaneExplorerRuntime {
         }
     }
     dispatchFilterKey(key) {
-        if (key.name === "escape" || key.name === "return") {
+        if (key.name === "escape" || key.name === "return" || key.name === "enter") {
             this.state = { ...this.state, filterFocused: false };
+            this.trace("filter.submit", {
+                key: traceKey(key),
+                pane: this.activePane().id,
+                filter: this.activePane().filter,
+                rows: filteredRows(this.activePane()).length
+            });
             this.render();
             return;
         }
@@ -145,6 +166,12 @@ export class TwoPaneExplorerRuntime {
                     cursor: 0
                 }))
             };
+            this.trace("filter.update", {
+                key: traceKey(key),
+                pane: this.activePane().id,
+                filter: this.activePane().filter,
+                rows: filteredRows(this.activePane()).length
+            });
             this.render();
             return;
         }
@@ -157,6 +184,12 @@ export class TwoPaneExplorerRuntime {
                     cursor: 0
                 }))
             };
+            this.trace("filter.update", {
+                key: traceKey(key),
+                pane: this.activePane().id,
+                filter: this.activePane().filter,
+                rows: filteredRows(this.activePane()).length
+            });
             this.render();
         }
     }
@@ -195,6 +228,14 @@ export class TwoPaneExplorerRuntime {
             ...this.state,
             panes: updateActivePane(this.state, (candidate) => ({ ...candidate, selected }))
         };
+        this.trace("selection.toggle", {
+            pane: pane.id,
+            row: row.id,
+            selected: selected.size,
+            checked: selected.has(row.id),
+            filter: pane.filter,
+            cursor: pane.cursor
+        });
         this.render();
     }
     runAction(action) {
@@ -223,6 +264,7 @@ export class TwoPaneExplorerRuntime {
         });
     }
     async suspendAnd(fn) {
+        this.pauseKeypress();
         this.driver.exitAltScreen();
         this.driver.enableLineWrap();
         this.driver.showCursor();
@@ -236,6 +278,7 @@ export class TwoPaneExplorerRuntime {
                 this.driver.enterAltScreen();
                 this.driver.disableLineWrap();
                 this.driver.hideCursor();
+                this.subscribeKeypress();
                 this.state = { ...this.state, size: normalizeSize(this.driver.getSize()) };
                 this.render();
             }
@@ -290,6 +333,15 @@ export class TwoPaneExplorerRuntime {
         }
         this.settle?.reject(error);
     }
+    trace(event, fields = {}) {
+        const trace = this.config.trace;
+        if (trace === undefined) {
+            return;
+        }
+        void Promise.resolve(trace({ event, ...fields })).catch(() => {
+            // Diagnostic tracing must not interfere with TUI input handling.
+        });
+    }
 }
 export function renderTwoPaneExplorer(state, actions, screen) {
     screen.clear();
@@ -402,9 +454,21 @@ function actionMatchesKey(action, key) {
     const keys = Array.isArray(action.key) ? action.key : [action.key];
     return keys.some((candidate) => key.ch === candidate || key.name === candidate);
 }
+function isTabKey(key) {
+    return key.name === "tab" || key.ch === "\t" || (key.name === "i" && key.ctrl);
+}
 function firstKey(key) {
     return Array.isArray(key) ? key[0] ?? "" : key;
 }
+function traceKey(key) {
+    return {
+        name: key.name,
+        ch: key.ch,
+        ctrl: key.ctrl,
+        meta: key.meta,
+        shift: key.shift
+    };
+}
 function isQuitKey(key) {
     return key.ch === "q" || (key.name === "c" && key.ctrl);
 }

package/node_modules/toolcraft-design/dist/prompts/interactive/glyphs.d.ts

@@ -10,9 +10,9 @@ export declare const GLYPHS: {
     readonly barEnd: string;
     readonly radioActive: string;
     readonly radioInactive: string;
-    readonly checkboxActive: string;
-    readonly checkboxSelected: string;
-    readonly checkboxInactive: string;
+    readonly checkboxActive: "[ ]";
+    readonly checkboxSelected: "[x]";
+    readonly checkboxInactive: "[ ]";
     readonly passwordMask: string;
     readonly ellipsis: "...";
 };

package/node_modules/toolcraft-design/dist/prompts/interactive/glyphs.js

@@ -27,9 +27,9 @@ export const GLYPHS = {
     barEnd: glyph("└", "-"),
     radioActive: glyph("●", ">"),
     radioInactive: glyph("○", " "),
-    checkboxActive: glyph("◻", "[ ]"),
-    checkboxSelected: glyph("◼", "[+]"),
-    checkboxInactive: glyph("◻", "[ ]"),
+    checkboxActive: "[ ]",
+    checkboxSelected: "[x]",
+    checkboxInactive: "[ ]",
     passwordMask: glyph("•", "*"),
     ellipsis: "..."
 };

package/node_modules/toolcraft-design/dist/prompts/interactive/keys.js

@@ -21,6 +21,9 @@ export function mapKey(name, char) {
     if (char === " ") {
         return "space";
     }
+    if (char !== undefined && aliases[char] !== undefined) {
+        return aliases[char];
+    }
     if (!name) {
         return undefined;
     }

package/node_modules/toolcraft-design/dist/prompts/interactive/multiselect.js

@@ -102,10 +102,14 @@ function renderOption(option, values, active, submitted, cancelled) {
 }
 function renderMultiselectPrompt(prompt, opts) {
     if (prompt.state === "submit" || prompt.state === "cancel") {
-        const labels = prompt.visibleOptions
-            .filter((option) => hasValue(prompt.value, option.value))
-            .map((option) => prompt.state === "submit" ? color.dim(option.label) : color.dim.strikethrough(option.label))
-            .join(", ");
+        const selectedOptions = prompt.visibleOptions.filter((option) => hasValue(prompt.value, option.value));
+        const labels = selectedOptions.length > 3
+            ? prompt.state === "submit"
+                ? color.dim(`${selectedOptions.length} selected`)
+                : color.dim.strikethrough(`${selectedOptions.length} selected`)
+            : selectedOptions
+                .map((option) => prompt.state === "submit" ? color.dim(option.label) : color.dim.strikethrough(option.label))
+                .join(", ");
         const end = prompt.state === "submit" ? color.green(GLYPHS.barEnd) : color.red(GLYPHS.barEnd);
         return `${color.gray(GLYPHS.barStart)} ${symbol(prompt.state)} ${opts.message}\n${color.gray(GLYPHS.bar)}  ${labels}\n${end}`;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.68",
+  "version": "0.0.70",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,8 +47,8 @@
     "postpack": "node ../../scripts/manage-bundled-workspace-deps.mjs cleanup . toolcraft-design @poe-code/frontmatter @poe-code/agent-mcp-config @poe-code/agent-human-in-loop @poe-code/task-list @poe-code/agent-defs @poe-code/config-mutations @poe-code/process-runner tiny-mcp-client mcp-oauth auth-store"
   },
   "dependencies": {
-    "toolcraft-schema": "0.0.68",
-    "commander": "^14.0.3",
+    "toolcraft-schema": "0.0.70",
+    "commander": "^13.1.0",
     "fast-string-width": "^3.0.2",
     "fast-wrap-ansi": "^0.2.0",
     "ignore": "^5.3.2",
@@ -63,7 +63,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=18.18"
   },
   "repository": {
     "type": "git",