sudocode 1.1.17 → 1.1.18-dev.0

package/node_modules/@sudocode-ai/cli/dist/filename-generator.js

@@ -0,0 +1,103 @@
+/**
+ * Generate human-readable filenames from spec titles
+ */
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Convert a title to snake_case filename
+ * - Lowercase
+ * - Replace spaces and special chars with underscores
+ * - Remove consecutive underscores
+ * - Trim underscores from start/end
+ * - Truncate to reasonable length
+ */
+export function titleToFilename(title, maxLength = 50) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_") // Replace non-alphanumeric with underscore
+        .replace(/_+/g, "_") // Replace multiple underscores with single
+        .replace(/^_|_$/g, "") // Trim underscores from start/end
+        .slice(0, maxLength); // Truncate to max length
+}
+/**
+ * Generate a unified filename with format: {id}_{title_slug}.md
+ * This format is used for both specs and issues to ensure consistency.
+ * @param title - The entity title
+ * @param id - The entity ID
+ * @param extension - File extension (default: .md)
+ * @returns Filename in format: {id}_{title_slug}.md
+ */
+export function generateUniqueFilename(title, id, extension = ".md") {
+    const titleSlug = titleToFilename(title);
+    const filename = `${id}_${titleSlug}${extension}`;
+    return filename;
+}
+/**
+ * Find existing markdown file for an entity (supports multiple naming conventions)
+ * Works for both specs and issues.
+ * @param entityId - The entity ID
+ * @param directory - Directory to search
+ * @param title - Optional title for title-based search
+ * @returns Path to existing file if found, null otherwise
+ */
+export function findExistingEntityFile(entityId, directory, title) {
+    // Try new unified format: {id}_{title_slug}.md
+    if (title) {
+        const unifiedFile = path.join(directory, `${entityId}_${titleToFilename(title)}.md`);
+        if (fs.existsSync(unifiedFile)) {
+            return unifiedFile;
+        }
+    }
+    // Try ID-based filename (legacy for issues, and legacy specs)
+    const idBasedFile = path.join(directory, `${entityId}.md`);
+    if (fs.existsSync(idBasedFile)) {
+        return idBasedFile;
+    }
+    // Try title-based filename (legacy for specs)
+    if (title) {
+        const titleBasedFile = path.join(directory, `${titleToFilename(title)}.md`);
+        if (fs.existsSync(titleBasedFile)) {
+            // Verify it's the right entity by checking ID in frontmatter
+            try {
+                const content = fs.readFileSync(titleBasedFile, "utf8");
+                const idMatch = content.match(/^---\s*\n[\s\S]*?^id:\s*['"]?([^'"\n]+)['"]?\s*$/m);
+                if (idMatch && idMatch[1] === entityId) {
+                    return titleBasedFile;
+                }
+            }
+            catch (error) {
+                // Continue searching
+            }
+        }
+        // Try title-based with ID suffix (legacy collision resolution)
+        const titleWithIdFile = path.join(directory, `${titleToFilename(title)}_${entityId}.md`);
+        if (fs.existsSync(titleWithIdFile)) {
+            return titleWithIdFile;
+        }
+    }
+    // Search directory for any file with matching ID in frontmatter
+    try {
+        const files = fs.readdirSync(directory);
+        for (const file of files) {
+            if (!file.endsWith(".md"))
+                continue;
+            const filePath = path.join(directory, file);
+            try {
+                const content = fs.readFileSync(filePath, "utf8");
+                const idMatch = content.match(/^---\s*\n[\s\S]*?^id:\s*['"]?([^'"\n]+)['"]?\s*$/m);
+                if (idMatch && idMatch[1] === entityId) {
+                    return filePath;
+                }
+            }
+            catch (error) {
+                // Skip files we can't read
+            }
+        }
+    }
+    catch (error) {
+        // Directory doesn't exist or can't be read
+    }
+    // Not found
+    return null;
+}
+//# sourceMappingURL=filename-generator.js.map

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

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

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

