@visualprd/mcp-server 1.1.0

package/dist/services/visualprd-client.d.ts

@@ -0,0 +1,191 @@
+/**
+ * VisualPRD API Client
+ *
+ * Connects to VisualPRD's Firestore backend to fetch project data,
+ * update build prompt status, and manage dynamic steps.
+ */
+import { ProjectConfig, ProjectData, BuildPrompt, PageEntity, SchemaEntity, EndpointEntity, TechStackEntity, DesignSystem, MCPSession, BuildCategory, BuildInstructionV2, BuildProgressV2 } from '../types/index.js';
+export declare class VisualPRDClient {
+    private db;
+    private config;
+    private projectDataCache;
+    private cacheTimestamp;
+    private readonly CACHE_TTL_MS;
+    constructor(config: ProjectConfig);
+    /**
+     * Load full project data including all entities
+     */
+    loadProjectData(forceRefresh?: boolean): Promise<ProjectData>;
+    private loadPages;
+    private loadSchemas;
+    private loadEndpoints;
+    private loadTechStack;
+    private loadBuildPrompts;
+    /**
+     * Load build prompts from v9-mega format (category documents with instructions array)
+     */
+    private loadBuildPromptsV9Mega;
+    private detectVersion;
+    private extractDesignSystem;
+    /**
+     * Get the next incomplete build prompt with all dependencies met
+     */
+    getNextBuildPrompt(): Promise<BuildPrompt | null>;
+    /**
+     * Mark a build prompt as complete
+     */
+    markPromptComplete(promptId: string, completionData: {
+        completionNotes?: string;
+        filesCreated?: string[];
+        testResults?: {
+            passed: number;
+            failed: number;
+        };
+    }): Promise<boolean>;
+    /**
+     * Uncheck/revert a build prompt
+     */
+    uncheckPrompt(promptId: string): Promise<boolean>;
+    /**
+     * Inject a new dynamic build prompt
+     */
+    injectBuildPrompt(insertAfterPromptId: string, newPrompt: {
+        title: string;
+        category: BuildCategory;
+        instruction: string;
+        reason: string;
+        relatedDocuments?: {
+            pages?: string[];
+            schemas?: string[];
+            endpoints?: string[];
+            techStack?: string[];
+        };
+        estimatedMinutes?: number;
+        dependsOn?: string[];
+    }): Promise<BuildPrompt | null>;
+    /**
+     * Get a specific page by ID or name
+     */
+    getPage(identifier: string): Promise<PageEntity | null>;
+    /**
+     * Get a specific schema by ID or collection name
+     */
+    getSchema(identifier: string): Promise<SchemaEntity | null>;
+    /**
+     * Get a specific endpoint by ID or name
+     */
+    getEndpoint(identifier: string): Promise<EndpointEntity | null>;
+    /**
+     * Get a specific tech stack item by ID or name
+     */
+    getTechStackItem(identifier: string): Promise<TechStackEntity | null>;
+    /**
+     * Get multiple entities by their references
+     */
+    resolveEntityReferences(refs: {
+        pages?: string[];
+        schemas?: string[];
+        endpoints?: string[];
+        techStack?: string[];
+    }): Promise<{
+        pages: PageEntity[];
+        schemas: SchemaEntity[];
+        endpoints: EndpointEntity[];
+        techStack: TechStackEntity[];
+    }>;
+    /**
+     * Create or update MCP session
+     */
+    updateSession(sessionId: string, data: Partial<MCPSession>): Promise<void>;
+    /**
+     * Log a tool call for analytics
+     */
+    logToolCall(sessionId: string, toolName: string, request: any, response: any, durationMs: number, intelligenceUsed: string): Promise<void>;
+    /**
+     * Log an error for debugging
+     */
+    logError(sessionId: string, promptId: string, error: {
+        errorType: string;
+        errorMessage: string;
+        stackTrace?: string;
+        context?: string;
+    }, diagnosis: any): Promise<void>;
+    private normalize;
+    private truncateForStorage;
+    /**
+     * Get build progress statistics
+     */
+    getBuildProgress(): Promise<{
+        totalSteps: number;
+        completedSteps: number;
+        currentStep: number;
+        percentComplete: number;
+        estimatedTimeRemaining: number;
+    }>;
+    /**
+     * Get the design system
+     */
+    getDesignSystem(): Promise<DesignSystem | undefined>;
+    /**
+     * Clear cache (force refresh on next load)
+     */
+    clearCache(): void;
+    /**
+     * Get next incomplete build instruction with V2 format (structured testCriteria)
+     * For v9-mega projects only
+     */
+    getNextBuildInstructionV2(): Promise<BuildInstructionV2 | null>;
+    /**
+     * Convert BuildPrompt to BuildInstructionV2 format
+     */
+    private promptToInstructionV2;
+    /**
+     * Normalize test criteria to V2 format
+     * Handles both string[] (old format) and TestCriterionV2[] (new format)
+     */
+    private normalizeTestCriteria;
+    /**
+     * Mark an instruction as complete in v9-mega format
+     * Updates the instruction within its category document
+     */
+    markInstructionCompleteV2(promptId: string, completionData: {
+        completionNotes?: string;
+        filesCreated?: string[];
+        validationSummary?: string;
+    }): Promise<boolean>;
+    /**
+     * Flag an instruction for human review (after max retry attempts)
+     */
+    flagInstructionForReview(promptId: string, reason: string, validationHistory: Array<{
+        attempt: number;
+        verdict: string;
+        message: string;
+    }>): Promise<boolean>;
+    /**
+     * Get V2 build progress with flagged counts
+     */
+    getBuildProgressV2(): Promise<BuildProgressV2>;
+    /**
+     * Log a V2 validation event for analytics
+     */
+    logValidationEvent(sessionId: string, promptId: string, event: {
+        type: 'submission' | 'validation' | 'retry' | 'flagged' | 'approved';
+        attempt?: number;
+        verdict?: string;
+        summary?: string;
+        criteriaResults?: Array<{
+            criterion: string;
+            status: string;
+            reason: string;
+        }>;
+    }): Promise<void>;
+    /**
+     * Get user's BYOK configuration if available
+     */
+    getUserBYOKConfig(userId: string): Promise<{
+        hasCustomKey: boolean;
+        encryptedApiKey?: string;
+        preferredModel?: string;
+    } | null>;
+}
+//# sourceMappingURL=visualprd-client.d.ts.map

package/dist/services/visualprd-client.d.ts.map

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