@polterware/polter 0.2.1 → 0.2.2

package/dist/api.js

@@ -20,7 +20,7 @@ import {
   runCommand,
   savePipeline,
   toolFlags
-} from "./chunk-3XNNC5AW.js";
+} from "./chunk-2MXXRP4H.js";
 export {
   allCommands,
   applyActions,

package/dist/{chunk-3XNNC5AW.js → chunk-2MXXRP4H.js}

@@ -131,7 +131,15 @@ var supabaseCommands = [
     tool: "supabase",
     base: ["link"],
     label: "link",
-    hint: "Link to remote project"
+    hint: "Link to remote project",
+    suggestedArgs: [
+      {
+        value: "project-ref",
+        label: "--project-ref <ref>",
+        hint: "Link with project ref",
+        args: ["--project-ref"]
+      }
+    ]
   },
   {
     id: "supabase:unlink",
@@ -863,7 +871,7 @@ function getFlagsForTool(toolId) {
 }
 
 // src/lib/runner.ts
-import { spawn } from "child_process";
+import { spawn, spawnSync } from "child_process";
 import { existsSync } from "fs";
 import { delimiter, dirname, join, resolve } from "path";
 function getSupabaseBinaryCandidates() {
@@ -953,6 +961,22 @@ async function runCommand(execution, args, cwd = process.cwd(), options) {
     });
   });
 }
+function runInteractiveCommand(execution, args, cwd = process.cwd()) {
+  const resolved = typeof execution === "string" ? { command: execution } : execution;
+  const result = spawnSync(resolved.command, args, {
+    cwd,
+    env: resolved.env,
+    shell: true,
+    stdio: "inherit"
+  });
+  return {
+    exitCode: result.status,
+    signal: result.signal,
+    stdout: "",
+    stderr: "",
+    spawnError: result.error?.message
+  };
+}
 async function runSupabaseCommand(args, cwd = process.cwd()) {
   return runCommand(resolveSupabaseCommand(cwd), args, cwd);
 }
@@ -1451,6 +1475,7 @@ export {
   toolFlags,
   getFlagsForTool,
   runCommand,
+  runInteractiveCommand,
   runSupabaseCommand,
   commandExists,
   resolveToolCommand,

package/dist/index.js

@@ -21,10 +21,11 @@ import {
   planChanges,
   resolveToolCommand,
   runCommand,
+  runInteractiveCommand,
   runSupabaseCommand,
   savePipeline,
   writeProjectConfig
-} from "./chunk-3XNNC5AW.js";
+} from "./chunk-2MXXRP4H.js";
 
 // src/index.tsx
 import React20 from "react";
