sfcc-dev-mcp 1.0.15 → 1.0.19

package/dist/ai-instructions/skills/sfcc-webdav-workflows/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: sfcc-webdav-workflows
+description: Practical guide for using WebDAV in Salesforce B2C Commerce Cloud for IMPEX transfers and log access. Use this when setting up WebDAV clients, debugging WebDAV permission issues, or designing automation that reads/writes files via WebDAV.
+---
+
+# SFCC WebDAV Workflows
+
+WebDAV is SFCC’s “remote filesystem over HTTP”. It’s central to:
+- Moving data in/out via IMPEX
+- Reading logs
+- Managing catalogs/images in supported folders
+
+This skill focuses on *practical* workflows and the most common permission and path pitfalls.
+
+## Quick Checklist
+
+```text
+[ ] Confirm which auth path you are using: BM user (Basic Auth) vs API client (client-id/secret token)
+[ ] For IMPEX, ensure the BM role includes File Transfer Manager access
+[ ] If using API client auth, generate credentials in Account Manager
+[ ] Verify directory permissions are configured in Business Manager for the exact folder(s)
+[ ] Avoid overlapping WebDAV client permission paths (SFCC restriction)
+[ ] Don’t expect write access to restricted folders (e.g. security logs)
+[ ] For automation: scope access to the minimum folders required
+```
+
+## Mental Model
+
+- **WebDAV ≈ HTTP interface to instance folders** (not your local repo)
+- **Permissions are folder-scoped** and configured in Business Manager
+- **Two common authentication modes**:
+  - **Business Manager users**: Basic Auth (username/password), governed by Role permissions
+  - **API clients**: token-based auth (client credentials from Account Manager), governed by “WebDAV Client Permissions” JSON
+- **Wildcard folder permissions** (like `/catalogs/*` or “all other folders”) grant access to future subfolders automatically
+- **WebDAV versioning is not enabled** in SFCC
+- **Primary instance group vs sandbox**: primary instance group access requires authenticated WebDAV; sandboxes often use WebDAV for manual file moves
+
+## Common SFCC WebDAV Folders (What They’re Typically For)
+
+These vary by project, but the patterns are stable:
+
+| Folder | Typical use | Read/Write? |
+|---|---|---|
+| `/impex/src/` | Upload import feeds, export results | Usually read/write |
+| `/impex/src/logs/` | Some log exports and job artifacts | Often read |
+| `/Logs/` | Log files (application logs) | Usually read |
+| `/catalogs/` | Catalog assets (shared library content, images) | Often read |
+| `/cartridges/` | Code deployment via WebDAV (teams vary) | Usually read/write for deployment users |
+
+## Business Manager Setup (Humans / Desktop Clients)
+
+### Role-based permissions
+- Configure in: **Administration → Organization → Roles & Permissions** (select a role) → **WebDAV Permissions** tab
+- Use this when a developer uses Cyberduck/Transmit/FileZilla with BM credentials.
+- Required functional permissions often include: `WebDAV_Realm_Access`, `WebDAV_Manage_Customization`, `WebDAV_Transfer_Files`.
+- If you select a wildcard path (like `/catalogs/*` or “all other folders”), permissions apply to future subfolders automatically unless sub-permissions are set explicitly.
+
+### Debugging “403 Forbidden” quickly
+- Confirm you’re editing the correct role
+- Confirm the role grants permissions for the *exact* path you’re trying to access
+
+## API Client Setup (Automation / CI / Tools)
+
+### WebDAV Client Permissions (JSON)
+- Configure in: **Administration → Organization → WebDAV Client Permissions**
+- You assign `client_id` → permissions array of `{ path, operations }`.
+
+**Operations typically include:** `read`, `read_write`.
+
+### Critical constraint: no intersecting permission paths
+SFCC does not allow different WebDAV client permission paths to overlap.
+
+Example of what to avoid:
+- Client A: `/impex/src`
+- Client B: `/impex/src/foo`
+
+Design your permission model so each client owns a non-overlapping subtree.
+
+### Restricted directories
+Some directories are effectively **read-only** for security reasons (for example, security log directories). Expect permission errors even if you attempt to grant write.
+
+## Automation Patterns
+
+### Pattern: “single-purpose” clients
+Create separate API clients for:
+- Log readers (read-only `/Logs/`)
+- IMPEX uploaders (read/write `/impex/src/`) 
+
+This keeps credentials and blast radius smaller.
+
+### Pattern: job writes file → WebDAV serves download
+When storefront requests can’t write files, a common SFCC pattern is:
+1. Storefront creates a token/state record
+2. Background job generates file into `/impex/src/` (or another allowed folder)
+3. Storefront polls and then links the file
+
+(See also: `sfcc-platform-limits` for storefront file I/O constraints.)
+
+## References
+- Rhino Inquisitor: A Beginner’s Guide To WebDAV For Salesforce B2C Commerce Cloud
+  - https://www.rhino-inquisitor.com/a-beginners-guide-to-webdav-in-sfcc/
+- Salesforce Help: Access files with WebDAV (folder access + permissions)
+  - https://help.salesforce.com/s/articleView?id=cc.b2c_access_files_webdav.htm&type=5
+- Salesforce Help: Create roles & WebDAV permissions
+  - https://help.salesforce.com/s/articleView?id=cc.b2c_creating_roles.htm&type=5
+- Salesforce Help: Roles and permissions overview
+  - https://help.salesforce.com/s/articleView?id=cc.b2c_roles_and_permissions.htm&type=5
+- Salesforce Help: Transfer files to an instance (IMPEX)
+  - https://help.salesforce.com/s/articleView?id=cc.b2c_transferring_files_to_an_instance.htm&type=5
+- Salesforce Help: Generate API client ID (Account Manager)
+  - https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm&type=5

