sudocode 1.1.17 → 1.1.18-dev.0

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

@@ -0,0 +1,377 @@
+/**
+ * Prompt resolver service
+ *
+ * Resolves entity references and file mentions in agent prompts:
+ * - Injects [[s-xxxxx]] or @s-xxxxx spec references with markdown content
+ * - Injects [[i-xxxxx]] or @i-xxxxx issue references with markdown content
+ * - Tracks @file mentions but leaves them for agent to handle
+ */
+import { getSpecById } from "./specs.js";
+import { getIssueById } from "./issues.js";
+/**
+ * PromptResolver service
+ *
+ * Extracts and resolves entity references in agent prompts
+ */
+export class PromptResolver {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Resolve all references in a prompt
+     *
+     * @param prompt - The raw prompt with [[entity-id]], @entity-id, and @file references
+     * @param alreadyExpandedIds - Optional set of entity IDs that were already expanded in parent executions
+     * @param implicitIssueId - Optional issue ID to automatically include even if not mentioned in prompt (for issue-based executions)
+     * @returns Resolution result with resolved prompt, references, and errors
+     */
+    async resolve(prompt, alreadyExpandedIds = new Set(), implicitIssueId) {
+        const references = [];
+        const errors = [];
+        const expandedEntityIds = [];
+        // Extract all references (order matters - extract entity IDs first)
+        const specRefs = this.extractSpecReferences(prompt);
+        const issueRefs = this.extractIssueReferences(prompt);
+        // Extract entity IDs for filtering file mentions
+        const entityIds = new Set([
+            ...specRefs.map((r) => r.id),
+            ...issueRefs.map((r) => r.id),
+        ]);
+        const fileRefs = this.extractFileMentions(prompt, entityIds);
+        // Track all references
+        references.push(...fileRefs);
+        // Resolve and inject specs (replace inline)
+        let resolvedPrompt = prompt;
+        for (const ref of specRefs) {
+            // Skip if already expanded in parent execution
+            if (alreadyExpandedIds.has(ref.id)) {
+                ref.found = true;
+                references.push(ref);
+                continue;
+            }
+            const spec = getSpecById(this.db, ref.id);
+            if (spec) {
+                ref.found = true;
+                resolvedPrompt = this.replaceReference(resolvedPrompt, ref.id, this.formatSpec(spec));
+                expandedEntityIds.push(ref.id);
+            }
+            else {
+                ref.found = false;
+                ref.error = `Spec ${ref.id} not found`;
+                errors.push(ref.error);
+            }
+            references.push(ref);
+        }
+        // Resolve issues (keep reference, append content at end)
+        const issueAppendixes = [];
+        for (const ref of issueRefs) {
+            // Skip if already expanded in parent execution
+            if (alreadyExpandedIds.has(ref.id)) {
+                ref.found = true;
+                references.push(ref);
+                continue;
+            }
+            const issue = getIssueById(this.db, ref.id);
+            if (issue) {
+                ref.found = true;
+                // Don't replace the reference - append content at end instead
+                issueAppendixes.push(`\n\nIssue ${ref.id}:\n${this.formatIssue(issue)}`);
+                expandedEntityIds.push(ref.id);
+            }
+            else {
+                ref.found = false;
+                ref.error = `Issue ${ref.id} not found`;
+                errors.push(ref.error);
+            }
+            references.push(ref);
+        }
+        // If an implicit issue ID is provided (for issue-based executions),
+        // automatically include it even if not mentioned in the prompt
+        if (implicitIssueId && !alreadyExpandedIds.has(implicitIssueId)) {
+            // Check if it's already in the issueRefs (explicitly mentioned)
+            const alreadyMentioned = issueRefs.some((ref) => ref.id === implicitIssueId);
+            if (!alreadyMentioned) {
+                const issue = getIssueById(this.db, implicitIssueId);
+                if (issue) {
+                    // Add implicit issue reference
+                    references.push({
+                        type: "issue",
+                        id: implicitIssueId,
+                        found: true,
+                    });
+                    // Append content at the end
+                    issueAppendixes.push(`\n\nIssue ${implicitIssueId}:\n${this.formatIssue(issue)}`);
+                    expandedEntityIds.push(implicitIssueId);
+                }
+                else {
+                    const error = `Implicit issue ${implicitIssueId} not found`;
+                    errors.push(error);
+                    references.push({
+                        type: "issue",
+                        id: implicitIssueId,
+                        found: false,
+                        error,
+                    });
+                }
+            }
+        }
+        // Append all issue contents at the end
+        if (issueAppendixes.length > 0) {
+            resolvedPrompt += issueAppendixes.join("");
+        }
+        return {
+            resolvedPrompt,
+            references,
+            errors,
+            expandedEntityIds,
+        };
+    }
+    /**
+     * Extract spec references from prompt
+     * Supports two patterns:
+     * - [[s-xxxxx]] (bracket syntax)
+     * - @s-xxxxx (@ mention syntax)
+     */
+    extractSpecReferences(prompt) {
+        const refs = [];
+        // Extract bracket syntax: [[s-xxxxx]]
+        const bracketPattern = /\[\[(s-[a-z0-9]+)\]\]/gi;
+        const bracketMatches = prompt.matchAll(bracketPattern);
+        for (const match of bracketMatches) {
+            const id = match[1].toLowerCase();
+            if (!refs.some((r) => r.id === id)) {
+                refs.push({
+                    type: "spec",
+                    id,
+                    found: false,
+                });
+            }
+        }
+        // Extract @ mention syntax: @s-xxxxx
+        const mentionPattern = /@(s-[a-z0-9]+)(?=\s|$|[^\w-])/gi;
+        const mentionMatches = prompt.matchAll(mentionPattern);
+        for (const match of mentionMatches) {
+            const id = match[1].toLowerCase();
+            if (!refs.some((r) => r.id === id)) {
+                refs.push({
+                    type: "spec",
+                    id,
+                    found: false,
+                });
+            }
+        }
+        return refs;
+    }
+    /**
+     * Extract issue references from prompt
+     * Supports two patterns:
+     * - [[i-xxxxx]] (bracket syntax)
+     * - @i-xxxxx (@ mention syntax)
+     */
+    extractIssueReferences(prompt) {
+        const refs = [];
+        // Extract bracket syntax: [[i-xxxxx]]
+        const bracketPattern = /\[\[(i-[a-z0-9]+)\]\]/gi;
+        const bracketMatches = prompt.matchAll(bracketPattern);
+        for (const match of bracketMatches) {
+            const id = match[1].toLowerCase();
+            if (!refs.some((r) => r.id === id)) {
+                refs.push({
+                    type: "issue",
+                    id,
+                    found: false,
+                });
+            }
+        }
+        // Extract @ mention syntax: @i-xxxxx
+        const mentionPattern = /@(i-[a-z0-9]+)(?=\s|$|[^\w-])/gi;
+        const mentionMatches = prompt.matchAll(mentionPattern);
+        for (const match of mentionMatches) {
+            const id = match[1].toLowerCase();
+            if (!refs.some((r) => r.id === id)) {
+                refs.push({
+                    type: "issue",
+                    id,
+                    found: false,
+                });
+            }
+        }
+        return refs;
+    }
+    /**
+     * Extract file mentions from prompt
+     * Pattern: @filepath (but not @s-xxxxx or @i-xxxxx)
+     *
+     * Note: File mentions are tracked but not resolved (agent handles them)
+     */
+    extractFileMentions(prompt, entityIds) {
+        const pattern = /@([^\s@]+)/g;
+        const matches = prompt.matchAll(pattern);
+        const refs = [];
+        for (const match of matches) {
+            let path = match[1];
+            // Remove trailing punctuation (period, comma, etc.)
+            path = path.replace(/[.,;:!?]+$/, "");
+            // Skip if it's a spec or issue ID (already handled)
+            if (entityIds.has(path.toLowerCase())) {
+                continue;
+            }
+            // Avoid duplicates
+            if (!refs.some((r) => r.id === path)) {
+                refs.push({
+                    type: "file",
+                    id: path,
+                    found: true, // Files are not resolved here, just tracked
+                });
+            }
+        }
+        return refs;
+    }
+    /**
+     * Replace a reference with formatted content
+     * Handles both [[id]] and @id syntaxes
+     */
+    replaceReference(prompt, id, content) {
+        // Replace bracket syntax: [[id]]
+        const bracketPattern = new RegExp(`\\[\\[${id}\\]\\]`, "gi");
+        prompt = prompt.replace(bracketPattern, content);
+        // Replace @ mention syntax: @id
+        const mentionPattern = new RegExp(`@${id}(?=\\s|$|[^\\w-])`, "gi");
+        prompt = prompt.replace(mentionPattern, content);
+        return prompt;
+    }
+    /**
+     * Format spec - returns all information shown in CLI show command
+     */
+    formatSpec(spec) {
+        const parts = [];
+        // Header
+        parts.push(`**${spec.id}: ${spec.title}**`);
+        parts.push("");
+        // Metadata
+        parts.push(`**Priority:** ${spec.priority}`);
+        if (spec.file_path) {
+            parts.push(`**File:** ${spec.file_path}`);
+        }
+        if (spec.parent_id) {
+            parts.push(`**Parent:** ${spec.parent_id}`);
+        }
+        parts.push(`**Created:** ${spec.created_at}`);
+        parts.push(`**Updated:** ${spec.updated_at}`);
+        // Tags
+        const tags = this.getTags(spec.id, "spec");
+        if (tags.length > 0) {
+            parts.push(`**Tags:** ${tags.join(", ")}`);
+        }
+        // Relationships
+        const outgoing = this.getOutgoingRelationships(spec.id, "spec");
+        if (outgoing.length > 0) {
+            parts.push("");
+            parts.push("**Outgoing Relationships:**");
+            for (const rel of outgoing) {
+                parts.push(`- ${rel.relationship_type} → ${rel.to_id} (${rel.to_type})`);
+            }
+        }
+        const incoming = this.getIncomingRelationships(spec.id, "spec");
+        if (incoming.length > 0) {
+            parts.push("");
+            parts.push("**Incoming Relationships:**");
+            for (const rel of incoming) {
+                parts.push(`- ${rel.from_id} (${rel.from_type}) → ${rel.relationship_type}`);
+            }
+        }
+        // Content
+        if (spec.content) {
+            parts.push("");
+            parts.push("**Content:**");
+            parts.push(spec.content);
+        }
+        return parts.join("\n");
+    }
+    /**
+     * Format issue - returns all information shown in CLI show command
+     */
+    formatIssue(issue) {
+        const parts = [];
+        // Header
+        parts.push(`**${issue.id}: ${issue.title}**`);
+        parts.push("");
+        // Metadata
+        parts.push(`**Status:** ${issue.status}`);
+        parts.push(`**Priority:** ${issue.priority}`);
+        if (issue.assignee) {
+            parts.push(`**Assignee:** ${issue.assignee}`);
+        }
+        if (issue.parent_id) {
+            parts.push(`**Parent:** ${issue.parent_id}`);
+        }
+        parts.push(`**Created:** ${issue.created_at}`);
+        parts.push(`**Updated:** ${issue.updated_at}`);
+        if (issue.closed_at) {
+            parts.push(`**Closed:** ${issue.closed_at}`);
+        }
+        // Tags
+        const tags = this.getTags(issue.id, "issue");
+        if (tags.length > 0) {
+            parts.push(`**Tags:** ${tags.join(", ")}`);
+        }
+        // Relationships
+        const outgoing = this.getOutgoingRelationships(issue.id, "issue");
+        if (outgoing.length > 0) {
+            parts.push("");
+            parts.push("**Outgoing Relationships:**");
+            for (const rel of outgoing) {
+                parts.push(`- ${rel.relationship_type} → ${rel.to_id} (${rel.to_type})`);
+            }
+        }
+        const incoming = this.getIncomingRelationships(issue.id, "issue");
+        if (incoming.length > 0) {
+            parts.push("");
+            parts.push("**Incoming Relationships:**");
+            for (const rel of incoming) {
+                parts.push(`- ${rel.from_id} (${rel.from_type}) → ${rel.relationship_type}`);
+            }
+        }
+        // Content
+        if (issue.content) {
+            parts.push("");
+            parts.push("**Content:**");
+            parts.push(issue.content);
+        }
+        return parts.join("\n");
+    }
+    /**
+     * Get tags for an entity
+     */
+    getTags(entityId, entityType) {
+        const query = this.db.prepare(`
+      SELECT tag FROM tags WHERE entity_id = ? AND entity_type = ?
+    `);
+        const rows = query.all(entityId, entityType);
+        return rows.map((r) => r.tag);
+    }
+    /**
+     * Get outgoing relationships for an entity
+     */
+    getOutgoingRelationships(entityId, entityType) {
+        const query = this.db.prepare(`
+      SELECT relationship_type, to_id, to_type
+      FROM relationships
+      WHERE from_id = ? AND from_type = ?
+    `);
+        return query.all(entityId, entityType);
+    }
+    /**
+     * Get incoming relationships for an entity
+     */
+    getIncomingRelationships(entityId, entityType) {
+        const query = this.db.prepare(`
+      SELECT relationship_type, from_id, from_type
+      FROM relationships
+      WHERE to_id = ? AND to_type = ?
+    `);
+        return query.all(entityId, entityType);
+    }
+}
+//# sourceMappingURL=prompt-resolver.js.map

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

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

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"}