@gowelle/stint-agent 1.0.8 → 1.2.0

package/README.md

@@ -15,7 +15,13 @@ The official CLI agent for [Stint](https://stint.codes) — a lightweight daemon
 - 📦 Automatic commit execution
 - 🔍 Repository status syncing
 - 🖥️ Background daemon process
-- 📝 Comprehensive logging
+- 📝 Comprehensive logging and filtering
+- 📊 Interactive status dashboard
+- 🚀 Multiple release channels (stable/beta/nightly)
+- 🔍 Built-in environment diagnostics
+- 📈 Resource usage monitoring
+
+For detailed feature documentation, see the **[Features Guide](docs/features.md)**.
 
 ## Installation
 
@@ -49,47 +55,47 @@ stint daemon status
 
 ### General
 
-| Command | Description |
-|---------|-------------|
-| `stint --version`, `stint -V` | Show current agent version |
-| `stint --help`, `stint -h` | Show help information |
-| `stint update` | Update agent to the latest version |
+| Command                       | Description                        |
+| ----------------------------- | ---------------------------------- |
+| `stint --version`, `stint -V` | Show current agent version         |
+| `stint --help`, `stint -h`    | Show help information              |
+| `stint update`                | Update agent to the latest version |
 
 ### Authentication
 
-| Command | Description |
-|---------|-------------|
-| `stint login` | Authenticate with Stint (opens browser for OAuth) |
-| `stint logout` | Remove stored credentials |
-| `stint whoami` | Show current user and machine information |
+| Command        | Description                                       |
+| -------------- | ------------------------------------------------- |
+| `stint login`  | Authenticate with Stint (opens browser for OAuth) |
+| `stint logout` | Remove stored credentials                         |
+| `stint whoami` | Show current user and machine information         |
 
 ### Daemon Lifecycle
 
-| Command | Description |
-|---------|-------------|
-| `stint install` | Register daemon to run on system startup (Login required) |
-| `stint uninstall` | Remove daemon from system startup |
-| `stint daemon start` | Start background daemon manually |
-| `stint daemon stop` | Stop daemon gracefully |
-| `stint daemon status` | Check if daemon is running |
-| `stint daemon logs [--lines N]` | View daemon logs (default: 50 lines) |
-| `stint daemon restart` | Restart the daemon |
+| Command                         | Description                                               |
+| ------------------------------- | --------------------------------------------------------- |
+| `stint install`                 | Register daemon to run on system startup (Login required) |
+| `stint uninstall`               | Remove daemon from system startup                         |
+| `stint daemon start`            | Start background daemon manually                          |
+| `stint daemon stop`             | Stop daemon gracefully                                    |
+| `stint daemon status`           | Check if daemon is running                                |
+| `stint daemon logs [--lines N]` | View daemon logs (default: 50 lines)                      |
+| `stint daemon restart`          | Restart the daemon                                        |
 
 ### Project Management
 
-| Command | Description |
-|---------|-------------|
-| `stint link` | Link current directory to a Stint project (or create a new one) |
-| `stint unlink [--force]` | Remove project link |
-| `stint status` | Show project, git, auth, and daemon status |
-| `stint sync` | Manually sync repository information to server |
+| Command                      | Description                                                     |
+| ---------------------------- | --------------------------------------------------------------- |
+| `stint link`                 | Link current directory to a Stint project (or create a new one) |
+| `stint unlink [--force]`     | Remove project link                                             |
+| `stint status [--dashboard]` | Show status (use `-d` for interactive dashboard)                |
+| `stint sync`                 | Manually sync repository information to server                  |
 
 ### Commit Operations
 
-| Command | Description |
-|---------|-------------|
-| `stint commits` | List pending commits for this repository |
-| `stint commit <id>` | Execute a specific pending commit |
+| Command             | Description                              |
+| ------------------- | ---------------------------------------- |
+| `stint commits`     | List pending commits for this repository |
+| `stint commit <id>` | Execute a specific pending commit        |
 
 ## Complete Workflow
 
@@ -113,44 +119,46 @@ stint status
 
 ## Troubleshooting
 
-### "Not authenticated" error
-
-Run `stint login` to authenticate with your Stint account.
+For comprehensive troubleshooting help, see the **[Troubleshooting Guide](docs/TROUBLESHOOTING.md)**.
 
-### "Repository has uncommitted changes"
+### Quick Tips
 
-The agent requires a clean repository to execute commits:
+**"Not authenticated" error**
 
 ```bash
-git stash                  # Temporarily stash changes
-# or
-git add . && git commit -m "message"
+stint login
 ```
 
-### Daemon won't start
+**Daemon won't start**
 
 ```bash
 stint daemon status        # Check if already running
 stint daemon logs          # Check logs for errors
-stint daemon stop          # Stop first
-stint daemon start         # Then start again
+stint daemon restart       # Restart daemon
 ```
 
-### WebSocket connection issues
+**For detailed solutions**, including:
+
+- Connection issues (WebSocket, API, Circuit Breaker)
+- Daemon problems (crashes, autostart)
+- Authentication errors
+- Git operation failures
+- Platform-specific issues (Windows, macOS, Linux)
 
-Check your network connection and firewall settings.
+See the **[Troubleshooting Guide](docs/TROUBLESHOOTING.md)**.
 
 ## Logging
 
 Logs are stored in your system's config directory:
 
-| Platform | Log Location |
-|----------|--------------|
-| **macOS** | `~/.config/stint/logs/` |
-| **Linux** | `~/.config/stint/logs/` |
+| Platform    | Log Location                        |
+| ----------- | ----------------------------------- |
+| **macOS**   | `~/.config/stint/logs/`             |
+| **Linux**   | `~/.config/stint/logs/`             |
 | **Windows** | `%USERPROFILE%\.config\stint\logs\` |
 
 Log files:
+
 - `agent.log` - General CLI operations
 - `daemon.log` - Daemon process logs
 - `error.log` - Error details

package/dist/StatusDashboard-7ZIGEOQ4.js

@@ -0,0 +1,232 @@
+import {
+  gitService,
+  projectService,
+  validatePidFile
+} from "./chunk-FBQA4K5J.js";
+import {
+  authService
+} from "./chunk-RHMTZK2J.js";
+
+// src/components/StatusDashboard.tsx
+import { useState, useEffect } from "react";
+import { Box as Box3, Text as Text3, useApp, useInput } from "ink";
+
+// src/components/Panel.tsx
+import { Box, Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Panel({ title, icon, children }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [
+    /* @__PURE__ */ jsxs(Text, { color: "blue", children: [
+      icon ? `${icon} ` : "",
+      title,
+      ":"
+    ] }),
+    /* @__PURE__ */ jsx(Text, { color: "gray", children: "\u2500".repeat(50) }),
+    /* @__PURE__ */ jsx(Box, { flexDirection: "column", paddingLeft: 0, children })
+  ] });
+}
+
+// src/components/StatusRow.tsx
+import { Box as Box2, Text as Text2 } from "ink";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function StatusRow({ label, value, labelWidth = 12 }) {
+  return /* @__PURE__ */ jsxs2(Box2, { children: [
+    /* @__PURE__ */ jsx2(Text2, { bold: true, children: label.padEnd(labelWidth) }),
+    typeof value === "string" ? /* @__PURE__ */ jsx2(Text2, { children: value }) : value
+  ] });
+}
+
+// src/components/StatusDashboard.tsx
+import { Fragment, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function StatusDashboard({ cwd }) {
+  const { exit } = useApp();
+  const [state, setState] = useState({
+    linkedProject: null,
+    repoInfo: null,
+    user: null,
+    daemonRunning: false,
+    daemonPid: null,
+    isRepo: false,
+    loading: true,
+    lastRefresh: /* @__PURE__ */ new Date(),
+    error: null
+  });
+  const [showHelp, setShowHelp] = useState(false);
+  const refreshStatus = async () => {
+    setState((prev) => ({ ...prev, loading: true, error: null }));
+    try {
+      const [linkedProject2, user2, isRepo2] = await Promise.all([
+        projectService.getLinkedProject(cwd),
+        authService.validateToken(),
+        gitService.isRepo(cwd)
+      ]);
+      let repoInfo2 = null;
+      if (isRepo2) {
+        try {
+          repoInfo2 = await gitService.getRepoInfo(cwd);
+        } catch {
+        }
+      }
+      const { valid, pid } = validatePidFile();
+      setState({
+        linkedProject: linkedProject2,
+        repoInfo: repoInfo2,
+        user: user2,
+        daemonRunning: valid,
+        daemonPid: pid,
+        isRepo: isRepo2,
+        loading: false,
+        lastRefresh: /* @__PURE__ */ new Date(),
+        error: null
+      });
+    } catch (error2) {
+      setState((prev) => ({
+        ...prev,
+        loading: false,
+        error: error2.message
+      }));
+    }
+  };
+  useEffect(() => {
+    refreshStatus();
+    const interval = setInterval(refreshStatus, 5e3);
+    return () => clearInterval(interval);
+  }, [cwd]);
+  useInput((input, key) => {
+    if (input === "q" || key.escape) {
+      exit();
+    } else if (input === "r") {
+      refreshStatus();
+    } else if (input === "?") {
+      setShowHelp((prev) => !prev);
+    }
+  });
+  const { linkedProject, repoInfo, user, daemonRunning, daemonPid, isRepo, loading, lastRefresh, error } = state;
+  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", padding: 1, children: [
+    /* @__PURE__ */ jsx3(Box3, { marginBottom: 1, children: /* @__PURE__ */ jsx3(Text3, { bold: true, color: "cyan", children: "\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E" }) }),
+    /* @__PURE__ */ jsxs3(Box3, { marginBottom: 1, children: [
+      /* @__PURE__ */ jsx3(Text3, { bold: true, color: "cyan", children: "\u2502" }),
+      /* @__PURE__ */ jsx3(Text3, { bold: true, children: "  \u{1F4CA} Stint Status Dashboard                        " }),
+      /* @__PURE__ */ jsx3(Text3, { bold: true, color: "cyan", children: "\u2502" })
+    ] }),
+    /* @__PURE__ */ jsx3(Box3, { marginBottom: 1, children: /* @__PURE__ */ jsx3(Text3, { bold: true, color: "cyan", children: "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F" }) }),
+    error && /* @__PURE__ */ jsx3(Box3, { marginBottom: 1, children: /* @__PURE__ */ jsxs3(Text3, { color: "red", children: [
+      "\u26A0 Error: ",
+      error
+    ] }) }),
+    loading && /* @__PURE__ */ jsx3(Box3, { marginBottom: 1, children: /* @__PURE__ */ jsx3(Text3, { color: "yellow", children: "\u27F3 Refreshing..." }) }),
+    /* @__PURE__ */ jsx3(Panel, { title: "Project Status", icon: "\u{1F4E6}", children: linkedProject ? /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Status:", value: /* @__PURE__ */ jsx3(Text3, { color: "green", children: "\u2713 Linked" }) }),
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Project ID:", value: linkedProject.projectId }),
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Linked At:", value: new Date(linkedProject.linkedAt).toLocaleString() })
+    ] }) : /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Status:", value: /* @__PURE__ */ jsx3(Text3, { color: "yellow", children: "Not linked" }) }),
+      /* @__PURE__ */ jsx3(Text3, { color: "gray", children: 'Run "stint link" to link this directory to a project.' })
+    ] }) }),
+    /* @__PURE__ */ jsx3(Panel, { title: "Git Repository", icon: "\u{1F4C2}", children: isRepo && repoInfo ? /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Branch:", value: /* @__PURE__ */ jsx3(Text3, { color: "cyan", children: repoInfo.currentBranch }) }),
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Remote:", value: repoInfo.remoteUrl || /* @__PURE__ */ jsx3(Text3, { color: "gray", children: "None" }) }),
+      /* @__PURE__ */ jsx3(
+        StatusRow,
+        {
+          label: "Last Commit:",
+          value: `${repoInfo.lastCommitSha.substring(0, 7)} - ${repoInfo.lastCommitMessage.substring(0, 40)}${repoInfo.lastCommitMessage.length > 40 ? "..." : ""}`
+        }
+      ),
+      renderGitChanges(repoInfo)
+    ] }) : /* @__PURE__ */ jsx3(Text3, { color: "yellow", children: "Not a git repository" }) }),
+    /* @__PURE__ */ jsx3(Panel, { title: "Authentication", icon: "\u{1F510}", children: user ? /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Status:", value: /* @__PURE__ */ jsx3(Text3, { color: "green", children: "\u2713 Authenticated" }) }),
+      /* @__PURE__ */ jsx3(StatusRow, { label: "User:", value: `${user.name} (${user.email})` }),
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Machine:", value: authService.getMachineName() })
+    ] }) : /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Status:", value: /* @__PURE__ */ jsx3(Text3, { color: "yellow", children: "Not logged in" }) }),
+      /* @__PURE__ */ jsx3(Text3, { color: "gray", children: 'Run "stint login" to authenticate.' })
+    ] }) }),
+    /* @__PURE__ */ jsx3(Panel, { title: "Daemon", icon: "\u2699\uFE0F", children: daemonRunning ? /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Status:", value: /* @__PURE__ */ jsx3(Text3, { color: "green", children: "\u2713 Running" }) }),
+      /* @__PURE__ */ jsx3(StatusRow, { label: "PID:", value: String(daemonPid) })
+    ] }) : /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(StatusRow, { label: "Status:", value: /* @__PURE__ */ jsx3(Text3, { color: "yellow", children: "Not running" }) }),
+      /* @__PURE__ */ jsx3(Text3, { color: "gray", children: 'Run "stint daemon start" to start the background agent.' })
+    ] }) }),
+    /* @__PURE__ */ jsxs3(Box3, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsx3(Text3, { color: "gray", children: "\u2500".repeat(50) }),
+      /* @__PURE__ */ jsxs3(Box3, { children: [
+        /* @__PURE__ */ jsxs3(Text3, { color: "gray", children: [
+          "Last refresh: ",
+          lastRefresh.toLocaleTimeString()
+        ] }),
+        /* @__PURE__ */ jsx3(Text3, { color: "gray", children: " \u2502 Auto-refresh: 5s" })
+      ] }),
+      /* @__PURE__ */ jsxs3(Box3, { marginTop: 1, children: [
+        /* @__PURE__ */ jsx3(Text3, { color: "cyan", children: "[q]" }),
+        /* @__PURE__ */ jsx3(Text3, { children: " Quit  " }),
+        /* @__PURE__ */ jsx3(Text3, { color: "cyan", children: "[r]" }),
+        /* @__PURE__ */ jsx3(Text3, { children: " Refresh  " }),
+        /* @__PURE__ */ jsx3(Text3, { color: "cyan", children: "[?]" }),
+        /* @__PURE__ */ jsx3(Text3, { children: " Help" })
+      ] })
+    ] }),
+    showHelp && /* @__PURE__ */ jsxs3(
+      Box3,
+      {
+        flexDirection: "column",
+        marginTop: 1,
+        borderStyle: "round",
+        borderColor: "cyan",
+        padding: 1,
+        children: [
+          /* @__PURE__ */ jsx3(Text3, { bold: true, color: "cyan", children: "Keyboard Shortcuts" }),
+          /* @__PURE__ */ jsx3(Text3, { children: "  q, Esc  - Exit dashboard" }),
+          /* @__PURE__ */ jsx3(Text3, { children: "  r       - Refresh status immediately" }),
+          /* @__PURE__ */ jsx3(Text3, { children: "  ?       - Toggle this help" })
+        ]
+      }
+    )
+  ] });
+}
+function renderGitChanges(repoInfo) {
+  const { staged, unstaged, untracked, ahead, behind } = repoInfo.status;
+  const totalChanges = staged.length + unstaged.length + untracked.length;
+  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", children: [
+    totalChanges > 0 ? /* @__PURE__ */ jsxs3(Fragment, { children: [
+      /* @__PURE__ */ jsx3(
+        StatusRow,
+        {
+          label: "Changes:",
+          value: /* @__PURE__ */ jsxs3(Text3, { color: "yellow", children: [
+            totalChanges,
+            " file(s)"
+          ] })
+        }
+      ),
+      staged.length > 0 && /* @__PURE__ */ jsx3(Box3, { paddingLeft: 2, children: /* @__PURE__ */ jsxs3(Text3, { color: "green", children: [
+        "Staged:    ",
+        staged.length
+      ] }) }),
+      unstaged.length > 0 && /* @__PURE__ */ jsx3(Box3, { paddingLeft: 2, children: /* @__PURE__ */ jsxs3(Text3, { color: "yellow", children: [
+        "Unstaged:  ",
+        unstaged.length
+      ] }) }),
+      untracked.length > 0 && /* @__PURE__ */ jsx3(Box3, { paddingLeft: 2, children: /* @__PURE__ */ jsxs3(Text3, { color: "gray", children: [
+        "Untracked: ",
+        untracked.length
+      ] }) })
+    ] }) : /* @__PURE__ */ jsx3(StatusRow, { label: "Changes:", value: /* @__PURE__ */ jsx3(Text3, { color: "green", children: "Clean working tree" }) }),
+    (ahead > 0 || behind > 0) && /* @__PURE__ */ jsx3(
+      StatusRow,
+      {
+        label: "Sync:",
+        value: /* @__PURE__ */ jsxs3(Text3, { color: "yellow", children: [
+          ahead > 0 ? `\u2191${ahead}` : "",
+          " ",
+          behind > 0 ? `\u2193${behind}` : ""
+        ] })
+      }
+    )
+  ] });
+}
+export {
+  StatusDashboard
+};

package/dist/api-HLTR2LTF.js

@@ -0,0 +1,7 @@
+import {
+  apiService
+} from "./chunk-W4JGOGR7.js";
+import "./chunk-RHMTZK2J.js";
+export {
+  apiService
+};