patchwork-os 0.2.0-alpha.0

package/dist/tools/performanceReport.js

@@ -0,0 +1,218 @@
+import { successStructured } from "./utils.js";
+const DEFAULT_WINDOW_MINUTES = 60;
+export function createGetPerformanceReportTool(deps) {
+    return {
+        schema: {
+            name: "getPerformanceReport",
+            description: "Live performance assessment: per-tool latency percentiles, throughput, extension health, session counts, and overall health score.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    windowMinutes: {
+                        type: "number",
+                        description: "Lookback window in minutes for throughput stats. Default: 60.",
+                        minimum: 1,
+                        maximum: 1440,
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    generatedAt: { type: "string" },
+                    windowMinutes: { type: "number" },
+                    latency: {
+                        type: "object",
+                        properties: {
+                            perTool: { type: "object" },
+                            overallP95Ms: { type: "number" },
+                        },
+                        required: ["perTool", "overallP95Ms"],
+                    },
+                    throughput: {
+                        type: "object",
+                        properties: {
+                            callsPerMinute: { type: "number" },
+                            errorsPerMinute: { type: "number" },
+                            errorRatePct: { type: "number" },
+                            rateLimitRejectedTotal: { type: "number" },
+                        },
+                        required: [
+                            "callsPerMinute",
+                            "errorsPerMinute",
+                            "errorRatePct",
+                            "rateLimitRejectedTotal",
+                        ],
+                    },
+                    extension: {
+                        type: "object",
+                        properties: {
+                            connected: { type: "boolean" },
+                            rttMs: { type: ["number", "null"] },
+                            circuitBreakerSuspended: { type: "boolean" },
+                            disconnectCount: { type: "number" },
+                            connectionQuality: {
+                                type: "string",
+                                enum: ["healthy", "degraded", "poor", "disconnected"],
+                            },
+                        },
+                        required: [
+                            "connected",
+                            "rttMs",
+                            "circuitBreakerSuspended",
+                            "disconnectCount",
+                            "connectionQuality",
+                        ],
+                    },
+                    sessions: {
+                        type: "object",
+                        properties: {
+                            active: { type: "number" },
+                            inGrace: { type: "number" },
+                        },
+                        required: ["active", "inGrace"],
+                    },
+                    health: {
+                        type: "object",
+                        properties: {
+                            score: { type: "number" },
+                            signals: { type: "array", items: { type: "string" } },
+                        },
+                        required: ["score", "signals"],
+                    },
+                },
+                required: [
+                    "generatedAt",
+                    "windowMinutes",
+                    "latency",
+                    "throughput",
+                    "extension",
+                    "sessions",
+                    "health",
+                ],
+            },
+        },
+        handler: async (params) => {
+            const windowMinutes = typeof params.windowMinutes === "number" && params.windowMinutes >= 1
+                ? params.windowMinutes
+                : DEFAULT_WINDOW_MINUTES;
+            const windowMs = windowMinutes * 60_000;
+            // --- Latency ---
+            const allPercentiles = deps.activityLog.percentiles();
+            const windowedS = deps.activityLog.windowedStats(windowMs);
+            const allStats = deps.activityLog.stats();
+            const perTool = {};
+            for (const [tool, pct] of Object.entries(allPercentiles)) {
+                const ws = windowedS[tool];
+                const as = allStats[tool];
+                perTool[tool] = {
+                    p50: pct.p50,
+                    p95: pct.p95,
+                    p99: pct.p99,
+                    sampleCount: pct.sampleCount,
+                    avgMs: as?.avgDurationMs ?? 0,
+                    calls: ws?.count ?? 0,
+                    errorRate: ws && ws.count > 0
+                        ? Math.round((ws.errors / ws.count) * 10000) / 100
+                        : 0,
+                };
+            }
+            // Overall p95: max across all tools (worst-case SLA)
+            const p95Values = Object.values(allPercentiles).map((p) => p.p95);
+            const overallP95Ms = p95Values.length > 0 ? Math.max(...p95Values) : 0;
+            // --- Throughput ---
+            let totalCalls = 0;
+            let totalErrors = 0;
+            for (const s of Object.values(windowedS)) {
+                totalCalls += s.count;
+                totalErrors += s.errors;
+            }
+            const callsPerMinute = Math.round((totalCalls / windowMinutes) * 100) / 100;
+            const errorsPerMinute = Math.round((totalErrors / windowMinutes) * 100) / 100;
+            const errorRatePct = totalCalls > 0
+                ? Math.round((totalErrors / totalCalls) * 10000) / 100
+                : 0;
+            const rateLimitRejectedTotal = deps.getRateLimitRejected();
+            // --- Extension ---
+            const connected = deps.extensionClient.isConnected();
+            const cb = deps.extensionClient.getCircuitBreakerState();
+            const circuitBreakerSuspended = cb.suspended;
+            const disconnectCount = deps.getExtensionDisconnectCount();
+            // RTT: not directly tracked; null unless we can derive it
+            const rttMs = null;
+            let connectionQuality;
+            if (!connected) {
+                connectionQuality = "disconnected";
+            }
+            else if (circuitBreakerSuspended) {
+                connectionQuality = "poor";
+            }
+            else if (rttMs !== null && rttMs > 500) {
+                connectionQuality = "degraded";
+            }
+            else {
+                connectionQuality = "healthy";
+            }
+            // --- Sessions ---
+            const sessions = deps.getSessions();
+            // --- Health score ---
+            let score = 100;
+            const signals = [];
+            if (circuitBreakerSuspended) {
+                score -= 20;
+                signals.push("Circuit breaker suspended");
+            }
+            if (rttMs !== null && rttMs > 500) {
+                score -= 10;
+                signals.push(`Extension RTT high (${rttMs}ms)`);
+            }
+            if (errorRatePct > 5) {
+                score -= 15;
+                signals.push(`Error rate critical (${errorRatePct}%)`);
+            }
+            else if (errorRatePct > 1) {
+                score -= 10;
+                signals.push(`Error rate elevated (${errorRatePct}%)`);
+            }
+            if (overallP95Ms > 2000) {
+                score -= 10;
+                signals.push(`p95 latency critical (${overallP95Ms}ms)`);
+            }
+            else if (overallP95Ms > 500) {
+                score -= 5;
+                signals.push(`p95 latency elevated (${overallP95Ms}ms)`);
+            }
+            if (rateLimitRejectedTotal > 0) {
+                score -= 10;
+                signals.push(`${rateLimitRejectedTotal} rate-limit rejection(s)`);
+            }
+            if (!connected) {
+                signals.push("Extension disconnected");
+            }
+            score = Math.max(0, Math.min(100, score));
+            return successStructured({
+                generatedAt: new Date().toISOString(),
+                windowMinutes,
+                latency: { perTool, overallP95Ms },
+                throughput: {
+                    callsPerMinute,
+                    errorsPerMinute,
+                    errorRatePct,
+                    rateLimitRejectedTotal,
+                },
+                extension: {
+                    connected,
+                    rttMs,
+                    circuitBreakerSuspended,
+                    disconnectCount,
+                    connectionQuality,
+                },
+                sessions,
+                health: { score, signals },
+            });
+        },
+    };
+}
+//# sourceMappingURL=performanceReport.js.map

