@gowelle/stint-agent 1.0.1 → 1.0.3

package/README.md

@@ -34,7 +34,7 @@ stint login
 # Check your authentication status
 stint whoami
 
-# Link a project
+# Link a project (or create a new one)
 cd /path/to/your/project
 stint link
 
@@ -47,6 +47,13 @@ stint daemon status
 
 ## Commands
 
+### General
+
+| Command | Description |
+|---------|-------------|
+| `stint --version`, `stint -V` | Show current agent version |
+| `stint --help`, `stint -h` | Show help information |
+
 ### Authentication
 
 | Command | Description |
@@ -69,7 +76,7 @@ stint daemon status
 
 | Command | Description |
 |---------|-------------|
-| `stint link` | Link current directory to a Stint project |
+| `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 |

package/dist/{api-GH4C2AFN.js → api-37DCZYLF.js}

@@ -1,6 +1,6 @@
 import {
   apiService
-} from "./chunk-CCM25AHM.js";
+} from "./chunk-NMOUYAW2.js";
 export {
   apiService
 };

package/dist/{chunk-TCWMYJPP.js → chunk-EVWSJ3RU.js}

@@ -2,7 +2,7 @@ import {
   apiService,
   config,
   logger
-} from "./chunk-CCM25AHM.js";
+} from "./chunk-NMOUYAW2.js";
 
 // src/utils/process.ts
 import fs from "fs";
@@ -322,17 +322,11 @@ var CommitQueueProcessor = class {
         throw new Error(`Directory ${projectPath} is not a git repository`);
       }
       const status = await gitService.getStatus(projectPath);
-      const hasChanges = status.staged.length > 0 || status.unstaged.length > 0 || status.untracked.length > 0;
-      if (hasChanges) {
-        throw new Error("Repository has uncommitted changes. Please commit or stash them first.");
-      }
-      if (commit.files && commit.files.length > 0) {
-        logger.info("queue", `Staging specific files: ${commit.files.join(", ")}`);
-        await gitService.stageFiles(projectPath, commit.files);
-      } else {
-        logger.info("queue", "Staging all changes");
-        await gitService.stageAll(projectPath);
+      const hasStagedChanges = status.staged.length > 0;
+      if (!hasStagedChanges) {
+        throw new Error('No staged changes to commit. Please stage files using "git add" before committing.');
       }
+      logger.info("queue", `Committing ${status.staged.length} staged files.`);
       logger.info("queue", `Creating commit with message: "${commit.message}"`);
       const sha = await gitService.commit(projectPath, commit.message);
       logger.success("queue", `Commit created successfully: ${sha}`);

package/dist/{chunk-CCM25AHM.js → chunk-NMOUYAW2.js}

@@ -254,7 +254,7 @@ var AuthServiceImpl = class {
       return null;
     }
     try {
-      const { apiService: apiService2 } = await import("./api-GH4C2AFN.js");
+      const { apiService: apiService2 } = await import("./api-37DCZYLF.js");
       const user = await apiService2.getCurrentUser();
       logger.info("auth", `Token validated for user: ${user.email}`);
       return user;
@@ -274,7 +274,7 @@ var AuthServiceImpl = class {
 var authService = new AuthServiceImpl();
 
 // src/services/api.ts
-var AGENT_VERSION = "1.0.1";
+var AGENT_VERSION = "1.0.3";
 var ApiServiceImpl = class {
   sessionId = null;
   async getHeaders() {
@@ -351,7 +351,7 @@ var ApiServiceImpl = class {
       return session;
     }, "Connect");
   }
-  async disconnect() {
+  async disconnect(reason) {
     if (!this.sessionId) {
       return;
     }
@@ -359,7 +359,8 @@ var ApiServiceImpl = class {
     await this.request("/api/agent/disconnect", {
       method: "POST",
       body: JSON.stringify({
-        session_id: this.sessionId
+        session_id: this.sessionId,
+        reason: reason || "Agent disconnected"
       })
     });
     this.sessionId = null;
@@ -381,22 +382,40 @@ var ApiServiceImpl = class {
   }
   async getPendingCommits(projectId) {
     logger.info("api", `Fetching pending commits for project ${projectId}`);
-    const commits = await this.request(
-      `/api/agent/projects/${projectId}/pending-commits`
+    const response = await this.request(
+      `/api/agent/pending-commits?project_id=${projectId}`
     );
+    const commits = response.data.map((item) => ({
+      id: item.id,
+      projectId: item.project_id || item.projectId,
+      message: item.message,
+      files: item.files,
+      createdAt: item.created_at || item.createdAt
+    }));
     logger.info("api", `Found ${commits.length} pending commits`);
     return commits;
   }
   async markCommitExecuted(commitId, sha) {
     logger.info("api", `Marking commit ${commitId} as executed (SHA: ${sha})`);
     return this.withRetry(async () => {
-      const commit = await this.request(
+      const response = await this.request(
         `/api/agent/commits/${commitId}/executed`,
         {
           method: "POST",
           body: JSON.stringify({ sha })
         }
       );
+      const data = response.data;
+      const commit = {
+        id: data.id,
+        projectId: data.project_id || data.projectId,
+        message: data.message,
+        sha: data.sha,
+        status: data.status,
+        createdAt: data.created_at || data.createdAt,
+        executedAt: data.executed_at || data.executedAt,
+        error: data.error
+      };
       logger.success("api", `Commit ${commitId} marked as executed`);
       return commit;
     }, "Mark commit executed");
@@ -422,7 +441,8 @@ var ApiServiceImpl = class {
   }
   async getLinkedProjects() {
     logger.info("api", "Fetching linked projects");
-    const projects = await this.request("/api/agent/projects");
+    const response = await this.request("/api/agent/projects");
+    const projects = response.data;
     logger.info("api", `Found ${projects.length} linked projects`);
     return projects;
   }
@@ -432,6 +452,16 @@ var ApiServiceImpl = class {
     logger.info("api", `Fetched user: ${user.email}`);
     return user;
   }
+  async createProject(data) {
+    logger.info("api", `Creating project: ${data.name}`);
+    const response = await this.request("/api/agent/projects", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+    const project = response.data;
+    logger.success("api", `Created project: ${project.name} (${project.id})`);
+    return project;
+  }
 };
 var apiService = new ApiServiceImpl();
 

package/dist/daemon/runner.js

@@ -5,13 +5,13 @@ import {
   projectService,
   removePidFile,
   writePidFile
-} from "../chunk-TCWMYJPP.js";
+} from "../chunk-EVWSJ3RU.js";
 import {
   apiService,
   authService,
   config,
   logger
-} from "../chunk-CCM25AHM.js";
+} from "../chunk-NMOUYAW2.js";
 
 // src/daemon/runner.ts
 import "dotenv/config";
@@ -27,8 +27,12 @@ var WebSocketServiceImpl = class {
   isManualDisconnect = false;
   // Event handlers
   commitApprovedHandlers = [];
+  commitPendingHandlers = [];
+  suggestionCreatedHandlers = [];
   projectUpdatedHandlers = [];
   disconnectHandlers = [];
+  agentDisconnectedHandlers = [];
+  syncRequestedHandlers = [];
   async connect() {
     try {
       const token = await authService.getToken();
@@ -108,12 +112,24 @@ var WebSocketServiceImpl = class {
   onCommitApproved(handler) {
     this.commitApprovedHandlers.push(handler);
   }
+  onCommitPending(handler) {
+    this.commitPendingHandlers.push(handler);
+  }
+  onSuggestionCreated(handler) {
+    this.suggestionCreatedHandlers.push(handler);
+  }
   onProjectUpdated(handler) {
     this.projectUpdatedHandlers.push(handler);
   }
   onDisconnect(handler) {
     this.disconnectHandlers.push(handler);
   }
+  onAgentDisconnected(handler) {
+    this.agentDisconnectedHandlers.push(handler);
+  }
+  onSyncRequested(handler) {
+    this.syncRequestedHandlers.push(handler);
+  }
   sendMessage(message) {
     if (!this.isConnected()) {
       logger.warn("websocket", "Cannot send message: not connected");
@@ -139,6 +155,18 @@ var WebSocketServiceImpl = class {
         this.commitApprovedHandlers.forEach((handler) => handler(commit, project));
         return;
       }
+      if (message.event === "commit.pending") {
+        const { pendingCommit } = message.data;
+        logger.info("websocket", `Commit pending: ${pendingCommit.id}`);
+        this.commitPendingHandlers.forEach((handler) => handler(pendingCommit));
+        return;
+      }
+      if (message.event === "suggestion.created") {
+        const { suggestion } = message.data;
+        logger.info("websocket", `Suggestion created: ${suggestion.id}`);
+        this.suggestionCreatedHandlers.forEach((handler) => handler(suggestion));
+        return;
+      }
       if (message.event === "project.updated") {
         const { project } = message.data;
         logger.info("websocket", `Project updated: ${project.id}`);
@@ -148,6 +176,13 @@ var WebSocketServiceImpl = class {
       if (message.event === "sync.requested") {
         const { projectId } = message.data;
         logger.info("websocket", `Sync requested for project: ${projectId}`);
+        this.syncRequestedHandlers.forEach((handler) => handler(projectId));
+        return;
+      }
+      if (message.event === "agent.disconnected") {
+        const reason = message.data?.reason || "Server requested disconnect";
+        logger.warn("websocket", `Agent disconnected by server: ${reason}`);
+        this.agentDisconnectedHandlers.forEach((handler) => handler(reason));
         return;
       }
       logger.debug("websocket", `Unhandled event: ${message.event}`);
@@ -358,6 +393,19 @@ var FileWatcher = class {
   addProject(projectPath, projectId) {
     this.watchProject(projectPath, projectId);
   }
+  /**
+   * Sync a project by ID (called when server requests a sync)
+   */
+  async syncProjectById(projectId) {
+    const linkedProjects = projectService.getAllLinkedProjects();
+    for (const [projectPath, linkedProject] of Object.entries(linkedProjects)) {
+      if (linkedProject.projectId === projectId) {
+        await this.performSync(projectPath, projectId);
+        return;
+      }
+    }
+    logger.warn("watcher", `Cannot sync: project ${projectId} not found in linked projects`);
+  }
   /**
    * Remove a project from watching (called when a project is unlinked)
    */
@@ -377,9 +425,32 @@ var FileWatcher = class {
   }
 };
 
+// src/utils/notify.ts
+import notifier from "node-notifier";
+function notify(options) {
+  try {
+    notifier.notify({
+      title: options.title,
+      message: options.message,
+      open: options.open,
+      sound: true,
+      wait: false,
+      appID: "Stint Agent"
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    }, (error) => {
+      if (error) {
+        logger.error("notify", "Failed to send notification", error);
+      }
+    });
+  } catch (error) {
+    logger.error("notify", "Failed to send notification", error);
+  }
+}
+
 // src/daemon/index.ts
 var heartbeatInterval = null;
 var isShuttingDown = false;
+var shutdownReason;
 var fileWatcher = new FileWatcher();
 async function startDaemon() {
   logger.info("daemon", "Starting daemon...");
@@ -406,6 +477,30 @@ async function startDaemon() {
     websocketService.onDisconnect(() => {
       logger.warn("daemon", "WebSocket disconnected, will attempt to reconnect");
     });
+    websocketService.onAgentDisconnected(async (reason) => {
+      logger.warn("daemon", `Server disconnected agent: ${reason}`);
+      logger.info("daemon", "Initiating graceful shutdown...");
+      await shutdown(`Server: ${reason}`);
+      process.exit(0);
+    });
+    websocketService.onSuggestionCreated((suggestion) => {
+      logger.info("daemon", `Suggestion created: ${suggestion.title} (${suggestion.priority})`);
+      notify({
+        title: "New Suggestion",
+        message: `${suggestion.title}
+Priority: ${suggestion.priority}`,
+        open: `https://stint.codes/projects/${suggestion.project_id}/suggestions/${suggestion.id}`
+        // Hypothetical URL structure
+      });
+    });
+    websocketService.onSyncRequested(async (projectId) => {
+      logger.info("daemon", `Server requested sync for project: ${projectId}`);
+      try {
+        await fileWatcher.syncProjectById(projectId);
+      } catch (error) {
+        logger.error("daemon", `Failed to sync project ${projectId}`, error);
+      }
+    });
     setupSignalHandlers();
     startHeartbeat();
     fileWatcher.start();
