sudocode 1.0.0 → 1.1.1

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

@@ -0,0 +1,79 @@
+/**
+ * Export SQLite data to JSONL files
+ */
+import type Database from "better-sqlite3";
+import type { Spec, Issue, SpecJSONL, IssueJSONL } from "./types.js";
+export interface ExportOptions {
+    /**
+     * Output directory for JSONL files
+     */
+    outputDir?: string;
+    /**
+     * Only export entities that have been updated since this timestamp
+     */
+    since?: Date;
+    /**
+     * Custom file names
+     */
+    specsFile?: string;
+    issuesFile?: string;
+}
+/**
+ * Convert a Spec to SpecJSONL format with embedded relationships and tags
+ */
+export declare function specToJSONL(db: Database.Database, spec: Spec): SpecJSONL;
+/**
+ * Convert an Issue to IssueJSONL format with embedded relationships and tags
+ */
+export declare function issueToJSONL(db: Database.Database, issue: Issue): IssueJSONL;
+/**
+ * Export all specs to JSONL format
+ */
+export declare function exportSpecsToJSONL(db: Database.Database, options?: ExportOptions): SpecJSONL[];
+/**
+ * Export all issues to JSONL format
+ */
+export declare function exportIssuesToJSONL(db: Database.Database, options?: ExportOptions): IssueJSONL[];
+/**
+ * Export both specs and issues to JSONL files
+ */
+export declare function exportToJSONL(db: Database.Database, options?: ExportOptions): Promise<{
+    specsCount: number;
+    issuesCount: number;
+}>;
+/**
+ * Debouncer for export operations
+ */
+export declare class ExportDebouncer {
+    private db;
+    private delayMs;
+    private options;
+    private timeoutId;
+    private pending;
+    constructor(db: Database.Database, delayMs?: number, options?: ExportOptions);
+    /**
+     * Trigger an export (will be debounced)
+     */
+    trigger(): void;
+    /**
+     * Execute the export immediately
+     */
+    execute(): Promise<void>;
+    /**
+     * Cancel any pending export
+     */
+    cancel(): void;
+    /**
+     * Check if an export is pending
+     */
+    isPending(): boolean;
+    /**
+     * Wait for any pending export to complete
+     */
+    flush(): Promise<void>;
+}
+/**
+ * Create a debounced export function
+ */
+export declare function createDebouncedExport(db: Database.Database, delayMs?: number, options?: ExportOptions): ExportDebouncer;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,IAAI,EACJ,KAAK,EACL,SAAS,EACT,UAAU,EAGX,MAAM,YAAY,CAAC;AAQpB,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC;IACb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,SAAS,CAqBxE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,CAwC5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,aAAkB,GAC1B,SAAS,EAAE,CAab;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,aAAkB,GAC1B,UAAU,EAAE,CAad;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBtD;AAED;;GAEG;AACH,qBAAa,eAAe;IAKxB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,OAAO,CAAkB;gBAGvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,MAAa,EACtB,OAAO,GAAE,aAAkB;IAGrC;;OAEG;IACH,OAAO,IAAI,IAAI;IAYf;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,MAAa,EACtB,OAAO,GAAE,aAAkB,GAC1B,eAAe,CAEjB"}

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