package/dist/clients/agent-instructions-client.d.ts

@@ -0,0 +1,66 @@
+import { Logger } from '../utils/logger.js';
+import { WorkspaceRootsService } from '../config/workspace-roots.js';
+export type DestinationType = 'project' | 'user' | 'temp';
+export type MergeStrategy = 'append' | 'replace' | 'skip';
+export interface InstructionStatus {
+    workspaceRoot?: string;
+    hasAgents: boolean;
+    hasSkills: boolean;
+    detectedSkillsDir?: string;
+    missingSkills: string[];
+    sourceSkills: string[];
+}
+export interface SyncOptions {
+    destinationType?: DestinationType;
+    preferredRoot?: string;
+    skillsDir?: string;
+    mergeStrategy?: MergeStrategy;
+    includeAgents?: boolean;
+    includeSkills?: boolean;
+    installMissingOnly?: boolean;
+    dryRun?: boolean;
+    tempDir?: string;
+}
+export interface SyncPlan {
+    destinationType: DestinationType;
+    basePath: string;
+    agentsTarget?: string;
+    skillsTarget?: string;
+    actions: {
+        agentsAction: 'create' | 'append' | 'replace' | 'skip' | 'none';
+        skillsToCopy: string[];
+        skillsSkipped: string[];
+    };
+    notes: string[];
+}
+export interface SyncResult {
+    plan: SyncPlan;
+    applied: boolean;
+    message: string;
+}
+/**
+ * Manages copying AGENTS.md and bundled skills into the user's workspace.
+ */
+export declare class AgentInstructionsClient {
+    private readonly logger;
+    private readonly workspaceRootsService;
+    private readonly sourceAgentsPath;
+    private readonly sourceSkillsPath;
+    constructor(workspaceRootsService: WorkspaceRootsService, logger?: Logger);
+    getStatus(preferredRoot?: string): Promise<InstructionStatus>;
+    syncInstructions(options?: SyncOptions): Promise<SyncResult>;
+    private resolveWorkspaceRoot;
+    private resolveBasePath;
+    private resolveSkillsTarget;
+    private planAgentMerge;
+    private planSkillCopy;
+    private applyPlan;
+    private writeAgents;
+    private copySkills;
+    private findMissingSkills;
+    private getSourceSkillNames;
+    private findFirstExistingDir;
+    private exists;
+    private isDirectory;
+}
+//# sourceMappingURL=agent-instructions-client.d.ts.map

