@superblocksteam/vite-plugin-file-sync 1.99.99-next.3 → 2.0.0-SNAPSHOT.84af65cd215b6ca1

package/dist/ai-service/app-interface/filesystem/virtual-file-system.js

@@ -0,0 +1,238 @@
+/**
+ * Virtual filesystem manager.
+ *
+ * Coordinates multiple virtual file handlers to provide a unified
+ * interface for reading, writing, and listing files that may have
+ * different physical representations.
+ */
+import { getLogger } from "../../../util/logger.js";
+import { ApiFileHandler } from "./handlers/api-handler.js";
+import { SkillFileHandler } from "./handlers/skill-handler.js";
+/**
+ * Manages virtual file handlers and routes operations to the appropriate handler.
+ *
+ * Usage:
+ * ```typescript
+ * const vfs = new VirtualFileSystem();
+ * vfs.registerHandler(new ApiFileHandler());
+ *
+ * // Check if a path is virtual
+ * if (vfs.isVirtualPath("apis/MyAPI.ts")) {
+ *   const content = await vfs.read("apis/MyAPI.ts", options);
+ * }
+ * ```
+ */
+export class VirtualFileSystem {
+    handlers = [];
+    disabledTypes = new Set();
+    /**
+     * Register a handler for a type of virtual file.
+     *
+     * @param handler - The handler to register
+     */
+    registerHandler(handler) {
+        this.handlers.push(handler);
+    }
+    /**
+     * Get all registered handlers (including any currently disabled).
+     */
+    getHandlers() {
+        return this.handlers;
+    }
+    activeHandlers() {
+        if (this.disabledTypes.size === 0)
+            return this.handlers;
+        return this.handlers.filter((h) => !this.disabledTypes.has(h.type));
+    }
+    /**
+     * Toggle a handler on/off at runtime without unregistering it. When disabled,
+     * the handler is skipped by all lookup/read/write operations and reads fall
+     * through to the raw disk path. Used to bypass API projection during v2→v3
+     * migration so Clark reads the raw YAML sources instead of the generated TS.
+     */
+    setHandlerEnabled(type, enabled) {
+        if (enabled)
+            this.disabledTypes.delete(type);
+        else
+            this.disabledTypes.add(type);
+    }
+    isHandlerEnabled(type) {
+        return !this.disabledTypes.has(type);
+    }
+    /**
+     * Find the handler for a virtual path.
+     *
+     * @param virtualPath - The virtual path to look up
+     * @returns The matching handler, or undefined if none match
+     */
+    getHandler(virtualPath) {
+        return this.activeHandlers().find((h) => h.matches(virtualPath));
+    }
+    /**
+     * Find the handler for a physical path.
+     *
+     * @param physicalPath - The physical path to look up
+     * @returns The matching handler, or undefined if none match
+     */
+    getHandlerForPhysical(physicalPath) {
+        return this.activeHandlers().find((h) => h.matchesPhysical(physicalPath));
+    }
+    /**
+     * Check if a path is a virtual path managed by any handler.
+     *
+     * @param path - The path to check
+     * @returns true if any handler manages this path
+     */
+    isVirtualPath(path) {
+        const logger = getLogger();
+        const active = this.activeHandlers();
+        const handlerTypes = active.map((h) => h.type);
+        logger.info(`[VirtualFileSystem.isVirtualPath] path="${path}", handlers=[${handlerTypes.join(", ")}]`);
+        for (const handler of active) {
+            const matches = handler.matches(path);
+            logger.info(`[VirtualFileSystem.isVirtualPath] handler=${handler.type}, matches=${matches}`);
+            if (matches) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Check if a path is a physical path that should be blocked from direct reads.
+     *
+     * Physical paths are the underlying files that make up virtual files
+     * (e.g., apis/MyAPI/api.yaml, apis/MyAPI/step_1.js). These should not
+     * be read directly; instead, the virtual path (apis/MyAPI.ts) should be used.
+     *
+     * @param path - The path to check
+     * @returns true if this is a physical path that should be blocked
+     */
+    isPhysicalPath(path) {
+        return this.activeHandlers().some((h) => h.matchesPhysical(path));
+    }
+    /**
+     * Get error message for attempting to read a physical path directly.
+     *
+     * @param physicalPath - The physical path that was attempted to be read
+     * @returns Error message pointing to the virtual path
+     */
+    getBlockedReadError(physicalPath) {
+        const virtualPath = this.toVirtualPath(physicalPath);
+        return `Cannot read physical file '${physicalPath}'. Read the virtual file instead: ${virtualPath}`;
+    }
+    /**
+     * Parse a virtual path to extract metadata.
+     *
+     * @param virtualPath - The virtual path to parse
+     * @returns Parsed info or undefined if not a virtual path
+     */
+    parse(virtualPath) {
+        const handler = this.getHandler(virtualPath);
+        return handler?.parse(virtualPath);
+    }
+    /**
+     * Convert a physical path to its virtual representation.
+     *
+     * @param physicalPath - The physical path to convert
+     * @returns The virtual path, or the original path if not managed by any handler
+     */
+    toVirtualPath(physicalPath) {
+        for (const handler of this.activeHandlers()) {
+            const virtualPath = handler.toVirtualPath(physicalPath);
+            if (virtualPath) {
+                return virtualPath;
+            }
+        }
+        return physicalPath;
+    }
+    /**
+     * Convert a list of physical paths to virtual paths, deduplicating as needed.
+     *
+     * @param physicalPaths - The physical paths to convert
+     * @returns Array of virtual paths (deduplicated)
+     */
+    toVirtualPaths(physicalPaths) {
+        const virtualPaths = new Set();
+        for (const physPath of physicalPaths) {
+            virtualPaths.add(this.toVirtualPath(physPath));
+        }
+        return Array.from(virtualPaths);
+    }
+    /**
+     * Read content from a virtual file.
+     *
+     * @param virtualPath - The virtual path to read
+     * @param options - Read options
+     * @returns The file content, or undefined if not found or not a virtual path
+     */
+    async read(virtualPath, options) {
+        const handler = this.getHandler(virtualPath);
+        if (!handler) {
+            return undefined;
+        }
+        return await handler.read(virtualPath, options);
+    }
+    /**
+     * Write content to a virtual file.
+     *
+     * @param virtualPath - The virtual path to write
+     * @param content - The content to write
+     * @param options - Write options
+     * @throws Error if path is not managed by any handler
+     */
+    async write(virtualPath, content, options) {
+        const handler = this.getHandler(virtualPath);
+        if (!handler) {
+            throw new Error(`No handler found for virtual path: ${virtualPath}`);
+        }
+        await handler.write(virtualPath, content, options);
+    }
+    /**
+     * Delete a virtual file.
+     *
+     * @param virtualPath - The virtual path to delete
+     * @param options - Delete options
+     * @returns List of physical paths that were deleted
+     * @throws Error if path is not managed by any handler
+     */
+    async delete(virtualPath, options) {
+        const handler = this.getHandler(virtualPath);
+        if (!handler) {
+            throw new Error(`No handler found for virtual path: ${virtualPath}`);
+        }
+        return await handler.delete(virtualPath, options);
+    }
+}
+/**
+ * Create a VirtualFileSystem with the default handlers registered.
+ *
+ * @param options - Optional configuration including feature flags
+ */
+export function createDefaultVirtualFileSystem(options) {
+    const logger = getLogger();
+    const vfs = new VirtualFileSystem();
+    // ApiFileHandler transforms YAML API files to virtual TS - only needed in YAML mode.
+    // SDK apps write API files directly and must not register it (it would project
+    // raw files into virtual TS), and registering it twice in YAML mode left a dead
+    // duplicate in the handler list. Register exactly once, only in YAML mode.
+    if (!options?.sdkApiEnabled) {
+        vfs.registerHandler(new ApiFileHandler());
+        logger.info(`[VirtualFileSystem] Registered ApiFileHandler`);
+    }
+    // Register SkillFileHandler when:
+    // 1. knowledgeManager is provided (for on-demand knowledge/facts)
+    // 2. OR useSystemSkills is enabled (for original skills feature)
+    const hasKnowledgeManager = !!options?.knowledgeManager;
+    const shouldRegisterSkillHandler = hasKnowledgeManager || options?.useSystemSkills;
+    if (shouldRegisterSkillHandler) {
+        logger.info(`[VirtualFileSystem] Registering SkillFileHandler (hasKnowledgeManager=${hasKnowledgeManager}, useSystemSkills=${options?.useSystemSkills})`);
+        vfs.registerHandler(new SkillFileHandler(options?.knowledgeManager, options?.appRootDirPath));
+    }
+    else {
+        logger.info(`[VirtualFileSystem] Skipping SkillFileHandler (hasKnowledgeManager=${hasKnowledgeManager}, useSystemSkills=${options?.useSystemSkills})`);
+    }
+    const handlerTypes = vfs.getHandlers().map((h) => h.type);
+    logger.info(`[VirtualFileSystem] Created with handlers: [${handlerTypes.join(", ")}]`);
+    return vfs;
+}
+//# sourceMappingURL=virtual-file-system.js.map

package/dist/ai-service/app-interface/filesystem/virtual-file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-file-system.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-file-system.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Type definitions for the virtual filesystem layer.
+ *
+ * The virtual filesystem provides an abstraction over physical files,
+ * allowing certain file types (like APIs) to appear differently to
+ * consumers than they are stored on disk.
+ */
+import type { TemplateRenderer } from "../../template-renderer.js";
+/**
+ * File metadata returned by listFiles when includeMetadata is true.
+ */
+export interface FileMetadata {
+    /** Relative file path (virtual path for APIs) */
+    path: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modification time */
+    mtime: Date;
+    /** Whether this is a directory */
+    isDirectory: boolean;
+    /** Whether this is a file */
+    isFile: boolean;
+}
+/**
+ * Options for reading virtual files.
+ */
+export interface VirtualReadOptions {
+    appRootDirPath: string;
+    templateRenderer?: TemplateRenderer;
+    entityNames?: string[];
+}
+/**
+ * Options for writing virtual files.
+ */
+export interface VirtualWriteOptions {
+    appRootDirPath: string;
+}
+/**
+ * Options for deleting virtual files.
+ */
+export interface VirtualDeleteOptions {
+    appRootDirPath: string;
+    createDraftDelete: (relativePath: string) => Promise<void>;
+}
+/**
+ * Result of parsing a virtual path.
+ */
+export interface VirtualPathInfo {
+    /** The type of virtual file (e.g., "api") */
+    type: string;
+    /** Extracted parameters from the path (e.g., { apiName: "MyAPI" }) */
+    params: Record<string, string>;
+}
+/**
+ * Handler for a specific type of virtual file.
+ *
+ * Each handler is responsible for a category of virtual files
+ * (e.g., API files). The VirtualFileSystem uses handlers to
+ * route operations to the appropriate implementation.
+ */
+export interface VirtualFileHandler {
+    /** Unique identifier for this handler type */
+    readonly type: string;
+    /**
+     * Check if this handler manages the given virtual path.
+     *
+     * @param virtualPath - The virtual path to check
+     * @returns true if this handler should process the path
+     */
+    matches(virtualPath: string): boolean;
+    /**
+     * Check if a physical path belongs to this handler's domain.
+     * Used for converting physical paths to virtual paths in listings.
+     *
+     * @param physicalPath - The physical path to check
+     * @returns true if this handler should convert the path
+     */
+    matchesPhysical(physicalPath: string): boolean;
+    /**
+     * Parse a virtual path to extract metadata.
+     *
+     * @param virtualPath - The virtual path to parse
+     * @returns Parsed info or undefined if not a valid path for this handler
+     */
+    parse(virtualPath: string): VirtualPathInfo | undefined;
+    /**
+     * Convert a physical path to its virtual representation.
+     *
+     * @param physicalPath - The physical path to convert
+     * @returns The virtual path, or undefined if not convertible
+     */
+    toVirtualPath(physicalPath: string): string | undefined;
+    /**
+     * Read content from a virtual file.
+     *
+     * @param virtualPath - The virtual path to read
+     * @param options - Read options including app root and dependencies
+     * @returns The file content, or undefined if not found
+     */
+    read(virtualPath: string, options: VirtualReadOptions): Promise<string | undefined>;
+    /**
+     * Write content to a virtual file.
+     *
+     * @param virtualPath - The virtual path to write
+     * @param content - The content to write
+     * @param options - Write options including app root
+     */
+    write(virtualPath: string, content: string, options: VirtualWriteOptions): Promise<void>;
+    /**
+     * Delete a virtual file and its associated physical files.
+     *
+     * @param virtualPath - The virtual path to delete
+     * @param options - Delete options including draft delete function
+     * @returns List of physical paths that were deleted
+     */
+    delete(virtualPath: string, options: VirtualDeleteOptions): Promise<string[]>;
+    /**
+     * Get metadata for a virtual file.
+     *
+     * @param virtualPath - The virtual path to get metadata for
+     * @param options - Read options including app root
+     * @returns File metadata, or undefined if not found
+     */
+    getMetadata?(virtualPath: string, options: VirtualReadOptions): Promise<FileMetadata | undefined>;
+}
+//# sourceMappingURL=virtual-fs-types.d.ts.map

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-fs-types.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-fs-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,IAAI,CAAC;IACZ,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAEtC;;;;;;OAMG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAExD;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAExD;;;;;;OAMG;IACH,IAAI,CACF,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE/B;;;;;;OAMG;IACH,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E;;;;;;OAMG;IACH,WAAW,CAAC,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CACtC"}

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.js

@@ -0,0 +1,9 @@
+/**
+ * Type definitions for the virtual filesystem layer.
+ *
+ * The virtual filesystem provides an abstraction over physical files,
+ * allowing certain file types (like APIs) to appear differently to
+ * consumers than they are stored on disk.
+ */
+export {};
+//# sourceMappingURL=virtual-fs-types.js.map

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-fs-types.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-fs-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * YAML mode path validator implementation.
+ *
+ * Handles path validation for the flat template structure:
+ * - APIs: apis/ApiName/api.yaml
+ * - Pages: pages/PageName/index.tsx
+ * - App root: App.tsx
+ * - Scope file: scope.ts
+ */
+import type { PathValidator } from "./path-validator.js";
+/**
+ * Path validator for YAML mode (flat structure).
+ *
+ * In YAML mode:
+ * - APIs are at apis/ (e.g., apis/MyApi/api.yaml)
+ * - Pages are at pages/ (e.g., pages/Home/index.tsx)
+ * - App root is App.tsx
+ * - Scope files (scope.ts) are protected from direct modification
+ */
+export declare class YamlPathValidator implements PathValidator {
+    readonly apiPrefix = "apis";
+    readonly pagesPrefix = "pages";
+    readonly appRoot = "App.tsx";
+    /**
+     * Checks if a path is an API file path.
+     * In YAML mode, API files start with "apis/".
+     */
+    isApiFilePath(filePath: string): boolean;
+    /**
+     * Checks if a path is a direct page path (pages/xyz.tsx rather than pages/xyz/index.tsx).
+     * Direct page paths are not allowed - pages must be in subdirectories.
+     */
+    isDirectPagePath(filePath: string): boolean;
+    /**
+     * Checks if a path is a scope file.
+     * Scope files are protected from direct modification.
+     */
+    isScopeFile(filePath: string): boolean;
+    /**
+     * Get directories that are protected from modification.
+     */
+    getProtectedDirectories(): readonly string[];
+    /**
+     * Check if a path should bypass blacklist checks.
+     * In YAML mode, apis/ and pages/ directories have special handling.
+     */
+    shouldBypassBlacklist(_relativePath: string, firstDir: string): boolean;
+}
+//# sourceMappingURL=yaml-path-validator.d.ts.map

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-path-validator.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/yaml-path-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,SAAS,UAAU;IAC5B,QAAQ,CAAC,WAAW,WAAW;IAC/B,QAAQ,CAAC,OAAO,aAAa;IAE7B;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI3C;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,uBAAuB,IAAI,SAAS,MAAM,EAAE;IAI5C;;;OAGG;IACH,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;CAYxE"}

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.js

@@ -0,0 +1,67 @@
+/**
+ * YAML mode path validator implementation.
+ *
+ * Handles path validation for the flat template structure:
+ * - APIs: apis/ApiName/api.yaml
+ * - Pages: pages/PageName/index.tsx
+ * - App root: App.tsx
+ * - Scope file: scope.ts
+ */
+/**
+ * Path validator for YAML mode (flat structure).
+ *
+ * In YAML mode:
+ * - APIs are at apis/ (e.g., apis/MyApi/api.yaml)
+ * - Pages are at pages/ (e.g., pages/Home/index.tsx)
+ * - App root is App.tsx
+ * - Scope files (scope.ts) are protected from direct modification
+ */
+export class YamlPathValidator {
+    apiPrefix = "apis";
+    pagesPrefix = "pages";
+    appRoot = "App.tsx";
+    /**
+     * Checks if a path is an API file path.
+     * In YAML mode, API files start with "apis/".
+     */
+    isApiFilePath(filePath) {
+        return filePath.startsWith("apis/");
+    }
+    /**
+     * Checks if a path is a direct page path (pages/xyz.tsx rather than pages/xyz/index.tsx).
+     * Direct page paths are not allowed - pages must be in subdirectories.
+     */
+    isDirectPagePath(filePath) {
+        return /^pages\/[^/]+\.tsx$/.test(filePath);
+    }
+    /**
+     * Checks if a path is a scope file.
+     * Scope files are protected from direct modification.
+     */
+    isScopeFile(filePath) {
+        return filePath === "scope.ts" || filePath.endsWith("/scope.ts");
+    }
+    /**
+     * Get directories that are protected from modification.
+     */
+    getProtectedDirectories() {
+        return [".git", "node_modules", ".superblocks", "pages"];
+    }
+    /**
+     * Check if a path should bypass blacklist checks.
+     * In YAML mode, apis/ and pages/ directories have special handling.
+     */
+    shouldBypassBlacklist(_relativePath, firstDir) {
+        // apis directory is allowed for virtual file operations
+        if (firstDir === "apis") {
+            return true;
+        }
+        // pages directory - allow files in subdirectories
+        // Direct page paths like pages/Foo.tsx will be caught by isDirectPagePath check
+        if (firstDir === "pages") {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=yaml-path-validator.js.map

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-path-validator.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/yaml-path-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACnB,SAAS,GAAG,MAAM,CAAC;IACnB,WAAW,GAAG,OAAO,CAAC;IACtB,OAAO,GAAG,SAAS,CAAC;IAE7B;;;OAGG;IACH,aAAa,CAAC,QAAgB;QAC5B,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,QAAgB;QAC/B,OAAO,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,QAAgB;QAC1B,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,CAAU,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,qBAAqB,CAAC,aAAqB,EAAE,QAAgB;QAC3D,wDAAwD;QACxD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,kDAAkD;QAClD,gFAAgF;QAChF,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/ai-service/app-interface/linter.d.ts

@@ -0,0 +1,11 @@
+export declare class Linter {
+    private readonly eslint;
+    private readonly cwd;
+    constructor(cwd: string);
+    warmCache(files: string[]): Promise<void>;
+    lint(files: string[], abortSignal?: AbortSignal): Promise<{
+        errors: Record<string, string[]>;
+        fixedFiles: string[];
+    }>;
+}
+//# sourceMappingURL=linter.d.ts.map

package/dist/ai-service/app-interface/linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/linter.ts"],"names":[],"mappings":"AAmCA,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IASjB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE;IAmBzB,IAAI,CACR,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAoEvE"}