@@ -443,15 +538,16 @@ function setupSignalHandlers() {
   signals.forEach((signal) => {
     process.on(signal, async () => {
       logger.info("daemon", `Received ${signal}, shutting down...`);
-      await shutdown();
+      await shutdown(`Signal: ${signal}`);
       process.exit(0);
     });
   });
   logger.info("daemon", "Signal handlers registered");
 }
-async function shutdown() {
+async function shutdown(reason) {
   if (isShuttingDown) return;
   isShuttingDown = true;
+  shutdownReason = reason;
   logger.info("daemon", "Shutting down daemon...");
   stopHeartbeat();
   try {
@@ -467,7 +563,7 @@ async function shutdown() {
     logger.error("daemon", "Failed to disconnect from WebSocket", error);
   }
   try {
-    await apiService.disconnect();
+    await apiService.disconnect(shutdownReason);
     logger.info("daemon", "Disconnected from API");
   } catch (error) {
     logger.error("daemon", "Failed to disconnect from API", error);

package/dist/index.js

@@ -8,13 +8,13 @@ import {
   projectService,
   spawnDetached,
   validatePidFile
-} from "./chunk-TCWMYJPP.js";
+} from "./chunk-EVWSJ3RU.js";
 import {
   apiService,
   authService,
   config,
   logger
-} from "./chunk-CCM25AHM.js";
+} from "./chunk-NMOUYAW2.js";
 
 // src/index.ts
 import "dotenv/config";
@@ -44,82 +44,245 @@ function startCallbackServer(expectedState, timeoutMs = 5 * 60 * 1e3) {
       callbackReject = reject2;
     });
     server.on("request", (req, res) => {
+      res.setHeader("Access-Control-Allow-Origin", "*");
+      res.setHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
+      res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-XSRF-TOKEN, X-Requested-With, X-Inertia, X-Inertia-Version");
+      res.setHeader("Access-Control-Expose-Headers", "X-Inertia-Location");
+      res.setHeader("Access-Control-Allow-Private-Network", "true");
+      if (req.method === "OPTIONS") {
+        res.setHeader("Access-Control-Allow-Private-Network", "true");
+        res.writeHead(200);
+        res.end();
+        return;
+      }
       if (req.url?.startsWith("/auth/callback")) {
         try {
           const url = new URL(req.url, `http://${req.headers.host}`);
           const token = url.searchParams.get("token");
           const state = url.searchParams.get("state");
           const error = url.searchParams.get("error");
+          const next = url.searchParams.get("next");
+          const accept = req.headers.accept || "";
+          const isInertia = req.headers["x-inertia"] === "true";
+          const isJsonRequest = accept.includes("application/json") || isInertia;
           if (error) {
             const errorDescription = url.searchParams.get("error_description") || error;
-            const escapedError = escapeHtml(errorDescription);
-            res.writeHead(400, { "Content-Type": "text/html" });
-            res.end(`
-                            <html>
-                                <head><title>Authentication Failed</title></head>
-                                <body>
-                                    <h1>Authentication Failed</h1>
-                                    <p>${escapedError}</p>
-                                    <p>You can close this window.</p>
-                                </body>
-                            </html>
-                        `);
+            if (isJsonRequest) {
+              res.writeHead(400, { "Content-Type": "application/json" });
+              res.end(JSON.stringify({
+                status: "error",
+                error,
+                message: errorDescription
+              }));
+            } else {
+              const escapedError = escapeHtml(errorDescription);
+              res.writeHead(400, { "Content-Type": "text/html" });
+              res.end(`
+                                <html>
+                                    <head><title>Authentication Failed</title></head>
+                                    <body>
+                                        <h1>Authentication Failed</h1>
+                                        <p>${escapedError}</p>
+                                        <p>You can close this window.</p>
+                                    </body>
+                                </html>
+                            `);
+            }
             callbackReject(new Error(`OAuth error: ${errorDescription}`));
             return;
           }
           if (state !== expectedState) {
-            res.writeHead(400, { "Content-Type": "text/html" });
-            res.end(`
-                            <html>
-                                <head><title>Authentication Failed</title></head>
-                                <body>
-                                    <h1>Authentication Failed</h1>
-                                    <p>Invalid state parameter. Security validation failed.</p>
-                                    <p>You can close this window.</p>
-                                </body>
-                            </html>
-                        `);
+            if (isJsonRequest) {
+              res.writeHead(400, { "Content-Type": "application/json" });
+              res.end(JSON.stringify({
+                status: "error",
+                error: "invalid_state",
+                message: "State parameter mismatch"
+              }));
+            } else {
+              res.writeHead(400, { "Content-Type": "text/html" });
+              res.end(`
+                                <html>
+                                    <head><title>Authentication Failed</title></head>
+                                    <body>
+                                        <h1>Authentication Failed</h1>
+                                        <p>Invalid state parameter. Security validation failed.</p>
+                                        <p>You can close this window.</p>
+                                    </body>
+                                </html>
+                            `);
+            }
             callbackReject(new Error("State parameter mismatch"));
             return;
           }
           if (!token) {
-            res.writeHead(400, { "Content-Type": "text/html" });
-            res.end(`
-                            <html>
-                                <head><title>Authentication Failed</title></head>
-                                <body>
-                                    <h1>Authentication Failed</h1>
-                                    <p>No token provided in callback.</p>
-                                    <p>You can close this window.</p>
-                                </body>
-                            </html>
-                        `);
+            if (isJsonRequest) {
+              res.writeHead(400, { "Content-Type": "application/json" });
+              res.end(JSON.stringify({
+                status: "error",
+                error: "missing_token",
+                message: "No token provided"
+              }));
+            } else {
+              res.writeHead(400, { "Content-Type": "text/html" });
+              res.end(`
+                                <html>
+                                    <head><title>Authentication Failed</title></head>
+                                    <body>
+                                        <h1>Authentication Failed</h1>
+                                        <p>No token provided in callback.</p>
+                                        <p>You can close this window.</p>
+                                    </body>
+                                </html>
+                            `);
+            }
             callbackReject(new Error("No token in callback"));
             return;
           }
-          res.writeHead(200, { "Content-Type": "text/html" });
-          res.end(`
+          if (isInertia && next) {
+            res.writeHead(409, { "X-Inertia-Location": next });
+            res.end();
+          } else if (isJsonRequest) {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+              status: "success",
+              message: "Authentication successful",
+              user: "Authenticated",
+              next: next || void 0
+            }));
+          } else if (next) {
+            res.writeHead(302, { "Location": next });
+            res.end();
+          } else {
+            res.writeHead(200, { "Content-Type": "text/html" });
+            res.end(`
+                        <!DOCTYPE html>
                         <html>
-                            <head><title>Authentication Successful</title></head>
+                            <head>
+                                <title>Stint - Authentication Successful</title>
+                                <style>
+                                    body {
+                                        background-color: #0f172a;
+                                        color: #e2e8f0;
+                                        font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+                                        display: flex;
+                                        justify-content: center;
+                                        align-items: center;
+                                        height: 100vh;
+                                        margin: 0;
+                                    }
+                                    .container {
+                                        background-color: #1e293b;
+                                        padding: 2.5rem;
+                                        border-radius: 1rem;
+                                        box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+                                        text-align: center;
+                                        max-width: 28rem;
+                                        width: 100%;
+                                        border: 1px solid #334155;
+                                    }
+                                    h1 {
+                                        color: #38bdf8;
+                                        margin-top: 0;
+                                        font-size: 1.5rem;
+                                        margin-bottom: 1rem;
+                                    }
+                                    p {
+                                        color: #94a3b8;
+                                        line-height: 1.5;
+                                        margin-bottom: 1.5rem;
+                                    }
+                                    .icon {
+                                        color: #22c55e;
+                                        width: 3rem;
+                                        height: 3rem;
+                                        margin-bottom: 1.5rem;
+                                    }
+                                    .btn {
+                                        background-color: #38bdf8;
+                                        color: #0f172a;
+                                        padding: 0.75rem 1.5rem;
+                                        border-radius: 0.5rem;
+                                        text-decoration: none;
+                                        font-weight: 600;
+                                        display: inline-block;
+                                        transition: background-color 0.2s;
+                                        border: none;
+                                        cursor: pointer;
+                                    }
+                                    .btn:hover {
+                                        background-color: #0ea5e9;
+                                    }
+                                </style>
+                            </head>
                             <body>
-                                <h1>Authentication Successful!</h1>
-                                <p>You have been successfully authenticated. You can close this window.</p>
+                                <div class="container">
+                                    <svg xmlns="http://www.w3.org/2000/svg" class="icon" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+                                        <path stroke-linecap="round" stroke-linejoin="round" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                                    </svg>
+                                    <h1>Authentication Successful</h1>
+                                    <p>You have successfully logged in to Stint. You can now close this window and return to your terminal.</p>
+                                    <button onclick="window.close()" class="btn">Close Window</button>
+                                </div>
+                                <script>
+                                    // Attempt to close the window automatically after 3 seconds
+                                    setTimeout(function() {
+                                        window.close();
+                                    }, 3000);
+                                </script>
                             </body>
                         </html>
-                    `);
+                        `);
+          }
           callbackResolve(token);
         } catch (error) {
-          res.writeHead(500, { "Content-Type": "text/html" });
-          res.end(`
-                        <html>
-                            <head><title>Error</title></head>
-                            <body>
-                                <h1>Error</h1>
-                                <p>An error occurred processing the callback.</p>
-                                <p>You can close this window.</p>
-                            </body>
-                        </html>
-                    `);
+          const isJsonRequest = req.headers.accept?.includes("application/json");
+          if (isJsonRequest) {
+            res.writeHead(500, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+              status: "error",
+              message: "Internal server error processing callback"
+            }));
+          } else {
+            res.writeHead(500, { "Content-Type": "text/html" });
+            res.end(`
+                            <!DOCTYPE html>
+                            <html>
+                                <head>
+                                    <title>Stint - Error</title>
+                                    <style>
+                                        body {
+                                            background-color: #0f172a;
+                                            color: #e2e8f0;
+                                            font-family: sans-serif;
+                                            display: flex;
+                                            justify-content: center;
+                                            align-items: center;
+                                            height: 100vh;
+                                            margin: 0;
+                                        }
+                                        .container {
+                                            background-color: #1e293b;
+                                            padding: 2rem;
+                                            border-radius: 0.5rem;
+                                            text-align: center;
+                                            max-width: 24rem;
+                                            border: 1px solid #334155;
+                                        }
+                                        h1 { color: #f43f5e; margin-top: 0; }
+                                        p { color: #94a3b8; }
+                                    </style>
+                                </head>
+                                <body>
+                                    <div class="container">
+                                        <h1>Authentication Error</h1>
+                                        <p>An error occurred processing the callback.</p>
+                                        <p>Please try logging in again.</p>
+                                    </div>
+                                </body>
+                            </html>
+                        `);
+          }
           callbackReject(error);
         }
       } else {
@@ -134,7 +297,7 @@ function startCallbackServer(expectedState, timeoutMs = 5 * 60 * 1e3) {
         reject(error);
       }
     });