package/dist/clients/agent-instructions-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-instructions-client.d.ts","sourceRoot":"","sources":["../../src/clients/agent-instructions-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACP,YAAY,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;QAChE,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAwB;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM;IAOnE,SAAS,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsC7D,gBAAgB,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAiFtE,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,eAAe;YAmBT,mBAAmB;YAoBnB,cAAc;YAsBd,aAAa;YAqBb,SAAS;YAUT,WAAW;YAoBX,UAAU;YAUV,iBAAiB;YAcjB,mBAAmB;YAUnB,oBAAoB;YASpB,MAAM;YASN,WAAW;CAQ1B"}

package/dist/clients/agent-instructions-client.js

@@ -0,0 +1,277 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import os from 'os';
+import { Logger } from '../utils/logger.js';
+import { PathResolver } from '../utils/path-resolver.js';
+/**
+ * Manages copying AGENTS.md and bundled skills into the user's workspace.
+ */
+export class AgentInstructionsClient {
+    logger;
+    workspaceRootsService;
+    sourceAgentsPath;
+    sourceSkillsPath;
+    constructor(workspaceRootsService, logger) {
+        this.workspaceRootsService = workspaceRootsService;
+        this.logger = logger ?? Logger.getChildLogger('AgentInstructionsClient');
+        this.sourceAgentsPath = PathResolver.getAgentsInstructionsFile();
+        this.sourceSkillsPath = PathResolver.getSkillsSourcePath();
+    }
+    async getStatus(preferredRoot) {
+        const rootPath = this.resolveWorkspaceRoot(preferredRoot);
+        const sourceSkills = await this.getSourceSkillNames();
+        if (!rootPath) {
+            return {
+                workspaceRoot: undefined,
+                hasAgents: false,
+                hasSkills: false,
+                detectedSkillsDir: undefined,
+                missingSkills: sourceSkills,
+                sourceSkills,
+            };
+        }
+        const agentsTarget = path.join(rootPath, 'AGENTS.md');
+        const hasAgents = await this.exists(agentsTarget);
+        const candidateSkillsDirs = [
+            '.github/skills',
+            '.cursor/skills',
+            '.claude/skills',
+        ].map(dir => path.join(rootPath, dir));
+        const detectedSkillsDir = await this.findFirstExistingDir(candidateSkillsDirs);
+        const missingSkills = await this.findMissingSkills(detectedSkillsDir, sourceSkills);
+        const hasSkills = !!detectedSkillsDir && missingSkills.length === 0 && sourceSkills.length > 0;
+        return {
+            workspaceRoot: rootPath,
+            hasAgents,
+            hasSkills,
+            detectedSkillsDir,
+            missingSkills,
+            sourceSkills,
+        };
+    }
+    async syncInstructions(options = {}) {
+        const mergedOptions = {
+            destinationType: options.destinationType ?? 'project',
+            preferredRoot: options.preferredRoot ?? '',
+            skillsDir: options.skillsDir ?? '',
+            mergeStrategy: options.mergeStrategy ?? 'append',
+            includeAgents: options.includeAgents ?? true,
+            includeSkills: options.includeSkills ?? true,
+            installMissingOnly: options.installMissingOnly ?? true,
+            dryRun: options.dryRun ?? true,
+            tempDir: options.tempDir ?? '',
+        };
+        const basePath = this.resolveBasePath(mergedOptions.destinationType, mergedOptions.preferredRoot, mergedOptions.tempDir);
+        if (!basePath) {
+            return {
+                plan: {
+                    destinationType: mergedOptions.destinationType,
+                    basePath: '',
+                    actions: { agentsAction: 'none', skillsToCopy: [], skillsSkipped: [] },
+                    notes: [
+                        'Workspace root not discovered; provide a root or use destinationType "temp" or "user".',
+                    ],
+                },
+                applied: false,
+                message: 'No accessible base path for installation',
+            };
+        }
+        const sourceSkills = await this.getSourceSkillNames();
+        const skillsTarget = mergedOptions.includeSkills
+            ? await this.resolveSkillsTarget(basePath, mergedOptions.skillsDir)
+            : undefined;
+        const agentsTarget = mergedOptions.includeAgents
+            ? path.join(basePath, 'AGENTS.md')
+            : undefined;
+        const plan = {
+            destinationType: mergedOptions.destinationType,
+            basePath,
+            agentsTarget,
+            skillsTarget,
+            actions: {
+                agentsAction: 'none',
+                skillsToCopy: [],
+                skillsSkipped: [],
+            },
+            notes: [],
+        };
+        if (mergedOptions.includeAgents && agentsTarget) {
+            plan.actions.agentsAction = await this.planAgentMerge(agentsTarget, mergedOptions.mergeStrategy);
+        }
+        if (mergedOptions.includeSkills && skillsTarget) {
+            const skillCopyPlan = await this.planSkillCopy(skillsTarget, sourceSkills, mergedOptions.installMissingOnly);
+            plan.actions.skillsToCopy = skillCopyPlan.toCopy;
+            plan.actions.skillsSkipped = skillCopyPlan.skipped;
+        }
+        if (mergedOptions.dryRun) {
+            return {
+                plan,
+                applied: false,
+                message: 'Dry run only. No files were written.',
+            };
+        }
+        await this.applyPlan(plan, mergedOptions.mergeStrategy);
+        return {
+            plan,
+            applied: true,
+            message: 'Agent instructions synchronized',
+        };
+    }
+    resolveWorkspaceRoot(preferredRoot) {
+        const roots = this.workspaceRootsService.getRoots();
+        if (!roots || roots.length === 0) {
+            return undefined;
+        }
+        if (preferredRoot) {
+            const matched = roots.find(root => root.path === preferredRoot || root.name === preferredRoot);
+            if (matched) {
+                return matched.path;
+            }
+        }
+        return roots[0]?.path;
+    }
+    resolveBasePath(destinationType, preferredRoot, tempDir) {
+        if (destinationType === 'project') {
+            return this.resolveWorkspaceRoot(preferredRoot);
+        }
+        if (destinationType === 'user') {
+            return os.homedir();
+        }
+        const resolvedTemp = tempDir
+            ? path.resolve(tempDir)
+            : path.join(os.tmpdir(), 'sfcc-dev-mcp-ai-instructions');
+        return resolvedTemp;
+    }
+    async resolveSkillsTarget(basePath, preferredDir) {
+        const safeDir = preferredDir && !preferredDir.includes('..') && !path.isAbsolute(preferredDir)
+            ? preferredDir
+            : '';
+        const candidates = [safeDir, '.github/skills', '.cursor/skills', '.claude/skills'].filter(Boolean);
+        for (const candidate of candidates) {
+            const resolved = path.resolve(basePath, candidate);
+            if (!resolved.startsWith(basePath)) {
+                continue;
+            }
+            if (await this.isDirectory(resolved)) {
+                return resolved;
+            }
+        }
+        return path.resolve(basePath, candidates[0] || '.github/skills');
+    }
+    async planAgentMerge(targetPath, strategy) {
+        const exists = await this.exists(targetPath);
+        if (!exists) {
+            return 'create';
+        }
+        if (strategy === 'skip') {
+            return 'skip';
+        }
+        if (strategy === 'replace') {
+            return 'replace';
+        }
+        const existingContent = await fs.readFile(targetPath, 'utf-8');
+        const sourceContent = await fs.readFile(this.sourceAgentsPath, 'utf-8');
+        if (existingContent.includes(sourceContent.trim())) {
+            return 'skip';
+        }
+        return 'append';
+    }
+    async planSkillCopy(targetDir, sourceSkills, missingOnly) {
+        const toCopy = [];
+        const skipped = [];
+        for (const skill of sourceSkills) {
+            const targetSkillDir = path.join(targetDir, skill);
+            const exists = await this.isDirectory(targetSkillDir);
+            if (exists && missingOnly) {
+                skipped.push(skill);
+                continue;
+            }
+            toCopy.push(skill);
+        }
+        return { toCopy, skipped };
+    }
+    async applyPlan(plan, mergeStrategy) {
+        if (plan.agentsTarget && plan.actions.agentsAction !== 'none' && plan.actions.agentsAction !== 'skip') {
+            await this.writeAgents(plan.agentsTarget, mergeStrategy, plan.actions.agentsAction);
+        }
+        if (plan.skillsTarget && plan.actions.skillsToCopy.length > 0) {
+            await this.copySkills(plan.skillsTarget, plan.actions.skillsToCopy);
+        }
+    }
+    async writeAgents(targetPath, strategy, plannedAction) {
+        const targetDir = path.dirname(targetPath);
+        await fs.mkdir(targetDir, { recursive: true });
+        const sourceContent = await fs.readFile(this.sourceAgentsPath, 'utf-8');
+        if (plannedAction === 'create' || strategy === 'replace') {
+            await fs.writeFile(targetPath, sourceContent, 'utf-8');
+            return;
+        }
+        const existingContent = await fs.readFile(targetPath, 'utf-8');
+        const merged = [
+            existingContent,
+            '',
+            '<!-- merged from sfcc-dev-mcp AI instructions -->',
+            sourceContent,
+        ].join('\n');
+        await fs.writeFile(targetPath, merged, 'utf-8');
+    }
+    async copySkills(targetDir, skills) {
+        await fs.mkdir(targetDir, { recursive: true });
+        for (const skill of skills) {
+            const sourceDir = path.join(this.sourceSkillsPath, skill);
+            const destinationDir = path.join(targetDir, skill);
+            await fs.cp(sourceDir, destinationDir, { recursive: true, force: false });
+        }
+    }
+    async findMissingSkills(skillsDir, sourceSkills) {
+        if (!skillsDir) {
+            return sourceSkills;
+        }
+        const missing = [];
+        for (const skill of sourceSkills) {
+            const target = path.join(skillsDir, skill);
+            const exists = await this.isDirectory(target);
+            if (!exists) {
+                missing.push(skill);
+            }
+        }
+        return missing;
+    }
+    async getSourceSkillNames() {
+        try {
+            const entries = await fs.readdir(this.sourceSkillsPath, { withFileTypes: true });
+            return entries.filter(entry => entry.isDirectory()).map(entry => entry.name);
+        }
+        catch (error) {
+            this.logger.error('Failed to read source skills', error);
+            return [];
+        }
+    }
+    async findFirstExistingDir(pathsToCheck) {
+        for (const candidate of pathsToCheck) {
+            if (await this.isDirectory(candidate)) {
+                return candidate;
+            }
+        }
+        return undefined;
+    }
+    async exists(targetPath) {
+        try {
+            await fs.access(targetPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isDirectory(targetPath) {
+        try {
+            const stats = await fs.stat(targetPath);
+            return stats.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=agent-instructions-client.js.map

package/dist/clients/agent-instructions-client.js.map

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

package/dist/clients/base/abstract-documentation-client.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Abstract Documentation Client
+ *
+ * Base class for documentation clients (SFRA, ISML) that share common patterns:
+ * - Category-based organization
+ * - Caching with TTL
+ * - Search with relevance scoring
+ * - File-based document loading
+ */
+import { CacheManager } from '../../utils/cache.js';
+import { Logger } from '../../utils/logger.js';
+import { CategoryInfo } from '../../utils/category-utils.js';
+/**
+ * Base document interface - extend for specific document types
+ */
+export interface BaseDocument {
+    name: string;
+    title: string;
+    description: string;
+    sections: string[];
+    content: string;
+    category: string;
+    filename: string;
+    lastModified?: Date;
+}
+/**
+ * Summary format for document lists
+ */
+export interface DocumentSummary {
+    name: string;
+    title: string;
+    description: string;
+    category: string;
+    filename: string;
+}
+/**
+ * Search result with relevance scoring
+ */
+export interface SearchResult<T extends DocumentSummary> {
+    document: T;
+    relevance: number;
+    matchedSections: string[];
+    preview: string;
+}
+/**
+ * Category information with count
+ */
+export interface CategoryWithCount {
+    name: string;
+    displayName: string;
+    description: string;
+    count: number;
+}
+/**
+ * Configuration for the documentation client
+ */
+export interface DocumentationClientConfig<TCategory extends string> {
+    /** Name for logging */
+    clientName: string;
+    /** Path to documentation files */
+    docsPath: string;
+    /** Category mappings (document name -> category) */
+    categoryMappings: Record<string, TCategory>;
+    /** Category descriptions */
+    categoryDescriptions: Record<TCategory, CategoryInfo>;
+    /** Default category for unmapped documents */
+    defaultCategory: TCategory;
+    /** Cache key prefix */
+    cachePrefix: string;
+}
+/**
+ * Abstract base class for documentation clients
+ * Provides common functionality for loading, caching, and searching documents
+ */
+export declare abstract class AbstractDocumentationClient<TDocument extends BaseDocument, TSummary extends DocumentSummary, TCategory extends string> {
+    protected readonly logger: Logger;
+    protected readonly cache: CacheManager;
+    protected readonly docsPath: string;
+    protected readonly config: DocumentationClientConfig<TCategory>;
+    protected documentsCache: TDocument[] | null;
+    protected lastScanTime: number;
+    protected static readonly SCAN_CACHE_TTL: number;
+    constructor(config: DocumentationClientConfig<TCategory>);
+    /**
+     * Get list of all available documents with summaries
+     */
+    getAvailableDocuments(): Promise<TSummary[]>;
+    /**
+     * Get a specific document by name
+     */
+    getDocument(documentName: string): Promise<TDocument | null>;
+    /**
+     * Search documents with relevance scoring
+     */
+    searchDocuments(query: string, options?: {
+        category?: string;
+        limit?: number;
+    }): Promise<SearchResult<TSummary>[]>;
+    /**
+     * Get documents filtered by category
+     */
+    getDocumentsByCategory(category: string): Promise<TSummary[]>;
+    /**
+     * Get available categories with counts
+     */
+    getAvailableCategories(): Promise<CategoryWithCount[]>;
+    /**
+     * Clear all caches
+     */
+    clearCache(): void;
+    protected static readonly PARALLEL_BATCH_SIZE = 30;
+    /**
+     * Load all documents from the docs directory
+     * Uses parallel batch processing for improved performance
+     */
+    protected loadAllDocuments(): Promise<TDocument[]>;
+    /**
+     * Parse a single document file - override for custom parsing
+     */
+    protected parseDocumentFile(filePath: string, filename: string): Promise<TDocument | null>;
+    /**
+     * Create a document instance - override for custom document types
+     */
+    protected abstract createDocument(baseData: BaseDocument): TDocument;
+    /**
+     * Convert document to summary - override for custom summary types
+     */
+    protected abstract toSummary(document: TDocument): TSummary;
+    /**
+     * Normalize document name for consistent lookup
+     */
+    protected normalizeDocumentName(name: string): string;
+    /**
+     * Calculate relevance score for a document
+     */
+    protected calculateDocumentRelevance(document: TDocument, query: string): number;
+    /**
+     * Find sections that match the search query
+     */
+    protected findMatchedSections(document: TDocument, query: string): string[];
+    /**
+     * Generate a preview snippet for search results
+     */
+    protected generateDocumentPreview(document: TDocument, query: string): string;
+}
+//# sourceMappingURL=abstract-documentation-client.d.ts.map

package/dist/clients/base/abstract-documentation-client.d.ts.map

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