@@ -0,0 +1,63 @@
+/**
+ * ID generation utilities
+ *
+ * Supports two ID formats:
+ * 1. Legacy: SPEC-001, ISSUE-001 (sequential numbers)
+ * 2. Hash-based: s-x7k9, i-a3f2 (UUID-derived base36 hashes)
+ *
+ * New entities use hash-based IDs for better distributed workflow support.
+ * Legacy IDs remain supported indefinitely.
+ */
+import type Database from "better-sqlite3";
+/**
+ * Calculate adaptive hash length based on entity count
+ * Uses birthday paradox probability to determine safe length
+ *
+ * Target: Keep collision probability under 25%
+ * Base36 namespace sizes:
+ * - 4 chars: ~1.7M namespace → ~980 items at 25% collision prob
+ * - 5 chars: ~60M namespace → ~5.9K items at 25% collision prob
+ * - 6 chars: ~2.2B namespace → ~35K items at 25% collision prob
+ * - 7 chars: ~78B namespace → ~212K items at 25% collision prob
+ * - 8 chars: ~2.8T namespace → ~1M+ items at 25% collision prob
+ */
+export declare function getAdaptiveHashLength(count: number): number;
+/**
+ * Convert UUID to base36 hash
+ * Takes first N hex digits of SHA256(UUID) and converts to base36
+ */
+export declare function hashUUIDToBase36(uuid: string, length: number): string;
+/**
+ * Check if ID is legacy format (SPEC-001, ISSUE-001)
+ */
+export declare function isLegacyID(id: string): boolean;
+/**
+ * Check if ID is hash format (i-x7k9, s-a3f2)
+ */
+export declare function isHashID(id: string): boolean;
+/**
+ * Generate spec ID and UUID
+ * Returns hash-based ID derived from UUID
+ */
+export declare function generateSpecId(db: Database.Database, outputDir: string): {
+    id: string;
+    uuid: string;
+};
+/**
+ * Generate issue ID and UUID
+ * Returns hash-based ID derived from UUID
+ */
+export declare function generateIssueId(db: Database.Database, outputDir: string): {
+    id: string;
+    uuid: string;
+};
+/**
+ * Generate a UUID v4
+ */
+export declare function generateUUID(): string;
+/**
+ * Infer entity type from ID
+ * Supports both hash-based (i-xxxx, s-xxxx) and legacy (ISSUE-xxx, SPEC-xxx) formats
+ */
+export declare function getEntityTypeFromId(id: string): "spec" | "issue";
+//# sourceMappingURL=id-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../src/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BrE;AAoCD;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAU9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAU9B;AA8DD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAkBhE"}

package/node_modules/@sudocode-ai/cli/dist/id-generator.js

