@lovelybunch/api 1.0.22 → 1.0.24

package/dist/lib/gait-path.d.ts

@@ -1,13 +1,25 @@
 /**
- * Find the .gait directory by traversing up from the current working directory
- * If GAIT_DATA_PATH is set (from CLI), use that instead
+ * Get the base path for .gait directory based on environment
+ *
+ * Priority order:
+ * 1. Explicit basePath parameter
+ * 2. Dev mode: GAIT_DEV_ROOT environment variable
+ * 3. Production mode: GAIT_DATA_PATH environment variable
+ * 4. Fallback: current working directory
  */
-export declare function findGaitDirectory(startDir?: string): Promise<string | null>;
+export declare function getGaitBasePath(basePath?: string): string;
 /**
- * Get the path to a context file, automatically finding the .gait directory
+ * Get the full path to a specific .gait subdirectory
  */
-export declare function getContextFilePath(fileName: string): Promise<string | null>;
+export declare function getGaitPath(subdirectory: string, basePath?: string): string;
 /**
- * Get the .gait config to read storage path settings
+ * Common .gait subdirectories
  */
-export declare function getGaitConfig(): Promise<any | null>;
+export declare const GAIT_PATHS: {
+    readonly proposals: () => string;
+    readonly context: () => string;
+    readonly agents: () => string;
+    readonly resources: () => string;
+    readonly chats: () => string;
+    readonly config: () => string;
+};

package/dist/lib/gait-path.js

@@ -1,57 +1,45 @@
-import { promises as fs } from 'fs';
 import path from 'path';
 /**
- * Find the .gait directory by traversing up from the current working directory
- * If GAIT_DATA_PATH is set (from CLI), use that instead
+ * Get the base path for .gait directory based on environment
+ *
+ * Priority order:
+ * 1. Explicit basePath parameter
+ * 2. Dev mode: GAIT_DEV_ROOT environment variable
+ * 3. Production mode: GAIT_DATA_PATH environment variable
+ * 4. Fallback: current working directory
  */
