opencode-swarm-plugin 0.44.0 → 0.44.2

package/src/schemas/index.ts

@@ -1,286 +0,0 @@
-/**
- * Schema Definitions - Central export point for all Zod schemas
- *
- * This module re-exports all schema definitions used throughout the plugin.
- * Schemas are organized by domain:
- *
- * ## Cell Schemas (Issue Tracking) - PRIMARY
- * - `CellSchema` - Core cell/issue definition (formerly BeadSchema)
- * - `CellStatusSchema` - Status enum (open, in_progress, blocked, closed)
- * - `CellTypeSchema` - Type enum (bug, feature, task, epic, chore)
- * - `SubtaskSpecSchema` - Subtask specification for epic creation
- * - `CellTreeSchema` - Epic + subtasks structure (formerly CellTreeSchema)
- *
- * **Backward compatibility:** All Bead* names are exported as deprecated aliases.
- *
- * ## Task Schemas (Swarm Decomposition)
- * - `TaskDecompositionSchema` - Full task breakdown
- * - `DecomposedSubtaskSchema` - Individual subtask definition
- *
- * ## Evaluation Schemas (Agent Self-Assessment)
- * - `EvaluationSchema` - Complete evaluation with criteria
- * - `CriterionEvaluationSchema` - Single criterion result
- *
- * ## Progress Schemas (Swarm Coordination)
- * - `SwarmStatusSchema` - Overall swarm progress
- * - `AgentProgressSchema` - Individual agent status
- * - `SpawnedAgentSchema` - Spawned agent metadata
- *
- * ## Worker Handoff Schemas (Swarm Contracts)
- * - `WorkerHandoffSchema` - Complete structured handoff contract
- * - `WorkerHandoffContractSchema` - Task contract (files, criteria)
- * - `WorkerHandoffContextSchema` - Narrative context (epic summary, role)
- * - `WorkerHandoffEscalationSchema` - Escalation protocols
- *
- * @module schemas
- */
-
-// Cell schemas (primary names)
-export {
-  CellStatusSchema,
-  CellTypeSchema,
-  CellDependencySchema,
-  CellSchema,
-  CellCreateArgsSchema,
-  CellUpdateArgsSchema,
-  CellCloseArgsSchema,
-  CellQueryArgsSchema,
-  SubtaskSpecSchema,
-  CellTreeSchema,
-  EpicCreateArgsSchema,
-  EpicCreateResultSchema,
-  type CellStatus,
-  type CellType,
-  type CellDependency,
-  type Cell,
-  type CellCreateArgs,
-  type CellUpdateArgs,
-  type CellCloseArgs,
-  type CellQueryArgs,
-  type SubtaskSpec,
-  type CellTree,
-  type EpicCreateArgs,
-  type EpicCreateResult,
-} from "./cell";
-
-// Bead schemas (backward compatibility aliases)
-export {
-  BeadStatusSchema,
-  BeadTypeSchema,
-  BeadDependencySchema,
-  BeadSchema,
-  BeadCreateArgsSchema,
-  BeadUpdateArgsSchema,
-  BeadCloseArgsSchema,
-  BeadQueryArgsSchema,
-  BeadTreeSchema,
-  type BeadStatus,
-  type BeadType,
-  type BeadDependency,
-  type Bead,
-  type BeadCreateArgs,
-  type BeadUpdateArgs,
-  type BeadCloseArgs,
-  type BeadQueryArgs,
-  type BeadTree,
-} from "./cell";
-
-// Evaluation schemas
-export {
-  CriterionEvaluationSchema,
-  WeightedCriterionEvaluationSchema,
-  EvaluationSchema,
-  WeightedEvaluationSchema,
-  EvaluationRequestSchema,
-  SwarmEvaluationResultSchema,
-  ValidationResultSchema,
-  DEFAULT_CRITERIA,
-  type CriterionEvaluation,
-  type WeightedCriterionEvaluation,
-  type Evaluation,
-  type WeightedEvaluation,
-  type EvaluationRequest,
-  type SwarmEvaluationResult,
-  type ValidationResult,
-  type DefaultCriterion,
-} from "./evaluation";
-
-// Task schemas
-export {
-  EffortLevelSchema,
-  DependencyTypeSchema,
-  DecomposedSubtaskSchema,
-  SubtaskDependencySchema,
-  TaskDecompositionSchema,
-  DecomposeArgsSchema,
-  SpawnedAgentSchema,
-  SwarmSpawnResultSchema,
-  AgentProgressSchema,
-  SwarmStatusSchema,
-  type EffortLevel,
-  type DependencyType,
-  type DecomposedSubtask,
-  type SubtaskDependency,
-  type TaskDecomposition,
-  type DecomposeArgs,
-  type SpawnedAgent,
-  type SwarmSpawnResult,
-  type AgentProgress,
-  type SwarmStatus,
-} from "./task";
-
-// Mandate schemas
-export {
-  MandateContentTypeSchema,
-  MandateStatusSchema,
-  VoteTypeSchema,
-  MandateEntrySchema,
-  VoteSchema,
-  MandateScoreSchema,
-  CreateMandateArgsSchema,
-  CastVoteArgsSchema,
-  QueryMandatesArgsSchema,
-  ScoreCalculationResultSchema,
-  DEFAULT_MANDATE_DECAY_CONFIG,
-  mandateSchemas,
-  type MandateContentType,
-  type MandateStatus,
-  type VoteType,
-  type MandateEntry,
-  type Vote,
-  type MandateScore,
-  type MandateDecayConfig,
-  type CreateMandateArgs,
-  type CastVoteArgs,
-  type QueryMandatesArgs,
-  type ScoreCalculationResult,
-} from "./mandate";
-
-// Swarm context schemas
-export {
-  SwarmStrategySchema,
-  SwarmDirectivesSchema,
-  SwarmRecoverySchema,
-  SwarmBeadContextSchema,
-  CreateSwarmContextArgsSchema,
-  UpdateSwarmContextArgsSchema,
-  QuerySwarmContextsArgsSchema,
-  type SwarmStrategy,
-  type SwarmDirectives,
-  type SwarmRecovery,
-  type SwarmBeadContext,
-  type CreateSwarmContextArgs,
-  type UpdateSwarmContextArgs,
-  type QuerySwarmContextsArgs,
-} from "./swarm-context";
-
-// Worker handoff schemas
-export {
-  WorkerHandoffContractSchema,
-  WorkerHandoffContextSchema,
-  WorkerHandoffEscalationSchema,
-  WorkerHandoffSchema,
-  type WorkerHandoff,
-  type WorkerHandoffContract,
-  type WorkerHandoffContext,
-  type WorkerHandoffEscalation,
-} from "./worker-handoff";
-
-// Cell event schemas (PRIMARY)
-export {
-  BaseCellEventSchema,
-  CellCreatedEventSchema,
-  CellUpdatedEventSchema,
-  CellStatusChangedEventSchema,
-  CellClosedEventSchema,
-  CellReopenedEventSchema,
-  CellDeletedEventSchema,
-  CellDependencyAddedEventSchema,
-  CellDependencyRemovedEventSchema,
-  CellLabelAddedEventSchema,
-  CellLabelRemovedEventSchema,
-  CellCommentAddedEventSchema,
-  CellCommentUpdatedEventSchema,
-  CellCommentDeletedEventSchema,
-  CellEpicChildAddedEventSchema,
-  CellEpicChildRemovedEventSchema,
-  CellEpicClosureEligibleEventSchema,
-  CellAssignedEventSchema,
-  CellWorkStartedEventSchema,
-  CellCompactedEventSchema,
-  CellEventSchema,
-  createCellEvent,
-  isCellEventType,
-  getCellIdFromEvent,
-  isStateTransitionEvent,
-  isEpicEvent,
-  isAgentEvent,
-  type CellEvent,
-  type CellCreatedEvent,
-  type CellUpdatedEvent,
-  type CellStatusChangedEvent,
-  type CellClosedEvent,
-  type CellReopenedEvent,
-  type CellDeletedEvent,
-  type CellDependencyAddedEvent,
-  type CellDependencyRemovedEvent,
-  type CellLabelAddedEvent,
-  type CellLabelRemovedEvent,
-  type CellCommentAddedEvent,
-  type CellCommentUpdatedEvent,
-  type CellCommentDeletedEvent,
-  type CellEpicChildAddedEvent,
-  type CellEpicChildRemovedEvent,
-  type CellEpicClosureEligibleEvent,
-  type CellAssignedEvent,
-  type CellWorkStartedEvent,
-  type CellCompactedEvent,
-} from "./cell-events";
-
-// Bead event schemas (DEPRECATED - backward compatibility)
-export {
-  BaseBeadEventSchema,
-  BeadCreatedEventSchema,
-  BeadUpdatedEventSchema,
-  BeadStatusChangedEventSchema,
-  BeadClosedEventSchema,
-  BeadReopenedEventSchema,
-  BeadDeletedEventSchema,
-  BeadDependencyAddedEventSchema,
-  BeadDependencyRemovedEventSchema,
-  BeadLabelAddedEventSchema,
-  BeadLabelRemovedEventSchema,
-  BeadCommentAddedEventSchema,
-  BeadCommentUpdatedEventSchema,
-  BeadCommentDeletedEventSchema,
-  BeadEpicChildAddedEventSchema,
-  BeadEpicChildRemovedEventSchema,
-  BeadEpicClosureEligibleEventSchema,
-  BeadAssignedEventSchema,
-  BeadWorkStartedEventSchema,
-  BeadCompactedEventSchema,
-  BeadEventSchema,
-  createBeadEvent,
-  isBeadEventType,
-  getBeadIdFromEvent,
-  type BeadEvent,
-  type BeadCreatedEvent,
-  type BeadUpdatedEvent,
-  type BeadStatusChangedEvent,
-  type BeadClosedEvent,
-  type BeadReopenedEvent,
-  type BeadDeletedEvent,
-  type BeadDependencyAddedEvent,
-  type BeadDependencyRemovedEvent,
-  type BeadLabelAddedEvent,
-  type BeadLabelRemovedEvent,
-  type BeadCommentAddedEvent,
-  type BeadCommentUpdatedEvent,
-  type BeadCommentDeletedEvent,
-  type BeadEpicChildAddedEvent,
-  type BeadEpicChildRemovedEvent,
-  type BeadEpicClosureEligibleEvent,
-  type BeadAssignedEvent,
-  type BeadWorkStartedEvent,
-  type BeadCompactedEvent,
-} from "./cell-events";