@@ -0,0 +1,196 @@
+/**
+ * ID generation utilities
+ *
+ * Supports two ID formats:
+ * 1. Legacy: SPEC-001, ISSUE-001 (sequential numbers)
+ * 2. Hash-based: s-x7k9, i-a3f2 (UUID-derived base36 hashes)
+ *
+ * New entities use hash-based IDs for better distributed workflow support.
+ * Legacy IDs remain supported indefinitely.
+ */
+import * as crypto from "crypto";
+/**
+ * Calculate adaptive hash length based on entity count
+ * Uses birthday paradox probability to determine safe length
+ *
+ * Target: Keep collision probability under 25%
+ * Base36 namespace sizes:
+ * - 4 chars: ~1.7M namespace → ~980 items at 25% collision prob
+ * - 5 chars: ~60M namespace → ~5.9K items at 25% collision prob
+ * - 6 chars: ~2.2B namespace → ~35K items at 25% collision prob
+ * - 7 chars: ~78B namespace → ~212K items at 25% collision prob
+ * - 8 chars: ~2.8T namespace → ~1M+ items at 25% collision prob
+ */
+export function getAdaptiveHashLength(count) {
+    if (count < 980)
+        return 4; // i-x7k9
+    if (count < 5900)
+        return 5; // i-x7k9p
+    if (count < 35000)
+        return 6; // i-x7k9p1
+    if (count < 212000)
+        return 7; // i-x7k9p1a
+    return 8; // i-x7k9p1a4
+}
+/**
+ * Convert UUID to base36 hash
+ * Takes first N hex digits of SHA256(UUID) and converts to base36
+ */
+export function hashUUIDToBase36(uuid, length) {
+    // Remove hyphens from UUID
+    const cleanUUID = uuid.replace(/-/g, "");
+    // Hash the UUID with SHA256 for better distribution
+    const hash = crypto.createHash("sha256").update(cleanUUID).digest("hex");
+    // Take enough hex chars to generate desired base36 length
+    // Each base36 char needs ~1.29 hex chars (log(36)/log(16))
+    const hexCharsNeeded = Math.ceil(length * 1.29);
+    const hexSubstring = hash.substring(0, hexCharsNeeded);
+    // Convert hex to bigint, then to base36
+    const bigInt = BigInt("0x" + hexSubstring);
+    let result = bigInt.toString(36).toLowerCase();
+    // Pad with zeros if needed
+    if (result.length < length) {
+        result = result.padStart(length, "0");
+    }
+    // Truncate to exact length if needed
+    if (result.length > length) {
+        result = result.substring(0, length);
+    }
+    return result;
+}
+/**
+ * Generate hash-based ID from UUID with collision checking
+ */
+function generateHashIDFromUUID(db, uuid, entityType, count) {
+    const prefix = entityType === "spec" ? "s" : "i";
+    const baseLength = getAdaptiveHashLength(count);
+    // Try progressively longer hashes on collision (very rare)
+    for (let length = baseLength; length <= 8; length++) {
+        const hash = hashUUIDToBase36(uuid, length);
+        const candidate = `${prefix}-${hash}`;
+        // Check if this ID already exists
+        const table = entityType === "spec" ? "specs" : "issues";
+        const existsStmt = db.prepare(`SELECT COUNT(*) as count FROM ${table} WHERE id = ?`);
+        const result = existsStmt.get(candidate);
+        if (result.count === 0) {
+            return candidate;
+        }
+    }
+    throw new Error(`Failed to generate unique hash ID for ${entityType} after trying lengths ${baseLength}-8`);
+}
+/**
+ * Check if ID is legacy format (SPEC-001, ISSUE-001)
+ */
+export function isLegacyID(id) {
+    return /^(SPEC|ISSUE)-\d+$/.test(id);
+}
+/**
+ * Check if ID is hash format (i-x7k9, s-a3f2)
+ */
+export function isHashID(id) {
+    return /^[is]-[0-9a-z]{4,8}$/.test(id);
+}
+/**
+ * Generate spec ID and UUID
+ * Returns hash-based ID derived from UUID
+ */
+export function generateSpecId(db, outputDir) {
+    const uuid = crypto.randomUUID();
+    // Count existing specs for adaptive length
+    const countStmt = db.prepare(`SELECT COUNT(*) as count FROM specs`);
+    const result = countStmt.get();
+    const id = generateHashIDFromUUID(db, uuid, "spec", result.count);
+    return { id, uuid };
+}
+/**
+ * Generate issue ID and UUID
+ * Returns hash-based ID derived from UUID
+ */
+export function generateIssueId(db, outputDir) {
+    const uuid = crypto.randomUUID();
+    // Count existing issues for adaptive length
+    const countStmt = db.prepare(`SELECT COUNT(*) as count FROM issues`);
+    const result = countStmt.get();
+    const id = generateHashIDFromUUID(db, uuid, "issue", result.count);
+    return { id, uuid };
+}
+/**
+ * Get next spec number from database
+ * Strategy:
+ * 1. Find the latest spec by created_at
+ * 2. Extract number from its ID
+ * 3. Increment by 1
+ * 4. Fallback to count + 1 if extraction fails
+ */
+function getNextSpecNumber(db) {
+    const stmt = db.prepare(`
+    SELECT id FROM specs
+    ORDER BY created_at DESC
+    LIMIT 1
+  `);
+    const latest = stmt.get();
+    if (latest) {
+        const match = latest.id.match(/(\d+)$/);
+        if (match) {
+            return parseInt(match[1], 10) + 1;
+        }
+    }
+    // Fallback: count + 1
+    const countStmt = db.prepare(`SELECT COUNT(*) as count FROM specs`);
+    const result = countStmt.get();
+    return result.count + 1;
+}
+/**
+ * Get next issue number from database
+ * Strategy:
+ * 1. Find the latest issue by created_at
+ * 2. Extract number from its ID
+ * 3. Increment by 1
+ * 4. Fallback to count + 1 if extraction fails
+ */
+function getNextIssueNumber(db) {
+    const stmt = db.prepare(`
+    SELECT id FROM issues
+    ORDER BY created_at DESC
+    LIMIT 1
+  `);
+    const latest = stmt.get();
+    if (latest) {
+        const match = latest.id.match(/(\d+)$/);
+        if (match) {
+            return parseInt(match[1], 10) + 1;
+        }
+    }
+    // Fallback: count + 1
+    const countStmt = db.prepare(`SELECT COUNT(*) as count FROM issues`);
+    const result = countStmt.get();
+    return result.count + 1;
+}
+/**
+ * Generate a UUID v4
+ */
+export function generateUUID() {
+    return crypto.randomUUID();
+}
+/**
+ * Infer entity type from ID
+ * Supports both hash-based (i-xxxx, s-xxxx) and legacy (ISSUE-xxx, SPEC-xxx) formats
+ */
+export function getEntityTypeFromId(id) {
+    // Hash format: i-xxxx for issues, s-xxxx for specs
+    if (id.startsWith("i-")) {
+        return "issue";
+    }
+    if (id.startsWith("s-")) {
+        return "spec";
+    }
+    // Legacy format: ISSUE-xxx for issues, SPEC-xxx for specs
+    if (id.startsWith("ISSUE-")) {
+        return "issue";
+    }
+    if (id.startsWith("SPEC-")) {
+        return "spec";
+    }
+    throw new Error(`Cannot infer entity type from ID: ${id}`);
+}
+//# sourceMappingURL=id-generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../src/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,CAAC,CAAC,CAAC,SAAS;IACpC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC,UAAU;IACtC,IAAI,KAAK,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC,CAAC,WAAW;IACxC,IAAI,KAAK,GAAG,MAAM;QAAE,OAAO,CAAC,CAAC,CAAC,YAAY;IAC1C,OAAO,CAAC,CAAC,CAAC,aAAa;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAc;IAC3D,2BAA2B;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEzC,oDAAoD;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzE,0DAA0D;IAC1D,2DAA2D;IAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAEvD,wCAAwC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE/C,2BAA2B;IAC3B,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,qCAAqC;IACrC,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC7B,EAAqB,EACrB,IAAY,EACZ,UAA4B,EAC5B,KAAa;IAEb,MAAM,MAAM,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACjD,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAEhD,2DAA2D;IAC3D,KAAK,IAAI,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;QAEtC,kCAAkC;QAClC,MAAM,KAAK,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzD,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B,iCAAiC,KAAK,eAAe,CACtD,CAAC;QACF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAsB,CAAC;QAE9D,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,yBAAyB,UAAU,IAAI,CAC3F,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,EAAqB,EACrB,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEjC,2CAA2C;IAC3C,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAuB,CAAC;IAEpD,MAAM,EAAE,GAAG,sBAAsB,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAElE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEjC,4CAA4C;IAC5C,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAuB,CAAC;IAEpD,MAAM,EAAE,GAAG,sBAAsB,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,EAAqB;IAC9C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;GAIvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAgC,CAAC;IAExD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAuB,CAAC;IACpD,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,kBAAkB,CAAC,EAAqB;IAC/C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;GAIvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAgC,CAAC;IAExD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAuB,CAAC;IACpD,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,mDAAmD;IACnD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,0DAA0D;IAC1D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,134 @@
+/**
+ * Import JSONL data to SQLite with collision resolution
+ */
+import type Database from "better-sqlite3";
+import type { SpecJSONL, IssueJSONL } from "@sudocode-ai/types";
+/**
+ * Warnings collected during import for non-fatal issues
+ */
+export interface ImportWarning {
+    type: "missing_entity" | "invalid_relationship";
+    message: string;
+    entityId?: string;
+    relationshipFrom?: string;
+    relationshipTo?: string;
+}
+export interface ImportOptions {
+    /**
+     * Input directory for JSONL files
+     */
+    inputDir?: string;
+    /**
+     * Custom file names
+     */
+    specsFile?: string;
+    issuesFile?: string;
+    /**
+     * Dry run - detect changes but don't apply
+     */
+    dryRun?: boolean;
+    /**
+     * Automatically resolve collisions
+     */
+    resolveCollisions?: boolean;
+    /**
+     * Path to meta.json for collision logging
+     */
+    metaPath?: string;
+    /**
+     * Force update these entity IDs even if timestamp hasn't changed
+     * Useful when file watcher detects content hash changes
+     */
+    forceUpdateIds?: string[];
+}
+export interface ImportResult {
+    specs: {
+        added: number;
+        updated: number;
+        deleted: number;
+    };
+    issues: {
+        added: number;
+        updated: number;
+        deleted: number;
+    };
+    collisions: CollisionInfo[];
+    warnings?: ImportWarning[];
+}
+export interface CollisionInfo {
+    id: string;
+    uuid: string;
+    type: "spec" | "issue";
+    reason: string;
+    localContent: string;
+    incomingContent: string;
+    localCreatedAt?: string;
+    incomingCreatedAt: string;
+    resolution?: "keep-local" | "use-incoming" | "renumber";
+    newId?: string;
+}
+export interface ChangeDetection {
+    added: string[];
+    updated: string[];
+    deleted: string[];
+    unchanged: string[];
+}
+/**
+ * Detect changes between existing and incoming entities
+ * Uses UUID as the source of truth for entity identity
+ */
+export declare function detectChanges<T extends {
+    id: string;
+    uuid: string;
+    updated_at: string;
+}>(existing: T[], incoming: T[], forceUpdateIds?: string[]): ChangeDetection;
+/**
+ * Detect ID collisions (same ID, different UUID)
+ * UUIDs are the source of truth for entity identity
+ */
+export declare function detectCollisions<T extends {
+    id: string;
+    uuid: string;
+    title: string;
+    created_at: string;
+}>(existing: T[], incoming: T[]): CollisionInfo[];
+/**
+ * Count references to an entity ID in content fields
+ */
+export declare function countReferences(db: Database.Database, entityId: string, entityType: "spec" | "issue"): number;
+/**
+ * Resolve collisions using timestamp-based deterministic strategy
+ *
+ * The entity with the NEWER (more recent) created_at timestamp logically
+ * should be renumbered, while the OLDER entity keeps the original ID.
+ *
+ * For practical reasons (entities already in DB can't be easily renamed),
+ * incoming entities are always the ones that get new IDs. However, we
+ * deterministically decide which UUID gets which new ID based on timestamps.
+ */
+export declare function resolveCollisions(db: Database.Database, collisions: CollisionInfo[]): CollisionInfo[];
+/**
+ * Update text references when an ID is renumbered
+ */
+export declare function updateTextReferences(db: Database.Database, oldId: string, newId: string): number;
+/**
+ * Import specs from JSONL
+ */
+export declare function importSpecs(db: Database.Database, specs: SpecJSONL[], changes: ChangeDetection, dryRun?: boolean, skipRelationships?: boolean): {
+    added: number;
+    updated: number;
+    deleted: number;
+};
+/**
+ * Import issues from JSONL
+ */
+export declare function importIssues(db: Database.Database, issues: IssueJSONL[], changes: ChangeDetection, dryRun?: boolean, skipRelationships?: boolean): {
+    added: number;
+    updated: number;
+    deleted: number;
+};
+/**
+ * Import both specs and issues from JSONL files
+ */
+export declare function importFromJSONL(db: Database.Database, options?: ImportOptions): Promise<ImportResult>;
+//# sourceMappingURL=import.d.ts.map

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

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