@mdfriday/foundry 26.4.20 → 26.5.1

package/dist/types/internal/infrastructure/http/netlify-http-client.d.ts

@@ -1,8 +1,28 @@
 import { HttpClient, HttpResponse } from '@internal/domain/publish/repository/http-client';
+/**
+ * Node.js HTTP Client for Netlify API
+ *
+ * 使用 native fetch 实现
+ */
 export declare class NetlifyHttpClient implements HttpClient {
+    /**
+     * POST JSON data
+     */
     postJSON(url: string, data: any, headers?: Record<string, string>): Promise<HttpResponse>;
+    /**
+     * POST multipart form data
+     */
     postMultipart(url: string, formData: Record<string, any>, headers?: Record<string, string>): Promise<HttpResponse>;
+    /**
+     * PUT binary data
+     */
     putBinary(url: string, data: Buffer | Uint8Array, headers?: Record<string, string>): Promise<HttpResponse>;
+    /**
+     * GET request
+     */
     get(url: string, headers?: Record<string, string>): Promise<HttpResponse>;
+    /**
+     * Create HttpResponse from fetch Response
+     */
     private createResponse;
 }

package/dist/types/internal/infrastructure/http/node-http-client.d.ts

@@ -1,4 +1,7 @@
 import { HttpClient, HttpResponse } from '@internal/domain/identity/repository';
