sudocode 1.1.17 → 1.1.18-dev.0

package/node_modules/@sudocode-ai/cli/dist/operations/issues.js

@@ -0,0 +1,474 @@
+/**
+ * CRUD operations for Issues
+ */
+import { generateUUID } from "../id-generator.js";
+import { getIncomingRelationships, getOutgoingRelationships, } from "./relationships.js";
+/**
+ * Parse external_links JSON field from SQLite row
+ */
+function parseExternalLinks(row) {
+    if (!row)
+        return null;
+    if (typeof row.external_links === "string") {
+        try {
+            row.external_links = JSON.parse(row.external_links);
+        }
+        catch {
+            row.external_links = undefined;
+        }
+    }
+    return row;
+}
+/**
+ * Create a new issue
+ */
+export function createIssue(db, input) {
+    // Validate parent_id exists if provided and get parent_uuid
+    let parent_uuid = null;
+    if (input.parent_id) {
+        const parent = getIssue(db, input.parent_id);
+        if (!parent) {
+            throw new Error(`Parent issue not found: ${input.parent_id}`);
+        }
+        parent_uuid = parent.uuid;
+    }
+    const uuid = input.uuid || generateUUID();
+    // Build INSERT statement with optional timestamp fields
+    const columns = [
+        "id",
+        "uuid",
+        "title",
+        "content",
+        "status",
+        "priority",
+        "assignee",
+        "parent_id",
+        "parent_uuid",
+        "archived",
+        "external_links",
+    ];
+    const values = [
+        "@id",
+        "@uuid",
+        "@title",
+        "@content",
+        "@status",
+        "@priority",
+        "@assignee",
+        "@parent_id",
+        "@parent_uuid",
+        "@archived",
+        "@external_links",
+    ];
+    if (input.created_at) {
+        columns.push("created_at");
+        values.push("@created_at");
+    }
+    if (input.updated_at) {
+        columns.push("updated_at");
+        values.push("@updated_at");
+    }
+    if (input.closed_at !== undefined) {
+        columns.push("closed_at");
+        values.push("@closed_at");
+    }
+    if (input.archived_at !== undefined) {
+        columns.push("archived_at");
+        values.push("@archived_at");
+    }
+    const stmt = db.prepare(`
+    INSERT INTO issues (
+      ${columns.join(", ")}
+    ) VALUES (
+      ${values.join(", ")}
+    )
+    ON CONFLICT(id) DO UPDATE SET
+      uuid = excluded.uuid,
+      title = excluded.title,
+      content = excluded.content,
+      status = excluded.status,
+      priority = excluded.priority,
+      assignee = excluded.assignee,
+      parent_id = excluded.parent_id,
+      parent_uuid = excluded.parent_uuid,
+      archived = excluded.archived,
+      archived_at = excluded.archived_at,
+      external_links = excluded.external_links,
+      ${input.created_at ? "created_at = excluded.created_at," : ""}
+      ${input.updated_at ? "updated_at = excluded.updated_at" : "updated_at = CURRENT_TIMESTAMP"}
+  `);
+    try {
+        const params = {
+            id: input.id,
+            uuid: uuid,
+            title: input.title,
+            content: input.content || "",
+            status: input.status || "open",
+            priority: input.priority ?? 2,
+            assignee: input.assignee ?? null,
+            parent_id: input.parent_id ?? null,
+            parent_uuid: parent_uuid,
+            archived: input.archived ? 1 : 0,
+            external_links: input.external_links ?? null,
+        };
+        // Add optional timestamp parameters
+        if (input.created_at) {
+            params.created_at = input.created_at;
+        }
+        if (input.updated_at) {
+            params.updated_at = input.updated_at;
+        }
+        if (input.closed_at !== undefined) {
+            params.closed_at = input.closed_at;
+        }
+        if (input.archived_at !== undefined) {
+            params.archived_at = input.archived_at;
+        }
+        stmt.run(params);
+        const issue = getIssue(db, input.id);
+        if (!issue) {
+            throw new Error(`Failed to create issue ${input.id}`);
+        }
+        return issue;
+    }
+    catch (error) {
+        if (error.code && error.code.startsWith("SQLITE_CONSTRAINT")) {
+            throw new Error(`Constraint violation: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Get an issue by ID
+ */
+export function getIssue(db, id) {
+    const stmt = db.prepare(`
+    SELECT * FROM issues WHERE id = ?
+  `);
+    const row = stmt.get(id);
+    return parseExternalLinks(row);
+}
+/**
+ * Update an issue
+ */
+export function updateIssue(db, id, input) {
+    const existing = getIssue(db, id);
+    if (!existing) {
+        throw new Error(`Issue not found: ${id}`);
+    }
+    // Validate parent_id exists if provided
+    if (input.parent_id) {
+        const parent = getIssue(db, input.parent_id);
+        if (!parent) {
+            throw new Error(`Parent issue not found: ${input.parent_id}`);
+        }
+    }
+    const updates = [];
+    const params = { id };
+    if (input.title !== undefined && input.title !== existing.title) {
+        updates.push("title = @title");
+        params.title = input.title;
+    }
+    if (input.content !== undefined && input.content !== existing.content) {
+        updates.push("content = @content");
+        params.content = input.content;
+    }
+    if (input.status !== undefined && input.status !== existing.status) {
+        updates.push("status = @status");
+        params.status = input.status;
+        // Handle closed_at based on status changes
+        // Use input.closed_at if provided, otherwise auto-set based on status
+        if (input.closed_at !== undefined) {
+            // Explicit closed_at provided - use it
+            updates.push("closed_at = @closed_at");
+            params.closed_at = input.closed_at;
+        }
+        else if (input.status === "closed" && existing.status !== "closed") {
+            // Status changing to 'closed' - set timestamp
+            updates.push("closed_at = CURRENT_TIMESTAMP");
+        }
+        else if (input.status !== "closed" && existing.status === "closed") {
+            // Reopening - clear timestamp
+            updates.push("closed_at = NULL");
+        }
+    }
+    else if (input.closed_at !== undefined &&
+        input.closed_at !== existing.closed_at) {
+        // closed_at provided without status change
+        updates.push("closed_at = @closed_at");
+        params.closed_at = input.closed_at;
+    }
+    if (input.priority !== undefined && input.priority !== existing.priority) {
+        updates.push("priority = @priority");
+        params.priority = input.priority;
+    }
+    if (input.assignee !== undefined && input.assignee !== existing.assignee) {
+        updates.push("assignee = @assignee");
+        params.assignee = input.assignee;
+    }
+    if (input.parent_id !== undefined && input.parent_id !== existing.parent_id) {
+        updates.push("parent_id = @parent_id");
+        params.parent_id = input.parent_id;
+    }
+    if (input.archived !== undefined &&
+        (input.archived ? 1 : 0) !== existing.archived) {
+        updates.push("archived = @archived");
+        params.archived = input.archived ? 1 : 0;
+        // Handle archived_at based on archived changes
+        // Use input.archived_at if provided, otherwise auto-set based on archived
+        if (input.archived_at !== undefined) {
+            // Explicit archived_at provided - use it
+            updates.push("archived_at = @archived_at");
+            params.archived_at = input.archived_at;
+        }
+        else if (input.archived && !existing.archived) {
+            // Archiving - set timestamp
+            updates.push("archived_at = CURRENT_TIMESTAMP");
+        }
+        else if (!input.archived && existing.archived) {
+            // Unarchiving - clear timestamp
+            updates.push("archived_at = NULL");
+        }
+    }
+    else if (input.archived_at !== undefined &&
+        input.archived_at !== existing.archived_at) {
+        // archived_at provided without archived change
+        updates.push("archived_at = @archived_at");
+        params.archived_at = input.archived_at;
+    }
+    if (input.external_links !== undefined) {
+        updates.push("external_links = @external_links");
+        params.external_links = input.external_links;
+    }
+    // Handle updated_at - use provided value or set to current timestamp
+    if (input.updated_at !== undefined) {
+        updates.push("updated_at = @updated_at");
+        params.updated_at = input.updated_at;
+    }
+    else if (updates.length > 0) {
+        // Only update timestamp if there are actual changes
+        updates.push("updated_at = CURRENT_TIMESTAMP");
+    }
+    if (updates.length === 0) {
+        return existing;
+    }
+    const stmt = db.prepare(`
+    UPDATE issues SET ${updates.join(", ")} WHERE id = @id
+  `);
+    try {
+        stmt.run(params);
+        const updated = getIssue(db, id);
+        if (!updated) {
+            throw new Error(`Failed to update issue ${id}`);
+        }
+        // If status changed to 'closed', update any dependent blocked issues
+        if (input.status === "closed" && existing.status !== "closed") {
+            updateDependentBlockedIssues(db, id);
+        }
+        return updated;
+    }
+    catch (error) {
+        if (error.code && error.code.startsWith("SQLITE_CONSTRAINT")) {
+            throw new Error(`Constraint violation: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Update status of issues that were blocked by the given issue
+ * Called when a blocker issue is closed
+ * Semantics:
+ *   - blocks: closedIssueId --[blocks]--> blocked (outgoing blocks)
+ *   - depends-on: blocked --[depends-on]--> closedIssueId (incoming depends-on)
+ */
+function updateDependentBlockedIssues(db, closedIssueId) {
+    // Find all issues that are blocked by this issue
+    // Check both outgoing 'blocks' and incoming 'depends-on' relationships
+    const blocksRelationships = getOutgoingRelationships(db, closedIssueId, "issue", "blocks");
+    const dependsOnRelationships = getIncomingRelationships(db, closedIssueId, "issue", "depends-on");
+    const allDependentRelationships = [
+        ...blocksRelationships,
+        ...dependsOnRelationships,
+    ];
+    for (const rel of allDependentRelationships) {
+        // For 'blocks': closedIssueId blocks to_id
+        // For 'depends-on': from_id depends-on closedIssueId
+        const blockedIssueId = rel.relationship_type === "blocks" ? rel.to_id : rel.from_id;
+        const blockedIssue = getIssue(db, blockedIssueId);
+        // Only update if the issue is currently marked as 'blocked'
+        if (!blockedIssue || blockedIssue.status !== "blocked") {
+            continue;
+        }
+        // Check if this issue has any other open/in_progress/blocked blockers
+        const hasOtherBlockers = hasOpenBlockers(db, blockedIssueId, closedIssueId);
+        // If no other blockers, update status from 'blocked' to 'open'
+        if (!hasOtherBlockers) {
+            const updateStmt = db.prepare(`
+        UPDATE issues
+        SET status = 'open', updated_at = CURRENT_TIMESTAMP
+        WHERE id = ?
+      `);
+            updateStmt.run(blockedIssueId);
+        }
+    }
+}
+/**
+ * Check if an issue has any open blockers (excluding the specified blocker)
+ * Semantics:
+ *   - blocks: blocker --[blocks]--> issueId (incoming blocks)
+ *   - depends-on: issueId --[depends-on]--> blocker (outgoing depends-on)
+ */
+function hasOpenBlockers(db, issueId, excludeBlockerId) {
+    const stmt = db.prepare(`
+    SELECT COUNT(*) as count
+    FROM relationships r
+    JOIN issues blocker ON (
+      (r.relationship_type = 'blocks' AND r.from_id = blocker.id AND r.from_type = 'issue') OR
+      (r.relationship_type = 'depends-on' AND r.to_id = blocker.id AND r.to_type = 'issue')
+    )
+    WHERE (
+      (r.relationship_type = 'blocks' AND r.to_id = ? AND r.to_type = 'issue') OR
+      (r.relationship_type = 'depends-on' AND r.from_id = ? AND r.from_type = 'issue')
+    )
+      AND blocker.status IN ('open', 'in_progress', 'blocked')
+      ${excludeBlockerId ? "AND blocker.id != ?" : ""}
+  `);
+    const params = excludeBlockerId
+        ? [issueId, issueId, excludeBlockerId]
+        : [issueId, issueId];
+    const result = stmt.get(...params);
+    return result.count > 0;
+}
+/**
+ * Delete an issue
+ * Cascades to delete:
+ * - Any feedback FROM this issue
+ * - Any feedback targeting this issue
+ * - All relationships involving this issue (both incoming and outgoing)
+ */
+export function deleteIssue(db, id) {
+    // Delete any feedback FROM this issue (no longer handled by FK CASCADE since from_id is nullable)
+    db.prepare(`DELETE FROM issue_feedback WHERE from_id = ?`).run(id);
+    // Delete any feedback targeting this issue
+    db.prepare(`DELETE FROM issue_feedback WHERE to_id = ?`).run(id);
+    // Delete all relationships involving this issue (both directions)
+    db.prepare(`
+    DELETE FROM relationships
+    WHERE (from_id = ? AND from_type = 'issue')
+       OR (to_id = ? AND to_type = 'issue')
+  `).run(id, id);
+    // Then delete the issue itself
+    const stmt = db.prepare(`DELETE FROM issues WHERE id = ?`);
+    const result = stmt.run(id);
+    return result.changes > 0;
+}
+/**
+ * Close an issue (convenience method)
+ */
+export function closeIssue(db, id) {
+    return updateIssue(db, id, { status: "closed" });
+}
+/**
+ * Reopen an issue (convenience method)
+ */
+export function reopenIssue(db, id) {
+    return updateIssue(db, id, { status: "open" });
+}
+/**
+ * List issues with optional filters
+ */
+export function listIssues(db, options = {}) {
+    const conditions = [];
+    const params = {};
+    if (options.status !== undefined) {
+        conditions.push("status = @status");
+        params.status = options.status;
+    }
+    if (options.priority !== undefined) {
+        conditions.push("priority = @priority");
+        params.priority = options.priority;
+    }
+    if (options.assignee !== undefined) {
+        conditions.push("assignee = @assignee");
+        params.assignee = options.assignee;
+    }
+    if (options.parent_id !== undefined) {
+        conditions.push("parent_id = @parent_id");
+        params.parent_id = options.parent_id;
+    }
+    if (options.archived !== undefined) {
+        conditions.push("archived = @archived");
+        params.archived = options.archived ? 1 : 0;
+    }
+    let query = "SELECT * FROM issues";
+    if (conditions.length > 0) {
+        query += " WHERE " + conditions.join(" AND ");
+    }
+    query += " ORDER BY priority DESC, created_at DESC";
+    if (options.limit !== undefined) {
+        query += " LIMIT @limit";
+        params.limit = options.limit;
+    }
+    if (options.offset !== undefined) {
+        query += " OFFSET @offset";
+        params.offset = options.offset;
+    }
+    const stmt = db.prepare(query);
+    const rows = stmt.all(params);
+    return rows.map((row) => parseExternalLinks(row));
+}
+/**
+ * Get ready issues (no blockers)
+ */
+export function getReadyIssues(db) {
+    const stmt = db.prepare("SELECT * FROM ready_issues ORDER BY priority DESC, created_at DESC");
+    const rows = stmt.all();
+    return rows.map((row) => parseExternalLinks(row));
+}
+/**
+ * Get blocked issues
+ */
+export function getBlockedIssues(db) {
+    const stmt = db.prepare("SELECT * FROM blocked_issues ORDER BY priority DESC, created_at DESC");
+    const rows = stmt.all();
+    return rows.map((row) => parseExternalLinks(row));
+}
+/**
+ * Search issues by title or content
+ */
+export function searchIssues(db, query, options = {}) {
+    const conditions = ["(title LIKE @query OR content LIKE @query)"];
+    const params = { query: `%${query}%` };
+    if (options.status !== undefined) {
+        conditions.push("status = @status");
+        params.status = options.status;
+    }
+    if (options.priority !== undefined) {
+        conditions.push("priority = @priority");
+        params.priority = options.priority;
+    }
+    if (options.assignee !== undefined) {
+        conditions.push("assignee = @assignee");
+        params.assignee = options.assignee;
+    }
+    if (options.parent_id !== undefined) {
+        conditions.push("parent_id = @parent_id");
+        params.parent_id = options.parent_id;
+    }
+    if (options.archived !== undefined) {
+        conditions.push("archived = @archived");
+        params.archived = options.archived ? 1 : 0;
+    }
+    let sql = `SELECT * FROM issues WHERE ${conditions.join(" AND ")} ORDER BY priority DESC, created_at DESC`;
+    if (options.limit !== undefined) {
+        sql += " LIMIT @limit";
+        params.limit = options.limit;
+    }
+    else {
+        sql += " LIMIT 50";
+    }
+    const stmt = db.prepare(sql);
+    const rows = stmt.all(params);
+    return rows.map((row) => parseExternalLinks(row));
+}
+//# sourceMappingURL=issues.js.map

package/node_modules/@sudocode-ai/cli/dist/operations/issues.js.map

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

package/node_modules/@sudocode-ai/cli/dist/operations/references.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Operations for managing cross-references in markdown content
+ */
+export interface AddReferenceOptions {
+    referenceId: string;
+    displayText?: string;
+    relationshipType?: string;
+    format?: 'inline' | 'newline';
+    position?: 'before' | 'after';
+}
+export interface ReferenceLocation {
+    line?: number;
+    text?: string;
+}
+/**
+ * Format a reference string with optional display text and relationship type
+ *
+ * Examples:
+ * - formatReference('issue-001') => '[[issue-001]]'
+ * - formatReference('issue-001', 'OAuth') => '[[issue-001|OAuth]]'
+ * - formatReference('issue-001', undefined, 'implements') => '[[issue-001]]{ implements }'
+ * - formatReference('issue-001', 'OAuth', 'implements') => '[[issue-001|OAuth]]{ implements }'
+ */
+export declare function formatReference(referenceId: string, displayText?: string, relationshipType?: string): string;
+/**
+ * Add a reference to markdown content at the specified location
+ *
+ * @param content - The markdown content to modify
+ * @param location - Where to insert the reference (line or text)
+ * @param options - Reference formatting options
+ * @returns Updated content with reference inserted
+ */
+export declare function addReferenceToContent(content: string, location: ReferenceLocation, options: AddReferenceOptions): string;
+//# sourceMappingURL=references.d.ts.map

package/node_modules/@sudocode-ai/cli/dist/operations/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/operations/references.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,CAcR;AAkCD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAkER"}

package/node_modules/@sudocode-ai/cli/dist/operations/references.js

@@ -0,0 +1,117 @@
+/**
+ * Operations for managing cross-references in markdown content
+ */
+/**
+ * Format a reference string with optional display text and relationship type
+ *
+ * Examples:
+ * - formatReference('issue-001') => '[[issue-001]]'
+ * - formatReference('issue-001', 'OAuth') => '[[issue-001|OAuth]]'
+ * - formatReference('issue-001', undefined, 'implements') => '[[issue-001]]{ implements }'
+ * - formatReference('issue-001', 'OAuth', 'implements') => '[[issue-001|OAuth]]{ implements }'
+ */
+export function formatReference(referenceId, displayText, relationshipType) {
+    let ref = `[[${referenceId}`;
+    if (displayText) {
+        ref += `|${displayText}`;
+    }
+    ref += ']]';
+    if (relationshipType) {
+        ref += `{ ${relationshipType} }`;
+    }
+    return ref;
+}
+/**
+ * Find the character index for a given line number in content
+ */
+function getCharIndexForLine(content, lineNumber) {
+    const lines = content.split('\n');
+    if (lineNumber < 1 || lineNumber > lines.length) {
+        throw new Error(`Line number ${lineNumber} is out of bounds (content has ${lines.length} lines)`);
+    }
+    // Calculate character index at the start of the line
+    let charIndex = 0;
+    for (let i = 0; i < lineNumber - 1; i++) {
+        charIndex += lines[i].length + 1; // +1 for newline
+    }
+    return charIndex;
+}
+/**
+ * Find the character index for text in content
+ */
+function getCharIndexForText(content, searchText) {
+    const index = content.indexOf(searchText);
+    if (index === -1) {
+        throw new Error(`Text not found: "${searchText}"`);
+    }
+    return index;
+}
+/**
+ * Add a reference to markdown content at the specified location
+ *
+ * @param content - The markdown content to modify
+ * @param location - Where to insert the reference (line or text)
+ * @param options - Reference formatting options
+ * @returns Updated content with reference inserted
+ */
+export function addReferenceToContent(content, location, options) {
+    const { referenceId, displayText, relationshipType, format = 'inline', position = 'after' } = options;
+    // Validate location
+    if (!location.line && !location.text) {
+        throw new Error('Either line or text must be specified');
+    }
+    if (location.line && location.text) {
+        throw new Error('Cannot specify both line and text');
+    }
+    // Format the reference
+    const refString = formatReference(referenceId, displayText, relationshipType);
+    // Determine insertion point
+    let insertIndex;
+    if (location.line) {
+        insertIndex = getCharIndexForLine(content, location.line);
+        if (position === 'after') {
+            // Move to end of line
+            const lineEndIndex = content.indexOf('\n', insertIndex);
+            insertIndex = lineEndIndex === -1 ? content.length : lineEndIndex;
+        }
+    }
+    else if (location.text) {
+        insertIndex = getCharIndexForText(content, location.text);
+        if (position === 'after') {
+            // Move past the search text
+            insertIndex += location.text.length;
+        }
+    }
+    else {
+        throw new Error('Location must specify line or text');
+    }
+    // Build the insertion string based on format
+    let insertion;
+    if (format === 'newline') {
+        if (position === 'before') {
+            // Insert reference on its own line before
+            insertion = `${refString}\n`;
+        }
+        else {
+            // Insert reference on its own line after
+            insertion = `\n${refString}`;
+        }
+    }
+    else {
+        // inline format
+        if (position === 'before') {
+            // Insert reference with a space after it
+            insertion = `${refString} `;
+        }
+        else {
+            // Insert reference with a space before it
+            insertion = ` ${refString}`;
+        }
+    }
+    // Insert the reference
+    const updatedContent = content.slice(0, insertIndex) +
+        insertion +
+        content.slice(insertIndex);
+    return updatedContent;
+}
+//# sourceMappingURL=references.js.map

package/node_modules/@sudocode-ai/cli/dist/operations/references.js.map

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