@polterware/polter 0.4.2 → 0.5.0

package/README.md

@@ -21,7 +21,6 @@ Polter is a productivity layer on top of the official `supabase` CLI. Instead of
 - **Built-in Self-Update**: Update Polter for the current repository or globally through npm
 - **Shell Execution**: Resolves `supabase` from the current repository first, then falls back to `PATH`
 - **TypeScript-based CLI**: Strongly typed internal implementation
-- **App Workflows**: Explicit `polter app ...` flows for repository-aware setup, linking, migrations, runtime configuration, and app installation
 
 ---
 
@@ -103,45 +102,6 @@ Install Supabase CLI (official docs):
 
 ## Quick Reference
 
-### App Workflows
-
-Polter keeps generic Supabase execution separate from app-specific automation.
-Use the `app` namespace when you want project-aware workflows:
-
-```bash
-polter app setup ops --path .
-```
-
-```bash
-polter app link ops --path .
-```
-
-```bash
-polter app migrate ops push --path .
-```
-
-```bash
-polter app configure ops --path .
-```
-
-```bash
-polter app install ops
-```
-
-```bash
-polter app update ops
-```
-
-`setup ops` installs dependencies, collects Supabase connection data, links the project, pushes migrations, and writes the runtime bootstrap payload used by the desktop app.
-
-`configure ops` refreshes the runtime connection payload without reinstalling the app.
-
-`install ops` is currently macOS-only. By default it resolves the latest GitHub release from `polterware/ops`, accepts `--version <version>` to pin a release, and still supports `--artifact-url` or `POLTER_OPS_MACOS_ARTIFACT_URL` as manual overrides.
-
-`update ops` is also macOS-only. It replaces the installed `ops.app` with a newer release while preserving the persisted runtime configuration, local settings, and Supabase session state stored outside the app bundle.
-
-Use `POLTER_OPS_GITHUB_REPO=owner/repo` when you need to resolve releases from a fork or a different repository.
-
 ### Execution Model
 
 Polter executes workflow commands as:
@@ -260,36 +220,6 @@ Pins are persisted locally using OS-level app config storage.
 
 ## Usage Examples
 
-### Bootstrap Ops from source
-
-```bash
-polter app setup ops --path /absolute/path/to/ops
-```
-
-### Reconfigure an installed Ops app
-
-```bash
-polter app configure ops
-```
-
-### Install the latest released Ops app
-
-```bash
-polter app install ops
-```
-
-Install a specific release:
-
-```bash
-polter app install ops --version 1.0.0
-```
-
-Update an existing installation without re-running runtime configuration:
-
-```bash
-polter app update ops
-```
-
 ### Check Supabase CLI version
 
 Interactive path:

package/dist/api.js

