opencode-swarm-plugin 0.44.1 → 0.44.2

package/dist/swarm-validation.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Swarm Validation Hook Infrastructure
+ *
+ * Provides validation event types and hooks for post-swarm validation.
+ * Integrates with swarm-mail event sourcing to emit validation events.
+ *
+ * @module swarm-validation
+ */
+import { z } from "zod";
+/**
+ * Agent event type for validation events
+ *
+ * This is a minimal type that matches the swarm-mail AgentEvent interface
+ * for the validation events we emit.
+ */
+type AgentEvent = {
+    type: "validation_started";
+    project_key: string;
+    timestamp: number;
+    epic_id: string;
+    swarm_id: string;
+    started_at: number;
+} | {
+    type: "validation_issue";
+    project_key: string;
+    timestamp: string | number;
+    epic_id: string;
+    severity: "error" | "warning" | "info";
+    category: "schema_mismatch" | "missing_event" | "undefined_value" | "dashboard_render" | "websocket_delivery";
+    message: string;
+    location?: {
+        event_type?: string;
+        field?: string;
+        component?: string;
+    };
+} | {
+    type: "validation_completed";
+    project_key: string;
+    timestamp: number;
+    epic_id: string;
+    swarm_id: string;
+    passed: boolean;
+    issue_count: number;
+    duration_ms: number;
+};
+/**
+ * Severity levels for validation issues
+ */
+export declare const ValidationIssueSeverity: z.ZodEnum<{
+    error: "error";
+    info: "info";
+    warning: "warning";
+}>;
+/**
+ * Categories of validation issues
+ */
+export declare const ValidationIssueCategory: z.ZodEnum<{
+    schema_mismatch: "schema_mismatch";
+    missing_event: "missing_event";
+    undefined_value: "undefined_value";
+    dashboard_render: "dashboard_render";
+    websocket_delivery: "websocket_delivery";
+}>;
+/**
+ * Validation issue with location context
+ */
+export declare const ValidationIssueSchema: z.ZodObject<{
+    severity: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+    }>;
+    category: z.ZodEnum<{
+        schema_mismatch: "schema_mismatch";
+        missing_event: "missing_event";
+        undefined_value: "undefined_value";
+        dashboard_render: "dashboard_render";
+        websocket_delivery: "websocket_delivery";
+    }>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodObject<{
+        event_type: z.ZodOptional<z.ZodString>;
+        field: z.ZodOptional<z.ZodString>;
+        component: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ValidationIssue = z.infer<typeof ValidationIssueSchema>;
+/**
+ * Context for validation execution
+ */
+export interface ValidationContext {
+    /** Project key (path) */
+    project_key: string;
+    /** Epic ID being validated */
+    epic_id: string;
+    /** Swarm ID being validated */
+    swarm_id: string;
+    /** Validation start time */
+    started_at: Date;
+    /** Event emitter function */
+    emit: (event: AgentEvent) => Promise<void>;
+}
+/**
+ * Run post-swarm validation
+ *
+ * Emits validation_started, runs validators, emits validation_issue for each issue,
+ * and emits validation_completed with summary.
+ *
+ * @param ctx - Validation context
+ * @param events - Events to validate
+ * @returns Validation result with passed flag and issues
+ */
+export declare function runPostSwarmValidation(ctx: ValidationContext, events: unknown[]): Promise<{
+    passed: boolean;
+    issues: ValidationIssue[];
+}>;
+/**
+ * Report a validation issue
+ *
+ * Emits a validation_issue event with the provided issue details.
+ *
+ * @param ctx - Validation context
+ * @param issue - Validation issue to report
+ */
+export declare function reportIssue(ctx: ValidationContext, issue: ValidationIssue): Promise<void>;
+export {};
+//# sourceMappingURL=swarm-validation.d.ts.map

package/dist/swarm-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-validation.d.ts","sourceRoot":"","sources":["../src/swarm-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,KAAK,UAAU,GACX;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,QAAQ,EACJ,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAMN;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;EAAuC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAMlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;iBAWhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,UAAU,EAAE,IAAI,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAMD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CA+BzD;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/validators/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validators - Event and schema validation utilities
+ *
+ * @module validators
+ */
+export * from "./schema-validator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/validators/schema-validator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Event Schema Validator
+ *
+ * Validates emitted events against their Zod schemas.
+ * Catches:
+ * - Type mismatches
+ * - Missing required fields
+ * - Undefined values that could break UI rendering
+ * - Schema violations
+ *
+ * Used by:
+ * - Swarm event emission (validateEvent before emit)
+ * - Post-run validation (validateSwarmEvents for all events)
+ * - Debug tooling (identify schema drift)
+ */
+import type { ZodError } from "zod";
+export interface ValidationIssue {
+    severity: "error" | "warning";
+    category: "schema_mismatch" | "undefined_value" | "missing_field" | "type_error";
+    message: string;
+    location?: {
+        event_type?: string;
+        field?: string;
+    };
+    zodError?: ZodError;
+}
+export interface SchemaValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+/**
+ * Validate a single event against its schema
+ *
+ * Usage:
+ * ```typescript
+ * const result = validateEvent(event);
+ * if (!result.valid) {
+ *   console.error("Schema validation failed:", result.issues);
+ * }
+ * ```
+ */
+export declare function validateEvent(event: unknown): SchemaValidationResult;
+/**
+ * Validate all events from a swarm run
+ *
+ * Usage:
+ * ```typescript
+ * const { passed, issueCount } = await validateSwarmEvents(events);
+ * if (!passed) {
+ *   console.error(`Found ${issueCount} validation issues`);
+ * }
+ * ```
+ */
+export declare function validateSwarmEvents(events: unknown[]): Promise<{
+    passed: boolean;
+    issueCount: number;
+}>;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/validators/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/validators/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EACJ,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,YAAY,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAkDpE;AAgCD;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAWlD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.44.1",
+  "version": "0.44.2",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,7 +36,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target node --external @electric-sql/pglite --external swarm-mail --external evalite && bun build ./src/plugin.ts --outfile ./dist/plugin.js --target node --external @electric-sql/pglite --external swarm-mail --external evalite && bun build ./src/eval-capture.ts --outfile ./dist/eval-capture.js --target node --external @electric-sql/pglite --external swarm-mail && bun build ./src/compaction-prompt-scoring.ts --outfile ./dist/compaction-prompt-scoring.js --target node --external @electric-sql/pglite --external swarm-mail && tsc",
+    "build": "bun run scripts/build.ts",
     "dev": "bun --watch src/index.ts",
     "test": "bun test --timeout 10000 src/anti-patterns.test.ts src/mandate-promotion.test.ts src/mandate-storage.test.ts src/output-guardrails.test.ts src/pattern-maturity.test.ts src/skills.test.ts src/structured.test.ts src/schemas/",
     "test:integration": "bun test --timeout 60000 src/*.integration.test.ts",