@@ -0,0 +1,195 @@
+/**
+ * Export SQLite data to JSONL files
+ */
+import { listSpecs } from "./operations/specs.js";
+import { listIssues } from "./operations/issues.js";
+import { getOutgoingRelationships } from "./operations/relationships.js";
+import { getTags } from "./operations/tags.js";
+import { listFeedback } from "./operations/feedback.js";
+import { writeJSONL } from "./jsonl.js";
+/**
+ * Convert a Spec to SpecJSONL format with embedded relationships and tags
+ */
+export function specToJSONL(db, spec) {
+    // Get outgoing relationships
+    const relationships = getOutgoingRelationships(db, spec.id, "spec");
+    // Convert to JSONL format
+    const relationshipsJSONL = relationships.map((rel) => ({
+        from: rel.from_id,
+        from_type: rel.from_type,
+        to: rel.to_id,
+        to_type: rel.to_type,
+        type: rel.relationship_type,
+    }));
+    // Get tags
+    const tags = getTags(db, spec.id, "spec");
+    return {
+        ...spec,
+        relationships: relationshipsJSONL,
+        tags,
+    };
+}
+/**
+ * Convert an Issue to IssueJSONL format with embedded relationships and tags
+ */
+export function issueToJSONL(db, issue) {
+    // Get outgoing relationships
+    const relationships = getOutgoingRelationships(db, issue.id, "issue");
+    // Convert to JSONL format
+    const relationshipsJSONL = relationships.map((rel) => ({
+        from: rel.from_id,
+        from_type: rel.from_type,
+        to: rel.to_id,
+        to_type: rel.to_type,
+        type: rel.relationship_type,
+    }));
+    // Get tags
+    const tags = getTags(db, issue.id, "issue");
+    // Get feedback provided by this issue
+    const feedbackList = listFeedback(db, { issue_id: issue.id });
+    const feedbackJSONL = feedbackList.map((feedback) => ({
+        id: feedback.id,
+        issue_id: feedback.issue_id,
+        spec_id: feedback.spec_id,
+        feedback_type: feedback.feedback_type,
+        content: feedback.content,
+        agent: feedback.agent,
+        anchor: feedback.anchor && typeof feedback.anchor === "string"
+            ? JSON.parse(feedback.anchor)
+            : feedback.anchor,
+        dismissed: feedback.dismissed,
+        created_at: feedback.created_at,
+        updated_at: feedback.updated_at,
+    }));
+    return {
+        ...issue,
+        relationships: relationshipsJSONL,
+        tags,
+        feedback: feedbackJSONL.length > 0 ? feedbackJSONL : undefined,
+    };
+}
+/**
+ * Export all specs to JSONL format
+ */
+export function exportSpecsToJSONL(db, options = {}) {
+    const { since } = options;
+    // Get all specs (including archived)
+    const specs = listSpecs(db);
+    // Filter by timestamp if requested
+    const filtered = since
+        ? specs.filter((spec) => new Date(spec.updated_at) > since)
+        : specs;
+    // Convert to JSONL format with relationships and tags
+    return filtered.map((spec) => specToJSONL(db, spec));
+}
+/**
+ * Export all issues to JSONL format
+ */
+export function exportIssuesToJSONL(db, options = {}) {
+    const { since } = options;
+    // Get all issues (including archived)
+    const issues = listIssues(db);
+    // Filter by timestamp if requested
+    const filtered = since
+        ? issues.filter((issue) => new Date(issue.updated_at) > since)
+        : issues;
+    // Convert to JSONL format with relationships and tags
+    return filtered.map((issue) => issueToJSONL(db, issue));
+}
+/**
+ * Export both specs and issues to JSONL files
+ */
+export async function exportToJSONL(db, options = {}) {
+    const { outputDir = ".sudocode", specsFile = "specs.jsonl", issuesFile = "issues.jsonl", } = options;
+    const specsPath = `${outputDir}/${specsFile}`;
+    const issuesPath = `${outputDir}/${issuesFile}`;
+    // Export specs
+    const specs = exportSpecsToJSONL(db, options);
+    await writeJSONL(specsPath, specs);
+    // Export issues
+    const issues = exportIssuesToJSONL(db, options);
+    await writeJSONL(issuesPath, issues);
+    return {
+        specsCount: specs.length,
+        issuesCount: issues.length,
+    };
+}
+/**
+ * Debouncer for export operations
+ */
+export class ExportDebouncer {
+    db;
+    delayMs;
+    options;
+    timeoutId = null;
+    pending = false;
+    constructor(db, delayMs = 5000, options = {}) {
+        this.db = db;
+        this.delayMs = delayMs;
+        this.options = options;
+    }
+    /**
+     * Trigger an export (will be debounced)
+     */
+    trigger() {
+        this.pending = true;
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+        }
+        this.timeoutId = setTimeout(() => {
+            this.execute();
+        }, this.delayMs);
+    }
+    /**
+     * Execute the export immediately
+     */
+    async execute() {
+        if (!this.pending) {
+            return;
+        }
+        this.pending = false;
+        this.timeoutId = null;
+        try {
+            await exportToJSONL(this.db, this.options);
+        }
+        catch (error) {
+            console.error("Export failed:", error);
+            throw error;
+        }
+    }
+    /**
+     * Cancel any pending export
+     */
+    cancel() {
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+        this.pending = false;
+    }
+    /**
+     * Check if an export is pending
+     */
+    isPending() {
+        return this.pending;
+    }
+    /**
+     * Wait for any pending export to complete
+     */
+    async flush() {
+        if (this.pending) {
+            if (this.timeoutId) {
+                clearTimeout(this.timeoutId);
+                this.timeoutId = null;
+            }
+            await this.execute();
+        }
+    }
+}
+/**
+ * Create a debounced export function
+ */
+export function createDebouncedExport(db, delayMs = 5000, options = {}) {
+    return new ExportDebouncer(db, delayMs, options);
+}
+//# sourceMappingURL=export.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * Generate human-readable filenames from spec titles
+ */
+/**
+ * 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 declare function titleToFilename(title: string, maxLength?: number): string;
+/**
+ * Generate a unique filename based on title, with ID suffix if collision
+ * @param title - The spec title
+ * @param id - The spec ID (used for collision resolution)
+ * @param directory - Directory to check for collisions
+ * @param extension - File extension (default: .md)
+ * @returns Unique filename
+ */
+export declare function generateUniqueFilename(title: string, id: string, directory: string, extension?: string): string;
+/**
+ * Find existing markdown file for a spec (supports both naming conventions)
+ * @param specId - The spec ID
+ * @param directory - Directory to search
+ * @param title - Optional title for title-based search
+ * @returns Path to existing file if found, null otherwise
+ */
+export declare function findExistingSpecFile(specId: string, directory: string, title?: string): string | null;
+//# sourceMappingURL=filename-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filename-generator.d.ts","sourceRoot":"","sources":["../src/filename-generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAO7E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAc,GACxB,MAAM,CA4BR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAgCf"}

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