-    server.listen(0, "127.0.0.1", () => {
+    server.listen(0, "localhost", () => {
       const address = server.address();
       const port = address.port;
       timeout = setTimeout(() => {
@@ -144,7 +307,7 @@ function startCallbackServer(expectedState, timeoutMs = 5 * 60 * 1e3) {
       callbackPromise.then(() => clearTimeout(timeout)).catch(() => clearTimeout(timeout)).finally(() => {
         setTimeout(() => {
           server.close();
-        }, 100);
+        }, 500);
       });
       resolve({
         server,
@@ -283,9 +446,10 @@ function registerWhoamiCommand(program2) {
 }
 
 // src/commands/link.ts
-import { select } from "@inquirer/prompts";
+import { select, input } from "@inquirer/prompts";
 import ora4 from "ora";
 import chalk4 from "chalk";
+import path from "path";
 import process2 from "process";
 function registerLinkCommand(program2) {
   program2.command("link").description("Link current directory to a Stint project").action(async () => {
@@ -317,17 +481,59 @@ function registerLinkCommand(program2) {
         return;
       }
       spinner.succeed("Ready to link");
-      const selectedProjectId = await select({
+      const choices = projects.map((project) => ({
+        name: project.name,
+        value: project.id,
+        description: `ID: ${project.id}`
+      }));
+      const CREATE_NEW_PROJECT = "create-new-project";
+      choices.push({
+        name: "\u2795 Create new project",
+        value: CREATE_NEW_PROJECT,
+        description: "Create a new project on Stint"
+      });
+      const selectedAction = await select({
         message: "Select a project to link:",
-        choices: projects.map((project) => ({
-          name: `${project.name}${project.description ? ` - ${project.description}` : ""}`,
-          value: project.id,
-          description: `ID: ${project.id}`
-        }))
+        choices
       });
+      let selectedProjectId = selectedAction;
+      let selectedProject = projects.find((p) => p.id === selectedProjectId);
+      if (selectedAction === CREATE_NEW_PROJECT) {
+        const name = await input({
+          message: "Project name:",
+          default: path.basename(cwd),
+          validate: (input2) => input2.trim().length > 0 || "Project name is required"
+        });
+        const description = await input({
+          message: "Description (optional):"
+        });
+        const createSpinner = ora4("Creating project...").start();
+        try {
+          let repoInfo = null;
+          if (isRepo) {
+            try {
+              repoInfo = await gitService.getRepoInfo(cwd);
+            } catch (e) {
+              logger.warn("link", `Failed to get repo info for creation metadata: ${e.message}`);
+            }
+          }
+          const newProject = await apiService.createProject({
+            name,
+            description: description || void 0,
+            repo_path: cwd,
+            remote_url: repoInfo?.remoteUrl || void 0,
+            default_branch: repoInfo?.currentBranch || void 0
+          });
+          createSpinner.succeed("Project created successfully!");
+          selectedProjectId = newProject.id;
+          selectedProject = newProject;
+        } catch (error) {
+          createSpinner.fail("Failed to create project");
+          throw error;
+        }
+      }
       const linkSpinner = ora4("Linking project...").start();
       await projectService.linkProject(cwd, selectedProjectId);
-      const selectedProject = projects.find((p) => p.id === selectedProjectId);
       linkSpinner.succeed("Project linked successfully!");
       console.log(chalk4.green(`
 \u2713 Linked to ${chalk4.bold(selectedProject?.name || selectedProjectId)}`));
@@ -400,6 +606,8 @@ Directory ${cwd} is no longer linked.
 import ora6 from "ora";
 import chalk6 from "chalk";
 import process4 from "process";
+import path2 from "path";
+import os from "os";
 function registerStatusCommand(program2) {
   program2.command("status").description("Show linked project and connection status").action(async () => {
     const spinner = ora6("Gathering status...").start();
@@ -459,7 +667,15 @@ function registerStatusCommand(program2) {
       }
       console.log(chalk6.blue("\n\u2699\uFE0F  Daemon:"));
       console.log(chalk6.gray("\u2500".repeat(50)));
-      console.log(`${chalk6.bold("Status:")}      ${chalk6.gray("Not running (Phase 3)")}`);
+      const { valid, pid } = validatePidFile();
+      if (valid && pid) {
+        console.log(`${chalk6.bold("Status:")}      ${chalk6.green("\u2713 Running")}`);
+        console.log(`${chalk6.bold("PID:")}         ${pid}`);
+        console.log(`${chalk6.bold("Logs:")}        ${path2.join(os.homedir(), ".config", "stint", "logs", "daemon.log")}`);
+      } else {
+        console.log(`${chalk6.bold("Status:")}      ${chalk6.yellow("Not running")}`);
+        console.log(chalk6.gray('Run "stint daemon start" to start the background agent.'));
+      }
       console.log();
       logger.info("status", "Status command executed");
     } catch (error) {
@@ -517,8 +733,8 @@ function registerSyncCommand(program2) {
 import ora8 from "ora";
 import chalk8 from "chalk";
 import fs from "fs";
-import path from "path";
-import os from "os";
+import path3 from "path";
+import os2 from "os";
 import { fileURLToPath } from "url";
 import { dirname } from "path";
 var __filename = fileURLToPath(import.meta.url);
@@ -544,7 +760,7 @@ function registerDaemonCommands(program2) {
         console.log(chalk8.gray('Run "stint login" first.\n'));
         process.exit(1);
       }
-      const runnerPath = path.join(__dirname, "daemon", "runner.js");
+      const runnerPath = path3.join(__dirname, "daemon", "runner.js");
       if (!fs.existsSync(runnerPath)) {
         throw new Error(`Daemon runner not found at ${runnerPath}`);
       }
@@ -558,7 +774,7 @@ function registerDaemonCommands(program2) {
       console.log(chalk8.green(`
 \u2713 Daemon is running in the background`));
       console.log(chalk8.gray(`PID: ${daemonPid}`));
-      console.log(chalk8.gray(`Logs: ${path.join(os.homedir(), ".config", "stint", "logs", "daemon.log")}
+      console.log(chalk8.gray(`Logs: ${path3.join(os2.homedir(), ".config", "stint", "logs", "daemon.log")}
 `));
       logger.success("daemon", `Daemon started with PID ${daemonPid}`);
     } catch (error) {
@@ -619,7 +835,7 @@ function registerDaemonCommands(program2) {
         console.log(`${chalk8.bold("Status:")}      ${chalk8.green("\u2713 Running")}`);
         console.log(`${chalk8.bold("PID:")}         ${pid}`);
         console.log(`${chalk8.bold("PID File:")}    ${getPidFilePath()}`);
-        console.log(`${chalk8.bold("Logs:")}        ${path.join(os.homedir(), ".config", "stint", "logs", "daemon.log")}`);
+        console.log(`${chalk8.bold("Logs:")}        ${path3.join(os2.homedir(), ".config", "stint", "logs", "daemon.log")}`);
       } else {
         console.log(`${chalk8.bold("Status:")}      ${chalk8.yellow("Not running")}`);
         console.log(chalk8.gray('Run "stint daemon start" to start the daemon.'));
@@ -637,7 +853,7 @@ function registerDaemonCommands(program2) {
   });
   daemon.command("logs").description("Tail daemon logs").option("-n, --lines <number>", "Number of lines to show", "50").action(async (options) => {
     try {
-      const logFile = path.join(os.homedir(), ".config", "stint", "logs", "daemon.log");
+      const logFile = path3.join(os2.homedir(), ".config", "stint", "logs", "daemon.log");
       if (!fs.existsSync(logFile)) {
         console.log(chalk8.yellow("\n\u26A0 No daemon logs found."));
         console.log(chalk8.gray("The daemon has not been started yet.\n"));
@@ -693,7 +909,7 @@ Log file: ${logFile}`));
       if (!user) {
         throw new Error("Not authenticated");
       }
-      const runnerPath = path.join(__dirname, "daemon", "runner.js");
+      const runnerPath = path3.join(__dirname, "daemon", "runner.js");
       const daemonPid = spawnDetached("node", [runnerPath]);
       await new Promise((resolve) => setTimeout(resolve, 1e3));
       if (!isProcessRunning(daemonPid)) {
@@ -714,6 +930,7 @@ Log file: ${logFile}`));
 // src/commands/commit.ts
 import ora9 from "ora";
 import chalk9 from "chalk";
+import { confirm as confirm2 } from "@inquirer/prompts";
 import process6 from "process";
 function registerCommitCommands(program2) {
   program2.command("commits").description("List pending commits for the current project").action(async () => {
@@ -759,7 +976,7 @@ function registerCommitCommands(program2) {
     }
   });
   program2.command("commit <id>").description("Execute a specific pending commit").action(async (id) => {
-    const spinner = ora9("Executing commit...").start();
+    const spinner = ora9("Checking repository status...").start();
     try {
       const cwd = process6.cwd();
       const linkedProject = projectService.getLinkedProject(cwd);
@@ -769,6 +986,14 @@ function registerCommitCommands(program2) {
         console.log(chalk9.gray('Run "stint link" first to link this directory.\n'));
         process6.exit(1);
       }
+      const status = await gitService.getStatus(cwd);
+      if (status.staged.length === 0) {
+        spinner.fail("No staged changes");
+        console.log(chalk9.yellow("\n\u26A0 No staged changes detected."));
+        console.log(chalk9.gray("Please stage the files you want to commit first."));
+        console.log(chalk9.gray("  git add <files>\n"));
+        process6.exit(1);
+      }
       spinner.text = "Fetching commit details...";
       const commits = await apiService.getPendingCommits(linkedProject.projectId);
       const commit = commits.find((c) => c.id.startsWith(id));
@@ -780,7 +1005,24 @@ function registerCommitCommands(program2) {
         console.log(chalk9.gray('Run "stint commits" to see available commits.\n'));
         process6.exit(1);
       }
-      spinner.text = `Executing commit: ${commit.message}`;
+      spinner.stop();
+      console.log(chalk9.blue("\n\u{1F4CB} Staged changes to commit:"));
+      console.log(chalk9.gray("\u2500".repeat(40)));
+      status.staged.forEach((file) => {
+        console.log(chalk9.green(`  + ${file}`));
+      });
+      console.log();
+      console.log(`${chalk9.bold("Message:")}    ${commit.message}`);
+      console.log();
+      const confirmed = await confirm2({
+        message: "Are you sure you want to commit these changes?",
+        default: true
+      });
+      if (!confirmed) {
+        console.log(chalk9.yellow("\nCommit cancelled.\n"));
+        return;
+      }
+      const execSpinner = ora9("Executing commit...").start();
       const project = {
         id: linkedProject.projectId,
         name: "Current Project",
@@ -789,7 +1031,7 @@ function registerCommitCommands(program2) {
         updatedAt: ""
       };
       const sha = await commitQueue.executeCommit(commit, project);
-      spinner.succeed("Commit executed successfully!");
+      execSpinner.succeed("Commit executed successfully!");
       console.log(chalk9.green("\n\u2713 Commit executed"));
       console.log(chalk9.gray("\u2500".repeat(50)));
       console.log(`${chalk9.bold("Commit ID:")}  ${commit.id}`);
@@ -798,7 +1040,9 @@ function registerCommitCommands(program2) {
       console.log();
       logger.success("commit", `Executed commit ${commit.id} -> ${sha}`);
     } catch (error) {
-      spinner.fail("Commit execution failed");
+      if (ora9().isSpinning) {
+        ora9().fail("Commit execution failed");
+      }
       logger.error("commit", "Failed to execute commit", error);
       console.error(chalk9.red(`
 \u2716 Error: ${error.message}
@@ -818,8 +1062,9 @@ function getTimeAgo(date) {
 }
 
 // src/index.ts
+var AGENT_VERSION = "1.0.3";
 var program = new Command();
-program.name("stint").description("Stint Agent - Local daemon for Stint Project Assistant").version("1.0.0").addHelpText("after", `
+program.name("stint").description("Stint Agent - Local daemon for Stint Project Assistant").version(AGENT_VERSION, "-V, --version", "output the current version").addHelpText("after", `
 ${chalk10.bold("Examples:")}
   ${chalk10.cyan("$")} stint login                 ${chalk10.gray("# Authenticate with Stint")}
   ${chalk10.cyan("$")} stint link                  ${chalk10.gray("# Link current directory to a project")}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gowelle/stint-agent",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Local agent for Stint - Project Assistant",
   "author": "Gowelle John <gowelle.john@icloud.com>",
   "license": "MIT",
@@ -36,12 +36,13 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@inquirer/prompts": "^5.0.0",
+    "@inquirer/prompts": "^5.5.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "conf": "^12.0.0",
     "dotenv": "^17.2.3",
     "node-fetch": "^3.3.2",
+    "node-notifier": "^10.0.1",
     "open": "^10.0.0",
     "ora": "^8.0.1",
     "simple-git": "^3.22.0",
@@ -49,6 +50,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
+    "@types/node-notifier": "^8.0.5",
     "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^8.50.0",
     "@typescript-eslint/parser": "^8.50.0",
@@ -60,4 +62,4 @@
   "engines": {
     "node": ">=20.0.0"
   }
-}
+}