+/**
+ * Node.js HTTP Client implementation using native fetch
+ */
 export declare class NodeHttpClient implements HttpClient {
     post(url: string, data: any, headers?: Record<string, string>): Promise<HttpResponse>;
     postForm(url: string, data: Record<string, string>): Promise<HttpResponse>;

package/dist/types/internal/infrastructure/index.d.ts

@@ -1,6 +1,14 @@
+/**
+ * Infrastructure Layer Exports
+ *
+ * Provides concrete implementations of domain repositories
+ */
 export { NodeWorkspaceRepository, NodeProjectRepository, } from './persistence/node-workspace-repository';
 export { NodeSnapshotRepository } from './persistence/node-snapshot-repository';
 export { NodeFileSystemRepository } from './persistence/node-file-system';
 export { NodeManifestRepository } from './persistence/node-manifest-repository';
 export { NodeHttpClient } from './http/node-http-client';
 export { NetlifyHttpClient } from './http/netlify-http-client';
+export * from './llm';
+export * from './embedding';
+export * from './node';

package/dist/types/internal/infrastructure/llm/fetch-http-client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Fetch HTTP Client Implementation
+ *
+ * 基于浏览器/Node.js 原生 fetch API 的 LLMHttpClient 实现
+ *
+ * 用途：
+ * - 默认实现：当外部未提供 httpClient 时使用
+ * - Node.js 环境：CLI、测试等场景
+ * - 浏览器环境：支持 CORS 的场景
+ *
+ * 注意：
+ * - Obsidian 环境中访问本地服务（如 LM Studio）会遇到 CORS 问题
+ * - Obsidian Plugin 应该提供自定义实现（使用 Electron net 模块）
+ */
+import type { LLMHttpClient, LLMHttpRequest, LLMHttpResponse } from '@internal/domain/wiki/repository/llm-http-client';
+export declare class FetchHttpClient implements LLMHttpClient {
+    fetch(request: LLMHttpRequest): Promise<LLMHttpResponse>;
+}
+/**
+ * 创建默认的 HTTP Client
+ *
+ * @returns FetchHttpClient 实例
+ */
+export declare function createDefaultLLMHttpClient(): LLMHttpClient;

package/dist/types/internal/infrastructure/llm/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * LLM Infrastructure Exports
+ */
+export * from './provider';
+export * from './lmstudio-provider';
+export * from './ollama-provider';

package/dist/types/internal/infrastructure/llm/llm-config.d.ts

@@ -0,0 +1,80 @@
+/**
+ * LLM 服务配置
+ *
+ * 统一管理不同的 LLM 服务配置：
+ * - 本地服务（LM Studio, Ollama）
+ * - 云端服务（OpenAI, GLM, DeepSeek, Moonshot）
+ * - Embedding 服务（可选，独立配置）
+ */
+export type LLMServiceType = 'lmstudio' | 'ollama' | 'openai' | 'glm' | 'deepseek' | 'moonshot' | 'custom';
+export interface LLMServiceConfig {
+    /**
+     * 服务类型
+     */
+    type: LLMServiceType;
+    /**
+     * Base URL
+     */
+    baseURL: string;
+    /**
+     * API Key (optional)
+     */
+    apiKey?: string;
+    /**
+     * 默认模型名称
+     */
+    defaultModel?: string;
+    /**
+     * 自定义 headers
+     */
+    customHeaders?: Record<string, string>;
+}
+export interface EmbeddingServiceConfig {
+    /**
+     * 服务类型
+     * 注意：moonshot 不官方提供 embedding 服务，请谨慎使用
+     */
+    type: 'lmstudio' | 'ollama' | 'openai' | 'glm' | 'deepseek' | 'moonshot' | 'custom' | 'none';
+    /**
+     * Base URL
+     */
+    baseURL?: string;
+    /**
+     * API Key (optional)
+     */
+    apiKey?: string;
+    /**
+     * Embedding 模型名称
+     */
+    model?: string;
+}
+export interface WikiLLMConfig {
+    /**
+     * 主 LLM 服务（用于知识提取和查询）
+     */
+    llm: LLMServiceConfig;
+    /**
+     * Embedding 服务（用于语义检索，可选）
+     */
+    embedding?: EmbeddingServiceConfig;
+}
+/**
+ * 预设配置
+ */
+export declare const LLM_PRESETS: Record<string, LLMServiceConfig>;
+export declare const EMBEDDING_PRESETS: Record<string, EmbeddingServiceConfig>;
+/**
+ * 从环境变量加载配置
+ */
+export declare function loadLLMConfigFromEnv(): WikiLLMConfig;
+/**
+ * 验证配置
+ */
+export declare function validateLLMConfig(config: WikiLLMConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * 打印配置信息（隐藏敏感信息）
+ */
+export declare function printLLMConfig(config: WikiLLMConfig): string;

package/dist/types/internal/infrastructure/llm/lmstudio-provider.d.ts

@@ -0,0 +1,55 @@
+/**
+ * OpenAI-Compatible Embedding + LLM Provider
+ *
+ * 实现了所有兼容 OpenAI API 的服务的 Embedding 能力：
+ *   - LM Studio  (本地, http://localhost:1234/v1)
+ *   - OpenAI     (https://api.openai.com/v1)
+ *   - GLM/智谱   (https://open.bigmodel.cn/api/paas/v4)
+ *   - DeepSeek   (https://api.deepseek.com/v1)
+ *   - Moonshot   (https://api.moonshot.cn/v1)
+ *   - 其他兼容服务 (custom)
+ *
+ * Embedding API 格式: POST /embeddings { model, input }
+ * Chat API 格式:      POST /chat/completions (SSE 或非流式)
+ *
+ * 导出别名 OpenAICompatibleEmbeddingProvider，推荐新代码使用此名称。
+ * LMStudioProvider 保留为兼容旧代码。
+ */
+import { ILLMProvider, LLMConfig, LLMStreamChunk } from './provider';
+import { IEmbeddingProvider } from '../embedding/embedding-provider.interface';
+import type { LLMHttpClient } from '@internal/domain/wiki/repository/llm-http-client';
+/**
+ * OpenAI-compatible provider for both Chat Completions and Embeddings.
+ *
+ * Exported as both `OpenAICompatibleEmbeddingProvider` (preferred) and
+ * the legacy `LMStudioProvider` alias.
+ */
+export declare class OpenAICompatibleEmbeddingProvider implements ILLMProvider, IEmbeddingProvider {
+    private baseURL;
+    private apiKey?;
+    readonly name: string;
+    private embeddingModel;
+    private httpClient;
+    constructor(baseURL?: string, embeddingModel?: string, httpClient?: LLMHttpClient, apiKey?: string | undefined, providerName?: string);
+    /** Infer a readable name from the base URL (for error messages). */
+    private inferProviderName;
+    /** Build Authorization header when an API key is configured. */
+    private buildHeaders;
+    complete(prompt: string, config: LLMConfig, signal?: AbortSignal): AsyncIterable<LLMStreamChunk>;
+    completeSync(prompt: string, config: LLMConfig, signal?: AbortSignal): Promise<string>;
+    /**
+     * Domain IEmbeddingProvider contract: generateEmbedding(text, model).
+     * Bridges to the infrastructure embed() method.
+     */
+    generateEmbedding(text: string, model: string): Promise<number[]>;
+    embed(request: {
+        text: string;
+        model?: string;
+        signal?: AbortSignal;
+    }): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    healthCheck(): Promise<boolean>;
+}
+/** @deprecated Use OpenAICompatibleEmbeddingProvider instead */
+export declare const LMStudioProvider: typeof OpenAICompatibleEmbeddingProvider;
+export type LMStudioProvider = OpenAICompatibleEmbeddingProvider;

package/dist/types/internal/infrastructure/llm/node-llm-http-client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Node.js LLM HTTP Client Implementation
+ *
+ * 基于 Node.js 原生 fetch API 的 LLMHttpClient 实现
+ * 用于测试和 CLI 环境
+ *
+ * 注意：这是 FetchHttpClient 的别名，用于明确表示 Node.js 环境
+ */
+import { FetchHttpClient } from './fetch-http-client';
+import type { LLMHttpClient } from '@internal/domain/wiki/repository/llm-http-client';
+/**
+ * Node.js HTTP Client for LLM
+ *
+ * 使用原生 fetch API（Node.js 18+ 内置支持）
+ */
+export declare class NodeLLMHttpClient extends FetchHttpClient implements LLMHttpClient {
+}
+/**
+ * 创建 Node.js LLM HTTP Client
+ */
+export declare function createNodeLLMHttpClient(): LLMHttpClient;

package/dist/types/internal/infrastructure/llm/ollama-provider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Ollama Provider Implementation
+ *
+ * Ollama 本地模型服务
+ * 默认端口: http://localhost:11434
+ */
+import { ILLMProvider, LLMConfig, LLMStreamChunk } from './provider';
+export declare class OllamaProvider implements ILLMProvider {
+    private baseURL;
+    readonly name = "Ollama";
+    constructor(baseURL?: string);
+    complete(prompt: string, config: LLMConfig, signal?: AbortSignal): AsyncIterable<LLMStreamChunk>;
+    private completeWithChat;
+    private completeWithGenerate;
+    completeSync(prompt: string, config: LLMConfig, signal?: AbortSignal): Promise<string>;
+    healthCheck(): Promise<boolean>;
+}

package/dist/types/internal/infrastructure/llm/openai-compatible-provider.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 通用 OpenAI-Compatible Provider
+ *
+ * 支持所有兼容 OpenAI API 的服务：
+ * - OpenAI
+ * - GLM (智谱AI)
+ * - DeepSeek
+ * - Moonshot (Kimi)
+ * - LM Studio
+ * - Ollama (通过 OpenAI API)
+ * - 其他兼容服务
+ */
+import { ILLMProvider, LLMConfig, LLMStreamChunk } from './provider';
+import type { LLMHttpClient } from '@internal/domain/wiki/repository/llm-http-client';
+export interface OpenAICompatibleConfig {
+    /**
+     * API Base URL
+     * - OpenAI: https://api.openai.com/v1
+     * - GLM: https://open.bigmodel.cn/api/paas/v4
+     * - DeepSeek: https://api.deepseek.com/v1
+     * - Moonshot: https://api.moonshot.cn/v1
+     * - LM Studio: http://localhost:1234/v1
+     */
+    baseURL: string;
+    /**
+     * API Key (optional for local services)
+     */
+    apiKey?: string;
+    /**
+     * Provider name for error messages
+     */
+    providerName?: string;
+    /**
+     * Default model name
+     */
+    defaultModel?: string;
+    /**
+     * Custom headers
+     */
+    customHeaders?: Record<string, string>;
+    /**
+     * HTTP Client (optional, defaults to fetch)
+     */
+    httpClient?: LLMHttpClient;
+}
+/**
+ * OpenAI-Compatible Provider
+ *
+ * 通用实现，支持所有兼容 OpenAI Chat Completion API 的服务
+ */
+export declare class OpenAICompatibleProvider implements ILLMProvider {
+    readonly name: string;
+    private baseURL;
+    private apiKey?;
+    private defaultModel?;
+    private customHeaders;
+    private httpClient;
+    constructor(config: OpenAICompatibleConfig);
+    complete(prompt: string, config: LLMConfig, signal?: AbortSignal): AsyncIterable<LLMStreamChunk>;
+    completeSync(prompt: string, config: LLMConfig, signal?: AbortSignal): Promise<string>;
+    healthCheck(): Promise<boolean>;
+}
+/**
+ * 预设配置工厂函数
+ */
+export declare function createOpenAIProvider(apiKey: string, model?: string, httpClient?: LLMHttpClient): OpenAICompatibleProvider;
+export declare function createGLMProvider(apiKey: string, model?: string, httpClient?: LLMHttpClient): OpenAICompatibleProvider;
+export declare function createDeepSeekProvider(apiKey: string, model?: string, httpClient?: LLMHttpClient): OpenAICompatibleProvider;
+export declare function createMoonshotProvider(apiKey: string, model?: string, httpClient?: LLMHttpClient): OpenAICompatibleProvider;
+export declare function createLMStudioProvider(baseURL?: string, model?: string, httpClient?: LLMHttpClient): OpenAICompatibleProvider;

package/dist/types/internal/infrastructure/llm/provider-factory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LLM Provider Factory
+ *
+ * 根据配置创建对应的 Provider 实例
+ */
+import { ILLMProvider } from './provider';
+import { IEmbeddingProvider } from '../embedding/embedding-provider.interface';
+import { LLMServiceConfig, EmbeddingServiceConfig } from './llm-config';
+import type { LLMHttpClient } from '@internal/domain/wiki/repository/llm-http-client';
+/**
+ * 创建 LLM Provider
+ */
+export declare function createLLMProvider(config: LLMServiceConfig, httpClient?: LLMHttpClient): ILLMProvider;
+/**
+ * 创建 Embedding Provider
+ *
+ * 除 Ollama 外，所有服务均使用 OpenAI 兼容的 /embeddings 端点
+ * （由 OpenAICompatibleEmbeddingProvider 实现）。
+ *
+ * 各服务默认 embedding 模型：
+ *   lmstudio  → text-embedding-nomic-embed-text-v2-moe
+ *   ollama    → nomic-embed-text          (Ollama 原生 /api/embeddings)
+ *   openai    → text-embedding-3-small
+ *   glm       → embedding-3
+ *   deepseek  → deepseek-embedding        (需确认模型名称是否可用)
+ *   moonshot  → moonshot-v1-embedding     (非官方，请自行确认)
+ *   custom    → 由调用方指定
+ */
+export declare function createEmbeddingProvider(config?: EmbeddingServiceConfig, httpClient?: LLMHttpClient): IEmbeddingProvider | null;
+/**
+ * 健康检查所有配置的服务
+ */
+export declare function healthCheckServices(llmProvider: ILLMProvider, embeddingProvider?: IEmbeddingProvider | null): Promise<{
+    llm: boolean;
+    embedding: boolean | null;
+}>;

package/dist/types/internal/infrastructure/llm/provider.d.ts

@@ -0,0 +1,77 @@
+/**
+ * LLM Provider Abstraction
+ *
+ * 提供统一的 LLM 调用接口，支持多种 Provider
+ */
+/**
+ * LLM 流式响应块
+ */
+export interface LLMStreamChunk {
+    text: string;
+    done: boolean;
+}
+/**
+ * LLM 配置
+ */
+export interface LLMConfig {
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    apiKey?: string;
+    baseURL?: string;
+    systemMessage?: string;
+}
+/**
+ * LLM Provider 统一接口
+ */
+export interface ILLMProvider {
+    /**
+     * 流式完成
+     * @param prompt 提示词
+     * @param config LLM 配置
+     * @param signal 取消信号
+     */
+    complete(prompt: string, config: LLMConfig, signal?: AbortSignal): AsyncIterable<LLMStreamChunk>;
+    /**
+     * 非流式完成（等待完整响应）
+     * @param prompt 提示词
+     * @param config LLM 配置
+     * @param signal 取消信号
+     */
+    completeSync(prompt: string, config: LLMConfig, signal?: AbortSignal): Promise<string>;
+    /**
+     * 健康检查
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Provider 名称
+     */
+    readonly name: string;
+}
+/**
+ * LLM 错误基类
+ */
+export declare class LLMError extends Error {
+    readonly provider: string;
+    constructor(message: string, provider: string);
+}
+/**
+ * LLM 连接错误
+ */
+export declare class LLMConnectError extends LLMError {
+    constructor(provider: string, cause?: Error);
+}
+/**
+ * LLM HTTP 错误
+ */
+export declare class LLMHttpError extends LLMError {
+    readonly status: number;
+    readonly statusText: string;
+    constructor(provider: string, status: number, statusText: string);
+}
+/**
+ * LLM 取消错误
+ */
+export declare class LLMAbortError extends LLMError {
+    constructor(provider: string);
+}

package/dist/types/internal/infrastructure/node/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Node.js Infrastructure Implementations
+ *
+ * 统一导出所有 Node.js 环境的实现类
+ */
+export * from './node-file-system';
+export * from './node-path-service';
+export * from './node-crypto-service';
+export * from './node-conversation-repository';
+export * from './node-kb-repository';
+export * from './node-wiki-page-repository';

package/dist/types/internal/infrastructure/node/node-conversation-repository.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Node.js Conversation Repository Implementation
+ *
+ * 使用 IFileSystem 接口进行文件操作
+ * 调用 Conversation Entity 的方法来格式化内容
+ */
+import { IConversationRepository, SaveConversationOptions } from '../../domain/wiki/repository';
+import { Conversation } from '../../domain/wiki/entity/conversation';
+import { IFileSystem } from '../../domain/wiki/repository';
+import { IPathService } from '../../domain/wiki/repository';
+export declare class NodeConversationRepository implements IConversationRepository {
+    private readonly baseDir;
+    private readonly fileSystem;
+    private readonly pathService;
+    constructor(baseDir: string, fileSystem: IFileSystem, pathService: IPathService);
+    save(conversation: Conversation, options?: SaveConversationOptions): Promise<string>;
+    list(): Promise<Conversation[]>;
+    exists(conversationId: string): Promise<boolean>;
+    getFilePath(conversationId: string): string;
+    private ensureDirectory;
+}

package/dist/types/internal/infrastructure/node/node-crypto-service.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Node.js Crypto Service Implementation
+ *
+ * 实现 Domain 层定义的 ICryptoService 接口
+ */
+import { ICryptoService } from '@internal/domain/wiki/repository';
+export declare class NodeCryptoService implements ICryptoService {
+    hash(content: string, algorithm: 'sha256' | 'md5'): string;
+    randomUUID(): string;
+}

package/dist/types/internal/infrastructure/node/node-file-system.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Node.js File System Implementation
+ *
+ * 实现 Domain 层定义的 IFileSystem 接口
+ */
+import { IFileSystem, FileStats } from '@internal/domain/wiki/repository';
+export declare class NodeFileSystem implements IFileSystem {
+    readFile(path: string, encoding: string): Promise<string>;
+    writeFile(path: string, content: string, encoding: string): Promise<void>;
+    stat(path: string): Promise<FileStats>;
+    exists(path: string): Promise<boolean>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    unlink(path: string): Promise<void>;
+    /**
+     * Synchronous version of exists (for backward compatibility)
+     */
+    existsSync(path: string): boolean;
+    /**
+     * Synchronous version of readFile (for backward compatibility)
+     */
+    readFileSync(path: string, encoding: string): string;
+    /**
+     * Synchronous version of stat (for backward compatibility)
+     */
+    statSync(path: string): FileStats;
+}

package/dist/types/internal/infrastructure/node/node-kb-repository.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Node.js JSON Knowledge Base Repository
+ *
+ * 使用 IFileSystem 和 IPathService 进行平台无关的文件操作
+ */
+import { IKBRepository, IFileSystem, IPathService } from '../../domain/wiki/repository';
+import { KnowledgeBase } from '../../domain/wiki';
+export declare class NodeKBRepository implements IKBRepository {
+    private readonly filePath;
+    private readonly fileSystem;
+    private readonly pathService;
+    constructor(filePath: string, fileSystem: IFileSystem, pathService: IPathService);
+    load(): Promise<KnowledgeBase | null>;
+    exists(): Promise<boolean>;
+    save(kb: KnowledgeBase): Promise<void>;
+    getLastModified(): Promise<number>;
+    getSize(): Promise<number>;
+}

package/dist/types/internal/infrastructure/node/node-path-service.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Node.js Path Service Implementation
+ *
+ * 实现 Domain 层定义的 IPathService 接口
+ */
+import { IPathService } from '@internal/domain/wiki/repository';
+export declare class NodePathService implements IPathService {
+    join(...paths: string[]): string;
+    basename(p: string, ext?: string): string;
+    dirname(p: string): string;
+    relative(from: string, to: string): string;
+    resolve(...paths: string[]): string;
+    extname(p: string): string;
+}

package/dist/types/internal/infrastructure/node/node-wiki-page-repository.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Node.js Markdown Wiki Page Repository
+ *
+ * 使用 IFileSystem 和 IPathService 进行平台无关的文件操作
+ */
+import { IWikiPageRepository, IFileSystem, IPathService } from '../../domain/wiki/repository';
+export declare class NodeWikiPageRepository implements IWikiPageRepository {
+    private readonly baseDir;
+    private readonly fileSystem;
+    private readonly pathService;
+    private readonly wikiDir;
+    constructor(baseDir: string, fileSystem: IFileSystem, pathService: IPathService);
+    writePage(relativePath: string, content: string): Promise<void>;
+    deletePage(relativePath: string): Promise<void>;
+    writePages(pages: Map<string, string>): Promise<void>;
+    listPages(directory: string): Promise<string[]>;
+    appendToLog(entry: string): Promise<void>;
+    updateIndex(content: string): Promise<void>;
+    updateGlossary(content: string): Promise<void>;
+    exists(relativePath: string): Promise<boolean>;
+    /**
+     * 递归列出所有 .md 文件
+     */
+    private listMarkdownFiles;
+}

package/dist/types/internal/infrastructure/persistence/node-file-system.d.ts

@@ -1,4 +1,12 @@
+/**
+ * Node.js FileSystem Implementation
+ *
+ * 实现 FileSystemRepository 接口
+ */
 import { FileSystemRepository, FolderScanResult, FolderStructure, SymlinkResult } from '@internal/domain/workspace/repository/file-system';
+/**
+ * Node.js FileSystem Repository Implementation
+ */
 export declare class NodeFileSystemRepository implements FileSystemRepository {
     exists(filePath: string): Promise<boolean>;
     isDirectory(filePath: string): Promise<boolean>;

package/dist/types/internal/infrastructure/persistence/node-manifest-repository.d.ts

@@ -1,11 +1,42 @@
 import { ManifestRepository } from '@internal/domain/publish';
 import { PublishManifest } from '@internal/domain/publish';
+/**
+ * Node.js Manifest Repository Implementation
+ *
+ * 使用文件系统存储 manifest
+ */
 export declare class NodeManifestRepository implements ManifestRepository {
+    /**
+     * Load manifest from file
+     */
     loadManifest(projectPath: string, publishMethod: 'ftp' | 'netlify' | 'mdfriday', suffix?: string): Promise<PublishManifest | null>;
+    /**
+     * Save manifest to file
+     */
     saveManifest(projectPath: string, manifest: PublishManifest, suffix?: string): Promise<void>;
+    /**
+     * Generate manifest by scanning directory
+     */
     generateManifest(projectId: string, publicDir: string, publishMethod: 'ftp' | 'netlify' | 'mdfriday', remoteConfig?: any): Promise<PublishManifest>;
+    /**
+     * Delete manifest file
+     */
     deleteManifest(projectPath: string, publishMethod: 'ftp' | 'netlify' | 'mdfriday', suffix?: string): Promise<boolean>;
+    /**
+     * Get manifest file path
+     *
+     * @param projectPath
+     * @param publishMethod
+     * @param suffix - Optional suffix for manifest filename (e.g., 'free', 'custom')
+     *                 For mdfriday with different deploymentTypes
+     */
     private getManifestPath;
+    /**
+     * Recursively scan directory and collect file info
+     */
     private scanDirectory;
+    /**
+     * Calculate file hash (MD5 or SHA1)
+     */
     private calculateFileHash;
 }