@@ -1486,7 +1487,7 @@ function FlagSelection({
 }
 
 // src/screens/CommandExecution.tsx
-import { useState as useState11, useEffect as useEffect5 } from "react";
+import { useState as useState11, useEffect as useEffect6 } from "react";
 import { Box as Box13, Text as Text17 } from "ink";
 
 // src/components/Spinner.tsx
@@ -1668,6 +1669,56 @@ function useCommand(execution = "supabase", cwd = process.cwd(), options) {
   return { status, result, run, reset };
 }
 
+// src/hooks/useInteractiveRun.ts
+import { useCallback as useCallback3 } from "react";
+import { useStdin } from "ink";
+
+// src/hooks/useFullscreen.ts
+import { useEffect as useEffect5 } from "react";
+var ENTER_ALT_SCREEN = "\x1B[?1049h";
+var LEAVE_ALT_SCREEN = "\x1B[?1049l";
+var HIDE_CURSOR = "\x1B[?25l";
+var SHOW_CURSOR = "\x1B[?25h";
+function useFullscreen() {
+  useEffect5(() => {
+    process.stdout.write(ENTER_ALT_SCREEN + HIDE_CURSOR);
+    return () => {
+      process.stdout.write(SHOW_CURSOR + LEAVE_ALT_SCREEN);
+    };
+  }, []);
+}
+
+// src/hooks/useInteractiveRun.ts
+function useInteractiveRun() {
+  const { setRawMode } = useStdin();
+  const runInteractive = useCallback3(
+    (tool, args, cwd) => {
+      process.stdout.write(SHOW_CURSOR + LEAVE_ALT_SCREEN);
+      setRawMode(false);
+      process.stdout.write(`
+  Running: ${tool} ${args.join(" ")}
+
+`);
+      const resolved = resolveToolCommand(tool, cwd);
+      const result = runInteractiveCommand(
+        { command: resolved.command, env: resolved.env },
+        args,
+        cwd
+      );
+      process.stdout.write(
+        `
+  Command exited (code ${result.exitCode ?? "?"}). Returning to Polter...
+`
+      );
+      setRawMode(true);
+      process.stdout.write(ENTER_ALT_SCREEN + HIDE_CURSOR);
+      return result;
+    },
+    [setRawMode]
+  );
+  return { runInteractive };
+}
+
 // src/lib/clipboard.ts
 import { spawn, exec } from "child_process";
 async function copyToClipboard(text) {
@@ -1746,14 +1797,15 @@ function CommandExecution({
   const { status, result, run, reset } = useCommand(tool, process.cwd(), {
     quiet: panelMode
   });
+  const { runInteractive } = useInteractiveRun();
   const cmdDisplay = `${tool} ${currentArgs.join(" ")}`;
   const runCommand2 = currentArgs.join(" ");
-  useEffect5(() => {
+  useEffect6(() => {
     if (phase === "running" && status === "idle") {
       run(currentArgs);
     }
   }, [phase, status, run, currentArgs]);
-  useEffect5(() => {
+  useEffect6(() => {
     if (phase === "running" && status === "success") {
       if (isPinnedRun(runCommand2)) {
         setPhase("success");
@@ -1916,6 +1968,13 @@ function CommandExecution({
       });
     }
   }
+  if (panelMode && !result?.spawnError) {
+    errorItems.push({
+      value: "run-interactive",
+      label: "\u{1F4BB} Run in terminal",
+      hint: "Suspend TUI and run interactively"
+    });
+  }
   errorItems.push({
     value: "copy",
     label: "\u{1F4CB} Copy command to clipboard"
@@ -1967,7 +2026,7 @@ function CommandExecution({
       {
         stdout: result?.stdout,
         stderr: result?.stderr,
-        height: Math.max(3, height - 16 - (suggestions.length > 0 ? suggestions.length + 4 : 0)),
+        height: Math.max(3, height - 13 - errorItems.length - (suggestions.length > 0 ? suggestions.length + 4 : 0)),
         isActive: false
       }
     ),
@@ -2006,6 +2065,13 @@ function CommandExecution({
               setPhase("running");
               break;
             }
+            case "run-interactive": {
+              const interactiveResult = runInteractive(tool, currentArgs);
+              if (!interactiveResult.spawnError && interactiveResult.exitCode === 0) {
+                setPhase("success");
+              }
+              break;
+            }
             case "copy":
               await copyToClipboard(cmdDisplay);
               break;
@@ -2031,7 +2097,7 @@ function CommandExecution({
 }
 
 // src/screens/SelfUpdate.tsx
-import { useEffect as useEffect6, useState as useState12 } from "react";
+import { useEffect as useEffect7, useState as useState12 } from "react";
 import { Box as Box14, Text as Text18 } from "ink";
 import { jsx as jsx18, jsxs as jsxs16 } from "react/jsx-runtime";
 var packageName = "@polterware/polter";
@@ -2061,12 +2127,12 @@ function SelfUpdate({
   const { status, result, run, reset } = useCommand("npm", updateCwd, {
     quiet: panelMode
   });
-  useEffect6(() => {
+  useEffect7(() => {
     if (phase === "running" && status === "idle") {
       run(updateArgs);
     }
   }, [phase, run, status, updateArgs]);
-  useEffect6(() => {
+  useEffect7(() => {
     if (phase === "running" && status === "success") {
       setPhase("success");
     }
@@ -2365,8 +2431,8 @@ import { useMemo as useMemo5, useState as useState14 } from "react";
 import { Box as Box16, Text as Text20 } from "ink";
 
 // src/hooks/useEditor.ts
-import { useState as useState13, useCallback as useCallback3 } from "react";
-import { useStdin } from "ink";
+import { useState as useState13, useCallback as useCallback4 } from "react";
+import { useStdin as useStdin2 } from "ink";
 
 // src/lib/editor.ts
 import { spawnSync, spawn as spawn2 } from "child_process";
@@ -2415,9 +2481,9 @@ function openInEditor(filePath) {
 
 // src/hooks/useEditor.ts
 function useEditor() {
-  const { setRawMode } = useStdin();
+  const { setRawMode } = useStdin2();
   const [isEditing, setIsEditing] = useState13(false);
-  const openEditor = useCallback3(async (filePath) => {
+  const openEditor = useCallback4(async (filePath) => {
     const editor = resolveEditor();
     const terminal = isTerminalEditor(editor.command);
     setIsEditing(true);
@@ -2956,7 +3022,7 @@ function PipelineBuilder({
 }
 
 // src/screens/PipelineExecution.tsx
-import { useState as useState16, useEffect as useEffect7, useMemo as useMemo7 } from "react";
+import { useState as useState16, useEffect as useEffect8, useMemo as useMemo7 } from "react";
 import { Box as Box21, Text as Text25 } from "ink";
 
 // src/components/StepIndicator.tsx
@@ -3052,7 +3118,7 @@ function PipelineExecution({
   const [phase, setPhase] = useState16("running");
   const [progress, setProgress] = useState16(null);
   const [results, setResults] = useState16([]);
-  useEffect7(() => {
+  useEffect8(() => {
     if (!pipeline) return;
     executePipeline(pipeline, (p) => {
       setProgress({ ...p });
@@ -3259,23 +3325,8 @@ function AppClassic() {
 import React19 from "react";
 import { Box as Box30, Text as Text33, useApp as useApp2, useInput as useInput9 } from "ink";
 
-// src/hooks/useFullscreen.ts
-import { useEffect as useEffect8 } from "react";
-var ENTER_ALT_SCREEN = "\x1B[?1049h";
-var LEAVE_ALT_SCREEN = "\x1B[?1049l";
-var HIDE_CURSOR = "\x1B[?25l";
-var SHOW_CURSOR = "\x1B[?25h";
-function useFullscreen() {
-  useEffect8(() => {
-    process.stdout.write(ENTER_ALT_SCREEN + HIDE_CURSOR);
-    return () => {
-      process.stdout.write(SHOW_CURSOR + LEAVE_ALT_SCREEN);
-    };
-  }, []);
-}
-
 // src/hooks/usePanelNavigation.ts
-import { useState as useState17, useCallback as useCallback4 } from "react";
+import { useState as useState17, useCallback as useCallback5 } from "react";
 function usePanelNavigation() {
   const [state, setState] = useState17({
     view: "pipelines",
@@ -3284,7 +3335,7 @@ function usePanelNavigation() {
     innerParams: {},
     innerStack: []
   });
-  const selectSidebarItem = useCallback4((itemId) => {
+  const selectSidebarItem = useCallback5((itemId) => {
     const featureIds = [
       "database",
       "functions",
@@ -3325,7 +3376,7 @@ function usePanelNavigation() {
       });
     }
   }, [state.featureId]);
-  const navigateInner = useCallback4((screen, params) => {
+  const navigateInner = useCallback5((screen, params) => {
     setState((prev) => ({
       ...prev,
       innerStack: [...prev.innerStack, { screen: prev.innerScreen, params: prev.innerParams }],
@@ -3333,7 +3384,7 @@ function usePanelNavigation() {
       innerParams: params ?? {}
     }));
   }, []);
-  const goBackInner = useCallback4(() => {
+  const goBackInner = useCallback5(() => {
     setState((prev) => {
       if (prev.innerStack.length === 0) {
         return { ...prev, innerScreen: "home", innerParams: {} };
@@ -3348,7 +3399,7 @@ function usePanelNavigation() {
       };
     });
   }, []);
-  const goHomeInner = useCallback4(() => {
+  const goHomeInner = useCallback5(() => {
     setState((prev) => ({
       ...prev,
       innerScreen: "home",
@@ -3356,7 +3407,7 @@ function usePanelNavigation() {
       innerStack: []
     }));
   }, []);
-  const switchViewAndNavigate = useCallback4(
+  const switchViewAndNavigate = useCallback5(
     (view, screen, params) => {
       setState((prev) => ({
         ...prev,
@@ -3379,14 +3430,14 @@ function usePanelNavigation() {
 }
 
 // src/hooks/usePanelFocus.ts
-import { useState as useState18, useCallback as useCallback5 } from "react";
+import { useState as useState18, useCallback as useCallback6 } from "react";
 function usePanelFocus() {
   const [focused, setFocused] = useState18("sidebar");
-  const toggleFocus = useCallback5(() => {
+  const toggleFocus = useCallback6(() => {
     setFocused((prev) => prev === "sidebar" ? "main" : "sidebar");
   }, []);
-  const focusSidebar = useCallback5(() => setFocused("sidebar"), []);
-  const focusMain = useCallback5(() => setFocused("main"), []);
+  const focusSidebar = useCallback6(() => setFocused("sidebar"), []);
+  const focusMain = useCallback6(() => setFocused("main"), []);
   return {
     focused,
     isSidebarFocused: focused === "sidebar",
@@ -3425,13 +3476,13 @@ function useSidebarItems() {
 }
 
 // src/hooks/useModal.ts
-import { useState as useState19, useCallback as useCallback6 } from "react";
+import { useState as useState19, useCallback as useCallback7 } from "react";
 function useModal() {
   const [state, setState] = useState19(null);
-  const openModal = useCallback6((content, title) => {
+  const openModal = useCallback7((content, title) => {
     setState({ content, title });
   }, []);
-  const closeModal = useCallback6(() => {
+  const closeModal = useCallback7(() => {
     setState(null);
   }, []);
   return {

package/dist/mcp.js

@@ -17,7 +17,7 @@ import {
   resolveToolCommand,
   runCommand,
   savePipeline
-} from "./chunk-3XNNC5AW.js";
+} from "./chunk-2MXXRP4H.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polterware/polter",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "An interactive CLI for managing Supabase CLI workflows.",
   "type": "module",
   "bin": {