sudocode 1.1.17 → 1.1.18-dev.0

package/node_modules/@sudocode-ai/cli/dist/jsonl.js

@@ -0,0 +1,333 @@
+/**
+ * JSONL (JSON Lines) reader and writer
+ * Supports reading and writing .jsonl files for specs and issues
+ */
+import * as fs from "fs";
+import * as readline from "readline";
+import * as path from "path";
+/**
+ * Read a JSONL file and parse all lines
+ * Uses streaming for memory efficiency with large files
+ */
+export async function readJSONL(filePath, options = {}) {
+    const { skipErrors = false, onError } = options;
+    // Check if file exists
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const entities = [];
+    const fileStream = fs.createReadStream(filePath, { encoding: "utf8" });
+    const rl = readline.createInterface({
+        input: fileStream,
+        crlfDelay: Infinity,
+    });
+    let lineNumber = 0;
+    for await (const line of rl) {
+        lineNumber++;
+        // Skip empty lines
+        if (line.trim() === "") {
+            continue;
+        }
+        try {
+            const entity = JSON.parse(line);
+            entities.push(entity);
+        }
+        catch (error) {
+            const parseError = error;
+            if (onError) {
+                onError(lineNumber, line, parseError);
+            }
+            if (!skipErrors) {
+                throw new Error(`Failed to parse JSON at line ${lineNumber}: ${parseError.message}`);
+            }
+        }
+    }
+    return entities;
+}
+/**
+ * Read a JSONL file synchronously (for smaller files)
+ */
+export function readJSONLSync(filePath, options = {}) {
+    const { skipErrors = false, onError } = options;
+    // Check if file exists
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const entities = [];
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        const lineNumber = i + 1;
+        // Skip empty lines
+        if (line === "") {
+            continue;
+        }
+        try {
+            const entity = JSON.parse(line);
+            entities.push(entity);
+        }
+        catch (error) {
+            const parseError = error;
+            if (onError) {
+                onError(lineNumber, line, parseError);
+            }
+            if (!skipErrors) {
+                throw new Error(`Failed to parse JSON at line ${lineNumber}: ${parseError.message}`);
+            }
+        }
+    }
+    return entities;
+}
+/**
+ * Write entities to a JSONL file
+ * Each entity is written as a single line of JSON
+ * Entities are sorted by created_at date to minimize merge conflicts
+ */
+export async function writeJSONL(filePath, entities, options = {}) {
+    const { atomic = true } = options;
+    // Ensure directory exists
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const targetPath = atomic ? `${filePath}.tmp` : filePath;
+    // Sort entities by created_at date to minimize merge conflicts
+    const sortedEntities = [...entities].sort((a, b) => {
+        const aDate = a.created_at;
+        const bDate = b.created_at;
+        // Handle missing created_at fields - put them at the end
+        if (!aDate && !bDate) {
+            // Both missing dates, sort by ID
+            const aId = a.id || "";
+            const bId = b.id || "";
+            return aId < bId ? -1 : aId > bId ? 1 : 0;
+        }
+        if (!aDate)
+            return 1;
+        if (!bDate)
+            return -1;
+        // Compare dates as strings (ISO 8601 format sorts lexicographically)
+        if (aDate < bDate)
+            return -1;
+        if (aDate > bDate)
+            return 1;
+        // If dates are equal, fall back to ID comparison
+        const aId = a.id || "";
+        const bId = b.id || "";
+        return aId < bId ? -1 : aId > bId ? 1 : 0;
+    });
+    // Write each entity as a line
+    const lines = sortedEntities.map((entity) => JSON.stringify(entity));
+    const content = lines.join("\n") + "\n";
+    // Check if content has actually changed before writing
+    // This prevents unnecessary file writes that trigger watcher events
+    if (fs.existsSync(filePath)) {
+        const existingContent = fs.readFileSync(filePath, "utf8");
+        if (existingContent === content) {
+            // Content unchanged, skip write
+            return;
+        }
+    }
+    fs.writeFileSync(targetPath, content, "utf8");
+    // Atomic rename if requested
+    if (atomic) {
+        fs.renameSync(targetPath, filePath);
+    }
+    // Set file modification time to match the newest updated_at timestamp
+    // This ensures filesystem mtime reflects content timestamps for accurate sync direction detection
+    if (sortedEntities.length > 0) {
+        const timestamps = sortedEntities
+            .map((e) => e.updated_at)
+            .filter((t) => t != null)
+            .map((t) => {
+            // Append 'Z' if not present to force UTC interpretation
+            const timestamp = String(t);
+            const hasZone = timestamp.endsWith("Z") ||
+                timestamp.includes("+") ||
+                /[+-]\d{2}:\d{2}$/.test(timestamp);
+            const utcTimestamp = hasZone
+                ? timestamp
+                : timestamp.replace(" ", "T") + "Z";
+            return new Date(utcTimestamp).getTime();
+        });
+        if (timestamps.length > 0) {
+            const newestTimestamp = Math.max(...timestamps);
+            const mtimeDate = new Date(newestTimestamp);
+            fs.utimesSync(filePath, mtimeDate, mtimeDate);
+        }
+    }
+}
+/**
+ * Write entities to a JSONL file synchronously
+ * Entities are sorted by created_at date to minimize merge conflicts
+ */
+export function writeJSONLSync(filePath, entities, options = {}) {
+    const { atomic = true } = options;
+    // Ensure directory exists
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const targetPath = atomic ? `${filePath}.tmp` : filePath;
+    // Sort entities by created_at date to minimize merge conflicts
+    const sortedEntities = [...entities].sort((a, b) => {
+        const aDate = a.created_at;
+        const bDate = b.created_at;
+        // Handle missing created_at fields - put them at the end
+        if (!aDate && !bDate) {
+            // Both missing dates, sort by ID
+            const aId = a.id || "";
+            const bId = b.id || "";
+            return aId < bId ? -1 : aId > bId ? 1 : 0;
+        }
+        if (!aDate)
+            return 1;
+        if (!bDate)
+            return -1;
+        // Compare dates as strings (ISO 8601 format sorts lexicographically)
+        if (aDate < bDate)
+            return -1;
+        if (aDate > bDate)
+            return 1;
+        // If dates are equal, fall back to ID comparison
+        const aId = a.id || "";
+        const bId = b.id || "";
+        return aId < bId ? -1 : aId > bId ? 1 : 0;
+    });
+    // Write each entity as a line
+    const lines = sortedEntities.map((entity) => JSON.stringify(entity));
+    const content = lines.join("\n") + "\n";
+    // Check if content has actually changed before writing
+    // This prevents unnecessary file writes that trigger watcher events
+    if (fs.existsSync(filePath)) {
+        const existingContent = fs.readFileSync(filePath, "utf8");
+        if (existingContent === content) {
+            // Content unchanged, skip write
+            return;
+        }
+    }
+    fs.writeFileSync(targetPath, content, "utf8");
+    // Atomic rename if requested
+    if (atomic) {
+        fs.renameSync(targetPath, filePath);
+    }
+    // Set file modification time to match the newest updated_at timestamp
+    // This ensures filesystem mtime reflects content timestamps for accurate sync direction detection
+    if (sortedEntities.length > 0) {
+        const timestamps = sortedEntities
+            .map((e) => e.updated_at)
+            .filter((t) => t != null)
+            .map((t) => {
+            // Append 'Z' if not present to force UTC interpretation
+            const timestamp = String(t);
+            const hasZone = timestamp.endsWith("Z") ||
+                timestamp.includes("+") ||
+                /[+-]\d{2}:\d{2}$/.test(timestamp);
+            const utcTimestamp = hasZone
+                ? timestamp
+                : timestamp.replace(" ", "T") + "Z";
+            return new Date(utcTimestamp).getTime();
+        });
+        if (timestamps.length > 0) {
+            const newestTimestamp = Math.max(...timestamps);
+            const mtimeDate = new Date(newestTimestamp);
+            fs.utimesSync(filePath, mtimeDate, mtimeDate);
+        }
+    }
+}
+/**
+ * Update a single line in a JSONL file by entity ID
+ * If the entity doesn't exist, append it
+ * If it exists, replace the line
+ */
+export async function updateJSONLLine(filePath, entity, idField = "id") {
+    const entityId = entity[idField];
+    if (!entityId) {
+        throw new Error(`Entity missing ${idField} field`);
+    }
+    // Read existing entities
+    const entities = await readJSONL(filePath, { skipErrors: true });
+    // Find and update or append
+    const index = entities.findIndex((e) => e[idField] === entityId);
+    if (index >= 0) {
+        // Replace existing
+        entities[index] = entity;
+    }
+    else {
+        // Append new
+        entities.push(entity);
+    }
+    // Write back
+    await writeJSONL(filePath, entities);
+}
+/**
+ * Update a single line in a JSONL file synchronously
+ */
+export function updateJSONLLineSync(filePath, entity, idField = "id") {
+    const entityId = entity[idField];
+    if (!entityId) {
+        throw new Error(`Entity missing ${idField} field`);
+    }
+    // Read existing entities
+    const entities = readJSONLSync(filePath, { skipErrors: true });
+    // Find and update or append
+    const index = entities.findIndex((e) => e[idField] === entityId);
+    if (index >= 0) {
+        // Replace existing
+        entities[index] = entity;
+    }
+    else {
+        // Append new
+        entities.push(entity);
+    }
+    // Write back
+    writeJSONLSync(filePath, entities);
+}
+/**
+ * Delete an entity from a JSONL file by ID
+ */
+export async function deleteJSONLLine(filePath, entityId, idField = "id") {
+    // Read existing entities
+    const entities = await readJSONL(filePath, { skipErrors: true });
+    // Filter out the entity
+    const initialLength = entities.length;
+    const filtered = entities.filter((e) => e[idField] !== entityId);
+    if (filtered.length === initialLength) {
+        return false; // Nothing deleted
+    }
+    // Write back
+    await writeJSONL(filePath, filtered);
+    return true;
+}
+/**
+ * Delete an entity from a JSONL file synchronously
+ */
+export function deleteJSONLLineSync(filePath, entityId, idField = "id") {
+    // Read existing entities
+    const entities = readJSONLSync(filePath, { skipErrors: true });
+    // Filter out the entity
+    const initialLength = entities.length;
+    const filtered = entities.filter((e) => e[idField] !== entityId);
+    if (filtered.length === initialLength) {
+        return false; // Nothing deleted
+    }
+    // Write back
+    writeJSONLSync(filePath, filtered);
+    return true;
+}
+/**
+ * Get a single entity from a JSONL file by ID
+ */
+export async function getJSONLEntity(filePath, entityId, idField = "id") {
+    const entities = await readJSONL(filePath, { skipErrors: true });
+    return entities.find((e) => e[idField] === entityId) ?? null;
+}
+/**
+ * Get a single entity from a JSONL file synchronously
+ */
+export function getJSONLEntitySync(filePath, entityId, idField = "id") {
+    const entities = readJSONLSync(filePath, { skipErrors: true });
+    return entities.find((e) => e[idField] === entityId) ?? null;
+}
+//# sourceMappingURL=jsonl.js.map

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

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

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