@@ -0,0 +1,93 @@
+/**
+ * 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 unique filename based on title, with ID suffix if collision
+ * @param title - The spec title
+ * @param id - The spec ID (used for collision resolution)
+ * @param directory - Directory to check for collisions
+ * @param extension - File extension (default: .md)
+ * @returns Unique filename
+ */
+export function generateUniqueFilename(title, id, directory, extension = '.md') {
+    const baseFilename = titleToFilename(title);
+    // Try base filename first
+    const baseFile = baseFilename + extension;
+    const basePath = path.join(directory, baseFile);
+    // If file doesn't exist, use base filename
+    if (!fs.existsSync(basePath)) {
+        return baseFile;
+    }
+    // Check if existing file is for the same spec (by reading its frontmatter ID)
+    try {
+        const existingContent = fs.readFileSync(basePath, 'utf8');
+        const idMatch = existingContent.match(/^---\s*\n[\s\S]*?^id:\s*['"]?([^'"\n]+)['"]?\s*$/m);
+        if (idMatch && idMatch[1] === id) {
+            // Same spec, use the existing filename
+            return baseFile;
+        }
+    }
+    catch (error) {
+        // If we can't read the file, assume it's a collision
+    }
+    // Collision detected - append ID
+    const collisionFilename = `${baseFilename}_${id}${extension}`;
+    return collisionFilename;
+}
+/**
+ * Find existing markdown file for a spec (supports both naming conventions)
+ * @param specId - The spec 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 findExistingSpecFile(specId, directory, title) {
+    // Try ID-based filename first (legacy)
+    const idBasedFile = path.join(directory, `${specId}.md`);
+    if (fs.existsSync(idBasedFile)) {
+        return idBasedFile;
+    }
+    // Try title-based filename
+    if (title) {
+        const titleBasedFile = path.join(directory, `${titleToFilename(title)}.md`);
+        if (fs.existsSync(titleBasedFile)) {
+            // Verify it's the right spec 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] === specId) {
+                    return titleBasedFile;
+                }
+            }
+            catch (error) {
+                // Continue searching
+            }
+        }
+        // Try title-based with ID suffix
+        const titleWithIdFile = path.join(directory, `${titleToFilename(title)}_${specId}.md`);
+        if (fs.existsSync(titleWithIdFile)) {
+            return titleWithIdFile;
+        }
+    }
+    // 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,26 @@
+/**
+ * ID generation utilities
+ */
+import type Database from "better-sqlite3";
+import type { Config } from "@sudocode-ai/types";
+/**
+ * Generate next spec ID based on database contents
+ */
+export declare function generateSpecId(db: Database.Database, outputDir: string): string;
+/**
+ * Generate next issue ID based on database contents
+ */
+export declare function generateIssueId(db: Database.Database, outputDir: string): string;
+/**
+ * Get current config
+ */
+export declare function getConfig(outputDir: string): Config;
+/**
+ * Update config (version-controlled)
+ */
+export declare function updateConfig(outputDir: string, updates: Partial<Config>): void;
+/**
+ * Generate a UUID v4
+ */
+export declare function generateUUID(): string;
+//# 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;;GAEG;AAKH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AA6FD;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GACvB,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

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