-export async function findGaitDirectory(startDir) {
-    // If running from CLI (gait serve), use the directory where command was run
-    if (process.env.GAIT_DATA_PATH) {
-        const gaitPath = path.join(process.env.GAIT_DATA_PATH, '.gait');
-        try {
-            await fs.access(gaitPath);
-            return gaitPath;
-        }
-        catch {
-            // Fall through to directory traversal
-        }
+export function getGaitBasePath(basePath) {
+    if (basePath) {
+        return basePath;
     }
-    // Otherwise traverse up from start directory
-    let currentDir = startDir || process.cwd();
-    while (currentDir !== path.parse(currentDir).root) {
-        const gaitPath = path.join(currentDir, '.gait');
-        try {
-            await fs.access(gaitPath);
-            return gaitPath;
-        }
-        catch {
-            currentDir = path.dirname(currentDir);
-        }
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        return process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        return path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        return path.resolve(process.cwd(), '.gait');
     }
-    return null;
 }
 /**
- * Get the path to a context file, automatically finding the .gait directory
+ * Get the full path to a specific .gait subdirectory
  */
-export async function getContextFilePath(fileName) {
-    const gaitDir = await findGaitDirectory();
-    if (!gaitDir)
-        return null;
-    return path.join(gaitDir, 'context', fileName);
+export function getGaitPath(subdirectory, basePath) {
+    const base = getGaitBasePath(basePath);
+    return path.join(base, subdirectory);
 }
 /**
- * Get the .gait config to read storage path settings
+ * Common .gait subdirectories
  */
-export async function getGaitConfig() {
-    const gaitDir = await findGaitDirectory();
-    if (!gaitDir)
-        return null;
-    const configPath = path.join(gaitDir, 'config.json');
-    try {
-        const config = await fs.readFile(configPath, 'utf-8');
-        return JSON.parse(config);
-    }
-    catch {
-        return null;
-    }
-}
+export const GAIT_PATHS = {
+    proposals: () => getGaitPath('proposals'),
+    context: () => getGaitPath('context'),
+    agents: () => getGaitPath('agents'),
+    resources: () => getGaitPath('resources'),
+    chats: () => getGaitPath('chats'),
+    config: () => getGaitPath(''),
+};

package/dist/lib/storage/file-storage.js

@@ -2,13 +2,11 @@ import { promises as fs } from 'fs';
 import path from 'path';
 import matter from 'gray-matter';
 import Fuse from 'fuse.js';
+import { getGaitPath } from '../gait-path.js';
 export class FileStorageAdapter {
     basePath;
     constructor(basePath) {
-        // Use environment variable if available (for web server), otherwise default to .gait
-        this.basePath = basePath || (process.env.GAIT_DATA_PATH ?
-            path.join(process.env.GAIT_DATA_PATH, '.gait') :
-            '.gait');
+        this.basePath = basePath || getGaitPath('proposals');
     }
     async ensureDirectories() {
         const dirs = ['proposals', 'specs', 'flags', 'experiments', 'templates'];

package/dist/routes/api/v1/agents/[id]/route.js

@@ -4,9 +4,19 @@ import path from 'path';
 import matter from 'gray-matter';
 const app = new Hono();
 function getAgentsPath() {
-    const basePath = process.env.GAIT_DATA_PATH ?
-        path.resolve(process.env.GAIT_DATA_PATH, '.gait') :
-        path.resolve(process.cwd(), '.gait');
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
     return path.join(basePath, 'agents');
 }
 function generateFilename(name) {

package/dist/routes/api/v1/agents/route.js

@@ -4,9 +4,19 @@ import path from 'path';
 import matter from 'gray-matter';
 const app = new Hono();
 function getAgentsPath() {
-    const basePath = process.env.GAIT_DATA_PATH ?
-        path.resolve(process.env.GAIT_DATA_PATH, '.gait') :
-        path.resolve(process.cwd(), '.gait');
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
     return path.join(basePath, 'agents');
 }
 function generateFilename(name) {

package/dist/routes/api/v1/chats/[id]/route.js

@@ -1,6 +1,22 @@
 import { readFile, unlink } from "fs/promises";
-import { join } from "path";
-const CHATS_DIR = join(process.cwd(), ".gait", "chats");
+import { join, resolve } from "path";
+function getChatsPath() {
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = resolve(process.cwd(), '.gait');
+    }
+    return join(basePath, 'chats');
+}
+const CHATS_DIR = getChatsPath();
 export async function GET(c) {
     try {
         const id = c.req.param('id');

package/dist/routes/api/v1/chats/route.js

@@ -1,6 +1,22 @@
 import { writeFile, readdir, readFile, mkdir } from "fs/promises";
-import { join } from "path";
-const CHATS_DIR = join(process.cwd(), ".gait", "chats");
+import { join, resolve } from "path";
+function getChatsPath() {
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = resolve(process.cwd(), '.gait');
+    }
+    return join(basePath, 'chats');
+}
+const CHATS_DIR = getChatsPath();
 export async function GET(c) {
     try {
         // Ensure chats directory exists

package/dist/routes/api/v1/config/route.js

@@ -2,9 +2,19 @@ import { promises as fs } from 'fs';
 import path from 'path';
 async function getConfigPath() {
     // Use the same approach as FileStorageAdapter for consistency
-    const basePath = process.env.GAIT_DATA_PATH ?
-        path.resolve(process.env.GAIT_DATA_PATH, '.gait') :
-        path.resolve(process.cwd(), '.gait');
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
     return path.join(basePath, 'config.json');
 }
 export async function GET(c) {

package/dist/routes/api/v1/context/architecture/route.js

@@ -4,9 +4,19 @@ import path from 'path';
 import matter from 'gray-matter';
 const app = new Hono();
 function getArchitecturePath() {
-    const basePath = process.env.GAIT_DATA_PATH ?
-        path.resolve(process.env.GAIT_DATA_PATH, '.gait') :
-        path.resolve(process.cwd(), '.gait');
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
     return path.join(basePath, 'context');
 }
 /**

package/dist/routes/api/v1/context/knowledge/[filename]/route.js

@@ -4,9 +4,19 @@ import path from 'path';
 import matter from 'gray-matter';
 const app = new Hono();
 function getKnowledgePath() {
-    const basePath = process.env.GAIT_DATA_PATH ?
-        path.resolve(process.env.GAIT_DATA_PATH, '.gait') :
-        path.resolve(process.cwd(), '.gait');
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
     return path.join(basePath, 'context', 'knowledge');
 }
 function generateFilename(title) {

package/dist/routes/api/v1/context/knowledge/route.js

@@ -5,9 +5,19 @@ import matter from 'gray-matter';
 import filenameRoute from './[filename]/index.js';
 const app = new Hono();
 function getKnowledgePath() {
-    const basePath = process.env.GAIT_DATA_PATH ?
-        path.resolve(process.env.GAIT_DATA_PATH, '.gait') :
-        path.resolve(process.cwd(), '.gait');
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
     return path.join(basePath, 'context', 'knowledge');
 }
 function generateFilename(title) {

package/dist/routes/api/v1/context/project/route.js

@@ -4,9 +4,19 @@ import path from 'path';
 import matter from 'gray-matter';
 const app = new Hono();
 function getProjectPath() {
-    const basePath = process.env.GAIT_DATA_PATH ?
-        path.resolve(process.env.GAIT_DATA_PATH, '.gait') :
-        path.resolve(process.cwd(), '.gait');
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
     return path.join(basePath, 'context');
 }
 /**

package/dist/routes/api/v1/resources/[id]/route.js

@@ -1,6 +1,22 @@
 import { promises as fs } from 'fs';
 import path from 'path';
-const RESOURCES_DIR = '.gait/resources';
+function getResourcesPath() {
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
+    return path.join(basePath, 'resources');
+}
+const RESOURCES_DIR = getResourcesPath();
 const FILES_DIR = path.join(RESOURCES_DIR, 'files');
 const METADATA_DIR = path.join(RESOURCES_DIR, 'metadata');
 async function getResourceMetadata(id) {

package/dist/routes/api/v1/resources/[id]/thumbnail/route.js

@@ -1,6 +1,22 @@
 import { promises as fs } from 'fs';
 import path from 'path';
-const RESOURCES_DIR = '.gait/resources';
+function getResourcesPath() {
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
+    return path.join(basePath, 'resources');
+}
+const RESOURCES_DIR = getResourcesPath();
 const METADATA_DIR = path.join(RESOURCES_DIR, 'metadata');
 const THUMBNAILS_DIR = path.join(RESOURCES_DIR, 'thumbnails');
 async function getResourceMetadata(id) {

package/dist/routes/api/v1/resources/route.js

@@ -4,7 +4,23 @@ import path from 'path';
 function generateId() {
     return `res-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
 }
-const RESOURCES_DIR = '.gait/resources';
+function getResourcesPath() {
+    let basePath;
+    if (process.env.NODE_ENV === 'development' && process.env.GAIT_DEV_ROOT) {
+        // Dev mode: use project root .gait directory
+        basePath = process.env.GAIT_DEV_ROOT;
+    }
+    else if (process.env.GAIT_DATA_PATH) {
+        // Production mode: use GAIT_DATA_PATH (set by CLI)
+        basePath = path.resolve(process.env.GAIT_DATA_PATH, '.gait');
+    }
+    else {
+        // Fallback: use current directory .gait
+        basePath = path.resolve(process.cwd(), '.gait');
+    }
+    return path.join(basePath, 'resources');
+}
+const RESOURCES_DIR = getResourcesPath();
 const FILES_DIR = path.join(RESOURCES_DIR, 'files');
 const METADATA_DIR = path.join(RESOURCES_DIR, 'metadata');
 const THUMBNAILS_DIR = path.join(RESOURCES_DIR, 'thumbnails');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovelybunch/api",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "type": "module",
   "main": "dist/server-with-static.js",
   "exports": {
@@ -12,7 +12,7 @@
     "static/**/*"
   ],
   "scripts": {
-    "dev": "tsx watch src/server.ts",
+    "dev": "NODE_ENV=development GAIT_DEV_ROOT=../../.gait tsx watch src/server.ts",
     "build": "tsc",
     "build:bundle": "tsc && node scripts/bundle-frontend.js",
     "start": "node dist/server-with-static.js",
@@ -32,8 +32,8 @@
   "dependencies": {
     "@hono/node-server": "^1.13.7",
     "@hono/node-ws": "^1.0.6",
-    "@lovelybunch/core": "^1.0.22",
-    "@lovelybunch/types": "^1.0.22",
+    "@lovelybunch/core": "^1.0.24",
+    "@lovelybunch/types": "^1.0.24",
     "dotenv": "^17.2.1",
     "fuse.js": "^7.0.0",
     "gray-matter": "^4.0.3",