@@ -1,51 +1,82 @@
 import {
   createIpcClient
-} from "./chunk-XCCKD3RZ.js";
+} from "./chunk-GCS7JEYU.js";
 import {
-  allCommands,
-  applyActions,
-  createIpcServer,
-  deletePipeline,
-  detectPkgManager,
-  executePipeline,
   features,
+  getFeatureById,
+  getFlagsForTool,
+  toolFlags
+} from "./chunk-AK3NTS3Y.js";
+import {
+  getSkillContent,
+  getSkillPath,
+  setupSkill,
+  setupSkillCli
+} from "./chunk-XNRIN3VM.js";
+import {
+  deletePipeline,
   findPipelineByName,
+  getAllPipelines,
+  savePipeline
+} from "./chunk-U64WZOJ3.js";
+import "./chunk-BIN7BDA2.js";
+import "./chunk-GKROVUDG.js";
+import {
+  parsePolterYaml
+} from "./chunk-U6725U7K.js";
+import {
+  planChanges
+} from "./chunk-E2B5FFBU.js";
+import {
+  getCurrentStatus
+} from "./chunk-OKHPN6X7.js";
+import {
+  applyActions
+} from "./chunk-BGT5TT2A.js";
+import {
+  getMcpStatusInfo,
+  installMcpServerSilent,
+  removeMcpServerSilent
+} from "./chunk-45CQFZU7.js";
+import {
+  createIpcServer
+} from "./chunk-EAMHFQKU.js";
+import {
   findProcessesByCwd,
   findRunningByCommand,
   generateProcessId,
-  getAllPipelines,
-  getCommandById,
-  getCommandValue,
-  getCommandsByTool,
-  getCurrentStatus,
-  getFeatureById,
-  getFlagsForTool,
-  getMcpStatusInfo,
   getProcessOutput,
-  getSkillContent,
-  getSkillPath,
   getSocketPath,
-  getToolDisplayName,
-  getToolInfo,
-  installMcpServerSilent,
   isProcessRunning,
   listProcesses,
-  parsePolterYaml,
-  planChanges,
   registerForegroundProcess,
-  removeMcpServerSilent,
   removeProcess,
+  startProcess,
+  stopProcess
+} from "./chunk-6IBRTRLX.js";
+import "./chunk-ZU5VZHYD.js";
+import {
+  executePipeline
+} from "./chunk-JQB2A3CA.js";
+import {
+  allCommands,
+  getCommandById,
+  getCommandValue,
+  getCommandsByTool
+} from "./chunk-GVIKF6UI.js";
+import {
+  detectPkgManager,
+  getToolDisplayName,
+  getToolInfo,
   resolvePkgArgs,
   resolveToolCommand,
   runCommand,
-  savePipeline,
-  setupSkill,
-  setupSkillCli,
-  startProcess,
-  stopProcess,
-  toolFlags,
+  runCommandWithRetry,
   translateCommand
-} from "./chunk-CWBIXRZP.js";
+} from "./chunk-ELSIHPJL.js";
+import "./chunk-RVMOIUSL.js";
+import "./chunk-TD6YNU6L.js";
+import "./chunk-3RG5ZIWI.js";
 export {
   allCommands,
   applyActions,
@@ -84,6 +115,7 @@ export {
   resolvePkgArgs,
   resolveToolCommand,
   runCommand,
+  runCommandWithRetry,
   savePipeline,
   setupSkill,
   setupSkillCli,

package/dist/app-HGIGWI7F.js

@@ -0,0 +1,393 @@
+import {
+  CommandArgs,
+  CommandExecution,
+  CustomCommand,
+  DeclarativePlan,
+  DeclarativeStatus,
+  FlagSelection,
+  GhostBanner,
+  InitScaffold,
+  McpManage,
+  PipelineBuilder,
+  PipelineExecution,
+  PipelineList,
+  ProcessList,
+  ProcessLogs,
+  ProjectConfig,
+  ScriptPicker,
+  SelectList,
+  SelfUpdate,
+  SkillSetup,
+  StatusBar,
+  ToolStatus,
+  buildHomeItems,
+  colors,
+  getFeatures,
+  getPinnedCommands,
+  getPinnedRuns,
+  inkColors,
+  togglePinnedCommand,
+  togglePinnedRun,
+  useTerminalDimensions
+} from "./chunk-57CZSEY5.js";
+import "./chunk-KEGROLGX.js";
+import "./chunk-AK3NTS3Y.js";
+import "./chunk-XNRIN3VM.js";
+import "./chunk-U64WZOJ3.js";
+import "./chunk-BIN7BDA2.js";
+import "./chunk-GKROVUDG.js";
+import "./chunk-U6725U7K.js";
+import "./chunk-E2B5FFBU.js";
+import "./chunk-OKHPN6X7.js";
+import "./chunk-BGT5TT2A.js";
+import "./chunk-45CQFZU7.js";
+import "./chunk-6IBRTRLX.js";
+import "./chunk-ZU5VZHYD.js";
+import "./chunk-JQB2A3CA.js";
+import {
+  findCommandByValue
+} from "./chunk-GVIKF6UI.js";
+import "./chunk-ELSIHPJL.js";
+import "./chunk-RVMOIUSL.js";
+import "./chunk-TD6YNU6L.js";
+import "./chunk-3RG5ZIWI.js";
+
+// src/app.tsx
+import { Box as Box3, Text as Text3, useApp } from "ink";
+
+// src/hooks/useNavigation.ts
+import { useState, useCallback } from "react";
+function useNavigation() {
+  const [stack, setStack] = useState([
+    { screen: "home", params: {} }
+  ]);
+  const current = stack[stack.length - 1];
+  const navigate = useCallback((screen, params) => {
+    setStack((prev) => [...prev, { screen, params: params ?? {} }]);
+  }, []);
+  const goBack = useCallback(() => {
+    setStack((prev) => {
+      if (prev.length <= 1) return [{ screen: "home", params: {} }];
+      return prev.slice(0, -1);
+    });
+  }, []);
+  const goHome = useCallback(() => {
+    setStack([{ screen: "home", params: {} }]);
+  }, []);
+  return {
+    screen: current.screen,
+    params: current.params,
+    navigate,
+    goBack,
+    goHome
+  };
+}
+
+// src/hooks/useTerminalWidth.ts
+function useTerminalWidth() {
+  return useTerminalDimensions().width;
+}
+
+// src/hooks/useTerminalHeight.ts
+function useTerminalHeight() {
+  return useTerminalDimensions().height;
+}
+
+// src/screens/Home.tsx
+import { useEffect, useMemo, useState as useState2 } from "react";
+import { Box as Box2, Text as Text2, useInput } from "ink";
+import ms from "ms";
+
+// src/components/TabBar.tsx
+import { Box, Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+function TabBar({ tabs, activeIndex, width = 80 }) {
+  const narrow = width < 50;
+  const medium = width < 80;
+  return /* @__PURE__ */ jsx(Box, { gap: 1, children: tabs.map((tab, i) => {
+    const isActive = i === activeIndex;
+    const showLabel = narrow ? false : medium ? isActive : true;
+    const displayText = showLabel ? `${tab.icon} ${tab.label}` : tab.icon;
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx(
+        Text,
+        {
+          color: isActive ? inkColors.accent : void 0,
+          bold: isActive,
+          dimColor: !isActive,
+          children: displayText
+        }
+      ),
+      isActive && !narrow && /* @__PURE__ */ jsx(Text, { color: inkColors.accent, children: "\u2550".repeat(displayText.length) })
+    ] }, tab.id);
+  }) });
+}
+
+// src/screens/Home.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function Home({
+  onNavigate,
+  onExit,
+  width = 80,
+  height = 24
+}) {
+  const allFeatures = useMemo(() => getFeatures(), []);
+  const [activeTabIndex, setActiveTabIndex] = useState2(0);
+  const [pinnedCommands, setPinnedCommands] = useState2(
+    () => getPinnedCommands()
+  );
+  const [pinnedRuns, setPinnedRuns] = useState2(
+    () => getPinnedRuns()
+  );
+  const [pinFeedback, setPinFeedback] = useState2();
+  const activeFeature = allFeatures[activeTabIndex];
+  useEffect(() => {
+    if (!pinFeedback) return;
+    const timeout = setTimeout(() => setPinFeedback(void 0), ms("1.4s"));
+    return () => clearTimeout(timeout);
+  }, [pinFeedback]);
+  useInput((_input, key) => {
+    if (key.leftArrow && !key.meta) {
+      setActiveTabIndex(
+        (prev) => prev > 0 ? prev - 1 : allFeatures.length - 1
+      );
+    }
+    if (key.rightArrow && !key.meta) {
+      setActiveTabIndex(
+        (prev) => prev < allFeatures.length - 1 ? prev + 1 : 0
+      );
+    }
+    if (key.tab) {
+      setActiveTabIndex(
+        (prev) => prev < allFeatures.length - 1 ? prev + 1 : 0
+      );
+    }
+  });
+  const tabs = useMemo(
+    () => allFeatures.map((f) => ({ id: f.id, icon: f.icon, label: f.label })),
+    [allFeatures]
+  );
+  const items = useMemo(
+    () => buildHomeItems({
+      activeFeature,
+      pinnedCommands,
+      pinnedRuns
+    }),
+    [activeFeature, pinnedCommands, pinnedRuns]
+  );
+  const pinnedCommandSet = useMemo(
+    () => new Set(pinnedCommands),
+    [pinnedCommands]
+  );
+  const pinnedRunSet = useMemo(() => new Set(pinnedRuns), [pinnedRuns]);
+  const refreshPins = () => {
+    setPinnedCommands(getPinnedCommands());
+    setPinnedRuns(getPinnedRuns());
+  };
+  const handleSelect = (value, item) => {
+    if (!item) return;
+    if (item.kind === "command") {
+      const cmdDef = findCommandByValue(value);
+      if (cmdDef) {
+        onNavigate("command-args", {
+          command: value,
+          commandId: cmdDef.id,
+          tool: cmdDef.tool
+        });
+      } else {
+        onNavigate("command-args", { command: value, tool: "supabase" });
+      }
+      return;
+    }
+    if (item.kind === "run") {
+      const args = value.split(" ").filter(Boolean);
+      if (args.length > 0) {
+        const basePart = args[0] ?? "";
+        const cmdDef = findCommandByValue(basePart);
+        const tool = cmdDef?.tool ?? "supabase";
+        onNavigate("confirm-execute", { args, tool, interactive: cmdDef?.interactive });
+      }
+      return;
+    }
+    switch (value) {
+      case "__action_custom__":
+        onNavigate("custom-command");
+        break;
+      case "__action_pipelines__":
+        onNavigate("pipeline-list");
+        break;
+      case "__action_tools__":
+        onNavigate("tool-status");
+        break;
+      case "__action_config__":
+        onNavigate("project-config");
+        break;
+      case "__action_skill_setup__":
+        onNavigate("skill-setup");
+        break;
+      case "__action_update__":
+        onNavigate("self-update");
+        break;
+      case "__action_declarative_plan__":
+        onNavigate("declarative-plan");
+        break;
+      case "__action_declarative_status__":
+        onNavigate("declarative-status");
+        break;
+      case "__action_init_scaffold__":
+        onNavigate("init-scaffold");
+        break;
+      case "__action_exit__":
+        onExit();
+        break;
+    }
+  };
+  const handleRightAction = (item) => {
+    if (item.kind === "command") {
+      const wasPinned = pinnedCommandSet.has(item.value);
+      togglePinnedCommand(item.value);
+      refreshPins();
+      setPinFeedback(
+        wasPinned ? `Unpinned "${item.value}"` : `Pinned "${item.value}"`
+      );
+      return;
+    }
+    if (item.kind === "run") {
+      const wasPinned = pinnedRunSet.has(item.value);
+      togglePinnedRun(item.value);
+      refreshPins();
+      setPinFeedback(
+        wasPinned ? `Unpinned run "${item.value}"` : `Pinned run "${item.value}"`
+      );
+    }
+  };
+  return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx2(Box2, { marginBottom: 1, children: /* @__PURE__ */ jsx2(TabBar, { tabs, activeIndex: activeTabIndex, width }) }),
+    pinFeedback && /* @__PURE__ */ jsx2(Box2, { marginBottom: 1, children: /* @__PURE__ */ jsxs2(Text2, { color: inkColors.accent, children: [
+      "\u2713 ",
+      pinFeedback
+    ] }) }),
+    /* @__PURE__ */ jsx2(
+      SelectList,
+      {
+        items,
+        onSelect: handleSelect,
+        onRightAction: handleRightAction,
+        boxedSections: true,
+        width,
+        maxVisible: Math.max(8, height - 14)
+      }
+    ),
+    /* @__PURE__ */ jsx2(StatusBar, { hint: "\u2190\u2192 tab \xB7 \u2191\u2193 navigate \xB7 Enter select \xB7 p pin", width })
+  ] });
+}
+
+// src/app.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function AppClassic() {
+  const { screen, params, navigate, goBack, goHome } = useNavigation();
+  const { exit } = useApp();
+  const width = useTerminalWidth();
+  const height = useTerminalHeight();
+  const handleExit = () => {
+    process.stdout.write(
+      "\n" + colors.dim("Thank you for using ") + colors.primaryBold("Polter") + colors.dim("!") + "\n\n"
+    );
+    exit();
+  };
+  const renderScreen = () => {
+    switch (screen) {
+      case "home":
+        return /* @__PURE__ */ jsx3(Home, { onNavigate: navigate, onExit: handleExit, width, height });
+      case "command-args":
+        return /* @__PURE__ */ jsx3(
+          CommandArgs,
+          {
+            command: params.command ?? "",
+            tool: params.tool,
+            onNavigate: navigate,
+            onBack: goBack,
+            width
+          }
+        );
+      case "custom-command":
+        return /* @__PURE__ */ jsx3(CustomCommand, { onNavigate: navigate, onBack: goBack, width });
+      case "flag-selection":
+        return /* @__PURE__ */ jsx3(
+          FlagSelection,
+          {
+            args: params.args ?? [],
+            tool: params.tool,
+            onNavigate: navigate,
+            onBack: goBack,
+            width
+          }
+        );
+      case "confirm-execute":
+      case "command-execution":
+        return /* @__PURE__ */ jsx3(
+          CommandExecution,
+          {
+            args: params.args ?? [],
+            tool: params.tool,
+            rawCommand: params.rawCommand,
+            onBack: goBack,
+            onExit: handleExit,
+            onRunSuggestion: (sugTool, sugArgs) => {
+              goHome();
+              navigate("confirm-execute", { tool: sugTool, args: sugArgs });
+            },
+            width
+          }
+        );
+      case "self-update":
+        return /* @__PURE__ */ jsx3(SelfUpdate, { onBack: goBack, onExit: handleExit, width });
+      case "tool-status":
+        return /* @__PURE__ */ jsx3(ToolStatus, { onBack: goBack, onNavigate: navigate, width });
+      case "mcp-manage":
+        return /* @__PURE__ */ jsx3(McpManage, { onBack: goBack, width });
+      case "process-list":
+        return /* @__PURE__ */ jsx3(ProcessList, { onNavigate: navigate, onBack: goBack, width, height });
+      case "process-logs":
+        return /* @__PURE__ */ jsx3(ProcessLogs, { processId: params.processId ?? "", onBack: goBack, width, height });
+      case "project-config":
+        return /* @__PURE__ */ jsx3(ProjectConfig, { onBack: goBack, width });
+      case "pipeline-list":
+        return /* @__PURE__ */ jsx3(PipelineList, { onNavigate: navigate, onBack: goBack, width });
+      case "pipeline-builder":
+        return /* @__PURE__ */ jsx3(PipelineBuilder, { onBack: goBack, width, height });
+      case "pipeline-execution":
+        return /* @__PURE__ */ jsx3(
+          PipelineExecution,
+          {
+            pipelineId: params.pipelineId ?? "",
+            onBack: goBack,
+            onExit: handleExit,
+            width
+          }
+        );
+      case "declarative-plan":
+        return /* @__PURE__ */ jsx3(DeclarativePlan, { onBack: goBack, onNavigate: navigate, width, height });
+      case "declarative-status":
+        return /* @__PURE__ */ jsx3(DeclarativeStatus, { onBack: goBack, width, height });
+      case "init-scaffold":
+        return /* @__PURE__ */ jsx3(InitScaffold, { onBack: goBack, onNavigate: navigate, width, height });
+      case "script-picker":
+        return /* @__PURE__ */ jsx3(ScriptPicker, { onNavigate: navigate, onBack: goBack, width, height });
+      case "skill-setup":
+        return /* @__PURE__ */ jsx3(SkillSetup, { onBack: goBack, width, height });
+      default:
+        return /* @__PURE__ */ jsx3(Box3, { children: /* @__PURE__ */ jsxs3(Text3, { color: "red", children: [
+          "Unknown screen: ",
+          screen
+        ] }) });
+    }
+  };
+  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx3(GhostBanner, { width }),
+    renderScreen()
+  ] });
+}
+export {
+  AppClassic
+};