@lovelybunch/api 1.0.78-alpha.0 → 1.0.78-alpha.2

package/dist/lib/jobs/job-scheduler.js

@@ -125,6 +125,18 @@ export class JobScheduler {
         const job = await this.store.getJob(jobId);
         if (!job) {
             console.warn(`Attempted to run missing job ${jobId}`);
+            this.clearTimer(jobId);
+            this.jobs.delete(jobId);
+            return null;
+        }
+        // Re-validate status after the disk read. A scheduled timer may have been
+        // armed when the job was active, but the user (or another process) may have
+        // paused the job in the interim. Refuse to spawn in that case and drop the
+        // stale timer so we don't keep re-firing.
+        if (trigger === 'scheduled' && job.status !== 'active') {
+            console.warn(`Skipping scheduled run for job ${jobId}: status is ${job.status}`);
+            this.clearTimer(jobId);
+            this.jobs.set(jobId, { job });
             return null;
         }
         this.runningJobs.add(jobId);
@@ -245,15 +257,38 @@ export class JobScheduler {
                 }).catch(err => console.warn('[jobs] Slack notification failed:', err));
             }).catch(() => { });
         }
+        // Re-read the job from disk so any pause/edit/delete that happened during
+        // the run wins over our in-memory snapshot. Without this, the completion
+        // write silently reverts concurrent user changes and resurrects deleted
+        // job files, and the subsequent register() re-arms a timer based on the
+        // stale start-of-run status.
+        const fresh = await this.store.getJob(job.id);
+        if (!fresh || fresh._error) {
+            if (!fresh) {
+                console.warn(`Job ${job.id} was deleted during run; not persisting completion state`);
+            }
+            else {
+                console.warn(`Job ${job.id} is corrupted on disk; not persisting completion state`);
+            }
+            this.runningJobs.delete(jobId);
+            this.clearTimer(jobId);
+            this.jobs.delete(jobId);
+            return outcome;
+        }
+        fresh.runs = [runRecord, ...fresh.runs.filter((r) => r.id !== runRecord.id)].slice(0, 50);
+        fresh.metadata.lastRunAt = start;
+        fresh.metadata.updatedAt = new Date();
         try {
-            await this.store.saveJob(job);
+            await this.store.saveJob(fresh);
         }
         catch (error) {
             console.error(`Failed to persist run state for job ${job.id}:`, error);
         }
         this.runningJobs.delete(jobId);