package/src/schemas/mandate.ts

@@ -1,232 +0,0 @@
-/**
- * Mandate schemas for voting system
- *
- * Agents file and vote on ideas, tips, lore, snippets, and feature requests.
- * High-consensus items become "mandates" that influence future behavior.
- *
- * Vote decay and scoring patterns match learning.ts (90-day half-life).
- */
-import { z } from "zod";
-
-// ============================================================================
-// Core Types
-// ============================================================================
-
-/**
- * Content types for mandate entries
- */
-export const MandateContentTypeSchema = z.enum([
-  "idea",
-  "tip",
-  "lore",
-  "snippet",
-  "feature_request",
-]);
-export type MandateContentType = z.infer<typeof MandateContentTypeSchema>;
-
-/**
- * Mandate status lifecycle
- *
- * - candidate: New entry, collecting votes
- * - established: Has some consensus but not enough for mandate status
- * - mandate: High consensus (net_votes >= 5 AND vote_ratio >= 0.7)
- * - rejected: Strong negative consensus or explicitly rejected
- */
-export const MandateStatusSchema = z.enum([
-  "candidate",
-  "established",
-  "mandate",
-  "rejected",
-]);
-export type MandateStatus = z.infer<typeof MandateStatusSchema>;
-
-/**
- * Vote type
- */
-export const VoteTypeSchema = z.enum(["upvote", "downvote"]);
-export type VoteType = z.infer<typeof VoteTypeSchema>;
-
-// ============================================================================
-// Entry Schema
-// ============================================================================
-
-/**
- * A mandate entry represents a proposal from an agent
- *
- * Entries can be ideas, tips, lore, code snippets, or feature requests.
- * Other agents vote on entries to reach consensus.
- */
-export const MandateEntrySchema = z.object({
-  /** Unique ID for this entry */
-  id: z.string(),
-  /** The actual content of the mandate */
-  content: z.string().min(1, "Content required"),
-  /** Type of content */
-  content_type: MandateContentTypeSchema,
-  /** Agent that created this entry */
-  author_agent: z.string(),
-  /** When this entry was created (ISO-8601) */
-  created_at: z.string().datetime({ offset: true }),
-  /** Current status */
-  status: MandateStatusSchema.default("candidate"),
-  /** Optional tags for categorization and search */
-  tags: z.array(z.string()).default([]),
-  /** Optional metadata (e.g., code language for snippets) */
-  metadata: z.record(z.string(), z.unknown()).optional(),
-});
-export type MandateEntry = z.infer<typeof MandateEntrySchema>;
-
-// ============================================================================
-// Vote Schema
-// ============================================================================
-
-/**
- * A vote on a mandate entry
- *
- * Each agent can vote once per entry (upvote or downvote).
- * Votes decay with 90-day half-life matching learning.ts patterns.
- */
-export const VoteSchema = z.object({
-  /** Unique ID for this vote */
-  id: z.string(),
-  /** The mandate entry this vote applies to */
-  mandate_id: z.string(),
-  /** Agent that cast this vote */
-  agent_name: z.string(),
-  /** Type of vote */
-  vote_type: VoteTypeSchema,
-  /** When this vote was cast (ISO-8601) */
-  timestamp: z.string().datetime({ offset: true }),
-  /** Raw vote weight before decay (default: 1.0) */
-  weight: z.number().min(0).max(1).default(1.0),
-});
-export type Vote = z.infer<typeof VoteSchema>;
-
-// ============================================================================
-// Score Schema
-// ============================================================================
-
-/**
- * Calculated score for a mandate entry
- *
- * Scores are recalculated periodically with decay applied.
- * Uses same decay formula as learning.ts (90-day half-life).
- */
-export const MandateScoreSchema = z.object({
-  /** The mandate entry this score applies to */
-  mandate_id: z.string(),
-  /** Net votes (upvotes - downvotes) with decay applied */
-  net_votes: z.number(),
-  /** Vote ratio: upvotes / (upvotes + downvotes) */
-  vote_ratio: z.number().min(0).max(1),
-  /** Final decayed score for ranking */
-  decayed_score: z.number(),
-  /** When this score was last calculated (ISO-8601) */
-  last_calculated: z.string().datetime({ offset: true }),
-  /** Raw vote counts (before decay) */
-  raw_upvotes: z.number().int().min(0),
-  raw_downvotes: z.number().int().min(0),
-  /** Decayed vote counts */
-  decayed_upvotes: z.number().min(0),
-  decayed_downvotes: z.number().min(0),
-});
-export type MandateScore = z.infer<typeof MandateScoreSchema>;
-
-// ============================================================================
-// Decay Configuration
-// ============================================================================
-
-/**
- * Configuration for mandate decay calculation
- *
- * Matches learning.ts decay patterns.
- */
-export interface MandateDecayConfig {
-  /** Half-life for vote decay in days */
-  halfLifeDays: number;
-  /** Net votes threshold for mandate status */
-  mandateNetVotesThreshold: number;
-  /** Vote ratio threshold for mandate status */
-  mandateVoteRatioThreshold: number;
-  /** Net votes threshold for established status */
-  establishedNetVotesThreshold: number;
-  /** Negative net votes threshold for rejected status */
-  rejectedNetVotesThreshold: number;
-}
-
-export const DEFAULT_MANDATE_DECAY_CONFIG: MandateDecayConfig = {
-  halfLifeDays: 90,
-  mandateNetVotesThreshold: 5,
-  mandateVoteRatioThreshold: 0.7,
-  establishedNetVotesThreshold: 2,
-  rejectedNetVotesThreshold: -3,
-};
-
-// ============================================================================
-// API Schemas
-// ============================================================================
-
-/**
- * Arguments for creating a mandate entry
- */
-export const CreateMandateArgsSchema = z.object({
-  content: z.string().min(1, "Content required"),
-  content_type: MandateContentTypeSchema,
-  tags: z.array(z.string()).default([]),
-  metadata: z.record(z.string(), z.unknown()).optional(),
-});
-export type CreateMandateArgs = z.infer<typeof CreateMandateArgsSchema>;
-
-/**
- * Arguments for casting a vote
- */
-export const CastVoteArgsSchema = z.object({
-  mandate_id: z.string(),
-  vote_type: VoteTypeSchema,
-  weight: z.number().min(0).max(1).default(1.0),
-});
-export type CastVoteArgs = z.infer<typeof CastVoteArgsSchema>;
-
-/**
- * Arguments for querying mandates
- */
-export const QueryMandatesArgsSchema = z.object({
-  status: MandateStatusSchema.optional(),
-  content_type: MandateContentTypeSchema.optional(),
-  tags: z.array(z.string()).optional(),
-  author_agent: z.string().optional(),
-  limit: z.number().int().positive().default(20),
-  min_score: z.number().optional(),
-});
-export type QueryMandatesArgs = z.infer<typeof QueryMandatesArgsSchema>;
-
-/**
- * Result of score calculation
- */
-export const ScoreCalculationResultSchema = z.object({
-  mandate_id: z.string(),
-  previous_status: MandateStatusSchema,
-  new_status: MandateStatusSchema,
-  score: MandateScoreSchema,
-  status_changed: z.boolean(),
-});
-export type ScoreCalculationResult = z.infer<
-  typeof ScoreCalculationResultSchema
->;
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-export const mandateSchemas = {
-  MandateContentTypeSchema,
-  MandateStatusSchema,
-  VoteTypeSchema,
-  MandateEntrySchema,
-  VoteSchema,
-  MandateScoreSchema,
-  CreateMandateArgsSchema,
-  CastVoteArgsSchema,
-  QueryMandatesArgsSchema,
-  ScoreCalculationResultSchema,
-};

