@sudocode-ai/local-server 0.1.0

package/dist/services/prompt-template-engine.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Prompt Template Engine
+ *
+ * Simple template engine with Handlebars-like syntax for rendering prompts.
+ * Supports variable substitution, conditionals, and loops.
+ *
+ * @module services/prompt-template-engine
+ */
+/**
+ * PromptTemplateEngine - Render templates with context variables
+ *
+ * Template Syntax:
+ * - Variables: {{variable}} or {{object.nested.path}}
+ * - Conditionals: {{#if variable}}content{{/if}}
+ * - Loops: {{#each array}}content{{/each}}
+ *
+ * @example
+ * ```typescript
+ * const engine = new PromptTemplateEngine();
+ * const result = engine.render(
+ *   'Hello {{name}}!',
+ *   { name: 'World' }
+ * );
+ * // Result: 'Hello World!'
+ * ```
+ */
+export declare class PromptTemplateEngine {
+    /**
+     * Render template with context variables
+     *
+     * @param template - Template string with {{variable}} syntax
+     * @param context - Object containing variable values
+     * @returns Rendered template string
+     *
+     * @example
+     * ```typescript
+     * const template = `
+     *   Issue: {{issue.title}}
+     *   {{#if issue.description}}
+     *   Description: {{issue.description}}
+     *   {{/if}}
+     *   {{#each specs}}
+     *   - [[{{id}}]]: {{title}}
+     *   {{/each}}
+     * `;
+     *
+     * const context = {
+     *   issue: { title: 'Bug fix', description: 'Fix auth' },
+     *   specs: [{ id: 'SPEC-001', title: 'Auth' }]
+     * };
+     *
+     * engine.render(template, context);
+     * ```
+     */
+    render(template: string, context: Record<string, any>): string;
+    /**
+     * Replace one {{#each}} loop with balanced tags
+     * Processes innermost loop first
+     */
+    private replaceLoop;
+    /**
+     * Replace one {{#if}} conditional with balanced tags
+     */
+    private replaceConditional;
+    /**
+     * Find a balanced {{#tagName}} ... {{/tagName}} pair
+     * Returns the FIRST match (outermost, will be processed recursively)
+     */
+    private findBalancedTag;
+    /**
+     * Get nested value from context using dot notation
+     *
+     * @param context - Context object
+     * @param path - Dot-separated path (e.g., 'user.name')
+     * @returns Value at path or undefined
+     *
+     * @example
+     * ```typescript
+     * getValue({ user: { name: 'Alice' } }, 'user.name')
+     * // Returns: 'Alice'
+     * ```
+     */
+    private getValue;
+    /**
+     * Validate template syntax
+     *
+     * Checks for:
+     * - Balanced {{#if}} / {{/if}} tags
+     * - Balanced {{#each}} / {{/each}} tags
+     *
+     * @param template - Template string to validate
+     * @returns Validation result with errors if any
+     *
+     * @example
+     * ```typescript
+     * engine.validate('{{#if x}}content{{/if}}')
+     * // Returns: { valid: true, errors: [] }
+     *
+     * engine.validate('{{#if x}}content')
+     * // Returns: { valid: false, errors: ['Unbalanced {{#if}} tags'] }
+     * ```
+     */
+    validate(template: string): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=prompt-template-engine.d.ts.map

package/dist/services/prompt-template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-template-engine.d.ts","sourceRoot":"","sources":["../../src/services/prompt-template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IA8B9D;;;OAGG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IA8CvB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ;IAYhB;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAwBjE"}

package/dist/services/prompt-templates.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Prompt Templates Service
+ *
+ * Manages prompt templates in the database, including:
+ * - Seeding default templates
+ * - Loading templates by ID or type
+ * - Validating template syntax
+ *
+ * @module services/prompt-templates
+ */
+import type Database from 'better-sqlite3';
+/**
+ * Prompt template record from database
+ */
+export interface PromptTemplate {
+    id: string;
+    name: string;
+    description: string | null;
+    type: 'issue' | 'spec' | 'custom';
+    template: string;
+    variables: string;
+    is_default: number;
+    created_at: number;
+    updated_at: number;
+}
+/**
+ * Initialize default prompt templates in the database
+ *
+ * This function is idempotent - it will only insert templates if they don't exist.
+ * Should be called during database initialization.
+ *
+ * @param db - Database instance
+ */
+export declare function initializeDefaultTemplates(db: Database.Database): void;
+/**
+ * Get default template for a specific type
+ *
+ * @param db - Database instance
+ * @param type - Template type (issue, spec, custom)
+ * @returns Default template or null if not found
+ */
+export declare function getDefaultTemplate(db: Database.Database, type: 'issue' | 'spec' | 'custom'): PromptTemplate | null;
+/**
+ * Get template by ID
+ *
+ * @param db - Database instance
+ * @param templateId - Template ID
+ * @returns Template or null if not found
+ */
+export declare function getTemplateById(db: Database.Database, templateId: string): PromptTemplate | null;
+/**
+ * List all templates, optionally filtered by type
+ *
+ * @param db - Database instance
+ * @param type - Optional type filter
+ * @returns Array of templates
+ */
+export declare function listTemplates(db: Database.Database, type?: 'issue' | 'spec' | 'custom'): PromptTemplate[];
+/**
+ * Create a new custom template
+ *
+ * @param db - Database instance
+ * @param params - Template parameters
+ * @returns Created template
+ */
+export declare function createTemplate(db: Database.Database, params: {
+    name: string;
+    description?: string;
+    type: 'issue' | 'spec' | 'custom';
+    template: string;
+    variables: string[];
+    isDefault?: boolean;
+}): PromptTemplate;
+/**
+ * Update an existing template
+ *
+ * @param db - Database instance
+ * @param templateId - Template ID
+ * @param updates - Fields to update
+ * @returns Updated template or null if not found
+ */
+export declare function updateTemplate(db: Database.Database, templateId: string, updates: {
+    name?: string;
+    description?: string;
+    template?: string;
+    variables?: string[];
+    isDefault?: boolean;
+}): PromptTemplate | null;
+/**
+ * Delete a template
+ *
+ * @param db - Database instance
+ * @param templateId - Template ID
+ * @returns True if deleted, false if not found
+ */
+export declare function deleteTemplate(db: Database.Database, templateId: string): boolean;
+//# sourceMappingURL=prompt-templates.d.ts.map

package/dist/services/prompt-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-templates.d.ts","sourceRoot":"","sources":["../../src/services/prompt-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAoCD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAsDtE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAChC,cAAc,GAAG,IAAI,CAYvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,GACjB,cAAc,GAAG,IAAI,CAMvB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GACjC,cAAc,EAAE,CAqBlB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACA,cAAc,CA+BhB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACA,cAAc,GAAG,IAAI,CA0DvB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAMT"}

package/dist/services/relationships.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Service layer for Relationships API
+ * Wraps CLI operations for managing relationships between specs and issues
+ */
+import type Database from "better-sqlite3";
+import type { Relationship, EntityType, RelationshipType } from "@sudocode-ai/types";
+import { type CreateRelationshipInput } from "@sudocode-ai/cli/dist/operations/relationships.js";
+/**
+ * Create a new relationship between entities
+ */
+export declare function createRelationship(db: Database.Database, input: CreateRelationshipInput): Relationship;
+/**
+ * Get a specific relationship
+ */
+export declare function getSpecificRelationship(db: Database.Database, from_id: string, from_type: EntityType, to_id: string, to_type: EntityType, relationship_type: RelationshipType): Relationship | null;
+/**
+ * Delete a relationship
+ */
+export declare function deleteRelationship(db: Database.Database, from_id: string, from_type: EntityType, to_id: string, to_type: EntityType, relationship_type: RelationshipType): boolean;
+/**
+ * Get all outgoing relationships from an entity
+ */
+export declare function getEntityOutgoingRelationships(db: Database.Database, entity_id: string, entity_type: EntityType, relationship_type?: RelationshipType): Relationship[];
+/**
+ * Get all incoming relationships to an entity
+ */
+export declare function getEntityIncomingRelationships(db: Database.Database, entity_id: string, entity_type: EntityType, relationship_type?: RelationshipType): Relationship[];
+/**
+ * Get all relationships for an entity (both incoming and outgoing)
+ */
+export declare function getEntityRelationships(db: Database.Database, entity_id: string, entity_type: EntityType): {
+    outgoing: Relationship[];
+    incoming: Relationship[];
+};
+//# sourceMappingURL=relationships.d.ts.map

package/dist/services/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/services/relationships.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,mDAAmD,CAAC;AAE3D;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,uBAAuB,GAC7B,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,EACnB,iBAAiB,EAAE,gBAAgB,GAClC,YAAY,GAAG,IAAI,CASrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,EACnB,iBAAiB,EAAE,gBAAgB,GAClC,OAAO,CAST;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,UAAU,EACvB,iBAAiB,CAAC,EAAE,gBAAgB,GACnC,YAAY,EAAE,CAOhB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,UAAU,EACvB,iBAAiB,CAAC,EAAE,gBAAgB,GACnC,YAAY,EAAE,CAOhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,UAAU,GACtB;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAExD"}

package/dist/services/specs.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Specs service - wraps CLI operations for API use
+ */
+import type Database from "better-sqlite3";
+import { type CreateSpecInput, type UpdateSpecInput, type ListSpecsOptions } from "@sudocode-ai/cli/dist/operations/index.js";
+import type { Spec } from "@sudocode-ai/types";
+/**
+ * Get all specs with optional filtering
+ */
+export declare function getAllSpecs(db: Database.Database, options?: ListSpecsOptions): Spec[];
+/**
+ * Get a single spec by ID
+ */
+export declare function getSpecById(db: Database.Database, id: string): Spec | null;
+/**
+ * Create a new spec
+ */
+export declare function createNewSpec(db: Database.Database, input: CreateSpecInput): Spec;
+/**
+ * Update an existing spec
+ */
+export declare function updateExistingSpec(db: Database.Database, id: string, input: UpdateSpecInput): Spec;
+/**
+ * Delete a spec
+ */
+export declare function deleteExistingSpec(db: Database.Database, id: string): boolean;
+//# sourceMappingURL=specs.d.ts.map

package/dist/services/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/services/specs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,EAAE,CAER;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,eAAe,GACrB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,GACrB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7E"}

package/dist/services/watcher.d.ts

@@ -0,0 +1,50 @@
+/**
+ * File watcher service for the server
+ * Reuses the CLI watcher with server-specific callbacks
+ */
+import type Database from "better-sqlite3";
+import { type WatcherStats } from "@sudocode-ai/cli/dist/watcher.js";
+export interface ServerWatcherOptions {
+    /**
+     * Database instance
+     */
+    db: Database.Database;
+    /**
+     * Base directory to watch (e.g., .sudocode)
+     */
+    baseDir: string;
+    /**
+     * Debounce delay in milliseconds (default: 2000)
+     */
+    debounceDelay?: number;
+    /**
+     * Enable reverse sync (JSONL → Markdown) when JSONL files change (default: false)
+     */
+    syncJSONLToMarkdown?: boolean;
+    /**
+     * Callback for file change events
+     * This will be used to broadcast WebSocket updates
+     */
+    onFileChange?: (info: {
+        filePath: string;
+        event: "add" | "change" | "unlink";
+        entityType?: "spec" | "issue";
+        entityId?: string;
+    }) => void;
+}
+export interface ServerWatcherControl {
+    /**
+     * Stop watching files
+     */
+    stop: () => Promise<void>;
+    /**
+     * Get watcher statistics
+     */
+    getStats: () => WatcherStats;
+}
+/**
+ * Start the file watcher for the server
+ * This wraps the CLI watcher with server-specific logging and callbacks
+ */
+export declare function startServerWatcher(options: ServerWatcherOptions): ServerWatcherControl;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/services/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/services/watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,YAAY,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,GAC5B,oBAAoB,CA4EtB"}

package/dist/services/websocket.d.ts

@@ -0,0 +1,127 @@
+import * as http from "http";
+/**
+ * Message types that the server sends to clients
+ */
+export interface ServerMessage {
+    type: "issue_created" | "issue_updated" | "issue_deleted" | "spec_created" | "spec_updated" | "spec_deleted" | "feedback_created" | "feedback_updated" | "feedback_deleted" | "relationship_created" | "relationship_deleted" | "pong" | "error" | "subscribed" | "unsubscribed";
+    data?: any;
+    message?: string;
+    subscription?: string;
+}
+/**
+ * WebSocket server manager
+ */
+declare class WebSocketManager {
+    private wss;
+    private clients;
+    private heartbeatInterval;
+    private readonly HEARTBEAT_INTERVAL;
+    /**
+     * Initialize the WebSocket server
+     */
+    init(server: http.Server, path?: string): void;
+    /**
+     * Handle new WebSocket connection
+     */
+    private handleConnection;
+    /**
+     * Handle client disconnection
+     */
+    private handleDisconnection;
+    /**
+     * Handle client errors
+     */
+    private handleError;
+    /**
+     * Handle pong response from client
+     */
+    private handlePong;
+    /**
+     * Handle incoming messages from clients
+     */
+    private handleMessage;
+    /**
+     * Handle subscription request
+     */
+    private handleSubscribe;
+    /**
+     * Handle unsubscription request
+     */
+    private handleUnsubscribe;
+    /**
+     * Send a message to a specific client
+     */
+    private sendToClient;
+    /**
+     * Broadcast a message to all subscribed clients
+     */
+    broadcast(entityType: "issue" | "spec", entityId: string, message: ServerMessage): void;
+    /**
+     * Broadcast a relationship or feedback update
+     * These don't have a specific entity type in the subscription, so we broadcast to 'all' subscribers
+     */
+    broadcastGeneric(message: ServerMessage): void;
+    /**
+     * Start the heartbeat mechanism to detect dead connections
+     */
+    private startHeartbeat;
+    /**
+     * Stop the heartbeat mechanism
+     */
+    private stopHeartbeat;
+    /**
+     * Get statistics about connected clients
+     */
+    getStats(): {
+        totalClients: number;
+        clients: Array<{
+            id: string;
+            subscriptions: string[];
+            connectedAt: string;
+            isAlive: boolean;
+        }>;
+    };
+    /**
+     * Gracefully shutdown the WebSocket server
+     */
+    shutdown(): Promise<void>;
+}
+export declare const websocketManager: WebSocketManager;
+/**
+ * Initialize the WebSocket server
+ */
+export declare function initWebSocketServer(server: http.Server, path?: string): void;
+/**
+ * Broadcast issue updates to subscribed clients
+ */
+export declare function broadcastIssueUpdate(issueId: string, action: "created" | "updated" | "deleted", data?: any): void;
+/**
+ * Broadcast spec updates to subscribed clients
+ */
+export declare function broadcastSpecUpdate(specId: string, action: "created" | "updated" | "deleted", data?: any): void;
+/**
+ * Broadcast feedback updates to subscribed clients
+ */
+export declare function broadcastFeedbackUpdate(action: "created" | "updated" | "deleted", data?: any): void;
+/**
+ * Broadcast relationship updates to subscribed clients
+ */
+export declare function broadcastRelationshipUpdate(action: "created" | "deleted", data?: any): void;
+/**
+ * Get WebSocket server statistics
+ */
+export declare function getWebSocketStats(): {
+    totalClients: number;
+    clients: Array<{
+        id: string;
+        subscriptions: string[];
+        connectedAt: string;
+        isAlive: boolean;
+    }>;
+};
+/**
+ * Shutdown the WebSocket server
+ */
+export declare function shutdownWebSocketServer(): Promise<void>;
+export {};
+//# sourceMappingURL=websocket.d.ts.map

package/dist/services/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/services/websocket.ts"],"names":[],"mappings":"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"}

package/dist/utils/sudocode-dir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility to get the SUDOCODE directory path
+ * Respects SUDOCODE_DIR environment variable for testing
+ */
+export declare function getSudocodeDir(): string;
+//# sourceMappingURL=sudocode-dir.d.ts.map

package/dist/utils/sudocode-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sudocode-dir.d.ts","sourceRoot":"","sources":["../../src/utils/sudocode-dir.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@sudocode-ai/local-server",
+  "version": "0.1.0",
+  "description": "Local backend server for sudocode - provides REST API and WebSocket endpoints",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "sudocode-server": "dist/cli.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "node build.js",
+    "build:dev": "tsc && chmod +x dist/cli.js",
+    "start": "node dist/index.js",
+    "test": "NODE_ENV=test vitest",
+    "test:e2e": "RUN_E2E_TESTS=true NODE_ENV=test vitest --run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "sudocode",
+    "server",
+    "api",
+    "backend"
+  ],
+  "author": "sudocode AI",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sudocode-ai/sudocode.git",
+    "directory": "server"
+  },
+  "homepage": "https://sudocode.ai",
+  "bugs": {
+    "url": "https://github.com/sudocode-ai/sudocode/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@ag-ui/core": "^0.0.39",
+    "@copilotkit/runtime": "^1.10.6",
+    "@sudocode-ai/cli": "^0.1.0",
+    "@sudocode-ai/types": "^0.1.0",
+    "@types/ws": "^8.18.1",
+    "async-mutex": "^0.5.0",
+    "better-sqlite3": "^11.8.1",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5",
+    "express": "^4.18.2",
+    "glob": "^11.0.3",
+    "node-fetch": "^2.7.0",
+    "ws": "^8.18.3",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.19",
+    "@types/supertest": "^6.0.3",
+    "esbuild": "^0.24.2",
+    "supertest": "^7.1.4",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4"
+  },
+  "files": [
+    "dist/**/*"
+  ]
+}