package/dist/tools/performanceReport.js.map

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

package/dist/tools/planPersistence.d.ts

@@ -0,0 +1,306 @@
+export declare function createPlanTools(workspace: string): ({
+    schema: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                title: {
+                    type: string;
+                    description: string;
+                };
+                fileName: {
+                    type: string;
+                    description: string;
+                };
+                sections: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        required: string[];
+                        additionalProperties: boolean;
+                        properties: {
+                            name: {
+                                type: string;
+                                description: string;
+                            };
+                            tasks: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                                description: string;
+                            };
+                        };
+                    };
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                created: {
+                    type: string;
+                };
+                fileName: {
+                    type: string;
+                };
+                path: {
+                    type: string;
+                };
+                sections: {
+                    type: string;
+                };
+                tasks: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+} | {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                fileName: {
+                    type: string;
+                    description: string;
+                };
+                markComplete: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                markIncomplete: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                addTasks: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        required: string[];
+                        additionalProperties: boolean;
+                        properties: {
+                            section: {
+                                type: string;
+                                description: string;
+                            };
+                            tasks: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                            };
+                        };
+                    };
+                };
+                addSections: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        required: string[];
+                        additionalProperties: boolean;
+                        properties: {
+                            name: {
+                                type: string;
+                            };
+                            tasks: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                updated: {
+                    type: string;
+                };
+                changes: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+} | {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                fileName: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                found: {
+                    type: string;
+                };
+                fileName: {
+                    type: string;
+                };
+                title: {
+                    type: string;
+                };
+                created: {
+                    type: string;
+                };
+                updated: {
+                    type: string;
+                };
+                sections: {
+                    type: string;
+                };
+                summary: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+} | {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                fileName: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                deleted: {
+                    type: string;
+                };
+                fileName: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+} | {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {};
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                plans: {
+                    type: string;
+                };
+                count: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: () => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+})[];