-        // Refresh schedule for next execution
-        await this.register(job);
+        // Refresh schedule for next execution from the fresh on-disk state. If the
+        // user paused mid-run, fresh.status === 'paused' and register() will clear
+        // the timer rather than re-arming it.
+        await this.register(fresh);
         return outcome;
     }
     async updateJobMetadata(job, nextRun) {

package/dist/routes/api/v1/context/architecture/route.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;

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

@@ -0,0 +1,245 @@
+import { Hono } from 'hono';
+import { promises as fs } from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+import { findGaitDirectory } from '../../../../../lib/gait-path.js';
+import { getLogger, ContextKinds } from '@lovelybunch/core/logging';
+import { requireAuth } from '../../../../../middleware/auth.js';
+// Helper function to generate a simple summary from content
+function generateSummary(content, maxLines = 3, maxChars = 200) {
+    // Remove markdown formatting for cleaner summary
+    const cleanContent = content
+        .replace(/^#+\s+/gm, '') // Remove headings
+        .replace(/[*_`]/g, '') // Remove bold, italic, code
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // Convert links to text
+        .trim();
+    // Get first few lines
+    const lines = cleanContent.split('\n').filter(line => line.trim().length > 0);
+    const summary = lines.slice(0, maxLines).join(' ');
+    // Truncate if too long
+    return summary.length > maxChars
+        ? summary.substring(0, maxChars) + '...'
+        : summary;
+}
+const app = new Hono();
+async function getArchitecturePath() {
+    const gaitDir = await findGaitDirectory();
+    if (!gaitDir)
+        return null;
+    return path.join(gaitDir, 'context');
+}
+/**
+ * GET /api/v1/context/architecture
+ * Load architecture document
+ */
+app.get('/', async (c) => {
+    try {
+        const architecturePath = await getArchitecturePath();
+        if (!architecturePath) {
+            return c.json({
+                success: false,
+                error: 'GAIT directory not found'
+            }, 404);
+        }
+        // Ensure directory exists
+        await fs.mkdir(architecturePath, { recursive: true });
+        // Look for architecture.md file
+        const filePath = path.join(architecturePath, 'architecture.md');
+        try {
+            const fileContent = await fs.readFile(filePath, 'utf-8');
+            const { data, content } = matter(fileContent);
+            // Extract title from first heading or use default
+            const title = content.match(/^#\s+(.+)$/m)?.[1] || 'Architecture Overview';
+            const document = {
+                filename: 'architecture.md',
+                metadata: {
+                    ...data,
+                    updated: data.updated || new Date().toISOString().split('T')[0],
+                    type: 'architecture',
+                    category: 'design',
+                    tags: data.tags || []
+                },
+                content,
+                title
+            };
+            return c.json({
+                success: true,
+                document
+            });
+        }
+        catch (fileError) {
+            // If file doesn't exist, return default content
+            const defaultContent = `# Architecture Overview
+
+This document describes the overall architecture and design patterns used in this project.
+
+## System Architecture
+
+Describe the high-level system architecture, including major components and their relationships.
+
+## Design Patterns
+
+Document the key design patterns and architectural principles followed in this project.
+
+### Frontend Architecture
+
+- Component structure
+- State management
+- Routing approach
+- UI/UX patterns
+
+### Backend Architecture
+
+- API design
+- Data layer
+- Service architecture
+- Authentication & authorization
+
+## Data Flow
+
+Explain how data flows through the system, including:
+
+- Request/response cycles
+- Data transformations
+- Caching strategies
+- Error handling
+
+## Technology Decisions
+
+Document key technology choices and the reasoning behind them:
+
+- Framework selections
+- Database choices
+- Third-party integrations
+- Development tools
+
+## Deployment Architecture
+
+Describe the deployment strategy and infrastructure:
+
+- Environment setup
+- CI/CD pipeline
+- Monitoring and logging
+- Scaling considerations
+
+## Security Considerations
+
+Outline security measures and best practices:
+
+- Authentication mechanisms
+- Data protection
+- API security
+- Infrastructure security
+
+## Performance Considerations
+
+Document performance optimization strategies:
+
+- Caching layers
+- Database optimization
+- Frontend performance
+- Monitoring and metrics
+`;
+            const document = {
+                filename: 'architecture.md',
+                metadata: {
+                    version: '1.0',
+                    updated: new Date().toISOString().split('T')[0],
+                    type: 'architecture',
+                    category: 'design',
+                    tags: []
+                },
+                content: defaultContent,
+                title: 'Architecture Overview'
+            };
+            return c.json({
+                success: true,
+                document
+            });
+        }
+    }
+    catch (error) {
+        console.error('Error loading architecture document:', error);
+        return c.json({
+            success: false,
+            error: 'Failed to load architecture document'
+        }, 500);
+    }
+});
+/**
+ * PUT /api/v1/context/architecture
+ * Update architecture document
+ */
+app.put('/', async (c) => {
+    try {
+        const body = await c.req.json();
+        if (!body.content) {
+            return c.json({ success: false, error: 'Content is required' }, 400);
+        }
+        const architecturePath = await getArchitecturePath();
+        if (!architecturePath) {
+            return c.json({ success: false, error: 'GAIT directory not found' }, 404);
+        }
+        await fs.mkdir(architecturePath, { recursive: true });
+        const filePath = path.join(architecturePath, 'architecture.md');
+        // Read current content if it exists
+        let currentData = {};
+        try {
+            const currentContent = await fs.readFile(filePath, 'utf-8');
+            const { data } = matter(currentContent);
+            currentData = data;
+        }
+        catch {
+            // File doesn't exist, use defaults
+        }
+        // Prepare updated metadata
+        const updatedMetadata = {
+            ...currentData,
+            ...body.metadata,
+            updated: new Date().toISOString().split('T')[0],
+            type: 'architecture',
+            category: 'design',
+            version: currentData.version || '1.0'
+        };
+        // Create the markdown content with frontmatter
+        const fileContent = matter.stringify(body.content, updatedMetadata);
+        await fs.writeFile(filePath, fileContent, 'utf-8');
+        // Extract updated title
+        const title = body.title ||
+            body.content.match(/^#\s+(.+)$/m)?.[1] ||
+            'Architecture Overview';
+        // Log architecture update event
+        try {
+            const session = await requireAuth(c);
+            const actor = session ? `human:${session.email}` : "human:unknown";
+            const logger = getLogger();
+            logger.log({
+                kind: ContextKinds.ARCHITECTURE_UPDATE,
+                actor,
+                subject: `context:architecture.md`,
+                tags: ["context", "architecture"],
+                payload: {
+                    title,
+                    summary: generateSummary(body.content),
+                }
+            });
+        }
+        catch (logError) {
+            console.error('Error logging architecture update:', logError);
+        }
+        return c.json({
+            success: true,
+            document: {
+                filename: 'architecture.md',
+                title,
+                metadata: updatedMetadata,
+                content: body.content
+            }
+        });
+    }
+    catch (error) {
+        console.error('Error updating architecture document:', error);
+        return c.json({ success: false, error: 'Failed to update architecture document' }, 500);
+    }
+});
+export default app;

package/dist/routes/api/v1/context/project/route.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export default app;

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

@@ -0,0 +1,200 @@
+import { Hono } from 'hono';
+import { promises as fs } from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+import { findGaitDirectory } from '../../../../../lib/gait-path.js';
+import { getLogger, ContextKinds } from '@lovelybunch/core/logging';
+import { requireAuth } from '../../../../../middleware/auth.js';
+// Helper function to generate a simple summary from content
+function generateSummary(content, maxLines = 3, maxChars = 200) {
+    // Remove markdown formatting for cleaner summary
+    const cleanContent = content
+        .replace(/^#+\s+/gm, '') // Remove headings
+        .replace(/[*_`]/g, '') // Remove bold, italic, code
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // Convert links to text
+        .trim();
+    // Get first few lines
+    const lines = cleanContent.split('\n').filter(line => line.trim().length > 0);
+    const summary = lines.slice(0, maxLines).join(' ');
+    // Truncate if too long
+    return summary.length > maxChars
+        ? summary.substring(0, maxChars) + '...'
+        : summary;
+}
+const app = new Hono();
+async function getProjectPath() {
+    const gaitDir = await findGaitDirectory();
+    if (!gaitDir)
+        return null;
+    return path.join(gaitDir, 'context');
+}
+/**
+ * GET /api/v1/context/project
+ * Load project overview document
+ */
+app.get('/', async (c) => {
+    try {
+        const projectPath = await getProjectPath();
+        if (!projectPath) {
+            return c.json({
+                success: false,
+                error: 'GAIT directory not found'
+            }, 404);
+        }
+        // Ensure directory exists
+        await fs.mkdir(projectPath, { recursive: true });
+        // Look for project.md file
+        const filePath = path.join(projectPath, 'project.md');
+        try {
+            const fileContent = await fs.readFile(filePath, 'utf-8');
+            const { data, content } = matter(fileContent);
+            // Extract title from first heading or use default
+            const title = content.match(/^#\s+(.+)$/m)?.[1] || 'Project Overview';
+            const document = {
+                filename: 'project.md',
+                metadata: {
+                    ...data,
+                    updated: data.updated || new Date().toISOString().split('T')[0],
+                    type: 'project',
+                    category: 'overview',
+                    tags: data.tags || []
+                },
+                content,
+                title
+            };
+            return c.json({
+                success: true,
+                document
+            });
+        }
+        catch (fileError) {
+            // If file doesn't exist, return default content
+            const defaultContent = `# Project Overview
+
+This document provides an overview of the project, including its purpose, goals, and key information.
+
+## Purpose
+
+Describe the main purpose and objectives of this project.
+
+## Key Features
+
+- Feature 1
+- Feature 2
+- Feature 3
+
+## Technology Stack
+
+List the main technologies, frameworks, and tools used in this project.
+
+## Getting Started
+
+Provide instructions for setting up and running the project locally.
+
+## Documentation
+
+Links to additional documentation, guides, and resources.
+`;
+            const document = {
+                filename: 'project.md',
+                metadata: {
+                    version: '1.0',
+                    updated: new Date().toISOString().split('T')[0],
+                    type: 'project',
+                    category: 'overview',
+                    tags: []
+                },
+                content: defaultContent,
+                title: 'Project Overview'
+            };
+            return c.json({
+                success: true,
+                document
+            });
+        }
+    }
+    catch (error) {
+        console.error('Error loading project document:', error);
+        return c.json({
+            success: false,
+            error: 'Failed to load project document'
+        }, 500);
+    }
+});
+/**
+ * PUT /api/v1/context/project
+ * Update project overview document
+ */
+app.put('/', async (c) => {
+    try {
+        const body = await c.req.json();
+        if (!body.content) {
+            return c.json({ success: false, error: 'Content is required' }, 400);
+        }
+        const projectPath = await getProjectPath();
+        if (!projectPath) {
+            return c.json({ success: false, error: 'GAIT directory not found' }, 404);
+        }
+        await fs.mkdir(projectPath, { recursive: true });
+        const filePath = path.join(projectPath, 'project.md');
+        // Read current content if it exists
+        let currentData = {};
+        try {
+            const currentContent = await fs.readFile(filePath, 'utf-8');
+            const { data } = matter(currentContent);
+            currentData = data;
+        }
+        catch {
+            // File doesn't exist, use defaults
+        }
+        // Prepare updated metadata
+        const updatedMetadata = {
+            ...currentData,
+            ...body.metadata,
+            updated: new Date().toISOString().split('T')[0],
+            type: 'project',
+            category: 'overview',
+            version: currentData.version || '1.0'
+        };
+        // Create the markdown content with frontmatter
+        const fileContent = matter.stringify(body.content, updatedMetadata);
+        await fs.writeFile(filePath, fileContent, 'utf-8');
+        // Extract updated title
+        const title = body.title ||
+            body.content.match(/^#\s+(.+)$/m)?.[1] ||
+            'Project Overview';
+        // Log project update event
+        try {
+            const session = await requireAuth(c);
+            const actor = session ? `human:${session.email}` : "human:unknown";
+            const logger = getLogger();
+            logger.log({
+                kind: ContextKinds.PROJECT_UPDATE,
+                actor,
+                subject: `context:project.md`,
+                tags: ["context", "project"],
+                payload: {
+                    title,
+                    summary: generateSummary(body.content),
+                }
+            });
+        }
+        catch (logError) {
+            console.error('Error logging project update:', logError);
+        }
+        return c.json({
+            success: true,
+            document: {
+                filename: 'project.md',
+                title,
+                metadata: updatedMetadata,
+                content: body.content
+            }
+        });
+    }
+    catch (error) {
+        console.error('Error updating project document:', error);
+        return c.json({ success: false, error: 'Failed to update project document' }, 500);
+    }
+});
+export default app;

package/dist/routes/api/v1/jobs/[id]/route.d.ts

@@ -9,6 +9,9 @@ export declare function GET(c: Context): Promise<(Response & import("hono").Type
 }, 404, "json">) | (Response & import("hono").TypedResponse<{
     success: true;
     data: {
+        id: string;
+        name: string;
+        status: ScheduledJobStatus;
         schedule: {
             type: "cron";
             expression: string;
@@ -22,11 +25,8 @@ export declare function GET(c: Context): Promise<(Response & import("hono").Type
             anchorHour?: number;
         };
         description?: string;
-        id: string;
-        name: string;
         prompt: string;
         model: string;
-        status: ScheduledJobStatus;
         metadata: {
             createdAt: string;
             updatedAt: string;
@@ -39,13 +39,13 @@ export declare function GET(c: Context): Promise<(Response & import("hono").Type
         agentIds?: string[];
         mcpServers?: string[];
         runs: {
+            error?: string;
             id: string;
             status: import("@lovelybunch/types").ScheduledJobRunStatus;
             jobId: string;
             trigger: import("@lovelybunch/types").ScheduledJobTrigger;
             startedAt: string;
             finishedAt?: string;
-            error?: string;
         }[];
     };
 }, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
@@ -70,6 +70,9 @@ export declare function PATCH(c: Context): Promise<(Response & import("hono").Ty
 }, 400, "json">) | (Response & import("hono").TypedResponse<{
     success: true;
     data: {
+        id: string;
+        name: string;
+        status: ScheduledJobStatus;
         schedule: {
             type: "cron";
             expression: string;
@@ -83,11 +86,8 @@ export declare function PATCH(c: Context): Promise<(Response & import("hono").Ty
             anchorHour?: number;
         };
         description?: string;
-        id: string;
-        name: string;
         prompt: string;
         model: string;
-        status: ScheduledJobStatus;
         metadata: {
             createdAt: string;
             updatedAt: string;
@@ -100,13 +100,13 @@ export declare function PATCH(c: Context): Promise<(Response & import("hono").Ty
         agentIds?: string[];
         mcpServers?: string[];
         runs: {
+            error?: string;
             id: string;
             status: import("@lovelybunch/types").ScheduledJobRunStatus;
             jobId: string;
             trigger: import("@lovelybunch/types").ScheduledJobTrigger;
             startedAt: string;
             finishedAt?: string;
-            error?: string;
         }[];
     };
 }, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{

package/dist/routes/api/v1/jobs/route.d.ts

@@ -11,6 +11,9 @@ export declare function withLightweightRuns<T extends {
 export declare function GET(c: Context): Promise<(Response & import("hono").TypedResponse<{
     success: true;
     data: {
+        id: string;
+        name: string;
+        status: ScheduledJobStatus;
         schedule: {
             type: "cron";
             expression: string;
@@ -24,11 +27,8 @@ export declare function GET(c: Context): Promise<(Response & import("hono").Type
             anchorHour?: number;
         };
         description?: string;
-        id: string;
-        name: string;
         prompt: string;
         model: string;
-        status: ScheduledJobStatus;
         metadata: {
             createdAt: string;
             updatedAt: string;
@@ -41,13 +41,13 @@ export declare function GET(c: Context): Promise<(Response & import("hono").Type
         agentIds?: string[];
         mcpServers?: string[];
         runs: {
+            error?: string;
             id: string;
             status: import("@lovelybunch/types").ScheduledJobRunStatus;
             jobId: string;
             trigger: import("@lovelybunch/types").ScheduledJobTrigger;
             startedAt: string;
             finishedAt?: string;
-            error?: string;
         }[];
     }[];
 }, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
@@ -66,6 +66,9 @@ export declare function POST(c: Context): Promise<(Response & import("hono").Typ
 }, 400, "json">) | (Response & import("hono").TypedResponse<{
     success: true;
     data: {
+        id: string;
+        name: string;
+        status: ScheduledJobStatus;
         schedule: {
             type: "cron";
             expression: string;
@@ -79,11 +82,8 @@ export declare function POST(c: Context): Promise<(Response & import("hono").Typ
             anchorHour?: number;
         };
         description?: string;
-        id: string;
-        name: string;
         prompt: string;
         model: string;
-        status: ScheduledJobStatus;
         metadata: {
             createdAt: string;
             updatedAt: string;
@@ -96,13 +96,13 @@ export declare function POST(c: Context): Promise<(Response & import("hono").Typ
         agentIds?: string[];
         mcpServers?: string[];
         runs: {
+            error?: string;
             id: string;
             status: import("@lovelybunch/types").ScheduledJobRunStatus;
             jobId: string;
             trigger: import("@lovelybunch/types").ScheduledJobTrigger;
             startedAt: string;
             finishedAt?: string;
-            error?: string;
         }[];
     };
 }, 201, "json">) | (Response & import("hono").TypedResponse<{

package/dist/routes/api/v1/mail/route.d.ts

@@ -116,7 +116,7 @@ export declare function setMailStatusHandler(c: Context): Promise<(Response & im
 }, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
     success: false;
     error: any;
-}, 500 | 404, "json">)>;
+}, 404 | 500, "json">)>;
 /**
  * POST /api/v1/mail/:id/reply
  * Reply to an email
@@ -154,7 +154,7 @@ export declare function replyMailHandler(c: Context): Promise<(Response & import
 }, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
     success: false;
     error: any;
-}, 500 | 404, "json">)>;
+}, 404 | 500, "json">)>;
 /**
  * POST /api/v1/mail/send
  * Send an email (coming soon)
@@ -217,7 +217,7 @@ export declare function setMailActionHandler(c: Context): Promise<(Response & im
 }, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<{
     success: false;
     error: any;
-}, 500 | 404, "json">)>;
+}, 404 | 500, "json">)>;
 /**
  * GET /api/v1/mail/:id/processing
  * Get processing status and log tail for an email