apigrip 0.1.0 → 0.2.0

package/cli/commands/serve.js

@@ -1,12 +1,62 @@
 import fs from 'node:fs';
+import path from 'node:path';
 import { parseSpec } from '../../core/spec-parser.js';
 import { createServer } from '../../server/index.js';
-import { resolveProjectContext } from '../resolve-project.js';
+import { findProjectForDir } from '../../core/projects-store.js';
+
+const ROOT_SPEC_FILES = ['openapi.yaml', 'openapi.yml', 'openapi.json', 'swagger.yaml', 'swagger.yml', 'swagger.json'];
+
+/**
+ * Quick project resolution for the serve command.
+ * Unlike resolveProjectContext, this never does BFS discovery.
+ * Only auto-opens cwd if it's a git repo with a root-level spec file.
+ */
+async function resolveServeProject(argv) {
+  // 1. Explicit flags take priority
+  if (argv.spec) {
+    const projectDir = argv.project || process.cwd();
+    return { projectDir, specPath: argv.spec };
+  }
+  if (argv.project) {
+    const specPath = findRootSpec(argv.project);
+    return { projectDir: argv.project, specPath };
+  }
+
+  // 2. Check if cwd is inside a bookmarked project
+  const cwd = process.cwd();
+  const bookmark = findProjectForDir(cwd);
+  if (bookmark) {
+    const specPath = bookmark.spec || findRootSpec(bookmark.path);
+    return { projectDir: bookmark.path, specPath };
+  }
+
+  // 3. Only auto-open cwd if it's a git repo with a root-level spec
+  const isGitRepo = fs.existsSync(path.join(cwd, '.git'));
+  if (isGitRepo) {
+    const specPath = findRootSpec(cwd);
+    if (specPath) {
+      return { projectDir: cwd, specPath };
+    }
+  }
+
+  // 4. Start without a project — user can open from history in the UI
+  return { projectDir: null, specPath: null };
+}
+
+function findRootSpec(dir) {
+  for (const name of ROOT_SPEC_FILES) {
+    const p = path.join(dir, name);
+    try {
+      if (fs.statSync(p).isFile()) return p;
+    } catch { /* not found */ }
+  }
+  return null;
+}
 
 export async function serveCommand(argv) {
-  const { projectDir, specPath } = await resolveProjectContext(argv);
+  const { projectDir, specPath } = await resolveServeProject(argv);
 
-  if (!fs.existsSync(projectDir)) {
+  if (projectDir && !fs.existsSync(projectDir)) {
     console.error(`Project directory does not exist: ${projectDir}`);
     process.exitCode = 2;
     return;
@@ -34,8 +84,11 @@ export async function serveCommand(argv) {
 
   const { app } = createServer({ projectDir, specPath, spec, noBrowse });
 
-  app.listen(port, host, () => {
+  const server = app.listen(port, host, () => {
     console.log(`Server listening on http://${host}:${port}`);
+    if (projectDir) {
+      console.log(`Project: ${projectDir}`);
+    }
     if (argv.open) {
       import('child_process').then(({ exec }) => {
         const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
@@ -43,4 +96,15 @@ export async function serveCommand(argv) {
       });
     }
   });
+
+  server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+      console.error(`Error: Port ${port} is already in use. Try --port <number>`);
+    } else if (err.code === 'EACCES') {
+      console.error(`Error: Permission denied for port ${port}. Try a port above 1024.`);
+    } else {
+      console.error(`Error starting server: ${err.message}`);
+    }
+    process.exitCode = 1;
+  });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apigrip",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A spec-first, read-only OpenAPI client for developers",
   "type": "module",
   "main": "./lib/index.cjs",

package/server/routes/project.js

@@ -2,6 +2,7 @@ import { Router } from 'express';
 import { getGitInfo } from '../../core/git-info.js';
 import { parseSpec } from '../../core/spec-parser.js';
 import { discoverSpec } from '../../core/spec-discovery.js';
+import { addProject } from '../../core/projects-store.js';
 import { broadcast } from './events.js';
 import path from 'path';
 import fs from 'fs';
@@ -62,6 +63,9 @@ export function createProjectRoutes(state) {
     // Switch project
     state.projectDir = newPath;
 
+    // Auto-bookmark the project
+    try { addProject(newPath); } catch { /* already bookmarked or invalid — ignore */ }
+
     // Discover and parse spec
     const specResult = await discoverSpec(newPath);
     state.specPath = specResult?.specPath || null;