opencode-swarm-plugin 0.21.0 → 0.23.0

package/dist/pattern-maturity.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Pattern Maturity Module
+ *
+ * Tracks decomposition pattern maturity states through lifecycle:
+ * candidate → established → proven (or deprecated)
+ *
+ * Patterns start as candidates until they accumulate enough feedback.
+ * Strong positive feedback promotes to proven, strong negative deprecates.
+ *
+ * @see https://github.com/Dicklesworthstone/cass_memory_system/blob/main/src/scoring.ts#L73-L98
+ */
+import { z } from "zod";
+/**
+ * Maturity state for a decomposition pattern
+ *
+ * - candidate: Not enough feedback to judge (< minFeedback events)
+ * - established: Enough feedback, neither proven nor deprecated
+ * - proven: Strong positive signal (high helpful, low harmful ratio)
+ * - deprecated: Strong negative signal (high harmful ratio)
+ */
+export declare const MaturityStateSchema: z.ZodEnum<{
+    deprecated: "deprecated";
+    candidate: "candidate";
+    established: "established";
+    proven: "proven";
+}>;
+export type MaturityState = z.infer<typeof MaturityStateSchema>;
+/**
+ * Pattern maturity tracking
+ *
+ * Tracks feedback counts and state transitions for a decomposition pattern.
+ */
+export declare const PatternMaturitySchema: z.ZodObject<{
+    pattern_id: z.ZodString;
+    state: z.ZodEnum<{
+        deprecated: "deprecated";
+        candidate: "candidate";
+        established: "established";
+        proven: "proven";
+    }>;
+    helpful_count: z.ZodNumber;
+    harmful_count: z.ZodNumber;
+    last_validated: z.ZodString;
+    promoted_at: z.ZodOptional<z.ZodString>;
+    deprecated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PatternMaturity = z.infer<typeof PatternMaturitySchema>;
+/**
+ * Feedback event for maturity tracking
+ */
+export declare const MaturityFeedbackSchema: z.ZodObject<{
+    pattern_id: z.ZodString;
+    type: z.ZodEnum<{
+        helpful: "helpful";
+        harmful: "harmful";
+    }>;
+    timestamp: z.ZodString;
+    weight: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type MaturityFeedback = z.infer<typeof MaturityFeedbackSchema>;
+/**
+ * Configuration for maturity calculations
+ */
+export interface MaturityConfig {
+    /** Minimum feedback events before leaving candidate state */
+    minFeedback: number;
+    /** Minimum decayed helpful score to reach proven state */
+    minHelpful: number;
+    /** Maximum harmful ratio to reach/maintain proven state */
+    maxHarmful: number;
+    /** Harmful ratio threshold for deprecation */
+    deprecationThreshold: number;
+    /** Half-life for decay in days */
+    halfLifeDays: number;
+}
+export declare const DEFAULT_MATURITY_CONFIG: MaturityConfig;
+/**
+ * Calculate decayed feedback counts
+ *
+ * Applies half-life decay to each feedback event based on age.
+ *
+ * @param feedbackEvents - Raw feedback events
+ * @param config - Maturity configuration
+ * @param now - Current timestamp for decay calculation
+ * @returns Decayed helpful and harmful totals
+ */
+export declare function calculateDecayedCounts(feedbackEvents: MaturityFeedback[], config?: MaturityConfig, now?: Date): {
+    decayedHelpful: number;
+    decayedHarmful: number;
+};
+/**
+ * Calculate maturity state from feedback events
+ *
+ * State determination logic:
+ * 1. "deprecated" if harmful ratio > 0.3 AND total >= minFeedback
+ * 2. "candidate" if total < minFeedback (not enough data)
+ * 3. "proven" if decayedHelpful >= minHelpful AND harmfulRatio < maxHarmful
+ * 4. "established" otherwise (enough data but not yet proven)
+ *
+ * @param feedbackEvents - Feedback events for this pattern
+ * @param config - Maturity configuration
+ * @param now - Current timestamp for decay calculation
+ * @returns Calculated maturity state
+ */
+export declare function calculateMaturityState(feedbackEvents: MaturityFeedback[], config?: MaturityConfig, now?: Date): MaturityState;
+/**
+ * Create initial pattern maturity record
+ *
+ * @param patternId - Unique pattern identifier
+ * @returns New PatternMaturity in candidate state
+ */
+export declare function createPatternMaturity(patternId: string): PatternMaturity;
+/**
+ * Update pattern maturity with new feedback.
+ *
+ * Side Effects:
+ * - Sets `promoted_at` timestamp on first entry into 'proven' status
+ * - Sets `deprecated_at` timestamp on first entry into 'deprecated' status
+ * - Updates `helpful_count` and `harmful_count` based on feedback events
+ * - Recalculates `state` based on decayed feedback counts
+ *
+ * State Transitions:
+ * - candidate → established: After minFeedback observations (default 3)
+ * - established → proven: When decayedHelpful >= minHelpful (5) AND harmfulRatio < maxHarmful (15%)
+ * - any → deprecated: When harmfulRatio > deprecationThreshold (30%) AND total >= minFeedback
+ *
+ * @param maturity - Current maturity record
+ * @param feedbackEvents - All feedback events for this pattern
+ * @param config - Maturity configuration
+ * @returns Updated maturity record with new state
+ */
+export declare function updatePatternMaturity(maturity: PatternMaturity, feedbackEvents: MaturityFeedback[], config?: MaturityConfig): PatternMaturity;
+/**
+ * Promote a pattern to proven state
+ *
+ * Manually promotes a pattern regardless of feedback counts.
+ * Use when external validation confirms pattern effectiveness.
+ *
+ * @param maturity - Current maturity record
+ * @returns Updated maturity record with proven state
+ */
+export declare function promotePattern(maturity: PatternMaturity): PatternMaturity;
+/**
+ * Deprecate a pattern
+ *
+ * Manually deprecates a pattern regardless of feedback counts.
+ * Use when external validation shows pattern is harmful.
+ *
+ * @param maturity - Current maturity record
+ * @param reason - Optional reason for deprecation
+ * @returns Updated maturity record with deprecated state
+ */
+export declare function deprecatePattern(maturity: PatternMaturity, _reason?: string): PatternMaturity;
+/**
+ * Get weight multiplier based on pattern maturity status.
+ *
+ * Multipliers chosen to:
+ * - Heavily penalize deprecated patterns (0x) - never recommend
+ * - Slightly boost proven patterns (1.5x) - reward validated success
+ * - Penalize unvalidated candidates (0.5x) - reduce impact until proven
+ * - Neutral for established (1.0x) - baseline weight
+ *
+ * @param state - Pattern maturity status
+ * @returns Multiplier to apply to pattern weight
+ */
+export declare function getMaturityMultiplier(state: MaturityState): number;
+/**
+ * Format maturity state for inclusion in prompts
+ *
+ * Shows pattern reliability to help agents make informed decisions.
+ *
+ * @param maturity - Pattern maturity record
+ * @returns Formatted string describing pattern reliability
+ */
+export declare function formatMaturityForPrompt(maturity: PatternMaturity): string;
+/**
+ * Format multiple patterns with maturity for prompt inclusion
+ *
+ * Groups patterns by maturity state for clear presentation.
+ *
+ * @param patterns - Map of pattern content to maturity record
+ * @returns Formatted string for prompt inclusion
+ */
+export declare function formatPatternsWithMaturityForPrompt(patterns: Map<string, PatternMaturity>): string;
+/**
+ * Storage interface for pattern maturity records
+ */
+export interface MaturityStorage {
+    /** Store or update a maturity record */
+    store(maturity: PatternMaturity): Promise<void>;
+    /** Get maturity record by pattern ID */
+    get(patternId: string): Promise<PatternMaturity | null>;
+    /** Get all maturity records */
+    getAll(): Promise<PatternMaturity[]>;
+    /** Get patterns by state */
+    getByState(state: MaturityState): Promise<PatternMaturity[]>;
+    /** Store a feedback event */
+    storeFeedback(feedback: MaturityFeedback): Promise<void>;
+    /** Get all feedback for a pattern */
+    getFeedback(patternId: string): Promise<MaturityFeedback[]>;
+}
+/**
+ * In-memory maturity storage (for testing and short-lived sessions)
+ */
+export declare class InMemoryMaturityStorage implements MaturityStorage {
+    private maturities;
+    private feedback;
+    store(maturity: PatternMaturity): Promise<void>;
+    get(patternId: string): Promise<PatternMaturity | null>;
+    getAll(): Promise<PatternMaturity[]>;
+    getByState(state: MaturityState): Promise<PatternMaturity[]>;
+    storeFeedback(feedback: MaturityFeedback): Promise<void>;
+    getFeedback(patternId: string): Promise<MaturityFeedback[]>;
+}
+export declare const maturitySchemas: {
+    MaturityStateSchema: z.ZodEnum<{
+        deprecated: "deprecated";
+        candidate: "candidate";
+        established: "established";
+        proven: "proven";
+    }>;
+    PatternMaturitySchema: z.ZodObject<{
+        pattern_id: z.ZodString;
+        state: z.ZodEnum<{
+            deprecated: "deprecated";
+            candidate: "candidate";
+            established: "established";
+            proven: "proven";
+        }>;
+        helpful_count: z.ZodNumber;
+        harmful_count: z.ZodNumber;
+        last_validated: z.ZodString;
+        promoted_at: z.ZodOptional<z.ZodString>;
+        deprecated_at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    MaturityFeedbackSchema: z.ZodObject<{
+        pattern_id: z.ZodString;
+        type: z.ZodEnum<{
+            helpful: "helpful";
+            harmful: "harmful";
+        }>;
+        timestamp: z.ZodString;
+        weight: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=pattern-maturity.d.ts.map

package/dist/pattern-maturity.d.ts.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenCode Plugin Entry Point
+ *
+ * CRITICAL: Only export the plugin function from this file.
+ *
+ * OpenCode's plugin loader calls ALL exports as functions during initialization.
+ * Exporting classes, constants, or non-function values will cause the plugin
+ * to fail to load with cryptic errors.
+ *
+ * If you need to export utilities for external use, add them to src/index.ts instead.
+ *
+ * @example
+ * // ✅ CORRECT - only export the plugin function
+ * export default SwarmPlugin;
+ *
+ * // ❌ WRONG - will break plugin loading
+ * export const VERSION = "1.0.0";
+ * export class Helper {}
+ */
+import { SwarmPlugin } from "./index";
+export { SwarmPlugin };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,CAAC"}