@@ -0,0 +1,123 @@
+/**
+ * ID generation utilities
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as crypto from "crypto";
+import { VERSION } from "./version.js";
+/**
+ * Generate next spec ID based on database contents
+ */
+export function generateSpecId(db, outputDir) {
+    const config = readConfig(outputDir);
+    const nextNumber = getNextSpecNumber(db);
+    return `${config.id_prefix.spec}-${String(nextNumber).padStart(3, "0")}`;
+}
+/**
+ * Generate next issue ID based on database contents
+ */
+export function generateIssueId(db, outputDir) {
+    const config = readConfig(outputDir);
+    const nextNumber = getNextIssueNumber(db);
+    return `${config.id_prefix.issue}-${String(nextNumber).padStart(3, "0")}`;
+}
+/**
+ * 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;
+}
+/**
+ * Read config file (version-controlled)
+ */
+function readConfig(outputDir) {
+    const configPath = path.join(outputDir, "config.json");
+    if (!fs.existsSync(configPath)) {
+        // Create default config if not exists
+        const defaultConfig = {
+            version: VERSION,
+            id_prefix: {
+                spec: "SPEC",
+                issue: "ISSUE",
+            },
+        };
+        writeConfig(outputDir, defaultConfig);
+        return defaultConfig;
+    }
+    const content = fs.readFileSync(configPath, "utf8");
+    return JSON.parse(content);
+}
+/**
+ * Write config file (version-controlled)
+ */
+function writeConfig(outputDir, config) {
+    const configPath = path.join(outputDir, "config.json");
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf8");
+}
+/**
+ * Get current config
+ */
+export function getConfig(outputDir) {
+    return readConfig(outputDir);
+}
+/**
+ * Update config (version-controlled)
+ */
+export function updateConfig(outputDir, updates) {
+    const config = readConfig(outputDir);
+    Object.assign(config, updates);
+    writeConfig(outputDir, config);
+}
+/**
+ * Generate a UUID v4
+ */
+export function generateUUID() {
+    return crypto.randomUUID();
+}
+//# 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":"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"}