sudocode 1.0.0 → 1.1.1

package/node_modules/@sudocode-ai/local-server/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/node_modules/@sudocode-ai/local-server/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/node_modules/@sudocode-ai/local-server/dist/services/prompt-template-engine.js

@@ -0,0 +1,212 @@
+/**
+ * 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 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, context) {
+        let result = template;
+        // Process in order: loops, conditionals, then variables
+        // Use a while loop to handle nested structures by processing innermost first
+        // 1. Handle loops: {{#each array}}...{{/each}}
+        // Process innermost loops first by finding balanced tags
+        let previousResult = '';
+        while (result !== previousResult) {
+            previousResult = result;
+            result = this.replaceLoop(result, context);
+        }
+        // 2. Handle conditionals: {{#if variable}}...{{/if}}
+        previousResult = '';
+        while (result !== previousResult) {
+            previousResult = result;
+            result = this.replaceConditional(result, context);
+        }
+        // 3. Replace simple variables: {{variable}}
+        result = result.replace(/\{\{([^}#/]+)\}\}/g, (match, key) => {
+            const value = this.getValue(context, key.trim());
+            return value !== undefined ? String(value) : match;
+        });
+        return result;
+    }
+    /**
+     * Replace one {{#each}} loop with balanced tags
+     * Processes innermost loop first
+     */
+    replaceLoop(template, context) {
+        const match = this.findBalancedTag(template, 'each');
+        if (!match)
+            return template;
+        const { key, content, fullMatch } = match;
+        const array = this.getValue(context, key.trim());
+        if (!Array.isArray(array)) {
+            return template.replace(fullMatch, '');
+        }
+        const replacement = array
+            .map((item) => this.render(content, item))
+            .join('');
+        return template.replace(fullMatch, replacement);
+    }
+    /**
+     * Replace one {{#if}} conditional with balanced tags
+     */
+    replaceConditional(template, context) {
+        const match = this.findBalancedTag(template, 'if');
+        if (!match)
+            return template;
+        const { key, content, fullMatch } = match;
+        const value = this.getValue(context, key.trim());
+        const replacement = value ? content : '';
+        return template.replace(fullMatch, replacement);
+    }
+    /**
+     * Find a balanced {{#tagName}} ... {{/tagName}} pair
+     * Returns the FIRST match (outermost, will be processed recursively)
+     */
+    findBalancedTag(template, tagName) {
+        const openPattern = `\\{\\{#${tagName}\\s+([^}]+)\\}\\}`;
+        const closePattern = `\\{\\{\\/${tagName}\\}\\}`;
+        const openRegex = new RegExp(openPattern);
+        const match = openRegex.exec(template);
+        if (!match)
+            return null;
+        const openIndex = match.index;
+        const key = match[1];
+        let depth = 1;
+        let i = openIndex + match[0].length;
+        const contentStart = i;
+        // Find the matching closing tag by counting depth
+        while (i < template.length && depth > 0) {
+            // Check for nested opening tags
+            const nestedOpen = template.slice(i).match(new RegExp(`^${openPattern}`));
+            if (nestedOpen) {
+                depth++;
+                i += nestedOpen[0].length;
+                continue;
+            }
+            // Check for closing tags
+            const close = template.slice(i).match(new RegExp(`^${closePattern}`));
+            if (close) {
+                depth--;
+                if (depth === 0) {
+                    const content = template.slice(contentStart, i);
+                    const fullMatch = template.slice(openIndex, i + close[0].length);
+                    return { key, content, fullMatch };
+                }
+                i += close[0].length;
+                continue;
+            }
+            i++;
+        }
+        return null;
+    }
+    /**
+     * 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'
+     * ```
+     */
+    getValue(context, path) {
+        const keys = path.split('.');
+        let value = context;
+        for (const key of keys) {
+            if (value === null || value === undefined)
+                return undefined;
+            value = value[key];
+        }
+        return value;
+    }
+    /**
+     * 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) {
+        const errors = [];
+        // Check for balanced {{#if}} tags
+        const ifCount = (template.match(/\{\{#if/g) || []).length;
+        const endIfCount = (template.match(/\{\{\/if\}\}/g) || []).length;
+        if (ifCount !== endIfCount) {
+            errors.push(`Unbalanced {{#if}} tags (${ifCount} vs ${endIfCount})`);
+        }
+        // Check for balanced {{#each}} tags
+        const eachCount = (template.match(/\{\{#each/g) || []).length;
+        const endEachCount = (template.match(/\{\{\/each\}\}/g) || []).length;
+        if (eachCount !== endEachCount) {
+            errors.push(`Unbalanced {{#each}} tags (${eachCount} vs ${endEachCount})`);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+}
+//# sourceMappingURL=prompt-template-engine.js.map

package/node_modules/@sudocode-ai/local-server/dist/services/prompt-template-engine.js.map

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

package/node_modules/@sudocode-ai/local-server/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/node_modules/@sudocode-ai/local-server/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/node_modules/@sudocode-ai/local-server/dist/services/prompt-templates.js

@@ -0,0 +1,236 @@
+/**
+ * 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 { randomUUID } from 'crypto';
+import { PromptTemplateEngine } from './prompt-template-engine.js';
+/**
+ * Default issue template
+ *
+ * Renders an issue into an executable prompt with:
+ * - Issue title and description
+ * - Related specifications
+ * - Feedback from previous execution attempts
+ */
+const DEFAULT_ISSUE_TEMPLATE = `Fix issue {{issueId}}: {{title}}
+
+## Description
+{{description}}
+
+{{#if relatedSpecs}}
+## Related Specifications
+{{#each relatedSpecs}}
+- [[{{id}}]]: {{title}}
+{{/each}}
+{{/if}}
+
+{{#if feedback}}
+## Feedback from Previous Attempts
+{{#each feedback}}
+- {{content}} (from {{issueId}})
+{{/each}}
+{{/if}}
+
+Please implement a solution for this issue. Make sure to:
+1. Read and understand the issue requirements
+2. Check related specifications for context
+3. Write clean, well-tested code
+4. Update documentation if needed
+`;
+/**
+ * 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 function initializeDefaultTemplates(db) {
+    const engine = new PromptTemplateEngine();
+    // Validate default template
+    const validation = engine.validate(DEFAULT_ISSUE_TEMPLATE);
+    if (!validation.valid) {
+        throw new Error(`Default issue template has invalid syntax: ${validation.errors.join(', ')}`);
+    }
+    // Check if default issue template already exists
+    const existing = db
+        .prepare(`
+      SELECT id FROM prompt_templates
+      WHERE type = 'issue' AND is_default = 1
+    `)
+        .get();
+    if (existing) {
+        // Default template already exists, skip initialization
+        return;
+    }
+    // Insert default issue template
+    const templateId = randomUUID();
+    const variables = JSON.stringify([
+        'issueId',
+        'title',
+        'description',
+        'relatedSpecs',
+        'feedback',
+    ]);
+    db.prepare(`
+    INSERT INTO prompt_templates (
+      id, name, description, type, template, variables, is_default,
+      created_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(templateId, 'Default Issue Template', 'Renders an issue into an executable prompt with related specs and feedback', 'issue', DEFAULT_ISSUE_TEMPLATE, variables, 1, // is_default
+    new Date().toISOString(), new Date().toISOString());
+}
+/**
+ * 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 function getDefaultTemplate(db, type) {
+    const template = db
+        .prepare(`
+      SELECT * FROM prompt_templates
+      WHERE type = ? AND is_default = 1
+      LIMIT 1
+    `)
+        .get(type);
+    return template || null;
+}
+/**
+ * Get template by ID
+ *
+ * @param db - Database instance
+ * @param templateId - Template ID
+ * @returns Template or null if not found
+ */
+export function getTemplateById(db, templateId) {
+    const template = db
+        .prepare('SELECT * FROM prompt_templates WHERE id = ?')
+        .get(templateId);
+    return template || null;
+}
+/**
+ * List all templates, optionally filtered by type
+ *
+ * @param db - Database instance
+ * @param type - Optional type filter
+ * @returns Array of templates
+ */
+export function listTemplates(db, type) {
+    if (type) {
+        return db
+            .prepare(`
+        SELECT * FROM prompt_templates
+        WHERE type = ?
+        ORDER BY is_default DESC, name ASC
+      `)
+            .all(type);
+    }
+    return db
+        .prepare(`
+      SELECT * FROM prompt_templates
+      ORDER BY is_default DESC, name ASC
+    `)
+        .all();
+}
+/**
+ * Create a new custom template
+ *
+ * @param db - Database instance
+ * @param params - Template parameters
+ * @returns Created template
+ */
+export function createTemplate(db, params) {
+    // Validate template syntax
+    const engine = new PromptTemplateEngine();
+    const validation = engine.validate(params.template);
+    if (!validation.valid) {
+        throw new Error(`Invalid template syntax: ${validation.errors.join(', ')}`);
+    }
+    const templateId = randomUUID();
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO prompt_templates (
+      id, name, description, type, template, variables, is_default,
+      created_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(templateId, params.name, params.description || null, params.type, params.template, JSON.stringify(params.variables), params.isDefault ? 1 : 0, now, now);
+    return getTemplateById(db, templateId);
+}
+/**
+ * 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 function updateTemplate(db, templateId, updates) {
+    const existing = getTemplateById(db, templateId);
+    if (!existing) {
+        return null;
+    }
+    // Validate template syntax if template is being updated
+    if (updates.template) {
+        const engine = new PromptTemplateEngine();
+        const validation = engine.validate(updates.template);
+        if (!validation.valid) {
+            throw new Error(`Invalid template syntax: ${validation.errors.join(', ')}`);
+        }
+    }
+    const fields = [];
+    const values = [];
+    if (updates.name !== undefined) {
+        fields.push('name = ?');
+        values.push(updates.name);
+    }
+    if (updates.description !== undefined) {
+        fields.push('description = ?');
+        values.push(updates.description);
+    }
+    if (updates.template !== undefined) {
+        fields.push('template = ?');
+        values.push(updates.template);
+    }
+    if (updates.variables !== undefined) {
+        fields.push('variables = ?');
+        values.push(JSON.stringify(updates.variables));
+    }
+    if (updates.isDefault !== undefined) {
+        fields.push('is_default = ?');
+        values.push(updates.isDefault ? 1 : 0);
+    }
+    if (fields.length === 0) {
+        return existing;
+    }
+    fields.push('updated_at = ?');
+    values.push(new Date().toISOString());
+    values.push(templateId);
+    db.prepare(`
+    UPDATE prompt_templates
+    SET ${fields.join(', ')}
+    WHERE id = ?
+  `).run(...values);
+    return getTemplateById(db, templateId);
+}
+/**
+ * Delete a template
+ *
+ * @param db - Database instance
+ * @param templateId - Template ID
+ * @returns True if deleted, false if not found
+ */
+export function deleteTemplate(db, templateId) {
+    const result = db
+        .prepare('DELETE FROM prompt_templates WHERE id = ?')
+        .run(templateId);
+    return result.changes > 0;
+}
+//# sourceMappingURL=prompt-templates.js.map

package/node_modules/@sudocode-ai/local-server/dist/services/prompt-templates.js.map

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