package/src/schemas/swarm-context.ts

@@ -1,115 +0,0 @@
-/**
- * Swarm Context Schemas
- *
- * These schemas define the structure for storing and recovering swarm execution context.
- * Used for checkpoint/recovery, continuation after crashes, and swarm state management.
- */
-import { z } from "zod";
-
-/**
- * Decomposition strategy used for the swarm
- */
-export const SwarmStrategySchema = z.enum([
-  "file-based",
-  "feature-based",
-  "risk-based",
-]);
-export type SwarmStrategy = z.infer<typeof SwarmStrategySchema>;
-
-/**
- * Shared directives and context for all agents in a swarm
- */
-export const SwarmDirectivesSchema = z.object({
-  /** Context shared with all agents (API contracts, conventions, arch decisions) */
-  shared_context: z.string(),
-  /** Skills to load in agent context (e.g., ['testing-patterns', 'swarm-coordination']) */
-  skills_to_load: z.array(z.string()).default([]),
-  /** Notes from coordinator to agents (gotchas, important context) */
-  coordinator_notes: z.string().default(""),
-});
-export type SwarmDirectives = z.infer<typeof SwarmDirectivesSchema>;
-
-/**
- * Recovery state for checkpoint/resume
- */
-export const SwarmRecoverySchema = z.object({
-  /** Last known checkpoint (ISO-8601 timestamp or checkpoint ID) */
-  last_checkpoint: z.string(),
-  /** Files modified since checkpoint (for rollback/recovery) */
-  files_modified: z.array(z.string()).default([]),
-  /** Progress percentage (0-100) */
-  progress_percent: z.number().min(0).max(100).default(0),
-  /** Last status message from agent */
-  last_message: z.string().default(""),
-  /** Error context if agent failed (for retry/recovery) */
-  error_context: z.string().optional(),
-});
-export type SwarmRecovery = z.infer<typeof SwarmRecoverySchema>;
-
-/**
- * Complete context for a single bead in a swarm
- *
- * Stored in swarm_contexts table for recovery, continuation, and state management.
- */
-export const SwarmBeadContextSchema = z.object({
-  /** ID of the swarm context record */
-  id: z.string(),
-  /** Epic this bead belongs to */
-  epic_id: z.string(),
-  /** Cell ID being executed */
-  bead_id: z.string(),
-  /** Decomposition strategy used */
-  strategy: SwarmStrategySchema,
-  /** Files this bead is responsible for */
-  files: z.array(z.string()),
-  /** Cell IDs this task depends on */
-  dependencies: z.array(z.string()).default([]),
-  /** Shared directives and context */
-  directives: SwarmDirectivesSchema,
-  /** Recovery state */
-  recovery: SwarmRecoverySchema,
-  /** Creation timestamp (epoch ms) */
-  created_at: z.number().int().positive(),
-  /** Last update timestamp (epoch ms) */
-  updated_at: z.number().int().positive(),
-});
-export type SwarmBeadContext = z.infer<typeof SwarmBeadContextSchema>;
-
-/**
- * Args for creating a swarm context
- */
-export const CreateSwarmContextArgsSchema = SwarmBeadContextSchema.omit({
-  id: true,
-  created_at: true,
-  updated_at: true,
-});
-export type CreateSwarmContextArgs = z.infer<
-  typeof CreateSwarmContextArgsSchema
->;
-
-/**
- * Args for updating a swarm context
- */
-export const UpdateSwarmContextArgsSchema = z.object({
-  id: z.string(),
-  recovery: SwarmRecoverySchema.partial().optional(),
-  files: z.array(z.string()).optional(),
-  dependencies: z.array(z.string()).optional(),
-  directives: SwarmDirectivesSchema.partial().optional(),
-});
-export type UpdateSwarmContextArgs = z.infer<
-  typeof UpdateSwarmContextArgsSchema
->;
-
-/**
- * Args for querying swarm contexts
- */
-export const QuerySwarmContextsArgsSchema = z.object({
-  epic_id: z.string().optional(),
-  bead_id: z.string().optional(),
-  strategy: SwarmStrategySchema.optional(),
-  has_errors: z.boolean().optional(), // Filter by presence of error_context
-});
-export type QuerySwarmContextsArgs = z.infer<
-  typeof QuerySwarmContextsArgsSchema
->;