@@ -0,0 +1,146 @@
+/**
+ * Markdown parser with frontmatter support
+ */
+import type Database from "better-sqlite3";
+import type { LocationAnchor } from "@sudocode-ai/types";
+export interface ParsedMarkdown<T extends object = Record<string, any>> {
+    /**
+     * Parsed frontmatter data
+     */
+    data: T;
+    /**
+     * Markdown content (without frontmatter)
+     */
+    content: string;
+    /**
+     * Original raw content
+     */
+    raw: string;
+    /**
+     * Cross-references found in content
+     */
+    references: CrossReference[];
+}
+export interface CrossReference {
+    /**
+     * The full matched text (e.g., "[[spec-001]]" or "[[@issue-042]]")
+     */
+    match: string;
+    /**
+     * The entity ID (e.g., "spec-001" or "issue-042")
+     */
+    id: string;
+    /**
+     * Entity type (spec or issue)
+     */
+    type: "spec" | "issue";
+    /**
+     * Position in content
+     */
+    index: number;
+    /**
+     * Optional display text (e.g., "Authentication" from "[[spec-001|Authentication]]")
+     */
+    displayText?: string;
+    /**
+     * Optional relationship type (e.g., "blocks" from "[[spec-001]]{ blocks }")
+     * Defaults to "references" if not specified
+     */
+    relationshipType?: string;
+    /**
+     * Optional location anchor for spatial context of the reference
+     */
+    anchor?: LocationAnchor;
+}
+/**
+ * Parse markdown file with YAML frontmatter
+ * @param content - Markdown content to parse
+ * @param db - Optional database for validating cross-references
+ * @param outputDir - Optional output directory for loading config metadata
+ */
+export declare function parseMarkdown<T extends object = Record<string, any>>(content: string, db?: Database.Database, outputDir?: string): ParsedMarkdown<T>;
+/**
+ * Parse markdown file from disk
+ * @param filePath - Path to markdown file
+ * @param db - Optional database for validating cross-references
+ * @param outputDir - Optional output directory for loading config metadata
+ */
+export declare function parseMarkdownFile<T extends object = Record<string, any>>(filePath: string, db?: Database.Database, outputDir?: string): ParsedMarkdown<T>;
+/**
+ * Extract cross-references from markdown content
+ * Supports formats:
+ * - [[i-x7k9]] or [[s-14sh]] - hash-based entity reference
+ * - [[@i-x7k9]] - entity reference with @ prefix (for clarity)
+ * - [[i-x7k9|Display Text]] - with custom display text
+ * - [[i-x7k9]]{ blocks } - with relationship type (shorthand)
+ * - [[i-x7k9]]{ type: blocks } - with relationship type (explicit)
+ * - [[i-x7k9|Display]]{ blocks } - combination of display text and type
+ *
+ * If db is provided, validates references against the database and determines entity type.
+ * Only returns references to entities that actually exist.
+ *
+ * If db is not provided, determines entity type from hash-based ID prefix (i- or s-).
+ */
+export declare function extractCrossReferences(content: string, db?: Database.Database): CrossReference[];
+/**
+ * Stringify frontmatter and content back to markdown
+ */
+export declare function stringifyMarkdown<T extends object = Record<string, any>>(data: T, content: string): string;
+/**
+ * Update frontmatter in an existing markdown file
+ * Preserves content unchanged
+ */
+export declare function updateFrontmatter<T extends object = Record<string, any>>(originalContent: string, updates: Partial<T>): string;
+/**
+ * Update frontmatter in a file
+ */
+export declare function updateFrontmatterFile<T extends object = Record<string, any>>(filePath: string, updates: Partial<T>): void;
+/**
+ * Check if a file has frontmatter
+ */
+export declare function hasFrontmatter(content: string): boolean;
+/**
+ * Create markdown with frontmatter
+ */
+export declare function createMarkdown<T extends object = Record<string, any>>(data: T, content: string): string;
+/**
+ * Write markdown file with frontmatter
+ */
+export declare function writeMarkdownFile<T extends object = Record<string, any>>(filePath: string, data: T, content: string): void;
+/**
+ * Remove frontmatter from markdown content
+ */
+export declare function removeFrontmatter(content: string): string;
+/**
+ * Get only frontmatter data from markdown
+ */
+export declare function getFrontmatter<T extends object = Record<string, any>>(content: string): T;
+export interface FeedbackMarkdownData {
+    id: string;
+    specId: string;
+    specTitle?: string;
+    type: string;
+    location: {
+        section?: string;
+        line?: number;
+        status: "valid" | "relocated" | "stale";
+    };
+    status: string;
+    content: string;
+    createdAt: string;
+    resolution?: string;
+}
+/**
+ * Parse feedback section from issue markdown content
+ * Looks for "## Spec Feedback Provided" section
+ */
+export declare function parseFeedbackSection(content: string): FeedbackMarkdownData[];
+/**
+ * Format feedback data for inclusion in issue markdown
+ */
+export declare function formatFeedbackForIssue(feedback: FeedbackMarkdownData[]): string;
+/**
+ * Append or update feedback section in issue markdown
+ */
+export declare function updateFeedbackInIssue(issueContent: string, feedback: FeedbackMarkdownData[]): string;
+//# sourceMappingURL=markdown.d.ts.map

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

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